Level Editor

The built-in Level Editor provided by the game is a great and easy way to make your own levels and worldmaps which you can share separately or as Add-ons with the community.

There are various guides on the internet documenting how to use the level editor. We have provided a list of several video and text based guides (as well as our own) for you to check out if you are in need of help. You're always welcome to contribute your own, too!

Note: Some of these may be incomplete or out-dated and it is out of our hands whether the author will provide an update or not!

Text Tutorials

• Official Guide by SuperTux Team
• v0.6.0 Guide by Ordoviz

Video Tutorials

• Basic Tutorial by brmbrmcar
• Advanced Tutorial by brmbrmcar
• Basic Tutorial (Part 1/2) by Oliver Buo
• Basic Tutorial (Part 2/2) by Oliver Buo
• Advanced Tutorial (Part 1/2) by Oliver Buo
• Advanced Tutorial (Part 2/2) by Oliver Buo
• Expert Tutorial by Oliver Buo

---

Sharing Levels

When you finished creating a level or even more, it is possible to share your creations with the SuperTux community.

Upload your work to the SuperTux Forum or share it on our Discord Sever. You can also create your own Add-on for the game by submitting it to our Add-on Manager!

You can find the respective links here.

Getting The Relevant Files

You can find your levels at C:\Users\YOUR-USERNAME\AppData\Roaming\SuperTux\supertux2\levels\YOUR-LEVELSETNAME\ on Windows, ~/Library/Application Support/SuperTux/ on macOS or /home/YOUR-USERNAME/.local/share/supertux2/levels/YOUR-LEVELSETNAME/ on Linux.

There should be some files called level1.stl, level2.stl and so on, depending on the number of levels you have created. Those files contain the actual levels you created.

If you have created a worldmap, there will also be a file called worldmap.stwm. That file stores the content of the worldmap.

The info File

Another file should be called info without any file ending. It contains the following code:

(supertux-level-subset
  (title (_ "Name that should be displayed"))
  (description (_ "A short description"))
  (levelset #f)
  (hide-from-contribs #f)
)

Property	Description
title	The name of your add-on that will be displayed to players. This can be translated with a .po language file.
description	A short description about your add-on. Write a short summary. This can be translated with a .po language file.
levelset	Use #f if you created a worldmap and #t if you didn't.
hide-from-contribs	If this is set to #t, your levelset won't show up in-game. This should only be used internaly in SuperTux, so just leave it #f.

The .nfo File

Every Add-On needs an .nfo-file which looks like this:

(supertux-addoninfo
  (id "Worldmap-ID")
  (version 1)
  (type "world")
  (title "Your Worldmap Name")
  (author "Your Name")
  (license "CC-by-sa 4.0")
)

Property	Description
id	The ID of your worldmap. You are only allowed to use letters, _ (underscore) and - (minus). To avoid having two add-ons with the same ID, call it yourname_name-of-your-worldmap. The .nfo file should be named after your ID.
version	If you updated your worldmap, count up. Only whole numbers are allowed, so do not set it to 1.1 or something.
type	Use world or worldmap if you created a worldmap and levelset if you did not.
title	The title of the worldmap.
author	Your name or nickname.
license	Leave it like this to allow sharing and modification of your worldmap.

---

Creating The Add-On Structure

To have a working Add-On, you will need to structure it similar to the structure described below. That way you can also replace or add game assets of your own without causing compatibility issues with other Addons (or even Story Mode) that do not have these assets available.

Note that if some directory or file is placed between brackets, like [worldmap.stwm], those brackets are not part of the filename. They indicate that this is optional and only necessary in some cases. [...] means that there can be some files, but we won't specify a name or file extension here.

├── [images]
│   └── [...]
├── levels
│   └── YOUR-WORLDMAP-ID
│       ├── level1.stl
│       ├── level2.stl
│       ├── [...].stl
│       ├── info
│       ├── [worldmap.stwm]
|       └── [...].po
├── [music]
│   └── [...]
└── YOUR-WORLDMAP-ID.nfo

Put all graphics in an images/ directory, all sounds in a sounds/ directory and music into a music/ directory, as shown above.

To help you properly structure and plan this, you can take a look at the structure for such files used within SuperTux. You will find them at C:\Program Files\SuperTux\data\ on Windows or /usr/share/supertux2/ on Linux. But be careful, as the file locations in the levels must match the directory structure you create!

Compressing Add-Ons As A .zip-Archive

Select the levels-directory, the .nfo-file - and if you added additional content - those directories and compress them as a .zip-file.

Now the player can simply save this file in supertux2/addons/ and enable it in-game in the "Add-ons" menu by checking the checkbox.

Uploading The Add-On

Now you can upload your file. We recommend creating a new topic at the Levels & Add-ons forum.

Describe your worldmap, and add one or two screenshots, depending on the number of levels you created. Then attach your .zip-file to the post. Caution: Files larger than 2MB in size cannot be uploaded there.

---

Questions? Problems?

Do you still have questions? Or do you experience any problems? Just contact us and ask.