     The LORD Cavern RHP set #3 v1.25 By Donald Tidmore
     For The LORD Cavern By Jason Brown

     IGM maintained by Donald Tidmore.
     December 2009 Files/Docs Revisions:

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

     v1.15: All scripts in archive now require LORD Cavern v1.8
            or its current betas.  Uses December 2009 IGM Beta.
            Added Cloth Bag RHP Script on 04/20/2009.

     v1.20: Edited all RHP scripts used by LORD Cavern. 09/04/2009

     v1.25: 11/21/09 edits of CANYON2.RHP and CLOTHBAG.RHP scripts.


    [INTRODUCTION]
While working on updates of the RHP Language in June-July 2003, I
created two LORD Cavern-based scripts, The Scary Bats and The
Canyon #2.  The purpose was to test various additional RHP codes
such as the KILLSAVE code.

They were also used, along with other RHP scripts that I have created
or revised over time, to determine source of problems with the @GEMS@
RHP Code.  For some reason, older versions of RHPTest.exe and
Lordcave.exe were allowing the LORD Gems field to go negative. That
problem was fixed in LORD Cavern v1.6 and RHP Toolkit v1.3.

The current official versions of The Forest Outhouse (v2.50),
The Gateway (v1.3), The LORD Cavern (v1.7), RHP Toolkit (v1.5),
and The Outlands Tavern (v1.6) are all confirmed to not allow
the negative Gems situation to occur.  A similar problem with
some RHP Scripts causing negative Wisdom was fixed in LORD
Cavern v1.7 in 2005.        {paragraph rewritten 06/11/2007.}
-------------------------------------

    [FILE LIST]

  Files that should be in CAVERHP3.ZIP:

  CAVERHP3.DIZ, FILE_ID.DIZ   : BBS Discription File(s).
  CAVERHP3.TXT  : This file!

  BATS2.RHP     : The Scary Bats RHP, v1.20        {11/30/2009}
  CANYON2.RHP   : The Canyon #2 v1.25              {11/30/2009}
  CLOTHBAG.RHP  : The Cloth Bag v1.20              {11/30/2009}
  ------------

  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.
  See:  http://camelot.legendarydragons.com/ccl-proj.txt

  LC-RHP3.TXT   : Bundled with LCrhp3_b.zip for Fidonet posting.
====================================================================


    [REQUIREMENTS]
A computer!
LORD version 3.25 or greater, some RHPs require v3.50+.
The LORD Cavern v1.3+, some 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
      seperate lines, with no directorys.

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.

      The 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 uses:

The Scary Bats:  By Donald Tidmore.  Modified from Michael Everett's
    original script.  Requires LORD Cavern v1.5b beta or v1.6.
    Set at 80% like the original bats.rhp.
    -- Uses @SCRIPTVERSION@, @YESNO@, `n code - inserts player's LORD
    name on-screen, @EXPERIENCE@, @GOLD@, @GEMS@, @MORE@, @DEFENSE@,
    @CHARM@, and @LEVEL@ codes,

The Canyon #2:  By Donald Tidmore.  Modified from Jason Brown's
    original script.  Requires LORD Cavern v1.5, v1.5b beta, or v1.6.
    Set at 60% like the original canyon.rhp.
    -- Illustrates usage of @KILLSAVE@ RHP code.  Allows player to
    receive 2,000 Gold if they find the Bank note.

The Cloth Bag:  By Donald Tidmore.  Based upon Forest Outhouse's
    Burlap Bag script.  Requires LORD Cavern v1.6+ Betas.
====================================================================


How does @KILLSAVE@ work?  If RHP script event kills player, using
@KILL@ code, they are dead and immediately exit the IGM, and LORD.

If @KILLSAVE@ is used, it gives player 50% chance of surviving
death IF they have a Fairy. If they don't have a Fairy, they remain
dead.  Jason didn't want the Fairy to always save someone, so it
allows a 50/50 chance that the Fairy will go on Strike, and refuse
to revive the slain warrior.  If player is revived, they get to
finish using the RHP script, and then return to using the IGM.

At this time, the Canyon2.rhp script is the only one I know of that
uses Killsave.  In the Forest Outhouse RHP scripts I have created,
I have not coded anything that can kill or severely injure the
player.  If anyone else writes new LORDCAVE scripts, just send them
to me and I'll include them with this CAVERHP3.ZIP archive.

To date, no one has ever submitted any RHP script to me for
bundling in this RHP Scripts Set.
=====================================================================


    [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.

{06-20-2003}
Script usage advisory:  LORD Cavern v1.5b beta is required
if you run LORDCAVE RHP Scripts, and see any stats go negative.

-------------------------
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.
====================================================================


========== 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 Jason and myself know what you think
of the LORD Cavern 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.

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

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


{ 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 Forest Outhouse   -- Oh2-work.zip

The LORD Cavern       -- CaveWork.zip

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

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.
===========================================================
          
          
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.

I occasionally use Trillian, but not very often.  My ICQ
handle is Belgarion.  ID # 238686196.
===============================================================


    [OTHER PRODUCTS - Jason Brown]   {05/12/2008 rewrite}

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.74+ 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 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+).  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.66+ 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.32+ 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 third script, The
         Cloth Bag.

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


    [CLOSING - Donald:]
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.
====================================================================


[LEGAL DISCLAIMER]    DISCLAIMER OF WARRANTY

            THIS SOFTWARE AND MANUAL ARE PROVIDED "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.
====================================================================


    { Misc Notes: Section added 01/05/2005. ]

All of the IGMs - LORD Cavern v1.5/1.6/1.7, Gateway v1.1/1.2/1.3,
Forest Outhouse v2.00/2.10/2.20/2.50, Outlands Tavern v1.4/1.5/
1.5B/1.6 -- and RHP Toolkit v1.2/1.3/1.4/1.5 - are guaranteed
also to prevent any LORD stat during RHP Script execution from going
above-range, or from going negative.

In other words, say you are in LORD Cavern and have 31,995 Gems
on Hand.  An RHP Script occurs and you are told that you get
6 Gems.  In reality, you will only have 32,000 Gems afterwards,
since the IGMs and RHPTest are coded to not allow the stat to
exceed 32,000.  In the case of Gold and Experience fields, those
are coded to not allow either stat to go over 2 Billion.  That
way none of the IGMs will return players to LORD with negative
stats or above-range stats.
----------------------------------------------------------------

06/11/07 note:
Only the last batch of IGMs, released in 2005, that use the RHP
Script language are absolutely confirmed to prevent a RHP script
from causing stats such as Gems and Wisdom from going negative.
That happened during LORD Cavern v1.7's development, and I fixed
that igm to prevent the situations from occuring again.

Its always possible for igms to malfunction and cause a player's
LORD stats to go cuckoo, but I do my best to make sure that it
does not happen in all of my LORD and LORD/32 IGM programs.
==============================================================


    [ Current IGM Release Notes: }

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.

April 2006: * Added CCL-APPS.TXT to lcrhp3_a.zip archive.  Placed
              into distribution on various sites including the
              NightfallGames server, but never offically released
              as lcrhp3_a.zip to Fidonet via the Camelot LordNews FDN.
            * CCL-PROJ.TXT was put into use on Apr. 11th, 2005.

Jun. 11, 2007:  * Updated documentation files. Re-dated all of
              the RHP scripts to use current date.
            * Changed BATS2.RHP (Scary Bats) to v1.09.
              Changed CANYON2.RHP (The Canyon #2) to v1.04.
            * Prepared archive for a new official release as
              lcrhp3_b.zip.

Jun. 27:    * Edited Bats2.rhp and Canyon2.rhp - Fixed web-site URL
              header lines in both scripts.
              Official release will be done soon of LCRHP3_B.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 CAVERHP3.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 CAVERHP3.ZIP are copyright 2003-2009
by Donald Tidmore.
==============================================================


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.
===============================================================


CAVERHP3.TXT:  Copyright 2003-2009 by Donald Tidmore.

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

