Warning: This is an experimental debugging tool intended for local development servers only. Do not use on production or public servers. Use at your own risk.

Quick Installation

Clone the repo and run laits-entity-inspector-gui/update.ps1 (Windows) or update.sh (Linux/Mac)
Enable the mod in-game
Open laits-entity-inspector-gui/index.html in a browser

Run the updater again on new releases for auto-updating - you'll be notified on the dashboard.

Real-time entity debugging tools for Hytale modding.

Hytalor Integration: The inspector automatically detects when Hytalor is loaded, unlocking the Asset Browser and live asset patching — apply changes to game assets without restarting the server.

NPC Inspection: If you want in-depth NPC inspection, check out Alec's mod!
Alec's NPC Debug UI

Lait's Entity Inspector

alt text

Warning: This is an experimental debugging tool intended for local development servers only. Do not use on production or public servers. Use at your own risk.

Real-time entity debugging tools for Hytale modding.

What's New in v0.1.5

Live Instruction Inspector - A new Instructions tab in the component inspector shows the full instruction tree for any NPC entity. See which Instructions and InteractionInstructions are triggered, with a live event log feed of every sensor evaluation and action execution in real time.

Rename nodes - Right-click any instruction row (or click the Rename text) to give it a custom name. Custom names show up in the event log and are applied per entity type, so all Sheep share the same labels. Persists across sessions.
Collapse/expand - Click to collapse or expand instruction nodes. Alt+click to collapse or expand all sub-nodes at once.
Resizable event log - Drag the handle between the instruction tree and event log to resize. Size is persisted.
Fullscreen mode - Expand the component/instruction inspector to fill the entire viewport.
Font scaling - Adjust instruction text size from 90% to 150% with a slider. Persisted.

Debug Feature Toggles - A new Debug tab in Settings lets you enable/disable individual inspector subsystems at runtime. Useful for isolating side effects during debugging or reducing overhead when you only need specific features.

Toggle	What it controls
Position Tracking	Entity position polling each tick
Entity Lifecycle	Spawn/despawn event processing
On-Demand Refresh	Fresh data fetch before detail queries
Alarm Inspection	`inspector_get_entity_alarms`
Timer Inspection	`inspector_get_entity_timers`
Instruction Inspection	`inspector_get_entity_instructions`
Lazy Expansion	Field expansion requests
Asset Browser	Asset scanning and browsing
Patch Management	Hytalor patch publish/draft/delete
Entity Actions	Surname changes, teleport

All toggles default to on and persist to the config file.

Components

Entity Inspector Plugin

Hytale server plugin that collects live entity/component data via WebSocket.

Features:

Real-time entity spawn/despawn/update events
Component data serialization
WebSocket server on port 8765
Configurable update rate and entity filters

Commands:

/inspector - Show status
/inspector on|off - Toggle inspector
/inspector rate <ms> - Set update interval
/inspector pause|resume - Pause/resume updates
/inspector reload - Reload config

Inspector Web UI (clone from github)

ASCII/terminal-styled web interface for viewing entity data.

Features:

Real-time entity list with animations
Component inspector panel
Search/filter entities
Auto-reconnect

Manual Installation

Build the plugin:

   cd laits-entity-inspector
   gradle build -x test

Output: build/libs/laits-entity-inspector-<version>.jar

Copy the JAR to your world's mods folder:

   %APPDATA%/Hytale/UserData/Saves/<world>/Mods/

Start the Hytale server
Open laits-entity-inspector-gui/index.html in a browser (clone it from github)

License

MIT