Brings the 1.21.6 Locator Bar feature to Paper 1.16.5–1.21.5. Shows nearby players on your Action Bar with real-time directional tracking. No client-side mods required.
How it works
A bar appears above your hotbar showing the position of nearby players. Icons change based on distance:
- ⬤ — Close (0–179 blocks)
- ■ — Medium (179–230 blocks)
- ● — Far (230–281 blocks)
- • — Very far (281+ blocks)
Vertical arrows (ꜛ ꜜ) indicate when a player is above or below you. Each player is assigned a unique color for easy identification, which also appears in the tab list.
Hiding from the bar
Players are hidden from the Locator Bar when:
- Sneaking
- Under Invisibility effect
- Wearing a mob head or carved pumpkin
Commands
/locatorbar— Toggle the bar on/off/locatorbar on— Enable/locatorbar off— Disable/locatorbar reload— Reload config
Configuration
All settings are customizable in config.yml:
update-interval— Refresh rate in ticks (default: 1)fov-degrees— Field of view (default: 120°)bar-width— Width of the bar in characters (default: 51)max-range— Maximum tracking distance (0 = unlimited)distance-thresholds— Customize icon distance breakpointsvery-far-icon— Custom icon for max distanceshow-vertical-arrows— Toggle vertical arrowsvertical-threshold— Height difference to show arrows (default: 10)color-tab-names— Color player names in tab list (default: true)hide-sneaking,hide-invisible,hide-masked— Toggle hiding conditions
