Locator Bar

The locator bar is a UI element on the player's HUD which shows the position of other players in multiplayer.

The locator bar shows the position of other players in multiplayer as colored indicators, known as waypoints. It takes the place of the experience bar on the player HUD, except when gaining or losing XP, or the anvil or enchanting table GUI is opened, in which the locator bar will be hidden for 100 ticks (5 seconds) after the XP is updated, or the GUI is closed. It can be toggled in Java Edition with the locator_bar game rule; in Bedrock Edition with the "Player waypoints" (playerwaypoints) setting which can be set to "Everyone" (default) or "Off".

Each target is assigned a waypoint, and appears on the locator bar horizontally within 120 degrees of the camera's view. If the waypoint is above or below the player's camera pitch angle, a visual pointer appears on the indicator, showing the target's vertical direction from the camera's view. The color of a waypoint is randomly assigned to the player when they join a multiplayer game, or an entity when tracked in the locator bar; in Java Edition, it may also be assigned by their team color, or using the /waypoint command.

Players can prevent their positions from being shown in the locator bar by sneaking, wearing a mob head or carved pumpkin, or being under the Invisibility effect. Additionally, players in Spectator mode are only visible to other spectators in the locator bar.

The waypoint's icon changes based on the player's distance to its location. The further the player is from the waypoint, the smaller the icon visually shown on the locator bar. Several sprites of the icon can be observed based on the distance: 👁 Image
square (0–179 blocks), 👁 Image
circle (179–230 blocks), 👁 Image
small square (230–281 blocks), and 👁 Image
small circle (281+ blocks). In Java Edition, these sprites can be changed by setting the waypoint's style using the /waypoint command; multiple waypoint styles can be defined in a resource pack.

In Java Edition, the waypoint's visibility range is controlled by the waypoint_transmit_range and waypoint_receive_range attributes; transmission range can be used for players and entities, while receive range applies only to players. A player with a receive range set to zero will not receive any waypoint information.^[1] An entity which can transmit a waypoint is called a waypoint transmitter; only living entities, which are armor stands, mobs, and players, can transmit waypoints.^[2]

Entities' waypoints are tracked by the game when their transmission range is set to greater than zero. They can also be tracked when setting their waypoints' color using /waypoint command, but they don't appear on the locator bar, removed when the entity is despawned by the game, or when the player exits the world. In Bedrock Edition, only players are tracked in multiplayer mode, other entities are not tracked by the game.

The following NBT data are stored on living entities' data about the waypoint's icon visual information:

• Banner markers can be used for marking locations on a map using a placed-down banner.

Issues relating to "Locator Bar" or "Waypoint" are maintained on the bug tracker. Issues should be reported and viewed there.

• There exists a secret waypoint icon 👁 Image
  bowtie.png in the game's texture files. It can be enabled by using command /waypoint modify <target> style set bowtie.
• The "Locator Bar" experimental toggle on Java Edition is the shortest-lived experimental toggle in any Minecraft version, being removed just 14 days after it was added, existing only in snapshot versions and never released.

• 👁 Three players appear as colored icons on the locator bar.
  
  Three players appear as colored icons on the locator bar.
• 👁 Players in a cherry grove appearing on the locator bar.
  
  Players in a cherry grove appearing on the locator bar.
• 👁 Sunny avoids being seen on the locator bar.
  
  Sunny avoids being seen on the locator bar.
• 👁 The locator bar correlating with a map's player markers.
  
  The locator bar correlating with a map's player markers.
• 👁 Locator bar in Creative mode with three players, Efe, Sunny, and Zuri.
  
  Locator bar in Creative mode with three players, Efe, Sunny, and Zuri.