Minecraft:Commands/waypoint - Revision history

SyncBot: Fix template calls: add MC/ prefix

2026-04-09T20:15:12Z

Fix template calls: add MC/ prefix

← Older revision		Revision as of 20:15, 9 April 2026
Line 1:		Line 1:
	{{~~exclusive~~\|java}}		{{MC/Exclusive\|java}}
	{{Infobox command		{{Infobox command
	\| name = waypoint		\| name = waypoint
Line 11:		Line 11:

	Lists tracked waypoints or modifies properties of the waypoint being transmitted by specific entities. A tracked waypoint is associated with an entity that meets either of the following conditions:		Lists tracked waypoints or modifies properties of the waypoint being transmitted by specific entities. A tracked waypoint is associated with an entity that meets either of the following conditions:
	* The entity has the {{~~attr~~\|waypoint_transmit_range}} attribute set to a value greater than 0.		* The entity has the {{MC/Attr\|waypoint_transmit_range}} attribute set to a value greater than 0.
	* The entity's waypoint color has been explicitly set using {{~~cmd~~\|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.		* The entity's waypoint color has been explicitly set using {{MC/Cmd\|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 {{~~cmd~~\|waypoint list}}.		Only entities with tracked waypoints can be listed by {{MC/Cmd\|waypoint list}}.

	Any entities that can transmit a waypoint is called ''waypoint transmitter''. They only include living entities, which are armor stands, [[Minecraft:mob]]s, and players.		Any entities that can transmit a waypoint is called ''waypoint transmitter''. They only include living entities, which are armor stands, [[Minecraft:mob]]s, and players.
Line 25:		Line 25:
	:: Changes the waypoint's color to one of the 16 color codes. This overrides the default color.		:: Changes the waypoint's color to one of the 16 color codes. This overrides the default color.
	: <code>waypoint modify <waypoint> color hex <hex_color></code>		: <code>waypoint modify <waypoint> color hex <hex_color></code>
	:: Changes the waypoint's color using a 6-digit {{w\|hexadecimal color}} code (RRGGBB format, e.g., <code>FF0000</code> for red). This overrides the default color.		:: Changes the waypoint's color using a 6-digit {{MC/W\|hexadecimal color}} code (RRGGBB format, e.g., <code>FF0000</code> for red). This overrides the default color.
	: <code>waypoint modify <waypoint> color reset</code>		: <code>waypoint modify <waypoint> color reset</code>
	:: Resets the waypoint's color to the default color (chosen randomly by the game, or the entity's team color).		:: Resets the waypoint's color to the default color (chosen randomly by the game, or the entity's team color).
	: <code>waypoint modify <waypoint> style set <style></code>		: <code>waypoint modify <waypoint> style set <style></code>
	:: Sets the waypoint style from {{cd\|waypoint_style}} directory in a resource pack. By default, it is set to {{cd\|minecraft:default}}.		:: Sets the waypoint style from {{MC/Cd\|waypoint_style}} directory in a resource pack. By default, it is set to {{MC/Cd\|minecraft:default}}.
	:: The game does not check if a definition exists under the directory, setting it to a non-existent definition results in a missing texture for the waypoint icon.		:: The game does not check if a definition exists under the directory, setting it to a non-existent definition results in a missing texture for the waypoint icon.
	: <code>waypoint modify <waypoint> style reset</code>		: <code>waypoint modify <waypoint> style reset</code>
Line 36:		Line 36:
	== Arguments ==		== Arguments ==

	{{~~argument~~\|waypoint\|entity}}		{{MC/Argument\|waypoint\|entity}}
	: Specifies the target entity whose transmitted waypoint should be modified.		: Specifies the target entity whose transmitted waypoint should be modified.
	: {{~~arg~~ desc\|je=entity\|amount=single\|type=entities}} Must be a waypoint transmitter.		: {{MC/Arg desc\|je=entity\|amount=single\|type=entities}} Must be a waypoint transmitter.

	{{~~argument~~\|color\|color}}		{{MC/Argument\|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).		: 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., <code>red</code>, <code>blue</code>, <code>light_purple</code>).		: Must be a valid color name (e.g., <code>red</code>, <code>blue</code>, <code>light_purple</code>).

	{{~~argument~~\|hex_color\|hex_color}}		{{MC/Argument\|hex_color\|hex_color}}
	: Specifies a {{w\|hexadecimal color}} code (RRGGBB format) to apply to the waypoint's indicator on the locator bar. This overrides the default color.		: Specifies a {{MC/W\|hexadecimal color}} code (RRGGBB format) to apply to the waypoint's indicator on the locator bar. This overrides the default color.
	: Must be a 6-digit hexadecimal number (000000-FFFFFF). For example, <code>FF0000</code> for red, <code>6495ED</code> for cornflower blue.		: Must be a 6-digit hexadecimal number (000000-FFFFFF). For example, <code>FF0000</code> for red, <code>6495ED</code> for cornflower blue.

	{{~~argument~~\|style\|resource_location}}		{{MC/Argument\|style\|resource_location}}
	: Specifies the waypoint style from {{cd\|waypoint_style}} directory in a resource pack.		: Specifies the waypoint style from {{MC/Cd\|waypoint_style}} directory in a resource pack.
	: {{~~arg~~ desc\|je=resource_location}}		: {{MC/Arg desc\|je=resource_location}}

	== Result ==		== Result ==
Line 56:		Line 56:
	{{Result table\|onlyje=1}}		{{Result table\|onlyje=1}}
	{{Result table\|The command is incomplete, or any argument is not specified correctly.\|unparseable}}		{{Result table\|The command is incomplete, or any argument is not specified correctly.\|unparseable}}
	{{Result table\|cmd=/waypoint modify <waypoint>\|{{cd\|waypoint}} is a target selector that's not a waypoint transmitter.\|fail}}		{{Result table\|cmd=/waypoint modify <waypoint>\|{{MC/Cd\|waypoint}} is a target selector that's not a waypoint transmitter.\|fail}}
	{{Result table\|cmd=/waypoint modify ... color <color>\|{{cd\|color}} is an unknown color.\|fail}}		{{Result table\|cmd=/waypoint modify ... color <color>\|{{MC/Cd\|color}} is an unknown color.\|fail}}
	{{Result table\|cmd=/waypoint modify ... color hex <hex_color>\|{{cd\|hex_color}} is an invalid hex color code.\|fail}}		{{Result table\|cmd=/waypoint modify ... color hex <hex_color>\|{{MC/Cd\|hex_color}} is an invalid hex color code.\|fail}}
	{{Result table\|cmd=\|succeed}}		{{Result table\|cmd=\|succeed}}
	{{Result table}}		{{Result table}}
Line 64:		Line 64:
	== Output ==		== Output ==

	{{Output table}}		{{MC/Output table}}
	{{Output table\|edition=je\|On success\|1\|1\|0}}		{{MC/Output table\|edition=je\|On success\|1\|1\|0}}
	{{Output table\|cmd=/waypoint list\|On success\|1\|1\|the total number of tracked waypoints}}		{{MC/Output table\|cmd=/waypoint list\|On success\|1\|1\|the total number of tracked waypoints}}
	{{Output table}}		{{MC/Output table}}

	== Examples ==		== Examples ==
Line 75:		Line 75:
	* To change the waypoint color for the player named "Steve" to gold on the locator bar:		* To change the waypoint color for the player named "Steve" to gold on the locator bar:
	*: <code>waypoint modify Steve color gold</code>		*: <code>waypoint modify Steve color gold</code>
	* To change the waypoint color for a creeper to lime using a hex code:{{note\|name=single_entity\|1=The {{cd\|<waypoint>}} selector must resolve to exactly one entity. Using a selector like <code>@e[type=...]</code> without <code>limit=1</code> will fail if more than one entity of that type exists.}}		* To change the waypoint color for a creeper to lime using a hex code:{{note\|name=single_entity\|1=The {{MC/Cd\|<waypoint>}} selector must resolve to exactly one entity. Using a selector like <code>@e[type=...]</code> without <code>limit=1</code> will fail if more than one entity of that type exists.}}
	*: <code>waypoint modify @e[type=creeper,limit=1] color hex 00FF00</code>		*: <code>waypoint modify @e[type=creeper,limit=1] color hex 00FF00</code>
	* To reset the waypoint color for a [[Minecraft:zombie]] to its default color:{{note\|name=single_entity}}		* To reset the waypoint color for a [[Minecraft:zombie]] to its default color:{{note\|name=single_entity}}
Line 84:		Line 84:
	== History ==		== History ==
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|java}}		\|{{MC/HistoryLine\|java}}
	\|{{HistoryLine\|\|1.21.6\|exp=Locator Bar\|dev=25w15a\|Added {{~~cmd~~\|waypoint\|link=none}}.}}		\|{{HistoryLine\|\|1.21.6\|exp=Locator Bar\|dev=25w15a\|Added {{MC/Cmd\|waypoint\|link=none}}.}}
	\|{{HistoryLine\|\|1.21.6\|dev=25w17a		\|{{HistoryLine\|\|1.21.6\|dev=25w17a
	\|{{~~cmd~~\|waypoint\|link=none}} is now available in normal gameplay.		\|{{MC/Cmd\|waypoint\|link=none}} is now available in normal gameplay.
	\|Added {{~~cmd~~\|waypoint modify ... style\|link=none}} arguments.		\|Added {{MC/Cmd\|waypoint modify ... style\|link=none}} arguments.
	\|Removed {{~~cmd~~\|waypoint modify ... fade\|link=none}} arguments, effectively removing waypoint's fade effects.}}		\|Removed {{MC/Cmd\|waypoint modify ... fade\|link=none}} arguments, effectively removing waypoint's fade effects.}}
	}}		}}

	== Navigation ==		== Navigation ==
	{{Navbox commands}}		{{MC/Navbox commands}}

	de:Befehl/waypoint		de:Befehl/waypoint

SyncBot: Remove broken links to missing pages

2026-04-09T15:45:56Z

Remove broken links to missing pages

imported>The triple g at 15:56, 14 September 2025

2025-09-14T15:56:08Z

New page

{{exclusive|java}}
{{Infobox command
| name = waypoint
| oplevel = 2
| others = [[Minecraft:Commands#Cheats|Cheats]] enabled
}}

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 {{attr|waypoint_transmit_range}} attribute set to a value greater than 0.
* The entity's waypoint color has been explicitly set using {{cmd|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 {{cmd|waypoint list}}.

Any entities that can transmit a waypoint is called ''waypoint transmitter''. They only include [[Minecraft:living entities]], which are [[Minecraft:armor stand]]s, [[Minecraft:mob]]s, and [[Minecraft:player]]s.

== Syntax ==

: <code>waypoint list</code>
:: 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.
: <code>waypoint modify <waypoint> color <color></code>
:: Changes the waypoint's color to one of the 16 [[Minecraft:color code]]s. This overrides the default color.
: <code>waypoint modify <waypoint> color hex <hex_color></code>
:: Changes the waypoint's color using a 6-digit {{w|hexadecimal color}} code (RRGGBB format, e.g., <code>FF0000</code> for red). This overrides the default color.
: <code>waypoint modify <waypoint> color reset</code>
:: Resets the waypoint's color to the default color (chosen randomly by the game, or the entity's [[Minecraft:team]] color).
: <code>waypoint modify <waypoint> style set <style></code>
:: Sets the [[Minecraft:waypoint style]] from {{cd|waypoint_style}} directory in a [[Minecraft:resource pack]]. By default, it is set to {{cd|minecraft:default}}.
:: 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.
: <code>waypoint modify <waypoint> style reset</code>
:: Resets the waypoint's style.

== Arguments ==

{{argument|waypoint|entity}}
: Specifies the target entity whose transmitted waypoint should be modified.
: {{arg desc|je=entity|amount=single|type=entities}} Must be a waypoint transmitter.

{{argument|color|color}}
: 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., <code>red</code>, <code>blue</code>, <code>light_purple</code>).

{{argument|hex_color|hex_color}}
: Specifies a {{w|hexadecimal color}} 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, <code>FF0000</code> for red, <code>6495ED</code> for cornflower blue.

{{argument|style|resource_location}}
: Specifies the [[Minecraft:waypoint style]] from {{cd|waypoint_style}} directory in a resource pack.
: {{arg desc|je=resource_location}}

== Result ==

{{Result table|onlyje=1}}
{{Result table|The command is incomplete, or any argument is not specified correctly.|unparseable}}
{{Result table|cmd=/waypoint modify <waypoint>|{{cd|waypoint}} is a target selector that's not a waypoint transmitter.|fail}}
{{Result table|cmd=/waypoint modify ... color <color>|{{cd|color}} is an unknown color.|fail}}
{{Result table|cmd=/waypoint modify ... color hex <hex_color>|{{cd|hex_color}} is an invalid hex color code.|fail}}
{{Result table|cmd=|succeed}}
{{Result table}}

== Output ==

{{Output table}}
{{Output table|edition=je|On success|1|1|0}}
{{Output table|cmd=/waypoint list|On success|1|1|the total number of tracked waypoints}}
{{Output table}}

== Examples ==

* To list all currently tracked waypoints being transmitted:
*: <code>waypoint list</code>
* To change the waypoint color for the player named "Steve" to gold on the [[Minecraft:locator bar]]:
*: <code>waypoint modify Steve color gold</code>
* To change the waypoint color for a [[Minecraft:creeper]] to lime using a hex code:{{note|name=single_entity|1=The {{cd|<waypoint>}} selector must resolve to exactly one entity. Using a selector like <code>@e[type=...]</code> without <code>limit=1</code> will fail if more than one entity of that type exists.}}
*: <code>waypoint modify @e[type=creeper,limit=1] color hex 00FF00</code>
* To reset the waypoint color for a [[Minecraft:zombie]] to its default color:{{note|name=single_entity}}
*: <code>waypoint modify @e[type=zombie,limit=1] color reset</code>

{{notelist}}

== History ==
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.21.6|exp=Locator Bar|dev=25w15a|Added {{cmd|waypoint|link=none}}.}}
|{{HistoryLine||1.21.6|dev=25w17a
|{{cmd|waypoint|link=none}} is now available in normal gameplay.
|Added {{cmd|waypoint modify ... style|link=none}} arguments.
|Removed {{cmd|waypoint modify ... fade|link=none}} arguments, effectively removing waypoint's fade effects.}}
}}

== Navigation ==
{{Navbox commands}}

[[Minecraft:de:Befehl/waypoint]]
[[Minecraft:ja:コマンド/waypoint]]
[[Minecraft:lzh:令/waypoint]]
[[Minecraft:pt:Comandos/waypoint]]
[[Minecraft:zh:命令/waypoint]]

← Older revision		Revision as of 15:45, 9 April 2026
Line 6:		Line 6:
	}}		}}

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

	== Usage ==		== 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:		Lists tracked waypoints or modifies properties of the waypoint being transmitted by specific entities. A tracked waypoint is associated with an entity that meets either of the following conditions:
	* The entity has the {{attr\|waypoint_transmit_range}} attribute set to a value greater than 0.		* The entity has the {{attr\|waypoint_transmit_range}} attribute set to a value greater than 0.
	* The entity's waypoint color has been explicitly set using {{cmd\|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.		* The entity's waypoint color has been explicitly set using {{cmd\|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.
Line 16:		Line 16:
	Only entities with tracked waypoints can be listed by {{cmd\|waypoint list}}.		Only entities with tracked waypoints can be listed by {{cmd\|waypoint list}}.

	Any entities that can transmit a waypoint is called ''waypoint transmitter''. They only include ~~[[Minecraft:~~living entities]], which are ~~[[Minecraft:~~armor ~~stand]]s~~, [[Minecraft:mob]]s, and ~~[[Minecraft:player]]s~~.		Any entities that can transmit a waypoint is called ''waypoint transmitter''. They only include living entities, which are armor stands, [[Minecraft:mob]]s, and players.

	== Syntax ==		== Syntax ==

	: <code>waypoint list</code>		: <code>waypoint list</code>
	:: 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.		:: 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 team color.
	: <code>waypoint modify <waypoint> color <color></code>		: <code>waypoint modify <waypoint> color <color></code>
	:: Changes the waypoint's color to one of the 16 ~~[[Minecraft:~~color ~~code]]s~~. This overrides the default color.		:: Changes the waypoint's color to one of the 16 color codes. This overrides the default color.
	: <code>waypoint modify <waypoint> color hex <hex_color></code>		: <code>waypoint modify <waypoint> color hex <hex_color></code>
	:: Changes the waypoint's color using a 6-digit {{w\|hexadecimal color}} code (RRGGBB format, e.g., <code>FF0000</code> for red). This overrides the default color.		:: Changes the waypoint's color using a 6-digit {{w\|hexadecimal color}} code (RRGGBB format, e.g., <code>FF0000</code> for red). This overrides the default color.
	: <code>waypoint modify <waypoint> color reset</code>		: <code>waypoint modify <waypoint> color reset</code>
	:: Resets the waypoint's color to the default color (chosen randomly by the game, or the entity's ~~[[Minecraft:~~team]] color).		:: Resets the waypoint's color to the default color (chosen randomly by the game, or the entity's team color).
	: <code>waypoint modify <waypoint> style set <style></code>		: <code>waypoint modify <waypoint> style set <style></code>
	:: Sets the ~~[[Minecraft:~~waypoint style]] from {{cd\|waypoint_style}} directory in a ~~[[Minecraft:~~resource pack]]. By default, it is set to {{cd\|minecraft:default}}.		:: Sets the waypoint style from {{cd\|waypoint_style}} directory in a resource pack. By default, it is set to {{cd\|minecraft:default}}.
	:: 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.		:: The game does not check if a definition exists under the directory, setting it to a non-existent definition results in a missing texture for the waypoint icon.
	: <code>waypoint modify <waypoint> style reset</code>		: <code>waypoint modify <waypoint> style reset</code>
	:: Resets the waypoint's style.		:: Resets the waypoint's style.
Line 41:		Line 41:

	{{argument\|color\|color}}		{{argument\|color\|color}}
	: 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).		: 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., <code>red</code>, <code>blue</code>, <code>light_purple</code>).		: Must be a valid color name (e.g., <code>red</code>, <code>blue</code>, <code>light_purple</code>).

	{{argument\|hex_color\|hex_color}}		{{argument\|hex_color\|hex_color}}
	: Specifies a {{w\|hexadecimal color}} code (RRGGBB format) to apply to the waypoint's indicator on the ~~[[Minecraft:~~locator bar]]. This overrides the default color.		: Specifies a {{w\|hexadecimal color}} code (RRGGBB format) to apply to the waypoint's indicator on the locator bar. This overrides the default color.
	: Must be a 6-digit hexadecimal number (000000-FFFFFF). For example, <code>FF0000</code> for red, <code>6495ED</code> for cornflower blue.		: Must be a 6-digit hexadecimal number (000000-FFFFFF). For example, <code>FF0000</code> for red, <code>6495ED</code> for cornflower blue.

	{{argument\|style\|resource_location}}		{{argument\|style\|resource_location}}
	: Specifies the ~~[[Minecraft:~~waypoint style]] from {{cd\|waypoint_style}} directory in a resource pack.		: Specifies the waypoint style from {{cd\|waypoint_style}} directory in a resource pack.
	: {{arg desc\|je=resource_location}}		: {{arg desc\|je=resource_location}}

Line 73:		Line 73:
	* To list all currently tracked waypoints being transmitted:		* To list all currently tracked waypoints being transmitted:
	*: <code>waypoint list</code>		*: <code>waypoint list</code>
	* To change the waypoint color for the player named "Steve" to gold on the ~~[[Minecraft:~~locator bar]]:		* To change the waypoint color for the player named "Steve" to gold on the locator bar:
	*: <code>waypoint modify Steve color gold</code>		*: <code>waypoint modify Steve color gold</code>
	* To change the waypoint color for a ~~[[Minecraft:~~creeper]] to lime using a hex code:{{note\|name=single_entity\|1=The {{cd\|<waypoint>}} selector must resolve to exactly one entity. Using a selector like <code>@e[type=...]</code> without <code>limit=1</code> will fail if more than one entity of that type exists.}}		* To change the waypoint color for a creeper to lime using a hex code:{{note\|name=single_entity\|1=The {{cd\|<waypoint>}} selector must resolve to exactly one entity. Using a selector like <code>@e[type=...]</code> without <code>limit=1</code> will fail if more than one entity of that type exists.}}
	*: <code>waypoint modify @e[type=creeper,limit=1] color hex 00FF00</code>		*: <code>waypoint modify @e[type=creeper,limit=1] color hex 00FF00</code>
	* To reset the waypoint color for a [[Minecraft:zombie]] to its default color:{{note\|name=single_entity}}		* To reset the waypoint color for a [[Minecraft:zombie]] to its default color:{{note\|name=single_entity}}
Line 95:		Line 95:
	{{Navbox commands}}		{{Navbox commands}}

	~~[[Minecraft:~~de:Befehl/waypoint]]		de:Befehl/waypoint
	~~[[Minecraft:~~ja:コマンド/waypoint]]		ja:コマンド/waypoint
	~~[[Minecraft:~~lzh:令/waypoint]]		lzh:令/waypoint
	~~[[Minecraft:~~pt:Comandos/waypoint]]		pt:Comandos/waypoint
	~~[[Minecraft:~~zh:命令/waypoint]]		zh:命令/waypoint