Описание плагина SoulRecycle:
SoulRecycle — это не «выкинул мусор в пустоту». Игрок открывает меню, кладёт предмет в воронку по центру — и сразу видит, что вернётся: слоты превью показывают ресурсы, стоимость и шанс успеха. Предмет смещается влево, вокруг — до четырёх иконок результата; лаймовый краситель подтверждает разбор. Закрыл через ESC — предмет вернётся в инвентарь.Правило ищется так: сначала ручные (recipes/overrides.yml + 13 встроенных исключений), затем при включённом auto-recipe-fallback — обратный разбор ванильного рецепта верстака. Нет правила — четыре барьера и отказ. Чёрный список (blacklist/materials.yml) блокирует переработку независимо от рецепта — звезда незера, яйцо дракона, элитры и т.д. уже там по умолчанию.
Policy в config.yml решает, что делать с «особенными» предметами. Зачарованные и переименованные — deny по умолчанию (можно allow или strip с предупреждением в lore). Повреждённые — три режима: deny (любой урон = отказ), scale-output (каждый ресурс × % оставшейся прочности, округление вниз) или allow (полный выход). На отдельное правило можно навесить min-durability-percent.
Комиссия за переработку — через Vault (softdepend). Нет Vault или vault-enabled: false — бесплатно. Право soulrecycle.bypass и OP снимают оплату. Скидки — ноды soulrecycle.discount.<N> по списку процентов в конфиге.
Админ: /recycle reload, постраничный /recycle list, /recycle test <MATERIAL> — что вернётся и с каким шансом. Reload подхватывает config, GUI, blacklist, overrides и messages.
Особенности плагина SoulRecycle:
- Из коробки — GUI, 13 ручных правил (netherite + chainmail), blacklist, policy, messages и auto-recipe с первого запуска
- Двухфазное GUI — воронка → превью → подтверждение; справка всегда на месте; тексты в messages.yml, слоты и материалы кнопок в gui/general.yml
- Auto-recipe fallback — нет ручного правила → разбор по ванильному shaped/shapeless крафту; комиссия из default-recycle-cost
- 13 встроенных исключений — netherite (кузня) и chainmail (нет рецепта верстака); остальное не дублируется в Java
- Ручные overrides — recipes/overrides.yml добавляет или перекрывает правила по id
- Policy прочности — deny / scale-output / allow; в превью предупреждение «Прочность N% — ресурсы уменьшены»
- Policy зачарований — deny / allow / strip (strip — разбор разрешён, в lore предупреждение о потере чар)
- Чёрный список — отдельный файл, EnumSet O(1); примеры rare/donate предметов уже в дефолте
- Vault-комиссия — списание до выдачи лута; при нехватке денег предмет не тратится; bypass для доната/админов
- Скидки LuckPerms — soulrecycle.discount.100 … soulrecycle.discount.5 по tier-списку в config
- Лимиты — cooldown между переработками и cap переработок в минуту на игрока
- Миры — blacklist миров в config; в них меню открывается, но разбор блокируется
- Шанс успеха — per-rule success-chance; при провале и return-on-fail: true предмет возвращается
- Anti-dupe — atomic claim входного предмета, lock на время обработки, блок shift/hotbar/drag в GUI
- InventoryHolder — GUI через holder, не по title; безопасное закрытие и возврат предмета
- Reload без рестарта — config, GUI, recipes, blacklist, messages, Vault hook
Команды плагина SoulRecycle:
Основная: /soulrecycle. Алиасы: /recycle, /recycler./recycle — открыть GUI переработки (игрок) /recycler — то же (алиас) /soulrecycle — то же (алиас) /recycle gui — открыть GUI /recycler gui — открыть GUI (алиас) /soulrecycle gui — открыть GUI (алиас) /recycle reload — перезагрузить config, GUI, blacklist, recipes, messages (OP) /recycle list — список правил, 10 на страницу (OP) /recycle list <страница> — конкретная страница списка (OP) /recycle test — превью разбора для материала (OP)
Алиасы наследуют подкоманды: /recycler reload = /soulrecycle reload.
Права плагина SoulRecycle:
soulrecycle.use — открыть GUI и переработать предмет (default: op) soulrecycle.bypass — не платить комиссию Vault (default: false)Скидки на комиссию (не в plugin.yml, проверяются по списку в config):
soulrecycle.discount.100 — скидка 100% soulrecycle.discount.75 — скидка 75% soulrecycle.discount.50 — скидка 50% soulrecycle.discount.25 — скидка 25% soulrecycle.discount.20 — скидка 20% soulrecycle.discount.15 — скидка 15% soulrecycle.discount.10 — скидка 10% soulrecycle.discount.5 — скидка 5%
При нескольких discount-нодах берётся первая подходящая сверху списка tier в config.
Админ-команды (reload, list, test) — только OP, отдельной permission-ноды нет.
Скриншоты плагина SoulRecycle:
Плэйсхолдеры плагина :
Установка плагина SoulRecycle:
Для экономики можете поставить Vault + плагин экономики по типу EssentialsX — опционально; без Vault комиссия не списывается (vault-enabled: true по умолчанию, но hook мягкий).- Скачайте плагин.
- Выключите сервер
- Переместите файл .jar в папку /plugins/ вашего сервера.
- Запустите сервер.
- Готово.
