# Blocking Combat Action

### Blocking Combat Action

The Blocking Combat Action gives an ability for AI to attempt to detect and block projectiles and melee attacks, when within range of an enemy. This also works for player attacks. This also allows for the ability for an AI's attack to stop if its target is blocking and play a recoiling animation (which requires a recoil animation). There's a cooldown to control how often this action can happen.

<figure><img src="/files/WXC2BKSBMRLkd4rsgTpL" alt=""><figcaption></figcaption></figure>

### Creating a New Blocking Combat Action

There is an example Blocking Combat Action to help get you started. However, you might want to create your own, or have different blocking settings for different AI. You can create a new Blocking Combat Action by right clicking within the Project tab and going to Create>Emerald AI>Action>Block Action.

{% hint style="info" %}
**Note:** You can also select the included example Block Combat Action and press Ctrl+D to duplicate it. This will allow you to create a copy of the example so you can retain the default settings such as the Enter, Cooldown, and Exit Condition settings.
{% endhint %}

<figure><img src="/files/7yMt2zYDY14cduyfRXEZ" alt=""><figcaption></figcaption></figure>

You will then have a new Blocking Combat Action to customize through the Blocking Combat Action Editor.

{% hint style="info" %}
**Note:** There are detailed tooltips for every setting. Just hover the mouse over the setting to bring up the tooltip.
{% endhint %}

<figure><img src="/files/PDcy4htuAQ0XBWJAZRTs" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://black-horizon-studios.gitbook.io/emerald-ai-wiki/emerald-profiles-and-objects/combat-action-object/blocking-combat-action.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.