CurseForge · Hytale mod

Alec's NPC Debug UI!

An easy to use inspection tool for working with and debugging NPCs. Link the UI to NPCs and pin important data to your screen so you can see what's working and what's not.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Alec's NPC Debug UI! release should I use?

Updated today

Latest stable file Alec's NPC Inspector! v1.5.2

Game version 0.6

Mod system Built-in Hytale mod system

Alec's NPC Debug UI! Alec's NPC Inspector! v1.5.2 targets 0.6. Do not install it as a separate client mod. Enable it on the world host—the local server in singleplayer or the dedicated server in multiplayer. No required dependencies listed for this file.

Where it goes

Where should Alec's NPC Debug UI! be installed in Hytale?

Do not install it as a separate client mod. Enable it on the world host—the local server in singleplayer or the dedicated server in multiplayer.

Separate client mod Not supported

World host / dedicated server Required

Mod system for this release Built-in Hytale mod system

Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

Put Hytale mods on the world host or dedicated server. Singleplayer runs a local server too; Hytale does not use separate client mods.

Read the Hytale installation guide

What else does Alec's NPC Debug UI! Alec's NPC Inspector! v1.5.2 need?

Alec's NPC Inspector! v1.5.2. Change the file and its required mods may change too.

No required dependencies listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional project dependencies. Check the creator notes before changing an existing world.

Before you install it

Add Alec's NPC Debug UI! without breaking your instance.

Built for Alec's NPC Debug UI! Alec's NPC Inspector! v1.5.2. Pick another file and the loader, install side or required mods may change.

01
Stick to this file

Use Alec's NPC Inspector! v1.5.2. It targets 0.6; another release may target a different game build or dependency set.
02
Bring the mods it needs

This file does not list any required mods. Do not add a library just because a different file uses it.
03
Enable it on the world host

Do not install it as a separate client mod. Enable it on the world host—the local server in singleplayer or the dedicated server in multiplayer.
04
Pick the file you checked

Use the “Get this file” button beside Alec's NPC Inspector! v1.5.2. It opens that exact file at the source.

About this project

What does Alec's NPC Debug UI! add?

In-game NPC debugging tool for Hytale. It can be used with any mod and is designed to inspect live NPC behavior with UI tools instead of command spam.

When Alec's Tamework is installed, the inspector now also consumes Tamework's public API to expose persisted tame/profile state alongside live ECS state.

What It Does

Adds an in-game NPC Debug Inspector Tool item that can:
- Link/unlink multiple NPCs
- Open a linked NPC roster
- Inspect linked NPCs quickly
- Toggle built-in role debug flags per NPC
Includes a Pinned Overlay so selected inspector fields stay visible while you keep playing.
Tracks recent state/event transitions in the inspector data.
When Tamework is present, adds additional API-backed debug sections for:
- persisted profile and snapshot state
- command-link/home-position state
- ownership / claim / damage policy evaluation
- resolved Tamework config views
- Tamework persistence diagnostics
- recent Tamework capture / death / lost / profile-change events

Quick Start

Install the mod jar into your mods folders.
Start server and join.
Spawn and use the item Npc_Debug_Inspector_Tool on an NPC.
- Optional: Or, use /npcdebug while looking at an NPC to open the inspector without an item.

Inspector Tool Behavior

Item asset: Server/Item/Items/Debug/Npc_Debug_Inspector_Tool.json

Left-Click: link/unlink targeted NPC.
Right-Click: open linked NPC roster.

Each tool stores its own linked/highlighted NPC sets in item metadata, so multiple tools can track different test groups.

UI Surfaces

1) Inspector Page

Sectioned NPC details (overview, AI/state, sensors, pathing, timers, components, flock, etc.).
With Tamework installed, also shows API-backed persistence/policy/config/diagnostic sections in addition to the live Tamework component section.
Expand/collapse sections.
Section reorder support.
Refresh rate slider (150ms to 2000ms, step 50ms).
Recent Events category filters (Core, Targeting, Timers, Alarms, Needs, Flock).
Pin mode for selecting fields to mirror in overlay.

2) Linked Roster

Card view of linked NPCs with basic live status.
Filter controls:
- text search
Per-NPC actions:
- Inspect
- Debug Flags
- Highlight
- Copy UUID (copies into in-UI buffer field for manual Ctrl+C)
- Unlink

3) Debug Flags Page

Built-in role debug flag toggles grouped by category.
Bulk actions:
- Enable All
- Disable All
Works on the selected linked NPC.

4) Pinned Overlay HUD

Separate non-blocking overlay view that remains visible while interacting with the world.
Shows only pinned fields from the currently pinned NPC.
Keeps section grouping/order for readability.
Includes optional pinned Events Log stream.

Lait's Entity Inspector Shoutout

If you are interested in external tools, check out Lait's Entity Inspector for an even more powerful entity inspection tool!

View similar data in a web-based GUI
Live-edit assets in the interface
Detects Hytalor for live asset patching

Project description from CurseForge.

Pick your setup