JsonPatcher

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

Важная информация о версии 2

На данный момент JsonPatcher v2 находится в стадии бета-тестирования. Новая версия добавляет множество функций, включая глобальные патчи для модов и модпаков. Документация доступна по адресу jsonpatcher-docs.mattidragon.dev, однако она пока неполная и частично устарела. В некоторых случаях лучше обратиться к старой версии вики.

Как использовать

Для начала работы с JsonPatcher достаточно создать файл с расширением .jsonpatch в директории data/<namespace>/jsonpatch вашего датапака или assets/<namespace>/jsonpatch ресурспака.

Рекомендуется начинать патч с мета-тега @version, который указывает совместимость с конкретной версией мода:

@version "1"

Далее необходимо указать целевые файлы для применения патчей с помощью мета-тега @target. Все мета-теги используют JSON-формат. Вы можете выбрать отдельный файл строкой, применить объект для более широкого выбора или использовать массив для множественного выбора - патч применится, если совпадёт любой из селекторов.

Сам процесс модификации файлов использует синтаксис, похожий на язык C. Для доступа к содержимому целевых файлов применяется символ $, который можно использовать как переменную или сразу указывать нужное свойство после него.

Более подробную информацию о языке патчинга можно найти в вики проекта.