JasonConfig

JasonConfig - это библиотечный мод для Майнкрафт, который не добавляет контента в игру напрямую. Его задача - дать разработчикам простой и гибкий API для создания конфигов (файлов настроек), используя JSON вместо стандартного TOML. Если вы обычный игрок - просто установите мод, о деталях можете не беспокоиться. Но если вы делаете свои моды на Fabric, стоит присмотреться.

Зачем это нужно

В ванильном Майнкрафте или с Forge у конфигов есть свои проблемы: TOML-формат не любит пустые списки, а некоторые классы Java (вроде Vec3) вообще не поддерживаются. JasonConfig решает это, используя JSON - более гибкую и надёжную структуру данных. Для разработчика писать конфиги становится проще, а вероятность багов - меньше.

Что умеет JasonConfig

• Работа с JSON - вместо TOML, что даёт больше гибкости.
• Поддержка сложных типов - Vec3, списки, вложенные объекты (например, LinkedHashMap). В Forge такое либо невозможно, либо требует костылей.
• Простой API - создаёте класс, объявляете поля и вызываете register(). Похоже на Forge Config, но без ограничений.
• Комментарии в конфиге - можно добавить пояснения прямо в JSON-файл.

Плюсы и минусы vs Forge Config

Из плюсов:

• JSON надёжнее: не ломается на пустых списках.
• Поддерживает больше типов: Vec3, Map, Record-классы.
• Писать проще, но стиль похож на Forge.

Минусы:

• JSON чуть сложнее читать обычным игрокам.
• Библиотека экспериментальная - баги могут вылезти, но пока автор их не нашёл.

Как подключить (для разработчиков)

Используйте CurseMaven. В build.gradle добавьте зависимость вроде:

implementation "curse.maven:jasonconfig-123456:9876543"

(актуальные версии смотрите в файлах мода на CurseForge).

Пример конфига есть в пакете api - там же документация. Всё стандартно: объявляете Config, потом ConfigValue с типом (через TypeToken), и в конце вызываете register(). Не забудьте вызвать init() в главном классе вашего мода.

Вердикт

Для разработчиков, кто устал от ограничений Forge Config - JasonConfig неплохая альтернатива. JSON спасает там, где TOML тупит. На стабильность пока рассчитывать рано, но для тестов и небольших проектов - норм. Скачайте мод JasonConfig, если хотите упростить себе работу с конфигами в Minecraft.