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

Command	Description
`/wp set <name> [color:...] [style:...] [radius:...]`	Create waypoint at your location
`/wp tp <name>`	Teleport to waypoint
`/wp del <name>`	Delete waypoint
`/wp list`	List your waypoints
`/wp color <name> <preset\|#hex\|reset>`	Change color
`/wp style <name> <style\|reset>`	Change icon
`/wp radius <name> <min\|max> <blocks\|reset>`	Set visibility radius

Global Waypoints

Command	Description
`/wp gset <name> [color:...] [style:...] [radius:...]`	Create global waypoint (admin)
`/wp gtp <name>`	Teleport to global waypoint
`/wp gdel <name>`	Delete global waypoint (admin)
`/wp glist`	List visible global waypoints
`/wp globals`	Open visibility GUI
`/wp ghide <name>` / `/wp gshow <name>`	Hide/show specific global
`/wp ghideall` / `/wp gshowall`	Hide/show all globals

Utility

Command	Description
`/wp help`	Show help
`/wp colors`	List available colors
`/wp styles`	List available icon styles

Permissions

Permission	Default	Description
`waypoints.use`	true	Access to `/wp` command
`waypoints.personal`	true	Manage personal waypoints
`waypoints.personal.tp`	true	Teleport to personal waypoints
`waypoints.global.use`	true	View globals & visibility controls
`waypoints.global.tp`	true	Teleport to global waypoints
`waypoints.global.manage`	op	Create/delete/edit global waypoints

Configuration

Config file: plugins/WayBar/config.yml

Default 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