Description
ModProfiler – Find Mod Errors & Server Performance Issues
Find problematic mods, track errors, and troubleshoot your Hytale server more easily!
ModProfiler is a lightweight, read-only diagnostic tool for Hytale servers. It helps server owners identify which mods may be responsible for warnings, errors, and performance-related log messages.
Perfect for servers running many different mods!
Features
- Automatic Error Tracking – Collects warnings and errors from server logs.
- Mod Identification – Attempts to identify which mod caused a problem.
- Slow Task Detection – Tracks slow tasks reported in server logs.
- Mod Rankings – Displays the mods with the most recorded issues.
- Diagnostic Reports – Generates easy-to-read reports.
- Read-Only Monitoring – Does not modify other mods or gameplay.
Commands
| Command | Description |
|---|---|
/modprofiler |
Show profiler status |
/modprofiler top |
Show the 10 most problematic mods |
/modprofiler errors |
Display the latest 10 warnings and errors |
/modprofiler report |
Generate a diagnostic report immediately |
Shortcut: Use /mp instead of /modprofiler.
Permission: taleworld.modprofiler.admin
Where Are Reports Saved?
ModProfiler automatically creates diagnostic files in its own server data directory.
Typically located under:
mods/de.derfriesn_TaleWorld_ModProfiler/
The exact report location is also displayed when running /mp report.
Generated files:
mod-profiler-report.txt– Human-readable summary of detected issues, slow tasks, and problematic mods.mod-profiler-events.jsonl– Detailed event log for advanced troubleshooting.
Installation
- Download ModProfiler.
- Place the
.jarfile in your Hytale server'smodsfolder. - Restart your server.
- ModProfiler starts monitoring automatically.
- Use
/mp reportto generate your first report.
No additional setup is required.
Why Use ModProfiler?
Running a server with 20, 50, or even 100+ mods?
Finding the cause of crashes, warnings, or performance problems can be difficult.
ModProfiler helps you narrow down the problem without disabling every mod individually.
It does not automatically fix errors, and mod attribution may not always be conclusive. Slow task detection relies on available log messages rather than continuous CPU profiling.
Less guessing. Easier debugging. Better server maintenance.
Made for the Hytale community by Tale-World.
Website: https://tale-world.com




