2 - Level editing for SuperTux -
3 http://super-tux.sf.net/
5 Last update: April 26, 2004
7 This document describes both the level format and
12 The level format used to be pretty easy to understand, but it
13 is now more complex. Anyway, should be pretty useful to know
14 a bit of it, when you want to do stuff just as to just change
15 the author's name or something small.
17 It uses the Lisp syntax and is pretty intuitive. Here have a
19 (Comments can be made using ';')
23 ; some level info: version, author and the level's name
25 (author "Ingo Ruhnke")
27 ; number of tiles used (currently the height has to be 15)
30 ; Tux's start position
33 ; Background image; if none is specified, the color below will be used
36 (music "Mortimers_chipdisko.mod")
37 ; Colors, as you can see you can have different colors in the top
38 ; and in the bottom, thus creating a gradient
43 (bkgd_green_bottom 120)
45 ; Time (it is not in seconds!)
47 ; Gravity to be used (you should let it stay in 10 for ordinary levels)
49 ; The particle system draws images that simulate weather effects
50 ; As of the writing of this text, both "snow" and "clouds" are supported
51 (particle_system "snow")
52 ; Theme is the tileset that is used
55 ; here goes a lot of numbers that are the tiles places
57 ; Reset points; there can be more than one
58 ; Reset points are positions where the player passes through and
59 ; if he dies, he will be back to there. They are invisible
61 (point (x 6988) (y 222))
63 ; Objects include enemies, may include more stuff in the future
64 ; just as moving plataforms...
66 (mriceblock (x 13919) (y 384))
67 (mriceblock (x 14258) (y 366))
68 (mriceblock (x 12996) (y 248))
69 (mriceblock (x 13058) (y 250))
70 (mriceblock (x 12933) (y 245))
77 USING THE BUILT-IN LEVEL EDITOR:
78 --------------------------------
80 When opening the leveleditor, a menu will appear. This menu
81 can be used to select or add level subsets. A level subset is
82 a collection of levels. Subsets can be chose during gameplay
85 After selecting the subset, have a look at the level editor.
86 The button bar in the right is the place where you can control
87 the actions related with editing. You can select levels and add
90 To select tiles (foreground or background) and enemies, the button
91 bar is the right place. There you can also save, test and setup
92 the level. It is also possible between two selection cursors! Give
93 a try to both. A right click in a button bar button will give you
94 a description and a shortcut for it.
96 To change a tile, just press the tile you want to change with a
97 left mouse click. The current tile will be used. Depending
98 on the selection behavior, you can or not select more
101 To scroll, you just have to point over the two arrow buttons, or
102 use the right button click.
104 There is a small help that can be reached by pressing F1.
106 To go back to the menu, just press Esc.
108 The levels are saved under a .supertux/levels directory in
115 FlexLay is an external project (it even uses different libraries)
116 that is developed by Ingo Ruhnke and supports a lot of different
117 games, including SuperTux (or else we wouldn't mention it :) ).
119 Anyway, it is pretty easy to use and is a lot more advanced than
120 the internal one. So, if you are considering doing a few levels
121 for us, it would be a good idea to check this out.
123 Its webpage is located at:
124 http://pingus.seul.org/~grumbel/flexlay/
126 It needs ClanLib and a few odd libraries... Anyway, it worths
129 The only cons it has is that you have to have an accelerated
130 videocard (with the drivers working, obviously). For linux,
131 we advise nvidia videocards with the use of nvidia's closed
132 drivers. ATI drivers should be enough to run this game though.
137 To sum up, go build lots of levels and HAVE FUN!!
139 Please, send your levels or any art, including sketches, you
140 have created to the SuperTux mailing list.
143 - SuperTux developers