# FeatureGrant

> Kinbarrow modding reference — content tree `4a103dcdb658a75a`, version `0.2.0+main.e011511f4`.

[Effects and mechanisms](https://kinbarrow.com/modding/latest/mechanisms.md)

Used by [ClassDef](https://kinbarrow.com/modding/latest/class-def.md#feature-grant), [Npc](https://kinbarrow.com/modding/latest/npc.md#feature-grant), [FeatDef](https://kinbarrow.com/modding/latest/feat-def.md#feature-grant), [RaceDef](https://kinbarrow.com/modding/latest/race-def.md#feature-grant), [SubclassDef](https://kinbarrow.com/modding/latest/subclass-def.md#feature-grant).

This is a nested shape inside a content file. The catalog explains context validation and links real RON examples.

One self-defining feature grant: its open id, sheet name, and every mechanic or explicit flavor-only declaration owned by its class, subclass, or race row.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `action` | `FeatureAction` | optional | An activated combat feature declared by this grant. The shared combat step pays the action economy; `ledger` names the existing use store. `effects` uses the same composable vocabulary as spells. `None` means this grant contributes no combat action. |
| `advisory` | `string` | optional | Optional player-facing guidance shown when this choice is selected. Absent means the option needs no additional advisory. |
| `choice` | `string` | optional | If set, this grant is one OPTION in a named choice group rather than an automatic class feature. Grants sharing a `choice` id are offered together when that group's lowest option level is reached. Absent = automatic at `level`. A mod adds another option by adding another grant with the same `choice` id. |
| `facts` | `FeatureFact[]` | optional | Typed combat facts this grant contributes once its class level is reached. Absent means the grant contributes no entry-packet fact. |
| `flavor` | `boolean` | default `false` | True when this named grant is intentionally sheet-only flavor. |
| `id` | `string` | required | Open authored id, unique within its owning class. |
| `level` | `uint32` | required | The class level, or character level for a race row, at which the feature is granted. |
| `levelup` | `LevelUpEffect` | optional | Optional generic character-growth operation supplied by this grant. |
| `modifiers` | `Modifier[]` | optional | The passive mechanics this grant carries. |
| `name` | `string` | required | Required sheet name owned by this open-id grant. |
| `passive` | `Effect[]` | default `[]` | Persistent effects contributed while this grant is reached. Only effects with a passive reader are accepted by validation. |
| `recharge` | `FeatureRecharge[]` | optional | Generic resource refresh rules owned by this grant. |
| `trigger` | `FeatureTrigger` | optional | A combat reaction, rider, aura, or boundary grant declared by this feature. `None` means crossing combat boundaries has no consequence from this grant. |
| `uses` | `integer` | optional | Base uses per rest from this level. A level-up resource row may instead derive or ladder the capacity. Absent means the grant has no own count. |


## Supporting shapes

- [Effect](https://kinbarrow.com/modding/latest/mechanisms/spell/effect.md)
- [FeatureAction](https://kinbarrow.com/modding/latest/mechanisms/class-def/feature-action.md)
- [FeatureFact](https://kinbarrow.com/modding/latest/mechanisms/class-def/feature-fact.md)
- [FeatureRecharge](https://kinbarrow.com/modding/latest/mechanisms/class-def/feature-recharge.md)
- [FeatureTrigger](https://kinbarrow.com/modding/latest/mechanisms/class-def/feature-trigger.md)
- [LevelUpEffect](https://kinbarrow.com/modding/latest/class-def.md#level-up-effect)
- [Modifier](https://kinbarrow.com/modding/latest/class-def.md#modifier)