/waypoint

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

/waypoint

Permission level required	2
Restrictions	Cheats enabled

{
    "title": "<code>/waypoint</code>",
    "rows": [
        {
            "field": "2",
            "label": "(link to Permission level article, displayed as Permission level<br>required)"
        },
        {
            "field": "(link to Options#Cheats article, displayed as Cheats) enabled<br/><sup class=\"noprint nowrap Inline-Template \" title=\"\">[<i>only \"(link to Locator Bar article, displayed as Locator Bar)\" (link to Experiments article, displayed as Experiment)</i>]</sup>",
            "label": "(link to Commands#Restrictions article, displayed as Restrictions)"
        }
    ],
    "invimages": [],
    "images": []
}

Usage

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

• The entity has the waypoint_transmit_range attribute set to a value greater than 0.
• The entity's waypoint color has been explicitly set using /waypoint modify <waypoint> color (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 /waypoint list.

Syntax

waypoint list

Lists all entities currently transmitting a tracked waypoint (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 team color.

waypoint modify <waypoint> color <color>

Changes the color of the waypoint to one of the 16 color codes. This overrides the default color.

waypoint modify <waypoint> color hex <hex_color>

Changes the color of the waypoint using a 6-digit hexadecimal color code (RRGGBB format, e.g., FF0000 for red). This overrides the default color.

waypoint modify <waypoint> color reset

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

waypoint modify <waypoint> fade <fade_start> <alpha_start> <fade_end> <alpha_end>

Defines a custom distance-based fade effect for the specified entity's waypoint indicator on the locator bar. The indicator will have initial opacity of alpha_start (0.0–1.0), and starting at distance fade_start (blocks), it will fade linearly to opacity alpha_end at distance fade_end.

waypoint modify <waypoint> fade reset

Resets the fade effect for the specified entity's waypoint indicator to the default behavior.

Arguments

<waypoint>: entity

Specifies the target entity whose transmitted waypoint should be modified.

Must be a player name, a target selector or a UUID. And the target selector must be in single type.

<color>: color

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

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

<hex_color>: string

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

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

<fade_start>: integer

Specifies the distance (in blocks) at which the waypoint indicator starts fading on the locator bar.

Must be a [Int]32-bit integer number (from -2147483648 (-2³¹) to 2147483647 (2³¹-1) ). And it must be between 0 and 2147483647 (inclusive).

<alpha_start>: float

Specifies the opacity (alpha value) of the waypoint indicator at the fade_start distance.

Must be a [Float]Single-precision floating-point number (from -(2-2^-23)×2¹²⁷ (≈-3.4×10³⁸) to (2-2^-23)2×¹²⁷ (≈3.4×10³⁸) ). And it must be between 0.0 and 1.0 (inclusive). (0.0 is fully transparent, 1.0 is fully opaque).

<fade_end>: integer

Specifies the distance (in blocks) at which the waypoint indicator finishes fading on the locator bar. Must be greater than or equal to fade_start.

Must be a [Int]32-bit integer number (from -2147483648 (-2³¹) to 2147483647 (2³¹-1) ). And it must be between 0 and 2147483647 (inclusive).

<alpha_end>: float

Specifies the opacity (alpha value) of the waypoint indicator at the fade_end distance and beyond.

Must be a [Float]Single-precision floating-point number (from -(2-2^-23)×2¹²⁷ (≈-3.4×10³⁸) to (2-2^-23)2×¹²⁷ (≈3.4×10³⁸) ). And it must be between 0.0 and 1.0 (inclusive).

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 locator bar:

  waypoint modify Steve color gold

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

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

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

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

• To make a random player's waypoint indicator fully opaque (alpha 1.0) up to 20 blocks away, then fade to 30% opaque (alpha 0.3) by 100 blocks away on the locator bar:

  waypoint modify @r fade 20 1.0 100 0.3

• To reset the fade effect for a skeleton to the default behavior:

  waypoint modify @e[type=skeleton,limit=1] fade reset

History

[hide]Upcoming Java Edition
1.21.6 Experiment Locator Bar			25w15a				Added /waypoint.