追捕指南针

追猎指南针

一个高性能、服务端驱动的 Fabric 模组，专为 Minecraft 1.21.8 设计，为追猎小游戏引入动态玩家追踪指南针机制。本模组以效率和原版一致同步为设计理念，采用现代组件系统，完全在服务端运行。

⚡ 功能

• 动态目标系统： 右键单击指南针可按字母顺序循环切换所有在线活跃玩家（不包括你自己）。

• 智能动作栏同步： 在动作栏上动态显示目标的名称、当前所在世界状态以及精确方块距离的实时更新。

• 自动手持处理： 追踪算法会自动识别并更新指南针，无论其位于主手还是副手。

• 物品栏生命周期控制： * 玩家重生后会自动获得一个全新的追踪指南针。

• 死亡时指南针会立即从物品栏中移除，防止意外掉落或复制。

• 精细性能配置： 内置 JSON 配置管理器，允许你自定义指南针显示名称，在 ACTION_BAR 或 CHAT 日志之间选择，切换方块距离计算功能，并调整刻更新间隔以最大限度地减少服务端开销。

🛠️ 命令与权限

本模组提供简洁、本地化的命令，基础命令为 /pusula，并包含用于国际化场景的内部别名。

命令	权限等级	描述
/pusula	所有人	向执行命令的玩家给予一个新的追踪指南针。
/compass	所有人	/pusula 的别名。
/target	所有人	/pusula 的别名。
/pusula reload	OP（等级 2）	直接从磁盘重新加载 JSON 配置文件并立即重置内部刻计时器。

⚙️ 配置文件

配置文件会自动生成在 .minecraft/config/manhunt-compass.json 路径下。

{
  "compassName": "§6追猎指南针",
  "messageType": "ACTION_BAR",
  "blockReach": true,
  "updateInterval": 20
}

• compassName：自定义字符串，支持原版格式色彩代码。
• messageType：在 ACTION_BAR 或 CHAT 输出之间选择。
• blockReach：切换是否向追踪者广播精确方块距离的计算结果。
• updateInterval：更新的频率，以服务端刻为单位（例如 20 刻 = 1 秒）。