Locator Bar

The locator bar is an upcoming feature for the player HUD which shows the position of other players in multiplayer and entities.

Usage

Locator bar in Survival mode.

The locator bar appears in place of the experience bar, except when gaining XP. It can be toggled by the locatorBar game rule. By default, it shows the position of other players in multiplayer as colored square indicators, often referred to as waypoints.

Waypoints appear on the bar approximately within 120 degrees of the camera facing towards the target. If the target is on a significantly different Y-level, an arrow pointing to the target vertically appears over the square indicator. The color of a waypoint is randomly assigned to a player when they join a multiplayer game, or when a waypoint is tracked for the entity; it may also be assigned by their team color, or customized using the /waypoint command.

In Java Edition, waypoints are controlled by waypoint_transmit_range and waypoint_receive_range attributes. They control the waypoint's transmit range of players and entities, and the receiver range of players exclusively. When a target enters within a transmission range of an entity, the target will receive waypoints information of that entity in their locator bar. Similarly, receivers only receive waypoints that are inside their receive range (and receive nothing if that range is zero).

Entities' waypoints are tracked by the game when the waypoint_transmit_range attribute is set to greater than zero. Setting a waypoint's color using /waypoint for the entity also enables tracking, but it does not appear on the locator bar and temporary (no longer tracked) after reloading the world.

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

History

[hide]Upcoming Java Edition
1.21.6 Experiment Locator Bar			25w15a				Added the locator bar behind its own experimental data pack.
1.21.6			25w17a				The locator bar is now available without its experimental data pack.
[hide]Upcoming Bedrock Edition
1.21.80 Experiment Locator Bar			Preview 1.21.80.20				Added the locator bar behind experimental toggle.
			Preview 1.21.80.21				Player dots on the locator bar now show correctly regardless of simulation distance.
			Preview 1.21.80.22				Dots are now shown representing players in spectator mode to other players also in spectator mode on the locator bar.

See also

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

Issues

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

Gallery

Mojang screenshots

• 

  Three players appear as colored icons on the locator bar.

• 

  Players in a cherry grove appearing on the locator bar.

• 

  Sunny avoids being seen on the locator bar.

• 

  The locator bar correlating with a map's player markers.

• 

  Player Locator bar.