removed a few useless DEBUG_MSGs :)
[supertux.git] / LEVELDESIGN
1
2 This document describes both the level format and
3 the level editor.
4
5 = LEVEL FORMAT =
6
7
8 HEAD:
9 --------
10
11 1. Name of the level.
12 2. The theme of the level. The game will look in "supertuxdir/data/images/theme"
13 3. The time you have to finish the level.
14 4. Defines the music file, which should be played.
15 5,6,7. RGB values for the background of the level.
16 8. Defines the level's length.
17
18 Example:
19 ----------
20 Antarctica
21 antarctica
22 240
23 ji_turn.it
24 128
25 192
26 255
27 375
28
29 MAIN:
30 -------
31  
32 Levels are created with the following characters:
33 (15 lines and as many columns as defined in the seventh line of the levelfile)
34
35 X/x <- Brick0
36 Y/y <- Brick1
37 A/B/! <- Box full
38 a <- Box empty
39 C-F <- Cloud0
40 c-f <- Cloud1
41 G-J <- Bkgd0
42 g-j <- Bkgd1
43 # <- Solid0
44 [ <- Solid1
45 = <- Solid2
46 ] <- Solid3
47 $ <- Distro
48 ^ <- Waves
49 * <- Poletop
50 | <- Pole
51 \ <- Flag
52 & <- Water
53
54 Bad guys:
55
56 0 <- BluescreenOfDeath
57 1 <- Laptop
58 2 <- Money
59
60 = BUILT-IN LEVEL EDITOR =
61
62
63 //FIXME: Check if all the informations are still valid, when releasing 0.0.6.
64 USING THE BUILT-IN LEVEL EDITOR:
65 --------------------------------
66
67 The built-in level editor can already be used for
68 production, but more advances are expected in the
69 future, including a mouse driven interface.
70
71 When opening the leveleditor, a menu will appear. This
72 menu can be used to add, edit, load, save and test levels.
73
74 Menu entries:
75 - Return to Level Editor - just closes the menu and goes
76 to the editing mode. To come back to the menu, press Esc.
77 - New Level - creates a new level. The number of the level
78 is showed in the upper left part of the screen. The level
79 file are currently placed on data/levels/default.
80 - Test Level - if you want to test the current level, use
81 this option.
82 - Level Settings - this allows you to edit the header of the
83 file (as described in the beggining of this document). An
84 important field is the 'Level width' that allows you to
85 adjust level's size.
86 (Warning: there are some characters that do not work, cause
87 they are not supported by the fonts)
88 - Load Level - goes to a given level number.
89 - Save Level - saves the current level.
90 - Quit Level Editor - goes back to SuperTux's main menu.
91
92 Editing mode:
93 To edit the level, you'll have to use the mouse or the
94 keyboard to control the red cursor, using the keyboard
95 to change tiles. Tiles keys are the same used by the
96 level format, listed above. You can check them in the fly,
97 pressing F1. I'd suggest you to print the above list of keys.
98 In the future, a mouse interface will be introduced.
99
100 To go back to the menu, just press Esc.
101
102 Now, do lots of levels and HAVE FUN!!
103
104 Please, send your levels or any art you created to the SuperTux's
105 mailinglist or to the maintainer (look at AUTHORS.txt).
106
107
108 SuperTux developers