> ## 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.

# Roll Component: Sliding and Rolling with Motion Warping

> Give your character slides and rolls. Checks for obstacles in the path, traces a ground target ahead, and warps the character animation to fit the terrain.

The Roll Component moves the character forward along the ground, making it ideal for sliding and rolling mechanics. Rather than playing a fixed-distance animation, it procedurally finds a target point ahead of the character based on the terrain and allowed distance range, then warps the animation to land precisely on that point. This means your rolls and slides adapt naturally to slopes, uneven ground, and varying movement speeds. Add this component directly to your character and configure it in the Inspector.

## Add to Your Character

Attach the **RollComponent** directly to your character GameObject. All settings are exposed directly on the component — no separate Data Asset is required.

## Component Properties

<ParamField path="Capsule Height" type="float" required>
  The height of the capsule shape used to check for blocking obstacles in the character's path during the roll. Set this to a value appropriate for the character's crouched silhouette during a slide or roll animation.
</ParamField>

<ParamField path="Capsule Radius" type="float" required>
  The radius of the capsule shape used to detect obstacles ahead of the character. Tune this to match the character's width so the clearance check accurately represents the rolling pose.
</ParamField>

<ParamField path="Layer Mask" type="LayerMask" required>
  Defines which collision layers the component tests against when checking for obstacles and when tracing down to find the target point. Set this to include your environment geometry layers.
</ParamField>

<ParamField path="Rolling Asset" type="Motion Warping Asset" required>
  The Motion Warping Asset containing the roll or slide animation to play. The single Warp Phase within this asset will be driven to the target point found by the component.
</ParamField>

<ParamField path="Roll Max Distance" type="float" required>
  The maximum distance ahead the system will place the target point. The character will roll no farther than this distance in a single interaction.
</ParamField>

<ParamField path="Roll Min Distance" type="float" required>
  The minimum distance ahead required for the target point. If no valid ground point exists at least this far ahead, the interaction is cancelled.
</ParamField>

<ParamField path="Max Fall Off" type="float" required>
  The maximum allowed vertical drop between the character's current position and the target point. If the traced ground point is lower than the character by more than this value, the interaction is rejected — preventing rolls off ledges or into pits.
</ParamField>

## How It Works

The RollComponent executes two sequential trace stages before starting the interaction. Both stages must pass for the roll to proceed.

<Steps>
  <Step title="Check for Blocking Obstacles">
    The component sweeps a capsule (defined by **Capsule Height** and **Capsule Radius**) forward along the roll path. If any collider on the **Layer Mask** intersects the capsule, the interaction is immediately aborted — the character cannot roll into a space it doesn't fit.
  </Step>

  <Step title="Trace Down for the Target Point">
    With the path confirmed clear, the component traces downward from a point ahead of the character (within **Roll Max Distance**) to find the ground surface. The hit position is validated against **Roll Min Distance** and **Max Fall Off**. If no ground hit is found, or if the hit falls outside the allowed range, the interaction is cancelled.
  </Step>
</Steps>

If both stages succeed, the system initiates the roll interaction and warps the character to the detected target point using the **Rolling Asset**.

## Triggering the Interaction

Get a reference to the `RollComponent` on your character, then call `Interact` on the `MotionWarping` component:

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

Call this from your input handler, movement state machine, or ability system when the player triggers a slide or roll action.

## Motion Warping Asset Requirements

Rolling or sliding moves the character from its current position to a single point ahead on the ground, so the **Rolling Asset** requires exactly **one Warp Phase**.

<Note>
  The single Warp Phase maps the character's root motion forward to the ground point discovered by the downward trace. Ensure your roll or slide animation's root motion aligns with this forward direction for best results.
</Note>