              -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
                   LORD IGM: THE GEM TRADER   **FREEWARE**
                 VERSION 2.00 -- DOCUMENTATION -- March 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.geocities.com/donaldtidmore/camelot5.html (Inactive)
         (Backup site. Updated once a month 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.

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-2003) 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 (early
September 2002 compilation).  It MAY be usable under LORD for Linux,
betas #1 and #2, but I have no way to confirm that.  So support is
only guaranteed for DOS LORD, as of March 2003.
============================================================

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 program, which is comprised of two LORD LADY Scripts:
  GemTrade.ldy and GemFairy.ldy.  GemFairy is the part that can only
  be used with LORD v4.07, due to 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:
  The IGM uses a simple 3 Gems=2 potions exchange rate.  In LORD, you pay
  two Gems to get one potion.  With Jack, you get a slightly better deal.

  You may buy up to 2,500 potions at a time, and are allowed to make up to
  8 purchases per visit.  Version 2.00 allows repeat visits each day.
  ----------------------------

         Special Deals Section Notes:
  There are NO refunds given when buying a Horse or Fairy, if you already
  have one, or give Jack extra Gems.  You do get a small number of Charm
  points for Extra Gems in the Special Deals section.  Cheating is quickly
  punished, and you are immediately kicked out of the IGM afterwards.

  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.

  To access Special Deals Menu, you must be able to (a) pay a 4-gems
  admission fee and (b) have enough gems to buy a Horse.  Fairy option
  is only made available if you have enough gems to buy one.
     To get a Horse, you must have 20 Gems.
     To get a Fairy, you must have 36 Gems.
  ----------------------------

         Next Version Info:
  Later versions will (a) limit daily Gems for Potions trading, to
  control possible abuse of the IGM, and (b) limit per-day visits.
  Most likely the limit will be 3-4 visits per day.   The Special
  Deals menu will offer Children for adoption, but only if you are
  below 200 Kids level.  Other work plan is to write story of Jack's
  daughter Samantha, and have it run randomly as you are exiting
  the IGM, most likely.  Details haven't been worked out on that.
      Info screen on "Sexy Samantha" has been added to v2.00 at the
  ending of the Fairy Purchase.
  =======================

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

  Preview of "coming attractions":
  Jack will tell you about his daughter Samantha.  You'll get to meet
  her sometime this year, both in the IGM, and in the GemFairy.Ldy
  LADY script.  Possibly inside GemTrade.Ldy's handling code for the
  Horse Trade as well.  Details not decided upon yet.

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

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.

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

4.0  INSTALLATION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
    1. Unzip Gemtr200.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.
    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.00 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 LORD game.
    2. Delete the gem*.* files unless you think you may want to keep
       them around.  That concludes IGM removal process.
=========================================================

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

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

C:\INTERNET\LORD\IGMS\GEMTRADE.EXE /N* /GC:\INTERNET\LORD
THE GEM TRADER v2.00

---------------------------------------------
Note: You may NOT rename Gemtrade.dat or GEMTRADE.EXE. Doing so will
      cause the program to not work correctly.  No support is promised
      to people who can't follow simple directions.
======================================================================

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, as currently
     written.  However Fairy and Horse purchase may be made contingent
     on whether the user's LORD game is registered or not, in the
     future.
------------------------------

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.

    GemTrade.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:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Updates/bug fixes and the like for THE GEM TRADER can be found at
the following:

1. http://www.fidotel.com/public/camelot/camelot6.htm
   http://www.geocities.com/donaldtidmore/camelot6.html (Backup site)
   Castle Camelot LORD IGMs Page.

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

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

4. http://www.geocities.com/SiliconValley/Vista/5389/

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.51 which is in progress for Chris MacPherson.
======================================================================


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.
    ---- Purchase a Horse.   ---- Purchase a Fairy.
    --  View current LORD stats upon IGM exit.

    Note: Stats screen gives accurate reporting of Skill points and
    Skill use points when they exceed 40, unlike LORD itself.

Archive/Program Version Info:
   The IGM's first public release is v2.00.  My LADY Script files
   for Gem Trader already use 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,
               Joe Kinjin, Charlie Wardick, Jacques Shake.
               And a few others here and there.
==================================================================


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

9.0  RELEASE INFO:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
The Gem Trader v2.00 was officially released on March 17, 2003.


10.0  MY OTHER LORD Apps:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
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.41.
    http://www.fidotel.com/public/camelot/Scripts/dgt-lady.zip

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

I am the official maintainer of Jason Brown's LORD programs, which
are listed below - along with any beta versions that are in progress
at this time, as of March 13, 2003:

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

CAVE15A.ZIP   - The L.O.R.D. Cavern v1.5A. LORD IGM by Jason Brown.
    http://www.fidotel.com/public/camelot/IGM-Beta/cavework.zip
    In final processing. - BETA - (NOT RELEASED YET)

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

Adopted from Robert Fogt:
OUTH200.ZIP - The Forest Outhouse v2.00 LORD IGM.
    In final processing for v2.00. - BETA - (NOT RELEASED YET)
    http://www.fidotel.com/public/camelot/IGM-Beta/oh2-work.zip
--------------------

Updated for Chris MacPherson:
PAWN251.ZIP - The Pawn Shop v2.51 - BETA -  Still in development.
    http://www.fidotel.com/public/camelot/IGM-Beta/pawnwork.zip
--------------------------------------------------------------------

    If you wish to try out anything marked as BETA, you are expected
    to let me know that you are running the program, and provide
    feedback on how the program works.
===================================================================

11.0  UPCOMING LORD Projects:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
** Forest Outhouse v2.10 - Will contain new feature that lets you
   gain various stat increases after reading a parchment scroll,
   including a Skill Point, if you are lucky.  Will also implement
   RHP Script Language, so that IGM will run any random .RHP script
   IGMs that are developed for it.

** Gem Trader v2.10 - Will cover per-day usage limitation;  Adoption
   of Children for Gems;  and Sexy Samantha side-story IGM component.

** LPEdit v1.10 - Enforcement of LORD's policy where you can't marry
   someone unless you have 100/125 Charm points.  Conversion away
   from pop-up dialog box windows so that utility can be used as a
   door possibly over a dial-up modem connection.

** The Nice Hag v2.00 - LORD IGM adaptation of the LADY Script.

** Outlands Tavern v1.5 - Will cover three features/issues.
   Will fix things so that if a sleeping player is attacked, no
   one else may enter IGM on separate node and try attacking the
   same person.  Similar issue with killing prisoners in dungeon
   will be addressed.  Food/Drink sales will be re-implemented.

** RHP Toolkit v1.3 - introduce support for RHP Scripts to be used by
   the next version of my Forest Outhouse IGM.  RHPTest is used to
   debug/test RHP Scripts.  No changes planned for LordType program.

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

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
  
Gemtrade.txt -- End of documentation.  03/17/2003.

