Locator Bar

Locator Bar - это плагин для серверов Minecraft, который даёт игрокам полный контроль над тем, кто их видит на локаторной панели (верхняя полоска с точками игроков). На обычных серверах эта панель показывает всех игроков в радиусе, но бывают ситуации, когда хочется скрыться - будь то PvP, мини-игры или просто желание побыть незаметным. Locator Bar решает именно эту проблему, позволяя каждому игроку индивидуально настраивать видимость.

Плагин работает на любом сервере с поддержкой Bukkit/Spigot/Paper, использует права доступа и может интегрироваться с PlaceholderAPI. Всё управление происходит через простые команды, а гибкая конфигурация позволяет администратору настроить поведение под свой сервер.

Команды и разрешения

Управлять видимостью можно через команду /locatorbar (сокращения: /lb, /locator). Права разделены на два уровня: базовые для игроков и админские для персонала.

Команда	Описание	Право
/locatorbar toggle	Переключить видимость (в зависимости от режима)	locatorbar.use
/locatorbar receive	Переключить получение сигналов от других (только в раздельном режиме)	locatorbar.use
/locatorbar status	Проверить текущие настройки	locatorbar.use
/locatorbar help	Показать справку	locatorbar.use
/locatorbar player <имя> [toggle|status]	Управление настройками других игроков (админ)	locatorbar.admin
/locatorbar reload	Перезагрузить конфигурацию	locatorbar.admin

Права доступа:

Право	Описание	По умолчанию
locatorbar.use	Доступ к базовым командам	true (все)
locatorbar.admin	Админ-команды и управление игроками	op
locatorbar.cooldown.bypass	Игнорировать все задержки	false
locatorbar.cooldown.X	Установить свою задержку в секундах (0-300)	false

Примеры использования прав: locatorbar.cooldown.5, locatorbar.cooldown.60, locatorbar.cooldown.120.

Режимы работы

В конфиге можно выбрать один из двух режимов управления:

• combined (объединённый) - команда /lb toggle одновременно переключает и видимость игрока для других, и возможность видеть других. Проще, но менее гибкий.
• separate (раздельный) - /lb toggle управляет только твоей видимостью, а /lb receive - тем, видишь ли ты других. Позволяет, например, скрыться от всех, но при этом самому наблюдать за игроками.

Конфигурация

Файл config.yml позволяет тонко настроить плагин. Ниже приведён его полный перевод с русскими комментариями, чтобы было понятнее.

# Locator Bar
# Язык (en, de, ru - если добавить файл)
language: "en"

# Показывать приветственное сообщение новичкам при первом заходе
show-first-join-message: false

# Режим управления: 'combined' или 'separate'
control-mode: "combined"

# Задержка между командами (по умолчанию 5 секунд)
default-cooldown: 5

# Настройки звуков
sounds:
  enabled: false  # Включить звуки
  volume: 1.0     # Громкость (0.0 - 1.0)
  pitch: 1.0      # Высота тона (0.5 - 2.0)
  enable: "entity.player.levelup"     # Звук при включении видимости
  disable: "block.note_block.bass"    # Звук при выключении

# Настройки для конкретных миров
world-settings:
  # Пример:
  # world_nether:
  #   force-visible: true

# Дальность передачи и приёма (по умолчанию как в ваниле - 60000000)
default-transmit-range: 60000000.0
default-receive-range: 60000000.0

# Отключать ли приём при скрытии (только для combined режима)
disable-receive-when-hidden: false

# Интервал автосохранения данных игроков (в секундах)
save-interval: 300

# Проверять обновления при запуске
update-checker: true

# Режим отладки
debug: false

# Версия конфига (не менять)
config-version: 2

Языковые файлы

Плагин поддерживает английский и немецкий языки. Вы можете легко добавить русский, переведя файл lang/en.yml и указав language: "ru" в конфиге. Ниже приведён оригинальный английский файл для справки.

# English Messages
prefix: "<gradient:#667eea:#764ba2>ʟᴏᴄᴀᴛᴏʀʙᴀʀ</gradient> <dark_gray>"</dark_gray> "

# Update messages
update-available: "<prefix><#fbbf24>⚔ Update available! <#94a3b8>Current: <#ff8787>{current} <#94a3b8>Latest: <#51cf66>{latest}"
update-hide-button: "  <#a78bfa>[<click:run_command:/locatorbar hideupdate><#51cf66><bold>✔ Hide for 24h</bold></click>] <#94a3b8>Download: <click:open_url:{download_url}><#a5f3fc>{download_url}</click>"
update-hidden: "<prefix><#51cf66>Update notifications hidden for 24 hours! ⌛"

# First join messages
first-join-welcome: "<prefix><#51cf66>Welcome! <#a5f3fc>✔ <white>You can control your locator bar visibility!"
first-join-info: "<prefix><#fbbf24>Use <#a78bfa>/locatorbar help <#fbbf24>to see all available commands. <#94a3b8>Have fun!"

# Command messages
only-players: "<prefix><#ff6b6b>Only players can use this command!"
no-permission: "<prefix><#ff6b6b>You don't have permission to use this command!"
config-reloaded: "<prefix><#51cf66>Configuration reloaded successfully!"
command-not-available: "<prefix><#ff6b6b>This command is not available in the current control mode!"
player-not-found: "<prefix><#ff6b6b>Player not found or not online!"

# World-specific messages
world-force-visible: "<prefix><#ff8787>You cannot change visibility in this world! <#a78bfa>⚔ Force visibility is enabled."
admin-world-force-visible: "<prefix><#ff8787>Cannot change visibility for <#fbbf24>{player}<#ff8787>! ⚔ Force visibility is enabled in their world."

# Cooldown messages
cooldown-active: "<prefix><#ff8787>Please wait <#fbbf24>{time} seconds <#ff8787>before using this command again! ⌛"

# Toggle messages - Combined mode
visibility-enabled-combined: "<prefix><#51cf66>Locator bar <bold>enabled</bold>! You are visible and can see others! <#a5f3fc>✔"
visibility-disabled-combined: "<prefix><#ff8787>Locator bar <bold>disabled</bold>! You are hidden and cannot see others! <#fbbf24>❌"

# Toggle messages - Separate mode
visibility-enabled: "<prefix><#51cf66>You are now <bold>visible</bold> on other players' locator bars! <#a5f3fc>✔"
visibility-disabled: "<prefix><#ff8787>You are now <bold>hidden</bold> from other players' locator bars! <#fbbf24>❌"
receiving-enabled: "<prefix><#51cf66>You can now <bold>see</bold> other players on your locator bar! <#a5f3fc>☀"
receiving-disabled: "<prefix><#ff8787>You can no longer <bold>see</bold> other players on your locator bar! <#94a3b8>☁"

# Admin messages
admin-usage: "<prefix><#a78bfa>Usage: /locatorbar player <name> [toggle|status]"
admin-visibility-enabled: "<prefix><#51cf66>Enabled locator bar for <#a5f3fc>{player}<#51cf66>! ✔"
admin-visibility-disabled: "<prefix><#ff8787>Disabled locator bar for <#fbbf24>{player}<#ff8787>! ❌"
admin-status-header: "<prefix><#e879f9>Locator bar settings for <#a5f3fc>{player}<#e879f9>:"
admin-status-visible: "  <#51cf66>★ Visibility: <bold>ᴇɴᴀʙʟᴇᴅ</bold> <gray>(others can see them)"
admin-status-hidden: "  <#ff8787>☠ Visibility: <bold>ᴅɪsᴀʙʟᴇᴅ</bold> <gray>(others cannot see them)"
admin-status-receiving: "  <#51cf66>☀ Receiving: <bold>ᴇɴᴀʙʟᴇᴅ</bold> <gray>(they can see others)"
admin-status-not-receiving: "  <#ff8787>☁ Receiving: <bold>ᴅɪsᴀʙʟᴇᴅ</bold> <gray>(they cannot see others)"
admin-status-world-force: "  <#a78bfa>⚔ World: <bold>ғᴏʀᴄᴇ ᴠɪsɪʙʟᴇ</bold> <gray>(world setting override)"

# Status messages
status-header: "<prefix><#e879f9>Your current locator bar settings:"
status-visible: "  <#51cf66>★ Visibility: <bold>ᴇɴᴀʙʟᴇᴅ</bold> <gray>(others can see you)"
status-hidden: "  <#ff8787>☠ Visibility: <bold>ᴅɪsᴀʙʟᴇᴅ</bold> <gray>(others cannot see you)"
status-receiving: "  <#51cf66>☀ Receiving: <bold>ᴇɴᴀʙʟᴇᴅ</bold> <gray>(you can see others)"
status-not-receiving: "  <#ff8787>☁ Receiving: <bold>ᴅɪsᴀʙʟᴇᴅ</bold> <gray>(you cannot see others)"
status-combined: "  <#a78bfa>→ Mode: <bold>ᴄᴏᴍʙɪɴᴇᴅ</bold> <gray>(toggle controls both settings)"
status-world-force: "  <#a78bfa>⚔ World: <bold>ғᴏʀᴄᴇ ᴠɪsɪʙʟᴇ</bold> <gray>(forced visible in this world)"

# Help messages - Combined mode
help-header-combined: "<prefix><#a78bfa>Available commands:"
help-toggle-combined: "  <#fbbf24>/locatorbar toggle <gray>- Toggle locator bar visibility (both ways)"
help-status-combined: "  <#fbbf24>/locatorbar status <gray>- Check your current settings"
help-help-combined: "  <#fbbf24>/locatorbar help <gray>- Show this help message"
help-player-combined: "  <#f87171>/locatorbar player <name> [toggle|status] <gray>- Manage other players <italic>(admin)"
help-reload-combined: "  <#f87171>/locatorbar reload <gray>- Reload configuration <italic>(admin)"

# Help messages - Separate mode
help-header: "<prefix><#a78bfa>Available commands:"
help-toggle: "  <#fbbf24>/locatorbar toggle <gray>- Toggle your visibility to others"
help-receive: "  <#fbbf24>/locatorbar receive <gray>- Toggle seeing others on your bar"
help-status: "  <#fbbf24>/locatorbar status <gray>- Check your current settings"
help-help: "  <#fbbf24>/locatorbar help <gray>- Show this help message"
help-player: "  <#f87171>/locatorbar player <name> [toggle|status] <gray>- Manage other players <italic>(admin)"
help-reload: "  <#f87171>/locatorbar reload <gray>- Reload configuration <italic>(admin)"

PlaceholderAPI

Плагин поддерживает PlaceholderAPI, что позволяет выводить информацию о видимости на табло, скорбордах и в чате.

Плейсхолдер	Возвращает	Пример
%locatorbar_visible%	true/false	true
%locatorbar_receiving%	true/false	false
%locatorbar_status%	Статус (например, visible_receiving)	visible_receiving

Зачем это нужно на сервере

В ванильном Minecraft локаторная панель показывает всех игроков в радиусе, и это нельзя отключить. На серверах с PvP или анархией это может быть критично - враги видят твоё местоположение. Locator Bar даёт игрокам выбор: быть невидимым для чужих глаз, но при этом самому видеть всех. В мини-играх можно принудительно включить видимость в определённых мирах, чтобы никто не прятался. Администратор может управлять настройками любого игрока или перезагружать конфиг без перезапуска сервера.

Плагин лёгкий, не нагружает сервер, и отлично подходит как для небольших приватных серверов, так и для крупных проектов. Настройка займёт пару минут - достаточно скопировать конфиг, поправить пару строк и раздать права.

Если вы собираете сервер и хотите дать игрокам больше контроля над приватностью - Locator Bar будет отличным дополнением. Скачайте плагин Locator Bar и настройте его под свой стиль игры.