Minecraft:Commands/waypoint

Manages waypoints displayed on the Minecraft:locator bar. Allows querying existing waypoints of entities and modifying their appearance properties like color and fade effect.

Usage

Lists tracked waypoints or modifies properties of the waypoint being transmitted by specific Minecraft:entities. A tracked waypoint is associated with an entity that meets either of the following conditions:

• The entity has the Template:Attr attribute set to a value greater than 0.
• The entity's waypoint color has been explicitly set using Template:Cmd (either with a name or hex code) during the current game session. This is temporary and it is no longer tracked after reloading the world.

Only entities with tracked waypoints can be listed by Template:Cmd.

Any entities that can transmit a waypoint is called waypoint transmitter. They only include Minecraft:living entities, which are Minecraft:armor stands, Minecraft:mobs, and Minecraft:players.

Syntax

waypoint list

Lists all tracked waypoint from entities (as defined above). The output includes the player's name or the entity's type with color specified by their waypoint color. If none specified, it results to white, regardless of the randomly chosen color by the game or their Minecraft:team color.

waypoint modify <waypoint> color <color>

Changes the waypoint's color to one of the 16 Minecraft:color codes. This overrides the default color.

waypoint modify <waypoint> color hex <hex_color>

Changes the waypoint's color using a 6-digit Template:W code (RRGGBB format, e.g., FF0000 for red). This overrides the default color.

waypoint modify <waypoint> color reset

Resets the waypoint's color to the default color (chosen randomly by the game, or the entity's Minecraft:team color).

waypoint modify <waypoint> style set <style>

Sets the Minecraft:waypoint style from Template:Cd directory in a Minecraft:resource pack. By default, it is set to Template:Cd.

The game does not check if a definition exists under the directory, setting it to a non-existent definition results in a Minecraft:missing texture for the waypoint icon.

waypoint modify <waypoint> style reset

Resets the waypoint's style.

Arguments

Specifies the target entity whose transmitted waypoint should be modified.

Template:Arg desc Must be a waypoint transmitter.

Specifies a color name to apply to the waypoint's indicator on the Minecraft:locator bar. This overrides the default color (which may be influenced by the entity's Minecraft:team color).

Must be a valid color name (e.g., red, blue, light_purple).

Specifies a Template:W code (RRGGBB format) to apply to the waypoint's indicator on the Minecraft:locator bar. This overrides the default color.

Must be a 6-digit hexadecimal number (000000-FFFFFF). For example, FF0000 for red, 6495ED for cornflower blue.

Specifies the Minecraft:waypoint style from Template:Cd directory in a resource pack.

Template:Arg desc

Examples

• To list all currently tracked waypoints being transmitted:

  waypoint list

• To change the waypoint color for the player named "Steve" to gold on the Minecraft:locator bar:

  waypoint modify Steve color gold

• To change the waypoint color for a Minecraft:creeper to lime using a hex code:Template:Note

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

• To reset the waypoint color for a Minecraft:zombie to its default color:Template:Note

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