--- deliantra/server/pod/random_maps.pod	2010/06/29 18:29:29	1.3
+++ deliantra/server/pod/random_maps.pod	2010/07/12 22:28:17	1.10
@@ -39,9 +39,10 @@
 =head2 Style Parameters
 
   layoutstyle <style>   (special!) Pick the layout style for the map.
-                        Currently, "rogue", "spiral", "maze", "snake",
-                        "onion", and "squarespiral" are allowed.  See
-                        below for more detail.
+                        Currently, "rogue", "spiral", "maze", "cave",
+                        "castle", "snake", "onion", "squarespiral" and
+                        "multiple" are allowed.  See below for more
+                        detail.
 
   floorstyle <style>    Load /styles/floorstyles/<style> and pick a random
                         floortype from that style map for the random map.
@@ -126,6 +127,11 @@
    						3: closed (complete maze)
    						default: random
 
+  cave		cave_type			0: very rough, mazelike
+                                                1: round 1-2 space corridors, often elliptic
+                                                2: more open, roundish
+                                                3: wide open areas, roundish
+
   50% of the time a maze layout will be "doorified", meaning that doors
   will be placed at random in the maze.
 
@@ -186,6 +192,9 @@
        				these will be made to make exits to
        				rightward, leftward, north and south.
 
+  rotate	0	do not randomly rotate the map
+  		1	randomly rotate by 90, 180, 270° (default)
+
   origin_x		<You shouldn't need to set this>  The exit which
        		leads back from this map will go to this x.
 
@@ -386,9 +395,206 @@
    #   #  #       #      #  #         # # #
    ########################################
 
+=head3 Cave Maps
+
+Type 0, rough:
+
+   ########################################
+   #################################   ####
+   #############    ########         # ####
+   #############    ######## ###    ## ####
+   #############    ####     ######### ####
+   #############    #### ############# ####
+   ##########       ##   ############  ####
+   ########## ###      ####################
+   ########   ##  #########################
+   ###  ##   ###  #########################
+   ### ##    ###  #########################
+   ### ## ## ###      #####################
+   ###    #  ###        ###################
+   ###  ### ###  ###### ###################
+   ######## #    ######    #   ############
+   #######    ## #########       #  #######
+   #######     #  ########    #       #####
+   #######  ##### ######### ###   ###   ###
+   ####### ######      #### ###   #########
+   ###      ###     ##  ### ####     ######
+   ##  #  # ### ######  ### #######  ######
+   #  ##  ###   ###################   #####
+   # ################################     #
+   # #################################### #
+   ########################################
+
+   ########################################
+   ## ####    ##########  ######### #   ###
+   ## #####    #######   ######   #       #
+   ##  ##                 # ##        ### #
+   ###         #######    #    #### # #####
+   #####   #   ##### ##   #         #   ###
+   ##      ##   ###  ##             #   # #
+   ## #  ####   ##   ##          ## #     #
+   ##    ##### ###   ##          #  #   ###
+   ###   ###### #            ##  #      ###
+   ### ###                   #          ###
+   ##  #####                         #  ###
+   ######            ###               ####
+   ####          #  ####               ####
+   ##   #   ###  # ##               #  ####
+   #   ##   ### ## ##         ##          #
+   # #  # #   #  #     ####        #  ##  #
+   ###    ### #####    #### #  #     ##   #
+   #      ##  ##         ## ##         ## #
+   #      ### ##     ### #  ##  # #    ## #
+   #      ##  #  ##  ##    ### ###   #### #
+   #      ##  # ### ####    ##       #### #
+   #      ##     ## ####### ##       ######
+   # #  ######      ######  ####  ## ######
+   ########################################
+
+Type 1: corridors
+
+   ########################################
+   ############################           #
+   ####  ####   ################  ##  ##  #
+   ###    ##      ########   #### ## #### #
+   #   ##          ######     ### ## #### #
+   # #######   ##             ##  ##  ##  #
+   # #######  ####      #    ##    #      #
+   # ######  ######   ###  ###        ### #
+   # ######  ########     ###   ####  ### #
+   #   #### ##########   ###   ######  ## #
+   ###  ### ###############    ######     #
+   ####  ##  ##   #########  #  ######  ###
+   ##### ###       #########  #  ##########
+   # ###  ###  ##    #####    ##  #########
+   #      ##  ####    #### ##  #  #########
+   #  ##      ####     ##  ##    ##########
+   #  ###    ######         ##  ###########
+   #  ############## #####  ###    ########
+   # ##  ####  #####  #### #######   ######
+   ###    ##    ####  #### #######    #####
+   ##     ##  #  ##  #####  ######     ####
+   ##         ##     ######   #####     ###
+   ###  ####  #### #########   ##### ##   #
+   #########                    ####      #
+   ########################################
+
+   ########################################
+   ########################################
+   ###                 ###          #######
+   ##                                 #####
+   #    #  ############# ###########   ####
+   #   ###  ##########################  ###
+   #   ###  #                    ######  ##
+   #   ##                          ####  ##
+   #   ##   ######################  ###  ##
+   #   ##  ######################## ###  ##
+   #   ##  ###                 ####  ## ###
+   #   ##  ##                   ###  #  ###
+   #   ##  ##  ###############  ###  ## ###
+   #   ##  ##                  ####  ##  ##
+   #   ##  ###                #####  ##  ##
+   #   ##  #### ###################   #  ##
+   #   ##   ### ####################     ##
+   #   ##       ######################   ##
+   #   ###      #######################  ##
+   #   #######################    #####  ##
+   #    ###################         ##   ##
+   ##                        #####       ##
+   ###                     #########    ###
+   ########################################
+   ########################################
+
+Type 2: somewhat open
+
+   ########################################
+   ####################  #####          ###
+   #############  #####   ####           ##
+   ####   #####    ####    ##             #
+   ###     ###     #####            ##    #
+   #            #  #####  #   ##   ####   #
+   #    #     ###   ###  ########  ####   #
+   #    #   #   ##       #     ###  ##  # #
+   #              #     #      ##         #
+   ##        ###  ##       ##             #
+   ###    #######         ###    ##     ###
+   ##############        ###    ####   ####
+   ###############       ##    ####    ####
+   ###      ########     ##   ###    #  ###
+   ##      ##########    ##   ##   ###   ##
+   ###    ###     ###     ##      #####   #
+   ##    ###       ##  #  ##     ######## #
+   ## #####   ###      #  ##    ######### #
+   #  ####   ###     ##   ###   #######   #
+   #        ##      ###  #####      ##   ##
+   ##     ####  ##   #  ###### #        ###
+   ###  ###    ####  #  ##     #####   ####
+   ####  #     #####    ###  ##############
+   ####        #####    ###################
+   ########################################
+
+Type 3: wide open
+
+   ########################################
+   # ########                 #######     #
+   # ########                 ########    #
+   #   #####                  ######### ###
+   ### #####     ##     ###  ########## ###
+   ##   #####   ###     #### ###   ###  ###
+   ### ######   ###     ####       ##     #
+   ### #####    ##       ######## ##      #
+   ##  ##       ##       ##########       #
+   ## ##        ##       ##########       #
+   #           ###       #########    ##  #
+   #        #######      ########    #### #
+   #  ##   ########       #####     ##### #
+   # ####  #####           ###      ##### #
+   # ####   ###                     ####  #
+   # ####   ###           ####      ####  #
+   # ###    ###           #####    #####  #
+   # ###   ####    ##    ########### #### #
+   # ##     ####  ##     ##########   #####
+   # ##      #######     #####         ####
+   # ###      #######   ######     #      #
+   # ###      ######### #         ###     #
+   #  #       #####  ##     ########      #
+   #          ####          #######       #
+   ########################################
+
+=head3 Castle layouts
+
+Castles are similar to caves, except they generate very straight dungeon
+features (not unlike roguelike layouts).
+
+   ########################################
+   ####        ####################      ##
+   ####        ######     #########      ##
+   ####   ### #######  #  #########      ##
+   ####   D        D  ##      #####      ##
+   #####D##       #####           D      ##
+   #####  #       #           #  ##      ##
+   #####          # ####      #  ##########
+   #####  #       # #         #    D      #
+   #####  #       # #  ########  #D#      #
+   #####  #       #D#  # ######### ########
+   #####  ######### #  D            #######
+   #####   ##########  D        ##D########
+   ###### ###    ####  ###### #D#   # #####
+   #####       #D#  ## ###      D   # #####
+   #####       # #     ##    ######   #####
+   #####       # #    ###    ######   #####
+   #######D###D###    ###    ##    #     ##
+   ######      ####   ###    ##    #     ##
+   ######    #      #####    ##          ##
+   ######    #    #######    ##    #     ##
+   ######    D    #############    #     ##
+   ###########    #############    #     ##
+   ###########    ##################     ##
+   ########################################
+
 =head3 Spiral Maps
 
-   A Spiral Map::
+A Spiral Map:
 
     ###########################
     ###########################
@@ -422,7 +628,7 @@
     4  Fit Spiral:  scale spiral to fit rectanglar region
        (i.e., the spiral will look elliptical)
 
-=head3 Rogue-like Maps:
+=head3 Rogue-like Maps
 
 A Rogue-like Map:
 
@@ -567,6 +773,12 @@
     #             #   <   #             #
     ##################################### 
 
+=head2 Multiple layouts
+
+The layoutstyle "multiple" divides the map into many areas
+and uses random layout styles in each area. Works best with
+very high or wide maps and fewer levels.
+
 =head2 An example input file
 
   layoutstyle onion