Add-ons are extensions for SuperTux which are distributed separately from the main distribution. In most cases, they are sets of levels contributed by users or groups of users. They may, however, include custom [[tilesets|Tileset]], which may give these levels a very distinct look.

Add-ons can be downloaded from within SuperTux. Simply ensure you have an internet connection, and select “Addons” from the main menu, where you can choose to install the currently available add-ons.

The addons are managed in two repositories:

addons contains the .zip files that are downloaded by SuperTux, while addon-src contains the levels in extracted form to make it easier to modify and debug them.

The process of updating the addons repository is documented at:

https://github.com/SuperTux/addons/blob/master/README.md

Manual installation

If you cannot use the Add-on manager for some reason (for example if you built SuperTux without libcurl), you can download the add-ons, which are distributed as .zip files. Just copy the file(s) to your SuperTux 2 config directory (~/.supertux2/ on UNIX / Linux, %USERPROFILE%\supertux2\ on Windows).

$ wget -P ~/.supertux2 $ADDON_URL

Creating Mods

So you've played SuperTux, beating all the levels, including the bonus levels, and now you want more. Happily, you're in luck. The Supertux Fan Site had loads of levels but supertux.info/pmlvls.php is no more. But now you want to actually play them, instead of looking at the screenshots, or create your own fun levels. These instructions are for you.

Creating Levels

Levels are created in different ways depending on which version you are using, as the format changed between 0.1.x and 0.3.x. Also, 0.3.x has a separate editor and game. Anyway, these will create some .stl files for you to enjoy.

SuperTux 0.1.x

Create as many levels as you want using the built-in editor. Try reading the editor help first by pressing F1.

Creating Worldmaps

There's another editor from http://roofrabbit.com/supertux.html#editor written in VB that you can use to create worldmaps, or you could try to use FlexLay.

SuperTux 0.3.x

Download the SuperTux Editor from Download/Unstable. The Editor FAQ might be helpful. Alternately, you could create 0.1.x levels and then modify them using a text editor or the Scheme converter script into version 2 levels. See the File formats page for details.

Packaging Levels

Once you've made these beautiful levels, you want to let the world see them. Just follow these easy steps, which will make archives usable directly as addons for 0.3.x and allow one-step unpacking in 0.1.x:

Pick a “meaningful name”. This name will be used as file and directory name - the user won't get in touch with it. So pick a short but descriptive name. Your name or acronym should be sufficient, for example. Here, we will use my-levels as example.
Create a new directory hierarchy: levels/my-levels
Copy your levels (*.stl files) into your that folder.
If you made a worldmap, you have to put it
- 0.1: in levels/worldmaps/ as my-levels.stwm, or
- 0.3: in your levels/my-levels/ as worldmap.stwm.
To make it an addon, create a my-levels.nfo text file in the top level of your directory hierarchy and fill it with the following information. See the #.nfo files section below for details.

(supertux-addoninfo (kind “<Type:Level,LevelSubset,World,...>”) (title "

Add-ons.md 7.8 KB Histórico Raw