/waypoint

原文：Commands/waypoint；源修订：3724964。

Java 版独有命令，需要启用作弊；权限等级为 2。管理定位栏上显示的路径点，允许查询实体已有路径点，以及修改颜色和淡出效果等外观属性。

用法

列出被跟踪的路径点，或修改指定实体所传送路径点的属性。满足以下任一条件的实体具有被跟踪路径点：

• waypoint_transmit_range 属性值大于 0。
• 在当前游戏会话中，通过 waypoint modify <waypoint> color 明确设置过路径点颜色（使用名称或十六进制代码）。这是临时状态，重新加载世界后不再跟踪。

只有拥有被跟踪路径点的实体才会出现在 waypoint list 中。

能够传送路径点的实体称为“路径点发送者”。它们仅包括活体实体，即盔甲架、生物和玩家。

语法

waypoint list：列出上述实体所有被跟踪的路径点。输出包含玩家名称或实体类型，其颜色为路径点指定颜色。若未指定，则显示白色，不受游戏随机选择颜色或队伍颜色影响。

waypoint modify <waypoint> color <color>：将路径点颜色改为 16 种颜色代码之一，覆盖默认颜色。

waypoint modify <waypoint> color hex <hex_color>：以六位十六进制颜色代码（RRGGBB，例如红色为 FF0000）设置颜色，覆盖默认颜色。

waypoint modify <waypoint> color reset：恢复默认颜色，即游戏随机选择的颜色或实体的队伍颜色。

waypoint modify <waypoint> style set <style>：从资源包的 waypoint_style 目录设置路径点样式，默认为 minecraft:default。游戏不会检查目录中是否存在定义；设为不存在的定义会让路径点图标显示缺失纹理。

waypoint modify <waypoint> style reset：重置路径点样式。

参数

waypoint（entity）：指定要修改所传送路径点的目标实体。必须解析为单个实体，且必须是路径点发送者。

color（color）：用于定位栏路径点指示器的颜色名称，覆盖默认颜色（默认颜色可能受队伍颜色影响）。必须是有效颜色名，例如 red、blue、light_purple。

hex_color（hex_color）：用于定位栏路径点指示器的十六进制颜色代码，采用 RRGGBB 格式，覆盖默认颜色。

style（resource_location）：资源包 waypoint_style 目录中的路径点样式。

结果与输出

命令不完整或参数指定不正确时无法解析。目标不是路径点发送者、颜色名称未知或十六进制颜色代码无效时失败。其他情况成功。

成功时成功次数、success 均为 1；修改命令的 result 为 0，waypoint list 的 result 为被跟踪路径点总数。

示例

列出当前所有被跟踪且正在传送的路径点：

waypoint list

将 Steve 在定位栏上的路径点颜色改为金色：

waypoint modify Steve color gold

通过十六进制代码把一只苦力怕的路径点改为亮绿色：

waypoint modify @e[type=creeper,limit=1] color hex 00FF00

将一只僵尸的路径点恢复默认颜色：

waypoint modify @e[type=zombie,limit=1] color reset

<waypoint> 选择器必须恰好解析为一个实体。若使用 @e[type=...] 而不加 limit=1，存在多个同类实体时会失败。

来源为 Minecraft Wiki；本中文翻译/改编按 CC BY-NC-SA 3.0 共享。