Adoa's Minimap

SimpleMinimap v9.0.0

Complete logic overhaul. Nearly every system was rewritten from scratch.

Core Architecture

• Replaced all per-feature world.execute() calls with a single WorldCollector pass — one world-thread job captures terrain, enemies, WAILA, and waypoint data simultaneously, eliminating the recurring 200–400ms world-thread spikes from v8
• Introduced PlayerTracker for packet-level position caching — player position is now read from ClientMovement packets on the network thread, avoiding world-thread-affine reads that always returned (0,0,0) from async contexts
• Split MinimapHud into focused subsystems: TileManager, OverlayManager, PointerManager, WailaManager, FrameOverlayManager, and MinimapDiagnostics

Rendering

• Full terrain tile renderer (MinimapRenderer) — renders 128×128-block tiles at 1px/block into PNGs, composited by a 5×5 TerrainTileGrid
• MinimapEncoder handles async PNG encoding with a bounded queue to prevent backpressure
• AssetPublisher tracks per-player asset delivery state so mask and frame PNGs are never re-sent unnecessarily
• BufferedImageTileCache — shared LRU image cache across tile encode jobs
• Tile prewarming on HUD creation so the first frame is never blank

Settings & Config

• MinimapConfig fully reworked with a builder pattern; all settings validated and clamped on load
• MinimapConfigSchema handles migration from older config formats automatically
• PlayerConfigStorage now persists all settings per-player
• New defaults: size 250px, update rate 200ms, detail 50%, circle shape

New Features

• External API — MinimapMobLayerApi and MinimapPlayerLayerApi let other plugins inject custom markers onto the minimap
• Frame overlay — configurable border/frame rendered as a PNG overlay
• Diagnostics — internal tick timing, world-thread queue wait, and error tracking logged on a 5-second window
• /minimap command consolidates all subcommands; /waila command removed (merged into settings)
• PluginVersion class for consistent version reporting
• Dutch (nl) language support added

Bug Fixes

• Fixed player position always reading (0,0,0) from async threads
• Fixed stale asset delivery causing blank HUDs after reconnect
• Fixed enemy scan iterating the full 232-block radius every tick regardless of visible map area
• Fixed waypoint markers not clamping to the minimap border correctly

Updated for Server 0.5.2

• Vector3d and Vector3i migrated from com.hypixel.hytale.math.vector to org.joml
• Rotation3f.getY() → Rotation3f.yaw()
• CustomUIHud constructor now requires a HUD identifier string