CivDiplomacyTool v1.00 - readme
--------------------------------------
   By Gramphos



CivDiplomacyTool (CDT) is made to set up initial diplomatic deals in a Civilization III save game.
It uses files created by Civ3MultiTool (C3MT) saved in CDD (Civilization Diplmacy Data) format.
To use this too you must not have C3MT yourself, but to create CDD-files you need C3MT.

CDT is programmed in C++, and should be easier to get running than C3MT.

CDT is based on my earlier tool CPT which mean that it can be used to load CPF files as well. However, this ability is no longer being developed.
CDT does not have full support for all functions in the CPF format, but the must common functions are in.

CDT also has mush less error handling then C3MT, and can't work with corrupt SAVs.


Disclaimer
----------------------
This software is provided AS IS, and no warranty is given, on any part of the software. Viktor Griph is not responsible for any data loss caused by this program. By using this software the user takes all responsibilities for its actions.
If this software makes your saves corrupt, or saves manipulated by this software gets corrupt later you shall NOT contact Atari support.

Company Names & Trademarks 
Any and all company names, servicemarks, or trademarks referred to in this software, of course, remains their property and their use or mention in no way reflects the position of that company with regard to this program or any other item on or associated with the program. 


Version history
--------------------------------------
v1.00
- Work with saves in range from Civ3 1.07f to PTW 1.21f
- All features of CPT v1.05
- Can setup diplomacy deals (Goods are NOT handled).
v1.01
- Added support for CDD format revision 2
- Confirmed support for PTW 1.27f
- Currected bug in applyment of alliances that could corrupt a changed save.
- Corrected a small memory leak
- Fixed a problem where deals set up for civs or players not in the game could sometimes be assigned to other players.
- Added version info page



Command line syntax
--------------------------------------
CDT [/nodone] [save] [cdd] [newsave]
CDT /cpf [/nodone] [save] [cpf] [newsave]
/cpf - tells the tool to load a CPF-file
/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 and the /cpf flag is set; If any space is in the name it must be quoted ("positions for mapx.cpf"). Is the cpf-file that shall be used.
cdd - can be passed if a save is passed and the /cpf flag is not set; If any space is in the name it must be quoted ("diplomascy for scenarioy.cdd"). Is the cdd-file that shall be used.
newsave - can be passed if a cpf or cdd file 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
--------------------------------------
* CDT 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)
* Can't handle goods.



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
----------
Note if you have trouble figuring this out C3MT can generate the FOW data for you.

The CDD format
--------------------------------------
The CDD format is binarry and not included here. If you want to know the format contact me directly.


Where can I find updates to this tool?
--------------------------------------
I'll post this tool at Civfanatics and Apolyton.
The CDT threads:
	http://forums.civfanatics.com/showthread.php?threadid=54690
	http://apolyton.net/forums/showthread.php?referrerid=9561&threadid=87735
The C3MT threads:
	http://apolyton.net/forums/showthread.php?referrerid=9561&threadid=71802
	http://forums.civfanatics.com/showthread.php?threadid=54689



Redistribution
--------------------------------------
This tool is not as subjected to change as C3MT, and I'll allow any scenario creator to include it with his/her scenario.
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 file version.


Contact
--------------------------------------
To contact me mail to: gramphos@apolyton.net
Real name: Viktor Griph


Trademarks
--------------------------------------
Civilization, Sid Meier's Civilization, Civ, Play The World and Sid Meier's Play The World are registered trademarks owned by Atari.
PKWARE Data Compression Library is a registered trademark of PKWARE
Any and all company names, servicemarks, or trademarks referred to in this software, of course, remains their property and their use or mention in no way reflects the position of that company with regard to this program or any other item on or associated with the program. 