


Per player locator bar visibility control.

The player on the left is shown by default, while the player on the right has hidden himself using the /locatorbar toggle command. The Locator Bar only shows the visible player.
Commands & Permissions
**Commands**
| Command | Description | Permission |
|---------|-------------|------------|
| `/locatorbar toggle` | Toggle your visibility settings | `locatorbar.use` |
| `/locatorbar receive` | Toggle receiving others (separate mode) | `locatorbar.use` |
| `/locatorbar status` | Check your current settings | `locatorbar.use` |
| `/locatorbar help` | Show help message | `locatorbar.use` |
| `/locatorbar player [toggle\|status]` | Manage other players | `locatorbar.admin` |
| `/locatorbar reload` | Reload configuration | `locatorbar.admin` |
**Aliases**: `/lb`, `/locator`
**Permissions**
| Permission | Description | Default |
|------------|-------------|---------|
| `locatorbar.use` | Access basic commands | `true` |
| `locatorbar.admin` | Admin commands and player management | `op` |
| `locatorbar.cooldown.bypass` | Bypass all cooldowns | `false` |
| `locatorbar.cooldown.X` | X second cooldown (0-300) | `false` |
**Examples**: `locatorbar.cooldown.5`, `locatorbar.cooldown.60`, `locatorbar.cooldown.120`
config.yml
```yaml
# LocatorBar by Blaxk_
# https://modrinth.com/plugin/locator-bar
# Language settings (en, de)
language: "en"
# Show welcome message to new players on first join
show-first-join-message: false
# Control mode for locator bar settings
# 'combined' - /lb toggle controls both visibility and receiving together
# 'separate' - /lb toggle for visibility, /lb receive for receiving separately
control-mode: "combined"
# Cooldown settings
default-cooldown: 5 # Default cooldown in seconds
# Permission-based cooldowns:
# locatorbar.cooldown.bypass - No cooldown
# locatorbar.cooldown.X - X second cooldown (where X is any number 0-300)
# Examples: locatorbar.cooldown.0, locatorbar.cooldown.34, locatorbar.cooldown.120, etc.
# Sound settings
sounds:
enabled: false # Enable/disable all sound effects
volume: 1.0 # Sound volume (0.0 to 1.0)
pitch: 1.0 # Sound pitch (0.5 to 2.0)
enable: "entity.player.levelup" # Sound when enabling visibility
disable: "block.note_block.bass" # Sound when disabling visibility
# World-specific settings
world-settings:
# Example world configurations:
# world_nether:
# force-visible: true
# minigame_world:
# force-visible: true
# lobby:
# force-visible: true
# Attribute ranges - always applied
# Standard Minecraft default is 60000000
default-transmit-range: 60000000.0
default-receive-range: 60000000.0
# When a player toggles visibility off, should their receive range also be set to 0?
# Only applies when control-mode is 'combined'
# true = player cannot see others when hidden (more immersive)
# false = player can still see others even when hidden (more flexible)
disable-receive-when-hidden: false
# Plugin settings
save-interval: 300 # Auto-save player data every 5 minutes (in seconds)
update-checker: true # Check for updates on startup
# Debug mode
debug: false
# Do not change this
config-version: 2
```
lang/en.yml
```yaml
# English Messages
prefix: "ʟᴏᴄᴀᴛᴏʀʙᴀʀ » "
# Update messages
update-available: "⚔ Update available! Current: {current} Latest: {latest}"
update-hide-button: " [✔ Hide for 24h] Download: {download_url}"
update-hidden: "Update notifications hidden for 24 hours! ⌛"
# First join messages
first-join-welcome: "Welcome! ✔ You can control your locator bar visibility!"
first-join-info: "Use /locatorbar help to see all available commands. Have fun!"
# Command messages
only-players: "Only players can use this command!"
no-permission: "You don't have permission to use this command!"
config-reloaded: "Configuration reloaded successfully!"
command-not-available: "This command is not available in the current control mode!"
player-not-found: "Player not found or not online!"
# World-specific messages
world-force-visible: "You cannot change visibility in this world! ⚔ Force visibility is enabled."
admin-world-force-visible: "Cannot change visibility for {player}! ⚔ Force visibility is enabled in their world."
# Cooldown messages
cooldown-active: "Please wait {time} seconds before using this command again! ⌛"
# Toggle messages - Combined mode
visibility-enabled-combined: "Locator bar enabled! You are visible and can see others! ✔"
visibility-disabled-combined: "Locator bar disabled! You are hidden and cannot see others! ❌"
# Toggle messages - Separate mode
visibility-enabled: "You are now visible on other players' locator bars! ✔"
visibility-disabled: "You are now hidden from other players' locator bars! ❌"
receiving-enabled: "You can now see other players on your locator bar! ☀"
receiving-disabled: "You can no longer see other players on your locator bar! ☁"
# Admin messages
admin-usage: "Usage: /locatorbar player [toggle|status]"
admin-visibility-enabled: "Enabled locator bar for {player}! ✔"
admin-visibility-disabled: "Disabled locator bar for {player}! ❌"
admin-status-header: "Locator bar settings for {player}:"
admin-status-visible: " ★ Visibility: ᴇɴᴀʙʟᴇᴅ (others can see them)"
admin-status-hidden: " ☠ Visibility: ᴅɪsᴀʙʟᴇᴅ (others cannot see them)"
admin-status-receiving: " ☀ Receiving: ᴇɴᴀʙʟᴇᴅ (they can see others)"
admin-status-not-receiving: " ☁ Receiving: ᴅɪsᴀʙʟᴇᴅ (they cannot see others)"
admin-status-world-force: " ⚔ World: ғᴏʀᴄᴇ ᴠɪsɪʙʟᴇ (world setting override)"
# Status messages
status-header: "Your current locator bar settings:"
status-visible: " ★ Visibility: ᴇɴᴀʙʟᴇᴅ (others can see you)"
status-hidden: " ☠ Visibility: ᴅɪsᴀʙʟᴇᴅ (others cannot see you)"
status-receiving: " ☀ Receiving: ᴇɴᴀʙʟᴇᴅ (you can see others)"
status-not-receiving: " ☁ Receiving: ᴅɪsᴀʙʟᴇᴅ (you cannot see others)"
status-combined: " → Mode: ᴄᴏᴍʙɪɴᴇᴅ (toggle controls both settings)"
status-world-force: " ⚔ World: ғᴏʀᴄᴇ ᴠɪsɪʙʟᴇ (forced visible in this world)"
# Help messages - Combined mode
help-header-combined: "Available commands:"
help-toggle-combined: " /locatorbar toggle - Toggle locator bar visibility (both ways)"
help-status-combined: " /locatorbar status - Check your current settings"
help-help-combined: " /locatorbar help - Show this help message"
help-player-combined: " /locatorbar player [toggle|status] - Manage other players (admin)"
help-reload-combined: " /locatorbar reload - Reload configuration (admin)"
# Help messages - Separate mode
help-header: "Available commands:"
help-toggle: " /locatorbar toggle - Toggle your visibility to others"
help-receive: " /locatorbar receive - Toggle seeing others on your bar"
help-status: " /locatorbar status - Check your current settings"
help-help: " /locatorbar help - Show this help message"
help-player: " /locatorbar player [toggle|status] - Manage other players (admin)"
help-reload: " /locatorbar reload - Reload configuration (admin)"
```
lang/de.yml
```yaml
# German Messages / Deutsche Nachrichten
prefix: "ʟᴏᴄᴀᴛᴏʀʙᴀʀ » "
# Update messages
update-available: "⚔ Update verfügbar! Aktuell: {current} Neueste: {latest}"
update-hide-button: " [✔ Für 24h ausblenden] Download: {download_url}"
update-hidden: "Update-Benachrichtigungen für 24 Stunden ausgeblendet! ⌛"
# First join messages
first-join-welcome: "Willkommen auf dem Server! ✔ Du kannst nun die Sichtbarkeit deiner Locator Bar umschalten."
first-join-info: "Nutze /locatorbar help, um alle verfügbaren Befehle zu entdecken. Viel Spaß beim Spielen!"
# Command messages
only-players: "Nur Spieler können diesen Befehl verwenden!"
no-permission: "Du hast keine Berechtigung für diesen Befehl!"
config-reloaded: "Konfiguration erfolgreich neu geladen!"
command-not-available: "Dieser Befehl ist im aktuellen Kontrollmodus nicht verfügbar!"
player-not-found: "Spieler nicht gefunden oder nicht online!"
# World-specific messages
world-force-visible: "Du kannst die Sichtbarkeit in dieser Welt nicht ändern! ⚔ Zwangssichtbarkeit ist aktiviert."
admin-world-force-visible: "Kann Sichtbarkeit für {player} nicht ändern! ⚔ Zwangssichtbarkeit ist in ihrer Welt aktiviert."
# Cooldown messages
cooldown-active: "Bitte warte {time} Sekunden bevor du diesen Befehl erneut verwendest! ⌛"
# Toggle messages - Combined mode
visibility-enabled-combined: "Locator Bar aktiviert! Du bist sichtbar und kannst andere sehen! ✔"
visibility-disabled-combined: "Locator Bar deaktiviert! Du bist versteckt und kannst andere nicht sehen! ❌"
# Toggle messages - Separate mode
visibility-enabled: "Du bist jetzt sichtbar auf anderen Locator Bars! ✔"
visibility-disabled: "Du bist jetzt versteckt vor anderen Locator Bars! ❌"
receiving-enabled: "Du kannst jetzt andere Spieler auf deiner Locator Bar sehen! ☀"
receiving-disabled: "Du kannst keine anderen Spieler mehr auf deiner Locator Bar sehen! ☁"
# Admin messages
admin-usage: "Verwendung: /locatorbar player [toggle|status]"
admin-visibility-enabled: "Locator Bar für {player} aktiviert! ✔"
admin-visibility-disabled: "Locator Bar für {player} deaktiviert! ❌"
admin-status-header: "Locator Bar Einstellungen für {player}:"
admin-status-visible: " ★ Sichtbarkeit: ᴀᴋᴛɪᴠ (andere können ihn sehen)"
admin-status-hidden: " ☠ Sichtbarkeit: ɪɴᴀᴋᴛɪᴠ (andere können ihn nicht sehen)"
admin-status-receiving: " ☀ Empfangen: ᴀᴋᴛɪᴠ (er kann andere sehen)"
admin-status-not-receiving: " ☁ Empfangen: ɪɴᴀᴋᴛɪᴠ (er kann andere nicht sehen)"
admin-status-world-force: " ⚔ Welt: ᴢᴡᴀɴɢssɪᴄʜᴛʙᴀʀ (Welteinstellung überschreibt)"
# Status messages
status-header: "Deine aktuellen Locator Bar Einstellungen:"
status-visible: " ★ Sichtbarkeit: ᴀᴋᴛɪᴠ (andere können dich sehen)"
status-hidden: " ☠ Sichtbarkeit: ɪɴᴀᴋᴛɪᴠ (andere können dich nicht sehen)"
status-receiving: " ☀ Empfangen: ᴀᴋᴛɪᴠ (du kannst andere sehen)"
status-not-receiving: " ☁ Empfangen: ɪɴᴀᴋᴛɪᴠ (du kannst andere nicht sehen)"
status-combined: " → Modus: ᴋᴏᴍʙɪɴɪᴇʀᴛ (Toggle kontrolliert beide Einstellungen)"
status-world-force: " ⚔ Welt: ᴢᴡᴀɴɢssɪᴄʜᴛʙᴀʀ (zwangsweise sichtbar in dieser Welt)"
# Help messages - Combined mode
help-header-combined: "Verfügbare Befehle:"
help-toggle-combined: " /locatorbar toggle - Locator Bar Sichtbarkeit umschalten (beide Richtungen)"
help-status-combined: " /locatorbar status - Deine aktuellen Einstellungen überprüfen"
help-help-combined: " /locatorbar help - Diese Hilfe-Nachricht anzeigen"
help-player-combined: " /locatorbar player [toggle|status] - Andere Spieler verwalten (Admin)"
help-reload-combined: " /locatorbar reload - Konfiguration neu laden (Admin)"
# Help messages - Separate mode
help-header: "Verfügbare Befehle:"
help-toggle: " /locatorbar toggle - Deine Sichtbarkeit für andere umschalten"
help-receive: " /locatorbar receive - Das Sehen anderer auf deinem Balken umschalten"
help-status: " /locatorbar status - Deine aktuellen Einstellungen überprüfen"
help-help: " /locatorbar help - Diese Hilfe-Nachricht anzeigen"
help-player: " /locatorbar player [toggle|status] - Andere Spieler verwalten (Admin)"
help-reload: " /locatorbar reload - Konfiguration neu laden (Admin)"
```
PlaceholderAPI
### Available Placeholders
| Placeholder | Returns | Example |
|-------------|---------|---------|
| `%locatorbar_visible%` | `true`/`false` | `true` |
| `%locatorbar_receiving%` | `true`/`false` | `false` |
| `%locatorbar_status%` | Detailed status | `visible_receiving` |
Supports english and german.
暂无评论,抢个沙发吧~