CIV3BREED v0.4.6 
-----------------------------
(C)2001 by Mortioso
Only distribute the executable together with this text file please.


LEGAL STUFF - Blah Blah
-----------------------------
All trademarks and trade names are the properties of their respective owners.
I disclaim any proprietary interest in those trademarks and trade names.
I am in no way affiliated with those companies or trademarks.


DESCRIPTION
-----------------------------
CIV3BREED is a command-line tool for patching save files.
It uses a text format C3B file which contains starting locations for all civs. 
It also has two variants of reveal map, with or without 'fog-of-war'.
Anyone who wants to play a scenario with correct starting locations, just has to follow these steps.

1. Create a C3B file.
2. Start up the scenario in Civ3.
3. Save the game.
4. Exit the game and run the tool. (Alternatively ALT+TAB or CTRL+ESC out from Civ3 and then run it)
5. Start the game if it's not running, and load the new savegame with correct starting locations.


USAGE
-----------------------------
Copy the tool to your CIV3\SAVES directory. 
Put the C3B file in your CIV3\SAVES directory. 
Then run it there. It will ask for 
1. Save file to read
2. C3B file to read
3. Save file to create

ALTERNATIVELY you can use command line syntax:

civbreed savefiletoread c3b-file savefiletocreate [option]

Examples:
civbreed savefile.sav marla.c3b correctstart.sav
civbreed savefile.sav marla.c3b correctstart.sav -r
civbreed savefile.sav marla.c3b correctstart.sav -f

Option -r reveals the whole map, including 'fog-of-war', but it will reappear around units when moving them, as the game updates the map. This way you can actually see what is happening all over the world, which is not a good idea if there are a lot of units, because it will take forever to watch them move, at least on my computer.

Option -f reveals the whole map, but leaves the 'fog-of-war' on.


Creating the C3B file
-----------------------------
A file has been supplied, it's named map.c3b, you have to modify it for the map you want to play.
You could also copy the lines below which I used for Marla Singer's World Map and modify accordingly.

<Select and copy lines after this tag>
[C3Bv046]
Rome 133 61
Egypt 144 76
Greece 141 63
Babylon 154 70
Germany 134 48
Russia 148 42
China 205 63
America 71 61
Japan 224 68
France 127 53
India 179 81
Persia 164 76
Aztec 54 84
Zululand 143 143
Iroquios 67 57
England 125 45
<Select until before the beginning of this tag>

Now for example save the selection as 'marla.c3b'.
If you have another map, look up starting locations for all civs in the civ3edit tool supplied with the game and edit the file, or use a C3B file supplied by someone else.

Important:
1. Header must exist, as it appears.
2. All civs must be specified and in the same order as above.
3. Format is: civname X Y
4. Spaces must appear where they do above.
5. If X is even, Y must also be even.
6. If X is uneven, Y must also be uneven.

Starting locations at edges of the map will not work due to a limited parsing algorithm implementation. This might be fixed in a later release.


HISTORY
-----------------------------

0.4.4
-----
- First public release.

0.4.6
-----
- C3B files now have new header. Format has not been changed in other ways. Old C3B files will work if you just change the header tag from [C3Bv44] to [C3Bv46]. It's there for consistency.
- Fixed error messages.
- Fixed file opening error that could occur in some circumstances, when it happened, the program would crash.
- Added 'ask for files' when no parameters are supplied, which makes the tool easier to use.
- Added reveal with 'fog-of-war' on.
- Revised this file.


AND FINALLY
-----------------------------
Use at your own risk! If not, you shouldn't be using this tool. =)
This program uses less than minimal error handling. 
Modified rules might break things, who knows?