Donut Essentials

Donut Essentials — административный плагин для серверов Paper и Folia

Donut Essentials — это готовое к использованию решение для модерации и управления сервером, разработанное специально для Paper с поддержкой архитектуры Folia. Плагин объединяет в себе систему постоянных наказаний, блокировку по IP, инструменты для технического обслуживания, систему объявлений, функцию исчезновения (vanish), управление инвентарями, настраиваемые сообщения и безопасное планирование задач. Он предоставляет администраторам полный контроль над сервером через единый интерфейс команд и настроек.

Система наказаний и управление дисциплиной

Плагин предоставляет комплексную систему наказаний для повседневной модерации. Поддерживаются следующие типы наказаний: KICK, BAN, MUTE, WARN, NOTE, IP_BAN. Система работает как с постоянными, так и с временными наказаниями. Длительности временных наказаний могут быть указаны через парсер времени TimeParser, поддерживая настраиваемые токены формата времени, например #default.

Каждое наказание хранит следующую информацию: уникальный ID, тип наказания, целевой UUID, никнейм или IP-адрес, имя исполнителя, причину, время создания, время истечения (для временных наказаний), статус активности и статус скрытности. Модераторы могут создавать наказания, отменять их действие, редактировать причины, удалять записи из истории, просматривать активные наказания и листать историю наказаний игрока с помощью пагинации.

При включенной опции storage.persistence-enabled данные о наказаниях сохраняются в файле punishments.yml. Истечение временных наказаний обрабатывается через асинхронный планировщик Folia, что позволяет уведомлять персонал о завершении наказания.

Команды для управления наказаниями включают: kick, ban, mute, warn, note, banip, tempban, tempmute, tempwarn, tempipban, unban, unmute, unwarn, unnote, unpunish, change-reason, warns, notes, check, banlist, history. Для скрытых действий используется префикс -s (например, /kick -s), при этом сообщение о наказании видят только сотрудники с соответствующим правом доступа. При редактировании причин можно использовать шаблоны @layoutKey, а токены времени — #default, которые подставляются значениями из конфигурации time-layouts.

Блокировка по IP и защита аккаунтов

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

В процессе входа в игру проверяется IP-адрес, с которого происходит подключение. Если адрес не совпадает с разрешенным, вход блокируется, если у игрока нет права на обход блокировки. Настройка блокировки включает параметры ip-lock.enabled, ip-lock.log-blocked-attempts и ip-lock.kick-message. По умолчанию используется право доступа plugin.iplock.bypass для обхода блокировки. Данные о блокировках хранятся в файле ip-locks.yml.

Режим обслуживания и планирование

Плагин включает полноценную подсистему для режима обслуживания (Maintenance Mode), позволяющую безопасно ограничивать доступ к серверу. Возможности включают включение/выключение режима, создание списка исключений (whitelist), установку нескольких вариантов MOTD, планирование времени обслуживания с таймерами начала и окончания, автоматическое определение длительности, отмену таймеров и уведомления персонала о попытках входа. Права доступа для обхода и получения уведомлений также настраиваются.

Команды для управления режимом: maintenance on, maintenance off, maintenance reload, maintenance add , maintenance remove , maintenance whitelist, maintenance starttimer , maintenance endtimer , maintenance schedule , maintenance aborttimer, maintenance motd, maintenance setmotd . Таймеры позволяют запланировать окно обслуживания на будущее или установить время окончания текущей сессии.

Объявления и система вещания

Для информирования игроков доступна система вещания (Broadcast). Команда /broadcast [subtitle] отправляет полноэкранное объявление всем игрокам. Сообщения поддерживают форматирование MiniMessage, заголовки, подзаголовки и разделение заголовка и подзаголовка через символ |. Звуковые эффекты для объявлений настраиваются в конфигурации по ключам announcements.sound.*.

Инструменты для администрации: Vanish и InvSee

Функция Vanish позволяет сотрудникам скрываться из виду других игроков. Команда /vanish переключает статус. Сервис VanishService управляет видимостью, а слушатель AdminToolsListener защищает скрытых администраторов от взаимодействия с ними и нанесения урона. Состояние исчезновения восстанавливается при повторном входе игрока.

Инструмент InvSee позволяет просматривать и редактировать инвентари игроков. Команда /invsee открывает графический интерфейс (GUI) с 54 слотами, содержащий снимок инвентаря цели. Система безопасна для Folia: клонирование инвентаря выполняется через планировщик сущности цели, открытие GUI — через планировщик зрителя, а изменения зрителя записываются обратно при закрытии интерфейса. В GUI можно редактировать слоты инвентаря, экипировку и слот для предметов в руке.

Управление сообщениями и конфигурация

Сервис MessageService загружает настраиваемые сообщения из файла messages.yml. Файл копируется в папку данных плагина при первом запуске. Поддерживаемые функции: настраиваемый префикс, замена плейсхолдеров, сообщения об ошибках, сообщения об использовании и сообщения принудительного выполнения.

Плагин использует файлы конфигурации для хранения данных: punishments.yml для записей о наказаниях, ip-locks.yml для блокировок по IP и messages.yml для текстовых сообщений.

Для выполнения задач используется планировщик FoliaScheduler, который централизует отправку задач, дружественных к Folia. Доступные утилиты: runAsync, runAsyncTimer, runGlobal, runAtEntity. Файловый ввод-вывод и длительные операции выполняются асинхронно, а операции, связанные с игроками, запускаются через планировщик соответствующей сущности. Долговременные задачи и операции с файлами также делегируются асинхронно.

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

Плагин регистрирует широкий спектр команд для управления сервером. Полный список включает: kick, ban, mute, warn, note, banip, tempban, tempmute, tempwarn, tempipban, unban, unmute, unwarn, unnote, unpunish, change-reason, warns, notes, check, banlist, history, fssentials, systemprefs, vanish, offlinetp, playerlist, punishment, invsee, maintenance, broadcast, iplock. Точная справка и использование команд доступны через файл plugin.yml, а команда fssentials выводит настраиваемую справку из config.yml.

Система прав доступа (permissions) обеспечивает детальный контроль над функциями плагина. Основные права включают:

• fssentials.punish.kick — высылать игроков.
• fssentials.punish.ban — навсегда банить игроков.
• fssentials.punish.tempban — временно банить игроков.
• fssentials.punish.mute — блокировать чат игроков.
• fssentials.punish.tempmute — временно блокировать чат.
• fssentials.punish.warn — выдавать предупреждения.
• fssentials.punish.tempwarn — выдать временное предупреждение.
• fssentials.punish.banip — банить IP-адреса.
• fssentials.punish.tempipban — временно банить IP-адреса.
• fssentials.punish.unpunish — удалять наказания.
• fssentials.punish.change-reason — редактировать причины наказаний.
• fssentials.view.banlist — просматривать активные баны.
• fssentials.view.history — просматривать историю наказаний.
• fssentials.view.check — просматривать информацию о модерации игрока.
• fssentials.view.playerlist — просматривать списки игроков.
• fssentials.invsee — просматривать и редактировать инвентари.
• fssentials.vanish — переключать режим исчезновения.
• fssentials.admin.reload — перезагружать плагин.
• fssentials.admin.systemprefs — просматривать системные настройки.
• fssentials.maintenance.admin — полное управление режимом обслуживания.
• plugin.iplock.bypass — обходить блокировку по IP аккаунта.

Права на обход блокировки и получение уведомлений настраиваются через MaintenanceConfig.

Архив и совместимость

Плагин распространяется в виде файла donutessentials-2.0.0.jar размером 131 019 байт. Архив содержит 72 файла, из которых 45 являются класс-файлами. В архиве отсутствуют миксины и встроенные JAR-файлы.

Плагин совместим со следующими платформами сервера: Bukkit, Folia, Paper, Purpur, Spigot. Поддерживаемые версии игры включают 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, а также версии 26.1, 26.1.1, 26.1.2, 26.2, 26.3. Плагин требует серверную среду и не предназначен для клиента. Зависимости от других плагинов отсутствуют. Плагин имеет лицензию Apache-2.0. В архиве не обнаружены русскоязычные ресурсы.

Связанные материалы

• Free Minecraft Models — похожий плагин
• Worlds — похожий плагин

Автор: NAIZO · Лицензия: Apache-2.0