If you like what I do and want to support me, send a $ tip on ko-fi!

Thumper Custom Level Editor

Download the latest release
How to use the editor: https://youtu.be/bxDgG2yeUk8
You can find help and additional resources on the Thumper Discord here:

First Time Running

When you first launch TCLE 2.2, you will be greeted with this screen

You will want to say YES to this, unless you don't want your "track_objects.txt" file to be updated (in case you have custom objects in it you don't want overwritten)

Feel free to read the changelog to get a feel of what has all changed!

The UI

The interface may seem confusing and busy at first, but you will learn it pretty quick. It is not difficult.
The majority of buttons can be hovered on to display a tooltip about what it does.

Some areas also have Blue question marks which can also be hoevered or clicked.

The entire interface can be moved and resized as you wish. The areas in between panels is draggable.

In addition, the panels can be undocked and moved about freely by pressing the blue arrow in their title bars to undock it. And then it can be dragged around by its title bar.


And can be resized using the control in the bottom-right

If a dock is empty, you can chose to dock another panel in its spot

And if you mess up your view a lot and its a big pain, go to VIEW > Reset Docks to get back to normal

You can customize the look and keybinds of the Editor too. Go to EDIT > Preferences

Each panel can be colored differently. And to change a keybind, just click on it.

Creating your first level

Go to FILE > New Level Folder

File in the details of your level however you like.

Keep in mind, when you set the file path, a NEW folder will be created inside that location using the Level Name

So then I will have X:\Thumper\levels\My First Level\ and all the relevant files for the custom level will be in this location.
Then click SAVE.

Understanding the File Hierarchy

There are a few different files that make up a custom level, and it is important to know how they all related to each other. The file types are

• Leaf

• Lvl

• Gate

• Master

• Sample

• Leaf files are the building blocks of everything. They contain all the data of where objects will spawn and how the track moves and bends. You can think of them as a "pattern" or a "bar" in music. They are typically short, which enables them to be reused if you want the same pattern to show up multiple times throughout a level.

• Lvl files combined multiple leafs into a single sequence, and are typically used to denote 1 single sublevel. Lvl files are also where you can add tunnels, loop tracks, and do volume sequencing.

• Gate files are boss levels. They take 4-5 lvls (Depending on the boss). Each lvl becomes 1 phase of the boss.

• Master files are used to structure the entirety of the custom level. You add lvl and gate files here to setup your sublevels in order. The master also is where you can set level BPM and skybox, as well as checkpoint and rest lvls.

• Sample files hold all of the samples your custom level may reference. If it doesn't exist in a samp file, your level cannot play that sound. You can also add custom sounds/external audio through the Sample Editor panel. There are preset sample packs you can pick from when creating your custom level. Each one comes from a different main game level and work at different BPMs to sound correct.

Creating Files

To add a file to the project, click the blue file icon in the Working Folder panel, and choose one of the file types

Name it however you want, and then you will see it shows up in its respective editor panel, and the Working Folder. I chose Leaf in this exampe, but it works the same for all the others.

Mod Loader

Along with the level editor, you will need the Mod Loader
github page