**指南针坐标** — 一个轻量级的 Paper/Spigot 插件,它只在你拿着指南针时显示你的坐标。它在动作栏中渲染坐标,并通过 ProtocolLib 的“伪”reduceDebugInfo 切换 F3 坐标的可见性。当手中没有指南针时,坐标会在所有地方隐藏(包括 F3)。
### 功能
- 拿着指南针时,在动作栏中显示坐标(无论在哪个手上)。
- 通过 ProtocolLib 开启/关闭 F3 坐标,无需修改服务器配置。
- 完全可定制的消息格式、颜色、更新间隔和方向标签。
### 要求
- Java 17+
- 匹配您 Minecraft 版本的 Paper 或 Spigot
- 服务器上安装了 ProtocolLib
### 安装
- 将插件 .jar 文件放入服务器的 plugins 文件夹中。
- 确保 ProtocolLib 已安装且兼容。
- 启动或重启服务器。
- 如果需要,编辑 plugins/CompassCoords/config.yml,然后重启。
- 运行命令:`/gamerule reducedDebugInfo`
### 行为:
- 坐标仅在手持指南针时显示。
- 当手中没有指南针时,插件使用 ProtocolLib 在动作栏和 F3 中隐藏坐标。
### 配置文件
```yaml
# 此文件解释了每个选项。将键复制到 `plugins/CompassCoords/config.yml`。
#
# `text` 值的可用占位符:
# %x, %y, %z - 玩家坐标 (整数)
# %dx, %dy, %dz - 带有十进制的玩家坐标
# %world - 世界名称
# %yaw, %pitch - 玩家旋转 (整数)
# %dyaw, %dpitch - 带有十进制的玩家旋转
# %dir - 从偏航方向派生的方位(使用下面的 `directions` 映射)
#
# 颜色代码:
# 使用 `&`-代码 (例如 &6, &r)。它们将在运行时转换为 §-代码。
# 如果您愿意,您也可以直接编写 §-代码。
# 插件是否启用。
enabled: true
# 更新动作栏的频率(以刻度为单位)。 20 刻度 = 1 秒。
# 较低的值更新频率更高,但可能会更嘈杂。
delay: 5
# 在拿着指南针时显示的动作栏消息格式。
# 结合上述任何占位符。颜色:使用 &-代码或 §-代码。
# 例如,使用整数坐标:
# "&6%dir&r | &6X:&r %x &6Y:&r %y &6Z:&r %z"
# 例如,使用带有十进制的坐标:
# "§6%dir§r | §6X:§r %dx §6Y:§r %dy §6Z:§r %dz"
# %dir 方位所使用的 8 个指南针方向的标签。
# 如果您愿意,可以自定义它们以适应您的语言或风格。
directions:
north: "N"
northeast: "NE"
east: "E"
southeast: "SE"
south: "S"
southwest: "SW"
west: "W"
northwest: "NW"
```