Minecraft Waypoint Command Guide
Read Java waypoint color and style command syntax, examples, version differences and reset commands.
What the Minecraft waypoint command does
/waypoint changes waypoints that already exist because an entity transmits one; it does not create arbitrary coordinate waypoints. Forms include list, color <name>, color hex <RRGGBB>, color reset, style set <style> and style reset.
The target is an entity selector, not a coordinate, and it has to resolve to exactly one living entity. @e[type=creeper] fails the moment a second creeper exists; @e[type=creeper,limit=1] does not. Setting a color on an entity whose waypoint_transmit_range is 0 makes it show up in waypoint list and nowhere else. The full argument reference is on the Minecraft waypoint command page.
Version rules that break a copied command
A copied command may fail when written for a different version. Check the introduction version, color-name syntax and game-rule name before using an example.
1.21.6 introduced the feature.
The Locator Bar and
/waypointshipped in Java Edition 1.21.6. Snapshots 25w15a and 25w16a had the command but not waypoint styles, so style commands do not apply to those snapshots.Java 26.2 tightened the color argument.
From 26.2 the named colors are accepted only in lowercase with underscores.
dark_purpleworks;DarkPurpleanddarkpurpleare rejected outright. Command blocks and functions written for 1.21.x start failing after an update for exactly this reason, and the same rule now applies toteam modify <name> color.The game rule was renamed.
locatorBarbecamelocator_barin snapshot 25w44a, released in 1.21.11, when every game rule moved to a snake_case resource location. On 1.21.6 through 1.21.10 use/gamerule locatorBar false; from 1.21.11 use/gamerule locator_bar false. The Locator Bar gamerule page lists all of them, Bedrock included.
Choosing a color worth overriding with
The default starts with UUID.hashCode(), takes three RGB bytes, and sets HSV brightness to 0.9. Compare markers in game before choosing an override.
See what the default actually is.
The UUID color guide explains default Java colors. The detailed arithmetic is documented on the Minecraft UUID color page.
Check it against the rest of the party.
An override helps only if teammates can distinguish it. Read the party color guide and compare the resulting markers in game.
Named colors are the safer choice for anything that has to survive a version bump. color hex gives you the exact value but no autocomplete, and a typo there fails quietly.
Waypoint command questions
Do I need to be an operator?
Yes — permission level 2 and cheats enabled, or run it from a server console, a command block or a function. There is no client-side setting that changes a waypoint color.
Nothing happened when I ran the command.
Usually the target. The selector has to match exactly one living entity, and that entity has to be transmitting a waypoint for the color to appear on the bar at all. On 26.2 and later, check the color spelling too — lowercase with underscores.
Does any of this work on Bedrock?
No. There is no /waypoint command in Bedrock at any version. Bedrock assigns marker colors randomly per session, and only an add-on using the scripting API can set one. The Bedrock Locator Bar page has the details.
How do I undo an override?
/waypoint modify <target> color reset removes the color override. style reset resets the icon style.