# Vault Component

## Overview

This component is used to vault over obstacles. Add it directly to your character:

<figure><img src="/files/JWLPWziJ4QMyWs04RqSB" alt="" width="432"><figcaption><p>Inspector.</p></figcaption></figure>

{% hint style="success" %}
**Tip:** you can create Mantle Settings and Motion Warping Assets by right clicking <mark style="background-color:purple;">**Create/KINEMATION/Motion Warping/**</mark>
{% endhint %}

**Vaulting Settings** define properties to vault over obstacles:

<figure><img src="/files/wLpNyEj05GRm6UAwySUA" alt="" width="422"><figcaption><p>Vaulting Settings.</p></figcaption></figure>

* **Layer Mask:** defines the collision mask.
* **Capsule Radius:** radius for capsule trace.
* **Max/Min Obstacle Length:** max and min allowed lengths of the obstacle.
* **Sphere Edge Check Radius:** sphere trace radius to find the edges of the obstacle.
* **Max Allowed Start Length:** max allowed distance between the front edge and the character.
* **Max/Min Allowed Start Height:** max/min allowed height of the fron edge.
* **Close Edge Deviation:** edge vertical offset.
* **Far Edge Offset:** start vertical offset to find the rear edge.
* **Max/Min Allowed End Height:** max/min allowed height of the rear edge.

## How does it work?

The **VaultComponent** uses 3 stages to find all target points: Close Edge, Far Edge and End Point.

1. Try to find an obstacle and the Close Edge.
2. Try to find the End Point.
3. Try to find the Far Edge

## Motion Warping Asset Requirements

Vaulting over animation must have 3 Warp Phases.

1. Go from current point to the Close Edge.
2. Go from the Close Edge to the Far Edge.
3. Go from the Far Edge to the End Point.

<figure><img src="/files/JXiXaz4CGWRuGFKKMTAP" 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://kinemation.gitbook.io/motion-warping-for-unity/components/vault-component.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.
