JasonConfig

Мод JasonConfig для Minecraft — библиотека для управления настройками модов

JasonConfig — это легковесная библиотека для модов Minecraft на платформе Forge, предназначенная для создания удобных и надёжных файлов конфигурации. В отличие от стандартных инструментов Forge, она использует формат JSON, что делает работу с данными более стабильной, особенно при хранении пустых списков или сложных объектов. Библиотека упрощает код разработчика, позволяя сохранять и загружать любые классы Java (включая Vec3 и кастомные записи), не требуя от игрока специальных знаний для редактирования настроек.

Библиотека для разработчиков

JasonConfig — это утилитарная библиотека, предназначенная исключительно для авторов модов на платформе Forge. Она предоставляет простой API для работы с конфигурацией на основе структуры JSON. Если вы являетесь обычным игроком, вам не нужно изучать документацию ниже: достаточно установить мод как зависимость для своих проектов. Библиотека не добавляет новые механики в игру напрямую, а служит инструментом для создания удобных файлов настроек в других модах.

Преимущества перед стандартной конфигурацией Forge

Основная цель JasonConfig — решить проблемы стандартной системы конфигурации Forge (YAML/TOML). Стандартные конфиги часто ломаются при попытке сохранить пустые списки и не поддерживают сериализацию сложных классов Java, таких как Vec3. JasonConfig использует JSON, что делает работу с данными более надёжной и расширяемой, позволяя корректно сохранять любые объекты Java без риска краха игры.

Ограничения и статус проекта

Несмотря на удобство, у библиотеки есть свои особенности. Формат JSON может быть менее читабельным для обычного пользователя по сравнению с текстовыми форматами вроде YAML. Также автор отмечает экспериментальный статус проекта: хотя критических багов пока не найдено, со временем могут обнаружиться ошибки, так как разработка ведётся одним человеком.

Примеры использования в коде

Библиотека предоставляет классы `Config`, `ConfigValue` и `ConfigComment`, которые позволяют легко объявлять настройки. В примере ниже показано, как создать конфиг, добавить комментарий и сохранить список значений, а также сложный объект `Vec3` и кастомный класс `Info`.

Интеграция в проект

Для использования JasonConfig в своём моде необходимо добавить его как зависимость в файл сборки. Доступно официальное хранилище CurseMaven. В коде сборки (Gradle) зависимость добавляется через стандартный синтаксис Maven, указывая соответствующую версию для нужной сборки проекта. Вся документация по API находится в пакете api внутри самого файла библиотеки и содержит подробные описания классов.

Связанные материалы

• YetAnotherConfigLib (YACL) — похожий мод
• Fzzy Config — похожий мод
• Forge Config Screens — похожий мод
• WorldEdit — похожий мод
• EMI Loot — похожий мод

Автор: Corrinedev · Лицензия: MIT