home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / LORD / SHOPED10.ZIP / SHOPREAD.TXT < prev   
Text File  |  2006-12-04  |  41KB  |  919 lines
  1. SHOPEDIT Documentation Appendix For Pawn Shop LORD IGM:
  2.  
  3. Revised on 05/06/2006 to use PAWNPLAY.DAT instead of EXPTRADE.DAT.
  4. All data sections were brought up-to-date on 12-03-2006.
  5. =========================================================
  6.  
  7. To keep the PAWNWORK.ZIP file's size down, all of the
  8. executable files used by SHOPEDIT and PAWNCONV are stored
  9. separately in the official distribution release archives
  10. SHOPED10.ZIP and PSCONV10.ZIP.  They are available from my
  11. Castle Camelot web-site, my Camelot LordNews FDN site, and
  12. several other sources on the Internet.  All other files used
  13. by The Pawn Shop IGM are stored during beta development inside
  14. the PAWNWORK.ZIP archive.  The official release archive for
  15. v4.00 (PAWN400.ZIP) will contain *ALL* files used by the IGM.
  16. ===========================================================
  17.  
  18.  
  19. IMPORTANT:  READ THIS!!  {Added on 08/13/05}
  20. --------------------------
  21. Marty Blankenship had some questions about why PAWNPLAY.DAT
  22. did not always exist, so I've added this short section to
  23. better explain how the Pawn Shop IGM handles its database file.
  24.  
  25. PAWNPLAY.DAT only covers ONE day of IGM use at a time.
  26. At the start of each new day -- OR when PSETUP /Maint is run
  27. manually, as opposed to being run from MAINT.BAT by LORD -- the
  28. PSETUP program automatically deletes the prior day's
  29. PAWNPLAY.DAT player database file.
  30.  
  31. Therefore until someone actually uses the IGM, no player
  32. database file will exist.  So if SHOPEDIT is run from the IGM
  33. directory, and the PAWNPLAY.DAT file is missing, it is set up
  34. to automatically terminate.
  35.  
  36. You CAN NOT edit database records when none exist.  The editor
  37. is not intended for CREATING records just editing existing ones.
  38. Therefore if there is no database file, then there is no point
  39. in running SHOPEDIT.EXE.  I hope that clears up any misunderstanding
  40. that anyone has about when they can use SHOPEDIT.
  41.  
  42. ---------------------------------------------------------------
  43. If you wonder how the IGM keeps track of the Shop Owner Player's
  44. data, the ONLY stats regarding shop ownership have always been
  45. stored inside the PAWNSHOP.DAT file.  That is where all data on
  46. Vault Gold and Gems balances are stored.  PAWNSHOP.DAT is updated
  47. EVERY time someone in the IGM, or some action done by PSETUP,
  48. changes data in the file.
  49.  
  50. The SHOPEDIT.EXE utility does not access any Pawn Shop IGM data
  51. files other than its config file, SHOPEDIT.CFG, and the IGM
  52. player database file, PAWNPLAY.DAT.  It does not use the IGM's
  53. PAWNSHOP.DAT or PSLIMITS.CFG data files.
  54. ----------------------------------------------------------------
  55.  
  56.  
  57. {Moved here from Pawnshop.txt 07/26/06:}
  58.  
  59.     Important Notes Section:  **** READ THIS!!!! ****
  60. ===========================================================
  61.  
  62. (1) 09/12/05: Changed IGM to NOT use the lockfile.dat file
  63.     for purpose of testing it as a multi-player program.
  64.     That testing stage was officially ended on March 10th,
  65.     2006.  The IGM is now permanently multi-player.
  66.  
  67.     The IGM already was usable on multiple nodes simply
  68.     because it uses the A.N.G.E.L. bbs door game tool-kit.
  69.     -----------------------------------------------------
  70.  
  71. (2) IGM was changed on Dec. 31, 2005 to use a new Configuration
  72.     File structure.  The IGM was updated to use the new Config
  73.     file name PAWNSHOP.DAT on Jan. 09, 2006.
  74.  
  75.     Version 4.00 is a MAJOR change from v3.40. (a) It uses a
  76.     different config file name and layout;  (b) it uses a new
  77.     igm player database file name and layout;  (c) and it is
  78.     now 100% multi-player.
  79.  
  80.     Use PAWNCONV v1.00, released officially on 12-02-2006,
  81.     to convert your old/current PAWNSHOP.CFG file into a new
  82.     PAWNSHOP.DAT file.  See PAWNCONV.TXT file for full info
  83.     on the process, or the synopsis on it in PAWNSHOP.TXT.
  84.  
  85.     After creating the PAWNSHOP.DAT file, follow directions for
  86.     making the PSLIMITS.CFG data file.  It is the SECONDARY IGM
  87.     Configuration File used by The Pawn Shop.  It was not affected
  88.     by the January 2006 IGM data files changes.
  89.  
  90.     =========================================================
  91.     ** You REALLY want to keep your OLD Owner data and Vault
  92.     settings?  OK, you may use the PAWNCONV.EXE utility. It
  93.     will be available with PawnShop v4.00 whenever it is
  94.     officially released, and is available separately via
  95.     my web-site, Fidonet, and other online sources, in the
  96.     PSCONV10.ZIP archive, which will be released on 12-03-2006.
  97.  
  98.     PAWNCONV.EXE will OVER-WRITE any existing PAWNSHOP.DAT
  99.     file.  It reads the values from PAWNSHOP.CFG, asks you
  100.     for your Sysop Handle, then creates the PAWNSHOP.DAT file.
  101.  
  102.     Once you have the PAWNSHOP.DAT file, remember to run PSETUP
  103.     /CONFIG and visually verify that your IGM setup is correct.
  104.  
  105.     This info is ONLY for those who are UPGRADING from v3.40.
  106.     ==========================================================
  107.  
  108. (3) As of 03/29/2006, The Pawn Shop is now using PAWNPLAY.DAT
  109.     as its IGM Player Database File.  Old EXPTRADE.DAT files
  110.     are *INCOMPATIBLE* with SHOPEDIT.EXE, PSETUP.EXE and
  111.     PAWNSHOP.EXE.
  112.  
  113.     To update to the new player database file, *EVERYONE* Must
  114.     delete their EXPTRADE.DAT file.  Then using the current,
  115.     PAWNWORK.ZIP archive file's program files, re-use the IGM
  116.     to recreate the player database file.
  117.  
  118. (4) IGM Player Database File Structure changes:
  119.     -- Reorganized file structure on March 15, 2005;  June 25,
  120.     2005;  Jul. 16, 2005;  Jul. 29, 2005;  Sept. 01, 2005.
  121.  
  122. (5) IGM Limits Config File Structure changes:
  123.     -- Reorganized file structure on Feb. 23, 2005;  Second
  124.     change made on July 29, 2005;  Third changes were on
  125.     June 21, 2005;  Fourth/last change was on August 01, 2005.
  126.  
  127. (6) Created new IGM data file, PS-FIGHTS.DAT, on Sept. 12, 2005
  128.     to control access to the IGM's Claim Shop Office event.  The
  129.     file prevents anyone from using the event while another
  130.     player is in process of making a Shop Office Claim.
  131.  
  132. (7) Changed PSETUP.EXE on June 28, 2005 to use PAWNTIME.DAT
  133.     time/date use file.  It is only used by PSETUP.EXE, and
  134.     it controls payments of Owner Salary, Employees Salary,
  135.     and Guards salary so that they are made only once per day.
  136.  
  137. (8) The IGM has an Admittance Fee, which previously may not
  138.     have been noticed.  You either have to have a Horse, which
  139.     grants FREE admittance, or you have to have ONE Forest
  140.     Fight to pay for admittance (per visit).  07/16/06 note.
  141.  
  142.     One of the privileges of Shop Ownership, or of being
  143.     married to the Shop Owner, is FREE admittance is guaranteed
  144.     to the Shop Owner, and to their Spouse.  (v3.86 Note)
  145.  
  146.     Free admittance to the IGM is also granted to the LORD
  147.     player character used by the Sysop User, as of 11-21-2006.
  148. ==============================================================
  149.  
  150.  
  151. {Moved here from Pawnshop.txt 07/26/06:}
  152.  
  153.     UPDATE INSTRUCTIONS FOR USING v3.88 Beta:  {03-29-2006}
  154. ========================================================
  155. 1) Obtain PAWNWORK.ZIP from me via email.
  156.    Use ktidmore@bellsouth.net or gtidmore@hiwaay.net please.
  157.  
  158.    Obtain ShopEdit v1.00 and PawnConv v1.00 from my web-site:
  159.      http://www.filegate.com/camelot/LORDfile/shoped10.zip
  160.      http://www.filegate.com/camelot/LORDfile/psconv10.zip
  161.  
  162. 2) Unzip all files from all three archives, using the -N
  163.    parameter used by Wzunzip and Pkunzip, into your IGM
  164.    directory.  Delete your existing EXPTRADE.DAT file.
  165.  
  166.    Run PAWNCONV.EXE so it creates a PAWNSHOP.DAT IGM
  167.    Configuration file.  Or use PSETUP /CONFIG to create
  168.    the file.  Neither PSETUP or PAWNSHOP will operate until
  169.    this has been done.
  170.  
  171. 3) Use IGM long enough to create a new player database file.
  172.  
  173.    Until you have made a PAWNPLAY.DAT file, any usage of the
  174.    SHOPEDIT.EXE utility, PSETUP REPORT command will not work.
  175.  
  176.    **  If you have just started using the IGM, then simply
  177.    follow the Installation instructions that are listed farther
  178.    down in this documentation file.  (Yes I know, this file is
  179.    big, and complex. I'm trying to rewrite it over time.)
  180.  
  181. 4) You may resume normal usage of the IGM at this time.
  182. ==============================================================
  183.  
  184.  
  185.   ** READ THIS !!!! **  {Moved here from Pawnshop.txt 07/26/06}
  186.  
  187.   12/15/05 Notes:  I've fixed PAWNSHOP.EXE so that if the user runs the IGM
  188.   in LORD, and the PSLIMITS.CFG file does not exist, the IGM will create
  189.   the file using default settings.  Its up to the sysop/end-user to check
  190.   the file, using PSETUP /CONFIG, and make any changes they want to the limits
  191.   settings.
  192.  
  193.   PSETUP.EXE, during un-install process, now shows you what data string it
  194.   used to search 3RDPARTY.DAT and MAINT.BAT file.  If you have more one
  195.   than Pawn Shop installation in a LORD game, the un-install process will ONLY
  196.   remove the Pawn Shop setup that is based in the current directory that
  197.   PSETUP is running from.  The other igm setups of The Pawn Shop are left in place.
  198.  
  199.   Remember when you do un-install the IGM, that you are supposed to visually
  200.   verify your 3RDPARTY.DAT file to make sure that its content is as desired.
  201.  
  202.   IGM Setup programs can occasionally screw up so you should do this all the
  203.   time with ALL of your LORD igms.
  204.   ============================================================================
  205.  
  206.  
  207. {Moved here from Pawnshop.txt 07/26/06:}
  208.  
  209.     Notes regarding Horse/Fairy/Orphan Child Gems Trades:
  210. ===========================================================
  211.   Customers may purchase Horse, Fairy or Orphan Kids provided
  212.   (1) that they have enough Gems, (2) that they have not reached
  213.   the Fairy/Horse/Adoptions Limits, and (3) that they are in
  214.   good standing with Wendy.  Anyone who is on the Hate List is
  215.   not allowed to use the Wendy Menu and Blackey Menu events.
  216.  
  217.   Anyone on the Shop Ban List is not allowed to use the IGM
  218.   at all as long as their name remains in the SHOPBAN.DAT file.
  219.   Details are in the "Foul Language" Section of this file.
  220.  
  221.   There is NO Limit on Gems for Horse Trades.  Other than that
  222.   (a) player has to have 15 Gems to pay for one, and (b) they
  223.   must be in good standing with Wendy.
  224.  
  225.   Limits Info, as of July 26, 2006 (and Dec. 03, 2006):
  226.   ----------------------------
  227.   1. Sysop-Configurable. 0-15 Fairy Gems Trades are allowed per day.
  228.      Does not count Horse for Fairy trade swaps by players. Each
  229.      Fairy costs 30 Gems.  Note: If this limit is set at Zero,
  230.      then the IGM does not allow Gems Fairy Trades at all.
  231.  
  232.   2: Sysop-Configurable. 1-16,000 Orphan Gems Trades are allowed
  233.      per day.
  234.  
  235.      Customers may trade for up to 750 Kids per gems trade.  Limit
  236.      covers Kids obtained from Wendy's Blessings and Adoptions
  237.      made via Gems Trades each day. 
  238.  
  239.      ** NOTE: Actual number of Kids one can adopt during a Gems
  240.      Trade is dependent on how many Kids they have already bought
  241.      that day, on what the Daily Adoptions Limit is, and on the
  242.      player's LORD Gems on Hand amount. **
  243.  
  244.      Kids Stolen via the KIDNAP mercenary service are not counted
  245.      as Adoptions, so they don't count against the Daily Adoptions
  246.      Limit.  Each orphan costs 40 Gems.
  247.  
  248.      A) Players can not use Adoptions service if they already have
  249.      32,000 or more Kids.  B) Once player meets the Adoptions Limit,
  250.      further adoptions that day are not allowed -- unless the sysop
  251.      increases the limit during the day.  C) Anyone on the Hate
  252.      List is not allowed to use Wendy Menu services including
  253.      the Adopt Children event.
  254.   -----------------------------------------------------
  255.  
  256.   Fairy trades are limited due to their use by various Mercenary
  257.   Services, so I felt it advisable to control this IGM event.
  258.  
  259.   =================================================================
  260.   Usage Reports Data:  Fairy and Horse Trades per player are listed
  261.   on Report #2.  Kids Adopted and Kids Stolen are on Report #3.
  262.  
  263.   The Shop Owner player, their player spouse, and the Sysop User
  264.   player may view the Usage Reports for free from the Office Menu.
  265.   All other players, excluding ones on the Hate List or Shop Ban
  266.   List, can buy access to the Reports from Wendy.
  267.  
  268.   The sysop user can view/update the Pawn-use.txt reports file using the
  269.   PSETUP REPORT command, or by choosing a menu option inside PSETUP.
  270.   =====================================================================
  271.  
  272.  
  273. {Moved here from Pawnshop.txt 07/26/06:}
  274.  
  275.     Notes regarding Major Updates of the IGM in 2005:
  276. =======================================================
  277.  
  278.   * Added use of ROB-GOLD.DAT file. Deleted use of old ROB.DAT file.
  279.   Players can only be robbed of Bank Gold or Gems once per day.
  280.   Rob-Gold.dat tracks who has been victims of Gold robbery - but
  281.   that is only if the robbery is successful.
  282.  
  283.   * Added use of ROB-GEMS.DAT file.  It tracks who has been a
  284.   victim of Gems Theft, if the robbery was successful. A player
  285.   can be robbed of Gems only once per day.
  286.  
  287.   ----------------------------------
  288.   * The old BULLETIN.TXT file is now named PAWNBULL.TXT.
  289.  
  290.   * Added option in IGM, handled by Blackey, that allows the
  291.   player to view the LORD Daily News file from inside the IGM.
  292.   IGM makes copy of the LOGNOW.TXT file and displays the file
  293.   LNWSCOPY.TXT on-screen once player has paid the access fee.
  294.  
  295.   * Credit for the June 2005 updates goes to Don Young of the X-Bit
  296.   BBS, who notified me of long-term abuses of this IGM.  BANISH
  297.   and POISON were being used heavily by bullies to prevent
  298.   people from being able to play LORD at all for days at a time.
  299.  
  300.   The Mercenary Protection service was being heavily abused by
  301.   people in Pacific time zone, causing great havoc in LORD games
  302.   held in other time zones.  Players in Pacific zone were getting
  303.   protection and then abusing the mercenary services heavily.  Everyone
  304.   else suffered as a result because they could not retaliate against
  305.   the bullies who had Wendy's Protection.
  306.  
  307.   The \NoProtect IGM command line variable was added to prevent
  308.   that abuse from continuing to happen.  It is up to the sysops
  309.   to use it.  It is also their responsibility to monitor their
  310.   BBS door games and BAN bullies from them.  No IGM or door game
  311.   author can do a complete job of handling bullies.  That is the
  312.   sysop's responsibility.
  313.  
  314.   The alternative is to disable ALL access to Blackey Menu. You
  315.   do so by using \NoBlackey on the IGM command line.  You can
  316.   only use ONE at a time.  Please always use PSETUP /CONFIG Install
  317.   IGM feature for enabling use of either \NoBlackey or \NoProtect.
  318.  
  319.   To disable them, simply delete the parameter from the Pawn Shop
  320.   IGM command line in your 3RDPARTY.DAT LORD file. You can also
  321.   Un-install and Re-install to disable either parameter.  However
  322.   that wipes out all data in the two IGM config files, which you
  323.   have to recreate line by line in PSETUP INSTALL and CONFIGURE
  324.   processes.
  325.  
  326.  
  327.   ============= IMPORTANT:  READ THIS!!!!! ====================
  328.   July 13, 2005: Using Foul Language in The Pawn Shop more than
  329.   THREE times in a day now results in DEATH of the player.  The
  330.   second and third offenses both result in loss of Fairy.
  331.  
  332.   See "Foul Language Punishments Revision: Sept. 2006:" at
  333.   bottom of this file for full details.
  334.   =============================================================
  335.  
  336.  
  337.   Aug. 01, 2005: Added Max Visits/Day Limit in PSLIMITS.CFG file,
  338.   for sysops to configure, using 1-20 range.  Individual users of
  339.   IGM can choose how many visits a day they wish to allow.
  340.   Update the IGM Limits File using PSETUP /CONFIG.
  341.  
  342.   All players are subject to the Visits/Day Limit w/o exceptions.
  343.  
  344.   Aug. 03, 2005: Revised Flirt with Wendy, Flirt with Blackey
  345.   events.  Reduced amount of Experience Points they will grant,
  346.   and increased amount of Charm/Defense points granted if player
  347.   gets 0 exp. points from Wendy or Blackey.
  348.  
  349.   Aug. 04, 2005: Implemented Multiple Adoptions code.
  350.  
  351.   ** May 06, 2006:  Players may adopt up to 750 Kids per purchase.
  352.   They can adopt up to 16,000 Kids/Day, as of July 26th, 2006.
  353.  
  354.  
  355.   ------------------ READ THIS!! -------------------------------
  356.   Sept. 26, 2006: Normally, you can not use mercenary services on any
  357.   warrior who is also online in LORD.  There are four exceptions.
  358.   You may use INTERCEPT, LEARN, MAIL and SPY commands on any player
  359.   except for the shop owner, who is protected from mercenaries.
  360.  
  361.   Services such as INTERCEPT that cause no harm to the target
  362.   are allowed to be used on the Shop Owner Player by Blackey.
  363.  
  364.   All of the mercenary services have been retested to ensure that
  365.   they work properly when the targeted player is either in LORD
  366.   or is also using The Pawn Shop at the current time.
  367. =================================================================
  368.  
  369.  
  370. {Moved here from Pawnshop.txt 07/26/06:}
  371.  
  372.     Special Parameters Usage:  Added 06/21/2005:
  373. =================================================
  374.  
  375. I was looking into usage of the NoBlackey variable and found out
  376. it has not been usable since Pawn Shop was converted in December
  377. 2002-January 2003 to use the ANGEL Tool-kit.  I restored its
  378. usage on Jun. 21th, 2005.  This documentation file, dating back
  379. to the one used by version 3.00, also had failed to even mention
  380. NoBlackey was an available option.  Just as well, since the
  381. original instructions to use /NoBlackey on the IGM command line
  382. for Pawn Shop turned out, under ANGEL, to cause the IGM to crash.
  383.  
  384. PSETUP has been updated to ask if you wish to use either of two
  385. special parameters in the 3RDPARTY.DAT file's IGM command line
  386. used by LORD to execute this IGM.  You can't use both of them.
  387.  
  388.     \NoBlackey - If used, it de-activates all usage of Blackey Menu.
  389. The game still be be used, it just won't be as exciting <G>.  But
  390. if that is how you want to use the igm, you can do that now.
  391.  
  392.     \NoProtect - I was told by Don Young that players were abusing
  393. Wendy's Protection.  So this parameter was created to deactivate
  394. Wendy's Buy Protection service.  While in use, NO one is protected
  395. from mercenary attack EXCEPT for the Shop Owner player.
  396.  
  397. The shop owner is ALWAYS protected from mercenary attack.  It is
  398. one of the primary privileges of shop ownership. (Their spouse is
  399. NOT protected.)
  400.  
  401. You can use PSETUP to change an existing installation of Pawn Shop
  402. to use either parameter or you can add them to the 3RDPARTY.DAT
  403. file manually.  If you do the latter, be VERY CAREFUL that you
  404. use "\".  Using "/" will cause the IGM to crash.  It does something
  405. that the Windows O.S. calls an Illegal Instruction.
  406. -----------------------------------------------------
  407.  
  408. IGM installation process asks if you want to do three things.
  409. The first is usage of the \NoBlackey parameter.  If it is not
  410. in use, you are then asked if you want to use \NoProtect. Third,
  411. you are asked if you wish to include version data info in the
  412. IGM's 3RDPARTY.DAT entry lines.  All three went into full effect
  413. on Jun. 21, 2005.
  414.  
  415. I have not personally tested use of \NoBlackey yet.  But it
  416. should work OK.  Until notified otherwise, use it with caution.
  417. =============================================================
  418.  
  419. If you find \NoProtect of use, you can thank me for coding it,
  420. and you can thank Don Young, Sysop of The X-Bit BBS, for
  421. requesting a way to disable usage of Mercenary Protection.
  422.  
  423. If you like and use \NoBlackey, thank Chris.  He created that
  424. one a long time ago.
  425.  
  426. --------------------------------------------------------------
  427. Internal Constants: NoBanish - activated if sysop/end-user
  428. specified that Banish_Uses is zero.  NoPoison - activated
  429. when Poison_Uses is zero.  NoKidnap - activated when Kidnap_Uses
  430. is Zero.  Notes added 08/01/05.
  431. =============================================================
  432.  
  433.  
  434. {Moved here from Pawnshop.txt 07/26/06:}
  435.  
  436. ===============================================================
  437.  ** 07/13/05 Note regarding PAWNTIME.DAT:  PLEASE READ THIS!!!
  438.  
  439.     I changed the structure of the PAWNTIME.DAT to store the
  440.     three boolean values that limit salary payments to once a day.
  441.     --------------------------------------------------------
  442.  
  443.  
  444. {Moved here from Pawnshop.txt 07/26/06:}
  445.  
  446.   --------------------------------------------------------------
  447.   WARNING:  Do not EVER manually edit BANISH.DAT and POISON.DAT
  448.   so that the same player ends up being both banished and
  449.   poisoned.  That is VERY BAD behavior.  I don't want players
  450.   blaming ME for such actions, so please do NOT ever do this!
  451.  
  452.   ====================================================
  453.   For Sysops:  Please monitor the LOGNOW.TXT announcements made
  454.   by the PSETUP Poison Player and Banish Player Events.  If
  455.   players get Banished AND Poisoned on the same day, that's a
  456.   glitch that I am unable to prevent.  As long as no one tampers
  457.   with the BANISH.DAT and POISON.DAT files, the IGM is designed
  458.   to prevent this situation from occurring.
  459.  
  460.   It is the sysop's responsibility to detect and punish abusers
  461.   of this IGM or any other IGM that they use in their LORD game.
  462.  
  463.   IF someone reports a situation like this to you, please do
  464.   something immediately to correct it.  The quickest way is
  465.   to use LPEDIT and run New Day for Player for the player or
  466.   players who notify you that such a problem exists.  That will
  467.   allow them to immediately resume usage of LORD.
  468.  
  469.   The #1 best way to stop people from abusing any BBS door game
  470.   is to deny them access to your BBS doors completely.  If you are
  471.   looking for less drastic punishments, here are some ideas:
  472.  
  473.   To immediately punish a bully or cheater INSIDE Pawn Shop itself,
  474.   you can add their LORD Real Name to the SHOPBAN.DAT file. That
  475.   will disallow their usage of the IGM completely until the file
  476.   is deleted by PSETUP Maintenance event.
  477.  
  478.   You can also edit their IGM player database record using
  479.   SHOPEDIT.EXE.  There are various settings that you can change.
  480.  
  481.   Set Visits to 20.  Disallows player from using igm any more that day.
  482.   Usage of SHOPBAN.DAT has the same effect.
  483.  
  484.   Set Adoptions to 16,000.  Disallows further adoptions that day.
  485.   And so on.
  486.  
  487.   To punish bully/cheater inside LORD itself, run my LPEDIT program
  488.   and do a CLEAN SLATE on the bully/cheater.  There are two modes.
  489.   1 resets player to Post-Dragon Kill settings.  The other resets them
  490.   to Brand New Player settings.
  491.  
  492.   LORDCFG does not have a Clean Slate option, but you can achieve the
  493.   same results by manually changing every appropriate value in the player's
  494.   record to zeroes in the LORD Player Editor module part of LORDCFG.EXE.
  495.   ======================================================================
  496.  
  497.  
  498. {Moved here from Pawnshop.txt 07/26/06:}
  499.  
  500. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  501.     Updating from Version 3.00 (or v3.10) to v3.40:
  502.  
  503.      ** Deleted section on 12/03/2006. I no longer provide
  504.      support for version 3.40.  Everyone is to use v3.88 Beta
  505.      or the official release of v4.00, when it becomes available.
  506.      Contact me via E-Mail or Fidonet mail if you want assistance
  507.      with the IGM Update process.  But please read PAWNSHOP.TXT
  508.      and its related docs files beforehand.
  509. ===============================================================
  510.  
  511.  
  512. {Archived here from PAWNSHOP.TXT 12/04/06:}
  513. July 2006 Notice:
  514. -----------------
  515. As of 07/26/06, PSETUP can NO longer be used with /?, ?, /C,
  516. or /M parameters.  All Maintenance is now done using /MAINT.
  517. All Configuration is done using /CONFIG.  To see the help
  518. screen, you use PSETUP /HELP or PSETUP /SWITCHES.
  519.  
  520. Aug. 03, 2006 Notice:
  521. All "Hated" customers are denied access to the Wendy Menu and
  522. Blackey Menu.  That includes events such as Adopt Children.
  523.  
  524. Oct. 04, 2006 Notice:
  525. Anyone on the HATE List is now denied access to the Good
  526. Customers Discount for buying Weapons/Armour. (v3.86+)
  527. =======================================================
  528.  
  529. 3.50: IGM Usage Report notes Section:
  530. =======================================================
  531.   Moved into SHOPREAD.TXT file on 12/04/2006.
  532.  
  533.   * The disk file is named PAWN-USE.TXT and can be viewed
  534.     using any program that reads text files, or by using
  535.     PSETUP.  Simplest and quickest access is to use the
  536.     PSETUP /REPORT command.
  537.  
  538.   * Usage Report #1 was added in 2004.  It covers Lord Name,
  539.     Experience Traded, Gems Traded, Potions Bought, Visits,
  540.     Fairy Trades, and Horse Trades.
  541.  
  542.   * Usage Report #2 covers Exp. Trade Limit Rate; and amounts
  543.     of Max HitPoints, Strength, Defense and Charm purchased.
  544.  
  545.   * Usage Report #3 covers, as of 06/21/05, Kids Adopted, Kids
  546.     Stolen, # of Gems Thefts, Wisdom gain/loss, and # of Bank
  547.     Gold Thefts.
  548.  
  549.   * You can't use PSETUP /REPORT if you do not have a current
  550.     PAWNPLAY.DAT file.  It also should not be used with OLD
  551.     copies of the file, since they probably will use out-dated
  552.     player database structures. You must be in the IGM directory
  553.     where PAWNPLAY.DAT is located to use PSETUP /REPORT.
  554.  
  555.   * Players may pay Wendy to view the Usage Reports.  She
  556.     does not charge a lot. Normally, you have to have access
  557.     to the Shop Office to view them from inside the IGM.
  558.   -----------------------------------------------------------------
  559.  
  560.   * WARNING: Avoid using PSETUP to change values in PAWNSHOP.DAT,
  561.     or in PSLIMITS.CFG while the IGM is in use.  It is a possible
  562.     source of IGM usage complications, so that situation should
  563.     be avoided.  PSETUP /Report may be used safely while the IGM
  564.     is in use, but will not be completely up-to-date in such cases.
  565.  
  566.   * If you have pawnrept.bat file, you can delete it.  It is
  567.     no longer in use.  PSETUP.EXE originally was not able to
  568.     display the file on-screen, so it was provided as a service
  569.     to users of this IGM.
  570.  
  571.   * If you have an bulletin.txt or ps-time.txt file, delete them.
  572.     The IGM now uses PAWNBULL.TXT for the Bulletins file.  The
  573.     other file was a temporary file and is no longer in use by PSETUP.
  574. ==========================================================
  575.  
  576.  
  577. {Archived from PAWNSHOP.TXT on 12/04/2006:}
  578.  
  579. 07/30/06 Note: Either delete any ROB.DAT files you have, or rename
  580. them manually to ROBVAULT.DAT (unless RobVault.dat already exists).
  581. --------------------------------------------------------------
  582.  
  583. * Copies of PAWNWORK.ZIP and SHOPEDIT.ZIP are backed up on
  584.   my Castle Camelot web-site.  Sometimes it is once a week,
  585.   and other times it is 1-3 times a month.  And they are
  586.   also available from the NightFall Games and Fidotel BBS
  587.   servers, but those files are not always kept up-to-date.
  588.  
  589. * ALWAYS obtain BOTH beta archives from me directly and that
  590.   way I can notifiy you if there are any special conditions
  591.   that you need to be aware of, regarding the current beta
  592.   programs. Occasionally, while I am working on the IGM, some
  593.   components may not work properly, or they may contain temporary
  594.   debug statements.  And possibly new events that are in testing
  595.   may not work properly.
  596.  
  597. * For every user of The Pawn Shop: Please send feedback on ANY
  598.   problems you encounter using the IGM, which you can tell are
  599.   caused by the IGM.
  600. ==============================================================
  601.  
  602.  
  603. **** Detailed Notes for PSLIMITS.CFG Section: ****
  604. --------------------------------------------------------------
  605. *PSLIMITS.CFG -
  606.     Stores the values used in Potions Trading limits.
  607.     Entry #1:  Amount of potions player may acquire each day via
  608.     either Gems Trading, potions purchases with Gold, or Experience
  609.     Trades.  Maximum limit is 16,000.  Default setting is 8,000.
  610.  
  611.     Entry #2: Percentage of Experience points player is entitled to
  612.     trade in each day.  Maximum limit is 50%. Default setting: 20%.
  613.  
  614.     Entry #3: Number of Fairy trades for Gems player may make each day.
  615.     Maximum limit is 15.  Default setting: 5.  May be set to ZERO
  616.     by Sysop to disable Gems Trade for Fairies.
  617.  
  618.     Note: The Trade Menu's "Swap Fairy for Horse" and "Swap Horse
  619.     for Fairy" are not covered by the Fairy Trades Limit.
  620.  
  621.     Entry #4: Number of Orphan Child trades for Gems player
  622.     may make each day.  Range: 0 through 16,000.  Sysop is
  623.     allowed, as of 12/04/06, to disable this Service by setting
  624.     its Limit value to Zero.
  625.  
  626.     Note: Wendy's Blessing can grant Children to a player.  It
  627.     is not covered by the Adoptions/Day Limit.
  628.  
  629.     Some limits may be set to Zero.  That disables access to the
  630.     Mercenary service, or normal Gems Trade service, which they
  631.     are designed for.
  632.  
  633.     Entry #5 covers Banish Player Service.  It can be set between
  634.     0 and 5.  If 0, then no one is allowed to banish players.
  635.  
  636.     Exception: Blackey can Banish anyone who violates his rules.
  637.  
  638.     Entry #6 covers Kidnap Service Uses.  It can be set between
  639.     0 and 100.  If 0, then no one is allowed to Kidnap Children
  640.     from other warriors.  Each Kidnap Event can steal up to 5
  641.     Kids at a time.  The IGM will not allow Event to be used
  642.     once the Kids Stolen counter reaches 100.
  643.  
  644.     Entry #7 covers Poison Player Service.  It can be set between
  645.     0 and 5.  If 0, then no one is allowed to Poison players.
  646.  
  647.     Entry #8 covers Gems Thefts.  Can be set between 0 and 5. If
  648.     an attempt is unsuccessful, it does not count against the
  649.     limit.
  650.  
  651.     Entry #9 covers Bank Gold Thefts.  It can be set between
  652.     0 and 5.  If 0, then no one is allowed to Steal Gold from
  653.     another warrior's LORD Bank Gold account.  If robbery attempt
  654.     is unsuccessful, it does not count against the limit.
  655.  
  656.     Entry #0 (the ZERO menu key) covers Max Visits/Day Limit.
  657.     Users are not allowed to set this to Zero.  Allowed range
  658.     is 1 to 20.  This is IGM Limit setting #10.
  659.  
  660.     The PSLIMITS.CFG file is also recreated when user does an
  661.     IGM Reset, and is updated whenever Configure Limits is used
  662.     in a PSETUP /CONFIG session.
  663.  
  664.     If the IGM is run, and PSLIMITS.CFG does not exist, the IGM
  665.     will automatically generate the file using default values.
  666. ===========================================================
  667.  
  668.  
  669. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  670. 6.0  BUGS/TROUBLESHOOTING:
  671.  
  672. Most of this was written years ago by Chris MacPherson and
  673. does not really have relevance to the IGM's usage now I think.
  674. So it is now stored in the SHOPREAD.TXT docs file.
  675.  
  676. -=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
  677.  
  678. PROBLEM:  THE PAWN SHOP WILL NOT LOAD!  WHAT DO I DO???  {Chris}
  679.  
  680. SOLUTION:
  681. I've had a few comments that after installation it will announce itself
  682. in LORD and be listed in 'Other Places' but will not load.  The way to
  683. get THE PAWN SHOP to come up is to change the fossil/internal settings
  684. in the Node Configuration in LORD (ie. LORDCFG.EXE).  You may need to
  685. change to either Regular Fossil or Weird Fossil.  Hope this helps.
  686.  
  687. * Note: This was applicable to version 1.xx, and I simply do not
  688.   know if this situation still occurs with the 3.xx versions. Donald.
  689.  
  690. After installation make sure that 3rdparty.dat entry contains /N*
  691. /G<lordpath> parameters, or the IGM will not work properly.  Also
  692. make sure entry added to maint.bat is PSETUP.EXE /MAINT.   (Only applicable
  693. to beta versions 2.51+.
  694.  
  695. (Note: Older v1.xx versions use a "<c:\lord\> PAWNSHOP.EXE * lordpath"
  696. 3rdparty.dat entry line setup.  Please REMOVE the old entry, then
  697. INSTALL the v3.88 Beta IGM back into your LORD game(s).
  698. ====================================================================
  699.  
  700.  
  701. PROBLEM:  My users LOVE the new version.  What do I do?
  702.  
  703. SOLUTION:  Thank Chris for writing a great IGM. And thank myself
  704.   and Charlie Wardick for our work in updating The Pawn Shop. <G>
  705.  
  706. If you are an author of LORD programs, it would be nice to have
  707. a free registered version of your programs perhaps.  Or perhaps
  708. a "personalized" version, if you have that kind of setup. Donald.
  709. ======================================
  710.  
  711.  
  712. PROBLEM:  PAWNSHOP.EXE starts running and does an RTE error message.
  713. I'm returned back to LORD immediately without getting inside the IGM.
  714.  
  715. SOLUTIONS:
  716. 1) Make sure that you have PAWNSHOP.DAT and PSLIMITS.CFG files in
  717. the IGM directory, AND that they refer to the CORRECT IGM directory,
  718. and to the CORRECT LORD directory.  If either file is missing, the
  719. IGM will not run.
  720.  
  721. 2) Delete PAWNPLAY.DAT file, and retry IGM.  If you just updated
  722. from an older official version, such as v3.10, or from some old
  723. betas, the old player database file is probably incompatible with
  724. the IGM and with PSETUP.EXE.
  725.  
  726. 3) The record structure for PAWNTIME.DAT, used only by PSETUP.EXE,
  727. was updated in July 2005. If you get an RTE 100 while using PSETUP,
  728. simply delete PAWNTIME.DAT.  Then restart PSETUP using /CONFIG command
  729. and it will recreate the file for you.
  730.  
  731. You have to restart the IGM without a player database. It will
  732. then recreate one.  That should solve any RTE problems.  If it
  733. does NOT, contact me immediately with details.  Donald.
  734.  
  735.  
  736. ------------------------------------------------------------
  737. Some final notes:  Avoid manual edits of PAWNSHOP.DAT and
  738. PSLIMITS.CFG while the IGM is in use, or usage of PSETUP options
  739. while the IGM is in use.  *SOME* PSETUP functions will work OK
  740. when the IGM is in use, others would cause problems for sure.
  741.  
  742. Do NOT mess with the lockfile.dat while IGM is in use.  Also
  743. NEVER manually delete PAWNPLAY.DAT while the IGM is in use.
  744.  
  745. The same thing applies to OUT.*, MAIL*.DAT, and INFO.* files
  746. that are in use by the IGM, while it is operating.
  747.  
  748. =========================================
  749. *Do NOT ever modify content of PAWNSHOP.scr yourself, with ONE
  750. exception.  If you want different LORD color codes for an event,
  751. you may modify those to your own preference.  Otherwise, HANDS
  752. OFF this data file.  It is protected by federal and international
  753. copyright laws.
  754.  
  755. If you don't like how something is coded in the file, then let
  756. me know.  I will then make changes to the file myself. Donald.
  757. ======================================================================
  758.  
  759.  
  760. PROBLEM:  The IGM reports that either Vault Gold or Vault Gems
  761. balances are negative.   {05/20/2003}
  762.  
  763. SOLUTION:  IGM is configured to reset negative balance to 100 Million
  764. Gold.  If Vault Gems is negative, it is reset to 100,000 Gems.  If the
  765. negative values is for Invested Gold and/or Invested Gems, then you
  766. will need to run PSETUP /MAINT to fix the two fields.
  767.  
  768. Shop ownership will be vacated if the Setup program runs the Bankruptcy
  769. event.  In which case, the IGM will return to no owner status settings.
  770. ===========================================================================
  771.  
  772.  
  773. PROBLEM: During IGM entry, the IGM identifies you as the Shop's Owner
  774. and you had not done a Claim Office igm event previously.  And your
  775. Lord character uses Lord Player number Zero.
  776.  
  777. SOLUTION: IGM was comparing the incoming player's PlayerNum field to
  778. TConfig.OwnerNum, the Shop Owner's Player Number config file field,
  779. and if they matched, it automatically considered you as the shop owner.
  780.  
  781. As of 03/02/2005, the IGM has been set up to use 200 as the default
  782. OwnerNum value when there is no owner.  LORD does not allow more than
  783. 150 players in a game, so no one will have a player number of 200.
  784.  
  785. That should take care of the IGM assuming that you are the Shop Owner
  786. when you have never actually used the Claim Shop event in the IGM.
  787.  
  788. -------------------------------------------------
  789. Side Note: As of 03/02/05, whenever there is no shop owner, the Owner
  790. Name entry in PAWNSHOP.DAT will now say "NO SHOP OWNER" instead of
  791. containing blank spaces.
  792.  
  793. As of 07/16/06, if there is no shop owner, the Owner RealName
  794. entry in PAWNSHOPO.DAT now says "NO OWNER YET". (v3.86+)
  795. END of 03/02/05 PROBLEM/Solution section.
  796. ====================================================================
  797.  
  798.  
  799. **** Foul Language Punishments Section: ****
  800. --------------------------------------------------------------
  801.   * Entirely rewritten in September 2006:
  802.  
  803.   Each player who uses foul words in Blackey's presence is
  804.   immediately punished.  Punishments increase in number and
  805.   severity with each offense, culminating in the warrior's
  806.   DEATH upon the fourth offense.  There is NO immunity from
  807.   the penalties for the Shop Owner player.
  808.  
  809.   * Penalty #1: Each player loses some Charm for each offense.
  810.     Each player loses 25% of their HitPoints for First offense,
  811.     50% of Hitpoints for Second offense, and their Hitpoints are
  812.     dropped to ONE point for later offenses.
  813.  
  814.   * Penalty #2: Each player loses 25% of their Gold and Gems
  815.     on the First offense.  Second offense costs them 50% of
  816.     Gold in Hand and Gems.  Third/Fourth offenses costs them
  817.     ALL of their Gold in Hand and Gems.
  818.  
  819.   * Penalty #3: Each player loses 7.5% of their Experience
  820.     Points for Second offense. Third/Fourth offense costs them
  821.     15% of their Experience Points.
  822.  
  823.   * Penalty #4: Each player loses their Horse, starting with
  824.     the Second offense, if they have one.
  825.  
  826.   * Players go on the Naughty List for Second and Third offense,
  827.     and on the Hate List during/after the Fourth offense.
  828.  
  829.   * Penalty #5: Each player loses their Fairy, starting with
  830.     the Third offense, if they have one.
  831.  
  832.   * ALL players are thrown out of the shop immediately
  833.     starting with the Second offense.
  834.  
  835.   * ALL players are put to DEATH by Blackey, and their Hitpoints
  836.     drop to Zero, when he punishes fourth (and later) offenses.
  837.  
  838.   * The Shop Owner Player is subject to punishment by Blackey
  839.     just like everyone else who uses the IGM.  Plus they get
  840.     additional punishment, as noted below.
  841.  
  842.   All of the penalties noted above are in full effect as of
  843.   Sept. 13-14, 2006, and have been fully tested.
  844.   =============================================================
  845.  
  846.  
  847.   Special Punishment for Shop Owner's Foul Language usage:
  848.  
  849.   * Second Offense: Owner player loses 25% of their Invested
  850.     Vault Gold, and 25% of their Invested Vault Gems.
  851.  
  852.   * Third Offense: Owner player loses 50% of Invested Gold/Gems.
  853.  
  854.   * Fourth Offense: Owner player loses Shop Ownership status,
  855.     and is banned from retrying to re-Claim the Shop Office
  856.     on that LORD game day, should they be resurrected from death.
  857.  
  858.   The IGM's CLAIM.DAT lists the LORD Real Names of those players
  859.   who have tried to Claim the Shop Office each day.  If a player
  860.   is listed there, the IGM does not allow them to do Office Claim.
  861.   ===========================================================
  862.  
  863.  
  864.   The Shop Ban List:    {added 10/22/2006}
  865.   ============================================================
  866.   * Any warrior who is killed by the Shop Owner during a Shop
  867.     Ownership Fight is now placed on the Shop Ban List.
  868.  
  869.   * Any warrior who uses Foul Language around Blackey a fourth
  870.     time is placed on the Shop Ban List.
  871.  
  872.   * During PSETUP Maintenance, it has always been possible for
  873.     the HATE.DAT file to be retained.  That now also applies
  874.     to the SHOPBAN.DAT file.  So people on the Hate List and/or
  875.     Shop Ban List may find themself paying for their sins on
  876.     more than one LORD game day.
  877.  
  878.   * Anyone who is on the Shop Ban List is denied access to the
  879.     Pawn Shop IGM, effective Oct. 22nd, 2006.
  880.  
  881.  Shop Ban List status may extend to multiple days if the
  882.  PSETUP Maintenance process does not delete SHOPBAN.DAT,
  883.  in same manner as HATE.DAT file has always been handled.
  884.  
  885.  Sysops are requested to NOT interfere with this policy by
  886.  deleting the SHOPBAN.DAT file manually!!  There are NO
  887.  exceptions to this policy, for any reason.
  888.  ============================================================
  889.  
  890.  
  891.   Shop Ownership Status Revocation:  {added 10/22/2006}
  892.   ----------------------------------
  893.   * Effective Oct. 22nd, 2006, any Shop Owner player who uses
  894.     Foul Language a fourth time automatically loses their
  895.     Shop Ownership Status.  This final Foul Language penalty
  896.     for Shop Owners was designed in September 2006.
  897.  
  898.   End of Foul Language section.
  899. =============================================================
  900.  
  901.  
  902. If you spot any bugs, please report them to me.  I can NOT fix
  903. problems that I have no knowledge of, after all.
  904.  
  905. Thanks Donald Tidmore.
  906. =========================================================
  907.  
  908.   
  909. This ShopRead.txt file was created on Mar. 10, 2006.
  910.  
  911. All Pawn Shop files are Copyright 2002-2006 by Donald Tidmore.
  912. And some are Copyright 2002-2006 by Chris MacPherson.
  913.  
  914. The SHOPEDIT files are Copyright 2005-2006 by Donald Tidmore.
  915. The PAWNCONV files are copyright 2006 by Donald Tidmore.
  916.  
  917. Revised on December 03, 2006.
  918.  
  919.