Skip to content
Documentation
On this page

Playing levels

Pick a level in the level list, set the run conditions and start it. Someone else's level is a plain folder: copy it into the levels folder and refresh the list

ButtonWhat it does
Levelsthe list of levels, described below
Editorthe level editor, Getting started
Sandboxan arena with no level and the tutorial, Sandbox and tutorial
Settingsevery setting, Settings
Storydoes not work yet
Multiplayerdoes not work yet

The level list

Levels in the main menu opens the list of levels. Levels come from three places:

  • My Levels - the levels folder, Installation
  • Built-in - the levels that come with the game
  • Workshop - Steam builds only. It shows the levels you are subscribed to. Collections of resources you are subscribed to are not levels: they show up in the editor's library, Library and collections

At the top there are the search field, Sort, View (grid or list) and Filters. The list opens as a grid. You can sort by Best match, Name, Length, Progress and Recent. The arrow next to the sort button (Reverse order) turns the order around. Best match has no direction

The search looks at level names first, then at authors, then at tags

Filters opens a window with more filters. The list behind it changes as you press:

  • AI content - With AI, Without AI and Not specified
  • Length - shortest and longest level, plus whether to show levels whose length is unknown
  • Progress - Not played, Started, Cleared, Cleared by a bot
  • Played recently - the last 24 hours, 7 days or 30 days
  • Age rating - the highest age rating to show
  • Other - hide levels with a password, hide levels from a newer version of the game
  • Tags - press a tag once to require it, twice to exclude it

Progress and Played recently are only in the main menu's list. The editor's list has its own filters. The button shows how many filters are on, and Reset filters turns them all off. Filters stay set until you close the game

Copied a level into the folder? Press Scan again and the list updates

A lock on a card means the level is protected by a password

A hold or a right click on a card opens a menu: Open and Delete. Delete on a Workshop level unsubscribes you from the item and deletes its files. This needs Steam running: otherwise Steam downloads the level again. Built-in levels cannot be deleted

Adding someone else's level

A level is a plain folder of files. You can archive it and send it to a friend

A folder. Copy the level folder into levels and press Scan again. Copy the level folder itself: the one holding level.json (or level.blob) and metadata.json

An archive. Open the editor and create a new level with the Level Archive generator. Then pick the file with the Choose Level Archive... button

FileResult
.zip, .tar.gzopens
.zip with its own password, .zip.gpg, .tar.gz.gpgopens after protected, enter the password and press again
.7zrefused for now. Repack it as a zip
anything elserefused, Troubleshooting

A renamed archive still opens: the game recognises the format by the file's bytes. An archive from an older version of the game is updated on import

By default an imported level gets an id of its own. So it does not overwrite a level that is already on the device

More - How to share a level by hand

The level screen

The level screen shows the cover, the authors, the description and the music author. It also has the Authors and Licenses buttons

The author's name and the music line open their own link if the level's metadata holds one

The age rating is set by the level's author. The game does not check it

"Contains AI-generated content" appears when the author declared that the level, its cover or one of its resources was generated by AI. This is also the author's own declaration. No such line does not mean "no AI": the author may simply not have said anything

Before a run you can pick the conditions:

ConditionChoices
LivesZen (the run never ends), One life, Three lives, Custom (a slider up to 16)
Speed0.5, 1.0, 2.0, Custom (a slider up to 2). The level and the music change together
Checkpointson or off, Damage and lives
No Collisionon or off. The avatar passes through everything, Damage and lives
BotNo Bot, Reflex Bot v1, Warm Bot v1, Bots
Player Seeda number, Randomize, Clear. 0 - a new seed every run, Determinism

Play starts the run

The pause has Continue, Restart, Restart from Checkpoint (once a checkpoint is reached), Settings, Back to Options and Back to Menu. Back to Options returns to the level screen with the conditions the run was started with, or to the editor's Play tab if the run was started from there

The result window

The window shows Passed or Failed and three sections: Progress, Damage and Conditions

  • rows: Completed, Checkpoint reached, Time, Level length, Hits taken, Lives left, Longest clean streak
  • run conditions: Speed, Lives, Bot, Seed, Checkpoints. For a No Collision run, Lives gets · No collision added
  • buttons: Restart, Restart from Checkpoint, Settings, Back to Options, Back to Menu

By default the window does not open on a loss. Instead the run rewinds to the last checkpoint. To change this - Settings → Interface → Open Menu on Lose

Records

The level screen has a record block: Best, Attempts and Cleared (or Never played)

Each set of conditions has its own record: lives, speed, checkpoints, collisions and the bot. The block shows the record for the conditions selected right now. Attempts and clears are counted for any run

How a record is chosen - Statistics

Difficulty

In the list, a level's difficulty is an icon at the start of the line under its name, before the length. The level screen shows the icon and the tier's name beside the age rating

The tier is set by the level's author. A moderator who republishes the level may change it. A level with no tier shows no icon: it is Not rated

IconTier
difficulty-autoAuto - the level plays itself, no input needed
difficulty-drizzleDrizzle
difficulty-rainRain
difficulty-downpourDownpour
difficulty-hailHail
difficulty-barrageBarrage
difficulty-onslaughtOnslaught
difficulty-delugeDeluge
difficulty-infernoInferno
difficulty-singularitySingularity

The tiers go from the easiest to the hardest. For now the scale ends at Singularity. Harder tiers will come later, built from the levels people actually make

Card markers

MarkerWhat it means
Not subscribedthe workshop folder is on disk, but you are not subscribed to it. Visible only when Settings → General → Show All Found Content is on
Offlinethe level source did not answer
Newer version, From a newer version of the gamethis version of the game will not open the level, Troubleshooting
No level filethe folder has no level.json, so the level cannot be started, The level folder and backups
No metadatathe folder has no readable metadata.json. The card shows the folder name, and the level plays, The level folder and backups

Deleting a level

Hold or right-click a card → Delete. The game asks for confirmation first

Along with the level you can delete its statistics (Also delete statistics) and backups (Also delete backups)

Deleting a protected level needs no password