ModProfiler

AipocsHouse ModProfiler

A low-overhead statistical CPU and allocation profiler for Hytale Java mods.

ModProfiler samples JVM thread activity every 100 ms, attributes visible stack frames to loaded mod JARs, and stores statistics in a temporary in-memory SQLite database. No JSON statistics files are written, and all collected data is discarded when the server stops.

Features

• In-game profiler GUI with automatic two-second refresh
• Full-height scrolling table for loaded non-Hytale Java mods
• Sorting by one-minute CPU, then one-minute allocation rate, then tick CPU
• CPU averages for the last 10 seconds, one minute, and five minutes
• Peak sampled CPU
• Allocation rate per second
• World/tick-thread CPU attribution
• Current and peak sampled thread counts per mod
• Sample count and confidence rating
• Loaded class count
• Hottest sampled method
• Server TPS and MSPT
• JVM heap, garbage collection, and live thread statistics
• Whole-process CPU and profiler-overhead reporting
• Plain-English wrapped mouseover help for every metric
• Console top-mod report once per minute

Commands

• /profiler — open the profiler GUI
• /modprofiler — alias for /profiler
• /profiler reset — clear collected statistics
• /profiler rescan — rebuild loaded-mod class ownership

The /modprofiler alias also supports the reset and rescan actions.

Permission

aipocshouse.modprofiler.use

Hytale server operators receive access through the default permission system. HyperPerms and LuckPerms/LuckyPerms can grant the same node to an administrator group because the command uses Hytale's central PermissionHolder check.

Understanding the numbers

• CPU percentages use one-core utilization: 100% means one CPU core was fully occupied.
• ALLOC / SEC is the rate at which a mod creates Java objects. It is memory traffic, not retained RAM ownership.
• THREADS N/P means distinct sampled threads now and the highest observed count. Shared Hytale or executor threads can appear for multiple mods.
• Sampling is statistical. Very short work between samples can be missed.
• Shared-library frames can be attributed to the nearest visible owning mod frame.

A normal Hytale plugin cannot reliably measure retained heap ownership, every thrown exception, or exact per-mod file/network I/O. Those measurements require deeper JVM-agent instrumentation and substantially more overhead.