    -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
    LORD IGM: THE GEM TRADER   **FREEWARE**

    VERSION 2.40 Beta  -- DOCUMENTATION

    ** v2.20 Officially released Nov. 10, 2003. **

    IGM Compile date:  September 16, 2005.  (v2.40 beta)

    JACKEDIT.EXE Compile Date:  September 12, 2005. (v0.92 Beta)

    Docs Update done:  September 16, 2005.

    Last Player Database Structure revision:  August 19, 2005.
    -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

AUTHOR:  Donald Tidmore
Email:   donald.tidmore@usa.net or donald.tidmore@fidotel.com (primary)
         gtidmore@hiwaay.net (secondary)
         ktidmore@bellsouth.net (use ONLY if unable to use primary addresses.)

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

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


07/18/05: Re-organized layout of IGM's Player Database file.  Added
          four new variables -- Forest, HorseShoes, Saddles, and
          Kids_Ban -- for use in tracking purchase of Forest Fights
          potions by trading gems for HorseShoes or Saddles, and
          tracking Adoptions Access eligibility each day.

          Started work on JACKEDIT.EXE player database editor
          utility. Users of July 18 beta will need to delete
          pre-existing gemdrink.dat file before using the IGM.

          JACKEDIT.EXE is usable as of 07-19-2005.

08/19/05: Added SkillUses variable to player database structure.

          Usage of GEMTRADE v2.38+ and JACKEDIT v0.875+ betas are now
          required due to incorporation of the new database variable.
====================================================================


0.5  JACKEDIT.EXE Information  {07/19/05}
=========================================

IGM Utility: Gem Trader Player Editor

Version 0.92 Beta -- September 2005 development.

    -- Development started on Jul. 19, 2005.
    -- For usage only with the DOS LORD IGM.

    -- Requires you to have a current GEMDRINK.DAT file.
    -- You also need to be using v2.39+ of the IGM.

  Distributed inside the gemtwork.zip beta archive.
  Also distributed inside jackedit.zip archive.

  ** 08/19/05: Added support in editor for the Skill
  Use Points field, added to player database today.
  So you have to use v2.39+ of the IGM from now on
  with v0.875+ of the editor program.             **
  --------------------------------------------------

  08/08/05: Changed IGM to use JACK-USE.TXT for the Usage Reports
  disk file, instead of the old Tradelst.txt file.

  08/08/05: Started testing Saddles and HorseShoe Sets code.

  08/19/05: Added third usage report and SkillUses database
  variable.  Report #3 will cover HorseShoe Sets, Saddles, Forest
  Fights, and Skill Use Points values.

  ================================================================
  Deletion of old Gemdrink.dat file should be done before you begin
  usage of the Aug. 19 beta compile of either GEMTRADE.EXE or
  JACKEDIT.EXE if you have used IGM earlier today (Aug. 19th).
  ===============================================================


  JACKEDIT Usage Notes:
  =======================================

  1) Obtain current copy of beta program from me via email.
     It will be distributed inside gemtwork.zip beta archive.

  2) Unzip all files from gemtwork.zip into your IGM directory,
     using overwrite mode so you get the newest files.

  3) Change into the Gem Trader IGM directory.  Verify you have
     a current GEMDRINK.DAT file.  If you don't then you can't
     use JACKEDIT.EXE.

  4) The first time you run the utility, it will ask you for
     the path to the Gem Trader IGM directory.  Type it in, and
     press ENTER to exit the dialog box prompt.  JACKEDIT.CFG
     file will be created in that directory.

  5) Run JACKEDIT.EXE.  If a config file is not in the directory
     you run it from, it will ask you to create on - as noted
     above.  If config file is found, it then checks for existence
     of GEMDRINK.DAT file.  If one is not found, program will
     give error message and quit working.

     JACKEDIT has only one screen of data.  It shows database
     fields in the order they are listed in the player database
     record structure (usually).  Each value, with one exception,
     may be set to any value that is valid for it.

     The Lord Player Number field is display-only.  That is because
     I don't see any valid reason to allow users to fiddle around
     the LORD Player Number field.

  6) When you exit JACKEDIT, it will resave the GEMDRINK.DAT
     file so that any changes you made will be accessible to
     the IGM.         End of Notes for JACKEDIT usage.
==============================================================


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
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 Gem Trader is usable only with
versions 4.05pb - 4.07 beta of LORD at this time.  The LADY Script Gem
Fairy Trade, which covers the trade of Gems for a Fairy, requires LORD
v4.07 beta, April 2002 compilation or later.  Some features of the IGM
version are not in the Script versions, primarily due to limitations of
the LADY script engine.
=========================

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

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

This IGM is fully tested under LORD v3.55 through v4.07 beta
using late August 2005 compilation.

Support is only guaranteed for users of DOS LORD.
============================================================


2.0  INTRODUCTION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  Thanks for trying out my first solo LORD IGM program.  I made it
  after spending several months creating and fine-tuning the original
  Gem Trader LADY Scripts:  GemTrade.ldy and GemFairy.ldy.  GemFairy is
  the part that can only be used with LORD v4.07, due to the fact that
  prior versions of LORD, using LADY Script engine, did not support the
  LADY script variable for Fairy.

  ======================= Program Description/Setting:
  You come across a camp in a meadow and see a man working besides
  large kettles near a spring.  He's surrounded by hundreds of full
  or empty small bottles, of different colors.  When you introduce
  yourself, you discover that he is Peddler Jack, and he is the source
  of all of the magical elixirs sold by the Bartender at the Inn.

  Jack will sell you his Hitpoints, Strength and Defense potions
  at a better rate than the Bartender does.  Unlike the Bartender,
  who keeps the Charm potions for his own use, presumably, Peddler Jack
  will also trade you Charm potions.  You may also acquire a new Horse
  or Fairy, providing you have enough Gems to do business. If you don't
  have any Gems, or not enough to trade, you receive 1 free Max Hitpoint.
  ============================


      The Gems/Potions Exchange Rate and Purchase Limits:
      ---------------------------------------------------
  1) Gem Trader uses a simple 3 Gems = 2 potions exchange rate.  In
  LORD's Inn, the bartender is stingy and only gives one potion for
  two gems.  With Jack, you get a better deal -- plus he sells Charm
  points, which the bartender does not do.

  ----------------------------------------------------------------
  NOTE: If you want a better deal, you can always check out one of
  my two IGM betas, Doofus the Gnome.  Ole Doofus does offer some
  better prices here and there, and he allows you to buy multiple
  kids at a time.  Interested?  Let me know by email and I'll send
  you a beta archive.  What is the other new IGM?  The Werewolf II.

  http://www.fidotel.com/public/camelot/IGM-Beta/dg2-work.zip
  -- Doofus the Gnome IGM beta archive.

  http://www.fidotel.com/public/camelot/IGM-Beta/werework.zip
  -- The Werewolf II IGM beta archive.

  The on-line files will not always be up-to-date.  I generally do
  web-site updates one-two times a week.  If you want to use these
  two new IGMs, join my beta testers group.
  ---------------------------------------------------------------

  2) You may buy up to 2,500 potions at a time, and are allowed to
  make up to 7 purchases per visit.  Higher purchase/visit values
  resulted in IGM instability, especially when Fairies were involved.

    ** Changed Purchases/Visit from 6 to 7 on Aug. 20, 2005. **

  3) Players are limited to a maximum of 8,000 potions purchases per
  day.  The actual value is configurable by the end-user/sysop, using
  a default minimum value of 2,000.

  4) Players may visit Peddler Jack's camp up to 10 times per day.
  After they've reached 10, no further trips are allowed until the
  next LORD game day.  The actual number of visits/day is selected
  by end-user/sysop during IGM installation, or using IGM Configuration.

    ** Changed up to 10 visits/day, as of Jul. 19, 2005. **
  ====================================

  5) Regarding Adoptions, there are three limiting factors.  Two
  are sysop-configurable, as of 08/31/2005.  (A) Players may do
  up to 750 Adoptions per purchase.

  (B) You may do up to 5,000 Adoptions per day - as of 08/31/2005.  This
  limit may be between 1 and 5,000, and is sysop-configurable.

  (C) Adoptions are allowed until player has 16,000 or more Kids.  After
  that, this IGM will not allow access to the Adoptions IGM event.

  The IGM supports single adoptions and multiple adoptions.
  ====================================

  6) 07/29/05: Fairies/Day limit changed from 5 to 12.
     Fairies may now be bought up to 12 times per day.

     * Regarding Fairy purchase, requesting one when you HAVE
     one, results in "Fairy Lightning Bolt" injury, and ejection
     from the IGM.

  7) 07/29/05: Horses may be bought up to 12 times per day.

   * Regarding Horse purchase, requesting one when you HAVE one,
     results in "Horse Bite" injury, and ejection from the IGM.

  -------------------------------------------------------------
  As of 08/31/05, the Fairies/Day and Horses/Limit are sysop
  configurable by the user during IGM installation or Config
  Update process.  The end-user/sysop may also now choose the
  number of adoptions that is allowed per purchase.

  Use GEMTRADE CONFIG to update your igm config file settings
  to include the three new igm configuration values as soon as
  you start using the August 31 beta compile of GEMTRADE.EXE.
  -------------------------------------------------------------

  Once player reaches Fairy/Horse purchase limits, they are
  granted a 50% gems refund by Peddler Jack, and the requested
  purchase which was denied does not count against the Purchases
  per Visit limit.  If Jack is unable to sell player the Horse
  or Fairy, the player is granted 2 Skill Use Points for their
  current Skills Class.

  Skill use points are tracked by the IGM, as of Aug. 19th, and
  are reported in the third IGM usage report.

  ====================================
  8) The primary Stats screen, Stats Summary screen, and the on-screen
  and disk file Potions Traders Info Listing reports all cover adoptions.
  They also track daily purchases of Horses and Fairies.
  ========================================================================


  March 2005 notes on Sexy Samantha storyline:
  -------------------------------------------------------------------
  I created a new LORD IGM last year, named Kiteria's Lord Bank.  Samantha
  is the banker, and she will do her interaction with people in that IGM.

  It is possible that I will have her doing actual interaction with players
  in this IGM as well.  Will just wait and see how the creative process
  works itself out in that regard.  Eventually Sexy Samantha is going to
  start flirting with warriors at the Bank in addition to handling their
  Gold and Gems Banking needs -- which are protected from burglars.

  April 15: Added two lines to Gem Trader's Installation Notice, to advertise
  Jack's daughter becoming a sexy banker.  Seems appropriate for a daddy to
  send customers in the direction of his only daughter, right?  I think so <G>.
  =============================================================================


  Update Plans:  No timetable.  Will do them as the mood strikes me.
  ----------------------------------------------------------------------------
  Notes: Fairy Trades Limit and Horse Trades Limit are hard-coded
  at 12.  I see no real need to make either one sysop-configurable.

  Adoptions/Purchase limit of 700 is hard-coded, and does not need
  to be sysop-configurable.


  Reserved for a Later development period:
  ========================================
  * The "Player returns to LORD riding a milk cow" idea is still
    planned, but I am not sure when I will put it into effect. I
    don't know to create ANSI graphics, and without one, the gag
    might not really work with players based solely on on-screen
    wording they see.  And effect is only temporary anyway, since
    LORD does not know what a Milk Cow is.

  * Horse Accessories: Besides Saddles and Horseshoes, which will
    be added first, the Horse Supplies Menu will eventually also
    offer one or more of these items:  1) Apples, 2) Honey and Oats
    Feed Bag, and 3) Bridles.
  =====================================================================


                  UPDATING to version 2.40 Beta:
                  --------------------------------
  As of 03-23-2005, this IGM is back in development.  Please always use
  beta archive (GEMTWORK.ZIP) that you obtain from me directly via email.
  That way you will know if there are any problems being worked out,
  which you should know about.

  To update to the beta, simply unzip all of its data files into the
  sub-directory you have Gem Trader installed in.  Use overwrite mode
  for every file in the gemtwork.zip archive.  If you use version data
  in 3rdparty.dat, you will need to manually edit Gem Trader's version
  information periodically.

  Run GEMTRADE CONFIG if you are doing an update, and make changes to
  the Adoptions/Day Limit variable.  As of July 29th, you may use between
  1 and 5,000.  The default setting is 1,250, as of Sept. 14th, 2005.

  You also have to select values, as of 08/31/05, for Adoptions per
  Purchase limit, Fairies per day limit, and Horses per day limit,
  while you are using the GEMTRADE CONFIG process.  

  To use v2.40 Beta, simply unzip the current files from GEMTWORK.ZIP into
  your Gem Trader IGM directory using overwrite mode.

  If you are using August 19 beta, be aware that the player database
  structure has been changed, so you may need to delete your existing
  GEMDRINK.DAT file before running the IGM in LORD, or using GEMTRADE REPORT.
  ---------------------------------------------------------------------

  Please note that you can either keep your old settings for Adoptions/
  Day limit, or increase them up to 5,000, as of August 31th, 2005.

  Fairy trades will be allowed up to maximum of 12 per day.
  -- The old limit was changed from 5 on 07-29-2005.

  Horse trades will be allowed up to maximum of 12 per day also.
  -- Coding is in progress, as of 07/29/2005.

  ----------------------------------------------------------------------
  There is an actual IGM usage factor of 70 for purchases per day.
  Fairies, Horses, Saddles, and HorseShoe Sets can only be bought
  one at a time.  Potions and Orphans can be bought in quantity,
  subject to Potions Trade and Adoptions Trade igm rules.

  With 10 visits/day maximum and 7 purchases/visit, you get the
  usage factor of 70 for the maximum # of purchases that one can
  make each day.
  =====================================================================


  Gem Trader v2.40 Beta Configuration Process:
  ======================================
  1) Run GEMTRADE Config.  Follow on-screen instructions.

  -- Max Visits per Day.  Range is 1-10, default is 5.
     07/19/05: Increased from 8 to 10, for max visits allowed each day.

  -- Potions Purchases per Day.  Range is 1-8000, default is 2000.

  -- Sysop's Lord name - Needed by code governing displaying
     the List Potions Trader screen during IGM exit.

  -- Max Adoptions per Day.  Adoptions are allowed UNTIL the player
     has 16,000 or more Kids. After that, NO adoptions are allowed.
     Old limit was 4,000.  Changed to 16,000 on 06/20/2005.

  -- Adoptions per Purchase Limit.  The IGM allows users to make
     up to 750 adoptions per purchase, as of 08/31/05.

  -- Fairies/Day Limit.  Limited to maximum of 12. 08/31/05.

  -- Horses/Day Limit.  Limited to maximum of 12. 08/31/05.

  Based upon feedback from Daryl Stout, I have changed the IGM
  to use 750 for max adoptions/purchase, and 5,000 for max
  adoptions per day.  Both changes are effective on 08/31/2005.

  -- Unless you re-install the game, you have to manually update
     3rdparty.dat to the current IGM version data.  Which is now:

            The Gem Trader v2.40 Beta

     If you have not been using version data, then the changes in
     beta numbers is not something you need to deal with in 3rdparty.dat.

  ** I do all of my IGM testing using LORD v4.07 beta.  As much as possible,
  I keep up with the new compilations released via email request by Michael
  Preslar.  All of my personal IGM development since July 2004
  has been done under Microsoft Windows XP, using Borland Pascal
  v7.01.

  If you have more than one LORD game, be sure to double-check values
  in GEMTRADE.DAT so that you know which game you are installing the
  IGM into.
  ====================================================================


                    Some Notes from Version 2.20:
  * Player who enters IGM unable to purchase anything gets 1 Temporary
    Hitpoint.
  * Charm points granted for overpayment of Gems in Horse/Fairy purchase
    are now counted against the daily potions purchase limit.
  * Potion Traders Listing screen will now only be visible upon IGM exit,
    if current player is the end-user/sysop.
  * Player Stats screen and Stats Summary screen were revised.
  * Activated IGM's CONFIG process so that end-user/sysop can enter
    Max Visits per Day, Max Potions Limit, and Sysop Lord Name values.
    Added Kids/Day Limit value configuration in June 2003.

    The same values are to be entered when using GEMTRADE INSTALL.
    In regards to the Sysop Lord name field, please do NOT use LORD
    color codes.  And the field length limit is 20 spaces.

    Version 2.20's Gemtrade.dat now has 8 lines of data.
  -------------------------------------------------------------------

  Standard update from v2.10.  Unzip gemtr220.zip in the IGM directory,
  overwriting all existing IGM files.  Run GEMTRADE CONFIG and
  follow the Config Update directions listed earlier in this file.

  To view the Report on IGM usage, type GEMTRADE REPORT at DOS prompt.
  The file is automatically updated after each usage of the IGM by
  the sysop/end-user.  If you don't have a Gemdrink.dat database file,
  the IGM usage report will not be generated.  The database file
  is reset at the start of each new day's LORD usage.
  =========================================

  Usage of v2.20's Adoptions service costs 44 Gems per child, which
  includes the 4-Gems fee for seeing Peddler Jack's Special Deals.
  ===============================================================


         Special Deals Section Notes:

  If you are buying a Fairy, and have reached the Daily Fairy Trade limit,
  then Peddler Jack gives you a 50% refund of 12 Gems.  And you get a
  few Skill Use Points for your current Skills Class.  Otherwise, there
  normally are no refunds given when you pay Extra Gems, or buy something
  (Horse, Fairy) that you already have.  A small amount of Charm points
  is granted player in return for Extra Gems.

  Cheating is quickly punished, and you are immediately kicked out of the IGM.

  Buying a Horse when you have one, or buying Fairy when you have one, is
  classified as STUPID.  You either get a painful bite in the rear end,
  or a lightning bolt through your waist, as a result.  And you are
  sent away afterwards, as Jack doesn't take advantage of idiots.

  As of Apr. 15, 2005, the Special Deals access fee is now 5 Gems.  You
  can only use Special Deals if you have enough to make a Horse purchase.
  So if you have less than 20 Gems, you are denied access.  Once inside
  Special Deals, you are only shown those deals you can afford to buy.

  E.g. If you don't have 25 Gems left, you can't buy the Fairy. And that
  option is not shown on-screen.  IGM does not allow player to choose
  an option that they don't have permission to use, incidentally.

  Adoptions cost 40 Gems per child. So if player does not have 40 Gems,
  they can't do an adoption, and the Adoption Service is off-limits.

  Currently, you can only make ONE purchase per trip to the Special
  Deals menu.  I'll work on allowing multiple adoptions at a later time
  during this IGM development cycle.
  ================================================================


                                 Misc. Notes:

  Requesting zero Potions.  It will get you out of a trade, if you
  suddenly change your mind.  But it constitutes wasting Jack's time,
  so he sends you on your way afterwards.

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


  Upcoming IGM work, for current development period:

  ------------------------------ No timetable ----------------------------
  1) Random Event, where player exits IGM, riding a Milk Cow
     instead of a Horse.

  2) Sale of Bridles, Apples, Feed Bags (Oats and Honey)
     for owners of a Horse.

==========================================================================
  Sexy Samantha Notes:  Any work on Sexy Samantha character interaction
      with players is going to be done in the Kiteria's Lord Bank IGM.
      But there may be some in this IGM eventually as well.

      Info screen on "Sexy Samantha" was added to v2.00 at the
      ending of the Fairy Purchase.  It is shown randomly on 50/50
      basis - when player pays Extra Gems for Fairy.

      The LADY Script version of Gem Fairy Trade was updated in 2004
      to randomly execute the script's Samantha story event.  It does
      not do a lot, but the player does get a small reward.

      Once updates to the IGM's Special Deals section work properly in
      the IGM, they will be coded into the Gem Trader LADY Script, if
      it is possible to do so.  The script may always have different
      Gem prices for the services it offers.  I don't plan on making
      everything the IGM does work similarly in the script, and vice-versa.
      ==============================================================


      Summary of the basic idea of "Sexy Samantha":
      ---------------------------------------------
  Basically she is a knock-dead gorgeous young woman who is always
  either wanting to gossip about men with the lady warriors, or she
  wants to jump the male warriors, and have her way with them.  Yes,
  Samantha is quite a handful.  Consider yourself VERY Lucky if you
  meet her and survive to talk about it.  Some of her victims, they
  say were so weakened that they became easy prey for the Red Dragon.
  (And some did NOT get resurrected the next day.)

  Currently, she spends her time managing her bank.  Drop by it
  and enjoy her company.  Benefits: 1: No one is allowed to rob this bank.
  2) When you kill the dragon, your IGM Bank stats are NOT affected,
  as they are in LORD itself.  And 3: You get to enjoy another quality IGM.

      http://www.fidotel.com/public/camelot/LordApps/klbank13.zip
      Primary download link for Kiteria's Lord Bank v1.30.

      -----------------------------------------------------------
      K. L. Bank Player Editor v1.00 - Released 08-31-2005.
      http://www.fidotel.com/public/camelot/LordApps/kbedit10.zip

      - You must be using v1.30 IGM of the IGM in order to use the
      player editor program, and you have to have a bankplay.dat file.
  ===================================================================


3.0  FILES:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
The following files are included within THE GEM TRADER archive:

FILE_ID.DIZ  - Description file (GemTrade.diz)
GEMTRADE.DIZ - backup copy of archive identifier for BBS usage.
GEMTRADE EXE - The Gem Trader IGM.  Setup is included inside.
GEMTRADE TXT - Gem Trader docs - this file.
GEMTHIST.TXT - Gem Trader History file.  And Upcoming updates file.

JACKEDIT.EXE - IGM's player database editor utility.

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

* GEMTRADE.DAT - Created by IGM when it is installed.  Stores sysop
                 name, BBS name, and LORD directory path.

* JACKTIME.DAT - v2.10: - 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.

* GEMDRINK.DAT - v2.10: - Binary player database. Tracks all activity
                 inside IGM by every player, and will be used to
                 control whether player can buy more potions, once
                 they reach the established Daily Potions purchase
                 limit.

* JACK-USE.TXT - v2.20 - Disk file listing content of GemDrink.dat.
                 Created automatically when IGM is used by sysop or
                 the end-user.  Created when GEMTRADE REPORT command
                 is entered from DOS Prompt.  Req'd: Gemdrink.dat file.

* JACKEDIT.CFG - Created when JACKEDIT.EXE is first used.
               Config file contains path to IGM database file.

To do list: Add third usage report, which will cover any IGM
stats that the first two reports don't cover.
====================================================================


4.0  INSTALLATION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
    While the IGM is in beta development, the most current version of
    this IGM will be posted once a week, usually, on my web-site:

    http://www.fidotel.com/public/camelot/IGM-Beta/gemtwork.zip

    The beta version should be used INSTEAD of version 2.20. 03/23/05 Note.
    ==============================================================

    1. Unzip GEMTR220.zip into a LORD sub-directory, or into main
       LORD directory.  As long as no other IGM uses GEMTRADE.* name,
       it will co-exist with other LORD IGMs without any problem.
       The Docs files can be renamed, if needed, if there is any
       file-name conflict.

         http://www.fidotel.com/public/camelot/lordapps/gemtr220.zip

    2. From DOS Prompt, type:  GEMTRADE 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 Gem Trader v2.0x from
       in the Other Places Menu screen.

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

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


IGM Updates:
    To update your Gem Trader installation, do the following.  Assumes
    that you are already using version 2.10, or version 2.20.

    1. Obtain version 2.20 from me, or from my web-site.
       You should be using the GemtWork.zip file, or GEMTR220.ZIP,
       whichever is the more recent program.

    2. Copy GEMTR220.zip to the directory where you have Gem Trader
       currently installed.  IGM is designed to be run from its own
       directory, or from directory containing other IGMs -- as long
       as they don't use any filenames used by GEM TRADER.

    3. Using PKUNZIP, WINZIP, etc, unzip files from Gemtwork.zip,
       overwriting old files with what is in the archive.

       If using PKZIP for DOS, use command:  Pkunzip -n Gemtwork
       That unzips only the files that are NEW from the archive.

    4. From DOS Prompt, type:  GEMTRADE 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, Max Potions Purchases per Day, Sysop's
       Lord Name, and Max Adoptions per Day.

    5. Manually edit 3rdparty.dat to list the IGM as being v2.20.

    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

Archive is also available from the NightFall Games LORD server site
at http://www.nightfallgames.com/files/ in its Scripts section.

The site is updated about twice a month usually with new betas
of my LORD IGMs and Utilities.  Occasionally, updates are 1-2
times a month.
==============================================================


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\IGMS\GEMTRADE.EXE /N* /GC:\INTERNET\LORD
THE GEM TRADER v2.40 Beta

The actual description entry in 3rdparty.dat will contain
LORD color codes.  They can be changed to your own preference.


----------------------------------------------------------------------
Note:  While using this IGM, you may NOT rename any of these files:
       GEMTRADE.DAT, JACKTIME.DAT, GEMDRINK.DAT, and GEMTRADE.EXE.

       Renaming JACK-USE.TXT will not hurt anything, but should not
       be done except to make backups of the usage reports file.

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

  LordMenu information:  To acquire LordMenu v1.30 LORD utility, contact
  me via Email.  Or contact Lloyd Hannesson at dasme@dasme.org.

  Program may be downloaded via web browser from my Camelot
  LordNews FDN web-site:
       http://www.filegate.net/camelot/lordfile/lrdmnu13.zip

  It is also available from various other sources on the Internet.

  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, as currently
     written.  NONE of my IGMs will EVER change your LORD registration
     status.
--------------------------------------------------------------------


TESTING:
    LORD Lady Scripts, Gemtrade.ldy and GemFairy.ldy, which this IGM
    is based upon, are usable only with LORD 4.05pb, 4.06, or 4.07.
    GemFairy.ldy is only usable under LORD 4.07 beta.

    The Gem Trader 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.

Primary Testing:  Done under Microsoft Windows XP SP1 and SP2.
================================================================


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
   Revamped Trentsoft LORD IGMs Page

   #1 is for the official releases of my LORD IGMs.  Links
   for the BETA programs are always available from my site's
   LORD Links Page or the LORD IGMs Page.

2. People can also download LORD IGM programs from the LORD
   IGMs Page on my Kiteria's Korner web-site -- but they should
   be aware those hyperlinks may not always be accurate.  The
   web-page is updated approximately once a month.

   http://www.fidotel.com/public/kiteria/kit-IGMs.htm

   Normal update status: Web-page is updated each time I release
   a new LORD IGM, a new version of the DGT-LADY.ZIP scripts
   collection, or when I release new LORD programs for others.

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

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

   To reach me using Fidonet Mail, send all mail to one of these
   three Echoes:  NetMail, LORD, or Door_Games (Ruth Argust's echo).
   Preferably, use the LORD echo, unless you wish to report something
   in private.  In that case, use NetMail or send me an E-Mail message.

   I generally check Fidonet mail about two times a month.

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. The Fidotel BBS's LORD Archives files area has copies of all of
   my officially released IGM/utility Lord programs, and is updated
   periodically with the current beta archives.  You have to be a
   member of the BBS to access those files.  http://www.fidotel.com/.

7. Lloyd Hannesson's web-site's Lord IGMs Listing contains the most
   current release of all currently known, and available, LORD IGMs,
   along with Lord utilities released by him and me.

   http://www.dasme.org/techn/lord1IGM.php - LORD IGM List Project.

   Be advised that PHP-based web-sites do not work well with older
   web browsers, such as Netscape v4.xx.

   ---------------------------------------------------------------
There are several MIRROR sites online which contain all of the LORD files
I have placed in distribution in Fidonet via my Camelot LordNews FDN site.
======================================================================


6.0  FEATURES:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
    User may do the following in Gem Trader IGM.
    -- Purchase Max Hitpoints potions.
    -- Purchase Strength points potions.
    -- Purchase Defense points potions.
    -- Purchase Charm points potions.

    -- In Special Deals Menu, you may do these Gems Trades:
         Purchase Horse.  Purchase Fairy.  Adopt Children.

         Adoption Limits: You may only trade for up to 250 orphans
         per trading session, as of 07/05/05.  Total adoptions/Day
         are subject to the sysop-configurable Kids/Day Limit, which
         has max value of 8,000 adoptions per day as of 07/27/05.

    --  View current LORD stats upon IGM exit.
    -- Some stats are displayed in Summary screen after each purchase.

    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.

Limitations:
  1.  If you cheat, you are thrown out of the IGM.

  2.  During each IGM visit, you are limited to SIX purchases.

      Why 6? IGM got unstable during 2004 development whenever
      a higher # of purchases was tested.

  3.  Per day, you are limited to between 1 and 8 visits, depending
      on what the sysop/user chooses for Max Visits variable. (v2.10)

  4.  Potions purchase per day is limited to 8,000.

  5.  Adoptions are allowed until player goes over 8,000 Kids.
      Player must have 45+ gems to do any adoptions.

      Up to 250 children may be bought per trading session.
      Up to 8,000 children may be obtained each day.
      The Kids/Day adoption setting is sysop-configurable.

      Once players reach the Kids/Day limit, they are not
      allowed to do any more adoptions until the next day.

  6.  Players are limited to maximum of 5 Fairy trades per day.
      Limit is hard-coded into the IGM.

Archive/Program Version Info:
   The IGM's first public release was v2.00.  My LADY Script files
   for Gem Trader already use the v1.xx numbering system.

   * v2.10 - Official release.  May 06, 2003.
   * v2.20 - Official release.  Nov. 10, 2003.
=======================================================


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

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. Gordon
                  died in early July 2005.  He will be missed by many
                  people who were his friends.

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.

Stephen Gibbs    - For pointing out defects in v2.00 one day after
                   it was released.  Sometimes one needs a fresh eye
                   to spot things <G>.  Thanks Stephen for the help.

Kenneth Padgett  - For letting me take care of his Hiding in the Shadows IGM.

Chris Ciesiensky - For letting me take care of his Turgeon's House 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:  Michael Everett, Paul Koukos, Joe Kinjin, Marty Blankenship,
               Russell Tiedt, Daryl Stout, and others.
==================================================================


8.0  DEDICATIONS:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
As with the ChasWare LORD Player Editor utility, this LORD program is
also dedicated to long-time friends Suzanne Franklin and Bryan Turner.

And it is dedicated to each beta tester, and especially to Charlie
Wardick, for teaching me how to use ANGEL Toolkit to create this IGM;
and to Jimmy Rose, for his assistance with understanding how his
A.N.G.E.L. toolkit works.

JACKEDIT.EXE: Is dedicated to memory of Christopher Reeve who died
in early 2005.  When people think of Superman, they should always remember
the man who truly was one in his battle to recover from paralysis.
==================================================================


9.0  RELEASE INFO:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
   The LORD LADY Scripts:
** Released v1.00 of Gemtrade.ldy on March 31, 2002.
** v1.01 - Player selects number of potions they want. April 02, 2002.
** v1.03 - Repeat purchase of Max Hitpoints potions.   April 23, 2002.
** v1.04 - Repeat purchase of Strength potions.
** v1.05 - Repeat purchase of Defense potions.
** v1.06 - Multiple, repeat Potions purchases.
** v1.07 - Rewrote Punishment code for cheaters.
** v1.08 - Special Deals section - purchase of Horse.  July 02, 2002.
** v1.10 - Special Deals: purchase of Fairy.           July 26, 2002.
** v1.11 - Overpayment of Gems for Horse/Fairy grants player
           small repayment in Charm Points.
** v1.12 - Moved Fairy purchase handling into separate
           LADY Script file: GemFairy.ldy.             August 24, 2002.
** v1.13 - Added code to ensure that scripts didn't allow players'
           Max Hitpoints, Strength, or Defense stats to exceed the
           LORD 32,000 point limit, or to go negative.
** v1.14 - Added support for purchase of Charm Points.  Nov. 16, 2002.
** v1.15 - Replaced free Max Hitpoint award for players with 0-2 gems,
           with a free Temporary Hitpoint.      March 19, 2003.
** v1.16 - Current version, as of November 2003.  Has comment links for
           the IGM version 2.10 and 2.20 programs. (11/10/03 revision)

** v1.18 - Added support to script for Adoptions.  December 2003.
** v1.20 - December 2003 - February 2005. No major script code changes.

** v1.22 - Mid-February 2005. Full rewrite of IGM portions covering
           processing of multiple Elixir potions purchases was required
           due to problem in 2004 compilations of LORD v4.07 beta that
           caused the affected LORD stat to drop to Zero.  Max HPs rewrite.
** v1.24 - Strength code rewrite and testing.
** v1.26 - Defense code rewrite and testing.
** V1.28 - Charm code rewrite and testing.
** v1.30 - Added short encounter with Samantha to script, which runs randomly.
           She grants Free healing to those who need it.  Was done as a
           Valentine's Day 2005 present to my LORD friends.

** v1.35 - Gemtrade.ldy was fixed by Michael Preslar to take care
           of LADY script language bug that was causing LORD v4.07 beta
           to crash when someone tried to do an Elixir potions trade.

** v1.40 - Script now allows multiple adoptions. Limits each trade
           session to a maximum of 99 adoptions.  05/11/2005.

           07/24/05: Added Install/Uninstall code to Gemtrade.ldy
           for use with new LADY events.dat file in LORD 4.07 beta.

---------- Current status of the Gem Trader LADY Scripts, September 2005:
    ** Gem Fairy Trade script is version 1.08.
    ** Gem Trader script is version 1.40.

    ** The DGT-Lady script archive is version 1.60.
==================================================================


   The LORD IGM Version:

** The Gem Trader v2.00 was officially released on March 17, 2003.
** Version 2.10 was officially released on May 09, 2003.
** Version 2.20 was officially released on Nov. 10, 2003.

There is not an 32-bit version of Gem Trader in development.  One
will be worked on after I release the next official version update
of this IGM.
===================================================================


10.0:   { Castle Camelot LORD Apps Summary: }

See:  http://www.fidotel.com/public/camelot/ccl-apps.txt

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

  Belgarion's LORD Lady Scripts. Scripts by Donald Tidmore,
      Gordon Lewicky, Michael Everett and Dan Stovall.

  ChasWare LORD Player Editor (LPEdit).  September 2005 beta.

  LPEDIT/32 for Lord/32.  September 2005 beta.

  Doofus the Gnome - In-progress LORD IGM.  September 2005 beta.
  -- IGM Version of Gordon Lewicky's LADY Script.

  The Forest Outhouse.  Update of Robert Fogt's Outhouse IGM.
  --- The Forest Outhouse RHP Pack.

  FreeWorld II Lord/32 IGM. Created by Chris Martino. Adopted
  by me 08-09-2005 following his disappearance in May 2005.
  Status: September 2005 beta.

  The Gateway.  Maintained for Jason Brown.

  The Gem Trader.  My first IGM.  September 2005 beta.

  Hiding In The Shadows.  Adopted from Kenneth Padgett.

  Kiteria's LORD Bank.

  The L.O.R.D. Cavern.  Maintained for Jason Brown.
  -- LORD Cavern RHP Sets #1, #2, and #3. Contains RHP scripts
     created by Jason Brown, Michael Everett, and Donald Tidmore.

  LordStat. Maintained for Jason Brown.  September 2005 beta.

  Love Shack II.  September 2005 beta.  My first tribute IGM,
    dedicated to Trevor Herndon.

  The Nice Hag.  My second IGM.

  The Outlands Tavern. Maintained for Jason Brown.
  --- The Outlands Tavern RHP Pack.  Contains RHP Scripts by myself
      and Gary Hartzell.

  The Pawn Shop. Maintained for Chris MacPherson.  September 2005 beta.

  RHP Toolkit. RHPTest and LordType utilities, by Jason Brown.

  The Ruined Castle.  My third IGM. Based on Dan Stovall's LADY script.

  Turgeon's House.  Adopted from Mike Ciesiensky.

  Violet's Cottage II. My second tribute IGM.  September 2005 beta.

  Werewolf II.  My third IGM recreation. September 2005 beta.
  -----------------------------------------------------------

  Notes: I also updated the LORD Gambling Casino IGM, created by Tobin
  Fricke.  It was turned over in June 2004 to Chris Martino (www.oddware.org)
  for him to continue support and development of it.

  Chris Martino disappeared in late May 2005.  I have resumed
  authorship of my IGMs, Lord Gambling Casino and Realm of Lore,
  as of mid-August 2005.

  ======================================================================
  Upcoming new IGMs:  I will eventually start recreation process  which
  for remake of David Simmons' IGM, Shauna, Princess of Sorcery.

  ------------------------------------------------------------------------
  Upcoming IGMs work - Rewrites to use ANGEL or MannDoor Toolkits:

  1) Turgeon's House/32
     For use ONLY under LORD/32 Beta.  MannDoor tool-kit.

  2) Hiding in the Shadows/32
     For use ONLY under LORD/32 Beta.  MannDoor tool-kit.

  3) The Gateway, LORD Cavern, Forest Outhouse, and The Outlands Tavern:
     All four will be converted to either ANGEL or MannDoor tool-kits. No
     immediate time-table.  I'm finishing up their current development cycle
     currently.  RHPTest will be updated to indirectly include revised
     toolkit code, required by the four IGMs it is used with.

  4) LordStat. Is being updated to create HTML bulletins of its LORD bulletin
     files, with initial work handled by Jason Brown.

  5) ChasWare LPEdit 32-bit.  For safety, the DOS version of
     LPEDIT should NEVER be used with LORD/32 Beta or LORD/X Beta.
     A 32-bit version is being developed by me, as of July 2005.

  6) Summer/Fall 2005: Lord/32 versions of my IGMs will be worked
     on, once I have familiarized myself with how to write them
     using either modified ANGEL code, or the MannDoor Toolkit.


  No tool-kit rewrite necessary:
  =========================================
  7) LordType: Will not need any further updates for indefinite period.  Program
     is compatible with LORD/32 beta, since it is designed to display text
     files that have LORD color codes in them.
========================================================================


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


                                 DEDICATION:
                     ====================================
Version 2.00 was dedicated to Bryan Turner and Suzanne Franklin.

Versions 2.10 and 2.20 are dedicated to Bryan Turner, Suzanne Franklin,
    Charlie Wardick, and Michael Everett.

Work on current IGM beta is also dedicated to those four friends. 03/23/05.
======================================================================


                       { IGM/Utility Support Notice: }

  Linux-based versions of my IGMs are not contemplated in the immediate
  future.  I do not know Linux, and do not intend to try learning it.

  As of late March 2005, LORD/32 for Windows BETA is in BBS testing. It is
  also available via email request from him.

  Check with Michael Preslar for further details via his web-site at
  http://www.michaelpreslar.com/.  LORD/X for Linux Beta is also in
  BBS Testing.  Lord for Linux does NOT support IGMs yet. Contact him
  via email using mike@lordlegacy.com email address.

  I will be working on 32-bit versions of my LORD programs later in 2005,
  as I progress in learning how to use Virtual Pascal.  I'm also
  eventually going to learn to use Borland Delphi 6.
==========================================================================


IGM Crashes:  If you experience a crash while using the IGM, please
send me a capture log of your BBS session which most comm programs
and Telnet clients are able to generate.  Zip it up in an archive
using Winzip, PKzip or some other ZIP-compatible utility, and send
it to me at ktidmore@bellsouth.net (or gtidmore@hiwaay.net).

Also include copy of the IGM's data files such as Tradelst.dat and
Gemdrink.dat.  Copies of the LORD game's play*.dat files, if included,
will help with analyzing what caused your IGM crash.
==========================================================================


Question: Will there be any other tribute IGMs?

Answers: Possibly.  None will be done for any other IGMs made
by Trevor Herndon.  I either don't have the ability to play
every event in an IGM, or the IGM is one I have very little
knowledge of, or interest in reproducing.

As for other recreations of Jay Hodges' IGMs, this is the
only IGM he did (Werewolf) that I know enough about to attempt
recreating.

Otherwise, I will work on recreating Shauna, Princess of
Sorcery, which was made by another LORD programmer friend,
David Simmons, who also lost his source code over the years.
That will be done sometime in Fall 2005.

---------------- 08/19/05 note: -------------------------------
The only other IGMs work planned for remainder of year is
that I have resumed authorship of Realm of Lore and Lord Gambling
Casino igms, and I will be working on them later in 2005.

I don't know when I will be able to work on Lord/32 igms.  I mainly
have to wait until Jay Hodges has time to assist me with the process.

As of Aug. 09, 2005, I am supporting Free World II for Lord/32 which
was a project started by Chris Martino.  I have its source code
so I am able to provide support for it following his disappearance
in late May 2005.

--------------------------------------------------------------
Note: If you are interested in recreating IGMs yourself, there
are several out there that you can get permission to develop.
Such as the other IGMs by Trevor Herndon and Jay Hodges, to name
two LORD authors who lost their source code over the past decade
or two.
===============================================================


The Gem Trader, LADY Script versions and IGM versions, is
copyright 2002-2005 by Donald Glenn Tidmore.

Gemtrade.txt -- End of documentation.

Revised on:  September 16, 2005 at 06:07 am.

