     The LORD Cavern RHP set #1 v1.40 By Jason Brown
     For The LORD Cavern By Jason Brown

     Maintained by Donald Tidmore.
     December 2009 Files/Docs Revisions:

     v1.30: Posted officially on Jun. 29th, 2007 online.

     v1.35: All scripts in archive now require LORD Cavern v1.8
            or its current betas.  Uses December 2009 IGM Beta.

     v1.40: Edited all RHP scripts used by LORD Cavern. 11/30/2009
            Covers Nov. 2009 edits.


[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 just wanted to do some interesting RHPs, so here they are.  Enjoy!

P.S.: This set includes program and version info for LORD CAVERN
v1.4+, v1.5+, v1.6+ as well as installation name and percent.
===========================================================


    [FILE LIST]

  Files that should be in CAVERHP1.ZIP:

  FILE_ID.DIZ   : BBS Description File.
  CAVERHP1.DIZ  : copy of DIZ file.
  CAVERHP1.TXT  : This file!

  CANYON.RHP    : The Canyon RHP v1.30                 {11/30/2009}
  CITY.RHP      : The Lost City of Darborne RHP v1.30  {11/30/2009}
  DMINE.RHP     : The Diamond Mine RHP v1.30           {11/30/2009}
  MAGICIAN.RHP  : The Old Magician RHP v1.20           {11/30/2009}
  WATRFALL.RHP  : The Waterfall RHP v1.30              {11/30/2009}
                  * Requires LORD Cavern v1.8 or its betas.

  HOMEPAGE.URL  : Windows95 Internet Shortcut to Jason Brown's
                : web-site, and to Castle Camelot web-site.
  ------------
  CCL-APPS.TXT  : Info on Castle Camelot LORD Apps.
                  { updated periodically online }
  See:  http://camelot.legendarydragons.com/ccl-apps.txt

  CCL-PROJ.TXT  : Castle Camelot LORD Projects List.

  LC-RHP1.TXT   : Bundled with LCrhp1_e.zip for Fidonet posting.
---------------------------------------------------------------

** CITY.RHP has at times been called "The Underground City of
Darborne", but the actual name used by Jason when he created the
script is "The Lost City of Darborne". 06/11/2007 note.
-----------------------------------------------------------------


    [REQUIREMENTS]

A computer!
LORD version 3.25 or greater, some RHPs require v3.50+.
The LORD Cavern v1.3+, some RHPs require v1.3a+ or v1.3c+.
-----------------------------------------------------------------


    [INSTALLATION]
Unzip this file into your LORD Cavern directory.  Follow the
instructions for your version below.

v1.3: Edit EXTRA.CFG and change the second line to match the total
      number of RHPs you install.  Add each filename on separate
      lines, with no directory path info.

v1.3a+: Use SETUP.EXE included with The LORD Cavern and use
      option 'E'xtra Setup at the main menu, add each one with
      the '3' command.

v1.4, v1.5, v1.6: Uses same instructions as v1.3a entry.

v1.7: IGM now uses LCSETUP.EXE for setup program name.
      Program otherwise works the same as v1.3a entry indicates.

      LORD Cavern v1.7 was released on Jun. 11th, 2005.
--------------------------------------------------------------

Here is some information on the versions of LORD, and of L.O.R.D.
Cavern, that each RHP needs.  And what chance it should be at:

The Canyon (Uncommon):
   The LORD Cavern v1.3a+: Uses @KILL@ command, @BANK@ command
                               in mail recording
   LORD v3.50+: Can kill users.

The Diamond Mine (Very Common):
   The LORD Cavern v1.3+: No enhanced features
   LORD v3.25+: No enhanced features.

The Lost City of Darborne (Very uncommon):
   The LORD Cavern v1.3c+: Uses LEVEL commands
   LORD v3.50+: Can kill users.

The Old Magician (Slightly common):
   The LORD Cavern v1.3c+: Uses LEVEL commands
   LORD v3.25+: No enhanced features.

The Waterfall (Common):
   The LORD Cavern v1.3c+: Uses LEVEL commands
   LORD v3.25+: No enhanced features.
-----------------------------------------------------------------


    [UNINSTALLING: LORD Cavern IGM Setup]

v1.3: Edit EXTRA.CFG, changing the second line to the correct number
      of RHPs installed.

v1.3a+: USE SETUP.EXE and option 'E', and then option '4', then
      press the letters of the files to remove.

v1.4, v1.5, and v1.6:  All three use the v1.3a instructions.

v1.7: IGM uses LCSETUP.EXE program now. From Main Menu, select
      menu code 'E', and press the ENTER key.  Then select menu
      code 'L in the same way.  You will be shown a listing of
      installed RHP scripts. To un-install one, you simply press
      the code letter shown beside the script.  To exit screen,
      press the * key.  From Extra Config Menu, use the Save
      option and exit to the main menu.  Use Save option again
      and exit the setup program.

      (* Notes apply also to versions 1.4, 1.5, and 1.6 of
      LORD Cavern except that they use the SETUP.EXE program.
-----------------------------------------------------------------


    [USING IT]

Using RHP Scripts:  The way LORD Cavern works is that it
randomly chooses to run an event each you use a Cave Search.
About 80% of the time, an event that is written in the IGM
source code gets executed.  About 20% of the time, the IGM
will run a RHP Script event -- if any have been installed.

Note: Jason's name for the IGM is The L.O.R.D. Cavern, but I
prefer to just use The LORD Cavern, which is easier to type.
-------------------------------------------------------------

11/09/2003: Using LORD Cavern v1.6, there should not be any
problem with RHP scripts causing negative stats.  If you do notice
any, please let me know the applicable details:  Script name, which
Lord stat went negative, the IGM version, and so forth.  Donald.

06/11/07 Note: That also applies to v1.7 of the IGM.
------------------------------------------------------------


========== 06/08/2008 Notes: ==========

None of these scripts will work, as currently written, with
any prior official releases of The LORD Cavern.  All of them
require that you use a beta compilation of LORDCAVE v1.8.


Usage of Percentages in RHP Code statements.  06/08/2008
--------------------------------------------------------
In order for them to work properly, *EVERYONE* who writes
RHP scripts who wishes to use percentages, is required to
do so in this fashion.  No other way will work correctly.

Example:  You wish to reward the player with a 5% increase in
Gems.  The only way this will work is to write these 2 lines:

@VARIABLE1 =GEMS%5   <-- Computes 5% of GEMS stat.
@GEMS@ +VARIABLE1    <-- Adds amount stored in VARIABLE1 to GEMS.

Example: To write a loss of 5% Experience, you would do this:

@VARIABLE1 =EXPERIENCE%5   <-- Computes 5% of EXPERIENCE stat.
@EXPERIENCE@ -VARIABLE1
       <-- Deducts amount stored in VARIABLE1 from EXPERIENCE.

For these scripts to work properly, it is imperative that
you use the June 08+, 2008 beta of LORD Cavern.  Donald.
=================================================================


    [REGISTRATION]

None, this is Public Domain.
Just let us know what you think of the IGM once you've tried it.
-----------------------------------------------------------------


    [DISTRIBUTION SITES]      Section Rewrite 06/29/2007.

Primary distribution sources:  {Added 06/29/2007}
-----------------------------
1) Camelot LordNews FDN site:
   http://www.filegate.net/camelot/
   My Official Fidonet programs distribution site.

2) Castle Camelot web-site:
   http://camelot.legendarydragons.com/Scripts/
   -- Public access directory for LORD Lady and RHP Scripts.

   http://camelot.legendarydragons.com/LordApps/
   -- Public access directory for LORD programs, LORD II
   programs, Planets: TEOS programs, and Wildcat Tournament
   LORD programs.

   See either http://camelot.legendarydragons.com/camelot6.htm
   or http://camelot.legendarydragons.com/lordapps.htm to
   get archive files, or to download individual scripts.

2-B) Castle Camelot LORD Library FTP server:
   ftp://ftp.legendarydragons.com/lord/

   Note: Individual RHP script files are fully accessible
   using either a FTP client program or your web browser.

3) Nightfallgames.com Server:  Hosted by Michael Everett.
   http://www.nightfallgames.com/files/
   -- See the IGMs/Scripts subdirectory.

4) BBS Archives Site:  Hosted by Mike Ehlert.
   http://archives.thebbs.org/ra98a.htm
   -- Door Games: LORD IGMs  (web-page uses frames)

   http://archives.thebbs.org/ra99a.htm
   -- Door Games: LORD Utils</A> --  (web-page uses frames)
=================================================================


WWW: http://www.pcisys.net/~jmbrown/
My World Wide Web page includes links to other pages, like
Seth Able's!  (Note: Site has been fully inactive since 2002.)

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

Other distribution sources info:  {Rewrote 06/29/2007}
----------------------------------
    http://camelot.legendarydragons.com/igmpage.htm
    Revamped TrentSoft LORD IGMs Page.

    http://camelot.legendarydragons.com/igm-beta.htm
    LORD Beta programs d/l page.

    Primary distribution source is the LordApps directory:
    http://camelot.legendarydragons.com/lordapps.htm

    Official releases of Chasware LORD Player Editor utility;
    The Forest Outhouse, The Gateway, The Gem Trader, Hiding
    In The Shadows, Kiteria's LORD Bank, The L.O.R.D. Cavern,
    The Love Shack II, The Nice Hag, The Outlands Tavern, The
    Pawn Shop, Ruined Castle, Turgeon's House, The Village Hut,
    and Violet's Cottage II LORD IGMs;  and the LordMenu,
    LordStat, LordType, and RHPTest and utilities.

    Note: Lord Gambling Casino IGM was supported by Chris
    Martino until he disappeared in late May 2005.  I have
    resumed authorship of the IGM, as of mid-August 2005,
    along with the Realm of Lore IGM.
------------------------------------------------------------
          
Fidonet Mail:  use 1:123/450, and post to LORD Echo.  If writing
          using my name, address messages to Donald Tidmore.  You
          can also write to me in Net-Mail.

Email:  ktidmore@bellsouth.net or gtidmore@hiwaay.net. If you
        are unable to use them, use donald.tidmore@usa.net.

Note: Jason Brown does not participate in Fidonet.
===============================================================


    [OTHER PRODUCTS - Jason Brown]   {Revised 11/01/2009}

Here is the other LORD stuff that I've done!

  Current official version info of IGMs, prepared by Donald Tidmore:

The LORD Cavern v1.7  - IGM for LORD 3.25+ - 12 different random
(CAVE17.ZIP)  actions, great comm routines (works on several
              systems other IGMs won't), intro ANSI, and some
              really rare happenings!  The Random Happening
              Program (RHP) language lets you make your own random
              happenings!  Now allows sysop handles.  Node 0 and
              DigiBoard support, comm routines refined.  Freeware,
              as of v1.4.  Now includes built-in limits on rewards
              and penalties, to reduce its impact on LORD's "fair
              play" doctrine.  Includes some brand new random
              actions, All new riddles and questions for the Troll
              and Riddler.  And much more.   June 2005 (v1.7)

              ** Status: December 2009 Beta.  v1.71+ beta
--------------------

The LORD Cavern RHP Set #1 - 5 RHP programs for The LORD 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 LORD Cavern RHP Set #2 - 6 MORE RHP programs for The LORD
(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+).  The Scary Bats - v1.5+ req'd.
--------------------

LordStat v2.30 - Bulletin generator for LORD 3.15+ - 11 different bulletins
(LORDST23.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.

              Added in 2005-2006: Pause Code support for EZYCOM BBS
              software;  HTML Bulletins are available if the user/sysop
              chooses to use them;  Utility now uses text config file.

              ** v2.30 was officially released on Mar. 31th, 2009.
--------------------------------------------------

The Outlands Tavern v1.6 - IGM for LORD 3.50+ - Great IGM for LORD!  Lets
(OUTS16.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. Includes new
              Food/Drink Menu, and enhanced protection for sleeping
              players from attack, as of version 1.5.  June 2005 (v1.6)

              Status: December 2009 Beta.  v1.61+ Beta.
--------------------

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

              Status: December 2009 Beta.  v1.31+ Beta.
--------------------

RHP Toolkit v1.5   - RHPTEST v1.5 is a utility program for RHP
(RHPTST15.ZIP)   Script writers to use in 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.  - LORDTYPE v1.5 is a text viewer
                 utility that handles files like LOGNOW.TXT that
                 use LORD color codes.   Sept. 2005 (v1.5).

              Status: December 2009 Beta.  v1.54+ Beta.
--------------------------------------------------

Stones! v1.2 - A LORD2 IGM by Jason Brown.  Support and development was
         taken over in June 2002 by Max Larivee.  Max vanished
         around July 2005 and is presumed dead.  So no one
         currently supports this LORD2 IGM.  Status: Dead IGM.
=================================================================

CAVERHP3.ZIP:  ** LORD Cavern RHP Set #3 - contains revisions of
         the Bats and Canyon RHP Scripts.  Canyon2.rhp was
         redesigned in 2003 to use the @KILLSAVE@ RHP Code
         command when the LORD Cavern IGM kills the player.
         The player who has a Fairy then has a 50% chance that
         the Fairy will save their life, allowing them to
         continue using the IGM.  Includes new script, The
         Cloth Bag.

    http://camelot.legendarydragons.com/Scripts/caverhp3.zip
=================================================================


{ IN PROGRESS, December 2009 Notes:  }
------------------------------------
ChasWare Lpedit/32    -- LP32Work.zip  (For LORD/32 beta)
-- Not in active development due to zero feedback on program.

Free World II         -- FW2-Work.zip  (For LORD/32 beta)
-- Not in active development due to zero feedback on program.

The Changeling        -- Chg2work.zip  (in final processing)

The Forest Outhouse   -- Oh2-work.zip

The Gateway           -- Gatework.zip

The LORD Cavern       -- CaveWork.zip

LORD Skeleton         -- BoneWork.zip
     ANGEL version of Realm of Lore IGM.

The Nice Hag          -- Hag-work.zip  (in final processing)

The Outlands Skeleton -- TaveWork.zip
     ANGEL version of Outlands Tavern IGM.
     Does not run RHP scripts yet.

The Outlands Tavern   -- Out-work.zip

Realm of Lore         -- ROL-Work.zip

Violet's Cottage II   -- VC2-WORK.ZIP (Short-term development)

Various IGM Utilities are also in progress, but are not
itemized in this file.  See CCL-APPS.TXT for more info.

Note: The archives are posted online using lower-case file names.
===========================================================
          

    [CLOSING - JASON:]

Not much to say, just that I hope some of you out there manage to
write your own RHPs.

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


    [REVISIONS}

    {03/19/2002 - 11/02/2002;  March-November 2003]
Updated program version references for LORD Cavern, LordStat,
and The Outlands Tavern.  Added info for The Gateway, RHPTest, Stones!,
and LORD Cavern RHP Sets #1 and #2.  Fixed spelling.

06/24/2002: Fidonet distribution of Caverhp1.zip done using LCrhp1_a.zip,
            and Caverhp2.zip distribution done using LCrhp2_a.zip.
            -- Included Random Hobbit v2.00 and Mushroom Patch v2.00
               RHP script updates by Michael Everett.

07/27/2002: Fidonet distribution of current RHP script archive files
            done using LCrhp1_b.zip, for Caverhp1.zip update.

            -- The Diamond Mine v1.10       -- The Canyon v1.10.
            -- The Old Magician v1.10.      -- The Waterfall v1.10.
            -- The Underground City of Darborne v1.10.

09/06/2002: Fidonet distribution of current RHP script archive files
            done using LCrhp1_b.zip, for Caverhp1.zip update.

11/02/2002: LORD Cavern v1.5 released for public usage.
            Fidonet distribution of Caverhp1.zip done as LCrhp1_c.zip,
            and Caverhp2.zip done as LCrhp2_c.zip.

12/04/2002: Updated Distribution section of Caverhp1, Caverhp2 docs.

03/30/2003: LORD Cavern v1.5a entry changes.  Updated all web-site URLs.

05/25/2003: The Waterfall v1.12 RHP Script revision.

June 2003:  Docs update.   Script revisions:
            The Waterfall v1.14        The Canyon v1.10
            The Diamond Mine v1.11     The Old Magician v1.11
            The Lost City of Darborne v1.11

Nov. 09, 2003:
            * Official release of LORD Cavern v1.6 IGM, The
              Gateway v1.2 IGM, was done on Nov. 07, 2003.

            * Official release of The Forest Outhouse v2.20 IGM,
              and The RHP Toolkit v1.3 utilities, was done on
              Nov. 08, 2003.

            * Official release of Caverhp1.zip sent to Fidonet, along
            with LordCave v1.6, as LCrhp1_d.zip, on Nov. 09, 2003.

            * Official release of Caverhp2.zip sent to Fidonet,
            using LCrhp2_d.zip, on Nov. 09, 2003.

            * First official release of LORD Cavern RHP Set #3,
            using Caverhp3.zip sent to Fidonet, on Nov. 09, 2003.

            * Forest Outhouse RHP Pack v1.05 (otrhp1.zip) was
            released officially on Nov. 08, 2003.

            * The Outlands Tavern v1.5 IGM was released on Jan.
            01, 2004.  Minor update, v1.5B, was released on Jan.
            05, 2004.

            * The Outlands Tavern RHP Set v1.22 was officially
            released in December 2004 on Castle Camelot web-site,
            and at other locations.
            { ================================================ }

            * Periodic updates, primarily of text files, are done
            on the Castle Camelot web-site of CaveRhp1, CaveRhp2,
            CaveRhp3, Forhp1, and Otrhp1 archive files.  Individual
            RHP script updates are download-able using hyperlinks
            on my LORD IGMs Page.
            http://camelot.legendarydragons.com/camelot6.htm
            ==================================================

Oct. 12, 2005:
            * Official release of The Forest Outhouse v2.50,
              The Gateway v1.3, LORD Cavern v1.7 IGM, and
              The Outlands Tavern v1.6 was made on Jun. 11, 2005.

            * Official release of RHP Toolkit v1.4 was done on
              Jun. 11, 2005.

            * Official release of RHP Toolkit v1.5 was done on
              Sept. 21, 2005.

Jun. 11, 2007:  * Updated documentation files. Re-dated all of
              the RHP scripts to use current date.
            * Changed CITY.RHP back to use its original name
              of "The Lost City of Darborne", instead of "The
              Underground City of Darborne".
            * Prepared archive for a new official release as
              lcrhp1_e.zip.  

Jun. 27:    * Edited City.rhp. Replaced web-site URL header.
              Official release will be done soon of LCRHP1_E.ZIP.

Jun. 29:    * Rewrote documentation file, CCL-APPS.TXT file.
            * Updated LCRHP1_E.ZIP archive for official release.
================================================================


{ Castle Camelot LORD Apps Summary: }
{ Read the CCL-APPS.TXT inside CAVERHP1.ZIP }

Or See:  http://camelot.legendarydragons.com/ccl-apps.txt

      Contains more detailed info on each program release.
      Along with Future Update/IGM development info.
      ** The online file is not always up-todate.
==============================================================

All of the RHP Scripts in CAVERHP1.ZIP are copyright 1999-2009
by Jason Brown, and this text file is copyright 2002-2009 by
Jason Brown and Donald Tidmore.
-------------------------------------------------------------

{ Castle Camelot LORD Apps Summary: }
{ Read the CCL-APPS.TXT inside CAVERHP1.ZIP }

Or See:  http://camelot.legendarydragons.com/ccl-apps.txt

      Contains more detailed info on each program release.
      Along with Future Update/IGM development info.
      ** The online file is not always up-to-date.
==============================================================


Rhp Script-based IGMs Development note:   {05/01/2009 Info}
---------------------------------
I plan to convert the LORD Cavern, The Gateway, and The Outlands
Tavern IGMs from the DDIGM toolkit to the ANGEL toolkit sometime
in 2010.  An ANGEL version of Outlands Tavern is currently in
progress, and is in use by some of my beta testers.

Current work on LORD Cavern, for v1.8 release, is underway.
I have no timetable for when it will be released.  The current
version is still using the DDIGM Toolkit.

Work on The Outlands Tavern to use brand new RHP Library code
for handling multiplication and division math operations is
in progress, with the help of Dennis Collins.  I am also
working on the RHP Toolkit.

Development of The Forest Outhouse was resumed full-time on
Apr. 13th, 2009.  I have no timetable for when v2.70 will
be released.  It will be the last version of the IGM based
on the DDIGM Toolkit.  v3.00 will be based on the ANGEL toolkit.

Work on The Gateway IGM began in late October 2009.
===============================================================


CAVERHP1.TXT:  Copyright 1999-2009 by Donald Tidmore.

Revised on:   November 30, 2009 at 08:00 pm.

