Config Reconciler — умное обновление конфигов для Minecraft
Каждый, кто собирал или обновлял модпаки для Minecraft, знает, как больно терять свои настройки после очередного апдейта. Вы долго подбирали идеальные параметры генерации мира, балансировали сложность или настраивали клиент — а новая версия сборки просто перезаписывает всё файлом по умолчанию. Дополнение Config Reconciler решает эту проблему раз и навсегда.
Этот мод — настоящий подарок для авторов модпаков и их игроков. Вместо грубой замены конфигурационных файлов он аккуратно сравнивает три версии: предыдущие настройки по умолчанию из модпака, текущие изменения игрока и новые дефолты, которые приходят с обновлением. В результате независимые правки пользователя сохраняются, а конфликтующие значения по умолчанию остаются за игроком и записываются в отчёт для ручной проверки.
Основные возможности Config Reconciler
Мод умеет работать с JSON-объектами, Java .properties и подмножеством TOML на уровне отдельных ключей. Это значит, что если разработчик сборки изменил только один параметр, а вы трогали другой — обе правки объединятся без потерь. Вот что ещё умеет утилита:
- Консервативное слияние на уровне ключей для JSON, .properties и части TOML.
- Автоматические резервные копии перед внесением изменений.
- Текстовые и JSON-отчёты о каждом конфликте и обновлении.
- Режим сухого прогона (dry-run) для предварительного просмотра изменений без записи.
- Политика конфликтов KEEP_USER по умолчанию и опция KEEP_INCOMING для тех, кто хочет принимать новые значения.
- Полное отсутствие сетевых запросов и телеметрии — мод работает локально и приватно.
Неподдерживаемые или слишком сильно изменённые файлы просто остаются в версии игрока. Это безопасный подход: лучше ничего не менять, чем сломать чужую конфигурацию.
Поддерживаемые версии Minecraft и загрузчики
Дополнение доступно для трёх популярных загрузчиков модов. Для Fabric требуется только Fabric Loader 0.16.14 или новее, а вот Fabric API не нужен вовсе — это приятный бонус для тех, кто любит минимализм. Отдельные JAR-файлы подготовлены для Fabric, Forge и NeoForge, так что вы легко подберёте нужный вариант.
Список поддерживаемых версий впечатляет. Для Fabric это Minecraft 1.18.2, 1.19.2, 1.19.4, 1.20.1, 1.20.4, 1.20.6, 1.21.1, 1.21.4, 1.21.5, 1.21.8, 1.21.10, 1.21.11, а также версии 26.1.2 и 26.2. Forge-версия охватывает 1.18.2, 1.19.2, 1.19.4, 1.20.1 и 1.20.4. Для NeoForge доступны 1.20.6, 1.21.1, 1.21.4, 1.21.5, 1.21.8, 1.21.10, 1.21.11 и 26.x. Обратите внимание на требования к Java: для старых версий нужна Java 17, для диапазона 1.20.6–1.21.11 — Java 21, а для 26.x — Java 25.
Если вы пользуетесь лаунчером foxygame.net, то найдёте Config Reconciler в каталоге дополнений — установка происходит в один клик, а все зависимости и версии подбираются автоматически. Это особенно удобно, когда нужно быстро протестировать сборку на разных версиях игры.
Как установить Config Reconciler для Minecraft
Процесс установки предельно прост. Вам нужно скачать Config Reconciler, выбрав JAR-файл, соответствующий вашему загрузчику, и положить его в папку mods. Никаких дополнительных библиотек или API не требуется. После этого остаётся только запустить игру и убедиться, что мод подхватился.
Важно понимать: сам по себе мод не делает ничего, пока модпак не предоставит управляемые настройки по умолчанию. Если вы устанавливаете его в существующую сборку, сначала добавьте текущие дефолты — тогда отличающиеся файлы будут приняты при первом запуске. В следующих релизах модпака просто обновляйте файлы в папке defaults и при желании меняйте номер версии в pack-version.txt.
Настройка и структура папок
Правильная организация файлов — ключ к успешной работе. Все настройки по умолчанию должны лежать в config/config_reconciler/defaults/ с путями относительно папки config. Например, файл config/config_reconciler/defaults/example.json управляет целевым файлом config/example.json.
Критически важное правило: не отправляйте управляемый файл через обычные оверрайды лаунчера. Лаунчер перезапишет копию игрока до запуска Minecraft, и весь смысл мода потеряется. Файл должен существовать только в defaults, а Config Reconciler уже сам позаботится об обновлении целевой версии.
Все настройки самого мода генерируются в config/config_reconciler/reconciler.json. Там вы можете включить режим dryRun для предварительного просмотра, а также выбрать политику конфликтов. Отчёты сохраняются в .config-reconciler/reports/latest.txt и latest.json — их удобно анализировать после каждого обновления.
Ограничения альфа-версии
Стоит честно признать: это ранний релиз, и у него есть свои ограничения. Мод управляет только папкой config, но не трогает options.txt и серверные настройки в serverconfig. JSON-массивы обрабатываются как атомарные значения, а TOML-массивы таблиц и многострочные строки не сливаются, когда обе стороны различаются. Это не полный парсер TOML, поэтому сложные структуры могут остаться без изменений.
Файлы, превышающие лимит размера для слияния, остаются нетронутыми и без больших резервных копий. В игре нет редактора конфликтов или всплывающих окон — восстановление выполняется вручную из резервных копий при закрытой игре. Запись происходит атомарно для каждого файла, но не транзакционно для всех конфигов сразу. После изменения файлов рекомендуется перезапустить игру, так как другие моды могли закэшировать старые значения.
Помните, что отчёты и резервные копии могут содержать секреты из конфигурационных файлов. Прежде чем делиться ими с кем-либо, внимательно проверьте содержимое.
Лицензия и происхождение
Мод распространяется под лицензией MIT, а исходный код поставляется отдельно. Разработчик честно указывает, что проект создавался с использованием AI-ассистента, а аватар — это символическая иллюстрация слияния конфигураций, а не скриншот из игры. Config Reconciler — независимый проект сообщества и не имеет отношения к Mojang, Microsoft или CurseForge.
В лаунчере foxygame.net дополнение обновляется автоматически, поэтому вы всегда будете использовать актуальную версию Config Reconciler с поддержкой всех свежих сборок Minecraft. Это избавляет от ручной проверки обновлений и гарантирует совместимость с вашими любимыми модпаками.
В итоге Config Reconciler — это именно тот инструмент, которого не хватало многим авторам сборок. Он делает обновление модпаков безболезненным для игроков, сохраняя их личные настройки и одновременно доставляя новые дефолты. Попробуйте его в следующем обновлении своей сборки — разница будет заметна сразу.