              -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
                    LORD IGM: THE NICE HAG   **FREEWARE**
                        VERSION 2.10 -- DOCUMENTATION

              -- v2.00:  Officially released on May 06, 2003. --
             -- v2.10:  Officially released on June 04, 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;  once a quarter or so.)

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.

Note:  The LADY Script version of The NICE HAG is usable only with
versions 4.05pb - 4.07 beta of LORD.
=========================

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

THE NICE HAG 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 is fully tested under LORD v4.07 beta (May 2003 compilations).
It MAY be usable under LORD for Linux, betas #1 and #2, but I have no
way to confirm that.  Other beta testers have used the IGM with LORD
v3.55 - v4.06 as well.  Support is only available for DOS LORD, since I
have no way to test under the Lord for Linux beta program.  IGM support
does not yet exist for LORD/32's beta.
============================================================


2.0  INTRODUCTION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  Thanks for trying out my second personal LORD IGM program.  This is
  the second IGM adapted from an LORD LADY Script that was created
  in 2002 by myself.

  ======================= Program Description/Setting:
  While adventuring in the forest, you come across an Old woman.
  Her smile warms your heart.  "My name is Sarah, and I'm lost. Can
  you help me get home?" she asks.   Being a good warrior, you escort
  her home to a little brick cottage near town.  You are greeted by
  Sarah's sister, who you have met before -- it's the Old Hag.

  The Hag thanks you for bringing her sister home safely, and offers
  you a special deal as a reward.  For one Gem, she will DOUBLE her
  usual exchange rate, and give you TWO Hitpoints!  There are a few
  extras involved in the process, including Healing when needed,
  and a small gift of Experience Points.  Whether you give the Hag
  your gem or not, you will get something out of the visit.
  ============================

  Uses Limitation:  This IGM can only be used up to 5 times per day.
  Sysops/end-users may choose between 1, 2, 3, 4, or 5 uses per day.
  Nicehag.exe is hard-coded to not work past 5 visits each day for
  a player, whose past igm usage is recorded in the IGM's daily usage
  database file - hagvisit.dat.  (v2.10 allows 5 max visits per day.)
  -------------------------------------------------------------------

  IGM does not involve interaction with other players.  If player is
  married, the spouse's name is listed in the View Stats screen. The
  IGM should be usable on as many nodes as your LORD game/BBS can access.

  No LORD mail files are written by IGM to players, and no usage-oriented
  messages are written by IGM to lognow.txt file, as of v2.10.
======================================================================


3.0  FILES:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
The following files are included within THE NICE HAG archive:

FILE_ID.DIZ  - Description file (Nice-Hag.diz)
Nice-Hag.DIZ - backup copy of archive identifier for BBS usage.
NiceHag EXE - The NICE HAG IGM.  Setup is included inside.
Nice-Hag TXT - NICE HAG docs - this file.

* NiceHag.DAT -  Created by IGM when it is installed.  Stores sysop
           name, BBS name, LORD directory path, and IGM directory path.
* HAGTIME.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.
* HAGVISIT.DAT - Binary player database. Tracks all activity inside IGM by
                 every player.
====================================================================


4.0  INSTALLATION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
    1. Unzip HAG210.ZIP into a LORD sub-directory, or into your main
       LORD directory.  As long as no other IGM uses files that Nice
       Hag is hard-coded to access/use, it will co-exist with other LORD
       igms without any problem.  However, I recommend that you give the
       IGM its own subdirectory, such as NICEHAG.

    2. From DOS Prompt, type:  NiceHag 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 installation.

    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 NICE HAG v2.00 from
       in the Other Places Menu screen.
======================================================================

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

    2. Delete the nice*.* files unless you think you may want to keep
       them around.  That concludes IGM removal process.  Also delete
       files like hagtime.dat and hagvisit.dat, unless you think you'll
       re-install the IGM at a later time.
======================================================================

                          IGM Configuration Update:
    If you change your mind about how many times per day the IGM may
    be used, you type, from DOS Prompt:  NiceHag CONFIG

    Follow the dialog box instructions, and choose a number for daily
    uses between 1 and 5.

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

Upgrading from Version 2.00:
----------------------------
Run the NICEHAG CONFIG command, to use IGM where it is currently
located.  Then follow the on-screen prompts.  If you are moving
IGM to different location, remove it first, then re-install from
the new location.  Edit/revise 3rdparty.dat file to change the
version number information.  If using LordMenu, update its data
files, so that the Other Places screen in LORD shows accurate info.

=================================================================

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 be different, most likely.

C:\INTERNET\LORD\NICEHAG\NICEHAG.EXE /N* /GC:\INTERNET\LORD
THE NICE HAG v2.10

The actual description entry in 3rdparty.dat will contain the
LORD color codes, like this:  `@T`$he `@N`$ice `@H`$ag `%v2.10

----------------------------------------------------------------------
Note:  While using this IGM, you may NOT rename any of these files:
         NICEHAG.DAT, HAGTIME.DAT, HAGVISIT.DAT, and NICEHAG.EXE.

       Renaming files will result in IGM usage problems, or keep the
       IGM from working at all.  Plus, doing so is a violation of the
       conditions for obtaining technical support.  I do not promise
       to provide support to people who disregard these directions.
======================================================================

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

    http://www.nightfallgames.com/files/ - See Scripts section.
==============================================================

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. There are no
     limitations other than on how many times a day IGM can be used.
     (And of course, the player has to be ALIVE, to use the IGM. <G>.)
------------------------------

TESTING:
    LORD Lady Scripts, Nicehag.ldy, which this IGM is based upon, is
    usable only with LORD 4.05pb, 4.06, or 4.07.

    NICEHAG.EXE LORD IGM is tested under LORD v4.06 and 4.07 beta
    by myself, and with earlier LORD versions by various friends.

    Testing has been done using all versions of Microsoft Windows,
    starting with Windows 95, and ending with Windows XP, using
    current v4.0x versions of Legend of the Red Dragon.
================================================================


5.0  DISTRIBUTION/UPDATES/REVIEWS:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Current official version of THE NICE HAG can be found via
the following site links:

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/LordApps/hag210.zip
   The Nice Hag (IGM) v2.10 - Direct access download

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

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

4. http://www.geocities.com/SiliconValley/Vista/5389/
   Inactive since December 2002.  (Updated on May 03, 2003. )

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

6. ICQ Shared Files.  I keep current copies of dgt-lady.zip, and
   archives for my LORD IGM/utility programs in the ICQ directory.
   As long as I'm online, and you have Shared Files activated, you
   can download files from my system.

   If something is listed as BETA, check with me before installing it.
   Some new compilations aren't tested right away, and might not work
   properly.  This mainly applies to beta versions of The Pawn Shop
   v2.70, as of 05/22/2003, which is in progress for Chris MacPherson.

7. http://www.dasme.org/techn/lord1igm.php  - LORD 1 IGM List.  Resumed
   operational status on February 04, 2003. Hosted by Lloyd Hannesson.
   (Added entry #7 on March 18, 2003.)

   As of mid-April 2003, Lloyd's site was off-line.  He has moved to
   a new home, and has not put the web-site back online yet, as of
   May 31, 2003.
======================================================================


6.0    Archive/Program Version Info:

   The IGM's public release is v2.10.  My LADY Script files for
   The Nice Hag already uses the v1.xx numbering system.
=======================================================


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

Michael Preslar - He convinced me to try writing LADY Scripts in
                  January 2002.  And he provided me with free hosting
                  for my web-sites for several months in 2002.
Gordon Lewicky  - He taught me most of what I know about LADY Script
                  programming, and has done diagnostic work on all of
                  my complex LADY Scripts when they had glitches.
Gary Hartzell   - For giving me feedback, support, and friendship.
                  And especially for encouraging me to become an LORD
                  IGMs author when I was considering it in May 2002.
Jason Brown     - For entrusting me with his LORD IGMs and utilities
                  as their co-author, maintainer, and updater.
                  Also for several long years of LORD friendship.
Charlie Wardick - My primary programming teacher.  For over a year
                  of training in how to write LADY scripts in a
                  logical manner, and then in relearning Pascal
                  language and usage of Turbo/Borland Pascal.
Chris MacPherson - For entrusting me with update of his Pawn Shop IGM.

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.  Oh yeah, and most of all, for putting up with my
tendency to write occasionally LONG email messages to them <G>.
==================================================================

Beta Testers:  Gordon Lewicky, Michael Everett, Paul Koukos, Jason
         Brown, Joe Kinjin, Charlie Wardick, Chris MacPherson.
         And a few others here and there, including Rob McGee.
==================================================================


8.0  DEDICATIONS:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
The Nice Hag IGM is, as of 06/03/2003, dedicated to my friends
Gary Hartzell and Gordon Lewicky.
==================================================================


9.0  RELEASE INFO:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
THE NICE HAG v2.00 was officially released on May 06, 2003.

Version 2.10 was released for public usage on June 04, 2003.
==============================================

10.0                      CASTLE CAMELOT LORD Apps:
                          CCL-APPS.TXT -- 06/03/2003

    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

OTRHP1.ZIP - The Outlands Tavern RHP Set #1 v1.16
    http://www.fidotel.com/public/camelot/Scripts/otrhp1.zip
    -- Includes two scripts by Gary Hartzell -- Dude With A Joint
    and Meet A Stranger;  and one by me -- The Secret Alcove v1.25

LPEDIT10.ZIP - ChasWare LORD Player Editor v1.00. -- LORD Utility.
    http://www.fidotel.com/public/camelot/Lordapps/lpedit10.zip
    Created by Charlie Wardick, development finished by me.
    v1.00 was officially released on February 28, 2003.

OUTH200.ZIP - The Forest Outhouse v2.00 LORD IGM. (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/outh200.zip
    v2.00 was officially released on April 03, 2003.
    Adopted from Robert Fogt and Lloyd Hannesson in Nov. 2002.

HAG200.ZIP - The Nice Hag v2.00 LORD IGM.  (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/HAG200.zip
    v2.00 was officially released on May 06, 2003.  

GEMTR210.ZIP - The Gem Trader v2.10 LORD IGM. (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/gemtr210.zip
    v2.10 was officially released on May 09, 2003.

OUTH210.ZIP - The Forest Outhouse v2.10 LORD IGM. (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/outh210.zip
    v2.10 was officially released on May 13, 2003.
    Adopted from Robert Fogt and Lloyd Hannesson in Nov. 2002.

LORDGC20.ZIP - The L.O.R.D. Gambling Casino v2.00 LORD IGM.
    -- Official Release: May 26th, 2003. --
    http://www.fidotel.com/public/camelot/LordApps/lordgc20.zip
    Adopted from Tobin Fricke in March 2003.

HAG210.ZIP - The Nice Hag v2.10 LORD IGM.  (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/HAG210.zip
    v2.10 was officially released on June 04, 2003.
=================================================================

    LORD programs by Jason Brown, maintained by Donald Tidmore:

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

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

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

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

RHPTST12.ZIP  - RHP Toolkit v1.2.  LORD Utility by Jason Brown.
    Contains two programs: RHPTest v1.2 and LordType v1.2.
    http://www.fidotel.com/public/camelot/Lordapps/rhptst12.zip
=================================================================

    In beta production, as of 06-03-2003:

1) The Gateway v1.1a Beta
   http://www.fidotel.com/public/camelot/IGM-Beta/gatework.zip
    ** Prepared for Jason Brown.

2) The L.O.R.D. Cavern v1.5a Beta
    http://www.fidotel.com/public/camelot/IGM-Beta/cavework.zip
    ** Tweaking for official release, using version # 1.5b.
    ** Prepared for Jason Brown.

3) The Outlands Tavern v1.4b Beta
    http://www.fidotel.com/public/camelot/IGM-Beta/out-work.zip
    ** Prepared for Jason Brown.

4) The Pawn Shop v2.74+ Beta
    http://www.fidotel.com/public/camelot/IGM-Beta/pawnwork.zip
    ** Tweaking, fine-tuning for version 3.00 release.
    ** Prepared for Chris MacPherson.

5) RHP Toolkit v1.2a Beta -- LORD Utility
    http://www.fidotel.com/public/camelot/IGM-Beta/rhp-work.zip
    ** Prepared for Jason Brown.

6) Gem Trader v2.13 Beta.  -- LORD IGM.
   http://www.fidotel.com/public/camelot/IGM-Beta/gemtwork.zip
====================================================================


                           UPCOMING LORD Projects:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
** LPEdit v1.10 - Not scheduled until LORD v4.07 beta problems are
   resolved.  May make marriage contingent on the proposing player
   having 100/125 charm points.

** The Ruined Castle v2.00 - LORD IGM adaption of Dan Stovall's
   LADY Script.

** Forest Outhouse v2.20 - Will contain new feature that lets you
   gain various stat increases after reading a parchment scroll,
   including a Skill Point, if you are lucky.
   http://www.fidotel.com/public/camelot/IGM-Beta/oh2-work.zip
=========================================================================


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


                       { IGM/Utility Support Notice: }
  Since I do not use a Linux-based computer, I can not provide support
  for this program if you are using the LORD/x beta, beyond the normal
  DOS LORD IGM support level.

  As of May 23rd, 2003, LORD/32 for Windows is in beta #2.  It does
  not yet support IGM usage.  When it does, and is stable for Local
  Mode usage for people like myself, I will test L.O.R.D. Cavern, The
  Gateway, The Outlands Tavern IGMs;  the LordStat and RHP Toolkit LORD
  utilities;  my LPEdit LORD player editor utility;  and The Gem Trader,
  The Nice Hag, The Forest Outhouse, The L.O.R.D. Gambling Casino, and
  The Pawn Shop LORD IGMs -- to see if any changes need to be made, in
  order to provide Lord/32 support for them.
  ---------------------------------

  In summary, this program may be used with DOS LORD versions and will
  be fully supported.  Limited support may be available eventually for
  LORD/32 users, running my LORD programs. It depends on whether Michael
  Preslar releases details on how IGMs are to interact differently, if
  at all, when they are run by either LORD/X or LORD/32.
==========================================================================

                         -- End of documentation. --

Nice-hag.txt:  Last update - June 04, 2003.

