Fzzy Config

Fzzy Config - это многофункциональный конфигурационный движок для модов Minecraft, который работает на Fabric, Forge, NeoForge и Quilt. Если вы когда-нибудь мучились с ручным редактированием TOML-файлов или писали собственные экраны настроек - этот мод для вас. Он берёт на себя всю рутину: от парсинга до генерации интерфейса.

Что это и зачем нужно

В ванильном Майнкрафт конфигов как таковых нет - всё зашито в коде. Но моды добавляют сотни опций: от баланса мобов до сложности крафта. Раньше каждый автор мода писал свой велосипед: кто-то делал GUI через Mixin, кто-то - текстовые файлы с непонятными ключами. Fzzy Config решает эту проблему раз и навсегда.

Основные фишки

• Автоматическая сериализация в TOML - никаких JSON или ручных парсеров. Просто объявил поля - и готово.
• Минимальный API - подключил библиотеку, добавил пару аннотаций, и конфиг работает. Не нужно писать билдеры экранов или регистрировать что-то вручную.
• Генерация GUI на лету - интерфейс настроек создаётся автоматически на основе структуры твоего конфига. Кнопки, ползунки, выпадающие списки - всё из коробки.
  • Полная поддержка клавиатурной навигации и скринридеров - проверено незрячим моддером.
  • ModMenu и Catalogue подхватываются автоматически, без лишних телодвижений.

Синхронизация - киллер-фича

• Автоматическая синхронизация сервер-клиент - настройки с сервера передаются игрокам без дополнительных плагинов.
• Можно отправлять живые обновления конфига прямо с клиента на сервер.
• Или наоборот - форвардить свои настройки другим игрокам, чтобы у всех был одинаковый опыт.

Валидация и контроль

• Встроенная проверка значений - не только для чисел и строк, но и для сложных типов вроде тегов или идентификаторов.
• Можно жёстко ограничить, какие значения игрок может выбрать: например, только определённые биомы или мобов.
• Автоматические подсказки для полей с тегами - удобно, когда не помнишь точное название.

Обновления и гибкость

• Версионирование конфигов - реализуешь один метод, и старые настройки автоматически подтягиваются при обновлении мода.
• Можно импортировать конфиги из других библиотек - полезно, если переезжаешь на Fzzy Config с Cloth Config или аналогов.
• Работает как с простыми Java/Kotlin-объектами, так и с продвинутыми настройками в стиле GameOptions.
• Единый API для всех загрузчиков - Fabric, Forge, NeoForge, Quilt. Включает лёгкую сетевую библиотеку для мульти-лоадера.

Кому пригодится

В первую очередь - мододелам. Если ты пишешь мод и хочешь дать игрокам удобные настройки без лишнего кода - Fzzy Config сэкономит часы работы. Для обычных игроков польза косвенная: моды с этой библиотекой будут иметь понятный интерфейс настроек и меньше багов с синхронизацией.

Скачай Fzzy Config и добавь в папку mods - библиотека сама подхватится всеми совместимыми модами. Ничего настраивать не нужно, всё работает из коробки.