Wayfinder [Minimap]

[1.8.0] - 2026-01-28

Added

• Performance Mode: New optional setting to reduce client stuttering during minimap updates
  • When enabled, map pixel updates are spread across multiple frames (staggered updates)
  • The 40x40 grid is split into 2 horizontal bands, updating one per tick
  • Automatically completes the full update cycle even if the player stops moving (prevents half-map desync)
  • Disabled by default for maximum visual responsiveness
  • Per-player toggle accessible via the settings menu

Performance Optimizations

The following internal optimizations have been implemented to reduce client stuttering:

• Pre-computed UI Selectors: Pixel background/visibility selectors are computed once at class load, avoiding string allocation during updates
• Pre-computed Circular Visibility Mask: Eliminates Math.sqrt() calls per pixel for circular mode
• Primitive Boolean Arrays for Entity Positions: O(1) lookup instead of HashSet for hostile/player markers
• Integer Color Comparison: Quantized int colors instead of String comparison for faster delta detection
• Aggressive Color Quantization: 16 levels per channel (4096 total colors) to maximize delta cache hits
• Text Label Delta Checking: Coordinates, compass, and clock text only sent when changed
• Rotation Delta Threshold: Map only recalculates when rotation changes by more than 3 degrees

Configuration

New player config option:

• PerformanceMode: Boolean (default: false) - Enables staggered pixel updates to reduce stuttering

Migration

To upgrade from v1.7.x:

• No breaking changes
• Existing player settings are preserved
• Performance Mode defaults to disabled (original behavior)