SyncBot: Sync: new page from Minecraft

2026-06-12T11:08:51Z

Sync: new page from Minecraft

New page

{{About|the bar|the map|Locator map|the game rule|Game rule#locator_bar}}
[[File:Survival Locator Bar.png|thumb|class=pixel-image|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:player]]s 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:tick]]s (5 seconds) after the XP is updated, or the GUI is closed. It can be toggled in ''Java Edition'' with the {{gmr|locator_bar}} game rule; in ''Bedrock Edition'' with the "Locator bar" [[Minecraft:Game settings|game setting]] or {{gmr|locatorbar}} game rule, which is enabled by default. In [[Minecraft:Bedrock Edition 26.30]],{{Upcoming}} this is instead a "Player waypoints" ({{gmr|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 [[Minecraft:Rotation|pitch angle]], a visual pointer appears on the indicator, showing the target's vertical direction from the camera's view. The [[Minecraft:color code|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}}, it may also be assigned by their [[Minecraft:team]] color, or using the {{cmd|waypoint}} command.

Players can prevent their positions from being shown in the locator bar by [[Minecraft:crouch|sneaking]], wearing a [[Minecraft:Head|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|class=pixel-image|16px]] square (0–179 blocks), [[File:Locator Bar icon default_1.png|class=pixel-image|16px]] circle (179–230 blocks), [[File:Locator Bar icon default_2.png|class=pixel-image|16px]] small square (230–281 blocks), and [[File:Locator Bar icon default_3.png|class=pixel-image|16px]] small circle (281+ blocks). {{IN|java}}, these sprites can be changed by setting the waypoint's style using the {{cmd|waypoint}} command; multiple [[Minecraft:waypoint style]]s can be defined in a [[Minecraft:resource pack]].

{{IN|je}}, the waypoint's visibility range is controlled by the {{attr|waypoint_transmit_range}} and {{attr|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.<ref>{{snap|25w17a|April 22, 2025}}</ref> An entity which can transmit a waypoint is called a ''waypoint transmitter''; only [[Minecraft:living entities]], which are [[Minecraft:armor stand]]s, [[Minecraft:mob]]s, and [[Minecraft:player]]s, can transmit waypoints.<ref>The implementation is from {{jcp|net.minecraft.world.waypoints.WaypointTransmitter}} interface in the game's source code. Additionally, {{jcp|net.minecraft.world.entity.LivingEntity}} implements this interface. ([[Minecraft:Obfuscation map|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 {{cmd|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|be}}, only players are tracked in multiplayer mode, other entities are not tracked by the game.

== NBT format ==
{{exclusive|java|section=1}}

The following [[Minecraft:NBT]] data are stored on [[Minecraft:entity data|living entities' data]] about the waypoint's icon visual information:
<div class="treeview">
* {{nbt|compound}} The root tag.
** {{nbt inherit/entity}}
** {{nbt inherit/mob}}
** {{nbt|compound|locator_bar_icon}}: The waypoint's icon visual data in the locator bar.
*** {{nbt|int|color}}: The waypoint's color stored as 32-bit signed integer using {{w|two's complement}}, assuming the color is fully opaque.<ref>{{jcp|net.minecraft.world.waypoints.Waypoint#Icon}} static class sets color from {{jcp|net.minecraft.ChatFormatting}} enum. (Mojang mapping)</ref>
*** {{nbt|string|style}}: The waypoint's style name from {{cd|[[Minecraft:waypoint_style]]}} directory in a [[Minecraft:resource pack]].
</div>

== History ==
=== ''Java Edition'' ===
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.21.6|dev=25w15a|exp=Locator Bar|Added the locator bar behind its own experimental data pack.}}
|{{HistoryLine||1.21.6|dev=25w17a
|The locator bar is now available without its experimental data pack.
|Added [[Minecraft:waypoint style]] for customizing waypoints' icon in [[Minecraft:resource pack]]s.
|Removed waypoint fade effects.}}
}}

=== ''Bedrock Edition'' ===
{{HistoryTable
|{{HistoryLine|bedrock}}
|{{HistoryLine||1.21.80|dev=Preview 1.21.80.20|exp=Locator Bar|Added the locator bar behind its own experimental toggle.}}
|{{HistoryLine|||dev=Preview 1.21.80.21|Player dots on the locator bar now show correctly regardless of [[Minecraft:simulation distance]].}}
|{{HistoryLine|||dev=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.}}
|{{HistoryLine||1.21.90|dev=Preview 1.21.90.23|The locator bar is now available without its experimental toggle.}}
|{{HistoryLine|bedrock upcoming}}
|{{HistoryLine||26.30|dev=Preview 26.30.20|Replaced the {{cd|locatorbar}} game rule with {{cd|playerwaypoints}}.}}
|{{HistoryLine|||dev=Preview 26.30.29|Replaced the "Locator bar" game setting with "Player waypoints".}}
}}

== See also ==
*[[Minecraft:Banner marker]]s can be used for marking locations on a [[Minecraft:map]] using a placed-down [[Minecraft:banner]].

== Issues ==
{{issue list|Locator Bar|Waypoint}}

== Trivia ==
* There exists a secret waypoint icon [[File:Locator Bar icon bowtie.png|class=pixel-image|16px]] {{cd|bowtie.png}} in the game's texture files. It can be enabled by using [[Minecraft:command]] {{cmd|waypoint modify <target> style set bowtie}}.
* 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 ===
<gallery>
File:SummerDrop LocatorBar A.jpeg|Three players appear as colored icons on the locator bar.
File:SummerDrop LocatorBar B.jpeg|[[Minecraft:Player]]s in a [[Minecraft:Cherry Grove|cherry grove]] appearing on the locator bar.
File:SummerDrop LocatorBar C.jpeg|[[Minecraft:Sunny]] avoids being seen on the locator bar.
File:SummerDrop LocatorBar 1.jpeg|The locator bar correlating with a [[Minecraft:Locator map|map's player markers]].
File:Player Locator bar.jpeg|Locator bar in Creative mode with three players, [[Minecraft:Efe]], [[Minecraft:Sunny]], and [[Minecraft:Zuri]].
</gallery>

== References ==
{{reflist}}

== Navigation ==
{{Navbox experiments}}
{{Navbox gameplay}}

[[Category:UI]]

[[Minecraft:de:Ortungsleiste]]
[[Minecraft:es:Barra localizadora]]
[[Minecraft:fr:Barre de localisation]]
[[Minecraft:it:Barra localizzatrice]]
[[Minecraft:ja:方向バー]]
[[Minecraft:lzh:尋蹤欄]]
[[Minecraft:pl:Pasek nawigacyjny]]
[[Minecraft:pt:Barra Localizadora]]
[[Minecraft:ru:Локатор игроков]]
[[Minecraft:uk:Панель локатора]]
[[Minecraft:zh:定位栏]]

Minecraft:Locator Bar - Revision history

SyncBot: Sync: new page from Minecraft