WayBar - Vanilla locator bar waypoints
Simple waypoints integrated into the native Minecraft level bar
45
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
WayBar - Vanilla locator bar waypoints
WayBar - Locator Bar Waypoints
A Minecraft server plugin that displays Locator Bar and Locator Bar waypoints in the native Locator Bar.
Features
- Per-player visibility — save locations, teleport, customize appearance - Per-player visibility — server-wide points visible to all players - Per-player visibility — waypoints appear in the vanilla compass UI via ProtocolLib - Per-player visibility — preset colors or hex values (`#RRGGBB`) - Per-player visibility — different waypoint markers - Per-player visibility — 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`:
```yaml 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
- Dependency: Paper or Spigot Dependency: - Dependency: 21+ - Dependency: Dependency:
> 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
```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
```
