Selection and region editing
Select a block region with the Selection tool, then edit the whole region at once with the gizmo, keys or the right-click menu. There are two kinds of selection.
| Kind | How to make it | Meaning |
|---|---|---|
| Box selection | Drag | Every cell inside the box. Resize it with the face handles. |
| Cell-set selection | Shift+drag · Shift+E etc. | Only the chosen block cells. Its bounding box is shown as well. |
How to open
Section titled “How to open”| Method | Action |
|---|---|
| 4 or Q | Selection tool. The mode changes to Selection. |
| Viewport right bar | Selection · Move · Rotate · Size buttons (Q · W · E · R) |
| Tab | Place ↔ Selection |
| Outliner | Clicking a block actor switches to the Selection tool and selects that actor’s blocks. |
Quick start
Section titled “Quick start”- Press Q and drag across the floor to select a box.
- While holding the button, set the height with Alt+drag up/down, then release.
- Press W and drag an arrow to move it. Hold Alt while dragging to duplicate.
- Press R and stretch with a size handle; the added cells are filled by continuing the end-face blocks.
- Copy with Ctrl+C, point the mouse elsewhere, and paste with Ctrl+V.
- If something goes wrong, press Ctrl+Z. The selection box is restored too.
Selecting a region
Section titled “Selecting a region”| Input (Selection tool) | Action |
|---|---|
| Click | Selects one cell. |
| Drag | Footprint box selection (blue box) |
| Alt+drag up/down while dragging | Box height up to the mouse height (drag down to go into the ground) |
| Shift+mouse wheel · Ctrl+Shift+mouse wheel while dragging | Height ±1 · ±10 |
| Shift+drag | Selects only the visible blocks inside the screen rectangle as a cell set. |
| Ctrl+drag | Adds the blocks in the screen rectangle to the current selection. |
| Ctrl+Shift+drag | Removes the blocks in the screen rectangle from the current selection. |
| Ctrl+click | Adds that cell to, or removes it from, the selection. |
| Shift+E | Selects every block in the world of the same type as the block under the mouse (state ignored). If the mouse is inside the selection, it selects only within the selection. |
| Ctrl+I | Invert selection. Box selection = blocks outside the box in the world; cell-set selection = the remaining blocks within its range |
| Ctrl+A | The whole range that contains blocks |
| Esc | Clear selection |
Since 0.9.10: Alt+drag down (or Shift+mouse wheel down) while dragging lets you select below the starting layer.
- While dragging, the text “Selection W×H×D = N blocks” is shown.
- Screen rectangle selection does not pick blocks hidden behind blocks in front. Turn on Shift+drag screen select: include hidden in the Sun window on the viewport left bar to include hidden blocks.
- You can also make a screen selection with Shift+drag · Ctrl+Shift+drag in the Place tool.
Face handles
Section titled “Face handles”When there is a box selection in the Selection tool, small square handles appear at the center of its six faces.
- Dragging a handle pushes or pulls only that face. The opposite face stays put. The minimum is 1 block.
- Colors: red = X faces, green = top/bottom faces (height), blue = Z faces.
- Press Esc to return to the box before dragging.
- Cell-set selections have no handles.
- Face handles change only the selection box. Blocks stay as they are.
Selecting by numbers
Section titled “Selecting by numbers”Enter the coordinates of the two end cells in Min · Max (X · Y · Z) of the Selection group in the Details panel. For a cell-set selection, the bounding box is shown; editing it turns it into a box selection.
W / E / R gizmos
Section titled “W / E / R gizmos”When there is a block selection, turn on the region gizmo with W · E · R. One drag is one undo step. The selection follows the result.
| Key | Gizmo | Drag | Alt+drag |
|---|---|---|---|
| W | Move | Drag an axis arrow, a plane or the center to move. A ghost shows the destination. | Duplicate (original stays) |
| E | Rotate | Drag the ring to rotate in 90° steps. Hold Shift to also show the X and Z rings. Stairs and doors rotate with it. | (none) |
| R | Size | Drag the + or − handles of the box to stretch or shrink it on the grid. | Array (duplicates once per selection size along the dragged axis) |
Since 0.9.9: Cells added with Size (R) continue the single end-face layer as it is (block, state, actor). Stretching terrain continues its height and grass/dirt cross-section. A box filled with a single block type is the same as filling with that block.
- When you shrink, selected cells that end up outside are removed. Patterns inside the box stay as they are.
- Empty cells in the selection are not filled. Blocks of other actors are not overwritten.
- A new box made with Size can be up to 4 million blocks.
- R is the Size gizmo only when a gizmo is already on. Pressed without a gizmo, it rotates the selection 90° (table below).
- Press Q to turn the gizmo off. Esc cancels a gizmo drag in progress.
- Move and Size move in units of the grid snap value (1 block or more) on the viewport right bar.
Region operations by key
Section titled “Region operations by key”| Key | Action |
|---|---|
| R · Shift+R | Rotate 90° clockwise · counterclockwise (when the gizmo is off). Block orientations rotate too. |
| X · Shift+X · U | Flip left/right (X axis) · front/back (Z axis) · up/down |
| Arrow keys | 1 block forward, back, left or right relative to the camera (Shift = 10 blocks) |
| PgUp · PgDn | 1 block up · down (Shift = 10 blocks) |
| K | Array: duplicates by the count, gap and direction in the Tools panel |
| End | Drop to floor: lowers until it touches a block below (block selection, props, actors). |
| Del | Clears the selection (only the chosen cells for a cell-set selection) |
| H | Hides the selection on screen only. H with no selection = show everything hidden |
- In a cell-set selection, the arrow keys, PgUp and PgDn move only the chosen cells.
- Rotate, flip and array use the whole bounding box even for a cell-set selection.
Array (K)
Section titled “Array (K)”In the Selection tool, the array fields are in the Selection group of the Tools panel.
| Field | Value | Meaning |
|---|---|---|
| Array count | 1–1000 (default 3) | Number of copies |
| Gap (blocks) | −64–256 (default 0) | Empty cells between copies |
| Direction | Camera forward · Up · Down · East (+X) · West (−X) · South (+Z) · North (−Z) | Direction to line them up |
| Create array | Same as K. |
The same group also has Rotate 90°, Rotate -90°, Flip left/right, Flip front/back, Flip up/down and Rotate clipboard buttons. Rotate clipboard rotates what you copied by 90°.
Copy and paste
Section titled “Copy and paste”| Key | Action |
|---|---|
| Ctrl+C | Copies the selection. For a cell-set selection, only the chosen cells are copied. |
| Ctrl+X | Cut (copy + delete) |
| Ctrl+V | Pastes with the cell under the mouse (placement spot) as the minimum corner. Air cells are skipped. The pasted region becomes selected. |
One paste becomes one actor.
Right-click menu
Section titled “Right-click menu”Right-click the viewport without dragging to open a menu. If nothing is selected, the clicked block is selected first.
| Item | Action |
|---|---|
| Cut · Copy · Paste here | Same as the table above. Paste goes to the right-clicked cell. |
| Duplicate (beside) | Duplicates the selection beside itself, one selection size toward the screen’s right. |
| Delete | Deletes the selection (or the selected prop) |
| Selection → make actor | Groups the selected blocks into a new actor. |
| Select all matching blocks · Same block within selection only | Same as Shift+E. |
| Invert selection | Ctrl+I |
| Camera here | Moves the view close, centering the clicked spot on screen. |
| Drop to floor | End |
| Hide · Show all hidden | H |
| Quick add | Adds an actor, marker, etc. at the clicked cell. |
Options
Section titled “Options”| Setting | Where | Meaning |
|---|---|---|
| Min · Max | Details › Selection | Selection box coordinates |
| Array count · Gap (blocks) · Direction | Tools panel › Selection | K array |
| Grid snap | Viewport right bar | Gizmo move step |
| Rotation snap | Viewport right bar | Rotation step of the prop and actor gizmos |
| Shift+drag screen select: include hidden | Viewport left bar › Sun | Screen selection also picks hidden blocks |
Shortcuts
Section titled “Shortcuts”| Key | Action |
|---|---|
| 4 · Q | Selection tool |
| W · E · R | Move · Rotate · Size gizmo |
| R · Shift+R | Rotate 90° (when there is no gizmo) |
| X · Shift+X · U | Flip |
| Arrow keys · PgUp · PgDn | Move (Shift = 10 blocks) |
| K | Array |
| End | Drop to floor |
| Shift+E · Ctrl+I · Ctrl+A | Same block · invert · all |
| Ctrl+C · Ctrl+X · Ctrl+V | Copy · Cut · Paste |
| Del | Clear |
| H | Hide / show all |
| F | Frame the selection |
| Esc | Cancel gizmo or handle drag → clear selection |
| Ctrl+Z | Undo (selection box too) |
Tips / cautions
Section titled “Tips / cautions”Since 0.9.9: Undo and redo also restore the selection box. If you undo after moving or stretching with a gizmo, the selection returns to its original place too.
- Changes to the selection alone (selecting, face handles, numeric input) are not recorded in the undo history.
- If W · E · R do nothing, there is no block selection. Press Q and select a region first.
- Hide (H) hides on screen only. It does not affect saving or exporting.
- Moving a very large selection (over 1.5 million blocks) with a gizmo is processed as a large operation with progress.
- You can save the selected region as a prefab (Prefabs) or stretch it with Face extrude.