PrefabRenderer:Commands and Settings

Supported files

Editor	View type	Files	Priority
Hytale Prefab 3D View	hytalePrefabViewer.preview	*.prefab.json	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

Command ID	Title	What it does
hytalePrefabViewer.openPreview	Hytale: Open Prefab Preview	Opens the 3D view of the selected or active *.prefab.json file to the side of the current editor.

Where the command appears

Place	Shown when
Editor title bar (button with the preview icon)	The file in the editor is a *.prefab.json file and the editor is not already the 3D view
Explorer context menu	The right-clicked file is a *.prefab.json file
Command Palette	The active file is a *.prefab.json file

Keybindings

The extension contributes no keybindings. You can assign one to hytalePrefabViewer.openPreview in File → Preferences → Keyboard Shortcuts.

Settings

All settings are in the section Prefab Renderer of the settings editor.

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

• Relative paths in assetsZip and assetFolders are resolved against the first workspace folder.
• assetsZip 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 Asset Sources for the search order.

Example

settings.json with a custom Assets.zip location and one extra mod folder:

"hytalePrefabViewer.assetsZip": "C:/path/to/Assets.zip",
"hytalePrefabViewer.assetFolders": ["C:/code/MyOtherMod/src/main/resources"]

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 Assets.zip 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.