/waypoint 命令生成器
选好要改什么,直接拿到一条能跑的命令。下面每个分支都按命令的真实语法生成,包括最容易踩的那条:目标必须只指向一个实体。
语法核对自/waypoint 命令参考页
游戏版本
自 1.21.6(快照 25w17a)以来语法没有变过。1.21.6 到 26.3 之间的所有版本都接受同一条命令。
/waypoint 需要权限等级 2(管理员)并且开启作弊。单人存档可以「对局域网开放」时勾选允许作弊,或者放进命令方块里执行。
1. 你想做什么?
16 个内置颜色名之一。会同时覆盖由 UUID 推导出的默认色和队伍颜色。
2. 改谁的?
必须刚好指向一个实体,而且这个实体得是路径点发射者 —— 玩家、生物或盔甲架。
@s 指执行命令的实体本身 —— 玩家改自己的颜色时用它最稳。
3. 选颜色
从某个玩家的默认色起步
Java 版会按 UUID 给每个实体推出一个默认标记色。先查出来,再在它基础上微调,比对着空白取色器瞎猜强。
生成的命令
/waypoint modify @s color red在聊天框里输入就留着。命令方块和数据包函数不接受斜杠,那时关掉。
需要权限等级 2 并开启作弊。仅 Java 版可用。
命令的全部分支
| 语法 | 作用 |
|---|---|
waypoint list | 列出全部已跟踪的路径点,每个都用自己的颜色显示。 |
waypoint modify <target> color <color> | 设置 16 个具名颜色之一。 |
waypoint modify <target> color hex <RRGGBB> | 设置任意 RRGGBB 颜色,不写 #。 |
waypoint modify <target> color reset | 去掉覆盖,回到默认颜色。 |
waypoint modify <target> style set <style> | 把标记图标指向资源包里的某个 waypoint_style。 |
waypoint modify <target> style reset | 把标记图标还原成 minecraft:default。 |
这个 Minecraft waypoint 命令生成器写的是什么命令
/waypoint 是唯一直接作用于定位栏的原版命令,而它能做的比大多数人以为的少:它不创建航标,只是给已经由某个实体发送出来的航标换皮。这个 Minecraft waypoint 命令生成器会拼出六种合法写法——list、color <name>、color hex <RRGGBB>、color reset、style set <style> 和 style reset——并保证参数顺序符合解析器的要求。
目标参数是实体选择器而不是坐标,而且必须正好命中一个生物实体。@e[type=creeper] 在场上出现第二只苦力怕时就会失败,@e[type=creeper,limit=1] 不会。对 waypoint_transmit_range 为 0 的实体设颜色,只会让它出现在 waypoint list 里,别处看不到。完整参数说明见 Minecraft waypoint 命令。
会让抄来的命令失效的版本规则
大多数「突然不能用了」的命令,其实是照着另一个版本写的。有三处变更要留意,上面的 Minecraft waypoint 命令生成器在你选定版本后会一并处理。
1.21.6 引入了这个特性。
定位栏和
/waypoint随 Java 版 1.21.6 发布。快照 25w15a 和 25w16a 有命令但没有航标样式,所以这个 Minecraft waypoint 命令生成器在这两个版本下会禁用样式相关选项。Java 26.2 收紧了颜色参数。
从 26.2 起,具名颜色只接受小写加下划线的形式。
dark_purple可以,DarkPurple和darkpurple直接被拒。为 1.21.x 写的命令方块和函数在更新后失效,多半就是这个原因;team modify <name> color现在也一样。游戏规则改过名。
在快照 25w44a(随 1.21.11 发布)里,所有游戏规则都改成了 snake_case 资源位置,
locatorBar因此变成locator_bar。1.21.6 到 1.21.10 用/gamerule locatorBar false,1.21.11 及以后用/gamerule locator_bar false。定位栏 gamerule 那页把包括基岩版在内的名字都列全了。
该覆盖成什么颜色
每个玩家本来就有一个由 UUID 推出的默认色——java.util.UUID.hashCode() 折成三个字节,再取九成亮度。它永远稳定,所以只有默认色确实碍事时才值得覆盖。动手前先做两项检查。
先看默认色到底是什么。
定位栏颜色查询能按用户名或 UUID 算出任意 Java 玩家的默认色,包括未加深的原值和十六个具名颜色里最接近的一个——想让覆盖后的颜色还像这个玩家,这是个好起点。算法本身写在 Minecraft UUID 颜色。
再跟全队比一遍。
覆盖成一个又跟队友撞的颜色等于白改。先把整队过一遍定位栏颜色对比工具,再只改真正造成撞色的那一个。
要经得起版本更新的,优先用具名颜色。color hex 能给出精确值,但没有自动补全,写错了也不会报错。
waypoint 命令常见问题
必须是 OP 吗?
是的——权限等级 2 且开启作弊,或者从服务器控制台、命令方块、函数里执行。没有任何客户端设置能改航标颜色。
命令执行了但什么都没发生。
多半是目标不对。选择器必须正好命中一个生物实体,而且该实体本身要在发送航标,颜色才会显示在定位栏上。26.2 及以后还要检查颜色拼写——小写加下划线。
基岩版能用吗?
不能。基岩版任何版本都没有 /waypoint 命令。基岩版每次会话随机分配标记颜色,只有用脚本 API 的附加包才能设定。细节见基岩版定位栏。
怎么撤销覆盖?
/waypoint modify <target> color reset 会去掉覆盖,标记回到 UUID 推出的默认色;style reset 对图标样式同理。这个 Minecraft waypoint 命令生成器两条都能生成。