Patched - Мод для частичного изменения JSON файлов

Patched представляет собой инновационный мод, который открывает новые возможности для работы с JSON файлами в Minecraft. Вместо полной замены файлов, как это происходит в стандартной системе, Patched позволяет вносить точечные изменения в конкретные части JSON документов.

Основные возможности

С помощью этого мода вы можете:

• Добавлять или удалять элементы генерации мира в биомах
• Модифицировать условия получения достижений
• Настраивать таблицы лута, добавляя или убирая предметы
• Изменять рецепты крафта
• Применять массовые изменения ко всем файлам, соответствующим определенному шаблону
• Создавать условные модификации в зависимости от установленных модов или настроек конфигурации

Как это работает

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

{
  "op": "find",
  "path": "/features/6",
  "test": {
    "path": "",
    "value": "minecraft:ore_gravel"
  },
  "then": {
    "op": "remove",
    "path": ""
  }
}

Этот патч размещается в датапаке по пути data/minecraft/worldgen/biome с именем plains.json.patch.

Команды для диагностики

Мод включает несколько полезных команд для анализа состояния игры:

• /patched list packs - показывает список пакетов, содержащих патчи
• /patched list patches <pack> - отображает патчи из указанного пакета
• /patched dump patch <pack> <name> - показывает содержимое конкретного патча
• /patched dump file <name> - отображает файл с комментариями о внесенных изменениях

Оптимизация производительности

Для предотвращения проблем с производительностью Patched проверяет только те пакеты, которые явно указывают на использование патчей. Это достигается добавлением специальной секции в файл pack.mcmeta:

{
  "pack": {
    // ...
  },
  "patched": {
    "format_version": 1 // Указывает, что этот пакет использует Patched
  }
}

Совместимость и ограничения

Мод интегрируется в базовую систему загрузки ресурсов Minecraft, что обеспечивает совместимость с большинством других модов. Однако существуют некоторые ограничения для "объединенных" ресурсов, таких как теги, файлы языков, sounds.json и другие клиентские ресурсы - только пакет, предоставляющий эти ресурсы, может их патчить.

Также стоит отметить, что в версиях до 1.19.3 невозможно напрямую патчить ванильные биомы, поскольку они жестко закодированы в игре.