WayBar - Vanilla locator bar waypoints

Minecraft 版本： 26.1 26.1.1 26.1.2 26.2

平台： bukkit paper spigot

标签： adventure utility

WayBar - Locator Bar Waypoints

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

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)

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 ```yaml 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 ```