![LOCATORBAR](https://cdn.modrinth.com/data/cached_images/cbd7199f9467e3b586b7b5ddc3197792ad7b9eeb.png) ![Downloads](https://img.shields.io/modrinth/dt/KF5O4Zzd?logo=modrinth&label=Downloads&color=38B541&style=for-the-badge) ![Minecraft](https://img.shields.io/badge/Minecraft-1.21.6+-blue?style=for-the-badge) *Per-player locator bar visibility control*

---

![Example](https://cdn.modrinth.com/data/cached_images/96232b3a19bd4c2828862dccfd721159f7ecd77a_0.webp) _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._

### ⚙️ Requirements - **Server**: Paper/Purpur 1.21.6+ - **Java**: 21+ - **Optional**: PlaceholderAPI for placeholder support

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) # Debug mode debug: false # Do not change this config-version: 1 ```

messages.yml

```yaml # LocatorBar Messages # English Messages en: prefix: "ʟᴏᴄᴀᴛᴏʀʙᴀʀ » " # Update messages update-available: "<#fbbf24>⚔ Update available! <#94a3b8>Current: <#ff8787>{current} <#94a3b8>Latest: <#51cf66>{latest}" update-hide-button: " <#a78bfa>[<#51cf66>✔ Hide for 24h] <#94a3b8>Download: <#a5f3fc>{download_url}" update-hidden: "<#51cf66>Update notifications hidden for 24 hours! ⌛" # First join messages first-join-welcome: "<#51cf66>Welcome! <#a5f3fc>✔ You can control your locator bar visibility!" first-join-info: "<#fbbf24>Use <#a78bfa>/locatorbar help <#fbbf24>to see all available commands. <#94a3b8>Have fun!" # Command messages only-players: "<#ff6b6b>Only players can use this command!" no-permission: "<#ff6b6b>You don't have permission to use this command!" config-reloaded: "<#51cf66>Configuration reloaded successfully!" command-not-available: "<#ff6b6b>This command is not available in the current control mode!" player-not-found: "<#ff6b6b>Player not found or not online!" # World-specific messages world-force-visible: "<#ff8787>You cannot change visibility in this world! <#a78bfa>⚔ Force visibility is enabled." admin-world-force-visible: "<#ff8787>Cannot change visibility for <#fbbf24>{player}<#ff8787>! ⚔ Force visibility is enabled in their world." # Cooldown messages cooldown-active: "<#ff8787>Please wait <#fbbf24>{time} seconds <#ff8787>before using this command again! ⌛" # Toggle messages - Combined mode visibility-enabled-combined: "<#51cf66>Locator bar enabled! You are visible and can see others! <#a5f3fc>✔" visibility-disabled-combined: "<#ff8787>Locator bar disabled! You are hidden and cannot see others! <#fbbf24>❌" # Toggle messages - Separate mode visibility-enabled: "<#51cf66>You are now visible on other players' locator bars! <#a5f3fc>✔" visibility-disabled: "<#ff8787>You are now hidden from other players' locator bars! <#fbbf24>❌" receiving-enabled: "<#51cf66>You can now see other players on your locator bar! <#a5f3fc>☀" receiving-disabled: "<#ff8787>You can no longer see other players on your locator bar! <#94a3b8>☁" # Admin messages admin-usage: "<#a78bfa>Usage: /locatorbar player [toggle|status]" admin-visibility-enabled: "<#51cf66>Enabled locator bar for <#a5f3fc>{player}<#51cf66>! ✔" admin-visibility-disabled: "<#ff8787>Disabled locator bar for <#fbbf24>{player}<#ff8787>! ❌" admin-status-header: "<#e879f9>Locator bar settings for <#a5f3fc>{player}<#e879f9>:" admin-status-visible: " <#51cf66>★ Visibility: ᴇɴᴀʙʟᴇᴅ (others can see them)" admin-status-hidden: " <#ff8787>☠ Visibility: ᴅɪsᴀʙʟᴇᴅ (others cannot see them)" admin-status-receiving: " <#51cf66>☀ Receiving: ᴇɴᴀʙʟᴇᴅ (they can see others)" admin-status-not-receiving: " <#ff8787>☁ Receiving: ᴅɪsᴀʙʟᴇᴅ (they cannot see others)" admin-status-world-force: " <#a78bfa>⚔ World: ғᴏʀᴄᴇ ᴠɪsɪʙʟᴇ (world setting override)" # Status messages status-header: "<#e879f9>Your current locator bar settings:" status-visible: " <#51cf66>★ Visibility: ᴇɴᴀʙʟᴇᴅ (others can see you)" status-hidden: " <#ff8787>☠ Visibility: ᴅɪsᴀʙʟᴇᴅ (others cannot see you)" status-receiving: " <#51cf66>☀ Receiving: ᴇɴᴀʙʟᴇᴅ (you can see others)" status-not-receiving: " <#ff8787>☁ Receiving: ᴅɪsᴀʙʟᴇᴅ (you cannot see others)" status-combined: " <#a78bfa>→ Mode: ᴄᴏᴍʙɪɴᴇᴅ (toggle controls both settings)" status-world-force: " <#a78bfa>⚔ World: ғᴏʀᴄᴇ ᴠɪsɪʙʟᴇ (forced visible in this world)" # Help messages - Combined mode help-header-combined: "<#a78bfa>Available commands:" help-toggle-combined: " <#fbbf24>/locatorbar toggle - Toggle locator bar visibility (both ways)" help-status-combined: " <#fbbf24>/locatorbar status - Check your current settings" help-help-combined: " <#fbbf24>/locatorbar help - Show this help message" help-player-combined: " <#f87171>/locatorbar player [toggle|status] - Manage other players (admin)" help-reload-combined: " <#f87171>/locatorbar reload - Reload configuration (admin)" # Help messages - Separate mode help-header: "<#a78bfa>Available commands:" help-toggle: " <#fbbf24>/locatorbar toggle - Toggle your visibility to others" help-receive: " <#fbbf24>/locatorbar receive - Toggle seeing others on your bar" help-status: " <#fbbf24>/locatorbar status - Check your current settings" help-help: " <#fbbf24>/locatorbar help - Show this help message" help-player: " <#f87171>/locatorbar player [toggle|status] - Manage other players (admin)" help-reload: " <#f87171>/locatorbar reload - Reload configuration (admin)" # German Messages de: prefix: "ʟᴏᴄᴀᴛᴏʀʙᴀʀ » " # Update messages update-available: "<#fbbf24>⚔ Update verfügbar! <#94a3b8>Aktuell: <#ff8787>{current} <#94a3b8>Neueste: <#51cf66>{latest}" update-hide-button: " <#a78bfa>[<#51cf66>✔ Für 24h ausblenden] <#94a3b8>Download: <#a5f3fc>{download_url}" update-hidden: "<#51cf66>Update-Benachrichtigungen für 24 Stunden ausgeblendet! ⌛" # First join messages first-join-welcome: "<#51cf66>Willkommen auf dem Server! <#a5f3fc>✔ Du kannst nun die Sichtbarkeit deiner Locator Bar togglen." first-join-info: "<#fbbf24>Nutze <#a78bfa>/locatorbar help<#fbbf24>, um alle verfügbaren Befehle zu entdecken. <#94a3b8>Viel Spaß beim Spielen!" # Command messages only-players: "<#ff6b6b>Nur Spieler können diesen Befehl verwenden!" no-permission: "<#ff6b6b>Du hast keine Berechtigung für diesen Befehl!" config-reloaded: "<#51cf66>Konfiguration erfolgreich neu geladen!" command-not-available: "<#ff6b6b>Dieser Befehl ist im aktuellen Kontrollmodus nicht verfügbar!" player-not-found: "<#ff6b6b>Spieler nicht gefunden oder nicht online!" # World-specific messages world-force-visible: "<#ff8787>Du kannst die Sichtbarkeit in dieser Welt nicht ändern! <#a78bfa>⚔ Zwangssichtbarkeit ist aktiviert." admin-world-force-visible: "<#ff8787>Kann Sichtbarkeit für <#fbbf24>{player}<#ff8787> nicht ändern! ⚔ Zwangssichtbarkeit ist in ihrer Welt aktiviert." # Cooldown messages cooldown-active: "<#ff8787>Bitte warte <#fbbf24>{time} Sekunden <#ff8787>bevor du diesen Befehl erneut verwendest! ⌛" # Toggle messages - Combined mode visibility-enabled-combined: "<#51cf66>Locator Bar aktiviert! Du bist sichtbar und kannst andere sehen! <#a5f3fc>✔" visibility-disabled-combined: "<#ff8787>Locator Bar deaktiviert! Du bist versteckt und kannst andere nicht sehen! <#fbbf24>❌" # Toggle messages - Separate mode visibility-enabled: "<#51cf66>Du bist jetzt sichtbar auf anderen Locator Bar! <#a5f3fc>✔" visibility-disabled: "<#ff8787>Du bist jetzt versteckt vor anderen Locator Bar! <#fbbf24>❌" receiving-enabled: "<#51cf66>Du kannst jetzt andere Spieler auf deiner Locator Bar sehen! <#a5f3fc>☀" receiving-disabled: "<#ff8787>Du kannst keine anderen Spieler mehr auf deiner Locator Bar sehen! <#94a3b8>☁" # Admin messages admin-usage: "<#a78bfa>Verwendung: /locatorbar player [toggle|status]" admin-visibility-enabled: "<#51cf66>Locator Bar für <#a5f3fc>{player}<#51cf66> aktiviert! ✔" admin-visibility-disabled: "<#ff8787>Locator Bar für <#fbbf24>{player}<#ff8787> deaktiviert! ❌" admin-status-header: "<#e879f9>Locator Bar Einstellungen für <#a5f3fc>{player}<#e879f9>:" admin-status-visible: " <#51cf66>★ Sichtbarkeit: ᴀᴋᴛɪᴠ (andere können ihn sehen)" admin-status-hidden: " <#ff8787>☠ Sichtbarkeit: ɪɴᴀᴋᴛɪᴠ (andere können ihn nicht sehen)" admin-status-receiving: " <#51cf66>☀ Empfangen: ᴀᴋᴛɪᴠ (er kann andere sehen)" admin-status-not-receiving: " <#ff8787>☁ Empfangen: ɪɴᴀᴋᴛɪᴠ (er kann andere nicht sehen)" admin-status-world-force: " <#a78bfa>⚔ Welt: ᴢᴡᴀɴɢssɪᴄʜᴛʙᴀʀ (Welteinstellung überschreibt)" # Status messages status-header: "<#e879f9>Deine aktuellen Locator Bar Einstellungen:" status-visible: " <#51cf66>★ Sichtbarkeit: ᴀᴋᴛɪᴠ (andere können dich sehen)" status-hidden: " <#ff8787>☠ Sichtbarkeit: ɪɴᴀᴋᴛɪᴠ (andere können dich nicht sehen)" status-receiving: " <#51cf66>☀ Empfangen: ᴀᴋᴛɪᴠ (du kannst andere sehen)" status-not-receiving: " <#ff8787>☁ Empfangen: ɪɴᴀᴋᴛɪᴠ (du kannst andere nicht sehen)" status-combined: " <#a78bfa>→ Modus: ᴋᴏᴍʙɪɴɪᴇʀᴛ (Toggle kontrolliert beide Einstellungen)" status-world-force: " <#a78bfa>⚔ Welt: ᴢᴡᴀɴɢssɪᴄʜᴛʙᴀʀ (zwangsweise sichtbar in dieser Welt)" # Help messages - Combined mode help-header-combined: "<#a78bfa>Verfügbare Befehle:" help-toggle-combined: " <#fbbf24>/locatorbar toggle - Locator Bar Sichtbarkeit umschalten (beide Richtungen)" help-status-combined: " <#fbbf24>/locatorbar status - Deine aktuellen Einstellungen überprüfen" help-help-combined: " <#fbbf24>/locatorbar help - Diese Hilfe-Nachricht anzeigen" help-player-combined: " <#f87171>/locatorbar player [toggle|status] - Andere Spieler verwalten (Admin)" help-reload-combined: " <#f87171>/locatorbar reload - Konfiguration neu laden (Admin)" # Help messages - Separate mode help-header: "<#a78bfa>Verfügbare Befehle:" help-toggle: " <#fbbf24>/locatorbar toggle - Deine Sichtbarkeit für andere umschalten" help-receive: " <#fbbf24>/locatorbar receive - Das Sehen anderer auf deinem Balken umschalten" help-status: " <#fbbf24>/locatorbar status - Deine aktuellen Einstellungen überprüfen" help-help: " <#fbbf24>/locatorbar help - Diese Hilfe-Nachricht anzeigen" help-player: " <#f87171>/locatorbar player [toggle|status] - Andere Spieler verwalten (Admin)" help-reload: " <#f87171>/locatorbar reload - Konfiguration neu laden (Admin)" # Do not change this messageconfig-version: 1 ```

PlaceholderAPI

### Available Placeholders | Placeholder | Returns | Example | |-------------|---------|---------| | `%locatorbar_visible%` | `true`/`false` | `true` | | `%locatorbar_receiving%` | `true`/`false` | `false` | | `%locatorbar_status%` | Detailed status | `visible_receiving` |

### 📝 Supported Languages - **🇺🇸 English** (`en`) - Default - **🇩🇪 German** (`de`) - Deutsch

Locator Bar

Compatibility

Minecraft: Java Edition

Platforms

Creators

Details

Player Example

Available Commands

Status Example