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
• 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 26.1–26.2
• Java: 25
• Dependencies: none

For Minecraft 1.21.6–1.21.11, download the legacy WayBar 0.2.0 release and use Java 21 with ProtocolLib. That release remains unchanged. Current releases target Minecraft 26.x and do not use ProtocolLib.

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