Level Editor
There are various videos on the internet documenting the use of the built-in level editor. This is a list of some of the useful ones. However, due to the nature of the internet this list is probably incomplete. You're always welcome to add new ones!
- 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
When you finished a level or even more, there is an easy way to share it to the SuperTux community.
You can find them at C:\Users\YOUR-USERNAME\AppData\Roaming\SuperTux\supertux2\levels\YOUR-LEVELSETNAME\ on Windows 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. Additionally, there will be a file called worldmap.stwm, if you made a world. The last 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) )
Title: The name of your add-on that should be displayed. Description: A short description about your add-on. For example you can type in your nickname or the difficulty of your levels. 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. So just leave it #f.
If you are adding textures, you have to pack your levels as an add-on, otherwise just go on to step 2. An add-on needs a .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") )
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 don't set it to 1.1 or something. Type: Use "world" or "worldmap" if you created a worldmap and "levelset" if you don't. Title: The title of the worldmap. Author: Your name/nickname. License: Leave it like this to allow sharing and modification of your worldmap.
Put the images in an image folder in the same way the normal SuperTux images are. You can find them at C:\Program Files\SuperTux\data\images\ (Windows) or /usr/share/supertux2/images/ (Linux). The levels, the worldmap and the "info"-file must be in a folder called levels/WORLDMAP-ID/ and the WORLDMAP-ID.nfo mustn't be placed in any folder. It should look like this example add-on:
If you don't add any textures, select all files (Ctrl+A) and compress them as a .zip-archive. However, if you are adding textures, select the "levels" folder, the "images" folder and the "WORLDMAP-ID.nfo" and compress them as a .zip-archive.
Just sign in at FreeGameDev.net and create a new topic at the 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.
Do you still have questions? Visit the SuperTux forum on FreeGameDev and ask!