Stages

Custom stages can be created directly in the game’s Stage Editor by selecting  in the Workshop menu. There are two types of custom stages:


 * – Allows you to use in-game assets to create a tiled stage quickly and easily. Ideal for prototyping your layouts before turning them into a fully-featured Advanced stage.
 * – Allows you to skin your creations with custom graphics and more. You can change any Standard stage into an Advanced stage by toggling the setting in the editor’s Stage Parameters menu. Additionally, custom scripting is supported on Advanced stages.

Advanced custom stages are structured similarly to other custom items, with config.ini and the following folders:  and. You can read more about this structure in the File Structure page or use the default blank stage template in the editor program.

For Advanced stages, the core stage folder should also include:


 * [any size, but 16:9 aspect ratio, 960×540 recommended] – used in the preview window on the Steam Workshop website.
 * [56x40px] – used for the in-game stage select menu.
 * [242x130px] – displayed in the large preview window when hovering over a stage in the stage select menu.

You can read more about stage art on the Stage Sprites page.

Background Music
Custom stages have access to all stage music from the game soundtrack in the editor’s Stage Parameters menu, and also support up to 4 custom tracks like the base stages.

To add a custom track, go to the  directory and add or replace   with an ogg file of your choice. Additional tracks can also be included under the names,  , and.

The game will randomly select one of these ogg files to use as the background music when the stage begins.

Stage Articles
Stage articles behave similarly to normal articles, with some differences. For a reference on how articles work, check the Articles page.

Custom stages have access to 3 types of stage articles:,  , and. The type of article created as well as the script set it uses (, , etc.) is dependent on spawners placed in the stage editor; the script set used is determined by the spawner number and the type of article is changeable in the editor’s properties menu.

In addition to all of the variables shown in the normal articles page, stage articles also have these variables:

Scripting
Visit the Stage Scripting page to learn more about writing code for Advanced stages.