# NaturalAttackOnHit

> Kinbarrow modding reference — content tree `f6fc3bd8d7e181b7`, version `0.2.0+main.376d33cd6`.

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

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

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

Authorable `NaturalAttackOnHit` data exposed through the modding schema.

<a id="natural-attack-on-hit--condition"></a>

## NaturalAttackOnHit::Condition

Apply a condition when the target is no larger than `max_target_size`. `save: None` is the 2024 monster wording "the target has the condition"; an authored save branches through the ordinary saving-throw machinery.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `condition` | `string` | required |  |
| `duration` | `NaturalAttackConditionDuration` | default `"Persistent"` |  |
| `max_target_size` | `Size` | optional |  |
| `save` | `NaturalAttackSave` | optional |  |

<a id="natural-attack-on-hit--grapple"></a>

## NaturalAttackOnHit::Grapple

Select the grapple behavior.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `escape_dc` | `int64` | required |  |
| `max_target_size` | `Size` | required |  |
| `max_targets` | `integer` | optional | Maximum creatures this attack's anatomy can hold at once. Absent means the stat block states no additional capacity limit. |
| `pull_ft` | `uint32` | default `0` | Pull the newly grappled target straight toward the attacker. |
| `restrained` | `boolean` | default `false` |  |

<a id="natural-attack-on-hit--damage"></a>

## NaturalAttackOnHit::Damage

Select the damage behavior.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `condition_duration_secs` | `integer` | optional | Absolute-world duration for the failed-save condition. Absent uses the condition's ordinary persistent lifecycle. |
| `condition_on_failed_save` | `string` | optional |  |
| `damage` | `Damage` | required |  |
| `doubles_on_crit` | `boolean` | default `false` | Whether these dice are part of the attack's critical damage roll. Monster poison/save riders default false; magic weapon damage such as Frost Brand authors true. |
| `on_save` | `OnSave` | optional |  |
| `save` | `NaturalAttackSave` | optional |  |


## Supporting shapes

- [Damage](https://kinbarrow.com/modding/latest/magic-item.md#damage)
- [NaturalAttackConditionDuration](https://kinbarrow.com/modding/latest/mechanisms/npc/natural-attack-condition-duration.md)
- [NaturalAttackSave](https://kinbarrow.com/modding/latest/mechanisms/magic-item/natural-attack-save.md)
- [OnSave](https://kinbarrow.com/modding/latest/mechanisms/spell/on-save.md)
- [Size](https://kinbarrow.com/modding/latest/spell.md#size)