Donut Orders

Donut Orders - это плагин для серверов Minecraft (начиная с версии 1.20), который решает старую проблему: как игрокам удобно продавать и покупать предметы друг у друга без громоздких магазинов сундуков и админских вмешательств. Идея простая - рынок заказов на покупку. Покупатель создает заказ, указывая предмет, количество и цену. Продавец видит все активные заказы, выбирает подходящий и моментально получает деньги, просто передав предметы через специальное GUI. Все средства резервируются сразу, никаких долгов и двойных трат - экономика остается честной.

Зачем это нужно? На серверах Майнкрафт часто бывает, что у одного игрока есть избыток алмазов, а другому срочно нужно продать незерит. С Donut Orders вы можете просто выставить заказ на покупку алмазов по рыночной цене, а другие игроки сами решат, выполнять его или нет. Плагин работает на Vault, то есть совместим с любой экономикой - EssentialsX, CMI и другими.

Как это работает

1. Покупатель открывает /orders, нажимает New Order, выбирает предмет в GUI, вводит количество и цену за единицу в чате.
2. Средства сразу блокируются - покупатель не может потратить то, чего нет.
3. Продавцы просматривают публичный рынок, выбирают заказ, перетаскивают предметы в интерфейс доставки и получают оплату на месте.
4. Если заказ выполнен не полностью, купленные предметы ждут в личном хранилище (stash), пока игрок не заберет их.
5. Заказы автоматически истекают через настроенное количество дней - неизрасходованные деньги возвращаются, а собранные предметы остаются в хранилище.

Возможности

Для покупателей

• Размещение заказов на любые материалы из списка разрешенных на сервере.
• Система эскроу - деньги резервируются при создании заказа, никаких двойных трат.
• Отслеживание статуса: Активен, Выполнен, Истек, Отменен.
• Виртуальное хранилище - доставленные предметы хранятся на сервере, даже если инвентарь полон.
• Защита от переполнения - если при получении предметы не помещаются, они выпадают под ноги.
• Отмена заказа в любой момент с возвратом остатка средств.
• Детальный просмотр заказа: прогресс, цена, срок и статус хранилища в одном GUI.

Для продавцов

• Просмотр всех активных заказов в постраничном GUI рынка.
• Интерфейс доставки на 45 слотов - принимаются только правильные предметы, несовместимые сразу отклоняются с сообщением.
• Частичное выполнение - можно передать столько предметов, сколько нужно, оплата идет за каждую единицу.
• Защита от дублирования - одновременные попытки выполнить один и тот же заказ обрабатываются последовательно на сервере.
• Лишние предметы автоматически возвращаются в инвентарь.

Экономика

• Работает через Vault - совместимость с любой экономикой (EssentialsX, CMI и др.).
• Опциональный налог на выплаты продавцам (настраивается в процентах, отключен по умолчанию) - помогает убирать деньги из экономики.
• Возврат средств точный, без округлений.

Администрирование и настройка

• /orders admin reload - горячая перезагрузка config.yml и messages.yml без перезапуска сервера.
• Настраиваемое максимальное количество заказов на игрока.
• Настраиваемый срок действия заказа (в днях).
• Список разрешенных материалов - контролируйте, какие предметы можно продавать.
• Все сообщения для игроков в messages.yml - полностью переводятся, поддерживают цветовые коды & и hex-цвета #RRGGBB.

Технические детали

• Полная поддержка Folia - планировщики используют регионизированные schedulers, работает и на обычном Paper/Spigot.
• SQLite + HikariCP - заказы сохраняются в локальную базу с WAL-режимом, внешняя БД не нужна.
• Асинхронный ввод-вывод - чтение и запись БД не блокирует главный поток или регионы.
• Все зависимости затенены и перегружены - никаких конфликтов classpath с другими плагинами.

Команды

Команда	Описание	Право доступа
/orders	Открыть ваши заказы (алиасы: /order, /market)	donutorders.use
/orders admin reload	Перезагрузить конфиг и сообщения	donutorders.admin

Права доступа

Право	По умолчанию	Описание
donutorders.use	Все игроки	Использовать /orders и весь GUI
donutorders.admin	Операторы	Доступ к админским подкомандам

Интерфейсы GUI

Экран	Назначение
Ваши заказы	Просмотр собственных заказов, статус и хранилище, отмена
Новый заказ	Выбор предмета, установка количества и цены через чат
Рынок	Постраничный список всех активных заказов других игроков
Доставка предметов	Сетка на 45 слотов для передачи предметов по выбранному заказу
Подтверждение доставки	Просмотр перед выполнением
Детали заказа	Полная информация о своем заказе с кнопками отмены и сбора
Забрать из хранилища	Получить все доставленные предметы из виртуального хранилища

Конфигурация

orders:
  max-per-player: 10        # Максимум активных заказов на игрока
  default-expiry-days: 7    # Дни до истечения невыполненного заказа
  tax-percent: 0.0          # Процент налога с выплаты продавцу (0 = выкл)

database:
  filename: donutorders.db  # Файл SQLite в папке плагина

allowed-materials:
  - DIAMOND
  - EMERALD
  - GOLD_INGOT
  - IRON_INGOT
  - NETHERITE_INGOT
  - COAL
  - LAPIS_LAZULI
  - REDSTONE
  - QUARTZ
  - AMETHYST_SHARD
  - GLOWSTONE_DUST
  - BLAZE_ROD
  - ENDER_PEARL
  - GHAST_TEAR
  - NETHER_STAR
  - ELYTRA
  - TOTEM_OF_UNDYING
  - SHULKER_SHELL
  - HEART_OF_THE_SEA
  - TRIDENT
  - OAK_LOG
  # ... и любое другое название материала из Bukkit

Требования

Требование	Версия
Paper / Folia	1.20+
Java	17+
Vault	Любая совместимая версия
Плагин экономики	EssentialsX, CMI или любой Vault-совместимый

Установка

1. Поместите DonutOrders-1.0.0.jar в папку plugins/.
2. Убедитесь, что Vault и плагин экономики установлены.
3. Запустите сервер - config.yml и messages.yml создадутся автоматически.
4. Отредактируйте allowed-materials и другие опции, затем выполните /orders admin reload.

Всё. Теперь на вашем сервере Майнкрафт появится удобный рынок заказов на покупку, который работает без лишних телодвижений. Если вы собираете сервер с экономикой - Donut Orders однозначно стоит скачать.