Minecraft:Locator Bar

File:Survival Locator Bar.png

Locator bar in Survival mode, showing orange and blue waypoints.

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

Usage

The locator bar shows the position of other players in Minecraft:multiplayer as colored indicators, known as waypoints. It takes the place of the Minecraft:experience bar on the player Minecraft:HUD, except when gaining or losing Minecraft:XP, or the Minecraft:anvil or Minecraft:enchanting table GUI is opened, in which the locator bar will be hidden for 100 Minecraft:ticks (5 seconds) after the XP is updated, or the GUI is closed. It can be toggled in Java Edition with the Template:Gmr game rule; in Bedrock Edition with the "Locator bar" game setting or Template:Gmr game rule, which is enabled by default. In Minecraft:Bedrock Edition 26.30,Template:Upcoming this is instead a "Player waypoints" (Template:Gmr) 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; Template:In, it may also be assigned by their Minecraft:team color, or using the Template:Cmd command.

Players can prevent their positions from being shown in the locator bar by sneaking, wearing a mob head or Minecraft:carved pumpkin, or being under the Minecraft:Invisibility effect. Additionally, players in Minecraft: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: File:Locator Bar icon default 0.png square (0–179 blocks), File:Locator Bar icon default 1.png circle (179–230 blocks), File:Locator Bar icon default 2.png small square (230–281 blocks), and File:Locator Bar icon default 3.png small circle (281+ blocks). Template:IN, these sprites can be changed by setting the waypoint's style using the Template:Cmd command; multiple Minecraft:waypoint styles can be defined in a Minecraft:resource pack.

Template:IN, the waypoint's visibility range is controlled by the Template:Attr and Template:Attr 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.<ref>Template:Snap</ref> An entity which can transmit a waypoint is called a waypoint transmitter; only Minecraft:living entities, which are Minecraft:armor stands, Minecraft:mobs, and Minecraft:players, can transmit waypoints.<ref>The implementation is from Template:Jcp interface in the game's source code. Additionally, Template:Jcp implements this interface. (Mojang mapping)</ref>

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 Template:Cmd 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. Template:IN, only players are tracked in multiplayer mode, other entities are not tracked by the game.

NBT format

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

• Template:Nbt The root tag.
  • Template:Nbt inherit/entity
  • Template:Nbt inherit/mob
  • Template:Nbt: The waypoint's icon visual data in the locator bar.
    • Template:Nbt: The waypoint's color stored as 32-bit signed integer using Template:W, assuming the color is fully opaque.<ref>Template:Jcp static class sets color from Template:Jcp enum. (Mojang mapping)</ref>
    • Template:Nbt: The waypoint's style name from Template:Cd directory in a Minecraft:resource pack.

History

See also

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

Trivia

• There exists a secret waypoint icon File:Locator Bar icon bowtie.png Template:Cd in the game's texture files. It can be enabled by using Minecraft:command Template:Cmd.
• The "Locator Bar" Minecraft: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.

Gallery

Mojang screenshots

• Three players appear as colored icons on the locator bar.
  Three players appear as colored icons on the locator bar.
• Minecraft:Players in a cherry grove appearing on the locator bar.
  Minecraft:Players in a cherry grove appearing on the locator bar.
• Minecraft:Sunny avoids being seen on the locator bar.
  Minecraft: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, Minecraft:Efe, Minecraft:Sunny, and Minecraft:Zuri.
  Locator bar in Creative mode with three players, Minecraft:Efe, Minecraft:Sunny, and Minecraft:Zuri.