10.00:  Player Database Converter Section:  Jul. 12, 2007
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

Kiteria's LORD Bank - CONVBANK.TXT
Player Database Converter Utility program docs

* CONVKB10.EXE v1.00 was officially released on March 14th, 2006.
* Released CONVBANK v1.10, as CONVKB11.EXE, on July 29, 2007.

Docs and DIZ file for CONVBANK.EXE revised Sept. 17, 2007.

* CONVBANK v1.20 was officially released on Sept. 18th, 2007.
  It replaces the CONVKB11.EXE utility released in July.
----------------------------------------------------------

Official download links for CONVBANK.EXE v1.20:

http://camelot.legendarydragons.com/LordApps/convkb12.zip
http://www.filegate.net/camelot/lordfile/convkb12.zip
=============================================================

ConvBank files were updated for Kiteria's LORD Bank v1.70's
release.  CONVKB11.EXE is replaced by CONVBANK.EXE v1.20.

Those who are updating from v1.60 to v1.70 do NOT need to
use the ConvBank utility again.  Use only the Conv*.* files
that are bundled inside BANKWORK.ZIP currently, and inside
KLBANK17.ZIP and CONVKB12.ZIP, which will be released on
Sept. 18th, 2007.

http://camelot.legendarydragons.com/LordApps/klbank17.zip
http://www.filegate.net/camelot/lordfile/klbank17.zip
=======================================================


Beta Testing download links:  For CONVBANK.EXE v1.20:

http://camelot.legendarydragons.com/IGM-Beta/convbank.zip

Note: ConvBank.zip contains the convbank.* files used during
      each cycle of the utility's development.

The Convbank.pas source code is included with the utility
inside the CONVKB12.ZIP archive.
=======================================================


Who CAN and/or SHOULD use this program?
----------------------------------------
** People updating from Kiteria's LORD Bank v1.60 to v1.70
   do NOT have to use CONVBANK again.
-------------------------------------------------------------

1. IF you are using Kiteria's LORD Bank v1.50, you MUST
   use this program to create a new IGM player database file
   that can be used with K.L. Bank beta versions 1.51 through
   1.59.  That is if you intend to start using the current betas.

2. Anyone using the current beta who has NOT previously
   updated from version 1.50 of the IGM has to use this program.
=========================================================


Why do you need to use CONVBANK.EXE?
--------------------------------------------------
The current IGM uses a different player database file structure
than K.L. Bank v1.50 did. Therefore the v1.50 BANKPLAY.DAT file is
INCOMPATIBLE with the current IGM program.  The structure is
brand new and usable ONLY with Kiteria's LORD Bank v1.60, or
its 2007 beta versions.

** The current IGM's player database record structure is not
   compatible with K.L. Bank v1.50.  There are various reasons,
   but the main ones are as follows.

   (A) The player database structure was altered in mid-January
   2007, following the official release of K.L. Bank v1.50.

   (B) This version uses one renamed player database variable,
   a brand new player database format, and three brand new
   variables for Gems_Int, Paid_GemsInt, and Paid_CharmTax.

   Everyone *SHOULD* use KLBEDIT v1.50 when you use CONVBANK.EXE.
   It can *NOT* be used with CONVKB10.EXE, which is only for
   use with version 1.50 of the Kiteria's LORD Bank IGM.

   KLBEDIT v1.40 was recompiled as version 1.50 on 09/18/2007,
   and works the same way as version 1.40 does.
============================================================


How is CONVBANK.EXE used?
--------------------------------------------------
CONVBANK.EXE and KLBEDIT.EXE are bundled inside the K.L. Bank
beta distribution archive, BANKWORK.ZIP.  Obtain a copy from
me via Email, using ktidmore@bellsouth.net or gtidmore@hiwaay.net.

The CONVBANK.* files are included inside BANKWORK.ZIP with
the exception of its source code files.

Note: ** The CONVBANK files are updated for K.L. Bank v1.70's
release, and distributed inside KLBANK17.ZIP and CONVKB12.ZIP.
----------------------------------------------------------

The copies posted of BANKWORK.ZIP on the Camelot LordNews FDN
site (and its mirror sites), on the BBS Archives servers
operated by Mike Ehlert, and on my Castle Camelot web-site, are
not always up-to-date.
-------------------------------------------------------------

Everyone is to use the CONVBANK.* files which are stored in
the KLBANK17.ZIP official release archive for K.L.Bank v1.70.
-------------------------------------------------------------

Update process from K.L. Bank v1.50 to v1.60/v1.70:

1) Run Kiteria's LORD Bank v1.50.  Do anything you wish to
   do inside, and then exit the program.  Then exit LORD
   as well.  Do NOT try ANY of these conversion steps while
   the IGM is in use!

2) Copy your existing BANKPLAY.DAT file to KB15PLAY.DAT.

   Make backup copies of BANKPLAY.DAT and BANK-USE.TXT.

   Print your current BANK-USE.TXT file for a hard copy of
   the IGM Player Database record values for each LORD
   player who is currently using the KLBank IGM.  (Optional)

3) Change into the K.L. Bank IGM directory.  Then unzip the
   files from KLBANK17.ZIP, using overwrite mode, into the
   IGM directory.

4) Run CONVBANK.EXE.  It automatically processes the KB15PLAY.DAT
   file and creates a new BANKPLAY.DAT player database file.

   You only need to run the CONVBANK.EXE program ONE time.
   At this point, you can move all of the CONVBANK.* files
   into a sub-directory or you can delete them.

   The old CONVKB11.* files can be deleted at any time.

5) Now run KLBEDIT.EXE v1.50.  (Distributed inside KBEDIT15.ZIP,
   and KLBANK17.ZIP archives.)

   Check each record visually for any glitches.

   Use the printed copy of BANK-USE.TXT to verify that each
   player's Gold and Gems Bank balances are correct.  Then you
   can exit the program.

At this point, the player database file is now fully compatible
with Kiteria's LORD Bank version 1.60 and v1.70.
=============================================================


ConvBank Development History:
==============================
* Created file CONVBANK.txt on Oct. 21, 2005.

* Resumed usage of CONVBANK.* file names on Jan. 26th, 2007.
  The first version used CONVKB10.* file names.

* Started using CONVKB11.* names for ConvBank v1.10 on
  July 29th, 2007 during final official release processing
  of the Kiteria's LORD Bank v1.60 program files.

* Sept. 18th, 2007:  Re-released CONVBANK v1.10 with new docs
  as part of release of Kiteria's LORD Bank v1.70 IGM.

===============================================================
The CONVKB10.*, CONVKB11.*, and CONVBANK.* files are all
Copyright 2005-2007 by Donald Tidmore;  and Copyright 2005 by
Donald Tidmore and Stephen Gibbs - who created the initial
program for me in 2005.

----------------------------------------------------------
Mar. 14, 2006: Officially released CONVBANK.EXE utility,
               using program name CONVKB10.EXE.
               Along with KLBEDIT v1.20 utility.

June 25, 2006: Created KLBEDIT v1.30.  Fixed problem with its
               cursor flashing on-screen found by a friend.

Jan. 06, 2007: Revised menu codes usage, and screen layout
               used by KLBEDIT v1.30 to incorporate unenabled
               entries for 2 Gems Interest database variables.

Jan. 13, 2007: Officially released KLBEDIT v1.30.
               Updated the CONVKB10.DIZ and CONVKB10.TXT files.

               Officially released K.L.Bank v1.50 IGM.
               Distribution was done on/around Jan. 13, 2007.

Jul. 29, 2007: Created ConvKB11.EXE using ConvBank.pas file,
               renamed to CONVKB11.PAS.  ConvBank v1.10 was
               released on July 29th, 2007;  Distribution was
               done on July 31th and August 01th, 2007.

Sept. 18, 2007: CONVBANK v1.10 re-released with new docs as
                part of Kiteria's LORD Bank v1.70's release.
                Program name changed back to CONVBANK.EXE.
------------------------------------------------------------

End of CONVBANK.TXT Section.
=============================================================

All Kiteria's LORD Bank IGM files are Copyright 2004-2007
by Donald Tidmore.

KLBEdit files are Copyright 2005-2007 by Donald Tidmore.

The CONVKB10, CONVKB11, and CONVBANK files are Copyright
2005-2007 by Donald Tidmore and Stephen Gibbs.

Spell-checked file on Sept. 18, 2007.

Revised on:   September 18, 2007 at 01:24 pm.

