> For the complete documentation index, see [llms.txt](https://kinemation.gitbook.io/motion-warping-for-unity/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kinemation.gitbook.io/motion-warping-for-unity/components/roll-component.md).

# Roll Component

## Overview

This component is used to move the character forward. Perfect for Sliding or Rolling mechanics. Make sure to add it directly to your character:

<figure><img src="/files/tifk38PB0lGvS7O52U9g" alt="" width="433"><figcaption><p>Inspector.</p></figcaption></figure>

* **Capsule Height/Radius:** used for capsule trace to find an obstacle.
* **Layer Mask:** used to filter collision targets.
* **Rolling Asset:** Motion Warping Asset with rolling animation.
* **Roll Max/Min Distance:** max/min allowed movement distance.
* **Max Fall Off:** max allowed vertical offset for the target point.

## How does it work?

This component uses 2 stages to trace down the target point:

1. Try to find a blocking obstacle in the way. If an obstacle found, abort the interaction.
2. Trace down to find a target point. If no hit, stop the interaction.

After that the interaction will be initiated.

## Motion Warping Asset Requirements

Only 1 Warping Phase is required for this component to work properly.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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