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).
Install via App

File Details
DownloadInstall

OptiPortal-1.1.4.jar

Bycpl
  • R
  • Mar 22, 2026
  • 18.45 MB
  • 62
  • Early Access

File Name

OptiPortal-1.1.4.jar

Supported Versions

  • Early Access

[1.1.4] - 2026-03-22

Fixed

  • BUG FIX — Destination zone not promoted to HOT after same-world portal teleport: The async TeleportRecord processing path blocked same-world adventure.teleporter portals because the destination world field is null for same-world teleports. The current world name is now used as the fallback, so destination zones are promoted to HOT immediately on arrival. Portal link learning (source → destination mapping) was also missing from the async path and is now restored.

  • BUG FIX — Chunk pressure limit too low for servers with permanently-warm zones: The hard abort threshold for chunk loading defaulted to 512, which could be exceeded by the chunks already held by WARM zones alone. The default is now 2048, and the threshold is documented in config.json under chunkPressure.maxLoadedThreshold.

  • BUG FIX — WARM zones dropped to COLD: Zones set to the WARM (never-expire) strategy were still subject to normal tier decay and chunk eviction downgrade logic, causing them to drop to COLD and lose their loaded chunks between player visits. WARM zones now hold a minimum tier of WARM — they decay from HOT to WARM normally when not in active use, but are protected from dropping to COLD through both the periodic decay cycle and the chunk eviction path.

  • BUG FIX — Destination zone not promoted to HOT when approaching a same-world portal: Walking toward a location-to-location portal did not promote the destination zone from WARM to HOT before the player arrived. The proximity check only fired when the player was already near the destination position, which is too late. The plugin now detects teleports by observing sudden position changes in the async position poll, learns the source portal position after the first use, and promotes the destination to HOT on all subsequent approaches.

  • BUG FIX — Portal destination world link lost on server restart: The world a portal device linked to was not saved when the zone was first registered, so the connection was forgotten on every restart and had to be rediscovered at runtime. The destination is now persisted immediately on registration.