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

# Mantle Component: Add Obstacle Climbing to Characters

> Add obstacle climbing to your character with the Mantle Component. Assign high and low climb assets, configure capsule detection, and set height limits.

The Mantle Component gives your character the ability to climb over obstacles in the environment. It distinguishes between low and high obstacles automatically, playing the appropriate Motion Warping Asset for each case. Add the component directly to your character GameObject and supply a Settings Data Asset to control how the system detects climbable surfaces.

## Add to Your Character

Attach the **MantleComponent** directly to your character GameObject in the Inspector. You will need to assign two Motion Warping Assets (one for high climbs, one for low climbs) and a Settings Data Asset that governs detection behaviour.

<Tip>
  Create Mantle Settings and Motion Warping Assets by right-clicking in the Project window and choosing **Create → KINEMATION → Motion Warping**.
</Tip>

## Component Properties

<ParamField path="Mantle High" type="Motion Warping Asset" required>
  The Motion Warping Asset used when the character climbs a **high** obstacle. The system selects this asset when the detected obstacle height exceeds the **Low Height** threshold defined in the Settings Data Asset.
</ParamField>

<ParamField path="Mantle Low" type="Motion Warping Asset" required>
  The Motion Warping Asset used when the character climbs a **low** obstacle. The system selects this asset when the detected obstacle height is at or below the **Low Height** threshold.
</ParamField>

<ParamField path="Settings" type="Data Asset" required>
  A reusable Scriptable Object that holds all detection and geometry parameters for the climbing logic. Configure it once and share it across multiple characters or scenarios.
</ParamField>

## Settings Data Asset Properties

<ParamField path="Layer Mask" type="LayerMask" required>
  Defines which collision layers the component considers when searching for a climbable obstacle. Set this to the layers that represent your environment geometry.
</ParamField>

<ParamField path="Max Height" type="float" required>
  The maximum obstacle height the character can climb. If the detected obstacle is taller than this value, the climbing interaction is rejected and will not start.
</ParamField>

<ParamField path="Low Height" type="float" required>
  The height threshold that determines which animation asset is used. If the obstacle height exceeds this value the system plays the **Mantle High** asset; otherwise it plays the **Mantle Low** asset.
</ParamField>

<ParamField path="Min Height" type="float" required>
  The minimum obstacle height required to trigger a climb. Obstacles shorter than this value are ignored entirely.
</ParamField>

<ParamField path="Max Distance" type="float" required>
  The maximum horizontal distance allowed between the character and the obstacle. If the character is farther away than this value, the interaction is skipped.
</ParamField>

<ParamField path="Capsule Radius" type="float" required>
  The radius of the capsule shape used during the initial obstacle trace. Match this to your character's approximate width for reliable detection. Also used to verify that enough space exists on the obstacle's edge for the character to land.
</ParamField>

<ParamField path="Capsule Height" type="float" required>
  The height of the capsule shape used during the initial obstacle trace and the space-check on the edge. Tune this to match the crouched or standing height of the character depending on your animation.
</ParamField>

<ParamField path="Sphere Edge Check Radius" type="float" required>
  The radius of the sphere trace used to locate the precise edge of the obstacle. A smaller radius finds sharper edges; a larger radius tolerates rougher geometry.
</ParamField>

<ParamField path="Max Surface Incline Angle" type="float" required>
  The maximum angle (in degrees) that the top surface of an obstacle may be inclined before the system refuses to climb it. Use this to prevent the character from attempting to climb steep or sloped surfaces.
</ParamField>

<ParamField path="Forward Offset" type="float" required>
  A distance offset applied forward from the detected edge point. Adjust this to fine-tune where the character lands after clearing the top of the obstacle.
</ParamField>

## How It Works

The MantleComponent runs three sequential stages every time you trigger an interaction. All three stages must succeed for the climb to begin.

<Steps>
  <Step title="Find the Obstacle">
    The component casts a capsule (using **Capsule Radius**, **Capsule Height**, and **Max Distance**) in front of the character to detect a potential obstacle. If nothing is hit within the allowed distance, the interaction is aborted immediately.
  </Step>

  <Step title="Find the Edge">
    A sphere trace (using **Sphere Edge Check Radius**) walks the hit geometry to locate the precise top edge of the obstacle. The detected height is validated against **Min Height** and **Max Height**. If the edge falls outside that range, the interaction is rejected.
  </Step>

  <Step title="Check Available Space">
    The component checks whether there is enough clearance on and above the edge for the character capsule. If another collider is blocking the landing zone, the interaction is cancelled.
  </Step>
</Steps>

If all three stages succeed, the system picks the correct Motion Warping Asset (High or Low) based on the **Low Height** threshold and starts the interaction.

## Triggering the Interaction

Get a reference to the `MantleComponent` on your character, then call `Interact` on the `MotionWarping` component and pass the `MantleComponent` as the argument:

```csharp theme={null}
_warping.Interact(_mantleComponent);
```

Call this from your input handler, animation state machine, or ability system whenever you want the character to attempt a climb.

## Motion Warping Asset Requirements

Climbing moves the character from a starting position to a single destination point on top of the obstacle. Your Motion Warping Asset therefore needs exactly **one Warp Phase**.

<Note>
  Both the **Mantle High** and **Mantle Low** assets must each contain exactly 1 Warp Phase. The single phase maps the character's root motion from its current position to the detected edge point.
</Note>