YAML Config

Мод YAML Config для Майнкрафт - это мощная библиотека конфигурации, которая делает настройку модов простой и удобной. Кто из нас не тратил часы на ручное редактирование JSON или TOML файлов, пытаясь разобраться в структуре? YAML Config решает эту проблему, предлагая читаемый YAML формат и встроенный GUI для редактирования, причем прямо в игре, по нажатию клавиши F12.

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

В ванильном Майнкрафте нет встроенной системы управления настройками модов. Обычно каждый мод создает свой конфиг - кто в JSON, кто в TOML, кто как бог на душу положит. Это головная боль при сборке модпаков. YAML Config предлагает единый стандарт, который интуитивно понятен даже новичкам - YAML. Плюс к этому, он берет на себя синхронизацию настроек между сервером и клиентами.

Основные возможности

YAML формат

Человекочитаемый формат, где структура видна сразу. Не надо ломать глаза над скобками.

GUI интерфейс

По нажатию F12 открывается экран со всеми модами, у которых есть настройки через YAML Config. Выбираешь мод и видишь все его опции с описанием. Каждый параметр можно отредактировать, сбросить на дефолт и сохранить.

Поддержка типов данных

• Простые типы: boolean, int, float, double, String, ResourceLocation, Registry
• Коллекции: List, Map
• Дата и время: LocalDateTime
• И кастомные типы через свой сериализатор

Синхронизация клиент-сервер

Если на сервере что-то изменили в настройках, у клиентов это обновится автоматически. Без лишних телодвижений.

Три типа конфигов

• CLIENT - только для клиента, на сервер не летит
• SERVER - для сервера, на клиенты не синхронизируется
• COMMON - общие, можно редактировать с любой стороны

Для разработчиков

Если вы делаете свой мод, интеграция YAML Config займет буквально пару минут. Вам нужно:

1. Создать класс конфига
2. Объявить поля через ConfigBuilder
3. Вызвать build()

public class MyModConfig {
    public static IConfig config;
    public static IConfigEntry<Boolean> debug;

    public static void init() {
        ConfigBuilder builder = new ConfigBuilder("mymod", "mymod-config", ConfigExtension.YAML, ConfigType.CLIENT);
        debug = builder.defineBoolean("debug", false)
                .withComments("Включает режим отладки");
        config = builder.build();
    }
}

Потом в коде обращаетесь к настройкам через get() и set(). Все просто.

Что еще стоит знать

Мод весит совсем немного, не грузит игру, работает на Fabric/Forge/NeoForge под версии Minecraft 1.19-1.21. Подходит как для клиентской игры, так и для серверов. Если собираете свой модпак - это must-have для управления конфигами.

Скачайте YAML Config и забудьте про головную боль с редактированием конфигураций. Все будет работать из коробки, а GUI поймет даже тот, кто впервые запустил Minecraft.