
 DNDBBS Documentation   (c) Copyright 1980-2021 All rights reserved.


 All  BASIC  source  code  written,  maintained,  and  compiled  by

                           Erik Jon Oredson


                   With  thanks  to  the  following:


                               Azathoth

                                Gandalf

                                 Charon


                  "That's not a bug! It's a feature!"




 Table of contents
 -----------------
 1.0  Hardware requirements
 2.0  Distribution Information
 2.1  Installation Information
 3.0  Modem settings
 4.0  Communications device driver
 5.0  Console Ansi support
 6.0  RAM disk support
 7.0  Conventional RAM, XMS, and EMS
 8.0  Command line options
 9.0  Dndbbs as a single user program
 10.0 Configuring instructions
 11.0 Operating Dndbbs
 12.0 Modem communications
 13.0 Configuring for communications ports
 14.0 System environment
 15.0 Files used
 16.0 Door information and nodes
 17.0 Door batch files
 18.0 Problem determination
 19.0 Rbbs door file structure information
 20.0 Reporting errors and the author's email
 21.0 Notes on program usage
 22.0 Conversion notes
 23.0 Additional command line options
 24.0 Returned errorlevel variables
 25.0 Further notes on Dndbbs
 26.0 Notes on nodes
 27.0 Notes for batch files
 28.0 Sight impaired support
 29.0 Windows 16-bit vs. 32-bit vs. 64-bit
 30.0 Additional Opening Screen Function Keys 
 ----

 1.0  Hardware requirements
 --------------------------
 The  Adventure System  requires  an IBM (or compatible) PC, XT, or AT,
 serial port, hayes smartmodem (or compatible), minimum of 512K memory,
 one megabyte of expanded or extended memory,  a one megabyte Ram disk,
 an 80 column color monitor, and up to 80 megabytes of disk storage.

 Dndbbs will work in the following environments:

   DoubleDOS, Desqview, CP/M, PC-DOS, MS-DOS,
   Windows 3.1, 95, 98, ME, 2000, NT, XP, 2003, Vista, and OS/2.

 Dndbbs will  NOT  work in  Win7/8 because they do  not run any  16-bit
 programs whatsoever for no good reason at all.  Use a DOS emulator  or
 install a VM.

 2.0 Distribution Information
 ----------------------------
 Dndbbs is distributed in four files:

    Dnd50a2e.zip -- Runtime programs, data files, documentation,
                    and command modules.
    Dnd50a2s.zip -- Source for all runtime modules, *.bas, and *.inc
    Dnd50a2u.zip -- Updates for dndbbs v5.0 r2.0
    Dnd50a2p.zip -- Patch kit for dndbbs v5.0 r2.0

 Copy  these files to the  directory root C:\ and  unzip  the  contents
 with Pkzip.exe or any other unarchiving program. Use the pathname line
 switch -d to preserve the original paths Dndbbs was stored from:

    Pkunzip -d Dnd*.zip

 If  using any  zip  extractor program, unzip the package to C:\  while
 preserving pathnames. Note: files can be found at:

    www.filegate.net/pdn/pdnbasic/

 2.1 Installation Information
 ----------------------------
 Dndbbs is distributed with Users.dat  file containing only the  Sysop.

 If this  file contains any other users then it should be deleted,  and
 restarted with the following instructions:

 To quickstart  Dndbbs  without any  configuration  requirements enter:
 'Makesys' to create the Sysop, then 'Sysop' in the Dndbbs
 directory, or,

 Start  the Setup.exe program  to create  the necessary data files, and
 start Dndbbs with the sysop logon, or,

 To  recreate the configure files,  type 'Makecnfg' to create the setup
 files,  then  type 'Dndinit 1'  to recreate the data files, then start
 Dndbbs.exe, or,

 For  further information read  section 10.0 of this file for  advanced
 setup information.

 3.0  Modem settings
 -------------------
 Dndbbs  can autoanswer the modem by  receiving the response 'Ring' and
 returning the  command 'Ata' or receiving the  response 'Connect' then
 the modem speed (i.e. Connect 2400). This way the modem can autoanswer
 with S0=1 or  with S0=0  (modem register S0 sets the number of rings).
 Dndbbs configures serial ports for 300 up to 38,400 baud at no parity,
 eight data bits,  and one stop bit (N,8,1). The initial modem settings
 should be one of these commands:

 Modem initialization string 1: ATM0E0Q0V1X1

 M0     --   speaker off
 E0     --   do not echo commands
 Q0     --   enable result codes
 V1     --   verbose result codes
 X1     --   extended result codes

 Modem initialization string 2: ATM0E0Q0V1X1&C1&D2

 &C1    --   carrier detection
 &D2    --   DTR detection

 Modem initialization string 3: ATM0E0Q0V1X1&C1&D2S0=1SS=255

 S0=1   --   autoanswer on ring one
 S2=255 --   disable escape codes

 4.0  Communications device driver
 ---------------------------------
 Dndbbs can access most communications  device drivers for modem input,
 output and initializing. Normally all you need to do is put the device
 driver  statement  in your  config.sys file and reboot  to install the
 port driver.  The  Fossil  (fido/opus/seadog standard interface layer)
 driver distributed as X00.SYS should  be placed in Config.sys with the
 command 'DEVICE=X00.SYS'.  Dndbbs will verify if the  device driver is
 installed and use the features of the driver automatically. Installing
 the port driver can greatly enhance the operation of Dndbbs.

 5.0  Console ansi support
 -------------------------
 Dndbbs can send color code changes to the ANSI.SYS device driver.  The
 Ansi  driver is found  on your DOS disk.  Install the driver by adding
 the statement 'Device=ANSI.SYS' to the CONFIG.SYS file.

 Dndbbs can also utilize the enhanced Ansi code as stated by the Avatar
 device driver specification. The driver included for using these codes
 codes are ZAVT.SYS and ZAVTNK.SYS.  The Zavtnk file has  the same Ansi
 codes without keyboard redefinition code parsing.

 Dndbbs can detect the driver and will use the Ansi codes of the driver
 automatically. Installing the Ansi driver can speed up the screen used
 by Dndbbs.

 6.0  RAM disk support
 ---------------------
 The Vdisk.sys device should be installed for a small ram disk of 1024K
 and selected in the Dndcnfg files variables.  Vdisk.sys is only useful
 for the ram disk option  if you are using multinodes.  Optionally, the
 Ramdrive.sys program can be used. A ram disk is highly recommended for
 the  Dndbbs runtime commands  and configuration  information which are
 loaded  from the .cfg files into disk  files.  If you are experiencing
 slow  command prompts while using Dndbbs, install a ram disk.  The Ram
 drive  letter could also  be a networked drive letter sharing the data
 between workstation instances of Dndbbs running.

 7.0  Conventional RAM, XMS, and EMS
 -----------------------------------
 Since  Dndbbs  uses  Xms or Ems swap memory from the startup programs,
 your  system should have  some Ems emulator such as  emm386.exe or any
 compatible Ems handler.  Although Dndbbs  will load into  conventional
 ram as little as 512k,  Dndbbs requires Xms/Ems to be loaded.  Add the
 next two lines to your Config.sys file before bootup and Dndbbs should
 run normally:

 DEVICE=HIMEM.SYS
 DEVICE=EMM386.EXE RAM

 this will allow Dndbbs to load and operate as efficiently as possible.
 If Xms/Ems is not loaded, Dndbbs code will attempt to swap to and from
 the disk,  slowing down processing dramatically.  Other Ems  emulators
 could be used such as Qemm, 386max, or Helix RAM.

 8.0  Command line options
 -------------------------
 The  command line options  are  parameters you type after  the command
 Dndbbs  at the DOS prompt.  The node parameter is optional and must be
 the first switch on the command line and range from 0-9, A-Z, 10-99.

 The remaining command line options are:

    /BY skips the startup screens.
    /DO starts the game by reading the Rbbs door file information.
    /LC starts the game without modem communications.
    /TN starts the game in telnet mode bypassing door file.
    /N:"codename"  starts the Dndbbs with the username in quotes.
    /M:#  overrides the maximum screen height to 25, 43, or 50.
    /P:#  overrides the communication port number.
    /B:#  baud rate override
    /A:"xxx"  port address override (hexidecimal)
    /R:d  overrides the default RAM drive letter.
    /T:#  overrides the amount of user online time in minutes.

 Examples starting Dndbbs:

    Dndbbs /1/LC
    Dndbbs /2/BY
    Dndbbs /1/LC/N:"Joe_User"
    Dndbbs /99/P:1/T:30

 The remaining extended switches are:

    /R:1 closes program and performs a cold boot. (F12 in mainscreen).
    /R:2 closes program and performs a warm boot. (F11 in mainscreen).
    /R:3 cold boot at midnight. /R:4 warm boot at midnight.
    /S:"hh:mm"  cold boot at specific time

 9.0  Dndbbs as a single user program
 ------------------------------------
 To start the adventure at your computer without a modem or serial port
 type 'Dndbbs /LC'  then  you can enter  the program from the keyboard.
 When  started  locally you do not need to have a  modem or  the fossil
 driver installed to operate Dndbbs.

 10.0  Configuring instructions
 ------------------------------
 Copy the  Dnd50a2e.zip file to  C:\ then separate the  compressed .zip
 files with a pkunzip utility preserving the directories stored.

 Dndbbs  will look for the configure file in the  default directory the
 program is started from.  If the configuration file is not  found then
 the Dndbbs exits with an error message to create a configuration file.

 Start the configure program by typing  dndcnfg  in the dnd  directory.
 You will be presented with a color screen containing eight options:

  F1 Logon variables                            F5 Command variables
  F2 Processing variables                       F6 Modem variables
  F3 File variables                             F7 Custom equations
  F4 Rooms variables                            F8 Security Variables

 And a selection on the bottom line:

  Highlight Menu Choice W/ Cursor Keypad, Press Return To Select Option.
  Control-D Load Default, Control-W Write Config, Control-R Read Config.

 Select the option for  loading the configuration defaults (control-d),
 loading a configuration file (control-r), or writing the configuration
 file (control-w).

 At this point you can select one of the eight options  with the cursor
 keypad and  the enter key,  or by pressing the function key selection,
 or with the first letter of  the option.  The screen will display  the
 parameters for the selected option.

 The  necessary datapath options  in the file  variables screen are the
 data, documentation, temporary work, and message files.

 When you have  entered  the datapath options,  write the configuration
 out to the  configure file.  You must  select the  node number for the
 configure  file used to load Dndbbs.  For node 1 the file is dnd1.cfg,
 for  node 2 the  file is dnd2.cfg, etc.  Press enter  for the  default
 configure file dnd.cfg.  The default configure file dnd.cfg is read by
 the utility programs when the sysop runs Edit.exe, and Dndedit.exe.

 11.0 Operating Dndbbs
 ---------------------
 After writing the configuration  file to disk Dndbbs can start locally
 with the  command  'Dndbbs /LC' or 'Dndbbs /1' for bbs mode.  While in
 bbs mode the  program  controls the modem and answers  incoming calls.
 The opening screen status indicator displays the activity of the modem
 during answering and connection. Dndbbs answers at speeds up to 38,400
 baud. Your modem  must be 100% hayes compatible and support the entire
 hayes command set. The opening screen shows the modem status, recycle,
 intializaltion, reset, and off hook commands.

 Note the possible modem baud rates which can be selected are:

  300, 600, 1200, 2400, 4800, 9600, 19200 (fossil), 38400 (fossil),
  57600 (x00 fossil), 115200 (X00 fossil),

 The  remaining baud rates,  if selected, should be adjusted  to one of
 the above:

   50, 75, 110, 134.5, 150, 450 (adjust to 300),
   7200 (adjust to 4800),
   12000, 14400, 16800 (adjust to 9600),
   21600, 24000, 26400, 28800, 31200, 33600 (adjust to 19200),
   64000, 78600 (adjust to 57600),
   230400 (adjust to 115200),

 although Dndbbs will  not attempt to adjust the computer to modem baud
 rate after the modems have connected.

 12.0 Modem communications
 -------------------------
 Sample of Dndbbs to modem conversation bbs mode:

 From Dndbbs to modem:

  ATZ          (reset command, status indicator: Reset ok).
  ATM0E0Q0X1V1 (initialization command, status indicator: Init ok).

 Now the opening screen status indicator displays Waiting for call.

 From modem to Dndbbs:

  RING         (for S0=0, incoming call, status indicator: RING,
                Dndbbs responds with ATA, or),
  CONNECT 1200 (for S0=1, modem autoanswers, returns connect speed
                after autoanswer).

 For 300 baud the modem returns CONNECT, Dndbbs waits, and assumes 300.

 If Dndbbs does not detect a carrier signal within 30 seconds  then the
 modem  disconnects  and the program recycles.  Dndbbs can configure to
 disallow 300 baud access.

 13.0 Configuring for communications ports
 -----------------------------------------
 For sysops using multinode systems, networks or multitask applications
 you may need to  configure Dndbbs for  a  specific communication  port
 number  besides the default of port 1. Dndcnfg modem variables  screen
 allows you to set the port to any port number from 1 to 64. The Fossil
 device driver can access up to eight ports  on an AT.  In  order to do
 this  you  must  modify  the  command   line on the  Device=X00.SYS in
 CONFIG.SYS.  Read X00  documentation for further  information. Example
 of the X00 command line for 2 ports would be 'Device=X00.SYS E 2'.

 14.0 System environment
 -----------------------
 An environment  string is a  system variable locally  known to dos and
 the program dos executes.  Environment strings are placed into the dos
 system variable space with the set command.  Dndbbs will recognize the
 strings and  use them for disk access.  There are  many  set variables
 recognized by Dndbbs.  You can also place the dos environment varables
 into the AUTOEXEC.BAT file. For example:

  SET DNDBBS=C:\DNDBBS50
  SET DNDDOC=C:\DNDBBS50\DNDDOC
  SET DNDDAT=C:\DNDBBS50\DNDDAT
  SET DNDMESS=C:\DNDBBS50\DNDMESS
  SET DNDTEMP=D:\
  SET DNDDOOR=C:\RBBS\

 The path command can  specify the directory  containing the Dndbbs.exe
 program.  By combining the environment strings  with the path command,
 Dndbbs can be started from any drive.  The DOS environment strings are
 used instead of the configuration file pathnames.  Dndbbs will add the
 trailing slash at  the end of  the set  statements.  If the  directory
 containing Dndbbs is  C:\DNDBBS50\ then  the path statement  would be:

  PATH=%PATH%;C:\DNDBBS50\

  Or run SETPATHS.BAT from the Dndbbs directory to set all paths.  Watch
  for C:\ which is set as the default temporary drive.

  In XP or other  Windows running Cmd.exe  use the /E:ON switch to allow
  command extension so Setpaths.bat can be used in the Cmd environment.

 15.0 Files used
 ---------------
 A well  organized  Dndbbs  system would  make full use of the datapath
 options.  The disk  drive structure  could  look something  like this:

    c:\            c:\dndbbs50\dnddat\            c:\dndbbs50\dnddoc\
    config.sys     actions.dat     nonplyrs.dat   abort1.doc
    autoexec.bat   automate.dat    notice.dat     abort2.doc
    ansi.sys       badlogin.dat    objdesc.dat    catalog.doc
    vdisk.sys      bank.dat        objects.dat    catalogd.doc
    x00.sys        containr.dat    prelog.dat     catalogm.doc
                   ctninv.dat                     catalogs.doc
    c:\dndbbs50\   dmhelp.dat      roomdesc.dat   hint.doc
    shroom.com     dndcnfg.dat     roominv.dat    summary.doc
    dnd??.cfg      dndedit.dat     rooms.dat      summaryd.doc
    dndbbs.exe     edithelp.dat    spells.dat     summarym.doc
    dndcnfg.exe    graffiti.dat    teaminv.dat    summarys.doc
    dndedit*.exe   help.dat        teamuser.dat   wish.doc
    dndutil.exe    logoff.dat      treasure.dat
    edit*.exe      logoffh.dat     userinv.dat    c:\dndbbs50\
    cmd*.exe       logon.dat       user.dat       coins.doc
    dndcnvt.exe    monclass.dat    welcome.dat    disclaim.doc
    dndcnvt2.exe   moninv.dat                     disclam2.doc
    dndinit.exe    monsters.dat                   readme*.*
    dndpack.exe    montalk.dat                    restrict.doc
    dndsic.exe                                    sysnews.dat
    editedit.exe   d:\ (ram disk)                 tumbler.doc
    helpedit.exe   altwrk??.dat                   *.doc, *.txt
    import.exe     messwrk?.dat
    makecnfg.exe   tmpwrk??.dat                   Main .doc files
    makesys.exe                                    c:\dndbbs50\
    runedit.exe    c:\dndbbs50\dndmess\           dndbbs.doc
    runprog.exe    messbase.dat                   dndcnfg.doc
    setup.exe      public.*                       dndedit.doc
    uninstal.exe   private.*                      edit.doc
    vbdrt10e.exe   base1.*                        sysop.doc

 Certain  reserved filenames,  such as any file with  the extension  of
 .bak, .bk1, .bk2, .bk3, .bk4, and .bk5 should not be used.

 16.0 Door information and nodes
 -------------------------------
 Select the  dndcnfg  option for the pathname  where the DOS  directory
 containing the  door file is to be found.  Next, specify the Rbbs door
 info file node number,  and  write the  .cfg file for  Dndbbs node you
 will be using. Dndcnfg will add the trailing  slash at the  end of the
 pathname if  you forget.  The dnddoor environment variable can also be
 used.  To start dndbbs  as a door use the node number after the dndbbs
 command to read the Dndbbs  .cfg file containing the door information.
 (for example: dndbbs /1). To specify the node  parameter  from a batch
 file  use the  node number for the  first replacement  parameter  (for
 example: dndbbs /%1). Other door types need to be converted to an Rbbs
 door  file with a conversion program such as DoorMaster. The door file
 searched for will be dorinfox.def with x replaced with the node number
 then dinfxx.def for extended Rbbs door info files.

 17.0 Door batch files
 ---------------------
 Here is a  sample batch file to call dndbbs from rbbs. This batch file
 is named dnd.bat  and is called from rctty.bat  from rbbs.bat with the
 command dnd 1.

  cd\dndbbs50
  dndbbs /%1
  cd\rbbs

 For futher rbbs batch file  programming  read the  rbbs documentation.
 There  are many involved batch routines for files rbbs.bat, rctty.bat,
 and rbbstm.bat.  Rbbs uses the file menu5 to look  for the  keyword to
 start the batch file.  The menu5 file must have the batch file name in
 uppercase  surrounded  by  spaces so  rbbs can find it.  Then the rbbs
 attaches  .bat to  this filename and checks the disk for the filename.
 For example,  menu5  could look  like  this:

 +--------------------------------------------------------------------+
 |                      Rbbs doors menu selections                    |
 |                                                                    |
 | Type in one of the following door options:                         |
 |                                                                    |
 | DND - The adventure system v5.0a!                                  |
 +--------------------------------------------------------------------+

 Additionally,  the definition file for invoking a door from Rbbs could
 be  specified if the  Doors.def  file is  located in the  \Rbbs\System
 directory,  or other node-specified  directory in \Rbbs,  and contains
 the following fields per line:

  1. Name of door - up to 8 characters.
  2. Minimum security to use door.
  3. Questionnaire to execute before the door.
  4. Method to invoke doors - "S" for shelling,  else go to .BAT  file.
  5. Template for invoking  door - make sure  the first word has a file
     extension -  RBBS-PC will  check for  existence  of the first word
     as file.
  6. Whether  to  ask for  password on return - Y is yes, anything else
     bypasses password check.
  7. File to display after the door.
  8. Maximum  time allowed in doors - time remaining  passed to door is
     reduced if max time is less.

 An example to call Dndbbs would be:

  DNDBBS,5,,D,"DNDBBS.BAT [NODE]",Y,,60

 Also  see the  Rbbs  documentation for additional parameters within []
 to specify template string replacements.

 18.0  Problem determination
 ---------------------------
 Q. The program does not read the configuration file:

 Delete all the Dnd*.cfg configuration files and start dndcnfg. Dndcnfg
 loads  defaults into all  configuration values.  Store the config file
 with  Control-w and you  will be prompted  for the node number.  Press
 enter for no node or enter the node number from 1 to 16.

 Q. The program does not recognize the configuration file:

 You  have not written a  new configuration file to disk. Make sure you
 use the control-w command before exiting dndcnfg. Or the configuration
 file is from an old version. You will prompted for the node number for
 the configuration file.

 Q. Installing a new version of Dndbbs:

 The configuration file structure may have changed from an old version.
 Delete  all  old Dnd*.cfg configuration files and write new files with
 dndcnfg and the control-w command.

 Q. Message: Out of memory during CHAIN

 Your MS-DOS shell  does not have enough conventional memory.  The only
 solution to this is to increase conventional RAM.  Dndbbs will not run
 well in any amount of RAM below 512 KB.

 Q. Message: Error loading run-time module vbdrt10e.exe: Out of memory.

 Shelling to an external program  does not have enough conventional RAM
 to load. Increase conventional RAM.

 Q. The program seems to hesitate frequently:

 Dndbbs is  shelling out to the  Cmd*.exe modules and  they are loading
 very slowly.  The cure for this is to  place the  SMARTDRV.EXE program
 into  Autoexec.bat  then reboot to  start the  driver.  Smartdrv  will
 cache your disk drives and read the command modules quickly.  To start
 a 1024 KB cache  for Dos and 512 KB  cache for windows on drive c: use

   Smartdrv.exe C 1024 512

 Q. The modem does not answer the phone:

 This is probably because the modem is not initializing correctly.  Try
 rebooting and  then starting the program.  Try initializing the  modem
 with  another communications program.  If none of these work then your
 modem might not support the hayes command set.  When you start Dndbbs,
 the fossil is initialized, then the opening screen appears. The status
 indicator  area will show 'Call Waiting' if  the modem has initialized
 correctly. Dndbbs does not support USB modems, only serial modems.

 If  the status indicator  shows 'Reset Timeout' or 'Init Timeout' this
 means the modem has not sent 'OK' back to Dndbbs  and  the modem might
 not have  initialized properly.  If this is the  case then the  Dndbbs
 continues normally anyway.

 Q. The program displays errors and/or does not start:

 Most users do not  increment the number of available file handles when
 installing  Dndbbs for the first time.  Dndbbs uses 48 files per node,
 plus 4 for DOS  (Stdin, Stdout, Stderr, Stdprn).  Adjust the files=255
 statement in the config.sys file.  The increased file handles  will go
 into  effect when you reboot. In  WinX the file for  increasing Files=
 is  in  \Windows\System32\Config.nt and the maximum files which can be
 increased to is 255.

 Q. Dndbbs operates very slowly after starting:

 Add a Ram disk, or reduce some  cpu usage by  disabling sort toggle in
 the game or disabling the equation parser in the game. Normally Dndbbs
 requires a cpu which works as fast as a 486, Pentium,  or Pentium Pro.
 Also if you are running multiple Dndbbs partitions in Windows or OS/2,
 try increasing  the time slice or task priority.  Pentium II, III, and
 SMP Pentium systems are fast enough for Dndbbs to work maximally.

 Q. The data files are corrupt or need to be customized:

 Run the Dndinit.exe program.  Also, if the Sysop needs to create their
 own dungeon files without the init utility delete the files;

 Actions.dat, Monclass.dat, Monsters.dat, Montalk.dat, Nonplyrs.dat,
 Objects.dat, Roominv.dat, Rooms.dat, Spells.dat, Treasure.dat,
 Moninv.dat;

 then logging on  with  Dungeon Master access  the data files rooms can
 be created from the beginning.

 Q. At high speeds Dndbbs drops characters received from the modem:

 Dndbbs has no interrupt handling,  therefore the program  can only get
 the modem input as fast as the program can poll the state of the modem
 so the solution  is  to  add a device driver which gets and stores the
 modem i/o.  Try installing the  X00 device driver,  turn on the Fossil
 activity for  the Dndbbs port, then run Dndbbs.  The X00 driver should
 have  fifoes set to 15 by specifying  F=15 at the load statement,  and
 transmit buffer set to at least 1,024 bytes in config.sys:

   Device=c:\x00.sys E F=15 T=1024

 Q. At high speeds Dndbbs drops characters transmitted to the modem.

 Sometimes the output buffer gets stuck or the remote telecommunication
 package 'hiccups' during transfer  of ANSI codes.  Usually the problem
 is call-waiting.  When this occurs there is no real solution except to
 get a data only line.

 Q. When more than one Dndbbs is loaded at the same time, some files do
 not get updated between each Dndbbs partition:

 The  Dndbbs  reads and writes records from  the same data files at the
 same time. The solution is to load share.exe before starting any multi
 partition software.  Then all partitions  which have Dndbbs will share
 file records. Note however that if you are not running multiple copies
 of dndbbs then  you could disable share from being detected,  by using
 the /D:5 switch on the command line.

 Q. The Dndbbs locks up during startup without any error message:

 Try  increasing  the files= statement in  Config.sys  and  reboot. The
 Dndbbs needs 48  file handles per process.  Set the files=  command in
 config.sys to 255.

 The file in WinX to  increase Files=  is in  \Windows\System\Config.nt
 and the maximum files which can be set to is 255.

 Q. When Dndbbs or Edit shell to an external program an 'out of memory'
 message is displayed:

 Use  the  Shroom  utility on the  program command line.  This  utility
 allows the current program to be swapped to memory before running  the
 shell program. An example syntax for Shroom is:

    Shroom -q dndbbs.exe

 Startup batch files are included for Shroom:

    Start1.bat   --  Starts 'dndbbs.exe /LC' with Shroom
    Start2.bat   --  Starts 'dndbbs.exe %1%2%3' with Shroom
    Start3.bat   --  Starts 'dndbbs.exe /LC/BY/N:"%1%2%3' with Shroom

 Q. Dndbbs quits with a message to run Dndutil.

 The node  selected to start  on the command line is  already in use or
 already has a user online at the node. This happens if Dndbbs has been
 closed  before clearing the  node list by being  shut down improperly.
 The solution is to  either run Dndutil with /c on the command line, or
 to clear the specified node with /c:<n> where <n> is the node.

 Q. Link.exe problems

 In Win95/Win98/XP the BC, LIB, and LINK programs work fine.

 In Vista the VB Linker returns with no error or message and returns to
 prompt,  the PDS Linker displays 'not a 32-bit program' error message,
 and may display 'access denied', and the QB45 Linker does not link the
 Dndbbs. There is no workaround for this. Compile the Dndbbs on the LAN
 on a Win 98 computer and copy the .exe from there.

 In  Win7  no 16-bit programs can be loaded at all.  There is no reason
 for this whatsoever. Use a DOS emulator instead, such as DOSbox.

 Q. Lib.exe usages:

  Copy contents of lib file to list file:

     Lib qb.lib, qb.out;

  Combines library files into one library file:

     Lib library.lib+dtfmter.lib+qbx.lib,nul;

  Combines library files into one qbx library file:

     Link /q dtfmter.lib+qbx.lib,library.qlb,Nul,qbxqlb.lib;

  Creates missing qb.qlb file in qb45:

     Link /q qb.lib,qb.qlb,Nul,bqlb45.lib;

 Q. Destructive backspace

 For teletype-aware output, Dndbbs displays block patterns for password
 entry. On a CRT the backspace is non-destructive, displaying the area:

   Password?[                    ]

 with the right bracket when destructive backspace is disabled.

 19.0 Rbbs door file structure information
 -----------------------------------------
 Rbbs v17.4/v17.5 door option, 13 lines ascii text:

 DNDRBBS             bbs name
 JOE                 bbs sysop first name
 USERNAME            bbs sysop last name
 COM1                comm port used, COM0 for rbbs local sysop
 2400 BAUD,N,8,1     baud rate and parameters
  1                  network type
 JOE                 'SYSOP' for rbbs sysop, otherwise the user's
 OWNER                 first name, and last name
 NEW YORK, NY.       users city, state
  2                  graphics preference, 2=ansi
  10                 the user level
  60                 time remaining
 -1                  fossil used

 Door file used for v17.4 with node <nul>, 0 - 9, A - Z is Dorinfo?.def
 and with extended node for 10 - 99 used with v17.5 is Dinf??.def

 20.0 Reporting errors and the author's email
 --------------------------------------------
 Reporting  errors and problems  of a serious nature  should be sent to
 the author at the email address:

    dndbbs@gmail.com

 please  note  this  is for  bugs that  are  critical  to the  improper
 operation  of  the  Dndbbs  program,  such  as:  bugs that  crash your
 computer,  bugs  that freeze  your computer,  and/or bugs  that delete
 valuable  data.  When reporting problems  of this nature,  remember to
 include:

    your email address for response by the author,
    the exact explanation of what you were doing when the problem
      occurred, and,

      a copy of any configuration files important to describing your
      computer system, such as: config.sys, autoexec.bat,
      config.nt, autoexec.nt, win.ini, system.ini.

 the author will not respond to error reports if there is not any clear
 indication of how the bugs happened, or if your description of the bug
 is not precise enough.

 21.0 Notes on program usage
 ---------------------------
 In Windows Cmd.exe  Alt-Enter full screen mode the command boot switch
 for  /M:50 must be used.  Although Dndbbs will  detect screen modes of
 25x80, 43x80, and 50x80,  it will  not detect  12x80, 30x80, 58x80, or
 60x80, and will not detect any 40 column modes.

 When  using mapped networked drives  and  starting dndbbs displays the
 error 68 (device unavailable),  then the drive icons should  be double
 clicked on to initiate them.

 22.0  Conversion notes
 ----------------------
 Dndbbs conversion files:

   Dndcnvt.exe converts old Dnddoor v5.0a files to Dndbbs v5.0a.

   Dndcnvt2.exe converts old Dnd v2.7a files and other systems to
     Dndbbs v5.0a.

   (provided the .inc files have not changed).

 23.0  Additional command line options
 -------------------------------------
 Normally  the  maximum  settings for number  of nonplayers and monster
 classes are 1024 each,  resulting in 90  Kilobytes of standard memory.
 Use the low memory switch when  there are more than 1024 entries. This
 causes the files  to be  read from disk  which is slower  than reading
 from memory. This may cause slower processing by Dndbbs.

 The command line debug switches are:

   /D:1  bypasses the startup screen switch display.
   /D:2  bypasses the startup screen author notice.
   /D:3  turns packing off at midnight for node <nul>.
   /D:4  disables reading the monster class file into memory.
   /D:5  prevents share from being detected.
   /D:6  enables debug mode.

 The  remaining command line debug switches  are for  fossil detection
 override.  Since Dndbbs detects the existence of fossil automatically,
 the driver may be misreporting the actual upper fossil function range.
 BNU sometimes exhibits this behaviour. To override the fossil version,
 use the following switches:

   /F:0  disable fossil
   /F:1  enable fossil type 1 (x00)
   /F:2  enable fossil type 2 (fossil)

 Standard  fossil function range from 01x to 1Bx,  whereas,  x00 fossil
 superset functions are reported by 1Cx to range from 1Cx to 21x.

 During opening screen the following Alt- keys are activated:

   Alt-1 Bank, Alt-2 Casino, Alt-3 Mail, Alt-4 Teams, Alt-5 RBBS Hack,
   Alt-6 Hex Editor, Alt-7 |Toggle, Alt-8 |Reboot, Alt-9 Read.Dayfile.

   Alt-D Disk Log, Alt-P Print Log, Alt-W Toggle Display, Alt-X Dndpack,
   Alt-Y Screen Saver, Alt-Z Debug Mode, Alt-0 Clear Screen.

 During Dndbbs activated the following keys are installed:

   Alt-D Toggle disk log, Alt-P Toggle print log, Alt-W Print Screen,
   Alt-X Screen To File Dump, Alt-Z Toggle debug, Alt-F Toggle Local Mode.

   The /? command line switch displays dndbbs switches.
   The /help command line switch displays additional switches.
   The @filename.ext loads the command line from any specified file.

 24.0  Returned errorlevel variables
 -----------------------------------
 Dndbbs exits with errorlevels:

 0  - unknown termination.
   Possible reasons:
     If a bad |reboot exited to DOS without closing the window.

 1  - proper termination.
   Usual reason:
     If the user quits normally.

 2  - abnormal termination.
   Some reasons:
     If there is a bad node, or a bad chain happens.

 25.0  Further notes on Dndbbs
 -----------------------------
 Dndbbs creates an exit file when returning to DOS which is Dexit??.def
 where ?? is the node if the game quits normally.

 Dndbbs could be  started with Shroom  for shells to Dndpack.  If there
 are more than 2 lines running constantly then it is suggested that the
 Dndpack be run once per day.

 Dndbbs is compiled without /O to retain common block include header to
 chain to command modules.

 Dndbbs is not overlayed with link () imbedded objects.

 Vbdtr10e.exe is used for the runtime module library.

 To  ensure  complete security,  Dndbbs  also  includes a dual-password
 encryption subroutine.  If the variable  DualPassword=-1 is set in the
 Guest?.cfg file for the node then two passwords are required to login.

 The second password cannot be edited by any Dndbbs editor function.

 Since  Dndbbs  is distributed with existing config files  certain .cfg
 file  settings could be set for  remote  DOS shell.  This  password is
 located in line 237 of the file and should be set to a blank line.

 26.0  Notes on nodes
 --------------------
 Nodelist starts with <nul> with Dndbbs booted without any /<node>  and
 continues with 0-9, A-Z, and 10-99 filling the nodelist from 1 to 127,
 as such (- being nul):

    Node  - 0 1 2 3 4 5 6 7 8  9
    List  1 2 3 4 5 6 7 8 9 10 11

 And,

    Node  A  B  C  D  E  F  G  H  I  J  K  L  M
    List  12 13 14 15 16 17 18 19 20 21 22 23 24

 Through,

    Node  N  O  P  Q  R  S  T  U  V  W  X  Y  Z
    List  25 26 27 28 29 30 31 32 33 34 35 36 37

 Finally, 10 to 99 fill slots 38 to 127.

 27.0  Notes for batch files
 ---------------------------
 Notes for batch files:

 Dndbbs could be called from a batch file in a loop,  checking for exit
 file:

 (errorlevel is compared greater than or equal to value).

 Contents of Dndbbs1.bat could be:

   Echo off
   :Start
   If Exist Dexit1.def Del Dexit1.def
   Dndbbs /1
   If Not Exist Dexit1.def Goto Start
   If Errorlevel 1 Goto Exit
   Goto Start
   :Exit

 Dndbbs could be started from any drive or directory if the environment
 variables  are set to point to  certain Dndbbs directories by  loading
 Setpaths.bat, then Dndbbs could be added to the C:\Autoexec.bat file.

 In XP and  other Windows platforms the  Control-Break key will 'stick'
 and  send the break to the  batch file  prompting  to abort the  batch
 file.

 28.0  Sight impaired support
 ----------------------------
 For  people who are  blind or are sight impaired .wav files are played
 by default. For sounds, the following are used:

    Event                    Sound
    -------------------      ------------
    Main menu starts         Laser.wav
    Modem detects ring       Ringin.wav
    Local login/carrier      Carrier.wav
    Illegal password         Boing.wav
    Illegal login            Bang.wav
    User logs in             Connect.wav
    User logs out            Complete.wav
    Edit functions           Gunshot.wav
    QuickEdit/HexCalc        Whoosh.wav
    Out.File                 Glass.wav
    Bank/Casino              Cashreg.wav

 For information on setting  the  blaster environment variable  for the
 player, read the blaster.txt file.

 To turn off sounds, either:

   Set Playwav=0 in the Option??.cfg file
   Set the blaster environment variable to SET BLASTER=A0
   or, Delete or rename *.wav

 Option??.cfg also sets the blaster variables.

 29.0  Windows 16-bit vs. 32-bit vs. 64-bit
 ------------------------------------------
 QBasic  compiles  into 16-bit with no problems. In all 16-bit systems,
 such as Win95 and Win98, the 16-bit drivers are loaded in Autoexec.bat
 and Config.sys without problems.  In 32-bit systems  such as Win XP no
 16-bit device drivers for Cmd.exe are loaded at all. In 64-bit systems
 such as Win 7/10 no 16-bit programs can be loaded in Cmd.exe at all.

 Try a virtual machine or an emulator instead.

 In the DOSbox emulator the following are recommended in the
 dosbox-0.74.conf/dosbox-0.74-2.conf/dosbox-0.74-3.conf file:

   [cpu]
   core=dynamic
   cputype=auto
   cycles=max
   cycleup=10
   cycledown=20

   [render]
   frameskip=20

   [serial]
   serial1=modem
   serial2=modem
   serial3=modem
   serial4=modem

   [autoexec]
   MOUNT C: C:\
   SET COMPUTERNAME=MACHINE1
   C:\DNDBBS50\NOSHARE /I
   C:\DNDBBS50\X00 E 4

 30.0  Additional Opening Screen Function Keys
 ---------------------------------------------
 These are the remaining opening screen function keys:

   The following should all be used before doing a screen refresh:

     Alt-A to override base address
     Alt-B to override baud rate
     Alt-C to override comm port

   The following can be used to set/toggle fossil state:

     Alt-E to toggle fossil mode
     Alt-G to enable/disable fossil

   Used after port changes:

     Alt-R to refresh screen

DNDBBS UPDATE DOCUMENTATION
===========================

Version 1.0
-----------
First release.

Version 1.1
-----------
New commands:

BRIBE             CLOCK             DATE              END
EXIT              HOLD              LEAVE             OFFER
PARLEY            PAWN              TURN

Version 1.2
-----------
New attack commands:

BACKSTAB          CIRCLE            FEINT             HIT
PARRY             STRIKE            THRUST            CHARGE

Version 1.3
-----------
New commands:

DISMOUNT          FIRE              LOAD              MOUNT
RIDE

New spells:

BEFUDDLE          CONJURE           DRAIN             PASSDOOR
POISON            TURN

Version 1.4
-----------
Added six pages of configuration, and sixty pages of documentation.

Version 1.5
-----------
Now produces ANSI color codes.

Version 1.6
-----------
Added user fights and monster classes.

Version 1.7
-----------
Added another configuration page for modem support.

Version 1.8
-----------
Added more edit options.

Version 1.9
-----------
Added invisible treasure, monster room exit blocking, monster room
pickup prevention, weapon classes, weapon proficiencies, and the
dndedit full screen color editor.

Version 2.0
-----------
New help command for single topics.

New commands:

IDENTIFY          LOGIN             RELOGIN           STORE

Version 2.1
-----------
Added rings for protection of level drain, poison, and generic monster
spell.

Version 2.2
-----------
Added traps for poison needles, falling doors, and deadly spears.

Version 2.3
-----------
New commands:

CATALOG           DAYFILE

Version 2.4
-----------
New dndcnfg configuration program.

Version 2.5
-----------
New character class for ladies only.

New lady commands:

BEGUILE           CHARM

Version 2.5a
------------
Psionic spells including new psi stats, monster psionics, attack and
defense psi spells, and custom psi attack formulas for user and monster
psionics.

Version 2.6
-----------
Added player character alignment.

New attack commands:

COUNTER           GUARD             SHIELD

New spells:

DETECT EVIL       DETECT LOCK       DETECT TRAP

Version 2.6a
------------
Four new room directions northeast, southeast, southwest, northwest,
plus new top ten listing includes point ranking, and users can wish for
statistic points once per player.

Added new command:

ALIGNMENT

Version 2.6b
------------
Spells can be restricted to class type and have descriptions displayed
when they are cast, plus characters now have race classification.

Version 2.6c
------------
Added multinode commands:

/SAY              /SEND             /STATUS
/WHISPER          /YELL

Added multinode DM commands:

!BROADCAST        !NOID

Version 2.6d
------------
New player character class Assistant DM, new commands in mail and bank,
plus dndedit control-h help screens.

Version 2.7
-----------
All source code fully structured, gotoless, modularized, organized,
lowercased.

Version 2.7a
------------
Added weapon rusting, monsters can steal treasure, eat command for
edible food, spells can require up to five ingredients for casting
options of scrolls, magic devices, or by the cast command.

New character classes:

Town Mayor        Governor          GuildMaster

Version 2.7b
------------
New Commands:

DRIVE             ENTER             FLY               GO
LAUNCH            LEARN             LOAD              MOVE

New attack commands:

BEFUDDLE          BEMUSE            PUMMEL            RESIST

New spells:

INTOXICATE        HIDE              SEARCH            SET TRAP

Version 2.7c
------------
Additional logging to daylog, and many help files.

New commands:

COMMANDS          DAYLOG            HINT              NOTICE
PRELOG            REROLL            SORT              WELCOME

Version 2.8a
------------
User file codename, password, and classname encryption, more modem and
login configuration options.

Version 2.8b
------------
Added random percentage for hide command, daily maximum calls and
timeon restriction for each individual user, and message bases.

New commands:

ANSI              AUTO              GRAPHICS          WAIT

New spells:

IDENTIFY          ILLUMINATE        INVISIBILITY      ENLIGHTEN

Version 2.8c
------------
Added two letter command abbreviations, and configurable level ten
classnames.

Version 2.9a
------------
Added many synonymical commands.

New attack commands:

BEAT              DODGE             LUNGE             PUNCH

Version 2.9b
------------
Added nonplayers data file, edit and dndedit nonplayer editing.

New spells:

PSYCHE            TELEPATHY

More multinode commands:

ACCEPT            GIVE              IDENTIFY          OFFER

New paladin commands:

HUNT              TRACE

New ranger commands:

FOLLOW            TRACK

Version 2.9c
------------
Added parsable equations for spells and monsters, and dndutil bulletin
maker.

More multinode commands:

FIRE              LAUNCH

New thief commands:

STEAL             THROW

New cleric commands:

BLESS             CURSE

Version 2.9d
------------
Added illumination devices and fuel.

New commands:

FUEL              LIGHT

New display commands:

LASTUSER          WHO

Version 2.9e
------------
Added the dungeon maker utility.

New lady commands:

BEWILDER          BEWITCH

New lady attributes:

BEAUTY            GLAMOUR

Version 3.0
-----------
Added new / multinode commands:

/BLOCK            /GROUP            /NOSEND
/SAY              /SEND             /SENDTO
/STATUS           /WHISPER          /WHO              /YELL

Version 3.1
-----------
Added new | Sysop commands:

|CLOCK            |CONFIG           |DEBUG
|DOS              |EDIT             |MONITOR
|PROGRAM          |REBOOT           |SHELL            |SYSED

Version 3.2
-----------
Added team menu, player body hit points, and vehicle/room attributes.

Version 3.3
-----------
Rewrote |Config and |Sysed to allow remote editing.

Version 3.4
-----------
Added command class restrictions and time limits in dndcnfg security
variables.

Version 3.5
-----------
Added online user editing and fixed containers. Added more traps and
rings.

Added new commands:

WHATIS            WISH

Version 3.6
-----------
Added remote full screen editor and psuedo-interpreter.

Added new | Sysop commands:

|USAGE            |UTILITY

Version 3.7
-----------
Wrote mouse routines for dndcnfg and dndedit.

Added new adventure commands:

DISCHARGE         RELOAD

Version 3.8
-----------
Added boots, helmets, and trowsers. Added help search menu selection.

New multinode commands:

/AUTO             /BRIEF            /CHAT
/QUIT             /WAIT

Version 3.9
-----------
Added more inventory sort options. Added room link connect edit option.

Version 4.0
-----------
Added two-way door room links. Added short, medium, long dayfile list.

Version 4.1
-----------
Added connect baud rate strings and maximum time per user/session to
dndcnfg.

Version 4.2
-----------
Added teleport shop names in quotes. Allowed containers to disappear
when dropped in each other, and added a self-imploding container.

Version 4.3
-----------
Added vga screen mode lines per page 25, 43 and 50. Edited actions for
multiple random room number teleport and added imbedded ansi output
strings.

Version 4.4
-----------
Added new spell commands:

MIX               POUR

Added new adventure commands:

PRESS             SWITCH

Version 4.5
-----------
Added Dndcnfg custom modem connect baud rates, and more teleport
functions.

Added new look types:

LOOK ROOM         LOOK INVENTORY    LOOK TOGGLE
LOOK ROOMNUMBER

Added new commands:

TAKE ALL          DROP ALL          TAKE AUTO

Version 4.6
-----------
Added Dndutil automatons, and Dndcnfg control-h help screens.

Version 4.7
-----------
Converted all code to Visual Basic 1.0, and file indexes to single
precision. Room inventory is now a doubly linked list. Added
Container.doc file.

Version 4.8
-----------
All inventory files are now doubly linked lists. Added Containr.doc
file.

Command 'Drop All <container>' added. Sysops can use '!Kill All'

Version 4.9
-----------
Expanded the Bank command. Added midnight packing to node zero. Added
the liquid type to potions. Containers now have traps, attributes for
size, and can have contents restricted to specific items of treasure.

Version 4.9b
------------
Added guest.cfg file for guest accounts and open/closed system. Added
cursor up/down and ctrl-up/down and keypad 5 key for increasing and
decreasing time left. Added page-up/down for quick edit of online user.

Added new commands:

REPAIR ROOM       REPAIR INVENTORY         REPAIR CONTAINERS

Version 4.9c
------------
Added startup.cfg file for startup overrides. Added modems.dat datafile
for dndcnfg modems selection. Improves opening screen with new Alt-keys.
Also adds several new command line switches. Added custom .lib files.

Added new look types:

LOOK MONSTERCLASS                          LOOK ROOMACTION

Version 5.0a
------------
Added new Thief commands to: Look in, Search, and Identify player
containers, steal containers from player, steal item from container
from player, and steal container from container from player.

Added offer container to player for item, offer item to player for
container, and offer container to player for container.

Added offline player team fights. Wrote Helpedit and Import utilities.
Monsters now can hold weapon, shield and wear armor. Monster weapon,
shield, and armor plus added to monster attack and defend formulas.

Removed support for DoubleDOS and Desqview. Added vehicle occupants.

Added new command types:

LOOK BANK         LOOK MAIL         LOOK SELF

Added new node commands:

/BLOCK SELF       /NOSEND SELF

New commands:

BURN              DECLINE           IMBUE             SMOKE
WRITE             ZAP

Packing list for Dndbbs Version v5.0a r2.0:
===========================================

   Executable files:

      Ansi.exe          --   Screen blanker.
      Copyscrn.exe      --   Displays copyright screen.
      Dndbbs.exe        --   Dndbbs main program.
      Dndcnfg.exe       --   Configuration program.
      Dndcnvt.exe       --   Dndoor conversion program.
      Dndedit.exe       --   Sysop full screen editor program.
      Dndedit?.exe      --   Sysop full screen editor subprograms.
      Dndinit.exe       --   Data file initialization program.
      Dndinit1.exe      --   Auxiliary initialization program.
      Dndinit2.exe      --   Auxiliary initialization program.
      Dndpack.exe       --   Inventory file pack utility.
      Dndsic.exe        --   BASIC pseudo-interpreter.
      Edit.exe          --   Data file menu editor program.
      Editcmd?.exe      --   Data file menu editor subprograms.
      Makecnfg.exe      --   Default .cfg file maker.
      Makesys.exe       --   Creates default user files.
      Uninstal.exe      --   Generic uninstall utility.

      Cmd*.exe          --   Main command programs.

      Dndutil.exe       --   Generic utility program.
      Dndutil.cfg       --   Configuration file for Dndutil.
      Dndutil.doc       --   Dndutil documentation.
      Dndutil.txt       --   Dndutil features.
      Dndmove.cfg       --   Config file for Dndutil /A command.

   Batch programs\files:

      Setup.exe         --   Installs Dndbbs.
      Dos?.bat          --   Contains DOS commands for shell function.

   Data files:

      Actions.dat       --   Room action descriptions.
      Automate.dat      --   List of automatons.
      Containr.dat      --   List of containers.
      Ctninv.dat        --   Container inventory.
      Dmhelp.dat        --   Help text for DMs.
      Dndedit.dat       --   Help screens for Dndedit.
      Dndusage.dat      --   Stores program usage.
      Edithelp.dat      --   Help text for Edit.
      Help.dat          --   Help text for players.
      Lastuser.dat      --   List of previous players.
      Logoff.dat        --   Display file for logoff. (editable text).
      Logon.dat         --   Help text for logon.
      Messbase.dat      --   List of message bases.
      Modems.dat        --   List of modem models and commands.
      Monclass.dat      --   List of monster class numbers.
      Monsters.dat      --   List of monster stats.
      Montalk.dat       --   List of monster talk responses.
      Nonplyrs.dat      --   List of nonplayers stats.
      Notice.dat        --   Display file for logon. (editable text).
      Objects.dat       --   List of object stats.
      Prelog.dat        --   Display file for logon. (editable text).
      Private.dat       --   Private message base file.
      Public.dat        --   Public message base file.
      Roomdesc.dat      --   Room description file.
      Roominv.dat       --   Room inventory.
      Rooms.dat         --   List of room stats.
      Spells.dat        --   List of spell stats.
      Teaminv.dat       --   Team inventory.
      Teamuser.dat      --   Lists of players teams.
      Treasure.dat      --   List of treasure stats.
      Userinv.dat       --   User inventory.
      Userlog.dat       --   File of player activity.
      Users.dat         --   List of user stats.
      Welcome.dat       --   Display file for logon. (editable text).

      Private.tbl       --   Table of private message base.
      Public.tbl        --   Table of public message base.

      Private.new       --   Table of private message base new messages.
      Public.new        --   Table of public message base new messages.
        (message base files also named with extensions .dat, .tbl, .new)
        *.bk1, *.bk2   --   Message backup files from packing.

      Dndbbs.day        --   List of player logon activity.
      Dndbbs.log        --   List of player game activity.

      Dnd.cfg           --   Default configuration file for nul node.
      Dnd??.cfg         --   Configuration files for nodes 0-9, A-Z, 10-99.
      Dndpack.cfg       --   Config file for Dndpack program.
      Guest??.cfg       --   Config file for guest login.
      Start??.cfg       --   Config file for startup options.

      Lastlist.txt      --   Lists previous players logon.
      Ranklist.txt      --   Lists top ranking players.
      Teamlist.txt      --   Lists team players.
      Teamrank.txt      --   Lists top ten teams.
      Userlist.txt      --   Lists players in game.

      Lastlist.ans      --   Ansi bulletins.
      Ranklist.ans      --    '   '
      Teamlist.ans      --    '   '
      Teamrank.ans      --    '   '
      Userlist.ans      --    '   '

   Document files:

      Catalog.doc       --   Short categorization of user commands.
      CatalogM.doc      --   Short categorization of node commands.
      CatalogD.doc      --   Short categorization of DM commands.
      CatalogS.doc      --   Short categorization of Sysop commands.
      Commands.doc      --   Short list of commands and abbreviations.
      Dndbbs.doc        --   Complete description of all commands.
      Dndcnvt.doc       --   Documentation for conversion utility.
      Edit.doc          --   Complete description of all edit commands.
      Hint.doc          --   Short list of hints for playing.
      Outfile.doc       --   List of text file replacement strings.
      Readme.com        --   Program to view readme.1st.
      Readme.1st        --   File describing installation and operation.
      Readme2.com       --   Program to view readme.txt
      Readme.txt        --   File describing uninstall information.
      Restrict.doc      --   List of character command restrictions.
      Summary.doc       --   Short explanation of all player commands.
      SummaryM.doc      --   Short explanation of all node commands.
      SummaryD.doc      --   Short explanation of all DM commands.
      SummaryS.doc      --   Short explanation of all Sysop commands.
      Sysop.doc         --   Complete installation procedures.
      Version.lst       --   List of versions and features.

      File_id.diz       --   Upload file description.

      Register.frm      --   Lists donation information.
      Packing.lst       --   Lists files in system.

   External auxiliary files:

      Command.com       --   DOS Command Interpreter.
      Edit.com          --   DOS editing utility.
      Edit.hlp          --   Help file for edit.com

      Shroom.com        --   Program swap utility.
      Shroom.doc        --   Utility usage documentation.
      Shroom.txt        --   Utility readme documentation.

   Utilities:

      Helpedit.exe      --   Help.dat text/command editor.
      Helpedit.txt      --   Help editor documentation.

      Import.exe        --   Treasure/Spells text file import utility.
      Import.txt        --   Import documentation.
      Import1.dat       --   Description of treasure.txt import file.
      Import2.dat       --   Description of spell.txt import file.
      Import3.dat       --   Example of treasure.txt import file.
      Import4.dat       --   Example of spell.txt import file.

   Suplementary external auxiliary files:

      Ansi.sys          --   Screen code device driver.
      Emm386.exe        --   Expanded/extended memory driver.
      Himem.sys         --   High/upper memory block device driver.
      Mouse.exe         --   Mouse driver.
      Ramdrive.sys      --   RAM drive device driver.
      Scrnsave.exe      --   Calls Windows screen save function.
      Setver.exe        --   DOS program version device driver.
      Share.exe         --   DOS file record locking driver.
      Smartdrv.exe      --   Disk cache device driver.
      Tee?.exe          --   Screen utilities for remote DOS access.
      X00.sys           --   Communication port device driver.

   Secondary external files:

      Cooked.asm        --   Screen speed utility source.
      Cooked.com        --   Screen speed utility program.

      Raw.asm           --   Screen speed utility source.
      Raw.com           --   Screen speed utility program.
      Raw.doc           --   Screen speed utility documentation.
      Raw.lst           --    '   '
      Raw.txt           --    '   '

      Tee?.bas          --   Tee utility program source.

      Lowerdtr.exe      --   Communication port DTR utility.
      Raisedtr.exe      --    '   '

---

Categorized catalog of all commands in Dndbbs:

Combat commands:

Attack         Backstab       Beat           Befuddle       Beguile
Bemuse         Bewilder       Bewitch        Bless          Charge
Charm          Circle         Counter        Curse          Dodge
Feint          Fire           Guard          Hit            Imbue
Kill           Launch         Lunge          Parry          Pummel
Punch          Resist         Return         Shield         Throw
Thrust         Turn           Zap

Entry commands:

Appeal         Break          Close          Dismount       Drive
Eat            Follow         Go             Hide           Hunt
Lock           Lose           Mount          Move           Open
Panic          Picklock       Pull           Push           Ride
Run            Smash          Trace          Track          Unlock

Direction commands:

Down           East           Enter          Fly            In
North          Northeast      Northwest      Out            South
Southeast      Southwest      Swim           Up             West

Help commands:

Catalog        Commands       Help           Hint           Whatis

Listing and information commands:

Bulletin       Check          Clock          Date           Dayfile
Daylog         Examine        Experience     Health         Identify
Information    Inventory      Lastuser       Look           Notice
Prelog         Users          Welcome

Spell casting commands:

Burn           Cast           Discharge      Drink          Eat
Learn          Mix            Pour           Psionic        Reload
Smoke          Use            Wish

Inventory commands:

Accept         Bribe          Decline        Draw           Drop
Fuel           Get            Give           Hold           Light
Load           Offer          Put            Read           Search
Sell           Steal          Take           Trade          Wear
Wield

Game control commands:

Ansi           Avatar         Chat           Duplex         Echo
Graphics       Linefeed       Linelength     Login          Pagelength
Password       Quit           Relogin        Reroll         Save
Setting        Sort           Stop           Store          Suicide
Time           Top            Train          Wordwrap

Adventure control commands:

Alignment      Auto           Brief          Bye            Configure
Parley         Press          Talk           Switch         Wait
Write

Shoppe commands:

Bank           Buy            Casino         Fix            List
Mail           Pawn           Recharge       Repair         Sell
Team

Lady commands:

Beguile        Bemuse         Bewilder       Bewitch        Charm

Also try:

'Look Room', 'Look Inventory', and 'Look Toggle'.

Dungeon Master Commands:

DM commands with [] require a parameter.

DM commands with <> can have an optional parameter.

!Abort <>       !Broadcast      !Call <>       !Discard []     !Edit <>
!Get []         !Help <>        !Invisible     !Kill []        !Link
!Noid           !Reduce []      !Status        !Teleport []    !Zap <>

Multinode messaging commands:

The <> replacement parameter is required.

The [] replacement parameter is optional.

/Auto          /Block <>      /Brief         /Chat          /Echo
/Group         /NoSend <>     /Quit          /Say <>        /Send <>
/SendTo <>     /Status []     /Whisper <>    /Wait          /Who []
/Yell <>

Sysop commands:

|Clock       |Config      |Debug       |Dos         |Edit      |Monitor
|Program     |Reboot      |Shell       |Sysed       |Usage     |Utility
|Control     |Password    |Toggle

GENERAL DISCLAIMER NOTICE
=========================
'DNDBBS Version v5.0a' IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.

THE  AUTHOR  DISCLAIMS  ALL  WARRANTIES,   EITHER  EXPRESS  OR  IMPLIED,
INCLUDING   THE   WARRANTIES  OF   MERCHANTABILITY  AND  FITNESS  FOR  A
PARTICULAR PURPOSE.

IN NO  EVENT SHALL THE  AUTHOR OR ANY SUPPLIER BE LIABLE FOR ANY DAMAGES
WHATSOEVER INCLUDING DIRECT,  INDIRECT,  INCIDENTAL, CONSEQUENTIAL, LOSS
OF  BUSINESS PROFITS OR  SPECIAL DAMAGES,  EVEN  IF THE  AUTHOR  OR  ANY
SUPPLIER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

SOME  STATES  DO NOT ALLOW  THE EXCLUSION OR LIMITATION OF LIABILITY FOR
CONSEQUENTIAL  OR  INCIDENTAL  DAMAGES  SO THE FOREGOING LIMITATION  MAY
NOT APPLY.   PLEASE   CHECK   WITH YOUR  LOCAL  AND STATE  AGENCIES  FOR
INFORMATION  ABOUT ANY  APPLIED  RESPONSIBILITIES  REGARDING  THE  ABOVE
NOTICES.

THE  AUTHOR OF DNDBBS IS  NOT  RESPONSIBLE  FOR ANY DAMAGES  DUE  TO THE
PUBLIC REVERSE ENGINEERING OF THE PRODUCT.

Microsoft product:

WARNING:  THIS  MICROSOFT PRODUCT  HAS BEEN TESTED AND CERTIFIED FOR USE
ONLY  WITH THE  MS-DOS AND PC-DOS  OPERATING SYSTEMS.  YOUR  USE OF THIS
PRODUCT  WITH  ANOTHER  OPERATING SYSTEM  MAY  VOID  VALUABLE   WARRANTY
PROTECTION PROVIDED BY MICROSOFT ON THIS PRODUCT.

Author: Erik Jon Oredson
Support: dndbbs@gmail.com
Url: www.filegate.net

Special care  has been used in making sure  shareware author notices for
their distribution  instructions  has  been made.  To date the following
authors and their instructions is included:

BNU v1.70: David Nugent

"Permission  is  granted  to  repack the  distribution  archive  using a
different  packing  method,   provided  that  the  uncompressed contents
EXACTLY match the uncompressed contents of the distribution archive.."

(these files are exactly distributed with Dndbbs in \drivers:  Bnu.Com,
Bnu.Doc, Bnu.Sys, Fossil.Txt, Bnuport.zip, Bnuutil.zip).

X00.SYS v1.50: Raymond L. Gwinn

The License.txt notice is:

1. You may copy and distribute verbatim copies of X00 as you receive it,
in any medium, provided that you conspicuously and appropriately publish
on each copy a valid copyright notice:

 "Copyright (C) 1987, 1988, 1989 Raymond L. Gwinn"

 (I am doing that here).

2. ...keep  intact the notices on all  files that refer to this  License
Agreement and to the absence of any warranty;  PROVIDE UNMODIFIED COPIES
OF THE DOCUMENTATION AS PROVIDED WITH THE PROGRAM;

 (these files are being included).

3. ...and  give  any  other  recipients of  X00  a  copy of this License
Agreement along with the program.

 (this information is in License.txt)

4. ...You may not copy, sublicense, distribute or transfer X00 except as
expressly provided under this License Agreement.

 Notes from the Author:  Hacked versions of X00 such as v1.53a and v2.02
 are not distributed with Dndbbs.

SHROOM v2.6a: Davis Augustine

"This is a copyrighted  software work which is distributed as shareware.
Under  this license agreement you  are granted the  right to  use Shroom
on all machines and environments that it supports."

ANSICON v1.01: Jason Hood

The original zipfile can be freely distributed, by any means. However, I
would  like  to  be  informed if it is placed on a CD-ROM (other than an
archive compilation).  Modified versions may be distributed, as long  as
the original zipfile is included (I would prefer to be contacted).

NOSHARE TSR  Version 1.00  Copyright (c) Martin Filteau, 1993

 This program is provided as is, with no warranty whatsoever.  You use it
 at your own risk and the author will not assume any responsability. This
 software is free but donations and comments will be greatly appreciated.

 Martin Filteau                Internet: filteau@scribens.polymtl.ca
 9416 ave de Bretonvilliers    CIS:      72607,2711
 Montr‚al (Qu‚bec), Canada
 H2M 2B1

WATCHCAT TSR port carrier monitoring utility:

     WATCHCAT is in the public domain may be  freely distributed provided
 the WATCHCAT.DOC, WATCHCAT.ASM, and WATCHCAT.COM files  are not modified
 in any way. Users are free to adapt the program as they see fit. I would
 appreciate a copy of such adaptations.

 Joseph R. Ahlgren
 RBBS 703-241-7980
 89/08/23

Also thanks to the following:

 Dmaplay.bas code was adapted from Dma.zip written by Mike Huff  (1996).

 Which was modified by Martin Rampersad.

 And was rewritten into Playwav.bas,

 Program downloaded from http://www.ocf.berkeley.edu/~horie

Finally thanks to:

 Mods suggested by:

  C.G. Learn
  DesotoFireflite@comcast.net

 Adds /B## and /B:## baud override to command line in dndsub1.bas
  Adds /A:"xxx" base port address to command line
   Adds /TN telnet switch to bypass door file
   (affects dndbbs.exe)

Final Notes:

The  Author of  Dndbbs would like to thank the  Authors of all  imbedded
source  being  distributed  with   Dndbbs  and  respects  their included
shareware notices.

Programming notes:

When  writing  programs,  the  limitation  of  'the perfect interpreter'
  appeared.

It seems that  since it takes programming code to  interpret programming
  code, no interpretive system can become complete.

Therefore,  any  consistently written program  can  be  only so  complex
  before  the  limitation occurs. Also note a program cannot have both a
  deadline  and  upper limit  on  lines of code  at the same time.  This
  paradox  arrives due  to the  nature of  physics  particles  since the
  analogy between position and velocity holds true for data.

=========== END OF DOCUMENTATION ============
