# NaturalAttack

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

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

Used by [Npc](https://kinbarrow.com/modding/latest/npc.md#natural-attack).

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

One natural attack off a monster's stat block: a bite, claw, or slam the creature IS armed with — not a borrowed weapon. PRIMITIVES only: to-hit and the damage average DERIVE (`pb_for_cr` + the governing ability's mod), exactly as a humanoid's weapon line does. The `ability` names which mod feeds both (Str for a slam, Dex for a wolf's quick bite — the finesse rule made explicit for the raceless). `reach_ft` is the melee reach (5 ft on the grid = one square; a longer reach is ledgered); a ranged natural attack carries `range` (none in the starter bestiary — the substrate for a manticore's spikes, ledgered).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `ability` | `Ability` | required | The ability whose mod feeds to-hit and damage (Str, or Dex for a finesse-like bite). |
| `advantage_if_self_bloodied` | `boolean` | default `false` | Advantage while the attacker itself is Bloodied (for example, Bloodied Fury). |
| `advantage_if_target_bloodied` | `boolean` | default `false` | Authored advantage if target bloodied. |
| `advantage_if_target_wounded` | `boolean` | default `false` | Advantage when the target has fewer than all of its Hit Points. |
| `charge` | `NaturalAttackCharge` | optional | Extra on-hit payload after a straight run toward the target. |
| `damage` | `Damage` | required | The attack's damage dice and kind. |
| `damage_flat` | `integer` | optional | Printed flat damage modifier when it differs from the attack ability modifier. Absent keeps the ordinary derived modifier. |
| `damage_if_self_bloodied` | `Damage` | optional | Replacement damage dice and kind when the attacker itself is Bloodied. Swarms use this to reduce their attack damage as their members fall. |
| `damage_if_target_bloodied` | `Damage` | optional | Replacement damage dice and kind when the target is Bloodied. The ordinary flat modifier remains unchanged unless `damage_flat` authors it. |
| `forbid_target_grappled_by_self` | `boolean` | default `false` | This attack cannot target a creature currently grappled by its source. |
| `name` | `string` | required | Authored name. |
| `on_hit` | `NaturalAttackOnHit[]` | default `[]` | Typed mechanics that resolve only after this particular attack hits. Keeping them on the attack (rather than the creature body) preserves identity when a stat block has, for example, a plain Bite and a condition-bearing Tail. |
| `range` | `Range` | optional | Ranged natural-attack range; absent = melee only. |
| `reach_ft` | `uint32` | required | Melee reach in feet (5 ft = one grid square). |
| `recharge_low` | `uint8` | default `0` | The LOW d6 face that restores this attack at turn start (6 = "Recharge 6"). Zero means the attack is always available. |


## Supporting shapes

- [Ability](https://kinbarrow.com/modding/latest/spell.md#ability)
- [Damage](https://kinbarrow.com/modding/latest/magic-item.md#damage)
- [NaturalAttackCharge](https://kinbarrow.com/modding/latest/mechanisms/npc/natural-attack-charge.md)
- [NaturalAttackOnHit](https://kinbarrow.com/modding/latest/mechanisms/npc/natural-attack-on-hit.md)
- [Range](https://kinbarrow.com/modding/latest/class-def.md#range)