==========================================================
CSPL EXAMPLE SAVE GAME
by Angelo Scotto
e-mail:scotto_a@hotmail.com
==========================================================

This is a quick example of CSPL working.
Even if it is just an example and isnt playable at all 
i think its useful for three reasons:
1) it shows how future CSPL programs should be used
2) it comes with source code so it can be used by scenario
   designer as a tutorial,to understand how CSPL works 
   (even if without CSPL docs they can only guess ;o) )
3) it helps me to understand if CSPL works only on mine
   computer (which means Win98 and Tot 1.1) and to catch
   some bugs in the library code (so, feel free to write
   the author if you have problems in making CSPL working)

I feel its better to say explicitly here that the CSPL 
library is not present in this package, it only contains 
a program (csplclient.exe) written using CSPL library so 
dont try to realize other CSPL programs starting from the 
sourcecode included,they wont work, you have to wait for 
the library release.

===========================================================
REQUIREMENTS
===========================================================
1) Microprose CivII:TOT

It seems nothing else but as i said before i need to know if 
it works also on Tot without patch (i think so but havent 
tested), if it works on Win2000 (i dont think so but havent 
tested) or WinME (i have no idea)

===========================================================
LAUNCHING A CSPL PROGRAM
===========================================================
This is a standard rule: to launch a CSPL program you MUST
have TOT game loaded and opened on the scenario you want to
use with the CSPL program.
So usually you need to execute following actions in sequence:
1) Launch TOT
2) Load CSPL Scenario
3) Launch CSPL Program
In this test you have a SAV file instead of a SCN but this is
not important, simply Launch TOT, loads cspltest.sav and 
AT THIS POINT launch csplclient.exe.
If all goes well you should see the CSPL window/bar in the 
top-left corner of the screen: CSPL is up and running...

=============================================================
FEATURES OF THIS EXAMPLE PROGRAM
=============================================================
This program contains a couple of events which cannot be 
realized using the macro event language which comes with Civ2

1) Maps linked east-west:
Even if this program is a save game of Extended-Original and so
second map represent Alpha Centauri you should be able to see
how this feature could be used in historical scenarios linking
different parts of the earth east-west (A map for America another
for Europe and so on)
To test this feature i placed a some caravels on the east-west
border of each map, simply move them toward the border (the column
of tiles at X=0 coordinate) and see how CSPL take caravels and
move them as soon as they reach the border

2) Units which needs an improvement in the city to be built:
Romans have a city in this game, Aurelianorum, select it; it is producing 
a settler, try to change production to warriors, CSPL should 
warn you that warriors cannot be built in a city without
a barrack; give Aurelianorum a barrack using cheat menu and try to produce
again warriors, this time no warning happens!

3) Units which changes their type in a single user keypress:
CSPL can even detect user keypress, but only if they are directed 
to CSPL window/bar, in this example i used the 'e' key to transfor
settlers unit in engineers and viceversa; to use it simply select a 
settler on you map and activate CSPL window/bar (click on it) at this
point press the e key and the settler selected should became an 
engineer! (Anyway i found that this transformation can be slow: a second 
between the keypress and the transformation)

4) Events triggered entering in a particular square:
You have a cavalry unit at (12,10,0) try move it left, entering at 
10,10 of the first world should cause an event (which should raise 
your empire tresaury), but only the first time a unit enters it

DISCLAIMERS
------------
Copyright @ 2001 Angelo Scotto
All Rights Reserved. 

THIS PACKAGE IS COPYRIGHT FREEWARE. NO RESPONSIBILITY IS TAKEN FOR ANY DAMAGE OR LOSSES CAUSED BY THIS PROGRAM. THIS PROGRAM AND ASSOCIATED FILES ARE DISTRIBUTED AS IS. 

THIS PROGRAM MAY NOT BE SOLD, OR DISTRIBUTED FOR ANY COMMERCIAL PURPOSES, WITHOUT PRIOR WRITTEN APPROVAL FROM THE AUTHOR. 

PROGRAM DETAILS SUBJECT TO CHANGE WITHOUT NOTICE. 

All trademarks belong to their respective owners. 