Skip to content

Compass

For: intermediate admins tuning tracking. The deep end lives in Analysis and Signal.

The tracking compass points hunters at speedrunners (and back again), with dimensional tracking, min/max distance, and per-role rules. Every setting below lives under settings.compass.

Quick Start

Hunters get a compass by default; speedrunners do not. Hand both sides one:

settings:
  compass:
    obtaining:
      given-to:
        hunters: true
        speedrunners: true

Right-click refreshes the target, left-click cycles candidates, shift-click toggles teammate tracking. That is the whole loop; the details live in Refresh.

Target Selection

The target is a live player of the opposite role. Dimensional tracking means only same-dimension targets count; the compass falls back to the target's last seen location in your dimension, which is handy for finding the portal they left through. Online tracking means disconnects record a last seen location but are never live targets. Respawning players are never targets at all.

Ranking: nearest in-range live player first, then a too-close player, then another player's last seen location. With nothing trackable, the needle spins. The compass does nothing while its holder is in spectator mode, and vanilla spectators (admins) get nothing at all.

Next Steps