                           The L.O.R.D. Cavern v1.5
                               By Jason Brown.
                      Maintained by Donald Tidmore.

                  Compiled with Borland Turbo Pascal 7.0
             Uses DDPlus v7.1 by Steven Lorenz and Bob Dalton
                For Legend of the Red Dragon by Michael Preslar

                   (LORD was created by Seth Able Robinson.)
                    (It is now owned by Metropolis Gameport.)

                           Version date: 11/02/2002

                            Docs update 12/31/2002


[LEGAL DISCLAIMER]

                         DISCLAIMER OF WARRANTY

            THIS SOFTWARE AND MANUAL ARE SOLD "AS IS" AND WITHOUT
            WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY
            OTHER WARRANTIES WHETHER EXPRESSED OR IMPLIED.  BECAUSE
            OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS INTO
            WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR
            A PARTICULAR PURPOSE IS OFFERED.  GOOD DATA PROCESSING
            PROCEDURE DICTATES THAT ANY PROGRAM BE THOROUGHLY TESTED
            WITH NON-CRITICAL DATA BEFORE RELYING ON IT.  THE USER
            MUST ASSUME THE ENTIRE RISK OF USING THE PROGRAM.  ANY
            LIABILITY OF THE SELLER WILL BE LIMITED EXCLUSIVELY TO
            PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.
-----------------------------------------------------------------

[INTRODUCTION]
I wanted to write an IGM.  So here it is.  I've seen random event IGMs
before, but not with this range of events!  Some just give or take,
others make the player make a choice, and still more test intellect.
A well rounded mix, if you ask me.  Oh, yeah, its multi-node and needs
only LORD's drop-file and node definition file.  One last thing, please
excuse spelling errors.  That's not my high-point in life.
-----------------------------------------------------------------


[FILE LIST]
 Note: EXTRA.CFG is no longer included in the ZIP, SETUP creates it,
 if it does not already exist.  Files that should be in CAVE15.ZIP:

  FILE_ID.DIZ   : BBS Description File. (LordCave.diz)
  LORDCAVE.TXT  : You're reading it!
  LC_Whats.txt  : Revisions, What's new in this version. (whatsnew.txt)
  CaveCode.txt  : Info on how to program your own random happenings!
                  Previously named Codes.txt.
  LCSAMPLE.RHP  : A sample Random Happening Program.
                  RENAMED FROM PROGRAM.SMP!
                  Renamed from Sample.rhp - 11/01/02.
 *ROCK.RHP      : A Random Happening Program: The Strange Rock v1.10.
                  RENAMED FROM ROCK.PRG!
 *LORDCAVE.ANS  : Intro ANSI file.
 *LORDCAVE.EXE  : The L.O.R.D. Cavern!
 *SETUP.EXE     : Setup program for The L.O.R.D. Cavern IGM.
  LORDCAVE.ICO  : Windows9x icon.
  HOMEPAGE.URL  : Internet Shortcut to Jason Brown's web-page,
                  and to my Castle Camelot LORD Links Page.
  ============================

  Files that are made by The L.O.R.D. Cavern in its directory:
  ------------------------------------------------------------
 *LORDCAVE.DAT  : Player record file.
 *CAVETIME.DAT  : Time keeping file.
 *LORDCAVE.CFG  : Configuration file.
 *EXTRA.CFG     : Extra config file, see [EXTRA SETUP INFO].
  REGISTER.FRM  : Optional: in case you don't have a printer on your BBS
                  computer.   (No longer needed - IGM is Freeware.)
  ERROR.LOG     : Created in directory ran from, usually LORD's, that has
                  any errors that happen in it.

  * = Needed for program to run.

  BTW: Setup isn't really needed.  It's just nice to keep around.  <G>

  BUT, if you don't have it, then you can't change your IGM settings.
      Or install new RHP Script events, or view existing ones, etc.

  Do *NOT* rename Setup.exe.  It has to be that filename to install
  the IGM properly in your LORD game.  Which is why it is important
  to use a separate subdirectory for this IGM.

  LORD Cavern will co-exist in an IGMs Directory with other IGMs,
  provided that they don't use any files that Lordcave.exe uses,
  such as Setup.exe, extra.cfg, or lordcave.dat.
------------------------------------------------------------------------

[REQUIREMENTS]
LORD version 3.25 or greater.
DOS (version 3.1 or better) or compatible operating system.
SHARE installed for multinode systems.
A Modem!  300-115,200 baud and any fossil lock baud rate up to 115,200.
  (Works well on telnet, too!)
286 or better processor (should not be a problem...)
Memory!  Very little needed to run...  never actually bothered to find out.

** Note 1:  Share.exe is not required for usage on systems using
Windows 95, Windows 98, Windows 2000/NT, Windows ME, Windows XP,
or non-Microsoft O.S.'s such as OS/2 or Linux. At least for Local
Mode play.  It may still be needed for multi-node usage of the IGM.

** Note 2:  IGM verified to work without problems under Windows ME.
   Running either LORD v4.06 or LORD v4.07 beta (January-August 2002
   compilations). **

*** Note 3: IGM was fully tested using Pentium III and IV CPUs.
-----------------------------------------------------------------


[UPGRADING]
All versions:
Your IGM will need to be reset, if you used ROCK.PRG, it must be renamed
in your EXTRA.CFG.

From v1.2c or earlier:
Copy the files in the zip over your existing files.  See the section
[EXTRA SETUP INFO] to set-up EXTRA.CFG.  If you want, edit LORDCAVE.CFG
using SETUP to include your handle, else it is set to a blank string.

From v1.3 or v1.3a:
Copy the files in the zip over your existing files.  If you want, edit
LORDCAVE.CFG using SETUP to include your handle, else it is set blank.

From v1.3b+:
Copy the files in the zip over your existing files.  No additional
configurations needed.

--------------------------------
From v1.4b:
Unzip all files from Cave15.zip, over-writing existing Cavern files,
into subdirectory where LORD Cavern is installed.  If you used any
of the L.O.R.D. Cavern RHP Set #1 and #2 files, those all need to
be replaced with the current versions.  So remember to get Caverhp1.zip
and Caverhp2.zip.  The most current files are always posted here:

  http://www.fidotel.com/public/camelot/Scripts/ directory.
  http://www.filegate.net/camelot/lordfile/ directory.

RHP Script files have to be in the SAME directory as LORD Cavern is in.
Follow the regular instructions for Installation now.  The IGM will
run properly without any RHP scripts installed.  They simply add
additional dimensions to your adventure in the Cave.
-----------------------------------

Script authors who use @DEFENSE@, @SKILLUSE@, etc., codes from this
update are reminded that they must use @VERSION@ 1.5 in their scripts.
-----------------------------------------------------------------


[INSTALLATION]
Put the files in the zip in a directory off of your LORD directory.
May I suggest naming the directory "LORDCAVE"?  Then run SETUP.
Press 'C' to configure first.  Then press 'S' to configure EXTRA.CFG.
This is so the User/Sysop can add RHP programs (see [EXTRA SETUP
INFO]), and to specify how many Cave Searches are allowed each day.

The rest shouldn't be too hard to figure out.  Just answer all of the
questions.  Installing (pressing 'I' after leaving the Configure sub-menu)
will put the IGM's run lines into 3RDPARTY.DAT, and an announcement
that The L.O.R.D. Cavern has been installed will be written in the
Daily Happenings log file (lognow.txt).
------------------------------

Special Notes:  LORD Cavern will work fine in an IGMs directory with
other IGMs, *AS LONG* as the others do NOT use an Setup.exe or Extra.cfg
file.  They also can't use either Lordcave.dat or Cavetime.dat.

The L.O.R.D. Cavern, Outlands Tavern, and the Gateway each use the same
filenames for the Config program, and IGM config data file.  It is
mandatory that each of the three IGMs be in a separate directory.

Do NOT try to use either IGM with Setup.exe file renamed.  Each IGM is
hard-coded to use setup.exe.

For backup purposes ONLY, user can copy extra.cfg to LC-extra.cfg name,
for example.  If you do this, remember to update the file whenever you
have re-run the Setup program.
======================================================================

For those of you who want to edit LORDCAVE.CFG yourself, here's a
listing of it:

LORDCAVE.CFG Listing:

D:\BBS\LORD\
Unregistered BBS
Unregistered
Sysop
Sysop #1
000000

Line 1: Path to LORD with trailing backslash
Line 2: Your BBS name
Line 3: Your real first name
Line 4: Your real last name
Line 5: *NEW!* Your handle (optional).  Displayed at start up instead
        of your real name, no effect on registration, can include LORD
        codes.
Line 6: Your registration code.  Put in '000000' if not registered, please.
        ** Not applicable now.  All versions are fully usable and Freeware.

The path must be on the first line, and no comments are allowed unless
they are after the registration code's line.
----------------------------------------------

In v1.3 - v1.4x versions, the File_id.diz file states that the IGM will
use non-standard COM ports.  There is no configuration setting for that,
since the IGM obtains the information from LORD's Node*.Dat file.  As long
as LORD is set-up correctly, this will be set-up right in that respect.
I wish more IGMs used that Node*.Dat, too...
----------------------------------------------

These are the lines put in 3RDPARTY.DAT by The L.O.R.D. Cavern:

<path to lordcave>\LORDCAVE.EXE *
`#T`5he `#L`5.`#O`5.`#R`5.`#D`5. `#C`5avern`2

Just in case you wanted to know.  :^)

========================================
Example:  c:\lord\LORDCAVE\LORDCAVE.EXE * would be your first line,
if you installed LORD in root directory of Drive C:.
-----------------------------------------------------------------


[EXTRA SETUP INFO]
Use SETUP's option 'S' to edit the extra information, which allows
you to install RHP scripts, and to set how many Cave Searches are
allowed each day.  The program should be straight forward...
-------------------------

Advice to sysops:  You should avoid using anything over 60 searches
per day, unless your LORD game is so competitive that normal
interaction between players can off-set the net rewards a player
will get from using L.O.R.D. Cavern each day.  Try using the IGM
yourself to get an idea of what # of Cave Searches to use.
-----------------------------------------------------------------


[UNINSTALLING]
Note: To reset The L.O.R.D. Cavern, run SETUP and press 'R'.

Now why would you want to un-install? <G>?  Well, run SETUP, press 'U'.
Unless it's in an IGM extender's files.  Then use the expander to
uninstall The L.O.R.D. Cavern.  IGME is great with that... Wait!  I
mentioned something not written by me!  Oh, no!  Seriously, its a
great program.  Look in to it...

==================================================
Provided the user is running LORD v3.50 - v4.00a - by Seth Robinson;
or v4.02 - v4.07 - by Michael Preslar;  LORD will automatically handle
as many IGMs as you wish to install.  However, unless you are using
the LordMenu utility, any IGMs installed over 24 will result in user
having the Other Places menu scroll upward until the command prompt
appears.  Use of LordMenu v1.30 - by Lloyd Hannesson - allows you to
list installed IGMs in a two columns per line menu.
--   http://www.dasme.org/techn/files/lrdmnu13.zip (LordMenu v1.30)
-----------------------------------------------------------------


[USING IT]
Just select The L.O.R.D. Cavern in the Other Places in LORD.  It will
do maintenance automatically when the first person for the day enters,
and it doesn't take that long.  BTW, if you use 'Clean Mode' in LORD
(with version 3.26+) then the user can't get laid, as found in one
of the random Cave options.  It's still there, just reworded so it will
correspond to "Clean Mode" environment.
-----------------------------------------------------------------


[REGISTRATION]
As of version 1.4a, The L.O.R.D. Cavern is freeware!  Thanks go
out to everyone that registered, I really appreciate it!

If you have comments, bug reports, or the like send them to:
  InterNet Email: jmbrown@pcisys.net
Be sure to include your version number.  Thanks!

** For version 1.5+ support, please send messages to Donald Tidmore.
   Email:  ktidmore@bellsouth.net or donald.tidmore@usa.net.
-----------------------------------------------------------------


[OTHER PRODUCTS]
Here is the other LORD stuff that I've done!

The L.O.R.D. Cavern RHP Set #1 - 5 RHP programs for The L.O.R.D. Cavern!
(CAVERHP1.ZIP)              The Lost City of Darborne, The Waterfall, The
                            Old Magician, The Diamond Mine, and The
                            Canyon.  v1.3a+ (some require v1.3c+).

The L.O.R.D. Cavern RHP Set #2 - 5 MORE RHP programs for The L.O.R.D.
(CAVERHP2.ZIP)              Cavern!  The Bats, The Flower Patch, A Random
                            Hobbit, The Mushroom Patch, and The Cavern
                            Women.  All written by users!  v1.3b+ (some
                            require v1.3c+).

LordStat v1.7 - Bulletin generator for LORD 3.15+ - 11 different bulletins
(LORDST17.ZIP)  to spice up your LORD game!  Helps users to pick and
                choose who to attack, and tells who is the best warrior in
                the Realm!  Now also tells users where others are in the
                Realm, sleeping in the Inn, Field, or in an IGM!  New
                bulletin lists the installed IGMs!  Lets you not use any
                of the bulletins you don't want to, and has an easy to use
                built in SETUP program!  Now has the ability to have custom
                bulletins made!  Includes Renegade, Wildcat! and
                RemoteAccess pause code support.  Freeware.

The Outlands Tavern v1.4 - IGM for LORD 3.50+ - Great IGM for LORD!  Lets
(OUTS14.ZIP)       users talk and PARTY!  Best of all, users can stay
                   overnight in the Tavern, for a fee, and be safer than in
                   LORD's Inn!  There's still a chance someone might get
                   them!  New BackRoom will spice up the stay and includes
                   support for BADWORDS.DAT!  Also has RHP support!
                   Freeware.   Restored Taste Punch event. Added defensive
                   skill technique usage to Player Fights.

The Gateway v1.1 - IGM for LORD 3.25+ - This neat-o IGM will allow
(GATE11.ZIP)       you to run RHP scripts like they were normal IGMs
                   (well, sort of).  Freeware.

RHPTest v1.2     - Utility program for RHP Script writers to use in
(RHPTST12.ZIP)     testing their Scripts outside of the LORD IGM
                   they are written for.  Allows some evaluation of
                   how they work without your having to start playing
                   a LORD game session.
--------------------------------------------------

Stones! v1.2 - A LORD2 IGM by Jason Brown.  Support and development was
    taken over in June 2002 by Max Larivee.  Contact Max at
    fieldsoft@hotmail.com with any questions about Stones! v1.20.
-----------------------------------------------------------------


[DISTRIBUTION SITES]                   Revised 12/31/2002.
Check out these Internet sites!

FTP:  None used by Jason Brown.
WWW: http://www.pcisys.net/~jmbrown/
My World Wide Web page includes links to other pages, like Seth Able's!

Email: jmbrown@pcisys.net -OR- farlander@mailandnews.com
--------------------------------------------------------

Current distribution sites update:
----------------------------------
FTP:      ftp://ftp.lordlegacy.org/lordlegacy/igms/
          12/04/02: No longer have access to FTP server.

WWW #1:   http://www.fidotel.com/public/camelot/camelot6.htm
          Castle Camelot LORD IGMs Page

WWW #2:   Backup Castle Camelot web-site - GeoCities server.
          http://www.geocities.com/donaldtidmore/camelot6.html

Download URL:  http://www.fidotel.com/public/camelot/LordApps/
          Official releases of L.O.R.D. Cavern, The Gateway,
          Outlands Tavern, LordStat, and RHPTest.

Download URL:  http://www.fidotel.com/public/camelot/Scripts/
          Current releases of L.O.R.D. Cavern RHP Sets #1 and #2,
          Outlands Tavern RHP Set #1, and LADY Script files.
          * Only the .ZIP files are available as of 12/04/02.

Fidonet:  http://www.filegate.net/camelot/lordfile/
          Camelot LordNews FDN.

Fidonet Mail:  use 1:123/450, and post to LORD Echo.  If writing
          using my name, address messages to Donald Tidmore.

Email:    ktidmore@bellsouth.net - OR- donald.tidmore@usa.net
-----------------------------------------------------------------


[CLOSING]
Thanks to Thomas Wendland, Michael Pacheco, and Jim Rainer for testing
this program.  For their kindness and help they got FREE registrations.

Thanks to Thomas Wendland, aka Mathias, for doing the intro ANSI.

Thanks to Michael Everett for testing the latest betas!

Thanks to Seth Able Robinson for writing LORD and releasing the
  PLAYER.DAT structure.

If you have any bug reports or comments you can reach me at:
  Email: jmbrown@pcisys.net
-----------------------------------------------------------------


[REVISIONS - June-November 2002]
Updated program version references for L.O.R.D. Cavern, LordStat,
The Outlands Tavern, and The Gateway.  Added info for RHPTest, Stones!,
and L.O.R.D. Cavern RHP Set #2.  Updated email contact information.

L.O.R.D. Cavern RHP Sets #1 and #2 documentation updated.

Thanks to Michael Everett, Gary Hartzell, Gordon Lewicky, and
Charlie Wardick for their assistance in beta testing updated
versions in summer 2002.

Special thanks to Charlie Wardick for lessons in learning PASCAL again,
learning how to use Turbo Pascal, and learning LORD programming.

Special thanks to Gordon Lewicky for identifying reason for IGM not
properly generating truly random numbers for determining which IGM
event is executed.  Note that the faster the CPU is, the player will
still see some events occur more than others, or perhaps consecutively.

12/04/2002:  My old web-site was terminated, so I have resumed usage
of my original GeoCities site.  A new long-term site will be setup
again somewhere else later this month.
=====================================================


BBS Testers info:
------------------
1) Gordon Lewicky - Email: glewicky@telus.net.  Sysop Milkyway
   !:153/307,  Milky Way, 1;153/307;  or Fidonet 1:153/0.
   Sysop of Milkyway BBS. in British Columbia, Canada.

2) Michael Everett - Email: sysop@bobobbs.net.
   Sysop of Bobo's BBS.  http://www.bobobbs.net, telnet://bobobbs.net

3) Paul Koukos - Email:  444@hellasbbs.com
   Sysop of Hellas BBS.   http://hellasbbs.com, telnet://hellasbbs.com

4) Gary Hartzell.  Email: gary.hartzell@verizon.net.

5) Charlie Wardick:  Email: chasware@cox.net, Phoenix, Arizona.

Thanks to Michael Preslar for keeping LORD alive through v4.06
and v4.07 beta.

=================================================================
Note: This IGM is NOT tested under LORD/x for Linux.  Neither Jason
or I use Linux.  So no guarantees are made that this IGM will run
properly under anything other than the DOS version of Legend of the
Red Dragon.  Whenever, LORD/32 for Windows becomes available to
the public, a 32-bit version of L.O.R.D. Cavern *MAY* be created.
=================================================================

[END]    11/02/2002.  12/31/2002 Docs update.
