定位器显示

定位器显示

一个纯客户端的定位器颜色条显示模组

定位器显示是一款客户端 Minecraft 模组，它会在玩家列表中的玩家姓名前添加一个可自定义的符号，并且该符号的颜色会与玩家定位器条的颜色完全一致。

---

功能

• 在玩家列表中的每个玩家姓名前显示一个可定制的彩色符号。
• 通过从预设中选择一个字符或指定自定义字符来自定义符号。
• 预设字符：⬤, ▌, ⬛, ★, ◆, ▶, ✚, ✖
• 使用官方 Mojang UUID 来确保颜色准确。
• 对于未向 Mojang 注册的玩家，会回退到确定性的离线 UUID。
• 完全客户端化；可用于任何多人服务器。
• 在玩家列表包含数千名玩家的服务器（如小游戏、PvP 服务器）中会自动关闭。

前置要求

• Minecraft 1.21.6 或更高版本
• Fabric Loader 0.19.3 或更高版本
• Java 21 或更高版本
• ModMenu（推荐）

安装方法

1. 下载相应的 .jar 文件
2. 将文件放入你的 .minecraft/mods 文件夹
3. 使用 Fabric Loader 启动 Minecraft

---

工作原理

1. 模组从公共 Mojang API 异步获取玩家的 Mojang UUID。
2. 使用 Java 的哈希码算法（与定位器条相同）根据 UUID 计算颜色。
3. 指定的符号会被添加到玩家列表中玩家姓名之前。

注意：如果玩家姓名不存在于 Mojang 数据库中（例如，离线/破解服务器）， 模组会使用标准的离线 UUID（UUID.nameUUIDFromBytes("OfflinePlayer:<name>")）， 以确保颜色保持稳定。

配置

该模组可通过 ModMenu 进行配置。

选项：

• 启用 → 用于开启或关闭模组
• 符号 → 选择要显示的字符
• > 自定义字符（最大长度 3） → 如果在上一选项中选择 自定义，请在此处输入你的自定义符号
• 完成 → 保存配置并退出

---

免责声明

这是自由软件：你可以自由地修改和重新分发它。 在法律允许的范围内，不提供任何担保。

许可证

代码：GPL-3.0-only
资源（徽标/图标）：CC BY-NC-ND 4.0（见 LICENSE-ASSETS）

贡献

如果你发现错误或有功能请求，请提交问题。 如果你想在代码方面做出贡献，请务必查看 TODO 文件以及已提交的问题。 通过向此仓库贡献，你同意所有新增/修改内容将在 GPLv3-only 许可证下授权，并允许以编译形式进行分发。

致谢

基于 Fabric 示例模组模板（CC0）编写。