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

            -- v2.00:  Officially released on May 06, 2003. --
            -- v2.10:  Officially released on June 04, 2003. --
            -- v2.14:  Officially released on October 03, 2003. --
            -- v2.30:  Officially released on March 25, 2004. --
              -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

AUTHOR:  Donald Tidmore
Email:   donald.tidmore@fidotel.com, donald.tidmore@usa.net,
         gtidmore@hiwaay.net.  Or ktidmore@bellsouth.net, if
         others are unusable by you.

ICQ:     Belgarion - #238685196.  Checked occasionally.

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.fidotel.com/public/camelot/igm-beta.htm
         Current LORD betas download page

         --  http://www.fidotel.com/public/camelot/igmpage.htm
         Revamped Trentsoft IGMs Page

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

Address:  Donald Tidmore, 1111 Berenice Street,
          Tuscumbia, Alabama 35674-3503  USA
=================================================================

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 (December 04, 2003
compilation).  As of 03/24/2004, that was the most currently
available compile of the current DOS LORD program.

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.  The IGM was created on April 07, 2003.

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

  { ------------------------------------------------------------------ }
  v2.15+ Notes: The Bandit event will be run 20% of the time, after the
  player leaves the cottage.  Unlike the LADY script, I've configured
  the IGM to only take 25% of the player's Gold and Gems.

  Note 2: I decided that those who try to keep accessing IGM each
  day beyond the Max Visits/Day setting, configured by sysop during
  IGM installation, will ALWAYS meet the bandit while exiting IGM.

  Example: If sysop sets IGM usage to 2 times/day, anyone who uses IGM
  3 times or more, will automatically trigger the bandit event.
======================================================================


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 HAG230.ZIP into a LORD sub-directory, or into your main LORD
       directory.  (Unzip HAG-WORK.ZIP if you are using a beta version.)

       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
       sub-directory, 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.30
       from in the Other Places Menu screen.

    4. Co-existence with other IGMs guarantee:  I use an IGMs directory
       for running several LORD IGMs together.  These IGMs WILL get
       along with The Nice Hag IGM without ANY problem:

       Barak's House, Felicity's Temple, Free World, Gem Trader, Warrior's
       Graveyard, Hidden Spring of Turgon, L.O.R.D. Cavern, Love Shack (or
       Love Shack II), Turgeon's House, Violet's Cottage, or Werewolf.

       If using Outlands Tavern v1.5/v1.5a, it can be run with L.O.R.D.
       Cavern or The Gateway - any version - safely in the same directory.
======================================================================

                                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, 2.10, or 2.14:
----------------------------
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.

Upgrading from v2.14 to v2.30:
    Manual update:  Edit IGM's entry in 3rdparty.dat to change version
    number for Nice hag igm.  Save file.  Update Lordmenu data files.

    Entry should say: The Nice Hag v2.30 (without color codes)

    Automated update:  You will have to uninstall the IGM, and then
    re-install it to use this method.
=================================================================

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

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

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

Get copy from my web-site's LordApps directory:
    http://www.fidotel.com/public/camelot/LordApps/lrdmnu13.zip
===============================================================

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/hag230.zip
   The Nice Hag (IGM) v2.30 - 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.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.

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


6.0    Archive/Program Version Info:

   The IGM's public release is v2.30.  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.
    Version 2.14 was officially released on October 03, 2003.
    Version 2.30 was officially released on March 25, 2004.
==============================================


10.0          { Castle Camelot LORD Apps Summary: }  {03/20/2004}

    Lists the CURRENT official version of each program.

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

CAVERHP1.ZIP - The LORD Cavern RHP Set #1
    http://www.fidotel.com/public/camelot/Scripts/caverhp1.zip

CAVERHP2.ZIP - The LORD Cavern RHP Set #2
    http://www.fidotel.com/public/camelot/Scripts/caverhp2.zip

CAVERHP3.ZIP - The LORD Cavern RHP Set #3
    http://www.fidotel.com/public/camelot/Scripts/caverhp3.zip

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.48.
    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.28

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

LORDGC21.ZIP - LORD Gambling Casino v2.10 LORD IGM.
    http://www.fidotel.com/public/camelot/LordApps/lordgc21.zip

CAVE16.ZIP - The L.O.R.D. Cavern v1.6 LORD IGM.  (Official Release)
   -- http://www.fidotel.com/public/camelot/LordApps/cave16,zip

GATE12.ZIP - The Gateway v1.2 LORD IGM.  (Official Release)
   -- http://www.fidotel.com/public/camelot/LordApps/gate12.zip

OUTH220.ZIP - The Forest Outhouse v2.20 LORD IGM.  (Official Release)
   -- http://www.fidotel.com/public/camelot/LordApps/outh220.zip

RHPTST13.ZIP - The RHP ToolKit v1.3 LORD Utilities.  (Official Release)
   -- http://www.fidotel.com/public/camelot/LordApps/rhptst13.zip
   -- Contains RHPTest v1.3 and LordType v1.3.

FORHP1.ZIP - The Forest Outhouse RHP Pack v1.05 -- 11/08/2003 release
    http://www.fidotel.com/public/camelot/Scripts/forhp1.zip

GEMTR220.ZIP - The Gem Trader v2.20 LORD IGM. (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/gemtr220.zip

PAWN310.ZIP - The Pawn Shop v3.00 LORD IGM. (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/pawn310.zip

LOVE200.ZIP - The Love Shack II v2.00 LORD IGM. (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/love200.zip
======================================================================

THOUSE32.ZIP - The Turgeon's House v3.20 LORD IGM. (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/thouse32.zip
    -- v3.20 was officially released on Jan. 05, 2004.

OUTS15A.ZIP - The Outlands Tavern v1.5a LORD IGM. (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/outs15a.zip
    -- IGM was re-released as v1.5a on Jan. 05, 2004.

OTRHP1.ZIP - The Outlands Tavern RHP Set #1 v1.18
    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.28
    -- Re-released docs update on Jan. 05, 2004.

LPEDIT12.ZIP - ChasWare LORD Player Editor v1.20. -- LORD Utility.
    http://www.fidotel.com/public/camelot/Lordapps/lpedit12.zip
    ** Officially released on March 22, 2004.

HAG230.ZIP - The Nice Hag v2.30 LORD IGM.  (Official Release)
    http://www.fidotel.com/public/camelot/LordApps/hag230.zip
    ** Officially released on March 25, 2004.

                   - See the enclosed CCl-APPS.TXT file.
====================================================================


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

Email contact notes:  Please use either donald.tidmore@usa.net, or
donald.tidmore@fidotel.com (preferred for LORD mail) to contact me.

gtidmore@hiwaay.net - usable as of mid-September 2003.

ktidmore@bellsouth.net - I want to return it to being mainly for
family usage.  So don't use it for Lord email unless the above
three email accounts are not accessible for you.  Thanks.
================================================================


  Support Notice - LORD IGMs/Utilities.  Revised 10/03/03.
  ==========================================================
  I do not know or use Linux, so there will not be any Linux-based
  versions of my LORD programs.  Unless some other LORD author wishes
  to do the work.

  As of Dec. 31, 2003, there has been zero progress publicized on
  LORD/32, since the 2nd beta was released in early summer 2003.
  The same applies to LORD/X as well.

  No info has been released to indicate how Lord/32 will handle/run
  existing 16-bit DOS igms or how one should proceed to make 32-bit
  LORD IGMs.  Whenever that does happen, I may work on 32-bit versions
  of my LORD games, or I may have an experienced Windows programmer
  friend take care of those projects.
=====================================================================

Nice-hag.txt:  -- End of Documentation --

Revised on:    March 25, 2004 at 02:25 am.

