📋 Overview
LocatorToggle is a lightweight Spigot plugin that allows players to locally toggle the newly introduced locator bar. When toggled off, the player is also hidden from other players' locator bars, providing a more private gameplay experience.
❗ Gamerule 'locatorBar' must be set to 'true'
🎥 Demonstration
🛠️ Commands
- /locator - Toggles the locator bar functionality on/off for the player.
- /locator radius <value> - Sets the locator bar radius (1-60,000,000 blocks).
- /locator reload - Reloads the plugin configuration and language files.
🔐 Permissions
| Permission node | Description | Default setting |
|---|---|---|
| locator.toggle | Controls usage of the /locator command | Everyone |
| locator.radius | Controls usage of the /locator radius subcommand | Everyone |
| locator.reload | Controls usage of the /locator reload subcommand | Operators |
⚙️ Configuration
Click to view config.yml
# Whether new users will have their locator disabled by default.
locator-disabled-by-default: false
# Maximum radius that players can set using /locator radius.
locator-max-radius: 60000000
# Default radius when players enable the locator.
# This only applies when the player hasn't set a custom radius yet.
default-locator-radius: 60000000
🔌 PlaceholderAPI Support
This plugin provides the following placeholders:
%locatortoggle_status%- Returns "enabled" or "disabled" based on the player's preference%locatortoggle_radius%- Returns the player's custom locator bar radius (if set)
