Minecraft 定位栏颜色检查器
计算细节
自定义你的定位栏颜色
觉得定位栏颜色不好看？用取色器选个喜欢的颜色，输入玩家名就能生成指令（需要管理员 OP 权限），复制到游戏里执行，立马换上新颜色！
Minecraft 定位栏颜色检查器 — 输入玩家名或 UUID 查询默认颜色，或使用 HSV 取色器自由选色，一键生成 /waypoint modify 指令。支持 Java 版和基岩版 Geyser。
什么是定位栏（Locator Bar）？
定位栏是《我的世界》在 1.21.6 版本（Java版）和 1.21.90 版本（基岩版）中正式上线的一项原生 HUD 功能，显示在屏幕上方，用于指示航点（Waypoint）和其他玩家的方向。在未人工干预的默认状态下，游戏底层通过实体的 UUID 经过哈希算法自动派生出颜色，确保每位玩家都有专属的定位颜色。
各版本颜色机制差异
Java 版 — 颜色永久固定
在 Java 版中，每位玩家的定位栏颜色是由其 UUID 永久决定的。由于 Mojang/微软账号的 UUID 是唯一且终身不变的，因此你的定位栏颜色在任何 Java 服务器中都完全一致——这是真正属于你的「颜色签名」。即使你修改了用户名，颜色也不会改变，因为底层 UUID 保持不变。
基岩版 — 颜色动态随机
在原版基岩版中，定位栏颜色与 UUID 完全无关。颜色是根据玩家加入世界或服务器的先后顺序临时分配的——第一个加入的可能是蓝色，第二个是绿色，依此类推。这些颜色在每次会话后都会重置，重新加入可能获得完全不同的颜色。目前基岩版中没有任何原版命令可以控制此颜色。
基岩版经 Geyser 代理 — 在 Java 服务器中获得固定颜色
当基岩版玩家通过 GeyserMC 或 Floodgate 代理连接到 Java 服务器时，代理程序会根据玩家的 Xbox Live XUID 自动生成一个虚拟 Java UUID（高64位为0，低64位为 XUID）。Java 服务器会像对待 Java 玩家一样，基于此虚拟 UUID 分配一个固定的定位栏颜色。本工具可以精确计算该颜色。
如何修改定位栏颜色（Java 版）
在 Java 版 1.21.6 及更高版本中，拥有足够权限的服务器管理员可以使用 /waypoint命令自定义定位栏的航点颜色。以下是所有可用命令：
设置预设颜色名称
支持的颜色名称包括：white（白色）、orange（橙色）、magenta（品红）、light_blue（浅蓝色）、yellow（黄色）、lime（黄绿色）、pink（粉色）、gray（灰色）、light_gray（浅灰）、cyan（青色）、purple（紫色）、blue（蓝色）、brown（棕色）、green（绿色）、red（红色）、black（黑色）。
设置自定义十六进制颜色
使用 hex 关键词加上 6 位十六进制色码（不加 #）来设置精确的自定义颜色。例如 hex FF5555 为柔和红色，hex 55FF55 为亮绿色。
重置为 UUID 默认颜色
移除所有手动覆盖，将该玩家的定位栏颜色恢复为由 UUID 自动计算的默认值——也就是本工具所计算的结果。
控制航点可见性
控制哪些人能看到该玩家的航点。可选模式：everyone（所有人可见）、allies（仅队友可见）、hidden（完全隐藏）。默认为 everyone。
注意：/waypoint 命令需要管理员权限（OP 等级 2 及以上）。普通玩家无法修改自己或他人的颜色。在使用权限插件（如 LuckPerms）的服务器上，相关权限节点为 minecraft.command.waypoint。
技术原理解析
Java UUID 哈希映射
游戏底层将玩家的 128 位 UUID 视为包含两个 64 位长整型（Most/Least Significant Bits）的结构，并对其取 hashCode()。计算出的 32 位整型通过位移操作拆分为 R、G、B 分量，得到最终渲染的颜色。
基岩版与 Geyser 转换
基岩版原生定位栏颜色通常是加入世界的临时顺序分配的。但在通过 Geyser 跨服代理进入 Java 服务器时，Geyser 会利用玩家的 Xbox XUID 生成一个特定的虚拟 Java UUID。本工具支持该算法，方便计算基岩玩家在 Java 服务器中的颜色。
手动修改与重置
拥有管理员权限的玩家可以使用 /waypoint modify <玩家名> color <颜色/十六进制> 命令强制指定某种颜色。若想恢复默认颜色，可运行 /waypoint modify <玩家名> color reset。
常见问题解答
为什么我的游戏内颜色和计算结果不一致？
请确保您查询的版本正确。如果在 Java 服务器中，请确认管理员是否使用过 /waypoint modify 指令覆盖了您的颜色。此外，部分 GeyserMC 服务端插件可能会根据不同的配置生成不同格式的虚拟 UUID。
基岩版 Xbox 玩家代号是如何转换为 UUID 的？
Geyser 默认会将 Xbox 账号的 XUID（64位无符号长整型）作为 UUID 的低 64 位，而高 64 位设为 0。本工具通过 PlayerDB 接口获取玩家的 XUID，并重现此拼接过程，算出对应的 UUID 和哈希。
离线模式（非正版）玩家能计算吗？
离线模式（盗版）服务器生成 UUID 是根据玩家名字的离线哈希（UUID v3）生成的。您可以将所得的离线 UUID 直接输入到第三个 Tab（直接输入 UUID）中来进行计算。
基岩版玩家能手动修改定位栏颜色吗？
在原版基岩版中，目前没有任何命令或设置可以手动控制定位栏颜色。颜色由游戏引擎根据加入顺序自动且临时地分配。如果基岩版玩家通过 Geyser 加入了 Java 服务器，则服务端管理员可以在 Java 端使用 /waypoint modify 进行修改。