返回博客

文章

Minecraft 定位栏颜色查询：Locator Bar Color 是怎么来的、怎么改

Minecraft 定位栏（Locator Bar）颜色由 UUID 决定。本文讲清颜色计算原理，教你查询自己的准确颜色、查看全部 16 种定位栏颜色，并用 /waypoint 修改它。

Minecraft 定位栏颜色查询：Locator Bar Color 是怎么来的、怎么改

Minecraft 定位栏颜色（Locator Bar Color）不是随机的。在 Java 版中，客户端根据你的账号 UUID 推导出标记颜色，所以同一个 UUID 永远得到同一个色点——在任何服务器、任何世界都一样，且永久不变。基岩版则完全不同：它在每次进入游戏时随机分配一个颜色。

最新调研核查：2026 年 7 月 26 日。 本页所有数据与命令均已对照 Minecraft Wiki 官方 Locator Bar 条目 与 Wiki 的 /waypoint 命令文档 核验，颜色算法部分另与 Locator Bar Color、Laby 的实现做了交叉比对。

想立刻知道自己的颜色？ 使用免费的 Minecraft 定位栏颜色查询工具。粘贴 UUID 即可——如果你玩的是离线服 / 局域网服，直接输入用户名也行——工具会返回准确的 hex 与 RGB 值。全部计算在浏览器本地完成，不会上传任何数据。

什么是定位栏（Locator Bar）

定位栏是一条 HUD 状态条，用来显示其他玩家相对于你视线方向的位置。大多数时候它会取代经验条；当你获得经验、或打开铁砧与附魔台时会临时让位（之后还会隐藏 100 游戏刻）。

加入版本如下：

版本分支版本号说明
Java 版1.21.6最早出现在快照 25w15a，需实验性数据包；25w17a 起正常启用
基岩版1.21.90最早出现在预览版 1.21.80.20；预览版 1.21.90.23 起取消实验性开关

只有位于你镜头方向 120 度 范围内的玩家才会显示标记。如果对方在你视角俯仰角的上方或下方，标记上会出现一个小的方向指示，提示你抬头或低头。

定位栏颜色是怎么决定的

在 Java 版中，有三种因素可以决定标记颜色，优先级从高到低：

  1. /waypoint 显式设置的颜色 —— 由管理员设置，优先级最高。
  2. 记分板队伍颜色 —— 如果你所在队伍设置了颜色，会覆盖默认颜色。
  3. 你的 UUID —— 自动兜底方案，也是绝大多数玩家实际看到的那个颜色。

第三点才是关键，也是绝大多数误解的来源。

UUID 颜色计算原理

Minecraft 并没有在任何地方存储你的颜色，而是每次都从 UUID 现场算出来，步骤如下：

  1. 取你的 UUID，执行 Java 标准的 UUID.hashCode()，得到一个 32 位整数。
  2. 读取该整数的 低 24 位，拆成三个字节：红、绿、蓝。
  3. 把这个原始 RGB 交给渲染器，渲染器保留色相与饱和度，但把亮度归一到约 90% 后再绘制标记。

第三步比听上去重要得多。如果没有它，某些哈希值接近 0 的 UUID 会渲染成一个几乎全黑的点，在 HUD 上根本看不见。亮度归一意味着偏暗的原始颜色会被提亮、过亮的会被略微压暗，从而保证每个标记都清晰可辨。这也意味着第 2 步得到的原始 hex 并不是你在屏幕上看到的颜色——这正是不同 UUID 取色工具结果会互相打架的原因。

由于正版（Mojang / 微软）账号的 UUID 永不改变，你的 Java 版定位栏颜色是永久的。改用户名不会变，换服务器不会变，重装游戏也不会变。

如何查询自己的 Minecraft UUID

查颜色需要先拿到 UUID，具体方法取决于你的账号类型。

如果你是正版账号：

  • 使用定位栏颜色查询工具的用户名模式，或任意 Minecraft UUID 查询服务，例如 NameMC。
  • 在游戏内执行 /data get entity @s UUID，会以整数数组形式输出你的 UUID。
  • 直接请求 Mojang 公开 API：https://api.mojang.com/users/profiles/minecraft/<用户名>。

正版 UUID 绑定的是账号本身而非名称，所以无论改多少次用户名，它都不会变。

如果你玩离线服、局域网服或第三方（盗版）服：

因为背后没有 Mojang 账号，服务器会改为根据你的名字生成 UUID：把字符串 OfflinePlayer:<你的名字> 哈希成一个版本 3 的 UUID。这带来一个实际后果：在离线服上改用户名，你会得到一个全新的 UUID，因而得到一个全新的定位栏颜色。 查询工具的离线用户名模式复现的就是这套计算，你可以在正式改名前先预览某个名字会产生什么颜色。

全部 16 种定位栏颜色

以下是 /waypoint modify ... color 接受的 16 种命名颜色，与 /team modify ... color、聊天格式化代码使用的是同一套。注意它们不是染料颜色，所以这里没有橙色、青色和棕色。

颜色名Hex颜色名Hex
black#000000dark_gray#555555
dark_blue#0000AAblue#5555FF
dark_green#00AA00green#55FF55
dark_aqua#00AAAAaqua#55FFFF
dark_red#AA0000red#FF5555
dark_purple#AA00AAlight_purple#FF55FF
gold#FFAA00yellow#FFFF55
gray#AAAAAAwhite#FFFFFF

如果这 16 种都不合心意，/waypoint 也支持任意 hex 值，见下文。

如何修改定位栏颜色

游戏设置菜单里没有这个选项。普通玩家无法自行修改颜色——所有方法都需要管理员权限，或者需要服主帮你执行命令。

方法一：/waypoint 命令

/waypoint 需要权限等级 2 并开启作弊。语法如下：

/waypoint modify <目标> color <颜色名>
/waypoint modify <目标> color hex <RRGGBB>
/waypoint modify <目标> color reset
/waypoint modify <目标> style set <样式>
/waypoint modify <目标> style reset
/waypoint list

<目标> 可以是玩家名、UUID，或一个只能匹配到单个航点发送实体的目标选择器。

几个实际例子：

/waypoint modify @s color red
/waypoint modify Steve color hex 00E5B8
/waypoint modify @s color reset

注意 hex 形式是六位十六进制，不带 # 前缀。color reset 用于清除手动覆盖，恢复成自动的 UUID 颜色。

方法二：队伍颜色

如果你不想逐个玩家管理航点，可以改用带颜色的记分板队伍，队伍颜色会自动作用到定位栏：

/team add red_team
/team modify red_team color red
/team join red_team Steve

对 PvP 服和小游戏服来说这通常是更好的方案，因为玩家在定位栏上看到的颜色会与聊天、名牌上的队伍颜色保持一致。

方法三：在离线服上改名

这招比较粗暴但确实有效：离线服的 UUID 由用户名推导而来，换个名字就换个颜色。可以在查询工具的离线模式里逐个试候选名字，直到找到满意的颜色。

看懂定位栏：形状与距离

标记的形状能大致告诉你对方有多远，距离越远形状越小、越圆：

距离标记形状
0–179 格方形
179–230 格圆形
230–281 格小方形
281 格以上小圆形

配合颜色一起看，一眼就能获取相当多的信息：是谁、在哪个方向、大概多远，以及在你上方还是下方。

如何在定位栏中隐藏自己

你并非只能被动暴露位置，以下任意一种方式都能让你的标记对其他玩家隐藏：

  • 潜行
  • 佩戴生物头颅或雕刻南瓜
  • 处于隐身效果下
  • 处于旁观模式（此时仍对其他旁观者可见）

服主可控的手段更多。Java 版中有两个实体属性控制作用范围：

  • waypoint_transmit_range —— 该实体的标记能被多远之外接收到。
  • waypoint_receive_range —— 该实体能接收到多远之外的标记。

只有生物类实体才能发送航点，包括玩家、生物和盔甲架。

如何关闭定位栏

  • Java 版： /gamerule locator_bar false 可对整个世界关闭。
  • 基岩版： 在设置中找到 Player waypoints（玩家路径点），选项为 Everyone 或 Off。

Java 版 vs 基岩版：为什么我的颜色一直在变

这是最常见的困惑来源，值得单独说清楚：

Java 版基岩版
颜色来源由 UUID 推导随机分配
稳定性永久固定，各处一致每次会话都换新颜色
管理员能否覆盖可以，/waypoint 或队伍颜色没有 /waypoint 命令
开关方式locator_bar 游戏规则”Player waypoints” 设置项

如果你在基岩版上发现颜色跟昨天不一样，那不是 bug，而是设计如此。只有 Java 版的颜色是稳定可预测的，也只有 Java 版的颜色能通过 UUID 查出来。

给服主的几点建议

  • 两名玩家可能拿到非常接近的颜色。 UUID 哈希没有任何防冲突机制，人一多迟早会出现两个几乎一样的标记。用队伍颜色来解决。
  • 分配队伍前先查颜色。 把常驻玩家丢进颜色查询工具跑一遍，再分配与他们现有颜色形成对比的队伍色。
  • 亮度归一会限制你的配色空间。 由于渲染器会固定亮度，非常暗的 hex 值在屏幕上并不会保持很暗，设计时请以中高亮度的颜色为主。
  • /waypoint 的覆盖不会因换队而失效。 显式航点颜色优先级高于队伍颜色，所以如果某个玩家的颜色”卡住”了，先检查是不是残留了 /waypoint modify，再去排查队伍配置。

常见问题

Minecraft 定位栏颜色是永久的吗？

Java 版是永久的。它由账号 UUID 计算而来，而 UUID 永不改变，因此在任何服务器上都相同，改用户名和重装游戏也不影响。基岩版则是随机的，每次会话都会变。

改用户名会改变定位栏颜色吗？

正版账号不会——UUID 绑定的是账号而非名称。但在离线服、局域网服或第三方服上会改变，因为服务器是用 OfflinePlayer:<名字> 生成 UUID 的。

普通玩家能自己改定位栏颜色吗？

不能。修改颜色需要 /waypoint 命令（权限等级 2 且开启作弊）或记分板队伍颜色，两者都需要管理员权限，客户端没有任何相关选项。

为什么查询工具给的 hex 和我游戏里看到的颜色不一样？

因为客户端在绘制前会对标记做亮度归一。UUID 哈希直接得到的原始值并不是屏幕上的颜色。质量好的查询工具会一并应用这一步着色处理，这也是不同工具结果会有差异的原因。

定位栏是哪个版本加入的？

Java 版 1.21.6（快照 25w15a 为实验性，25w17a 起正常启用），基岩版 1.21.90（预览版 1.21.80.20 为实验性）。

航点可以用任意 hex 颜色吗？

可以。/waypoint modify <目标> color hex RRGGBB 接受任意六位十六进制值，不带 #。但过暗的值仍然会被渲染器提亮。

怎样才能不被其他玩家在定位栏上看到？

潜行、佩戴生物头颅或雕刻南瓜、喝隐身药水，或切换到旁观模式。管理员还可以通过 waypoint_transmit_range 属性限制可见范围，或用 /gamerule locator_bar false 直接关闭定位栏。

生物会显示在定位栏上吗？

只有生物类实体才能发送航点，默认情况下定位栏只显示其他玩家。管理员可以通过调整 waypoint_transmit_range 属性，让生物、盔甲架等其他生物类实体也发送航点。

查询你的颜色

想拿到准确颜色，最快的方式是使用 Minecraft 定位栏颜色查询工具。它同时支持正版 UUID 与离线用户名，会给出归一化后的 hex 与 RGB 值并实时预览，还附带全部 16 种命名颜色供参考。无需登录、不调用 Mojang API、数据不出浏览器。