+<sect1><title>Worldmaps</title>
+<para>Worldmaps are basically level files with a few nuances.</para>
+
+<sect2><title>Basic worldmap syntax</title>
+<para>It's time for a hands-on example. Let's just picture somebody with the idea to write a level set that takes place in London (represented by a lonely island):
+<programlisting>(supertux-worldmap
+ (properties ;; Global worldmap properties.
+ (name (_ "London")) ;; Name of the worldmap
+ (music "bigben.ogg") ;; Music to be played while on worldmap
+ )
+ (spawnpoint ;; At the moment, defining multiple spawnpoints on a worldmap is useless.
+ (name "main") ;; Call your spawn point "main".
+ (x 3) ;; Note that the coordinates are, unlike in a level, bound to the tilemap.
+ (y 3)
+ )
+ (tilemap
+ (width 5) ;; Number of tiles in a row. Four is just for demonstrational purposes.
+ (height 5)
+ (layer "interactive") ;; This has to be "interactive".
+ (solid #t) ;; This has to be true.
+ (speed 1.000000) ;; This has to be 1.0.
+ (tiles
+ 0 0 0 0 0 ;; The tiles as defined in data/images/worldmap.strf.
+ 0 11 16 12 0
+ 0 15 60 17 0
+ 0 14 18 13 0
+ 0 0 0 0 0
+ )
+ )
+ (level ;; Repeat this block for each level. Continuing from a level tile is only possible when the level is completed.
+ (x 3) ;; Coordinates of the level entry point.
+ (y 3)
+ (name "heathrow.stl") ;; Filename of the level, relative to the location of the worldmap file.
+ (extro-script "
+// A Squirrel script to execute once this level is completed.
+ ")
+ )
+ (special-tile ;; This is a sample message tile.
+ (x 4)
+ (y 3)
+ (map-message (_ "Hello.")) ;; Display the following text when Tux steps on this tile.
+ (passive-message #t) ;; Set to #f to stop Tux when he steps on this tile.
+ (apply-to-direction "north-west") ;; The message is displayed only when Tux comes from one of the specified directions (north, south, west, east, concatenate with a hyphen).
+ )
+ (special-tile ;; This is a sample portal tile.
+ (x 2)
+ (y 3)
+ (map-message (_ "Warp to the Tower"))
+ (teleport-to-x 1) ;; Worldmap coordinates to which Tux is teleported.
+ (teleport-to-y 1)
+ )
+)</programlisting></para>
+</sect2>
+
+</sect1>
+