home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / new / game / role / amigamud / readme < prev    next >
Text File  |  1994-07-31  |  15KB  |  330 lines
  1.                 AmigaMUD
  2.  
  3.  
  4. This is the version 0.7 of AmigaMUD. This is the third release of the
  5. system. The first release had a few bugs, but nothing major. The
  6. second release fixed those bugs and incorported a number of
  7. suggestions made by users of the first (V0.5) release. See file
  8. ChangesFromV0.5 for details on those changes. This V0.7 release fixes
  9. a couple of bugs added in the V0.6 release, and implements a couple of
  10. suggestions. Now I REALLY plan to get back to documentation.
  11.  
  12. At least one user, Nils-Arne Dahlberg, has solved all of the quests in
  13. the standard scenario, including the fairly difficult "Heart" quest.
  14. Any others out there managed this?
  15.  
  16. See the request for pictures and icons at the end of this file. I have
  17. yet to receive any of either, despite some good intentions out there.
  18.  
  19. Note that this is a BETA release. The system has been tested fairly
  20. extensively on this V2.04 A3000 (I run Enforcer continuously) and on a
  21. V1.3 A1000. Some testing was also done on a V1.3 A2500 and a V3.1
  22. A4000T.
  23.  
  24. This release is freely distributable - send it anywhere you like. You
  25. don't have to pay me anything, but I'm much more receptive to
  26. suggestions and requests that come with "donations", which can be sent
  27. to:
  28.  
  29.     Chris Gray
  30.     #808 - 8515 - 112 St.
  31.     Edmonton, AB
  32.     CANADA    T6G 1K7
  33.  
  34. Please do NOT send physical letters to me without donations if you
  35. want an answer. As many people who sent me letters about Draco and
  36. Amiga Empire will attest, I simply never get around to answering such
  37. letters. If the letter comes with, say, $50.00, however, I'll probably
  38. answer it right away, and perhaps even send you the latest version. I
  39. prefer to use electronic distribution means, however, since then I
  40. have fewer versions to keep track of.
  41.  
  42. I am much better at answering electronic mail, which can be sent to:
  43.  
  44.     cg@ami-cg.GraySage.Edmonton.AB.CA
  45.  
  46. I also read several Amiga and most MUD newsgroups. I hope to see lots
  47. of wildly enthusiastic articles about AmigaMUD! I suggest newsgroup
  48. comp.sys.amiga.games as the main discussion group, with perhaps some
  49. general MUD-related discussions in rec.games.mud.misc . A lot of the
  50. discussion on V0.5 was in newsgroup comp.sys.amiga.datacomm.
  51.  
  52.  
  53. This Release
  54.  
  55. There are 2 archives in this release. You only need the first one if
  56. you just want to play MUD on someone else's server. If you want to run
  57. a server, you will need both archives.
  58.  
  59. The first archive, AMClnt-0.7.lha contains:
  60.  
  61.     README - this file
  62.     ChangesFromV0.5 - notes on what has changed from the firt version
  63.     ChangesFromV0.6 - much smaller list of changes for this version
  64.     mud.library - the shared library that clients and servers use
  65.     MUD - the actual client program
  66.     Intro.txt - introductory document - read this first
  67.     MUD.txt - how to run the MUD program
  68.     Playing.txt - tips and detailed information on playing within the
  69.     standard AmigaMUD scenario
  70.     Building.txt - how to do online building, both using commands and
  71.     using mouse-buttons
  72.     ToDo.txt - stuff left to do
  73.     birds - a sound sample that will be played occasionally. Place it
  74.     in AmigaMUD:Sounds/birds .
  75.     some icon files
  76.  
  77. The second archive, AMSrv-0.7.lha contains:
  78.  
  79.     README - this file
  80.     ChangesFromV0.5 - notes on what has changed from the firt version
  81.     ChangesFromV0.6 - much smaller list of changes for this version
  82.     MUDServ - the AmigaMUD server program
  83.     MUDAgent - the remote client agent program
  84.     MUDShut - the server shutdown program
  85.     MUDFlush - the server flush program
  86.     SMUD - the simple MUD client program
  87.     AgentKill - the Workbench-started agent killer program
  88.     MUDServ.txt - how to be a sysadmin
  89.     MUDAgent.txt - details on the agent program
  90.     SMUD.txt - the simple MUD local client program
  91.     Decisions.txt - some ramblings on possibilities
  92.     MUD.data - the database for the sample scenario
  93.     MUD.index - database index file for scenario
  94.     some icon files
  95.  
  96. In the future, there will be a third archive, which will contain the
  97. complete AmigaMUD source for the standard scenario, the MUDCre
  98. program for creating an empty database, plus documentation on
  99. programming in AmigaMUD and within the standard scenario.
  100.  
  101.  
  102. Quick Setup
  103.  
  104. The client will run just fine on a 512K Amiga with one floppy disk. To
  105. set up for such a situation, unpack the AMClnt-0.7.lha archive
  106. somewhere, setup a bootable floppy with at least 180K of space, copy
  107. the file "MUD" to somewhere accessible on it, and copy the file
  108. "mud.library" to the "libs" directory (the "libs:" assign location) on
  109. the floppy. The first copy can be done from Workbench by dragging the
  110. MUD icon to where you want it, and the second can be done by having
  111. booted from the floppy you want to install to, and double-clicking on
  112. the "CopyLib" icon.
  113.  
  114. If you have a hard drive, then you just need to unpack the
  115. AMClnt-0.7.lha archive wherever you want it, and then double click on
  116. "CopyLib".
  117.  
  118. The MUD program looks in location "AmigaMUD:" for any IFF pictures or
  119. sounds that the scenario requests. I haven't supplied any such since I
  120. don't have any. However, MUD will still try to find them. So, you need
  121. to have an assign of that name (or a partition or mounted floppy with
  122. that name) or you will be continually clicking "CANCEL" on the
  123. standard requester.
  124.  
  125. Installing the server is a bit harder, since it needs a bit more
  126. space. The server will run on a two-floppy 1.5 Meg V1.3 system (like
  127. my Amiga 1000), but more memory and a harddrive make things easier. I
  128. think more memory will be needed on a V2.0 system, but I'm not in a
  129. position to easily test that. The most space a server system needs is
  130. for the database files. They will nearly fill a single density floppy
  131. by themselves. To allow for this, the server program MUDServ can be
  132. told where to look for the files, so it does not have to be in the
  133. same place as the database files. To run on my A1000, I put the
  134. database files on one floppy, and the various AmigaMUD programs, etc.
  135. on a much trimmed down Workbench disk, in a directory called 'MUD'. I
  136. put a tooltype "PATH=DF1:" into the MUDServ icon, telling it where to
  137. find the database files, along with "CACHE=100000" and a stack size of
  138. 25000. I have "mud.library" in LIBS: on that floppy, and all of the
  139. programs (MUDServ, MUD, MUDFlush, MUDShut, AgentKill, MUDAgent) in the
  140. MUD directory.
  141.  
  142. On a harddrive, you can keep everything in one directory, but I
  143. suggest keeping the database files in one directory and the programs
  144. in another, so that it is easier to backup the database files. You
  145. will want to put a proper "PATH=" in the MUDServ icon, and a cache
  146. size suitable for your system. On my A3000 I use 500000, which results
  147. in very infrequent disk I/O once the system has settled down. I also
  148. have a "go" file which runs MUDServ from a shell, with appropriate
  149. parameters. It contains:
  150.  
  151.     run <path>/MUDServ >nil: <nil: -c500000
  152.  
  153. If you are not running the server locally, you can add tooltypes to
  154. the MUD icon that will point it at your modem (the default is the
  155. standard serial port, running at 19200 BPS), and you can put in a
  156. modem command to dial the server you will be calling. See MUD.txt for
  157. details. If you are running the server locally, you can put "LOCAL=
  158. TRUE" into MUD's icon, or just set variable "MUDLOCAL=TRUE" to tell
  159. MUD to connect to a local server instead of a remote one.
  160.  
  161.  
  162. Quick Running
  163.  
  164. To start MUD, just double-click on its icon, or, from a shell, type
  165. "MUD" or "run MUD" to start it up. It will initially open two windows,
  166. one for graphics and one for text. If it is doing a local connection,
  167. MUD will connect to the server, and you will be asked for your
  168. character name. If MUD is connecting remotely, the graphics window
  169. will go away, leaving a full-screen text window. In this phase, MUD is
  170. acting like a simple terminal program. Characters you type will be
  171. sent to the serial port (and modem), and characters received from the
  172. modem will be displayed on the screen. If you set up a modem command,
  173. it will be executed as soon as the window opens, so the first thing
  174. you see may be the dialing sequence. When you are connected to the
  175. remote system, you must arrange for it to let you have binary access
  176. to the MUD server. How this is done will depend