Java troubleshooting guide

Minecraft Locator Bar Not Working? 9 Fixes

A missing Locator Bar is usually expected behavior, a renamed game rule, or a sender or receiver that is not eligible. Follow this checklist in order and stop when the first failed condition is fixed.

01Eligible target?Another player or transmitting entity02Rule enabled?Use the ID for your version03Ranges above 0?Receive and transmit04Sender visible?Not crouching or disguised
Work left to right; the first failed condition is usually the fix.
Edition
Java Edition
Current game rule
minecraft:locator_bar
Legacy rule
locatorBar
Fast diagnostic
/waypoint list

Quick answer

Fix a Minecraft Locator Bar that is missing or not showing players by checking the game rule, version, receive range, player hiding states, and waypoint transmission.

01

Why is my Minecraft Locator Bar not showing?

First confirm that another eligible player or entity exists, the game rule is enabled, and your receive range is above zero.

The Locator Bar does not replace the experience bar permanently. With nothing eligible to display, the normal XP bar stays visible. It can also return temporarily after you gain experience or close an experience-related screen, so wait a few seconds before treating that as a failure.

In an ordinary single-player world there is no other player waypoint to show. To test alone, give one living entity a positive waypoint_transmit_range, then face toward it.

  • Confirm another player or transmitting living entity is present.
  • Wait at least five seconds after gaining XP or closing an anvil or enchanting screen.
  • Make sure you are looking within the Locator Bar's approximate 120-degree facing range.
  • Continue with the version-specific game rule check below.
01Eligible target?Another player or transmitting entity02Rule enabled?Use the ID for your version03Ranges above 0?Receive and transmit04Sender visible?Not crouching or disguised
Work left to right; the first failed condition is usually the fix.
02

Check the correct Locator Bar game rule for your version

Java 1.21.11 and later use minecraft:locator_bar; Java 1.21.6 through 1.21.10 use the older locatorBar name.

Game rule IDs changed to namespaced snake_case identifiers in Java 1.21.11. This is why a command copied from an older 1.21.6 article can return an unknown-rule error on a current release even though the idea is correct.

Run the query command first. If it returns false, enable the rule with the matching true command. You need permission to query or change protected world settings on a server.

Java 1.21.11+ / 26.x — check/gamerule minecraft:locator_bar
Java 1.21.11+ / 26.x — enable/gamerule minecraft:locator_bar true
Java 1.21.6–1.21.10 — check/gamerule locatorBar
Java 1.21.6–1.21.10 — enable/gamerule locatorBar true
03

Check your waypoint receive range

A receive range of zero prevents that player from receiving waypoints, so the Locator Bar has nothing to display.

The waypoint_receive_range attribute belongs to the viewer. Players normally receive across the vanilla maximum range, but a command, data pack, plugin, or server menu can change the base value or add a modifier.

Query the effective value before overwriting it. If it is zero and you did not intend to disable reception, restore the vanilla player base value of 60,000,000. On a managed server, ask the administrator whether a plugin owns this setting before changing it.

Check your effective receive range/attribute @s minecraft:waypoint_receive_range get
Restore the vanilla player base range/attribute @s minecraft:waypoint_receive_range base set 60000000Record any custom value first; this changes the base value.
04

Check whether the other player is hiding

Crouching, invisibility, certain worn heads, and spectator visibility rules can intentionally remove a player from other players' Locator Bars.

Ask the missing player to stand normally, remove invisibility, and take off any carved pumpkin or mob head used as a disguise. Players in Spectator Mode are normally hidden from non-spectators, while spectators can see one another.

These are vanilla hiding rules, not connection failures. If one player is missing while everyone else appears, check that player's state before changing a world-wide game rule.

  • Release the crouch or sneak key.
  • Remove Invisibility.
  • Remove a carved pumpkin or mob head from the head slot.
  • Compare the viewer and target game modes.
Visible

Eligible player in range

Hidden

Crouching or invisible

Disabled

locatorBar gamerule off

Check player state first, then world and server configuration.
05

Check the sender's transmit range and tracked state

A player or mob must transmit a waypoint far enough for the viewer to receive it; ordinary mobs start with a transmit range of zero.

The waypoint_transmit_range attribute belongs to the sender. Players normally transmit across the vanilla maximum range, while other living entities do not appear until an operator gives them a positive range.

Use /waypoint list as a quick diagnostic for the currently tracked waypoints. For a mob test, select exactly one living entity and set an appropriate range. Do not use an unrestricted @e selector when a command expects one target.

List tracked waypoints/waypoint list
Check the nearest player's transmit range/attribute @p minecraft:waypoint_transmit_range get
Track one nearby allay within 120 blocks/attribute @e[type=allay,sort=nearest,limit=1] minecraft:waypoint_transmit_range base set 120
06

Check permissions, dimensions, and server software

If the vanilla checks pass, verify the active dimension and ask whether the server, proxy, plugin, mod, or data pack changes Locator Bar behavior.

Run diagnostics in the dimension where the players are actually testing and confirm the server accepted each command instead of silently relying on chat history. On multi-world server software, game rules can be managed per world or dimension by the platform.

Plugins and data packs can add per-player toggles, range limits, team rules, or replacement waypoints. Reproduce the problem once on the same version in a clean vanilla world when possible. If vanilla works, the difference belongs to the server configuration rather than the browser tool or the base game rule.

  • Read the exact red command error instead of retrying a different command blindly.
  • Confirm the operator or command-block permission level.
  • Test both players in the same world and dimension.
  • Temporarily compare against an unmodified vanilla test world.

Sources & verification

References used for this guide

Documented behavior, public identity conventions, and this site's reproducible calculations are kept distinct.

Mojang — Java Edition 1.21.6 Locator Bar and waypoint attributes Mojang — Java Edition 26.2 release notes Minecraft Wiki — Locator Bar visibility and display behavior Locator Bar Color — version-aware waypoint command generator

FAQ

Related questions

Concise answers for the search questions that brought players to this guide.

Why do I only see the XP bar instead of the Locator Bar?

The XP bar remains when there is no eligible waypoint to display and can return temporarily after XP changes or certain screens close. Confirm another transmitting target exists and wait a few seconds.

Why does locatorBar say unknown game rule?

Java 1.21.11 and later renamed game rules to namespaced snake_case IDs. Use minecraft:locator_bar on current releases; locatorBar is the legacy 1.21.6–1.21.10 name.

Why can my friend see me but I cannot see them?

Your receive range may be zero, their transmit range may be limited, or they may be crouching, invisible, disguised, or in a different spectator visibility case.

Why does a mob not appear on the Locator Bar?

Ordinary mobs have a waypoint_transmit_range of zero by default. Give one living entity a positive transmit range, then confirm it appears in /waypoint list.

Does /waypoint modify make an untracked mob visible?

Appearance changes and transmission are separate concerns. Give the living entity a positive waypoint_transmit_range and verify it is tracked before relying on color or style commands.