Description
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
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 testOutput: 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.htmlin a browser (clone it from github)
License
MIT