> For the complete documentation index, see [llms.txt](https://october-studio.gitbook.io/monster-survivors-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://october-studio.gitbook.io/monster-survivors-documentation/stages/create-a-stage.md).

# Create a Stage

{% stepper %}
{% step %}

## Preparation

As a first step, please make sure you prepared at least a few enemies or have the ones that came with the template. \
If are not sure, take a look at [Add a Simple Enemy](/monster-survivors-documentation/enemies/add-a-simple-enemy.md).&#x20;
{% endstep %}

{% step %}

## Setting up Timeline Window

1. To access Timeline, open it from a top panel:

<figure><img src="/files/eGA5OofOFTjQIU3dqSQZ" alt="" width="375"><figcaption><p>How to access Timeline</p></figcaption></figure>

2. Opened Timeline should look as follows:

<figure><img src="/files/GlPPOo6ahVOtCEIR8our" alt=""><figcaption><p>Timeline window</p></figcaption></figure>

Create a window layout that's most comfortable to you.&#x20;

<mark style="color:yellow;">Make sure that this window stays open and in view.</mark>
{% endstep %}

{% step %}

## Viewing a Timeline File

Let's take a look at a Timeline File:

1. Navigate to ![](/files/FEowFGlTBmm9Xq3kG76v) and select a stage file, for example Stage 1. It should have an icon like this:

<figure><img src="/files/ep5kxjtd5cANStthLsOV" alt=""><figcaption><p>Stage file example</p></figcaption></figure>

2. Open the file. If you did everything correctly in Step 2, the Timeline window should look like this:

<figure><img src="/files/p5nAAk7IAJ7lbw0BkGAx" alt=""><figcaption><p>Opened stage 1</p></figcaption></figure>

<mark style="color:yellow;">To display the timeline in seconds, press the settings button on the Timeline window, and select Seconds:</mark>

<figure><img src="/files/z9i3ExeKXAZVF9ckBuzs" alt="" width="158"><figcaption><p>Timeline settings</p></figcaption></figure>

<mark style="color:yellow;">For the ease of use you can lock the Timeline window, to pin the current stage you're working on. To do this, press the</mark> ![](/files/n4eZMa0JdXcLSZWIxIb9) <mark style="color:yellow;">button, on the top right side of the window.</mark> <mark style="color:red;">If you want to open another timeline, make sure to unlock the window before doing that.</mark>
{% endstep %}

{% step %}

## Creating a Stage

1. To create a Stage timeline, in your desired folder, Right Click > Create > Timeline. \
   Name your Stage timeline.&#x20;
2. Open the file. Timeline window should look like this:

<figure><img src="/files/ztWlq67SrZrahoq79RdA" alt="" width="563"><figcaption><p>Empty Stage Timeline</p></figcaption></figure>

{% endstep %}

{% step %}

## Adding Tracks

Now you can add various enemies, bosses and camera control:

1. Right Click on the empty field on the left, and add a wave track:

<figure><img src="/files/dakINui3C9Suoy29GzI8" alt="" width="364"><figcaption><p>Adding a Wave Track</p></figcaption></figure>

An empty track with preselected enemy will appear:

<figure><img src="/files/CrQEu2gt2R3cg2OuXaxB" alt="" width="274"><figcaption><p>Wave Track Example</p></figcaption></figure>

2. Click on the track. Inspector should display its settings:

<figure><img src="/files/N019SmVJiOlueAJyS0vq" alt="" width="284"><figcaption><p>Wave Track Settings</p></figcaption></figure>

There, choose your desired enemy.

<mark style="color:yellow;">If the enemy you expected doesn't appear in the list, refer to</mark> <mark style="color:yellow;"></mark><mark style="color:yellow;">**Step 4**</mark> <mark style="color:yellow;"></mark><mark style="color:yellow;">of</mark> [Add a Simple Enemy](/monster-survivors-documentation/enemies/add-a-simple-enemy.md)

3. Repeat **Steps 1** and **2** to add as many enemies as you like for this stage.
4. The process is mostly the same for bosses, but instead of separate tracks, you can add all bosses into a single one. To add it, Right Click on the empty field on the left, and choose to add a Boss Track:

<figure><img src="/files/6D1PTDHPRZXFH9IwPsP4" alt="" width="351"><figcaption><p>Creating a Boss Track</p></figcaption></figure>

5. To add optional camera controls, also Right Click on the empty field on the left, and choose to add a Camera Track:

<figure><img src="/files/k4gRHbBwFNWB6Ij4jOyS" alt="" width="362"><figcaption><p>Creating a Camera Track</p></figcaption></figure>
{% endstep %}

{% step %}

## Adding Clips

As you added enemies, bosses or camera controls to you liking, its time to set them up to appear in your stage.

1. On your timeline, hover on a wave track that you want to configure, press Right Mouse, and Add a Wave:

<figure><img src="/files/tMun34c4ET9tjE3JozMh" alt="" width="563"><figcaption><p>Adding a Wave</p></figcaption></figure>

2. This will spawn a wave of your choice. To know more about the waves and other clip types, go to [Clips](/monster-survivors-documentation/stages/tracks-and-clips.md#clips) and [Tracks](/monster-survivors-documentation/stages/tracks-and-clips.md#wave-track).
3. Resize the clip to your liking. To do that, hover over the edge of the clip, and drag it however you need. You can also size it more precisely in the Inspector field, by selecting the clip:

<figure><img src="/files/H5W1Fgumkvo9EsebITh8" alt="" width="286"><figcaption><p>Clip Timing example</p></figcaption></figure>

4. In the same Inspector window you will find spawn settings, that are separate for each individual Wave Clip:

<figure><img src="/files/hCJ6bM9ZamxQeTRDzxgK" alt="" width="283"><figcaption><p>Wave Clip Settings Example</p></figcaption></figure>

<mark style="color:yellow;">By default, all the spawn values will be 1. Make sure to change them in the Inspector according to your liking.</mark>&#x20;

5. Repeat the process for every enemy. To achieve best results, mix and match different Wave Clips, set different values etc. In the end, it can look in this manner:

<figure><img src="/files/7Sy60eHJviGlxl9k2IXJ" alt=""><figcaption><p>Clips in a Typical Stage</p></figcaption></figure>

6. You can optionally add tracks for Boss Fights and Camera Control. Example is also shown on the image above.

<mark style="color:yellow;">You can edit your Stage at any time. If you are not sure how you want it to play yet, you can fast forward to next steps, and come back to it later.</mark>
{% endstep %}

{% step %}

## Creating Stage Data

Next, you need to create a settings file for your Stage.&#x20;

1. First, you need to create a Stage Data file, to hold its settings. To do that, Right Click on in a project folder > Create > Stage Data. Rename your file.&#x20;
2. Open the file. It should look like this:

<figure><img src="/files/lx8OdieB77k3kMRvSY6s" alt="" width="308"><figcaption><p>New Field Data file</p></figcaption></figure>

3. Now, populate the fields to your liking. Check out [Stage Data](/monster-survivors-documentation/stages/stage-settings.md#stage-data) if you are not sure what these fields represent. Assign your newly created Stage Timeline in the Timeline field.

<mark style="color:yellow;">Make sure to set proper values to Enemy Damage and Enemy HP (1 by default).</mark>
{% endstep %}

{% step %}

## Registering a Stage

Now you need to add this Stage Data to the Stage Database.

1. To do that, open the Stage Database file ![](/files/t1YZsze69N9mQCJLlhAK). It should look like this when opened:

<figure><img src="/files/NkxPASKf0Fh8N8S2Tted" alt="" width="310"><figcaption><p>Stage Database</p></figcaption></figure>

2. Here, press the + icon on the bottom of the list. A new field will appear. Click on it and assign the Stage Data that you created.
3. Now you can play the game to test your Stage, and make adjustments in the process.

Have Fun!
{% endstep %}
{% endstepper %}


---

# 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, and the optional `goal` query parameter:

```
GET https://october-studio.gitbook.io/monster-survivors-documentation/stages/create-a-stage.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
