Maintenance script: BlockyRenderer wiki

2026-10-20T21:29:21Z

BlockyRenderer wiki

New page

The '''Blocky Editor (3D)''' is a second editor for the same <code>.blockymodel</code> file. It shows the same 3D view as the preview, but you can change nodes there. Every change becomes a small edit in the JSON text.

== Opening the editor ==
* The pencil icon ''Edit in 3D Editor'' in the title bar of the text editor, the preview or the Blocky Preview.
* Right-click a model in the Explorer or in the model browser and choose ''Edit in 3D Editor''.
* The pencil icon in the title bar of the '''Nodes''' view.
* The command <code>Blocky: Edit in 3D Editor</code>.
* ''Open With…'' on a <code>.blockymodel</code> file and then ''Blocky Editor (3D)''.

If the preview shows the same model, the editor takes the place of the preview. If you open it from a Blocky Preview tab, it replaces that tab. Otherwise it opens beside the active editor.

== How changes are saved ==
* Each change is written into the text document at exactly the affected spot. The rest of the file stays byte for byte as it was, including fields the extension does not know.
* Saving, the unsaved dot and undo and redo (<code>Ctrl+Z</code>, <code>Ctrl+Y</code>) come from VS Code. One command is one undo step.
* Numbers are rounded to 6 decimal places, as in vanilla files.
* New text uses the indentation and line endings of the file. Without indentation in the file, it uses two spaces and LF.
* If the 3D view does not match the text at the moment, for example while the JSON is broken, a command is discarded. The view then loads the current state of the file.

== Selecting ==
Click a node in the 3D view to select it. The selection is shared: the text, the '''Nodes''' view and every other 3D view of the same model show the same node.

== Keys in the 3D view ==
The editor shows a short key list in the lower right corner.
{| class="wikitable"
! Key !! Action
|-
| <code>Delete</code> || Delete the selected node with its children
|-
| <code>Ctrl+D</code> || Duplicate the selected node with its children
|-
| <code>H</code> || Show or hide the shape of the selected node
|-
| <code>F2</code> || Rename the selected node
|-
| <code>Esc</code> || Clear the selection
|}
On macOS, <code>Cmd+D</code> also duplicates. The keys do nothing while the focus is in a text field or list.

== Properties panel ==
On the right side of the editor, the '''Properties''' panel shows the selected node.
{| class="wikitable"
! Row !! Shown for !! Field in the file
|-
| Name || all || <code>name</code>
|-
| Type || all || <code>shape.type</code>, read only (Box, Quad or Group)
|-
| Position || all || <code>position</code>
|-
| Rotation ° || all || <code>orientation</code>. Shown as angles around X, Y and Z in degrees, stored as a quaternion.
|-
| Offset || all || <code>shape.offset</code>
|-
| Size || box, quad || <code>shape.settings.size</code>. A quad has only X and Y.
|-
| Stretch || all || <code>shape.stretch</code>
|-
| Normal || quad || <code>shape.settings.normal</code>: <code>+X</code>, <code>-X</code>, <code>+Y</code>, <code>-Y</code>, <code>+Z</code>, <code>-Z</code>
|-
| Visible || box, quad || <code>shape.visible</code>
|-
| Double-sided || box, quad || <code>shape.doubleSided</code>
|-
| Shading || box, quad || <code>shape.shadingMode</code>: <code>flat</code>, <code>standard</code>, <code>fullbright</code>, <code>reflective</code>
|}

=== Changing values ===
* '''Type''' a value and press <code>Enter</code> or leave the field. A comma is accepted as decimal point.
* '''Arrow keys''' <code>↑</code> and <code>↓</code> in a number field change the value by one step. The value is written to the file shortly after the last key press.
* '''Drag''' the axis letter (X, Y, Z) left or right. The 3D view moves along, the value is written when you release the mouse.
* Hold <code>Shift</code> for steps a tenth of the size.

{| class="wikitable"
! Value !! Arrow key step !! Drag step per pixel
|-
| Position, Offset, Size || 1 || 0.25
|-
| Stretch || 0.1 || 0.01
|-
| Rotation || 15° || 1°
|}

An empty name is not accepted, the old name comes back.

== New nodes ==
New nodes are added from the '''Nodes''' view. See [[BlockyRenderer:Blocky Renderer Tab#Nodes|Blocky Renderer Tab]]. A new node gets the next free <code>id</code> (highest id plus one) and a free name (<code>Box</code>, <code>Box2</code>, <code>Box3</code> and so on). A duplicate gets new ids for its whole subtree and a free name.

== Limits ==
* The editor has no animation list and plays no animations. Use the preview for that.
* Texture layouts are not edited in the editor. Change them in the text.

{{BlockyRenderer Nav}}

BlockyRenderer:Blocky Editor - Revision history

Maintenance script: BlockyRenderer wiki