SoulBuyer (Соулбайер)

Плагин для серверов Майнкрафт, который добавляет скупщика ресурсов с динамическим рынком, ротацией ассортимента и продажей через удобное меню. Игроки сдают предметы из инвентаря, получают серверную валюту или PlayerPoints, развивают категории ресурсов и могут пользоваться автопродажей и временными усилителями. В плагине есть русский язык: доступен файл lang/ru.yml, а язык можно выбирать по настройкам клиента или сервера.

Возможности

• Меню скупщика показывает доступные ресурсы, цену, коэффициент рынка, очки и количество предметов в инвентаре. ЛКМ продаёт все предметы выбранного вида, ПКМ открывает выбор количества.
• Есть фильтры категорий: руды, предметы с мобов, растения, блоки и прочее; сортировка по цене и очкам, страницы и кнопка продажи всех подходящих предметов.
• При частой сдаче одного ресурса его рыночный коэффициент и выплата снижаются до заданного предела. Если предмет перестают продавать, цена постепенно возвращается к обычной.
• Ассортимент скупщика выбирается из общего каталога и меняется по таймеру. В меню отображаются время до следующей смены, проданное за день и число доступных ресурсов.
• За продажи начисляются очки прогресса и опыт категорий. Уровни категорий и множители прав могут увеличивать доход.
• Магазин усилителей позволяет временно повысить личный множитель дохода, выплату за продажу или личный дневной лимит. Оплатой могут быть очки прогресса, валюта Vault либо PlayerPoints.
• Личные лимиты продажи по идентификатору предмета помогают защитить экономику от массового сбыта. Узлы LuckPerms могут увеличивать лимит.
• В режиме с двумя скупщиками обычное меню выплачивает валюту через Vault, а донатное — очки PlayerPoints. Для второго меню используются /donbuyer, /dbuyer, /ppbuyer и /donatesell.
• Поддерживается хранение данных в YAML, SQLite или MySQL; для сети серверов рынок синхронизируется через Redis. Данные о прогрессе, ценах, ротации и продажах сохраняются после перезапуска.
• PlaceholderAPI добавляет плейсхолдеры статистики: %soulbuyer_rotation_left%, %soulbuyer_rotation_seconds%, %soulbuyer_sold_today_money%, %soulbuyer_sold_today_points%, %soulbuyer_sold_today_stacks%, %soulbuyer_sold_alltime_money%, %soulbuyer_sold_alltime_points%, %soulbuyer_sold_alltime_stacks%, %soulbuyer_active_items%.

Команды

• /soulbuyer — открыть основное меню скупщика.
• /buyer, /sell, /sb, /rbuyer, /bs — настраиваемые псевдонимы основного меню.
• /donbuyer, /dbuyer, /ppbuyer, /donatesell — открыть скупщика с выплатой в PlayerPoints, если включён режим двух скупщиков.
• /soulbuyer admin reload — перезагрузить конфиги, интерфейсы и языковые файлы.

Права

• soulbuyer.use — обычный скупщик и продажа ресурсов.
• soulbuyer.donate — донатное меню с выплатой PlayerPoints.
• soulbuyer.admin — доступ к /soulbuyer admin reload.
• soulbuyer.autosell — автопродажа.
• soulbuyer.boosters — магазин усилителей.
• soulbuyer.limit.vip и soulbuyer.limit.premium — увеличенные дневные лимиты продажи.
• soulbuyer.multiplier.vip и soulbuyer.multiplier.premium — множители дохода; при нескольких правах применяется наибольший.

Настройка

Основные параметры находятся в config.yml: тип хранилища, экономика, рынок, ротация каталога, прогресс, усилители, дневные лимиты, автопродажа и язык. Предметы и базовые цены редактируются в items.yml, интерфейсы — в gui/, тексты — в lang/.

Для выбора языка используйте раздел locale в config.yml. locale-mode: CLIENT показывает игроку язык, соответствующий языку его клиента; locale-mode: SERVER задаёт общий язык через server-locale. Можно добавлять собственные файлы вида lang/<код>.yml.

Автопродажа настраивается игроком через кнопку с изумрудом в меню скупщика. Она может срабатывать при подборе предмета, открытии меню скупщика или открытии контейнера. В настройках выбираются категории и отдельные предметы, минимальная цена, уведомления и валюта выплаты в режиме двух скупщиков. ПКМ по кнопке автопродажи включает или выключает её.

Настройки игрока автопродажи в обычном хранилище имеют вид:

enabled=true
trigger=pickup
notify=actionbar
min-unit-price=0
payout=vault
categories=ores,mobs,plants,blocks,misc
disabled-items=bone,rotten_flesh

categories задаёт включённые категории, а disabled-items — исключённые из них идентификаторы предметов.

Требования

Для обычной экономики нужен Vault и совместимый плагин экономики. Если используется выплата только в PlayerPoints, требуется PlayerPoints, а Vault не нужен. MySQL и Redis требуются только для общей базы и рынка в сети серверов; PlaceholderAPI подключается по желанию. Плагин рассчитан на Paper и поддерживает Folia.