Maintenance script: PrefabRenderer wiki

2026-10-20T21:29:30Z

PrefabRenderer wiki

New page

== Supported files ==
{| class="wikitable"
! Editor !! View type !! Files !! Priority
|-
| Hytale Prefab 3D View || <code>hytalePrefabViewer.preview</code> || <code>*.prefab.json</code> || option
|}
Priority "option" means the 3D view is never opened automatically. Prefab files keep opening in the text editor. The extension adds no language and no file association.

== Commands ==
{| class="wikitable"
! Command ID !! Title !! What it does
|-
| <code>hytalePrefabViewer.openPreview</code> || ''Hytale: Open Prefab Preview'' || Opens the 3D view of the selected or active <code>*.prefab.json</code> file to the side of the current editor.
|}

=== Where the command appears ===
{| class="wikitable"
! Place !! Shown when
|-
| Editor title bar (button with the preview icon) || The file in the editor is a <code>*.prefab.json</code> file and the editor is not already the 3D view
|-
| Explorer context menu || The right-clicked file is a <code>*.prefab.json</code> file
|-
| Command Palette || The active file is a <code>*.prefab.json</code> file
|}

== Keybindings ==
The extension contributes no keybindings. You can assign one to <code>hytalePrefabViewer.openPreview</code> in ''File → Preferences → Keyboard Shortcuts''.

== Settings ==
All settings are in the section ''Prefab Renderer'' of the settings editor.

{| class="wikitable"
! Setting !! Type !! Default !! Scope !! What it does
|-
| <code>hytalePrefabViewer.assetsZip</code> || string || <code>~/.var/app/com.hypixel.HytaleLauncher/data/Hytale/install/release/package/game/latest/Assets.zip</code> || machine-overridable || Path of the vanilla <code>Assets.zip</code> installed by the Hytale launcher. It is read in place, never extracted. <code>~</code> is expanded. An empty value uses the default.
|-
| <code>hytalePrefabViewer.assetFolders</code> || array of strings || <code>[]</code> || resource || Additional asset folders, for example a mod's <code>src/main/resources</code>, with the layout <code>Server/Item/Items/...</code> and <code>Common/...</code>. They take precedence over <code>Assets.zip</code>, earlier entries over later ones.
|-
| <code>hytalePrefabViewer.detectAssetFolder</code> || boolean || <code>true</code> || resource || Automatically adds the asset folder that contains the opened prefab (the nearest parent folder with <code>Server/Item/Items</code>). It is searched before the configured folders.
|}

* Relative paths in <code>assetsZip</code> and <code>assetFolders</code> are resolved against the first workspace folder.
* <code>assetsZip</code> is a machine setting that can be overridden per workspace. The other two can be set per workspace folder.
* Changes take effect right away: all caches are dropped and open 3D views are redrawn.

See [[PrefabRenderer:Asset Sources|Asset Sources]] for the search order.

=== Example ===
<code>settings.json</code> with a custom <code>Assets.zip</code> location and one extra mod folder:
<pre>
"hytalePrefabViewer.assetsZip": "C:/path/to/Assets.zip",
"hytalePrefabViewer.assetFolders": ["C:/code/MyOtherMod/src/main/resources"]
</pre>
Replace the paths with the real locations on your system.

== Output and logging ==
The extension writes to the output channel ''Prefab Renderer'' (''View → Output''). It logs which asset sources are used, how long opening <code>Assets.zip</code> took and why a prefab could not be rendered. Use ''Developer: Set Log Level...'' to get more detail, for example the build time of each scene at the level ''Debug''.

{{PrefabRenderer Nav}}

PrefabRenderer:Commands and Settings - Revision history

Maintenance script: PrefabRenderer wiki