> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/for-enchantmentreform/configs/info-of-abilities.md).

# Abilities

Abilities run after trigger conditions and Power Modifiers. Each category page provides purpose, exact context, complete type-specific fields with defaults, a runnable YAML example, and behavior/limits.

EnchantmentReform registers **78 built-in ability keys**.

## Reference pages

* [Fundamental and Visual Abilities](/for-enchantmentreform/configs/info-of-abilities/fundamentals.md)
* [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md)
* [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md)
* [Projectile Abilities](/for-enchantmentreform/configs/info-of-abilities/projectiles.md)
* [Inventory and Equipment Abilities](/for-enchantmentreform/configs/info-of-abilities/inventory-equipment.md)
* [Anvil Activation Abilities](/for-enchantmentreform/configs/info-of-abilities/anvil.md)
* [Control-flow Abilities](/for-enchantmentreform/configs/info-of-abilities/orchestration.md)
* [Integration and Targeting Abilities](/for-enchantmentreform/configs/info-of-abilities/integration.md)
* [Block and World Abilities](/for-enchantmentreform/configs/info-of-abilities/blocks-world.md)

## Common format

```yaml
abilities:
  unique-entry-id:
    type: damage_entity
    target: TARGET
    amount: '2 + level'
    conditions: {}
    random: 1
    cooldown: 0
    times: 0
```

## Common fields

| Field                   | Default             | Description                                                                     |
| ----------------------- | ------------------- | ------------------------------------------------------------------------------- |
| `type`                  | required            | Registered ability key. Keys are case-insensitive and `-` is normalized to `_`. |
| `target`                | ability-specific    | Selects an entity role such as `SOURCE`, `SKILL`, or `TARGET`.                  |
| `source`                | `SOURCE` where used | Attribution, direction, shooter, owner, or another source role.                 |
| `conditions`            | empty               | Typed Power Conditions; every child must pass.                                  |
| `random`                | `1`                 | Execution probability.                                                          |
| `cooldown`              | `0`                 | Per-source, per-power, per-config-path cooldown in seconds.                     |
| `times`                 | `0`                 | Maximum successful attempts for this configured path; zero is unlimited.        |
| `cooldown-message`      | empty               | Optional cooldown message with `{remaining}` and `{power_id}`.                  |
| `location`              | `CONTEXT`           | Flat or nested extended location selector.                                      |
| `location.offset.x/y/z` | `0`                 | Offset applied after resolving the location.                                    |
| `item`                  | `CONTEXT`           | Flat or nested item selector used by item-aware abilities.                      |
| `item-holder`           | ability-specific    | Equipment holder for item selectors.                                            |

## Common execution order

1. Ability-local typed conditions.
2. Usage-count check.
3. Existing cooldown check.
4. Random roll.
5. Cooldown acquisition.
6. Usage-count increment.
7. Type-specific implementation.

Because common cooldown/count state is acquired before type-specific execution, an ability can consume an attempt and then skip when required event/entity/item/block/integration context is unavailable.

## Dynamic values

Supported fields may resolve `level`, power variables, level selector maps, numeric ranges, runtime placeholders, and PlaceholderAPI where a player context exists. Each entry documents important explicit placeholders.

## Type index

| Type                    | Reference                                                                                                                        |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| `mark`                  | [Fundamental and Visual Abilities](/for-enchantmentreform/configs/info-of-abilities/fundamentals.md#mark)                        |
| `cancel_event`          | [Fundamental and Visual Abilities](/for-enchantmentreform/configs/info-of-abilities/fundamentals.md#cancel-event)                |
| `remove`                | [Fundamental and Visual Abilities](/for-enchantmentreform/configs/info-of-abilities/fundamentals.md#remove)                      |
| `place_block`           | [Fundamental and Visual Abilities](/for-enchantmentreform/configs/info-of-abilities/fundamentals.md#place-block)                 |
| `place_temp_block`      | [Fundamental and Visual Abilities](/for-enchantmentreform/configs/info-of-abilities/fundamentals.md#place-temp-block)            |
| `particle`              | [Fundamental and Visual Abilities](/for-enchantmentreform/configs/info-of-abilities/fundamentals.md#particle)                    |
| `sound`                 | [Fundamental and Visual Abilities](/for-enchantmentreform/configs/info-of-abilities/fundamentals.md#sound)                       |
| `vanilla_animation`     | [Fundamental and Visual Abilities](/for-enchantmentreform/configs/info-of-abilities/fundamentals.md#vanilla-animation)           |
| `set_attribute`         | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#set-attribute)                         |
| `refresh_attribute`     | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#refresh-attribute)                     |
| `set_health`            | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#set-health)                            |
| `set_absorption`        | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#set-absorption)                        |
| `set_air`               | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#set-air)                               |
| `set_food`              | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#set-food)                              |
| `set_velocity`          | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#set-velocity)                          |
| `set_invulnerable`      | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#set-invulnerable)                      |
| `potion_effect`         | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#potion-effect)                         |
| `remove_potion_effect`  | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#remove-potion-effect)                  |
| `extend_potion_effects` | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#extend-potion-effects)                 |
| `potion_cloud`          | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#potion-cloud)                          |
| `freeze`                | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#freeze)                                |
| `fire`                  | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#fire)                                  |
| `experience`            | [Entity State Abilities](/for-enchantmentreform/configs/info-of-abilities/entity-state.md#experience)                            |
| `explosion`             | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#explosion)                            |
| `lightning`             | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#lightning)                            |
| `damage_entity`         | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#damage-entity)                        |
| `damage_item`           | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#damage-item)                          |
| `pull_target`           | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#pull-target)                          |
| `pull_location`         | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#pull-location)                        |
| `teleport_near_target`  | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#teleport-near-target)                 |
| `teleport`              | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#teleport)                             |
| `guardian_beam`         | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#guardian-beam)                        |
| `sonic_boom`            | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#sonic-boom)                           |
| `evoker_fangs`          | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#evoker-fangs)                         |
| `arrow_rain`            | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#arrow-rain)                           |
| `creeper_stats`         | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#creeper-stats)                        |
| `swap_health`           | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#swap-health)                          |
| `swap_potion_effects`   | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#swap-potion-effects)                  |
| `swap_locations`        | [Combat and Movement Abilities](/for-enchantmentreform/configs/info-of-abilities/combat.md#swap-locations)                       |
| `launch_projectile`     | [Projectile Abilities](/for-enchantmentreform/configs/info-of-abilities/projectiles.md#launch-projectile)                        |
| `shulker_bullet`        | [Projectile Abilities](/for-enchantmentreform/configs/info-of-abilities/projectiles.md#shulker-bullet)                           |
| `homing_projectile`     | [Projectile Abilities](/for-enchantmentreform/configs/info-of-abilities/projectiles.md#homing-projectile)                        |
| `consume_food`          | [Inventory and Equipment Abilities](/for-enchantmentreform/configs/info-of-abilities/inventory-equipment.md#consume-food)        |
| `auto_feed`             | [Inventory and Equipment Abilities](/for-enchantmentreform/configs/info-of-abilities/inventory-equipment.md#auto-feed)           |
| `enhance_equipment`     | [Inventory and Equipment Abilities](/for-enchantmentreform/configs/info-of-abilities/inventory-equipment.md#enhance-equipment)   |
| `enhance_helditem`      | [Inventory and Equipment Abilities](/for-enchantmentreform/configs/info-of-abilities/inventory-equipment.md#enhance-helditem)    |
| `replace_item`          | [Inventory and Equipment Abilities](/for-enchantmentreform/configs/info-of-abilities/inventory-equipment.md#replace-item)        |
| `shuffle_inventory`     | [Inventory and Equipment Abilities](/for-enchantmentreform/configs/info-of-abilities/inventory-equipment.md#shuffle-inventory)   |
| `change_item`           | [Inventory and Equipment Abilities](/for-enchantmentreform/configs/info-of-abilities/inventory-equipment.md#change-item)         |
| `modify_repair_cost`    | [Anvil Activation Abilities](/for-enchantmentreform/configs/info-of-abilities/anvil.md#modify-repair-cost)                       |
| `cost_price`            | [Inventory and Equipment Abilities](/for-enchantmentreform/configs/info-of-abilities/inventory-equipment.md#cost-price)          |
| `drop_item`             | [Inventory and Equipment Abilities](/for-enchantmentreform/configs/info-of-abilities/inventory-equipment.md#drop-item)           |
| `preserve_inventory`    | [Inventory and Equipment Abilities](/for-enchantmentreform/configs/info-of-abilities/inventory-equipment.md#preserve-inventory)  |
| `preserve_item`         | [Inventory and Equipment Abilities](/for-enchantmentreform/configs/info-of-abilities/inventory-equipment.md#preserve-item)       |
| `preserve_experience`   | [Inventory and Equipment Abilities](/for-enchantmentreform/configs/info-of-abilities/inventory-equipment.md#preserve-experience) |
| `use_on`                | [Inventory and Equipment Abilities](/for-enchantmentreform/configs/info-of-abilities/inventory-equipment.md#use-on)              |
| `delay`                 | [Control-flow Abilities](/for-enchantmentreform/configs/info-of-abilities/orchestration.md#delay)                                |
| `conditional`           | [Control-flow Abilities](/for-enchantmentreform/configs/info-of-abilities/orchestration.md#conditional)                          |
| `any_of`                | [Control-flow Abilities](/for-enchantmentreform/configs/info-of-abilities/orchestration.md#any-of)                               |
| `limit`                 | [Control-flow Abilities](/for-enchantmentreform/configs/info-of-abilities/orchestration.md#limit)                                |
| `repeat`                | [Control-flow Abilities](/for-enchantmentreform/configs/info-of-abilities/orchestration.md#repeat)                               |
| `nearby_entities`       | [Integration and Targeting Abilities](/for-enchantmentreform/configs/info-of-abilities/integration.md#nearby-entities)           |
| `nearby_block`          | [Block and World Abilities](/for-enchantmentreform/configs/info-of-abilities/blocks-world.md#nearby-block)                       |
| `summon`                | [Integration and Targeting Abilities](/for-enchantmentreform/configs/info-of-abilities/integration.md#summon)                    |
| `mythic_skill`          | [Integration and Targeting Abilities](/for-enchantmentreform/configs/info-of-abilities/integration.md#mythic-skill)              |
| `send_message`          | [Integration and Targeting Abilities](/for-enchantmentreform/configs/info-of-abilities/integration.md#send-message)              |
| `execute_command`       | [Integration and Targeting Abilities](/for-enchantmentreform/configs/info-of-abilities/integration.md#execute-command)           |
| `execute_action`        | [Integration and Targeting Abilities](/for-enchantmentreform/configs/info-of-abilities/integration.md#execute-action)            |
| `break_blocks`          | [Block and World Abilities](/for-enchantmentreform/configs/info-of-abilities/blocks-world.md#break-blocks)                       |
| `break_block`           | [Block and World Abilities](/for-enchantmentreform/configs/info-of-abilities/blocks-world.md#break-block)                        |
| `replace_block`         | [Block and World Abilities](/for-enchantmentreform/configs/info-of-abilities/blocks-world.md#replace-block)                      |
| `change_block_face`     | [Block and World Abilities](/for-enchantmentreform/configs/info-of-abilities/blocks-world.md#change-block-face)                  |
| `grow_crop`             | [Block and World Abilities](/for-enchantmentreform/configs/info-of-abilities/blocks-world.md#grow-crop)                          |
| `scan_blocks`           | [Block and World Abilities](/for-enchantmentreform/configs/info-of-abilities/blocks-world.md#scan-blocks)                        |
| `locate_structure`      | [Block and World Abilities](/for-enchantmentreform/configs/info-of-abilities/blocks-world.md#locate-structure)                   |
| `locate_biome`          | [Block and World Abilities](/for-enchantmentreform/configs/info-of-abilities/blocks-world.md#locate-biome)                       |
| `state`                 | [Control-flow Abilities](/for-enchantmentreform/configs/info-of-abilities/orchestration.md#state)                                |
| `auto_fishing`          | [Integration and Targeting Abilities](/for-enchantmentreform/configs/info-of-abilities/integration.md#auto-fishing)              |
| `disable_enchantments`  | [Integration and Targeting Abilities](/for-enchantmentreform/configs/info-of-abilities/integration.md#disable-enchantments)      |