Civ3MultiTool - README
   By Gramphos


What is this?
-----------------------
Civ3MultiTool (C3MT) was former named Civ3CopyTool (C3CT). It got that name for the first functions it had: to copy parts of BIC-files that contains the Civilization III (Civ3) rules.
Now it is extended to allow editing of Civ3 saved games (SAVs) with an integrated tool. And has been renamed to C3MT.
It has yet again been extended to include an editor for Civilopedia.txt.

How to use this tool
-----------------------
- The CopyTool
To start the copytool at once, pass /c3ct, or /ct to the EXE.
The CopyTool is made for advance users, and it can be really hard to get copied stuff working, and some stuff never work.
I don't guarantee that anything that has a field in the Interface can be copied and is supported by Civ3.
First you have to select a BIC-file toy use. A BIC is a file created by the game editor included with Civ3.
When done you simply enter how many copies of each thing you want and select copy.
To edit the copied things you should use the game editor included with Civ3. However can some fields be changed by the copytool.

- The SaveGame Editor
The SaveGame Editor is made to be more user-friendly then the CopyTool. Still it can be hard to use.
The SaveGame Editor can either be started from the CopyTool main window, or by passing /sge to the main program file while starting it.
To edit a file: Select File-Load and select the SAV to load. When it has loaded you can change things with the interface.
To find a specific unit or city to edit you can use the Filter-function.
If you have a file that you want to use defined starting locations for, you can, if a CPF exists, load them from a CPF.
Then all units are moved and the map and fog of war is set according to that file.

- The Civilopedia Editor
To start the civilopedia editor at once, pass /pedia to the EXE.
The Civilopedia editor has one list of entries, two text fields (default and description), a toolbar and a menu bar.
With that is it possible to edit the entries of the Civilopedia.

FAQ
-----------------------
Q: The tool crashes at startup with unexpected error or missing OCX error message. What am I doing wrong?
A: You miss some VB-runtime. They are too big to keep in the zip as this tool is updated often.
   The OCX-file needed can be downloaded at Microsoft
	http://activex.microsoft.com/controls/vb5/COMCTL32.CAB
	http://activex.microsoft.com/controls/vb5/RichTx32.cab
   Extract the CAB, right-click on the INF and select Install
   The VB5 runtimes needed can also be downloaded:
	http://download.microsoft.com/download/vb50pro/utility/1/win98/EN-US/Msvbvm50.exe

Q: Where can I find new versions of this tool?
A: The tool is posted at Apolyton and at Civfanatics when changes are made.
	http://apolyton.net/forums/showthread.php?s=&threadid=31391
	http://forums.civfanatics.com/showthread.php?s=&threadid=7787

Q: I miss something in this Readme.
A: Post in any of the above listed threads what your problem is, and I'll try to help you.

Q: I've created a .MOD / .CPF -file and want to distribute your tool with it. Can I do so?
A: As it stands right now I have to say no, as I want to be able to update the tool at any time.
   You may link to any of the threads where the tool can be downloaded, and write a description on how to use it to use what you have done.
   I also have another tool for CPF files, which can be included with your files.

Q: Why doesn't the SGE work with 1.21f?
A: The compression is very high, and without knowing anthing of it it is really hard to
   find a decompress routine.


Files in this ZIP
-----------------------
Readme.txt - this file
C3MT.exe - main program file for both The CopyTool and the SaveGame Editor
SaveGameEditor.bat - Command script that starts the SaveGame Editor
C3CT.bat - Command script that starts the CopyTool
example.cpf - an example Civilization Position File (CPF) that shows the syntax of the file, but doesn't work with any map
marla.cpf - a CPF that works with Marla's world map.


Version history
-----------------------
Perversion-number versions 
CopyUnit - A prototype that could copy only units 
That version later got a worldsize and civilization copy function. 
When the Tech copy function were added the program was renamed to Civ3CopyTool 
Next version supported buildings, but had a bug duplicating a value in the BICs and a new version were created. 
Next change was an addition of Eras, but they were disabled (among with the civ copy) in the next version, that featured resources and terrains. 
Bugs with Tech copy fixed and Citizens added in the next version. 
The next could copy civs again after some modification had been made. 
In the version after that the ability to rename units that were copied, and in the same time copy the graphics were added. 
It contained a bug, which was removed with the last unnumbered version. 

v0.51 
- The new civs can now automatically build the same units as the original civ 

v0.60 
- Export and import of a civ added. 
v0.60.0003 
- bug with import dialog fixed 

v0.61 
- units can be exported/imported 
v0.61.5 
- bugs with import tool fixed 
- import tool improved 

v0.62 
- export function improved to export more then one civ to the same file. (The import function can import files with multi civs since v0.61.5) 

v0.63 
- bug that made the tool not to load when the rules were changed fixed. 
- interface slightly modified 
v0.63.1 
- bug that made the tool not to load when governments had been added fixed. 
v0.63.2 
- some code worked over. 
- If you copy a wonder the wonderscreen is copied as well. 

v0.64 
- Maps can now be imported, exported and removed. 
v0.64.0001 
- Bug that made the file corrupt when removed a map corrected. 

v0.65 
- Building Icons, Wonder Splash Screens (if Wonder) and Civilopedia entries (if changed) are now copied for BUILDINGS 

v0.70 
-A Savegame editor (for units) has been added 
v0.70.1 
-bug with unit movement fixed 

v0.71 
-The SaveGames are now read and written safer, and the owner of a Unit can be changed (not just the nationality) 

v0.72 
- A filter has been added to the built-in Save Game Editor (which from now on also can be started with the parameter /sge) 

v0.73 
- Difficulty level in Saved Games can now be changed 
v0.73.5 
- Can correct corrupt SAVs that has the "DATAIO Operating System Error: CITY" after the last settler of a civ was killed on a boat/ship. 

v0.74 
- Fog of War can be reset 
- Rules in games can be changed 
v0.74.1 
- bug with FOW reset at the edges of the MAP fixed, and the map now doesn't sometimes miss parts of the reset. 

v0.75 
- Civilization Position Files added. 
- Year changeable 
v0.75.1 
- bug with FOW on rectangular maps fixed 
- marla.cpf added
v0.75.5 
- Improved CPF-functionallity: Entered civ names can be located. 
- New FOW functions. 
v0.75.6
- Some more Error handling added to the unit loading
- this readme file included in the ZIP for the first time
- the BAT to start the SaveGame editor added
v0.75.7
- Bug that made it impossible to save games with years later then 1950 fixed.
v0.75.8
- Bugs with the Filter fixed.

v0.76
- Units can now (hopefully) be added to savegames.
- Lockup bugs when load failed taken out
- All controls are now locked when no file is loaded (Also if I forget to gray one) to prevent some really bad bugs.
- The Map and FOW functions have been slightly improved to not miss some cases of FOW
v0.76.1
- Bugs with Import/Remove Map functions corrected

v0.77
- Maps can partly be exported from SAVs
- Goodie huts can be removed from SAVs
v0.77.1
- Rivers can be exported

v0.78
- Units can be deleted
- Maps can be made Flat
v0.78.1
- Support for files created with Civilization III v1.16f added
v0.78.2
- Bugs with Patchsupport fixed
v0.78.5
- Some more bugs with the CopyTool and patch taken out
- The CopyTool will no longer end after a copy process
v0.78.55
- Bug with Maps fixed
v0.78.9
- Missing EOF bug fixed
- Some things in development with the editor might be errors with. (Didn't have time to deactivate it)
v0.78.91
- 2:nd (and hopefully last) Missing EOF bug fixed
- Can be minimized

v0.80
- Some parts of the Cities can now be edited
v0.80.1
- The Copy Routine has been totally rewritten to totally eliminate Seek errors and be able to keep the loaded BIC-version.
- The full Unit directory is no longer copied. Instead only the ini, which are edited to still use the old files.

v0.81
- Many small bugs in v0.80 and subversions fixed.
- More fields added to the City-editor, but all doesn't work for 100%.
v0.81.01
- Bugs with the new fields in the City-editor fixed. (Culture is now summed correctly)
v0.81.02
- Bug when loading Save without cities fixed.
v0.81.03
- Bugs with copied/added resources fixed for BIC input/output
v0.81.04
- 'Loaded on'-field added to the units.
v0.81.1
- The new BICOutput is now used by all functions.
- Common Dialog Boxes are now called from DLLs, which hopefully will take out the biggest problem with the runtimes.

v0.82
- Maps can be imported to saved games.
v0.82.01
- Bug with BIC load/save in a map section corrected.
v0.82.02
- Bugs fixed in Saves with Units being changed type while changing cities in the list
- The Current research target can be edited.
v0.82.1
- Allows you to genarate CPF-files for maps
v0.82.11
- Sight is now calculated more accurate (hopefully correct) (hills don't stop you from seeing mountains as in the first calculation)
v0.82.2
- A Unit Organizer has been added. Now you can move the units in the BICs.
- An option to not automaticly save the BIC at copy added. (Don't ask me why)
v0.82.2001
- Bug with the Unit Organizer fixed. if you moved a unit with the last version move it back before upgrading or restore the Upgrade to fields by hand.
v0.82.2002
- The wondersplashes are now added at the end of the list
- The log file no longer logs normal startups
- The pediaicons.txt should (I hope I got it right this time) not lose the last line every time a building is copied.
v0.82.21
- Start year and End year of a SAVE can be edited
- Popup added when copy is done.
v0.82.22
- Citizens can be edited
- All Tabs now have tabstops in logical order
- The City list is sorted.
v0.82.225
- More parts of Citizens can be edited (Not tested mush)
- Citizens can be moved. (No calculation of production is made)

v0.83
- The tool was renamed to Civ3MultiTool
- The default startup now starts a main menu
- New flags added to automaticly start the CopyTool
- Unitis with ERA-specific graphics are now copied right
- The city editing now shows the units in the city
- In the unit tab, cities can now be selected to quick move a unit to a specific coordinate.
- Bug when the last line of INI-files fell out on copy fixed
- Citizens can be added/removed from cities
- Cities can be moved (no calculation of production is made)
- Civilization frame has been disabled by default to aviod questions on it
v0.83.0002
- Bugs that didn't allow sub windows for the CopyTool if opened from the main menu fixed.
- Bug with the remove huts optin for saves fixed
- Remove huts option added to the Map options for BICs
- The map options for BICs no longer uses the old system of BIC handling
v0.83.0003
- Bug with not being able to add units to saves fixed
- Ability to remove cities added (untested only)
v0.83.0004
- The load and save procedures of the Saves have been changed to not miss some data in very rare cases.
- The splash screen now closes when the savegame editor starts directly
- Errors with saves without cities have been taken out (there might still be some left)
- Bug with unit addition #2 fixed.
v0.83.0005
- Changed to fully work with v1.17f files.
v0.83.0006
- Bug with sight editing that was created when made to work with v1.17f fixed.

v0.84
- Added statistics for map in the CopyTool
- The BIC compare function has been improved to show the stats of added units
- The Filter function in the Save Game Modifier has been extended to involve parts of Cities
- Eras has been flagged as unfinished (this does not mean that they can be added, but that you can experiment with them)
- Bug with units not udating when adding another unit to a savegame has been fixed
- New units now defaults to the civ using slot 1 (human player)
- Loaded on list now only shows unit on the same tile
- Loaded on defauts to NONE for new units
v0.84.0001
- Bug with saves without cities fixed.

v0.90
- A Civilopedia editor has been added (started with /pedia)
- Some crash bugs fixed

v0.91
- CopyTool upgraded to work with 1.21f.
- SaveGame Editor disabled for1.21f (should still work with earlier versions)'
- Civilopedia editor output improved to preserve new lines between comments
- Minor bugs fixed
- Length calculation bug in BIC output fixed
- Popup messages and string constants moved to textfiles.
v0.91.0001
- Bug with Output of new difficultylevel data fixed


Credits
-----------------------
Thanks to heardie for the new splash screen

Trademarks
-----------------------
Civilization, Sid Meier's Civilization and Civ are registered trademarks owned by Infogrames.