Maintenance script: BlockyRenderer wiki

2026-10-20T21:29:21Z

BlockyRenderer wiki

New page

This page lists everything Blocky Renderer adds to VS Code: commands, keyboard shortcuts, settings, editors, views and file types.

== Commands ==
All commands are in the category '''Blocky'''. In the Command Palette they appear as <code>Blocky: …</code>.
{| class="wikitable"
! Command !! ID !! What it does !! In the Command Palette
|-
| Open Preview to the Side || <code>blockyRenderer.showPreviewToSide</code> || Opens the [[BlockyRenderer:Preview|preview]] beside the active editor || with a <code>.blockymodel</code> or <code>.blockyanim</code> file active
|-
| Open Preview || <code>blockyRenderer.showPreview</code> || Opens the preview in the active editor group || with a <code>.blockymodel</code> or <code>.blockyanim</code> file active
|-
| Show Source || <code>blockyRenderer.showSource</code> || Opens the JSON text of the file shown in the preview, Blocky Editor or Blocky Preview || with the preview, Blocky Editor or Blocky Preview active
|-
| Open Model Browser || <code>blockyRenderer.openModelBrowser</code> || Searches the workspace again and focuses the '''Models''' view || always
|-
| Refresh Model List || <code>blockyRenderer.refreshModels</code> || Searches the workspace for models again || always
|-
| Show in Model Browser || <code>blockyRenderer.browse</code> || Shows a model in the preview without opening it. Used by the entries of the '''Models''' view. || no
|-
| New Blocky Model… || <code>blockyRenderer.newModel</code> || Creates a new model, see [[BlockyRenderer:New Models|New Models]] || always
|-
| Edit in 3D Editor || <code>blockyRenderer.openEditor</code> || Opens the model in the [[BlockyRenderer:Blocky Editor|Blocky Editor]] || with a model, the preview or a model in the '''Nodes''' view
|-
| Open in Renderer Only || <code>blockyRenderer.openViewer</code> || Opens the file in the [[BlockyRenderer:Renderer Only|Blocky Preview]] || with a <code>.blockymodel</code> or <code>.blockyanim</code> file active
|-
| Open Blocky Files In… || <code>blockyRenderer.chooseOpenFilesIn</code> || Quick pick for <code>blockyRenderer.openFilesIn</code> || always
|-
| Add Box || <code>blockyRenderer.outline.addBox</code> || Adds a box in the '''Nodes''' view || with a model in the '''Nodes''' view
|-
| Add Quad || <code>blockyRenderer.outline.addQuad</code> || Adds a quad || with a model in the '''Nodes''' view
|-
| Add Group || <code>blockyRenderer.outline.addGroup</code> || Adds a group || with a model in the '''Nodes''' view
|-
| Rename || <code>blockyRenderer.outline.rename</code> || Renames a node || no
|-
| Duplicate || <code>blockyRenderer.outline.duplicate</code> || Duplicates a node with its children || no
|-
| Toggle Visibility || <code>blockyRenderer.outline.toggleVisible</code> || Shows or hides the shape of a node || no
|-
| Delete || <code>blockyRenderer.outline.remove</code> || Deletes a node with its children || no
|}

The node commands are described on [[BlockyRenderer:Blocky Renderer Tab#Nodes|Blocky Renderer Tab]].

== Keyboard shortcuts ==
{| class="wikitable"
! Key !! macOS !! Command !! When
|-
| <code>Ctrl+K V</code> || <code>Cmd+K V</code> || Open Preview to the Side || text editor of a <code>.blockymodel</code> or <code>.blockyanim</code> file has focus
|-
| <code>Ctrl+Shift+V</code> || <code>Cmd+Shift+V</code> || Open Preview || text editor of a <code>.blockymodel</code> or <code>.blockyanim</code> file has focus
|-
| <code>F2</code> || <code>F2</code> || Rename || '''Nodes''' view has focus
|-
| <code>Delete</code> || <code>Cmd+Backspace</code> || Delete || '''Nodes''' view has focus
|-
| <code>Ctrl+D</code> || <code>Cmd+D</code> || Duplicate || '''Nodes''' view has focus
|}

The keys inside the 3D view are listed on [[BlockyRenderer:Blocky Editor#Keys in the 3D view|Blocky Editor]] and [[BlockyRenderer:Animations#Keys|Animations]]. They are handled by the view itself and cannot be changed in the VS Code keyboard settings.

== Settings ==
{| class="wikitable"
! Setting !! Type !! Default !! Values
|-
| <code>blockyRenderer.autoOpenPreview</code> || boolean || <code>true</code> || Opens the 3D preview to the side when you open a <code>.blockymodel</code> or <code>.blockyanim</code> file.
|-
| <code>blockyRenderer.openFilesIn</code> || string || <code>text</code> ||
* <code>text</code>: text editor, with the preview beside it
* <code>editor</code>: renderer only, models in the Blocky Editor (editable), animations in the Blocky Preview
* <code>viewer</code>: renderer only, models and animations in the Blocky Preview (view only)
Sets <code>workbench.editorAssociations</code> at the same level (user or workspace). See [[BlockyRenderer:Renderer Only|Renderer Only]].
|-
| <code>blockyRenderer.newModelTemplate</code> || string || <code>cube</code> || What a new, empty <code>.blockymodel</code> file created in the Explorer is filled with:
* <code>cube</code>: a block-sized cube (32) with all six faces in the texture layout
* <code>empty</code>: a valid model without nodes
* <code>off</code>: the file stays empty
|}

The extension also changes the default of <code>files.associations</code>, so <code>*.blockymodel</code> and <code>*.blockyanim</code> open as JSON.

== Editors ==
Both are optional editors. They open through the commands above, ''Open With…'' or <code>blockyRenderer.openFilesIn</code>.
{| class="wikitable"
! Name !! View type !! Files
|-
| Blocky Editor (3D) || <code>blockyRenderer.editor</code> || <code>*.blockymodel</code>
|-
| Blocky Preview (3D) || <code>blockyRenderer.viewer</code> || <code>*.blockymodel</code>, <code>*.blockyanim</code>
|}

The preview beside the text is a webview panel with the view type <code>blockyRenderer.preview</code>.

== Views ==
{| class="wikitable"
! View !! ID !! Container
|-
| Models || <code>blockyRenderer.models</code> || Blocky Renderer (Activity Bar)
|-
| Nodes || <code>blockyRenderer.outline</code> || Blocky Renderer (Activity Bar)
|}

== Menus ==
{| class="wikitable"
! Where !! Entries
|-
| Title bar of a <code>.blockymodel</code> text editor || Open Preview to the Side, Edit in 3D Editor, Open in Renderer Only
|-
| Title bar of a <code>.blockyanim</code> text editor || Open Preview to the Side, Open in Renderer Only
|-
| Title bar of the preview || Show Source, Edit in 3D Editor
|-
| Title bar of the Blocky Editor || Show Source
|-
| Title bar of the Blocky Preview || Show Source, and Edit in 3D Editor for models
|-
| Explorer, right-click a folder || New Blocky Model…
|-
| Explorer, right-click a <code>.blockymodel</code> || Open Preview, Edit in 3D Editor, Open in Renderer Only
|-
| Explorer, right-click a <code>.blockyanim</code> || Open Preview, Open in Renderer Only
|}

The menus of the '''Models''' and '''Nodes''' views are listed on [[BlockyRenderer:Blocky Renderer Tab|Blocky Renderer Tab]].

== File types ==
{| class="wikitable"
! Extension !! Content !! Language !! Schema
|-
| <code>.blockymodel</code> || Hytale model || JSON || yes, see [[BlockyRenderer:New Models#JSON schema|New Models]]
|-
| <code>.blockyanim</code> || Hytale animation || JSON || no
|-
| <code>.png</code> || Texture, found in the folder of the model || ||
|}

Server JSON files under <code>Server/Models/</code> and <code>Server/Item/Items/</code> are read to find the model of an animation. See [[BlockyRenderer:Animations|Animations]].

{{BlockyRenderer Nav}}

BlockyRenderer:Commands and Settings - Revision history

Maintenance script: BlockyRenderer wiki