P E R F E C T OPTIMIZER
Live web dashboard, smart recommendations and one-click auto-apply for Hytale
// WHY PERFECTOPTIMIZER?
Most Hytale tools only observe your server. PerfectOptimizer acts.
Every server gets its own private analytics website with 19 live pages, 17 prescriptive rules and one-click config patches that ship straight from your browser to the live server. No more guessing which flag to tune. No more SSH-ing to edit files.
// FEATURES
- LIVE WEB DASHBOARD
Every server is auto-registered at first boot and gets a private URL. Zero config, zero account. 19 pages of stats: TPS multi-window, MSPT percentiles (avg / p50 / p95 / p99), heap pools, GC events, threads top-CPU, per-world counters, ping leaderboards, system info, tier history, lag spikes, activity timeline. 14-day retention with 15m / 1h / 6h / 24h / 7d ranges. - SMART RECOMMENDATIONS ENGINE
17 prescriptive rules continuously scan your last 24 hours of data and tell you what to fix in plain English, with the expected impact. TPS dropping while CPU is idle? Recommend NPC LOD. Heap leak shape detected? Point to the suspect class. Lag spikes clustered around the same hour? Flag a probable cron conflict. Severity tags (critical / warn / info), version-aware advice, snooze and dismiss controls. - ONE-CLICK AUTO-APPLY (NEW)
The differentiator: every applicable recommendation gets an Apply now button. One click and the patch travels to the plugin on its next push, gets applied to the live config, the file is saved and the server reloads its tier. Round-trip: under 10 seconds. Rollback in one click from the Applied changes history. Zero downtime. Optional kill-switch in config if you want to disable remote patching entirely. - ACTIVE OPTIMIZATION (ALWAYS RUNNING)
Distant NPCs throttled or fully frozen beyond 160 blocks (NPC LOD). Per-player chunk radius shrinks for individual players when their world dips below 18 TPS. Despawn accelerator multiplies idle entity TTL by 0.5. AFK player chunk shrink with delayed restore. Anti-flapping hysteresis on tier transitions (15 min lock, 25% player drop required). Heap-pressure-aware escalation (forces high tier above 80% heap, emergency above 92%). Critical escalator locks all worlds to emergency on sustained low TPS. Console log noise filter with 26 default patterns. - CPU FLAMEGRAPH (NEW)
Sample every 10 ms during 5 to 300 seconds, render a clickable SVG flamegraph in the browser. See exactly which code is using your TPS. Wider rectangles mean more time spent. Hover for the sample percentage. - HEAP DUMP TRIGGER (NEW)
One-click button on the dashboard captures a heap snapshot of the live server. Live-only or full heap. Open the resulting file in Eclipse MAT or VisualVM to find what is eating your memory. No SSH, no command line. - ERROR CAPTURE (NEW)
Every server warning and exception gets grouped by signature and counted. Same error never spams the list. Mark resolved once fixed to clean the view. Sentry-style triage without the Sentry bill. - WORLD HEATMAP (NEW)
Visualizes entity density per chunk across all your worlds. Bright red zones equal hot spots that probably need entity cleanup or spawn rate tuning. Refreshes every 30 seconds. - ANOMALY DETECTION (NEW)
Statistical outliers (2.5 sigma threshold) automatically marked with red dots on the TPS, MSPT, memory and CPU charts. No more digging through hours of history to find the spike that caused the problem. - MULTI-LANGUAGE DASHBOARD
Dashboard available in 5 languages: English, French, Spanish, Portuguese, German. Flag picker in the sidebar, per-user choice remembered. Inline help on every page explaining what each metric means and how to read it.
// HOW IT COMPARES
Side-by-side with the other approaches available for Hytale
| Feature | Profiler-only tools | Static optimizers | PerfectOptimizer |
| Live web dashboard | Snapshot only | None | 19 pages, 14-day history |
| Smart recommendations | None | None | 17 prescriptive rules |
| One-click auto-apply | None | None | Yes, with rollback |
| CPU flamegraph | Yes | None | Yes, in browser |
| Heap dump trigger | Console only | None | One-click button |
| Sentry-style error capture | None | None | Yes, grouped by signature |
| World entity heatmap | None | None | Per-chunk 2D grid |
| Statistical anomaly markers | None | None | Z-score outliers on charts |
| NPC LOD freeze and throttle | None | Partial | 4 distance tiers + freeze |
| Per-player chunk radius tuning | None | None | Yes, with hysteresis |
| Anti-flapping tier hysteresis | N/A | None | 15 min lock, 25% drop required |
| Heap pressure escalation | N/A | None | Forces tier above 80% / 92% heap |
| Discord webhook alerts | None | Limited | Tier, lag, memory, GC, escalation |
| Multi-language UI | English only | English only | 5 languages |
| Self-registering (zero config) | N/A | Manual setup | Yes, fingerprint-based |
Comparison based on publicly available documentation for general categories of Hytale performance tools as of the v1.3.0 release.
// COMMANDS
| Command | Description |
| /poptimizer | Show command help |
| /poptimizer ui | Open the in-game admin panel |
| /poptimizer status | Tier, TPS, viewer counts |
| /poptimizer dashboard | Print a clickable link to your private dashboard |
| /poptimizer apply | Force re-apply the current tier |
| /poptimizer reload | Reload config from disk |
| /poptimizer cpu N | CPU flamegraph sampler for N seconds (default 30) |
| /poptimizer profile N | Profile session for N seconds, exports TXT and JSON report |
| /poptimizer lag | Lag spike counters |
| /poptimizer memory | JVM heap status |
| /poptimizer npc | NPC LOD counters |
Permission node: perfectoptimizer.admin
// HOW IT WORKS
1. Drop the JAR into your Hytale mods folder. Start the server.
2. The plugin self-registers on first boot, gets a unique private token and prints your dashboard URL in the console.
3. Open the URL in any browser. The dashboard is live within seconds. No login, no account, the URL itself is your auth.
4. Watch metrics stream in real time. Recommendations appear automatically as data accumulates.
5. When you see an actionable suggestion, click Apply now. The plugin applies the patch on its next push. Rollback any time from the Applied changes log.
// TECHNICAL DETAILS
- Hytale version: Update 5+ (Java 21+)
- JVM: HotSpot recommended (Shenandoah / G1 / ZGC fully supported)
- Dependencies: none, self-registering
- Plugin size: 150 KB
- Dashboard retention: 14 days of metrics, full history of recommendations and applied changes
- Dashboard hosting: provided free at analytics.perfect-plugins.com, paid for as long as you own the plugin
Developed by KatsuyaTV
If you encounter any issues or have feature requests,
don't hesitate to reach out via DM, the discussion tab, or our Discord: discord.gg/DuqSZKrpyM
