/waypoint Command in Minecraft Java Edition

List and Modify Waypoints in Minecraft Java Edition

Java EditionWorld & BlocksPermission: Level 2Added in 1.21.6

The /waypoint command lets you view and customize waypoints in Minecraft Java Edition. With this command, you can list available waypoints and change their colors or styles using target selectors.

Players and map makers with operator permissions use this command to organize markers and adjust how waypoints look in their worlds. It was added in Java Edition 1.21.6 and requires permission level 2 to run.

Syntax (Java 26.3, 6 forms)

  1. /waypoint list
  2. /waypoint modify <waypoint> color <color>
  3. /waypoint modify <waypoint> color hex <color>
  4. /waypoint modify <waypoint> color reset
  5. /waypoint modify <waypoint> style reset
  6. /waypoint modify <waypoint> style set <style>

The forms you will use most

/waypoint list
Shows a list of waypoints.
/waypoint modify <waypoint> color <color>
Changes the color of a selected waypoint to a standard team color.
/waypoint modify <waypoint> color hex <color>
Sets the color of a selected waypoint using a six-digit hex code.
/waypoint modify <waypoint> color reset
Resets the color of the target waypoint back to its default.
/waypoint modify <waypoint> style reset
Resets the style of the target waypoint back to its default.
/waypoint modify <waypoint> style set <style>
Changes the style of a selected waypoint to a specific resource ID.

Arguments

ArgumentTypeWhat it means
<waypoint>target selector
one target
A target selector for one target, which can be a player name, a UUID, or a selector like @p, @a, @e, or @s.
<color>team color
<color>hex colourA colour written as six hex digits.
<style>resource IDA namespaced resource ID, such as minecraft:stone, that sets the waypoint style.

Examples

Version history

Measured from the game files of every Java release from 1.13 to 26.3.

  1. 1.21.6 Command added.

Tips

Common mistakes

Java vs Bedrock

The /waypoint command is only available in Minecraft Java Edition. Bedrock Edition has no command with this name.

FAQ

When was the /waypoint command added to Minecraft?

The /waypoint command was added to Minecraft Java Edition in version 1.21.6.

What permission level is needed to use /waypoint?

You need permission level 2, which means you must be a server operator or have cheats turned on in single-player.

Can I use the /waypoint command in Minecraft Bedrock Edition?

No, Bedrock Edition does not have a /waypoint command.

Related commands

/clone/difficulty/fill/fillbiome/forceload/gamerule/locate/place/seed/setblock/setworldspawn/time/weather/worldborder