Bulk Paint
IntermediateBulk Paint lets you replace every block of one material with a completely different material across your entire build in a single click. Where the regular Paint tool requires you to drag over each surface you want to change, Bulk Paint operates globally — it finds every matching block no matter where it is and swaps it all at once. It's the fastest way to retheme a finished build.
Opening Bulk Paint
Tap Bulk Paint in the Quick Build section of the sidebar. The modal opens and immediately scans your build, producing a list of every material currently in use. Liquid and nature blocks are excluded — only paintable shapes appear in the list.
Phase 1 — The Material List
The first screen shows every material in your build as a scrollable list of rows, sorted by block count so your most-used materials appear at the top. Each row shows:
- A material swatch — the same rendered preview you'd see in the main material palette, including colour tints.
- The material name — including the tint label in brackets if the material has been tinted (e.g. "Brick Wall (Red)").
- Block count and shape — how many blocks of this material exist in the build, and which shape they belong to.
Why the same material can appear more than once
Bulk Paint groups entries by material + shape rather than material alone. If you've used Wooden Wall as a flat cube block and also as steps, those two uses appear as separate rows — because they can only be repainted with materials valid for their respective shapes. Replacing "Wooden Wall (steps)" would only offer materials from the Steps category, while "Wooden Wall (cube)" would offer Walls, Flooring, Misc, Prints, and Terrain.
Phase 2 — Choosing a Replacement
Tap any row to enter the replacement picker. The top of the screen shows a summary strip confirming which material you're replacing and how many blocks will be affected. Tap ← Back in the strip at any time to return to the full material list without making any change.
Below the summary, a tabbed material grid appears — filtered to the categories that are valid for the selected shape. It works exactly like the House Generator material picker:
- Tabs along the top switch between material categories.
- Tap a swatch to select it as the replacement. The material name appears below the grid to confirm your choice.
- The Replace All button at the bottom activates once a replacement swatch is selected.
If no compatible materials exist for a shape (which is very unlikely but can happen with unusual shape types), the grid will say so and no replacement is possible for that entry.
Confirming the Replacement
Tap Replace All. Bulk Paint immediately:
- Snapshots the current build state onto the undo stack.
- Iterates every block in the build that matches the selected material and shape.
- Applies the replacement material to each matching block, respecting the same shape-compatibility rules as the regular Paint tool — so footprint-sensitive shapes (arch bridges, carved rocks, fancy-roofed slopes, partition pillars) are handled safely.
- Closes the modal and re-renders the viewport.
The whole operation is instant regardless of how many blocks are affected.
Undoing a Bulk Paint
Every Bulk Paint action is undoable. Press Ctrl+Z (or Cmd+Z on Mac) immediately after to restore all blocks to their original material. Because the entire replacement is pushed as a single undo step, one undo reverses everything — you don't need to undo once per block.
How Bulk Paint Differs From Regular Paint
| Paint tool | Bulk Paint | |
|---|---|---|
| Scope | Only the cells you drag over. | Every matching block in the entire build. |
| Source material | Whatever shape is under your cursor. | A specific material + shape combination you choose from the list. |
| Speed | Manual — you control exactly what gets painted. | Instant — one tap replaces everything at once. |
| Undo | One undo per stroke. | One undo for the entire operation. |
What Bulk Paint Won't Affect
- Liquid blocks — water and lava types are excluded entirely, as they don't use the standard material system.
- Nature blocks — trees, shrubs, and other nature objects are excluded for the same reason.
- Blocks hidden by Blueprint Reveal — blocks above the current reveal level are not repainted, consistent with how the regular Paint tool behaves.
- Shape-incompatible replacements — if a specific block would produce a footprint mismatch with the chosen replacement material (for example, trying to swap a standard pathing block to an arch bridge, which has a wider footprint), that individual block is skipped safely rather than causing an error.