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

                   v2.00 officially released July 10, 2003
              -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

AUTHOR:  Donald Tidmore

Email:   ktidmore@bellsouth.net, donald.tidmore@usa.net
ICQ:     Belgarion - #238685196.

Web:     http://www.fidotel.com/public/camelot/camelot5.htm
         Castle Camelot LORD Links Page
         --  http://www.fidotel.com/public/camelot/lordapps.htm
         Castle Camelot LORD Apps Page
         --  http://www.fidotel.com/public/camelot/camelot6.htm
         Castle Camelot LORD IGMs Page

         -- http://www.geocities.com/donaldtidmore/camelot5.html (Inactive)
                     (Backup site. Updated occasionally.)

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

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


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
1.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 beta of LORD at this time.

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

  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-2003) Metropolis, Inc.
     Created by Seth Robinson.  Developed by Michael Preslar.
     All rights reserved.

This IGM has been fully tested under LORD v3.55 through v4.07 beta
(using early June 003 beta compilation).  No support is offered for
IGM by users of LORD for Linux - or for LORD/32, which does not yet
support LORD IGMs anyway.  06-11-03 note,
============================================================


2.0  INTRODUCTION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  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 <G>, at the time.  So my "stable" of LORD
  programs, as of early June 2003, is as follows, in chronological order:

  L.O.R.D. Cavern, The Gateway, The Outlands Tavern, LordStat, and
  RHP Toolkit - supported for Jason, since June 10, 2002.  ChasWare
  LPEdit, a gift from Charlie Wardick.  Started June 19, 2003.
  The Forest Outhouse - adopted from Robert Fogt/Lloyd Hannesson
  on November 11, 2002.  Gem Trader IGM begun on November 16, 2002.
  Pawn Shop IGM work started for Chris MacPherson on November 22, 2002.
  The L.O.R.D. Gambling Casino IGM - adopted from Tobin Fricke on
  March 24, 2003.  And my last IGM project, The Nice Hag, was started
  on April 07, 2003.

  This project, Ruined Castle IGM, was started on June 11th, 2003.
  First official version released on 07-10-2003.
  ====================================================================

  ======================= Program Description/Setting:
  You find an old Castle that has a ghost inside.  And there are
  various adventures that can be found walking around outside as well.

  If you visit the Ghost, he will grant you small rewards.

  WARNING:  Do NOT ask for a Fairy, when you already have one.  You
  WILL be beaten nearly to death.  Do NOT EVER ask Ghost a second time
  in same day for a Fairy.  If you do, he will either take 3% of your
  Maximum Hitpoints OR he will summon the Grim Reaper.  In which case,
  you are executed by him at the Ghost's command.  Having a Fairy will
  NOT protect you.  The Grim Reaper does not allow Fairies to interfere,
  and sends the Fairy away to its freedom.

  The outer adventures have potential of granting a Horse, a Child,
  some Gems, Healing, Temporary Hitpoints, or some Forest Fights.
  ====================================================================

  Limits:  1. Player can only choose ONE castle adventure per visit.
           2. 1 to 8 Visits per day are allowed.
           3. IGM only allows 4 adoptions to take place per day.
           4. 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.
  ====================================================================

  Castle Visitors Log - Is only shown on-screen if current player is
  the registered sysop.  The disk file log is not viewable by players,
  and is there to allow sysop to monitor daily IGM usage.
    In order for it to work, the user MUST specify their Sysop Handle
  during IGM installation.
  --------------------------------------------------------------------

  IGM does not have any interaction other than between customer and Jack.
  There is zero player-player interaction.  The IGM should be usable
  on as many nodes as your LORD game/BBS can access.  All access of
  LORD's player.dat and lognow.txt files are protected by file locking/
  unlocking routines.
======================================================================


3.0  FILES:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
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.  Setup is included inside.
RUINCAST TXT - Ruined Castle docs - this file.

CCL-APPS.TXT - Info on all of my LORD Programming projects.

* 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.
* 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.
* RUIN-USE.DAT - Binary player database. Tracks all activity inside IGM
                 by players.  Is recreated at start of each new game day.
* RCVisits.txt - Disk file listing content of RUIN-USE.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: RUIN-USE.dat file.
====================================================================


4.0  INSTALLATION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
    1. Unzip RuinWork.zip into a LORD sub-directory.  I suggest using
       RuinCast for directory name.

         http://www.fidotel.com/public/camelot/IGM-Beta/RuinWork.zip
         (File will be/is updated usually 2-3 times per week Online.)

    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.

    3. If using LordMenu utility, remember to re-run Lordmenu.exe and
       update the 3rdalt.txt menu file.  Otherwise, when you enter
       LORD you would not see an entry to run The Ruined Castle v2.0x
       from in the Other Places Menu screen.

       Version Note:  LADY Script uses v1.xx numbering, so IGM starts
       with v2.00 for first official release version, and v1.50 for
       IGM development phase/beta testing usage.
=======================================================================

                                IGM Removal:
    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 and RUIN-USE.dat, unless you think you'll
       re-install the IGM at a later time.
===================================================================

    Configuration Update:

    From DOS Prompt type: RUINCAST CONFIG

    Only value that probably will need revision is Max Visits/Day.
    However, have not figured out way in the code for it to list
    the Sysop Handle value, so that will have to be typed in each
    time you use 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.
     -- IF using Lordmenu, update its data files.

    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://www.fidotel.com/public/camelot/Scripts/dgt-lady.zip
==============================================================

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:\INTERNET\LORD\RUINCAST\RUINCAST.EXE /N* /GC:\INTERNET\LORD
The Ruined Castle v2.00

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:
       RUINCAST.DAT, RUINTIME.DAT, RUIN-USE.DAT, and RUINCAST.EXE.

       Don't rename, except for backup purposes, the RCVisists.TXT
       file.  It is recreated after each IGM usage.
======================================================================

LordMenu information:  To acquire LordMenu v1.30 LORD utility, contact
me via Email.  Or contact Lloyd Hannesson at dasme@dasme.org.  Program
may also be downloaded via web browser from his web-site.
    http://www.dasme.org/techn/index.php

It is also available from various other sources on the Internet,
such as http://www.filegate.net/camelot/lordfile/.

Specific URL:  http://www.dasme.org/techn/files/lrdmnu13.zip
    LordMenu was created by Robert Fogt, and turned over through me
    to Lloyd in early 2002.  Who provides all support for it.
===============================================================

REQUIREMENTS:
  1. Any version of LORD that supports IGMs.   Testing was done
     with versions 3.55 through v4.07 beta.

  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, or 4.07.

    The Ruined Castle LORD IGM will be tested primarily under LORD
    v4.07 beta.  Other beta testers will use other versions, such
    as LORD v3.55.

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


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

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

   http://www.fidotel.com/public/camelot/lordapps.htm
   Castle Camelot LORD Apps Page

   http://www.fidotel.com/public/camelot/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, updater.

4. No current plans to update GeoCities site with copies of any
   LORD programs under development, so have omitted that info here.

5. 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:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
    There are three primary choices offered to player:  Explore
    inside Castle, Look around outside, or Go back to Town.

    -- Inside Castle, as of v1.62, only the Ghost event is available.
    Player may request Gold, Experience, a Fairy (*), Charm, Defense,
    Strength, or Forgiveness for bothering him (Max Hitpoints)

      *  Requesting Fairy, when you have one, results in beaten
         nearly to death by Ghost.
      *  Being greedy and asking Ghost a second time during a day's
         LORD play for a Fairy will result in either a 3% loss of Max
         Hitpoints, or in your Death. (v1.62)

    -- Later versions will have Castle Library event, and Vampire
    Event.  The latter will have 20-25% chance of killing player.

    -- Outside Castle, Exploration.  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.

    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. Decided to go with v2.00 for first release.
   IGM does everything the LADY script and has additional events.

   * Next version:  Will add Castle Library and Vampire Encounter
   adventures, possibly other stuff down the line.
=======================================================


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

Michael Preslar - Current author of Legend of the Red Dragon.

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

Beta Testers:  Gordon Lewicky, Michael Everett, Paul Koukos,
         Joe Kinjin, Charlie Wardick, Chris MacPherson, Rob McGee.
==================================================================


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

9.0      Released CASTLE CAMELOT LORD Apps Listing:

         See CCL-APPS.TXT file for listing of beta programs.

    These are my LORD-related program links:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
DGT-LORD.ZIP - Belgarion's LORD IGMs Play Guides.
    http://www.fidotel.com/public/camelot/dgt-lord.zip

DGT-LADY.ZIP - Belgarion's LORD Lady Scripts v1.46.
    http://www.fidotel.com/public/camelot/Scripts/dgt-lady.zip

    Usage requires LORD v4.05pb, v4.06, or v4.07 beta.  A few
    scripts work only with LORD v4.07 beta.

OTRHP1.ZIP - The Outlands Tavern RHP Set #1 v1.16
    http://www.fidotel.com/public/camelot/Scripts/otrhp1.zip

LPEDIT10.ZIP - ChasWare LORD Player Editor v1.00. -- LORD Utility.
    http://www.fidotel.com/public/camelot/Lordapps/lpedit10.zip

GEMTR210.ZIP - The Gem Trader v2.10 LORD IGM.
    http://www.fidotel.com/public/camelot/LordApps/gemtr210.zip

OUTH210.ZIP - The Forest Outhouse v2.10 LORD IGM.
    http://www.fidotel.com/public/camelot/LordApps/outh210.zip

LORDGC20.ZIP - The L.O.R.D. Gambling Casino v2.00 LORD IGM.
    http://www.fidotel.com/public/camelot/LordApps/lordgc20.zip

HAG210.ZIP - The Nice Hag v2.10 LORD IGM.
    http://www.fidotel.com/public/camelot/LordApps/hag210.zip

FORHP1.ZIP - The Forest Outhouse RHP Pack v1.00
    http://www.fidotel.com/public/camelot/Scripts/forhp1.zip
    -- Includes: The Burlap Bag, The Magical GemStone, Polish
    Armour, and Sharpen Weapon RHP scripts.
    -- Some require v2.10+, others v2.15+, of the Forest Outhouse IGM.

RUIN20.ZIP - The Ruined Castle v2.00 LORD IGM.
    http://www.fidotel.com/public/camelot/LordApps/ruin20.zip
=====================================================================

    LORD programs by Jason Brown, maintained by Donald Tidmore:
CAVE15.ZIP   - The L.O.R.D. Cavern v1.5. LORD IGM
    http://www.fidotel.com/public/camelot/Lordapps/cave15.zip

GATE11.ZIP    - The Gateway v1.1. LORD IGM
    http://www.fidotel.com/public/camelot/Lordapps/gate11.zip

LORDST17.ZIP  - LordStat v1.7.    LORD Utility
    http://www.fidotel.com/public/camelot/Lordapps/lordst17.zip

OUTS14.ZIP    - The Outlands Tavern v1.4.  LORD IGM
    http://www.fidotel.com/public/camelot/Lordapps/outs14.zip

RHPTST12.ZIP  - RHP Toolkit v1.2.  Two LORD Utilities.
    Includes RHPTest v1.2 and LordType v1.2.
    http://www.fidotel.com/public/camelot/Lordapps/rhptst12.zip
-----------------------------------------------------------------

CAVERHP1.ZIP - The L.O.R.D. Cavern RHP Set #1 v1.20
    http://www.fidotel.com/public/camelot/Scripts/caverhp1.zip
    -- First batch of RHP Scripts for L.O.R.D. Cavern usage.

CAVERHP2.ZIP - The L.O.R.D. Cavern RHP Set #2 v1.20
    http://www.fidotel.com/public/camelot/Scripts/caverhp2.zip
    -- Second batch of RHP Scripts for L.O.R.D. Cavern usage.
==================================================================


                           UPCOMING LORD Projects:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
** The Nice Hag v2.20 - Integration into existing IGM of Bandit
   LADY Script event, which will run randomly, as player is leaving
   the IGM.  Initial recompile done 06/11 to fix omission of CLOSE
   command in code accessing the IGM's configuration file.
   http://www.fidotel.com/public/camelot/IGM-Beta/Hag-Work.zip

** Ruined Castle v2.10 - Addition of Castle Library, Vampire events.
   No timetable, other than late July 2003.

** Conversion to ANGEL Toolkit of:  The Gateway, Forest Outhouse,
   L.O.R.D. Cavern, Outlands Tavern, and RHPTest.
   Timetable:  mid/late July or August 2003.
=========================================================================


10.0  SUMMARY
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Your comments, questions, suggestions are welcome and appreciated.  I'd
like to know that people are actually using my IGM. :)  I've put a lot
of work into it and I hope it is appreciated.
    -Donald Glenn Tidmore
======================================================================


11.0                             DEDICATION:
                     To Dan Stovall and Michael Everett.
======================================================================

12.0    No support is currently available for LORD/32 to run LORD IGMs.
  Due to my lack of Windows programming knowledge, *IF* 32-bit igms
  versions are made of my LORD IGMs, I may have another LORD author
  handle that.  I also can not provide support for any of my LORD
  IGMs if they are used with LORD/x, due to my lack of Linux knowledge.
==========================================================================

RUINCAST.txt -- End of documentation.
Updated on July 10, 2003.

