Cascada's itch page contains a web-based version of the level editor used to construct the holes which ship with the game. Using this editor you can make your own holes, and can apply for them to be included in additional level packs releases for others to play as well.

Getting Started

• Start from scratch or use the Import window to copy-paste in the data from an existing hole.
  • The level data for the holes which ship with the game can be copied from https://github.com/timboe/Cascada/tree/main/Source/holes
• Give the hole a name, creator, and specify its round and hole numbers.
  • The round number should be 7 or greater as the game currently ships with 6 rounds.
  • Rounds can have up to 9 holes, the hole numbers within a round must count up from 1 without any gaps.
• Choose one of the 7 waterfalls and one of the 4 falling water patterns.

Side-loaded holes cannot have custom backgrounds and will not have hole previews from the hole-select menu. In order to get these you will need to submit your custom hole for inclusion in a future level-pack. See below for details.

Building the Hole

• Construct your hole from static, elliptic and linear-path obstacles.
  • Left click and drag or use the arrow-keys to move the selected obstacle.
  • Right click and drag to rotate obstacles.
  • Press the Clone button or the 'c' key to make a copy of the selected obstacle.
  • Press the Remove button or the 'Delete' key to remove the selected obstacle.
• The green dot centred on the cursor represents the size of the in-game marble.
• A valid hole must contain at least one Required obstacle.
• Use the 'Waterfall Height' slider to set the vertical size of your finished hole, this must be sized between 1 and 4 playdate screens (240 to 960 pixels).
• Set the number of shots required to obtain Par for your hole.

Side-loading the Hole

• Press the Export button and copy-paste the JSON hole data into a text file with the specified name.
  • For example, if you are creating hole 1 for round 7 then the JSON data must be copied into a text file with the name: round_7_hole_1.json
• Make sure that you have loaded Cascada on your Playdate at least once, this will create the game's data folder on the device.
• Plug your Playdate into your computer via USB and boot into data disk mode.
  • From the home screen, go Home -> Settings -> System -> Reboot to Data Disk -> OK.
• Use your computer's file browser to open the Playdate disk and find Cascada's data folder.
  • Go Playdate -> Data -> uk.co.tim-martin.cascada
• Copy your custom hole files into this directory.
• Eject the Playdate disk from you computer.

Play

• Your custom holes will now appear in the game as additional rounds!

Distribute

• If you would like for your hole to be considered for a level-pack update to the game, then send the hole JSON data to cascada@tim-martin.co.uk
• Holes built into level-pack releases of the game can have custom backgrounds (unlike side-loaded holes), if your hole is designed to have a custom background then send the image as well. The image must be 400 pixels wide and between 240 and 960 pixels long. The image must be licenced under a permissive licence which allows for its redistribution.