The In Game Editor
The icon next to a definition's Origin field opens the region editor in
game: a golden axe to mark blocks with, a live preview of the region those marks describe, and a hotbar of
tools to move, turn and resize it. The same editor opens from the command line:
/tw region edit <definition>
which makes quick adjustments painless. Walk to the region, run the command, nudge, apply. See Region Commands for the permission it needs.
Marking the shape
The preview shows exactly the region that will be saved: glowing solid lines trace the shape's edges in the region's color, visible even through terrain, with a dusting of particles on the surface between them. What your clicks mean depends on the shape:
- Cuboid, Ellipsoid and Capsule
- Sphere
- Cone
- Polygon
Left click one corner block and right click the opposite corner. The cuboid covers both marked blocks fully. The ellipsoid and the capsule are inscribed in the marked box.
Left click the center block and right click a block on the boundary. The distance between the two becomes the radius.
Left click the apex, the point the cone starts from, and right click the block the cone should aim at. The length, yaw, and pitch are computed for you. The half angle keeps the value set in the entry.
Walk the outline of the area and left click blocks along it. You need at least three points; the moment
the third one lands, the outline becomes the region and the marks turn into glowing corner handles on its
bottom and top rims. The prism height keeps the halfHeight value set in the entry.
From then on each click has one meaning:
- Left click adds a corner on the wall nearest to where you clicked.
- Right click removes the corner you aim at. Aim anywhere along a corner's vertical edge, straight through walls, and its handle pulses white under your crosshair.
- F selects the aimed corner: it and its edge glow gold, the boss bar names the point, and a glowing push axis appears through it, following the way you face. Pressing F again lets the selection go, or moves it to another hovered corner.
With a point selected:
- Left click pushes it half a block along the axis; the arrowhead shows where.
- Right click pulls it back.
- Sneak scroll slides it in quarter block steps.
- Sneak right click picks it up. A picked up point follows your crosshair, scroll sets the carry distance, right click places it and left click puts it back.
The handles always sit on the region's real corners, so points you moved with the resize tool stay exactly where you put them, and reopening a saved polygon shows its corners ready to edit.
Every mark clicks in with a sound and an action bar confirmation, so you always know a click registered. The preview reshapes the moment your marks are complete, and marking a single point again reshapes it again, so one corner landing wrong never costs you the whole capture. A floating readout above the region shows its name, origin, rotation, size, and how many unsaved changes you have, and it updates live as you work.
Applying and publishing
When there is something to save, the boss bar turns green and the gray Apply dye turns lime. Click it to write the values to the entry. Nothing touches the entry until you apply; closing the editor discards whatever you changed. For the market square: left click the block at the center of the square, right click a block at its edge, and apply.
Applying saves to the entry, and the region goes live once you publish on the web panel. Until then the
floating readout shows saved, awaiting publish, and the workspace tags the region with
● unpublished changes, so a saved but not yet published region is never mistaken for a live one.
While the editor is open, boundary displays and command visualizations of the region you are editing are hidden for you, so the only boundary you see is the editor's own preview. They come back the moment you close the editor.
The tools only work on constant values. When a field like origin is bound to a variable (see
Dynamic Regions), the tool tells you so in the action bar and leaves the
variable untouched. The marking wand behaves the same way: it refuses to capture a region whose placement
follows a variable, rather than replacing the binding with a fixed position.
The preview only renders within 48 blocks of you and is capped per tick. You can tune this with the
region.content.preview_render_distance and region.content.preview_density snippets.
The rest of the editor
- Transform Tools: moving, carrying, rotating, resizing, teleporting, and the undo history.
- Editing Through Walls: driving the tools from spectator mode when the blocks you need are buried.
- The Workspace: seeing every region around you at once, and editing alongside other builders.