🧠 Abilities Schema
Defines actions or powers available to the player, such as movement, attacks, and passive buffs.
✅ Field Rules & Accepted Values
| Field | Type | Required | Notes |
|---|---|---|---|
| id | string | ✅ Yes | Unique internal ID, e.g. 'dash' |
| displayName | string | ✅ Yes | Shown in UI |
| description | string | ✅ Yes | Explains gameplay behavior |
| effect | string | ✅ Yes | Engine-level effect (e.g., 'move_fast_horizontal') |
| type | "movement" | "combat" | "defense" | "utility" | "passive" | "traversal" | ✅ Yes | Ability category |
| key | string | ❌ No | Input key (e.g. 'X', 'Space') for active abilities |
| cooldown | number (float) | ❌ No | Cooldown between uses, in seconds |
| duration | number (float) | ❌ No | Duration of the effect once triggered |
| target | "self" | "enemy" | "area" | "directional" | ❌ No | Effect target |
| cost | object | ❌ No | Optional cost (e.g., { energy: 10 }) |
| requiredState | "ground" | "air" | "wall" | "any" | ❌ No | State required to trigger |
| unlockAtLevel | number | ❌ No | Auto-unlocked at player level ≥ value |
| tags | string[] | ❌ No | Searchable labels (e.g. ['speed', 'stealth']) |
| icon | string | ❌ No | UI icon path (e.g., 'dash_icon.png') |