- moved the global_world into the leveleditors namespace

[supertux.git] / LEVELDESIGN

diff --git a/LEVELDESIGN b/LEVELDESIGN
index 1c4c811..9960db4 100644 (file)
--- a/LEVELDESIGN
+++ b/LEVELDESIGN
@@ -1,15 +1,24 @@
+
+This document describes both the level format and
+the level editor.
+
+= LEVEL FORMAT =
+
+
 HEAD:
 --------
 
 1. Name of the level.
-2. The time you have to finish the level.
-3. Defines the music file, which should be played.
-4,5,6. RGB values for the background of the level.
-7. Defines the level's length.
+2. The theme of the level. The game will look in "supertuxdir/data/images/theme"
+3. The time you have to finish the level.
+4. Defines the music file, which should be played.
+5,6,7. RGB values for the background of the level.
+8. Defines the level's length.
 
 Example:
 ----------
 Antarctica
+antarctica
 240
 ji_turn.it
 128
@@ -40,4 +49,51 @@ $ <- Distro
 * <- Poletop
 | <- Pole
 \ <- Flag
-& <- Water
\ No newline at end of file
+& <- Water
+
+Bad guys:
+
+0 <- BluescreenOfDeath
+1 <- Laptop
+2 <- Money
+
+= BUILT-IN LEVEL EDITOR =
+
+
+USING THE BUILT-IN LEVEL EDITOR:
+--------------------------------
+
+When opening the leveleditor, a menu will appear. This
+menu can be used to select or add level subsets.
+A level subset is a collection of levels. Subsets can be chose
+during gameplay when starting a game.
+
+After selecting the subset, have a look at the level editor.
+The button bar in the right is the place where you can control
+the actions related with editing. You can select levels and add
+throught there.
+To select tiles (foreground or background) and enemies, the button
+bar is the right place. There you can also save, test and setup
+the level. It is also possible between two selection cursors! Give
+a try to both.
+A right click in a button bar button will give you a description
+and a shortcut for it.
+
+To change a tile, just press the tile you want to change with a
+mouse left click. The current tile will be used. Depending
+on the selection behavior, you can or not select more
+than one tiles.
+To scroll, you just have to point over the two arrow buttons, or
+use the right button click.
+
+There is a small help that can be reached by pressing F1.
+
+To go back to the menu, just press Esc.
+
+Now, do lots of levels and HAVE FUN!!
+
+Please, send your levels or any art you created to the SuperTux's
+mailinglist or to the maintainer (look at AUTHORS.txt).
+
+
+SuperTux developers