> For the complete documentation index, see [llms.txt](https://black-horizon-studios.gitbook.io/emerald-ai-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://black-horizon-studios.gitbook.io/emerald-ai-wiki/emerald-components-optional/navmesh-link-component/setting-up-the-navmesh-link-component.md).

# Setting up the NavMesh Link Component

{% hint style="warning" %}
**Important:** Ensure you have a NavMesh Link Component on your AI.
{% endhint %}

{% hint style="warning" %}
**Important:** Ensure you have baked your scene with NavMesh and have NavMesh Links generated or manually placed. For a tutorial on how to do this, see Unity's tutorial here: <https://docs.unity3d.com/560/Documentation/Manual/class-NavMeshLink.html>
{% endhint %}

{% hint style="warning" %}
**Important:** Emerald AI 2025 v1.3.3 or higher is required to use this feature. This is a free update as all updates for Emerald AI are.
{% endhint %}

## Setting up the NavMesh Link Component

The NavMesh Link Component gives AI the ability to use NavMesh Links generated by Unity's NavMesh. This allows them to jump up, drop down, and jump over obstacles while navigating with NavMesh. This allows AI to feel more intelligent, difficult to evade, and allow them to take shortcuts when navigating.

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

### Applying NavMesh Link Animations

You should first assign an AI's NavMesh Link Animations. This can be done through an AI's Animation Profile and opening the NavMesh Link Animations foldout. Here, you will be able to assign a Jump, Land, Drop, and Vault animation.

{% hint style="danger" %}
**Required: If you are using an AI created from an update prior to version 1.3.3**, will need to regenerate your Animation Profile in order to have the new NavMesh Link States added. Not doing so will not allow the cover animations to play or be assigned to the Animator Controller. This can be done by [Regenerating your Animator Controller](https://black-horizon-studios.gitbook.io/emerald-ai-wiki/emerald-profiles-and-objects/animation-profile/regenerate-animator-controllers). This will update your Animator Controller to the newest version and apply the missing NavMesh Link States.
{% endhint %}

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

* **Jump** - The animation that plays when at the start of jumping up or across a NavMesh Link.
* **Land** - The animation that plays when landing from any NavMesh Link.
* **Drop** - The animation that plays when descending from an upper NavMesh Link.
* **Vault** - The animation that plays when jumping across a small distanced NavMesh Link.

### Adjusting the NavMesh Link Component Settings

Most of this component is automatic. Currently, the only only setting is the NavMesh Link Cooldown that stops an AI from using NavMesh Links until the cooldown amount has passed. This is to prevent AI from using NavMesh Links too often or unintentionally (due to a target that quickly changes position).

### Adding Jumping and Landing Sounds

Jumping and landing sounds can be optionally added through the [Sound Profile](/emerald-ai-wiki/emerald-profiles-and-objects/sound-profile.md) for each AI. These will play automatically when an AI jumps or lands.
