ModsJava
WayBar - Vanilla locator bar waypoints
I don't know my version or loader
Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.
No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.
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.0release 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
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
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 26.1, 26.1.1, 26.1.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Verified by MCModsHub
- Ships as WayBar-0.3.0.jar — drop this file into the mods folder
- Download size: 13.6 MB
- Download link checked 21 Aug 2026 — working
These come from our own check of the pack file, not from the source page.