-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
LORD IGM: THE PAWN SHOP   **FREEWARE**
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
VERSION 3.10 --  DOCUMENTATION    { December 30, 2003 }

AUTHOR:  Chris MacPherson
Email:   chris@macphersons.ca
Web:     http://macphersons.ca/chris/
         http://macphersons.ca/chris/files/pawnshop/
ICQ #:   20104440 (Reavus)

Updaters: Donald Tidmore - Email: donald.tidmore@fidotel.com,
          donald.tidmore@usa.net, or ktidmore@bellsouth.net

          ICQ #:    238685196 (Belgarion) {Used occasionally}
          Web:  http://www.fidotel.com/public/camelot/camelot5.htm
          ----------------------------------------
          Charlie Wardick - Email: chasware@cox.net
          Web:  http://www.jimmyrose.com/chasware/

    URL:  http://www.fidotel.com/public/camelot/Lordapps/pawn310.zip
          http://www.filegate.net/camelot/lordfile/pawn310.zip
======================================================================

TABLE OF CONTENTS
1.0  DISCLAIMER
2.0  INTRODUCTION
3.0  FILES
4.0  INSTALLATION
5.0  DISTRIBUTION/UPDATES/REVIEWS
6.0  BUGS/TROUBLESHOOTING
7.0  FEATURES
8.0  SPECIAL THANKS
9.0  DEDICATIONS
10.0 FURTHER INFORMATION


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
1.0  DISCLAIMER:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

THE ONLY THING I PROMISE WITH THIS PROGRAM IS THAT IT WILL OCCUPY
SPACE ON YOUR HARD DRIVE.  NO WARRANTY IS HEREBY EXPRESSED, IMPLIED,
OR SUGGESTED.  USE OF THIS PROGRAM IS AT YOUR OWN RISK.

THE PAWN SHOP IS A *FREEWARE* 'IN GAME MODULE' (IGM) FOR
LEGEND OF THE RED DRAGON (LORD).  THE PAWN SHOP WILL BE DISPLAYED
AS BEING UNREGISTERED IF LORD IS NOT REGISTERED.  MORE INCENTIVE FOR
SYSOPS TO REGISTER.

TAKE NOTE:

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

There, that's out of the way, enjoy! :)



-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
2.0  INTRODUCTION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

    Congratulations on grabbing a copy of THE PAWN SHOP!  I've made this
  IGM in hopes that it will complement LORD and add to its fun, not give
  players unfair advantages, or extreme rewards (like so many other IGMs
  unfortunately do).

    THE PAWN SHOP has many features common to several IGMs currently out
  there but offers many new choices and options in addition.  First of all,
  THE PAWN SHOP is an IGM in which a LORD player may actually own and run.
  In fact, all monetary transactions are kept track of and stored in a vault.
  From this, THE PAWN SHOP decides on whether it can afford to buy weapons,
  armour, gems, etc... from players.  The vault, itself, can be robbed by
  players and should THE PAWN SHOP go bankrupt, the current owner is dropped
  and another may step forward to take his/her place.

    Other features of THE PAWN SHOP are that you can buy all the weapons
  and armour offered in LORD but at 95% of their regular price.  You may
  also trade gems for elixirs but only 1 Gem per Elixir is required.

    There are a few other items offered for sale and you can (if you have
  the gold) buy 'services' from the resident low-life Blackey. :)
  ------------------------------

    Customer may exchange Experience points for either Max Hitpoints,
  Strength, Defense, or Charm.  Rate is based on an variable amount of
  Experience for each elixir potion wanted.  Player may purchase as
  many potions as your Experience points will cover, subject to a 20%
  limit - computed at IGM entry on player's FIRST visit to IGM. Once
  player reaches that trade limit, they may not use Experience Trade
  again until the next day.

  ** The Exp. Trade Rate Limit can be adjusted by the user, but may
  not exceed a 50% rate for Experience Trade. **

    "Naughty" customers get an increased chance of their drinks being
  "Bad Brews".  "Hated" customers aren't allowed to use Wendy or Blackey
  services at all.  Trade Experience feature is available only to Level
  2+ players who have 1,000+ experience points.
  ------------------------------

   Along with the IGM keeping track of potions obtained via Gems Trading
  or Experience Trading, it also tracks potions bought with Gold - such
  as Spartan Warrior - each day.  Once a player has obtained 3,200 potions
  -- or whatever amount the sysop chooses in pslimits.cfg file -- they may
  not do any more Gems/Experience Trading, for potions.  But they can
  continue to buy Potions for Gold, as long as they afford them.  And
  usage of Gems trading for non-potions items is not affected, unless you
  are declared Naughty by Wendy.

  ** This limit can also be adjusted by user, but may not exceed 16,000
  for Potions Traded per day amount.  Default value is 8,000 potions/day.

  Purpose of built-in maximum values is to prevent mis-use of the
  IGM's potions trading limits config file.
  --------------------------------------------------------------------

    So that ownership of shop doesn't give victor of dragon fight an
  unfair advantage over other players - via their ability to withdraw
  Gold and Gems from shop vault, the owner will receive a visit from
  the royal tax agent.  The Dragon Tax is 50% of Gold and Gems invested
  in shop by the owner player.
  ---------------------------------------------------------------------

  Customers may purchase Horse or Fairy provided they have enough Gems,
  and they have remained in good standing with Wendy.
  -----------------------------------------------------

  Gems Fairy Trading:  The IGM limits users to 5 trades per day maximum.
  During IGM setup, you may choose value you prefer, from 1 to 5.  Doing
  exchanges of Horse for Fairy, and vice-versa, does not count against
  this limit. It is only for obtaining Fairies using Gems. Default value
  is 2 Gems Fairy Trades per day.

  Gems Horse Trading:  Not limited.  Did not see a need for this.  But
  since Fairies are used in some Mercenary service purchases, it was
  considered advisable to limit player's ability to keep hiring mercenaries
  for long period of time during the same IGM session.

  Both Gems Fairy Trades and Gems Horse Trades are monitored as players
  use the IGM, and the counters are visible in two reports.  The shop
  owner or their spouse can view the Customers Info Report inside the
  Office. Otherwise, the end-user/sysop can view the Pawn-use.txt file,
  to monitor how the IGM has been used each day.

  PSETUP /REPORT will generate a new Pawn-Use.txt file.  Using the
  enclosed Pawnrept.bat automates this for the user.
  ---------------------------------------------------------------------

  That's about all I'll say, I don't want to spoil the surprise.  All
  this information is available to the players as well should they ask
  the right questions - of Blackey.
======================================================================


Multi-Node Usage Support:
-----------------------------------
Note:  Pawn Shop is designed for use by one player at a time, since
    it does not have multi-node usage support.  When it is in use, the
    Lockfile.dat file prevents any one else from entering the IGM, until
    the current user has left it (or been killed). 10/31/2003 revision.

    Why is there not multi-node support?   I have no real idea about
    how to enable it really, without creating conflict situations. Such
    as possibly having two players attempting to claim shop at same
    time.  How would IGM decide which one got to do the Shop Claim?


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
3.0  FILES:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
The following files are included within THE PAWN SHOP archive:

*PAWNSHOP.EXE - Main IGM executable
*PSETUP.EXE   - Setup/Configuration/Maintenance program
*PAWNSHOP.SCR - Screens and dialog text required for IGM
 CAMROC.INF   - Archive origin info file
 PAWNSHOP.TXT - This file!
 FILE_ID.DIZ  - Description file (PawnShop.diz)
 DESC.SDI     - Description file (PS-Desc.sdi)

 PAWNREPT.BAT - Batch file for updating/displaying IGM usage report.
                Requires 2 things: exptrade.dat file, and Vern Buerg's
                LIST.COM file viewing utility - or something similar.
                * Edit file to your own needs.

NOTE: THE PAWN SHOP will create several *.DAT files during its daily
      execution (ie. BANISH.DAT, BLACKEY.DAT, CLAIM.DAT, FLIRT.DAT,
      HATE.DAT, LOCKFILE.DAT, POISON.DAT, PROTECT.DAT, RESURRECT.DAT,
      ROB.DAT, SMILE.DAT, SUICIDE.DAT, and WENDY.DAT.)

      Created daily, when first player enters the IGM:
      ---------------------------------------------------------------
      EXPTRADE.DAT - Keeps track of each player's potions purchases
      each day via Gems Trade, Experience Trade, or Gold purchase.
      Is deleted when Daily Maintenance runs the first LORD time is
      started on a new day, so that each day lets players start with
      a clean slate.

      PAWN-USE.TXT - Potions Traders Listing, disk file.
      Will be automatically created/updated with each IGM usage, or
      when the sysop (end/user) runs the PSETUP /REPORT command.


      Created each day, during each IGM usage, if applicable:
      -------------------------------------------------------
      POTIONS.DAT - Lists LORD name of the players who have reached a
      daily Potions trade limit during a day.  Is also deleted when
      Daily Maintenance runs at start of each LORD game day.

      NAUGHTY.DAT - Lists LORD name of players who cheated in some
      manner during a Gems Trade or Experience Trade.  Deleted during
      Daily Maintenance at start of each new day.

      Created at IGM Installation, or during Re-configuration:
      ------------------------------------------------
      PSLIMITS.CFG - Stores the values used in Potions Trading limits.
        Entry #1:  Amount of potions player may acquire each day via
        either Gems Trading, potions purchases with Gold, or Experience
        Trades.  Maximum limit is 16,000.  Default setting is 8,000.

        Entry #2: Percentage of Experience points player is entitled to
        trade in each day.  Maximum limit is 50%. Default setting: 20%.

        Entry #3: Number of Fairy trades for Gems player may make each day.
        Maximum limit is 5.  Default setting: 2.

      This file is also recreated when user does an IGM Reset, and is
      updated whenever Configure Limits is used in a PSETUP /C session.


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
3.5  Updating from Version 3.00 to v3.10:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
    * None of the IGM data files are updated, so there is no need to
    delete or replace old data files.
    * Unzip all files from PAWN310.ZIP into your current Pawnshop
    IGM directory, using overwrite mode.

    * Manual update process:
    1. Open 3rdparty.dat file in a text editor - Wordpad will work.
    Change Pawn Shop IGM description line to say: The Pawn Shop v3.10.
    Change Color codes to your own preference if desired.
    2. Save changes to 3rdparty.dat file.  If using LordMenu, re-run
    it and update its data files.  Start playing with new IGM in LORD.

    * Automated update process:
    1) Uninstall version 3.00 or 3.0x beta IGM from LORD, using the
    PSETUP Uninstall IGM process.
    2) Install version 3.10 using PSETUP Install and Configure processes.
    3) If using Lordmenu, update its data files.  (Same thing applies
    to any older IGM manager utilities you may be using.)

    * For either manual or automated updates:
    If you have more than one LORD game that is running The Pawn Shop,
    you will need to repeat the process for each IGM installation.

    PSETUP will show on-screen WHERE it is being run from.  If you
    are in the wrong location, exit PSETUP.  Change to the right LORD
    IGM directory location, and then re-run PSETUP.
    ================================================================

    If you spot any bugs, please report them to me, or to Chris.
    Thanks Donald. 12/30/2003.


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
4.0  INSTALLATION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
I've tried to make THE PAWN SHOP as simple and easy as possible to
setup and install.  Very little has to be done by the sysop to maintain
it as well.

STEP 1: Create a directory for THE PAWN SHOP (preferably from within
        your LORD directory). e.g., C:\LORD\PAWNSHOP

STEP 2: Unzip THE PAWN SHOP archive into the directory and type PSETUP /C.

STEP 3: Press "I" for INSTALL to install THE PAWN SHOP within LORD.
        You will be prompted for your BBS name but that is all.

        The following is a list of what the installation will do:

        1. Create PAWNSHOP.CFG which will contain all the vital information
           THE PAWN SHOP requires to run.  It's a simple sequential file
           so you can use your favorite DOS EDITOR to view/edit it.

           Answer IGM's questions during INSTALL phase, IGM Reset, or
           Configuration process to setup the potions trading limits
           values, which are stored in the PSLIMITS.CFG file.

        2. Adds two lines to your LORD's 3RDPARTY.DAT file:
                C:\LORD\PAWNSHOP\PAWNSHOP.EXE /N* /GC:\LORD\
                `@THE PAWN SHOP `0v3.10

           Default color values are Red (Name) and Light Green (Version).
           Installation process includes the version number, but it can
           be removed from the entry manually if you wish to do so.

           Adjust C:\Lord to match where you have LORD installed.
           ** IMPORTANT:  The /N and /G options MUST be used.  **

        3. Adds a line to your LORD's MAINT.BAT file:
                C:\LORD\PAWNSHOP\PSETUP.EXE /M

           NOTE 1: The maintenance program is REQUIRED in order for
                 THE PAWN SHOP to function properly.

           Note 2: If a maint.bat doesn't exist in your LORD Game,
                 PSETUP will create one.

           Note 3:  make sure maint.bat only runs PSETUP /M ONCE.
              Re-install process sometimes results in dupe entries,
              so it is advisable to visually verify maint.bat content.

        4. The IGM announces itself in LORD's daily log. (LogNow.txt)

           That concludes IGM installation, with one exception.  If you
           use LordMenu, see later note, you have to update the
           3rdalt.txt file so that new IGMs, removed IGMs, or IGMs
           with updated entry lines will be properly usable in LORD.
        ===============================================================

    LORD Versions Compatibility Note:  Pawnshop.exe, the IGM, has
    zero problem working under all versions of LORD that are currently
    known to be still widely in use.  It has been tested thoroughly,
    in the v2.xx beta, under LORD 3.55, 4.00, 4.00a -- each of
    which were patched for RunTime Error 200, v4.02, v4.05pb, v4.06;
    and v4.07 beta's July 2003 compilation.

    Note: As of early November 2003, there had been no progress made
    by Michael Preslar on LORD 4.07 since late July 2003.

    PSETUP.exe, the IGM's setup/configuration/maintenance program,
    has been thoroughly tested, and works as it is intended to do.

    To avoid the Maint.dat LORD Crash situation, you either have to
    be running a post-May 2003 compilation of LORD v4.07 beta, or
    be using one of Seth Robinson's versions of LORD.  If you have
    questions on the issue, contact Michael Preslar using the email
    address mike@lordlegacy.com.

    There are a dozen or more IGMs, including Pawn Shop, which are
    known to work properly on 250+ Mhz systems using Pentium II+ CPUs.
    ==============================================================

    Acquiring LordMenu v1.30 Note:
    ------------------------------
    What is it?  It allows you to play LORD using a 2-column listing
    of installed Lord igms.  If you use more than 24 igms, you NEED it.

    Created by Robert Fogt, then turned over to me in early 2002.
    I transferred its ownership for support/development to Lloyd Hannesson,
    who     recompiled, tested, and publicly released version 1.30 in Spring
    2002.  You may get a copy via email from me or Lloyd, or use the following
    URL in your web browser to obtain a copy.  To reach Lloyd, use
    dasme@dasme.org.  To reach me, Donald, use donald.tidmore@fidotel.com
    or donald.tidmore@usa.net.

    URL link:  http://www.filegate.com/camelot/lordfile/lrdmnu13.zip
    -- Access file via the Camelot LordNews FN.

    Copies are also available from: LordApps directory (LordApps.htm)
    on Castle Camelot web-site;  the NightFall Games LORD Library site
    - http://www.nightfallgames.com/files/;  and the Fidotel BBS's
    web server's LORD Utilities files area - http://www.fidotel.com/.

    See: http://www.fidotel.com/public/camelot/lordapps.htm
    ===============================================================

REQUIREMENTS (minimum):
  1. LORD V3.55 or later versions.
  2. DOS 6.x or later versions.
  3. The Stay Overnight feature, for the player who is the current
     shop owner, is ONLY usable when L.O.R.D. is Registered.

  The Original IGM v1.x was tested under LORD v3.55.

  v2.00 never was executable, due to un-patch-able RTE200 problem.
     Was only tested by myself and Chris MacPherson in November
     and December 2001.

  v2.01 -- v2.90 Betas:  November 2002 - December 2003 work.
     Available to beta tester group, and generally available via
     download to others, who don't mind using beta software, from
     the Castle Camelot web-site.

  v3.00 - Officially released on December 02, 2003.
  =====================================================

  Bug fix work: 12/10/2003 forward.  v3.01+ beta
  =====================================================================

     Tested using LORD v3.55, v4.00, v4.00a, v4.06;  and August 2002 -
     July 2003 compilations of LORD v4.07 beta.

  Testing has been done using Microsoft Windows ME and Windows XP,
  primarily, using current v4.0x versions of Legend of the Red Dragon.
  --------------------------------------------

  LORD for Linux (LORD/X beta #2):  I do not offer, or provide, support
  for any of my LORD programs under Linux O.S. due to lack of knowledge
  and experience using any version of the UNIX operating system.

  LORD for Windows (LORD/32 beta #2):  It does not provide support for
  running IGMs.  No info has been released, as of Oct. 31, 2003 as to
  how to code LORD IGMs/utilities to run under this new LORD game.

  I do not have Windows programming experience, other than in HTML,
  so I am unable to offer support anyway personally for this and my
  other LORD programs under any O.S. other than MS-DOS. {10/31/03 rewrite}
  -----------------------------------------------------------------


  Running Pawn Shop, other LORD igms, under MS Windows XP Note:

  I do not have a solution to the way Win-XP runs some DOS apps in
  a 1/3-sized window.  The user may have to configure the Properties
  of the PSETUP.exe and pawnshop.exe files, under XP, to have them
  run in Full-Screen.

  If anyone reads this, and knows better solution, please write me with
  the directions on how to run DOS apps in a normal size window, especially
  in relation to this and other LORD igm's files. Thanks, Donald, 08-27-2003.



-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
5.0  DISTRIBUTION/UPDATES/REVIEWS:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Updates/bug fixes and the like for THE PAWN SHOP can be found at
the following URLs:  -- When it has been publicly released, that is.

1. http://macphersons.ca/chris/files/pawnshop/

2. http://www.filegate.net/camelot/lordfile/
   Camelot LordNews FDN - Lord Files directory.
   Fidonet #: 1:123/450 - Donald Tidmore, updater.

3. http://www.fidotel.com/public/camelot/camelot6.htm
   http://www.fidotel.com/public/camelot/lordapps.htm
    -- LORD IGMs Page;  LORD Apps Page links.
       Castle Camelot web-site - Donald Tidmore

4. http://www.nightfallgames.com/files/ - See LORD IGMs directory.
   Hosted by Michael Everett, one of the beta testers.
                 (For officially released LORD programs only)

5. ftp://ftp.fidotel.com - Fidotel LORD Archives. - Shannon Talley.
   See Legend_of_the_Red_Dragon/LORD_IGMs directory.
=============================================


Joseph Masters (Joseph.T.Masters@williams.edu) Pawn Shop v1.00 review:
  Realistic Pawn Shop IGM. One of the first IGMs I've ever seen
  that has taken an idea and completely followed through with it!
  Claim the Pawnshop, and you can effortlessly run an affordable
  buy/sell business.  Prices aren't restrictive enough; not recommended
  for LordNet games.

  No current IGM review is available. (Note: As the only person doing
  IGM reviews, I'm biased and can't objectively write a new one.  Especially
  for programs that I've personally created or rebuilt, such as this one.
  However, I think you will enjoy using the improved Pawn Shop.  All shop
  products pricing has been evaluated over nearly a full year.  The new
  version offers enhanced options such as Resurrecting Dead Warriors,
  buying Horses and Fairies, and tracking of IGM use each day by sysops.
  Donald 10/31/03 revision.)


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
6.0  BUGS/TROUBLESHOOTING:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

PROBLEM:  THE PAWN SHOP WILL NOT LOAD!  WHAT DO I DO???

SOLUTION:
I've had a few comments that after installation it will announce itself
in LORD and be listed in 'Other Places' but will not load.  The way to
get THE PAWN SHOP to come up is to change the fossil/internal settings
in the Node Configuration in LORD (ie. LORDCFG.EXE).  You may need to
change to either Regular Fossil or Weird Fossil.  Hope this helps.

After installation make sure that 3rdparty.dat entry contains /N*
/G<lordpath> parameters, or the IGM will not work properly.  Also
make sure entry added to maint.bat is PSETUP.EXE /M.   (Only applicable
to beta versions 2.51+.

(Note: Older v1.xx versions use a "<c:\lord\> PAWNSHOP.EXE * lordpath"
3rdparty.dat entry line setup.  Please REMOVE the old entry, then
INSTALL the v3.10 IGM back into your LORD game(s).
====================================================================


PROBLEM:  When PSETUP.exe /m maintenance is run, my LORD game says
player.dat is corrupted, and Lord terminates.  What do I do?

SOLUTION:  Obtain the current beta, May 10, 2003 or later, of LORD
v4.07 from Michael Preslar's e_maus@covingtononline.com email account.
Use "Send me Lord" (without quotes) in email subject line.

Fix *MAY* not work for everyone.  In local mode play, with no BBS
software in sue, the new beta has worked fine for me since May 2003.

But some BBS sysops during the early summer reported having further
maint.bat crash problems.  Send any questions to Michael Preslar on
this subject at mike@lordlegacy.com via Email.

As of 12/30/03, the most current LORD v4.07 beta compile I am aware
of, was done on Dec. 04, 2003.
======================================


PROBLEM:  My users LOVE the new version.  What do I do?

Solution:  Thank Chris for writing a great IGM. And thank myself
  and Charlie Wardick for our work in updating The Pawn Shop. <G>

If you are an author of LORD programs, it would be nice to have
a free registered version of your programs perhaps.
======================================


PROBLEM:  The IGM reports that either Vault Gold or Vault Gems
balances are negative.   {05/20/2003}

Solution:  IGM is configured to reset negative balance to 100 Million
Gold.  If Vault Gems is negative, it is reset to 100,000 Gems.  If the
negative values is for Invested Gold and/or Invested Gems, then you
will need to run PSETUP /M to fix the two fields.

Shop ownership will be vacated if the Setup program runs the Bankruptcy
event.  In which case, the IGM will return to no owner status settings.
===========================================================================


Pawnshop.cfg - Manual editing:  Change ONLY Lines 7-10 values:
   Line 7 is Total Invested Gold.  It is limited to 2.00 Billion.
   Line 8 is Total Vault Gold.  Max limit is 2.10 Billion.

   Line 9 is Total Vault Gems.  Max limit is 500 Million.
   Line 10 is Total Invested Gems.  Max limit is 475 Million.

After doing edits, run PSETUP /HELP and verify that the values are
correct, before re-running the IGM.  Max limits values are effective,
as of June 04, 2003.  Gems Vault limits were updated on Dec. 2nd, 2003.

Should pawnshop.cfg get corrupted, the simplest way to fix it, is to
run PSETUP /C, and choose the Reset IGM option.  That sets the IGM
to default values, with no shop owner.


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
7.0  FEATURES:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Here is a list of features, services and/or options which you can do
while in THE PAWN SHOP.

 Blackey's dark services:
   BANISH A PLAYER: Banish a player from LORD for one full day!
    As far as I know, THE PAWN SHOP is the first IGM which allows this.
   DEATH CRYSTAL: You've seen them in the forest.  Have a mercenary
    vaporize an opponent's horse.  (VAPORIZE code also works)
   DISFIGURE: Decrease a player's charm level.
   EVICT:  Evict a player from another LORD IGM, where they are "sleeping".
      You may also evict players from the LORD Inn.
   INTERCEPT: Read another player's LORD Mail.
   KIDNAP: Steal another player's child.  One child per usage.
   LEARN A PLAYER'S BBS NAME: Is someone pretending to be someone else?
    or just annoying you?  Find out who it is.
   LIST:  View Blackey's price list for primary services.

   MAIL, ANONYMOUS:  Sends anonymous mail to players. Does not work
    with shop owner player, since Blackey is forbidden to send his
    mercenaries after his boss.

   MAIM: Decrease a player's max hit points, strength, or defense.
   POISON: Decrease a player's forest and player fights, and more.
   PRICE/PRICE LIST:  Find out what Blackey charges for his primary
    mercenary services.
   PROTECT: Curious about obtaining Wendy's Protection?  Wanna know
    how much you'll have to pay?
   REVIVAL: Want to bring a dead warrior back to life?
    Blackey will tell you about another service "stolen" by Wendy.

   SPY ON A PLAYER: View ALL stats of a player including strength, defense,
    hit points, charm, weapon/armour name and number (for those IGMs that
    all you to change the name of weapons/armour you can tell what they
    really have), if they are married, number of kids, do they have a horse,
    do they have mail waiting, where are they staying (or if they are dead).
    Will also report number of Lays and Games Won the target has.
   STATS: View your current LORD stats.
   STEAL: Rob a player's bank account.
   SUICIDE: Tired of playing today?  Going away and don't want people
    killing you and getting the experience?  Have your character deleted
    so you can just vanish.
   VICTIMS: List all available victims in LORD.

    Some other miscellaneous Blackey Codes:
    ---------------------------------------
    BARD - Info on Seth Able.        BARTENDER - Info on Inn's Bartender.
    BLACKEY - Info on Blackey.       CAMROC - Info on Chris MacPherson.
    CLAIM - Info on claiming shop ownership.
    DRAGON - Info on Red Dragon.     FAIRY - Info on the Fairies.
    MASTER - Want to retry your Master?
    OWNER - Info on current shop owner.
    VAULT - Find out how much Gold/Gems are inside vault.

    FLIRT, FLOWERS, FOREST, GRIZELDA, HELP, HIRE, HORSE, GARDEN, GEMS,
    GOLD, JENNIE, MERCENARY, MONEY, OLIVIA, SECRET, SHREDDER, SMILE,
    SORRY, VIOLET, VULTURE, WENDY.

 Wendy, the witch.
   ASK FOR A BLESSING: Wendy will look at you and rate you.  Depending
    on your stats she will grant you a blessing (increase hit points,
    strength, defense, charm, forest fights, player fights, or nothing).
   PROTECTION: Buy protection from Blackey's mercenaries.  No player will
    be able to send a mercenary after you for the rest of the day.
   RESURRECT DEAD Player:   If you're willing to pay the HIGH price, she
    will cast a spell to resurrect a dead warrior. But only ONCE per warrior
    per day.
   FREE HEALING FOR OWNER:  During Blessing, if owner is injured, or has
    new Hitpoints, Wendy will heal them. For current player, who is shop
    owner only.

  The beautiful Wendy is in charge of selling Elixirs and Gems Trading.
  She will only do business with you if you have been behaving properly
  in the store.

 The Office.
  Only the owner of THE PAWN SHOP may enter the office.  From here the
  owner can view the amount of gold and gems in THE PAWN SHOP, deposit
  and/or withdraw gold from the vault, erase the bulletins, and stay
  overnight in THE PAWN SHOP.
     The shop owner may deposit/withdraw Gems. Gems withdrawal will only
  work when shop has over 250,000 Gems in Vault. And Gold withdrawal only
  works when vault has over 1 Million Gold.

  The spouse is allowed to make deposits or withdrawals from the Vault.
  And they can sleep in the office just like the shop owner, for free.

  Some privileges given the shop owner are not available to the spouse.
  Two examples:  They are not immune from attack by Blackey's mercenaries.
  They do not get Free Healing during Wendy's Blessing.  And the owner's
  spouse does not get a daily salary from the Pawn Shop.

  Treachery.
    ROB THE PAWN SHOP:
     Rob the shop's vault.  Great returns if you succeed.
     If you fail and are caught, you will be beaten up, and thrown
     out of the IGM.  And if you try to return on same day, some
     IGM features will not be usable by you.  Only 1 robbery attempt
     allowed per day.  Shop owner may NOT rob his own business.

     * However, the shop owner's SPOUSE can do robbery.
     * Gold theft is limited to either 500 Million or to 25% of
       the current Total Vault Gold amount.  Actual amount allowed
       by IGM may be much less.

    CLAIM THE PAWN SHOP:
     If there is no owner or the owner is dead then you may claim
     THE PAWN SHOP with no hassle, otherwise, you will have to take
     it over from the current owner -- *IF* you win the fight.  Only
     one shop claim is allowed per day, per player.

     Auto-Claim when current owner is dead.  You try to claim office,
     but find someone else has already killed the owner, who is lying
     dead in the office.  You receive shop ownership automatically.

     You are entitled to up to a quarter of the previous owner's Gold
     and Gems investment.  And you receive Free healing for injuries or
     new hitpoints, if applicable, when you become the new owner.

  Buy Menu
    Weapons/Armour: THE PAWN SHOP will sell weapons and armour for
                     95% of LORD's selling price.
    Spartan Warrior Elixir (increases your Defense)
    Eau de Shredder (increase your Strength)
    Love Potion #9 (increase your Charm)
    Ultra Ale (doubles your Hit Points)
    Gems

  Sell Menu
    Weapons/Armour: THE PAWN SHOP will buy back weapons and armour
                     at 55% of LORD's selling price.
    Gems

  Trade Menu
    1 player fight for 10 forest fights
    5 forest fights for 1 player fight
    Horse for a Fairy
    Fairy for a Horse
    Gems for Elixirs: Same as bartender, but trade is 1 to 1 with a
           chance that you will get a 'bad brew' and not gain anything.

           You may trade for Charm potions also - a service the Inn's
           bartender does not provide his customers with.

    Experience Points trade.  Player with over 1,000 Exp. points may
     trade Experience for Max Hitpoints, Strength, Defense, or Charm points.
     ---------------------------------
   * Trade 20 Gems for Horse  - no limit on usage each day.
   * Trade 40 Gems for Fairy  - Max limit of 5 Trades per day.

Pawn Shop Setup/Maintenance Info:
=================================
   Type PSETUP /HELP if you need list of IGM switches.
   The available switches are as follows:

   /C - Configuration.
   /M - Daily Maintenance.
   /AB - Add to Pawn Shop Bulletins.
           {Adds random message to bulletin.txt }
   /AC - Add to LORD Conversations.  { Adds a random message. }
   /AF - Add to Flower text.
           { Adds random message to garden.txt. }
   /BANISH - Banish Players from LORD.
           { processes content of Banish.dat file, if there is one. }
   /POISON - Poison Players in LORD.
           { processes content of Poison.dat file, if there is one. }
   /HELP - Display PSETUP.exe Switches Help.
           (/SWITCHES and /? also will work.
           Automatically displays current Vault Gold/Gems stats.
   /REPORT - Creates/Updates IGM's Customers Info Report.

   Note: To configure/reconfigure the IGM's Daily Limit values, you
   run PSETUP /C, and then use the Configure Daily Limits option.


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
8.0  SPECIAL THANKS TO:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Lewzer    : Hacked my IGM for bugs!  Thanks man, I think. :)
Mysterium : Testing my IGM for bugs in the early stages.
Blackey   : For supporting me in my initial stages of development and
            being my official support BBS.  Also the main guy to talk to
            in THE PAWN SHOP! <EG>
Energy    : For putting up my IGM for testing!
Meltdown  : For putting up my IGM for testing, and giving me the idea of
            vaporizing opponents' horses!  Hahaha!
NiD       : For giving me the solution to the cash flow problem.  WaHoo!

Chris Holt: For assistance with debugging various IGM problems.

Joe Kinjin: For being patient while Pawn Shop stability issues were
            worked on earlier this year, while IGM was being beta
            tested on his BBS's tournament Lord game.

===============
Donald Tidmore : For updating the IGM to current standards.
Jimmy Rose :  For assistance in getting ANGEL adaptation of code
              to properly run.
Charlie Wardick:  For (a) adapting IGM to remove unusable SharkWare
              IGMDrive components, (b) help in getting IGM to work
              otherwise, and (c) his expertise with BBS programming
              and for his teaching me LORD/BBS programming skills.

Beta Testers:  Gordon Lewicky, Michael Everett, Paul Koukos, Joe Kinjin,
               Charlie Wardick, Rob McGee.  And a few others who have
               checked out the beta at least once.


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
9.0  DEDICATIONS:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
THE PAWN SHOP is dedicated to the many LORD players of Saint John
and Fredericton, NB.

Saint John, NB:
BRAVEHEART     ANGEL           POLGARA         LEWZER
ANGELICA       SHANTAL         SHREDDER        BABY
VIKING         DREAM WEAVER    WHITE KNIGHT    EVAINE
--<RAPIER>--   FANTASIA        WARRIOR         KERRIE

Fredericton, NB:
CLONE          MAN SLAYER      DEAMON          SWEET LADY
FALKON         DEMONA          MELTDOWN        SAVAGE


-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
10.0  FURTHER INFORMATION:
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
There, that's about all I can say about THE PAWN SHOP right now (besides,
I hate writing documentation), but if there's anything else you can think
of that you would like answered just email me at chris@macphersons.ca or
visit my web page at http://macphersons.ca/chris/ and I'll try to answer
your questions.  And you can reach me via ICQ at #:20104440.

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.
    -Chris (Camroc) MacPherson

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


11.0  See external file CCL-APPS.TXT for info on all current/finished
      LORD programs prepared by Donald Tidmore.

Released LORD programs summary, as of Dec. 30, 2003:
   Most recent version info is listed.

Lord Gambling Casino v2.10 IGM, LordStat v1.7 utility,  Nice Hag v2.14
IGM,  Ruined Castle v2.00 IGM, Chasware LORD Player Editor v1.00 utility,
The Gateway v1.2 IGM, L.O.R.D. Cavern v1.6 IGM, Forest Outhouse v2.20 IGM,
Outlands Tavern v1.4 IGM,  The Gem Trader v2.20 IGM, and the RHP Toolkit
v1.3 utilities.  The Pawn Shop v3.10 and The Love Shack II v2.00 IGMs.

Patched IGMs released for LORD author friends, as of Nov. 12, 2003:
-------------------------------------------------------------------
    The Love Shack v1.40p, Castle of L.O.R.D. v2.20, Violet's Cottage
    v5.30, Anastasia's Honeymoon Hotel v1.10, and L.O.R.D. Pit v2.60
    for Trevor Herndon.

    Shauna, Princess of Sorcery v2.10p;  Knight's of the Golden
    Horseshoe v0.70p IGMs for David Simmons.

    Dragon's Castle v2.53 and Hospital Lobby v1.01 IGMs for
    Kaolin Fire Stockinger.

    See:  http://www.fidotel.com/public/camelot/lordapps.htm
          or http://www.fidotel.com/public/camelot/camelot6.htm
=========================================================================

This IGM is the copyrighted property of Chris MacPherson.

Spelling checked on 11/21/2003.

v2.01 - v3.00:  File update started: Nov. 26, 2002, by Donald Tidmore.
                Work ended officially on IGM on December 02, 2003.
===================================================================
v3.01 - v3.10:  File update process - Dec. 10 - 29, 2003.
                v3.10 officially released on Dec. 30, 2003, evening.
======================================================================

Current revision - December 30, 2003 at 09:59 pm.