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.
Now it also features a unit creation wizzard.


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.

- The Unit Creation Wizzard
This tool takes you from the first to the last step of adding a Unit to a BIC. It's intigrated with the Civilopedia editor to make it easy for you to write a Civilopedia entry directly.
You can specify what animation files to use, and set up the unit entierly from the wizzard without need in to use the editor.


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=&referrerid=9561&threadid=47897
	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.




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.
SAVExpnd.exe - A decompressor for 1.21f saves
c3mt.txt - English language file (no overrides)
c3mt.*.txt - Other language files



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

v0.92
- SaveGame Editor now works with 1.21f
- New Rules added to the SGE
- The CopyTool now handles multiplie streategies for units
- Some fields resized to fit the German text
- Bug with CivID assigning corrected (you can still not safely add civs)
v0.92.5
- Language chooser added
- Bug in the SaveGame Editor where an unstopable popup loop would hit the one who changed a specialist to a laborer fixed
- The Map Import and Export functions now work with 1.21f saves.
- The FoW reset in the SGE now calculates the FoW based on the terrain and if the unit has radar ability.
- Bug where translation of the 'Add #' labels only would affect one label
- The SAVExpnd.exe can now be called using SAVExpnd.exe "Compressed file" "Uncompressed file" 
v0.92.5001
- Problem when just one language file exists fixed.
v0.92.5001 SR1
- The SAVExpnd.exe is now the correct one.

v0.93
- Unit Creation Wizzard Added
- Civilopedia Editor now allows editing Civilopedia Icons
- The Description and Text field of the Civilopedia editor can be resized
- The CopyTool now has an option to Open a map window similar to the one earlier only in the SGE
- The MapWindow in the SGE now has a little flashing ellipse where the selected Unit/City is.
- The Map resizes (scaled, not redrawn) to fit the MapWindow when window is resized
- SplashScreen is now showed (with or without progressbar) while loading the terrain graphics.
- Bug with one of the terrainsets being wrong file in Map Window fixed.
- The Export/Import function for Units and Civs (which won't work, as the game crashes when civs are added) has been updated to unce again work. (I don't think they have worked since 1.07f)
- The Unit Organizer support for Multiple strategies has been extended
- Bug which made pre 1.21f maps unloadable corrected.
- Problem with default values when loading pre 1.21f Units fixed.
- Option to always backup files added
- Option to load civ3mod.bic if no rules are in the BIC loaded when starting the Civilopedia editor added.
- Crash bug when caceling the start of the Civilopedia editor from the CopyTool corrected
- All main toolparts now show up in the taskbar. No matter from what command they were started.
- Problems with not being able to start some tools in certain orders has been corrected.
- Crash at first startup if 0-length textfile existed in the C3MT dierctory (Input past end of file error) fixed
***Fixes after the beta release***
- Index crash bug in SGE fixed
- The Civilopediaeditor now stays the same size even with multiple additions being made.
v0.93.5
- Fixes bug were a unit has to have Bombard Range greater then zero to set Air Bombard strategy in UCW
- Added brows buttons to Animation and Sound files in UCW
- Added Special flags to Units in SGE
- Bug where new icon entries aren't grouped correctly in pediaicons.txt fixed.
- Rules are now imported and exported among maps from saves.


Credits
-----------------------
Thanks to heardie for the new splash screen
Thanks to Douglas Kane, foster_fc@yahoo.com, for making a public domain code without restriction for decompressing small PKWARE Data Compression Library compressed files. (It has ben modified to work with lage files)
-------------
German version by BeBro
Polish version by Mendax
Russian version by Montezuma

Trademarks
-----------------------
Civilization, Sid Meier's Civilization and Civ are registered trademarks owned by Infogrames.
PKWARE Data Compression Library is a registered trademark of PKWARE