Firefly (Файрфлай)

Плагин для серверов Майнкрафт, который управляет точками игроков на полосе-локаторе в верхней части экрана. Игрок может скрыть свою точку или сменить её цвет, чтобы не выдавать направление и расстояние до себя другим участникам. Подходит для выживания, пвп, фракций, ролевых режимов и мини-игр со скрытностью.

Возможности

• Скрывает точку игрока с полосы-локатора у других игроков.
• Позволяет выбрать один из 16 цветов Майнкрафт либо собственный цвет в формате #RRGGBB.
• Даёт администрации режим обхода скрытия: с ним можно видеть скрывшихся игроков и получать их список.
• Сохраняет для каждого игрока состояние скрытия, выбранный цвет и настройку обхода после перезахода или перезапуска сервера.
• Изменяет только полосу-локатор: компасы, карты, таблица игроков и другие игровые механики остаются без изменений.

Команды

• /firefly hide — скрыть свою точку.
• /firefly show — снова показать свою точку.
• /firefly toggle — переключить скрытие.
• /firefly color <name|#RRGGBB> — задать цвет точки, например /ff color #FF8800.
• /firefly color reset — вернуть обычный цвет точки.
• /firefly bypass <on|off|toggle> — включить, выключить или переключить обход скрытия для администрации.
• /firefly showhidden — показать список игроков со скрытой точкой.
• /firefly reload — перезагрузить config.yml и messages.yml.

Основная команда — /firefly, короткая форма — /ff. Для цветов доступны значения black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple, gold, gray, dark_gray, blue, green, aqua, red, light_purple, yellow, white и шестнадцатеричный код #RRGGBB.

Права

• firefly.use — скрытие, показ, переключение и смена цвета собственной точки; доступно всем игрокам.
• firefly.admin — обход скрытия, просмотр скрывшихся игроков и перезагрузка конфигурации; по умолчанию доступно операторам.

Настройка

Файлы плагина находятся в plugins/Firefly/: config.yml, messages.yml и, при стандартном хранилище, playerdata.yml.

Тексты сообщений редактируются в messages.yml; для цветов используются коды с символом &. Настройки игроков можно хранить в yaml, встроенной базе h2 или mysql. MySQL позволяет использовать общие настройки скрытия и цветов на сети серверов.

В конфигурации задаётся состояние режима обхода скрытия для администраторов при входе. Если администратор меняет его командой /firefly bypass, этот выбор сохраняется отдельно.

Требования

Для работы требуется плагин packetevents. Поддерживаются Paper, Spigot и Folia, а игроки подключаются с обычного ванильного клиента без клиентского мода и ресурс-пака.