- Документация
- https://modrinth.com/mod/donutsell
DonutSell — это серверный плагин для Minecraft, предназначенный для организации системы продажи предметов с использованием игровой экономики. Проект ориентирован на серверы, которым требуется удобная продажа ресурсов через графический интерфейс, поддержка истории операций и применение множителей стоимости. Концепция вдохновлена DonutSMP, однако плагин является самостоятельной реализацией.
Решение поддерживает современные серверные платформы Bukkit, Paper, Purpur и Spigot, распространяется по лицензии MIT и устанавливается как обычный серверный плагин. Основной функционал сосредоточен вокруг продажи предметов, управления ценами, настройки интерфейса и интеграции с серверной экономикой без необходимости изменять клиент Minecraft.
DonutSell представляет собой плагин экономической категории, который создаёт на сервере полноценную систему продажи предметов. Основная задача проекта — предоставить администраторам удобный механизм обмена игровых ресурсов на внутриигровую валюту с возможностью дальнейшей настройки поведения системы.
Плагин позволяет организовать продажу через GUI, вести историю операций, использовать множители стоимости и изменять внешний вид интерфейсов без изменения клиентской части игры. Все основные возможности работают на стороне сервера.
Среди подтверждённых возможностей плагина можно выделить несколько наиболее важных функций.
• создание серверной системы продажи предметов;
• поддержка истории продаж;
• использование множителей стоимости;
• настраиваемый графический интерфейс продажи;
• настройка сообщений и звуков;
• изменение заголовков, кнопок, расположения элементов и слотов GUI;
• хранение цен в отдельном файле prices.yml;
• сортировка предметов по стоимости или названию;
• поддержка компактного отображения больших чисел, например 1K, 1.2M, 3B или 1T;
• возможность добавления предметов в чёрный список;
• поддержка PlaceholderAPI для вывода цен;
• возможность использовать стандартную экономику через Vault либо отключить её и выполнять пользовательскую консольную команду для начисления средств.
Такой набор функций делает DonutSell удобным решением для серверов с развитой экономикой, магазинами и системой заработка игровой валюты.
После установки DonutSell начинает работать как серверная система продажи предметов.
Стоимость каждого предмета определяется данными из файла prices.yml. Согласно официальному описанию проекта, если цена для конкретного предмета отсутствует, используется значение по умолчанию, равное единице.
Во время продажи плагин рассчитывает итоговую стоимость, учитывает предусмотренные множители и выполняет начисление игровой валюты через выбранный механизм экономики. Если используется Vault, взаимодействие происходит через него. При отключении Vault администратор может использовать собственную консольную команду начисления средств, указанную в конфигурации.
История продаж позволяет просматривать выполненные операции через отдельный интерфейс.
DonutSell предназначен для серверной части Minecraft и официально поддерживает следующие платформы:
• Bukkit;
• Paper;
• Purpur;
• Spigot.
В метаданных выбранных файлов подтверждены Minecraft 1.21, 1.21.1–1.21.11, 26.1, 26.1.1, 26.1.2 и 26.2. Это перечень совместимости конкретных подготовленных версий, а не обещание поддержки будущих выпусков.
Плагин работает исключительно на стороне сервера. Установка каких-либо клиентских модификаций не требуется.
По официальным метаданным опубликованных версий обязательные зависимости проекта отсутствуют.
По умолчанию DonutSell использует Vault для взаимодействия с экономикой сервера. При этом разработчик предусматривает возможность отключения Vault и использования собственной консольной команды для выдачи игровой валюты.
Дополнительно заявлена поддержка PlaceholderAPI для отображения цен через плейсхолдеры.
Если конкретная конфигурация сервера использует дополнительные плагины экономики, необходимо ориентироваться на их совместимость и официальную документацию соответствующих проектов.
Установка выполняется стандартным способом для серверных плагинов Minecraft.
1. Скачайте подходящую версию DonutSell.
2. Остановите сервер.
3. Поместите файл плагина в папку plugins.
4. Запустите сервер.
5. При необходимости выполните первоначальную настройку файлов конфигурации.
В работе используются подтверждённые конфигурационные файлы config.yml и prices.yml. Детали их создания следует сверять с поведением выбранной версии после тестового запуска.
DonutSell предоставляет возможность адаптировать работу системы под особенности конкретного сервера.
Администратор может:
• изменить оформление GUI;
• настроить сообщения;
• изменить звуковое сопровождение;
• настроить интерфейс истории;
• изменить расположение элементов интерфейса;
• определить стоимость предметов;
• использовать сортировку по цене или названию;
• настроить работу экономики через Vault либо пользовательскую команду;
• использовать чёрный список предметов.
Согласно официальному описанию проекта, конкретные параметры конфигурационных файлов зависят от версии плагина. Подробная структура отдельных ключей официально не приводится, поэтому делать дополнительные выводы не следует.
Для управления системой предусмотрены подтверждённые команды:
• /donutsell
• /donutsell reload
• /donutsell item blacklist
• /donutsell item unblacklist
• /donutsell item set-price
• /sell
• /sellhistory
Иные команды официально не подтверждены.
Перед использованием DonutSell следует учитывать несколько особенностей.
Плагин предназначен исключительно для серверной части Minecraft и не устанавливается на клиент.
В официальных метаданных отсутствуют сведения о дополнительных обязательных зависимостях, кроме предусмотренной интеграции с Vault по умолчанию и поддержки PlaceholderAPI.
Также разработчик не публикует информацию о дополнительных механиках, расширенных сценариях автоматизации или иных функциях сверх официального описания. Поэтому подобные возможности нельзя считать подтверждёнными.
Для локализации доступны опубликованные версии:
• DonutSell 1.4;
• DonutSell 1.2.
Проект распространяется по лицензии MIT, что определяет условия использования и распространения исходного кода согласно тексту данной лицензии.
DonutSell работает на стороне сервера и не требует установки клиентских компонентов.
Подготовленные серверные файлы получены по официальному HTTPS, сверены по опубликованным контрольным суммам и прошли статическую проверку целостности и структуры JAR. Это подтверждает соответствие загрузки источнику, но не заменяет запуск в тестовой среде.
При этом отсутствуют подтверждённые сведения о динамическом тестировании конкретных файлов, поэтому утверждать прохождение такого тестирования нельзя.
Плагин создаёт систему продажи предметов на сервере Minecraft с поддержкой истории операций, множителей стоимости и настраиваемого графического интерфейса.
В метаданных выбранных файлов указаны Minecraft 1.21, все выпуски 1.21.1–1.21.11, а также 26.1, 26.1.1, 26.1.2 и 26.2.
DonutSell совместим с Bukkit, Paper, Purpur и Spigot.
Нет. По умолчанию плагин работает через Vault, однако разработчик позволяет отключить этот механизм и использовать пользовательскую консольную команду для начисления игровой валюты.
Стоимость предметов хранится в файле prices.yml. Если цена для предмета отсутствует, официальное описание указывает использование значения по умолчанию, равного 1.
Да. Плагин поддерживает чёрный список предметов. При попытке продажи такого предмета он возвращается игроку и не удаляется.
Да. Разработчик заявляет поддержку PlaceholderAPI для вывода стоимости предметов.
Нет. DonutSell является серверным плагином и устанавливается только на совместимый сервер Minecraft.
Решение поддерживает современные серверные платформы Bukkit, Paper, Purpur и Spigot, распространяется по лицензии MIT и устанавливается как обычный серверный плагин. Основной функционал сосредоточен вокруг продажи предметов, управления ценами, настройки интерфейса и интеграции с серверной экономикой без необходимости изменять клиент Minecraft.
Скриншоты и внешний вид
Что такое DonutSell
DonutSell представляет собой плагин экономической категории, который создаёт на сервере полноценную систему продажи предметов. Основная задача проекта — предоставить администраторам удобный механизм обмена игровых ресурсов на внутриигровую валюту с возможностью дальнейшей настройки поведения системы.
Плагин позволяет организовать продажу через GUI, вести историю операций, использовать множители стоимости и изменять внешний вид интерфейсов без изменения клиентской части игры. Все основные возможности работают на стороне сервера.
Основные возможности DonutSell
Среди подтверждённых возможностей плагина можно выделить несколько наиболее важных функций.
• создание серверной системы продажи предметов;
• поддержка истории продаж;
• использование множителей стоимости;
• настраиваемый графический интерфейс продажи;
• настройка сообщений и звуков;
• изменение заголовков, кнопок, расположения элементов и слотов GUI;
• хранение цен в отдельном файле prices.yml;
• сортировка предметов по стоимости или названию;
• поддержка компактного отображения больших чисел, например 1K, 1.2M, 3B или 1T;
• возможность добавления предметов в чёрный список;
• поддержка PlaceholderAPI для вывода цен;
• возможность использовать стандартную экономику через Vault либо отключить её и выполнять пользовательскую консольную команду для начисления средств.
Такой набор функций делает DonutSell удобным решением для серверов с развитой экономикой, магазинами и системой заработка игровой валюты.
Принцип работы
После установки DonutSell начинает работать как серверная система продажи предметов.
Стоимость каждого предмета определяется данными из файла prices.yml. Согласно официальному описанию проекта, если цена для конкретного предмета отсутствует, используется значение по умолчанию, равное единице.
Во время продажи плагин рассчитывает итоговую стоимость, учитывает предусмотренные множители и выполняет начисление игровой валюты через выбранный механизм экономики. Если используется Vault, взаимодействие происходит через него. При отключении Vault администратор может использовать собственную консольную команду начисления средств, указанную в конфигурации.
История продаж позволяет просматривать выполненные операции через отдельный интерфейс.
Совместимость
DonutSell предназначен для серверной части Minecraft и официально поддерживает следующие платформы:
• Bukkit;
• Paper;
• Purpur;
• Spigot.
В метаданных выбранных файлов подтверждены Minecraft 1.21, 1.21.1–1.21.11, 26.1, 26.1.1, 26.1.2 и 26.2. Это перечень совместимости конкретных подготовленных версий, а не обещание поддержки будущих выпусков.
Плагин работает исключительно на стороне сервера. Установка каких-либо клиентских модификаций не требуется.
Зависимости
По официальным метаданным опубликованных версий обязательные зависимости проекта отсутствуют.
По умолчанию DonutSell использует Vault для взаимодействия с экономикой сервера. При этом разработчик предусматривает возможность отключения Vault и использования собственной консольной команды для выдачи игровой валюты.
Дополнительно заявлена поддержка PlaceholderAPI для отображения цен через плейсхолдеры.
Если конкретная конфигурация сервера использует дополнительные плагины экономики, необходимо ориентироваться на их совместимость и официальную документацию соответствующих проектов.
Установка DonutSell
Установка выполняется стандартным способом для серверных плагинов Minecraft.
1. Скачайте подходящую версию DonutSell.
2. Остановите сервер.
3. Поместите файл плагина в папку plugins.
4. Запустите сервер.
5. При необходимости выполните первоначальную настройку файлов конфигурации.
В работе используются подтверждённые конфигурационные файлы config.yml и prices.yml. Детали их создания следует сверять с поведением выбранной версии после тестового запуска.
Настройка
DonutSell предоставляет возможность адаптировать работу системы под особенности конкретного сервера.
Администратор может:
• изменить оформление GUI;
• настроить сообщения;
• изменить звуковое сопровождение;
• настроить интерфейс истории;
• изменить расположение элементов интерфейса;
• определить стоимость предметов;
• использовать сортировку по цене или названию;
• настроить работу экономики через Vault либо пользовательскую команду;
• использовать чёрный список предметов.
Согласно официальному описанию проекта, конкретные параметры конфигурационных файлов зависят от версии плагина. Подробная структура отдельных ключей официально не приводится, поэтому делать дополнительные выводы не следует.
Команды
Для управления системой предусмотрены подтверждённые команды:
• /donutsell
• /donutsell reload
• /donutsell item blacklist
• /donutsell item unblacklist
• /donutsell item set-price
• /sell
• /sellhistory
Иные команды официально не подтверждены.
Ограничения
Перед использованием DonutSell следует учитывать несколько особенностей.
Плагин предназначен исключительно для серверной части Minecraft и не устанавливается на клиент.
В официальных метаданных отсутствуют сведения о дополнительных обязательных зависимостях, кроме предусмотренной интеграции с Vault по умолчанию и поддержки PlaceholderAPI.
Также разработчик не публикует информацию о дополнительных механиках, расширенных сценариях автоматизации или иных функциях сверх официального описания. Поэтому подобные возможности нельзя считать подтверждёнными.
Версии и лицензия
Для локализации доступны опубликованные версии:
• DonutSell 1.4;
• DonutSell 1.2.
Проект распространяется по лицензии MIT, что определяет условия использования и распространения исходного кода согласно тексту данной лицензии.
Безопасность
DonutSell работает на стороне сервера и не требует установки клиентских компонентов.
Подготовленные серверные файлы получены по официальному HTTPS, сверены по опубликованным контрольным суммам и прошли статическую проверку целостности и структуры JAR. Это подтверждает соответствие загрузки источнику, но не заменяет запуск в тестовой среде.
При этом отсутствуют подтверждённые сведения о динамическом тестировании конкретных файлов, поэтому утверждать прохождение такого тестирования нельзя.
FAQ
Для чего нужен DonutSell?
Плагин создаёт систему продажи предметов на сервере Minecraft с поддержкой истории операций, множителей стоимости и настраиваемого графического интерфейса.
Какие версии Minecraft поддерживаются?
В метаданных выбранных файлов указаны Minecraft 1.21, все выпуски 1.21.1–1.21.11, а также 26.1, 26.1.1, 26.1.2 и 26.2.
Какие платформы поддерживаются?
DonutSell совместим с Bukkit, Paper, Purpur и Spigot.
Обязательно ли использовать Vault?
Нет. По умолчанию плагин работает через Vault, однако разработчик позволяет отключить этот механизм и использовать пользовательскую консольную команду для начисления игровой валюты.
Где задаются цены предметов?
Стоимость предметов хранится в файле prices.yml. Если цена для предмета отсутствует, официальное описание указывает использование значения по умолчанию, равного 1.
Можно ли запретить продажу отдельных предметов?
Да. Плагин поддерживает чёрный список предметов. При попытке продажи такого предмета он возвращается игроку и не удаляется.
Поддерживается ли PlaceholderAPI?
Да. Разработчик заявляет поддержку PlaceholderAPI для вывода стоимости предметов.
Требуется ли установка на клиент?
Нет. DonutSell является серверным плагином и устанавливается только на совместимый сервер Minecraft.
