Description

Abilities are set via the Ability Property and are used to control the right click behaviour of modular items.

WIP: the ability system is planned to be extended (mostly arround the ability property to add more functionality)

The Ability Property miapi:ability_context controls the abilities. This property uses a list of abilities. Each Ability has the following fields:

• id: an arbitrary id of this ability on this item. Used so other modules can interact with this ability
• type: the actual ability type
• priority: allows you to manipulate the order of abilities.
  Lower gets tested first.
  defaults to 0 if you for example set this to 1 this ability will execute after the ability of submodules/only if the submodule ability does not want to trigger(f.e. the submodule ability only interacts with blocks but you want to capture other right clicks)
• data: the data of your ability
• allowed_on_block: (default true) if it`s allowed on block interaction (stuff like axe right clicking or other tool actions)
• allowed_on_entity: (default true) if it`s allowed on an entity interaction (Usually these are controlled by the target entity rather then the item)
  in vanilla only the leads, name-tag and dye item(while clicking on sheep) use this behaviour.
• allowed_on_air: (default true) if it`s allowed on neither a block nor air interaction (stuff like eating)

example:

{
    "ability_context": [
        {
            "id": "tm_arsenal:parry_shield_block",
            "type": "miapi:block",
            "priority": 0,
            "data": {
                "blocking": 50
            }
        }
    ]
}

This System also allows you to have items with multiple abilities of the same type, for example:

{
    "ability_context": [
        {
            "id": "test:copy_flint_and_steel",
            "type": "miapi:copy_item",
            "priority": 0,
            "allowed_on_air": false,
            "data": {
                "id": "minecraft:flint_and_steel"
            }
        },
        {
            "id": "test:copy_bow",
            "type": "miapi:copy_item",
            "priority": 1,
            "data": {
                "id": "minecraft:bow",
                "fake_item_identity": true
            }
        }
    ]
}