Player Locator Plus

# 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](https://github.com/timas130/PlayerLocatorPlus/blob/main/src/main/resources/data/player-locator-plus/tags/item/hiding_equipment.json)). 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 - `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: `true` - `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` - `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](https://www.minecraft.net/en-us/article/test-the-new-player-locator-bar), 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.