WayBar - Locator Bar Waypoints

A Minecraft server plugin that displays personal and global waypoints in the native Locator Bar.

!Banner

Features

• Personal waypoints — save locations, teleport, customize appearance
• Global waypoints — server-wide points visible to all players
• Locator Bar display — waypoints appear in the vanilla compass UI via ProtocolLib
• Custom colors — preset colors or hex values (#RRGGBB)
• Multiple icon styles — different waypoint markers
• Visibility radius — min/max distance filtering per waypoint
• Per-player visibility — players can hide/show individual global waypoints

Resource Packs (Custom Icons)

!Custom Icons

By default, waypoints use vanilla style. For custom waypoint styles, download a resource pack from Releases and configure it in config.yml:

resource-pack:
  enabled: true
  url: "https://your-host.com/waybar-icons.zip"
  sha1: "abc123..."

Once players accept the pack, custom styles become available via /wp style and /wp styles. If players don't accept the pack, they will see the vanilla style. Also available /wp rp command to suggest pack again.

Requirements

• Server: Paper or Spigot 1.21.6+
• Java: 21+
• Dependency: ProtocolLib

Other Bukkit-based servers may work if they support ProtocolLib. If you hit a version/build where Locator Bar waypoints don't work, please open an issue with your server and ProtocolLib versions.

Commands

Main command: /wp (aliases: /waybar, /wb)

Personal Waypoints

Global Waypoints

Utility

Permissions

Configuration

Config file: plugins/WayBar/config.yml

limits:
  personal: 10
  global: 20

gui:
  enabled: true
  title: "Global waypoints"

locator-bar:
  enabled: true

display:
  # If true, waypoints are shown only while holding a specific item (main hand or off-hand).
  require-item: false
  # Item material name to require for waypoint visibility.
  item: "minecraft:compass"

  distance:
    # If true, waypoints are only shown within their effective min/max radius.
    enabled: true
    # Default radius values (in blocks). Individual waypoints can override these via /wp radius.
    # -1 means "no limit" (always visible) for max.
    default-min: 0
    default-max: -1
    # Hysteresis buffer (in blocks) to avoid flicker near the boundary.
    hysteresis: 16
    # How often (in ticks) to re-check moving players (20 ticks = 1 second).
    check-period-ticks: 10

resource-pack:
  # If enabled and url is set, the server will offer a resource pack to players (optional).
  enabled: false
  # HTTPS URL to the pack zip (leave empty to disable sending).
  url: ""
  # Optional SHA-1 hash (40 hex chars). If set, helps clients cache/verify the pack.
  sha1: ""
  # Optional prompt shown to players.
  prompt: "Waypoints icons pack (optional)"

messages:
  # If true, adds the permission node to the "no permission" message (useful for debugging).
  show-permission-node: false