The 4th Coming - Inventory Dumper
Version 0.5 (10-26-01) 
Copyright (c) by Telias GaH (RisingEagle@gmx.net)

This  program  shall  help  you  to  create  lists  of  your inventory. It
produces  an  itemlist  but  there  will  not be any information about the
quantity.

===================================
Important Information (please read)
===================================

How to Dump
-----------

When you start t4cdump (you must have played on a t4c server before), you
can select an account and the character to dump. Notice that you can only
see those characters you have played with on this computer.

Keep these steps in mind to dump correctly:
1) run t4cdump, select account and character
2) press 'Backup' (new)
3) login with the account/character you just prepared
4) press 'Dump'
5) press 'Restore' (new)


Internet Usage
--------------

For  those  who are afraid of using a program which accesses the internet
with  private data (in this case: account/password information) I want to
explain what the update function does:

It sends an HTTP GET request to the server saved in the option screen and
saves the language files received in return. No other information will be 
transmitted.

Verify  this by checking the MD5 Hash and test t4cdump with a free packet
sniffer (for example Analyzer or Ethereal).


Unknown Items
-------------

Until  more IDs are added to the datebase, you might get some lines like:

      Unknown Item at position 00, 03 (ID: 0000040901)

This  means the item hasn't been identified and included yet. Please look
at the position in your inventory and write a mail with the item name and
ID.


How to identify ItemIDs
-----------------------

To identify, you need to look at your inventory. It consists of 4 columns
and several (as much as you need ;) rows:

       col0  col1  col2  col3
row0:   x     x     z     z
row1:         y     z     z
row2:         y     z     z
.
.
.

Now  think  of x, y and z as three items (x = gold, y = diamond, z = some 
cloak) and you might wonder which position you will see in t4cdump. It is
always  the  upper  left  corner  (x: col0, row0; y: col1, row1; z: col2, 
row0).

So you would get the following Unknown Item lines:
Unknown Item at position 00, 00 (ID: 0000012345) <-- gold
Unknown Item at position 01, 01 (ID: 0000054321) <-- diamond
Unknown Item at position 02, 00 (ID: 0000024680) <-- some cloak

You  just  need  to remember that the upper left corner of your inventory
has the position 00, 00 (not 01, 01 as you may assume) and that the first
value defines x, the second y.


======================
Additional Information
======================

Backup/Restore
--------------

Use this to prepare the dump. After pressing Backup you need to start t4c
(use  the  character you want to dump). When you don't need the temporary
data  anymore,  use  Restore  to make sure your inventory hasn't been re-
arranged.


Update
------

You  don't need to download the new database files manually anymore. This
downloads  and overwrites the current database files with the latest from
the server entered in the options.


Options
-------

Opens the option window:
 - URL       : server to download new database files
               Default: http://www.geocities.com/telid4o

 - Language  : language to use for dump (itemnames)
               Default: German

 - Auto-Clear: Enabling  this  will disable the Backup/Restore buttons.
               When  dumping, the inventory will be cleared and t4cdump
               waits  for  the  user  to log in with the character. Use 
               this if you don't care about the inventory arrangement.
               Default: off

 - Generate  : Generates a list of identified items in the selected
               language.


Remove Character
----------------

This button removes the character from the character list by deleting all
of the temporary data (including your macros). Do this for example if you
changed  your  name and don't need this character anymore. You can remove
the account after deleting the last character entry.

Notice  that this will NOT remove character or account information from a
t4c server. All data erased are the temporary registry entries.


History
-------

Version 0.5 (10-26-01): (+) update database (using internet)
                        (+) option window, options will be saved at exit
                        (+) auto-clear inventory option (disables
                            backup/restore)
                        (+) support for different language files
                        (!) changed memory access functions
                        (!) fixed many memory leaks
                        (!) fixed 'no-more-character'-bug when using
                            'remove'
                        (-) refresh

Version 0.4 (10-04-01): (+) backup / restore
                        (+) refresh reloads data-file
                        (+) remove character data
                        (+) show number of identified items
                        (+) generate item-list
                        (-) clean

Version 0.3 (09-12-01): (+) hide standard items
                        (+) sort item-output
                        (+) show position of all items

Version 0.2 (09-05-01): first public version
