Плагин DonutWorth 1.2

DonutWorth — серверный плагин для назначения цен предметам и их продажи через экономику Minecraft-сервера. Он включает таблицу стоимости, меню продажи, административное управление, чёрный список и показ цены. Категории: economy и equipment.

Для клиента указано unsupported, для сервера — required: игрокам JAR не нужен. Подтверждены Bukkit, Spigot, Paper, Purpur и Minecraft 1.21–1.21.10.

Назначение и возможности​

DonutWorth связывает предметы с числовой стоимостью и передаёт результат продажи в подключённую экономику. Администратор задаёт цены и ограничения.

Официально заявлены:

• собственная цена для игровых предметов;
• интерактивное меню продажи;
• административный GUI с пагинацией;
• чёрный список запрещённых к продаже предметов;
• перечитывание настроек без перезапуска сервера;
• показ стоимости при наведении;
• интеграция с экономикой через Vault.

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

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

Цены и пользовательская продажа​

В примере worth.yml содержит цены и общий множитель, позволяющий масштабировать набор. Баланс зависит от доступности ресурсов, других доходов и правил сервера.

Практический порядок подготовки цен:

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

Команда /sell открывает интерфейс продажи. Порядок обработки нестандартных свойств подробно не раскрыт, поэтому следует проверить стаки, позиции без цены, закрытие меню и начисление средств.

Административный GUI и чёрный список​

Административный GUI управляет ценами и поддерживает пагинацию. Настройки можно перечитать без остановки сервера, но ошибочная конфигурация от этого не становится безопасной.

Чёрный список исключает выбранные предметы из продажи. При его подготовке полезно учитывать:

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

Пример списка демонстрационный. Обработка зачарований, пользовательских названий, дополнительных данных и предметов других плагинов не описана и требует проверки.

Настройки и обновление данных​

Названы config.yml и worth.yml: первый содержит сообщения, звуки, параметры меню и чёрный список, второй — цены и общий множитель.

Практичный порядок изменения:

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

Примеры разработчика не являются универсальной экономической схемой; параметры должны соответствовать версии 1.2.

Экономика, Vault и ProtocolLib​

Экономика заявлена через Vault и совместимый провайдер, а показ цены при наведении связан с ProtocolLib. В структурированных метаданных обязательные project dependencies не указаны, но официальный раздел требований называет Vault и ProtocolLib обязательными. Поэтому отсутствие записей в метаданных не доказывает автономность JAR.

Перед внедрением версии 1.2 следует проверить:

• загружается ли DonutWorth без Vault;
• нужен ли ProtocolLib для всего плагина или отдельного отображения;
• какой экономический провайдер подключён к Vault;
• в каком порядке запускаются компоненты;
• какие сообщения появляются при отсутствии интеграции.

Схему зависимостей следует подтвердить документацией выпуска и тестовым запуском, не устраняя расхождение предположением.

Команды и права​

Предоставленный официальный текст подтверждает:

• /donutworth — основной вызов;
• /donutworth gui — административный GUI; право donutworth.gui; по умолчанию OP;
• /donutworth reload — перечитывание настроек; право donutworth.reload; по умолчанию OP;
• /donutworth version — просмотр версии; право donutworth.version; по умолчанию OP;
• /sell — интерфейс продажи; право donutworth.sell; по умолчанию доступно всем;
• /dw — алиас /donutworth.

Дополнительные подкоманды и права не подтверждены. Доступ следует проверить отдельно для игрока и администратора.

Совместимость и установка​

Подтверждены Minecraft 1.21–1.21.10 с перечисленными промежуточными выпусками, а также Bukkit, Spigot, Paper и Purpur. Другие версии утверждать нельзя.

Установка выполняется помещением DonutWorth-1.2.jar в папку plugins совместимого сервера. Рекомендуемый порядок:

• создать резервную копию;
• сверить ядро и версию Minecraft;
• подготовить экономические компоненты;
• поместить JAR в plugins;
• выполнить запуск в тестовой среде;
• проверить журнал, команды и права;
• испытать цены, чёрный список и продажу;
• только затем открыть функцию игрокам.

Отсутствие зависимостей в метаданных следует оценивать вместе с официальным описанием.

Файл, хеши и проверка​

Доступен DonutWorth-1.2.jar версии 1.2 размером 44 498 байт. SHA-512: bc48a8feccfd89f9c50bda5a4063e7f577554c83724f7ce7825e0577db075a9883fd475f37dab9e928f3808efdd46adfb3594187b5bbb54ef6f92d9bce979a3e. SHA-1: b48a3294aceb4fa3c0fe77506c06779ee3d69707.

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

Лицензия и границы выводов​

DonutWorth распространяется по лицензии MIT. При использовании, копировании или изменении следует соблюдать её условия и сохранять предусмотренное уведомление.

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

FAQ​

Нужна ли установка на клиент?​

Нет. Клиентская сторона обозначена как unsupported, серверная — как required. JAR устанавливает администрация.

Можно ли продавать любой предмет?​

Плагин позволяет назначать цены, но содержит чёрный список. Поведение предметов без цены и экземпляров с дополнительными свойствами нужно проверять отдельно.

Нужны ли Vault и ProtocolLib?​

Официальный текст связывает экономику с Vault, показ цены — с ProtocolLib, а в разделе требований называет оба компонента обязательными. Структурированные метаданные при этом не содержат mandatory project dependencies, поэтому для версии 1.2 требуется практическая проверка.

Можно ли обновить цены без перезапуска?​

Заявлена команда /donutworth reload с правом donutworth.reload; по умолчанию она предназначена для OP.

Какие версии Minecraft подтверждены?​

Подтверждены перечисленные выпуски от 1.21 до 1.21.10. Совместимость с другими версиями из предоставленных данных не следует.

Проводился ли динамический запуск?​

Нет. Выполнены получение по официальному HTTPS, сверка SHA-512 и SHA-1 и статическая проверка структуры и путей. JAR не запускался.