Contents
User Manual — Minecraft Block Editor by Moulberry — Requires Fabric + Minecraft 1.21+
Axiom is a client-side Minecraft mod that turns the game into a real-time block editor. It sits on top of normal Minecraft: you can toggle a full editor overlay, use in-hand tools without ever opening the overlay, or flip on capability modifiers that change how vanilla placement behaves.
Full-screen dockable overlay with tools panel, palette, clipboard, history, blueprint browser, world properties, and more. Toggle it with a keybind at any time.
In-hand editing operations from the hotbar: move, clone, stack, mirror, smear, erase — no overlay needed.
Toggle-able modifiers: angel placement, infinite reach, no-clip, replace mode, bulldozer, no updates, and more.
Press the Toggle Editor UI keybind to enter or exit the editor overlay. Your cursor is freed from the game and the editor camera takes over. Press it again to return to vanilla Minecraft.
| Action | Default |
|---|---|
| Rotate camera | RMB |
| Arcball / orbit around a point | Alt + RMB |
| Pan camera | Alt + LMB |
| Crosshair camera (lock cursor to centre) | MMB |
| Move (fly) | WASD + Space / Shift |
| Sprint | Left Ctrl |
| Use active tool | LMB |
| Adjust tool radius | Ctrl + Scroll |
All windows are dockable, resizable, and individually toggleable from the Window menu.
.blueprint files. Supports folders, tags, upload to server.The Style Editor (Window menu) gives full control over UI colours, sizes, and rounding. Export/import themes via clipboard.
Axiom supports up to 9 named editor viewports. Switch between them with Ctrl+1 through Ctrl+9. Each viewport can be pinned to a specific world location.
Axiom uses a voxel boolean selection — a set of individual blocks that can be accumulated, subtracted, or intersected. Once you have a selection, operations, clipboard actions, and builder tools all respect it.
flowchart TD
A([Choose Selection Tool]) --> B{Selection Mode}
B -->|Add| C[Union with existing]
B -->|Subtract| D[Remove from existing]
B -->|Intersect| E[Keep overlap only]
B -->|Replace| F[Start fresh]
C & D & E & F --> G([Active Selection])
G --> H1[Operations\nFill / Replace / Hollow / Drain / Smooth]
G --> H2[Builder Tools\nMove / Clone / Stack / Mirror / Smear]
G --> H3[Clipboard\nCopy / Cut / Paste]
G --> H4[Modify Selection\nExpand / Shrink / Smooth / Distort]
| Tool | How It Works | Key Options |
|---|---|---|
| Box Select | Drag to define a rectangular region between two corners. Gizmo handles allow fine-tuning after drawing. Can also be set to Position + Size mode instead of Pos1/Pos2 corners. | Shrink to fit (trims air); create Marker Region |
| Magic Select | Click a block; flood-fills and selects all connected blocks that match by your chosen comparison. Like a 3D paint-bucket selection. | Comparison: Block, BlockState, Material, Solid, Any; range limit |
| Freehand Select | Paint over blocks to include them in the selection. Works like a brush. | Brush radius |
| Lasso Select | Draw a 2D polygon outline on screen; Axiom projects it into 3D space and selects all blocks within it. | Depth (how far into the screen), include non-solid blocks |
Use the Select menu after creating a selection:
| Modifier | Effect |
|---|---|
| Expand | Grows selection outward by N blocks in all directions |
| Shrink | Contracts selection inward by N blocks |
| Smooth | Rounds the edges of the selection shape |
| Distort | Applies noise to the selection boundary for organic edges |
| Filter | Restricts selection to blocks matching a mask |
| Bounding Box | Replaces selection with its axis-aligned bounding box |
| Clear | Deselects all blocks |
Painting tools apply blocks via a spherical (or configurable-shape) brush. They work in real time as you click and drag.
| Tool | Description | Notable Options |
|---|---|---|
| Painter | Standard spherical brush that paints blocks. Supports soft-edge falloff and merge-strokes to smooth continuous drags. | Modes: Active Block, Tiled Clipboard, Stamped Clipboard, Gradient; inner radius (hollow core) |
| Gradient Painter | Paints blocks as a gradient between two anchored positions. The position-to-block mapping follows a configurable curve. | Linear / Sphere gradient; Bezier / Linear / Nearest interpolation; lock Pos1 / Pos2 |
| Biome Painter | Paints biome data onto the world. Can fill the entire vertical column at each position. Optionally visualises biomes with colour overlay. | Fill vertically; biome visualisation toggle |
| Tool | Description | Notable Options |
|---|---|---|
| Noise Painter | Each block under the brush is placed or skipped probabilistically based on a noise function value at that position. Creates natural-looking irregular fills. | Noise types: Simplex, White, Splatter, Voronoi Edges, Worley, Metaball; octaves, scale, lacunarity, gain, jitter; 3D mode; anisotropic mode |
Noise Painter is the go-to for organic texturing — for example, scattering gravel across a stone floor or adding moss patches to walls.
| Tool | Description | Notable Options |
|---|---|---|
| Script Brush | Runs user-written Lua scripts as a brush. The script receives block position and context, and returns what to place. Enables any custom logic that the built-in tools cannot express. | Lua script editor; custom numeric / boolean parameters exposed to the script |
Scripts are saved and can be shared as plain .lua files.
Sculpting tools manipulate existing block surfaces rather than painting new blocks over them.
| Tool | Description | Notable Options |
|---|---|---|
| Sculpt Draw | Pulls blocks outward or pushes them inward along the surface normal. Think of it as clay sculpting — drag to add or remove material. | Invert direction; mask Y axis; strength; denoise pass |
| Rock Tool | Places rock-like organic formations at the cursor with noise-driven surface variation. Each click grows a natural-looking boulder. | Meld strength, noise radius, noisiness, smoothing (sigma) |
| Weld | Merges adjacent surfaces — fills gaps and smooths junctions between separate block masses. | Strength, threshold |
| Melt | Inverse of Weld — erodes block surfaces inward, thinning edges and removing small protrusions. | Strength, threshold |
| Extrude (sculpt) | Expands or shrinks a one-block-thick surface shell. Displace mode moves the surface instead of duplicating it. | Mode: Expand / Shrink / Displace |
| Tool | Description | Notable Options |
|---|---|---|
| Freehand Draw | Drag the mouse through 3D space to place blocks along the drawn path. | Brush radius |
| Path | Place a series of control points; Axiom draws a smooth tube or corridor through them. Automatically uses stairs and slabs on diagonal runs. | Curve types: Bezier, Catmull-Rom, Catenary, Bresenham Line, DDA Line; easing; looped / inverted; extend to ground |
| Text | Renders text as placed blocks in the world. Choose font (including a built-in pixel font), size, direction, and rasterisation mode. | Font; size; direction (all 6 faces); full-cube mode |
| Stamp | Scatters saved blueprints randomly across a surface. Each blueprint has its own placement probability. | Per-blueprint chance; min spacing; random yaw / flip; extend foundation to ground; deferred vs immediate placement |
| Floodfill | Fills an enclosed hollow space with a chosen block — a 3D paint bucket. | Target block |
| Fluid Ball | Places a sphere of simulated fluid at the cursor. | Radius; fluid type |
| Tool | Description |
|---|---|
| Modelling | Freeform 3D mesh editing via moveable control-point gizmos. Move individual vertices in world space to deform a block mesh. Supports full undo. |
| Generator | Places organic tree forms (Ash, Cyprus types) at the clicked location with natural variation. |
Terrain tools work on height and surface topology. They operate like a heightmap editor layered on top of the block grid.
| Tool | Description | Modes / Key Options |
|---|---|---|
| Elevation | Raises or lowers terrain under the brush. Clicking continuously keeps raising/lowering; apply-once mode makes a single change per click. | Raise, Lower, Flatten, Flatten Up; Y limit; falloff; rate; smoothing; dynamics; load custom heightmap image |
| Slope | Click two points; Axiom grades the terrain between them to form a smooth ramp. | Shape: Cone or Plane |
| Smooth | Blurs terrain height values under the brush to remove sharp spikes and jagged edges. | Stable / Grow / Melt modes; strength; block ratio; fix edges |
| Distort | Displaces blocks using a noise vector field. Creates organic wrinkled or turbulent terrain. | Per-axis distance control; scale; iterations; smooth edges |
| Roughen | Adds or removes surface micro-detail (small bumps and divots). | Add / Remove mode; ratio; min exposed faces |
| Blend | Softens the transition between different block types at their borders. | Spread / Warp modes; spread distance; spread power; falloff |
| Shatter | Fractures a region into irregular noise-edged shards, as if a rock cracked. | Axis: X / Y / Z / 3D; scale; width; use active block for shard fill |
The Clentaminator tool (via server-side API) converts terrain biomes: sets ground type (Grass, Dirt, Sand, Gravel, Stone), adds vegetation, and controls farmland moisture and ocean-floor fertility.
The Shape tool places geometric primitives. Select a category and shape in Tool Options, then click (or click-and-drag) to place. A live preview appears before you confirm.
Three-dimensional filled or hollow volumes:
Two-dimensional surfaces placed in 3D space:
Control-point driven surface patches:
Smart Surface shows a live mesh wireframe overlay as you edit control points.
| Option | Effect |
|---|---|
| Hollow | Places only the shell, leaving the interior empty |
| Separate X/Z (or H/V) | Unlocks horizontal and vertical dimensions independently |
| Rotation mode: Auto / Keep / Reset | Controls whether rotation carries over between placements |
| Pivot: Base / Centre | Sets whether you place from the bottom or the centre of the shape |
| Gizmo space: Global / Local | Whether rotation handles align to world axes or the shape's own axes |
Extrude point (E) | Extrudes the nearest control point outward while placing |
| Tool | Description |
|---|---|
| Ruler | Click to place measurement points. Axiom shows Euclidean distance, Manhattan distance, bounding box dimensions, yaw, and pitch between each segment. You can split a segment, jump to the midpoint, and keep multiple rulers active at once. |
| Annotation | Places a named text label at a world position. All annotations are listed in the Annotations window and can be shown or hidden as an overlay. |
Operations apply a batch transformation to the current selection. Access them from the Operations menu or via keybind. Most open a settings dialog before executing. After every operation an undo entry is created.
Quick shortcuts: Ctrl+F Quick Fill, Ctrl+R Quick Replace — these use the last-used settings and skip the dialog.
| Operation ↕ | Category ↕ | What It Does |
|---|---|---|
| Fill | Fill | Fills the entire selection with the chosen block |
| Fill Outline | Fill | Fills only the outer edge faces of the selection bounding box |
| Fill Top | Fill | Fills only the topmost layer of the selection |
| Fill Bottom | Fill | Fills only the bottommost layer |
| Fill Walls | Fill | Fills the four vertical sides of the selection box |
| Fill Nearest | Fill | Replaces every air block with its nearest non-air neighbour (closes gaps) |
| Fill Gaps | Fill | Fills enclosed interior gaps |
| Fill Unreachable | Fill | Fills all positions not reachable from outside the selection by flood-fill |
| Replace | Replace | Replaces one block type with another throughout the selection |
| Type Replace | Replace | Smart material-aware replace: maps block shapes across materials (e.g. any stair becomes the active block's stair type) |
| Hollow | Structure | Removes all interior blocks, leaving only the shell |
| Drain | Structure | Removes all liquid blocks in the selection |
| Waterlog | Structure | Waterloggs all eligible blocks in the selection |
| Gravity | Structure | Simulates block gravity for all falling-block types in the selection |
| Set Biome | Structure | Overwrites the biome for all blocks in the selection |
| Smooth | Modify Selection | Rounds the edges of the selection shape |
| Distort | Modify Selection | Applies noise to the selection boundary for organic edges |
| Expand | Modify Selection | Grows selection outward by N blocks |
| Shrink | Modify Selection | Contracts selection inward by N blocks |
| Filter | Modify Selection | Restricts selection to blocks that pass a mask |
| Bounding Box | Modify Selection | Replaces selection with its axis-aligned bounding box |
| Clear | Modify Selection | Deselects all blocks |
| Analyze | Analysis | Counts and lists block-type distribution within the selection |
| Autoshade | Analysis | Applies ambient occlusion and sun shading using the palette block colours. Options: AO, Global Illumination, Sun Shading, Dither, palette filtering |
| Generate Colour Field | Analysis | Generates a colour-gradient field within the selection volume |
| Animated Rebuild | Special | Replays construction history as a time-lapse animation |
| Trigger Updates | Special | Fires neighbour block updates for all blocks in the selection |
| Trigger Updates & Tick | Special | Fires neighbour updates and a block tick for all blocks |
Builder Tools operate without the Editor UI overlay. Assign the Builder Tool to a hotbar slot, select it, then use the actions below. The current selection is shown as a highlight in the world. All actions create undo entries.
| Action | What It Does | Scroll Wheel |
|---|---|---|
| Move | Picks up and moves the selected region. Click to confirm the new position. The original blocks are deleted. | Adjusts move offset / direction |
| Clone | Places a copy of the selection at the target location. Original stays in place. | Repositions clone offset |
| Erase | Removes blocks. Sub-modes: Delete (single click removes one block), Erase Box (drag a rectangle), Erase Connected (flood-fill delete). | — |
| Stack | Repeats the selection in a direction N times, placing copies end-to-end. | Adjusts repetition count / direction |
| Smear | Stretches blocks in a direction, dragging their column along as you scroll. | Extends smear distance |
| Mirror | Reflects the selection across a chosen axis. Supports X, Y, and Z. | — |
| Extrude | Extrudes a face of the selection outward by one layer at a time. | — |
| Setup Symmetry | Places a symmetry plane in the world. All subsequent block edits are automatically mirrored. Supports flip, rotate, and nudge of the plane. Deactivates beyond a configurable range. | — |
X, Y, or Z to lock the scroll direction to that axis only.
Capabilities are toggle-able modifiers to normal Minecraft behaviour. Toggle each via the Context Menu (hold or tap Alt) or a dedicated keybind. Active capabilities are shown in the HUD.
| Capability | Effect When On |
|---|---|
| Angel Placement | Place blocks in mid-air without needing an adjacent support surface. |
| Bulldozer | Hold left-click to break blocks continuously at high speed. Great for clearing large areas. |
| Fast Place | Place blocks much faster than vanilla allows while still maintaining precise control over which block is placed. |
| Force Place | Bypasses all block placement restrictions (entity collisions, block limits, placement rules). |
| Infinite Reach | Removes the block interaction distance limit. Configurable maximum reach in blocks, or truly unlimited. |
| No Clip | Move through solid blocks while flying. Requires flight mode to be active. |
| Phantom | Move through blocks without triggering them: pressure plates, tripwires, and sensors are not activated. |
| No Updates | Suppress neighbour block updates when placing or breaking blocks. Allows unsupported blocks: sand mid-air, floating torches, etc. |
| Replace Mode | Right-clicking a block replaces it with the held block instead of placing adjacent. Combine with Type Replace to preserve block shape (e.g. replace any stair material while keeping the stair orientation). |
| Tinker | Right-clicking with an empty hand activates quick interaction: set block states, toggle doors/levers, inspect block properties. |
These are visual-only overlays, not persistent world changes:
| Helper | What It Shows |
|---|---|
| Show Collision Mesh | Red outline around block collision boxes |
| Show Light Blocks | Makes otherwise invisible light-source blocks visible and clickable |
| Show Structure Void Blocks | Renders structure void blocks in-world |
| Expand Hitboxes to Full Cube | Makes small blocks (buttons, torches) easier to click |
| Make Fluid Hitboxes Solid | Allows clicking on fluid surfaces to destroy or place blocks on them |
| Prevent Interactions | Prevents opening containers, doors, and signs while holding a block |
The clipboard holds blocks, block entities, and entities. It persists until you copy or cut again. The Clipboard window shows what is stored and exposes paste options.
| Action | Keybind | Notes |
|---|---|---|
| Copy | Ctrl+C | Copies blocks and entities from the selection |
| Copy With Air | (unbound) | Includes air blocks in the copy; they will overwrite on paste |
| Cut | Ctrl+X | Copies then deletes the selection |
| Paste | Ctrl+V | Shows placement gizmo; click to confirm position |
| Paste and Select | (unbound) | Pastes and simultaneously selects the pasted region |
| Duplicate | Ctrl+J | Copies the selection and immediately starts a paste |
| Algorithm | Quality | Best For |
|---|---|---|
| Nearest Neighbor | Fast | 90-degree rotations, large structures |
| RotSprite | High | Arbitrary-angle rotations with less aliasing |
| Scale2x | High | 2x integer upscale with edge enhancement |
| Scale3x | High | 3x integer upscale with edge enhancement |
flowchart LR
A([Select Region]) --> B["Copy\nCtrl+C"]
B --> C["Save Blueprint\nCtrl+P"]
C --> D[("Blueprint File\n.blueprint")]
D --> E[Blueprint Browser]
E --> F{Use As}
F -->|Paste once| G["Ctrl+V to paste"]
F -->|Scatter| H[Stamp Tool]
F -->|Share| I[Upload to Server]
Import and export standard .schem schematic files via File → Import Schematic and File → Export Schematic. After import the structure lands in the clipboard ready to paste.
Tool Masks restrict which blocks any tool is allowed to read from or write to. They are global — every tool respects the active mask. Open the mask editor from the Tool Masks window or menu.
| Node | What It Matches |
|---|---|
| Block | A specific block or list of blocks |
| Biome | Blocks that fall within a specific biome |
| Surface | Blocks that have at least one adjacent air block (surface-exposed) |
| Can See Sky | Blocks with an unobstructed vertical path to the sky |
| In Selection | Blocks that are inside the current selection |
| Above / Below | Blocks above or below a Y coordinate |
| Adjacent / Neighbor | Blocks that are next to a block matching a sub-condition |
| Near | Blocks within a specified radius of a position |
| Angle | Block faces at a specified surface angle (90 = up, 0 = horizontal, -90 = down) with a configurable tolerance range |
| OFFSET | Shifts which block is tested by the sub-mask by a position offset |
| NOT | Inverts the result of a sub-mask |
| AND | All connected sub-masks must match |
| OR | At least one connected sub-mask must match |
All keybinds are fully rebindable in the Keybinds window. Two preset profiles: Axiom Defaults and Blender-like. Click a column header to sort.
| Action ↕ | Category ↕ | Default |
|---|---|---|
| Undo | Edit | Ctrl+Z |
| Redo | Edit | Ctrl+Y |
| Copy | Edit | Ctrl+C |
| Cut | Edit | Ctrl+X |
| Paste | Edit | Ctrl+V |
| Duplicate | Edit | Ctrl+J |
| Delete | Edit | Del |
| Save Blueprint | Edit | Ctrl+P |
| Extrude Point | Edit | E |
| Confirm placement | Edit | Enter |
| Quick Fill | Operations | Ctrl+F |
| Quick Replace | Operations | Ctrl+R |
| Rotate Placement | Operations | Ctrl+R |
| Flip Placement | Operations | Ctrl+F |
| Rotate Camera | Camera | RMB |
| Arcball Camera | Camera | Alt+RMB |
| Pan Camera | Camera | Alt+LMB |
| Crosshair Camera | Camera | MMB |
| Use Tool | Camera | LMB |
| Adjust Tool Radius | Camera | Ctrl+Scroll |
| Move Forward | Movement | W |
| Move Left | Movement | A |
| Move Backward | Movement | S |
| Move Right | Movement | D |
| Move Up | Movement | Space |
| Move Down | Movement | Left Shift |
| Sprint | Movement | Left Ctrl |
| Nudge Forwards | Gizmo | Up Arrow |
| Nudge Backwards | Gizmo | Down Arrow |
| Nudge Right | Gizmo | Right Arrow |
| Nudge Left | Gizmo | Left Arrow |
| Nudge +Y | Gizmo | Page Up |
| Nudge -Y | Gizmo | Page Down |
| Toggle Editor UI | Capability | (set by user) |
| Toggle Angel Placement | Capability | (set by user) |
| Toggle Bulldozer | Capability | (set by user) |
| Toggle Fast Place | Capability | (set by user) |
| Toggle Force Place | Capability | (set by user) |
| Toggle No Clip | Capability | (set by user) |
| Toggle No Updates | Capability | (set by user) |
| Toggle Replace Mode | Capability | (set by user) |
| Toggle Infinite Reach | Capability | (set by user) |
| Toggle Tinker | Capability | (set by user) |
| Show Biomes | View | Ctrl+B |
| Switch Viewport 1-9 | View | Ctrl+1 to Ctrl+9 |
| Context Menu | Ingame | Alt |
| Jump to Block | Ingame | (set by user) |
| Orbit Camera | Ingame | (set by user) |
| Swap to Last Tool | Tools | (set by user) |
The World Properties window controls game rules without leaving the editor. Changes take effect immediately.
Axiom 5.4.1 • Fabric mod • Minecraft 1.21+ • by Moulberry