News
Game
Guides
Downloads
Versions
/waypoint
COMMANDS WORLD & RULES CHEATS · LEVEL 2 Added in 1.21.6

/waypoint command in Minecraft

The /waypoint command lists the waypoints of a dimension and changes how they look on the Locator Bar: their color and their icon style. Use it to give each player or team a marker that is easy to recognize in multiplayer, or to reset a waypoint to its default look.

Syntax

/waypoint list
/waypoint modify <waypoint> (color|style)
ArgumentExpectsWhat it does
waypointEntity selectoroneOne entity that transmits a waypoint, usually a player: @p, a player name or @n[type=...].
colorColorA team color name like red, gold or aqua; after hex, a six-digit code like FF8800.
styleResource IDWaypoint style ID defined by resource packs, e.g. minecraft:default or minecraft:bowtie.
All 6 forms
  • /waypoint list
  • /waypoint modify <waypoint> color <color>
  • /waypoint modify <waypoint> color hex <color>
  • /waypoint modify <waypoint> color reset
  • /waypoint modify <waypoint> style reset
  • /waypoint modify <waypoint> style set <style>

Examples

List the waypoints

/waypoint list

Shows how many waypoints exist in your dimension and which entities they belong to.

Java 26.3

Orange marker for the nearest player

/waypoint modify @p color hex FF8800

The nearest player now appears in orange on the Locator Bar of the others.

Java 26.3

Switch to the bowtie style

/waypoint modify @p style set minecraft:bowtie

Changes the icon shape of that waypoint; style reset returns to the default.

Java 26.3
Build your command

Fill in the fields, then copy the command.

Command generator

Which entities are waypoints

Players are waypoints by default. Another entity becomes one when its waypoint_transmit_range attribute is above 0, which you can set with /attribute. Otherwise the command fails with "Selected entity is not a waypoint".

Colors and styles

color takes a team color name, color hex any six-digit code, and color reset removes the custom color. Styles come from resource packs, which can add their own; the game ships default and bowtie. The whole bar is turned on or off with the locator_bar rule of /gamerule.

✓ Checked in Java Edition 26.3 · updated 2 November 2026

/waypoint: FAQ

Why does nothing appear on the Locator Bar?

The locator_bar game rule may be set to false, or the other entity is out of range. Check the rule with /gamerule locator_bar.

Can I use any color for a waypoint?

Yes. Use color hex with a six-digit code such as FF8800, or a named team color such as red or aqua.

How do I use /waypoint?

Type it in the chat with cheats on: /waypoint list.

Who can use /waypoint?

Cheats on, or operator level 2.

Since when does /waypoint exist?

It is in the official command tree since Java Edition 1.21.6.

Related commands