# Cutscene

## Creation

To create a cutscene, find (or create) the *GameName/Resources/GameName/Cutscene* folder in the project tab and right click.  Choose *Create > AnyRPG > Cutscene*.

## Properties

| Name                       | Description                                                                                                       |
| -------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Repeatable                 | If true, this cutscene can be played more than once.                                                              |
| Require Player Unit Spawn  | If true, the player unit must be spawned in the world for this cutscene to play.                                  |
| Use Default Faction Colors | If true, player faction will be ignored, and default faction relationship colors will be used for health bars.    |
| Timeline Name              | The name of a Unity Timeline to trigger when this cutscene is played.                                             |
| Load Scene Name            | The name of a scene to load to play this cutscene.                                                                |
| Unload Scene On End        | If true, the scene that was active before the cutscene played will be loaded when the cutscene ends.              |
| Auto Advance Subtitles     | <p>If true, the subtitles will be played automatically.<br>If false, the timeline will control the subtitles.</p> |
| Subtitle Properties        | [Subtitle Properties](#undefined)                                                                                 |

### Subtitle Properties

| Name               | Description                                                                                                                                                                                                                                                                                                           |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Audio Profile Name | The name of an audio profile to play when the cutscene is started.                                                                                                                                                                                                                                                    |
| Subtitle Nodes     | <p>A list of subtitle text and times.<br><strong>Start Time</strong><br>The time, in seconds after the start of the cutscene, to show the text.<br><strong>Show Time</strong><br>The time, in seconds, that the text should be active after being shown.<br><strong>Description</strong><br>The text to be shown.</p> |

## Next Steps

* Configure a [Scene Node](/scriptable-objects/scene-node.md) to automatically play a cutscene when the scene loads.
* Configure a [Cutscene Interactable](/scriptable-objects/interactable-option-configurations/cutscene-config.md) option to play a cutscene when interacted with.


---

# 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://docs.anyrpg.org/scriptable-objects/cutscene.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.