Recipe Modification library

Recipe Modification library — это инструмент для разработчиков, позволяющий автоматически применять изменения к рецептам в Minecraft при запуске игры.

Recipe Modification library не добавляет новые предметы или механики в игру. Она служит инструментом для создателей модпаков, разработчиков данных (data pack creators) и других авторов модов, которым нужно гибко управлять рецептами. Основная функция — автоматическое применение произвольных изменений ко всем рецептам в игре в момент её запуска.

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

Существует два основных способа взаимодействия с библиотекой. Рекомендуемый метод — использование файлов JSON в datapack, где вы описываете правила изменений. Альтернативный вариант — использование Java API для более сложной интеграции.

Мод не работает на стороне клиента. Он необходим только на сервере.

{
  "target_recipes": "#minecraft:buttons",
  "modifiers": [
    {
      "type": "modify_result_item",
      "function": "set_count",
      "count": 8
    }
  ]
}

Примером может служить ситуация, когда вы хотите, чтобы все рецепты кнопок выдавали по 8 предметов вместо одного, считая стандартный рецепт «обманом».

Другой полезный кейс — исправление проблем совместимости, когда рецепты одного мода не работают корректно из-за отсутствия стандартных тегов или ошибок в их использовании. Библиотека позволяет сделать такие рецепты совместимыми с аналогичными предметами из других модов, не переопределяя каждый рецепт вручную.

{
  "target_recipes": {
    "type": "namespace_equals",
    "namespace": "mod_xyz"
  },
  "modifiers": [
    {
      "type": "add_alternative",
      "ingredients": "mod_xyz:copper_nugget",
      "alternative": {
        "tag": "c:copper_nuggets"
      }
    }
  ]
}

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