Extended Interactions

Обозначения в таблице

Все кастомные взаимодействия представлены json-файлами в директории <.minecraft>/config/extended-interactions/custom. Просто создай там файл и заполни его следующим образом:

{
    "icon": {
        "id": "minecraft:diamond"
    },
    "blocks": [],
    "entities": [],
    "actions": []
}

Имя файла должно соответствовать регулярке [a-z][a-z0-9_]+\.json. ID этого взаимодействия будет именем файла без суффикса .json.

Иконка взаимодействия задаётся в свойстве icon. Используется тот же формат, что и у результата рецепта#crafting_shapeless).

Моменты, когда это взаимодействие доступно, задаются свойствами blocks и entities в следующем формате:

{
    "subject": "<block/entity identifier>".
    "if": [<list of conditions>]
}

Чтобы цель такого типа совпала, должны совпасть все условия в свойстве if. Условия форматируются так:

// Условия для блоков
{
    // Опционально. Мапа свойств blockstate на значения
    "state": {
        "waterlogged": "true"
    },
    // Опционально. NBT для совпадения
    "nbt": {
        "CustomName": "Intersting block"
    },
    // Опционально. Chat component (https://minecraft.wiki/w/Text_component_format) для показа, если это условие не выполнено
    "message": "Block must be waterlogged"
}

// Условия для сущностей
{
    // Опционально. NBT для совпадения
    "nbt": {
        "Sitting": true
    },
    // Опционально. Chat component (https://minecraft.wiki/w/Text_component_format) для показа, если это условие не выполнено
    "message": "Fox must be sitting"
}

То, что произойдёт, если это взаимодействие сработает, задаётся свойством actions. Вот все поддерживаемые действия:

// С 1.1.0
// Выполнить чат-команду на стороне сервера
// Команда выполняется от имени цели взаимодействия. (@s — это блок или сущность, на которую смотрел игрок при открытии радиального меню)
// Чтобы обратиться к игроку, запускающему взаимодействие, используй @ei:user
{
    "type": "extended_interactions:command",
    "cmd": "item replace entity @s weapon.mainhand with minecraft:totem_of_undying"
}

// С 1.1.0
// ПКМ предметом в руке
// Это действие автоматически проверяет, что у игрока есть предмет,
// соответствующий указанному предикату. Если у игрока его нет, показывается следующее сообщение
// {"translate":"extinter.extended_interactions.custom/<interaction id>.no_item"}
{
    "type": "extended_interactions:use_item",
    // Предикат предмета (https://minecraft.wiki/w/Advancement/Conditions/item)
    "item": {
        "items": ["minecraft:shears"]
    }
}

// С 1.1.0
// Активировать майнкрафтовую клавишу на стороне клиента
{
    "type": "extended_interactions:key",
    // Идентификатор клавиши (https://minecraft.wiki/w/Controls#Configurable_controls)
    "key": "key.drop"
}

// С 1.1.0. Требуется MaFgLib
// Активировать клавишу MaFgLib
{
    "type": "extended_interactions:mafglib",
    // Название категории, к которой относится эта клавиша
    "category": "Generic hotkeys",
    // Идентификатор клавиши MaFgLib
    "keybind": "openGuiConfigs"
}

// С 1.1.0. Требуется MaLiLib
// Активировать клавишу MaLiLib
{
    "type": "extended_interactions:malilib",
    // Название категории, к которой относится эта клавиша
    "category": "Generic hotkeys",
    // Идентификатор клавиши MaLiLib
    "keybind": "openGuiConfigs"
}

Пользовательские взаимодействия именуются как [ключ языка](https://minecraft.wiki/w/Resource_pack#Language): `extinter.extended_interactions.custom/<interaction id>`.

### Пример. Стрижка овцы
`<.minecraft>/config/extended-interactions/custom/shearing.json:`
```json
{
    "icon": {
        "id": "minecraft:shears"
    },
    "blocks": [],
    "entities": [
        {
            "subject": "minecraft:sheep",
            "if": [
                {
                    "nbt": {"Sheared": false},
                    "message": {"translate": "extinter.extended_interactions.custom/shearing.no_wool"}
                }
            ]
        }
    ],
    "actions": [
        {
            "type": "extended_interactions:use_item",
            "item": {
                "items": ["minecraft:shears"]
            }
        }
    ]
}

`/assets/lang/en_us.json`:

{
    "extinter.extended_interactions.custom/shearing": "Collect wool",
    "extinter.extended_interactions.custom/shearing.no_item": "You need a shears",
    "extinter.extended_interactions.custom/shearing.no_wool": "No wool to collect"
}