> ## Documentation Index
> Fetch the complete documentation index at: https://docs.borntocraftstudio.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Combat Events

> React to combat-related events like blocking and attacking.

Trigger actions during combat scenarios.

## Event Library

<CardGroup cols={2}>
  <Card title="Shield Block" icon="shield" href="#shield-block-event">
    Triggers upon a successful block.
  </Card>

  <Card title="Trident Throw" icon="location-crosshairs" href="#trident-throw-event">
    Triggers when a trident is launched.
  </Card>

  <Card title="Trident Recall" icon="rotate-left" href="#trident-recall-event">
    Triggers when a Loyalty trident returns.
  </Card>

  <Card title="Crossbow Reload" icon="crosshairs" href="#crossbow-reload-event">
    Triggers when reloading a crossbow.
  </Card>
</CardGroup>

## Configuration

### `shield_block_event`

Triggers when a player successfully blocks damage with a shield.

<ResponseField name="minDamage" type="Double">
  Minimum damage required to trigger event.
</ResponseField>

<ResponseField name="damageType" type="DamageCause">
  Source of damage (e.g. `ENTITY_ATTACK`, `PROJECTILE`).
</ResponseField>

### `trident_throw_event`

Triggers when a player throws a trident.

<ResponseField name="hasRiptide" type="Boolean">
  If true, only triggers for Riptide tridents.
</ResponseField>

<ResponseField name="hasLoyalty" type="Boolean">
  If true, only triggers for Loyalty tridents.
</ResponseField>

### `trident_recall_event`

Triggers when a Loyalty trident returns to the thrower.
<Info>No additional configuration.</Info>

### `crossbow_reload_event`

Triggers when a projectile is loaded into a crossbow.

<ResponseField name="projectileType" type="Material">
  Material of projectile loaded (`ARROW`, `FIREWORK_ROCKET`).
</ResponseField>

## Examples

<CodeGroup>
  ```yaml Shield Defense theme={null}
  shield_block_event:
    minDamage: 5.0
    damageType: PROJECTILE
    actions:
      - sound_action:
          sound: ITEM_SHIELD_BLOCK
          pitch: 0.5
  ```

  ```yaml Crossbow theme={null}
  crossbow_reload_event:
    projectileType: FIREWORK_ROCKET
    actions:
      - message_action:
          message: "<yellow>Rocket loaded! Ready to blast."
  ```
</CodeGroup>