Modpack Config Updater: Инструмент для управления конфигурациями сборок

Modpack Config Updater представляет собой специализированный инструмент, который значительно упрощает процесс обновления модпаков для Minecraft. Основная проблема, которую решает этот мод, заключается в том, что при выпуске обновлений создателям сборок приходится заменять целые файлы конфигураций, что приводит к потере пользовательских настроек. Данное решение позволяет вносить точечные изменения в конкретные параметры, не затрагивая остальные настройки.

Принцип работы системы

Мод отслеживает версию сборки через специальный файл "modpack_version.txt". После установки обновления, при первом запуске игры, автоматически применяются все необходимые изменения конфигураций, после чего файл версии обновляется.

Организация конфигурационных изменений

Основной файл настроек находится по пути config/modpackconfigupdater/modpackconfigupdater.json:

{
  "overrides": [
    "example_version1",
    "example_version2", 
    "example_version3",
    "example_version4"
  ]
}

Каждый элемент в списке overrides соответствует названию версии и указывает на папку с таким же именем в директории config/modpackconfigupdater/overrides. В этих папках содержатся изменения для соответствующих версий.

Пример работы: Предположим, у вас есть файл config/mod_config.properties с содержимым:

properties1=value1
properties2=value2
properties3=value3

Если в версии example_version1 нужно изменить значение properties2 и добавить properties4, создается файл config/modpackconfigupdater/overrides/example_version1/config/mod_config.properties:

properties2=value42
properties4=value4

После первого запуска файл config/mod_config.properties будет обновлен:

properties1=value1
properties2=value42
properties3=value3
properties4=value4

Файл modpack_version.txt теперь будет содержать example_version1. При последующих запусках изменения этой версии не применяются повторно.

Обновление через несколько версий

Если пользователь пропускает несколько версий (например, переходит с example_version1 на example_version4), изменения всех промежуточных версий (example_version2 и example_version3) применяются последовательно перед применением изменений конечной версии.

Технические характеристики

Поддерживаемые форматы файлов

Мод работает со следующими расширениями файлов:

"json", "properties", "yml", "yaml", "txt", "conf", "cfg", "ini", "xml", "properties", "ini", "rc", "config", "settings", "pref", "env", "toml"

Обработка данных

Система поддерживает различные форматы данных, включая JSON, YAML и Properties. Форматы TOML и XML пока не реализованы, но они редко используются в конфигурациях модов. Поддержка JSON5 будет добавлена в ближайшее время.

Важно отметить, что способ интерпретации файла зависит от его содержимого, а не от расширения. Любой файл с поддерживаемым расширением проверяется и обрабатывается в соответствии с определенным форматом данных. Если файл невалиден, его формат не обрабатывается.

Внимание: На альфа-стадии разработки возможна потеря данных или повреждение файлов при некорректном слиянии. Рекомендуется проявлять осторожность.

Первый запуск и пример конфигурации

При самом первом запуске с установленным модом, когда отсутствуют файлы modpack_version.txt или папка config/modpackconfigupdater, автоматически генерируется и применяется пример конфигурации. На основе этого примера можно строить свои первые обновления.