Minecraft 定位条颜色是怎么算出来的（Java 版与基岩版）
讲清 Minecraft 定位条颜色的来源：Java 版的 UUID 哈希取色、基岩版的入场顺序配色、Geyser 的 XUID 映射，以及用 /waypoint 指令改色的方法。
更新于 2026-09-11
Java 版的定位条颜色不是随机分给你的，也不能在设置里挑：它由账号的 UUID 决定。游戏把这个 UUID 算成一个 32 位哈希值，再取最低的 24 位当作红、绿、蓝三个通道。UUID 属于账号而不属于某个世界，所以你换存档、换服务器，颜色都一模一样。
基岩版不走这套规则，大多数困惑都从这里开始。下面会一步步拆开计算过程，说明为什么 Java 版的颜色终身不变，基岩玩家经 Geyser 进入 Java 服务器时颜色怎么定，以及管理员用 /waypoint 指令改色的具体写法。
定位条是什么，颜色从哪来
定位条是屏幕上的一条 HUD 指示栏，用箭头指向航点和其他玩家的方向，在 Java 版 1.21.6 与基岩版 1.21.90 中加入。每个玩家、每个航点都有一个带颜色的小图标，玩家图标的颜色是自动生成的，不需要你手动设置。
你会遇到的情况基本就是下面四行，后面几节逐条展开，先从 Java 版的计算开始。
| 场景 | 颜色由什么决定 | 跨世界是否一致 | 能否手动改 |
|---|---|---|---|
| Java 版正版账号 | 账号 UUID 经过哈希 | 一致 | 可以，管理员用 /waypoint modify |
| Java 版离线模式服务器 | 由用户名生成的 UUID | 同一用户名下一致 | 可以，管理员用 /waypoint modify |
| 基岩版本地世界或服务器 | 按加入顺序临时分配 | 不一致，每次进游戏都可能不同 | 原版没有指令可改 |
| 基岩玩家经 Geyser/Floodgate 进 Java 服 | 由 Xbox XUID 拼出的虚拟 UUID | 一致 | 可以，在 Java 端用 /waypoint modify |
从 UUID 到颜色：具体四步
本站的定位条颜色工具复现的就是 Java 版默认颜色的计算过程。它等价于 Java 标准库中 UUID 类的 hashCode() 实现，再加上一套固定的取色方式。
- 把 36 位的 UUID 按连字符拆成 5 段，前三段拼成一个 64 位整数，后两段拼成另一个 64 位整数。
- 把这两个 64 位整数做一次异或。
- 把结果的低 32 位与高 32 位再异或一次，压成 32 位有符号整数。这个值大约有一半概率是负数，那是正常的，不是出错。
- 取它的低 24 位：第 16 至 23 位是红色，第 8 至 15 位是绿色，第 0 至 7 位是蓝色，写成 6 位十六进制就是最终颜色。
第 24 至 31 位会被完全丢掉。只要两个哈希值的低 24 位相同，颜色就完全相同。
举一个可以自己核对的例子：Notch 这个账号的 Java UUID 是 069a79f4-44e9-4726-a5be-fca90e38aaf5，哈希结果是 -369792882，十六进制写作 0xE9F5688E。低 24 位是 F5688E，所以颜色是 #F5688E，一种粉色。工具页会同时给出 HEX、RGB 和 HSL 三种写法。
上面这套规则就是本站工具采用的算法，也是社区里复现玩家默认颜色的通行做法。Mojang 并没有公开定位条配色的内部实现，所以请把它当作一份相当可靠的复现，而不是官方规范。如果游戏内颜色依然对不上，按文末的排查清单逐条核对。
为什么换存档、换服务器颜色都不变
正版 Java 账号的 UUID 由 Mojang/Microsoft 分配一次，终身绑定这个账号。它不属于某个世界、某个存档或某台服务器，改用户名也不会改 UUID。凡是基于 UUID 推导出来的东西都是稳定的，定位条颜色就是其中之一。
- 单机存档、Realms 和各种多人服务器里都是同一个颜色。
- 改名、换皮肤、换启动器都不影响。
- 游戏版本升级也不影响，前提是取色规则本身没有被改动。
- 顺带的好处：朋友之间不用问就知道哪个图标是谁，这个颜色相当于账号签名。
有一个例外是离线模式服务器。这类服务器没法向 Mojang 查询真实 UUID，于是根据玩家用户名自己生成一个，也就是 UUID v3 方案。这个 UUID 对同一个用户名是稳定的，但改名就会变，而且同名的两个人颜色完全一样。
如果你在离线模式服务器上玩，把服务器生成的那个 UUID 复制到工具的「直接输入 UUID/哈希」标签页即可。工具对你给的 UUID 做哈希，结果就是服务器那边看到的颜色。
基岩版：入场顺序、XUID 与 Geyser
原版基岩版完全不看 UUID。颜色是按玩家进入世界或服务器的先后顺序临时分配的，每次会话结束就重置，同一个玩家重新进来可能换成另一个颜色。基岩版也没有任何原版指令可以指定这个颜色。
基岩玩家进入 Java 服务器时
中间隔着 GeyserMC 和 Floodgate 时，代理会为基岩玩家造一个虚拟 Java UUID：高 64 位填 0，低 64 位填该账号的 Xbox Live XUID。Java 服务端随后把他当成普通 Java 玩家，用这个虚拟 UUID 推出一个固定颜色。
工具在「基岩版 (Geyser)」标签下走的就是这条路：先用公开的 PlayerDB 接口按玩家代号查到 XUID，把 XUID 的十六进制补足 16 位后拼成 00000000-0000-0000-XXXX-XXXXXXXXXXXX 形式的 UUID，再套用前面那套哈希流程。
举一个假想的例子：假设某个账号的 XUID 是 2535413172052385，十六进制写作 000901F1E17AA1A1，于是虚拟 UUID 是 00000000-0000-0000-0009-01F1E17AA1A1。它的哈希是 -512516016，颜色算出来是 #73A050，一种偏暗的绿。真实的 XUID 就是这种很长的十进制数字。
有两个现实限制。查玩家代号需要联网，而且依赖第三方接口，所以偶尔会出现确实存在的玩家查不到的情况；另外 Geyser 的配置会影响虚拟 UUID 的生成方式，如果代理端改过配置，算出来的颜色可能和服内不一致。
用 /waypoint 指令改颜色
Java 版 1.21.6 及以后，管理员可以覆盖自动生成的颜色，指令族是 /waypoint modify，需要管理员权限（OP 等级 2 及以上）。使用 LuckPerms 这类权限插件时，对应的权限节点是 minecraft.command.waypoint。没有这些权限的普通玩家，改不了自己或别人的颜色。
| 指令 | 作用 |
|---|---|
| /waypoint modify 玩家名 color red | 使用 16 个预设颜色名之一 |
| /waypoint modify 玩家名 color hex FF5555 | 使用精确的 6 位十六进制颜色，不带 # 号 |
| /waypoint modify 玩家名 color reset | 清除手动覆盖，回到 UUID 推导出的默认色 |
| /waypoint modify 玩家名 visibility allies | 控制谁能看到航点：everyone、allies 或 hidden |
预设颜色名就是标准的那 16 个：white、orange、magenta、light_blue、yellow、lime、pink、gray、light_gray、cyan、purple、blue、brown、green、red、black。hex 形式接受任意 6 位十六进制数字，亮橙 FF8800、暗青 228B8B 都可以。上面每条指令里的「玩家名」都要换成游戏内的真实用户名。
工具会帮你把这句指令拼好：用取色器选一个颜色，它会生成 /waypoint modify 玩家名 color hex RRGGBB，名字里带空格会自动加引号。以管理员身份粘贴到聊天栏执行，颜色立刻生效；取色器里的重置按钮可以把选色还原成 UUID 默认色。
如果你是用 UUID 而不是用户名来算的颜色，生成的指令里会保留一个占位名：Java 标签下是 Java Player，直接输入 UUID 标签下是 Resolved Player。执行前记得换成游戏里的真实用户名，否则服务器找不到目标。
算出来的颜色和游戏里不一样怎么办
这套计算是确定性的，所以对不上基本只有两种可能：输入不对，或者服务器端做了覆盖。按下面的顺序排查。
- 先确认版本。基岩玩家在本地世界里拿到的是按加入顺序临时分配的颜色，任何计算都预测不了。
- 检查是不是被覆盖过。执行一次 /waypoint modify 玩家名 color reset，看颜色是否变回算出来的那个。
- 确认用的是哪个 UUID。正版账号、离线模式服务器和 Geyser 对应三个不同的 UUID，颜色自然可能不同。
- 检查输入格式。用户名最长 16 个字符，UUID 必须是 32 位或 36 位十六进制字符，第三个标签还接受十进制哈希值，比如 -1547567136。
- 如果玩家是经 Geyser 进来的，再检查一下代理端配置。
| 输入标签 | 接受的内容 | 备注 |
|---|---|---|
| Java 版 | 用户名，或 32/36 位十六进制 UUID | 用户名通过公开的 PlayerDB 接口解析，需要联网 |
| 基岩版 (Geyser) | Xbox 玩家代号 | 先用玩家代号换到 XUID，再拼成 Geyser 风格的 UUID |
| 直接输入 UUID/哈希 | 完整 UUID，或十进制哈希值 | 离线模式的 UUID 和原始哈希值都在这里算 |
24 位色空间一共只有 16,777,216 种颜色，所以两个不同玩家拿到同一个颜色很正常。你和朋友颜色撞了，那是哈希碰撞，不是工具算错。
Java 版的定位条颜色，本质上是 UUID 的一个很短的确定性函数：算哈希、取低 24 位、拆成 RGB。想知道自己的颜色，本站的定位条颜色工具对用户名、UUID、玩家代号和原始哈希值都能算，还会在你想要别的颜色时直接生成对应的 /waypoint modify 指令。需要一个 UUID 来试算的话，UUID 生成器可以现场生成。
常见问题
改了用户名，定位条颜色会跟着变吗？
Java 版不会。颜色来自账号 UUID，而改用户名不会改 UUID。离线模式服务器的 UUID 是根据用户名生成的，那种情况下改名颜色才会跟着变。
为什么我在某个特定服务器上颜色不一样？
多半是那台服务器用 /waypoint modify 覆盖过颜色，或者它跑在离线模式下，给你分配了另一个 UUID。可以让管理员执行一次 /waypoint modify 玩家名 color reset，再和这里算出的颜色对比。
基岩版玩家能自己改定位条颜色吗？
原版基岩版不行，颜色是临时的、按加入顺序分配的。如果基岩玩家通过 Geyser 进到 Java 服务器，Java 端的管理员可以用 /waypoint modify 设置或重置颜色。
为什么工具提示找不到玩家？
用户名和玩家代号的查询走的是公开接口，需要联网，而且拼写要完全正确。如果这个玩家只存在于离线模式服务器，请改用「直接输入 UUID/哈希」标签，把服务器生成的 UUID 粘进去。
颜色到底是按 UUID 算的，还是随机的？
是确定性的。同一个 UUID 永远得到同一个哈希、同一个颜色，所以你的图标在各个服务器上颜色一致。只是 24 位色空间有限，没法保证人人不同。