home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 1 / crawlyvol1.bin / games / dm_ed / dm_ed.doc next >
Text File  |  1993-12-03  |  6KB  |  169 lines
  1. The AMAZINGLY, ASTONISHINGLY, ASTOUNDINGLY,
  2.     W O N D E R F U L
  3.   DUNGEON MASTER / CHAOS STRIKES BACK EDITOR
  4.  
  5. (Version 1.0, or some large number if you count all the versions that
  6. were written in STOS BASIC)
  7.  
  8.  
  9. Introduction
  10. ============
  11. A few weeks ago, my good friend Antony Burden, with whom I wrote the
  12. original version of this program (in STOS BASIC), told me that he had
  13. had a request for an updated version which was STE compatible. That
  14. shows how long it was since we last did any work on this program --
  15. roughly 3 years.
  16.  
  17. Anyway, I managed to dig out a copy of the source code from the bottom
  18. of a disk box, and set about compiling it with the most recent version
  19. of STOS which I possessed.
  20.  
  21. There was a slight hitch. After compiling, it simply didn't run.
  22.  
  23. So, faced with the choice of picking my way through the old version to
  24. find out why it didn't work, and re-writing it from scratch, I decided
  25. to do a complete re-write.
  26.  
  27. So, a few weeks later, this is the result.  This program is now
  28. written completely in C, and compiled with the GNU C compiler with all
  29. the optimisation settings on.
  30.  
  31. It isn't very pretty, it doesn't use GEM, and control is by keyboard
  32. only, but it works.  (Having said that, I haven't had the opportunity
  33. to test it on any other machine than my 5-year-old STFM, with TOS 1.2,
  34. but it ought to work on any TOS version).
  35.  
  36. The one big restriction is that it runs in low (320 x 200) resolution
  37. only, and it takes up the whole screen.
  38.  
  39. Enough waffling, on to the instructions.
  40.  
  41.  
  42. Instructions
  43. ============
  44. Run the editor. You will be faced with a simple title screen; press a
  45. key to clear it.
  46.  
  47. You will now see my simple file selector. You can either type a
  48. filename in directly, or press ESC to switch to a list of files which
  49. you can scroll through with the cursor keys. Pressing RETURN will
  50. select the currently highlighted file or directory. You can change
  51. drive by pressing SHIFT + the drive letter. Undo will quit without
  52. returning a result.
  53.  
  54. When you select a file, the editor will load it and attempt to
  55. identify what type of file it is by its length. If it cannot tell what
  56. type of file it is, it will ask for another.
  57.  
  58. The editor will recognise several types of file: game positions saved
  59. from within DM and CSB, as well as game positions saved from the CSB
  60. Prison (useful if you want to get both of the hidden characters in
  61. your team) and the DUNGEON.DAT and MINI.DAT files which are used as
  62. the initial state of the dungeon for DM and CSB respectively.
  63.  
  64. I should mention here that there are 2 versions of Dungeon Master. The
  65. original version (sold by Mirrorsoft) creates saved game files of
  66. 47914 bytes, and as far as I can remember the later version (which I
  67. believe is included in the DM/CSB double pack sold by Psygnosis) makes
  68. saved game files of 47916 bytes. The extra 2 bytes are used as a
  69. checksum, and since I don't know how to calculate it, Dungeon Master
  70. will complain about damaged files when you try to reload a file that
  71. has been edited.
  72.  
  73. Having loaded a file, the editor will display a map of the top level
  74. of the dungeon contained in that file.
  75.  
  76. The following keys now come into effect:
  77.  
  78. Cursor keys:
  79.   Move the pointer around the screen. As it moves across the map, a
  80.   brief description of the current map square will be displayed in the
  81.   top-right of the screen.
  82.  
  83. Return:
  84.   Changes the map square currently pointed at to something relevant --
  85.   e.g. doors open and close; walls change to empty spaces and vice
  86.   versa. For full details, see the list at the end of this file.
  87.  
  88. N:
  89.   Asks for a new byte value for the square currently pointed at. A
  90.   full list appears at the end of this file.
  91.  
  92. R:
  93.   Read another file from disk for editing.
  94.  
  95. S:
  96.   Save the current file back to disk under its original name.
  97.  
  98. A:
  99.   Ask for a new file name and save the current file under that name.
  100.  
  101. P:
  102.   Ask for a file name and save the current screen image under that
  103.   name in DEGAS .PI1 format.
  104.  
  105. U:
  106.   Move up 1 level.
  107.  
  108. D:
  109.   Move down 1 level.
  110.  
  111. L:
  112.   Ask for a level number to display.
  113.  
  114. T:
  115.   Toggle whether descriptions of map squares are displayed.
  116.  
  117. Q:
  118.   Quit (asks for confirmation first).
  119.  
  120.  
  121. Meanings of byte values
  122. =======================
  123.  
  124. Byte
  125. Value(s)  Represents                        Changes to
  126. ========  ==========                        ==========
  127. 0-15:     WALL                              EMPTY SPACE
  128. 16-31:    OBJECT ON WALL                    WALL
  129. 32/40:    EMPTY SPACE                       WALL
  130. 48/56:    OBJECT OR MONSTER                 EMPTY SPACE
  131. 64/80:    PIT (CLOSED)                      PIT (OPEN)
  132. 68/84:    INVISIBLE PIT (CLOSED)            INVISIBLE PIT (OPEN)
  133. 72/88:    PIT (OPEN)                        PIT (CLOSED)
  134. 73:       FALSE PIT                         EMPTY SPACE
  135. 76/92:    INVISIBLE PIT (OPEN)              INVISIBLE PIT (CLOSED)
  136. 96/112:   EAST-WEST FACING STAIRS (DOWN)    unchanged
  137. 100/116:  EAST-WEST FACING STAIRS (UP)      unchanged
  138. 104/120:  NORTH-SOUTH FACING STAIRS (DOWN)  unchanged
  139. 108/124:  NORTH-SOUTH FACING STAIRS (UP)    unchanged
  140. 144:      EAST-WEST FACING DOOR (OPEN)      EAST-WEST FACING DOOR (CLOSED)
  141. 146:      EAST-WEST FACING DOOR (HALF-OPEN) unchanged
  142. 148:      EAST-WEST FACING DOOR (CLOSED)    EAST-WEST FACING DOOR (OPEN)
  143. 149:      EAST-WEST FACING DOOR (HACKED)    unchanged
  144. 152:      NORTH-SOUTH FACING DOOR (OPEN)    NORTH-SOUTH FACING DOOR (CLOSED)
  145. 155:      NORTH-SOUTH FACING DOOR (HALF-OPEN) unchanged
  146. 156:      NORTH-SOUTH FACING DOOR (CLOSED)  NORTH-SOUTH FACING DOOR (OPEN)
  147. 157:      NORTH-SOUTH FACING DOOR (HACKED)  unchanged
  148. 176:      SPINNER (OFF)                     SPINNER (ON)
  149. 180:      TRANSPORTER (OFF)                 TRANSPORTER (ON)
  150. 184:      SPINNER (ON)                      SPINNER (OFF)
  151. 188:      TRANSPORTER (ON)                  TRANSPORTER (OFF)
  152. 192/200:  DISAPPEARING WALL (CLOSED)        DISAPPEARING WALL (OPEN)
  153. 193/201:  FALSE WALL                        EMPTY SPACE
  154. 196/204/  DISAPPEARING WALL (OPEN)          DISAPPEARING WALL (CLOSED)
  155. 208/212/220
  156.  
  157. All other byte values are, as far as I know, undefined, and the editor
  158. will change them to empty spaces.
  159.  
  160.  
  161. Please feel free to send any comments, bug reports, job offers, large
  162. sums of money, marriage proposals, etc. to:
  163.  
  164. Simon Oke,
  165. 10 Symn Lane,
  166. Wotton-under-Edge,
  167. Gloucestershire,
  168. GL12 7BG.
  169.