PerfectDebug

A free passive debug tool for Hytale modders. Automatically scans the server API, sniffs events, monitors performance, and dumps vanilla assets — all without any commands.

Version	1.1.0
Platform	Hytale Server Plugin
Java	21
Dependencies	None
Price	Free

Installation

Download PerfectDebug-1.1.jar
Place it in your server's UserData/Mods/ folder
Start the server — everything runs automatically
Check output in UserData/Saves/[World]/mods/KatsuyaTV_PerfectDebug/

Features

API Scanner — Dumps class methods, fields, and hierarchy for 38+ server classes
Event Sniffer — Logs all events (connect, disconnect, chat, etc.)
Performance Monitor — Periodic server health reports (30s interval)
Vanilla Asset Scanner — Lists all particles, sounds, textures, items, blocks
Passive Item Tracker — Logs items seen in player inventories
Player Tracker — Logs player connections and disconnections

All features run in passive mode — no commands, no interaction, no server impact.

Output Files

All files are written to mods/KatsuyaTV_PerfectDebug/ inside your world save folder.

File	Content
`api_World.txt`	World class methods and fields
`api_PlayerRef.txt`	PlayerRef class API
`api_ItemStack.txt`	ItemStack class API
`api_Inventory.txt`	Inventory class API
`api_ItemContainer.txt`	ItemContainer class API
`api_scan_summary.txt`	Overview of all scanned classes
`events.txt`	Event sniffer log
`vanilla_items.txt`	All registered vanilla items
`vanilla_blocks.txt`	All registered vanilla blocks

API Scanner

Scans 38+ server classes using reflection and outputs full method signatures, field types, and class hierarchy. Invaluable for discovering undocumented API.

Classes scanned include: World, PlayerRef, Entity, ItemStack, Inventory, ItemContainer, ItemModule, HytaleServer, ComponentType, and more.

Event Sniffer

Registers listeners on all available events and logs them to events.txt:

PlayerConnectEvent
PlayerReadyEvent
PlayerDisconnectEvent
PlayerChatEvent

Vanilla Asset Scanner

Scans the Hytale asset directory and catalogs:

581 particles — All particle effect files
1,168 sounds — All sound effect files
356 textures — All block and item textures

Results are saved to organized text files for easy reference.

FAQ

Does PerfectDebug affect server performance?

No. The API scan runs once at startup (takes ~50ms). The event sniffer and trackers are lightweight listeners with no tick loops.

Can I use the API dump for my own plugins?

Absolutely. That's the main purpose — discover the Hytale server API to build your own mods.

Is it compatible with other plugins?

Yes. PerfectDebug is passive and does not modify any game state. It only reads and logs.