PlayerLocatorPlus NeoForged

PlayerLocatorPlus NeoForged

在经验条上方添加类似指南针的多人游戏 HUD。它会显示同一维度中其他玩家的方向，让你无需打开地图或路径点界面，也能更轻松地找到队友。

本项目是由 timas130 的 Player Locator Plus 独立移植至 NeoForge 1.21.1 的版本。

功能

• 使用 UUID、队伍、自定义或共享颜色显示彩色玩家标记
• 按住 Tab 时显示玩家头像和名称
• 标记会根据距离逐渐淡出并缩小
• 高度差较大时显示上下方向指示
• 可配置追踪范围、方向精度和更新频率
• 可由服务器设置在玩家潜行、隐身或穿戴指定装备时隐藏其标记
• 切换维度时正确同步标记
• 必要时，原版经验值和跳跃指示器仍优先显示在 HUD 上

安装

• Minecraft 1.21.1
• NeoForge 21.1.x
• Java 21
• 客户端和服务器都需要安装

发布版 jar 已包含所需的 Kotlin 和 TOML 运行时库。无需安装 Fabric API、Fabric Language Kotlin 或 Cloth Config。

配置与隐私

配置存储在 config/player-locator-plus.toml。修改服务器设置后，请以管理员身份运行 /plp reload，或重启服务器。

服务器所有者可以禁用追踪、设置最大范围、降低方向精度、控制更新频率，并选择是否发送距离数据。

以下情况下，玩家标记可以隐藏：

• 潜行时
• 隐身时
• 穿戴雕刻过的南瓜时
• 穿戴 player-locator-plus:hiding_equipment 物品标签中的装备时

可以通过数据包修改装备标签。禁用距离数据并不能阻止通过方向更新进行近似三角定位；如需更严格的限制，请使用 directionPrecision 和 maxDistance。

命令

• /plp reload — 重新加载配置（仅限管理员）
• /plp color <color> — 启用自定义颜色时，设置自己的标记颜色
• /plp color <color> <player> — 设置其他玩家的标记颜色（权限等级 3）
• /plp random — 显示测试标记（权限等级 2）

颜色可以使用 Minecraft 颜色名称，也可以使用六位十六进制值，例如 #ff8800。

关于此分支

原版 Player Locator Plus提供定位 HUD、标记自定义、隐藏规则、命令以及客户端/服务器配置机制。

此分支：

• 将项目从 Fabric 移植到 Minecraft 1.21.1 的 NeoForge
• 使用 Java 21，并打包所需的运行时库
• 使用 NeoForge GUI 图层重新实现 HUD 集成
• 修复玩家切换维度后标记未及时更新的问题

Player Locator Plus NeoForge 是基于 GPL-3.0-or-later 许可证分发的衍生作品，由独立团队维护，且未获得原作者认可。

源代码 · 问题反馈 · 致谢 · 许可证