Stages

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

• Standard 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.
• Advanced stages – 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: /sprites and /sounds. 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:

• preview.png [any size, but 16:9 aspect ratio, 960×540 recommended] – used in the preview window on the Steam Workshop website.
• thumb.png [56x40px] – used for the in-game stage select menu.
• thumb_big.png [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 /sounds directory and add or replace music_loop.ogg with an ogg file of your choice. Additional tracks can also be included under the names music_loop2.ogg, music_loop3.ogg, and music_loop4.ogg.

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

Scripting

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