Donut Team - плагин команд для SMP серверов

Donut Team - плагин для Minecraft, который добавляет на сервер полноценные команды игроков. Штука не для одиночной игры, а именно для SMP: когда на сервере двадцать человек и половина хочет жить вместе, без нормальной системы команд начинается бардак из табличек, сундуков с подписями и договорённостей в общем чате. Вот эту проблему Donut Team и закрывает.

По сути это компактный командный слой: создал команду, позвал друзей, обзавёлся общим домом и спокойно живёшь. Если вы держите SMP или только планируете, плагин стоит держать в голове как один из кандидатов - особенно если сервер крутится на Folia.

Что умеет Donut Team

Главное меню открывается командой /team, и это не просто список команд в чате, а нормальный инвентарный интерфейс. Через него создают команду, смотрят состав, редактируют права, принимают приглашения, телепортируются домой и переключают PvP между своими.

Ключевые механики такие:

• Жизненный цикл команды - создать, пригласить, вступить, выйти, выгнать, передать лидерство и распустить с подтверждением.
• Командный чат - /team chat включает режим чата только для своих, а /team chat <сообщение> отправляет одну строку с поддержкой MiniMessage.
• Общий дом - одна точка на команду: /team sethome, /team home, /team delhome. Телепорт с задержкой и отменой при движении.
• Friendly fire - /team pvp отключает урон между сокомандниками, причём и ближний бой, и снаряды.
• Права участников - владелец выдаёт invite, kick, home, sethome, speak и pvp. По умолчанию рядовой участник может только писать в чат.
• Лимит на лайт-версию - 8 человек на команду через donutteams.slots.8.

Чат-алиасы для тех, кто любит печатать быстро: /teams, /dt. Админский вариант - /dteams.

Интерфейс вместо заучивания команд

Обычно подобные плагины заставляют держать в голове десяток команд и их аргументы. Здесь с этим проще: /team без аргументов открывает меню, и дальше тыкаешь по слотам. Создание, список участников с редактором прав, ожидающие приглашения, инфо о команде, дом, friendly fire и настройки - всё в одном инвентаре.

Для админов это тоже плюс. Новый игрок заходит на сервер, ему не нужно объяснять синтаксис - он открыл меню и разобрался сам. Меньше тикетов в духе "а как вступить в команду".

Команды

Команда	Кто может	Что делает
/team	участник	Открыть меню команды
/team create <имя> [тег]	право create	Создать команду. Тег по умолчанию равен имени
/team disband confirm	владелец	Распустить команду после подтверждения
/team invite <игрок>	право invite	Пригласить игрока онлайн
/team join <команда>	приглашённый	Принять приглашение по имени команды
/team leave	участник	Выйти. Владелец сначала передаёт лидерство или распускает команду
/team kick <игрок>	право kick	Выгнать участника
/team info [команда]	любой	Обзор команды
/team chat [сообщение]	право speak	Включить командный чат или отправить строку
/team home	право home	Телепорт на общий дом
/team sethome / /team delhome	право sethome	Поставить или убрать единственный дом лайт-версии
/team pvp	право pvp	Переключить friendly fire
/team transfer <игрок>	владелец	Передать лидерство
/donutteams reload	админ	Перезагрузить конфиг и сообщения

Права и плейсхолдеры

Базовые права donutteams.use, donutteams.create, donutteams.chat и donutteams.home включены по умолчанию. donutteams.admin доступен только операторам. donutteams.slots.8 - тот самый лимит из 8 мест.

Для PlaceholderAPI идентификатор donutteams. Если команды нет, вернётся none, а для чисел - 0. Доступны %donutteams_name% (алиасы team, team_name), %donutteams_tag%, %donutteams_count% (алиасы size, members), %donutteams_home_world% (алиасы homeworld, home) и %donutteams_leader% (алиас owner).

С этим добром удобно делать таб-листы, плашки над ником или любые скорборды, где хочется показать принадлежность игрока к команде.

Дом команды и friendly fire - что важно знать

В лайт-версии дома ровно один на команду. Это стоит учитывать заранее: персональные дома - отдельный продукт Nightbeam, в этот плагин они не входят. Если у вас большая команда строителей, которые хотят каждый свою базу - либо ведите всех в одну точку, либо смотрите в сторону Pro.

Телепорт на дом идёт с прогревом и отменяется при движении. Мелочь, но она реально спасает в PvP: без такой защиты игроки уходят с поля боя телепортом домой.

Friendly fire тоже работает аккуратно. Когда он выключен, урон между сокомандниками отменяется на регион-потоке жертвы - это важно для Folia, где неправильная работа с сущностями ломает сервер. Проверка не прыгает по регионам ради изменения атакующего, что как раз и убирает классические краши на Folia.

Хранение данных

По умолчанию - SQLite, файл plugins/DonutTeams/teams.db, работает сразу после установки, ничего настраивать не нужно. Для крупных сетей есть MySQL с пулом HikariCP. Таблицы: teams, members, invites, homes, settings. SQL выполняется в отдельном потоке, команды кэшируются в памяти.

Мой личный совет: не спешите на MySQL сразу. На одном сервере SQLite абсолютно спокойно тянет десятки команд, а лишний сервис в инфраструктуре - это лишняя точка отказа. MySQL включайте, когда плагин реально нужно расшарить между несколькими серверами.

Производительность и Folia

Это, пожалуй, самое интересное в проекте. Donut Team изначально писался под Folia, а не просто получил галочку совместимости. Здесь нет BukkitScheduler - используются сущностные, региональные и глобальные планировщики Folia. Плюс асинхронная работа с базой.

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

Плагин проверялся на Minecraft 1.20.x и 1.21.x, актуальный релиз 1.0.1 добавил поддержку 1.26.3 (сама Folia 1.26.3 на момент выхода ещё не была доступна). Заявлена работа на Bukkit, Spigot, Paper, Purpur и Folia.

Технические требования простые:

• сервер на Paper или Folia;
• Java 21;
• опционально PlaceholderAPI, LuckPerms, DonutCore и MySQL. Vault для лайт-версии не нужен вообще.

DonutCore - необязательный хук через рефлексию для сетевых отображаемых имён, подключается как soft-depend. Без него плагин работает.

Важный нюанс про установку

Проверьте сначала версию Java. Java 21 - это не рекомендация, а требование, и на старых сборках с Java 17 плагин просто не стартует. Вторая частая ошибка - смешивание с другими командными плагинами. Если на сервере уже стоит что-то свое для команд, конфликт прав и плейсхолдеров почти гарантирован.

Установка элементарная: кидаете DonutTeams-1.0.0.jar в папку plugins/, перезапускаете сервер, всё. SQLite подхватывается сам, дополнительных плагинов не нужно.

Кому подойдёт

Donut Team - это модуль экосистемы Nightbeam, который живёт рядом с Donut Auction, Orders, RTP и Shards. Это не попытка воссоздать DonutSMP целиком и не "всё в одном". Скорее аккуратная деталь для сборки собственного SMP.

Вам стоит взять Donut Team, если	Возможно, пройдите мимо, если
У вас SMP на Paper или Folia	Нужны персональные дома у каждого игрока
Хочется простую систему команд без конфиг-марафона	Сервер на старом Spigot без Paper
Важен красивый GUI, а не стены текста	Нужна мульти-серверная синхронизация прямо сейчас
Играете на Folia и боитесь крашей планировщиков	Уже стоит крупный плагин на команды

Pro-версия с синхронизацией через Redis, дополнительными слотами, домами и косметикой появится позже на BuiltByBit. Лайт-версия при этом самодостаточна для одного сервера - это полноценный командный слой, а не демо-огрызок.

Если хочется поиграть с друзьями на своём сервере, где такие команды реально нужны, плагин отлично встанет на хостинг вроде BungeeHost - там его можно поднять буквально в пару кликов. Скачать Donut Team и добавить на сервер - минутное дело, а сколько боли с организацией игроков он снимает, чувствуется уже на первой неделе.