home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 7 / FreshFishVol7.bin / bbs / game / dungeonmap-2.1.lha / DungeonMap / DungeonMap.doc < prev    next >
Text File  |  1980-09-26  |  20KB  |  476 lines
  1. Document DungeonMap V2.1 documentation
  2.                         DungeonMap V2.1
  3.                         ===============
  4.  
  5.                      1991-94 © Bill Elliot
  6.                         727 94 Ave SW.,
  7.                         Calgary, Alberta
  8.                         T2V 0X8
  9.  
  10.  
  11. Disclaimer
  12. ----------
  13.  
  14.  DungeonMap is provided "AS IS" without warranty of any kind, either expressed
  15.  or implied.  By using DungeonMap, you agree to accept the entire risk as to
  16.  the quality and performance of the program.  Bill Elliot will not accept any
  17.  liability for this product.
  18.  
  19.  
  20. 0. Important
  21. ============
  22.  
  23. 0.1. A Programmer's Plea
  24. ------------------------
  25.  
  26.   DungeonMap is shareware.  If you find this program useful, please send $10 to:
  27.  
  28.       Bill Elliot
  29.       727 94 Ave SW.,
  30.       Calgary, Alberta
  31.       T2V 0X8
  32.  
  33.   Even if you think that DungeonMap is terrible, I would appreciate a letter 
  34.   giving me CONSTRUCTIVE ideas on how I can improve it.
  35.  
  36.   Please promote the shareware system by making a contribution to the authors
  37.   of the shareware products you commonly use.  There are many advantages to
  38.   the shareware system:
  39.  
  40.       -- You can receive quality programs at a decent price.  Had this been
  41.          a commercial program, you could expect to pay at least $19.95.
  42.  
  43.       -- You can thoroughly examine a shareware program before reimbursing
  44.          the author.  Once you've bought a commercial program, you're stuck
  45.          with it.
  46.  
  47.       -- You promote the creation of a number of exciting and diverse
  48.          programs that would otherwise not reach the public if commercial
  49.          marketing was the only alternative.
  50.  
  51.   Along with your $, please send your name, address, and the version number
  52.   of DungeonMap that you are currently using.  This can be found by displaying
  53.   the About requester located in the Project menu.
  54.  
  55. 0.2. Legal Bits...
  56. ------------------
  57.  
  58.   Now, for the legal stuff.  You don't need to read this unless you plan on
  59.   uploading, distributing, marketing, or stealing DungeonMap...
  60.  
  61.   DungeonMap is Copyrighted 1991-94 by Bill Elliot
  62.     All Rights are Reserved Worldwide
  63.  
  64.   DungeonMap is freely distributable as long as all the following conditions
  65.   are met:
  66.  
  67.       1) All the files must be included in their original form without
  68.          additions, deletions, or modifications of any kind.  Any such
  69.          modifications must appear in separate files.
  70.  
  71.       2) All copyright notices must remain intact.
  72.  
  73.       3) DungeonMap may not be sold commercially alone, or as a component in
  74.          another product.
  75.  
  76.       4) DungeonMap may not appear on shareware or public domain disks for
  77.          which the consumers are charged more than a nominal disk copying fee
  78.          of seven dollars (US $7) per disk.
  79.  
  80.       5) DungeonMap may not appear on any electronic service which charges 
  81.          more than the basic access fee to download DungeonMap.
  82.  
  83.       6) DungeonMap may not appear on any electronic service that claims
  84.          copyrights to uploaded programs, either alone or as part of a
  85.          collection.
  86.  
  87.   If you would like a variance to any of the above conditions, please contact
  88.   me for written permission.
  89.  
  90.  
  91.  
  92. 0.3. Another Way to Contact Me + An Ad
  93. --------------------------------------
  94.  
  95.   I am also on the Amiga Users of Calgary (AMUC) bulletin board on a fairly
  96.   regular basis. This is the first BBS to use the full power of the Amiga's
  97.   ability to multitask.  Some of its features are:
  98.   
  99.       - It has a mouse and pull-down menu driven interface.
  100.       - A 2.0 look and feel.
  101.       - Can download, upload, read your messages, take part in an on-line
  102.         conference ALL AT THE SAME TIME.
  103.       - While a file is downloading, and you see another file you want, you
  104.         can just add it to the list to be downloaded.
  105.       - There is also an off-line reader available for it, with the ability to
  106.         do off-line responding.
  107.         
  108.   You can use a regular ASCII terminal package to access VBBS initially to
  109.   get a copy of the special required terminal package. This term package is
  110.   what gives all the above features. Just look for a file called IceTERMnnn.LZH.
  111.   The most current version, as of this writing, is IceTERM115.LZH.
  112.   
  113.   The most current version of the off-line reader program is called IceOLR31.LZH.
  114.  
  115.  
  116.   The phone numbers to call are:
  117.   
  118.       (403)282-5171
  119.       (403)282-5137
  120.       (403)284-5624
  121.       (403)282-5238
  122.       (403)282-5224
  123.  
  124.  
  125.    My Internet address there is:
  126.  
  127.       Bill_Elliot@amuc.mtroyal.ab.ca
  128.  
  129. 0.4. Requirements
  130. -----------------
  131.  
  132.   This software was written and tested on AmigaDos version 2.04, and uses the
  133.   features of version 2, such as: Gadtools, ASL, etc. So you require 2.04.  If
  134.   you are still using V1.3, GET V2.04 or higher as they are light years ahead
  135.   of V1.3.
  136.  
  137. 1. Using DungeonMap
  138. -------------------
  139.  
  140.   DungeonMap is intended to be used as an aid to Dungeon Masters (DM's) © TSR
  141.   for creating dungeons for use in Advanced Dungeons & Dragons (AD&D) © TSR.
  142.   But, you can use it for what ever you like.
  143.  
  144.   The legend says "Door" and "Arch." But, these can be interpreted any way you
  145.   please (E.g., Door's could be locked or secret doors, and Arch's could be open
  146.   or unlocked doors). Just use your imagination. For the most part the program
  147.   is self explanatory.  I'll just cover some of the more subtle points and
  148.   features.
  149.  
  150. 1.1. Loading Saved Maps...
  151. --------------------------
  152.  
  153.     DungeonMap will first look for a directory (in what ever directory you
  154.     run DungeonMap from) called DungeonMapData.  If DungeonMapData is found, 
  155.     DungeonMap will display the files in this directory. Otherwise, it will
  156.     display the files in the current directory. NOTE: All files saved by
  157.     DungeonMap are forced to have a suffix of ".DAT". Therefore, only files
  158.     ending in ".DAT" are  displayed.  This helps save some time scrolling 
  159.     through other unrelated files.
  160.  
  161.     As the dungeon data is loaded, messages are displayed in the drag bar
  162.     after every 100 nodes are loaded.  This gives you some idea of what is 
  163.     happening during those long loads (E.g., a 1400 node map).
  164.  
  165. 1.2. Saving Maps...
  166. -------------------
  167.  
  168.     The same procedure as above is used for selecting which directory to
  169.     display files from.  But, this selection process is only for the first
  170.     save or load.  The requester will keep the directory you may change it
  171.     to (at least till you quite the program).
  172.  
  173. 1.3. Choosing a Map format...
  174. -----------------------------
  175.  
  176.     This allows you to choose the style of map to generate. You can choose a
  177.     dungeon style that is irregular in shape. Or, you can create a town, which
  178.     is rectangular, and where you can control the straightness of the roads
  179.     (among other things.)
  180.  
  181. 1.4. Creating new Dungeons...
  182. -----------------------------
  183.  
  184.     This is really what you're here for.  You will be presented with a
  185.     requester which asks how for the size of dungeon to create and how you
  186.     want it  created. (I.E., What proportion of the exits will be OPEN, WALLS,
  187.     DOORS, and ARCHS). The total of these proportions must equal 100 or the
  188.     OK gadget will not be available. Just a warning on size.  I would not try
  189.     anything larger than  say 2000 nodes.  Even this will take a fairly long
  190.     time.
  191.  
  192.     If you get tired of waiting for the dungeon to be completed, or you feel
  193.     enough dungeon has been created, then the process can be stopped.  Just
  194.     select the "NEW MAP" option again.  You will notice that while creating
  195.     a map the "NEW MAP" option will read "STOP MAP".
  196.  
  197.     Here are a couple of the messages you will see displayed in the drag bar,
  198.     while the Map is being created. They, and their meanings are as follows:
  199.  
  200.       "Creating dungeon of xxx nodes. yyy nodes created."
  201.  
  202.       This is just a progress report saying that xxx nodes of the requested
  203.       yyy nodes have been created. You will also see the dungeon being drawn
  204.       as it is created.
  205.  
  206.       "No undefined exits. Choosing a new start point for dungeon generation..."
  207.  
  208.       If there are no more undefined exits, a new one is created, at random,
  209.       on one of the outside edges. Then the dungeon creation will continue 
  210.       from tha