> For the complete documentation index, see [llms.txt](https://docs.motorica.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.motorica.com/documentation/motion-factory/reference/trail-set-manager-reference.md).

# Trail Set Manager Reference

## Trail Set Manager Dashboard

<figure><img src="/files/AytHizesundvOo5GjKMC" alt="An animation program with 5 highlighted callouts for different UI elements."><figcaption><p>Overview infographic of the UI in Trail Set Manager.</p></figcaption></figure>

1. Outliner
2. Gaits
3. Playback Timeline
4. 3D Viewport
5. Trail Editor

## 1. Outliner

<figure><img src="/files/4Mz47gp7icj2e8fUWNGd" alt="A greyed out animation program with one highlighted UI element for an animation file explorer."><figcaption><p>Highlighted diagram of the Outliner in Trail Set Manager.</p></figcaption></figure>

Trails are organized, created, and searchable in the Outliner.&#x20;

Use the purple `+` button to create new trails and folders, or right click in the Outliner's Explorer to create trails and folders in specific locations.

{% hint style="info" %}
You can also create new trails by importing [Pure Root Motion data in a JSON format](/documentation/motion-factory/reference/pure-root-motion-format.md).
{% endhint %}

## 2. Gaits

<figure><img src="/files/kDhqvF8kRCNgNcNMZmwq" alt="A greyed out animation program with one highlighted UI element for Gaits."><figcaption><p>Highlighted diagram of the Gaits section in Trail Set Manager.</p></figcaption></figure>

Gaits are created and organized in the Gaits section.

Every Trail must belong to a Gait. Additionally, `Idle` is a Gait added to every Trail Set by default and does not need to be recreated by the user.

{% hint style="info" %}
You can collapse the Gait section by clicking the double arrow button:            <img src="/files/hwMfO9IE8hJBtGijBPLQ" alt="Two arrows pointed at one another." data-size="original">
{% endhint %}

## 3. Playback Timeline

<figure><img src="/files/n8L4zd5CtcagEg2bAtng" alt="A greyed out animation program with one highlighted UI element for a program&#x27;s playback timeline.."><figcaption><p>Highlighted diagram of the Playback Timeline in Trail Set Manager.</p></figcaption></figure>

Directly control the 3D Viewport's playback of the Trail in real-time. Includes controls for repeating playback and changing the speed of playback.

You can also view and select Trail Segments directly in the timeline and view where each Segment resides in the Trail's runtime.

## 4. 3D Viewport

<figure><img src="/files/530vCTymJqafhUVWhw39" alt="A greyed out animation program with one highlighted UI element of the programs 3D Viewport for previewing trails.."><figcaption><p>Highlighted diagram of the 3D Viewport in Trail Set Manager.</p></figcaption></figure>

Trails are visually displayed in the 3D viewport with a T-posing, unmeshed avatar over selected segments. When using playback, the unmeshed avatar will play through the trail according the Trail and Trail Segment's configurations.

## 5. Trail Editor

<figure><img src="/files/Rv8ALbzYMf5xVl2cfDZy" alt="A greyed out animation program with one highlighted UI element for the editor section.."><figcaption><p>Highlighted diagram of the Trail Editor in Trail Set Manager.</p></figcaption></figure>

The Trail Editor allows you to edit a Trail's overall parameters, individual Segments, and select additional options for looping and Phase Shifting.

### Trail Parameters

<figure><img src="/files/g0Ddwcbw9xkeNb2rQLs0" alt="A dark mode UI element for Trail Parameters: Initial Direction and Root Offset."><figcaption><p>Example of the Trail Parameters section in the Trail Editor.</p></figcaption></figure>

Every Trail includes overall parameters for the Trail's `Initial Direction` and `Root Offset`.

### Trail Segments

Segments are customized in the Trail Segments section of the editor.

<figure><img src="/files/ybfWzmj0KWVkjntmPFUA" alt="A dark mode UI element for displaying an editable Segment, with dropdowns and fields for various parameters.."><figcaption><p>Example of the Trail Segments section in the Trail Editor.</p></figcaption></figure>

|                                              Property                                             | Definition                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| :-----------------------------------------------------------------------------------------------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|                                               `Gait`                                              | The Segment's selected Gait.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|                                             `Duration`                                            | <p>The number of frames within the selected Segment. <br><br>Animations are captured in 30fps.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|                                            `Turn Angle`                                           | The angle which the avatar turns at the start of the Segment.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|                                             `Angspeed`                                            | <p>The angular speed which the avatar turns during the start of the Segment.<br><br>Used to create arcs.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|                                           `Strafe Angle`                                          | <p>The angle which the avatar faces when performing movement. For example, enabling this property forces the avatar to face <code>0°</code>.<br><br>When disabled, the avatar faces the direction of their movement by default.</p>                                                                                                                                                                                                                                                                                                                                                                                    |
|                                         `Speed Multiplier`                                        | <p>The multiplier of the Segment's speed.<br><br>Used to create speed variations within the same Trail without using different Gaits.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|                                            `Post Turn`                                            | <p>Controls when the avatar begins rotating when carrying out a turn specified by <code>Turn Angle</code>.<br><br>There are 3 available values: <strong><code>0.0</code></strong> (pre-turn), <strong><code>0.5</code></strong> (default), and <strong><code>1.0</code></strong> (post-turn).<br><br><strong><code>0.0</code></strong> starts rotation before the avatar's change in direction starts.</p><p></p><p><strong><code>0.5</code></strong> starts rotation when the avatar changes direction.</p><p></p><p><strong><code>1.0</code></strong> delays rotations until after the avatar changes direction.</p> |
|                                           `End Angspeed`                                          | <p>The angular speed which the avatar turns at the end of the Segment.<br>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|                                      <br>Used to create arcs.                                     |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| When disabled, <code>End Angspeed</code> defaults to the same value as <code>Angspeed</code>.</p> |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

### Trail Options

<figure><img src="/files/nYx4oAOZIagrWVNlEuag" alt="A dark mode UI element for additional option when editing a trail: Looping and Phase Shifting."><figcaption><p>Example of the Options section in Trail Editor.</p></figcaption></figure>

Additional options include: turning the Trail into a looping animation, and enabling Phase Shifting to create animation variations with the Trail. A Trail cannot use Phase Shifting while also being a looping animation.

{% hint style="info" %}
You can collapse the Options section by clicking the double arrow button:            <img src="/files/hwMfO9IE8hJBtGijBPLQ" alt="Two arrows pointed at one another." data-size="original">
{% endhint %}


---

# 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://docs.motorica.com/documentation/motion-factory/reference/trail-set-manager-reference.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.