FeatureGrant

Used by ClassDef, Npc, FeatDef, RaceDef, SubclassDef

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.