Use the three basic tools of the Block brush mode (Place, Break and Eyedropper) to place and remove blocks. A click places one block; a drag fills a whole box at once. Undo any edit with Ctrl+Z.
| Method | Action |
|---|
| 1 · 2 · 3 | Switches to the Place, Break or Eyedropper tool. The mode changes to Block brush. |
| Tools panel | Press the Place 1, Break 2 or Eyedropper 3 button in the Block brush mode. |
| Tab | Toggles between the Place and Selection tools. |
In the viewport, a left click always uses the current tool. Move the camera with the right button, middle button and mouse wheel (Camera and views).
- Choose the block to place (see “Choosing the block to place” below).
- Press 1 to switch to the Place tool.
- Click a block face. One block is placed in the cell outside that face.
- To fill a wide area, drag across the floor. A green ghost box shows the footprint.
- While holding the button, hold Alt and drag the mouse up or down to change the height.
- Release the button to fill the whole box. This is one undo step.
- Remove a misplaced block with Shift+click.
| Method | Action |
|---|
| Eyedropper | Middle-click (without dragging) or click a block with the Eyedropper tool (3). That block becomes the block to place. |
| Content Browser | Click a block (or double-click / Enter). Right-click › Set as block to place does the same. Custom blocks work the same way. |
| Drag and drop | Drag a block from the Content Browser into the viewport to place it directly in that cell. |
| Main toolbar | The Block to place field on the right shows the current block. |
| Details | In the Block to place field of the Edit group, type the block including its state, such as minecraft:oak_stairs[facing=east], and press Enter. |
When you use the Place, Shape, Brush or Fill tool, the Tools panel shows a Block state group.
| Field | Meaning |
|---|
| Auto | When on, orientation, slab half and connections adapt to the placement spot (stairs face the viewer, fences connect to neighbors). |
| Property list | Choose a value for each property of the block to place (e.g. facing · half). Choosing a value other than (auto) makes that property “(pinned)”, and Auto no longer changes it. |
| All auto | Unpins all pinned properties and returns them to Auto. |
| Input | Action |
|---|
| Click | Places one block in the cell outside the face you hit. The block is placed when you release the button. |
| Drag | Draws a footprint box. Release to fill the cuboid with the current block (pattern). |
| Alt+drag up/down while dragging | Changes the box height to the height under the mouse. Releasing while holding Alt also fills. |
| Shift+mouse wheel · Ctrl+Shift+mouse wheel while dragging | Height ±1 · ±10 |
| Shift+click (without dragging) | Breaks the block in that cell. |
| Shift+drag | Makes a screen rectangle selection (Selection and region editing). |
| Esc | Cancels the box you are dragging. |
Since 0.9.10: Alt+drag down (or Shift+mouse wheel down) while dragging extends the box downward (into the ground) from the starting layer. Previously the height could not go below 1 block.
- While dragging, green ghost blocks and the text “Release to fill: blocks W×H×D = N blocks” are shown.
- The height can extend up to 512 blocks up or down.
- If you point at a spot with no block, the block is placed on the floor (y=0). If the floor is not visible either (sky), it is placed in midair 6 blocks in front of the camera.
- Block placement and drag fills always align to cells, regardless of the grid snap setting. Grid snap applies only to props and gizmo movement steps.
| Input | Action |
|---|
| Click | Removes the one block you clicked. |
| Drag | Keeps removing blocks the mouse passes over. |
| [ · ] | Erase brush radius −1 · +1 (Shift = larger step). At 1 or more, Erase with brush turns on automatically. At 0 it removes a single block. |
When you choose the Break tool, the Tools panel shows an Erase brush group.
| Field | Meaning |
|---|
| Erase with brush | When on, dragging erases with the brush size and shape. When off, it erases one block at a time. |
| Shape | Sphere, cube or cylinder. Uses the same values as the Brush tool. |
| Radius [ ] | 0–64 |
The block you click (including its state) becomes the block to place. A middle-click does the same while you use any other tool. Dragging with the middle button pans the view.
| Item | Action |
|---|
| Undo · Redo | Ctrl+Z · Ctrl+Y (or Ctrl+Shift+Z). Up to 200 steps. |
| One step | One click, one drag box, one brush stroke and one shape are each one step. |
| History panel | Window › History — the list of undo steps. Click a row to go to that step. |
| Large operation | Operations over 200,000 blocks are applied across several frames. The status bar shows progress and a cancel button. |
| Cancel | Press Esc while in progress to stop and revert the part already applied. |
| In progress | Other edits and saving are blocked until the large operation finishes. A Task in progress notice appears. |
| Setting | Where | Meaning |
|---|
| Auto | Tools panel › Block state | Automatic block orientation, slab half and connections |
| Erase with brush · Shape · Radius | Tools panel › Erase brush | Erase size of the Break tool |
| Block to place | Details › Edit | Block string including its state |
| Toggle actor per shape | Edit menu | When off, drag boxes, shapes and brush strokes go into the active folder or group instead of a new actor. |
| Key | Action |
|---|
| 1 · 2 · 3 | Place · Break · Eyedropper |
| Tab | Place ↔ Selection |
| Middle-click | Eyedropper |
| Shift+click (Place tool) | Break that block |
| Alt+drag up/down · Shift+mouse wheel (while dragging) | Drag box height |
| Ctrl+Shift+mouse wheel (while dragging) | Drag box height ±10 |
| [ · ] (- · =) | Erase brush size |
| Ctrl+Z · Ctrl+Y | Undo · Redo |
| Esc | Cancel drag box → cancel running large operation → clear selection |
You can change keys in Tools › Shortcuts… (Ctrl+Alt+K). Ctrl+Z, Ctrl+Y and Esc cannot be changed.
- Each block placed one at a time becomes its own actor (e.g.
oak_planks_1). One drag box is one actor. You can merge actors in the Outliner (Scene actors and Outliner).
- Cells in locked groups are skipped. A notice shows how many cells were skipped.
- When Symmetry is on, Place, Break and drag boxes also apply at the symmetric positions (Shapes, brush and fill).
- Shortcuts do not work while the cursor is in a text field (search, block to place, etc.). Click the viewport once.
- While a large operation is running, other edits are blocked. Wait for the progress to finish or cancel with Esc.