Civ3CopyTool - README
   By Gramphos


What is this?
-----------------------
Civ3CopyTool (C3CT) was first made to duplicate parts of the 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.


How to use this tool
-----------------------
- The CopyTool
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 C3CT.

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

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
   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: I downloaded the files, but I still get an error. Can I use this tool?
A: Try to find the comdlg32.ocx on your HD. Delete it, and install that CAB again.

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.

Files in this ZIP
-----------------------
Readme.txt - this file
Civ3CopyTool.exe - main program file for both The CopyTool and the SaveGame Editor
SaveGameEditor.bat - Commandscript that starts the SaveGame Editor without fully loading the CopyTool first
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 oyu moved a unit with the last version move it back before upgrading or restore the Upgrade to fields by hand.
- 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.

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