upgrade.cpp File Reference

#include <string>
#include <vector>
#include <map>
#include "stratagus.h"
#include "upgrade.h"
#include "action/action_train.h"
#include "commands.h"
#include "depend.h"
#include "interface.h"
#include "iolib.h"
#include "map.h"
#include "player.h"
#include "script.h"
#include "unit.h"
#include "unit_find.h"
#include "unittype.h"
#include "util.h"

upgrade.cpp - The upgrade/allow functions.
std::vector< CUpgrade * >	AllUpgrades
CUpgradeModifier *	UpgradeModifiers [UPGRADE_MODIFIERS_MAX]
	The main user useable upgrades. More...
int	NumUpgradeModifiers
	Number of upgrades modifiers used. More...
std::map< std::string, CUpgrade * >	Upgrades
static void	AllowUnitId (CPlayer &player, int id, int units)
void	InitUpgrades ()
	init upgrade/allow structures More...
void	CleanUpgrades ()
	cleanup upgrade module More...
void	SaveUpgrades (CFile &file)
	save the upgrades More...
static int	CclDefineModifier (lua_State *l)
static int	CclDefineUnitAllow (lua_State *l)
static int	CclDefineAllow (lua_State *l)
void	UpgradesCclRegister ()
	Register CCL features for upgrades. More...
int	UnitTypeIdByIdent (const std::string &ident)
int	UpgradeIdByIdent (const std::string &ident)
static void	ConvertUnitTypeTo (CPlayer &player, const CUnitType &src, CUnitType &dst)
static void	ApplyUpgradeModifier (CPlayer &player, const CUpgradeModifier *um)
static void	RemoveUpgradeModifier (CPlayer &player, const CUpgradeModifier *um)
void	ApplyIndividualUpgradeModifier (CUnit &unit, const CUpgradeModifier *um)
static void	RemoveIndividualUpgradeModifier (CUnit &unit, const CUpgradeModifier *um)
void	UpgradeAcquire (CPlayer &player, const CUpgrade *upgrade)
	Upgrade will be acquired. More...
void	UpgradeLost (CPlayer &player, int id)
	Upgrade will be lost. More...
void	ApplyUpgrades ()
	Apply researched upgrades when map is loading. More...
void	IndividualUpgradeAcquire (CUnit &unit, const CUpgrade *upgrade)
	Apply upgrade modifier of an individual upgrade. More...
void	IndividualUpgradeLost (CUnit &unit, const CUpgrade *upgrade)
	Make a unit acquire in individual upgrade. More...
void	AllowUpgradeId (CPlayer &player, int id, char af)
int	UnitIdAllowed (const CPlayer &player, int id)
	Make a unit lose in individual upgrade. More...
char	UpgradeIdAllowed (const CPlayer &player, int id)
char	UpgradeIdentAllowed (const CPlayer &player, const std::string &ident)

Function Documentation

AllowUnitId()

static void AllowUnitId ( CPlayer &  player, int  id, int  units  )

static

Change allow for an unit-type.

Parameters

player	Player to change
id	unit type id
units	maximum amount of units allowed

AllowUpgradeId()

void AllowUpgradeId	(	CPlayer &	player,
		int	id,
		char	af
	)

Change allow for an upgrade.

Parameters

player	Player to change
id	upgrade id
af	A'llow/F'orbid/`R'eseached

ApplyIndividualUpgradeModifier()

void ApplyIndividualUpgradeModifier	(	CUnit &	unit,
		const CUpgradeModifier *	um
	)

Apply the modifiers of an individual upgrade.

Parameters

unit	Unit that will get the modifier applied
um	Upgrade modifier that does the effects

ApplyUpgradeModifier()

static void ApplyUpgradeModifier ( CPlayer &  player, const CUpgradeModifier *  um  )

static

Apply the modifiers of an upgrade.

This function will mark upgrade done and do all required modifications to unit types and will modify allow/forbid maps

Parameters

player	Player that get all the upgrades.
um	Upgrade modifier that do the effects

ApplyUpgrades()

void ApplyUpgrades

(

)

Apply researched upgrades when map is loading.

Apply researched upgrades when map is loading

Returns

: void

CclDefineAllow()

static int CclDefineAllow ( lua_State *  l )

static

Description

Define which units/upgrades are allowed.

Example:

DefineAllow("unit-town-hall","AAAAAAAAAAAAAAAA") – Available for everybody DefineAllow("unit-stables","FFFFFFFFFFFFFFFF") – Not available DefineAllow("upgrade-sword1","RRRRRRRRRRRRRRRR") – Upgrade already researched.

How many units supported

CclDefineModifier()

static int CclDefineModifier ( lua_State *  l )

static

Define a new upgrade modifier.

Parameters

l	List of modifiers.

CclDefineUnitAllow()

static int CclDefineUnitAllow ( lua_State *  l )

static

Define which units are allowed and how much.

CleanUpgrades()

void CleanUpgrades

(

)

cleanup upgrade module

Cleanup the upgrade module.

ConvertUnitTypeTo()

static void ConvertUnitTypeTo ( CPlayer &  player, const CUnitType &  src, CUnitType &  dst  )

static

Convert unit-type to.

Parameters

player	For this player.
src	From this unit-type.
dst	To this unit-type.

IndividualUpgradeAcquire()

void IndividualUpgradeAcquire	(	CUnit &	unit,
		const CUpgrade *	upgrade
	)

Apply upgrade modifier of an individual upgrade.

IndividualUpgradeLost()

void IndividualUpgradeLost	(	CUnit &	unit,
		const CUpgrade *	upgrade
	)

Make a unit acquire in individual upgrade.

InitUpgrades()

void InitUpgrades

(

)

init upgrade/allow structures

Init upgrade/allow structures

RemoveIndividualUpgradeModifier()

static void RemoveIndividualUpgradeModifier ( CUnit &  unit, const CUpgradeModifier *  um  )

static

RemoveUpgradeModifier()

static void RemoveUpgradeModifier ( CPlayer &  player, const CUpgradeModifier *  um  )

static

Remove the modifiers of an upgrade.

This function will unmark upgrade as done and undo all required modifications to unit types and will modify allow/forbid maps back

Parameters

player	Player that get all the upgrades.
um	Upgrade modifier that do the effects

SaveUpgrades()

void SaveUpgrades

(

CFile &

file

)

save the upgrades

Save state of the dependencies to file.

Parameters

file	Output file.

UnitIdAllowed()

int UnitIdAllowed	(	const CPlayer &	player,
		int	id
	)

Make a unit lose in individual upgrade.

Return the allow state of the unit.

Parameters

player	Check state of this player.
id	Unit identifier.

Returns

the allow state of the unit.

UnitTypeIdByIdent()

int UnitTypeIdByIdent

(

const std::string &

ident

)

UnitType ID by identifier.

Parameters

ident

The unit-type identifier.

Returns

Unit-type ID (int) or -1 if not found.

UpgradeAcquire()

void UpgradeAcquire	(	CPlayer &	player,
		const CUpgrade *	upgrade
	)

Upgrade will be acquired.

Handle that an upgrade was acquired.

Parameters

player	Player researching the upgrade.
upgrade	Upgrade ready researched.

UpgradeIdAllowed()

char UpgradeIdAllowed	(	const CPlayer &	player,
		int	id
	)

Return the allow state of an upgrade.

Parameters

player	Check state for this player.
id	Upgrade identifier.

Returns

the allow state of the upgrade.

UpgradeIdByIdent()

int UpgradeIdByIdent

(

const std::string &

ident

)

Upgrade ID by identifier.

Parameters

ident

The upgrade identifier.

Returns

Upgrade ID (int) or -1 if not found.

UpgradeIdentAllowed()

char UpgradeIdentAllowed	(	const CPlayer &	player,
		const std::string &	ident
	)

Return the allow state of an upgrade.

Parameters

player	Check state for this player.
ident	Upgrade identifier.

Note

This function shouldn't be used during runtime, it is only for setup.

UpgradeLost()

void UpgradeLost	(	CPlayer &	player,
		int	id
	)

Upgrade will be lost.

Upgrade will be lost

Parameters

player	Player researching the upgrade.
id	Upgrade to be lost.

UpgradesCclRegister()

void UpgradesCclRegister

(

)

Register CCL features for upgrades.

Register CCL features for upgrades.

Variable Documentation

AllUpgrades

std::vector<CUpgrade *> AllUpgrades

NumUpgradeModifiers

int NumUpgradeModifiers

Number of upgrades modifiers used.

UpgradeModifiers

CUpgradeModifier* UpgradeModifiers[UPGRADE_MODIFIERS_MAX]

The main user useable upgrades.

Upgrades modifiers

Upgrades

std::map<std::string, CUpgrade *> Upgrades