Donut Mail

Donut Mail — плагин почтовой системы для серверов

Donut Mail — это плагин для серверов Minecraft, реализующий полноценную почтовую систему. Он позволяет игрокам обмениваться письмами даже при отсутствии онлайн, используя инвентарные интерфейсы. Плагин поддерживает кастомные купоны, гибкие настройки хранилища (YAML, SQLite, MySQL, HikariCP) и предоставляет API для интеграции с другими расширениями.

Основная функциональность

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

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

Кастомные купоны

Система поддерживает создание и отправку кастомных купонов (vouchers), которые игроки могут обменивать через почтовый сервис. Конфигурация купонов хранится отдельно, что позволяет администраторам настраивать их без изменения кода самого плагина. Примеры конфигурационных файлов для купонов доступны в архиве плагина (например, vouchers/example-voucher.yml), что упрощает создание собственных систем вознаграждений или предметов через почту.

Настройка хранилища данных

Donut Mail предлагает несколько вариантов хранения данных, чтобы администратор мог выбрать подходящий для своей инфраструктуры:

• YAML: Простое файловое хранилище, идеальное для небольших серверов и простых установок.
• SQLite: Локальная база данных, не требующая внешнего сервера.
• MySQL: Используется, когда предпочтительно внешнее хранилище.
• HikariCP: Поддерживает пулинг соединений для баз данных, требующих оптимизации.

Все настройки хранилища, включая выбор типа и параметры подключения, настраиваются в файле config.yml.

Интеграция и управление

Плагин предоставляет открытый API, позволяющий другим расширениям взаимодействовать с почтовой системой. Это открывает возможности для создания сложных игровых механик, связанных с перепиской. Управление доступом осуществляется через систему прав (permissions). Плагин поддерживает детализированные права доступа, например DonutMail.use, которые можно назначать игрокам через систему управления разрешениями сервера.

Фоновые задачи (background tasks) автоматически обрабатывают истечение срока действия писем и доставку уведомлений, поддерживая порядок в системе без необходимости ручного вмешательства.

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