# WayBar – Locator Bar Waypoints<\/p>\n
A Minecraft server plugin that displays **personal** and **global** waypoints in the native **Locator Bar**.<\/p>\n
<\/p>\n
## Features<\/p>\n
– **Personal waypoints** \u2014 save locations, teleport, customize appearance
\n– **Global waypoints** \u2014 server-wide points visible to all players
\n– **Locator Bar display** \u2014 waypoints appear in the vanilla compass UI via ProtocolLib
\n– **Custom colors** \u2014 preset colors or hex values (`#RRGGBB`)
\n– **Multiple icon styles** \u2014 different waypoint markers
\n– **Visibility radius** \u2014 min\/max distance filtering per waypoint
\n– **Per-player visibility** \u2014 players can hide\/show individual global waypoints<\/p>\n
## Resource Packs (Custom Icons)<\/p>\n
<\/p>\n
By default, waypoints use vanilla style. For custom waypoint styles, download a resource pack from Releases and configure it in `config.yml`:<\/p>\n
“`yaml
\nresource-pack:
\n enabled: true
\n url: “https:\/\/your-host.com\/waybar-icons.zip”
\n sha1: “abc123…”
\n“`<\/p>\n
Once players accept the pack, custom styles become available via `\/wp style` and `\/wp styles`.
\nIf players don’t accept the pack, they will see the vanilla style.
\nAlso available `\/wp rp` command to suggest pack again.<\/p>\n
## Requirements<\/p>\n
– **Server:** Paper or Spigot **1.21.6+**
\n– **Java:** 21+
\n– **Dependency:** ProtocolLib<\/p>\n
> 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.<\/p>\n
## Commands<\/p>\n
Main command: `\/wp` (aliases: `\/waybar`, `\/wb`)
\n### Personal Waypoints<\/p>\n
| Command | Description | ### Global Waypoints<\/p>\n | Command | Description | ### Utility<\/p>\n | Command | Description | ## Permissions<\/p>\n | Permission | Default | Description | ## Configuration<\/p>\n Config file: `plugins\/WayBar\/config.yml`<\/p>\n “`yaml gui: locator-bar: display: distance: resource-pack: messages: “`<\/p>\n<\/details>\n","protected":false},"excerpt":{"rendered":" Simple waypoints integrated into the native Minecraft level bar<\/p>\n","protected":false},"featured_media":169049,"template":"","meta":{"_minecraft_slug":"waybar","_minecraft_project_id":"8jw9t0YE","_minecraft_author":"Sakari0xFF","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":45,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"waybar.zip","_minecraft_size_bytes":14187423,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:25:13.051439Z","_minecraft_date_created":"2026-01-29T22:25:17.877737Z","_minecraft_date_modified":"2026-01-23T16:36:40.216607Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/waybar","_minecraft_icon_attachment_id":169049,"_minecraft_imported_at":"2026-06-09T20:01:12+00:00","_minecraft_import_hash":"cfbe313665b8457301fb4f9f6b941b4d","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,127,129,92],"mod_loader":[130,132,134],"minecraft_version":[40,41,79,80,81,82],"class_list":["post-169048","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|
\n| `\/wp set
\n| `\/wp tp
\n| `\/wp del
\n| `\/wp list` | List your waypoints |
\n| `\/wp color
\n| `\/wp style
\n| `\/wp radius
\n|———|————-|
\n| `\/wp gset
\n| `\/wp gtp
\n| `\/wp gdel
\n| `\/wp glist` | List visible global waypoints |
\n| `\/wp globals` | Open visibility GUI |
\n| `\/wp ghide
\n| `\/wp ghideall` \/ `\/wp gshowall` | Hide\/show all globals |<\/p>\n
\n|———|————-|
\n| `\/wp help` | Show help |
\n| `\/wp colors` | List available colors |
\n| `\/wp styles` | List available icon styles |<\/p>\n
\n|————|———|————-|
\n| `waypoints.use` | true | Access to `\/wp` command |
\n| `waypoints.personal` | true | Manage personal waypoints |
\n| `waypoints.personal.tp` | true | Teleport to personal waypoints |
\n| `waypoints.global.use` | true | View globals & visibility controls |
\n| `waypoints.global.tp` | true | Teleport to global waypoints |
\n| `waypoints.global.manage` | op | Create\/delete\/edit global waypoints |<\/p>\nDefault config.yml<\/summary>\n
\nlimits:
\n personal: 10
\n global: 20<\/p>\n
\n enabled: true
\n title: “Global waypoints”<\/p>\n
\n enabled: true<\/p>\n
\n # If true, waypoints are shown only while holding a specific item (main hand or off-hand).
\n require-item: false
\n # Item material name to require for waypoint visibility.
\n item: “minecraft:compass”<\/p>\n
\n # If true, waypoints are only shown within their effective min\/max radius.
\n enabled: true
\n # Default radius values (in blocks). Individual waypoints can override these via \/wp radius.
\n # -1 means “no limit” (always visible) for max.
\n default-min: 0
\n default-max: -1
\n # Hysteresis buffer (in blocks) to avoid flicker near the boundary.
\n hysteresis: 16
\n # How often (in ticks) to re-check moving players (20 ticks = 1 second).
\n check-period-ticks: 10<\/p>\n
\n # If enabled and url is set, the server will offer a resource pack to players (optional).
\n enabled: false
\n # HTTPS URL to the pack zip (leave empty to disable sending).
\n url: “”
\n # Optional SHA-1 hash (40 hex chars). If set, helps clients cache\/verify the pack.
\n sha1: “”
\n # Optional prompt shown to players.
\n prompt: “Waypoints icons pack (optional)”<\/p>\n
\n # If true, adds the permission node to the “no permission” message (useful for debugging).
\n show-permission-node: false<\/p>\n