Player Locator Plus

Track other players' locations on your experience bar like a compass!

Short showcase video

Marker colors

Each player's color is determined randomly by their UUID. You cannot change your UUID (unless you're playing in offline mode); therefore, it's impossible to change your marker color.

Distance fade

When a player is very far away, their marker starts to fade:

Disappearing

There are three ways to hide from the player locator:

1. Crouching
2. Wearing a carved pumpkin
3. Having the invisibility effect

Configuration

Configuration

The config is available at config/player-locator-plus.toml. You can also access the configuration screen with Mod Menu.

Server parameters:

• enabled: Is the mod enabled server-side at all. Note that the bar will still be visible if visible is true. Default: true
• sendServerConfig: Whether the server will try to force its config on the client. This will only have effect if the clients have acceptServerConfig set to true. Default: true
• sendDistance: Whether to send distance information along with the direction information. There's basically no point in settings this to false, as players can still easily triangulate the exact location of others even without knowing the distance. However, it is harder with this option on, especially if you consider that other players move. Default: true
• maxDistance: The maximum distance at which other players are visible on the compass. Default: 0 (unlimited)
• directionPrecision: The amount of segments the direction vector is split into. Decreasing this value significantly will make tracking way more inaccurate but be helpful in preventing triangulation. Default: 300
• ticksBetweenUpdates: How many ticks apart are the compass updates. The less, the smoother the movements of faraway players are. Close players (inside the entity render distance) do not depend on this parameter as much. Default: 5 (four times per second)
• sneakingHides: Whether sneaking hides players from the locator. Default: true
• pumpkinHides: Whether wearing a pumpkin (or any other gaze_disguise_equipment) hides players from the locator. Default: true
• mobHeadsHide: Whether wearing a mob/player head hides players from the locator. The exact list can be edited with a datapack by changing data/player-locator-plus/tags/item/hiding_equipment.json (see default here). Default: true
• invisibilityHides: Whether being invisible hides players from the locator. Default: true
• colorMode: How to determine the color of the markers. Vanilla waypoints always override this setting. Available modes:
  • UUID (default): Assign a random color based on the UUID of the player.
  • TEAM_COLOR: Use the color of the player's team (or white)
  • CUSTOM: Allow every player to assign a color with the /plp color command. Defaults to UUID colors
  • CONSTANT: Everyone has the same color from the constantColor option
• constantColor: Color used when colorMode is CONSTANT. Default: 0xFFFFFF (white)
• allowVanillaLocatorBar: Allow sending waypoint to vanilla players without the mod. Default: true

Client parameters:

• visible: Show the player locator. Default: true
• visibleEmpty: Show the player locator even there are no players online and no markers in sight. Default: false
• acceptServerConfig: Whether to override the client-side config with the server-side one. The server config will also be able set client parameters. Default: true
• fadeMarkers: Fade markers of faraway players. Default: false
• fadeStart: At what distance the markers start to fade. Default: 100
• fadeEnd: At what distance the markers stop fading and settle at fadeEndOpacity. Default: 1000
• shrinkMarkers: Shrink markers of faraway players like the vanilla locator bar. Default: true
• shrinkStart: At what distance the markers start start to shrink. Note that this option might not work as you expect: the shrinkStart-shrinkEnd interval is divided into 6 sections, where the first section does not shrink. So with the default 70-500 distances, the marker will actually start to shrink at ~152 blocks. Default: 70
• shrinkEnd: At what distance the markers stop to shrink. Default: 500
• fadeEndOpacity: The final opacity when/after fadeEnd is reached. Default: 0.3
• showHeight: Show little arrows above/below a marker if the height difference is significant. Default: true
• alwaysShowHeads: Always show player heads, regardless of whether Tab is pressed. Default: false
• showHeadsOnTab: Show player heads when Tab is pressed. Default: true
• showNamesOnTab: Show player names when Tab is pressed. Default: true
• showVanillaWaypoints: Show custom waypoints created by adding the waypoint_transmit_range attribute. Default: true

Acknowledgements

Originally introduced in Minecraft: Bedrock Edition Preview here, covered by Phoenix SC.

Known issues

• Major versions (1.x.x and 2.x.x) are NOT compatible! At least the major version must match between the server and the client.

License

Player Locator Plus is licensed under the GNU General Public License Version 3 or later.

Player Locator Plus

Track other players' locations on your experience bar like a compass!

Marker colors

By default, each player's color is determined randomly by their UUID. There are other options in the config (see below).

Distance fade

When a player is very far away, their marker starts to fade:

Disappearing

There are three ways to hide from the player locator:

1. Crouching
2. Wearing a carved pumpkin
3. Having the invisibility effect

Configuration

The config is available at config/player-locator-plus.toml. You can also access the configuration screen with Mod Menu.

Server parameters:

• enabled: Is the mod enabled server-side at all. Note that the bar will still be visible if visible is true. Default: true
• sendServerConfig: Whether the server will try to force its config on the client. This will only have effect if the clients have acceptServerConfig set to true. Default: true
• sendDistance: Whether to send distance information along with the direction information. There's basically no point in settings this to false, as players can still easily triangulate the exact location of others even without knowing the distance. However, it is harder with this option on, especially if you consider that other players move. Default: true
• maxDistance: The maximum distance at which other players are visible on the compass. Default: 0 (unlimited)
• directionPrecision: The amount of segments the direction vector is split into. Decreasing this value significantly will make tracking way more inaccurate but be helpful in preventing triangulation. Default: 300
• ticksBetweenUpdates: How many ticks apart are the compass updates. The less, the smoother the movements of faraway players are. Close players (inside the entity render distance) do not depend on this parameter as much. Default: 5 (four times per second)
• sneakingHides: Whether sneaking hides players from the locator. Default: true
• pumpkinHides: Whether wearing a pumpkin (or any other gaze_disguise_equipment) hides players from the locator. Default: true
• mobHeadsHide: Whether wearing a mob/player head hides players from the locator. The exact list can be edited with a datapack by changing data/player-locator-plus/tags/item/hiding_equipment.json (see default here). Default: true
• invisibilityHides: Whether being invisible hides players from the locator. Default: true
• colorMode: How to determine the color of the markers. Vanilla waypoints always override this setting. Available modes:
  • UUID (default): Assign a random color based on the UUID of the player.
  • TEAM_COLOR: Use the color of the player's team (or white)
  • CUSTOM: Allow every player to assign a color with the /plp color command. Defaults to UUID colors
  • CONSTANT: Everyone has the same color from the constantColor option
  • constantColor: Color used when colorMode is CONSTANT. Default: 0xFFFFFF (white)
  • allowVanillaLocatorBar: Allow sending waypoint to vanilla players without the mod. Default: true

Client parameters:

• visible: Show the player locator. Default: true
• visibleEmpty: Show the player locator even there are no players online and no markers in sight. Default: false
• acceptServerConfig: Whether to override the client-side config with the server-side one. The server config will also be able set client parameters. Default: true
• fadeMarkers: Fade markers of faraway players. Default: false
• fadeStart: At what distance the markers start to fade. Default: 100
• fadeEnd: At what distance the markers stop fading and settle at fadeEndOpacity. Default: 1000
• shrinkMarkers: Shrink markers of faraway players like the vanilla locator bar. Default: true
• shrinkStart: At what distance the markers start start to shrink. Note that this option might not work as you expect: the shrinkStart-shrinkEnd interval is divided into 6 sections, where the first section does not shrink. So with the default 70-500 distances, the marker will actually start to shrink at ~152 blocks. Default: 70
• shrinkEnd: At what distance the markers stop to shrink. Default: 500
• fadeEndOpacity: The final opacity when/after fadeEnd is reached. Default: 0.3
• showHeight: Show little arrows above/below a marker if the height difference is significant. Default: true
• alwaysShowHeads: Always show player heads, regardless of whether Tab is pressed. Default: false
• showHeadsOnTab: Show player heads when Tab is pressed. Default: true
• showNamesOnTab: Show player names when Tab is pressed. Default: true
• showVanillaWaypoints: Show custom waypoints created by adding the waypoint_transmit_range attribute. Default: true

Acknowledgements

Originally introduced in Minecraft: Bedrock Edition Preview here, covered by Phoenix SC.

Known issues

• Major versions (1.x.x and 2.x.x) are NOT compatible! At least the major version must match between the server and the client.

License

Player Locator Plus is licensed under the GNU General Public License Version 3 or later.