Fixtale | Keep your server alive v1.6.2

Fixtale is a stability and performance suite for Hytale servers, split into two complementary parts:

• Fixtale Early: protects the server during startup and low-level lifecycle transitions.
• Fixtale Runtime: optimizes live server behavior while players are online.

The goal is straightforward: fewer crashes, fewer freezes, cleaner logs, and higher uptime.

Discord Support: https://discord.gg/2quNMUJMxT

---

Quick install

1) Runtime (required): place fixtale-runtime-<version>.jar in mods/
2) Early (recommended): place fixtale-early-<version>.jar in earlyplugins/

---

What Fixtale solves

Under real production load (teleports, active worlds, heavy plugins, high concurrency), servers often suffer from:

• random freezes and stall events;
• invalid entity or chunk states causing hard failures;
• world unload/reload instability;
• memory pressure caused by stale references and delayed cleanup;
• warning spam that hides the real issue;
• TPS degradation during peak activity.

Fixtale targets exactly those pain points.

---

Fixtale Early (startup and core stability layer)

Fixtale Early adds a protective layer for low-level server edge cases that commonly lead to mass disconnects, stuck world threads, or full crashes.

What it improves

• Safer player join flow during sensitive readiness and handoff windows.
• Guards against stale or invalid references in delayed tasks and packet timing races.
• Safer component/entity cleanup during shutdown, teleport, and world transitions.
• More reliable chunk lifecycle behavior when worlds are busy or closing.
• Improved world unload cleanup to avoid stale handlers retaining old world state.
• Protection against out-of-range spatial checks in special world/event systems.
• Graceful fallback for invalid chunk block data so a broken block definition does not take down startup.
• Context-rich chunk diagnostics to identify the exact world/chunk involved in failures.
• Visibility into slow chunk deserialization to expose freeze sources earlier.
• Warning noise reduction so logs stay useful under stress.
• Slow tick visibility to surface overloaded systems quickly.
• Better connection-handshake diagnostics with clearer remote-side context.
• Safe teleporter portal update gating to avoid chunk/store re-entrancy crashes during sensitive chunk transitions.
• StateSupport store guard to avoid crashes from cross-world NPC interaction references.
• NPC kill ref guard to prevent world-thread crashes from invalid killer references.
• Model scale guard to prevent invalid entity scale crashes (scale <= 0).
• Optional slow system tick diagnostics (configurable on/off).
• NPC dialog compatibility guard for unstable dialog/animation edge cases.

In short: Early is designed so the server survives bad states instead of collapsing.

Configuration UI ("/fixtale ui")

---

Fixtale Runtime (live optimization and recovery)

Fixtale Runtime provides adaptive controls and operational tools to keep the server stable as load changes in real time.

What it provides

• Adaptive load tuning based on live server health signals.
• Global and per-player simulation balancing to reduce overhead without over-penalizing everyone.
• Per-world TPS policy control, including lighter behavior when the server is empty.
• Automatic default-world recovery after exceptional failure scenarios.
• Optional recovery for additional named worlds via configuration.
• Chunk-memory pressure cleanup triggers after sustained load drops.
• Mitigation for heavy fluid-related overhead that can create avoidable stalls.
• Dropped-item lifetime control (configurable TTL clamp) to reduce persistent world clutter and cumulative cost.
• Recipe blocking to disable crafting of specific items or recipe IDs (pattern-based).
• Live configuration behavior for faster operational adjustments.
• Chunk channel backpressure to throttle chunk traffic when channels stall.
• Keep loaded regions to keep specific chunks always loaded (spawn-friendly).
• In-game /fixtale ui to manage settings without editing config.json.

Included admin commands

- /fixtale npcclean
- Cleans NPCs in the active world while respecting a whitelist.
- Useful for maintenance, cleanup, and incident recovery.


- /fixtale fluidrecalc
- Recalculates fluid state in the current chunk.
- Also supports radius-based recalculation around the current position.


- /fixtale chunkregen <radius>
- Regenerates/reloads chunks around the player.
- Useful for damaged or desynced regions.


- /weather set fixtale
- Completely removes the fog.

---

Why server owners use Fixtale

• Fewer hard failures from rare but costly edge cases.
• Fewer long freeze windows during load/unload transitions.
• More actionable logs with less noise.
• Less manual firefighting during incidents.
• Better service continuity during peak hours.