WayBar - 定位栏地标
一个 Minecraft 服务器插件,在原生定位栏(Locator Bar)中显示个人和全局地标。

功能
- 个人地标 — 保存位置、传送、自定义外观
- 全局地标 — 全服可见的所有玩家都能看到的地点
- 定位栏显示 — 地标出现在原版指南针 UI 中
- 自定义颜色 — 预设颜色或十六进制值 (
#RRGGBB)
- 多种图标样式 — 不同的地标标记
- 可见半径 — 每个地标的最大/最小距离过滤
- 按玩家可见性 — 玩家可以隐藏/显示特定的全局地标
资源包(自定义图标)

默认情况下,地标使用原版风格。若要使用自定义地标样式,请从 Releases 下载资源包并在 config.yml 中进行配置:
resource-pack:
enabled: true
url: "https://your-host.com/waybar-icons.zip"
sha1: "abc123..."
一旦玩家接受该资源包,即可通过 /wp style 和 /wp styles 使用自定义样式。
如果玩家不接受该资源包,他们将看到原版样式。
还可以使用 /wp rp 命令再次提示安装资源包。
要求
- 服务器: Paper 或 Spigot 26.1–26.2
- Java: 25
- 依赖项: 无
对于 Minecraft 1.21.6–1.21.11,请下载旧版 WayBar 0.2.0 版本,并使用 Java 21 配合 ProtocolLib。该版本保持不变。当前版本针对 Minecraft 26.x,不使用 ProtocolLib。
命令
主命令:/wp(别名:/waybar, /wb)
个人地标
| 命令 |
描述 |
/wp set <name> [color:...] [style:...] [radius:...] |
在你所在位置创建地标 |
/wp tp <name> |
传送到地标 |
/wp del <name> |
删除地标 |
/wp list |
列出你的地标 |
/wp color <name> <preset|#hex|reset> |
更改颜色 |
/wp style <name> <style|reset> |
更改图标 |
/wp radius <name> <min|max> <blocks|reset> |
设置可见半径 |
全局地标
| 命令 |
描述 |
/wp gset <name> [color:...] [style:...] [radius:...] |
创建全局地标(管理员) |
/wp gtp <name> |
传送到全局地标 |
/wp gdel <name> |
删除全局地标(管理员) |
/wp glist |
列出可见的全局地标 |
/wp globals |
打开可见性 GUI |
/wp ghide <name> / /wp gshow <name> |
隐藏/显示特定全局地标 |
/wp ghideall / /wp gshowall |
隐藏/显示所有全局地标 |
实用工具
| 命令 |
描述 |
/wp help |
显示帮助信息 |
/wp colors |
列出可用颜色 |
/wp styles |
列出可用图标样式 |
权限
| 权限节点 |
默认值 |
描述 |
waypoints.use |
true |
访问 /wp 命令 |
waypoints.personal |
true |
管理个人地标 |
waypoints.personal.tp |
true |
传送到个人地标 |
waypoints.global.use |
true |
查看全局地标及可见性控制 |
waypoints.global.tp |
true |
传送到全局地标 |
waypoints.global.manage |
op |
创建/删除/编辑全局地标 |
配置
配置文件:plugins/WayBar/config.yml
默认 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
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
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧