Skip to content

Compass Feedback

Quick Start: Pick your goal.

What holders see and hear: the tracking actionbar, the accuracy percent, and chat messages.

Actionbar

refresh-ticks sets how often the tracking actionbar is pushed to holders, in ticks (default 1, minimum 1). Frontend only: the tracking interval is untouched, so lowering it redraws the same snapshot more often.

feedback:
  actionbar:
    display:
      refresh-ticks: 1
      show-distance: true
    show-distance-delta:
      enabled: true
      formats:
        further-format: "<green>â–²{distance}"
        closer-format: "<red>â–¼{distance}"
      limits:
        max-distance: 500.0
        min-delta-to-show: 5.0
      style:
        mode: BLINK
        blink-duration-seconds: 0.6
        reverse-on-hunter: true
  • show-distance-delta colors the distance by movement since the last refresh: a green up triangle when it grew, a red down triangle when it shrank.
  • Deltas only show within max-distance and past min-delta-to-show, so small wobbles far away do not clutter the screen. Both formats support {distance} and MiniMessage.
  • With reverse-on-hunter (default true), hunters see the formats swapped, so approaching the prey reads as progress.
  • mode picks how long the triangle stays: HOLD keeps it until the next refresh, BLINK shows it for blink-duration-seconds, then reverts to plain white. A blink of 0 skips the triangle entirely.
  • show-distance (default on) toggles the distance readout itself. With it off, the bar shows direction without any distance.

Show Accuracy

  • enabled (default off) appends a stepped accuracy percent after the tracked name: Tracking Alex (80%). The percent snaps to tens: 0% is the worst possible error, 100% is the true spot.
  • With inaccuracy off, every bar reads 100%.
  • accurate-color (default #63d42a) and inaccurate-color (default #cc472d) set the ends as #rrggbb; junk values fall back to the defaults.

Chat Messages

Compass actions can chat the holder: switching teammate mode on and off, and the death of a locked target (locking itself stays silent; the actionbar already shows the target):

feedback:
  chat-messages:
    enabled: true

The lines come from compass.teammate-on-chat, compass.teammate-off-chat, and compass.locked-target-died-chat in the active lang file.

Next Steps