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

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

No gallery available for this project.

Version	Minecraft	Loader	Download
WayBar v0.3.0 0.3.0	26.1, 26.1.1, 26.1.2, 26.2	bukkit, paper, spigot	Download
WayBar v0.2.0 0.2.0	1.21.10, 1.21.11, 1.21.6, 1.21.7, 1.21.8, 1.21.9	bukkit, paper, spigot	Download

WayBar - Vanilla locator bar waypoints