?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
WayBar - Vanilla locator bar waypoints

WayBar - Vanilla locator bar waypoints

Simple waypoints integrated into the native Minecraft level bar

43
0
43
0

Compatibility

Minecraft: Java Edition

1.21.6–1.21.11

Platforms

Links

Report issues

Tags

Creators

Details

Licensed ARR
Published 3 months ago

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