OptiPortal

Hytale server optimization plugin that eliminates chunk loading lag on portal travel. Pre-loads destination chunks before teleports occur using a self-learning portal link registry and three-tier cache system (HOT/WARM/COLD).

File Details

OptiPortal-1.0.7.jar

  • R
  • Mar 20, 2026
  • 18.42 MB
  • 32
  • Early Access

File Name

OptiPortal-1.0.7.jar

Supported Versions

  • Early Access

[1.0.7] - 2026-03-19

Big Improvements!

  • Native chunk retention: Chunks loaded for portal zones are now held in memory by the server's own pinning mechanism rather than relying solely on periodic reload requests, reducing unnecessary I/O and world-thread wake-ups during idle periods.
  • Keep-loaded pin release: Chunks held in memory by OptiPortal are now correctly released when their zone goes cold, preventing long-term memory growth on servers with many portal zones that cycle through active and idle periods. This now applies to both explicit release and the HOT→WARM→COLD tier-decay path.
  • BUG FIX: All zone registrations and preload coordinates were targeting the wrong chunk positions due to an incorrect block-to-chunk conversion. All preloads now land on the correct chunks.
  • Native warp sync: Warp data is now read directly from the server's live in-memory state rather than polling the warps file, eliminating stale reads and file I/O overhead. Falls back to file polling if the native source is unavailable.
  • Pre-spawn chunk preloading: The spawn area is now pre-warmed before a connecting player is placed in the world, eliminating cold-load spikes on first login.
  • Chunk backoff guard: Chunks that have recently failed to load are now skipped during preload passes, preventing repeated load attempts against broken chunk positions.
  • Event-driven staged load: The startup warm zone load now triggers immediately when the server finishes initialising rather than polling on a fixed interval. Polling is retained as a fallback.
  • Chunk pressure-aware batch sizing: Preload batch sizes are now reduced automatically when the server is managing a high number of loaded chunks across all worlds.
  • Eternal world decay exemption: Zones in worlds that never unload chunks are now permanently exempt from HOT→WARM→COLD decay, avoiding pointless tier churn for hubs and lobbies.
  • Portal zone lookup performance: Zone promotion on chunk load now resolves in constant time regardless of how many portals are registered, replacing a full scan on every chunk load event.
  • World initialisation ordering: Plugin subsystems now initialise against a world only after it is fully operational, preventing edge cases where portal scanning or event registration ran against a partially-started world.
  • Log level control: Internal diagnostic output now respects the server's configured log level, allowing verbose portal and teleport tracing to be suppressed in production without code changes.

[1.0.6] - 2026-03-19

Added

  • DrainPlayerFromWorldEvent hook: Instant origin-zone linger and portal-link capture on world exit, replacing 1-second poll latency.
  • PortalWorld resource auto-detection: Portal destination world spawn points auto-registered as PREDICTIVE zones on world load; no warps.json required.
  • ChunkPreLoadProcessEvent listener: PortalDevice blocks auto-discovered and registered; COLD zones promoted to WARM when the server natively loads their chunks.
  • Universe seeding fallback: WorldRegistry seeds from the live Universe map at startup to capture worlds loaded before the plugin started.