> 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/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.

EnchantedMobs registers **52 built-in ability keys**.

## Reference pages

* [Fundamental and Visual Abilities](/configs/info-of-abilities/fundamentals.md)
* [Entity State Abilities](/configs/info-of-abilities/entity-state.md)
* [Combat and Movement Abilities](/configs/info-of-abilities/combat.md)
* [Projectile Abilities](/configs/info-of-abilities/projectiles.md)
* [Inventory and Equipment Abilities](/configs/info-of-abilities/inventory-equipment.md)
* [Control-flow Abilities](/configs/info-of-abilities/orchestration.md)
* [Integration and Targeting Abilities](/configs/info-of-abilities/integration.md)
* [Block and World Abilities](/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.        |
| `location.offset-x/y/z` | `0`                 | Offset applied to the trigger-resolved location.                                |

## 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](/configs/info-of-abilities/fundamentals.md#mark)                      |
| `cancel_event`          | [Fundamental and Visual Abilities](/configs/info-of-abilities/fundamentals.md#cancel-event)              |
| `remove`                | [Fundamental and Visual Abilities](/configs/info-of-abilities/fundamentals.md#remove)                    |
| `place_block`           | [Fundamental and Visual Abilities](/configs/info-of-abilities/fundamentals.md#place-block)               |
| `particle`              | [Fundamental and Visual Abilities](/configs/info-of-abilities/fundamentals.md#particle)                  |
| `sound`                 | [Fundamental and Visual Abilities](/configs/info-of-abilities/fundamentals.md#sound)                     |
| `vanilla_animation`     | [Fundamental and Visual Abilities](/configs/info-of-abilities/fundamentals.md#vanilla-animation)         |
| `set_attribute`         | [Entity State Abilities](/configs/info-of-abilities/entity-state.md#set-attribute)                       |
| `set_health`            | [Entity State Abilities](/configs/info-of-abilities/entity-state.md#set-health)                          |
| `set_air`               | [Entity State Abilities](/configs/info-of-abilities/entity-state.md#set-air)                             |
| `set_food`              | [Entity State Abilities](/configs/info-of-abilities/entity-state.md#set-food)                            |
| `set_velocity`          | [Entity State Abilities](/configs/info-of-abilities/entity-state.md#set-velocity)                        |
| `set_invulnerable`      | [Entity State Abilities](/configs/info-of-abilities/entity-state.md#set-invulnerable)                    |
| `potion_effect`         | [Entity State Abilities](/configs/info-of-abilities/entity-state.md#potion-effect)                       |
| `remove_potion_effect`  | [Entity State Abilities](/configs/info-of-abilities/entity-state.md#remove-potion-effect)                |
| `extend_potion_effects` | [Entity State Abilities](/configs/info-of-abilities/entity-state.md#extend-potion-effects)               |
| `potion_cloud`          | [Entity State Abilities](/configs/info-of-abilities/entity-state.md#potion-cloud)                        |
| `freeze`                | [Entity State Abilities](/configs/info-of-abilities/entity-state.md#freeze)                              |
| `fire`                  | [Entity State Abilities](/configs/info-of-abilities/entity-state.md#fire)                                |
| `experience`            | [Entity State Abilities](/configs/info-of-abilities/entity-state.md#experience)                          |
| `explosion`             | [Combat and Movement Abilities](/configs/info-of-abilities/combat.md#explosion)                          |
| `lightning`             | [Combat and Movement Abilities](/configs/info-of-abilities/combat.md#lightning)                          |
| `damage_entity`         | [Combat and Movement Abilities](/configs/info-of-abilities/combat.md#damage-entity)                      |
| `damage_item`           | [Combat and Movement Abilities](/configs/info-of-abilities/combat.md#damage-item)                        |
| `pull_target`           | [Combat and Movement Abilities](/configs/info-of-abilities/combat.md#pull-target)                        |
| `teleport_near_target`  | [Combat and Movement Abilities](/configs/info-of-abilities/combat.md#teleport-near-target)               |
| `guardian_beam`         | [Combat and Movement Abilities](/configs/info-of-abilities/combat.md#guardian-beam)                      |
| `sonic_boom`            | [Combat and Movement Abilities](/configs/info-of-abilities/combat.md#sonic-boom)                         |
| `evoker_fangs`          | [Combat and Movement Abilities](/configs/info-of-abilities/combat.md#evoker-fangs)                       |
| `arrow_rain`            | [Combat and Movement Abilities](/configs/info-of-abilities/combat.md#arrow-rain)                         |
| `creeper_stats`         | [Combat and Movement Abilities](/configs/info-of-abilities/combat.md#creeper-stats)                      |
| `swap_health`           | [Combat and Movement Abilities](/configs/info-of-abilities/combat.md#swap-health)                        |
| `swap_potion_effects`   | [Combat and Movement Abilities](/configs/info-of-abilities/combat.md#swap-potion-effects)                |
| `swap_locations`        | [Combat and Movement Abilities](/configs/info-of-abilities/combat.md#swap-locations)                     |
| `launch_projectile`     | [Projectile Abilities](/configs/info-of-abilities/projectiles.md#launch-projectile)                      |
| `shulker_bullet`        | [Projectile Abilities](/configs/info-of-abilities/projectiles.md#shulker-bullet)                         |
| `homing_projectile`     | [Projectile Abilities](/configs/info-of-abilities/projectiles.md#homing-projectile)                      |
| `consume_food`          | [Inventory and Equipment Abilities](/configs/info-of-abilities/inventory-equipment.md#consume-food)      |
| `enhance_equipment`     | [Inventory and Equipment Abilities](/configs/info-of-abilities/inventory-equipment.md#enhance-equipment) |
| `enhance_helditem`      | [Inventory and Equipment Abilities](/configs/info-of-abilities/inventory-equipment.md#enhance-helditem)  |
| `replace_item`          | [Inventory and Equipment Abilities](/configs/info-of-abilities/inventory-equipment.md#replace-item)      |
| `disarm`                | [Inventory and Equipment Abilities](/configs/info-of-abilities/inventory-equipment.md#disarm)            |
| `shuffle_inventory`     | [Inventory and Equipment Abilities](/configs/info-of-abilities/inventory-equipment.md#shuffle-inventory) |
| `delay`                 | [Control-flow Abilities](/configs/info-of-abilities/orchestration.md#delay)                              |
| `conditional`           | [Control-flow Abilities](/configs/info-of-abilities/orchestration.md#conditional)                        |
| `any_of`                | [Control-flow Abilities](/configs/info-of-abilities/orchestration.md#any-of)                             |
| `limit`                 | [Control-flow Abilities](/configs/info-of-abilities/orchestration.md#limit)                              |
| `repeat`                | [Control-flow Abilities](/configs/info-of-abilities/orchestration.md#repeat)                             |
| `nearby_entities`       | [Integration and Targeting Abilities](/configs/info-of-abilities/integration.md#nearby-entities)         |
| `summon`                | [Integration and Targeting Abilities](/configs/info-of-abilities/integration.md#summon)                  |
| `mythic_skill`          | [Integration and Targeting Abilities](/configs/info-of-abilities/integration.md#mythic-skill)            |
| `send_message`          | [Integration and Targeting Abilities](/configs/info-of-abilities/integration.md#send-message)            |
| `execute_command`       | [Integration and Targeting Abilities](/configs/info-of-abilities/integration.md#execute-command)         |