BlockyRenderer:Commands and Settings

From MutigerAffe Wiki
Jump to navigation Jump to search

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 Blocky: ….

Command ID What it does In the Command Palette
Open Preview to the Side blockyRenderer.showPreviewToSide Opens the preview beside the active editor with a .blockymodel or .blockyanim file active
Open Preview blockyRenderer.showPreview Opens the preview in the active editor group with a .blockymodel or .blockyanim file active
Show Source blockyRenderer.showSource 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 blockyRenderer.openModelBrowser Searches the workspace again and focuses the Models view always
Refresh Model List blockyRenderer.refreshModels Searches the workspace for models again always
Show in Model Browser blockyRenderer.browse Shows a model in the preview without opening it. Used by the entries of the Models view. no
New Blocky Model… blockyRenderer.newModel Creates a new model, see New Models always
Edit in 3D Editor blockyRenderer.openEditor Opens the model in the Blocky Editor with a model, the preview or a model in the Nodes view
Open in Renderer Only blockyRenderer.openViewer Opens the file in the Blocky Preview with a .blockymodel or .blockyanim file active
Open Blocky Files In… blockyRenderer.chooseOpenFilesIn Quick pick for blockyRenderer.openFilesIn always
Add Box blockyRenderer.outline.addBox Adds a box in the Nodes view with a model in the Nodes view
Add Quad blockyRenderer.outline.addQuad Adds a quad with a model in the Nodes view
Add Group blockyRenderer.outline.addGroup Adds a group with a model in the Nodes view
Rename blockyRenderer.outline.rename Renames a node no
Duplicate blockyRenderer.outline.duplicate Duplicates a node with its children no
Toggle Visibility blockyRenderer.outline.toggleVisible Shows or hides the shape of a node no
Delete blockyRenderer.outline.remove Deletes a node with its children no

The node commands are described on Blocky Renderer Tab.

Keyboard shortcuts

Key macOS Command When
Ctrl+K V Cmd+K V Open Preview to the Side text editor of a .blockymodel or .blockyanim file has focus
Ctrl+Shift+V Cmd+Shift+V Open Preview text editor of a .blockymodel or .blockyanim file has focus
F2 F2 Rename Nodes view has focus
Delete Cmd+Backspace Delete Nodes view has focus
Ctrl+D Cmd+D Duplicate Nodes view has focus

The keys inside the 3D view are listed on Blocky Editor and Animations. They are handled by the view itself and cannot be changed in the VS Code keyboard settings.

Settings

Setting Type Default Values
blockyRenderer.autoOpenPreview boolean true Opens the 3D preview to the side when you open a .blockymodel or .blockyanim file.
blockyRenderer.openFilesIn string text
  • text: text editor, with the preview beside it
  • editor: renderer only, models in the Blocky Editor (editable), animations in the Blocky Preview
  • viewer: renderer only, models and animations in the Blocky Preview (view only)

Sets workbench.editorAssociations at the same level (user or workspace). See Renderer Only.

blockyRenderer.newModelTemplate string cube What a new, empty .blockymodel file created in the Explorer is filled with:
  • cube: a block-sized cube (32) with all six faces in the texture layout
  • empty: a valid model without nodes
  • off: the file stays empty

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

Editors

Both are optional editors. They open through the commands above, Open With… or blockyRenderer.openFilesIn.

Name View type Files
Blocky Editor (3D) blockyRenderer.editor *.blockymodel
Blocky Preview (3D) blockyRenderer.viewer *.blockymodel, *.blockyanim

The preview beside the text is a webview panel with the view type blockyRenderer.preview.

Views

View ID Container
Models blockyRenderer.models Blocky Renderer (Activity Bar)
Nodes blockyRenderer.outline Blocky Renderer (Activity Bar)

Menus

Where Entries
Title bar of a .blockymodel text editor Open Preview to the Side, Edit in 3D Editor, Open in Renderer Only
Title bar of a .blockyanim 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 .blockymodel Open Preview, Edit in 3D Editor, Open in Renderer Only
Explorer, right-click a .blockyanim Open Preview, Open in Renderer Only

The menus of the Models and Nodes views are listed on Blocky Renderer Tab.

File types

Extension Content Language Schema
.blockymodel Hytale model JSON yes, see New Models
.blockyanim Hytale animation JSON no
.png Texture, found in the folder of the model

Server JSON files under Server/Models/ and Server/Item/Items/ are read to find the model of an animation. See Animations.

Blocky Renderer
Start Installation
Features Preview · Animations · Blocky Editor · Renderer Only · Blocky Renderer Tab · New Models
Reference Commands and Settings · File Format · FAQ · Version History
Links Project page on mutigeraffe.com · Download on the VS Code Marketplace