Sueta

LocatorToggle

1.3

Allow Users to Toggle the New Locator Bar

·Plugin

📋 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 nodeDescriptionDefault setting
locator.toggleControls usage of the /locator commandEveryone
locator.radiusControls usage of the /locator radius subcommandEveryone
locator.reloadControls usage of the /locator reload subcommandOperators

⚙️ 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)

Similar projects

Plugin →