# Ability Types

Complete list of ability types available in the Combat plugin.

## Targeting Types

These determine who or what an ability affects.

| Type                     | Class                               | Description                                                                                                       |
| ------------------------ | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Direct Target            | `DirectTargetAbilityType`           | Targets a single entity. Requires line of sight and range validation. The caster selects a target before casting. |
| Action Target            | `ActionTargetAbilityType`           | Targets the entity directly in front of the caster. Action-game style, no explicit target selection.              |
| Self                     | `SelfAbilityType`                   | Targets the caster. No targeting needed. Used for self-buffs, heals, and defensive abilities.                     |
| AoE                      | `AoEAbilityType`                    | Affects all entities within a spherical radius around a point. Supports Y-axis height filtering.                  |
| Direct Target AoE        | `DirectTargetAoEAbilityType`        | Targets an entity, then applies effects in a radius around them. Combines single-target and area.                 |
| Direct Target Projectile | `DirectTargetProjectileAbilityType` | Fires a projectile toward a selected target. Projectile travels and hits on arrival.                              |
| Action Projectile        | `ActionProjectileAbilityType`       | Fires a projectile in the caster's forward direction. No target selection needed.                                 |
| Ground                   | `GroundAbilityType`                 | Targets a point on the ground. Player clicks a location to place the effect.                                      |
| Cone                     | `ConeAbilityType`                   | Affects entities in a cone-shaped area in front of the caster. Defined by angle and range.                        |
| Rectangle                | `RectangleAbilityType`              | Affects entities in a rectangular area. Defined by width and length.                                              |
| Aura                     | `AuraAbilityType`                   | Continuously affects nearby entities while active. Persistent area effect centered on the caster.                 |

## Activation Types

These determine how and when the ability fires.

| Type        | Class                       | Description                                                                                                                                                                     |
| ----------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Instant     | `InstantActivationType`     | Fires immediately with no cast time. Can trigger muzzle VFX at cast point.                                                                                                      |
| Channel     | `ChannelActivationType`     | Caster channels for a fixed duration. Effects apply during or at the end of the channel. Uses an animator bool for the channel animation. Moving or acting cancels the channel. |
| Incantation | `IncantationActivationType` | Caster performs a cast animation before the ability fires. The ability resolves when the animation reaches its trigger point. Can be interrupted by damage or movement.         |

## Combining Types

Each ability has exactly one targeting type and one activation type. Some common combinations:

| Combination                 | Example                      |
| --------------------------- | ---------------------------- |
| Direct Target + Instant     | Basic attack, quick heal     |
| Direct Target + Incantation | Fireball, lightning bolt     |
| Self + Instant              | Quick buff, dodge roll       |
| Self + Channel              | Meditation, regeneration     |
| AoE + Incantation           | Rain of fire, blizzard       |
| Ground + Channel            | Channeled beam at a location |
| Cone + Instant              | Breath attack, cleave        |
| Aura + Instant (toggle)     | Paladin aura, damage shield  |
| Action Projectile + Instant | Shotgun blast, arrow volley  |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sparkframework.dev/documentation/developer-guide/plugins/combat/ability-types.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.