MezzConfig

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

По сути, это типобезопасная (typed) система конфигурации, которая дает разработчикам модов единый API. Вместо того чтобы каждый автор изобретал велосипед с JSON или Properties-файлами, он берет MezzConfig и получает готовые инструменты для работы с настройками. А игроки и админы серверов получают предсказуемое поведение без багов в стиле "поменял в конфиге, а в игре не применилось".

Три уровня настроек - в чем фишка

Главная проблема конфигов в Майнкрафт - это разрозненность. Одни настройки должны быть глобальными для клиента, другие - уникальными для каждого мира, третьи - строго серверными. MezzConfig разделяет их четко:

• Shared client preferences - общие настройки клиента. Например, положение HUD-элементов или клавиши, которые не должны меняться при переходе между мирами.
• Per-world/per-server client settings - настройки, привязанные к конкретному миру или серверу. Полезно, когда на одном сервере вы хотите включить миникарту, а на другом - выключить.
• Server-owned configuration - серверные параметры, которые админ меняет на своей стороне, а они автоматически синхронизируются со всеми подключенными игроками. Никаких рассинхронов в духе "у тебя в конфиге true, у меня false".

Для модпаков это вообще спасение. Автор сборки может задать дефолтные значения, но игроки смогут переопределить отдельные параметры под себя без редактирования файлов вручную.

Технические возможности для разработчиков

Библиотека из коробки поддерживает валидацию значений. Это значит, что если в конфиге должно быть число от 1 до 100, а пользователь вписал "abc" или 9999, MezzConfig корректно обработает ошибку. Поддерживаются:

• числа (int, float, double с ограничениями диапазона)
• текстовые строки
• цвета (RGB/HEX)
• перечисления (enum)
• списки значений
• кастомные типы данных

Отдельно стоит отметить систему слушателей изменений (change listeners). Мод может реагировать на изменение конфига мгновенно, без перезагрузки мира. А если параметр критичен и требует рестарта - библиотека явно укажет это, избавляя игрока от головной боли "почему не работает".

Автоматическое обнаружение изменений файлов - еще одна киллер-фича. Вы правите конфиг в текстовом редакторе, сохраняете - и изменения подтягиваются в игру без перезахода. В последних версиях (актуальный релиз 0.5.9 от сентября 2026) пофиксили watcher-события, так что эта система работает стабильно даже при частых сохранениях.

Миграция и восстановление

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

Совместимость и установка

Библиотека доступна для Minecraft 1.21.1 под тремя загрузчиками: Fabric, Forge и NeoForge. Это не мод, который вы ставите ради контента - его требуют другие моды как зависимость. Если в описании мода указано "requires MezzConfig", просто скачайте соответствующую версию под ваш загрузчик и закиньте в папку mods.

Важный нюанс: MezzConfig регистрирует собственную schema настроек, что позволяет другим модам корректно интегрироваться с её API. Для игрока это прозрачно - просто работает.

Зачем это обычному игроку?

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

Для авторов модов это must-have инструмент, если вы не хотите писать свою систему конфигурации с нуля. Легковесный, типобезопасный, с поддержкой всех популярных загрузчиков.