AdvancedFlags - флаги стран над головой игрока

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

Зачем это вообще нужно

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

Что умеет AdvancedFlags

Основные возможности плагина:

• Флаг над головой игрока - отображается как частицы, видимые всем на сервере
• Ротация вслед за взглядом - флаг поворачивается туда, куда смотрит игрок, а не висит статичной картинкой
• Скрытие флагов - если не хочется смотреть на чужие флаги, отключаешь одной командой
• Автовыбор флага по IP - определяется страна по адресу и выставляет флаг автоматически. Работает через сторонний API, нужен бесплатный ключ

Список доступных флагов, по данным вики, перевалил за 230 штук. Выбор идёт через GUI - не надо помнить коды стран наизусть. Есть и ручной вариант: /af flags {код_страны} для тех, кто знает ISO-код своей страны. Плюс поддерживаются собственные PNG-флаги, если стандартного набора не хватило.

Команды

Все команды плагина начинаются с /af:

• /af help - справка по командам
• /af flags - открыть GUI выбора флага
• /af flags {country_code} - поставить конкретный флаг по коду страны
• /af version - версия плагина
• /af hide - скрыть все флаги
• /af rotate - автоматическая смена флага каждую секунду
• /af none - убрать флаг с игрока

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

Требования и совместимость

Хорошая новость: AdvancedFlags не требует установки сторонних зависимостей. Он использует ParticleNativeAPI для отрисовки частиц, но эта библиотека уже вшита в .jar - отдельно качать ничего не нужно. Кладёшь плагин в папку plugins, перезапускаешь сервер и всё, ничего не сломается.

Совместимость указана для Bukkit, Paper и Spigot, версии Minecraft 1.8 - 1.19.3. Это значит, что плагин покрывает огромный пласт серверов, включая старые PvP-проекты, которые принципиально сидят на 1.8. Подтверждений работы на 1.20+ в описании нет, так что для свежих версий стоит протестировать на тестовом сервере перед установкой в прод.

Последний релиз - 1.3.1 от 12 января 2023 года. В нём обновили backend API и добавили поддержку 1.19.x. Проект явно не заброшен, но и активной разработки с постоянными обновлениями ждать не стоит.

Важный нюанс

Флаги - это частицы, а не сущности и не виртуальные армор-стенды. Это значит, что на серверах с большим онлайном стоит следить за нагрузкой: если онлайн под 100+ и каждый игрок крутит флаг у головы, клиенты могут проседать по FPS. На Paper есть встроенные лимиты на частицы - проверь, что значение не порезано, иначе флаги будут мигать или не отображаться вовсе. Если ставишь автовыбор по IP - держи в голове, что сторонний API может капризничать при недоступности сервиса.

Кому ставить

Плагин стоит своих пяти минут на установку, если у тебя небольшой или средний сервер с активным сообществом и ты хочешь добавить социальной атмосферы. Для больших проектов с жёсткой экономикой ресурсов лучше сначала прогнать нагрузочный тест. Скачать AdvancedFlags можно под Paper, Spigot или Bukkit - плагин универсальный, дополнительных библиотек не просит. Ставь на тестовый сервер, проверь команды и GUI, и только потом заливай на основной.