Retouch Brush

Retouch Brush

A server-side Minecraft mod that lets you cycle through paintings using the brush!

📖 What is this mod?

This is a server-side mod that allows users to cycle through paintings using the brush.

Tired of breaking and replacing paintings just to get the right piece for your living room?

This server-side mod lets you effortlessly cycle through paintings.

Simply right-click any painting with a brush to change it.

You can even make a functioning TV using dispensers

Here is a little showcase!

✅ Features

• Multi-Loader Support: Fully compatible with Fabric, Quilt, Forge and NeoForge
• Easy Painting Cycling: Right-click any painting with a brush to cycle through available art variants
• Dispenser Support: Use a dispenser loaded with a brush to cycle through paintings
• Server-Side Only: Install only on the server; Vanilla clients can connect without downloading anything
• Server Authoritative: Prevents client-side manipulation by enforcing all logic securely on the server
• In-Game Configuration: Adjust the mod’s behavior directly using in-game configuration screen

📖 Usage

Using this mod is very simple!

Put the jar file in your mods folder and you’re good to go!

For [Fabric] and [Quilt] version, if you wish to be able to access the settings of the mod within the game; you will also need to put [ModMenu] and [Cloth Config API] in your mods folder.

For [Forge] and [NeoForge] version, if you wish to be able to access the settings of the mod within the game; you will also need to put [Cloth Config API] in your mods folder.

You can also edit the configuration file found in config folder manually if you wish to do so.

📖 Compatibility

This mod should be compatible with every mod.
It works with mods and resource packs that add more vanilla paintings.

🚀 Supported Versions

| Minecraft | Fabric | Quilt | Forge | NeoForge |
|:———:|:——–:|:———:|:———:|:———:|
| 26.3 | ✅(1.0.3) | ✅(1.0.3)⁶ | ❌ | ✅(1.0.3) |
| 26.2 | ✅(1.0.3) | ✅(1.0.3)⁵ | ❌ | ✅(1.0.3) |
| 26.1.2 | ✅(1.0.3) | ✅(1.0.3)⁴ | ❌ | ✅(1.0.3) |
| 26.1.1 | ✅(1.0.3) | ✅(1.0.3)⁴ | ❌ | ✅(1.0.3) |
| 26.1 | ✅(1.0.3) | ✅(1.0.3)⁴ | ❌ | ✅(1.0.3) |
| 1.21.11 | ✅(1.0.3) | ✅(1.0.3)³ | ❌ | ✅(1.0.3) |
| 1.21.10 | ✅(1.0.2) | ✅(1.0.2) | ❌ | ✅(1.0.2) |
| 1.21.9 | ✅(1.0.2) | ✅(1.0.2) | ❌ | ✅(1.0.2)² |
| 1.21.8 | ✅(1.0.2) | ✅(1.0.2) | ❌ | ✅(1.0.2) |
| 1.21.7 | ✅(1.0.2) | ✅(1.0.2) | ❌ | ✅(1.0.2) |
| 1.21.6 | ✅(1.0.2) | ✅(1.0.2) | ❌ | ✅(1.0.2) |
| 1.21.5 | ✅(1.0.2) | ✅(1.0.2) | ❌ | ✅(1.0.2) |
| 1.21.4 | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2)¹ | ✅(1.0.2) |
| 1.21.3 | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2) |
| 1.21.2 | ✅(1.0.2) | ✅(1.0.2) | ❌ | ✅(1.0.2) |
| 1.21.1 | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2) |
| 1.21 | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2) |
| 1.20.6 | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2) |
| 1.20.5 | ✅(1.0.2) | ✅(1.0.2) | ❌ | ✅(1.0.2) |
| 1.20.4 | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2) |
| 1.20.3 | ❌ | ❌ | ❌ | ❌ |
| 1.20.2 | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2) |
| 1.20.1 | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2) | ❌ |
| 1.20 | ✅(1.0.2) | ✅(1.0.2) | ✅(1.0.2) | ❌ |

✅ – Supported ⏳ – Planned ❌ – Not supported

Notes:

• Latest mod version is written in parentheses
• ¹: 1.21.4 [Forge] users can use cloth config for 1.21.3 since there is no build of cloth config for 1.21.4 Forge
• ²: 1.21.9 [NeoForge] users should use NeoForge 21.9.15-beta or below since cloth config causes a crash on NeoForge 21.9.16-beta upon opening the mods list
• ³: 1.21.11 [Quilt] users should use Quilt 0.29.3-beta.1 or above since mod menu now requires Fabric 0.17.3
• ⁴: From 26.1 to 26.1.2 [Quilt] users should use Quilt 0.30.0-beta.4 or above since mod menu now requires Fabric 0.18.4
• ⁵: From 26.2 [Quilt] users should use Quilt 0.30.0-beta.8 or above for mod menu to work
• ⁶: From 26.3 [Quilt] users should use Quilt 0.30.2-beta.1 or above for the mod to work