Плагин Shop DonutSMP 1.1.0

Shop DonutSMP — плагин автора dominik-kaspar-dev под лицензией MIT. Он переносит на собственный сервер формат магазина DonutSMP: главное меню категорий, отдельные торговые разделы и выбор количества перед покупкой. Проект относится к категориям economy и utility.

Магазин работает только на покупку. Для каждой позиции выбирается валюта Vault или PlayerPoints, а плагин проверяет баланс и свободное место. Клиентский JAR игрокам не нужен.

Назначение и модель работы​

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

Подтверждены:

• отдельные GUI категорий и магазинов;
• кнопки увеличения и уменьшения количества;
• валюта VAULT или PLAYERPOINTS для каждого товара;
• показ цены и валюты в описании;
• редактируемые сообщения;
• перечитывание настроек без перезапуска.

Аукцион, обмен между игроками и динамические цены в основе не указаны.

Скриншоты и внешний вид​

Аудитория и сценарии выбора​

Плагин рассчитан на владельцев серверов Minecraft 1.21.x, которым нужен централизованный магазин с визуальным интерфейсом и раздельным хранением ассортимента.

Он подходит, когда:

• сервер продаёт предметы игрокам, но не покупает их обратно;
• ассортимент удобно делить на категории;
• используются Vault, PlayerPoints или обе валюты;
• требуется менять заголовки, слоты, рамки и тексты;
• магазины удобнее хранить в разных YAML-файлах;
• правки нужно применять без перезапуска.

Для продажи предметов, рынка между игроками или иной валюты подтверждённых возможностей недостаточно.

Валюты и покупка​

Тип валюты задаётся отдельно для товара: VAULT либо PLAYERPOINTS. Перед выдачей плагин проверяет достаточность баланса и наличие места в инвентаре.

Vault и PlayerPoints указаны как soft-depend. Обязательные project dependencies в выбранных метаданных отсутствуют, но без нужной интеграции связанные с ней позиции отключаются. Плагин может загрузиться без обоих компонентов, однако товар не работает без провайдера выбранной валюты.

Каждый тип расчёта следует проверять отдельно: успешная покупка за Vault не подтверждает работу PlayerPoints и наоборот.

Интерфейс и файлы настроек​

Используются три группы файлов:

• config.yml — сообщения и GUI выбора количества;
• categories.yml — главное меню, категории и слоты;
• каталог shops — отдельные магазины и товары.

Для категорий заявлены настраиваемые размер, заголовок, слоты и рамка. Характерный заполнитель выполнен из серого стекла. В файлах магазинов задаются GUI, товары, цены, валюты и позиции. Разделение на множество файлов помогает не собирать весь ассортимент в одном документе.

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

Команды и разрешения​

Заявлены две команды:

• /shop — открыть магазин;
• /shop reload — перечитать конфигурацию.

Право shop.use относится к обычному доступу, shop.admin — к администрированию. Перед открытием магазина игрокам следует проверить, что игрок открывает GUI, но не может перезагружать настройки без административного права. Другие команды и разрешения не подтверждены.

Совместимость и стороны​

Подтверждены Minecraft 1.21–1.21.11. Выбранные метаданные перечисляют Bukkit и Purpur, а официальный текст называет проект Paper-плагином с целевой API 1.21.x. Конкретную сборку поэтому нужно проверять локально, не расширяя совместимость автоматически.

Сторона server отмечена как required, client — как unsupported. Официальное описание также указывает Java 17. JAR устанавливается только на сервер.

Установка и первичная настройка​

Подтверждённая процедура:

• сохранить резервную копию;
• поместить shop-donutsmp-1.1.0.jar в plugins;
• установить Vault и PlayerPoints, если нужны соответствующие валюты;
• один раз запустить сервер для создания файлов;
• отредактировать config.yml, categories.yml и каталог shops;
• применить правки через /shop reload;
• провести тестовую покупку.

В папке должен оставаться один JAR проекта. Если используется одна валюта, прежде всего нужна её интеграция; отсутствие второй отключит только связанные с ней позиции.

Проверка результата​

Начинать лучше с одной категории и одного тестового товара. Проверьте:

• открывается ли /shop;
• отображается ли категория в нужном слоте;
• ведёт ли она к требуемому магазину;
• видны ли цена и валюта;
• работает ли выбор количества;
• проходит ли покупка при достаточном балансе и свободном месте;
• выводятся ли сообщения при нехватке средств и места;
• проверена ли каждая используемая валюта;
• применяются ли правки после /shop reload;
• сохраняется ли результат после перезапуска.

JAR прошёл статическую проверку, но динамически не запускался. Поведение нужно подтвердить на конкретном сервере.

Ограничения​

Главное ограничение — режим buy-only: продажа не предусмотрена. Работоспособность товара также зависит от выбранной валютной интеграции.

Следует учитывать:

• клиентская установка не поддерживается;
• подтверждена только ветка 1.21.x;
• заявлены лишь Vault и PlayerPoints;
• дополнительные команды и форматы не подтверждены;
• успешная загрузка не доказывает работу всех товаров;
• согласованность категорий и магазинов проверяет администратор;
• производительность при конкретном объёме ассортимента не оценивалась.

Множество файлов описывает организацию настроек, а не гарантирует любую нагрузку.

Файл и контроль целостности​

Предоставлен shop-donutsmp-1.1.0.jar, версия 1.1.0, размер 72939 байт. SHA-512: 9eab72eafb8e9b3f36e94edacd71b5e9d60c6f9efb18e88bba6106152fe1cb29d9de07b62958207ce5142eace772947f4d0bdbc9733cc1e623ef10ad50136063. SHA-1: 2dcf7ba37d6a1998c277b70a1626c0bfb525cd43.

Файл получен по официальному HTTPS, локально сверен по опубликованным хешам и прошёл статическую проверку структуры и путей. Динамического запуска не было. Хеш подтверждает целостность файла, но не совместимость с любой средой.

Безопасное обновление и откат​

Перед обновлением сохраните JAR, config.yml, categories.yml и каталог shops. Заменяйте файл при остановленном сервере и не оставляйте несколько версий. После запуска проверьте категории, валюты, сообщения, выбор количества и покупку.

Для отката верните резервную копию JAR и настроек, затем повторите тест. В основе есть только версия 1.1.0; предыдущая сборка и правила миграции не указаны. Поэтому возврат зависит от собственной копии администратора, а совместимость будущих форматов нельзя предполагать.

Диагностика​

Разбирайте сбой по уровню:

• плагин не загрузился — проверить журнал, Java, версию и платформу;
• /shop не открывается — проверить shop.use;
• /shop reload недоступна — проверить shop.admin;
• категории нет — проверить categories.yml и связь с магазином;
• товар отключён — проверить интеграцию его валюты;
• покупка отклонена — проверить баланс и место;
• правки не видны — проверить перезагрузку и синтаксис YAML.

При сложной структуре оставьте одну категорию и один товар, затем возвращайте элементы по одному. Это помогает отделить общую несовместимость от ошибки конкретного файла.

Лицензия и авторство​

Автор — dominik-kaspar-dev. Канонический идентификатор лицензии — SPDX MIT. Локализация разрешена при соблюдении лицензии. При распространении изменённой версии нужно сохранять имя проекта, авторство и лицензионное уведомление. Редакционные выводы статьи не являются заявлениями автора.

FAQ​

Можно ли продавать предметы через Shop DonutSMP?​

Нет. Проект заявляет только покупку.

Обязательны ли одновременно Vault и PlayerPoints?​

Нет как обязательные project dependencies, но товару нужна интеграция выбранной валюты. Без неё позиция отключается.

Нужен ли JAR игрокам?​

Нет. Плагин устанавливается на сервер, клиентская сторона не поддерживается.

Где находятся основные настройки?​

Сообщения и селектор количества — в config.yml, категории — в categories.yml, магазины — в каталоге shops.

Можно ли применить изменения без перезапуска?​

Да. Для этого заявлена команда /shop reload с административным доступом.

Почему покупка не проходит?​

Нужно проверить валютную интеграцию, баланс, свободное место, права и сообщения сервера.