-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
LORD IGM: The Ruined Castle   **FREEWARE**
VERSION 2.30 -- DOCUMENTATION

The Ruined Castle v2.30 and RuinEdit v1.00 were
officially released on Nov. 30th, 2007.
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

Compile Date: RUINCAST.EXE:  November 30th, 2007.  v2.30.

Compile Date: RUINEDIT.EXE:  November 30th, 2007.  v1.00.

Docs updated on January 17, 2010.

Distribution of v2.30 IGM archives will be done sometime
on December 01st, 2007.


============================================================
AUTHOR:  Donald Tidmore

Email:   ktidmore@bellsouth.net (primary email),
         gtidmore@hiwaay.net    (primary email #2),
         donald.tidmore@usa.net  -- Permanent address. Use only
         if the others don't work for you.

Web:     http://camelot.legendarydragons.com/camelot5.htm
         Castle Camelot LORD Links Page

         --  http://camelot.legendarydragons.com/lordapps.htm
         Castle Camelot LORD Apps Page

         --  http://camelot.legendarydragons.com/camelot6.htm
         Castle Camelot LORD IGMs Page

Fidonet: 1:123/450
         http://www.filegate.net/camelot/
         Camelot LordNews FDN. Official Fidonet distribution site.

Address: 1111 Berenice Street, Tuscumbia, Alabama 35674-3503
         United States of America.
=================================================================


1.0: Program File Structure Notes:
=======================================================

Config File Structure updated on Feb. 01, 2007.
Player Database Structure updated on Oct. 23, 2007.

RUINEDIT now only works with Ruined Castle v2.28+ betas,
that are dated on Oct. 23, 2007 or later date.


2.00: INTRODUCTION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  Program Description/Setting:

  The original version of this IGM had two adventures in it,
  since that was all there was in Dan Stovall's Ruincast.ldy
  LADY Script.  You either went inside the castle and faced the
  Castle Ghost, or you walked in two directions around the
  outside of the castle seeking adventure.  If you went inside
  the Castle, you could only ask the Ghost for one thing before
  you were banished from his castle.  If you stayed outside, you
  could only go around the castle on its left side, or its right
  side, where you got to experience one adventure.  Then you
  were sent home to LORD.

  Over time, the IGM has "grown up", and it does many things that
  the "parent" Ruincast.ldy never did.  You get to ask the Ghost
  for up to five wishes per visit.  The number of items you can
  ask the Ghost also has grown over time.  One thing stays the
  same:  If you make him angry, he still may KILL you.  Luckily,
  he is sometimes merciful and chooses to just injure you.  You
  can fight an Ogre or a Vampire up to five times per visit,
  per NPC.  The events outside the castle are basically still
  the same as they were when the IGM was created.
  -------------------------------------------------------------

  The next version of the IGM will be significantly different.
  That is because it will become home for four events that I
  plan to recreate from Trevor Herndon's Castle of LORD IGM.
  Two other events from that IGM have already been recreated
  inside my Hiding In The Shadows IGM.  It is now home to the
  Weapons Shop and Armory from Castle of LORD. Timetable for
  that work is early 2008.
  ------------------------------------------------------------

  If you visit the Ghost, he will grant you small rewards. There
  are two events that make him extremely angry, which one should
  NEVER do:  Ask for a Fairy while you have one with you;  Or ask
  him a Fairy after he gave you one earlier in the day.  If you
  are stupid enough to do that, well there is a 33% chance that
  he will be merciful and simply injure you severely.  He *WILL*
  have the Grim Reaper execute you 67% of the time otherwise.
  The Ghost is like Bruce Banner.  It is NOT a good idea to make
  him angry.  He won't turn into a Green Hulk, but he does not
  need to.  Not when he can summon the Grim Reaper.

  In version 2.30, I have added an Events Menu which allows you
  to do various things inside the castle.  Visit the Ghost,
  Fight an Ogre, or Fight a Vampire.  It also allows the player
  to View Stats screens, view the IGM Usage Reports, or choose
  two ways to leave the IGM:  Normal or Fast.  You must risk
  the Dragon Poop Event at least once per day, as you are
  exiting the IGM.  It occurs randomly, and you MIGHT be very
  lucky, and NEVER experience it on some days.

  The Ogre and Vampire events were added on Jan. 16th, 2007.
  Which is when I created that neat Events Menu as well. Without
  it, you could only do ONE thing in the IGM during each visit.

  There are of course limits on how much LORD stat "goodies" one
  can get during a day.  And there are reasonable limits on what
  stats you can LOSE as well, when your luck goes bad.  For example,
  the Ogre and the Vampire CAN win some fights.  But consider
  yourself lucky because I don't let them kill anyone.  Well
  there is one exception.  If your Hitpoints reach zero during
  a fight, well you end up dead as a dinosaur.
  ---------------------------------------------------------------------

  To make it easier on the people who use an igm without ever
  reading its documentation, or asking other LORD players what
  happens in one, some things are made a lot clearer in this
  version as to the consequences of stupid actions.  Such as
  making that Ghost angry.

  11/08/07:  The Fairy Wish menu entry now makes it clear that players
  can ONLY make the wish ONE time per day.  Castle Ghost wishes update:
  Added Adopt Children wish in early Nov. 2007.  Ghost will grant 1 to 3
  kids per wish, amount chosen randomly, as long as player does not have
  32,000 Kids already.  Menu option for Adoptions is only shown on-
  screen if player is eligible to use it.
  ----------------------------------------------------------------------

  Now if you are scared of getting injured or killed visiting
  the Castle, you can always just look around outside.  The igm's
  outer adventures have the potential of granting a Horse, a
  Child, some Gems, Healing, Temporary Hitpoints, or some Forest
  Fights.  Nothing BAD will happen to you outside the castle,
  UNLESS you run into that Dragon Poop stuff.  Hey if you want
  a SAFE IGM, look somewhere else.

  If you make the Ghost angry, and he lets you live, then you
  are evicted from his Castle immediately.  Everyone, including
  the Ogre and Vampire, lives in the Castle by the Ghost's rules.
  At present, he doesn't allow humans to live in the Castle, but
  that will change in 2008.
  ===============================================================

  All visits to the Castle put you at risk of running into the Red
  Dragon's Poop -- which can teach you valuable wisdom -- or cause
  severe injury.  You can even get killed.  If you are killed, and
  have a Fairy, it will always heal you.  Dead player without fairy
  who is Level 1-4 is allowed a ONE-TIME rescue by an Angel. Everyone
  else will stay dead.  Fairy Rescue ONLY works in the DragonPoop event.

  Those players who exceed the daily visits per day Limit will ALWAYS
  run into the Dragon Poop event.  Yeah, that is intentional.  I
  don't like people who ignore that Daily Visits Limit, you see.

  Players runs risk of encountering the Red Dragon Poop event on EVERY
  visit, unless he/she is dead when they leave the castle. 11/08/07
  note.  You see, there is not much point in the Dragon Poop event
  running, if the player is leaving the IGM as a corpse.
  ====================================================================


2.50: The IGM Limits:     {Rewrote section 11/08/2007}
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  1. * The Castle Ghost event is usable five times per visit.

       If you make him angry making stupid Fairy wishes, though,
       you are immediately evicted from his Castle - whether
       you are alive or dead.

     * The Castle Ogre can be visited five times per visit.

     * The Castle Vampire can be visited five times per visit.

     * If player chooses to explore outside the castle during
       the visit, they can't go inside the castle afterwards,
       and vice versa.

     * Wisdom Points and Gold Rewards are limited to a maximum
       of 100 Million each day for each Castle Ghost event wish.

       Wisdom Points and Gold obtained from the Ghost are
       limited to 12.5 Million maximum per wish.  Wisdom Points
       earned during one of the Red Dragon Poop events is similarly
       limited to 12.5 Million maximum.  (As of 11/30/2007.)

       Level 1-4 players who wish for Wisdom or Gold are limited to
       750 Exp. Points or 750 Gold, in the Castle Ghost event.

     * The Castle Ghost Event limits these rewards similarly:
       Max Strength reward is 300 points for Level 1-4 players;  and
       it is limited to overall maximum of 500 points per wish.

       Max Defense reward is 350 points for Level 1-4 players;  and
       it is limited to overall maximum of 600 points per wish.

       Max Charm reward is 500 points per wish, for all players.

     * Ogre Event.  Hitpoints losses are not limited.  Max Hitpoints
       Reward when player kills the Ogre is limited to 200 points.

     * Vampire Event.  Strength Loss limited to 150 points.
       Strength Gain, when vampire is killed, limited to 200 points.
       No limit on Hitpoints lost when vampire wins fight.

     * Adoptions Wish. The Ghost only grants 1 to 3 Kids per wish.
       Players are not allowed to make Wish if they have 32,000+ kids.

     * Outside Castle, when Gems are found, that reward is limited to
       a maximum of 30 Gems per event.

  2. 01/15/2007: Changed IGM to allow 1 to 10 Visits per day.
     01/15/2007: Removed IGM's Limits on Adoptions per day.

     There is no exception to the Visits/Day Limit for anyone.
     The only way a player can use the IGM more than 10 times
     a day is for the sysop/end-user to use RUINEDIT and reset
     the Visits Today entry to zero, or a lower value.

  3. Only ONE Fairy will be granted to a player per day.
     Requesting fairy 2nd time from Ghost can result in Death.
     Player has 67% chance of just losing some Max Hitpoints.

     If player is punished, they also lose HitPoints.  If they
     are executed, their HitPoints drop to Zero.

  4. If you don't care about what others do in the IGM, then
     skip viewing the IGM Usage Reports.  Most of you probably
     will be curious to see how well or BAD others fared during
     their visits to the Ruined Castle each day.

     Castle Visitors Log - Is shown on-screen for all players as
     of v2.19 beta.

     The disk file log version is not viewable by players, and is there
     to allow the sysop/end-user to monitor daily IGM usage.  In order
     for it to work, the user MUST specify their Sysop Handle during IGM
     installation.  This file RUIN-USE.TXT lists players by LORD name,
     with info on Visits made, Kids Adopted, Gold found, Experience
     Points gained, and Gems Found.  It does not report negative data,
     by design.
  --------------------------------------------------------------------

  This IGM does not feature interaction between players.  It will
  support as many Nodes as your LORD game can access.  All access of
  LORD's player.dat and lognow.txt files are protected by file locking/
  unlocking routines.
======================================================================


3.0  Program Files section:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
The following files are included within The Ruined Castle archive:

FILE_ID.DIZ  - Description file (RUINCAST.diz)

RUINCAST.DIZ - backup copy of archive identifier for BBS usage.
RUINCAST EXE - The Ruined Castle IGM.  v2.30
RUINCAST TXT - Ruined Castle docs - this file.

RUINEDIT.DIZ - DIZ file for RUINEDIT utility.
RUINEDIT.EXE - Ruined Castle Player Database Editor utility. v1.00
RUINEDIT.TXT - Docs file for RUINEDIT utility.

RCE_INFO.TXT - Extended DIZ info file for RUINEDIT utility.
RUIN_INF.TXT - Extended DIZ info file for IGM programs.

CCL-APPS.TXT - Info on all of my LORD Programming projects.
CCL-PROJ.TXT - Info on December 2007 and 2008 LORD project plans.

* RUINCAST.DAT - Created by IGM when it is installed.  Stores sysop
                 name, BBS name, LORD and IGM directory path, and
                 Max Visits per Day values.

* RUINEDIT.CFG - Config file for RUINEDIT.EXE Player Database Editor.
                 Created first time program is used.

* RUINTIME.DAT - Used to keep track of change in Day, Month or Year, so
                 IGM knows internally when to reset its data files for
                 a new day's game usage.

* RUINPLAY.DAT - Binary player database. Tracks all activity inside IGM
                 by players.  Is recreated at start of each new day.

* RUINBACK.DAT - Player Database Restoration file. (Requires v2.21
                 Beta+) Usage enabled on January 11th, 2007.

* RUIN-USE.TXT - Disk file listing content of RUINPLAY.DAT.
                 Created automatically when IGM is used by sysop or
                 the end-user.  Created when RUINCAST REPORT command
                 is entered from DOS Prompt.  Req'd: RUINPLAY.DAT file.
====================================================================


4.0  INSTALLATION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
    During beta work development, instructions refer to
    RuinWork.zip and Ruinedit.zip.  Until the IGM is in
    development again, everyone is to use the RUIN23.ZIP
    and RUINED10.ZIP archives.

    Obtain the RUIN23.ZIP from a BBS, Internet server, or from
    me directly via Email request or Fidonet Mail request.

    1. Unzip RUIN23.zip into a LORD sub-directory.  I suggest using
       RuinCast for directory name.  By design, the IGM was developed
       to use its own subdirectory, but it will work with other
       IGMs provided none of the other igms use files that Ruined
       Castle requires - which are listed above.

         http://camelot.legendarydragons.com/LordApps/ruin23.zip

       To update from v2.20 to v2.30:  {Added 01/10/2007}

       (A) Delete existing files RUIN-USE.DAT and RCVISITS.TXT.
           They are replaced by RUINPLAY.DAT and RUIN-USE.TXT files.

       (B) Run RUINCAST CONFIG and verify your IGM settings.

    2. From DOS Prompt, type:  RUINCAST INSTALL

       Follow on-screen instructions, and IGM will be installed into
       your LORD game.  IGM announces itself in lognow.txt, and adds
       its entry lines to 3rdparty.dat.  That concludes the IGM
       installation process.

C:\BP7\RUINCAST\UNITS\RUINCAST.EXE /N* /GC:\INTERNET\LORD
The Ruined Castle v2.30

Basic entry lines that I use, without LORD Color Codes,
in the 3RDPARTY.DAT.  Will be different for each user since
everyone uses different directory/drive path info.
=======================================================================

IGM Removal Synopsis:
-------------------------
    1. Change to where you installed the IGM.  Type: RUINCAST REMOVE
       Follow instructions, and IGM will be removed from 3rdparty.dat,
       and the RUINCAST.dat file will be deleted.

    2. Delete the Ruin*.* files unless you think you may want to keep
       them around.  That concludes IGM removal process.  Also delete
       files like RUINTIME.DAT, RUINBACK.DAT, and RUINPLAY.DAT,
       unless you think you'll re-install the IGM at a later time.
===================================================================


Program Configuration Update:

    From DOS Prompt type: RUINCAST CONFIG

     -- Follow the on-screen directions.  The dialog boxes work
     best using a Mouse.  You can use ALT-Y to respond YES to
     a prompt.  Be sure to complete ALL displayed config values:
     Max Visits per Day, Sysop's Lord Name.

     -- If you use more than one copy of IGM, verify the IGM
     Directory Path information, while using CONFIG.  Also make
     sure you have the CORRECT LORD Path.

     -- Edit 3rdparty.dat to use the current IGM version number.

    IMPORTANT:  Do not try to reconfigure the IGM while LORD is
    running.  Strange things might happen, especially if someone
    was playing the IGM at that time on a BBS.
=========================================================

The LADY Scripts:  If you want them, they are all stored inside
my dgt-lady.zip file.  Along with scripts by my friends Michael
Everett, Dan Stovall, and Gordon Lewicky.

    http://camelot.legendarydragons.com/Scripts/dgt-lady.zip

Periodic update of dgt-lady.zip on web-site is due to inclusion
of my Lordapps.htm and Ccl-apps.txt data files for the most
part.  Occasionally I do some code rewrites and tweaking of my
LADY scripts.  As to brand new LADY scripts, I stopped doing
that sometime around 2005.  I just "fiddle" or fine-tune them
now and then, as the mood strikes.

Following his death in July 2005, I've been supporting all of
Gordon Lewicky's LADY scripts as my own.  And I maintain/support
the LADY Scripts made by Michael Everett for him.

The Ruined Castle LADY Script does NOT feature special interaction
with the Ghost such as the Fairy wish.  It also does not feature
the Dragon Poop random event.  It also does not have the Adoptions
Wish in its Ghost Wishes menu.
==============================================================


Minus LORD color codes, which in general I personally don't use
much myself, this is what the IGM command lines in 3rdparty.dat
should look like.  Each person installs programs their own way,
so your directory path will usually be different:

C:\BP7\RUINCAST\UNITS\RUINCAST.EXE /N* /GC:\INTERNET\LORD
The Ruined Castle v2.30

The actual description entry in 3rdparty.dat will contain
LORD color codes.  Which can be changed to user's preference.

----------------------------------------------------------------------
Note:  While using this IGM, you may NOT rename any of these files:
       RUINBACK.DAT, RUINCAST.DAT, RUINTIME.DAT, RUINPLAY.DAT,
       RUINEDIT.CFG, RUIN-USE.TXT, RUINCAST.EXE, and RUINEDIT.EXE.

       Don't rename, except for backup purposes, the RUIN-USE.TXT
       file.  It is recreated after each IGM usage or when the
       end-user runs the RUINCAST REPORT command.
======================================================================


4.5  LORDMENU Information:    {Added 12/26/2008}
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

The LordMenu program is currently developed and supported by me.
I took over its development and support when it stopped working
correctly in 2006, and needed to be fixed.  Which was done with
assistance from Dennis Collins.  LordMenu v1.40 was officially
released on July 29th, 2007.  Distribution was done on July
31th, 2007.  And LordMenu v1.50 was offically released on
August 29th, 2008.

   * http://camelot.legendarydragons.com/LordApps/lrdmnu15.zip

   * http://www.filegate.net/camelot/lordfile/lrdmnu15.zip
=============================================================


5.0  REQUIREMENTS:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

  1. Any version of DOS LORD that supports IGMs.   Testing was done
     with versions 3.55 through v4.08 beta.  This program does
     not work with the 32-bit versions of LORD, and never will.

  2. DOS 6.x or later versions.  Probably works with DOS v3.xx forward
     as well, but I can't say for sure.

  3. IGM is usable whether LORD is registered or not.
------------------------------

TESTING:
    LORD Lady Scripts, including RUINCAST.ldy, which this IGM is
    based upon, are usable only with LORD 4.05pb, 4.06, 4.07,
    or v4.08 Beta.  They also will work with the 32-bit versions
    of LORD, but I only have done testing of them in LORD/32. It
    does not work right with the more complex scripts such as
    Gem Trader and Doofus the Gnome.

    The Ruined Castle LORD IGM was tested by me using LORD v4.07.
    My beta testers used other LORD versions such as LORD v3.55.

    My testing was under MS Windows Millenium Edition and MS Windows XP.
    Others will do testing under Windows 95, Windows 98, Windows XP, and
    other Microsoft operating systems.

    All IGMs development since 2004 has been done solely using MS
    Windows XP Home edition, Service Packs 1 and 2.
================================================================


5.0  DISTRIBUTION/UPDATES/REVIEWS:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

1. http://camelot.legendarydragons.com/camelot6.htm
   Castle Camelot LORD IGMs Page.

   http://camelot.legendarydragons.com/lordapps.htm
   Castle Camelot LORD Apps Page

   http://camelot.legendarydragons.com/igmpage.htm
   Castle Camelot/Trentsoft LORD IGMs Page

2. http://www.filegate.net/camelot/lordfile/
   Camelot LordNews FDN - Lord Files directory.

3. Fidonet #: 1:123/450 - Donald Tidmore.

4. http://www.nightfallgames.com/files/ - Michael Everett's LORD
   Archive web-site.  New primary source for all LORD programs that
   I have in my Lord programs collection.  See IGMs directory.
======================================================================


6.0  FEATURES:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Removed some notations for older versions on 09/21/2007.
Section rewrote on Nov. 08th, 2007.

    There are three primary choices offered to player:  Explore
    inside Castle, Look around outside, or Go back to Town.

    -- Inside Castle, you can use three events:  Visit Castle Ghost,
    Ogre Fight Event, and Vampire Battle Event.  The Ghost grants
    these wishes, but only one Wish per visit to his Lair is allowed.

    * Wisdom Points, Gold Coins, Strength Points, Charm Points,
    Defense Points, Fairy, and Orphan Children.

    * If you choose to ask Forgiveness for bothering him, he MAY
    grant you some Max HitPoints.  All visits to the Ghost count
    against the 5 Ghost Event Uses per Visit limit, regardless
    of whether a wish is granted or not.

    Since the IGM allows players to find a Horse while exploring
    outside the Castle, the Ghost does not offer that Wish.

      *  Requesting Fairy, when you have one, results in beaten
         nearly to death by Ghost.  Or it results in death 33%
         of the time.

      *  Being greedy and asking Ghost a second time during a day's
         LORD play for a Fairy will result in player's Death.

    { ======================= Added 11/08/07 ======================= }
    * Guardian Angel Rescue from Death:  Can only be used ONE time per
    day. Is offered ONLY if player is killed by the Red Dragon's Poop.
    Is only available to Level 1-4 players.  Does NOT apply to player
    deaths caused by the Castle Ghost, Ogre, or Vampire.

    * Fairy Rescue from Death:  Can only be used ONE time per day.  Is
    allowed during IGM visit if one of these events occurs:

    (1) Player is executed by Grim Reaper at the Ghost's Order.
    (2) Player dies during Ogre Fight if Hitpoints drop to zero.
    (3) Player dies during Vampire Battle if Hitpoints drop to zero.
    (4) Player is killed by one of the randomly selected Red
        Dragon's Poop events, which occur during IGM exit.
    ============================================================


    -- Dragon Poop2 Random Event:  Added in March 2004:
    =========================================
    Based on Gordon Lewicky's LADY Script, DragonPoop, and my
    own revision of it - DragonPoop #2, this random event is
    designed to add some risk to each IGM usage.

    In normal IGM usage, you have a 33% chance of having a
    Dragon Poop encounter while leaving the IGM.  Any players
    who ignore the IGM Uses/Day limit will have the event occur
    on EVERY visit that exceeds that limit.

    One scenario results in death.  There are two rescues in
    the random event:  Angel Rescue and Fairy Rescue.  See notes
    in previous section for details on them.

    Most of the scenarios involve Hitpoints injury, and loss
    of Strength Points sometimes.
    =========================================================


    -- IGM Usage Changes, version 2.04+:  March-May 2004

    The RUINCAST REPORT command was modified to display the
    content of RUIN-USE.TXT on-screen automatically after a
    8-second delay.  Data is White on Black.  It is not possible
    to use LORD color codes inside the text file.

    11/08/07: Relocated info on Experience Points reward limit
    from Castle Ghost or Dragon Poop events into the Limits Section.

    The IGM controls the amount of Gold and Experience it awards
    to low-level players (Levels 1-4 range) to limit its effect
    on how fast a player is able to advance between Game Levels.

    -- Dragon Poop #2: LADY script vs IGM event:  April 2004
    In the LADY Script, there are six random event scenarios.
    For the IGM, I added a seventh scenario.  This one causes
    player to have broken leg and blood loss injury, which is
    processed as a 15% strength points penalty, and a 20%
    Hitpoints penalty.   One of the original scripts event
    scenarios was changed in v2.19 beta to cover player getting
    a broken arm, and a sprained ankle.  It reduces their Defense
    points along with Hitpoints.

    -- Fixed glitch where the IGM did not process commands that
    were based on the BBS Name value.  Primarily only affected my
    own IGM usage.
    ==================================================================

    No timetable for these IGM changes:

    -- Castle Library event.  May never be written.

    -- New Ghost Wishes:  Sex Change.  1 Skill Point. <-- no timetable.

    -- Several events will be added to Ruined Castle that are based
       upon Trevor Herndon's Castle of LORD igm.  No timetable for when
       I will start work on those.  It may wait until 2008.
    ###################################################################

    -- Outside Castle, Exploration.  Has Three events:  Find Child,
    Find Horse, or Find Gems.  If adoption is denied, unless reason
    is that player has reached LORD's 32,000 Kids limit, you are
    granted 25 temp Hitpoints.

    -- Leave Castle, Left/Right Path.  Depending on path chosen,
    you get possible Healing or Temporary Hitpoints, or you get
    a few Forest Fights.

    -- Random Events:  The user has a 33% chance in regular
    visits of the Dragon Poop event being executed as the player
    is returning to LORD.

    At least one other random event may be added later.
    ================================================================

    Note: Stats screen gives accurate reporting of Skill points and
    Skill use points when they exceed 40, unlike LORD itself. If a
    Skill is 40+ points, the word (MASTERED) is shown beside it.
---------------------------------------------------------

Archive/Program Version Info:
   * v2.00. 07-10-2003. Used v2.00 for first release.
   IGM does everything the LADY script and has additional events.

   * v2.20. 05-23-2004.  Second release is version 2.20.

   * v2.30. 11-30-2007.  Third release is version 2.30.

            * v2.30 includes the RUINEDIT.EXE Player Database Editor
            which was created for IGM usage on Jan. 15th, 2007.
================================================================


7.0  SPECIAL THANKS TO:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Gordon Lewicky  - Helped me learn how to do LADY Script programming.

Gary Hartzell   - Gave me lots of feedback and support in my IGMs work.

Jason Brown     - Got me hooked on LORD IGM work last year.

Charlie Wardick - Taught me LORD IGM programming skills, and how to
                  program Pascal again.  Which I had not touched since
                  the mid-80's in college.

Chris MacPherson - For entrusting me with update of his Pawn Shop IGM.

Michael Everett - Gave me idea for this IGM several months ago, and
                 has always supported my LORD programming activity,
                 and LORD newsletter work.

And to all of my other friends who've gone through my evolution
as a LORD games programmer since February 2002, by testing my new
Lady scripts, and LORD IGM/utility beta compilations, over those
many months.
==================================================================


8.0  DEDICATIONS AND LORD Status Section:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
I've dedicated the IGM to the LADY Script's authors,
Dan Stovall and Michael Everett.

RUINEDIT.EXE is dedicated to Tom Dominick, Sysop of The Loonie Bin
BBS.  telnet://thelooniebin.net --  As of Jan. 17th, 2007.
==================================================================


    DOS LORD v4.07 was officially released on Jun. 07, 2006.
    None of the 32-bit versions have been officially released.

    v4.08 Betas were released with ONE compilation in late
    September 2006 for DOS LORD, LORD/32, LORD for OS/2, and
    LORD for Linux.  In the twelve+ months since then, there has
    been no official development of LORD programs -- that has
    been made accessible to the public.

    As of December 01th, 2007, all versions of LORD v4.08 Beta
    still have unresolved problems -- based upon the September
    2006 compilations that I have access to.

    ---------------------------------------------------------
    According to the LordLegacy.com site, Preslar is working
    on the LORD games.  However, he has not given anyone (that
    I know of) new beta compilations to test.  Therefore, I
    have no idea which glitches have been fixed.  11/03/07 Note
    ---------------------------------------------------------

    Check with Michael Preslar for further details.
    Contact him via email using mike@lordlegacy.com address.
===============================================================


9.0:     RUINEDIT.EXE Information:

Stored separately in the RUINEDIT.TXT documentation file.
============================================================


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
10.0  DISCLAIMER:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

This is a BBS game written as a hobby.  The only warranty given is
that the program will take up a small amount of disk space on your
computer's hard drive, and will run under all versions of Legend of
the Red Dragon that support IGMs.

Notes:  The LADY Script version of The Ruined Castle is usable only with
versions 4.05pb - 4.07 of LORD at this time.  LORD v4.07 was
officially released on June 07, 2006.

This is an IGM version of the LADY Script created by Dan Stovall and
Michael Everett, that I promised Michael I'd do someday.
==================================================


NO OTHER WARRANTY IS HEREBY EXPRESSED, IMPLIED, OR SUGGESTED.
USE OF THIS PROGRAM IS AT YOUR OWN RISK.

The Ruined Castle IS A *FREEWARE* 'IN GAME MODULE' (IGM) FOR LEGEND OF
THE RED DRAGON (LORD).
------------------------------------------------------------


Copyright Info Section:     {Updated 12/26/2008}
------------------------------------------------------------

    Legend Of the Red Dragon (LORD) is copyright (C) by Seth Able
    Robinson of Robinson Technologies.  And by Metropolis Gameport,
    the current owner.  It is now developed by Michael Preslar.
    -------------------------------------------------------------

    Turbo Pascal and Borland Pascal are copyrighted programs
    created and owned by Borland International.

    ANGEL (or A.N.G.E.L.) stands for Atlantis Networking Game
    Engine Library.  ANGEL version 1.00 is copyright 2002-2010
    Atlantis Software by Jimmy Rose and Andy Stewart.

    DDIGM, if applicable to this IGM, is copyrighted by
    its author Steve Lorenz.
    ------------------------------------------------------------

    LORD, L.O.R.D., and LORD II program names were copyrighted by
    Robinson Technologies.  Those copyrights were transferred to
    Metropolis Gameport, in respect to BBS games.  The terms LORD/32
    and LORD/X are also copyrighted by Metropolis Gameport.

    The LordMenu program referred to in this program's documentation
    files is copyrighted by Donald Tidmore.  Its former versions
    were copyrighted by Robert Fogt and Lloyd Hannesson.
-------------------------------------------------------------

All copyright protection for RUINCAST.EXE is fully applicable
to any and all files distributed with the program.

The RUINEDIT.EXE utility is also copyrighted and freeware.
--------------------------------------------------

LORD (Legend of the Red Dragon) is a multi-player battle game
created for Bulletin Board Systems (BBS).

     (c) Copyright 1992-1997 Robinson Technologies
     (c) Copyright 1998,1999 (2000-2010) Metropolis, Inc.
     Created by Seth Robinson.  Developed by Michael Preslar.
     All rights reserved.
--------------------------------------------------

Violation of my rules for IGM usage immediately cancels your
right to request IGM technical support from me.

Technical support is only available for DOS LORD usage of
this igm.  No LORD/32 version is planned for this IGM.

DOS LORD v4.07 was officially released on June 07th, 2006.
--------------------------------------------------

I am gradually testing all of my IGMs under a Synchronet BBS
setup done for me by a friend using DOS LORD v4.07.  So far,
this IGM has not been tested in that environment using the
MTelnet program.

This IGM has been fully tested under LORD v3.55 through
v4.08 Beta's Sept. 2006 compilation.  Michael Preslar does
not allow any LORD IGM authors access to newer compilations
of any version of LORD.  There is nothing known in the LORD
community via the Fidonet BBS echoes, as of late Dec. 2008,
as to when LORD v4.08 will ever be officially released.

End of 12/26/2008 section rewrite.
============================================================


11.0  My LORD Programming History:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  I first started doing LORD Programming in early 2002 with
  Michael Preslar's assistance, along with that of Charlie
  Wardick and Gordon Lewicky, designing LORD Lady Scripts.  Later
  in 2002, I started writing LORD RHP Scripts with tutoring from
  Jason Brown and Michael Everett.

  This is my third LORD IGM created from an LADY Script file.  I came
  up with concept of making an IGM version of my Gem Trader Scripts
  back in November 2002.  Since then, I have completed work on the
  second LADY-Pascal conversion project -- The Nice Hag IGM.

  I began LORD programming in Spring 2002 when my friend Michael Preslar
  convinced me to try writing LADY Scripts.  In June 2002, I started
  working with my friend Jason Brown's LORD programs, since it was the
  only way to get them updated at the time.  My "stable" of LORD
  programs, as of late November 2007, includes these programs.  A full
  listing is supplied in all of my LORD program archives in the
  CCL-APPS.TXT file.  It lists details on current betas in progress,
  and info on official releases.
  ---------------------------------------------------------------------

  This is a short rundown on how I've ended up with so many LORD
  IGMs since I started work on Jason Brown's igms back in 2002:

  Developed for Jason Brown since June 10, 2002: The Gateway, L.O.R.D.
  Cavern, LordStat utility, The Outlands Tavern, and RHP Toolkit.

  With the help of Charlie Wardick, he and I started the process
  of converting Chris MacPherson's Pawn Shop IGM from the RTE200
  plagued Sharkware toolkit to the ANGEL toolkit in late Nov. 2002,
  right after Thanksgiving.  I released v3.00 for Chris one year
  later on Dec. 02nd, 2003.  I formally adopted the IGM as my own
  from Chris in Fall 2006.

  ChasWare LPEDIT was created by Charlie Wardick as a non-functional
  part of his The Changeling IGM.  He used its development into a
  fully functional LORD player database editor to teach me Pascal
  and LORD programming.  Along with teaching me how to figure out
  how Jason's IGMs, which were based on DDIGM, worked.

  The Forest Outhouse was adopted from Robert Fogt in 2002. To
  get his original Outhouse IGM to work, I had to graft it onto
  a stripped down version of The LORD Cavern.  The Gem Trader IGM
  was my first stand-alone IGM, created in November 2002, based upon my
  Gem Trader and Gem Fairy Trader LADY scripts.

  The Nice Hag was my second stand-alone IGM, created on April
  07th, 2003.  It was/is based on my Nice Hag LADY script.  The
  LORD Gambling Casino IGM was adopted from Tobin Fricke on April
  23rd, 2003.

  This IGM project, The Ruined Castle, was started on Jun. 11th,
  2003. Its first official version was released on Jul. 10th, 2003. It
  was my third solo IGM, based on Dan Stovall's Ruined Castle LADY
  script. The igm's third version was released on Nov. 30th, 2007.
  ---------------------------------------

  Turgeon's House was adopted from Mike Ciesiensky, Jr. in Sept.
  2003.  My first version of it, v3.20, was released on Jan. 05, 2004.
  Love Shack II, a recreation of Trevor Herndon's Love Shack IGM, was my
  fourth solo IGM.  It was created in Nov. 15th, 2003.  Its first
  version was released on Dec. 30, 2003.

  Hiding In The Shadows was adopted from Kenneth Padgett in
  January 2004.  My first version of the IGM, v2.00, was released
  on Sept. 27, 2004.  Violet's Cottage II, a recreation of Trevor
  Herndon's Violet's Cottage IGM, was created in January 2004.  It was
  my fifth solo IGM.  Its first version was released on Dec. 25, 2004.

  Realm of Lore was adopted from Paul Mullins in April 2004. I
  started full-time development of it in 2005, and it is nearly
  ready for official release, 3+ years later in December 2008.

  Kiteria's LORD Bank was my sixth solo IGM. It was created in
  October 2004.  Its first version was released on Jan. 11, 2005.
  Doofus the Gnome, my seventh solo IGM, was created in March 2005,
  based upon Gordon Lewicky's GNOME.LDY LADY Script.  It was
  released as v2.00 on July 17th, 2006.

  WereWolf II is my eighth solo IGM, based upon Jay Hodges' Werewolf
  IGM.  It was created on April 13th, 2005, and is my eighth solo IGM.
  Its first version, v1.00, was released on October 31th, 2007.
  The Village Hut was adopted from Ken Davis on November 22nd, 2005.
  My first version, v2.20, was released on Aug. 14th, 2007.

  My ninth solo IGM, LORD Skeleton, was created on March 16th,
  2006.  Its used primarily as a template IGM for testing new
  code for eventual relocation to other IGMs.  My tenth solo IGM, LORD
  Holidays, was created on January 08th, 2007.  It is nearly ready for
  release, as of Dec. 01, 2007.

  My other LORD projects are for LORD for Windows (LORD/32).  I'm
  working on ChasWare LPEDIT/32 player database editor, and on Free
  World II IGM.  The latter is based upon George Batalias, Jr.'s
  original IGM, and on IGM code originally created by Chris Martino.
  Neither program has been officially released yet.  No other LORD/32
  programs are planned currently due to zero feedback on the ones in
  progress.  It's hard to work on something that no one appears to
  have any interest in.
  ====================================================================


12.0:  **** C.C. LORD Apps Summary Section:
---------------------------------------------------------

{ Castle Camelot LORD Apps Summary: }  {01/16/10 revision}

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

  Contains more detailed info on each program release.
  Along with Future Update/IGM development info.

This listing covers only my LORD & LORD/32 IGMs and Utilities.
===================================================

  The Changeling IGM.    ** January 2010 development.
  ** Adopted from Charlie Wardick.  (Release is in progress)

  ChasWare LORD Player Editor. * Released v1.00 on May 14th, 2007.

  ChasWare LPEdit/32 - for LORD/32 beta.  ** January 2010 Beta.
    Status: Inactive. Worked on occasionally.
    Last compilation was on May 11, 2009.

  Doofus the Gnome IGM.    ** January 2010 development.
     ** Released v2.00 on Jul. 15th, 2006.

  The Forest Outhouse.  * Released v2.50 on Jun. 11th, 2005.
  --- Update of Robert Fogt's Outhouse IGM.

  Free World II - for Lord/32 beta - ** January 2010 Beta.
    Status: Inactive. Worked on occasionally.
    Last compilation was on May 11, 2009.

  The Gateway.             ** January 2010 development.
     * Released on Jun. 09th, 2005.
  -- Developed and maintained for Jason Brown.

  The Gem Trader.  ** January 2010 development.
     ** Released v2.60 on Dec. 18th, 2007.
  -- My first IGM that I created myself.

  Hiding In The Shadows.   * Released v3.00 on Oct. 03rd, 2007.
  * IGM was adopted from Kenneth Padgett.

  Kiteria's LORD Bank.  ** Released v1.70 on Sept. 18th, 2007.

  The LORD Cavern.      ** January 2010 Betas.
  -- * Released on Jun. 11th, 2005.
  -- Developed and maintained for Jason Brown.

  LORD Gambling Casino.  ** Released v2.30 on Sept. 05th, 2008.
  -- IGM was adopted from Tobin Fricke.

  LORD Holidays.  ** Released v1.00 on Dec. 24th, 2007.

  LordMenu utility.     ** Released v1.50 on Aug. 29th, 2008.
  -- For DOS LORD and LORD/32.  Adopted from Lloyd Hannesson.

  LordStat utility.   * Released v2.40 on Mar. 31th, 2009.
  -- For DOS LORD and 32-bit LORD versions.
  -- Developed and maintained for Jason Brown.

  Love Shack II.  * Released on May 21th, 2006.
  -- My first tribute IGM.  Based on IGM by Trevor Herndon.

  The Nice Hag.   ** January 2010 Betas.
  -- My second IGM.

  The Outlands Tavern.   ** January 2010 Betas.
  -- Developed and maintained for Jason Brown.

  The Pawn Shop.        ** Released v4.00 on Sept. 05th, 2008.
  -- IGM was created by Chris MacPherson.  It was turned over
     to me completely by Chris in 2007.

  Realm of Lore.  ** January 2010 Betas.
  -- IGM was created by Paul Mullins.

  RHP Toolkit.  * Contains RHPTest and LordType utilities.
  -- Maintained for Jason Brown.  ** January 2010 Betas.
  -- v1.5 was released on Sept. 20th, 2005.

  The Ruined Castle.  ** v2.30 was released on Nov. 30th, 2007.
  -- My third IGM. Based on Dan Stovall's LADY script.

  Turgeon's House.  ** Released on Aug. 31th, 2007.
  -- IGM was adopted from Mike Ciesiensky.

  The Village Hut.   ** v2.20 was released on Aug. 14th, 2007.
  -- IGM was adopted from Ken Davis.

  Violet's Cottage II.     ** January 2010 Betas.
  -- My second tribute IGM. Based on IGM by Trevor Herndon.
  ** Started short-term update work on 05/31/2008.

  Werewolf II IGM.   * Released on Oct. 31th, 2007.
  -- Based on Jay Hodges's IGM.
==============================================================


  IGM Player Database Editor Programs:

   1) JACKEDIT - for The Gem Trader IGM.
      -- JACKEDIT v1.00 was officially released on 02/26/2006.
      -- JACKEDIT v1.10 was officially released on 12/29/2006.
      -- JACKEDIT v1.20 was officially released on Dec. 18th, 2007.

      -- Status: January 2010 Beta development.

   2) DOOFEDIT - for Doofus the Gnome IGM.
      -- DoofEdit v1.00 was officially released on 02/26/2006.

      -- DoofEdit v1.10 was released on Jul. 14th, 2006.

      -- Status: January 2010 Beta development.

   3) SHADEDIT - For Hiding in the Shadows v2.70, v3.00 IGMs:
      -- First version was released as HS25EDIT on 09/20/2005,
         which was only for usage with H.I.T.S. v2.50 igm.
      -- SHADEDIT v1.00 was officially released on Dec. 31, 2006.
      -- SHADEDIT v1.10 was released on Oct. 03rd, 2007.

   4) KLBEDIT  - for Kiteria's LORD Bank IGM.
      -- KLBEDIT v1.00 was officially released on 08/31/2005.
      -- KLBEDIT v1.20 was officially released on 03/14/2006.
      -- KLBEDIT v1.30 was officially released on Jan. 13, 2007.
      -- KLBEDIT v1.40 was released on Jul. 29th, 2007.
      -- KLBEDIT v1.50 was released on Sept. 18th, 2007.

   5) SHOPEDIT - For Pawn Shop IGM.
      -- SHOPEDIT v1.00 was officially released on 12/02/2006.
      -- SHOPEDIT v1.10 was officially released on 08/31/2008.
         Final distribution was done on Sept. 06th, 2008.

   6) TURGEDIT - For Turgeon's House IGM.
      -- TurgEdit v1.00 was released on Oct. 12th, 2005.
      -- TurgEdit v1.10 was released on Aug. 31th, 2007.

   7) VIO2EDIT - For Violet's Cottage II IGM.
      -- Vio2Edit v1.00 was released on Oct. 12th, 2005.

      -- VIO2EDIT v1.10: January 2010 development - NON-BETA.

   8) WOLFEDIT - For Werewolf II IGM. v1.10.
      -- WOLFEDIT v1.00 was officially released on 12/02/2006.
      -- WOLFEDIT v1.10 was officially released on Oct. 31th, 2007.

   9) LS2EDIT - For Love Shack II IGM.
      -- LS2Edit v1.00 was officially released on 02/26/2006.

  10) HUT2EDIT - For Village Hut IGM v2.20.
      -- HUT2EDIT v1.00 was released on 08/14/2007.

  11) FW2EDIT - For Free World II LORD/32 IGM.

      ** Current Status:  January 2010 Beta.

  12) ROL2EDIT - For Realm of Lore IGM.  (Created 04/11/2006)
      -- ROL2EDIT v1.00 was officially released on 11/19/2006.

      -- ROL2EDIT v1.10 was officially released on 07/26/2008.
         ** Requires use of ROL.EXE v1.94+ Betas or v2.00.

  13) RUINEDIT - For The Ruined Castle IGM.  (Created 01/15/2007)
      -- RUINEDIT v1.00 was officially released on 11/30/2007.

  14) VALEDIT - For LORD Holidays IGM.       (Created 02/14/2007)
      -- VALEDIT v1.00 was officially released on 12/24/2007.

  -------------------- Rewrote section 05-01-2008 --------------
  15) CHANEDIT - For The Changeling IGM.       (Created 05/07/2007)
      -- CHANEDIT v1.00 was officially released on 04/30/2008.

      -- CHANEDIT v1.10: In official release processing.
         Status: January 2010 non-beta development/testing.

  16) LGCEDIT - For LORD Gambling Casino IGM.  (Created 11/28/07)
      -- LGCEDIT v1.00 was officially released on 07/30/2008.
         ** Requires use of LGCASINO.EXE igm, v2.18+ Betas or v2.30.

      -- LGCEDIT v1.10 was officially released on 09/04/2008.
         ** Requires LGCASINO.EXE IGM v2.30 or its v2.18+ betas.

  17) OUTSEDIT - For Outlands Tavern IGM.   (Created 11/29/2007)
      -- OUTSEDIT v1.00 was officially released on 12/28/2007.

      -- OUTSEDIT v1.10: January 2010 development - NON-BETA.

  18) SKELEDIT - For LORD Skeleton IGM.     (Created 11/29/2007)
     -- SkelEdit v1.00 was officially released on 10/08/2008.

     -- Current Status:  January 2010 Beta.

  19) LC2EDIT  - For LORD Cavern IGM.       (Created 12/03/2007)
      -- LC2Edit v1.00 was officially released on 12/28/2007.
      -- It is for usage ONLY with LORD Cavern v1.7.

      ** Current Status:  January 2010 beta.

  20) OT20EDIT - Temporary usage only for ANGEL version of The
         Outlands Tavern IGM.  {Created 05/12/2008}   Usage will
         be discontinued after Outlands Tavern v1.8's DDIGM-based
         version is finished and officially released.

      ** Current status:  January 2010 Beta.

  21) HAGEDIT - For The Nice Hag IGM.  Requires v2.31+ Betas.

      -- HAGEDIT v1.00: In official release processing.
         Status: January 2010 non-beta development/testing.

  22) FO2EDIT - For The Forest Outhouse IGM.  Requires v2.53+ betas.

      ** Current status:  January 2010 Beta.
  -------------------------------------------------

  23) GW2EDIT - For The Gateway IGM.  Requires v1.31+ Betas.

      ** Current status: January 2010 Beta.


  Realm of Lore Utility: Monster Database Editor:
  -----------------------------------------------
  RLMEDIT.EXE - For use with Realm of LORE v1.50+ Betas and
       with R.O.L. v2.00 when it is officially released.
       It is designed to be usable with R.O.L. v1.44 also.

  -- RLMEDIT v1.00 was officially released on 12/31/2006.

  -- RLMEDIT v1.10: January 2010 development - NON-BETA.
  ** Has not been distributed in separate archive yet.
  ----------------------------------------------------------

  IGM Player Database Conversion Programs:

  1) CONVBANK - For Kiteria's LORD Bank IGM.
     -- CONVKB10.EXE (v1.00) was released on Mar. 14th, 2006.
     -- CONVKB11.EXE (v1.10) was released on Jul. 29th, 2007.
     -- CONVBANK.EXE (v1.20) was released on Sept. 18th, 2007.

  2) CONVHITS - For Hiding In The Shadows.
     -- ConvHits v1.10 was released on Dec. 31th, 2006.
     -- CONVHITS v1.20 was released on Oct. 03rd, 2007.

  3) CONVLORE - For Realm of Lore IGM.
     -- CONVRL10.EXE v1.00 was officially released on 11/19/2006.
     -- ConvLore v1.10 was officially released on 12/28/2007.

  4) CONVOUTS - For Outlands Tavern IGM.

     Status:  January 2010 Beta.

  5) CONVSKEL - For LORD Skeleton IGM. (v0.80 to v0.81 beta)
     -- ConvSkel v1.00 was officially released on 10/09/2008.

     Status:  January 2010 Beta.
  -----------------------------------------------------------

  As of January 16, 2010, those are the only player database
  editors, and player database converters, other than
  ChasWare LPEDIT/32, which are in development or that are
  in official release status.
==============================================================


RUINCAST.txt -- End of documentation.

Spell checking of file done on Dec. 01, 2007 at 10:09 pm.

Note: This IGM is guaranteed to work properly with
DOS LORD v4.07 and DOS LORD v4.08 Beta.

Copyright 2002-2010 by Donald Glenn Tidmore.

Revised on:   January 17, 2010 at 11:00 pm.

