CustomItemGenerators

CustomItemGenerators - это аддон для Slimefun, который решает одну конкретную головную боль админов технических серверов: сделать свой генератор ресурсов без единой строчки Java-кода. Раньше для подобного приходилось либо искать похожий аддон и костылить под него конфиг, либо вообще писать свой. Тут же всё сводится к правке YAML-файла.

По сути это инструмент для тех, кто крутит тематический сервер Майнкрафт - выживание с экономикой, техномагию, индустриалку - и хочет, чтобы игроки добывали редкий ресурс не через стандартный Slimefun-крафт, а через собственную машину. Роль аддона здесь чисто утилитарная: расширить Slimefun там, где он сам по себе уже упирается в ограничения.

Что умеет плагин

Для каждого генератора в конфиге задаётся полный набор параметров:

• Тип блока - на чём будет стоять машина
• Имя и lore - как она отображается в инвентаре и подсказках
• Энергетическая ёмкость - сколько энергии машина хранит и тратит
• Рецепт крафта - как игрок её получит
• Список производимых предметов - что и в каком количестве выходит на выходе
• Энергозатраты и время производства - баланс под ваш сервер

Отдельный файл отвечает за отображение всех генераторов в GUI. Так что если стандартное меню кажется тесным, внешний вид можно перекроить под себя.

Совместимость и интеграция

CustomItemGenerators спокойно тянет предметы не только из ванильного Майнкрафт, но и из других Slimefun-аддонов. Это и есть его главная фишка: не нужно ограничиваться стандартным набором, можно ссылаться на любой зарегистрированный в Slimefun предмет. Если на сервере стоит что-то вроде ExoticGarden или других тематических дополнений, они прекрасно подцепятся.

В версии 1.1.0 от 3 ноября 2024 года появились валидаторы конфигов (защита от опечаток в YAML), событие производства для будущего API, MachineRegistry, а также корректная обработка генераторов с нулевым энергопотреблением. До этого добавляли рандомизацию результатов и настройку количества продукции - полезно, если хочется, чтобы из машины выпадало не ровно 5 изумрудов, а от 3 до 7.

Важные нюансы

Работает на Paper, версии Minecraft Java 1.20 - 1.20.6. Лицензия GPL-3.0-only, то есть форки и правки разрешены.

Совет из практики: если на сервере установлено много Slimefun-аддонов, сначала проверьте, что ID нужного предмета точно совпадает - опечатка в конфиге не всегда даёт явную ошибку, машина может просто молча ничего не производить. Валидаторы в 1.1.0 как раз частично это лечат, но глазами всё равно проверяйте.

Ещё момент: продумайте энергобаланс. Генератор с огромным выходом и минимальным потреблением энергии за пару дней обрушит экономику сервера - игроки начнут фармить алмазы пачками. Time production здесь не для красоты, ставьте его осмысленно.

Кому это надо

Если вы админ сервера на Slimefun и вам нужно добавить уникальный генератор под конкретную механику или под ваш модпак-концепт - CustomItemGenerators это закрывает за 10 минут настройки. Не нужен ни программист, ни отдельный плагин под каждый ресурс. Скачать CustomItemGenerators стоит тем, кто хочет гибко управлять добычей ресурсов на сервере, не ломая баланс.

По категориям проект попадает в Technology и Utility - это чисто серверная техническая утилита, для одиночной игры смысла мало.

Важно знать

Нужен ли игрокам этот аддон для игры на сервере? Нет. Ставится только на сервер, игрокам ничего качать не надо.

Подойдёт ли для Forge или Fabric? Нет. Это плагин для Paper-серверов на базе Bukkit API, с Fabric и Forge он не работает.

Можно ли делать машины, которые потребляют 0 энергии? Да, начиная с версии 1.1.0 эта ситуация обрабатывается корректно.