ItemFig

Что такое ItemFig

ItemFig - это простая библиотека для сохранения и чтения конфигов предметов в Minecraft Forge с использованием JSON. Если вы когда-нибудь пытались добавить собственное оружие с настраиваемым уроном или броню с изменяемой защитой, то знаете, как муторно вручную прописывать каждое значение в отдельном файле или коде. Эта библиотека решает именно эту проблему - вы задаёте дефолтные настройки, а ItemFig сам создаёт и обновляет JSON-файл конфига.

Идея не нова - автор CrazedAerialCable написал библиотеку с нуля, но вдохновлялся механикой Weaponworks 1.3. Кстати, оригинальную концепцию придумал моддер Lyof - у него есть крутые моды вроде Sortilege и Ends Phantasm. Если вам интересно, откуда ноги растут - гляньте их.

Что умеет ItemFig

• Читает и сохраняет значения конфигов в формате JSON - стандартный, удобный, человеко-читаемый формат.
• Автоматически воссоздаёт конфиг из значений по умолчанию, если файл был удалён - полезно, если игрок случайно стёр папку config.
• Автоматически добавляет недостающие записи для целых предметов - например, когда вы добавляете новый меч в мод, его настройки сразу появляются в конфиге.
• Автоматически обновляет поля у существующих предметов - скажем, вы решили изменить базовый урон у всех копий. ItemFig подтянет новые значения, не трогая остальное.
• Можно менять имя конфиг-файла и его расположение (в пределах папки config). Правда, расширение только json - это не критично, зато предсказуемо.

Что пока не умеет

Разработчик в курсе ограничений и думает, как их обойти в будущем:

• Пока всё сваливается в один файл - для маленьких модов это нормально, но для больших может быть тесновато.
• Путь до самого конфига не сменить - он всегда ложится в config/. Только имя файла внутри этой папки можно задать.

Зачем это нужно в Майнкрафт

В ванильном Майнкрафте все предметы жёстко прописаны в коде. Если ты мододел и хочешь сделать, например, набор мечей, урон которых можно менять через конфиг без перекомпиляции мода - ItemFig берёт эту рутину на себя. Игроки смогут сами настроить баланс под свой геймплей или под серверные правила. Особенно актуально для сборок с кастомным оружием, где каждый инструмент должен быть уникальным по характеристикам.

Библиотека работает на Minecraft Forge - так что если ты собираешь сборку на Фабрике, это не твой случай. Но для Forge-модов - отличный выбор, если не хочешь писать свои парсеры JSON с нуля.

Где скачать

ItemFig можно скачать с официальной страницы на CurseForge или Modrinth. Внутри - только jar-файл, кидаешь в папку mods и готово. Никаких дополнительных зависимостей не требует, кроме самого Forge.

Итог

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