Painter

Reskin your builds without breaking them. Painter gives you a dedicated Paintbrush that swaps existing blocks for new ones in a radius around your cursor — turn a cobblestone wall into stone brick, randomize a floor between three flooring blocks, or hand-paint a pixel-art pattern onto a surface, all without breaking and replacing a single block by hand.

Survival-friendly by design: painting consumes matching blocks from your inventory and refunds the blocks it replaces, so it's balanced for survival worlds, not just creative.

✨ Features

A dedicated Paintbrush item — craft one with a vanilla Brush + White Dye. It doesn't touch the regular archaeology brush, so that's still free for actual brushing.

Two ways to paint:

• Randomize — every click draws a fresh, weighted-random block from your palette. Great for natural variation (stone / cobblestone / mossy cobblestone mixed together, for example).
• Custom — paint a literal per-cell template onto your brush's grid. Assign specific blocks to specific cells for checkerboards, borders, or hand-designed pixel patterns, with any leftover cells still drawing randomly from your palette.

A full in-game configuration screen (Shift + right-click the brush):

• Searchable, scrollable block picker with every block in the game — including blocks from other installed mods
• Multi-select blocks, then add them to your palette or your mask in one click
• Palette weights are sliders + numeric boxes that always stay normalized to 100%
• A visual grid editor for Custom mode — click a cell, click a block, done
• Brush size (1–5) and shape (square / circle / diamond)

Masking — restrict painting to only certain blocks ("only replace stone and dirt"), or flip it to exclude certain blocks instead ("paint over anything except glass").

Built-in safety nets:

• /paintbrush undo reverts your last paint — blocks and inventory both roll back
• A brief cooldown between paints keeps holding right-click from hammering the server with block updates
• Ores are never duplicated — painting over an ore destroys it instead of returning a free item
• Fragile and structural blocks (doors, beds, stairs, slabs, block entities, etc.) are protected from accidental painting

Everything is also available via commands if you'd rather not open the GUI — see /paintbrush help in-game for the full list.

🧠 How it works

1. Craft a Paintbrush (Brush + White Dye).
2. Hold it and Shift + right-click to open the configuration screen.
3. Search for blocks, select them, and add them to your palette (what you paint with) and optionally a mask (what you paint onto).
4. Pick Randomize or Custom mode, set your brush size/shape, and hit Apply.
5. Right-click a block to paint. Right-click again to keep going.
6. Made a mistake? /paintbrush undo.

📋 Requirements

• Minecraft 1.20.1
• Forge 47.2.0 or later
• Java 17

💬 Feedback

This mod is actively maintained — bug reports and feature suggestions are welcome via the issue tracker.