AI Help File Document

Age of Mythology™
© 2002, Microsoft Corporation. All rights reserved.

Important: Age of Mythology allows you to create your own AI scripts. You may share
these custom AI scripts for the purposes of gameplay, but you may not sell or make other
commercial uses of the custom AI scripts. Microsoft® reserves all other rights to the
editors and files.

AI Script Help File Document

The AoM AI scripting system is a very powerful system that allows the user to craft the
AI using the same language as the folks at Ensemble Studios. While this is a useful
enduser feature, it is officially unsupported.

The high level overview for creating your own random map AI scripts is as follows:
· Write your random map script.
· Add an XML file into your AI directory following the format of default.xml,
defaultboom.xml, or defaultrush.xml.
· See your AI appear in the list of dropdown choices when you run the game.
· Debug it using the ingame debugging facilities:
o Add “aiDebug” to your user.cfg file in the startup directory.
o When the game is running, hit ALT+SHIFT+D to bring up the debugger.
For a scenario, the steps are largely the same, except that you need to associate the AI
script filename with the right player via the scenario editor (Player Data dialog).

A list of the type enumerations and function calls that can be made from the AI scripts is
included at the end of this document.

AoM includes a source debugger for your XS scripts. This is accessed by including a line
with “aiDebug” on it in the user.cfg in the Startup directory of your AoM installation. If
you do not have a user.cfg file, create one with any text editor. Once this is in your
user.cfg, hitting ALT+SHIFT+D will bring up the debugger. Different XS runtimes (AI
for each player, triggers, etc.) will be available for debugging. The debugger is an
unsupported feature.

You can also use the “aiEcho(…)” syscall (see the syscall reference at the end of this
document) to print out debugging strings, etc. during the execution of your AI. To see
these, you must put a “showAIEchoes” line in your user.cfg.
Sample AOM Scripts
The following script code is a sample script from one of the AoM single-player scenarios.
As such, it does not demonstrate everything that is possible with the AI scripting system,
but it does provide a working example. More examples (including all of the script code
for the Random Map AI for AoM) can be found in the “AI” subdirectory of your AoM
installation.

I. Sample Script File

//==============================================================================
// Scn08p2: AI Scenario Script for scenario 8 player 2
//==============================================================================
/*
Overview:
The human player rescues Ajax from the Trojan army, then joins forces at the
allied TC. His goal is to build up and take out the red town to the north, without
the availability of siege units.

The CP sends one trivial attack early, which dies hopelessly to the HP's huge
army left over from the start. Several of the following attack rules are currently
implemented by triggers which attempt to build military buildings near
the HP's town.

The CP attacks down any one of three channels, with the west channel reserved for
higher difficulty levels.

No attempt is made to train units out of the forward buildings, even if the
feeble attempt to build succeeds. If the forward building concept stays in, we should
add rules to make a local army out of each building and use them for extra attacks.

CP starts as age 2 with Animal Magnet (not used) and Pestilence.

Age 3: Aphrodite: Curse
Age 4: Hephaestus: Plenty

*/
//==============================================================================

include "scn lib.xs";

// Globals
int lastAttackPlanID = -1; // Updated with plan ID as each attack is launched
int defendPlan = -1;

int reservePlan = -1; // Extra defend plan, higher priority, for final resistance
int startTime = -1; // Updated with start time when cinematic is done.
// In seconds.

int age3Time = 1500; // Time (in seconds) to go to age 3

int age4Time = 10000;
int siegeMaintainPlan = -1;
int mythMaintainPlan = -1;
int hopliteMaintainPlan = -1;
int toxotesMaintainPlan = -1;
int hippikonMaintainPlan = -1;
int villagerMaintainPlan = -1;

int routeWestPass = -1;

int routeNorthPass = -1;
int routeEastPass = -1;

// Initial settings are for the easiest difficulty level, others are set in main().
int nextAttackTime = 480000; // 8 minutes
float attackSize = 4.0;
float maxAttackSize = 9.0;
float attackSizeMultiplier = 1.2;
int attackInterval = 300000; // 5 minutes
float reserveSize = 15.0; // Army to keep in reserve
int attackCount = 0;
int trainDelay = 30;
int cavTrainDelay = 30;
int archerTrainDelay = 15;
int infantryTrainDelay = 20;

int builderQty = 1; // For forward building

int defendQty = 0; // For escort group

// Cinematic block markers

const string cbVillagerGather = "1872";
const string cbSiegeGather = "1873";
const string cbArcherGather = "1878";
const string cbCavalryGather = "1874";
const string cbInfantryGather = "1875";
const string cbP2TC = "1876";
const string cbGateEast = "1826";
const string cbGateWest = "1827";
const string cbWestPass1 = "1833";
const string cbWestPass2 = "1832";
const string cbNorthWestPlateau = "1834";
const string cbNorthEastPlateau = "1835";
const string cbP1Gold = "1831";
const string cbP1Granary = "1830";
const string cbSouthField = "1877";
const string cbEastPass1 = "1828";
const string cbEastPass2 = "1829";
const string cbP1TC = "1836";
const string cbNorthPass = "2272";
const string cbAttack2Stable = "1882";
const string cbAttack2Army = "1883";
const string cbAttack5Tower = "1880";
const string cbAttack3Army = "1881";

// Econ
int maxVills = 20; // Will scale with difficulty
int maxFishBoats = 0; // Including one to scout
float goldPercent = 0.25;
float woodPercent = 0.15;
float foodPercent = 0.60;
int gathererTypeID = -1;
int fishGatherer = -1;
int mainBase = -1;
float mainRadius = 100.0;
// *****************************************************************************
//
// Building plan support for forward building
//
// *****************************************************************************
int buildPlan = -1;
int buildDefend = -1;
// Set the following four vars, then just enable testBuildPlan.
int buildUnit = cUnitTypeTower;
vector buildVec = cInvalidVector;
vector startPoint = cInvalidVector;

rule buildPlanRule
inactive
{

buildPlan = aiPlanCreate("Build Plan", cPlanBuild);

if(buildPlan >= 0)
{
aiPlanSetVariableInt(buildPlan, cBuildPlanBuildingTypeID, 0, buildUnit);
aiPlanSetDesiredPriority(buildPlan, 40);
aiPlanSetVariableVector(buildPlan, cBuildPlanCenterPosition, 0, buildVec);
aiPlanSetInitialPosition(buildPlan, startPoint);
aiPlanSetVariableFloat(buildPlan, cBuildPlanCenterPositionDistance, 0, 12);
aiPlanAddUnitType(buildPlan,
kbTechTreeGetUnitIDTypeByFunctionIndex(cUnitFunctionBuilder, 0),
1, builderQty, builderQty);
aiPlanSetEscrowID(buildPlan, cRootEscrowID);
aiPlanSetInitialPosition(buildPlan, buildVec);
aiPlanSetActive(buildPlan);
}

buildDefend =aiPlanCreate("Build Defend Plan", cPlanDefend);

if (buildDefend >= 0)
{
aiPlanAddUnitType(buildDefend, cUnitTypeMilitary, 0, defendQty, defendQty);
aiPlanSetDesiredPriority(buildDefend, 60); // Above other defend plans
aiPlanSetVariableVector(buildDefend, cDefendPlanDefendPoint, 0, buildVec);
aiPlanSetVariableFloat(buildDefend, cDefendPlanEngageRange, 0, 15);
aiPlanSetVariableBool(buildDefend, cDefendPlanPatrol, 0, false);
aiPlanSetVariableFloat(buildDefend, cDefendPlanGatherDistance, 0, 8.0);
aiPlanSetInitialPosition(buildDefend, kbGetBlockPosition(cbInfantryGather));
aiPlanSetUnitStance(buildDefend, cUnitStanceDefensive);

aiPlanSetVariableInt(buildDefend, cDefendPlanRefreshFrequency, 0, 5);

aiPlanSetNumberVariableValues(buildDefend, cDefendPlanAttackTypeID, 2, true);
aiPlanSetVariableInt(buildDefend, cDefendPlanAttackTypeID, 0, cUnitTypeUnit);
aiPlanSetVariableInt(buildDefend, cDefendPlanAttackTypeID, 1, cUnitTypeBuilding);

aiPlanSetActive(buildDefend);
aiEcho("Creating defend plan");
}
xsEnableRule("endBuildDefend");
xsDisableSelf();
}

rule endBuildDefend
inactive
minInterval 7
{
aiEcho("Build Plan state is "+aiPlanGetState(buildPlan));
if (aiPlanGetState(buildPlan) == -1)
{
aiPlanDestroy(buildDefend);
aiEcho("Destroying build defend plan");
xsDisableSelf();
}
}
// *****************************************************************************
//
// FUNCTIONS
//
// *****************************************************************************

void age2EventHandler(int bogus=-1)

{
xsEnableRule("usePestilence");
xsEnableRule("goToAge3");
xsEnableRule("getAge2UnitUpgrades");
xsEnableRule("getAge2ArmoryUpgrades");
}

void age3EventHandler(int bogus=-1)

{
xsEnableRule("useCurse");
siegeMaintainPlan = maintainUnit(cUnitTypePetrobolos, reserveSize/8,
kbGetBlockPosition(cbSiegeGather), 60);
xsEnableRule("getAge3UnitUpgrades");
xsEnableRule("getAge3ArmoryUpgrades");
}

void age4EventHandler(int bogus=-1)

{
xsEnableRule("usePlenty");
xsEnableRule("getAge4UnitUpgrades");
xsEnableRule("getAge4ArmoryUpgrades");
xsEnableRule("usePlenty");
}

// Called by a trigger, to let AI know that the game has started

void wakeup(int parm=-1)
{
startTime = xsGetTime()/1000;
aiEcho("Wakeup running at "+startTime);

if (kbGetAge() >= cAge2)

age2EventHandler(0);
if (kbGetAge() >= cAge3)
age3EventHandler(0);
if (kbGetAge() >= cAge4)
age4EventHandler(0);

xsEnableRule("attackGenerator");
xsEnableRule("scout");
hippikonMaintainPlan = maintainUnit(cUnitTypeHippikon, reserveSize/3,
kbGetBlockPosition(cbCavalryGather),
cavTrainDelay);

toxotesMaintainPlan = maintainUnit(cUnitTypeToxotes, reserveSize/3,

kbGetBlockPosition(cbArcherGather),
archerTrainDelay);

hopliteMaintainPlan = maintainUnit(cUnitTypeHoplite, reserveSize/3,

kbGetBlockPosition(cbInfantryGather),
infantryTrainDelay);

// Init low-priority defend plan to manage spare units

defendPlan =aiPlanCreate("Defend Plan", cPlanDefend);
if (defendPlan >= 0)
{
// All unassigned mil units
aiPlanAddUnitType(defendPlan, cUnitTypeMilitary, 0, 200, 200);
 // Way low, below scouting and attack
aiPlanSetDesiredPriority(defendPlan, 10);
aiPlanSetVariableVector(defendPlan, cDefendPlanDefendPoint, 0,
kbGetBlockPosition(cbInfantryGather));
aiPlanSetVariableFloat(defendPlan, cDefendPlanEngageRange, 0, 30);

aiPlanSetVariableFloat(defendPlan, cDefendPlanGatherDistance, 0, 15.0);

aiPlanSetInitialPosition(defendPlan, kbGetBlockPosition(cbInfantryGather));
aiPlanSetUnitStance(defendPlan, cUnitStanceDefensive);

aiPlanSetNumberVariableValues(defendPlan, cDefendPlanPatrolWaypoint, 3, true);

aiPlanSetVariableVector(defendPlan, cDefendPlanPatrolWaypoint, 0,
kbGetBlockPosition(cbGateEast));
aiPlanSetVariableVector(defendPlan, cDefendPlanPatrolWaypoint, 1,
kbGetBlockPosition(cbEastPass1));
aiPlanSetVariableVector(defendPlan, cDefendPlanPatrolWaypoint, 2,
kbGetBlockPosition(cbGateWest));
aiPlanSetVariableBool(defendPlan, cDefendPlanPatrol, 0, true);

aiPlanSetVariableInt(defendPlan, cDefendPlanRefreshFrequency, 0, 5);

aiPlanSetNumberVariableValues(defendPlan, cDefendPlanAttackTypeID, 2, true);
aiPlanSetVariableInt(defendPlan, cDefendPlanAttackTypeID, 0, cUnitTypeUnit);
aiPlanSetVariableInt(defendPlan, cDefendPlanAttackTypeID, 1, cUnitTypeBuilding);

aiPlanSetActive(defendPlan);
aiEcho("Creating defend plan");
}

// Higher-priority defend plan to reserve units for final push

reservePlan =aiPlanCreate("Reserve Plan", cPlanDefend);
if (reservePlan >= 0)
{
// All unassigned mil units
aiPlanAddUnitType(reservePlan, cUnitTypeMilitary, 0, reserveSize/2, reserveSize/2);

// Higher than other defend plans

aiPlanSetDesiredPriority(reservePlan, 30);
aiPlanSetVariableVector(reservePlan, cDefendPlanDefendPoint, 0,
kbGetBlockPosition(cbP2TC));
aiPlanSetVariableFloat(reservePlan, cDefendPlanEngageRange, 0, 15);

aiPlanSetVariableFloat(reservePlan, cDefendPlanGatherDistance, 0, 15.0);

aiPlanSetInitialPosition(reservePlan, kbGetBlockPosition(cbInfantryGather));
aiPlanSetUnitStance(reservePlan, cUnitStanceDefensive);

aiPlanSetVariableBool(reservePlan, cDefendPlanPatrol, 0, false);

aiPlanSetVariableInt(reservePlan, cDefendPlanRefreshFrequency, 0, 5);

aiPlanSetNumberVariableValues(reservePlan, cDefendPlanAttackTypeID, 2, true);
aiPlanSetVariableInt(reservePlan, cDefendPlanAttackTypeID, 0, cUnitTypeUnit);
aiPlanSetVariableInt(reservePlan, cDefendPlanAttackTypeID, 1, cUnitTypeBuilding);

aiPlanSetActive(reservePlan);
aiEcho("Creating defend plan");
}

// Create villager maintain plan

createSimpleMaintainPlan(gathererTypeID, maxVills, true, mainBase);
}

void initMainBase()
{
// Nuke bases, add one base to rule them all
kbBaseDestroyAll(cMyID);

mainBase = kbBaseCreate(cMyID, "Base "+kbBaseGetNextID(),

kbGetBlockPosition(cbP2TC), mainRadius);
if (mainBase < 0)
aiEcho("***** Main base creation failed. *****");
 vector baseFront=xsVectorNormalize(kbGetMapCenter()-
kbGetBlockPosition(cbP2TC)); // Set front
kbBaseSetFrontVector(cMyID, mainBase, baseFront);
kbBaseSetMaximumResourceDistance(cMyID, mainBase, mainRadius+20.0);
// Gather up to 20m beyond base perimeter
kbBaseSetMain(cMyID, mainBase, true); // Make this the main base

// Add the buildings

int buildingQuery = -1;
int count = 0;
buildingQuery = kbUnitQueryCreate("Building Query"); // All buildings in the base
configQuery(buildingQuery, cUnitTypeBuilding, -1, cUnitStateAliveOrBuilding,
cMyID, kbGetBlockPosition(cbP2TC), false, mainRadius);
kbUnitQueryResetResults(buildingQuery);
count = kbUnitQueryExecute(buildingQuery);

int i = 0;
int buildingID = -1;
for (i=0; < count)
{
buildingID = kbUnitQueryGetResult(buildingQuery, i);
// Add it to the base
kbBaseAddUnit( cMyID, mainBase, buildingID );
}
}

void initEcon()
{
aiSetAutoGatherEscrowID(cRootEscrowID);
aiSetAutoFarmEscrowID(cRootEscrowID);
gathererTypeID = kbTechTreeGetUnitIDTypeByFunctionIndex(cUnitFunctionGatherer,0);

int herdPlanID=aiPlanCreate("GatherHerdable Plan", cPlanHerd);

if (herdPlanID >= 0)
{
aiPlanAddUnitType(herdPlanID, cUnitTypeHerdable, 0, 100, 100);
aiPlanSetVariableInt(herdPlanID, cHerdPlanBuildingTypeID,
0, cUnitTypeSettlementLevel1);
aiPlanSetActive(herdPlanID);
}

aiSetResourceGathererPercentageWeight(cRGPScript, 1);
aiSetResourceGathererPercentageWeight(cRGPCost, 0);

kbSetAICostWeight(cResourceFood, 1.0);
kbSetAICostWeight(cResourceWood, 0.7);
kbSetAICostWeight(cResourceGold, 0.8);
kbSetAICostWeight(cResourceFavor, 7.0);

aiSetResourceGathererPercentage(cResourceFood, foodPercent, false, cRGPScript);

aiSetResourceGathererPercentage(cResourceWood, woodPercent, false, cRGPScript);
aiSetResourceGathererPercentage(cResourceGold, goldPercent, false, cRGPScript);
aiSetResourceGathererPercentage(cResourceFavor, 0.0, false, cRGPScript);
aiNormalizeResourceGathererPercentages(cRGPScript);

aiSetResourceBreakdown(cResourceFood, cAIResourceSubTypeFish, 1, 50, 1.0, mainBase);

aiSetResourceBreakdown(cResourceFood, cAIResourceSubTypeFarm, 1, 50, 1.0, mainBase);
aiSetResourceBreakdown(cResourceWood, cAIResourceSubTypeEasy, 1, 50, 1.0, mainBase);
aiSetResourceBreakdown(cResourceGold, cAIResourceSubTypeEasy, 1, 50, 1.0, mainBase);
}

void main()
{
aiEcho("Starting Scn08p2.xs");
kbSetTownLocation(kbGetBlockPosition(cbP2TC));
aiRandSetSeed();

//Calculate some areas.

kbAreaCalculate(1200.0);
aiSetAttackResponseDistance(10.0);
 kbEscrowSetPercentage( cEconomyEscrowID, cAllResources, 0.0);
kbEscrowSetPercentage( cMilitaryEscrowID, cAllResources, 0.0);
kbEscrowAllocateCurrentResources();

initMainBase(); // Destroy all auto-bases, make one manual base for everything
initEcon();

aiSetAgeEventHandler(cAge2, "age2EventHandler");
aiSetAgeEventHandler(cAge3, "age3EventHandler");
aiSetAgeEventHandler(cAge4, "age4EventHandler");

// Create attack routes

routeWestPass = attackRoute("West Pass",cbGateWest, cbWestPass1, cbWestPass2);
routeEastPass = attackRoute("East Pass",cbGateEast, cbEastPass1, cbEastPass2);
routeNorthPass = attackRoute("North Pass", cbGateWest, cbNorthPass, cbP1TC);

switch(aiGetWorldDifficulty())
{ // ignores 0 (easiest), uses initial values in that case.
case 1: // medium
{
nextAttackTime = 300000; // 5 minutes
attackSize = 6.0;
maxAttackSize = 12.0;
attackSizeMultiplier = 1.2;
attackInterval = 240000; // 4 minutes
reserveSize = 20;
age3Time = 1200; // Time (in seconds) to go to age 3
age4Time = 1800;
defendQty = 2;
builderQty = 2;
trainDelay = 25;
break;
}
case 2: // difficult/hard
{
nextAttackTime = 180000; // 3 minutes
attackSize = 8.0;
maxAttackSize = 30.0;
attackSizeMultiplier = 1.2;
attackInterval = 180000; // 3 minutes
reserveSize = 35;
age3Time = 900; // Time (in seconds) to go to age 3
age4Time = 1500;
defendQty = 3;
builderQty = 5;
trainDelay = 15;
break;
}
case 3: // hardest/nightmare
{
nextAttackTime = 30000; // 30 sec
attackSize = 10.0;
maxAttackSize = 50.0;
attackSizeMultiplier = 1.3;
attackInterval = 108000; // 3 minutes
reserveSize = 60;
age3Time = 500; // Time (in seconds) to go to age 3
age4Time = 900;
defendQty = 6;
builderQty = 10;
trainDelay = 10;
break;
}
}

cavTrainDelay = trainDelay;
archerTrainDelay = trainDelay/2;
infantryTrainDelay = (2*trainDelay)/3;
}
void siegeUnitAttack(vector location=vector(-1,-1,-1), int qty=1)
{
static int attackQuery = -1;
static int attackQuery2 = -1;
int attackID=aiPlanCreate("Mixed Unit Attack at "+timeString(),cPlanAttack);
if (attackID < 0)
{
return;
}

if (aiPlanSetVariableInt(attackID, cAttackPlanPlayerID, 0, 1) == false)

{
return;
}

if (aiPlanSetNumberVariableValues(attackID, cAttackPlanTargetTypeID, 3, true)

== false)
return;

aiPlanSetVariableInt(attackID, cAttackPlanTargetTypeID, 0, cUnitTypeUnit);

aiPlanSetVariableInt(attackID, cAttackPlanTargetTypeID, 1, cUnitTypeBuilding);
aiPlanSetVariableInt(attackID, cAttackPlanTargetTypeID, 2, cUnitTypeAbstractWall);

// Set up the attack queries with the appropriate vectors

if (aiPlanSetNumberVariableValues(attackID, cAttackPlanQueryID, 2, true) == false)
{
return;
}
if (attackQuery < 0)
{
attackQuery = kbUnitQueryCreate("Attack Query");
configQueryRelation(attackQuery, cUnitTypeUnit, -1, cUnitStateAlive,
cPlayerRelationEnemy, location, false, 50);
}
else
{
kbUnitQuerySetPosition(attackQuery, location);
}

if (attackQuery2 < 0)
{
attackQuery2 = kbUnitQueryCreate("Attack Query #2");
configQuery(attackQuery2, cUnitTypeBuilding, -1, cUnitStateAliveOrBuilding,
cPlayerRelationEnemy, location, false, 50);
}
else
{
kbUnitQuerySetPosition(attackQuery2, location);
}
aiPlanSetVariableInt(attackID, cAttackPlanQueryID, 0, attackQuery);
aiPlanSetVariableInt(attackID, cAttackPlanQueryID, 1, attackQuery2);

if (aiRandInt(2) == 0)
aiPlanSetVariableInt(attackID, cAttackPlanAttackRouteID, 0, routeNorthPass);
else
aiPlanSetVariableInt(attackID, cAttackPlanAttackRouteID, 0, routeEastPass);

aiPlanSetVariableVector(attackID, cAttackPlanGatherPoint,
0, kbGetBlockPosition(cbInfantryGather));
aiPlanSetVariableFloat(attackID, cAttackPlanGatherDistance, 0, 25.0);

aiPlanAddUnitType(attackID, cUnitTypeHoplite, 1, 3*qty/10, 3*qty/10);

aiPlanAddUnitType(attackID, cUnitTypeToxotes, 1, 4*qty/10, 4*qty/10);
aiPlanAddUnitType(attackID, cUnitTypeHippikon, 1, 3*qty/10, 3*qty/10);
// Add siege if this is attack 4 or higher.
if (attackCount > 4)
aiPlanAddUnitType(attackID, cUnitTypePetrobolos, 1, (qty+5)/10, (qty+5)/10);
 aiPlanSetInitialPosition(attackID, kbGetBlockPosition(cbInfantryGather));
aiPlanSetRequiresAllNeedUnits(attackID, false);
aiPlanSetActive(attackID);
aiEcho("Activating attack plan "+attackID);
if (lastAttackPlanID >= 0)
aiPlanDestroy(lastAttackPlanID); // free up last set of units?
lastAttackPlanID = attackID; // update the global var
}

// *****************************************************************************
//
// RULES
//
// *****************************************************************************

rule goToAge3
inactive
mininterval 20
{
if ( (xsGetTime()/1000) < age3Time )
return;
researchTech(cTechAge3Aphrodite);
xsEnableRule("goToAge4");
xsEnableRule("getAge3UnitUpgrades");
xsEnableRule("getAge3ArmoryUpgrades");
xsDisableSelf();
}

rule goToAge4
inactive
mininterval 20
{
return; // disabled for now.

if ( (xsGetTime()/1000) < age4Time )

return;
researchTech(cTechAge4Hephaestus);
xsEnableRule("getAge4UnitUpgrades");
xsEnableRule("getAge4ArmoryUpgrades");
xsDisableSelf();
}

rule getAge2UnitUpgrades
inactive
minInterval 20
{
if ( (xsGetTime()/1000) < (age3Time/3) )
return;
researchTech(cTechMediumInfantry);
researchTech(cTechMediumArchers);
// researchTech(cTechMediumCavalry);
xsDisableSelf();
}

rule getAge2ArmoryUpgrades
inactive
minInterval 20
{
if ( (xsGetTime()/1000) < (2*age3Time)/3 )
return;
aiEcho("Getting age 2 armory upgrades");
researchTech(cTechCopperWeapons);
researchTech(cTechCopperMail);
 researchTech(cTechCopperShields);
xsDisableSelf();
}

rule getAge3UnitUpgrades
inactive
minInterval 20
{
researchTech(cTechHeavyInfantry);
researchTech(cTechHeavyArchers);
researchTech(cTechHeavyCavalry);
xsDisableSelf();
}

rule getAge3ArmoryUpgrades
inactive
minInterval 20
{
researchTech(cTechBronzeWeapons);
researchTech(cTechBronzeMail);
researchTech(cTechBronzeShields);
xsDisableSelf();
}

rule getAge4UnitUpgrades
inactive
minInterval 20
{
researchTech(cTechChampionInfantry);
researchTech(cTechChampionArchers);
researchTech(cTechChampionCavalry);
xsDisableSelf();
}

rule getAge4ArmoryUpgrades
inactive
minInterval 20
{
researchTech(cTechIronWeapons);
researchTech(cTechIronMail);
researchTech(cTechIronShields);
xsDisableSelf();
}

rule scout
inactive
{
// just set up an explore plan
int exploreID = aiPlanCreate("Explore", cPlanExplore);
if(exploreID >= 0)
{
aiPlanSetVariableFloat( exploreID, cExplorePlanLOSMultiplier, 0, 4.0 );
aiPlanAddUnitType(exploreID, cUnitTypeHippikon, 1, 1, 1);
aiPlanSetInitialPosition( exploreID, kbGetBlockPosition(cbNorthWestPlateau));
aiPlanSetActive(exploreID);
}
xsDisableSelf();
}

rule attackGenerator
minInterval 10
inactive
{
static int buildingQuery = -1;

//aiEcho("attack check running, next time is "+nextAttackTime);

if ( xsGetTime() < nextAttackTime )
return;

if (buildingQuery < 0)
{
 buildingQuery = kbUnitQueryCreate("Building Query");
configQuery(buildingQuery, cUnitTypeBuilding, -1, cUnitStateAliveOrBuilding,
1, kbGetBlockPosition(cbAttack5Tower), false, 20);
}

attackCount = attackCount + 1;

// Add forward building coincident with some attacks

if (attackCount == 3) // Make tower
{
buildUnit = cUnitTypeTower;
buildVec = kbGetBlockPosition(cbAttack5Tower); // Gold mine
startPoint = kbGetBlockPosition(cbWestPass1);
kbUnitQueryResetResults(buildingQuery);
if (kbUnitQueryExecute(buildingQuery) == 0)
xsEnableRule("buildPlanRule");
else
aiEcho("Skipping tower build because of enemy buildings.");
}
if (attackCount == 5) // Make stable
{
buildUnit = cUnitTypeStable;
buildVec = kbGetBlockPosition(cbEastPass2);
startPoint = kbGetBlockPosition(cbEastPass1);
kbUnitQuerySetPosition(buildingQuery, startPoint);
kbUnitQueryResetResults(buildingQuery);
if (kbUnitQueryExecute(buildingQuery) == 0)
xsEnableRule("buildPlanRule");
else
aiEcho("Skipping stable build because of enemy buildings."); }
if (attackCount == 7) // Make fortress
{
buildUnit = cUnitTypeFortress;
buildVec = kbGetBlockPosition(cbNorthEastPlateau); // Elevated area north of town
startPoint = kbGetBlockPosition(cbWestPass1);
kbUnitQuerySetPosition(buildingQuery, startPoint);
kbUnitQueryResetResults(buildingQuery);
if (kbUnitQueryExecute(buildingQuery) == 0)
xsEnableRule("buildPlanRule");
else
aiEcho("Skipping fortress build because of enemy buildings."); }
if (aiRandInt(3) > 0)
{
aiEcho("Normal attack");
siegeUnitAttack(kbGetBlockPosition(cbP1TC), attackSize);
}
else
{
// 1 in 3 chance of aiming for green TC
siegeUnitAttack(kbGetBlockPosition("2259"), attackSize);
aiEcho("Deep attack");
}
nextAttackTime = xsGetTime() + attackInterval;
attackSize = attackSize * attackSizeMultiplier;
if (attackSize > maxAttackSize)
attackSize = maxAttackSize;
aiEcho("Next attack size will be "+attackSize+".");
}

rule useCurse
minInterval 5
inactive
{

// look for a group of 6 enemy military units, at my TC location or at my main

// army's location
int targetUnit = -1;
 static int tempQuery = -1;
if (tempQuery < 0)
{ // Doesn't exist, set it up
tempQuery = kbUnitQueryCreate("useCurseHome");
if ( configQuery(tempQuery, cUnitTypeUnit, -1, cUnitStateAlive,
1, kbGetBlockPosition(cbP2TC), true, 50) == false)
return;
}
kbUnitQueryResetResults(tempQuery);
int targetCount = kbUnitQueryExecute(tempQuery);

if ( targetCount < 6 )
{
vector pVec = aiPlanGetLocation(lastAttackPlanID);
if (xsVectorGetX(pVec)>=0)
{
static int tempQuery2 = -1;
if (tempQuery2 < 0)
{ // Doesn't exist, set it up
tempQuery2 = kbUnitQueryCreate("useCurseArmy");
if ( configQuery(tempQuery2, cUnitTypeUnit, -1, cUnitStateAlive,
1, pVec, true, 50) == false)
return;
}
else // Because pVec changes as army moves
kbUnitQuerySetPosition(tempQuery2, pVec);
kbUnitQueryResetResults(tempQuery2);
targetCount = kbUnitQueryExecute(tempQuery2);
if (targetCount < 6)
return;
else// grab middle unit
targetUnit = kbUnitQueryGetResult(tempQuery2, targetCount/2);
}
else
return;
}
else
targetUnit = kbUnitQueryGetResult(tempQuery, targetCount/2); // grab middle unit

aiEcho("Using Curse on unit "+targetUnit+" at "+kbUnitGetPosition(targetUnit));

if ( aiCastGodPowerAtUnit(cTechCurse, targetUnit) == true)
xsDisableSelf();
}

rule usePestilence
minInterval 5
inactive
{
// look for a group of 2 enemy buildings near my army.

if (lastAttackPlanID < 0)
return;

vector pVec = aiPlanGetLocation(lastAttackPlanID);

if (xsVectorGetX(pVec)<0)
return;

static int tempQuery = -1;

if (tempQuery < 0)
{ // Doesn't exist, set it up
tempQuery = kbUnitQueryCreate("useBronze");

if ( configQuery(tempQuery, cUnitTypeLogicalTypeBuildingsThatTrainMilitary,
-1, cUnitStateAlive, 1, pVec, true, 50) == false)
return;
}
else
kbUnitQuerySetPosition(tempQuery, pVec); // Because pVec changes as army moves
kbUnitQueryResetResults(tempQuery);
int targetCount = kbUnitQueryExecute(tempQuery);
 if (targetCount < 2)
return;

aiEcho("Using Pestilence at "+kbUnitGetPosition(kbUnitQueryGetResult(tempQuery, 0)));

if ( aiCastGodPowerAtPosition(cTechPestilence,
kbUnitGetPosition(kbUnitQueryGetResult(tempQuery, 0))) == true)
{
aiEcho("Deactivating UsePestilence");
xsDisableSelf();
}
}

rule usePlenty
minInterval 5
inactive
{
vector aimHere = kbGetBlockPosition(cbP2TC);
float dx = aiRandInt(40)-20.0;
float dz = aiRandInt(40)-20.0;
float newX = xsVectorGetX(kbGetBlockPosition(cbP2TC));
float newZ = xsVectorGetZ(kbGetBlockPosition(cbP2TC));
newX = newX + dx;
newZ = newZ + dz;

aimHere = xsVectorSetX(aimHere, newX); // TC vector +/-20 in x and z

aimHere = xsVectorSetZ(aimHere, newZ);

if ( aiCastGodPowerAtPosition(cTechPlenty, aimHere) == true)

{
aiEcho("Plenty worked at "+aimHere);
xsDisableSelf();
}
else
aiEcho("Plenty failed at "+aimHere);
}
// *****************************************************************************
//
// scn lib.xs
//
// General library utilities for scenarios
// Leaner versions of RM utilities, without escrow IDs and other complications
//
// *****************************************************************************

//==============================================================================
// Failure
// To be called in the event of an error. Breaks the script, preserves
// the current call stack, etc.
//==============================================================================
void failure( string msg="" )
{
aiEcho("Failure: " + msg);
}

// *****************************************************************************
//
// configQuery
//
// Sets up all the non-default parameters so you can config a query on a single call.
// Query must be created prior to calling, and the results reset and the query executed
// after the call.
//
// *****************************************************************************
bool configQuery( int queryID = -1, int unitType = -1, int action = -1, int state = -1,
int player = -1, vector center = vector(-1,-1,-1), bool sort = false, float radius = -1 )
{

if ( queryID == -1)
{
failure("Invalid query ID");
return(false);
}

if (player != -1)
kbUnitQuerySetPlayerID(queryID, player);

if (unitType != -1)
kbUnitQuerySetUnitType(queryID, unitType);

if (action != -1)
kbUnitQuerySetActionType(queryID, action);

if (state != -1)
kbUnitQuerySetState(queryID, state);

if (center != vector(-1,-1,-1))
{
kbUnitQuerySetPosition(queryID, center);
if (sort == true)
kbUnitQuerySetAscendingSort(queryID, true);
if (radius != -1)
kbUnitQuerySetMaximumDistance(queryID, radius);
}
return(true);
}

// *****************************************************************************
//
// configQueryRelation
//
// Sets up all the non-default parameters so you can config a query on a single call.
// Query must be created prior to calling, and the results reset and the query executed
// after the call.
// Unlike configQuery(), this uses the PLAYER RELATION rather than the player number
//
// *****************************************************************************
bool configQueryRelation( int queryID = -1, int unitType = -1, int action = -1,
int state = -1, int playerRelation = -1,
vector center = vector(-1,-1,-1), bool sort = false,
float radius = -1 )
{

if ( queryID == -1)
{
failure("Invalid query ID");
return(false);
}

if (playerRelation != -1)
kbUnitQuerySetPlayerRelation(queryID, playerRelation);

if (unitType != -1)
kbUnitQuerySetUnitType(queryID, unitType);

if (action != -1)
kbUnitQuerySetActionType(queryID, action);

if (state != -1)
kbUnitQuerySetState(queryID, state);

if (center != vector(-1,-1,-1))
{
kbUnitQuerySetPosition(queryID, center);
if (sort == true)
kbUnitQuerySetAscendingSort(queryID, true);
if (radius != -1)
kbUnitQuerySetMaximumDistance(queryID, radius);
}
return(true);
}

//==============================================================================
// getUnit( int unitType, int action, vector center)
//
// Returns a unit of the specified type, doing the specified action.
// Defaults = any unit, any action.
// Searches units owned by this player only, can include buildings.
// If a location is specified, the nearest matching unit is returned.
//==============================================================================

int getUnit( int unitType = -1, int action = -1, vector center = vector(-1,-1,-1) )
{

int retVal = -1;

int count = -1;
int unitQueryID = kbUnitQueryCreate("unit");

// Define a query to get all matching units

if (unitQueryID != -1)
{
kbUnitQuerySetPlayerID(unitQueryID, cMyID); // only my units
if (unitType != -1) // only if specified
kbUnitQuerySetUnitType(unitQueryID, unitType);
if (action != -1) // only if specified
kbUnitQuerySetActionType(unitQueryID, action);
if (center != vector(-1,-1,-1))
{
kbUnitQuerySetPosition(unitQueryID, center);
kbUnitQuerySetAscendingSort(unitQueryID, true);
}
kbUnitQuerySetState(unitQueryID, cUnitStateAlive);
}
 else
{
failure("Couldn't create unit query.");
return(-1);
}

kbUnitQueryResetResults(unitQueryID);
count = kbUnitQueryExecute(unitQueryID);
// Add buildings in process
kbUnitQuerySetState(unitQueryID, cUnitStateBuilding);
count = kbUnitQueryExecute(unitQueryID);

// Pick a unit and return its ID, or return -1.

if ( count > 0 )
if (center != vector(-1,-1,-1))
retVal = kbUnitQueryGetResult(unitQueryID, 0); // closest unit
else // get the ID of a random unit
retVal = kbUnitQueryGetResult(unitQueryID, aiRandInt(count));
else
retVal = -1;

return(retVal);
}

// *****************************************************************************
//
// trainUnit
//
// Train qty units of type unitID, optionally gathering at gatherPoint and
// training at a minimum of interval seconds apart. Returns the planID, or -1
// on failure.
// *****************************************************************************
int trainUnit( int unitID=-1, int qty=1, vector gatherPoint=vector(-1,-1,-1), int
interval=-1)
{

if (unitID == -1)
return(-1);
if (qty < 1)
return(-1);
int planID = aiPlanCreate("Train "+qty+" "+kbGetProtoUnitName(unitID), cPlanTrain);
if (planID >= 0)
{
aiPlanSetVariableInt(planID, cTrainPlanUnitType, 0, unitID);
aiPlanSetVariableInt(planID, cTrainPlanNumberToTrain, 0, qty);
if (interval > 0)
aiPlanSetVariableInt(planID, cTrainPlanFrequency, 0, interval);
if (xsVectorGetX(gatherPoint) >= 0)
aiPlanSetVariableVector(planID, cTrainPlanGatherPoint, 0, gatherPoint);
aiPlanSetActive(planID);
return(planID);
}
else
return(-1);
}

// *****************************************************************************
//
// maintainUnit
//
// Maintain a total of qty units of type unitID, optionally gathering at gatherPoint and
// training at a minimum of interval seconds apart. Returns the planID, or -1
// on failure.
// *****************************************************************************
int maintainUnit( int unitID=-1, int qty=1, vector gatherPoint=vector(-1,-1,-1), int
interval=-1)
{
 if (unitID == -1)
return(-1);
if (qty < 1)
return(-1);
int planID = aiPlanCreate("Maintain "+qty+" "+kbGetProtoUnitName(unitID), cPlanTrain);
if (planID >= 0)
{
aiPlanSetVariableInt(planID, cTrainPlanUnitType, 0, unitID);
aiPlanSetVariableInt(planID, cTrainPlanNumberToMaintain, 0, qty);
if (interval > 0)
aiPlanSetVariableInt(planID, cTrainPlanFrequency, 0, interval);
if (xsVectorGetX(gatherPoint) >= 0)
aiPlanSetVariableVector(planID, cTrainPlanGatherPoint, 0, gatherPoint);
aiPlanSetActive(planID);
return(planID);
}
else
return(-1);
}

// *****************************************************************************
//
// researchTech
//
// Creates a research plan to research the tech at an appropriate building
//
// *****************************************************************************
int researchTech(int techID=-1)
{
int planID = aiPlanCreate("Research "+kbGetTechName(techID), cPlanProgression);
if(planID < 0)
return(-1);

aiPlanSetVariableInt(planID, cProgressionPlanGoalTechID, 0, techID);

aiPlanSetActive(planID);
return(planID);
}

// *****************************************************************************
//
// attackRoute()
//
// Makes an attack route from a series of block names. Must have 2-5 block names.
//
// *****************************************************************************
int attackRoute(string name="default attack route", string block1="", string block2="",
string block3="", string block4="", string block5="")
{
string end="";
int numPoints=0;

// Start at block 5, find the last one

if (block5 != "")
{
numPoints=5;
end=block5;
}

if ( (block4 != "") && (numPoints == 0) )

{
numPoints=4;
end=block4;
}
 if ( (block3 != "") && (numPoints == 0) )
{
numPoints=3;
end=block3;
}

if ( (block2 != "") && (numPoints == 0) )

{
numPoints=2;
end=block2;
}

if ( (block1 != "") && (numPoints == 0) )

{
numPoints=1;
end=block1;
}

if (numPoints < 2)
return(-1);

int pathID = kbPathCreate(name+" path");

if (pathID < 0)
return(-1);

if (numPoints > 2)
kbPathAddWaypoint(pathID, kbGetBlockPosition(block2));
if (numPoints > 3)
kbPathAddWaypoint(pathID, kbGetBlockPosition(block3));
if (numPoints > 4)
kbPathAddWaypoint(pathID, kbGetBlockPosition(block4));

int attackRouteID = kbCreateAttackRouteWithPath(name, kbGetBlockPosition(block1),

kbGetBlockPosition(end));
if (attackRouteID < 0)
return(-1);
if (numPoints > 2)
kbAttackRouteAddPath(attackRouteID, pathID);

return(attackRouteID);
}

// *****************************************************************************
//
// int getUnassignedUnitCount(vector center, float radius, int player, int unitType)
//
// Counts the number of player's units of type unitType that don't belong to
// a plan. Count is limited to a distance of radius around point center.
//
// Generally used to count newly spawned units in order to set appropriate want/max
// levels for an attack plan.
// *****************************************************************************

int getUnassignedUnitCount(vector center=vector(-1.0, -1.0, -1.0), float radius=25.0,

int player=2, int unitType=cUnitTypeUnit)
{
// Number of unassigned units found by traversing the query results
int unassigned=0;

// Query to find the units of unitType within radius of center.

int query=-1;

// Number of units found by the query.

int count=-1;
int i=-1;

query = kbUnitQueryCreate("Unassigned units");

if (query < 0)
 return(-1);

configQuery(query, unitType, -1, cUnitStateAlive, player, center, true, radius);

kbUnitQueryResetResults(query);
count = kbUnitQueryExecute(query);

for (i=0; <count)

{
// if not a member of a plan...
if (kbUnitGetPlanID(kbUnitQueryGetResult(query,i)) == -1)
unassigned = unassigned + 1;
}
return(unassigned);
}

// *****************************************************************************
//
// string timeString(bool trimmed=true)
//
// Returns the current time in h:mm:ss format. If trimmed is true, it suppresses
// leading spaces or zeros. If false, string is always 7 characters.
// Not responible for games over 10 hours. ;-)
//
// *****************************************************************************
string timeString(bool trimmed=true)
{
int hour = 0;
int min = 0;
int sec = 0;
int time = 0;
string retval = "";

time = xsGetTime()/1000; // Seconds

hour = time/3600;
time = time - (hour*3600);
min = time/60;
time = time -(min*60);
sec = time;

if (trimmed == true)
{
// start with h:
if (hour > 0) {
retval = hour+":";
if (min >= 10)
retval = retval+min+":";
else
retval = retval+0+min+":";
if (sec >=10)
retval = retval+sec;
else
retval = retval+0+sec;
}
else
{ // start with min
retval = min+":";
if (sec >=10)
retval = retval+sec;
else
retval = retval+0+sec;
}
}
else // non-trimmed
{
retval = hour+":";
if (min >= 10)
retval = retval+min+":";
 else
retval = retval+0+min+":";
if (sec >=10)
retval = retval+sec;
else
retval = retval+0+sec;
}
return(retval);
}

/*
// *****************************************************************************
//
// build(int BuildingID, int areaID)
//
// *****************************************************************************

int build(int building=-1, int escrow=0, int areaID=-1)

{
int plan=aiPlanCreate("Build "+kbGetProtoUnitName(building), cPlanProgression);
if (plan < 0)
return(-1);

//Set it for the building that we get our unit from.

aiPlanSetVariableInt(plan, cProgressionPlanGoalUnitID, 0, building);
//Build it in our town.
aiPlanSetVariableInt(plan, cProgressionPlanBuildAreaID, 0, areaID);
//Go.
aiPlanSetActive(plan);
return(plan);
}
*/

// *****************************************************************************
//
// echoQuery(int queryID)
//
// aiEchos the list of items in the query result space, with ID numbers and unit types.
//
// *****************************************************************************
void echoQuery(int queryID = -1)
{
if (queryID < 0)
{
aiEcho("Invalid query");
return;
}

int i = 0;
int id = 0;
for (i=0; < kbUnitQueryNumberResults(queryID))
{
id = kbUnitQueryGetResult(queryID, i);
aiEcho(" "+id+" ("+kbGetProtoUnitName(kbGetUnitBaseTypeID(id))+")");
}

//==============================================================================
//createSimpleMaintainPlan: DCP
//==============================================================================
bool createSimpleMaintainPlan(int puid=-1, int number=1, bool economy=true,
int baseID=-1)
{
 //Create a the plan name.
string planName="Military";
if (economy == true)
planName="Economy";
// e.g. "Economy maintain 17 villager "
planName=planName+" maintain "+number+" "+kbGetProtoUnitName(puid)+" ";
int planID=aiPlanCreate(planName, cPlanTrain);
if (planID < 0)
return(false);

//Economy or Military.
if (economy == true)
aiPlanSetEconomy(planID, true);
else
aiPlanSetMilitary(planID, true);
//Unit type.
aiPlanSetVariableInt(planID, cTrainPlanUnitType, 0, puid);
//Number.
aiPlanSetVariableInt(planID, cTrainPlanNumberToMaintain, 0, number);

//If we have a base ID, use it.

if (baseID >= 0)
{
aiPlanSetBaseID(planID, baseID);
if (economy == false)
aiPlanSetVariableVector(planID, cTrainPlanGatherPoint, 0,
kbBaseGetMilitaryGatherPoint(cMyID, baseID));
}

aiPlanSetActive(planID);

//Done.
return(true);
}
List of AOM type enumerations and function calls

These are provided as a reference. All of the const variable definitions are provided by
the game and automatically included in your script (see the RM AI scripts in the AI
directory for a working example). There are some game-dependent items, such as
cNumberPlayers, that will change based on how many players are in the game, etc.

//Player/Game:
const vector cInvalidVector=vector(-1.0, -1.0, -1.0);
const vector cOriginVector=vector(0.0, 0.0, 0.0);
const int cNumberPlayers=13;
const string cFilename="YourAIFilenameHere";
const int cMyID=12;
const string cMyName="RandomCPNameHere";
const int cMyCulture=2;
const int cMyCiv=7;
const string cRandomMapName="RandomMapNameHere";

//Unit Stances:
const int cUnitStanceAggressive=0;
const int cUnitStanceDefensive=1;
const int cUnitStancePassive=2;

//Victory Condition/Game Mode Types:

const int cGameModeSupremacy=0;
const int cGameModeConquest=1;
const int cGameModeLightning=2;
const int cGameModeDeathmatch=3;

//Difficulty Levels:
const int cDifficultyEasy=0;
const int cDifficultyModerate=1;
const int cDifficultyHard=2;
const int cDifficultyNightmare=3;

//Age Constants:
const int cAge1=0;
const int cAge2=1;
const int cAge3=2;
const int cAge4=3;

//Player Relation Constants:

const int cPlayerRelationAny=-1;
const int cPlayerRelationSelf=0;
const int cPlayerRelationEnemy=2;
const int cPlayerRelationAlly=1;

//Resource Gatherer Preferences:

const int cRGPScript=0;
const int cRGPCost=1;
const int cRGPActual=2;

//Resource Subtypes:
const int cAIResourceSubTypeEasy=0;
const int cAIResourceSubTypeHunt=1;
const int cAIResourceSubTypeHuntAggressive=2;
const int cAIResourceSubTypeFarm=3;
const int cAIResourceSubTypeFish=4;
const int cAIResourceSubTypeTrade=5;

//Escrow IDs:
const int cRootEscrowID=0;
const int cEconomyEscrowID=1;
const int cMilitaryEscrowID=2;
//Plan Types:
const int cPlanMove=0;
const int cPlanAttack=1;
const int cPlanBuild=2;
const int cPlanTrain=3;
const int cPlanResearch=4;
const int cPlanWork=5;
const int cPlanGather=6;
const int cPlanExplore=7;
const int cPlanData=8;
const int cPlanProgression=9;
const int cPlanBuildWall=10;
const int cPlanFarm=11;
const int cPlanHunt=12;
const int cPlanHuntAggressive=13;
const int cPlanFish=14;
const int cPlanHerd=15;
const int cPlanEmpower=16;
const int cPlanTransport=17;
const int cPlanDropoffResource=18;
const int cPlanGatherRelic=19;
const int cPlanAttackStrategy=20;
const int cPlanGodPower=21;
const int cPlanDefend=22;
const int cPlanReserve=23;
const int cPlanGoal=24;
const int cPlanTower=25;
const int cPlanGatherGoal=26;
const int cPlanRepair=27;
const int cPlanTrade=28;

//Plan States:
const int cPlanStateNone=0;
const int cPlanStateDone=1;
const int cPlanStateFailed=2;
const int cPlanStateBuild=3;
const int cPlanStateGather=4;
const int cPlanStatePlace=5;
const int cPlanStateExplore=6;
const int cPlanStateTrain=7;
const int cPlanStateResearch=8;
const int cPlanStateAttack=9;
const int cPlanStateGoto=10;
const int cPlanStateEmpower=11;
const int cPlanStateEnter=12;
const int cPlanStateExit=13;
const int cPlanStateEvaluate=14;
const int cPlanStatePatrol=15;
const int cPlanStateRetreat=16;
const int cPlanStateWorking=17;
const int cPlanStateTransport=18;
const int cPlanStateDualPlace=19;
const int cPlanStateWait=20;
const int cPlanStateCast=21;

//Plan Events:
const int cPlanEventDone=0;
const int cPlanEventFailed=1;
const int cPlanEventPoll=2;
const int cPlanEventIdle=3;

//Gather Plan Variables:

const int cGatherPlanMaximumDistance=0;
const int cGatherPlanMaximumWalkDistance=1;
const int cGatherPlanKBResourceID=2;
const int cGatherPlanAutoBuildDropsite=3;
const int cGatherPlanResourceID=4;
const int cGatherPlanResourceType=5;
const int cGatherPlanResourceSubType=6;
const int cGatherPlanBreakDownID=7;
const int cGatherPlanDropsiteTimeLimit=8;
const int cGatherPlanDropsiteTime=9;
const int cGatherPlanDropsiteID=10;
const int cGatherPlanDropsitePUID=11;

//Build Plan Variables:

const int cBuildPlanBuildingPlacementID=0; (RO=0, AC=1).
const int cBuildPlanBuildingTypeID=1; (RO=0, AC=1).
const int cBuildPlanInfluenceUnitTypeID=2; (RO=0, AC=1).
const int cBuildPlanInfluenceUnitDistance=3; (RO=0, AC=1).
const int cBuildPlanInfluenceUnitValue=4; (RO=0, AC=1).
const int cBuildPlanAreaID=5; (RO=0, AC=1).
const int cBuildPlanCenterPosition=6; (RO=0, AC=1).
const int cBuildPlanCenterPositionDistance=7; (RO=0, AC=1).
const int cBuildPlanBuildUnitID=8; (RO=0, AC=1).
const int cBuildPlanFoundationID=9; (RO=0, AC=0).
const int cBuildPlanInfluencePosition=10; (RO=0, AC=1).
const int cBuildPlanInfluencePositionDistance=11; (RO=0, AC=1).
const int cBuildPlanInfluencePositionValue=12; (RO=0, AC=1).
const int cBuildPlanDockPlacementPoint=13; (RO=0, AC=1).
const int cBuildPlanNumAreaBorderLayers=14; (RO=0, AC=1).
const int cBuildPlanBuildingBufferSpace=15; (RO=0, AC=1).
const int cBuildPlanSettlementPlacementPoint=16; (RO=0, AC=1).
const int cBuildPlanFailOnUnaffordable=17; (RO=0, AC=1).
const int cBuildPlanInfluenceKBResourceID=18; (RO=0, AC=1).
const int cBuildPlanRandomBPValue=19; (RO=0, AC=1).
const int cBuildPlanInfluenceAtBuilderPosition=20; (RO=0, AC=1).
const int cBuildPlanInfluenceBuilderPositionValue=21; (RO=0, AC=1).
const int cBuildPlanInfluenceBuilderPositionDistance=22; (RO=0, AC=1).
const int cBuildPlanRetries=23; (RO=0, AC=1).
const int cBuildPlanMaxRetries=24; (RO=0, AC=1).
const int cBuildPlanPendingCommands=25; (RO=0, AC=1).
const int cBuildPlanFailureCause=26; (RO=1, AC=1).
const int cBuildPlanFailureCauseFloat=27; (RO=1, AC=1).
const int cBuildPlanMaxCanPaths=28; (RO=1, AC=1).
const int cBuildPlanCanPathStartIndex=29; (RO=0, AC=1).

//Train Plan Variables:

const int cTrainPlanBuildingID=0; (RO=0, AC=1).
const int cTrainPlanIntoArmyID=1; (RO=0, AC=1).
const int cTrainPlanIntoPlanID=2; (RO=0, AC=1).
const int cTrainPlanIntoBaseID=3; (RO=0, AC=1).
const int cTrainPlanNumberToTrain=4; (RO=0, AC=1).
const int cTrainPlanNumberToMaintain=5; (RO=0, AC=1).
const int cTrainPlanNumberTrained=6; (RO=1, AC=1).
const int cTrainPlanUnitType=7; (RO=0, AC=1).
const int cTrainPlanBuildFromType=8; (RO=0, AC=1).
const int cTrainPlanTrainedUnitID=9; (RO=1, AC=0).
const int cTrainPlanFrequency=10; (RO=0, AC=1).
const int cTrainPlanUseMultipleBuildings=11; (RO=0, AC=1).
const int cTrainPlanGatherPoint=12; (RO=0, AC=1).
const int cTrainPlanGatherTargetID=13; (RO=0, AC=1).
const int cTrainPlanMaintainBaseID=14; (RO=0, AC=1).
const int cTrainPlanMaintainAreaID=15; (RO=0, AC=1).

//Explore Plan Variables:

const int cExplorePlanLOSMultiplier=0; (RO=0, AC=1).
const int cExplorePlanDoLoops=1; (RO=0, AC=1).
const int cExplorePlanDoneLoops=2; (RO=1, AC=1).
const int cExplorePlanNumberOfLoops=3; (RO=0, AC=1).
const int cExplorePlanPointsInLoop=4; (RO=0, AC=1).
const int cExplorePlanAvoidingAttackedAreas=5; (RO=0, AC=1).
const int cExplorePlanReExploreAreas=6; (RO=1, AC=1).
const int cExplorePlanLOSProtoUnitID=7; (RO=1, AC=1).
const int cExplorePlanBuildPosition=8; (RO=1, AC=1).
const int cExplorePlanBuilderUnitType=9; (RO=1, AC=1).
const int cExplorePlanCanBuildLOSProto=10; (RO=0, AC=1).
const int cExplorePlanHandleDamageTime=11; (RO=1, AC=1).
const int cExplorePlanHandleDamageFrequency=12; (RO=0, AC=1).
const int cExplorePlanQuitWhenPointIsVisible=13; (RO=0, AC=1).
const int cExplorePlanQuitWhenPointIsVisiblePt=14; (RO=0, AC=1).
//Research Plan Variables:
const int cResearchPlanBuildingID=0; (RO=0, AC=1).
const int cResearchPlanBuildingTypeID=1; (RO=0, AC=1).
const int cResearchPlanTechID=2; (RO=0, AC=1).
const int cResearchPlanBuildingAbstractTypeID=3; (RO=0, AC=1).

//Attack Plan Variables:

const int cAttackPlanPlayerID=0; (RO=0, AC=1).
const int cAttackPlanSpecificTargetID=1; (RO=0, AC=0).
const int cAttackPlanTargetTypeID=2; (RO=0, AC=0).
const int cAttackPlanQueryID=3; (RO=0, AC=0).
const int cAttackPlanAttackRouteID=4; (RO=0, AC=1).
const int cAttackPlanAttackRoutePattern=5; (RO=0, AC=1).
const int cAttackPlanGatherPoint=6; (RO=0, AC=1).
const int cAttackPlanGatherDistance=7; (RO=0, AC=1).
const int cAttackPlanTargetID=8; (RO=1, AC=0).
const int cAttackPlanMoveAttack=9; (RO=0, AC=1).
const int cAttackPlanNumberAttacks=10; (RO=1, AC=1).
const int cAttackPlanRefreshFrequency=11; (RO=0, AC=1).
const int cAttackPlanLastRefreshTime=12; (RO=1, AC=1).
const int cAttackPlanHandleDamageTime=13; (RO=1, AC=1).
const int cAttackPlanHandleDamageFrequency=14; (RO=0, AC=1).
const int cAttackPlanBaseAttackMode=15; (RO=0, AC=1).
const int cAttackPlanPathID=16; (RO=0, AC=1).
const int cAttackPlanFromGoalID=17; (RO=0, AC=1).
const int cAttackPlanRetreatMode=18; (RO=0, AC=1).
const int cAttackPlanTargetAreaGroups=19; (RO=0, AC=0).
const int cAttackPlanTeleportLocation=20; (RO=1, AC=1).
const int cAttackPlanAutoUseGPs=21; (RO=0, AC=1).
const int cAttackPlanPowerID=22; (RO=1, AC=1).
const int cAttackPlanAttackRoutePatternLRU=0;
const int cAttackPlanAttackRoutePatternMRU=1;
const int cAttackPlanAttackRoutePatternRandom=2;
const int cAttackPlanAttackRoutePatternBest=3;
const int cAttackPlanBaseAttackModeNone=0;
const int cAttackPlanBaseAttackModeWeakest=1;
const int cAttackPlanBaseAttackModeStrongest=2;
const int cAttackPlanBaseAttackModeLRU=3;
const int cAttackPlanBaseAttackModeMRU=4;
const int cAttackPlanBaseAttackModeRandom=5;
const int cAttackPlanBaseAttackModeClosest=6;
const int cAttackPlanBaseAttackModeFarthest=7;
const int cAttackPlanRetreatModeNone=0;
const int cAttackPlanRetreatModeOutnumbered=1;
const int cAttackPlanRetreatModeWillLose=2;

//Progression Plan Variables:

const int cProgressionPlanPollingTime=0; (RO=0, AC=1).
const int cProgressionPlanProgressionID=1; (RO=0, AC=1).
const int cProgressionPlanTrainUnitAtEnd=2; (RO=0, AC=1).
const int cProgressionPlanNumGoalUnitsToBuild=3; (RO=0, AC=1).
const int cProgressionPlanGoalUnitID=4; (RO=0, AC=1).
const int cProgressionPlanGoalTechID=5; (RO=0, AC=1).
const int cProgressionPlanBuildAreaID=6; (RO=0, AC=1).
const int cProgressionPlanCurrentGoalID=7; (RO=0, AC=1).
const int cProgressionPlanCurrentGoalType=8; (RO=0, AC=1).
const int cProgressionPlanCurrentStep=9; (RO=0, AC=1).
const int cProgressionPlanCurrentStepPlanID=10; (RO=0, AC=1).
const int cProgressionPlanPaused=11; (RO=0, AC=1).
const int cProgressionPlanAdvanceOneStep=12; (RO=0, AC=1).
const int cProgressionPlanRunInParallel=13; (RO=0, AC=1).
const int cProgressionPlanChildProgressions=14; (RO=0, AC=0).
const int cProgressionPlanBuildingPref=15; (RO=0, AC=1).

//Build Wall Plan Variables:

const int cBuildWallPlanWallType=0; (RO=0, AC=1).
const int cBuildWallPlanWallStart=1; (RO=0, AC=1).
const int cBuildWallPlanWallEnd=2; (RO=0, AC=1).
const int cBuildWallPlanWallRingCenterPoint=3; (RO=0, AC=1).
const int cBuildWallPlanWallRingRadius=4; (RO=0, AC=1).
const int cBuildWallPlanNumberOfGates=5; (RO=0, AC=1).
const int cBuildWallPlanAreaIDs=6; (RO=0, AC=1).
const int cBuildWallPlanFoundationID=7; (RO=0, AC=1).
const int cBuildWallPlanGateIndices=8; (RO=0, AC=1).
const int cBuildWallPlanGateProtoIDs=9; (RO=0, AC=1).
const int cBuildWallPlanEdgeOfMapBuffer=10; (RO=0, AC=1).
const int cBuildWallPlanPieces=11; (RO=1, AC=1).
const int cBuildWallPlanPiecePositions=12; (RO=1, AC=1).
const int cBuildWallPlanPieceRotations=13; (RO=1, AC=1).
const int cBuildWallPlanEnRoute=14; (RO=0, AC=1).

//Build Wall Plan Wall Types:

const int cBuildWallPlanWallTypeStraight=0;
const int cBuildWallPlanWallTypeRing=1;
const int cBuildWallPlanWallTypeArea=2;

//Herd Plan Variables:

const int cHerdPlanBuildingID=0;
const int cHerdPlanBuildingTypeID=1;
const int cHerdPlanDistance=2;

//Farm Plan Variables:

const int cFarmPlanDropsiteTypeID=0;
const int cFarmPlanDropsiteID=1;
const int cFarmPlanFarmingPosition=2;
const int cFarmPlanAutoBuildDropsite=3;
const int cFarmPlanResourceID=4;
const int cFarmPlanBreakDownID=5;
const int cFarmPlanResourceType=6;
const int cFarmPlanResourceSubType=7;
const int cFarmPlanFarmID=8;

//Empower Plan Variables:

const int cEmpowerPlanTargetID=0;
const int cEmpowerPlanTargetTypeID=1;

//Fish Plan Variables:

const int cFishPlanLandPoint=0; (RO=0, AC=1).
const int cFishPlanWaterPoint=1; (RO=0, AC=1).
const int cFishPlanLandGroupID=2; (RO=0, AC=1).
const int cFishPlanWaterGroupID=3; (RO=0, AC=1).
const int cFishPlanAutoTrainBoats=4; (RO=0, AC=1).
const int cFishPlanNumberInTraining=5; (RO=0, AC=1).
const int cFishPlanDockID=6; (RO=0, AC=1).
const int cFishPlanMaximumDockDist=7; (RO=0, AC=1).
const int cFishPlanPlaceRetries=8; (RO=0, AC=1).
const int cFishPlanMaxPlaceRetries=9; (RO=0, AC=1).

//Transport Plan Variables:

const int cTransportPlanTransportID=0; (RO=0, AC=1).
const int cTransportPlanTransportTypeID=1; (RO=0, AC=1).
const int cTransportPlanGatherPoint=2; (RO=0, AC=1).
const int cTransportPlanTargetPoint=3; (RO=0, AC=1).
const int cTransportPlanGatherAreaGroup=4; (RO=0, AC=1).
const int cTransportPlanTargetAreaGroup=5; (RO=0, AC=1).
const int cTransportPlanGatherArea=6; (RO=0, AC=1).
const int cTransportPlanTargetArea=7; (RO=0, AC=1).
const int cTransportPlanPathType=8; (RO=0, AC=1).
const int cTransportPlanPathPlanned=9; (RO=0, AC=1).
const int cTransportPlanReturnWhenDone=10; (RO=0, AC=1).
const int cTransportPlanMaximizeXportMovement=11; (RO=0, AC=1).
const int cTransportPlanUnitsMoved=12; (RO=0, AC=0).
const int cTransportPlanIgnoreAreaIDs=13; (RO=0, AC=1).
const int cTransportPlanBestDangerArea=14; (RO=0, AC=1).
const int cTransportPlanBestDangerValue=15; (RO=0, AC=1).
const int cTransportPlanDropOffPoint=16; (RO=0, AC=1).
const int cTransportPlanPersistent=17; (RO=0, AC=1).
const int cTransportPlanMiddleAreaGroups=18; (RO=0, AC=0).

//Repair Plan Variables:

const int cRepairPlanTargetID=0; (RO=0, AC=1).
//Trade Plan Variables:
const int cTradePlanTargetUnitTypeID=0; (RO=0, AC=1).
const int cTradePlanTargetUnitID=1; (RO=0, AC=1).
const int cTradePlanStartPosition=2; (RO=0, AC=1).
const int cTradePlanTradeUnitType=3; (RO=0, AC=1).
const int cTradePlanTradeUnitTypeMax=4; (RO=0, AC=1).
const int cTradePlanMarketID=5; (RO=0, AC=1).

//Dropoff Resource Plan Variables:

const int cDropoffResourcePlanBuildingID=0;
const int cDropoffResourcePlanBuildingTypeID=1;

//Gather Relic Plan Variables:

const int cGatherRelicPlanDropsiteID=0; (RO=0, AC=1).
const int cGatherRelicPlanDropsiteTypeID=1; (RO=0, AC=1).
const int cGatherRelicPlanTargetID=2; (RO=0, AC=1).
const int cGatherRelicPlanTargetTypeID=3; (RO=0, AC=1).
const int cGatherRelicPlanTargetPosition=4; (RO=0, AC=1).
const int cGatherRelicPlanPickingUp=5; (RO=0, AC=1).

//Attack Strategy Plan Variables:

const int cAttackStrategyPlanPlayerID=0; (RO=0, AC=0).
const int cAttackStrategyPlanNumberTotalAttacks=1; (RO=1, AC=1).

//Defend Plan Variables:

const int cDefendPlanDefendTargetID=0; (RO=0, AC=0).
const int cDefendPlanDefendAreaID=1; (RO=0, AC=0).
const int cDefendPlanDefendBaseID=2; (RO=0, AC=0).
const int cDefendPlanDefendPoint=3; (RO=0, AC=0).
const int cDefendPlanEngageRange=4; (RO=0, AC=1).
const int cDefendPlanPatrol=5; (RO=0, AC=1).
const int cDefendPlanPatrolWaypoint=6; (RO=0, AC=0).
const int cDefendPlanCurrentWaypoint=7; (RO=0, AC=1).
const int cDefendPlanTargetID=8; (RO=1, AC=0).
const int cDefendPlanGatherDistance=9; (RO=0, AC=1).
const int cDefendPlanRefreshFrequency=10; (RO=0, AC=1).
const int cDefendPlanLastRefreshTime=11; (RO=1, AC=1).
const int cDefendPlanAttackTypeID=12; (RO=0, AC=0).
const int cDefendPlanGatherPercentage=13; (RO=0, AC=1).

//Reserve Plan Variables:

const int cReservePlanPlanType=0; (RO=0, AC=0).

//Goal Plan Variables:

const int cGoalPlanGoalType=0; (RO=0, AC=1).
const int cGoalPlanGoalSubType=1; (RO=0, AC=1).
const int cGoalPlanMinTime=2; (RO=0, AC=1).
const int cGoalPlanMaxTime=3; (RO=0, AC=1).
const int cGoalPlanMinAge=4; (RO=0, AC=1).
const int cGoalPlanMaxAge=5; (RO=0, AC=1).
const int cGoalPlanRepeat=6; (RO=0, AC=1).
const int cGoalPlanExecuteCount=7; (RO=0, AC=1).
const int cGoalPlanDoneGoal=8; (RO=0, AC=0).
const int cGoalPlanFailGoal=9; (RO=0, AC=0).
const int cGoalPlanExecuteGoal=10; (RO=0, AC=0).
const int cGoalPlanAutoUpdateState=11; (RO=0, AC=1).
const int cGoalPlanAutoUpdateBase=12; (RO=0, AC=1).
const int cGoalPlanAutoUpdateAttackPlayerID=13; (RO=0, AC=1).
const int cGoalPlanTargetType=14; (RO=0, AC=1).
const int cGoalPlanTarget=15; (RO=0, AC=1).
const int cGoalPlanTargetPoint=16; (RO=0, AC=1).
const int cGoalPlanTargetNumber=17; (RO=0, AC=1).
const int cGoalPlanMinUnitNumber=18; (RO=0, AC=1).
const int cGoalPlanMaxUnitNumber=19; (RO=0, AC=1).
const int cGoalPlanUnitPickerID=20; (RO=0, AC=1).
const int cGoalPlanUnitPickerFrequency=21; (RO=0, AC=1).
const int cGoalPlanUnitPickerTime=22; (RO=0, AC=1).
const int cGoalPlanAttackPlayerID=23; (RO=0, AC=1).
const int cGoalPlanAttackStartFrequency=24; (RO=0, AC=1).
const int cGoalPlanAttackStartTime=25; (RO=0, AC=1).
const int cGoalPlanUnitTypeID=26; (RO=0, AC=0).
const int cGoalPlanBaseID=27; (RO=0, AC=0).
const int cGoalPlanAllowRetreat=28; (RO=0, AC=1).
const int cGoalPlanUpgradeBuilding=29; (RO=0, AC=1).
const int cGoalPlanSetAreaGroups=30; (RO=0, AC=1).
const int cGoalPlanIdleAttack=31; (RO=0, AC=1).
const int cGoalPlanAreaGroupID=32; (RO=0, AC=0).
const int cGoalPlanFunctionID=33; (RO=0, AC=0).
const int cGoalPlanFunctionParm=34; (RO=0, AC=0).
const int cGoalPlanBuildingTypeID=35; (RO=0, AC=0).
const int cGoalPlanBuildingPlacementID=36; (RO=0, AC=0).
const int cGoalPlanBuildingSearchID=37; (RO=0, AC=0).
const int cGoalPlanActiveHealthTypeID=38; (RO=0, AC=1).
const int cGoalPlanActiveHealth=39; (RO=0, AC=1).

//Goal Plan Goal Types:

const int cGoalPlanGoalTypeForwardBase=0;
const int cGoalPlanGoalTypeCreateBase=1;
const int cGoalPlanGoalTypeMainBase=2;
const int cGoalPlanGoalTypeAttack=3;
const int cGoalPlanGoalTypeDefend=4;
const int cGoalPlanGoalTypeTrain=5;
const int cGoalPlanGoalTypeMaintain=6;
const int cGoalPlanGoalTypeResearch=7;
const int cGoalPlanGoalTypeAge=8;
const int cGoalPlanGoalTypeCallback=9;
const int cGoalPlanGoalTypeBuilding=10;
const int cGoalPlanGoalTypeBuildSettlement=11;

//Goal Plan Goal Sub Types:

const int cGoalPlanGoalSubTypeEmpty1=0;
const int cGoalPlanGoalSubTypeEmpty2=1;

//Goal Plan Target Types:

const int cGoalPlanTargetTypeArea=0;
const int cGoalPlanTargetTypeAreaGroup=1;
const int cGoalPlanTargetTypePoint=2;
const int cGoalPlanTargetTypeUnitType=3;
const int cGoalPlanTargetTypeUnit=4;
const int cGoalPlanTargetTypePlayer=5;
const int cGoalPlanTargetTypePlayerRelation=6;
const int cGoalPlanTargetTypeTech=7;

//Tower Plan Variables:

const int cTowerPlanCenterLocation=0; (RO=0, AC=1).
const int cTowerPlanAreaID=1; (RO=0, AC=1).
const int cTowerPlanDistanceFromCenter=2; (RO=0, AC=1).
const int cTowerPlanMaximizeLOS=3; (RO=0, AC=1).
const int cTowerPlanMaximizeAttack=4; (RO=0, AC=1).
const int cTowerPlanNumberToBuild=5; (RO=0, AC=1).
const int cTowerPlanBuildLocations=6; (RO=1, AC=1).
const int cTowerPlanProtoIDToBuild=7; (RO=0, AC=1).
const int cTowerPlanAttackLOSModifier=8; (RO=0, AC=1).
const int cTowerPlanLOSModifier=9; (RO=0, AC=1).

//Gather Goal Plan Variables:

const int cGatherGoalPlanScriptRPGPct=0; (RO=0, AC=1).
const int cGatherGoalPlanCostRPGPct=1; (RO=0, AC=1).
const int cGatherGoalPlanGathererPct=2; (RO=0, AC=1).
const int cGatherGoalPlanNumFoodPlans=3; (RO=0, AC=1).
const int cGatherGoalPlanNumWoodPlans=4; (RO=0, AC=1).
const int cGatherGoalPlanNumGoldPlans=5; (RO=0, AC=1).
const int cGatherGoalPlanNumFavorPlans=6; (RO=0, AC=1).
const int cGatherGoalPlanMinResourceAmt=7; (RO=0, AC=1).
const int cGatherGoalPlanResourceCostWeight=8; (RO=0, AC=1).
const int cGatherGoalPlanFarmLimitPerPlan=9; (RO=0, AC=1).
const int cGatherGoalPlanMaxFarmLimit=10; (RO=0, AC=1).
const int cGatherGoalPlanResourceSkew=11; (RO=0, AC=1).

//ProtoPower Constants:
const int cPowerLure=0;
const int cPowerBlessingofZeus=1;
const int cPowerBolt=2;
const int cPowerbramble=3;
const int cPowerBronze=4;
const int cPowerCeaseFireNomad=5;
const int cPowerCeaseFire=6;
const int cPowerCitadel=7;
const int cPowerDwarvenMine=8;
const int cPowerCurse=9;
const int cPowerEarthquake=10;
const int cPowerEclipse=11;
const int cPowerEnrage=12;
const int cPowerFlamingWeapons=13;
const int cPowerForestFire=14;
const int cPowerFrost=15;
const int cPowerGreatHunt=16;
const int cPowerHealingSpring=17;
const int cPowerInferno=18;
const int cPowerLightningStorm=19;
const int cPowerLocustSwarm=20;
const int cPowerMeteor=21;
const int cPowerNidhogg=22;
const int cPowerOmniscience=23;
const int cPowerOracle=24;
const int cPowerPestilence=25;
const int cPowerPlenty=26;
const int cPowerProsperity=27;
const int cPowerRagnorok=28;
const int cPowerRain=29;
const int cPowerRebellion=30;
const int cPowerRestoration=31;
const int cPowerShiftingSands=32;
const int cPowerSentinel=33;
const int cPowerPlagueofSerpents=34;
const int cPowershepherd=35;
const int cPowersight=36;
const int cPowerAncestors=37;
const int cPowerFimbulwinter=38;
const int cPowerSonofOsiris=39;
const int cPowerSPCMeteor=40;
const int cPowerSpy=41;
const int cPowerTornado=42;
const int cPowerUndermine=43;
const int cPowerUnderworldPassage=44;
const int cPowerVision=45;
const int cPowerWalkingWoods=46;
const int cPowerWellOfUrd=47;
const int cPowerwild=48;

//Power Type Constants:

const int cPowerTypeGeneric=0;
const int cPowerTypeTempUnit=1;
const int cPowerTypeLightning=2;
const int cPowerTypeFrost=3;
const int cPowerTypeLocust=4;
const int cPowerTypeTeleport=5;
const int cPowerTypeMeteor=6;
const int cPowerTypeInferno=7;
const int cPowerTypeHealing=8;
const int cPowerTypeEnrage=9;
const int cPowerTypeClone=10;
const int cPowerTypeDamageUnit=11;
const int cPowerTypeTornado=12;
const int cPowerTypeRain=13;
const int cPowerTypeUndermine=14;
const int cPowerTypeSnowStorm=15;
const int cPowerTypeBronze=16;
const int cPowerTypePeace=17;
const int cPowerTypeProsperity=18;
const int cPowerTypeEclipse=19;
const int cPowerTypeShowUnit=20;
const int cPowerTypeBolt=21;
const int cPowerTypeSpy=22;
const int cPowerTypeTechActivate=23;
const int cPowerTypeAnimalMagnet=24;
const int cPowerTypeHealingSpring=25;
const int cPowerTypeSwapUnit=26;
const int cPowerTypeRebellion=27;
const int cPowerTypeSandstorm=28;
const int cPowerTypeEarthquake=29;
const int cPowerTypePlenty=30;
const int cPowerTypeForestFire=31;
const int cPowerTypeFlamingWeapons=32;
const int cPowerTypeDwarvenMines=33;
const int cPowerTypePestilence=34;

//God Power Plan Variables:

const int cGodPowerPlanPowerTechID=0; (RO=0, AC=1).
const int cGodPowerPlanPowerProtoID=1; (RO=1, AC=1).
const int cGodPowerPlanCastNow=2; (RO=0, AC=1).
const int cGodPowerPlanAutoCast=3; (RO=0, AC=1).
const int cGodPowerPlanTargetingModel=4; (RO=0, AC=1).
const int cGodPowerPlanTargetLocation=5; (RO=0, AC=1).
const int cGodPowerPlanTargetUnit=6; (RO=0, AC=0).
const int cGodPowerPlanAttackPlanID=7; (RO=0, AC=1).
const int cGodPowerPlanResourceType=8; (RO=0, AC=0).
const int cGodPowerPlanEvaluationModel=9; (RO=0, AC=1).
const int cGodPowerPlanCount=10; (RO=0, AC=0).
const int cGodPowerPlanBPID=11; (RO=0, AC=0).
const int cGodPowerPlanBPBufferSpace=12; (RO=0, AC=1).
const int cGodPowerPlanDistance=13; (RO=0, AC=0).
const int cGodPowerPlanTargetHintLocation=14; (RO=1, AC=0).
const int cGodPowerPlanUnitTypeID=15; (RO=0, AC=1).
const int cGodPowerPlanType=16; (RO=1, AC=1).
const int cGodPowerPlanQueryID=17; (RO=0, AC=0).
const int cGodPowerPlanBuildingPlacementDistance=18; (RO=0, AC=1).
const int cGodPowerPlanBPInfluence=19; (RO=0, AC=0).
const int cGodPowerPlanBPInfluenceValue=20; (RO=0, AC=0).
const int cGodPowerPlanBPInfluenceDistance=21; (RO=0, AC=0).
const int cGodPowerPlanBPLocationPreference=22; (RO=0, AC=0).
const int cGodPowerPlanResourceSubType=23; (RO=0, AC=0).
const int cGodPowerPlanResourceFilterHuntable=24; (RO=0, AC=0).
const int cGodPowerPlanResourceFilterTotal=25; (RO=0, AC=0).
const int cGodPowerPlanQueryHitpointFilter=26; (RO=0, AC=0).
const int cGodPowerPlanTargetHintUnitID=27; (RO=1, AC=0).
const int cGodPowerPlanQueryPlayerID=28; (RO=0, AC=1).
const int cGodPowerPlanQueryPlayerRelation=29; (RO=0, AC=0).
const int cGodPowerPlanExplorePlanID=30; (RO=1, AC=0).
const int cGodPowerPlanCastAttempts=31; (RO=1, AC=1).
const int cGodPowerPlanCheckVisibility=32; (RO=0, AC=1).

//GodPower Targeting Models:

const int cGodPowerTargetingModelUnit=0;
const int cGodPowerTargetingModelLocation=1;
const int cGodPowerTargetingModelDualUnit=2;
const int cGodPowerTargetingModelDualLocation=3;
const int cGodPowerTargetingModelWorld=4;
const int cGodPowerTargetingModelTown=5;
const int cGodPowerTargetingModelAttachedPlanLocation=6;
const int cGodPowerTargetingModelTownCenter=7;
const int cGodPowerTargetingModelMilitaryGatherPoint=8;
const int cGodPowerTargetingModelNearbyUnitType=9;
const int cGodPowerTargetingModelDualPlace=10;

//GodPower Evaluation Models:

const int cGodPowerEvaluationModelNone=0;
const int cGodPowerEvaluationModelWorkers=1;
const int cGodPowerEvaluationModelCombatDistance=2;
const int cGodPowerEvaluationModelCombatDistanceSelf=3;
const int cGodPowerEvaluationModelQuery=4;
const int cGodPowerEvaluationModelKBResource=5;

//GodPower Plan Types:

const int cGodPowerPlanTypeDefault=0;
const int cGodPowerPlanTypeRequiresAttackPlan=1;

//Transport PathTypes:
const int cTransportPathTypePoints=0;
const int cTransportPathTypeAreas=1;

//Resign Types:
const int cResignGatherers=0;
const int cResignSettlements=1;
const int cResignTeammates=2;
const int cResignMilitaryPop=3;

//Unit Movement Types:

const int cMovementTypeNone=0;
const int cMovementTypeLand=1;
const int cMovementTypeWater=2;
const int cMovementTypeAir=4;
const int cMovementTypeNonSolid=8;

//KB Unit States:

const int cUnitStateNone=0;
const int cUnitStateBuilding=1;
const int cUnitStateAlive=2;
const int cUnitStateDead=4;
const int cUnitStateAny=255;
const int cUnitStateAliveOrBuilding=3;

//Building Placement Events:

const int cBuildingPlacementEventDone=0;
const int cBuildingPlacementEventFailed=1;

//Unit Query Constants:

const int cUnitQueryNoArmy=-1;
const int cUnitQueryInvalidArmy=-1002;

//Building Placement Preferences:

const int cBuildingPlacementPreferenceNone=-1;
const int cBuildingPlacementPreferenceBack=0;
const int cBuildingPlacementPreferenceFront=1;
const int cBuildingPlacementPreferenceLeft=2;

//Civs:
const int cCivZeus=0;
const int cCivPoseidon=1;
const int cCivHades=2;
const int cCivIsis=3;
const int cCivRa=4;
const int cCivSet=5;
const int cCivOdin=6;
const int cCivThor=7;
const int cCivLoki=8;
const int cCivRandom=9;
const int cCivGreek=10;
const int cCivNorse=11;
const int cCivEgyptian=12;
const int cCivNature=13;

//Cultures:
const int cCultureGreek=0;
const int cCultureEgyptian=1;
const int cCultureNorse=2;
const int cCultureNature=3;

//Resources:
const int cResourceGold=0;
const int cResourceWood=1;
const int cResourceFood=2;
const int cResourceFavor=3;
const int cAllResources=-1234;
//Unit Action Constants:
const int cActionBored=0;
const int cActionBuild=1;
const int cActionConvert=2;
const int cActionDeath=3;
const int cActionDecay=4;
const int cActionGather=5;
const int cActionHandAttack=6;
const int cActionHeal=7;
const int cActionHunting=8;
const int cActionIdle=9;
const int cActionMove=10;
const int cActionMoveByGroup=11;
const int cActionRangedAttack=12;
const int cActionRepair=13;
const int cActionResearch=14;
const int cActionTrain=15;
const int cActionOverrideAnimation=16;
const int cActionWork=17;
const int cActionAttack=18;
const int cActionUnused0=19;
const int cActionWander=20;
const int cActionEnter=21;
const int cActionAutoConvert=22;
const int cActionBirth=23;
const int cActionAreaAttack=24;
const int cActionFreeze=25;
const int cActionDormant=26;
const int cActionGatherPoint=27;
const int cActionMoveAttack=28;
const int cActionThrown=29;
const int cActionLightning=30;
const int cActionLight=31;
const int cActionJumpAttack=32;
const int cActionUnused1=33;
const int cActionMeteor=34;
const int cActionAttach=35;
const int cActionGuide=36;
const int cActionJumpMove=37;
const int cActionPickup=38;
const int cActionDiveBomb=39;
const int cActionUnused2=40;
const int cActionRegenerate=41;
const int cActionUse=42;
const int cActionEmpower=43;
const int cActionAutoGather=44;
const int cActionThrow=45;
const int cActionGore=46;
const int cActionDropoff=47;
const int cActionWhirlwindAttack=48;
const int cActionChargedRangedAttack=49;
const int cActionEject=50;
const int cActionFreezeAttack=51;
const int cActionConvertAttack=52;
const int cActionTrade=53;
const int cActionGuard=54;
const int cActionAutoMover=55;
const int cActionGetOnMover=56;
const int cActionSwallow=57;
const int cActionGate=58;
const int cActionLightningAttack=59;
const int cActionExplore=60;
const int cActionEat=61;
const int cActionBoost=62;
const int cActionCorpseDecay=63;
const int cActionTeleport=64;
const int cActionBuckAttack=65;
const int cActionTownBell=66;
const int cActionHeroDeath=67;
const int cActionHeroDeath=67;
//Tech Status:
const int cTechStatusUnobtainable=0;
const int cTechStatusObtainable=1;
const int cTechStatusAvailable=2;
const int cTechStatusResearching=3;
const int cTechStatusActive=4;
const int cTechStatusPersistent=5;

//Attack Routes:
const int cAttackRouteFrontRight=0;
const int cAttackRouteRightFront=1;
const int cAttackRouteRightBack=2;
const int cAttackRouteBackRight=3;
const int cAttackRouteBackLeft=4;
const int cAttackRouteLeftBack=5;
const int cAttackRouteLeftFront=6;
const int cAttackRouteFrontLeft=7;

//Area Types:
const int cAreaTypeForest=1;
const int cAreaTypeWater=2;
const int cAreaTypeImpassableLand=3;
const int cAreaTypeGold=4;
const int cAreaTypeSettlement=5;

//AreaGroup Types:
const int cAreaGroupTypeLand=0;
const int cAreaGroupTypeWater=1;

//KB TechTree Unit Functions:

const int cUnitFunctionBuilder=0;
const int cUnitFunctionGatherer=1;
const int cUnitFunctionEmpower=2;
const int cUnitFunctionFish=3;
const int cUnitFunctionWaterTransport=4;
const int cUnitFunctionTrade=5;
const int cUnitFunctionUnknown=6;

//KB TechTree Upgrade Types:

const int cUpgradeTypeAttack=0;
const int cUpgradeTypeArmor=1;
const int cUpgradeTypeHitpoints=2;
const int cUpgradeTypeSpeed=3;
const int cUpgradeTypeWorkRate=4;
const int cUpgradeTypeTrainPoints=5;
const int cUpgradeTypeAny=6;

//KB TechTree Progression:

const int cProgressionTechNode=0;
const int cProgressionUnitNode=1;

//Wall Types:
const int cWallTypeStraight=0;
const int cWallTypeRing=1;
const int cWallTypeArea=2;

//Communications Constants:

//Response Types:
const int cAICommResponseNoneRequired=0;
const int cAICommResponseWaiting=1;
const int cAICommResponseYes=2;
const int cAICommResponseNo=3;
const int cAICommResponseIncomingOrder=4;

//AI Chat Types:

const int cAICommRecordPrompt=0;
const int cAICommRecordOrder=1;
const int cAICommRecordStatement=2;
//Prompt Types:
const int cAICommPromptNone=0;
const int cAICommPromptAIBuildSettlement=1;
const int cAICommPromptAIResignGatherers=2;
const int cAICommPromptAIResignSettlements=3;
const int cAICommPromptAIResignActiveEnemies=4;
const int cAICommPromptIntro=5;
const int cAICommPromptGenericGodPower=6;
const int cAICommPromptOffensiveGodPower=7;
const int cAICommPromptEconomicGodPower=8;
const int cAICommPromptAILostSettlement=9;
const int cAICommPromptAILostLastSettlement=10;
const int cAICommPromptEnemyBuildSettlement=11;
const int cAICommPromptEnemyLostSettlement=12;
const int cAICommPromptEnemyLostLastSettlement=13;
const int cAICommPromptAIWinningAgeRace=14;
const int cAICommPromptAILosingAgeRace=15;
const int cAICommPromptAIWonderDestroyed=16;
const int cAICommPromptPlayerWonderDestroyed=17;
const int cAICommPromptPlayerBuildingWalls=18;
const int cAICommPromptAIAttack=19;
const int cAICommPromptAIAttackHere=20;
const int cAICommPromptAIRetreat=21;
const int cAICommPromptHelpHere=22;
const int cAICommPromptHelpHome=23;
const int cAICommPromptAITakeWater=24;
const int cAICommPromptTakingEnemyRelic=25;
const int cAICommPromptTakingAllyRelic=26;
const int cAICommPromptResignQuestion=27;

//Techs: 387 total

const int cTechAge1=0;
const int cTechAge2=1;
const int cTechAge3=2;
const int cTechMediumArchers=3;
const int cTechHeavyArchers=4;
const int cTechChampionArchers=5;
const int cTechMediumInfantry=6;
const int cTechHeavyInfantry=7;
const int cTechChampionInfantry=8;
const int cTechHusbandry=9;
const int cTechPlow=10;
const int cTechIrrigation=11;
const int cTechCopperWeapons=12;
const int cTechBronzeWeapons=13;
const int cTechIronWeapons=14;
const int cTechCopperMail=15;
const int cTechBronzeMail=16;
const int cTechIronMail=17;
const int cTechCopperShields=18;
const int cTechBronzeShields=19;
const int cTechIronShields=20;
const int cTechAmbassadors=21;
const int cTechTaxCollectors=22;
const int cTechCoinage=23;
const int cTechMediumCavalry=24;
const int cTechHeavyCavalry=25;
const int cTechChampionCavalry=26;
const int cTechWatchTower=27;
const int cTechGuardTower=28;
const int cTechBallistaTower=29;
const int cTechBoilingOil=30;
const int cTechLevyInfantry=31;
const int cTechBurningPitch=32;
const int cTechMasons=33;
const int cTechPickaxe=34;
const int cTechHandAxe=35;
const int cTechShaftMine=36;
const int cTechBowSaw=37;
const int cTechQuarry=38;
const int cTechCarpenters=39;
const int cTechBravery=40;
const int cTechValleyoftheKings=41;
const int cTechLightningStorm=42;
const int cTechLocustSwarm=43;
const int cTechTornado=44;
const int cTechWinterHarvest=45;
const int cTechSafeguard=46;
const int cTechRampage=47;
const int cTechMithrilBreastplate=48;
const int cTechCallOfValhalla=49;
const int cTechArcticWinds=50;
const int cTechArcticGale=51;
const int cTechWrathOfTheDeep=52;
const int cTechSpiritedCharge=53;
const int cTechThunderingHooves=54;
const int cTechBerserkergang=55;
const int cTechRime=56;
const int cTechFrost=57;
const int cTechDraftHorses=58;
const int cTechEngineers=59;
const int cTechArchitects=60;
const int cTechMeteor=61;
const int cTechBoneBow=62;
const int cTechAxeofVengeance=63;
const int cTechDesertWind=64;
const int cTechEnclosedDeck=65;
const int cTechCladding=66;
const int cTechFortifiedWall=67;
const int cTechAge1Zeus=68;
const int cTechSkinOfTheRhino=69;
const int cTechAge15Egyptian=70;
const int cTechSacredCats=71;
const int cTechGraniteBlood=72;
const int cTechHamarrtroll=73;
const int cTechCriosphinx=74;
const int cTechHieracosphinx=75;
const int cTechMonstrousRage=76;
const int cTechPhobosSpearofPanic=77;
const int cTechBacchanalia=78;
const int cTechSunRay=79;
const int cTechSylvanLore=80;
const int cTechForgeofOlympus=81;
const int cTechAge1Hades=82;
const int cTechAge1Poseidon=83;
const int cTechCreateGold=84;
const int cTechAge1Ra=85;
const int cTechAge1Isis=86;
const int cTechAge1Set=87;
const int cTechAge1Odin=88;
const int cTechAge1Thor=89;
const int cTechAge1Loki=90;
const int cTechAuroraBorealis=91;
const int cTechAge2Athena=92;
const int cTechAge2Ares=93;
const int cTechAge2Hermes=94;
const int cTechAge3Dionysos=95;
const int cTechAge3Apollo=96;
const int cTechAge3Aphrodite=97;
const int cTechAge4Hera=98;
const int cTechAge4Artemis=99;
const int cTechAge4Hephaestus=100;
const int cTechHuntingDogs=101;
const int cTechHandofTalos=102;
const int cTechSarissa=103;
const int cTechAegisShield=104;
const int cTechWingedMessenger=105;
const int cTechAge2Anubis=106;
const int cTechAge2Bast=107;
const int cTechAge2Ptah=108;
const int cTechAge3Hathor=109;
const int cTechAge3Nephthys=110;
const int cTechAge3Sekhmet=111;
const int cTechAge4Thoth=112;
const int cTechAge4Osiris=113;
const int cTechAge4Horus=114;
const int cTechFeetoftheJackal=115;
const int cTechAge4=116;
const int cTechAge2Forseti=117;
const int cTechAge2Heimdall=118;
const int cTechAge2Freyja=119;
const int cTechAge3Skadi=120;
const int cTechAge3Bragi=121;
const int cTechAge3Njord=122;
const int cTechAge4Hel=123;
const int cTechAge4Baldr=124;
const int cTechAge4Tyr=125;
const int cTechSignalFires=126;
const int cTechStoneWall=127;
const int cTechShoulderofTalos=128;
const int cTechSkeletonPower=129;
const int cTechBookofThoth=130;
const int cTechFaceoftheGorgon=131;
const int cTechCitadelWall=132;
const int cTechUnderworldPassage=133;
const int cTechRestoration=134;
const int cTechConscriptInfantry=135;
const int cTechLevyArchers=136;
const int cTechConscriptArchers=137;
const int cTechLevyCavalry=138;
const int cTechConscriptCavalry=139;
const int cTechCarrierPigeons=140;
const int cTechFloodControl=141;
const int cTechPharaohRespawn=142;
const int cTechStartingUnitsNorse=143;
const int cTechStartingUnitsGreek=144;
const int cTechStartingUnitsEgyptian=145;
const int cTechGreatHunt=146;
const int cTechCeaseFire=147;
const int cTechMonument1=148;
const int cTechMonument2=149;
const int cTechMonument3=150;
const int cTechMonument4=151;
const int cTechUndermine=152;
const int cTechDwarvenMail=153;
const int cTechDwarvenShields=154;
const int cTechDwarvenWeapons=155;
const int cTechRain=156;
const int cTechSerpentSpear=157;
const int cTechFloodoftheNile=158;
const int cTechVaultsofErebus=159;
const int cTechLordofHorses=160;
const int cTechOlympicParentage=161;
const int cTechPigSticker=162;
const int cTechLoneWanderer=163;
const int cTechEyesintheForest=164;
const int cTechScallopedAxe=165;
const int cTechRingGiver=166;
const int cTechLongSerpent=167;
const int cTechSwineArray=168;
const int cTechAge15Norse=169;
const int cTechAge15Greek=170;
const int cTechOdinsRavenRespawn=171;
const int cTechSnowStorm=172;
const int cTechHeavyCamelry=173;
const int cTechChampionCamelry=174;
const int cTechBronze=175;
const int cTechPharaohRespawnOsiris=176;
const int cTechNewKingdom=177;
const int cTechMedjay=178;
const int cTechFuneralRites=179;
const int cTechSpiritofMaat=180;
const int cTechCityoftheDead=181;
const int cTechFortifyTownCenter=182;
const int cTechHeroesZeusAge2=183;
const int cTechHeroesZeusAge3=184;
const int cTechHeroesZeusAge4=185;
const int cTechHeroesPoseidonAge2=186;
const int cTechHeroesPoseidonAge3=187;
const int cTechHeroesPoseidonAge4=188;
const int cTechHeroesHadesAge2=189;
const int cTechHeroesHadesAge3=190;
const int cTechHeroesHadesAge4=191;
const int cTechShaduf=192;
const int cTechMonument0=193;
const int cTechRelicAnkhofRa=194;
const int cTechRelicEyeofHorus=195;
const int cTechRelicSistrumofBast=196;
const int cTechRelicHeadofOrpheus=197;
const int cTechRelicRingoftheNibelung=198;
const int cTechRelicStaffofDionysus=199;
const int cTechRelicFettersofFenrir=200;
const int cTechRelicOdinsSpear=201;
const int cTechRelicKitharaofApollo=202;
const int cTechRelicMithrilHorseshoes=203;
const int cTechRelicBowofArtemis=204;
const int cTechRelicWedjatEye=205;
const int cTechRelicNoseoftheSphinx=206;
const int cTechGoldenApples=207;
const int cTechEldhrimnirKettle=208;
const int cTechRelicArrowsofAlfar=209;
const int cTechRelicToothedArrows=210;
const int cTechRelicWandofGambantein=211;
const int cTechProsperity=212;
const int cTechPegasusRelicRespawn=213;
const int cTechRelicGoldenBridleofPegasus=214;
const int cTechEclipse=215;
const int cTechWillofKronos=216;
const int cTechLabyrinthofMinos=217;
const int cTechFlamesofTyphon=218;
const int cTechDivineBlood=219;
const int cTechShaftsofPlague=220;
const int cTechBonusPoseidon=221;
const int cTechVision=222;
const int cTechBolt=223;
const int cTechSpy=224;
const int cTechFlamingWeapons=225;
const int cTechFlamingWeaponsActive=226;
const int cTechLossofLOS=227;
const int cTechSerpents=228;
const int cTechAnimalMagnetism=229;
const int cTechHealingSpring=230;
const int cTechCurse=231;
const int cTechSentinel=232;
const int cTechSandstorm=233;
const int cTechCitadel=234;
const int cTechWalkingWoods=235;
const int cTechRagnorok=236;
const int cTechNidhogg=237;
const int cTechPlenty=238;
const int cTechSonofOsiris=239;
const int cTechPharaohRespawnCityoftheDead=240;
const int cTechEarthquake=241;
const int cTechAthenianWall=242;
const int cTechHeroesHadesAge1=243;
const int cTechHeroesPoseidonAge1=244;
const int cTechHeroesZeusAge1=245;
const int cTechDwarvenAuger=246;
const int cTechPurseSeine=247;
const int cTechReinforcedHull=248;
const int cTechHuntressAxe=249;
const int cTechForestFire=250;
const int cTechPestilence=251;
const int cTechRelicTriosBow=252;
const int cTechRelicShardofBlueCrystal=253;
const int cTechRelicArmorofAchilles=254;
const int cTechRelicShipofFingernails=255;
const int cTechCrocodopolis=256;
const int cTechLeatherFrameShield=257;
const int cTechElectrumBullets=258;
const int cTechStonesofRedLinen=259;
const int cTechSpearontheHorizon=260;
const int cTechFeral=261;
const int cTechAnastrophe=262;
const int cTechTrierarch=263;
const int cTechThracianHorses=264;
const int cTechRelicShinglesofSteel=265;
const int cTechRelicEyeofOrnlu=266;
const int cTechRelicTuskoftheIronBoar=267;
const int cTechAssignLOS=268;
const int cTechRoarofOrthus=269;
const int cTechAtefCrown=270;
const int cTechConscriptSailors=271;
const int cTechNavalOxybeles=272;
const int cTechEnyosBowofHorror=273;
const int cTechDeimosSwordofDread=274;
const int cTechChampionElephants=275;
const int cTechHallofThanes=276;
const int cTechAdzeofWepwawet=277;
const int cTechSlingsoftheSun=278;
const int cTechRamoftheWestWind=279;
const int cTechSundriedMudBrick=280;
const int cTechFuneralBarge=281;
const int cTechNecropolis=282;
const int cTechDisableArmoryforThor=283;
const int cTechIronMailThor=284;
const int cTechBronzeMailThor=285;
const int cTechBronzeShieldsThor=286;
const int cTechBronzeWeaponsThor=287;
const int cTechIronShieldsThor=288;
const int cTechIronWeaponsThor=289;
const int cTechBurningPitchThor=290;
const int cTechHammeroftheGods=291;
const int cTechMeteoricIronMail=292;
const int cTechDragonscaleShields=293;
const int cTechTusksofApedemak=294;
const int cTechRelicPandorasBox=295;
const int cTechRelicHerasThundercloudShawl=296;
const int cTechRelicHarmoniasNecklace=297;
const int cTechRelicDwarfenCalipers=298;
const int cTechOracle=299;
const int cTechSonsofSleipnir=300;
const int cTechSetAge2Critter=301;
const int cTechSetAge3Critter=302;
const int cTechSetAge4Critter=303;
const int cTechPoseidonHippocampusRespawn=304;
const int cTechEgyptianbuildingbonus=305;
const int cTechOmniscience=306;
const int cTechMediumAxemen=307;
const int cTechHeavyAxemen=308;
const int cTechChampionAxemen=309;
const int cTechMediumSpearmen=310;
const int cTechHeavySpearmen=311;
const int cTechChampionSpearmen=312;
const int cTechHeavyChariots=313;
const int cTechChampionChariots=314;
const int cTechHeavyElephants=315;
const int cTechLevyBarracksSoldiers=316;
const int cTechConscriptBarracksSoldiers=317;
const int cTechLevyMigdolSoldiers=318;
const int cTechConscriptMigdolSoldiers=319;
const int cTechMediumSlingers=320;
const int cTechHeavySlingers=321;
const int cTechChampionSlingers=322;
const int cTechRelicGoldenLions=323;
const int cTechRelicMonkeyHead=324;
const int cTechLevyLonghouseSoldiers=325;
const int cTechConscriptLonghouseSoldiers=326;
const int cTechConscriptHillFortSoldiers=327;
const int cTechLevyHillFortSoldiers=328;
const int cTechThurisazRune=329;
const int cTechGoldenLionsRelicRespawn=330;
const int cTechMonkeyHeadRelicRespawn=331;
const int cTechRelicCanopicJarofImsety=332;
const int cTechRelicTowerofSestus=333;
const int cTechRelicTrojanGateHinge=334;
const int cTechSPCMeteor=335;
const int cTechOdinsFirstRavens=336;
const int cTechHeroesEgyptianAge1=337;
const int cTechWeakenAge1Units=338;
const int cTechSaltAmphora=339;
const int cTechMediumMigdolShadow=340;
const int cTechPoseidonFirstHippocampus=341;
const int cTechTempleofHealing=342;
const int cTechGreatestofFifty=343;
const int cTechCopperMailThor=344;
const int cTechCopperShieldsThor=345;
const int cTechCopperWeaponsThor=346;
const int cTechWeaponoftheTitans=347;
const int cTechAge2Fake=348;
const int cTechAge3Fake=349;
const int cTechAge4Fake=350;
const int cTechCrenellations=351;
const int cTechBlessingofZeus=352;
const int cTechRelicGirdleofHippolyta=353;
const int cTechSharedLOS=354;
const int cTechRelicPygmalionsStatue=355;
const int cTechRelicBlackLotus=356;
const int cTechDeathmatchGreek=357;
const int cTechDeathmatchEgyptian=358;
const int cTechDeathmatchNorse=359;
const int cTechCeasefireEffect=360;
const int cTechNorsebuildingbonus=361;
const int cTechLightningMode=362;
const int cTechFortifiedTents=363;
const int cTechDwarvenShieldsEffect=364;
const int cTechRelicHartersFolly=365;
const int cTechRelicScarabPendant=366;
const int cTechWellofUrd=367;
const int cTechRelicBootsofKickEverything=368;
const int cTechRelicAnvilofHephaestus=369;
const int cTechRelicPeltofArgus=370;
const int cTechRelicOsebergWagon=371;
const int cTechRelicBuhenFlagstone=372;
const int cTechRelicCatoblepasScales=373;
const int cTechRelicTailofCerberus=374;
const int cTechRelicBlanketofEmpressZoe=375;
const int cTechRelicKhopeshofHorus=376;
const int cTechCeaseFireNomad=377;
const int cTechEclipseActive=378;
const int cTechPlentyKOTHenable=379;
const int cTechStartingUnitsThor=380;
const int cTechSetAge1Critter=381;
const int cTechStartingResourcesEgyptian=382;
const int cTechStartingResourcesGreek=383;
const int cTechStartingResourcesNorse=384;
const int cTechRelicReedofNekhebet=385;
const int cTechWeakenTrojanGate=386;

//Unit Types: 772 total.

const int cUnitTypeHawk=0;
const int cUnitTypePalmStump=1;
const int cUnitTypeBush=2;
const int cUnitTypeArrow=3;
const int cUnitTypeAxe=4;
const int cUnitTypeBlood=5;
const int cUnitTypeScarabBlood=6;
const int cUnitTypeWaypointFlag=7;
const int cUnitTypeMoveto=8;
const int cUnitTypeTestObject=9;
const int cUnitTypeYardstick=10;
const int cUnitTypeSmoke=11;
const int cUnitTypeCloud=12;
const int cUnitTypeTornado=13;
const int cUnitTypeRevealer=14;
const int cUnitTypeAttackRevealer=15;
const int cUnitTypeConstructionSmall=16;
const int cUnitTypeConstructionMedium=17;
const int cUnitTypeConstructionLarge=18;
const int cUnitTypeConstructionExtraLarge=19;
const int cUnitTypeIceBlock=20;
const int cUnitTypePapyrus=21;
const int cUnitTypeWave=22;
const int cUnitTypeRainfall=23;
const int cUnitTypeIceSheet=24;
const int cUnitTypeCamera=25;
const int cUnitTypeCameraMotionArrow=26;
const int cUnitTypeCameraStart=27;
const int cUnitTypeWhale=28;
const int cUnitTypeFirePit=29;
const int cUnitTypeRockSymbols=30;
const int cUnitTypeStalagmite=31;
const int cUnitTypeRunestone=32;
const int cUnitTypeRockSnow=33;
const int cUnitTypeWaterLilly=34;
const int cUnitTypeWaterReeds=35;
const int cUnitTypeSnowfall=36;
const int cUnitTypeMist=37;
const int cUnitTypeWaterfall=38;
const int cUnitTypeGarrisonFlag=39;
const int cUnitTypeCrate=40;
const int cUnitTypeRugs=41;
const int cUnitTypeMarketStall=42;
const int cUnitTypeCatapultShot=43;
const int cUnitTypeMiscObjects=44;
const int cUnitTypeInfernoFireGround=45;
const int cUnitTypeLightningStrike=46;
const int cUnitTypeBallistaShot=47;
const int cUnitTypeSplash=48;
const int cUnitTypeMiscStairs=49;
const int cUnitTypeCoralReef=50;
const int cUnitTypeHeroBirth=51;
const int cUnitTypeCinematicBlock=52;
const int cUnitTypeFootprintVillager=53;
const int cUnitTypeFlamingFootprint=54;
const int cUnitTypeIcyFootprint=55;
const int cUnitTypeOarFootprint=56;
const int cUnitTypeMeteor=57;
const int cUnitTypeLightningsparks=58;
const int cUnitTypeLightningScorch=59;
const int cUnitTypeDustSmall=60;
const int cUnitTypeDustMedium=61;
const int cUnitTypeDustLarge=62;
const int cUnitTypeArrowFlaming=63;
const int cUnitTypeLightningCloud=64;
const int cUnitTypeLightningRain=65;
const int cUnitTypeUIArmyBannerFurled=66;
const int cUnitTypeUIArmyBannerPlain=67;
const int cUnitTypeUIArmyBannerInfantry=68;
const int cUnitTypeUIArmyBannerCavalry=69;
const int cUnitTypeUIArmyBannerArcher=70;
const int cUnitTypeUIArmyBannerVillager=71;
const int cUnitTypeBloodGore=72;
const int cUnitTypeLightningSparksGround=73;
const int cUnitTypeHoofprint=74;
const int cUnitTypeFootprintMilitary=75;
const int cUnitTypeFireObject=76;
const int cUnitTypeUIHeroBanner=77;
const int cUnitTypeUIIdleVillagerBanner=78;
const int cUnitTypeGiantFootprint=79;
const int cUnitTypeShark=80;
const int cUnitTypeOrca=81;
const int cUnitTypeRockGraniteSmall=82;
const int cUnitTypeRockLimestoneSmall=83;
const int cUnitTypeGrass=84;
const int cUnitTypeSeagull=85;
const int cUnitTypeRockGraniteBig=86;
const int cUnitTypeRockLimestoneBig=87;
const int cUnitTypeRockSandstoneBig=88;
const int cUnitTypeRockSandstoneSmall=89;
const int cUnitTypeRockRiverSandy=90;
const int cUnitTypeRockRiverGrassy=91;
const int cUnitTypeRockRiverIcy=92;
const int cUnitTypeShiftingSandsIn=93;
const int cUnitTypeUIArmyBannerMyth=94;
const int cUnitTypeUIIdleMilitaryBanner=95;
const int cUnitTypeHeavenlight=96;
const int cUnitTypeShiftingSandsOut=97;
const int cUnitTypeShiftingSandsOutEffect=98;
const int cUnitTypeInfernoUnitFlame=99;
const int cUnitTypeRevealertoPlayer=100;
const int cUnitTypeSkeleton=101;
const int cUnitTypeSandDriftDune=102;
const int cUnitTypeSandDriftPlain=103;
const int cUnitTypeSandDriftPatch=104;
const int cUnitTypeHealingSFX=105;
const int cUnitTypeHealingAreaSFX=106;
const int cUnitTypeFrostDrift=107;
const int cUnitTypeDustDevil=108;
const int cUnitTypeFountain=109;
const int cUnitTypeFireWood=110;
const int cUnitTypeCampfire=111;
const int cUnitTypeColumns=112;
const int cUnitTypeColumnsFallen=113;
const int cUnitTypeColumnsBroken=114;
const int cUnitTypeMilestone=115;
const int cUnitTypeSign=116;
const int cUnitTypeCloneSFX=117;
const int cUnitTypeInvisibleRam=118;
const int cUnitTypeSpear=119;
const int cUnitTypeSlingStone=120;
const int cUnitTypeRain=121;
const int cUnitTypeSnowStorm=122;
const int cUnitTypeFertilePlantsSFX=123;
const int cUnitTypeCinematicrocks=124;
const int cUnitTypeCinematicTrees=125;
const int cUnitTypeCinematicDeadBodies=126;
const int cUnitTypeDestroyedBuildingsSmall=127;
const int cUnitTypeCinematicScorch=128;
const int cUnitTypeunderminegrounddecallong=129;
const int cUnitTypeunderminegrounddecalshort=130;
const int cUnitTypeunderminegrounddecalcorner=131;
const int cUnitTypeArmorGlowSmall=132;
const int cUnitTypeTornadoDebris=133;
const int cUnitTypeRaft=134;
const int cUnitTypeMeteorImpactWater=135;
const int cUnitTypeMeteorImpactGround=136;
const int cUnitTypeRainSmall=137;
const int cUnitTypeBallofFire=138;
const int cUnitTypeIncreaseProsperityLarge=139;
const int cUnitTypeIncreaseProsperitySmall=140;
const int cUnitTypeBalloffireimpact=141;
const int cUnitTypeDove=142;
const int cUnitTypeSnowDriftArchery=143;
const int cUnitTypeSnowDriftBarracks=144;
const int cUnitTypeSnowDriftStable=145;
const int cUnitTypeSnowDriftSettlements=146;
const int cUnitTypeSnowDriftTower=147;
const int cUnitTypeSnowDriftSiege=148;
const int cUnitTypeSnowDriftMajorTemple=149;
const int cUnitTypeTunnelOpening=150;
const int cUnitTypeVolley=151;
const int cUnitTypeHadesFire=152;
const int cUnitTypeRockGraniteSprite=153;
const int cUnitTypeVisionRevealer=154;
const int cUnitTypeBoltStrike=155;
const int cUnitTypeSpyEye=156;
const int cUnitTypeCurseSFX=157;
const int cUnitTypeSentinelBase=158;
const int cUnitTypeBoltScorch=159;
const int cUnitTypeCitadelSFX=160;
const int cUnitTypeVisionSFX=161;
const int cUnitTypeRagnorokSFX=162;
const int cUnitTypeFimbulwinterSFX=163;
const int cUnitTypePlentyFlare=164;
const int cUnitTypeOsirisLightning=165;
const int cUnitTypeOsirisSFX=166;
const int cUnitTypePriestProjectile=167;
const int cUnitTypeUIArmyBannerSiege=168;
const int cUnitTypeRockLimestoneSprite=169;
const int cUnitTypeRockSandstoneSprite=170;
const int cUnitTypePineStump=171;
const int cUnitTypeOakstump=172;
const int cUnitTypeEarthquake=173;
const int cUnitTypeBarrel=174;
const int cUnitTypePots=175;
const int cUnitTypeBrokenSiegeWeapons=176;
const int cUnitTypeKrakenBits=177;
const int cUnitTypeFlowers=178;
const int cUnitTypeSeaweed=179;
const int cUnitTypeFern=180;
const int cUnitTypeFlagNumbered=181;
const int cUnitTypeScorpionTail=182;
const int cUnitTypeGenericCorpse=183;
const int cUnitTypeWadjetSpit=184;
const int cUnitTypeHeroDeath=185;
const int cUnitTypePetosuchusBeam=186;
const int cUnitTypeEarthquakeCrackA=187;
const int cUnitTypeEarthquakeCrackB=188;
const int cUnitTypeEarthquakeCrackC=189;
const int cUnitTypeEarthquakeCrackD=190;
const int cUnitTypeForestFireSFX=191;
const int cUnitTypePetosuchusprojectile=192;
const int cUnitTypeRecognizer=193;
const int cUnitTypeManticoreBarb=194;
const int cUnitTypeArrowSplashSFX=195;
const int cUnitTypePetrobolosShot=196;
const int cUnitTypeUITownBellBanner=197;
const int cUnitTypePestilenceSFX1=198;
const int cUnitTypePestilenceSFX2=199;
const int cUnitTypeHeroDeathRevealer=200;
const int cUnitTypeTestomatic=201;
const int cUnitTypeGateRamDestroyed=202;
const int cUnitTypeSpearFlaming=203;
const int cUnitTypeDestroyedBuildingsMed=204;
const int cUnitTypeDestroyedBuildingsLarge=205;
const int cUnitTypeOsiris=206;
const int cUnitTypeSPCMeteor=207;
const int cUnitTypeAvalanche=208;
const int cUnitTypeEinheriarBoostSFX=209;
const int cUnitTypeArrowSignal=210;
const int cUnitTypeOsirisBirth=211;
const int cUnitTypeOsirisBoxGlow=212;
const int cUnitTypeUIBannerObjective=213;
const int cUnitTypeOakstumpburnt=214;
const int cUnitTypeFireObjectBig=215;
const int cUnitTypeSmokeBig=216;
const int cUnitTypeUIArmyBannerHero=217;
const int cUnitTypeMummyFlies=218;
const int cUnitTypeVulture=219;
const int cUnitTypeConversionSFX=220;
const int cUnitTypeUIArmyBannerNaval=221;
const int cUnitTypeFireHades=222;
const int cUnitTypeDestruction3x3=223;
const int cUnitTypeDestruction4x4=224;
const int cUnitTypeDestruction5x5=225;
const int cUnitTypeDestruction8x8=226;
const int cUnitTypeThorhammer=227;
const int cUnitTypeRegenerationSFX=228;
const int cUnitTypePoisonSFX=229;
const int cUnitTypeTaprootlarge=230;
const int cUnitTypeTaprootSmall=231;
const int cUnitTypeShadow=232;
const int cUnitTypeDestructionSettlement=233;
const int cUnitTypeDestruction2x2=234;
const int cUnitTypeDestruction1x1=235;
const int cUnitTypeUIArmyBannerCaravan=236;
const int cUnitTypeUIArmyBannerOxcart=237;
const int cUnitTypeMInePieces=238;
const int cUnitTypeUnderworldSmoke=239;
const int cUnitTypeUnderworldExplosion=240;
const int cUnitTypeUICloudBoarder=241;
const int cUnitTypeBloodCinematic=242;
const int cUnitTypeSkeletonGiant=243;
const int cUnitTypeSkeletonAnimal=244;
const int cUnitTypeShipwreck=245;
const int cUnitTypeRuins=246;
const int cUnitTypeRottingLog=247;
const int cUnitTypeUnderbrush=248;
const int cUnitTypeGrassTall=249;
const int cUnitTypeRockCliff=250;
const int cUnitTypeUIRangeIndicatorEgyptSFX=251;
const int cUnitTypeHarpy=252;
const int cUnitTypeBlowingLeaves=253;
const int cUnitTypeHawksbill=254;
const int cUnitTypeSnowDrift=255;
const int cUnitTypeBloodFlow=256;
const int cUnitTypeBallofFireinvisible=257;
const int cUnitTypeSplashFootprint=258;
const int cUnitTypeLavaBubbling=259;
const int cUnitTypeWoodPile1=260;
const int cUnitTypeWoodPile2=261;
const int cUnitTypeWoodPile3=262;
const int cUnitTypeTrident=263;
const int cUnitTypeDestructionCitadel=264;
const int cUnitTypeForestFireAttack=265;
const int cUnitTypeUIRangeIndicatorGreekSFX=266;
const int cUnitTypeUIRangeIndicatorNorseSFX=267;
const int cUnitTypeInvisibleGate=268;
const int cUnitTypeUIArmyBannerBuilding=269;
const int cUnitTypeWaterdecoration=270;
const int cUnitTypeFootprintCavalry=271;
const int cUnitTypeFootprintAnimalLarge=272;
const int cUnitTypeFootprintAnimalSmall=273;
const int cUnitTypeFootprintSiege=274;
const int cUnitTypeEvilCloudSFX=275;
const int cUnitTypeSmokeGiant=276;
const int cUnitTypeCrateSmall=277;
const int cUnitTypeCinematicWake=278;
const int cUnitTypeWeapons=279;
const int cUnitTypeFootprintGiant=280;
const int cUnitTypeFootprintElephant=281;
const int cUnitTypeFootprintWheel=282;
const int cUnitTypeFootprintHydra=283;
const int cUnitTypeFootprintPortableRam=284;
const int cUnitTypeFootprintScorpion=285;
const int cUnitTypeFootprintScarab=286;
const int cUnitTypeSpearman=287;
const int cUnitTypeAxeman=288;
const int cUnitTypeSlinger=289;
const int cUnitTypeRaidingCavalry=290;
const int cUnitTypeCamelry=291;
const int cUnitTypeDwarf=292;
const int cUnitTypeBarracks=293;
const int cUnitTypeDock=294;
const int cUnitTypeFarm=295;
const int cUnitTypeGranary=296;
const int cUnitTypeArmory=297;
const int cUnitTypeGate=298;
const int cUnitTypeMarket=299;
const int cUnitTypeStable=300;
const int cUnitTypeFortress=301;
const int cUnitTypeMonument=302;
const int cUnitTypeSiegeCamp=303;
const int cUnitTypeWonder=304;
const int cUnitTypeCyclops=305;
const int cUnitTypeGoat=306;
const int cUnitTypeWolf=307;
const int cUnitTypePine=308;
const int cUnitTypeStorehouse=309;
const int cUnitTypeScarab=310;
const int cUnitTypeBallista=311;
const int cUnitTypeSiegeTower=312;
const int cUnitTypeCrocodile=313;
const int cUnitTypeHippo=314;
const int cUnitTypePalm=315;
const int cUnitTypeFlag=316;
const int cUnitTypeAnubite=317;
const int cUnitTypeBear=318;
const int cUnitTypeFireGiant=319;
const int cUnitTypeLocustSwarm=320;
const int cUnitTypeBoar=321;
const int cUnitTypeFrostGiant=322;
const int cUnitTypeWallLong=323;
const int cUnitTypeCatapult=324;
const int cUnitTypeCaravanNorse=325;
const int cUnitTypeTroll=326;
const int cUnitTypeMountainGiant=327;
const int cUnitTypeEinheriar=328;
const int cUnitTypeKraken=329;
const int cUnitTypeSeaTurtle=330;
const int cUnitTypeValkyrie=331;
const int cUnitTypeBattleBoar=332;
const int cUnitTypeTrireme=333;
const int cUnitTypeFishingShipGreek=334;
const int cUnitTypeBridge=335;
const int cUnitTypeCow=336;
const int cUnitTypeGiraffe=337;
const int cUnitTypeStatuePharaoh=338;
const int cUnitTypeTorch=339;
const int cUnitTypePig=340;
const int cUnitTypeLazerBear=341;
const int cUnitTypeZebra=342;
const int cUnitTypeWaterBuffalo=343;
const int cUnitTypeGazelle=344;
const int cUnitTypeBaboon=345;
const int cUnitTypeCentaur=346;
const int cUnitTypePhoenix=347;
const int cUnitTypeManticore=348;
const int cUnitTypeChimera=349;
const int cUnitTypeSphinx=350;
const int cUnitTypeMinotaur=351;
const int cUnitTypeHydra=352;
const int cUnitTypeChicken=353;
const int cUnitTypeMonkey=354;
const int cUnitTypeColossus=355;
const int cUnitTypeMummy=356;
const int cUnitTypeRoc=357;
const int cUnitTypeMedusa=358;
const int cUnitTypeObelisk=359;
const int cUnitTypeHadesDoor=360;
const int cUnitTypeAjax=361;
const int cUnitTypeArkantos=362;
const int cUnitTypeGargarensis=363;
const int cUnitTypeSetna=364;
const int cUnitTypeShabaKa=365;
const int cUnitTypeOdysseus=366;
const int cUnitTypeChiron=367;
const int cUnitTypeAmanra=368;
const int cUnitTypeWallConnector=369;
const int cUnitTypeWallShort=370;
const int cUnitTypeLeviathan=371;
const int cUnitTypeStatueLionRight=372;
const int cUnitTypeStatueLionLeft=373;
const int cUnitTypeEgyptianVulture=374;
const int cUnitTypeReginleif=375;
const int cUnitTypeScout=376;
const int cUnitTypeArcheryRange=377;
const int cUnitTypeScorpionMan=378;
const int cUnitTypeMinion=379;
const int cUnitTypeFishPerch=380;
const int cUnitTypeGreatBox=381;
const int cUnitTypeGreatBoxCart=382;
const int cUnitTypeGoldMine=383;
const int cUnitTypeKamos=384;
const int cUnitTypeOakTree=385;
const int cUnitTypePyramidLarge=386;
const int cUnitTypePyramidSmall=387;
const int cUnitTypeLion=388;
const int cUnitTypeRhinocerous=389;
const int cUnitTypeHyena=390;
const int cUnitTypeCrownedCrane=391;
const int cUnitTypeAurochs=392;
const int cUnitTypeFishMahi=393;
const int cUnitTypeFishSalmon=394;
const int cUnitTypeGiantDuckbilledPlatypus=395;
const int cUnitTypeTemple=396;
const int cUnitTypeHouse=397;
const int cUnitTypeTent=398;
const int cUnitTypeElephant=399;
const int cUnitTypeTunnel=400;
const int cUnitTypeTower=401;
const int cUnitTypeSettlement=402;
const int cUnitTypePegasus=403;
const int cUnitTypeScylla=404;
const int cUnitTypeAvenger=405;
const int cUnitTypeRaven=406;
const int cUnitTypeExcavation=407;
const int cUnitTypeGuardian=408;
const int cUnitTypeGuardianSleeping=409;
const int cUnitTypeSwordBearers=410;
const int cUnitTypeDeer=411;
const int cUnitTypeSettlementLevel1=412;
const int cUnitTypeOxCart=413;
const int cUnitTypeFenceStone=414;
const int cUnitTypeFenceWood=415;
const int cUnitTypeVillagerNorse=416;
const int cUnitTypeLonghouse=417;
const int cUnitTypeAcademy=418;
const int cUnitTypeVillagerGreek=419;
const int cUnitTypePortableRam=420;
const int cUnitTypeHillFort=421;
const int cUnitTypeVillagerEgyptian=422;
const int cUnitTypeThrowingAxeman=423;
const int cUnitTypeUlfsark=424;
const int cUnitTypeHuskarl=425;
const int cUnitTypeShrine=426;
const int cUnitTypeHeroNorse=427;
const int cUnitTypeHeroGreekAchilles=428;
const int cUnitTypePharaoh=429;
const int cUnitTypeLumberCamp=430;
const int cUnitTypeMiningCamp=431;
const int cUnitTypeHeroGreekOdysseus=432;
const int cUnitTypeHeroGreekChiron=433;
const int cUnitTypeHeroGreekPolyphemus=434;
const int cUnitTypeHoplite=435;
const int cUnitTypeHypaspist=436;
const int cUnitTypeHippikon=437;
const int cUnitTypeProdromos=438;
const int cUnitTypePeltast=439;
const int cUnitTypeToxotes=440;
const int cUnitTypePetrobolos=441;
const int cUnitTypeHelepolis=442;
const int cUnitTypePriest=443;
const int cUnitTypeMigdolStronghold=444;
const int cUnitTypeChariotArcher=445;
const int cUnitTypeMyrmidon=446;
const int cUnitTypeHetairoi=447;
const int cUnitTypeCataphract=448;
const int cUnitTypeMercenary=449;
const int cUnitTypeMonument2=450;
const int cUnitTypeMonument3=451;
const int cUnitTypeMonument4=452;
const int cUnitTypeMonument5=453;
const int cUnitTypeStatueofMajorGod=454;
const int cUnitTypeDwarvenForge=455;
const int cUnitTypeFolstagFlagBearer=456;
const int cUnitTypeTrojanHorse=457;
const int cUnitTypeBerryBush=458;
const int cUnitTypeBolderWall=459;
const int cUnitTypeMercenaryCavalry=460;
const int cUnitTypePirateShip=461;
const int cUnitTypeGateRam=462;
const int cUnitTypeJarl=463;
const int cUnitTypeWallLongDestructionSFX=464;
const int cUnitTypeWallShortDestructionSFX=465;
const int cUnitTypeWallConnectorDestructionSFX=466;
const int cUnitTypeOutpost=467;
const int cUnitTypeTransportShipGreek=468;
const int cUnitTypeKebenit=469;
const int cUnitTypeLongboat=470;
const int cUnitTypeLighthouse=471;
const int cUnitTypeHeroBoar=472;
const int cUnitTypeHeroGreekHeracles=473;
const int cUnitTypeHeroGreekJason=474;
const int cUnitTypeFishingShipNorse=475;
const int cUnitTypeFishingShipEgyptian=476;
const int cUnitTypeTransportShipEgyptian=477;
const int cUnitTypeTroyGate=478;
const int cUnitTypeTroyWallConnector=479;
const int cUnitTypeTroyWallLong=480;
const int cUnitTypeTroyWallShort=481;
const int cUnitTypeHeroGreekHippolyta=482;
const int cUnitTypeHeroGreekTheseus=483;
const int cUnitTypeHeroGreekBellerophon=484;
const int cUnitTypeHeroGreekAjax=485;
const int cUnitTypeHeroGreekAtalanta=486;
const int cUnitTypeHeroGreekPerseus=487;
const int cUnitTypeFlyingPurpleHippo=488;
const int cUnitTypeCaravanGreek=489;
const int cUnitTypeCaravanEgyptian=490;
const int cUnitTypeRelic=491;
const int cUnitTypeSkult=492;
const int cUnitTypeBolderRolling=493;
const int cUnitTypeGoldMineSmall=494;
const int cUnitTypePineSnow=495;
const int cUnitTypeCirce=496;
const int cUnitTypeStopCombat=497;
const int cUnitTypeNavalShipyard=498;
const int cUnitTypeRammingShipGreek=499;
const int cUnitTypeSiegeShipGreek=500;
const int cUnitTypeHeroGreekArgo=501;
const int cUnitTypeRammingShipNorse=502;
const int cUnitTypeRammingShipEgyptian=503;
const int cUnitTypeSiegeShipNorse=504;
const int cUnitTypeSiegeShipEgyptian=505;
const int cUnitTypeShade=506;
const int cUnitTypeAnimalAttractor=507;
const int cUnitTypeHealingSpringObject=508;
const int cUnitTypeSerpent=509;
const int cUnitTypeSentinelMain=510;
const int cUnitTypeCitadelCenter=511;
const int cUnitTypeWalkingWoodsPine=512;
const int cUnitTypeWalkingWoodsOak=513;
const int cUnitTypeWalkingWoodsPalm=514;
const int cUnitTypeHeroRagnorok=515;
const int cUnitTypeNidhogg=516;
const int cUnitTypeFimbulwinterWolf=517;
const int cUnitTypePlentyVault=518;
const int cUnitTypePharaohofOsiris=519;
const int cUnitTypeGoldMineDwarven=520;
const int cUnitTypeFenrisWolf=521;
const int cUnitTypeAthena=522;
const int cUnitTypeWalrus=523;
const int cUnitTypeWadjet=524;
const int cUnitTypePetsuchos=525;
const int cUnitTypeNemeanLion=526;
const int cUnitTypeAgamemnon=527;
const int cUnitTypeTheocrat=528;
const int cUnitTypeShadeofHades=529;
const int cUnitTypeAtlantisWallConnector=530;
const int cUnitTypeAtlantisWallLong=531;
const int cUnitTypeAtlantisGate=532;
const int cUnitTypeTamariskTree=533;
const int cUnitTypePhoenixEgg=534;
const int cUnitTypePolarBear=535;
const int cUnitTypeWalkingWoodsPineSnow=536;
const int cUnitTypeCaribou=537;
const int cUnitTypeElk=538;
const int cUnitTypePigSpecial=539;
const int cUnitTypeTitanBad=540;
const int cUnitTypePalmBurning=541;
const int cUnitTypeOakTreeBurning=542;
const int cUnitTypePineBurning=543;
const int cUnitTypeGreatBoxCart2=544;
const int cUnitTypeTransportShipNorse=545;
const int cUnitTypeThorHammerHaft=546;
const int cUnitTypeThorHammerHead=547;
const int cUnitTypePineSnowBurning=548;
const int cUnitTypeWarElephant=549;
const int cUnitTypeOakAutumn=550;
const int cUnitTypeBrokk=551;
const int cUnitTypeEitri=552;
const int cUnitTypeDwarfFoundry=553;
const int cUnitTypeHippocampus=554;
const int cUnitTypeOakAutumnBurning=555;
const int cUnitTypeSkraeling=556;
const int cUnitTypeUnderworldPassageSPC=557;
const int cUnitTypeCarcinos=558;
const int cUnitTypeJormundElver=559;
const int cUnitTypeMilitia=560;
const int cUnitTypeKastor=561;
const int cUnitTypeSeaSnake=562;
const int cUnitTypeOldMan=563;
const int cUnitTypeJailWall=564;
const int cUnitTypeDigPile=565;
const int cUnitTypeGoldenFleece=566;
const int cUnitTypeTempleUnderworld=567;
const int cUnitTypeArkantosman=568;
const int cUnitTypeBolderRollingDead=569;
const int cUnitTypeBolderRolling2=570;
const int cUnitTypePineDead=571;
const int cUnitTypeGateRam2=572;
const int cUnitTypeMiniAtlantis=573;
const int cUnitTypeAtlantisTile=574;
const int cUnitTypeAtlantisTileDead=575;
const int cUnitTypeWellofUrd=576;
const int cUnitTypeTroyGateDead=577;
const int cUnitTypePlentyVaultKOTH=578;
const int cUnitTypePoseidonStatue=579;
const int cUnitTypePharaohSecondary=580;
const int cUnitTypeSavannahTree=581;
const int cUnitTypeGoldenLion=582;
const int cUnitTypeMonkeyRelic=583;
const int cUnitTypeGhostShip=584;
const int cUnitTypeShadeofErebus=585;
const int cUnitTypeBanditMigdol=586;
const int cUnitTypeGoldMineTiny=587;
const int cUnitTypeWallMedium=588;
const int cUnitTypeStatueofLightning=589;
const int cUnitTypeCrossbowman=590;
const int cUnitTypeFenceIron=591;
const int cUnitTypeCharonFerry=592;
const int cUnitTypeHeroBoar2=593;
const int cUnitTypeTaproot=594;
const int cUnitTypeFemale=595;
const int cUnitTypeTheris=596;
const int cUnitTypeOrnlu=597;
const int cUnitTypePolaris=598;
const int cUnitTypeTamariskTreeDead=599;
const int cUnitTypePrisoner=600;
const int cUnitTypeFolstagFlag=601;
const int cUnitTypeUndermineBuildingDestructionSFX=602;
const int cUnitTypePineDeadBurning=603;
const int cUnitTypeApeofSet=604;
const int cUnitTypeGazelleofSet=605;
const int cUnitTypeHyenaofSet=606;
const int cUnitTypeCrocodileofSet=607;
const int cUnitTypeHippoofSet=608;
const int cUnitTypeRhinocerosofSet=609;
const int cUnitTypeGiraffeofSet=610;
const int cUnitTypeKrakenSPC=611;
const int cUnitTypeSavannahTreeBurning=612;
const int cUnitTypeWonderSPC=613;
const int cUnitTypeUnit=614;
const int cUnitTypeShip=615;
const int cUnitTypeBuilding=616;
const int cUnitTypeMilitaryBuilding=617;
const int cUnitTypeEconomicBuilding=618;
const int cUnitTypeDropsite=619;
const int cUnitTypeResource=620;
const int cUnitTypeHuntedResource=621;
const int cUnitTypeMinedResource=622;
const int cUnitTypeLandResource=623;
const int cUnitTypeWaterResource=624;
const int cUnitTypeProjectile=625;
const int cUnitTypeNature=626;
const int cUnitTypeSpecialPowers=627;
const int cUnitTypeUnattackable=628;
const int cUnitTypeAbstractTemple=629;
const int cUnitTypeMilitary=630;
const int cUnitTypeHero=631;
const int cUnitTypeTree=632;
const int cUnitTypeAbstractInfantry=633;
const int cUnitTypeAbstractCavalry=634;
const int cUnitTypeAbstractArcher=635;
const int cUnitTypeAbstractVillager=636;
const int cUnitTypeAbstractFarm=637;
const int cUnitTypeAbstractDock=638;
const int cUnitTypeInventoryHolder=639;
const int cUnitTypeInventoryItem=640;
const int cUnitTypeUseableItem=641;
const int cUnitTypeStrengthBonus=642;
const int cUnitTypeTradeableTo=643;
const int cUnitTypeTradeableFrom=644;
const int cUnitTypeAbstractSiegeWeapon=645;
const int cUnitTypeFlyingUnit=646;
const int cUnitTypeMythUnit=647;
const int cUnitTypeEconomic=648;
const int cUnitTypeRanged=649;
const int cUnitTypeFastSpeed=650;
const int cUnitTypeAverageSpeed=651;
const int cUnitTypeSlowSpeed=652;
const int cUnitTypeGeneric=653;
const int cUnitTypeUnitClass=654;
const int cUnitTypeBuildingClass=655;
const int cUnitTypeNatureClass=656;
const int cUnitTypeEmbellishmentClass=657;
const int cUnitTypeTestClass=658;
const int cUnitTypeE3Class=659;
const int cUnitTypeAll=660;
const int cUnitTypeActionGather=661;
const int cUnitTypeActionTrain=662;
const int cUnitTypeActionBuild=663;
const int cUnitTypeActionAttack=664;
const int cUnitTypeActionTrickle=665;
const int cUnitTypeFish=666;
const int cUnitTypeTransport=667;
const int cUnitTypeAbstractWall=668;
const int cUnitTypeHerdable=669;
const int cUnitTypeAbstractSettlement=670;
const int cUnitTypeBuildingsThatShoot=671;
const int cUnitTypeMythUnitGodPower=672;
const int cUnitTypeAge2Building=673;
const int cUnitTypeAge3Building=674;
const int cUnitTypeAge1Temple=675;
const int cUnitTypeFood=676;
const int cUnitTypeGold=677;
const int cUnitTypeWood=678;
const int cUnitTypeWildCrops=679;
const int cUnitTypeAge1Building=680;
const int cUnitTypeFoodDropsite=681;
const int cUnitTypeWoodDropsite=682;
const int cUnitTypeGoldDropsite=683;
const int cUnitTypeHumanSoldier=684;
const int cUnitTypeHuntable=685;
const int cUnitTypeAbstractMonument=686;
const int cUnitTypeSettlementsThatTrainVillagers=687;
const int cUnitTypeHack=688;
const int cUnitTypeCrush=689;
const int cUnitTypePierce=690;
const int cUnitTypeSharedBuilding=691;
const int cUnitTypeAbstractStable=692;
const int cUnitTypeAbstractFortress=693;
const int cUnitTypeAbstractBarracks=694;
const int cUnitTypeAbstractArcheryRange=695;
const int cUnitTypeEarlyWoodDropsite=696;
const int cUnitTypeEarlyFoodDropsite=697;
const int cUnitTypeEarlyGoldDropsite=698;
const int cUnitTypeConvertableBuilding=699;
const int cUnitTypeFavor=700;
const int cUnitTypeAnimalPrey=701;
const int cUnitTypeAnimalReactive=702;
const int cUnitTypeAnimalPredator=703;
const int cUnitTypeAbstractTradeUnit=704;
const int cUnitTypeAbstractPharaoh=705;
const int cUnitTypeMythUnitInfantry=706;
const int cUnitTypeMythUnitCavalry=707;
const int cUnitTypeMythUnitArcher=708;
const int cUnitTypeMythUnitSiege=709;
const int cUnitTypeUtilityShip=710;
const int cUnitTypeLogicalTypeHandUnitsAttack=711;
const int cUnitTypeLogicalTypePredatorsAutoAttack=712;
const int cUnitTypeLogicalTypeMeanPredatorsAutoAttack=713;
const int cUnitTypeLogicalTypeHandUnitsAutoAttack=714;
const int cUnitTypeLogicalTypePredatorsAttack=715;
const int cUnitTypeLogicalTypeScoutsRespondToAttack=716;
const int cUnitTypeLogicalTypeBuildingsNotHouses=717;
const int cUnitTypeLogicalTypeRangedUnitsAttack=718;
const int cUnitTypeLogicalTypeRangedUnitsAutoAttack=719;
const int cUnitTypeLogicalTypeUnitsNotBuildings=720;
const int cUnitTypeLogicalTypeDangerousAnimals=721;
const int cUnitTypeLogicalTypeIdleCivilian=722;
const int cUnitTypeLogicalTypeIdleMilitary=723;
const int cUnitTypeLogicalTypeTornadoAttack=724;
const int cUnitTypeLogicalTypeNeededForVictory=725;
const int cUnitTypeLogicalTypeIdleHero=726;
const int cUnitTypeLogicalTypeValidBoltTarget=727;
const int cUnitTypeLogicalTypeAffectedByHealingSpring=728;
const int cUnitTypeLogicalTypeAffectedByRestoration=729;
const int cUnitTypeLogicalTypeGarrisonOnBoats=730;
const int cUnitTypeLogicalTypeCavalryAndScout=731;
const int cUnitTypeLogicalTypeNonGreekUnit=732;
const int cUnitTypeLogicalTypeVillagersAttack=733;
const int cUnitTypeLogicalTypeEarthquakeAttack=734;
const int cUnitTypeAbstractArmory=735;
const int cUnitTypeLogicalTypeSiegeAutoAttack=736;
const int cUnitTypeLogicalTypeCanBeHealed=737;
const int cUnitTypeLogicalTypeMinimapFilterEconomic=738;
const int cUnitTypeLogicalTypeMinimapFilterMilitary=739;
const int cUnitTypeArcherShip=740;
const int cUnitTypeHammerShip=741;
const int cUnitTypeSiegeShip=742;
const int cUnitTypeAbstractCart=743;
const int cUnitTypeAbstractScout=744;
const int cUnitTypeLogicalTypeValidSpyTarget=745;
const int cUnitTypeAutoupgradedUnit=746;
const int cUnitTypeLogicalTypeNavalMilitary=747;
const int cUnitTypeLogicalTypeValidFrostTarget=748;
const int cUnitTypeLogicalTypeValidMeteorTarget=749;
const int cUnitTypeLogicalTypeSeaSerpentAttack=750;
const int cUnitTypeLogicalTypeFavoriteUnit=751;
const int cUnitTypeLogicalTypeFavoriteMythUnit=752;
const int cUnitTypeLogicalTypeConvertsHerds=753;
const int cUnitTypeLogicalTypeValidLocustSwarmTarget=754;
const int cUnitTypeLogicalTypeBuildingsNotWalls=755;
const int cUnitTypeLogicalTypeValidShiftingSandsTarget=756;
const int cUnitTypeLogicalTypeParticipatesInBattlecries=757;
const int cUnitTypeLogicalTypeBuildingsThatTrainMilitary=758;
const int cUnitTypeLogicalTypeRamAttack=759;
const int cUnitTypeLogicalTypeSiegeTowerUseRam=760;
const int cUnitTypeTransportShip=761;
const int cUnitTypeLogicalTypeVillagersRespondToAttack=762;
const int cUnitTypeLogicalTypeFimbulWinterTCEvalType=763;
const int cUnitTypeLogicalTypeValidForestFireTarget=764;
const int cUnitTypeLogicalTypeAutoattackTargetsBuildings=765;
const int cUnitTypeWalkingWood=766;
const int cUnitTypeLogicalTypeLandMilitary=767;
const int cUnitTypeLogicalTypeValidSPCUnitsDeadCondition=768;
const int cUnitTypeLogicalTypeAffectedByTownBell=769;
const int cUnitTypeLogicalTypeValidFlamingWeaponsTarget=770;
const int cUnitTypeLogicalTypeGreekHeroes=771;

//Syscalls: 536 total.

void xsDisableRule( string ruleName )
Disables the given rule.

void xsDisableSelf( void )

Disables the current rule.

void xsEnableRule( string ruleName )

Enables the given rule.
void xsSetRulePriority( string ruleName, int priority )
Sets the priority of the given rule.
void xsSetRulePrioritySelf( int priority )
Sets the priority of the current rule.

void xsSetRuleMinInterval( string ruleName, int interval )

Sets the min interval of the given rule.

void xsSetRuleMinIntervalSelf( int interval )

Sets the min interval of the current rule.

void xsSetRuleMaxInterval( string ruleName, int interval )

Sets the max interval of the given rule.

void xsSetRuleMaxIntervalSelf( int interval )

Sets the max interval of the current rule.

void xsEnableRuleGroup( string ruleGroupName )

Enables all rule in the given rule group.

void xsDisableRuleGroup( string ruleGroupName )

Disables all rules in the given rule group.

float xsVectorGetX( vector v )

Returns the x component of the given vector.

float xsVectorGetY( vector v )

Returns the y component of the given vector.

float xsVectorGetZ( vector v )

Returns the z component of the given vector.

float xsVectorSetX( vector v, float x )

Set the x component of the given vector, returns the new vector.

float xsVectorSetY( vector v, float y )

Set the y component of the given vector, returns the new vector.

float xsVectorSetZ( vector v, float z )

Set the z component of the given vector, returns the new vector.

float xsVectorSet( float x, float y, float z )

Set the 3 components into a vector, returns the new vector.

float xsVectorLength( vector v )

Returns the length of the given vector.

float xsVectorNormalize( vector v)

Returns the normalized version of the given vector.

int xsGetContextPlayer( void )

Returns the current context player ID.

void xsSetContextPlayer( int playerID )

Sets the current context player ID (DO NOT DO THIS IF YOU DO NOT KNOW
WHAT YOU ARE DOING).

int xsGetTime( void )

Returns the current gametime (in milliseconds).

bool xsAddRuntimeEvent( string foo, string bar, int something )

Setups a runtime event. Don't use this.

int xsGetFuntionID( string functionName )

Runs the secret XSFID for the function. USE WITH CAUTION.

void aiEcho( string echoString )

CP AI echo.

void aiErrorMessage( string errorString )

CP AI error.
void aiRandSetSeed( int seed )
Sets the seed of the random number generator.

int aiRandInt( int max )

Returns a random number (mod'ed by max if provided).

vector aiRandLocation( void )

Returns a random location guaranteed to be on the map.

void aiSet( string filename, int playerID )

Sets playerID's AI to the given filename.

aiBreakpointSet( int playerID, string filename, int lineNumber, bool on )

Sets a breakpoint.

aiBreakpointGo( int playerID )

Restart XS execution after the current breakpoint.

string aiGetPersonality( void )

Gets the player's personality.

bool aiSetPersonality( string name )

Sets the player's personality.

int aiGetMostHatedPlayerID( void )

Returns the script-defined most hated player ID for this player.

void aiSetMostHatedPlayerID( int v )

Sets the script-defined most hated player ID for this player.

int aiGetAvailableEconomyPop( void )

Returns the available economy pop for this player.

int aiGetEconomyPop( void )

Returns the script-defined economy pop for this player.

void aiSetEconomyPop( int v )

Set the script-defined economy pop for this player.

int aiGetAvailableMilitaryPop( void )

Returns the script-defined military pop for this player.

int aiGetMilitaryPop( void )

Returns the script-defined military pop for this player.

void aiSetMilitaryPop( int v )

Set the script-defined military pop for this player.

float aiGetEconomyPercentage( void )

Returns the economy priority percentage.

void aiSetEconomyPercentage( float v )

Set the economy priority percentage.

float aiGetMilitaryPercentage( void )

Returns the militarypriority percentage.

void aiSetMilitaryPercentage( float v )

Set the military priority percentage.

float aiGetAttackResponseDistance( void )

Returns the attack response distance.

void aiSetAttackResponseDistance( float v )

Set the attack response distance.

int aiGoalGetNumber( int goalType, int goalState, bool active )

Returns the number of matching goals.

int aiGoalGetIDByIndex( int goalType, int goalState, bool active, int index )
Returns the ID of matching goal.
int aiPlanGetNumber( int planType, int planState, bool active )
Returns the number of matching plans.

int aiPlanGetIDByIndex( int planType, int planState, bool active, int index )
Returns the ID of matching plan.

int aiPlanCreate( string planName, int typeName )

Creates a plan of the given name and type.

bool aiPlanDestroy( int planID )

Destroys the given plan.

bool aiPlanDestroyByName( string name )

Destroys the plan of the given name.

int aiPlanGetID( string name )

Returns the ID of the plan with the given name.

int aiPlanGetIDByTypeAndVariableType( int planType, int varType, int varID, bool active )
Returns the ID of the plan with the given parms.

int aiPlanGetIDByActiveIndex( int activeIndex )

Returns the ID of the plan with the given active index.

string aiPlanGetType( int planID )

Returns the name of the given plan.

int aiPlanGetType( int planID )

Returns the type of the given plan.

int aiPlanGetState( int planID )

Returns the state of the given plan.

int aiPlanGetActualPriority( int planID )

Returns the priority of the given plan.

int aiPlanGetDesiredPriority( int planID )

Returns the priority of the given plan.

bool aiPlanSetDesiredPriority( int planID, int priority )

Sets the priority of the given plan.

bool aiPlanAddUnitType(int planID, int unitTypeID, int numberNeed,

int numberWant, int numberMax )
Adds a unit type to the plan.

int aiPlanGetNumberUnits( int planID, int unitTypeID )

Returns the number of units currently assigned in the given plan.

bool aiPlanAddUnit( int planID, int unitID )

Adds a unit to the plan.

vector aiPlanGetLocation( int planID )

Returns the location for this plan.

vector aiPlanGetInitialPosition( int planID )

Returns the initial positon that was set for this plan.

void aiPlanSetInitialPosition( int planID, vector initialPosition )

Sets the initial positon for this plan.

bool aiPlanSetWaypoints( int planID, int pathID )

Sets the waypoints of the given plan to the waypoints of the given path.

bool aiPlanAddWaypoint( int planID, vector waypoint )

Adds the waypoint to the given plan.

int aiPlanGetNumberVariableValues( int planID, int planVariableIndex )

Returns the number of values for this variable index.
bool aiPlanSetNumberVariableValues( int planID, int planVariableIndex, int numberValues,
bool clearCurrentValues )
Sets the number of values for this variable.

bool aiPlanRemoveVariableValue( int planID, int planVariableIndex, int variableIndex )

Removes the index-th value of the variable.

bool aiPlanSetVariableInt( int planID, int planVariableIndex, int valueIndex, int value )
Sets the given variable of the given plan.

int aiPlanGetVariableInt( int planID, int planVariableIndex, int valueIndex )

Gets the given variable of the given plan.

bool aiPlanSetVariableFloat( int planID, int planVariableIndex, int valueIndex,

float value )
Sets the given variable of the given plan.

float aiPlanGetVariableFloat( int planID, int planVariableIndex, int valueIndex )

Gets the given variable of the given plan.

bool aiPlanSetVariableVector( int planID, int planVariableIndex, int valueIndex,

vector value )
Sets the given variable of the given plan.

vector aiPlanGetVariableVector( int planID, int planVariableIndex, int valueIndex )

Gets the given variable of the given plan.

bool aiPlanSetVariableBool( int planID, int planVariableIndex, int valueIndex,

bool value )
Sets the given variable of the given plan.

bool aiPlanGetVariableBool( int planID, int planVariableIndex, int valueIndex )

Gets the given variable of the given plan.

bool aiPlanSetVariableString( int planID, int planVariableIndex, int valueIndex,

string value )
Sets the given variable of the given plan.

string aiPlanGetVariableString( int planID, int planVariableIndex )

Gets the given variable of the given plan.

int aiPlanGetNumberUserVariableValues( int planID, int planVariableIndex )

Returns the number of values for this variable index.

bool aiPlanSetNumberUserVariableValues( int planID, int planVariableIndex,

int numberValues, bool clearCurrentValues )
Sets the number of values for this variable.

bool aiPlanRemoveUserVariables( int planID )

Removes all of the user variables from the given plan.

bool aiPlanRemoveUserVariable( int planID, int planVariableIndex )

Removes the user variable.

bool aiPlanRemoveUserVariableValue( int planID, int planVariableIndex,

int variableIndex )
Removes the index-th value of the user variable.

bool aiPlanAddUserVariableInt( int planID, int planVariableIndex, string name,

int numberValues )
Adds the variable to the given plan.

bool aiPlanSetUserVariableInt( int planID, int planVariableIndex, int valueIndex,

int value )
Sets the given variable of the given plan.

int aiPlanGetUserVariableInt( int planID, int planVariableIndex, int valueIndex )

Gets the given variable of the given plan.

bool aiPlanAddUserVariableFloat( int planID, int planVariableIndex, string name,

int numberValues )
 Adds the variable to the given plan.

bool aiPlanSetUserVariableFloat( int planID, int planVariableIndex, int valueIndex,

float value )
Sets the given variable of the given plan.

float aiPlanGetUserVariableFloat( int planID, int planVariableIndex, int valueIndex )

Gets the given variable of the given plan.

bool aiPlanAddUserVariableVector( int planID, int planVariableIndex, string name,

int numberValues )
Adds the variable to the given plan.

bool aiPlanSetUserVariableVector( int planID, int planVariableIndex, int valueIndex,

vector value )
Sets the given variable of the given plan.

vector aiPlanGetUserVariableVector( int planID, int planVariableIndex, int valueIndex )

Gets the given variable of the given plan.

bool aiPlanAddUserVariableBool( int planID, int planVariableIndex, string name,

int numberValues )
Adds the variable to the given plan.

bool aiPlanSetUserVariableBool( int planID, int planVariableIndex, int valueIndex,

bool value )
Sets the given variable of the given plan.

bool aiPlanGetUserVariableBool( int planID, int planVariableIndex, int valueIndex )

Gets the given variable of the given plan.

bool aiPlanAddUserVariableString( int planID, int planVariableIndex, string name,

int numberValues )
Adds the variable to the given plan.

bool aiPlanSetUserVariableString( int planID, int planVariableIndex, int valueIndex,

string value )
Sets the given variable of the given plan.

string aiPlanGetUserVariableString( int planID, int planVariableIndex, int valueIndex )

Gets the given variable of the given plan.

bool aiPlanGetActive( int planID )

Gets the active-ness of the given plan.

bool aiPlanSetActive( int planID, bool active )

Sets active on/off for the given plan.

bool aiPlanGetNoMoreUnits( int planID )

Gets the noMoreUnits-ness of the given plan.

bool aiPlanSetNoMoreUnits( int planID, bool v )

Sets noMoreUnits on/off for the given plan.

bool aiPlanGetOrphan( int planID )

Gets the orphan-ness of the given plan.

bool aiPlanSetOrphan( int planID, bool orphan )

Sets orphan on/off for the given plan.

bool aiPlanGetAllowUnderAttackResponse( int planID )

Gets the UA response-ness of the given plan.

bool aiPlanSetAllowUnderAttackResponse( int planID, bool uAR )

Sets under attack response on/off for the given plan.

int aiPlanGetUnitStance( int planID )

Gets the unit stance of the given plan.

bool aiPlanSetUnitStance( int planID, int stance )

Sets unit stance for the given plan.
bool aiPlanSetRequiresAllNeedUnits( int planID, bool rANU )
Sets 'requiresAllNeedUnits' on/off for the given plan.

bool aiPlanSetEventHandler( int planID, int eventType, string handlerName )

Sets event handler function for the given plan and event.

bool aiPlanSetEscrowID( int planID, int escrowID )

Sets the escrow for the plan.

int aiPlanGetEscrowID( int planID )

Gets the escrow for the plan.

bool aiPlanGetEconomy( int planID )

Gets the economy flag of the given plan.

bool aiPlanSetEconomy( int planID, bool v )

Sets economy on/off for the given plan.

bool aiPlanGetMilitary( int planID )

Gets the military flag of the given plan.

bool aiPlanSetMilitary( int planID, bool v )

Sets military on/off for the given plan.

bool aiPlanGetAttack( int planID )

Gets the attack flag of the given plan.

bool aiPlanSetAttack( int planID, bool v )

Sets attack flag on/off for the given plan.

bool aiPlanSetBaseID( int planID, int baseID )

sets the plan's base id.

int aiPlanGetBaseID( int planID)

gets the plan's base id.

int aiGetNumberIdlePlans( int planType )

Gets the of idle plans of the given type.

int aiCommsSendPromptWithVector(targetPlayerID, int promptType, int textVariant,

float timeout, int yesOrderType, int noOrderType,
int data1, vector position)
Sends a prompt to the designated player and sets up a response.

int aiCommsSendPrompt(targetPlayerID, int promptType, int textVariant, float timeout,

int yesOrderType, int noOrderType, int data1)
Sends a prompt to the designated player and sets up a response.

int aiCommsSendOrderWithVector(targetPlayerID, int promptType, int data1,

vector position)
Sends an order to the designated player.

int aiCommsSendOrder(targetPlayerID, int promptType, int data1)

Sends an order to the designated player.

int aiCommsSendStatement(targetPlayerID, int promptType, int textVariant)

Sends a statement to the designated player.

int aiCommsSendStatementWithVector(targetPlayerID, int promptType, int textVariant, vector

v)
Sends a statement to the designated player. Adds a location flare.

bool aiCommsSetEventHandler(string handlerFunctionName )

Sets the handler for the communications system (invalid name unsets the handler).

bool aiCommsSetSpecificEventHandler(long recordID, string handlerFunctionName )

Sets the handler for a specific chat record in the comms system (invalid
name unsets the handler).

bool aiSetGodPowerEventHandler(string handlerFunctionName )

 Sets the handler for god power casting events (invalid name unsets the handler).

bool aiSetBuildEventHandler( string handlerFunctionName )

Sets the handler for building completed events (invalid name unsets the handler).

bool aiSetWonderDeathEventHandler( string handlerFunctionName )

Sets the handler for wonder death events (invalid name unsets the handler).

bool aiSetRetreatEventHandler( string handlerFunctionName )

Sets the handler for retreat events (invalid name unsets the handler).

bool aiSetRelicEventHandler( string handlerFunctionName )

Sets the handler for relic events (invalid name unsets the handler).

bool aiSetResignEventHandler( string handlerFunctionName )

Sets the handler for resign events (invalid name unsets the handler).

long aiCommsGetRecordType(int id)

Get the type of a given record.

long aiCommsGetRecordPromptType(int id)

Get the prompt type of a given record.

long aiCommsGetRecordPlayerID(int id)

Get the player ID of a given record.

long aiCommsGetRecordResponse(int id)

Get the response type of a given record.

long aiCommsGetResponseData(int id)

Get the response data of a given record.

long aiCommsGetRecordData(int id)

Get the data of a given record.

vector aiCommsGetRecordPosition(int id)

Get the position of a given record.

bool aiSetAgeEventHandler( int age, string handlerFunctionName )

Sets the handler for the given age (invalid name unsets the handler).

bool aiSetUpdateResourceEventHandler( string handlerFunctionName )

Sets the handler for the update resource event (invalid name unsets the handler).

bool aiSetUpdateResourceLimit( int resourceID, float limit )

Sets the limit for the given resource for the update resource event.

bool aiTaskUnitMove( int unitID, vector position )

Does a lightweight (no plan) move tasking of the given unit to the given location.

bool aiTaskUnitWork( int unitID, int targetUnitID )

Does a lightweight (no plan) work tasking of the given unit on the given target
unit.

bool aiTaskUnitBuild( int unitID, int buildingTypeID, vector position )

Does a lightweight (no plan) build tasking of the given unit to build the given
building.

bool aiTaskUnitTrain( int unitID, int unitTypeID )

Does a lightweight (no plan) train tasking of the given unit for the given target
unit type.

bool aiTaskUnitResearch( int unitID, int techID )

Does a lightweight (no plan) research tasking of the given unit for the given tech
ID.

bool aiTaskUnitSpecialPower( int unitID, int powerID, vector position )

Does a lightweight (no plan) research tasking of the given unit for the given
special power.

bool aiTaskUnitDelete( int unitID )

 Deletes the given unit.

bool aiTribute( int playerID, int resourceID, float amount )

Tributes the given player.

bool aiUseMarket( int resourceID, float amount )

Buys (+amount) or sells (-amount) the given resource.

float aiGetMarketBuyCost( int resourceID )

Returns the amount required to buy 100 units of the given resource.

float aiGetMarketSellCost( int resourceID )

Returns the amount received for selling 100 units of the given resource.

float aiGetResourceGathererPercentageWeight( int rgpIndex )

Returns the RGP weight.

void aiSetResourceGathererPercentageWeight( int rgpIndex, float weight )

Sets the RGP weight.

void aiNormalizeResourceGathererPercentageWeights( void )

Normalizes all of the resource gatherer percentages weights to 1.0.

float aiGetResourceGathererPercentage( int resourceID, int rgpIndex )

Returns the resource gatherer percentage for the given resource.

void aiSetResourceGathererPercentage( int resourceID, float value, bool normalize,

int rgpIndex )
Sets the resource gatherer percentage for the given resource (if normalized is
true, the percentages will be normalized to 1.0).

void aiNormalizeResourceGathererPercentages( int rgpIndex )

Normalizes all of the resource gatherer percentages to 1.0.

int aiGetResourceBreakdownNumberPlans( int resourceTypeID, int resourceSubTypeID,

int baseID )
Gets the number of plans for the given breakdown.

int aiGetResourceBreakdownPlanPriority( int resourceTypeID, int resourceSubTypeID,

int baseID )
Gets the priority of the plans for the given breakdown.

float aiGetResourceBreakdownPercentage( int resourceTypeID, int resourceSubTypeID,

int baseID )
Gets the percentage for the given breakdown.

bool aiSetResourceBreakdown( int resourceTypeID, int resourceSubTypeID, int numberPlans,

int planPriority, float percentage, int baseID )
Sets a subtype breakdown for a resource.

bool aiRemoveResourceBreakdown( int resourceTypeID, int resourceSubTypeID, int baseID )

Removes the given breakdown.

int aiGetAutoGatherEscrowID( void )

Returns the auto gather escrow ID.

void aiSetAutoGatherEscrowID( int escrowID )

Sets the auto gather escrow ID.

int aiGetAutoFarmEscrowID( void )

Returns the auto Farm escrow ID.

void aiSetAutoFarmEscrowID( int escrowID )

Sets the auto Farm escrow ID.

int aiGetFarmLimit( void )

Returns the per plan farm build limit.

void aiSetFarmLimit( int limit )

Sets the per plan farm build limit.
int aiGetTrainedDropsiteUnitTypeID( void )
Returns the trained dropsite PUID.

void aiSetTrainedDropsiteUnitTypeID( int v )

Sets the trained dropsite PUID.

bool aiGetAutoFavorGather( void )

Returns auto favor gather on/off.

void aiSetAutoFavorGather( bool v )

Sets auto favor gather on/off.

bool aiGetAllowAutoDropsites( void )

Returns allow auto dropsites on/off.

void aiSetAllowAutoDropsites( bool v )

Sets allow auto dropsites on/off.

bool aiGetAllowBuildings( void )

Returns allow buildings on/off.

void aiSetAllowBuildings( bool v )

Sets allow buildings on/off.

int aiWallInArea( string name, int areaID, int numberNeed, int nubmerWant, int numberMax,
int escrowID, int numGates, int planPriority )
walls in the given area.

int aiWallInAreas( string name, int areaID1, int areaID2, int areaID3, int numberNeed,
int nubmerWant, int numberMax, int escrowID, int numGates,
int planPriority )
walls around all 3 areas at once.

int aiWallFromAToB( string name, vector a, vector b, int numberNeed, int nubmerWant,
int numberMax, int escrowID, int numGates, int planPriority )
walls from point a to point b.

int aiWallRingAroundPoint( string name, vector center, float radius, int numberNeed,
int nubmerWant, int numberMax, int escrowID, int numGates, int
planPriority )
walls a ring around the center, with a given radius.

void aiChat( int playerID, string chatString )

CP AI chat to playerID.

void aiSendChatToEveryone( string chatString )

CP AI chat to everyone.

void aiSendChatToAllies( string chatString )

CP AI chat to allies.

void aiSendChatToEnemies( string chatString )

CP AI chat to enemies.

int aiNumberUnassignedUnits( int typeID )

Returns the number of unassigned units of the given type.

int aiNumberUnassignedUnitsByGoal( int goalID )

Returns the number of unassigned units based on the goal's unit type(s).

void aiResourceCheat( int playerID, int resourceID, float amount )

Gives your wimpy CP AI free resources because it can't handle the truth, or
something like that.

int aiUnitCreateCheat( int playerID, int protoUnitID, vector position, string name,
int numberUnits )
Creates unit(s) with the given parms.

bool aiCastGodPowerAtPosition( int godPowerTechID, vector pos)

Casts the given God power tech, at the specified position.
bool aiCastGodPowerAtUnit( int godPowerTechID, int unitID)
Casts the given God power tech, at the specified unit.

int aiGetGodPowerTechIDForSlot( int slotID)

Get the god power tech id from the given slot.

int aiGetGodPowerProtoIDForTechID( int techID)

translate a granted tech id into a protopower id

int aiGetGodPowerType( int protoPowerID)

get the type for a ProtoPower

int aiFindBestAttackGodPowerPlan(void)
find a valid god power plan to attach to an attack plan

int aiGetWorldDifficulty( void )

Returns the world difficulty level.

void aiSetWorldDifficulty( int v )

Sets the world difficulty level.

string aiGetWorldDifficultyName( int level )

Returns the name of the level.

int aiGetGameMode( void )

Returns the game's mode.

int aiGetCaptainPlayerID( int playerID )

Returns the captain for the given player's team.

void aiAutoSavegame( string filename )

Saves the auto, debugging savegames.

bool aiGetAutosaveOn()
returns whether or not its cool to turn ai autosaves on.

void aiGetCurrentResourceNeed( int resourceID )

returns the current resource need for the given resource.

bool aiSetExploreDangerThreshold( float value)

sets the ai's Explore Danger Threshold value.

float aiGetExploreDangerThreshold()
gets the ai's Explore Danger Threshold value.

void aiSetPauseAllAgeUpgrades(bool v)
sets the pause all age upgrades flag in the AI.

bool aiGetPauseAllAgeUpgrades()
gets the pause all age upgrades flag from the AI.

void aiSetMinNumberNeedForGatheringAggressvies(long v)
sets the min number of needed units to gather aggressive animals.

int aiGetMinNumberNeedForGatheringAggressives()
gets the min number of needed units to gather aggressive animals.

void aiSetMinNumberWantForGatheringAggressives(long v)
sets the min number of wanted units to gather aggressive animals.

int aiGetMinNumberWantForGatheringAggressives()
gets the min number of wanted units to gather aggressive animals.

void aiResign()
reigns the current player..

void aiAttemptResign()
asks the player if its ok to resign

void aiSetMaxLOSProtoUnitLimit(int limit)

sets the limit for how many LOS Protounits the AI can build
int aiGetMaxLOSProtoUnitLimit()
gets the limit for how many LOS Protounits the AI can build

int aiGetPopNeeds()
gets the current Pop needs of all the plans.

void aiSwitchMainBase(int newBaseID, bool force)

switch the newBaseID to be the main base.

void kbEcho( string echoString )

Knowledge Base echo.

void kbDump( int player1, int player2 )

KB dump for player2's units from player1's perspective.

void kbDumpType( int player1, int player2, string typeName )

KB dump for player2's units of the given type from player1's perspective.

void kbLookAtAllUnitsOnMap( void )

Cheats and looks at all of the units on the map. This will format your harddrive
if you're not authorized to use it.

int kbGetPop( void )

Returns the current population for the player.

int kbGetPopCap( void )

Returns the current population cap for the player.

int kbGetAge( void )

Returns the current age for the current player.

int kbGetAgeForPlayer( int id )

Returns the current age for the player specified.

int kbGetCulture( void )

Returns the culture for the player.

string kbGetCulture( int cultureID )

Returns the culture name for the given culture.

int kbGetCiv( void )

Returns the civilization for the player.

string kbGetCivName( int civID )

Returns the civ name for the given civ.

int kbUnitQueryCreate( string name )

Creates a unit query, returns the query ID.

bool kbUnitQueryResetData( long queryID )

Resets the given unit query data AND results.

bool kbUnitQueryResetResults( long queryID )

Resets the given unit query results.

bool kbUnitQueryDestroy( long queryID )

Destroys the given unit query.

int kbUnitQueryNumberResults( long queryID )

Returns the number of results in the current query.

int kbUnitQueryGetResult( long queryID, int index )

Returns the UnitID of the index-th result in the current query.

bool kbUnitQuerySetPlayerID( long queryID, int playerID, bool resetQueryData )

Sets query data.

bool kbUnitQuerySetPlayerRelation( long queryID, int playerRelation )

Sets query data.
bool kbUnitQuerySetUnitType( long queryID, int unitTypeID )
Sets query data.

bool kbUnitQuerySetActionType( long queryID, int actionTypeID )

Sets query data.

bool kbUnitQuerySetState( long queryID, int state )

Sets query data.

bool kbUnitQuerySetPosition( long queryID, vector v )

Sets query data.

bool kbUnitQuerySetMaximumDistance( long queryID, float distance )

Sets query data.

bool kbUnitQuerySetAscendingSort( long queryID, bool v )

If parm is true, results are sorted in ascending distance order from the
query position.

bool kbUnitQuerySetBaseID( long queryID, int baseID )

Sets query data.

bool kbUnitQuerySetAreaID( long queryID, int areaID )

Sets query data.

bool kbUnitQuerySetAreaGroupID( long queryID, int areaGroupID )

Sets query data.

bool kbUnitQuerySetArmyID( long queryID, int armyID )

Sets query data.

bool kbUnitQuerySetSeeableOnly( long queryID, bool seeableOnly )

Sets query data.

int kbUnitQueryExecute( long queryID )

Executes the current query; returns number of results.

int kbUnitQueryExecuteOnQuery( long currentQueryID, int previousQueryID )

Executes the current query on the previous query's results; returns the new
number of results.

int kbUnitQueryExecuteOnQueryByName( long currentQueryID, string previousQueryName )

Executes the current query on the previous query's results; returns the new
number of results.

int kbUnitGetPlanID( int unitID )

Returns the plan ID for this unit ID.

int kbUnitGetBaseID( int unitID )

Returns the base ID for this unit ID.

int kbUnitGetAreaID( int unitID )

Returns the area ID for this unit ID.

int kbUnitGetArmyID( int unitID )

Returns the army ID for this unit ID.

int kbUnitGetMovementType( int unitTypeID )

Returns the movementType for this unitTypeID.

float kbUnitGetCurrentHitpoints( int unitID )

Returns the current hitpoints for this unit ID.

float kbUnitGetMaximumHitpoints( int unitID )

Returns the maximum hitpoints for this unit ID.

float kbUnitGetHealth( int unitID )

Returns the health for this unit ID.

float kbUnitGetCurrentAICost( int unitID )

Returns the current AI cost (worth) for this unit ID.
float kbUnitGetMaximumAICost( int unitID )
Returns the maximum AI cost (worth) for this unit ID.

vector kbUnitGetPosition( int unitID )

Returns the position for this unit ID.

bool kbUnitIsType( int unitID, long unitTypeID )

Returns true if the unit is of the unitTypeID.

int kbUnitGetActionType( int unitID )

Returns the actionTypeID of the unit.

int kbUnitGetTargetUnitID( int unitID )

Returns the target unit ID of the given unit.

int kbUnitGetNumberWorkers( int unitID )

Returns the number of units currently working on the given unit.

int kbUnitGetWorkerID( int unitID, int index )

Returns the index-th worker unit ID.

int kbGetBuildLimit(int player, int unitTypeID )

Returns the number of the unit type you are allowed to have (ONLY WORKS ON BASE
UNIT TYPES); returns -1 if there is no limit.

int kbGetPopCapAddition(int player, int unitTypeID )

Returns amount of pop cap addition provided by the given unit type (ONLY WORKS ON
BASE UNIT TYPES).

int kbGetPopSlots(int player, int unitTypeID )

Returns the number of pop slots this unit takes (ONLY WORKS ON BASE UNIT TYPES).

int kbGetPopulationSlotsByUnitTypeID( int playerID, int unitTypeID )

Returns the number of pop slots currently occupied by this unit type.

int kbGetPopulationSlotsByQueryID( int queryID )

Returns the number of pop slots currently occupied by the results in the
given query.

int kbUnitCount(int player, int unitTypeID, int stateID )

Returns a quick unit count of units for a player.

void kbUnitCountConsole(int playerID1, int playerID2, string unitType, string state(s) )

Returns a quick unit count of player2's units from player1's perspective.

vector kbGetMapCenter( void )

Returns the center vector of the map.

float kbGetMapXSize( void )

Returns the X size of the map.

float kbGetMapZSize( void )

Returns the Z size of the map.

void kbAreaCalculate()
Creates areas and area groups. DO THIS BEFORE ANYTHING ELSE IN YOUR SCRIPT.

int kbAreaGetNumber( void )

Returns the number of areas.

string kbAreaGetName( int areaID )

Returns the name of the given area.

bool kbAreaSetName( int areaID, string areaName )

Sets the name of the given area.

int kbAreaGetIDByPosition( vector position )

Returns the ID of the given area.

int kbAreaGroupGetIDByPosition( vector position )

 Returns the ID of the given area group.

vector kbAreaGetCenter( int areaID )

Returns the center of the given area.

int kbAreaGetNumberTiles( int areaID )

Returns the number of tiles in the given area.

int kbAreaGetNumberBlackTiles( int areaID )

Returns the number of black tiles in the given area.

int kbAreaGetNumberVisibleTiles( int areaID )

Returns the number of visible tiles in the given area.

int kbAreaGetNumberFogTiles( int areaID )

Returns the number of fog tiles in the given area.

int kbAreaGetVisibilityChangeTime( int areaID )

Returns the gametime of the last visibility change for the given area.

int kbAreaGetNumberUnits( int areaID )

Returns the number of units in the given area.

int kbAreaGetUnitID( int areaID, long index )

Returns the Unit ID of the index-th unit in the given area.

int kbAreaGetNumberBorderAreas( int areaID )

Returns the number of border areas for the given area.

int kbAreaGetBorderAreaID( int areaID, long index )

Returns the Area ID of the index-th border area in the given area.

int kbAreaGetType( int areaID )

Returns the Type of area.

int kbAreaFindBestGatherAreaID( int unitTypeID )

Returns the Area ID of the best area to gather the given unit type.

int kbAreaGetClosetArea( vector position, int areaType, int areaType1,

float minDistance )
Returns the Area ID of the closest area, of the given types, to given postion.

int kbPathCreate( string name )

Creates a path with the given name.

bool kbPathDestroy( int pathID )

Destroys the given path.

int kbPathGetNumber( void )

Returns the number of paths.

int kbPathGetIDByIndex( long index )

Returns the index-th path ID.

string kbPathGetName( int pathID )

Returns the name of the given path.

float kbPathGetLength( int pathID )

Returns the length of the given path.

int kbPathGetNumberWaypoints( int pathID )

Returns the number of waypoints in the given path.

bool kbPathAddWaypoint( int pathID, vector waypoint )

Adds the waypoint to the given path.

vector kbPathGetWaypoint( int pathID, long waypointNumber )

Returns the appropriate waypoint from the given path.

bool kbCanSimPath( vector pointA, vector pointB, long protoUnitTypeID, float range )
Returns true if the given unit type can path from pointA to pointB.
bool kbCanPath2( vector pointA, vector pointB, long protoUnitTypeID, float range )
Returns true if the given unit type can path from pointA to pointB.

int kbCreateAttackRoute( string name, int startAreaID, int goalAreaID,

int numInitialRoutes)
Returns the Route ID if successful.

int kbCreateAttackRouteWithPath( string name, vector startPt, vector endPt)

Returns the Route ID if successful.

bool kbDestroyAttackRoute( int routeID )

Returns true if the route was deleted.

bool kbAddAttackRouteSector( int sector )

add a new sector to path to.

bool kbAddAttackRouteIgnoreID( int ignoreAreaID )

ignore this area when finding the route.

bool kbAddAttackRouteIgnoreType( int ignoreAreaTypeID )

ignore this areatype when finding the route.

bool kbAttackRouteAddPath( int attackRouteID, int pathID)

Rreturns true if path was added to attack route.

bool kbMakeAttackRoutes()
find all the paths to the sector specified.

int kbGetNumAttackRoutes( long startAreaID, long goalAreaID)

Returns num paths from start to goal area.

int kbGetAttackRouteID( long startAreaID, long goalAreaID)

Returns the id of the routes from area1 to area2.

int kbEscrowCreate( string name, int resourceID, float percentage, int parentID )
Creates an escrow.

bool kbEscrowDestroy( int escrowID, bool promoteChildren )

Destroys an escrow.

int kbEscrowGetID( string name )

Returns the ID of the named escrow.

float kbEscrowGetPercentage( int escrowID, int resourceID )

Returns the percentage of the escrow.

bool kbEscrowSetPercentage( int escrowID, int resourceID, float percentage )

Sets the percentage of the escrow.

bool kbEscrowSetCap( int escrowID, int resourceID, float cap )

Sets the cap of the escrow.

float kbEscrowGetAmount( int escrowID, int resourceID )

Returns the amount of credits in the given escrow for the given resource.

bool kbEscrowFlush( int escrowID, int resourceID, bool flushChildren )

Removes all credits (and puts them into the root escrow) of the given resource
type from the given escrow.

bool kbEscrowAllocateCurrentResources( void )

Reallocates the current resource stockpile into the escrows.

int kbBuildingPlacementCreate( string name )

Creates a building placement; returns the ID.

bool kbBuildingPlacementDestroy( int id )

Destroys the given building placement.

bool kbBuildingPlacementResetResults( void )

Resets the current building placement.
bool kbBuildingPlacementSelect( int id )
Selects the given building placement.

bool kbBuildingPlacementSetEventHandler( int eventType, string handlerName )

Sets event handler function for the current BP and event.

bool kbBuildingPlacementSetBuildingType( int buildingTypeID )

Sets the building type for the current building placement.

bool kbBuildingPlacementSetBaseID( int baseID, int locationPref )

Sets the base ID and location preference for the current building placement.

bool kbBuildingPlacementAddAreaID( int areaID, int numberBorderAreaLayers,

bool addCenterInfluence )
Adds the Area ID to the current BP (with the given number of border area layers),
addCenterInfluence - adds a positional influence from the area center.

bool kbBuildingPlacementAddAreaGroupID( int areaGroupID )

Adds the AreaGroup ID to the current BP.

bool kbBuildingPlacementSetCenterPosition( vector position, float distance, float

obstructionRadius )
Sets up center position-based BP.

bool kbBuildingPlacementAddUnitInfluence( int typeID, float value, float distance,

long kbResourceID )
Adds the unit influence for the current building placement.

bool kbBuildingPlacementAddPositionInfluence( vector position, float value,

float distance )
Adds the position influence for the current building placement.

bool kbBuildingPlacementSetMinimumValue( float minimumValue )

Sets the minimum acceptable value for evaluated spots in the BP.

bool kbBuildingPlacementStart( void )

Starts the placement of current building.

vector kbBuildingPlacementGetResultPosition( int bpID )

Returns the vector result position for given BP ID.

float kbBuildingPlacementGetResultValue( int bpID )

Returns the result value for given BP ID.

int kbTargetSelectorCreate( string name )

Creates a target selector; returns the ID.

bool kbTargetSelectorDestroy( int id )

Destroys the given target selector.

bool kbTargetSelectorResetResults( void )

Resets the current target selector.

bool kbTargetSelectorSelect( int id )

Selects the given target selector.

bool kbTargetSelectorAddUnitType( int protoUnitTypeID )

Add the UAIT for the given BASE unit type as a filter.

bool kbTargetSelectorAddQueryResults( int queryID )

Sets the list of potential targets to the results in the given query.

int kbTargetSelectorGetNumberResults( void )

Returns the number of results in the given target selector.

int kbTargetSelectorGetResultValue( int index )

Returns the result value for given index of the current target selector.

bool kbTargetSelectorStart( void )

Starts the current target selector.
bool kbSetupForResource( int baseID, int resourceID, float distance, float amount )
Returns true if amount of resource is within distance of a dropsite.

float kbResourceGet( int resourceID )

Returns the current amount of the given resource.

float kbMaximumResourceGet( int resourceID )

Returns the maximum amount of the given resource you can have.

float kbTotalResourceGet( int resourceID )

Returns the total amount of the given resource gathered to this point in the game.

int kbGetNumberValidResourcesByPlan( int planID, int baseID )

Returns the number of valid KB resources for the given plan/base.

int kbGetNumberValidResources( int baseID, int resourceTypeID, int resourceSubTypeID,

float distance )
Returns the number of valid KB resources for the resource types.

float kbGetAmountValidResources( int baseID, int resourceTypeID, int resourceSubTypeID,

float distance )
Returns the resource amount of valid KB resources for the resource types.

float kbGetResourceIncome( int resourceID, float seconds, bool relative )

Returns the resource income over the last X seconds.

bool kbProtoUnitAvailable( int protoUnitID )

Returns true if the protoUnit is currently available.

int kbGetProtoUnitID( string name )

Returns the ID of the protounit.

bool kbCanAffordUnit( int protoUnitTypeID, int escrowID )

Returns true if the player can afford the proto unit.

bool kbCanAffordTech( int techID, int escrowID )

Returns true if the player can afford the tech.

int kbGetTechStatus( int techID )

Returns the current tech status for the current player of the requested tech.

float kbGetTechPercentComplete( int techID )

Returns the percent complete for the the requested tech of the current player.

float kbGetCombatEfficiency( int playerID1, int unitTypeID1, int playerID2,

int unitTypeID2 )
Returns the combat efficiency of the comparison (in terms of playerID1's units).

float kbGetAICostWeight( int resourceID )

Returns the AI cost weight for the given resource.

bool kbSetAICostWeight( int resourceID, float weight )

Sets the weight this resource type is given during AI cost calculuations.

float kbGetProtoUnitAICost( int protoUnitTypeID )

Returns the AI cost for the given protoUnit type ID.

float kbGetTechAICost( int techID )

Returns the AI cost for the given tech ID.

bool kbIsPlayerResigned( <playerID> )

Returns the player's resigned status.

bool kbHasPlayerLost( <playerID> )

Returns the player's lost status.

int kbGetPlayerTeam( <playerID> )

Returns the player's team number.

bool kbIsPlayerEnemy( int playerID )

 Returns true if the given player is an enemy.

bool kbIsPlayerNeutral( int playerID )

Returns true if the given player is a neutral player.

bool kbIsPlayerAlly( int playerID )

Returns true if the given player is an ally.

bool kbIsPlayerValid( int playerID )

Returns true if the given player is a valid player (i.e. it exists in the game).

bool kbIsPlayerHuman( int playerID )

Returns true if the given player is a a human player.

bool kbIsGameOver()
Returns whether the game is over or not.

vector kbGetTownLocation( void )

Returns the location of the main town.

int kbGetTownAreaID( void )

Returns the area ID of the main town.

bool kbSetTownLocation( vector location )

Sets the location of the main town.

bool kbGetAutoBaseCreate( void )

Returns the auto base creation value.

void kbSetAutoBaseCreate( bool v )

Sets the auto base creation value.

float kbGetAutoBaseCreate( void )

Returns the auto base creation distance.

void kbSetAutoBaseCreateDistance( float v )

Sets the auto base creation distance.

bool kbGetAutoBaseDetect( void )

Returns the auto base detection value.

void kbSetAutoBaseDetect( bool v )

Sets the auto base detection value.

float kbGetAutoBaseDetect( void )

Returns the auto base creation distance.

void kbSetAutoBaseDetectDistance( float v )

Sets the auto base creation distance.

int kbBaseGetNextID( void )

Returns the ID of the next base that will be created.

int kbBaseGetNumber( int playerID )

Returns the number of bases for the given player.

int kbBaseGetIDByIndex( int playerID, int index )

Returns the BaseID for the given base.

int kbBaseCreate( int playerID, string name, vector position, float distance )
Creates a base.

int kbBaseFindCreateResourceBase( int resourceType, int resourceSubType,

int parentBaseID )
Finds/Creates a resource base.

int kbBaseFindCreateResourceBase( int enemyPlayerID, int enemyBaseID )

Finds/Creates a 'forward' military base against the given enemy base.

bool kbBaseDestroy( int playerID, int baseID )

Destroys the given base.
void kbBaseDestroyAll( int playerID )
Destroys all of the bases for the given player.

vector kbBaseGetLocation( int playerID, int baseID )

Gets the location of the base.

bool kbBaseSetFrontVector( int playerID, int baseID, vector frontVector )

Sets the front (and back) of the base.

vector kbBaseGetFrontVector( int playerID, int baseID )

Gets the front vector of the base.

vector kbBaseGetBackVector( int playerID, int baseID )

Gets the back vector of the base.

int kbBaseGetTimeUnderAttack( int playerID, int baseID )

Returns the number of continuous seconds the base has been under attack.

bool kbBaseGetUnderAttack( int playerID, int baseID )

Gets the under attack flag of the base.

bool kbBaseSetActive( int playerID, int baseID, bool active )

Sets the active flag of the base.

bool kbBaseGetActive( int playerID, int baseID )

Gets the active flag of the base.

int kbBaseGetMainID( int playerID )

Gets the main base ID for the player.

bool kbBaseSetMain( int playerID, int baseID, bool main )

Sets the main flag of the base.

bool kbBaseGetMain( int playerID, int baseID )

Gets the main flag of the base.

bool kbBaseSetForward( int playerID, int baseID, bool forward )

Sets the forward flag of the base.

bool kbBaseGetForward( int playerID, int baseID )

Gets the forward flag of the base.

bool kbBaseSetSettlement( int playerID, int baseID, bool settlement )

Sets the settlement flag of the base.

bool kbBaseGetSettlement( int playerID, int baseID )

Gets the settlement flag of the base.

bool kbBaseSetMilitary( int playerID, int baseID, bool military )

Sets the military flag of the base.

bool kbBaseGetMilitary( int playerID, int baseID )

Gets the military flag of the base.

vector kbBaseGetMilitaryGatherPoint( int playerID, int baseID )

Gets the military gather point of the base.

bool kbBaseSetMilitaryGatherPoint( int playerID, int baseID, vector gatherPoint )

Sets the military gather point of the base.

bool kbBaseSetEconomy( int playerID, int baseID, bool Economy )

Sets the economy flag of the base.

bool kbBaseGetEconomy( int playerID, int baseID )

Gets the economy flag of the base.

float kbBaseGetMaximumResourceDistance( int playerID, int baseID )

Gets the maximum resource distance of the base.

void kbBaseSetMaximumResourceDistance( int playerID, int baseID, float distance )

 Sets the maximum resource distance of the base.

bool kbBaseAddUnit( int playerID, int baseID, int unitID )

Adds the given unit to the base.

bool kbBaseRemoveUnit( int playerID, int baseID, int unitID )

Removes the given unit to the base.

int kbBaseGetNumberUnits( int playerID, int baseID, int relation, int unitTypeID )
Returns the number of units that match the criteria.

bool kbUnitVisible( int unitID )

Returns true if the unit is currently visible to the player.

bool kbLocationVisible( vector location )

Returns true if the location is currently visible to the player.

vector kbGetBlockPosition( string blockName )

Returns the position of the cinematic block.

int kbGetBlockID( string blockName )

Returns the UnitID of the cinematic block.

int kbUnitPickCreate( string name )

Creates a unit pick.

bool kbUnitPickDestroy( int upID )

Destroys the given unit pick.

bool kbUnitPickResetAll( int upID )

Resets all of the unit pick data.

bool kbUnitPickResetResults( int upID )

Resets the unit pick results.

bool kbUnitPickSetPreferenceWeight( int upID )

Sets the unit pick preference weight.

bool kbUnitPickSetEnemyPlayerID( int upID )

Sets the unit pick enemy player ID.

bool kbUnitPickSetCombatEfficiencyWeight( int upID )

Sets the unit pick combat efficiency weight.

bool kbUnitPickResetCombatEfficiencyTypes( int upID )

Resets the enemy unit typeIDs for the unit pick combat efficiency calculation.

bool kbUnitPickAddCombatEfficiencyType( int upID, int typeID, float weight )

Adds an enemy unit typeID to the unit pick combat efficiency calculation.

bool kbUnitPickSetCostWeight( int upID )

Sets the unit pick cost weight.

bool kbUnitPickSetMovementType( int upID, int movementType )

Sets the unit pick movement type.

bool kbUnitPickSetDesiredNumberUnitTypes( int upID, int number, int numberBuildings,

bool degradeNumberBuildings )
Sets the unit pick desired number unit types.

int kbUnitPickGetDesiredNumberUnitTypes( int upID )

Gets the unit pick desired number unit types.

bool kbUnitPickSetDesiredNumberBuildings( int upID, int index, int numberBuildings )

Sets the unit pick desired number buildings for the index-th unit type.

int kbUnitPickGetDesiredNumberBuildings( int upID, int index )

gets the unit pick desired number buildings for the index-th unit type.

bool kbUnitPickSetMinimumNumberUnits( int upID, int number )

Sets the unit pick desired number unit types.
int kbUnitPickGetMinimumNumberUnits( int upID )
Gets the unit pick minimum number units.

bool kbUnitPickSetMaximumNumberUnits( int upID, int number )

Sets the unit pick desired number unit types.

int kbUnitPickGetMaximumNumberUnits( int upID )

Gets the unit pick maximum number units.

bool kbUnitPickSetMinimumPop( int upID, int number )

Sets the unit pick desired min pop.

int kbUnitPickGetMinimumPop( int upID )

Gets the unit pick minimum pop.

bool kbUnitPickSetMaximumPop( int upID, int number )

Sets the unit pick desired max pop.

int kbUnitPickGetMaximumPop( int upID )

Gets the unit pick maximum pop.

bool kbUnitPickSetAttackUnitType( int upID, int type )

Sets the unit pick attack unit type.

int kbUnitPickGetAttackUnitType( int upID )

Gets the unit pick attack unit type.

bool kbUnitPickSetPreferenceFactor( int upID, int unitTypeID, float preferenceFactor )

Sets the preferenceFactor for that unit type.

bool kbUnitPickAdjustPreferenceFactor( int upID, int unitTypeID,

float baseFactorAdjustment )
Adjusts the preferenceFactor for that unit type (uses 50.0 as the base if the UP
doesn't exist yet).

int kbUnitPickRun( int upID )

Runs the unit pick.

int kbUnitPickGetNumberResults( int upID )

Returns the number of unit pick results.

int kbUnitPickGetResult( int upID, int index )

Returns the index-th ProtoUnitID.

int kbFindAreaGroup( int groupType, float surfaceAreaRatio, int compareAreaID)

returns the area group that matches the given criteria.

int kbFindBestBuildingToRepair(vector position, float distance, float healthRatio,

int repairUnderAttackUnitTypeID)
returns the id of the best building to repair.

void kbSetForwardBasePosition(vector position)

set the explicit position that every forward base will use.

int kbArmyCreate( string name, bool exclusiveUnits )

Creates a army with the given name.

bool kbArmyDestroy( integer id )

Destroys the given army.

int kbArmyGetNumber( void )

Returns the number of armies.

int kbArmyGetID( string name )

Returns the ID of the given army.

int kbArmyGetIDByIndex( long index )

Returns the index-th army ID.

string kbArmyGetName( integer id )

 Returns the name of the given army.

int kbArmyGetNumberUnits( integer armyID )

Returns the number of units in the given army.

int kbArmyGetUnitID( integer armyID, long unitNumber )

Returns the appropriate unitID from the given army.

bool kbArmyAddUnit( integer armyID, integer unitID )

Adds the unitID to the given army.

bool kbArmyRemoveUnit( integer armyID, integer unitID )

Removes the unitID from the given army.

bool kbArmyRemoveUnitByIndex( integer armyID, integer unitIndex )

Removes the unitIndex-th unit from the given army.

bool kbArmyRemoveUnits( integer armyID )

Removes all units from the given army.

int kbArmyGetPlanID( integer armyID )

Returns the planID for the given army.

int kbArmyGetCreationTime( integer armyID )

Returns the creation time for the given army.

int kbArmyGetMembershipTime( integer armyID )

Returns the creation time for the given army.

vector kbArmyGetLocation( integer armyID )

Returns the vector location for the given army.

int kbArmyGetNumberWithinLocation( integer armyID, vector point, float range )

Returns the number of units within range of the given point in the given army.

float kbArmyGetCurrentHitpoints( integer armyID )

Returns the current total hitpoints for the given army.

float kbArmyGetMaximumHitpoints( integer armyID )

Returns the maximum total hitpoints for the given army.

float kbArmyGetHealth( integer armyID )

Returns the health for the given army.

int kbArmyGetNumberWithHealth( integer armyID, float minimumHealth )

Returns the number of units with at least the minimum amount of health specified
for the given army.

float kbArmyGetCurrentAICost( integer armyID )

Returns the current AI cost (worth) for the given army.

float kbArmyGetMaximumAICost( integer armyID )

Returns the maximum AI cost (worth) for the given army.

float kbArmyGetAPSDamageTaken( integer armyID, float timeSpan )

Returns the APS damage taken by the given army.

float kbArmyGetAPSDamageGiven( integer armyID, float timeSpan )

Returns the APS damage given by the given army.

float kbArmyGetAPSResourcesGathered( integer armyID, float timeSpan, integer resourceID )

Returns the APS resources gathered by the given army.

void kbForceContextPlayerID()
use for debugging or manual scenario repair ONLY!!!

int kbTechTreeGetNumberMatrixUnitTypeIDs( void )

Returns the number of matrix unit type IDs.

int kbTechTreeGetMatrixUnitTypeIDByIndex( int index )

Returns the matrix unit typeID at the given index.
int kbTechTreeGetTotalUnitIDsByMatrix(int mainUnitTypeID, int counterUnitTypeID)
Returns the total number of unitIDs matching the main type that
has the given counter type.

int kbTechTreeGetUnitIDByMatrixIndex(int mainUnitTypeID, int counterUnitTypeID,

int index)
Returns the index'th unitID matching the main type that has
the given counter type.

int kbTechTreeGetTotalUnitIDsByFunction( int functionID )

Returns the total number of unitIDs that performs the given function.

int kbTechTreeGetUnitIDTypeByFunctionIndex( int functionID, int index )

Returns the index'th unitID of the unit that performs the given function.

int kbTechTreeGetNumberDropsiteUnitIDsByResource( int resourceID )

Returns the number of unit typeIDs for dropsites that take the given resource.

bool kbTechTreeClearDropsiteUnitIDsByResource( int resourceID )

Clears the list of dropsites for the given resource type.

bool kbTechTreeAddDropsiteUnitIDByResource( int resourceID )

Adds the base unit type ID as a dropsite for the given resource.

int kbTechTreeGetDropsiteUnitIDByResource( int resourceID, int index )

Returns the index-th unitID of the dropsite that takes the given resource.

int kbTechTreeGetUnitIDByTrain( int unitTypeID, int civID )

Returns the unitTypeID of the unit that can train the given unitTypeID.

int kbTechTreeGetNumberTrainProtos( int unitTypeID )

Returns the number of protos that can train the given unitTypeID.

int kbTechTreeGetUnitIDByTrainIndex( int unitTypeID, int trainProtoIndex )

Returns index'th unitTypeID of the unit that can train the given unitTypeID.

int kbTechTreeGetNumberObtainProtos( int techID )

Returns the number of protos that the given techID can be obtained from.

int kbTechTreeGetUnitIDByObtainIndex( int techID, int obtainProtoIndex )

Returns index'th unitTypeID of the unit that the given techID,
can be obtained from.

string kbGetTechName( int techID )

Returns the name of the tech ID.

string kbGetProtoUnitName( int protoUnitTypeID )

Returns the name of the protounit ID.

int kbGetUnitBaseTypeID( int unitID )

Returns the base type ID of the unit.

string kbGetUnitTypeName( int unitTypeID )

Returns the name of the unit type.

int kbTechTreeGetUnitUpgradeTechTotal( int unitTypeID )

Returns the total number of upgrade techs of the unit type.

int kbTechTreeGetUnitUpgradeTech( int unitTypeID, int index )

Returns the index'th upgrade techs of the unit type.

int kbTechTreeGetCheapestUnitUpgrade( int protoUnitID, int upgradeQueryType,

int resourceFilterID, int buildingFilterID,
bool echoResults, int affectedUnitType )
Returns the Tech ID of the Cheapest Unit Upgrade, given the input parameters.

int kbTechTreeGetRandomUnitUpgrade()

bool kbTechTreeIsMinorGod( int techID )

Returns true if techID is a minor god tech.
int kbTechTreeGetGPTechID( int minorGodTechID )
Returns the GP techID that is enabled by minorGodTechID.

bool kbTechTreeAddMinorGodPref( int techID )

Have progressions preference this minor god selection.

bool kbTechTreeRemoveMinorGodPref( int techID )

Removes this minor god as perference in Progressions.

int kbTechTreeGetMinorGodMythUnitTotal( int minorGodTechID)

Returns the total number of myths units enabled by this minor god.

int kbTechTreeGetMinorGodMythUnitByIndex( int minorGodTechID, int index )

Returns the protoID of a myth unit

int kbTechTreeGetMinorGodChoices( int index, int age )

Returns the minorGodTechID of the given index, given the age, -1 means
the next age.

int kbProgressionGetTotalNodes( int progressionID )

Returns the total number of steps to complete the progression.

float kbProgessionGetTotalResourceCost( int progressionID, int resourceID )

Returns the total cost of the given resource for this progressionID.

float kbProgessionGetTotalWorkCost( int progressionID )

Returns the total work cost this progressionID.

int kbProgressionGetNodeType( int progressionID, int nodeIndex )

Returns the type of node at the given index, either Unit type or Tech type.

int kbProgressionGetNodeData( int progressionID, int nodeIndex )

Returns the data at nodeIndex, either UnitID or TechID, depending on the type.

bool kbProgressionIsNodeMinorGod( int progressionID, int nodeIndex )

Returns true if this nodeIndex is a Minor God Tech.