Ultimate Teams

Ultimate Teams — это легковесный плагин для серверов Minecraft на базе Spigot и его форков (Paper, Purpur, Folia), разработанный с упором на оптимизацию. Он позволяет создавать команды с возможностью отключения дружественного огня (friendly fire) и управления союзниками. Плагин обеспечивает кросс-серверную синхронизацию данных в реальном времени через MySQL и брокер сообщений, поддерживает команды чата для команд и союзников, а также экономические функции, такие как банковские счета команд и плата за вступление. Администраторы получают расширенные инструменты для управления командами, включая управление эндер-сундуками и принудительное добавление игроков.

Основные возможности и архитектура

Плагин разработан как оптимизированное решение для серверов, способное выдерживать нагрузку более 100 активных игроков. Вся работа с базой данных выполняется асинхронно, что предотвращает задержки (lag) в игровом процессе. Поддерживаются современные СУБД: H2 (предпочтительная), SQLite, MySQL (предпочтительная), MariaDB и PostgreSQL. Кросс-серверная синхронизация позволяет объединять данные между проксируемыми серверами в реальном времени, используя MySQL и брокер сообщений, что делает возможным создание единого кланового пространства на нескольких серверах. Для игроков на Bedrock Edition поддержка обеспечивается корректной установкой Floodgate.

Команды управления командой

Основная команда /team (алиасы: /team) предоставляет полный набор инструментов для игроков. С её помощью можно создавать команды, если игрок не состоит в другой, распускать свои команды (только владельцем), покидать текущую команду, приглашать игроков или присоединяться к приглашениям. Команда также позволяет удалять участников (/team kick), отображать информацию о текущей команде (/team info) или список всех команд на сервере (/team list). Можно менять префикс команды в чате, добавлять или удалять союзные и враждебные команды (/team ally, /team enemy), включать или выключать дружественный огонь (/team pvp). Также доступна установка домашнего места команды (/team sethome), назначение менеджеров команды (/team promote), управление правами менеджеров (/team permission) и экономические операции: депозит и вывод средств из банковского счета команды (/team deposit, /team withdraw).

Административные инструменты

Команда /teamadmin (алиас /ta) предназначена исключительно для администраторов сервера. Она позволяет перезагружать файлы конфигурации config.yml и messages.yml без рестарта плагина (/teamadmin reload). Администраторы могут распускать любые несанкционированные команды (/teamadmin disband), принудительно добавлять игроков в команды (/teamadmin join) и получать общую информацию о работе плагина (/teamadmin about). Особое внимание уделено управлению командными эндер-сундуками: через команду /teamadmin echest администраторы могут просматривать, редактировать, удалять, добавлять новые сундуки, делать резервные копии и откатывать изменения для всех общих эндер-сундуков каждой команды.

Командный чат и приглашения

Для коммуникации внутри групп предусмотрены специализированные команды. Команда /tc (алиасы: /teamchat, /tchat) отправляет сообщения только участникам одной команды или той, в которой находится игрок. Команда /ac (алиас /allychat) расширяет охват, отправляя сообщения всем участникам текущей команды, её союзных команд. Управление приглашениями осуществляется через команду /invites, которая позволяет игроку включить или выключить возможность получать приглашения в команды. Если функция отключена, игрок не сможет быть приглашен в ни одну из команд.

Экономика и интеграции

Плагин поддерживает экономические механики, включая стоимость создания команды, плату за вступление в неё и банковские счета команд. Для работы с экономикой требуется интеграция с соответствующими плагинами. Также доступна поддержка PlaceholderAPI (обязательна установка последней версии плагина), предоставляющая ряд плейсхолдеров без необходимости загрузки дополнительных файлов. Для управления телепортацией плагин использует собственный обработчик, но также поддерживает интеграцию с HuskHomes для более плавной работы, включая кросс-серверные телепортации.

Система прав доступа

Доступ к функциям плагина регулируется набором прав. Базовое право ultimateteams.player открывает доступ к основным функциям. Для работы с GUI и управлением командой требуются права ultimateteams.team.gui и ultimateteams.team.create. Управление командами требует специфических прав: ultimateteams.team.rename, ultimateteams.team.warp, ultimateteams.team.setwarp, ultimateteams.team.delwarp, ultimateteams.team.disband, ultimateteams.team.invite.send, ultimateteams.team.invite.accept, ultimateteams.team.invite.deny. Управление домашними местами и врагами/союзниками также требует соответствующих прав: ultimateteams.team.sethome, ultimateteams.team.delhome, ultimateteams.team.home, ultimateteams.team.pvp, ultimateteams.team.enemy.add, ultimateteams.team.enemy.remove, ultimateteams.team.ally.add, ultimateteams.team.ally.remove. Управление чатом и командой требует прав ultimateteams.team.leave, ultimateteams.team.kick, ultimateteams.team.list, ultimateteams.team.transfer, ultimateteams.team.prefix, ultimateteams.team.info, ultimateteams.team.promote, ultimateteams.team.demote, ultimateteams.team.echest, ultimateteams.team.permissions.add, ultimateteams.team.permissions.remove, ultimateteams.allychat, ultimateteams.teamchat. Экономические действия требуют прав ultimateteams.team.deposit, ultimateteams.team.withdraw, ultimateteams.team.invites.enable, ultimateteams.team.invites.disable, ultimateteams.team.fee.see, ultimateteams.team.fee.set, ultimateteams.team.fee.disable.

Административные права

Администраторы получают расширенный набор прав для полного контроля над сервером. Ключевые права включают ultimateteams.admin.about, ultimateteams.admin.reload, ultimateteams.admin.migrate, ultimateteams.admin.team.disband, ultimateteams.admin.team.join. Для управления эндер-сундуками администраторы имеют права ultimateteams.admin.echest.add, ultimateteams.admin.echest.remove, ultimateteams.admin.echest.list, ultimateteams.admin.echest.see, ultimateteams.admin.echest.rollback, ultimateteams.admin.echest.backup. Также доступны права на обход ограничений (bypass) для дружественного огня, охлаждения домашних мест, чата и телепортаций (ultimateteams.bypass.pvp, ultimateteams.bypass.homecooldown, ultimateteams.bypass.chatcooldown, ultimateteams.bypass.warpcooldown). Для наблюдения за чатом доступна команда ultimateteams.chat.spy.

Ограничения и заметки

Плагин не поддерживает клиентскую сторону (client side unsupported). Он предназначен исключительно для серверов. Файл архива UltimateTeams-5.0.4.jar содержит 1257 файлов и весит 1.86 МБ. Плагин не использует миксины (mixins: false). При использовании кросс-серверной синхронизации необходимо правильно настроить брокер сообщений и базу данных в конфигурации. Для полноценной работы с эндер-сундуками и телепортацией рекомендуется использовать HuskHomes, так как плагин предоставляет для него специальный обработчик.