CivPlacementTool v1.01 BETA - readme
--------------------------------------
   By Gramphos



CivPlacementTool (CPT) is made to move civs in a Civilization III save game.
It uses the same format (CPF) as Civ3CopyTool (C3CT), but does NOT require any part of C3CT to run.
CPT is programmed in C++, and should be easier to get running then C3CT. It is also smaller, and it is harder to corrupt a SAV.

CPT does not currently have full support for all functions in the CPF format, but the must common functions are in.

CPT also has mush less error handling then C3CT, and can't load corrupt SAVs.


Version history
--------------------------------------
v1.00
- Can move civs according to a CPF-file, and get the FOW right.
v1.01
- Takes command line parameters


Command line syntax
--------------------------------------
CPT [/nodone] [save] [cpf] [newsave]
/nodone - can always be passed; makes the tool not to popup a MessageBox when finished
save - can always be passed; If any space is in the name it must be quoted ("save game.sav"). Is the file that shall be changed.
cpf - can be passed if a save is passed; If any space is in the name it must be quoted ("positions for mapx.cpf"). Is the cpf-file that shall be used.
newsave - can be passed if a cpf is passed; If any space is in the name it must be quoted ("new save game.sav"). Is the file that shall be changed.


List of unsupported functions
--------------------------------------
* CPT does not read any Rules, and uses only the ID for not in-game-renamed civs.
* Only the default FOW format for the CPF-files is supported (but the alternate (original) format is not official, so that shouldn't hurt anyone but me)



The CPF-file format
--------------------------------------
The CPF-file format is based on sections, of the type
@BEGIN SECTION
...
@END SECTION
The main-section for each civ is CIV, and it contains a FOW section
the CIV section shall contain the following lines:
NAME=CIVNAME 	- The name of the Civ. (case sensitive)
ID=CIVID 	- The ID of the Civ in the game. They are listed in the ID order in all combo-boxes in the game
		  If you use a name not in the rules, set this value to -1
CORDS=X,Y	- The starting position of the CIV. The coordinates can be seen in the editor.
@BEGIN FOW
SIGHT DATA
@END FOW
The SIGHT DATA is rotated up.
xxx
xox
xxx
is a sight as the smallest city border.
and does in the game look as
  x
 x x
x o x
 x x
  x
o=the coordinate of the units
x=in sight
' '=out of sight
The same example with numbers for each cross showing how it is rotated:
----------
123
4o6
789
----------
  3
 2 6
1 o 9
 4 8
  7
----------


Where can I find updates to this tool?
--------------------------------------
I'll post this tool at Civfanatics and Apolyton.
the next version will include the thread URL. Until that is up you could check the C3CT threads, as I'll post a link to the new threads in them.
The CPT threads:
	http://forums.civfanatics.com/showthread.php?s=&threadid=11829
	http://apolyton.net/forums/showthread.php?s=&threadid=37749

The C3CT threads:
	http://apolyton.net/forums/showthread.php?s=&threadid=31391
	http://forums.civfanatics.com/showthread.php?s=&threadid=7787


Redistribution
--------------------------------------
This tool is not as subjected to change as C3CT, and I'll allow any map creator to include it with his map.
As long as this readme is maintained, and the site where they can check for updated versions of this tool is listed in your own readme.
You should also always check if a new version has been released before upgrading your version.


Contact
--------------------------------------
To contact me mail to: viktor.griph@edu.norrkoping.se
Real name: Viktor Griph


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