Locator Bar

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

Usage

The locator bar shows the position of other players in multiplayer as colored indicators, known as waypoints. It takes 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 is enabled by default from the locatorBar game rule.

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: square (0–179 blocks), circle (179–230 blocks), small square (230–281 blocks), and 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.

NBT format

This feature is exclusive to Java Edition.

 

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

History

See also

• Banner markers can be used for marking locations on a 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.

Trivia

• There exists a secret waypoint icon 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.

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.
• 
  Locator bar in Creative mode.

References

Navigation

v t e Gameplay
General mechanics	Add-ons Attribute Commands Distance Effect Potency Explosion Game rules Interaction range Inventory Creative inventory Saved Hotbars Generated loot Hitbox Multiplayer Server Server list Realms Splitscreen Oxidation Rarity Legacy Redstone circuits Conductivity Renewability Renewable Non-renewable Rotation Snowlogging South-east rule Spawn protection Tiers Waterlogging
Survival	Achievements Advancements Archaeology Armor materials Bartering Breaking Instant mining Breeding Brewing Cooking Crafting 2×2 grid Recipe book Dual wield Difficulty Durability Enchanting Experience Farming Fishing Health Healing Hunger Item repair Mob spawning Ominous Event Ominous Trial Raid Patrol Raid captain Smelting Smithing World Spawn Taming Trading Workstations Zombie siege
Combat	Blocking Damage Attack cooldown Critical hit Knockback Sprint-knockback Drops Monster infighting Geared mobs
Environment	Biomes Daylight cycle Dimensions Seeds Structures Weather World generation More
Movement	Crawling Flying Gliding Jumping Lying Riding Sitting Sneaking Sprinting Swimming Walking
User interface	Action bar Bossbar Chat Death messages Game mode switcher Heads-up display Narrator Locator bar Scoreboard Toasts Tutorial hints Tooltip
Visuals	Color Block colors Item colors Effect colors Miscellaneous colors Emotes Enchantment glint Error Light Resource pack Screen effects Skins Character Skin pack Third-person view Vibrant Visuals
Outdated	Sword blocking Materials Update Suppression