Donut Auction - аукцион для сервера

Donut Auction - серверный плагин-аукцион для Minecraft в стиле DonutSMP. Он добавляет общий рынок, где игроки могут продавать ненужные ресурсы и находить нужные предметы, не обмениваясь ими вручную. Для экономического SMP это удобный способ оживить торговлю и дать игрокам понятное место для сделок.

Как устроен аукцион

Основной интерфейс открывается в виде меню на 54 слота. В нём можно просматривать лоты, переходить между страницами, сортировать товары по цене, выбирать категории и искать предметы по тексту. Есть ручное обновление списка и отдельный доступ к своим объявлениям. Предусмотрен и предпросмотр шалкеров.

Поиск и фильтры особенно полезны на сервере с большим рынком: вместо просмотра длинного списка игрок сразу сужает его до нужной категории или товара. Если меняете поиск, сортировку или фильтр, просмотр возвращается на первую страницу. В версии 1.5.2 также исправлена навигация по страницам и отображение номера страницы и общего количества лотов.

Плагин поддерживает быстрые покупки и продажи. Для работы с командами используются /ah, /auction и /ah sell <price>. Игроки могут выставлять предметы и управлять своими лотами прямо через интерфейс, без необходимости запоминать сложный синтаксис.

Управление объявлениями

У каждого игрока есть список собственных лотов с разделением по статусам:

• Активные - объявления, которые ещё доступны для покупки.
• Проданные - завершённые сделки.
• Истёкшие - лоты, срок размещения которых закончился.

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

Экономика и настройки

Для денежных операций Donut Auction использует Vault и совместимые с ним экономические плагины. Например, можно подключить EssentialsX Economy или другой провайдер, зарегистрированный через Vault. Поддерживается также VaultUnlocked. Одного Vault недостаточно: на сервере должна быть установлена и настроена сама экономика.

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

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

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

Для крупного проекта или сети серверов предусмотрен MySQL с пулом соединений HikariCP. Выбор базы зависит от масштаба и устройства сервера: SQLite подойдёт для отдельного SMP, MySQL удобнее, когда аукциону нужна внешняя база данных.

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

DonutCore и сетевые серверы

Интеграция с DonutCore необязательна. Если этот компонент установлен, плагин может использовать сетевую систему отображаемых имён игроков. Без DonutCore аукцион продолжает работать штатно.

Для небольшой отдельной площадки достаточно стандартной схемы с SQLite. Если вы объединяете несколько серверов в сеть, MySQL рассчитан на более подходящий для такой установки сценарий хранения. Donut Auction создан для Paper и Folia; в актуальной версии 1.5.2 заявлена поддержка Minecraft 1.20.1-1.20.6, 1.21.x и 26.1.x-26.3.

Установка и требования

Поместите файл плагина в папку plugins сервера Paper или Folia и запустите сервер, чтобы создать конфигурацию. Для покупок и продаж установите Vault либо совместимый вариант, например VaultUnlocked, а также экономический плагин с работающим провайдером. DonutCore нужен только для интеграции отображаемых имён.

Перед запуском аукциона проверьте, что экономика доступна через Vault, а выбранная база данных настроена корректно. Иначе меню может открываться, но денежные операции не будут работать как задумано. Плагин также рассчитан на современную архитектуру Paper и поддержку Folia.

Технические сведения

• Серверная платформа: Paper и Folia.
• Версии Minecraft в актуальном контексте проекта: 1.20.1-1.20.6, 1.21.x и 26.1.x-26.3.
• Экономика: Vault-совместимый провайдер.
• База данных: SQLite по умолчанию или MySQL.
• Дополнительная интеграция: DonutCore, необязательно.
• Основа проекта: Java 17 и Maven.

Donut Auction решает конкретную задачу сервера: превращает торговлю между игроками в доступный внутриигровой рынок с поиском, фильтрами и управлением сделками. Он подойдёт владельцам экономических SMP, которым нужен аукцион с графическим интерфейсом, а игрокам позволит быстрее покупать и продавать ресурсы.