UI Symbols Documentation

Contexts


Battle

CcoBattleAbility

Component context wrapper for a battle ability (EMPIREBATTLE::ABILITY_DETAILS) which has live information for an ability like cooldown time, etc. exposes all information available to UiEd

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IntensityCanDecayBoolVoidReturns true if ability's intensity can decay
IsRechargeEnabledBoolVoidReturns true if all recharge contexts for this ability are true (eg engaged in melee)
IsPhaseActiveBoolCcoSpecialAbilityPhaseRecordReturns true if supplied CcoSpecialAbilityPhaseRecord is active in any of abilities phase trees
IsReignOfChaosRewardBoolVoidReturns true if this is an amry ability that can be rewarded as a reign of chaos outcome
ActivePhaseListCcoPair (list)VoidReturns list of CcoPair; the active phases for each target essentially
TimeUntilIntensityDecayIntVoidReturns amount of time (in seconds) until intensity decay starts
IsTargettedAbilityBoolVoidReturns true if this is an ability that you have to select a target for
MaxIntensityFloatVoidReturns the maximum intensity that modifiable stats of this ability will be multiplied by
IsActiveBoolVoidReturns true if this abiltiy is currently active and applying its effects
HasLimitedUsesBoolVoidReturns true if the ability has a limited number of uses (queried by RemainingUses)
DefaultIntensityFloatVoidReturns the starting/default intensity that modifiable stats of this ability will be multiplied by
EffectRangeFloatVoidReturns the range in metres that this ability will affect from the cast point
IntensityFloatVoidReturns the intensity that modifiable stats of this ability will be multiplied by
IsCurrentlyTargettingBoolVoidReturns true if this ability is currently being targetted by the player
CurrentStateStringVoidReturns a String representing the current state (active/passive/selected/inactive
CanBePurchasedBoolVoidReturns true if this ability can currently be afforded based on any required currencies (see CurrencyCosts)
RemainingUsesIntVoidReturns the number of remaining uses, -1 if unlimited
CurrencyCostsCcoPair (list)VoidReturns a list of CcoPair representing the costs required to activate this ability
WindUpPercentFloatVoidReturns the wind up percentage (0-1), 0 being not in windup and 1 being at the point where casts the spell. Wind up is the casting time essentially.
RechargeDisabledReasonsTextUniStringVoidReturns joined localised string of disabled reasons for this ability, if any (in melee, etc)
WindUpTimeRemainingSecsFloatVoidReturns the wind up time remaining in seconds. Wind up is the casting time essentially.
LeftClickTextUniStringVoidReturns some localised text that explains what left clicking on a button for this ability would currently do (activate, toggle targetting, toggle overcharge, etc)
RechargePercentFloatVoidReturns the cooldown percentage if in cooldown (0-1), 0 if not in cooldown
ManaUsedIntVoidReturns how much mana is used when activating this ability
RechargeTimeRemainingSecsFloatVoidReturns the cooldown time remaining seconds if ability is in cooldown
MiscastChanceFloatVoidReturns 0-1 value representing how likely to miscast when activate. A miscast will have negative impacts on the caster and the ability will fail to activate.
CanCurrentlyPerformBoolVoidReturns true if abiltiy can currently be activated
ActivePercentFloatVoidReturns the percent (0-1) the ability is through its active duration (progression until ability finishes), 0 if ability is not currently active
FillPercentFloatVoidThis is used for circular fills on 3k, where when ability active we unfill the ring (anti-clockwise), then when in cooldown we fill the ring (clockwise), and show the ring full while ability available (so transitions between cooldown being over and ring staying there)
IntensityDecayTimerStartedBoolVoidReturns true if the timer for the intensity decay has started
ActiveTimeRemainingSecsFloatVoid
IntensityDecayIsActiveBoolVoidReturns true if intensity decay is active for the ability
SetupAbilityContextCcoUnitAbilityVoidReturns the CcoUnitAbility setup for this ability (fixed information that doesnt change during the battle)
PerformAbilityForOwnerVoidVoidActivates the ability for the owner (unit/army)

CcoBattleAlliance

Component context wrapper for a battle alliance, exposes all information available to UiEd

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsPlayersAllianceBoolVoidReturns true if this is the player controlled alliance
IsDefenderBoolVoidReturns true if this faction is the defender in the battle
WillWinOnTimeoutBoolVoidReturns true if this alliance will win if timer runs out (usually the defender)
NumEntitiesInitialIntVoidReturns the number of entitie this alliance started the battle with
NumEntitiesIntVoidReturns the number of entities in this alliance
NumUnitsIntVoidReturns the number of units in this alliance
NumArmiesIntVoidReturns the number of armies in this alliance
CpKillScoreIntVoidReturns the score for this alliance, the higher the better the alliance performed (earned by unit experience and capturing capture points)
StartingTicketsIntVoidReturns the capture point tickets started the battle with
TicketsIncomePerSecondIntVoidReturns the total capture point tickets income rate, per second.
TicketsRemainingIntVoidReturns the capture point tickets remaining (when 0 lose if defending)
IdIntVoidReturns the index of this alliance
ArmyListCcoBattleArmy (list)VoidReturns the list of armies in this alliance
DevWinBattleVoidVoidFor dev purposes, forces win for this alliance by killing all units on other alliances in battlehide_in_uied, debug
DoesKeepScoreBoolVoidReturns true if we are keeping scores (CpKillScore)

CcoBattleArmy

Component context wrapper for a battle army, exposes all information available to UiEd

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ArmyAbilityIndexIntString, BoolReturns the index (ordered by cost) of the army ability specified by given key
FactionFlagDirStringVoidReturns directory for faction flag icons - append image name including extension for use in setting images
IsAliveBoolVoidReturns true if currently alive (has some controllable units still)
AbilityGodNameStringStringReturns the key for the daemon god that the ability associates with
ScoreIntVoidReturns the cp score for this army
FactionFlagLargeStringVoidReturns the faction flag large image filepath - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied
UniqueIDIntVoidReturns the unique id for this army (unique across all armies)
IsAbilityWithCostBoolString, Bool (optional)Returns if the specified ability key requires currency to activate. Optional bool argument for whether to use ryse ability
IsLocalPlayerBoolVoidReturns true if controlled by local player
GodWeightingFloatStringReturns the Reign of Chaos weighting towards a particular god when rolling for abilities
NumMenDiedIntVoidReturns the number of men who have died
IsHumanBoolVoidReturns true if controlled by a human
HasReignOfChaosBoolVoidReturns true if the faction has the reign of chaos feature (Daemon prince only)
ArmyIndexIntVoidReturns the index of this army in this alliance
FactionFlagMediumStringVoidReturns the faction flag medium image filepath - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied
NumUnitsIntVoidReturns the number of units currently alive
CurrentWaaaghPercentFloatVoidReturns the current Waaagh percent
FactionFlagSmallStringVoidReturns the faction flag small image filepath - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied
AllianceIndexIntVoidReturns the index of the alliance
CurrentWaaaghThresholdIntVoidReturns the current Waaagh threshold. Need to hit this to trigger a Waaagh
ArmyAbilityIndexCostFloatInt, Bool (optional)Returns the cost of the ability at the given by index. Optional bool argument for whether to use ryse ability
FactionContextCcoFactionRecordVoidReturns the faction context for this army
MaxUnitsCanControlIntVoidReturns the maximum number of units allowed at once on the battlefield at any one time
CurrentWaaaghPointsIntVoidReturns the current Waaagh points
WindsOfMagicPoolContextCcoBattleWindsOfMagicPoolVoidReturns the CcoBattleWindsOfMagicPool for this army, controls how much magic has for spell casting
NumEntitiesInitialIntVoidReturns the number of entities started the battle with
CurrentPercentToArmyAbilityFloatInt, Bool (optional)Returns the percentage of points you currently have towards ability given by index. Optional bool argument for whether to use ryse ability
RealmOfSoulsThresholdIntIntReturns the value require to achieve realms of souls effect
AllianceContextCcoBattleAllianceVoidReturns the CcoBattleAlliance for this army
CanPerformCataclysmAbilityBoolVoidReturns whether the current cataclysm ability (if it exists) can be used or performed
NumEntitiesIntVoidReturns the number of entities currently alive
RealmOfSoulsPercentFloatVoidReturns the percent complete to activate realm of souls effect
CommandingUnitContextCcoBattleUnitVoidReturns the CcoBattleUnit of the commanding/general unit
NumTotalUnitsIntVoidReturns the total units alive and reinforcements available
IsArmyAbilityUnlockedBoolInt, Bool (optional)Returns true of the ability specified by given index is unlocked. Optional bool argument for whether to use ryse ability
AiStatsModifierFloatVoidReturns a float with the ai stats modifier
ArmyAbilitiesListCcoUnitAbility (list)BoolReturns the list of abilities available to this army
NumReinforcementsIntVoidReturns the number of units in the reinforcements pool
HasDaemonFeatureBoolVoidReturns true if the daemon feature is available
MurderousProwessPercentFloatVoidReturns the percent of score vs thresh for murderous prowess
ArmyWideEffectsCcoBattleAbility (list)VoidReturns a vector of CcoBattleAbilities that have an army-wide effect
FormationListCcoFormationRecord (list)VoidReturns the list of formation records available to this army
MurderousProwessThreshIntVoidReturns the amount of murderous prowess score need to achieve to activate effect
HasWaaaghBoolVoidReturns true if Waaagh feature is available
UnitListCcoBattleUnit (list)VoidReturns the list of units in this army
PrimaryColourColourVoidReturns the primary faction colour of this army
MurderousProwessScoreIntVoidReturns the murderous prowess score
MurderousProwessShouldDeactivateBoolExpressionStateReturns true when murderous prowess ability should deactivate
AllianceColourColourVoidReturns the alliance colour for this army (as in colour based on player/ally/enemy/neutral)
ArmyAbilityCurrencyIntBool (optional)Returns the army ability currency for this army. Optional bool argument for whether to use ryse ability currency
HasMurderousProwessBoolVoidReturns true if Murderous Prowess feature available
PlayerNameUniStringVoidReturns the name of the player controlling tis army
GlobalCurrencyIntVoidReturns the supplies currency for this army
CurrentArmyAbilityThresholdIntBool (optional)Returns the threshold to the next unlockable ability (or the maximum if all are unlocked). Optional bool argument for whether to use ryse ability
HasRealmOfSoulsBoolVoidReturns true if Realm of Souls feature available
FactionNameUniStringVoidReturns the localised name of this army's faction
GlobalScoreIntVoidReturns the tickets remaining for this armies alliance
ArmyNameUniStringVoidReturns the localised name of this army

CcoBattleBuilding

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MaxHitpointsFloatVoid
CaptureLocationContextCcoBattleCapturePointVoid
DamagePercentFloatVoid
BreakForDebuggingVoidVoiddebug, hide_in_uied
GateCurrentHitpointsFloatVoid
SelectVoidVoidSelects this building in the card manager
ZoomToVoidVoidZooms the battle camera to this building
GateMaxHitpointsFloatVoid
HoldingAllianceContextCcoBattleAllianceVoid
GateDamagePercentFloatVoid
IsFlammableBoolVoid
IsToggleableBoolVoid
HoldingArmyContextCcoBattleArmyVoid
CentralPositionVector4Void
MissileWeaponContextCcoMissileWeaponRecordVoid
IsDestructableBoolVoid
PositionVector4Void
HasMissileWeaponBoolVoid
IsDestroyedBoolVoid
IsSelectedBoolVoid
HideTimeFloatVoid
CategoryTypeStringVoidReturns the category type name for this type of building.
IsSelectableBoolVoid
ShowTimeFloatVoid
CategoryIconPathStringVoid
IsGateBoolVoid
RadarIconStringVoid
CanUpdateAbilitiesBoolVoidAre the linked key building abilities enabled?
IsBridgeBoolVoid
SpecialAbilitiesListWithArmyCcoBattleAbility (list)CcoBattleArmyReturns the list of CcoBattleAbility's that this building owns in context of the specified army
GlobalEffectTextUniStringVoidReturns the description string of the global effects that the building applies
IsIncidentalBoolVoid
SpecialAbilitiesListCcoBattleAbility (list)VoidReturns the list of CcoBattleAbility's that this building owns in context of the owning army
LocalEffectTextUniStringVoidReturns the description string of the local effects that the building applies
NameUniStringVoid
HasOwnerBoolVoidDoes the building have a valid owning army associated with it?
IsOnFireBoolVoid
PercentOnFireFloatVoid
IsEnabledBoolVoid
CurrentHitpointsFloatVoid
IsUnbreachableWallBoolVoid

CcoBattleCaptureLocationsManager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SummaryListForTicketsSourcesCcoSummedValueContextIntReturns list of owned capture points, showing how many tickets they are scoring per second. Returns CcoSummedValueContext populated with CcoPair compposed of curency source record cco and amount value
TimeUntilAllCapturePointsAvailableFloatVoidReturns how long it will be until all capture points are available, in seconds
TicketsGoalIntVoidReturns the number of capture tickets that must be earned to fulfil the tickets victory condition

CcoBattleCapturePoint

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ColourForHolderColourVoid
ToggleableSlotBarricadesListContextListVoid
IsLinkedBuildingDestroyedBoolVoid
FillPercentFloatVoid
SetHighlightVoidBoolEnables or disables a pulsing highlight effect on the capture location
ToggleableSlotTowersListContextListVoid
ZoomToVoidVoid
CapturePercentFloatVoid
UnitsForAllianceContextListInt
HasCaptureBuildingBoolVoidDoes this capture location have an associated building
HasMoraleEffectsBoolVoid
ContestingProportionForAllianceFloatInt
CaptureBuildingCcoBattleBuildingVoid
KeyStringVoid
NameUniStringVoidReturns the string name for this capture point type
CapturePointScoreNormalisedFloatInt
OwnerIconPathStringVoidReturns the holder/owner faction flag medium image size - filepath.
ContestingArmycontextCcoBattleArmyVoid
CapturePointScoreFloatVoid
DevCaptureForArmyVoidCcoBattleArmyFor dev purposes, captures the capture point immediately for supplied armydebug, hide_in_uied
DisplayNameUniStringVoidReturns the displayable name for this capture point i.e. the header for the capture point tooltip
HoldingArmyContextCcoBattleArmyVoid
IsChildNearingReLockBoolVoidReturns whether the child of this capture point is about to be relocked because this point is being captured
SetStickyTooltipActiveVoidBoolSets the `sticky_tooltip_active` value to true or false based on the passed argument.
IconPathStringVoid
BuildingListContextListVoid
IsNearingReLockBoolVoidReturns whether this capture point is about to be relocked because its parent is being captured
ContestingUnitListContextListVoid
SetMouseOverVoidBoolSets the `mouse_over` value to true or false based on the passed argument.
RadiusFloatVoid
IsPointBasedBoolVoid
HoldingUnitListContextListVoid
IsStickyTooltipActiveBoolVoidReturns true if the capture point currently has a sticky tooltip open for it.
ContributesToVictoryBoolVoid
IsTimeBasedBoolVoid
IsLockedForAllianceBoolIntReturns true if the capture point is locked for the passed in alliance
FlagPositionVector4VoidReturns the flag position in world space in VECTOR_4
CurrentHolderAllianceIntVoidThe alliance id of the alliance that currently holds this capture point
IsMouseOverBoolVoidReturns true if the capture point is currently being moused over.
IsLockedBoolVoid
ScriptIdStringVoid
PositionVector4VoidReturns a position in world space in VECTOR_4
OriginalOwnerAllianceIntVoidThe original alliance id for this capture point
CanCurrentOwnerBuildBoolVoidReturns if the current owner of the capture point is allowed to build
LinkedChildCapturePointsListCcoBattleCapturePoint (list)VoidReturns the linked children capture point that would get unlocked after capturing this point, if any
IsEnabledBoolVoid
LinkedParentCapturePointContextCcoBattleCapturePointVoidReturns the linked parent capture point that needs to be captured first before unlocking this one, if it exists
ContestingFactorForAllianceFloatInt
IsContestedBoolVoid
IsNeutralBoolVoid
TypeRecordContextCcoCapturePointTypeRecordVoid
ColourFillColourVoid
ColourBaseColourVoid
ToggleableSlotsListContextListVoid
DescriptionUniStringVoid

CcoBattleCurrencyManager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PurchaseItemVoidString, Int, ContextTakes db key of the item, int32 for the currency item type enum and CcoBattleArmy and purchases the item
CanAffordItemBoolString, Int, ContextTakes db key of the item, int32 for the currency item type enum and CcoBattleArmy and returns boolean indicating whther the item can be afforded
GetCostForItemFloatString, Int, ContextTakes db key of the item, int32 for the currency item type enum and CcoBattleArmy and returns the cost for that item
GetArmyCurrencyForTypeFloatCcoBattleArmy, StringTakes db key of the currency and returns the amount of that currency for the players army
SummaryListForCurrencySourcesCcoSummedValueContextString, IntTakes db key and army unique id and returns CcoSummedValueContext populated with CcoPair compposed of curency source record cco and amount value
PurchaseArmyAbilityVoidString, Int, ContextTakes db key of ability, int32 for the currency item type enum and CcoBattleArmy and purchases the ability
CurrencyItemTypeStringToEnumIntStringTakes db key of the currency item type and returns int32 of the currency type enum
CurrencyTypeStringToEnumIntStringTakes db key of the currency type and returns int32 of the currency type enum

CcoBattleCursorContext

Component context wrapper for BATTLE_UI_CURSOR_OVER_CONTEXT, so can get context information about current 3d mouseover

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsMoveCursorBoolVoidReturns true if showing move cursor
IsContextSelectableBoolVoidReturns true if current mouseover can be selected
HasIntersectionsBoolVoidReturns if currently intersecting 3d world
CurrentCursorKeyStringVoidReturns the current cursor_record key of the cursor being used
ToggleableSlotContextCcoBattleToggleableSlotVoidReturns the toggleable slot currently mousing over
GroundTypeRecordContextCcoGroundTypeRecordVoidReturns the ground type record currently mousing over
VehicleContextCcoBattleVehicleVoidReturns the vehicle currently mousing over
BuildingContextCcoBattleBuildingVoidReturns the building currently mousing over
EntityContextCcoBattleEntityVoidReturns the entity currently mousing over
UnitContextCcoBattleUnitVoidReturns the unit currently mousing over
ContextPositionVector4VoidReturns the position of whatever context we are over (unit/building/etc)
GroundIntersectPositionVector4VoidReturns first intersection position with ground
FirstIntersectPositionVector4VoidReturns first intersection position
IsAttackCursorBoolVoidReturns true if showing attack cursor

CcoBattleEntity

Component context wrapper for a battle entity, exposes all information available to UiEd

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DevSetCollisionRadiiVoidFloatDev command to set radii ratio of collision on entitydebug, hide_in_uied
DevSetCollisionRadiusVoidFloatDev command to set radius of collision on entitydebug, hide_in_uied
ZoomToVoidVoidZooms camera to look at this entity
IsEngineBoolVoidReturns true if this is an engine entity
IsManBoolVoidReturns true if this is a man entity
IsReloadingBoolVoidReturns true if currently reloading
IsAliveBoolVoidReturns true if entity still alive
ReloadPercentFloatVoidReturns the percentage of how close to being reloaded
ReloadRemainingTimeFloatVoidReturns the remaining reload time in seconds
DevSetArticulationHeadOffsetVoidFloatDev command to set articulation radius of given node, if this is an articulated unitdebug, hide_in_uied
PositionVector4VoidReturns the current position
DevSetArticulationMaxAngleVoidFloatDev command to set articulation radius of given node, if this is an articulated unitdebug, hide_in_uied
KeyStringVoidReturns the BATTLE_ENTITY_RECORD key
DevSetArticulationRadiusVoidInt, FloatDev command to set articulation radius of given node, if this is an articulated unitdebug, hide_in_uied
EntityRecordContextCcoBattleEntityRecordVoidReturns the CcoBattleEntityRecord context
DevSetArticulationOffsetVoidInt, FloatDev command to set articulation offset of given node, if this is an articulated unitdebug, hide_in_uied
UnitContextCcoBattleUnitVoidReturns the CcoBattleUnit context
DevSetCollisionShapeVoidStringDev command to set collision shape. Valid shapes are circle, ellipse, capsule and lensdebug, hide_in_uied
DevSetCollisionZOffsetVoidFloatDev command to set collision z offset on entitydebug, hide_in_uied
DevSetCollisionHeightVoidFloatDev command to set collision height on entitydebug, hide_in_uied

CcoBattleGroup

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsCreatedVoidVoid
NumEntitiesVoidVoid
NumUnitsVoidVoid
UnitListVoidVoid
CanLockVoidVoid
FormationContextVoidVoid
ChangeFormationVoidVoid
IsTakingDamageVoidVoid
CurrentStateVoidVoid
GroupIdVoidVoid
SelectGroupVoidVoid
ToggleLockVoidVoid
DestroyGroupVoidVoid
CreateGroupVoidVoid
IsLockedVoidVoid
IsSelectedVoidVoid

CcoBattleLaboratoryInfo

Wrapper for the lab settings of a battle.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ValueForLabSettingFloatCcoLabSettingRecordReturns the value for the passed in lab setting
SetAbilityCooldownMultiplierVoidFloatSets the ability cooldown multiplier value to the one passed in
BloodMultiplierFloatVoidReturns the blood multiplier value
SetAbilityEffectRadiusMultiplierVoidFloatSets the ability effect radius multiplier value to the one passed in
SingleEntityScaleMultiplierFloatVoidReturns the single entity scale multiplier value
SetGravityMultiplierVoidFloatSets the gravity multiplier value to the one passed in
ChargeBonusMultiplierFloatVoidReturns the charge bonus multiplier value
SetProjectilePenetrationMultiplierVoidFloatSets the projectile penetration multiplier value to the one passed in
AbilityCooldownMultiplierFloatVoidReturns the ability cooldown multiplier value
AbilityEffectRadiusMultiplierFloatVoidReturns the ability effect radius multiplier value
SetAmmunitionMultiplierVoidFloatSets the ammunition multiplier value to the one passed in
GravityMultiplierFloatVoidReturns the gravity multiplier value
SetReloadTimeMultiplierVoidFloatSets the reload time multiplier value to the one passed in
ProjectilePenetrationMultiplierFloatVoidReturns the projectile penetration multiplier value
SetFatigueMultiplierVoidFloatSets the fatigue multiplier value to the one passed in
AmmunitionMultiplierFloatVoidReturns the ammunition multiplier value
SetExplosionRadiusMultiplierVoidFloatSets the explosion radius multiplier value to the one passed in
ReloadTimeMultiplierFloatVoidReturns the reload time multiplier value
SetWindsOfMagicMultiplierVoidFloatSets the winds of magic multiplier value to the one passed in
FatigueMultiplierFloatVoidReturns the fatigue multiplier value
ToggleWindsOfMagicLimitlessVoidVoidToggles the winds of magic limitless setting
SetMoraleMultiplierVoidFloatSets the morale multiplier value to the one passed in
ExplosionRadiusMultiplierFloatVoidReturns the explosion radius multiplier value
SetUnitSizeVoidFloatSets the unit size multiplier value to the one passed in
SetImpactForceMultiplierVoidFloatSets the impact force multiplier value to the one passed in
WindsOfMagicMultiplierFloatVoidReturns the winds of magic multiplier value
SetDamageMultiplierVoidFloatSets the damage multiplier value to the one passed in
SetBloodMultiplierVoidFloatSets the blood multiplier value to the one passed in
SetValueForLabSettingVoidCcoLabSettingRecord, FloatSets the value for the passed in lab setting to the one passed in
SetSingleEntityScaleMultiplierVoidFloatSets the single entity scale multiplier value to the one passed in
MoraleMultiplierFloatVoidReturns the morale multiplier value
IsWindsOfMagicLimitlessBoolVoidReturns true of winds of magic is set to limitless
ImpactForceMultiplierFloatVoidReturns the impact force multiplier value
SetChargeBonusMultiplierVoidFloatSets the charge bonus multiplier value to the one passed in
UnitSizeFloatVoidReturns the unit size multiplier value
DamageMultiplierFloatVoidReturns the damage multiplier value

CcoBattlePurchasableArmyAbility

A purchasable ability or upgrade that can be applied to specific armys

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PurchaseUpgradeVoidCcoBattleArmyPurchases the army ability upgrade
SoundTypeStringVoidReturns the sound type used for this purchase group
CanAffordBoolCcoBattleArmyReturns if can afford to purchase the item
IsAvailableInGroupBoolCcoBattleArmyReturns true if the item is available
GetCostForThisActionFloatCcoBattleArmyReturns the cost of this action
ArmySpecialAbilityRecordContextCcoArmySpecialAbilityRecordVoidReturns the army ability record context

CcoBattlePurchasableUnit

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitContextCcoBattleUnitVoidReturns CcoBattleUnit context
CanAffordUnitBoolIntReturns whetehr the unit can be afforded, takes in int32 army id
CostPerUnitFloatIntReturns price of the unit, takes in int32 army id

CcoBattlePurchasableUnitAbility

A purchasable ability or upgrade that can be applied to specific units

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FilterSelectionCanBeCastCcoBattleUnit (list)ContextList, Bool(UnitList, CanCastIfAlreadyInProgress) Filter a unit list to only those who will be affected by this ability, and who don't have the ability in progress already
FilterSelectionToApplicableCcoBattleUnit (list)ContextList(UnitList) Filter a unit list to only those who will be affected by this ability
GetCostForThisActionFloatInt
UnitSpecialAbilityRecordContextCcoUnitSpecialAbilityRecordVoid
SoundTypeStringVoid
UnitAbilityContextCcoUnitAbilityVoid
CanAffordBoolContextList, Int(UnitList, ArmyID) Can the army afford to purchase the ability for all of the units (who can get the ability) in the UnitList
PurchaseForCurrentSelectionVoidContextList, CcoBattleArmy, Bool(UnitList, CcoBattleArmy) Purchase the ability for the units in the list for the specific army
IsAvailableInGroupBoolContextList(UnitList) Is the ability available to any of the units in the list
GetCostForSelectionFloatContextList, Int(UnitList, ArmyID) Get the cost to apply this upgrade to all of the listed units for the specific army id

CcoBattleReinforcementArmy

Component context wrapper for a BATTLE_UI_REINFORCEMENT_ARMY, exposes all information available to UiEd

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitListCcoBattleUnit (list)VoidReturns the list of CcoBattleUnits that make up this reinforcing army.
TargetArmyContextCcoBattleArmyVoidReturns the CcoBattleArmy that this army's units will join after entering the field.
NumUnitsRemainingIntVoidHow many more units are left to be deployed, as not all units are deployed at the same time
PositionVector4VoidReturns a VECTOR4 specifying the world position of the reinforcement army's spawn zone/deployment location
TimeUntilDeploySecsFloatVoidHow long (in seconds) until the reinforcement army is deployed
IsDeployedUsingTimerBoolVoidIs this reinforcement army's spawn based on a timer/countdown?
IsDeployedBoolVoidHas the reinforcement army been deployed into the battlefield yet?

CcoBattleReinforcementDebugUnits

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DeployUnitsVoidContextList, CcoBattleArmyDeploys units
UnitsCcoBattleUnit (list)VoidLists units

CcoBattleReinforcementPool

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NumSpawnZonesAvailableToArmyIntCcoBattleArmy, ContextListReturns how many of the listed spawn zones are currently available to the specified army
GetHealthPercentageForUnitFloatCcoBattlePurchasableUnitGets health percentage of a unit in replenishment pool, returns 0 if unit is not found
CanUseUnitBoolCcoBattleUnitReturn whether a specific unit is available to deploy (even if it cannot be deployed currently)
CostForUnitsFloatContextList, IntReturns cost for list of units for an army
PurchaseUnitVoidCcoBattlePurchasableUnit, CcoBattleArmy, IntPurchases a single unit for an army at a spawn zone
PurchaseUnitsVoidContextList, CcoBattleArmy, IntPurchases the list of units for an army at a spawn zone
UnitsMatchingUnitCategoryForArmyCcoBattlePurchasableUnit (list)CcoBattleArmy, CcoBattlePurchasableUnit, IntReturn vector of units in the matching category to the supplied unit, available to an army
HaveAnyUnitsBeenOnBattlefieldBoolContextListHave any of the units been on the battlefield during this battle?
UnitsCategorisedForArmyCcoGroupList (list)CcoBattleArmy, IntReturn vector of units available to an army
CanPurchaseUnitsBoolContextList, CcoBattleArmy, IntReturn whether list of units is affordable to an army
UnitsUnlockedFromCapturePointCcoBattleUnit (list)CcoBattleArmy, CcoBattleCapturePointReturn vector of units that are unlocked on a specific capture point
CanPurchaseUnitBoolCcoBattlePurchasableUnit, CcoBattleArmy, IntReturn whether a specific unit is affordable to an army
UnitsForArmyCcoBattlePurchasableUnit (list)CcoBattleArmy, IntReturn vector of units available to an army
UnitsMatchCategoryBoolCcoBattlePurchasableUnit, CcoBattlePurchasableUnitDo the supplied purchasable units match the same unit category?
CanUseSpawnZoneReasonString (list)CcoBattleArmy, IntReturns the reason/state name of whether a spawn zone can be used or not
CanUseSpawnZoneBoolCcoBattleArmy, IntReturn whether the specific spawn zone can be used

CcoBattleRoot

The root for battle that gives access to anything battle related

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsSiegeBoolVoidReturns true if current battle is a siege
IsResultsPhaseBoolVoidReturns true if current phase in battle is results
MapBarrierToggleableSlotListCcoBattleToggleableSlot (list)CcoBattleArmyReturns list of map barrier toggleable slots in the battle
OpposingToPlayerAllianceContextCcoBattleAllianceVoidGet the opposing to player alliance
DevCycleArmyVoidVoidCycles between armies, used for dev functionalitydebug
SettlementContextCcoBattleSettlementVoidReturns the CcoBattleSettlement context if in a settlement/siege battle
DoesHaveArmyAbilityUpgradesBoolVoidReturns true if army ability upgrades are enabled for this battle
IsConflictPhaseBoolVoidReturns true if current phase in battle is conflict
IsCinematicModeEnabledBoolVoidReturns true if cinematic mode is currently enabled
PlayerArmyContextCcoBattleArmyVoidReturns the CcoBattleArmy for the player
ToggleableSlotListCcoBattleToggleableSlot (list)CcoBattleArmyReturns list of all toggleable slots in the battle
ShowEscapeMenuVoidVoidToggles the escape menu in battle
CaptureLocationManagerContextCcoBattleCaptureLocationsManagerVoidReturns capture location manager context
IsDeploymentPhaseBoolVoidReturns true if current phase in battle is deployment
DoesHaveUnitUpgradesBoolVoidReturns true if unit upgrades are enabled for this battle
ToggleCinematicModeVoidVoidToggles the cinematic mode UI
BattleReinforcementDebugUnitsContextCcoBattleReinforcementDebugUnitsVoidReturns the battle reinforcement debug units context
PlayerAllianceContextCcoBattleAllianceVoidReturns the CcoBattleAlliance for the player
BuildingsListCcoBattleBuilding (list)VoidReturns list of all buildings in the battle
IsToggleSlotListVisibleBoolVoidReturns true if the toggle slots can be shown
DoesHaveUnitReplenishmentsBoolVoidReturns true if unit replenishments are enabled for this battle
IsTeleportWithdrawAvailableBoolVoidReturns true if the battle allows the use of `Teleport Withdraw`.
DefendingAllianceContextCcoBattleAllianceVoidReturns the CcoBattleAlliance for the defending alliance
BattleReinforcementPoolContextCcoBattleReinforcementPoolVoidReturns the battle reinforcement pool context
IsCapturePointListVisibleBoolVoidReturns true if the capture points can be shown
HasAmbushWithdrawAreaBoolVoidReturns true if the current battle has an ambush withdraw area
AttackingAllianceContextCcoBattleAllianceVoidReturns the CcoBattleAlliance for the attacking alliance
StormOfMagicContextCcoBattleStormOfMagicVoidReturns the storm of magic context
DoesHaveReinforcementPurchasingBoolVoidReturns true if reinforcement purchasing is enabled for this battle
HasArmyAbilityFillCurrencyBoolVoidReturns true if army ability fill is used in this battle
YearIntVoidReturns the year number for the current battle
BattleTypeCheatSheetListCcoBattleTypeCheatSheetEntryRecord (list)IntGets a list of CcoBattleTypeCheatSheetEntryRecords, ordered by their priority indices, and that live in the specified column index.
BattleCurrencyManagerContextCcoBattleCurrencyManagerVoidReturns the currency manager context
NumberOfCoresIntVoidReturns the number of physical CPU cores (this probably should be a global function instead!)
GetHumanNetworkPlayersParticipatingInAllianceListCcoNetworkPlayer (list)VoidReturns list of human players participating in the battle
IsConquestBoolVoidReturns true if current battle is a conquest battle
SetupContextCcoBattleSetupVoidReturnsthe battle setup context for the current battle
HasPrisonersBoolVoidReturns true if prisoner currency is used in this battle
SpawnZoneListCcoBattleSpawnZone (list)VoidReturns list of all spawn zones in the battle
TimeoutWinningAllianceIndexIntVoidReturns the index of the alliance who will win when the timer runs out
ResultContextCcoBattleResultVoidReturns the battle result context for the current battle
HasSuppliesBoolVoidReturns true if supplies currency is used in this battle
IsDominationBoolVoidReturns true if current battle is a domination battle
ReinforcementArmyListCcoBattleReinforcementArmy (list)VoidReturns list of all reinforcing armies for the battle
UnitSizeFloatVoidReturns the unit scale factor setting
IsLegendaryModeBoolVoidReturns true if the current battle has legendary mode enabled
IsTrialBoolVoidReturns true if current battle is a trial battle
VehicleListCcoBattleVehicle (list)VoidReturns list of all the vehicles in the battle
BalanceOfPowerPercentFloatVoidReturns floating point percent for players alliance to show how much they are winning the battle
SelectionContextCcoBattleSelectionVoidReturns the selection context to get information on what is currently selected in battle
IsRealismModeEnabledBoolVoidReturns true if the current battle has realism mode enabled
IsSurvivalBoolVoidReturns true if current battle is a survival battle
VictoryCapturePointContextListCcoBattleCapturePoint (list)BoolReturns list of all the victory capture points in the battle if passed true, if passed false will return just the victory capture points
AmbushWithdrawAreaPositionVector4VoidReturns the position of the ambush withdraw area (if there is one)
CursorContextContextCcoBattleCursorContextVoidReturns the cursor context for the battle to get information on what is currently under the mouse cursor
CanDismantleBuildingsBoolVoidReturns true if buildings can be dismantled in the current battle
IsSpectatorBoolVoidReturns true if local player is current spectating
QuestKeyStringVoidReturns the quest key of the current battle if it is a quest battle
TimeControlContextCcoBattleTimeControlVoidReturns the time control context to query/interact with time controls in battle
BattleHasToggleBuildingsBoolVoidReturns true if the current battle has any toggleable buildings
CapturePointListCcoBattleCapturePoint (list)VoidReturns list of all the capture points in the battle
IsCampaignBattleBoolVoidReturns true if current battle was started from campaign
BattleTypeStateStringVoidReturns the type of battle as an unlocalised string
ClimateWeatherDescriptionRecordContextCcoBattleClimateWeatherDescriptionRecordVoidReturns the climate weather description record for the current battle
IsLabModeBoolVoidReturns true if current battle is a lab mode battle
GroupListCcoBattleGroup (list)VoidReturns list of all players unit groups
IsMultiplayerBoolVoidReturns true if current battle is multiplayer
IsReplayBoolVoidReturns true if current battle is a replay
UnitListCcoBattleUnit (list)VoidReturns list of all units in the battle
BattleNameTextUniStringVoidReturns the localised name of the battle
ClimateRecordContextCcoClimateRecordVoidReturns the climate record for the current battle
ArmyListCcoBattleArmy (list)VoidReturns list of all armies in the battle
IsTutorialBoolVoidReturns true if current battle is a tutorial
RestartBattleVoidVoidRestarts the current battle
WeatherRecordContextCcoBattleWeatherTypeRecordVoidReturns the weather record for the current battle
TimeRemainingStringUniStringVoidReturns the time remaining as a pre-formatted localised string
VictoryPointContributionSummaryForAllianceCcoSummedValueContextInt, BoolGet CcoSummedValueContext for summary of ticket score contribution by different types of capture points
AllianceListCcoBattleAlliance (list)VoidReturns list of all alliances in the battle
ZoomToPositionVoidVector4Zoom the camera to an abitrary position
SeasonRecordContextCcoSeasonRecordVoidReturns the CcoSeasonRecord context for the current battle

CcoBattleSelection

Exposes the current selection in battle allowing to perform queries and commands on the current selected units for example

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ToggleMeleeVoidVoidToggles melee/ranged mode on the current selection
ToggleRunVoidVoidToggles run/walk speed on the current selection
WithdrawVoidVoidIssues a withdraw command to the current selection, making them withdraw from the battlefield
HaltVoidVoidIssues a halt command to current selection, cancelling any current orders
FirstUnitContextCcoBattleUnitVoidReturns the first unit in the selection
UnitListCcoBattleUnit (list)VoidReturns list of CcoBattleUnit that are currently selected
FormationNameStringVoidReturns the current formation key of selection
NumEntitiesSelectedIntVoidReturns the number of entities currently selected
NumUnitGroupsIntVoidReturns number of unit groups currently selected
NumUngroupedUnitsIntVoidReturns number of ungrouped units currently selected
NumUnitsIntVoidReturns number of units currently selected
IsTakingDamageBoolVoidReturns true if the current selection is taking damage
AnyUnitSelectedIncludingEnemyBoolVoidReturns true if any unit selected including the enemy
AnyUnitSelectedBoolVoidReturns true if any controllable unit is selected
DeselectAllVoidVoidDeselects any currently selected units
IsOrderableBoolVoidReturns true if the current selection can be issued orders
ToggleFlyingVoidVoidToggles flying state of units that can fly in the current selection
ChangeFormationVoidExpressionStateChanges the formation of the current selection to thet specified one

CcoBattleSettlement

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MountedArtilleryLocationListVoidVoid
DestructionEffectsListVoidVoid
DestroyedPercentVoidVoid

CcoBattleSetup

Wrapper for a battle setup

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PlayerArmyIDIntVoidReturns the players army index
LocalPlayerAllianceContextCcoBattleSetupAllianceVoidReturns the local players CcoBattleSetupAlliance context
OtherPlayerAllianceContextCcoBattleSetupAllianceVoidReturns the other players alliance context
PlayerAllianceIDIntVoidReturns the players alliance index
HideEnemyUnitsBoolVoidReturns true is enemy units should be hidden
HideAllUnitsBoolVoidReturns true if all units should be hidden
IsPlayerAttackerBoolVoidReturns true if the player is the attacker
IsBenchmarkBoolVoidReturns true if this battle setup is a benchmark
IsTimeoutDrawBoolVoidReturns true if there was a timeout draw
BattleInfoContextCcoBattleSetupInfoVoidReturns the CcoBattleSetupInfo context

CcoBattleSetupAlliance

Wrapper for an alliance in a set battle, exposes army contexts to UiEd.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ArmyListCcoBattleSetupArmy (list)Bool (optional)Returns the list of all CcoBattleSetupArmy contexts involved in the battle.
ArmyContextCcoBattleSetupArmyIntReturns the CcoBattleSetupArmy with the specified id.

CcoBattleSetupArmy

Contains initial setup data for the specified army

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PlayerNameUniStringVoidReturns the name of the player if human or the localised string for cpu if AI
FlagDirStringVoidReturns path to flags for the faction
UnitListCcoBattleSetupUnit (list)Bool (optional)Returns the list of units in this setup army, optional bool argument for whether hidden armies should be excluded
AllianceColourColourVoidReturns the associate alliance colour for the setup army (as in colour based on player/ally/enemy/neutral)
BattleSetupFactionContextCcoBattleSetupFactionVoidReturns the CcoBattleSetupFaction for this setup army

CcoBattleSetupFaction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactionRecordContextVoidVoid
FlagDirVoidVoid
NameVoidVoid

CcoBattleSetupInfo

Wrapper for the setup of a battle, exposing info like the region name and year of battle.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BattleYearIntVoidReturns the year that the battle took place in, as int32.
RegionNameUniStringVoidReturns the name of the region that the battle took place in. Only applicable for campaign battles.
BattleTypeStringUniStringVoidReturns the type of battle (e.g. land battle, chokepoint battle...)
DevSetIsLabModeVoidBoolSets the battle to be a lab mode battledebug
LaboratoryInfoContextCcoBattleLaboratoryInfoVoidReturns the CcoBattleLaboratoryInfo if this is a laboratory type battle
AllianceContextFromIndexCcoBattleSetupAllianceIntReturns the CcoBattleSetupAlliance corresponding to the alliance at the given index.
BattleTitleUniStringVoidReturns the name of the battle.

CcoBattleSetupUnit

Wrapper for a BATTLE_SETUP_UNIT

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AppliedDishListCcoCookingDish (list)VoidReturns a list of CcoCookingDish with the dishes applied to this unit if any
UnitDetailsContextCcoUnitDetailsVoidReturns a CcoUnitDetails with the details of the unit
UnitRecordContextCcoMainUnitRecordVoidReturns a CcoMainUnitRecord with the main unit
CombatPotentialIntVoidReturns an int with the combat potential of the unit
IsCommanderBoolVoidReturns true if the unit is a commander
ImagePathStringVoidReturns a string with the image path of the unit
NameUniStringVoidReturns a localised string with the name of the unit

CcoBattleSpawnZone

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetAllianceColourColourInt
IsAvailableToAllianceForSupportBoolInt
IsAvailableToAllianceBoolInt
PositionVector4Void
OnMouseOverVoidBool
UniqueIDIntVoid
IsVanguardOnlyBoolVoidIs the spawn zone only available for use by vanguard units or not

CcoBattleStormOfMagic

Cco wrapper for querying and controlling the Storm Of Magic manager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FluxCapacityIntVoidMax/Target value of current lore progress
DisplayFluxValueIntVoidDisplayable value of current lore progress, which includes discharge value when amgic transition occurs
FluxValueIntVoidReal value of current lore progress
FluxPercentPreviewFloatVoidShows the new %age of the flux charge based on the current moused over spell
FluxPercentFloatVoidCurrent %age progress through the current lore until the next lore transition is triggered
IsFluxTransitioningBoolVoidIs there a magical flux transition in progress?
DevTriggerRandomAscendancyVoidVoidDEV - Trigger a random ascendancy change to a new lore
DevChangeAscendancyVoidCcoSpecialAbilityGroupRecordDEV - Trigger an ascendancy change to a specific lore (using the CcoSpecialAbilityRecord of the target lore)
SelectableLoreListCcoSpecialAbilityGroupRecord (list)VoidGet the list of the currently selectable lores (Supports only 8 max currently)
ApplyAscendancyVoidCcoSpecialAbilityGroupRecordRequest to apply a specific lore, in response to a manual lore selection notification
AvailableLoreListCcoSpecialAbilityGroupRecord (list)VoidGet the list of all of the available lores (Supports only 8 max currently)
CurrentAscendancyIndexIntVoidGet the Index for the currently ascendant lore
CanArmySelectAscendancyAtBattleStartBoolCcoBattleArmyWhether the specified army select the Storm of Magic ascendancy at battle start
TriggerAscendancyChangeVoidVoidTrigger a Storm of Magic Ascendancy Change message
CurrentAscendancyLoreContextCcoSpecialAbilityGroupRecordVoidGet the CcoSpecialAbilityGroupRecord for the currently ascendant lore
IsMagicalChargeTransitionInProgressBoolVoidIs a Storm of Magic ascendancy transition in progress?
IsEnabledBoolVoidIs the Storm Of Magic manager enabled?
MagicalChargeTransitionProgressFloatVoidGets the fractional progress of the magical transition
MagicalChargeTransitionTimeRemainingFloatVoidGets the time remaining for the magical transition in seconds
IsAscendancyTransitionInProgressBoolVoidIs a Storm of Magic ascendancy transition in progress?
AscendancyTransitionTimeRemainingFloatVoidGets the time remaining for the magical transition in seconds

CcoBattleSurvivalWave

Component context wrapper for a survival wave, detailing wave Id and units involved in the wave and other wave info

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CategorisedWaveUnitsListCcoGroupList (list)VoidReturns a list of Grouped CcoBattleUnits that represent the units in this wave, but in a categorised manner
WaveUnitsListCcoBattleUnit (list)VoidReturns a list of CcoBattleUnits that represent the units in this wave
WaveIdIntVoidReturns the associated Wave ID
IsFinalWaveBoolVoidReturns if the wave is the final/boss wave

CcoBattleTimeControl

Component context wrapper for battle time controls, contains all interface for querying and interacting with time state of battle

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
StateForSpeedStringExpressionState, FloatReturns button state to use for the specified speed
CycleSpeedVoidBool, BoolCycles the speed between pause,slowmo,play,fwd,ffwd either in the direction specified (true=forwards,false=backwards)
TogglePauseVoidVoidToggles between current speed and puase
ToggleSpeedVoidFloatToggles between specified speed and pause
SetSpeedVoidFloatSets time to a specified float multiplier speed
SetCanChangeTimeVoidBoolAllows to disable ability to change the time
CanCycleSpeedBoolBoolReturns true if can cycle in the direction specified (true=forwards,false=backwards). This assumes non-wrapping functionality (for 3k)
ShouldShowPausePanelBoolVoidReturns true if we should currently be showing the paused panel
IsSlowMoEnabledBoolVoidReturns true if can set speed to slow motion. This is disabled in realism mode for example
CanChangeTimeBoolVoidReturns true if can currently change the time
NumMpVotesForSpeedIntFloatReturns the number of votes in multiplayer for a particular speed
CurrentSpeedFloatVoidReturns the current speed as a float multiplier value (e.g. 1 for play, 0 for pause, 0.4 for slowmo...)
CurrentSpeedNameStringVoidReturns the UNLOCALISED name of the current speed

CcoBattleToggleableSlot

A slot that can contain a unit, barrier or building; that may be toggled from an off state to one of a pool of options

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsUnitBoolVoidDoes the slot represent a toggleable unit?
TypeStringString (list)VoidReturns the type of the slot as an unlocalised string
IconBlendablePathForIndexString (list)CcoBattleArmy, IntRetrieve the white/blendable icon asset path for the associated slot buildable index
ParentCapturePointContextCcoBattleCapturePointVoidGet the CcoBattleCapturePoint that is the parent of this toggleable slot
IconMinimapPathForIndexString (list)CcoBattleArmy, IntRetrieve the minimap icon asset path for the associated slot buildable index
SetActiveVoidBoolSet if the slot radial visible
IsActiveBoolVoidIs the slot radial visible?
ConstructionTimeRemainingSecondsFloatVoidHow long is left in the current construction timer
IsDestroyedBoolVoidReturns true if this slot has been destroyed and cannot be rebuilt
CurrentBuildableOwnerCcoBattleArmyVoidGet the CcoBattleArmy of the owner of the currently enabled buildable. Falls back to the capture point owner if this fails
CurrentIndexIntVoidGet the enabled index of the buildable on the associated slot (-1 for nothing)
IsDestructionInProgressBoolVoidIs there anything being destructed or a toggle switch being deferred?
ShowPreviewForIndexVoidIntShows the ghost preview for the buildable on the associated slot
IsConstructionInProgressBoolVoidIs there anything being constructed or a toggle switch being deferred?
HidePreviewForIndexVoidIntHides the ghost preview for the buildable on the associated slot
CanOwnerInteractBoolVoidCan the slot be interacted with by the army that owns it?
ZoomToVoidVoidZooms the camera to the position of this toggleable slot
WorldPositionVector4VoidReturns a Vector3 of the world position of the slot origin
CanInteractBoolCcoBattleArmyCan the slot be interacted with?
HasArtilleryMountLocationBoolVoidDoes the slot support an artillery mount?
EnabledIndexIntVoidWhich of the buildables is currently enabled? -1 for none
IsFreeRotationAllowedBoolVoidCan the slot be rotated?
IsAnyEnabledBoolVoidAre any of the buildables associated with this slot, enabled?
IsMapBarrierBoolVoidDoes the slot represent a toggleable barrier?
IconPathForIndexStringCcoBattleArmy, IntRetrieve the icon asset path for the associated slot buildable index
IsBuildingBoolVoidDoes the slot represent a toggleable building?
BuildablesListCcoBattleToggleableSlotBuildable (list)VoidGet the list of buildables associated with the slot (slot buildable indices associated with index-related functions in Toggleable Ccos)

CcoBattleToggleableSlotBuildable

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HidePreviewVoidVoidHides the ghost preview for the buildable on the associated slot
MapBarrierNameStringVoidGet the name if the map barrier is valid
IconPathStringCcoBattleArmyRetrieve the icon asset path for the buildable on the associated slot
IsDestroyedBoolVoidHas the buildable been destroyed/taken maximum damage
IndexIntVoidReturn the index that this buildable represents in the associated slot
CanRefundBoolCcoBattleArmyCan the buildable be refunded
CanAffordBoolContextCan the buildable be afforded
RefundValueFloatVoidGet the currency refund value for this buildable in its current state
CostFloatIntGet the currency cost for this buildable for the army specified
ParentContextCcoBattleToggleableSlotVoidGet the containing toggleable slot Cco for this buildable
CurrentStateStringCcoBattleArmy, IntGet the visual state for the slot
HideToolTipVoidVoidHide the building tooltip for the buildable on the associated slot
ShowToolTipVoidVoidShow the building tooltip for the buildable on the associated slot
SecondaryActionVoidVoidTrigger the secondary action for the slot
PrimaryActionVoidVoidTrigger the primary action for the slot
ShowPreviewVoidVoidShows the ghost preview for the buildable on the associated slot
MapBarrierIsAvailableBoolContext - Is this a map barrier that is available to the associated army

CcoBattleUnit

Component context wrapper for a battle unit, exposes all information available to UiEd

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ThreatPercentOfUnitFloatCcoBattleUnitReturns the threat of the specified unit. -1 is invalid, 1 is high threat, 0 is low threat
CanNearlyBeExecutedByNearbyEnemyBoolVoidReturns true if this unit is nearing the execute threshold health of a nearby enemy executioner ('nearing' value defined in the kv_ui_tweakers table)
IsRoutingBoolVoidReturns true if this unit is currently routing (running away due to low morale, but might recover and come back)
BattleResultUnitContextCcoBattleResultUnitVoidReturns the CcoBattleResultUnit for the current unit
DevSetHealAmountVoidInt, BoolSets the heal amount to the specified percentage value [0-100]debug, hide_in_uied
HealthPercentFloatVoidReturns the health of the unit as a percentage (0-1)
IsUnderMyControlBoolVoidReturns true if the unit is under the player control
NumEntitiesInitialIntVoidReturns the number of entities the unit entered the battle with
IsUnderMissileAttackBoolVoidReturns true if this unit is currently being fired upon
PurchasedEffectsListCcoUnitPurchasableEffectRecord (list)VoidReturns a list of CcoUiUnitStatusRecord that are currently active sorted in order of importance
StatusListCcoUiUnitStatusRecord (list)VoidReturns a list of CcoUiUnitStatusRecord that are currently active sorted in order of importance
ThreatPercentOfUnitMouseoverFloatVoidReturns the threat of the unit currently mousing over (used on tooltips). -1 is invalid, 1 is high threat, 0 is low threat
IsOriginallyOwnedByLocalPlayerBoolVoidReturns whether the local player originally owned this unit i.e. if it is gifted but still belongs to this player
IsWaveringBoolVoidReturns true if this unit is currently in wavering morale state (brink of routing)
CanBeExecutedByNearbyEnemyBoolVoidReturns true if this unit is below the execute threshold health of a nearby enemy executioner
DevSetAmmoAmountVoidInt, BoolSets the ammo amount to the specified valuedebug, hide_in_uied
RadarPositionVector4VoidReturns the radar position (0-1, 0-1) as a percentage to be used with ContextRadarIcon
IsUnderAIControlOriginallyBoolVoidReturns true if the unit started the battle under AI control
IsInMeleeBoolVoidReturns true if this unit is currently in melee combat
HealingPowerFloatVoidReturns this unit's modifier for healing
ManListCcoBattleEntity (list)VoidReturns the list of CcoBattleEntity just for man entities
NumEntitiesIntVoidReturns the current number of entities
OriginalOwningNetworkPlayerContextCcoNetworkPlayerVoidReturns the CcoNetworkPlayer that originally had control of this unit (if unit gifted for example)
HealthMaxIntVoidReturns the max health
IsOutOfControlBoolVoidReturns true if this unit is currently out of control (meaning player has no control over them and they just attack the nearest unit)
IsCharacterBoolVoidReturns true if this unit is a character (general or agent basically)
DevRoutVoidVoidWill rout the unitdebug, hide_in_uied
IsUnderAIControlBoolVoidReturns true if the unit is currently under AI control (instead of script or player)
IsVisibleBoolVoidReturns true if this unit is currently visible to player (taking into account hidden state and line of sight
PositionVector4VoidReturns the current position
IsSelectedBoolVoidReturns true if this unit is currently selected
HealthReplenishRateBaseFloatVoidReturns the base rate at which health is being replenished by abilities
SecondsLeftToTeleportIntVoidReturns number of seconds left in teleporting to withdraw process
MountListCcoBattleEntity (list)VoidReturns the list of CcoBattleEntity just for mount entities
ToggleFlyingCooldownTimerFloatVoidReturns the time (in seconds) remaining on the toggle flying cooldown timer
HealthValueIntVoidReturns the raw health value
IsForceRampageBoolVoidReturns true if the unit has a forced rampage
ArmyContextCcoBattleArmyVoidReturns the CcoBattleArmy this unit belongs to
OwningNetworkPlayerContextCcoNetworkPlayerVoidReturns the CcoNetworkPlayer that is currently in control of this unit, for mp battles where unit sharing possible
IsHiddenBoolVoidReturns true if this unit is currently hidden (using terrain types, etc)
StatusColourColourVoidReturns the colour for the current status, used for things like when in combat to identify if winning for example, or for when capturing capture point
EngineListCcoBattleEntity (list)VoidReturns the list of CcoBattleEntity just for engine entities
MaxHealthPercentCanReplenishFloatVoidReturns the max health percent that can be replenished by abilities
IsTeleportWithdrawingBoolVoidReturns whether unit is currently teleporting to withdraw
IsUnspottableBoolVoidReturns true if this unit has unspottable unit behaviour
DevRespawnVoidVoidWill respawn the unitdebug, hide_in_uied
CanToggleFlyingBoolVoidReturns true if this unit can currently choose to toggle its flying state (taking into account interruptions, etc)
DamageInflictedRecentlyIntVoidReturns the amount of damage inflicted in the last 4 seconds
IsOrderableBoolVoidReturns true if this can be given orders
IsInvincibleBoolVoidReturns true if the unit is invincible and cant take damage
AllianceColourColourVoidReturns the colour based on alliance (player/friendly/enemy/neutral)
PercentCasualtiesRecentlyFloatVoidReturns the percentage of men lost in the last 4 seconds
EntityListCcoBattleEntity (list)VoidReturns the list of CcoBattleEntity in the unit
DevResetAbilityUsesVoidVoidReset ability usesdebug, hide_in_uied
IsHighlightedBoolVoidReturns true if the unit is currently highlighted
IsFlyingBoolVoidReturns true if this unit is currently flying
DevKillVoidVoidWill kill the unitdebug, hide_in_uied
IsBuffedByHarmonyBoolVoidReturns true if the unit is currently receiving a battle harmony buff
BattleHarmonyEffectContextCcoBattleUnitEffectVoidReturn a context to the currently active battle harmony effect, if there is one
CanAlwaysFlyingBoolVoidReturns true if this unit has the ability to be always flying
IsSelectableBoolVoidReturns true if this unit can be selected
MoraleColourColourVoidReturns the colour that represents the current MoraleState
PercentHpLostRecentlyFloatVoidReturns the percentage of HP lost in the last 4 seconds
HasHarmonyEffectBoolVoidReturns true if the unit is tagged as a Yin or Yang battle harmony unit
DevResetAbilityRechargeVoidVoidReset ability rechargedebug, hide_in_uied
BattleAbilityListCcoBattleAbility (list)VoidReturns the list of abilities this unit can use as a list of CcoBattleAbility - these have current state information on abilities unlike CcoUnitAbility
HasStatusBoolVoidReturns true if unit has any CcoUiUnitStatusRecord currently
BreakForDebuggingVoidVoidBreaks in to attached IDE to inspect model UNIT in greater detaildebug, hide_in_uied
IsEnemyUnitBoolVoidReturns true if this unit belongs to the enemy alliance
StatusSubsetMostImportantCcoUiUnitStatusRecordVoidSame as StatusMostImportant BUT ignores certain statuses, as Fabian on 3k wanted to only show certain statuses on unit card as some statuses were shown in a different manner
CanFlyBoolVoidReturns true if this unit has the ability to fly
CopyMemoryAddressToClipboardVoidVoidCopies the memory address of this models actual unit to the clipboard which is handy for creating conditional breakpointsdebug, hide_in_uied
ActiveHarmonyEffectStateStringBool (optional)Returns a string representing the state of the current harmony effect (yin/yang), or an empty string if there is no active harmony effect. Optional argument specificies if harmony base type of the unit should count towards the effect, defaults to true
ReloadPercentMaxFloatVoidReturns highest reload percent in entity (so closest entity to firing), with idea being requested by Attila so know when unit will next be able to shoot to stop players wondering why unit not attacking
DevResetAbilityManagerVoidVoidReset ability managerdebug, hide_in_uied
IsUndeadBoolVoidReturns true if unit is undead or construct (different morale rules apply to these, have crumbling and unstable states)
AbilityListCcoUnitAbility (list)VoidReturns the list of abilities this unit can use as a list of CcoUnitAbility
CapturePowerFloatBool (optional)Returns the current capture power of this unit. Scaled by the unit's remaining men. Returns 0.0 when not on a map with capture points
IsRenownBoolVoidReturns true if a unit of renown (special limited units that have certain perks and we highlight in the UI)
IsFiringAtWillBoolVoidReturns true if this unit has fire at will enabled
HasInfinitePrimaryAmmoBoolVoidReturns true if has infinite primary ammo
HasArtilleryDroppedEnginesBoolVoidReturns true if artillery unit that has dropped their engines
StatusMostImportantCcoUiUnitStatusRecordVoidReturns the current most important CcoUiUnitStatusRecord that is active
GiftToOriginalOwnerVoidVoidGifts the unit back to their original owning player when the unit is currently a shared unit
IconPathStringVoidReturns the icon path used for unit cards, etc
LargestNearbyEnemyExecuteThresholdFloatVoidReturns the largest execution threshold of nearby enemies (Either from the executor attribute or ability phases)
IsPlayerUnitBoolVoidReturns true if this unit belongs to the player
BarrierMaxHpIntVoidReturns the units barrier max HP if any (barrier is a kind of rechargable shield)
BuildingContextCcoBattleBuildingVoidReturns the CcoBattleBuilding this unit is currently on/in
IsSpawnedUnitBoolVoidReturns true if a spawned unit (came from an ability for example during the battle)
SetupUnitContextCcoBattleSetupUnitVoidReturns the CcoBattleSetupContext which wraps BATTLE_SETUP_UNIT for this unit (setup info came into battle with)
ToggleFlyingVoidVoidToggles a unit between flying in the air and moving on the ground (for units that CanFly)
ActiveEffectStateStringBool (optional)Returns a string representing state of active effects (positive/negative/both) if any, optional bool can be provided which when true will only consider non-passive effects as counting
IsRunningBoolVoidReturns true if this unit is currently moving at running pace
DevTeleportVoidString, StringTeleports a unitdebug, hide_in_uied
UnlockedAbilitiesCcoUnitSpecialAbilityRecord (list)ContextList); Returns a list of the unlocked abilities from the list of groups supplied
BarrierSecsUntilRechargeFloatVoidReturns the number of seconds until the barrier will start recharging if the unit has a barrier and it has depleted (barrier is a kind of rechargable shield)
IsGeneralBoolVoidReturns true if this unit is a commanding general unit
ShouldShowAmmoBoolVoidReturns true if we should show ammo UI for this unit
UnitDetailsContextCcoUnitDetailsVoidReturns the CcoUnitDetails for this unit, used for unit info panel that shows unit information from various sources
FatigueNameUniStringVoidReturns the localised name of the current FatigueState
IsWalkingBoolVoidReturns true if this unit is currently moving at walking pace
DevSetArmyVoidIntGives control of the unit to a given armydebug, hide_in_uied
CooldownPassiveAbilityListCcoBattleAbility (list)VoidReturns a list of passive battle abilities current on cooldown
BarrierHpIntVoidReturns the units barrier HP if any (barrier is a kind of rechargable shield)
ToggleHighlightVoidVoidToggles the highlight shown with Highlight command
CanGuerrillaDeployCurrentlyBoolVoidReturns true if the unit CanGuerrillaDeploy and can do this currently (has extra checks like not in a vehicle, etc)
BarrierCapPercentFloatVoidReturns the units barrier percentage the current max is against the initial max, which is essentially the health percentage of a unit at the minute (barrier is a kind of rechargable shield)
MoraleNameWithGreatestEffectUniStringVoidReturns a combination of MoraleName and MoraleGreatestEffect. No longer needed since can add strings with expressionsdeprecated
CharacterRankIntVoidReturns the rank of the character this unit is for if any
IsReadyToExtractBoolVoidReturns true if an ambush battle with an extraction location and they are in the extraction zone ready to safely recover
DevTakeControlVoidVoidGives control of the unit to the playerdebug, hide_in_uied
IsIdleBoolVoidReturns true if this unit has no orders currently and is standing still
HasCharacterRankBoolVoidReturns whether the unit supports having a rank or not
HighlightVoidBoolHighlights on the 3d battlefield in same way script can (flashes entity markers and unit ids for example)
UnitRecordContextCcoMainUnitRecordVoidReturns the CcoMainUnitRecord for this unit
SelectVoidVoidSelects this unit to control
MoralePercentFloatVoidReturns the current morale as a percentage of best morale could be
ActiveFactionSpecificEffectListCcoEffect (list)Void(Returns a list of the CcoEffects that are being applied to the unit from Storm of Magic ascendancies
CanGuerrillaDeployBoolVoidReturns true if the unit has the ability to guerilla deploy (deploy outside deployment zone)
DelayedBarrierHpPercentFloatVoidReturns the units delayed barrier HP percent if any (barrier is a kind of rechargable shield)
DevToggleControlVoidVoidToggles control between player and UI, useful for taking control of enemy units for exampledebug, hide_in_uied
IsBarrierChargingBoolVoidReturns true if the unit has a barrier and it is currently recharging (barrier is a kind of rechargable shield)
IsCapturingBoolVoidReturns true if this unit is currently capturing a capture point
NumKillsIntVoidReturns the number of kills this unit has performed in this battle
HasInfiniteSecondaryAmmoBoolVoidReturns true if has infinite secondary ammo
ZoomToVoidVoidZooms camera to look at this unit
IsInLastStandBoolVoidReturns true if unit is currently in last stand, this is when they have no where to escape to and so will fight to last man
IsAffectedByStormOfMagicBoolVoidReturns true if affected by storm if there is a storm active, and we have an ability that uses the lore that is currently ascendant
UniqueUiIdIntVoidReturns the unique ui id of the unit as an int, unique amongst all units in the battle
ExperiencePercentFloatVoidReturns the experience percentage of progress to next level
BannerHolderEntityContextCcoBattleEntityVoidReturns the CcoBattleEntity for the entity currently holding the unit banner (entity who UI baner floats above)
IsWithdrawingBoolVoidReturns true if this unit is withdrawing from the map (running to edge of map to retire from battle)
MoraleGreatestEffectUniStringVoidReturns the localised name of the effect that is having the greatest effect on morale currently
BarrierReplenishRateFloatVoidReturns the barrier replenish rate as a percentage of the barrier's total hp
IsTerrifiedBoolVoidReturns true if unit is currently in a terrified state which seriously affects their morale (comes from units that have terrifying unit behaviour)
IsChangelingTransformationBoolVoidReturns true if this unit is currently transformed in a changeling form
DevSetForceRampageVoidBoolForces a unit to do rampage booldebug, hide_in_uied
SecondaryAmmoPercentFloatVoidReturns the percentage of secondary ammo remaining(0 - 1)
OfficerEntityContextCcoBattleEntityVoidReturns the CcoBattleEntity for the current officer entity (entity leading this unit)
IsFiringMissilesBoolVoidReturns true if this unit is currently firing missilees
FatigueStateIntVoidReturns the current fatigue state as an int (mirrors enum in code)
MoraleNameUniStringVoidReturns the localised name of the current MoraleState
ActiveEffectListCcoBattleUnitEffect (list)Bool (optional), String (optional)( Only Non-Passive Effects, Filter by source ability type); Returns a list of the active effects on the unit from abilities, etc
BarrierReplenishDelayFloatVoidReturns the barrier replenish delay (Time between taking damage and your barrier replenishing)
DevSetInvincibleVoidBoolSets the unit invincible based on the supplied booldebug, hide_in_uied
IsShatteredBoolVoidReturns true if this unit is shattered (morale so low that they will no longer recover and are essentially lost)
CustomNameUniStringVoidReturns any custom name given to this unit
IsWoundedBoolVoidReturns true if this unit currently has the specific wounded ability provided by Gary as wants to indicate this on health bars as special case
IsUnderPlayerControlBoolVoidReturns true if this unit is currently under the players control
IsAliveBoolVoidReturns true if this unit is still alive
PrimaryAmmoPercentFloatVoidReturns the percentage of primary ammo remaining (0-1)
ActiveProjectileContextCcoProjectileRecordVoidReturns the current CcoProjectileRecord context the unit is using for ranged attacks
MoraleStateIntVoidReturns morale state as an int (mirrors enum in code)
DevReduceHitpointsPercVoidIntReduce the hitpoint with the specified percentage value [0-100]debug, hide_in_uied
IsPartOfWaveBoolVoidReturns true if this unit is currently routing (running away due to low morale, but might recover and come back)
BarrierHpPercentFloatVoidReturns the units barrier HP percent if any (barrier is a kind of rechargable shield)
NameUniStringVoidReturns the localised name of the unit
IsAwaitingOrderAfterRallyBoolVoidReturns true if this unit recently rallied from routing and hasnt been given a command since, to highlight to player there are units not being taken advantage of
IsTakingDamageBoolVoidReturns true if this unit is currently taking damage
DelayedHealthPercentFloatVoidReturns the delayed health of the unit as a percentage (0-1)
ExperienceLevelIntVoidReturns the current experience level
IsGiftedBoolVoidReturns true if this unit has been gifted so the original owner isnt currently controlling
VehicleContextCcoBattleVehicleVoidReturns the current CcoBattleVehicle this unit is using if any

CcoBattleUnitEffect

Wrapper for a battle unit effect

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AbilityContextCcoUnitAbilityVoidReturn the setup ability for this effect
PhaseRecordContextCcoSpecialAbilityPhaseRecordVoidReturn the activating phase record for this effect
TooltipLayoutString (list)VoidReturns the tooltip layout that should be used for this effect
IconPathSmallString (list)VoidReturns the small icon path for the effect
IconPathString (list)VoidReturns the icon path for the effect
NameUniString (list)VoidReturns the name of the effect
HasIntensityBoolVoidReturns true if this effect is modified by an intensity value greater than 1.0f
IntensityFloatVoidReturns the intensity that that the effect is being multiplied by, or 1.0f if there is no intensity amount
PercentCompleteFloatVoidReturns the percentage of the effect that has completed
TotalDurationSecondsFloatVoidReturns the total duration of this effect
StartTimeSecondsIntVoidReturn the start time in seconds for this effect
TimeRemainingSecondsIntVoidReturn the time in seconds remaining for this effect
BattleAbilityContextCcoBattleAbilityVoidReturn the battle ability for this effect

CcoBattleVehicle

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CategoryNameVoidVoid
NameVoidVoid
PositionVoidVoid
PercentOnFireVoidVoid
HealthPercentVoidVoid
IsDestroyedVoidVoid
UnitContextVoidVoid
ArmyContextVoidVoid
IconPathVoidVoid
DescriptionVoidVoid

CcoBattleWindsOfMagicPool

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DepletionModifierPhaseListVoidVoid
RechargeModifierPhaseListVoidVoid
SpellPreviewRemainingManaVoidVoid
IsWindsOfMagicGamblerOpenVoidVoid
RechargeRateStringVoidVoid
RechargeRatePercentageVoidVoid
CurrentRechargePerSecondVoidVoid
MaxWindVoidVoid
ReserveWindVoidVoid
CurrentWindVoidVoid
HasUnlimitedWindVoidVoid
IsEnabledVoidVoid

CcoReinforcementArmy

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DelayVoidVoid
EntryPositionVoidVoid

Campaign

CcoCampaignAncillary

Component context wrapper for a campaign ancillary

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ColourTextUniStringVoidReturns localised colour text from record
MarkAsSeenVoidVoidMarks the equipment as seen so that HasSeen will return false
EffectTextUniStringVoidReturns localised effect text from record
TypeIconPathStringVoidReturns the icon path for the ancillary type
HasSeenBoolVoidReturns true if the user has already 'seen' this ancillary (MarkAsSeen has been called on it). This is to highlight new equipment
EffectUnfilteredListCcoEffect (list)VoidReturns a list of CcoEffect given by this ancillary when equipped, includes those not shown in uihide_in_uied
FuseTooltipUniStringCcoCampaignAncillaryReturns the tooltip for fusing with the passed in ancillary
EffectListCcoEffect (list)VoidReturns a list of CcoEffect given by this ancillary when equipped, prefiltered to not show those that shouldnt appear in ui
CanCharacterEquipBoolCcoCampaignCharacterReturns true if specified character can equip this ancillary
TurnsEquippedIntVoidReturns the number of turns this has been equipped
IsFusableBoolVoidReturns true if this ancillary can ever be fused.
IconPathStringVoidReturns icon path for images
SalvageValueCcoCampaignResourceTransactionCcoCampaignFaction (optional)Returns an int with the value of the ancillary if it were to get salvaged.
NameUniStringVoidReturns localised name of ancillary
SalvageVoidCcoCampaignFaction (optional)Salvages the ancillary.
RemoveAncillaryVoidVoidRemoves itself from the character that it's equipped to.
EquipToCharacterVoidCcoCampaignCharacter, CcoCampaignAncillaryEquips itself to the specified character, and swaps with the ancillary passed in if this exists.
CharacterEquippedToContextCcoCampaignCharacterVoidReturns the player character context where this ancillary is equipped, if any.
AncillaryRecordContextCcoAncillaryRecordVoidReturns the ancillary record context.
FuseForPlayerVoidCcoCampaignAncillaryFuses with the specified ancillary for the players faction (if possible)
CanFuseBoolCcoCampaignAncillaryReturns true if can fuse with the specified ancillary
ProvidedBodyguardsContextListVoidReturns list of CcoMainUnitRecord that are provided as bodyguards as a result of ancillary being equipped

CcoCampaignAreaOfInterest

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsMouseOverVoidVoid
EffectListVoidVoid
EffectBundleListVoidVoid
ZoomToClosestVoidVoid
PositionVoidVoid
IconPathVoidVoid
DescriptionVoidVoid
TitleVoidVoid
KeyVoidVoid

CcoCampaignArmoryItemVariant

Class that wraps a family member and an armory item variant that this family member owns

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanEquipItemBoolVoidReturns true if this item can be equipped on the family member
IsEquippedBoolVoidReturns true if this variation is equipped on the character
IsAvailableBoolVoidReturns true if this variation is available to the family member
ConflictingItemVariantListCcoArmoryItemVariantRecord (list)VoidReturns a list with all the armory item variants that conflict with this item.
CharacterContextCcoCampaignCharacterVoidReturns the context of the character that owns this variant
ArmoryItemVariantRecordContextCcoArmoryItemVariantRecordVoidReturns the context of the armory item variant
EquipItemSetVoidVoidEquips the set that this item is part of
UnequipItemVariantVoidVoidUnequips this variant from the family member
EquipItemVariantVoidVoidEquips this variant to the family member
IsCompatibleWithAgentSubtypeBoolVoidReturns true if this variant if compatible with the agent subtype of the family member

CcoCampaignArmyPlague

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SelectPlagueVoidCcoPlagueRecordSelects the plague with the CcoPlagueRecord passed in
ActivePlagueContextCcoCampaignBasePlagueVoidReturns a CcoCampaignBasePlague with the plague that is currently applied to the army
UnlockedPlagueListCcoPlagueRecord (list)VoidReturns a list of CcoPlagueRecord with the plagues that have been unlocked for this faciton
PlagueListCcoCampaignBasePlague (list)VoidReturns a list of CcoCampaignBasePlague with all plague for this faction

CcoCampaignBasePlague

Wrapper for a base plague

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PlagueCompositionContextCcoCampaignPlagueCompositionVoidReturns a CcoCampaignPlagueComposition which a plague composition with this base plague
PlagueEffectContextCcoPlagueEffectRecordVoidReturns a CcoPlagueEffectRecord which contains all effect bundles for this plague
PlagueRecordContextCcoPlagueRecordVoidReturns the record of the plague
DescriptionUniStringVoidReturns the description of the plague (currently taken from any of the effect bundles
NameUniStringVoidReturns the name of the plague (currently taken from any of the effect bundles
KeyStringVoidReturns record key for the plague

CcoCampaignBattle

This is the wrapper for pending battles in campaign, use to get information for prebattle/postbattle screen

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsQuestBattleBoolVoidReturns true if current battle is a quest battle
IsActiveBoolVoidReturns true if there is currently a pending battle (in prebattle or postbattle screen)
QuestBattleKeyStringVoidReturns set piece battle key for quest battle if this battle is a quest battle

CcoCampaignBookOfNagash

Wrapper for a book of nagash containing information about its owning force or settlement (or lack thereof)

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ZoomToOwnerVoidVoidZooms the camera to the current book owner if there is one
RemainingCooldownIntVoidReturns the remaining cooldown, in turns, before a rogue army spawns on the map carrying this book
IsOnCooldownBoolVoidReturns whether the book is currently on cooldown, meaning it has no owner
IsOwnedByContextBoolContextReturns whether the given context object is the owner of this book
IsOwnedByPlayerBoolVoidReturns whether the player faction owns this book
GetForcesAvailableForBookTransferCcoCampaignMilitaryForce (list)VoidGet a list of CcoCampaignMilitaryForce for armies valid for book transfer in this region
EffectBundleContextForFactionCcoEffectBundleCcoCampaignFactionReturns the effect bundle for the book for the given faction
OwningFactionContextCcoCampaignFactionVoidReturns the context for the owning faction for this book if there is one
OwningSettlementContextCcoCampaignSettlementVoidReturns the context for the owning settlement for this book if there is one
OwningForceContextCcoCampaignMilitaryForceVoidReturns the context for the owning military force for this book if there is one
ActiveMissionContextCcoCampaignMissionVoidReturns the CcoCampaignMission context of the active mission for this book
BookRecordContextCcoBooksOfNagashDetailsRecordVoidReturns the books_of_nagash_details record context associated with this object

CcoCampaignBuilding

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsRuinedBoolVoidReturns true if this building is ruined
IsAbandonedBoolVoidReturns true if this building is abandoned
HealthPercentFloatVoidReturns the health percentage of this building
TotalResourceChangeFromEffectsIntStringReturns the total resource change from building effects for the given pooled resource
FoodCostIntVoidReturns an int with the amount of food this building is consuming
DismantleRefundAmountIntVoidReturns the amount of gold this building will give when dismantled
UpkeepCostIntVoidReturns the upkeep cost of the building
MaxHealthIntVoidReturns the maximum health of the building
IsDamagedBoolVoidReturns true if this building is damaged
HealthIntVoidReturns the current health of the building
EffectListContextListVoidReturns a list of effects provided by this building
BuildingCultureVariantRecordContextCcoBuildingCultureVariantRecordVoidReturns the culture variant from the faction that owns this building
BuildingLevelRecordContextCcoBuildingLevelRecordVoidReturns the context of the building level record from this building
LongDescriptionUniStringVoidReturns a long description of the building
ShortDescriptionUniStringVoidReturns a short description of the building
NameUniStringVoidReturns the name of the building
CanUpgradeBoolVoidReturns true if this building can be upgraded
UniqueIdStringVoidReturns the unique identifier of the building

CcoCampaignBuildingLifecycleState

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BuildingCultureVariantRecordContextCcoBuildingCultureVariantRecordVoidReturns the building culture variant of the next building level
SetCanLoopVoidBoolSets the lifecycle to loop or not depending on the value of the bool passed in
CanLoopBoolVoidReturns true if the lifecycle is allowed to loop instead of demolishing the building at the end of the cycle
CanLeaveStateBoolVoidReturns true if the lifecycle can leave the current state
CanEnterNextStateBoolVoidReturns true if the lifecycle can transition to the next state
NextBuildingLevelContextCcoBuildingLevelRecordVoidReturns the building level which is currently in transition
CurrentBuildingLevelContextCcoBuildingLevelRecordVoidReturns the building level whose effects are currently active
TurnsUntilSpecificBuildingIntStringReturns the amount of turns until the lifecycle transitions to the specific building. Returns std::numeric_limits::max() if it never will.
TurnsUntilNextStateIntVoidReturns the amount of turns until the lifecycle transitions to the next building level

CcoCampaignBuildingSlot

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PossibleBuildingChainsListCcoBuildingChainRecord (list)Bool (optional)Returns a list with all the possible building chains that can be constructed in this slot
CanRepairBoolVoidReturns true if this building can be repaired (usually true when this building is damaged)
CanShowOptionsPopupBoolVoidReturns true if this slot can show the option popup that shows if the slot can be repaired, dismantled etc.
TooltipUniStringVoidReturns a tooltip for this slot
RemoveForeignSlotManagerVoidCcoCampaignFaction (optional)Removes the foreign slot manager associated with this slot, if this is a foreign slot. Optional can pass in the faction that wants to remove the manager
InstantUpgradeCostContextCcoCampaignResourceTransactionVoidReturns a CcoCampaignResourceTransaction with the transaction needed to instantly upgrade the building. Returns null is cannot instantly upgrade
PossibleBuildingSetListCcoBuildingSetRecord (list)VoidReturns a list of building sets that could be built in this slot
IsAlliedSlotBoolVoidReturns true if this slot is an allied foreign slot
ShouldShowSlotBoolVoidReturns true if this slot can be currently shown in the ui
UpgradeToFirstAvailableOptionVoidVoidIf this slot can be upgraded, it just constructs the first possible upgrade. This is currently used for outposts where only one building option is available
RepairResourceContextCcoCampaignResourceTransactionVoidReturns the context of the pooled resource needed to repair a the building
PossibleDowngradeListCcoBuildingLevelRecord (list)VoidReturns a list with the possible downgrades in this slot
CancelConstructionVoidBoolCommand that cancels the current construction
ShouldShowCategoriesPopupBoolVoidReturns true if this slot should show the categories popup
IsPortBoolVoidReturns true if this slot is a port
PossibleUpgradeListCcoBuildingLevelRecord (list)Bool (optional)Returns a list of the possible upgrades from this slot. Optional bool parameter to specify whether want all buildable infos
CanShowUpgradeOptionsBoolVoidReturns true if this slot can show a list of its upgrades
IsPrimaryBoolVoidReturns true if this is the main/primary slot
InstantUpgradeVoidVoidCommand that will instantly construct the current construction item
CanAbandonBoolVoidReturns true if this is a region slot and the settlement that owns it can be abandoned
BuildingSlotListCcoCampaignBuildingSlot (list)VoidReturns a list with all the slots that exist on the slot manager
PlayerVariantBuildingChainContextCcoBuildingChainRecordVoidReturns the context of the player variant of the building in this slot
IsEmptyBoolVoidReturns true if there is no building in this slot.
IsActiveBoolVoidReturns true if the slot is active (not locked by primary slot requirement)
IsRegionSlotBoolVoidReturns true if this is a region slot
ConstructVoidCcoBuildingLevelRecordCommand that will construct the building level record passed in
ConstructionItemContextCcoCampaignConstructionItemVoidReturns the context of the construction item (if building is demolishing, constructing etc)
DismantleVoidVoidCommand that will dismantle the current building in the slot
IsForeignSlotBoolVoidReturns true if this is a foreign slot
RepairCostIntVoidReturns an int with how much it costs to repair this building
LifecycleStateContextCcoCampaignBuildingLifecycleStateVoidReturns the context of the lifecycle state, if this slot contains a cyclic building
IsHordeSlotBoolVoidReturns true if this is a horde slot
RemovalCostIntVoidReturns an int with how much it costs to remove the manager associated with this slot. Works only with foreign slots
RepairVoidVoidCommand that will repair the current building in the slot
PrimarySlotContextCcoCampaignBuildingSlotVoidReturns the context of the primary slot from the slot manager, is any exists
CanAffordRepairBoolVoidReturns whether the repairing of this slot can be afforded
IsPartOfCapitalBoolVoidReturns true if this slot is part of capital.
SkavenDiscoverabilityThresholdIntVoidReturns the threshold of the skaven underworld empire being discovered
SettlementContextCcoCampaignSettlementVoidReturns the context of the settlement that owns the slot, if the slot if a region slot or a foreign slot.
CharacterContextCcoCampaignCharacterVoidReturns the context of the character that owns this slot, if any exists
AvailableDevelopmentPointsIntVoidReturns an int with the available development points of the owner of the building
BuildingRequirementsMetBoolCcoBuildingLevelRecordReturns whether all dependent buildings have been built for the provided building level
IsDismantlingBoolVoidReturns true if the building in this slot is being dismantled.
HasConstructedBuildingBoolStringReturns true if the given building has been constructed in this slot
SlotActivateLevelIntVoidReturns the primary slot level when this slot will get unlocked
BuildingContextCcoCampaignBuildingVoidReturns the context of the building on this slot, if it has any
IsConvertingBoolVoidReturns true if the building in this slot is being converted.
IsUpgradingBoolVoidReturns true if the building in this slot is being upgraded.
PossibleUpgradeChainListCcoBuildingChainRecord (list)VoidReturns a list with the possible upgrade chains in this slot.
CanAffordInstantUpgradeBoolVoidReturns true if can afford to instantly construct in this slot
IndexIntVoidReturns an int with the index of this slot in the slot list
IsRepairingBoolVoidReturns true if the building in this slot is being repaired
ForeignSlotSetKeyStringVoidReturns the String key of this BuildingSlot's Foreign Slot Manager slot_set record, if applicable; otherwise returns an empty string.
FactionContextCcoCampaignFactionVoidReturns the context of faction that owns this slot
HasInstantUpgradeFeatureBoolVoidReturns true if this building slot has the feature to be instantly constructed
PossibleUpgradeWithoutConversionsListCcoBuildingLevelRecord (list)VoidReturns a list with the possible upgrades in this slot, without any conversions.
SlotTemplateKeyStringVoidReturns the String key of this BuildingSlot's SLOT_TEMPLATE_RECORD.
IsBuildingNewBoolVoidReturns true if there is a new building being built in this slot
CanRemoveForeignSlotManagerBoolVoidReturns true if the foreign slot manager associated with this slot can be removed, or if there isn't any.
PossibleUpgradeOnlyConversionsListCcoBuildingLevelRecord (list)Bool (optional)Returns a list with the possible conversions in this slot
PooledResourceDemolishTooltipUniStringVoidReturns a tooltip for when demolishing recoups pooled resources
CanConvertBoolVoidReturns true if the building in this slot can be converted to another building
SkavenDiscoverabilityFactorialListCcoStringValue (list)CcoCampaignFactionReturns a list of factors that affected the skaven discoverability
CanUpgradeBoolVoidReturns true if the building in this slot can be upgraded.
ForeignSlotDiscoveredByFactionBoolCcoCampaignFactionReturns true if this foreign slot has been discovered by the faction passed in
IsPlayerFactionBoolVoidReturns true if this slot is owned by the player faction
RepairCostTooltipUniStringVoidReturns a tooltip with the cost to repair the building
CanDismantleBoolVoidReturns true if the building in this slot can be dismantled

CcoCampaignBuildingVariant

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OnscreenNameVoidVoid
BuildingLevelContextVoidVoid
OnscreenNameKeyVoidVoid
MaxLevelVoidVoid
LevelVoidVoid
CulturalVariantKeyVoidVoid
KeyVoidVoid
FactionKeyVoidVoid
InfoFilenameVoidVoid
IconFilenameVoidVoid
LongDescriptionVoidVoid
ShortDescriptionVoidVoid

CcoCampaignCaravan

Wrapper for a campaign caravan

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsReserveBoolVoidReturns true if this is a reserve caravan
SetStartingNodeVoidCcoCampaignRouteNodeSets the starting node for this caravan
DestinationNodeContextCcoCampaignRouteNodeVoidReturns a CcoCampaignRouteNode context with the destination node choice of the player
StartingNodeContextCcoCampaignRouteNodeVoidReturns a CcoCampaignRouteNode context with the starting node choice of the player
ChangePathSegmentVoidCcoCampaignRouteSegment, CcoCaravanContractRecord (optional)Changes the current path to include the segment passed in an updates the rest of the path to make sure it's valid
ContractContextCcoCaravanContractRecordVoidReturns a CcoCaravanContractRecord with the current contract for this caravan, if any
CharacterContextCcoCampaignCharacterVoidReturns a CcoCampaignCharacter with the character that owns the caravan
CurrentNodeContextCcoCampaignRouteNodeVoidReturns a CcoCampaignRoute node context where the caravan is currently positioned
TravelledPathNodeListCcoCampaignRouteNode (list)VoidReturns the a list of nodes that the caravan has already traversed
PathNodeListCcoCampaignRouteNode (list)VoidReturns the a list of nodes that the caravan will transverse next
PositionVector4VoidReturns the current display position of the caravan
IsReturningBoolVoidReturns true if the caravan has already reached its destination and is now returning back to the starting point
BestJourneyTimeForNodeIntCcoCampaignRouteNodeTime it takes to reach this node from destination if we take the best route
MaximumCargoIntCcoCaravanContractRecordMaximum cargo for the caravan and passed in contract
TurnsUntilReturnIntVoidReturns the turns until the caravan goes back to the starting point, this will only be > 0 after the caravan reaches its destination
CargoAmountIntVoidReturns the amount of cargo that this caravan currently has
ClearStartingPathVoidVoidClears the starting path of the caravan
SetAutoPathTowardsNodeVoidCcoCampaignRouteNode, CcoCaravanContractRecord (optional)Sets the caravan path towards the node passed in, if it's possible

CcoCampaignCaravanRecruitmentItem

Wrapper for a campaign FACTION_CARAVANS struct

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecruitmentRankIntVoidReturns the rank at which this caravan master will be spawned
RecruitmentCostIntVoidReturns the cost to recruit this caravan master
CharacterContextCcoCampaignCharacterVoidReturns the caravan master character context

CcoCampaignChaoticPlan

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetBagTokenTypesContextsCcoChaoticPlanTokenTypeRecord (list)VoidReturns a list of the token type contexts in the bag
GetPositivePoolTokensAvailableForDrawCcoChaoticPlanTokenRecord (list)VoidReturns the record contexts of all the positive pool tokens that are available for draw.
GetNumberOfUnitsInTheSchemerArmyIntVoidGet Number of Units in the plan's schemer army.
GetPlanTokenTypesContextsCcoChaoticPlanTokenTypeRecord (list)VoidReturns a list of the token type contexts in the plan
GetAmountOfPlanTypeTokensIntCcoChaoticPlanTokenTypeRecordReturns the amount of tokens of a certain type that exist in the entirety of the plan
ClearNewlyDrawnTokensVoidVoidClears all the temporarily stored newly drawn token ids.
GetAllPositivePoolTokensCcoChaoticPlanTokenRecord (list)Bool (optional)Returns the record contexts of all the positive pool tokens.
ChaoticPlanRecordContextCcoChaoticPlanRecordVoidReturns the Chaotic plan record context of the plan being performed
GetMaxRemainingTokenAddsForPlanIntVoidReturns the amount of tokens that can be added to the current plan in this turn
GetExecuteBlockReasonIntVoidReturns the reason why the plan cannot be executed, 0 if it can be executed.
IsNewlyDrawnTokenBoolCcoCampaignChaoticPlanTokenReturns if the token is newly drawn in order to display reveal animation.
ChaoticPlanSettlementContextCcoCampaignSettlementVoidReturns the Settlement context of the settlement of the region the plan takes place in
GetAllDrawnTokensOfTokenTypeCcoCampaignChaoticPlanToken (list)String, CcoComponentReturns all the token contexts of drawn tokens from a specific type present in the plan
CanExecuteBoolVoidReturns true if the plan can be executed, false otherwise.
GetAllAvailableTokensForPlanCcoChaoticPlanTokenRecord (list)VoidReturns the available tokens for the plan.
GetAmountOfDrawnPreselectedTokensFromRecordIntCcoChaoticPlanTokenRecordReturns the total amount of drawn tokens of a specific record in the plan if that token is a preselected token
ChaoticPlanSchemerSpecialInfoContextCcoChaoticPlanSchemersSpecialInfoRecordVoidReturns the special info context for the schemer used in the plan
GetRiskPctFromDrawnTokensIntVoidReturns the pct chance to draw negative tokens when a positive token is introduced in the plan given by the drawn tokens in the plan.
ChaoticPlanSchemerContextCcoCampaignCharacterVoidReturns the Character context of the schemer used in the plan
ToggleSelectedAbilityTokenVoidCcoChaoticPlanTokenRecordToggles the selected state of an ability selectable tokens, for abilities that allow you to select replacement tokens.
GetAmountOfDrawnTokensFromRecordIntCcoChaoticPlanTokenRecordReturns the total amount of drawn tokens of a specific record in the plan
GetRiskPctFromSchemerAndFactionIntVoidReturns the pct chance to draw negative tokens when a positive token is introduced in the plan given by schemer and faction bonuses (usually negative).
GetSelectedTokensFromAbilitySetSizeIntVoidReturns the amount of selected tokens in the ability tokens list, for abilities that allow you to select replacement tokens.
GetPlanTokensSizeIntVoidReturns the total amount of tokens in the plan
FactionContextCcoCampaignFactionVoidReturns the Faction context of the faction performing the plan
GetRiskPctFromSettlementIntVoidReturns the pct chance to draw negative tokens when a positive token is introduced in the plan given by the settlement and base bonuses.
GetPlanFlavorTextTurnSectionsCcoCampaignChaoticPlanFlavorTextTurnSection (list)VoidReturns a list of the token flavor texts separated by sections depending on the turn the tokens were drawn
GetBagTokensSizeIntVoidReturns amount of tokens in the bag
GetModifiedRewardsPctFromPlanStateIntIntReturns the value of a resource reward modified by the plan state
GetMaxPinnedTokensSizeIntCcoCampaignChaoticPlanInventoryTokenReturns the max amount of pinned tokens allowed for the plan
GetChanceToDrawNegativeTokenIntVoidReturns the pct chance to draw negative tokens when a positive token is introduced in the plan.
GetUnitsAfterRemovalCcoCampaignUnit (list)VoidReturns the schemer units remaining after removing from tokens.
GetPinnedTokensSizeIntVoidReturns the amount of pinned tokens
GetPlanAlarmThresholdIntVoidReturns the alarm threshold for chaotic plans
GetDrawnTokensFilteredPayloadInfoCcoCampaignPayloadInfoEntry (list)CcoCampaignFactionReturns filtered payload infos for displaying as rewards
GetAllUniqueDrawnTokensCcoChaoticPlanTokenRecord (list)VoidReturns the record contexts of all the unique drawn tokens (no duplicates)
GetAmountOfTokensDrawnOnNextTurnIntVoidThe amount of tokens that will be drawn in the next turn
AbilityAllowsPinningTokenOfTypeBoolCcoCampaignChaoticPlanInventoryToken, CcoChaoticPlanTokenRecordChecks if this type of token can be pinned for use in the provided ability
IsTokenAvailableInPositivePoolBoolCcoChaoticPlanTokenRecordReturns true if the token is available for draw in the positive tokens pool.
GetAllDrawnTokensCcoChaoticPlanTokenRecord (list)VoidReturns the record contexts of all the drawn tokens
GetPositiveTokenPctToDrawIntCcoChaoticPlanTokenRecordReturns the pct chance a positive token has to be drawn in the plan, return 0 if used on any other type of token.
PlanPayloadsManagerContextCcoCampaignChaoticPlanPayloadsManagerVoidReturns the context of the Payloads manager used in the plan
GetPlanNameUniStringVoidReturns localized name of the plan, which is set by the player
GetPlanRegionNameUniStringVoidReturns the key of the region in which the plan is taking place in a string
RemoveAllDrawnTokenPinsVoidVoidRemoves the pins from all the drawn tokens of the plan
GetTurnsUntilTriggerUnlockIntVoidReturns turns until the plan can be triggered.
GetAmountOfDrawnTypeTokensIntCcoChaoticPlanTokenTypeRecordReturns the amount of tokens of a certain type that are drawn
GetPreselectedTokensCcoChaoticPlanTokenRecord (list)VoidReturns the record contexts of all preselected tokens.
GetDrawnTokenTypesContextsCcoChaoticPlanTokenTypeRecord (list)VoidReturns a list of the token type contexts in the drawn tokens
GetPositivePoolTokensUnavailableForDrawCcoChaoticPlanTokenRecord (list)VoidReturns the record contexts of all the positive pool tokens that are unavailable for draw.
GetAmountOfBagTypeTokensIntCcoChaoticPlanTokenTypeRecordReturns the amount of tokens of a certain type that exist in the bag of the plan

CcoCampaignChaoticPlanFlavorTextTurnSection

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetPlanFlavorTextLogListCcoString (list)VoidReturns a list of formated unistrings composing the flavor text log for this turn section
SectionTurnDisplayNumberIntVoidReturns the distance in turns from the current turn that this section turn log maps

CcoCampaignChaoticPlanInteraction

Class that manages targeting interface interaction for a chaotic plan

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SetTargetVoidContextSets the target to the object passed in
ClearTargetVoidVoidClears the currently stored target
ToggleTargettingVoidVoidToggles the targeting system through the CampaignTargettingInterface.
EnableTargettingVoidBoolIs passed true, enables this as the targeting interface, else disables it.
ZoomToTargetVoidVoidZooms to the stored target
IsValidTargetBoolContextReturns true if the passed in object is a valid target
IsTargettingActiveBoolVoidReturns true if this is the currently active targeting interface
InvalidReasonsForTargetUniStringContextReturns the reasons why the passed in target is invalid. Returns empty string if valid
IsContextTargetedBoolContextReturns whether the given context is targeted. (Allows child classes to add unique targeting conditions)
CurrentTargetContextContextVoidReturns the context of the current target, if any has been set

CcoCampaignChaoticPlanInventoryToken

Wrapper for a Chaotic plan inventory token

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UsesLeftIntVoidReturns remaining uses of the token
HasBagPriceBoolVoidReturns whether the token has a bag price
CanUseBoolCcoCampaignChaoticPlanReturns if the token can be used in the specified plan
IsAbilityWithSelectableTokensBoolVoidReturns true if the ability contains a payload that allows you to select replacement tokens to replace the pinned ones.
GetAbilityTokenReplacementPayloadTokenContextsCcoChaoticPlanTokenRecord (list)VoidReturns a list of token record contexts that are available for targeting
BagPricePooledResourceCostsListCcoCampaignPooledResourceTransaction (list)CcoCampaignChaoticPlanReturns the pooled resources bag price of the token
BagPriceTreasuryCostAbsoluteIntCcoCampaignChaoticPlanReturns the absolute treasury bag price of the token
BagPriceTreasuryCostIntCcoCampaignChaoticPlanReturns the treasury bag price of the token
IsTokenTargetingAbilityBoolVoidReturns if the token has a token targeting payload.
TokenRecordContextCcoChaoticPlanTokenRecordVoidReturns the record context for this token type
CooldownRemainingIntVoidReturns remaining turns on cooldown for the token

CcoCampaignChaoticPlanPayloadsManager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AvailableThresholdSetListForResourceCcoPooledResourceThresholdOperationSetRecord (list)StringReturns a list of available threshold sets, which have a range that confers effects and armory items
IsUnitPlannedForRemovalBoolCcoCampaignUnitReturns if the unit is planned to be removed by guards and elites
AccumulatedPooledResourceIntStringReturns the amount of a pooled resource accumulated from payloads if the plan was to be executed now
AccumulatedTreasuryRewardsIntVoidReturns the amount of treasury rewards given if the plan was to be executed now
ChaoticPlanRecordContextCcoChaoticPlanRecordVoidReturns the Chaotic plan record context of the plan being performed
FactionContextCcoCampaignFactionVoidReturns the Faction context of the faction performing the plan
ActiveThresholdSetListForResourceCcoPooledResourceThresholdOperationSetRecord (list)StringReturns a list of active threshold sets, which have a range that confers effects and armory items

CcoCampaignChaoticPlanShopObject

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ApplicableChaoticPlanRecordsListCcoChaoticPlanRecord (list)VoidReturns all the plan records that the object's token can be used on
BuyVoidVoidBuy the token associated with the object
OwnedTokensCountFromSameCategoryIntVoidReturns the number of already owned tokens types of the same category
OwnedCountIntVoidReturns the number of already owned tokens of the object's type
IsHigherOrderOwnedBoolVoidChecks whether the player already owns an object of a higher order than this one
CanAffordBoolVoidChecks whether the player can afford the cost of the object
IsAllowedToBuyBoolVoidChecks whether the object is allowed for buying - it might not be if for example the ownership limit has been reached
IsUnlockedBoolVoidChecks whether the object is unlocked for buying
RecordContextCcoChaoticPlanShopCategoryObjectRecordVoidReturns the shop category object record context associated with this object

CcoCampaignChaoticPlanShopObjectChain

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RemainingShopObjectsListCcoCampaignChaoticPlanShopObject (list)VoidReturns an ordered list of the remaining shop objects in this chain
GetFirstChainObjectCcoCampaignChaoticPlanShopObjectVoidReturns the first object of this chain that should be available in the shop
GetCurrentlyAvailableToBuyObjectCcoCampaignChaoticPlanShopObjectVoidReturns an object of this chain that is available to buy
ShopObjectsListCcoCampaignChaoticPlanShopObject (list)VoidReturns an ordered list of the shop objects in this chain
IsAnyObjectAvailableToBuyBoolVoidReturns whether any object of this chain is available to buy
RemainingShopObjectTokenRecordsListCcoChaoticPlanTokenRecord (list)VoidReturns an ordered list of the shop objects' token records that remain in this chain

CcoCampaignChaoticPlanToken

Wrapper for a Chaotic plan token (in inventory/bag/drawn)

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TogglePinnedVoidVoidToggles the pin on a token
IsPinnedBoolVoidReturns if the token is pinned
GetDrawnTokenBoardPositionIdIntVoidReturns the token's position on the board in the relative color column
TokenRecordContextCcoChaoticPlanTokenRecordVoidReturns the token record context for the specific drawn token

CcoCampaignChaoticPlanTokenInventory

Wrapper for a Chaotic plan inventory of tokens

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetTokenCooldownRemainingIntIntReturns the cooldown remaining on the token

CcoCampaignChaoticPlansManager

A Cco used to handle Chaotic Plans managing for a faction!

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetShopObjectChainContextsCcoCampaignChaoticPlanShopObjectChain (list)CcoChaoticPlanShopCategoryRecordReturns all the currently available shop object chain contexts for the given category.
GetSchemerStartingTokensFromBackgroundTraitCcoChaoticPlanTokenRecord (list)CcoCampaignCharacterReturns the starting tokens for a schemer in a plan, which are the tokens they will have in the bag when the plan starts from their background trait.
GetSchemerRemainingCooldownIntIntReturns the remaining cooldown of the schemer with the given cqi, or 0 if they are not on cooldown.
HasTurnBlockingPlansBoolVoidReturns true if there are any turn blocking plans
GetAvailableSchemersSpecialInfosCcoChaoticPlanSchemersSpecialInfoRecord (list)VoidReturns the available schemers special info record contexts.
GetSchemerStartingTokensForPlanCcoChaoticPlanTokenRecord (list)CcoChaoticPlanRecord, CcoCampaignCharacterReturns the starting tokens for a schemer in a plan, which are the tokens they will have in the bag when the plan starts.
GetShopCategoryRecordCcoChaoticPlanShopCategoryRecordStringReturns a specific shop category record.
GetAvailableSchemersCcoCampaignCharacter (list)VoidReturns the available schemer character contexts.
DevUnlockMagicPlanTypeFromNarrativeVoidCcoCampaignFaction, CcoChaoticPlanTokenRecordCheat that unlocks a magic plan type
GetActiveChaoticPlansCcoCampaignChaoticPlan (list)VoidReturns all the active chaotic plans
GetShopCategoryRecordsCcoChaoticPlanShopCategoryRecord (list)VoidReturns all the available shop category records, ordered by the schemer order in the schemer special infos table. Thanquol's category is always last.
CanAffordPlanFromSetupBoolVoidReturns true if the faction can afford the currently selected plan.
DevUnlockSchemerVoidIntCheat that unlocks a schemer
AddTokensToChaoticPlanVoidCcoCampaignChaoticPlan, CcoComponent, CcoComponent (optional)Adds a list of inventory tokens to the bag tokens
CalculateMaxSchemersCountIntVoidReturns the maximum number of schemers the faction can have.
StartPlanCostRecordContextCcoResourceCostRecordVoidReturns the resource cost record context for the currently selected plan.
DevOverrideTurnTriggerUnlockVoidCcoCampaignChaoticPlanCheat that allows to override the turn trigger requirements for a plan
UseAbilityTokenInChaoticPlanVoidCcoCampaignChaoticPlan, CcoCampaignChaoticPlanInventoryToken, CcoComponentUse an ability token's payloads in an active plan.
GetAliveSchemersCountIntVoidReturns the number of alive schemers the faction has.
GetPlanForSchemerCcoCampaignChaoticPlanCcoCampaignCharacterReturns the active plan for a schemer.
DevUnlockAllPlanTypesVoidVoidCheat that unlocks all chaotic plan types
GetSelectableTokensForResourceActivatedGroupCcoChaoticPlanTokenRecord (list)VoidReturns a list of the selectable token record contexts for the current plan setup and the currently selected token group
GetSelectedSchemerSpecialInfoFromSetupCcoChaoticPlanSchemersSpecialInfoRecordVoidReturns the currently selected schemer's special info.
HasNotificationThisTurnBoolVoidReturns true the faction has active plans that need attention in this turn
AbandonChaoticPlanVoidCcoCampaignChaoticPlanAbandons the plan that is in progress
GetSelectableTokensForSetupCcoChaoticPlanTokenRecord (list)VoidReturns a list of the selectable token record contexts for the current plan setup
GetSelectedSchemerFromSetupCcoCampaignCharacterVoidReturns the currently selected schemer.
ExecuteChaoticPlanVoidCcoCampaignChaoticPlanExecutes the plan with its current progress
IsMagicPlanTypeUnlockedFromNarrativeBoolCcoCampaignFaction, CcoChaoticPlanTokenRecordReturn whether the magic plan type is unlocked from the narrative for a schemer.
CanUseAbilityTokenInChaoticPlanBoolCcoCampaignChaoticPlan, CcoCampaignChaoticPlanInventoryToken, IntReturns true if the target ability token can be triggered
GetSelectedChaoticPlanTypeFromSetupString (list)VoidReturns the currently selected plan type.
CleanupChaoticPlanFromSetupVoidVoidAttempts to remove the setup of a new plan from the plans manager
GetNumberOfAvailableMagicPlansForSelectedSchemerIntVoidReturns the number of magic plans the schemer can perform
IsSchemerUnlockedBoolIntReturn whether the Schemer has been unlocked for use.
GetAvailableInventoryTokensCcoCampaignChaoticPlanInventoryToken (list)CcoChaoticPlanRecordReturns all the contexts of non ability tokens that the faction has in their inventory
CanStartChaoticPlanFromSetupBoolVoidReturns true if the chaotic plan setup for this faction is ready.
GetOwnedTokensCountForCategoryIntCcoChaoticPlanShopCategoryRecordReturns the number of owned tokens from the input category record for the faction
CreateChaoticPlanFromSetupVoidUniStringAttempts to create a new plan in the region provided
CanAffordAddingTokenToPlanBoolCcoComponent, CcoCampaignChaoticPlanInventoryToken, CcoCampaignChaoticPlanReturns true if the faction can afford to add the specified token and all other currently selected tokens to the specified plan.
IsPreselectedTokenPlanLockedForSelectedSchemerBoolCcoChaoticPlanTokenRecordWill return true if the preselected token can be selected by the schemer that has been selected for the plan
SchemerBesiegedSettlementContextCcoCampaignSettlementIntReturns the settlement context for the settlement currently besieged by the schemer with the given cqi, or null if they are not besieging a settlement.
GetAvailableInventoryAbilitiesCcoCampaignChaoticPlanInventoryToken (list)CcoCampaignChaoticPlanReturns all the token contexts of ability tokens that the faction has in their inventory
CheatTestMilitaryPlanVoidVoidTest a mock military plan
CanSelectTokensForSetupBoolVoidReturns true if the chaotic plan setup for this faction is in a state ready to select tokens, if that is needed.
IsRegionEligibleForChaoticPlanBoolIntReturns true if the region can host a plan
AddPreselectedTokenVoidCcoChaoticPlanTokenRecordAdd a token to the selected ones in a chaotic plan setup.
GetChaoticPlanContextForSettlementCcoCampaignChaoticPlanCcoCampaignSettlementReturns s a pointer to the Cco of a plan that is executed in the region or null
GetRemainingSchemerBesiegingTurnsIntIntReturn the remaining turns until the siege will be automatically lifted by the Schemer.
IsPreselectedTokenAGroupBoolCcoChaoticPlanTokenRecordWill return true if the preselected token is owner of a group of preselected sub tokens
DevAddTokenToBoardVoidCcoCampaignChaoticPlan, CcoChaoticPlanTokenRecordCheat that adds the selected inventory token to the board.
IsSchemerCurrentlyBesiegingBoolIntReturns true if the supplied schemer is currently besieging.
IsShopPlanTypeFilterEnabledBoolStringWill return true if the shop filter of a given plan is active
ChaoticPlanInteractionContextCcoCampaignChaoticPlanInteractionVoidReturns the CampaignTargettingInterface extension of the plans that allows Region Targeting interaction in the 3d map
DevRemoveTokenFromBoardVoidCcoCampaignChaoticPlan, CcoCampaignChaoticPlanTokenCheat that removes the selected drawn token from the plan.
SelectChaoticPlanSchemerVoidIntSelect the schemer for the impending chaotic plan creation.
IsSchemerCurrentlyInActivePlanBoolIntReturns true if the supplied schemer is currently in an active plan.
FactionContextCcoCampaignFactionVoidReturns the Faction context of the faction attempting to perform actions on a plan or start a new one
RemoveShopFiltersVoidVoidWill remove all of the shop active filters
DevResetSchemerCooldownVoidIntCheat that resets the cooldown of the supplied Schemer lord.
SelectChaoticPlanRecordTypeVoidStringSelect the chaotic plan record type for the impending chaotic plan creation.
ToggleShopPlanTypeFilterVoidStringWill toggle the provided filter selection in the list of the shop active filters
DevAddAllShopTokensVoidVoidCheat that adds all the tokes from the shop to the faction performing the plan.
IsChaoticPlanUnlockedBoolCcoChaoticPlanRecordChecks whether the given type of plan is unlocked.
GetRegionPlansRemainingCooldownIntIntReturns the remaining cooldown of the region with the given cqi, or 0 if there is no cooldown.
RecruitWoundedSchemerVoidCcoCampaignCharacter, CcoCampaignFactionAttempts to recruit a wounded schemer

CcoCampaignCharacter

Component context wrapper for a campaign character

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PlagueCompositionContextCcoCampaignPlagueCompositionVoidReturns a CcoCampaignPlagueComposition with the plague composition of this character, if any
FactionFlagRotatedStringVoidReturns the filepath for rotated faction flag. PREFER to use FactionFlagDirdeprecated
IsOnLandBoolVoidReturns true if this character is currently positioned on land and not sea
TeleportationSystemContextCcoCampaignCharacterTeleportationSystemVoidReturns a CcoCampaignCharacterTeleportationSystem that manages the character interacting with the teleportation network system
DevRankUpVoidVoidRanks up the characterdebug, hide_in_uied
CanUseAncillaryCategoryBoolCcoAncillariesCategoryRecordReturns true if this character can use the ancillary category passed in.
HordeSnapshotBuildingListCcoBuildingLevelRecord (list)VoidReturns a list with all the buildings that the horde of this general will get back on resurrection.
UpkeepIntVoidReturns the cost to maintain this character per turn (if army this is for whole army not just the individual)
CanOpenDetailsAndIsChaoticPlanSchemerBoolVoidReturns true if character details can be opened for this character and the character is a chaotic plan schemer
FactionFlagLargeStringVoidReturns the filepath for large faction flag. PREFER to use FactionFlagDirdeprecated
IsOnScreenBoolVoidReturns true if this character is currently on screen
IsWoundedBoolVoidReturns true if this character is wounded
AutoManagementContextCcoCampaignCharacterAutoManagementVoidReturns a CcoCampaignCharacterAutoManagement that handles auto management logic for this character
ArmoryItemRecordListCcoArmoryItemRecord (list)VoidReturns a list with all the armory item records that are registered to this character.
NextLevelThresholdIntVoidReturns the raw threshold level CurrentXP needs to be to reach next rank
ZoomToVoidVector4 (optional)Zooms camera to this character. Can optionally provide an offset for the zoom.
CanOpenDetailsBoolVoidReturns true if character details can be opened for this character
FactionFlagMediumStringVoidReturns the filepath for medium faction flag. PREFER to use FactionFlagDirdeprecated
ToggleMultipleInitiativesFromSetsVoidContextListToggles a list of initiatives which can come from multiple sets.
IsPlayerCharacterBoolVoidReturns true if this character belongs to the player
ProvinceContextCcoCampaignProvinceVoidReturns a CcoCampaignProvince with the province the character is in (if any - they could be at sea))
CurrentXpIntVoidReturns the current raw xp value
ArmoryItemVariantListCcoCampaignArmoryItemVariant (list)VoidReturns a list with all the armory item variants that are registered to this character.
FactionFlagSmallStringVoidReturns the filepath for small faction flag. PREFER to use FactionFlagDirdeprecated
IsAliveBoolVoidReturns true if this character is alive
IsColonelBoolVoidReturns true if this character is a colonel (temporary general until general replaced on players next turn)
SeaRegionContextCcoCampaignModelSeaRegionVoidReturns a CcoCampaignModelSeaRegion with the sea region the character is in (if any - they could be on land))
RankIntVoidReturns the current rank level
InitiativeSetListCcoCampaignInitiativeSet (list)VoidReturns list of CcoCampaignInitiativeSet available to character
IsInMotionBoolVoidReturns true if character is currently moving
CanBeLoadedInCampaignBoolVoidReturns true if character can be loaded in campaign and false if can only be loaded in custom battle
CharacterTypeIconPathStringVoidReturns the character type icon path
CostForMultipleInitiativesFromSetsCcoCampaignResourceTransactionContextListGets the cost of initiatives which can come from multiple sets.
IsFactionLeaderBoolVoidReturns true if this character is a faction leader
FamilyMemberCQIIntVoidReturns the unique command queue index of the family member
RegionContextCcoCampaignModelRegionVoidReturns a CcoCampaignModelRegion with the region the character is in (if any - they could be at sea))
IsAgentBoolVoidReturns true if this character is an agent
HiddenSkillListCcoCampaignCharacterSkill (list)VoidReturns a list of CcoCampaignCharacterSkill that are hidden to the UI
ToggleIgnoreFromEndTurnNotificationsVoidVoidToggles adding or removing the character from the end turn notification ignore list based on whether it's already in the list or not
IsSaveableBoolVoidReturns true if character can be saved as part of persistent character feature (so can load in other campaigns or custom battle)
CategoryIconPathStringExpressionStateReturns the unit category icon path
IsGarrisonedBoolVoidReturns true if this character is garrisoned
SavedDanceCcoEternalDanceInstanceDataVoidReturns the dance saved in the repertoire of the character, or the faction (if the character has none)
IsGarrisonCommanderBoolVoidReturns true if this character is the commander of a settlement garrison
SelectedDanceCcoEternalDanceInstanceDataVoidReturns the current selected dance by the character. I.e. the current active exclusive INITIATIVE_SET_CATEGORY_RECORD* if applicable.
IsArmyBoolVoidReturns true if this character is a general of an army
CQIIntVoidReturns the unique command queue index of the character
SkillListCcoCampaignCharacterSkill (list)VoidReturns list of CcoCampaignCharacterSkill that are available to a character (regardless of current state)
FamilyMemberSharedStateReadStringStringStringTakes a String id, and returns stored string value in shared state for this character's family member with that key. Value will be empty if doesnt exist in registry.registry
TransportedInMilitaryForceContextCcoCampaignMilitaryForceVoidReturns a CcoCampaignMilitaryForce with the force in which this character is part of (useful for getting force that an agent is part of)
TurnsLockedInLimboIntVoidReturns the number of turns that the character will be locked in limbo. E.g. Packed up ogre camps stay in limbo for a number of turns.
ImageCardPathStringVoidReturns portrait image path used on unit cards
CanOpenCharacterDetailsBoolVoidReturns true if the character can open the character details
CanRenameBoolVoidReturns true if this character can be renamed (immortal characters cannot be renamed for example)
CaravanContextCcoCampaignCaravanVoidReturns the CcoCampaignCaravan associated with this character if it exists
ChaosRealmTraitsListCcoCharacterTraitLevelRecord (list)VoidReturns list of CcoCampaignTrait that this character has that were gained in the chaos realms, these are highlighted in the UI in different ways
ActorVOIntVoidReturns the actor vo id
ActionPointPreviewPercentFloatVoidReturns the previewed action point percent for when previewing stance change or potential move (0-1)
HighlightCharacterVoidBoolHighlights the character applying a visual effect to model on campaign (pass true to highlight, false to disable highlight)
FamilyMemberSharedStateReadBoolBoolStringTakes a String id, and returns stored bool value in shared state for this character's family member with that key. Value will be false if doesnt exist in registry.registry
PortraitPathStringVoidReturns portrait image path used on portholes
RemainingTravelTimeIntVoidReturns the remaining travel time of a character
IsPoliticianBoolVoidReturns true if the character is a politician
IsInLimboBoolVoidReturns true if character is in limbo
GovernorshipInteractionContextCcoCampaignGovernorshipInteractionVoidReturns the CcoCampaignGovernorshipInteraction for governor related queries/commands
RenameVoidVoidBrings up a dialog to rename this character
HasUncommitedSkillsBoolVoidReturns true if this character has skill choices made but not committed (clicked on skills but not applied by closing screen for example)
IsLoanedBoolVoidReturns true if the character is loaned
FactionFlagDirStringVoidReturns directory faction flag images live in. Use this instead of getting from faction so works correctly for rebels
ActionPointPercentFloatVoidReturns the remaining action point percent (0-1)
CharacterTypeNameUniStringVoidReturns localised character type (general, agent type, faction leader, etc)
FamilyMemberSharedStateReadFloatFloatStringTakes a String id, and returns stored float value in shared state for this character's family member with that key. Value will be -1 if doesnt exist in registry.registry
UnitDetailsContextCcoUnitDetailsExpressionStateReturns the CcoUnitDetails for unit for use on unit info panel that shows unit stats from various sources
SelectSkillChoiceVoidCcoCampaignCharacterSkillSelects the specified skill ready to be committed
TraitsListCcoCharacterTraitLevelRecord (list)VoidReturns list of CcoCampaignTrait that this character has
CanCharacterRankUpBoolVoidReturns true if this character can currently rank up
SkillPointsAvailableIntVoidReturns the current amount of skill points have to spend
IsVisibleBoolVoidReturns true if character visible to player on map (not shrouded, hidden, etc)
IsEffectBundleActiveBoolStringReturns true if specific effect bundle is active on the character
DescriptionUniStringVoidReturns localised description of the character
UnitContextCcoCampaignUnitVoidReturns the CcoCampaignUnit if this character has one (if commander in army, or agent embedded in army)
ClearAllSkillChoicesVoidVoidClears all skill choices currently made
DevReplenishApVoidVoidReplenishes action points to be fulldebug, hide_in_uied
CurrentXpPercentFloatVoidReturns the current XP progress percent to next level (0-1)
ShouldShowOnRadarBoolBool (optional)Returns true if should show on radar/radar lists, this handles all special cases of things we dont want to show like garrisons, etc. By default filters convalescing characters, but pass true in to not do that
FamilyMemberSharedStateValueExistsBoolStringTakes a String id, and returns if there's any state stored for this character's family member with that key.registry
CanAffordMovePreviewBoolVoidReturns true if can afford to perform the current movement preview
UnitListCcoCampaignUnit (list)VoidReturns list of CcoCampaignUnit in this characters force
IsClosestToSettlementBoolCcoCampaignSettlementReturns true if the supplied settlement is the one closest to character; which in itself is true if character is on land region of this settlement, or if the character is on a sea region that is the closest one neighboring the settlement.
ClearSkillChoiceVoidCcoCampaignCharacterSkillClears specified skill choice currently made
FactionNameWithIconUniStringVoidReturns the factions localised name with icon (use this instead of getting from faction so works correctly with rebels)
BreakForDebuggingVoidVoidBreaks into debugger so can inspect internal object in greater detaildebug, hide_in_uied
AgentSubtypeRecordContextCcoAgentSubtypeRecordVoidReturns the CcoAgentSubtypeRecord
HasChaoticPlanSchemerForceBoolVoidReturns true if this character is a chaotic plans schemer (has a force of the schemer type)
EnterLimboVoidVoidMove character to limbo or out of limbo)
IsPreviewingMoveBoolVoidReturns true if currently previewing where to move for this character (holding right click down on map with character selected)
AncillaryListCcoCampaignAncillary (list)VoidReturns list of equipped CcoCampaignAncillary
IsAtSeaNearPortSettlementBoolFloatReturns true if the character is at sea near a port settlement.
TintColourColourVoidReturns the colour tint of the character, in wh3 this is used for daemon prince based on equipment select and alignment to gods
ResetAllSkillsVoidVoidResets all skills for this character and wounds them for a short period
FactionNameUniStringVoidReturns the factions localised name (use this instead of getting from faction so works correctly with rebels)
IsSelectedBoolVoidReturns true if this character is selected
AgentRecordContextCcoAgentRecordVoidReturns the CcoAgentRecord
IsGovernorBoolVoidReturns true if this character is governing a province
DevKillVoidVoidKills the character, useful for dev purposes (NOTE: doesnt kill the force, use CcoCampaignMilitaryForce::DevKill for that)debug, hide_in_uied
SubterfugeLevelIntVoidReturns the subterfuge level
PositionVector4VoidReturns the position on the map, will be VECTOR_4_ZERO if not not on map
CanUseApBoolVoidReturns true if the character can use action points. Ex. Caravans and Ogre Camps can't use
BackgroundSkillContextCcoCampaignCharacterSkillVoidReturns to CcoCampaignCharacterSkill for the characters single background skill they start with
CommitSkillChoicesVoidVoidCommits skills choices currently made
IsOnMapBoolVoidReturns true if this character is currently on the map
SelectAndZoomVoidBool (optional)Selects and zooms to this character. Plays character selection voice line. Pass false to not play VO.
IsDetailsOnlyBoolVoidReturns true if we don't have a ptr to a CHARACTER object which means character is basically dead or doesnt exist yet, so has no live information such as map info, etc
EffectBundleUnfilteredListCcoEffectBundle (list)VoidReturns list of active CcoEffectBundle, without any filtering (so includes those that dont show in the UI)hide_in_uied
NameUniStringVoidReturns the localised name
SkillTreeTreeDataVoidReturns the skill tree data for creating a skill tree
AuthorityLevelIntVoidReturns the authority level
DevReRollInitiativesVoidVoidRe-rolls all initiatives for this characterdebug, hide_in_uied
CanBeEmbeddedBoolVoidReturns true if the character can be embedded into an army
CopyMemoryAddressToClipboardVoidVoidCopies memory address of internal character to clipboard, useful for conditional breakpointsdebug, hide_in_uied
LoyaltyContextCcoCampaignCharacterLoyaltyVoidReturns the CcoCampaignCharacterLoyalty
CanUseArmoryItemsBoolVoidReturns true if this character can use armory items.
DevAddAllArmoryItemsVoidVoidEnables all armory items for characterdebug, hide_in_uied
ZealLevelIntVoidReturns the zeal level
InitiativeManagerCcoCampaignInitiativeManagerVoidReturns a CcoCampaignInitiativeManager
EffectBundleListCcoEffectBundle (list)VoidReturns list of active CcoEffectBundle, pre-filtered to only include those that should show in the UI
IsActiveBoolVoidReturns true if this character is currently alive and in use on the map
MilitaryForceContextCcoCampaignMilitaryForceVoidReturns the CcoCampaignMilitaryForce if character is a general
SelectVoidBool (optional)Selects this character. Plays character selection voice line. Pass false to not play VO.
DevEnableAllSkillsVoidVoidEnables all the characters skillsdebug, hide_in_uied
SettlementContextCcoCampaignSettlementVoidReturns a CcoCampaignSettlement with the settlement the character is currently in. Can be null for example if at sea
IsTravellingInTeleportationNodeBoolVoidReturns true if the character is travelling in a teleportation node
ActionPointsPerTurnIntVoidReturns the total action points available for this character per turn
RadarIconPathStringVoidReturns the icon path used for display on minimap
FactionContextCcoCampaignFactionVoidReturns the CcoCampaignFaction of the character
CanEquipAncillaryBoolCcoCampaignAncillaryReturns true if this character can equip the ancillary passed in.
IsEffectPresentBoolStringReturns true if the specified effect key is present on the character
ActionPointsRemainingIntVoidReturns the number of action points remaining this turn
TurnsToResurrectionIntVoidReturns how many turns will be until character gets resurrected and is available again
IsIgnoredFromEndTurnNotificationsBoolVoidReturns true if character is in end turn notification ignore list

CcoCampaignCharacterAutoManagement

Wrapper for character auto-management logic

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ToggleAutoManagingVoidVoidActivates the auto management for this character
IsAutoManagingBoolVoidReturns true if the character is currently being auto managed by the AI

CcoCampaignCharacterLoyalty

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LoyaltyVoidVoid
OnScreenLoyaltyVoidVoid
RangeStateVoidVoid
IsLoyaltyApplicableVoidVoid

CcoCampaignCharacterSkill

Component context wrapper for a campaign character skill

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NameUniStringVoidReturns the localised name of the skill
GetProvidedChaoticPlanTokensCcoChaoticPlanTokenRecord (list)VoidReturns a context list of the chaotic plan tokens that are introduced by this skill regardless of plan type
CharacterContextCcoCampaignCharacterVoidReturns the owning CcoCampaignCharacter for this skill
DevSetSkillLevelVoidIntSets skill level to specified numeric level. Used for testing skills in devdebug, hide_in_uied
NextLevelContextCcoCampaignCharacterSkillLevelDetailsVoidReturns the next CcoCampaignCharacterSkillLevelDetails if add another skill point
CurrentLevelContextCcoCampaignCharacterSkillLevelDetailsVoidReturns the current CcoCampaignCharacterSkillLevelDetails active
DevCycleSkillLevelVoidBoolCycles skill level in specified direction (true forwards, false backwards) incrementing until reaches max and then resetting back to 0 if reach max. Used for testing skills in devdebug, hide_in_uied
SpawningUnitAndRankPairListCcoPair (list)VoidReturns a pair with units and their ranks, that characters with this skill will spawn with
RemovePointVoidVoidRemoves a point from skill. Effects not applied until committed via character
LevelsDetailsListContextListVoidReturns the list of CcoCampaignCharacterSkillLevelDetails for each level of this skill
AddPointVoidVoidAdds a point into skill. Effects not applied until committed via character
CanRemovePointBoolVoidReturns true if can remove a point (added a point but didnt commit the skill choices)
UnitAttributeListContextListVoidReturns a list of CcoUnitAttributeRecord that we are currently providing
IsBackgroundSkillBoolVoidReturns true if this is a characters background skill (automatic and not chosen)
AbilityListContextListVoidReturns a list of CcoUnitAbility that we are currently providing
TotalLevelsIntVoidReturns the max level of the skill
EffectUnfilteredListCcoEffect (list)VoidReturns a list of CcoEffect that we are currently providing, including those filtered out usually to not show in uihide_in_uied
LevelIntVoidReturns the current level of the skill
IndentIntVoidReturns the x grid position
EffectListCcoEffect (list)VoidReturns a list of CcoEffect that we are currently providing, prefiltered to not show those that shouldnt appear in ui
TierIntVoidReturns the y grid position
ChildSkillsListContextListVoidReturns list of CcoCampaignCharacterSkill which are child links to us (unlocked by us)
ParentSkillsListContextListVoidReturns list of CcoCampaignCharacterSkill which are parent links to us (we are unlocked by)
ImagePathStringVoidReturns the image path for the skill
StatusStringVoidReturns the status of the skill as an unlocalised string (available, complete, locked, etc)
KeyStringVoidReturns the campaign skill record key
DescriptionUniStringVoidReturns the localised description of the skill

CcoCampaignCharacterSkillLevelDetails

Component context wrapper for a campaign character skill level details (each CcoCampaignCharacterSkill has multiple levels, each level represented by one of these)

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectListContextListVoidReturns list of CcoEffect provided by this skill level
IsLockedBoolVoidReturns if this skill level is currently locked
RankRequiredIntVoidReturns the rank required to research this skill level
LevelIntVoidReturns the level index
UnitAttributeListContextListVoidReturns a list of CcoUnitAttributeRecord provided by this skill level
AbilityListContextListVoidReturns list of CcoUnitAbility provided by this skill level

CcoCampaignCharacterTeleportationInteraction

Wrapper for a targetting interface that deals with teleport points on the map

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EnableTargettingVoidBoolEnables or disables the targetting depending on the bool passed in
ToggleTargettingVoidVoidToggles the targetting from active/inactive
ClearTargetVoidVoidClears the current target
IsValidTargetBoolContextReturns true if the passed in target is valid
IsTargettingActiveBoolVoidReturns true if the targetting for this interface is active
InvalidReasonsForTargetUniStringContextReturns the reason why a target cannot be selected
IsContextTargetedBoolContextReturns whether the given context is targeted. (Allows child classes to add unique targeting conditions)
CurrentTargetContextContextVoidReturns the current target selected (should always be a CcoTeleportationNetworkNodeRecord)
SourceCharacterContextCcoCampaignCharacterVoidReturns a CcoCampaignCharacter with the interacting character
SetTargetVoidContextSets the target to the context passed in if valid

CcoCampaignCharacterTeleportationSystem

Wrapper for character teleportation logic

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CharacterContextCcoCampaignCharacterVoidReturns a CcoCampaignCharacter with the character context
CanCharacterTeleportBoolVoidReturns true if the character can teleport (some charcter can only close nodes)
TeleportToRandomNodeInTemplateVoidCcoTeleportationNodeTemplateRecordTeleports the character to a random node with the template passed in
TeleportToNodeVoidCcoTeleportationNetworkNodeRecordTeleports the character to the passed in node
CloseTeleportationNodeVoidVoidCloses the teleportation node that the character is interacting with
CanTeleportToNodeBoolCcoTeleportationNetworkNodeRecordCloses true if the character can teleport to the passed in node
CanCloseTeleportationNodeBoolVoidReturns true if the character can close the node that it's currently interacting with
TravelingToNodeContextCcoTeleportationNetworkNodeRecordVoidReturns a CcoTeleportationNetworkNodeRecord with the node that the character is currently traveling to, if any
InteractingNodeContextCcoTeleportationNetworkNodeRecordVoidReturns a CcoTeleportationNetworkNodeRecord with the node that the character is currently interacting with, if any
ClosureCostCcoCampaignResourceTransactionVoidReturns a CcoCampaignResourceTransaction with how much it costs for the character to close the node
TeleportationCostCcoCampaignResourceTransactionCcoTeleportationNodeTemplateRecordReturns a CcoCampaignResourceTransaction with much it costs for the character to teleport to the specified node
TeleportationInteractionContextCcoCampaignCharacterTeleportationInteractionVoidReturns a CcoCampaignCharacterTeleportationInteraction that manages targetting the nodes on the 3d map

CcoCampaignCharacterTrainingGroup

Wrapper for a campaign training group

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MaximumSlotCountIntVoidReturns an int with the maximum slots in the group
TrainingSlotListCcoCampaignCharacterTrainingSlot (list)VoidReturns a list with all the training slots in this group, including dummy ones for locked slots
FactionContextCcoCampaignFactionVoidReturns the faction context of the group
TreasuryCostIntVoidReturns the cost of training a character
SelectDilemmaChoiceVoidInt, IntSelects dilemma choice for specified slot index and dilemma choice index
StartCharacterTrainingVoidVoidStarts character training in next available slot
LocalisedNameUniStringVoidReturns the localised name of the group
CanStartCharacterTrainingBoolVoidReturns true if character training can be started
InitialPortraitPathStringVoidReturns a string with the initial portrait path

CcoCampaignCharacterTrainingSlot

Wrapper for a campaign training slot

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AgentSubTypeContextCcoAgentSubtypeRecordVoidReturns the selected agent subtype context
AgentContextCcoAgentRecordVoidReturns the selected agent context
IndexIntVoidReturns the index of the slot in the training group that it's part of
IsActiveBoolVoidReturns true if the slot is active
IsLockedBoolVoidReturns true if the slot is locked
RemainingDurationIntVoidReturns an int with the remaining duration of the slot
ActiveDilemmaContextCcoCharacterTrainingDilemmaRecordVoidReturns the context of the active dilemma, if any
CharacterNameUniStringVoidReturns the name of the character from the slot
PossibleAbilityGroupListCcoSpecialAbilityGroupRecord (list)VoidReturns a list with possible abilities for this slot
IsPurchaseButtonActiveBoolVoidReturns true if this slot is purchasable
CharacterPortraitStringVoidReturns a string with the character portrait path
TraitListCcoCharacterTraitLevelRecord (list)VoidReturns a list with the chosen traits
AgentSubtypeAgentPairContextListCcoAgentSubtypeAgentPair (list)VoidReturns all possible associated agent subtype agent pair context
AgentSubtypeAgentPairContextCcoAgentSubtypeAgentPairVoidReturns the selected agent subtype agent pair context

CcoCampaignConstructionItem

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BuildingCultureVariantRecordContextVoidVoid
BuildingLevelRecordContextVoidVoid
IsConversionVoidVoid
PercentCompleteVoidVoid
TotalConstructionTimeVoidVoid
TurnsUnderConstructionVoidVoid
TurnConstructionStartedVoidVoid
TurnsToCompletionVoidVoid
IsPausedVoidVoid
ClockAnimationStateVoidVoid
IsDamagedVoidVoid
UpkeepCostVoidVoid
LongDescriptionVoidVoid
ShortDescriptionVoidVoid
NameVoidVoid
TypeVoidVoid
DevPointCostVoidVoid
CostVoidVoid

CcoCampaignCorruptionCounter

Wrapper for a corruption counter

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MaxIntVoidReturns the max corruption for this counter
AmountIntVoidReturns the total amount of corruption from all the corruption types in this counter
IntervalListCcoCorruptionCounterIntervalRecord (list)VoidReturns a list of all intervals for this counter
ActiveIntervalListCcoCorruptionCounterIntervalRecord (list)VoidReturns a list of intervals that are currently active

CcoCampaignCursorContext

Component context wrapper for EMPIRECAMPAIGN::CURSOR_OVER_CONTEXT, so can get context information about current 3d mouseover

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SettlementContextCcoCampaignSettlementVoidReturns the settlement currently mousing over
CharacterContextCcoCampaignCharacterVoidReturns the character currently mousing over
CurrentCursorKeyStringVoidReturns the current cursor_record key of the cursor being used
LogicalPositionStringVoidReturns logical position on map currently mousing over as a stringdebug
FactionContextCcoCampaignFactionVoidReturns the faction currently mousing over

CcoCampaignDiplomacyManager

Component context wrapper for the campaign diplomacy manager, so we can get pending negotiations for MPC sim turns, etc. Not meant as a full replacement for diplomacy since we dont have resource to rewrite diplomacy to cco in wh3!

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OpenNegotiationVoidCcoCampaignFactionOpens up negotiation in diplomacy to accept/counter/modify if there is one
NegotiationForFactionCcoCampaignNegotiationCcoCampaignFactionReturns a CcoCampaignNegotiaton for the given proposing faction if there is one
SentNegotiationListCcoCampaignNegotiation (list)VoidReturns a list of CcoCampaignNegotiaton which were sent by the player and are awaiting on responses from other players (only in mpc sim turns)
PendingNegotiationListCcoCampaignNegotiation (list)VoidReturns a list of CcoCampaignNegotiaton which are pending for the player (only in mpc sim turns)

CcoCampaignDiplomacyManipulationInfo

Wrapper for a diplomacy manipulation info

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RemainingCooldownIntVoidReturns the remaining cooldown of the manipulation info
CooldownTimeIntVoidReturns the the total cooldown time of the manipulation info
DescriptionUniStringVoidReturns the description of the manipulation info
DisplayNameUniStringVoidReturns the localised name of the manipulation info
IconStringVoidReturns the icon path of the manipulation info
CategoryStringVoidReturns the category of the manipulation info
DiplomacyManipulationInteractionContextCcoCampaignDiplomacyManipulationInteractionVoidReturns the context of the diplomacy interaction of this info
PerformManipulationVoidCcoCampaignFaction, CcoCampaignFaction (optional), Context (optional)Performs the manipulation on targets passed in
OwnerFactionContextCcoCampaignFactionVoidReturns the context of the faction that owns this diplomacy manipulation info
ResourceTransactionContextCcoCampaignResourceTransactionCcoCampaignFaction, CcoCampaignFaction (optional), Context (optional)Returns the cost for performing the manipulation, taking into account the specified source and objective

CcoCampaignDiplomacyManipulationInteraction

Class that manages targetting interface interaction for a manipulation info

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AverageAttitideFloatVoidReturns the average relations between source and objective factions
ClearTargetVoidVoidClears the settlement target is this exists
ToggleTargettingVoidVoidToggles the targetting system through the CampaignTargettingInterface.
AverageCorruptionFloatVoidReturns the average corruption between the source and objective factions
EnableTargettingVoidBoolIs passed true, enables this as the targetting interface, else disables it.
UsesObjectiveFactionBoolVoidReturns true if objective/second faction is needed for the manuipulation type
ZoomToTargetVoidVoidZooms to the current settlement target, if this exists.
ValidSourceFactionListCcoCampaignFaction (list)VoidReturns a list of source factions that have at least 1 valid objective faction to target
IsValidTargetBoolContextReturns true if the passed in object is valid. Can also be used for checking source/objective factions
ValidObjectiveFactionListCcoCampaignFaction (list)Bool (optional)Returns a list with valid objective factions based on the selected source faction
IsTargettingActiveBoolVoidReturns true if this is the current targetting interface
InvalidReasonsForTargetUniStringContextReturns reasons why a target cannot be set. Returns empty if object is valid. This can be used for a settlement or for source/objective faction
ActionPerformTooltipUniStringVoidReturns a tooltip with reason why cannot perform the manipulation with current setup, or returns specific text if can perform
DiplomacyManipulationInfoContextCcoCampaignDiplomacyManipulationInfoVoidReturns the context of the diplomacy manipulation info associated with this class
ActionCostCcoCampaignResourceTransactionVoidReturns the cost for the manipulation with the current setup
ObjectiveFactionContextCcoCampaignFactionVoidReturns the context of the objective faction stored, if any
CanPerformActionBoolVoidReturns true if the manipulation can be performed with the current source faction, objective faction and settlement (if the settlement is needed)
SourceFactionContextCcoCampaignFactionVoidReturns the context of the source faction stored, if any
SetDefaultTargetSelectionModeVoidVoidSets the default target selection mode using the current category
GetTargetSelectionModeStringStringVoidGets the active target selection mode as a string. May return: 'force', 'region', 'force_or_region', 'source_faction' or 'objective_faction'
IsContextTargetedBoolContextReturns whether the given context is targeted. (Allows child classes to add unique targeting conditions)
IsActionBlockedByPendingBattleBoolVoidReturns true if the manipulation is blocked by active pending battle
SetTargetSelectionModeVoidStringInforms the targeter of which mode of selection it should be doing. Valid arguments are as follows: 'force', 'region', 'force_or_region', 'source_faction' & 'objective_faction'
CurrentTargetContextContextVoidThis will only return if the manipulation type is TRANSFER_SETTLEMENT and we have a settlement target stored. Else returns nul
IsActionLockedBoolVoidReturns true if the manipulation hasn't been unlocked yet
PerformActionVoidVoidPerforms the manipulation with the current source, objective and settlement target, if it can
SetObjectiveFactionVoidCcoCampaignFactionSets the objective faction for this manipulation
SetupInitialTargetFactionVoidCcoCampaignFactionDoes the initial setup of the factions without notifying.
SetSourceFactionVoidCcoCampaignFactionSets the source faction for this manipulation
UpdateTargetFactionVoidVoidUpdates the faction with the current targetting interface faction. This is so all targetting interfaces are in sync
SetTargetVoidContextSets the settlement target or the source/objective faction. Which faction will be set is determined by the m_setting_source flag
ShouldDisplayFactionDropdownBoolBool (optional)Returns true if we should display the faction dropdown in the changing of the way panel

CcoCampaignElectorSeat

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsOwnedByNonHumanFactionVoidVoid
IsOwnedByPlayerVoidVoid
ShouldShowElectorCountTitleVoidVoid
IsOwnedByHumanFactionVoidVoid
CanBeRemovedFromSeatVoidVoid
ElectorCountRecordContextVoidVoid
FactionContextVoidVoid
ProvinceContextVoidVoid
SettlementContextVoidVoid
CharacterContextVoidVoid
LoyaltyPooledResourceContextVoidVoid
MaxLoyaltyVoidVoid
SeatHolderFactionLoyaltyVoidVoid
SeatHolderFactionHasLoyaltyVoidVoid
IsAbandonedRegionVoidVoid

CcoCampaignEventAgentTargetsCharacter

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsReferingToPlayerVoidVoid
DiplomaticStateContextVoidVoid
ActionResultContextVoidVoid
TargetFactionContextVoidVoid
AgentFactionContextVoidVoid
TargetContextVoidVoid
AgentContextVoidVoid

CcoCampaignEventAgentTargetsSettlement

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsReferingToPlayerVoidVoid
DiplomaticStateContextVoidVoid
ActionResultContextVoidVoid
TargetFactionContextVoidVoid
AgentFactionContextVoidVoid
TargetContextVoidVoid
AgentContextVoidVoid

CcoCampaignEventAncillaryOrTrait

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TraitVoidVoid
AncillaryRecordVoidVoid
CharacterVoidVoid
ZoomToVoidVoid
HasZoomLocationVoidVoid
StolenVoidVoid
LostVoidVoid
DescriptionVoidVoid
EffectListVoidVoid
FactionVoidVoid
TraitLevelValueVoidVoid
TraitChainListVoidVoid
TraitLevelContextVoidVoid

CcoCampaignEventArmoryItem

Context wrapper for a campaign ARMORY_ITEM custom layout event

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasZoomLocationBoolVoidReturns true if this event has a zoom location
ZoomToVoidVoidZooms to the event location
ArmoryItemContextCcoArmoryItemRecordVoidReturns a CcoArmoryItemRecord with the item that was gained
CharacterContextCcoCampaignCharacterVoidReturns a CcoCampaignCharacter with the character that the item is available for

CcoCampaignEventBattleResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PlayersBattleResultVoidVoid
DefendingBattleResultVoidVoid
AttackingBattleResultVoidVoid
DefendingFactionContextVoidVoid
AttackingFactionContextVoidVoid
DefendingCharacterContextVoidVoid
AttackingCharacterContextVoidVoid

CcoCampaignEventBuildingConstructed

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BuildingCcoCampaignBuildingVariantVoidReturns a CcoCampaignBuildingVariant with the building variant data

CcoCampaignEventDilemma

Component context wrapper for an event dilemma

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DilemmaContextCcoDilemmaRecordVoidReturns the context of the dilemma record
CampaignVOActorGroupIntVoidReturns the actor group of VO
CampaignVOEventNameStringVoidReturns the event name of VO
DescriptionUniStringVoidReturns the description of the dilemma
ZoomToVoidVoidZooms to the dilemma
ChoiceKeyStringVoidReturns the key of the choice that has been made for this dilemma, empty if no choice made yet
MakeChoiceVoidStringCalls a command to choose the passed in choice
HasZoomLocationBoolVoidReturns true if the dilemma has a zoom location
CategoryStringVoidReturns a string with the category of the dilemma
HasMadeChoiceBoolVoidRetuns true if a choice has been made
EventCategoryStringVoidReturns a string with the event category of the dilemma
CanMakeChoiceBoolStringReturns true if the choice with the key passed in is possible to be chosen
IsChoiceActiveBoolStringReturns true if the passed in choice key is active/should be displayed
PrimaryTargetFactionContextCcoCampaignFactionVoidReturns a CcoCampaignFaction with the primary faction target for the dilemma
SecondTargetFactionPooledResourceUniStringStringReturns the second faction pooled resource with the resource key passed in
NumberOfChoicesIntVoidReturns the number of choices for this dilemma
FirstTargetFactionPooledResourceUniStringStringReturns the first faction pooled resource with the resource key passed in
ChoiceDetailListCcoCdirEventsDilemmaChoiceDetailRecord (list)VoidReturns a list of choice details for this dilemma
PayloadOfChoiceCcoCampaignPayloadInfoStringReturns the context of the payload for the choice key passed in
RegionTargetNameUniStringVoidReturns the character region target name (Used for database text)
AdditionalTreasureHuntContextCcoTreasureHuntExtraInformationRecordVoidReturns the treasure hunt context if this dilemma is a treasure hunt
SecondTargetFactionNameWithIconUniStringVoidReturns the character first faction target name with icon (Used for database text)
SecondaryTargetMilitaryForceContextCcoCampaignMilitaryForceVoidReturns the secondary force target
SecondTargetFactionNameUniStringVoidReturns the character second faction target name (Used for database text)
FirstTargetFactionNameWithIconUniStringVoidReturns the character first faction target name with icon (Used for database text)
PrimaryTargetMilitaryForceContextCcoCampaignMilitaryForceVoidReturns the primary force target
FirstTargetFactionNameUniStringVoidReturns the character first faction target name (Used for database text)
PrimaryTargetSettlementContextCcoCampaignSettlementVoidReturns the primary settlement target
CharacterTargetNameUniStringVoidReturns the character target name (Used for database text)
SecondaryTargetCharacterContextCcoCampaignCharacterVoidReturns the secondary character target
PrimaryTargetCharacterContextCcoCampaignCharacterVoidReturns the primary character target
CampaignVODelayFloatVoidReturns the delay of VO

CcoCampaignEventDiplomacy

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ZoomToVoidVoid
HasZoomLocationVoidVoid
EventTypeVoidVoid
EventIconPathVoidVoid
IsTreatyBrokenVoidVoid
SecondFactionVoidVoid
FirstFactionVoidVoid

CcoCampaignEventFaction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasZoomLocationVoidVoid
DiplomaticStateContextVoidVoid
SecondFactionContextVoidVoid
FirstFactionContextVoidVoid

CcoCampaignEventFeed

Context wrapper for the event feed

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanCategoryInstantOpenBoolCcoEventFeedCategoryRecordReturns whether this category of events is allowed to instant open
ToggleCategoryInstantOpenVoidCcoEventFeedCategoryRecordToggles the passed in category as being or not being allowed to instant open
NextAutoOpenEventContextCcoCampaignEventFeedMessageDetailsVoidReturns the context of the next auto open event if any
EventGroupListCcoCampaignEventFeedGroup (list)VoidReturns a list of event groups

CcoCampaignEventFeedCustomMission

Component context wrapper for an event mission

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ZoomToVoidVoidZooms to the location of the mission
HasZoomLocationBoolVoidReturns true if the misison has a zoom location
MissionContextCcoCampaignMissionVoidReturns a CcoCampaignMission with the mission context
DescriptionUniStringVoidReturns the description of the mission
SubtitleUniStringVoidReturns the subtitle of the mission
TitleUniStringVoidReturns the title of the mission

CcoCampaignEventFeedFilter

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
InclusionStateVoidVoid
ToggleCategoryVoidVoid
IsCategoryIncludedVoidVoid

CcoCampaignEventFeedGroup

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ShouldAutoExpandVoidVoid
EventListVoidVoid
TitleVoidVoid

CcoCampaignEventFeedMessageDetails

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasZoomLocationBoolExpressionState
IconPathStringVoid
EventTypeStringVoid
MissionContextCcoCampaignEventFeedCustomMissionVoid
UseRevealingTextBoolVoidReturns true if the event uses revealing text (currently only used for incidents)
HasSepiaFadeBoolVoidReturns true if the incident has a sepia fade multiplier
CustomContextContextVoid
SepiaFadeMultiplierFloatVoidReturns the sepia fade multiplier, used for story panels to fade out a few seconds of at the end of the movie
FullFlavourTextUniStringVoid
MarkAsReadVoidVoid
FlavourTextUniStringVoid
IsLargeIncidentBoolVoidReturns true if we are an incident and event image is over default event size (current 800x450) as we use a different incident layout for these, originally for story panel on wh3
IsUsingLargeImageBoolVoidReturns true if event image is over default event size (current 800x450) as we use different component set for larger images for these important events for things like stories in wh3
SecondaryDetailUniStringVoid
PrimaryDetailUniStringVoid
ShouldRepositionBoolVoid
TitleUniStringVoid
EventSoundStringVoid
RequiresResponseBoolVoid
MoviePathStringVoid
SecondaryDetailsWithTagsUniStringVoid
ImagePathStringVoid
LayoutStringVoid
PrimaryDetailsWithTagsUniStringVoid
IsValidBoolVoid
PositionVector4Void
IsReadBoolVoid
ZoomToVoidExpressionState

CcoCampaignEventFeedOpenEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ShouldRepositionBoolVoid
IconContextContextVoid
EventContextCcoCampaignEventFeedMessageDetailsVoid

CcoCampaignEventFeedRecords

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
YearListVoidVoid
RoundsListVoidVoid
EndYearVoidVoid
StartYearVoidVoid
YearContextVoidVoid

CcoCampaignEventFeedRound

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsEmptyVoidVoid
RoundTitleVoidVoid
SummaryListVoidVoid

CcoCampaignEventFeedSummary

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MarkAsReadVoidVoid
IsReadVoidVoid
TotalEventsVoidVoid
EventListVoidVoid
FirstEventContextVoidVoid
IconPathVoidVoid
TitleVoidVoid

CcoCampaignEventFeedYear

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactionListVoidVoid
CharacterListVoidVoid
RoundsListVoidVoid
ProvinceListVoidVoid

CcoCampaignEventHostileAction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsReferingToPlayerVoidVoid
DiplomaticStateContextVoidVoid
ActingFactionContextVoidVoid
TargetFactionContextVoidVoid
ActingCharacterContextVoidVoid

CcoCampaignEventIncident

Context wrapper for a campaign incident

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FirstTargetNameUniStringVoidReturns the name of the first target
DescriptionUniStringVoidReturns the description of the incident
HasZoomLocationBoolVoidReturns true if this incident can be zoomed to
PayloadCcoCampaignPayloadInfoVoidReturns a CcoCampaignPayloadInfo with the payload of this incident
CampaignVODelayFloatVoidReturns the delay of VO
IncidentCcoIncidentRecordVoidReturns a CcoIncidentRecord with the record of this incident
CampaignVOActorGroupIntVoidReturns the actor group of VO
CampaignVOEventNameStringVoidReturns the event name of VO
ZoomToVoidVoidZooms to the incident location
PrimaryTargetFactionContextCcoCampaignFactionVoidReturns a CcoCampaignFaction with the primary faction target
PrimaryTargetMilitaryForceContextCcoCampaignMilitaryForceVoidReturns a CcoCampaignMilitaryForce with the primary force target
PrimaryTargetSettlementContextCcoCampaignSettlementVoidReturns a CcoCampaignSettlement with the primary settlement target
PrimaryTargetCharacterContextCcoCampaignCharacterVoidReturns a CcoCampaignCharacter with the primary character target
EventCategoryIntStringReturns an it with the enum index of the event category passed in
IsBloodEventBoolVoidReturns true if the blood overlay needs to be shown for this incident
SecondTargetFactionNameUniStringVoidReturns the name of the faction of the second target
SecondTargetNameUniStringVoidReturns the name of the second target
FirstTargetFactionNameUniStringVoidReturns the name of the faction of the first target

CcoCampaignEventMercenaryUnitUnlock

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitVoidVoid

CcoCampaignEventTechnologyResearched

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ResearchedTechnologyVoidVoid
ZoomToVoidVoid
HasZoomLocationVoidVoid
FactionVoidVoid
NextTechnologyVoidVoid

CcoCampaignEventTrainingDilemmaAvailable

Context wrapper for a campaign TRAINING_DILEMMA_AVAILABLE custom layout event

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasZoomLocationBoolVoidReturns true if this event has a zoom location
ZoomToVoidVoidZooms to the event location

CcoCampaignEventUnitRecruitment

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionVoidVoid
NameVoidVoid
AgentVoidVoid
UnitVoidVoid

CcoCampaignFaction

Wrapper for a campaign faction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
InitiativeSetListCcoCampaignInitiativeSet (list)VoidReturns the list of available initiative sets
GeneralsListCcoCampaignCharacter (list)VoidReturns the list of all generals in the faction
IsVassalOfPlayerBoolVoidReturns if the faction is vassal of the player
EntitySharedStateReadStringStringStringTakes a String id, and returns stored string value in shared state for this faction with that key. Value will be empty if doesnt exist in registry.registry
FactionFlagRotatedStringExpressionStateReturns faction flag rotated icon path - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied
RenameVoidVoidRenames the faction to the given name, opens a text prompt to do so)
TurnIndexIntVoidReturns the index of this faction in the end turn process (which turn is theirs)
FactionWarContractsCcoCampaignFactionWarContractsVoidReturns the faction CcoCampaignFactionWarContracts context
IsIdleHumanBoolVoidReturns true if this faction used to be controlled by human but the player has disconnected from the game
ChaoticPlansManagerContextCcoCampaignChaoticPlansManagerVoidReturns the faction CcoChaoticPlansManager context
FactionLeaderContextCcoCampaignCharacterVoidReturns the CcoCampaignCharacter of the factions current leader
EntitySharedStateReadBoolBoolStringTakes a String id, and returns stored bool value in shared state for this faction with that key. Value will be false if doesnt exist in registry.registry
GetBuildingLifecycleResourceUpkeepIntStringReturns the total building lifecycle upkeep for the provided pooled resource key
EffectValueSumFloatStringReturns the summed authored Value of all instances of the given effect key currently applied to this faction (all sources).
ActiveMissionListCcoCampaignMission (list)VoidReturns the list of active missions
CanCaptureTerritoryBoolVoidReturns true if faction can capture territory (so not a horde faction)
FactionFlagLargeStringExpressionStateReturns faction flag large icon path - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied
CharacterListCcoCampaignCharacter (list)VoidReturns the list of all characters in the faction
CQIIntVoidReturns the command queue index for the faction
IsHumanBoolVoidReturns true if this faction is currently under human control
FactionCaravansContextCcoCampaignFactionCaravansVoidReturns the faction CcoCampaignFactionCaravans context if this faction can use the caravans system
BreakForDebuggingVoidVoidAllows to step into code to fully inspec model side FACTION objectdebug, hide_in_uied
FinishedDanceForCategoryCcoEternalDanceInstanceDataCcoInitiativeSetCategoryRecordReturns the finished CcoEternalDanceInstanceData for this category
PooledResourceTrackingDataCcoCampaignFactionPooledResourceTrackingDataVoidReturns the faction CcoCampaignFactionPooledResourceTrackingData context
FactionFlagMediumStringExpressionStateReturns faction flag medium icon path - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied
OpenDiplomacyWithVoidVoidStarts negotiation with this faction
FactionInteractionListCcoCampaignFactionInteraction (list)VoidReturns the list of faction interactions with all factions have interactions setup with (for things like waagh)
HasValidPositionBoolVoidReturns true if faction has a valid position
FactionInteractionContextCcoCampaignFactionInteractionCcoCampaignFactionReturns the faction CcoCampaignFactionInteraction context with supplied target faction (for things like war coordination, loan armies, etc)
EntitySharedStateReadFloatFloatStringTakes a String id, and returns stored float value in shared state for this faction with that key. Value will be -1 if doesnt exist in registry.registry
MissionForRecordContextCcoCampaignMissionCcoMissionRecordReturns a CcoCampaignMission context for the given CcoMissionRecord if it exists in the mission manager
NumMilitaryForcesContributingToUpkeepIncreaseTotalIntVoidReturns the total number of military forces that are contributing to the factions upkeep increase
SettlementOwningLimitForGroupIntStringReturns the maximum number of settlements this faction can own for the given settlement type owning-limit group key, including bonus-value modifiers from all sources.
CurrentTechContextCcoCampaignTechnologyVoidReturns the current technology being researched
FoodTotalIntVoidReturns the total amount of food the faction has
PinnedMissionListCcoCampaignMission (list)VoidReturns list of the missions currently pinned for this faction
DiscoveredProvinceListCcoCampaignProvince (list)VoidReturns a list of provinces this faction has discovered
HasPendingActionBoolVoidReturns true if faction has an active battle or pending action, used to report that a player is blocking gameplay in simultaneous turns
IsDeadBoolVoidReturns true if this faction has been killed
EntitySharedStateValueExistsBoolStringTakes a String id, and returns if there's any state stored for this faction with that key.registry
PrisonSystemCcoPrisonSystemVoidReturns the faction's prison system
HasRightToConstructBuildingBoolStringReturns whether the faction has a right to construct this building level
NumAncillariesAllowedPerCharacterForFactionIntCcoCampaignCharacter, StringReturns the number of ancillaries that can be equipped into this category per category for a (optionally provided) faction, e.g. 3 for runes
FactionFlagSmallStringExpressionStateReturns faction flag small icon path - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied
AttitudeCategoryIntVoidReturns the attitude category with the players faction (hostile->friendly)
SubcultureContextCcoSubcultureRecordVoidReturns the CcoSubcultureRecord for this faction
ZoomToVoidVector4 (optional)Zooms to the faction, tries capital first, then faction leader, then first character on map. Can optionally provide an offset for the zoom.
SettlementCapIntVoidReturns the settlement cap for a faction. ( 0 if they dont have)
ProvinceListCcoCampaignProvince (list)VoidReturns a list of provinces this faction has a stake in
MissionListCcoCampaignMission (list)VoidReturns list of current active missions for this faction
CanConfederateBoolCcoCampaignFactionReturns whether this faction can confederate the specified argument faction.
IsFactionReadyToEndTurnBoolVoidReturns true if this player has ended turn in simultaneous turns, and is just waiting for rest of players in their group to end turn before the turn is actually ended
CanIssueTrespassWarningBoolCcoCampaignFactionReturns true if can send faction a trespass warning (if cooldown expired since last did this or havent done yet)
ActiveMissionForKeyCcoCampaignMissionStringReturns an active mission context for the given key if it exists on the mission manager
TotalArmyUpkeepIntVoidReturns the total upkeep cost of all this faction's armies
GetNaviesCapIntVoidReturns the navies cap
CookingSystemCcoCookingSystemVoidReturns the faction's cooking system
FactionLevelIntVoidReturns the factions 'level' which determines things like how many armies can field, etc
AttitudeTooltipUniStringVoidReturns a localised string with the attitude towards the player (friendly, hostile etc)
CultureContextCcoCultureRecordVoidReturns the CcoCultureRecord for this faction
TriggerIncidentVoidStringTriggers an incident with the specified key. The incident must not have any model targets.
IsRogueFactionBoolVoidReturns whether or not this is a rogue faction
PooledResourceListCcoCampaignPooledResource (list)VoidReturns the list of all pooled resources for the faction
NameWithIconUniStringExpressionStateReturns name of faction with faction flag as image tag next to it
TreasuryAmountIntVoidReturns the current treasury amount of this faction
MercenaryPoolContextCcoCampaignFactionMercenaryPoolVoidReturns the context of the faction mercenary pool
InfluenceAmountIntVoidReturns the current amount of influence the faction has
AddPooledResourceVoidCcoCampaignPooledResource, String, IntAdds an amount of pooled resource with the given factor
IsFactionsTurnBoolVoidReturns true if it is currently this factions turn
SettlementListCcoCampaignSettlement (list)VoidReturns a list of settlements owned by this faction
PooledResourceManagerContextCcoCampaignPooledResourceManagerVoidReturns the pooled resource manager which manages all responsibility for pooled resources on a faction
GetArmiesCapIntVoidReturns the armies cap
ModelFactionContextCcoCampaignModelFactionVoidReturns the CcoCampaignModelFaction for this faction
ClimatesListCcoSettlementClimateTypeRecord (list)StringReturns the list of climates that are applicable to this faction based on the supplied suitability key
ScriptedBonusValueFloatStringReturns the value of the scripted bonus value with the passed key.
EquippedShapeshiftFormContextCcoShapeshiftFormVoidReturns the current CcoShapeshiftForm equipped to a faction
SlavesAmountIntVoidReturns the current number of slaves the faction has
IncomeIntVoidReturns the amount of income per turn this faction is earning
DevUnlockAllShapeshiftFormsVoidVoidUnlocks all shapeshift forms for this factiondebug, hide_in_ui
GetActiveNaviesCountIntVoidReturns the number of active navies
FactionGovernorshipContextCcoCampaignFactionGovernorshipVoidReturns the faction governorship context, manager responsible for all governor functionality
IsPlayersFactionBoolVoidReturns true if this is the players faction
FactionRecordContextCcoFactionRecordVoidReturns the CcoFactionRecord for this faction
IsMajorFactionBoolVoidReturns whether or not this is a major faction
NameUniStringExpressionStateReturns name of faction
SetAutoManagementBudgetPercentageVoidFloatSets the auto management budget to use the percentage passed in of the faction's treasury
HasEnoughSlavesBoolIntReturns true if specified amount of slaves are available
TechnologyResearchPointSurplusIntVoidReturns how many tech research points this faction has left from the last research requiring less points than those generated in a turn
EnemyFactionListCcoCampaignFaction (list)VoidReturns a list of all the factions that this faction is at war with
AIMilitaryTargetListCcoPair (list)VoidReturns list of CcoPair which is a list of the factions forces and their current targets (settlement/character/force) designated by the AI
RitualContextForKeyCcoCampaignRitualString, Bool (optional)Returns the specified CcoCampaignRitual for a faction given a ritual key
GetActiveArmiesCountIntVoidReturns the number of active armies
EnemiesCountIntVoidReturns the number of enemies that this faction has
IsFactionKnownToPlayerBoolVoidReturns whether the player has met this faction or not
TechnologyUiGroupListCcoTechnologyUiGroupRecord (list)VoidReturns a TreeCallback with all the ui groups that exists for the technologies in this faction(if any)
RitualManagerContextCcoCampaignRitualManagerVoidReturns the context of the faction ritual manager if the faction has one
IsBankruptBoolVoidReturns true if the players faction currently has negative funds
DiplomacyManipulationInfoListCcoCampaignDiplomacyManipulationInfo (list)VoidReturns list of the diplomacy manipulation infos, if the faction has any.
TechnologyResearchPointsIntVoidReturns how many tech research points this faction has
ParentFactionContextCcoCampaignFactionVoidReturns the parent faction (for waagh factions)
MilitaryAlliesCountIntVoidReturns the number of military allies that this faction has
AncillarySalvageGainIntCcoCampaignResourceTransactionReturns the amount of gained resource when salvaging ancillaries
TechnologyTreeTreeDataCcoTechnologyUiTabRecord (optional)Returns a TreeCallback with all the technologies for this faction
IsKnownFactionBoolCcoCampaignFactionReturns whether we have met the passed in faction or not
TechnologyManagerContextCcoCampaignTechnologyManagerVoidReturns the context of the faction technology manager if the faction has one
FactionsKnownListCcoCampaignFaction (list)VoidReturns a list of all the factions this faction knows (that it can see in diplomacy basically)
IsDefensiveAllyBoolVoidReturns true if faction is an ally of the player
IssueTrespassWarningVoidCcoCampaignFactionSends a warning to specified faction from this faction to warn to get off land, otherwise will face diplomatic penalties (get off my land feature on wh3)
ChildFactionContextCcoCampaignFactionVoidReturns child faction (for waagh parents)
IsCampaignFeatureAvailableBoolExpressionState, StringReturns true if the specified campaign feature key is available for this faction
AlliesCountIntVoidReturns the number of allies that this faction has
AncillarySalvageTooltipUniStringVoidReturns the appropriate tooltip text for salvaging ancillaries based on the subculture
IsEffectBundleActiveBoolStringReturns true if specific effect bundle is active on the faction
CharacterRecruitmentPoolEntriesForAgentSubtypeCcoCampaignCharacterPoolEntry (list)CcoAgentSubtypeRecordReturns an initiative set in which the initiatives have an expended cost of the specified resource if it exists
DevAdjustRelationsWithVoidCcoCampaignFaction, IntAdjusts the diplomatic relations with the given faction. A tad dodgy, factors added are permanent. Value has to be in the range -6 to 6debug, hide_in_ui
IsAllyBoolVoidReturns true if faction is a defensive ally of the player
EffectBundleUnfilteredListCcoEffectBundle (list)VoidReturns list of effect bundles currently active on the faction from various sources, without any filtering (so includes those that dont show in the UI)hide_in_uied
CorruptionCounterContextCcoCampaignCorruptionCounterVoidReturns the context of the corruption counter for this faction if it exists
AncillaryListCcoCampaignAncillary (list)VoidReturns list of all ancillaries in the faction ancillary pool, plus any assigned ones on the characters from this faction.
AllianceColourColourVoidReturns the colour based on alliance to local player (as in colour based on player/ally/enemy/neutral)
PendingMissionListCcoCampaignMission (list)VoidReturns list of pending missions that are available to opt in to (contracts)
PrimaryColourColourVoidReturns the primary colour for this faction
PooledResourceContextCcoCampaignPooledResourceStringReturns the specified CcoCampaignPooledResource given a pooled resource key if it exists
PositionVector4VoidReturns the faction position, depending on if the current campaign is the prologue
ActiveMissionCountIntArgumentPackReturns the number of active missions if no args, or number of active mission matching any of the mission category strings passed in
EffectBundleListCcoEffectBundle (list)VoidReturns list of effect bundles currently active on the faction from various sources, pre-filtered to only include those that should show in the UI
DevAddAllAncillariesVoidVoidEnables all ancillaries for characterdebug, hide_in_ui
InitiativeSetWithExpendedPooledResourceCostCcoCampaignInitiativeSetCcoCampaignPooledResourceReturns an initiative set in which the initiatives have an expended cost of the specified resource if it exists
IsFactionFeatureAvailableBoolExpressionState, StringReturns true if the specified faction feature key is available for this faction
PlaguesCompositionSystemContextCcoCampaignPlaguesCompositionSystemVoidReturns the plague system of the faction if it exists
TradeStateStringVoidReturns trade state with players faction
UnitCapForAgentIntCcoAgentRecordReturns unit cap modifier for provided agent record for this faction
AgentSubtypeCountIntCcoAgentSubtypeRecordReturns the count of the agent subtype for this faction
IsEnemyBoolVoidReturns true if faction is an enemy of the player
WasConfederatedByFactionBoolCcoCampaignFaction, Bool (optional)Returns true if this faction was confederated by the faction passed as argument. By default also checks for indirect confederation, can optionally also pass a bool to not do that
CapitalSettlementContextCcoCampaignSettlementVoidReturns the CcoCampaignSettlement of the factions capital (home region)
IsEffectPresentBoolExpressionState, StringReturns true if a specified effect key is present on a faction
TechnologyListCcoCampaignTechnology (list)VoidReturns a list of all technologies linked to this faction (regardless of state)
CanUseMortuaryCultsBoolVoidReturns true if can use mortuary cults functionality (tomb kings usually use this on warhammer)
MainRivalDiplomaticThreatLevelContextCcoDiplomacyThreatLevelVoidReturns the faction CcoDiplomacyThreatLevel for the faction this faction considers its main threat (only for AI, returns null for human players)
UnlockableRitualListCcoCampaignRitual (list)ArgumentPackReturns the list of rituals not yet unlocked for a faction. Deprecated, please use the ritual manager insteaddeprecated
AgentSubtypeCapIntCcoAgentSubtypeRecordReturns the cap for the agent subtype for this faction
UnitCapForUnitIntCcoMainUnitRecordReturns unit cap for provided main unit record for this faction
DevToggleHumanVoidVoidToggles whether faction played by human or AIdebug, hide_in_ui
SavedDanceForCategoryCcoEternalDanceInstanceDataCcoInitiativeSetCategoryRecordReturns the saved CcoEternalDanceInstanceData for this category
IsLockedOutOfPlayAsAIToPlayerBoolVoidReturns true if the player is locked out of playing as AI for this faction in the current pending battle, e.g. if another faction is available for them to take over due to bonus values.
OriginatingCapitalSettlementContextCcoCampaignSettlementVoidReturns the CcoCampaignSettlement of the factions original capital (home region)
IsRebelFactionBoolVoidReturns true if faction is a rebel faction
AvailableRitualListCcoCampaignRitual (list)ArgumentPackReturns the list of available rituals for a faction (alreay unlocked). Deprecated, please use the ritual manager insteaddeprecated
DiplomaticThreatLevelContextCcoDiplomacyThreatLevelVoidReturns the faction CcoDiplomacyThreatLevel for this faction, if AI we show the threat of the player to the AI, if for the player we show the general threat the AI perceives
AllianceStateStringVoidReturns the alliance state with the players faction
TrespassWarningCooldownIntVoidReturns how many turns until can issue trespass warning again (cooldown)
AssociatedPatronProvincesListCcoCampaignProvince (list)VoidReturns a list of provinces this faction is a patron of, as set in the patron_faction_to_associated_provinces table
IsTechSelectNeededBoolVoidReturns true if this faction is not currently researching a tech but has the ability to do so (reminder for end turn)
ShouldAlwaysOfferPlayAsAIToPlayerBoolVoidReturns true if the player should always be offered to play as AI for this faction in battles
DevEnableAllTechVoidVoidResearches all techs for the faction instantlydebug, hide_in_ui
MilitaryForceListCcoCampaignMilitaryForce (list)VoidReturns the list of all military forces in the faction
CanPerformRitualsBoolVoidReturns true if this faction can currently perform rituals
CharacterTrainingActiveDilemmaListCcoCharacterTrainingDilemmaRecord (list)VoidReturns the list of active training group dilemmas
FactionWomCompassContextCcoCampaignFactionWomCompassVoidReturns the faction CcoCampaignFactionWomCompass context if this faction can use the winds of magic compass feature
FactionFlagDirStringExpressionStateReturns directory for faction flag icons - append image name including extension for use in setting images
IsResearchingTechBoolVoidReturns true if this faction is currently researching a tech
RespawnableForcesCcoCampaignCharacter (list)StringReturns the list of spawned forces that can be respawned
WasConfederatedBoolVoidReturns if the faction was confederated by another faction
StrengthRankIntVoidReturns the rank amongst all current active factions in terms of strength
ControllableMilitaryForceListCcoCampaignMilitaryForce (list)VoidReturns the list of all controllable military forces (non-caravan & non-garrison) in the faction
SalvageAncillariesVoidContextListSalvages all the ancillaries passed into the context list
HasTradeAgreementBoolVoidReturns true if faction has a trade agreement with the player
CharacterForAgentSubtypeCcoCampaignCharacterCcoAgentSubtypeRecordReturns a CcoCampaignCharacter for the given agent subtype record if the faction has such a character
IsSameFactionBoolCcoCampaignFactionReturns true if the specified faction is the same as this one
CharacterTrainingGroupListCcoCampaignCharacterTrainingGroup (list)VoidReturns the list of character training groups
FactionIconStringVoidReturns faction flag icon path - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied
StrengthValueIntVoidReturns the strength value used to evaluate a factions strength rank amongst all factions
AutoManagementBudgetPercentageFloatVoidReturns the percentage of the faction's treasury that's being used for auto managing provinces/characters
SpawnForceCostCcoCampaignResourceTransactionStringReturns the cost to spawn a conditionally spawnable force
InitiativeManagerCcoCampaignInitiativeManagerVoidReturns the faction initiative manager
AcceptPendingMissionVoidString, Bool (optional)Accepts the specified pending mission (contract)
NetworkPlayerContextCcoNetworkPlayerVoidReturns the network player that is controlling this faction (humans steam info)
OriginalFactionLeaderContextCcoCampaignCharacterVoidReturns the CcoCampaignCharacter of the original faction leader

CcoCampaignFactionAlliedBuildings

Wrapper for a player faction and an ally faction, used to interact with outposts.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanConstructInSettlementBoolCcoCampaignSettlementReturns true if can construct the outpost in this settlement
LongDistanceThresholdIntVoidReturns the long distance threshold, used for displaying the correct shared enemy distance state
MiddleDistanceThresholdIntVoidReturns the middle distance threshold, used for displaying the correct shared enemy distance state
SharedEnemyDistanceFromSettlementFloatCcoCampaignSettlementReturns the distance between the closest enemy from the allied settlement specified. Returns 0 if the 2 factions have no shared enemies
MoveToSettlementCostIntCcoCampaignSettlementReturns the amount it will cost to move the slot to this settlement
CanMoveToSettlementBoolCcoCampaignSettlementReturns true if the slot can be moved to the passed in settlement
RecruitableUnitsForSettlementListCcoMainUnitRecord (list)CcoCampaignSettlementReturns a list with units that could be recruited if an outpost is built in the passed in settlement
RemoveAlliedBuildingVoidVoidRemoves the outpost from the settlement where it's constructed
AlliedSettlementContextCcoCampaignSettlementVoidReturns the context of the settlement where an outpost is built, if any
MoveToSettlementVoidCcoCampaignSettlementMoves the current outpost to the settlement specified
AllyFactionContextCcoCampaignFactionVoidReturns the context of the ally faction in whose regions the player faction can construct outposts
PlayerFactionContextCcoCampaignFactionVoidReturns the context of the faction that interacts with the outposts.
ConstructInSettlementVoidCcoCampaignSettlementConstructs an outpost in the passed in settlement
ConstructInSettlementTimeIntCcoCampaignSettlementReturns the amount of time it will take to construct the outpost in this settlement.
AllyPermittedSettlementListCcoCampaignSettlement (list)VoidReturns a list with settlements owned by the ally faction, in which an outpost can be constructed
ConstructInSettlementCostIntCcoCampaignSettlementReturns the cost of constructing the outpost in this settlement.

CcoCampaignFactionCaravans

Wrapper for a campaign FACTION_CARAVANS struct

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanRecruitCaravanMasterBoolCcoCampaignCharacterReturns true if can recruit the passed in character as a caravan master
TooltipForCaravanUniStringCcoCampaignCaravan, CcoCaravanContractRecord, IntReturns a localised tooltip with the reason why the caravan cannot be dispatched
InitialZoomPositionVector4VoidReturns a VECTOR_4 with a position where the camera should zoom when first opening the panel
RecruitCaravanVoidCcoCampaignCharacterRecruits a caravan with the caravan master passed in
StartCaravanVoidCcoCampaignCaravan, CcoCaravanContractRecord, IntStarts the caravan with the amount of cargo passed in
MaximumCaravansIntVoidReturns an int with the maximum number of caravans that a faction can have active at the same time
NodeListCcoCampaignRouteNode (list)VoidReturns a list of CcoCampaignRouteNode with all the route nodes that can be used by this faction
CaravanMasterListCcoCampaignCaravanRecruitmentItem (list)VoidReturns a list of CcoPair with the first entry as CcoCampaignCharacter and second as an int with the cost of recruiting the character as a caravan master
IdleCaravanListCcoCampaignCaravan (list)VoidReturns a list of CcoCampaignCaravan with all the caravans that are idle
ActiveCaravanListCcoCampaignCaravan (list)VoidReturns a list of CcoCampaignCaravan with all active caravans
FactionContextCcoCampaignFactionVoidReturns the faction context of this class

CcoCampaignFactionGovernorship

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProvinceListCcoCampaignProvince (list)VoidReturns a list with all provinces that the faction can use to establish governorship
ClosestPendingDecisionGovernorshipContextCcoCampaignProvinceGovernorshipVoidReturns a CcoCampaignProvinceGovernorship with the closest governorship that has a pending decision, if no governorship has decisions then returns null
SelectFirstValidTargettingInterfaceVoidVoidSelects the first valid governorship targetting interface, if any
UnassignedGovernorsCountIntVoidReturns the number of unassigned governors
MaximumGovernorCountIntVoidReturns the maximum number of governors that can be present
ProvinceGovernashipFromProvinceCcoCampaignProvinceGovernorshipCcoCampaignProvinceReturns the province governorship that contains the passed in province, if any
ProvinceGovernashipFromGovernorCcoCampaignProvinceGovernorshipCcoCampaignCharacterReturns the province governorship that contains the passed in governor, if any
MoveProvinceGovernorVoidCcoCampaignProvince, CcoCampaignProvinceMoves a governor from one province to another
SelectProvinceDecisionChoiceVoidCcoCampaignProvince, CcoCampaignDecisionChoiceRecordSelect dilemma choice for the passed in governor
EstablishProvinceGovernorshipVoidCcoCampaignProvince, CcoCampaignCharacterEstablishes a new governorship with the province and governor passed in
ProvinceGovernorshipListCcoCampaignProvinceGovernorship (list)VoidReturns a list of all province governorships that have been already established
GovernorListCcoCampaignCharacter (list)VoidReturns a list with all governors that can be used to establish new governorships

CcoCampaignFactionInteraction

Component context wrapper for two factions interacting with each other, for the war coordination system (kind of a mirror to FACTION_INTERACTIONS_ENV).

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AlliedBuildingsContextCcoCampaignFactionAlliedBuildingsVoidGets the CcoCampaignFactionAlliedBuildings context to deal with outposts
SetTargetVoidContextSelects a war coordination target (CcoCampaignMilitaryForce or CcoCampaignSettlement)
EnableTargettingVoidBoolSets the targetting mode on/off as specified to pick a target
TargetFactionContextCcoCampaignFactionVoidThe target faction interacting with
ReverseInteractionContextCcoCampaignFactionInteractionVoidReturns the interaction the opposite way around (so can see requests in opposite direction, etc)
SourceFactionContextCcoCampaignFactionVoidThe source faction (usually player)
OpenWarCoordinationPanelVoidString (optional)Opens up the war coordination panel, pass a specific tab key to select that section otherwise defaults to first available
ClearTargetVoidVoidClears the curent war coordination target
CurrentTargetRequestContextCcoCampaignWarCoordinationRequestVoidReturns the CcoCampaignWarCoordinationRequest requested from the target faction to the source faction (for war coordinations requests from AI, the request accepted from WarCoordinationPendingRequestsList basically)
WarCoordinationPendingRequestsListCcoCampaignWarCoordinationRequest (list)VoidAdd favour points for dev functionality, can be positive or negative
ZoomToTargetVoidVoidZooms the camera to the current war coordination target
IsValidTargetBoolContextReturns true if supplied context is a valid war coordination target (CcoCampaignMilitaryForce or CcoCampaignSettlement)
CheapestTargetFavourPointsCostIntString (optional)Returns the favour point cost for the cheapest target. Can optionally pass the targetting type(OFFENSIVE, DEFENSIVE, OCCUPY) (used to show on tooltip so know how much need to use set target button for example). Returns 0 if no valid targets
DevAddFavourPointsVoidIntAdd favour points for dev functionality, can be positive or negativedebug, hide_in_uied
LoanMilitaryForceVoidCcoCampaignMilitaryForceLoans the specified force of the target faction to the source faction
FavourPointsCostForTargetIntContextReturns the favour point cost to set a particular war coordination target (CcoCampaignMilitaryForce or CcoCampaignSettlement)
CanLoanMilitaryForceBoolCcoCampaignMilitaryForceReturns true if the specified force of the target faction can be loaned to the source faction
IsTargettingActiveBoolVoidReturns true if targetting mode is currently active
FavourPointsCostToLoanMilitaryForceIntCcoCampaignMilitaryForceReturns the favour point cost to loan the specified force from the target to the source faction
InvalidReasonsForTargetUniStringContextReturns the reasons if any as a localised string of why you cannot target a specified attack target (CcoCampaignMilitaryForce or CcoCampaignSettlement)
IsContextTargetedBoolContextReturns whether the given context is targeted. (Allows child classes to add unique targeting conditions)
MilitaryForcesLoanedListCcoCampaignMilitaryForce (list)VoidReturns a list of military forces loaned from the target to the source faction
MilitaryForcesToLoanListCcoCampaignMilitaryForce (list)VoidReturns a list of military forces available to loan from target faction to source faction
ToggleTargettingVoidVoidToggles targetting mode on/off to pick a target
CurrentTargetContextContextVoidReturns the current target to attack or defend for war coordination (CcoCampaignMilitaryForce or CcoCampaignSettlement)
NumAvailableWarCoordOptionsIntVoidReturns the number of available war coord options, used for sorting
SharedEnemyListCcoCampaignFaction (list)VoidReturns a list of enemies common to both the source and target faction who can target with war coordination
IsWarCoordinationAvailableBoolVoidReturns true if the source and target faction have war coordination available (military allies)
ToggleTargettingForTypeVoidStringEnables targetting with the passed in option type
FavourPointsChangePerTurnIntVoidHow many favour points generate each turn (determined by relationship have between factions)
IsWarTargettingAllowedBoolVoidReturns true if can ever use war targetting (only disabled between human players at the minute)
HasAnyValidTargetToPickBoolString (optional)Returns true if we have anything we can actually target now. Can optionally pass the targetting type(OFFENSIVE, DEFENSIVE, OCCUPY)
FavourPointsIntVoidHow many favour points have to spend between factions to pay for actions such as war coordination or requesting armies

CcoCampaignFactionPooledResourceTrackingData

Wrapper for a pooled resource tracking faction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactionContextCcoCampaignFactionVoidReturns a CcoCampaignFaction context for the tracking faction
TrackedFactionContextCcoCampaignPooledResourceTrackedFactionCcoCampaignFactionReturns a CcoCampaignPooledResourceTrackedFaction context for the provided faction if there is one
TrackedFactionDataListCcoCampaignPooledResourceTrackedFaction (list)VoidReturns a list of CcoCampaignPooledResourceTrackedFaction for this faction's tracked factions

CcoCampaignFactionProvinceManager

Wrapper for a campaign FACTION_PROVINCE_MANAGER

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TurnsUntilNextGrowthPointIntVoidReturns how many turns it would take for the province to provide the next development point
GrowthFactorListCcoStringValue (list)VoidReturns a list of CcoStringValue factors for the growth
CQIIntVoidReturns the unique command queue index identifier of this province
GrowthPredictedNextTurnIntVoidReturns the amount of growth that the province is predicted to have next turn
InitiativeListCcoProvinceInitiativeRecord (list)VoidReturns a list of all province initiatives
GrowthThresholdForPointIntVoidReturns the growth threshold for the development points
AllEffectsListCcoEffect (list)VoidReturns a list of CcoEffect that are applied to the province, this include hidden effect bundles
GrowthPerTurnIntVoidReturns how much growth per turn the province provides
EffectBundleAndSettlementsListCcoPair (list)VoidReturns a list of pairs with province effect bundles and settlements where those effect bundles are active
AccumulatedGrowthIntVoidReturns the accumulated growth
AutoManagementContextCcoCampaignProvinceAutoManagementVoidReturns the context of the auto management system of the province
PooledResourceDistributorContextCcoCampaignPooledResourceDistributorVoidReturns the context of the pooled resource distributor of this province
DevelopmentPointsIntVoidReturns the current development point
SlavesContextCcoCampaignSlavesVoidReturns the context of the slave system if the faction has access to the feature
AddPooledResourceVoidCcoCampaignPooledResource, String, IntAdds a pooled resource to this province
FoodTotalIntVoidReturns the total food
FactionContextCcoCampaignFactionVoidReturns the faction context
SetInitiativeVoidExpressionStateSets the CcoProvinceInitiativeRecord initiative that is stored on the component that calls this function
ZealLevelIntVoidReturns the current level of zeal
SubterfugeLevelIntVoidReturns the current level of subterfuge
ProvinceContextCcoCampaignProvinceVoidReturns the province context
ToggleTaxExemptVoidVoidToggles the province to be tax exempt if it's currently not or the other way around
PublicOrderContextCcoCampaignPublicOrderVoidReturns the public order context
HasMaxDevelopmentPointsBoolVoidReturns true if this province has maximum develpoment point currently
CommandLevelIntVoidReturns the current level of the command/authority
GrossIncomeIntVoidReturns the gross income that the province produces
IsWealthEnabledBoolVoidReturns true if wealth is enabled for this province
PooledResourceContextCcoCampaignPooledResourceStringReturns the pooled resource context for the key passed in
SelectedInitiativeCcoProvinceInitiativeRecordVoidReturns the context of the selected initiative that will be installed next turn
GeomanticWebLevelTextUniStringVoidReturns the geomantic web text for the current level
IsGrowthEnabledBoolVoidReturns true if growth is enabled for this province
InstalledInitiativeCcoProvinceInitiativeRecordVoidReturns the context of the currently installed initiative in this province
IsPublicOrderEnabledBoolVoidReturns true if public order is enabled for this province
PredictedGrowthPercentageFloatVoidReturns the percentage of predicted next turn growth to max growth
CanSetInitiativeBoolVoidReturns true if the selected initiative can be set
GrowthPercentageFloatVoidReturns the percentage of current growth to max growth
IsTaxExemptBoolVoidReturns true if the province is not currently taking tax
GeomanticWebLevelIntVoidReturns the current level of the geomantic web of the province
IncomeBreakdownListCcoStringValue (list)VoidReturns a list of CcoStringValue with the breakdown of the income spent/gained

CcoCampaignFactionWarContracts

Wrapper for a campaign FACTION_WAR_CONTRACTS struct

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AvailableContractsListCcoCampaignWarContract (list)VoidReturns a list of CcoCampaignWarContract with all available non-active contracts
ActiveContractCcoCampaignWarContractVoidReturns a CcoCampaignWarContract for the current active contract
FactionContextCcoCampaignFactionVoidReturns the faction context of this class

CcoCampaignFactionWomCompass

Wrapper for wom compass

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentDirectionContextCcoCampaignWomCompassDirectionVoidReturns a CcoCampaignWomCompassDirection with the currently active direction
DirectionListCcoCampaignWomCompassDirection (list)VoidReturns a list of CcoCampaignWomCompassDirection with all the directions of the compass
CanChangeDirectionBoolVoidReturns true if the selection can be changed by the faction
ChooseCompassDirectionVoidCcoCampaignWomCompassDirectionChanges the compass direction to the one specified if possible
IsDirectionLockedBoolCcoCampaignWomCompassDirectionReturns true if the passed in direction is currently locked
MaximumCompassCooldownIntVoidReturns an int with the maximum cooldown the compass can have (useful for calculating percentage)
ActivateUserActionForDirectionVoidCcoCampaignWomCompassDirection, StringActivates the user action with the type passed in for the specified direction
MaximumFactionCooldownIntVoidReturns an int with the maximum cooldown the faction can have (useful for calculating percentage)
TooltipReasonForDirectionUniStringCcoCampaignWomCompassDirectionReturns extra text for the passed in direction
CompassCooldownIntVoidReturns an int with the cooldown until the compass can be moved again by any faction
PowerLevelCostToSkipCooldownIntVoidReturns an int with the cost in power levels that it would take to skip the compass cooldown
FactionCooldownIntVoidReturns an int with the cooldown until the faction can turn the compass again
CanSelectDirectionBoolCcoCampaignWomCompassDirectionReturns true if can select the passed in direction
TurnsUntilUnlockedScriptObjectEventsListCcoString (list)VoidReturns a list of CcoString event names that will fire when script updates the turns until each direction is unlocked
DirectionForKeyContextCcoCampaignWomCompassDirectionStringReturns a CcoCampaignWomCompassDirection with the key specified

CcoCampaignGovernorshipInteraction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GrowthCombinedValueIntVoidReturns an int with the combined growth value of all the effects on the character
PublicOrderCombinedValueIntVoidReturns an int with the combined public order value of all the effects on the character
IncomeCombinedValueIntVoidReturns an int with the combined income value of all the effects on the character
SetTargetVoidContextSets the target to the passed in one
EnableTargettingVoidBoolEnables or disables this targetting interface based on the bool passed in
ToggleTargettingVoidVoidToggles this targetting interface from active to inactive and the other way around
ClearTargetVoidVoidClears the current target
IsValidTargetBoolContextReturns true if the passed in target is valid
IsTargettingActiveBoolVoidReturns true if this targetting interface is active
InvalidReasonsForTargetUniStringContextReturns the reason why the target is not valid
IsContextTargetedBoolContextReturns whether the given context is targeted. (Allows child classes to add unique targeting conditions)
CurrentTargetContextContextVoidReturns the context of the current target
SourceCharacterContextCcoCampaignCharacterVoidReturns a CcoCampaignCharacter with the character
CorruptionCombinedValueIntVoidReturns an int with the combined corruption value of all the effects on the character

CcoCampaignInitiative

Wrapper for a campaign initiative

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LinkedTechnologyListCcoTechnologyRecord (list)VoidReturns list of technologies that modify this initiative
HasInfiniteDurationBoolVoidReturns true if this initiative will not expire
CanAffordBoolInt (optional)Returns true if we can afford the required cost of this initiative. Supports checking for optional slot index if provided
MarkAsSeenVoidVoidMarks the initiative as seen
RequiredCostContextCcoCampaignResourceTransactionVoidReturns context to required resource cost. Initiative is locked until these transactions have been met
IsActiveBoolVoidReturns true if this initiative is currently active
DeactivateVoidVoidDeactivates the initiative
UpkeepCostContextCcoCampaignResourceTransactionVoidReturns context to per-turn upkeep cost
TotalNumberOfRequirementsMetForForceIntCcoCampaignMilitaryForceReturns the total count of required units met in a force
ActivateNextRoundVoidVoidActivates the initiative - its effects will be applied next turn
CostContextCcoCampaignResourceTransactionVoidReturns context to intitial cost
TotalCountOfRequiredUnitsIntVoidReturns the total count of required units
ActivateVoidInt (optional), Bool (optional)Activates the initiative, to an optionally provided slot index
InitiativeContextCcoInitiativeRecordVoidReturns associated initiative record wrapper
PointsCostIntVoidReturns how many points this initiative contributes towards the set's limits (can be negative)
ToggleNextRoundVoidVoidActivates an initiative (its effects will be applied next turn), or deactivates an activated initiative.
TurnsUntilPayloadIsActivatedIntCcoCampaignPayloadRecordReturns the number of turns until the payload is reactivated
InitiativeSetContextCcoCampaignInitiativeSetVoidReturns the initiative set this initiative belongs to
ToggleVoidInt (optional), Bool (optional)Activates an initiative, to an optionally provided slot index, or deactivates an activated initiative.
ObjectIdString (list)VoidObjectId
RemainingCooldownIntVoidReturns the remaining cooldown for the initiative, or 0 if it is not on cooldown
ForceMeetsUnitRequirementsBoolCcoCampaignMilitaryForceReturns true if this initiative meets the units requirements set in the required_units field
HasSeenBoolVoidReturns true if this initiative has been seen before (modified by MarkAsSeen)
CooldownIntVoidReturns the cooldown for the initiative, or 0 if it does not have a cooldown period
IsPendingActivationBoolVoidReturns true if the initiative is set to activate on the next round
DurationIntVoidReturns the duration for the initiative, or 0 if it has infinite duration, which should be queried seperately
ScriptLockReasonStringVoidReturns the script lock reason for this initiative, if any
IsOnCooldownBoolVoidReturns true if the initiative itself is on cooldown
LockReasonsUniStringVoidReturns reasons that this initiative is locked as a string
IsOnlyOnCooldownBoolInt (optional)Returns true if locked only because of being on cooldown. Can provide an optional slot index
ScriptRequirementsCcoScriptRequirement (list)StringReturns a list of CcoScriptRequirement for this initiative from the given script object id. Looks up ScriptObjectContext(script_object_id), expects a table keyed by initiative DB key to a list of requirement tables, and parses each entry. Returns an empty list if the script object or initiative entry is missing. See CcoScriptRequirement for the expected Lua table schema.
DevSetScriptLockVoidBoolRemove script lock and activate the initiative. Dev command.
GetUnlockableRitualsCcoCampaignRitual (list)VoidReturns a list of rituals that can be unlocked by this initiative.
IsScriptLockedBoolVoidReturns true if this initiative is script locked.
EffectsProvidedUnfilteredCcoEffect (list)VoidReturns list of Effects provided by this initiative, without UI filtering. This shows even hidden effects
IsLockedIgnoringSetCapacityBoolInt (optional)Returns true if this initiative is locked. Alternatively given a slot index, return if locked for given slot. Ignores the set's capacity
RemainingDurationIntVoidReturns the remaining duration of the intiative
IsLockedBoolInt (optional)Returns true if this initiative is locked. Alternatively given a slot index, return if locked for given slot
EffectsProvidedCcoEffect (list)VoidReturns list of Effects provided by this initiative

CcoCampaignInitiativeManager

Component context manager for campaign initiatives

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsPresetForInitiativeSetCategoryFinishedBoolCcoInitiativeSetCategoryRecordCheck if the preset for the initiative set category is finished (is present in applied finished presets.)
SaveInitiativeSetCategoryPresetVoidCcoInitiativeSetCategoryRecordSaves the current preset for a given category to the faction.
HasActiveInitiativeFromInitiativeSetBoolCcoInitiativeSetRecordReturns whether the manager has an active initiative from the given initiative set
IsInitiativeSetCategoryDisabledBoolCcoInitiativeSetCategoryRecordCheck if the initiative set category is disabled
HasActiveInitiativeFromInitiativeSetWithKeyBoolStringReturns whether the manager has an active initiative from the initiative set with the given key
IsInitiativeSelectedBoolCcoCampaignInitiativeCheck if the initiative button should be displayed as selected (active or to-be active)
CanPayPendingInitiativesExpenditureCostBoolCcoCampaignPooledResourceReturns true if the pending initiatives cost can be paid.
IsInitiativeActiveForAnySetBoolCcoCampaignInitiativeReturns true if the passed in initiative is active for any of the initiative sets it is a part of
TotalCostForConfirmationIntCcoCampaignPooledResource (optional)Get the total cost to confirm the selection
IsPresetForExclusiveCategorySavedBoolString (optional)Return true if the preset in this manager matches the saved one for this category in the faction.
GetInitiativeSetInCategoryUsingSearchKeyCcoCampaignInitiativeSetCcoInitiativeSetCategoryRecord, StringReturns the initiative set in the category using the search key, or null if none is found
TotalUpkeepIntCcoCampaignPooledResource (optional)Get the value of what the total upkeep will be after the selection has been confirmed
GetActiveCategoryFromMutuallyExclusiveSetCcoInitiativeSetCategoryRecordStringReturns the active category from a mutually exclusive set, or null if none is active
CalculateSwapCostForInitiativeFromSetCcoCampaignResourceTransactionCcoCampaignInitiative, CcoCampaignInitiativeSetReturns the cost for swapping a given initiative from a given set to another. Takes into account bonus values.
ActiveInitiativesCcoCampaignInitiative (list)VoidReturns a list of active initiatives from the sets in the manager
CategoriesCurrentlyBlockedCcoInitiativeSetCategoryRecord (list)VoidReturns a list of the initiative set categories currently blocked by bonus values
FinishedInitiativeSetPresetForCategoryCcoCampaignInitiativeSet (list)CcoInitiativeSetCategoryRecordReturns the finished preset of initiative sets for a category.
SetInitiativeSetCategoryPresetVoidCcoInitiativeSetCategoryRecord, Bool (optional)Adds a new empty exclusive saved category to the saved presets for the manager.
PostConfirmActiveInitiativeListCcoCampaignInitiative (list)CcoCampaignInitiativeSet (optional)Returns the initiatives which will be active once the confirm button is clicked. This is used to display the potential active effects
ClearListsVoidVoidClears the lists of to-be activated and de-activated initiatives. For when the panel is closing
ApplyPendingInitiativeChangesVoidVoidHandler when the confirmation button is clicked
InitiativesMarkedForDeactivationCcoCampaignInitiative (list)CcoCampaignInitiativeSet (optional)Returns the initiatives which have been marked for deactivation
ToggleInitiativeAndDependantLevelsVoidCcoCampaignInitiativeHandler when the initiative buttons are clicked
InitiativesMarkedForActivationCcoCampaignInitiative (list)CcoCampaignInitiativeSet (optional)Returns the initiatives which have been marked for activation
InitiativeSetListSortedBySortOrderCcoCampaignInitiativeSet (list)String (optional)Return all the initiative sets, optionally filtered by category, sorted by record sort order
ToggleInitiativeVoidCcoCampaignInitiativeHandler when the initiative buttons are clicked
IsSavedPresetPresentForInitiativeSetCategoryBoolCcoInitiativeSetCategoryRecordCheck if the faction has a saved preset for this category
InitiativeSetListCcoCampaignInitiativeSet (list)String (optional)Returns all the initiative sets within the manager optionally filtered for a category

CcoCampaignInitiativeSet

Component context wrapper for a campaign initiatives

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
InitiativeManagerCcoCampaignInitiativeManagerVoidReturns initiative manager for this set
PointsLimitIntVoidreturn the point limit for this set
RemainingCooldownIntVoidreturn the remaining cooldown for this set
ActiveInitiativeLimitIntVoidReturn the int with the active initiative limit for this set
CanActivateInitiativesBoolContextListReturn bool with the flag whether this set can activate initiatives
BaseCostContextCcoCampaignResourceTransactionVoidReturns the resource transaction cco for the base cost
CostForMultipleInitiativesCcoCampaignResourceTransactionContextListReturn the resource transaction cco for multiple initiatives' cost
ToggleMultipleInitiativesVoidContextList, Bool (optional)Activates multiple initiatives
ActiveInitiativeForSlotCcoCampaignInitiativeIntReturn the active initiative for a specific slot
GetFirstAvailableSlotIntVoidReturns the first ui slot number that a newly activated initiative can be set into. If the initiative limit has been reached it returns -1.
ChooseAllInitiativesVoidVoidSets all initiatives to active in this set's region.
ChosenInitiativesCcoCampaignInitiative (list)VoidReturn the list of chosen initiatives for this set
ActiveInitiativesCcoCampaignInitiative (list)VoidReturn the list of active initiatives for this set
TryFindInitiativeFromSetCcoCampaignInitiativeCcoCampaignInitiativeReturns a CcoCampaignInitiative with the given initiative for this set
InitiativeListSortedCcoCampaignInitiative (list)VoidReturn the list of all initiatives for this set
InitiativeListCcoCampaignInitiative (list)VoidReturn the list of all initiatives for this set
DevModifyLimitVoidInt (optional)Dev function to modify the limit of initiatives for this set
InitiativeSetContextCcoInitiativeSetRecordVoidReturn the initiative set record cco
IsOnCooldownBoolVoidreturn whether this set is on cooldown
PointsAllocatedIntVoidreturn the points allocated for this set

CcoCampaignMilitaryForce

Component context wrapper for a campaign military force

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanSwitchToPreviewStanceBoolVoidReturns true if this force can switch to the current stance being previewed
PooledResourceManagerContextCcoCampaignPooledResourceManagerVoidReturns the CcoCampaignPooledResourceManager for calculating pooled resource costs
EntitySharedStateValueExistsBoolStringTakes a String id, and returns if there's any state stored for this military force with that key.registry
ReturnLoanedArmyVoidVoidIf the army is a loaned army, returns them to their lending faction
WarCoordinationTargetterListContextListVoidReturns list of contexts who are targetting us (mix of factions and armies as war coordination can be on both these levels)
DevAddDevPointVoidVoidAdds development points for hordesdebug, hide_in_uied
RecallSpawnedForceVoidVoidSets the force's general in limbo if possible
IsPreviewingStanceBoolVoidReturns true if this force is currently previewing an alternative stance (mousing over a stance choice for example)
ArmyPlagueContextCcoCampaignArmyPlagueVoidReturns the CcoCampaignArmyPlague for any plague present
ZoomToVoidVector4 (optional)Zooms to the military force. Can optionally provide an offset for the zoom.
AverageHealthPercentageFloatVoidReturns the average health percentage of units (0-1)
PooledResourceListCcoCampaignPooledResource (list)VoidReturns the list of CcoCampaignPooledResource attached to this force
HasLimitedLifespanBoolVoidReturns true if this force has a limtied lifespan
IsRaidingBoolVoidReturns true if this force is raiding
ParentForceContextCcoCampaignMilitaryForceVoidReturns the CcoCampaignMilitaryForce of the parent army (for waagh parent)
LocationEffectListCcoEffect (list)VoidReturns current active list of CcoEffect coming from current location
HealthPercentFloatVoidReturns current hp percentage of recruited units against their max health (0-1)
FactionFlagRotatedStringVoidReturns the filepath for rotated faction flag.deprecated
IsSelectedBoolVoidReturns true if this force is selected
RemainingLifespanIntVoidReturns the remaining limited lifespan of this force
SpawnForceVoidString, CcoCampaignCharacter (optional)Spawns the specified spawnable_force_key if possible. Optionally a force in limbo can be respawned instead.
ChildForceContextCcoCampaignMilitaryForceVoidReturns the CcoCampaignMilitaryForce of any child armies (for waagh children)
FactionFlagLargeStringVoidReturns the filepath for large faction flag.deprecated
TotalLifespanIntVoidReturns the total limited lifespan of this force
IsHiddenToEnemiesBoolVoidReturns true if this army is currently hidden from enemies
TrespassGracePeriodIntVoidReturns the number of turns until war can be declared without penalty on an army if it does not vacate your territory
WarCoordTargettingContextCcoCampaignMilitaryForceWarTargettingVoidReturns the CcoCampaignMilitaryForceWarTargetting for handling setting war coordination targets
ForceEffectListCcoEffect (list)VoidReturns current active list of CcoEffect coming from force itself
UnitCountPercentFloatVoidReturns the percentage unit count of current units against max can have (0-1)
FactionFlagMediumStringVoidReturns the filepath for medium faction flag.deprecated
LoanTurnsRemainingIntVoidReturns the number of turns remaining until loan is over and will return to FactionLoanedFromContext if any (0 if not on loan)
IsAgentEmbeddedBoolVoidReturns true if this force has an agent embedded within
SkulltakerTeleportCostForForceIntCcoCampaignRitualSpecific to Skulltaker, takes in a CcoCampaignRitual so we can get the ritual setup from it and returns the cost for Skulltaker to teleport to that force, since it's different depending on each force.
IsTransportedArmyBoolVoidReturns whether a this force is a transported army
PositionVector4VoidReturns the map position of the force
PooledResourceContextCcoCampaignPooledResourceStringReturns the specified CcoCampaignPooledResource by record key
FactionFlagSmallStringVoidReturns the filepath for small faction flag.deprecated
AllowedNumberTacticsIntVoidReturns the number of allowed tactics for this force
CQIIntVoidReturns the command queue index (unique id of force)
IsHordeBoolVoidReturns true if this force is a horde
EffectBundleUnfilteredListCcoEffectBundle (list)VoidReturns current active list of CcoEffectBundle, without any filtering (so includes those that dont show in the UI)hide_in_uied
TransportedMilitaryForceContextCcoCampaignMilitaryForceVoidReturns the military force transported in this military force if one is present.
ActiveStanceContextCcoCampaignMilitaryForceStanceVoidReturns the current selected CcoCampaignStance
TooltipForCanLoanStatusUniStringVoidReturns a tooltip displaying information relating to whether an army can be loaned
SiegeTurnsRemainingIntVoidReturns the number of turns remaining before settlement sieging falls without a fight (if sieging)
ContractPointsValueIntVoidReturns the contract points value for the force
ForceTypeStringVoidReturns a string with the type of the military force
IsLayingAmbushBoolVoidReturns true if this force is currently in ambush stance
EffectBundleListCcoEffectBundle (list)VoidReturns current active list of CcoEffectBundle, pre-filtered to only include those that should show in the UI
TrespassWarningIsIssuedBoolVoidReturns whether a trespass warning has been issued by the player to this military force
MoraleContextCcoCampaignMilitaryForceMoraleVoidReturns the CcoCampaignMilitaryForceMorale
TooltipForRecallSpawnForceUniStringVoidReturns the tooltip for recalling a spawned force
CanRenameAnyUnitBoolVoidReturns true if anything in the army can be renamed
CanShowBalanceOfPowerPreviewBoolCcoCampaignMilitaryForceReturns true if can show the balance of power preview for the supplied army against this current army
DisbandVoidVoidDisbands the entire force essentially killing it
StanceListCcoCampaignMilitaryForceStance (list)VoidReturns the available CcoCampaignStance (that force can ever do, not just available right now)
RaidingIncomeIntVoidReturns the amount of income this force is providing in via raiding
IsLayingSiegeBoolVoidReturns true if this force is currently besieging a settlement
WillReplenishThisTurnBoolVoidReturns true if this force is replenishing and will increase in health in next turn
IsTrespassingAgainstPlayerBoolVoidReturns true if this force is trespassing on the players territory
UnitActionPointsAlwaysZeroThisTurnBoolVoidReturns whether the m_action_points_always_zero flag is set for units in this force, meaning they won't be able to gain AP this turn
DevManipulateWinStreakVoidBoolManipulates the winning streaks, useful for dev purposesdebug, hide_in_uied
CharacterListCcoCampaignCharacter (list)VoidReturns list of CcoCampaignCharacter in this force
FactionLoanedFromContextCcoCampaignFactionVoidReturns the CcoCampaignFaction that we were loaned from if any
UpkeepIntVoidReturns the cost per to turn to keep this force active
IsGarrisonedBoolVoidReturns true if this force is currently inside a settlement
TooltipForRespawnForceUniStringStringReturns the tooltip for spawning a force using supplied spawnable_force_key but ignoring resources.
FactionContextCcoCampaignFactionVoidReturns the CcoCampaignFaction this force belongs to
DevHealVoidVoidReplenishes the force, useful for dev purposesdebug, hide_in_uied
PendingRecruitmentUnitListCcoPair (list)VoidReturns list of CcoPair for each unit being recruited in this force
HasPlaceholderCharacterBoolVoidReturns true if the force has a placeholder character
TooltipForSpawnForceUniStringString, Bool (optional)Returns the tooltip for spawning a force using supplied spawnable_force_key
SoldierCountIntVoidReturns the number of current entities
IsNavalTransportBoolVoidReturns true if this force is a naval transport
CanRecallSpawnedForceBoolVoidChecks if the spawned force can be recalled
SettlementContextCcoCampaignSettlementVoidReturns the CcoCampaignSettlement we are in if any
IsEffectBundleActiveBoolStringReturns true if specific effect bundle is active on the force
FactionNameUniStringVoidReturns the factions localised name (use this instead of getting from faction so works correctly with rebels)
UnitListCcoCampaignUnit (list)VoidReturns list of CcoCampaignUnit in this force
IsSufferingAttritionBoolVoidReturns true if this force is suffering attrition and will take damage in the next turn
IsInValidSpawnForcePositionBoolStringReturns true if this force's position is valid to spawn the specified spawnable_force_key
DevRemoveEffectBundleVoidStringRemoves the specified effect bundle from the force, useful for dev purposesdebug, hide_in_uied
CommandingCharacterContextCcoCampaignCharacterVoidReturn the CcoCampaignCharacter for the commanding character who is leading the force
UnitCountIntVoidReturns the number of units recruited
IsInsideSphereOfInfluenceForForceBoolCcoCampaignMilitaryForceReturns if the force is inside the sphere of influence of another given force.
DevKillVoidVoidKills the force, useful for dev purposesdebug, hide_in_uied
NameUniStringVoidReturns the localised name
CanSpawnForceBoolString, Bool (optional)Returns true if this force can spawn the specified spawnable_force_key. If the optional bool is true then the cost is not taken into account.
ContainsSpellcasterBoolVoidReturns if the force contains a spellcasting character.
CanPlayerLoanBoolVoidReturns true if this force can currently be loaned to the player by the forces owning faction
PlagueResistanceFloatVoidReturns the additive resistance the force has against plague infection
EntitySharedStateReadStringStringStringTakes a String id, and returns stored string value in shared state for this military force with that key. Value will be empty if doesnt exist in registry.registry
DevSetDebugMoraleEffectValueVoidIntSets morale debug effect value for increasing/decreasing moraledebug, hide_in_uied
PlagueInfectionContextCcoCampaignPlagueInfectionVoidReturns a CcoCampaignPlagueInfection with a plague infection if it exists on the military force
PlagueEffectBundleListCcoEffectBundle (list)VoidReturns the list of CcoEffectBundle provided by the plague on this army
HasArmyPlagueBoolVoidReturns true if this force has an army plague attached
PlagueImmunityTurnsIntVoidReturns the number of turns the force is immune to plagues for, or 0 if not immune
AutoresolvePredictionInaccuracyPercentFloatCcoCampaignMilitaryForceReturns a percentage of inaccuracy the general calculating correct CombatComparisonStrengthRelativeToForce. Larger battles and lower general rankings make this larger. (0-1)
IsOgreCampBoolVoidReturns true if this force is a ogre camp
DevAddGrowthVoidIntAdds growth points for hordesdebug, hide_in_uied
EntitySharedStateReadBoolBoolStringTakes a String id, and returns stored bool value in shared state for this military force with that key. Value will be false if doesnt exist in registry.registry
IsMovingCampBoolVoidReturns true if this force is a moving camp (like ogre camps in wh3)
AITargetListContextListVoidReturns list of targets the AI is targetting (forces/settlements)
HordeContextCcoCampaignMilitaryForceHordeVoidReturns the CcoCampaignMilitaryForceHorde for getting horde specific info like settlements etc
CombatComparisonStrengthRelativeToForceFloatCcoCampaignMilitaryForceReturns a percentage of relative strength against specified force (where 1 is will definitely beat and 0 is definitely will lose)
IsImmuneToPlaguesBoolVoidReturns if the force is currently immune to plagues
IsFixedCampBoolVoidReturns true if this force is a fixed camp (like ogre camps in wh3)
DevRemoveDevPointVoidVoidRemove development points for hordesdebug, hide_in_uied
WinStreakListCcoCampaignWinStreak (list)VoidReturns list of CcoCampaignWinStreak
HasPlagueBoolVoidReturns true if this force has a plague attached
CampRequiredResourceCostContextCcoCampaignResourceTransactionStringReturns the CcoCampaignResourceTransaction for spawning a camp for the specified spawnable_force_key
EntitySharedStateReadFloatFloatStringTakes a String id, and returns stored float value in shared state for this military force with that key. Value will be -1 if doesnt exist in registry.registry
EnableFixedCampAreaOfInfluencePreviewVoidBoolIf true, enables preview of visualisation for how large fixed camp area of influence would be if deployed in current position (false disables it)
IsNotGarrisonForceBoolVoidReturns true if this force is not a garrison army
StancePreviewPercentCostFloatVoidReturns the percentage AP cost to switch to specified stance (0-1)

CcoCampaignMilitaryForceHorde

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BuildingCanEverBeBuiltBoolCcoBuildingLevelRecordReturns true if the building can ever be built
PrimarySlotContextCcoCampaignBuildingSlotVoidReturns a CcoCampaignBuildingSlot with the primary slot in the horde
BuildingSlotListCcoCampaignBuildingSlot (list)VoidReturns a list of CcoCampaignBuildingSlot with all the slots in the horde
AccumulatedGrowthIntVoidReturns an int with the current amount of accumulated growth
ChainListCcoBuildingChainRecord (list)VoidReturns a list of CcoBuildingChainRecord with all the building chains in the horde
GrowthFactorListCcoStringValue (list)VoidReturns a list of CcoStringValue with the name and value of the factors that went towards the current amount of growth
TurnsUntilNextGrowthPointIntVoidReturns an int with the number of turns needed until the next development point
GrowthThresholdForPointIntVoidReturns an int the growth amount needed for the next development point
GrowthPerTurnIntVoidReturns an int with the amount of growth the horde receives each turn
PredictedGrowthPercentageFloatVoidReturns a float with the percentage of growth value the horde will have next turn, relative to the next development point
GrowthPercentageFloatVoidReturns a float with the percentage of current growth relative to the next development point
DevelopmentPointsIntVoidReturns an int with the current number of development points
BuildingSetListCcoBuildingSetRecord (list)VoidReturns a list of CcoBuildingSetRecord with all the building sets in the horde

CcoCampaignMilitaryForceMorale

Component context wrapper for a campaign military force's morale

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsLowBoolVoidReturns true if morale considered low (which gives penalties)
DebugMoraleEffectValueIntVoidReturns the current debug effect value
PredictedMoraleChangeFloatVoidReturns the difference between PredictedMorale and CurrentMorale
PredictedMoraleFloatVoidReturns predicted (next turn) value
CurrentMoraleFloatVoidReturns current value
CurrentEffectCcoEffectBundleVoidReturns the current CcoEffectBundle being applied due to morale if any
PredictedBreakdownCcoStringValue (list)VoidReturns the predicted (next turn list of effects as a list of CcoStringValue
CurrentBreakdownCcoStringValue (list)VoidReturns the current list of effects as a list of CcoStringValue

CcoCampaignMilitaryForceStance

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanBeActivatedVoidVoid
IsActiveVoidVoid
EffectListVoidVoid
IconPathVoidVoid
DescriptionVoidVoid
NameVoidVoid
KeyVoidVoid
DisablePreviewVoidVoid
EnablePreviewVoidVoid
ActivateVoidVoid
CanAffordVoidVoid
CanBeActivatedOnTerrainVoidVoid

CcoCampaignMilitaryForceWarTargetting

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EnableTargettingVoidBool
ToggleTargettingVoidVoid
ClearTargetVoidVoid
ZoomToTargetVoidVoid
SetTargetVoidContext
IsTargettingActiveBoolVoid
InvalidReasonsForTargetUniStringContext
IsAvailableBoolVoid
IsValidTargetBoolContext
MilitaryForceContextContextVoid
IssuingFactionContextContextVoid

CcoCampaignMission

Component context wrapper for a CAMPAIGN_MISSION

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CharacterContextAtSettlementObjectiveDisplayPositionCcoCampaignCharacterVoidReturns the character located at the display position of the settlement at this mission objective.
PositionVector4VoidReturns the position of this mission on the campaign map
ImagePathStringVoidReturns the file path to the image for this mission
CharacterContextAtObjectiveDisplayPositionCcoCampaignCharacterFloat (optional)Returns the character located at the display position of this mission objective. You can optionally specify a floating point argument as the additional search radius.
IsObjectiveOverSettlementWithGarrisonedArmyBoolVoidReturns true if the display position for the mission objective is over a settlement that has an army stationed in it.
TargetSettlementContextCcoCampaignSettlementVoidReturns the target settlement if applicable. You could first use HasZoomLocation to check if this mission has a valid target.
IsPrologueStoryMissionBoolVoidReturns true if this is a story line mission for prologue, we show some special fx on events related to these
TargetCharacterContextCcoCampaignCharacterVoidReturns the target character if any. You could first use HasZoomLocation to check if this mission has a valid target.
CanBeCancelledBoolVoidReturns true if the mission can be cancelled
QuestCharacterContextCcoCampaignCharacterVoidReturns the quest character context if this mission is a quest battle
IsVictoryConditionBoolVoidReturns whether this mission is a campaign victory condition
BattleSetupInfoContextCcoBattleSetupInfoVoidReturns the battle setup info context for this mission
IsTeleportEnabledBoolVoidReturns whether teleport is enabled for this mission
FactionContextCcoCampaignFactionVoidReturns the faction context for this mission
ShouldShowTeleportButtonBoolVoidReturns whether to show the teleport button for this mission
IsPinnedBoolVoidReturns whether the mission is pinned
MissionRecordContextCcoMissionRecordVoidReturns the mission record context for this mission
IsQuestBoolVoidReturns whether the mission is a quest
DevCompleteVoidVoidCompletes the mission, dev onlydebug
CancelMissionVoidVoidCancels this mission
MissionIssuerContextCcoMissionIssuerRecordVoidReturns the mission issuer context for this mission
CompletedBoolVoidReturns whether the mission is completed
ShowInSchemesPanelVoidVoidShows the schemes panel and selects this scheme (if it is a scheme)
MissionDefinitionContextCcoCampaignMissionDefinitionVoidReturns the mission definition context for this mission
IsCancelledBoolVoidReturns whether the mission is cancelled
ShowObjectivePanelVoidVoidShows the mission panel
QuestBattleWinChanceFloatVoidReturns the chance of winning the quest battle associated with this mission
HasZoomLocationBoolVoidReturns whether the mission has a zoom location
ZoomToLocationVoidVoidZooms the camera to the location of this mission
BecameInactiveThisTurnBoolVoidReturns true if the mission went from active to expired/succeded/cancelled this turn
IsObjectivePanelOpenBoolVoidReturns whether the objective panel is open
TurnsRemainingIntVoidReturns the number of turns remaining for this mission
TeleportCharacterVoidVoidTeleports the selected character or character associated with this mission to the quest battle for this mission
BattleSetPieceArmyListCcoBattleSetPieceArmyRecord (list)VoidReturns a list with the armies in the battle piece setup
CompletionStatusIntVoidReturns the completion status. 0 Active, 1 Succeeded, 2 Cancelled, 3 Expired
ShowMissionPanelVoidVoidShows the mission panel with this mission selected
MainOpponentArmyCcoBattleSetPieceArmyRecordVoidReturns the main (non-reinforcement) opponent army in the battle piece setup
TeleportReasonTooltipUniStringVoidReturns the teleport reason tooltip for the mission. Why you can or cannot teleport
PinMissionVoidVoidPins this mission
SettlementContextAtObjectiveDisplayPositionCcoCampaignSettlementVoidReturns the settlement located at the display position of this mission objective.
MoviePathStringVoidReturns the file path to the movie for this mission

CcoCampaignMissionDefinition

Component context wrapper for a CAMPAIGN_MISSION_DEFINITION

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PrimaryPayloadInfoContextCcoCampaignPayloadInfoVoidReturns the primary payload info context
FactionIssuerContextCcoCampaignFactionVoidReturns the faction context of the issuer
TurnLimitIntVoidReturns the mission turn limit
IdentifierStringVoidReturns the mission identifier
IssuerIconStringVoidReturns the mission issuer icon file path
IssuerNameUniStringVoidReturns the name of the mission issuer, if there is one
DescriptionUniStringVoidReturns the description for the mission
HeaderUniStringVoidReturns the header for the mission definition
HasCurrentTargetFactionBoolCcoFactionRecordReturns true if any of the mission objectives targets the provided faction
PrimaryTimedFailurePayloadInfoListCcoPair (list)VoidReturns a list of CcoPair, each containing a timed failure payload and the remaining time of the payload
PrimaryTimedPayloadInfoListCcoPair (list)VoidReturns a list of CcoPair, each containing a timed payload and the remaining time of the payload
SecondaryObjectivesListCcoCampaignMissionObjective (list)VoidReturns the list of secondary objective contexts
PrimaryObjectivesListCcoCampaignMissionObjective (list)VoidReturns the list of primary objective contexts
SecondaryFailurePayloadInfoListCcoCampaignPayloadInfo (list)VoidReturns the list of the secondary failure payload info contexts
SecondaryPayloadInfoListCcoCampaignPayloadInfo (list)VoidReturns the list of the secondary payload info contexts
PrimaryFailurePayloadInfoContextCcoCampaignPayloadInfoVoidReturns the primary failure payload info context

CcoCampaignMissionObjective

Component context wrapper for a CAMPAIGN_MISSION_OBJECTIVE

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsPerformRiteObjectiveBoolVoidReturns whether this is an objective to perform a ritual
IsScriptedObjectiveBoolVoidReturns whether this is a scripted objective
CanTrackProgressBoolVoidReturns whether progress can be tracked on this mission
ObjectiveRequirementsListCcoCampaignMissionObjectiveRequirements (list)Bool (optional)Returns the mission objective requirements list
ObjectiveCancelledBoolVoidReturns whether the objective has been cancelled
ObjectiveCompletedBoolVoidReturns whether the objective has been completed
ScriptKeyStringVoidReturns the script key for this objective if it is a scripted objective or an empty string
IsCurrentTargetFactionBoolCcoFactionRecordReturns true if the current target faction is provided
TargetFactionRecordContextCcoFactionRecordVoidReturns the target faction record
MaxProgressValueIntVoidReturns the max progress value
CurrentProgressValueIntVoidReturns the current progress value

CcoCampaignMissionObjectiveRequirements

Component context wrapper for a CAMPAIGN_MISSION_COMPLETION_STATUS_LINE

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitRecordContextCcoMainUnitRecordVoidReturns the optional unit record context of this objective
BuildingLevelRecordContextCcoBuildingLevelRecordVoidReturns the optional building level record context of this objective
TechnologyRecordContextCcoTechnologyRecordVoidReturns the optional technology record context of this objective
ZoomToVoidVoidZooms the campaign camera to the objective's zoom to location
HasZoomToLocationBoolVoidReturns whether the objective has a zoom to location
IsCompletedBoolVoidReturns whether the objective has been completed
TooltipUniStringVoidReturns the tooltip of the objective
DescriptionUniStringVoidReturns the description of the objective

CcoCampaignNegotiation

Component context wrapper for a campaign negotiation

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TargetFactionContextCcoCampaignFactionVoidReturns the target faction (the non player faction in the negotiation)

CcoCampaignPayloadInfo

Wrapper for a payload, a payload is basically a reward from say a mission. Contains multiple CcoCampaignPayloadInfoEntry

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EntriesCcoCampaignPayloadInfoEntry (list)VoidReturns the list of CcoCampaignPayloadInfoEntry entries for this payload

CcoCampaignPayloadInfoEntry

Wrapper for a payload entry, a payload is basically a reward from say a mission, this is one entry from the list accessed by CcoCampaignPayloadInfo

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
StateStringVoidReturns the state to use in layout, this is either thte rarity state of the ancillary, if no ancillary just returns 'effect'
IconStringVoidReturns icon filepath to use
TitleUniStringVoidReturns localised name of payload entry reward
NumericValueIntVoidReturns the numeric value of a treasury reward, pooled resource transaction etc. without the rest of the text description, if not applicable, just returns 0
SortOrderIntVoidReturns sort order of the payload
UnitRankIntVoidReturns the unit rank, will return 0 if the payload doesn't provide a unit
IsAccessibleBoolVoidReturns true if payload is accessible (with DLC permissions)
IsUnitPayloadBoolVoidReturns true if there is a UnitRecordContext
UnitRecordContextCcoMainUnitRecordVoidReturns the CcoMainUnitRecord provided by the payload if there is any
TraitLevelRecordContextCcoCharacterTraitLevelRecordVoidReturns the CcoCharacterTraitLevelRecord provided by the payload if there is any
AncillaryCcoAncillaryRecordVoidReturns the CcoAncillaryRecord provided by the payload if there is any
EffectBundleCcoEffectBundleVoidReturns the CcoEffectBundle provided by the payload if there is any
TurnsRemainingIntVoidReturns how many turns the payload lasts

CcoCampaignPendingAction

Cco wrapper for getting information on the current pending action in campaign. There can only ever be one hence this being a singleton that basically wraps the pending action manager instead of the pending actions themselves, as would be quite involved to wrap those lifetimes

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionUniStringVoidReturns localised description of current pending action
ActionTypeStringVoidReturns UNlocalised name of current pending action
InvolvedFactionListCcoCampaignFaction (list)VoidReturns list of factions involved in this action
OwningFactionContextCcoCampaignFactionVoidReturns owning faction who has main responsibility of resolving this action
ZoomToVoidVoidZooms to location if HasZoomLocation is true
HasZoomLocationBoolVoidReturns true if has a location can zoom to
HasTimerBoolVoidReturns true if the pending action has a timer
TimeRemainingFloatVoidReturns timer value of the pending action as a float
ShouldBlockAllInteractionsBoolVoidReturns true if IsBlockingLocalPlayer and certain action types (like fullscreen media) which require to disable all interaction with campaign to avoid desyncs
IsBlockingLocalPlayerBoolVoidReturns true if the current pending action is blocking the local player (as in there is an action and we arent involved)
IsActiveBoolVoidReturns true if there is currently a pending action active (which blocks other players in simultaneous turns mpc)

CcoCampaignPendingActionNotification

Component context wrapper for an individual notification/warning for CcoCampaignPendingActionNotificationQueue

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionUniStringVoidReturns localised detailed description from end_turn_notification record
DisplayTextUniStringVoidReturns localised display text from end_turn_notification record
TitleUniStringVoidReturns localised title from end_turn_notification record
PooledResourceContextCcoCampaignPooledResourceVoidReturns the CcoCampaignPooledResource related to notification if exists
FactionContextCcoCampaignFactionVoidReturns the CcoCampaignFaction related to notification if exists
MilitaryForceContextCcoCampaignMilitaryForceVoidReturns the CcoCampaignMilitaryForce related to notification if exists
ProvinceContextCcoCampaignProvinceVoidReturns the CcoCamapignProvince related to notification if exists
SettlementContextCcoCampaignSettlementVoidReturns the CcoCampaignSettlement related to notification if exists
CharacterContextCcoCampaignCharacterVoidReturns the CcoCampaignCharacter related to notification if exists
ActivateVoidVoidActivates the notification, taking context sensitive action (like opening tech panel for tech available for example)
CanBeSupressedBoolVoidReturns true if this notification can be suppressed
IsSkippableBoolVoidReturns true if this notification can be skipped
NotificationTypeStringVoidReturns the notification type from end_turn_notification record
IconPathStringVoidReturns icon path from end_turn_notification record

CcoCampaignPendingActionNotificationQueue

Component context wrapper for end turn notification system (showing notifications/warnings to take care of before end turn)

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AreNotificationsVisibleBoolVoidReturns true if notification system currently activated
CurrentContextCcoCampaignPendingActionNotificationVoidReturns the current CcoCampaignPendingActionNotification to show in UI (we have cycle functionality in wh3)
NotificationsListContextListVoidReturns list of CcoCampaignPendingActionNotification that are currently active (showing on WH3 UI on end turn area)
PendingActionsOfTypeListContextListStringReturns list of CcoCampaignPendingActionNotification matching specified type string (matching key in notifications table in db)
PendingActionsOfItemListContextListContextReturns list of CcoCampaignPendingActionNotification that involve specified context (CcoCampaignMilitaryForce/CcoCampaignCharacter/CcoCampaignSettlement/CcoCampaignFaction)
PendingActionsOfCategoryListContextListStringReturns list of CcoCampaignPendingActionNotification matching specified category (army/character/region/faction)
PendingActionListContextListVoidReturns full list of current CcoCampaignPendingActionNotification to be aware of before ending turn
SkipCurrentContextVoidVoidSkips current notification, essentially suppressing it for this turn
CycleNotificationVoidBoolCycles through the current CurrentContext through NotificationsList (pass true for forwards, false for backwards)
SetAllNotificationsSuppressedVoidBoolSets the suppression of all types of notification.
ToggleSupressNotificationTypeVoidString, Bool (optional)Toggles suppression of a specific type of notification for specified notification key from db. If pass true as a second parameter, will ignore if db specifies if this can be suppressed (used for script)
SetActiveVoidVoidTurns the notification system on
ToggleNotificationsVoidVoidToggles the notification system to be on/off
IsNotificationTypeSupressedBoolStringReturns true if specified type has been suppressed
IsNotificationListEmptyBoolVoidReturns true if there are currently no notifications so can just end turn

CcoCampaignPlagueComposition

Wrapper for a plague composition (base plague plus ingredients)

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ReductionPostSpreadPercentageFloatCcoCampaignFactionReturns an float between with the percentage spread change reduction after spreading
ImmunityDurationIntCcoCampaignFactionReturns an int with the immunity duration of a target after being infected
InfectionDurationForTargetIntCcoCampaignFaction, ContextReturns an int with the duration of this compositio for the passed in target
InfectionDurationIntCcoCampaignFactionReturns an int with the duration of this composition
CombinedEffectsAndTypeListCcoPlagueEffectList (list)ExpressionState, Bool, CcoCampaignFaction (optional)Returns a list of combined effects from base and ingredients, grouped by type as a CcoPair. First in CcoPair is either list of CcoEffect if bool parameter is false or list of CcoCampaignPlagueCompositionEffectList is bool is true. Second returns the type
PlagueIngredientListCcoCampaignPlagueIngredient (list)VoidReturns a list of plague ingredients in the infection data
SpecialCompositionForFactionContextCcoPlagueSpecialCompositionRecordCcoCampaignFactionReturns the special composition for this combination of plague and ingredients for the passed in faction, if any
BasePlagueContextCcoCampaignBasePlagueVoidReturns the plague record context in the infection data
NameUniStringVoidReturns the name of the composition. Will be either the name of the reciepe if exists, if not the combination of base and ingredients
SpreadChanceToForceFloatCcoCampaignMilitaryForce, CcoCampaignFactionReturns the chance for this plague to spread to a specific military force for the creator
SpreadChanceToRegionFloatCcoCampaignSettlement, CcoCampaignFactionReturns the chance for this plague to spread to a specific region for the creator
SpreadChanceToForcesPercentageFloatCcoCampaignFactionReturns an float between with the percentage the spread change for force targets
SpreadChanceToRegionsPercentageFloatCcoCampaignFactionReturns an float between with the percentage the spread change for region targets

CcoCampaignPlagueCompositionEffectList

A small class to wrap an effect list with a plague or ingredient where it came from (to avoid nesting CcoPairs)

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PlagueOrIngredientContextContextVoidReturns the plague or ingredient that the effect bundle belongs to
EffectListCcoEffect (list)VoidReturns the list of effects

CcoCampaignPlagueInfection

Wrapper for a campaign REGION_INFECTION or MILITARY_FORCE_INFECTION

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SpreadChanceToForcesPercentageFloatVoidReturns an float between with the percentage the spread change for force targets
SpreadChanceToRegionsPercentageFloatVoidReturns an float between with the percentage the spread change for region targets
ReductionPostSpreadPercentageFloatVoidReturns an float between with the percentage spread change reduction after spreading
ImmunityDurationIntVoidReturns an int with the immunity duration of a target after being infected
RemainingDurationIntVoidReturns an int with the remaining duration of this infection
InfectionDurationIntVoidReturns an int with the base duration of this infection
EffectBundleListCcoEffectBundle (list)VoidReturns a list of CcoEffectBundle with the effect bundles provided by the infection
PlagueCompositionContextCcoCampaignPlagueCompositionVoidReturns a CcoCampaignPlagueComposition with the plague composition context
NameUniStringVoidReturns the name of the composition. Will be either the name of the reciepe if exists, if not the combination of base and ingredients

CcoCampaignPlagueIngredient

Wrapper for a campaign plague component

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ImagePathStringVoidReturns the image path of the plague component record
KeyStringVoidReturns the key of the plague component record
CooldownDurationIntCcoCampaignFaction (optional)Returns the number of turns left for cooldown, or 0 if none
UIOffsetVector4VoidReturns the offset used by the UI, or {0, 0} if none
PlagueParametersRecordContextCcoPlagueParameterRecordVoidReturns the plague parameters for this component
RequiredTechnologyContextCcoCampaignTechnologyVoidReturns the required technology needed to unlock this ingredient
ResourceTransactionContextCcoCampaignResourceTransactionVoidReturns the resource transaction context with the cost of this ingredient
UnlockTooltipUniStringCcoCampaignFaction (optional)Returns the reason with how to unlock the ingredient for the faction passed in (or for players faction if no faction is passed)
IsMutationBoolVoidReturns true if the component is a mutation
IsBlessedBoolCcoCampaignFaction (optional)Returns true if the component is blessed for the faction passed in (or for players faction if no faction is passed)
IsOnCooldownBoolCcoCampaignFaction (optional)Returns true if the component is on cooldown for the faction passed in (or for players faction if no faction is passed)
IsUnlockedBoolCcoCampaignFaction (optional)Returns true if the component is unlocked for the faction passed in (or for players faction if no faction is passed)
IsAvailableBoolCcoCampaignFaction (optional)Returns true if the component is available for the faction passed in (or for players faction if no faction is passed)
PlagueEffectContextCcoPlagueEffectRecordVoidReturns a CcoPlagueEffectRecord which contains all effect bundles for this ingredient
DescriptionUniStringVoidReturns the description of the plague component record
NameUniStringVoidReturns the name of the plague component record

CcoCampaignPlaguesCompositionSystem

Wrapper for a campaign plagues composition system

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PlagueSpecialCompositionListCcoPlagueSpecialCompositionRecord (list)VoidReturns a the list of special compositions that the faction has access to
PlagueIngredientsListCcoCampaignPlagueIngredient (list)VoidReturns a the list of plague ingredients that the faction has access to
DevUnlockPlaguesVoidVoidUnlock all base plagues and componentsdebug, hide_in_uied
HasAvailablePlagueComponentsBoolVoidChecks if the human player has access to any usable plague components
InfectTargetVoidCcoCampaignPlagueComposition, ContextInfects the passed in target with the passed in plague composition
BasePlagueListCcoCampaignBasePlague (list)VoidReturns a list will the faction plagues, if any
CompositionAndTargetPairCcoPairContext, ContextReturns a CcoPair created from the infection and target passed in, to be used for rituals
PlagueCompositionContextCcoCampaignPlagueCompositionCcoCampaignBasePlague, ContextListReturns the a plague composition cco that will be created from the plague record and plague ingredients passed in

CcoCampaignPooledResource

Wrapper for a campaign pooled resource

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectBundleUnfilteredListCcoEffectBundle (list)CcoCampaignFaction (optional)Returns a list of effect bundles active due to pooled resource. Can optionally specify faction to get effects for. If none specified, will get effects of owning faction of this resource. Includes those that wont shown in UIhide_in_uied
PendingFactorTotalIntVoidReturns the total of the pending factor list
OwningFactionContextCcoCampaignFactionVoidReturns the faction that owns this context if any
TooltipAudioStringVoidReturns the associated tooltip VO event
EffectBundleListCcoEffectBundle (list)CcoCampaignFaction (optional)Returns a list of effect bundles active due to pooled resource. Can optionally specify faction to get effects for. If none specified, will get effects of owning faction of this resource. Prefiltered to not include those that shouldnt appear in UI
TotalIntExpressionStateReturns the current total value (not factor total, this is the current amount)
MilitaryForceBreakdownContextCcoCampaignPooledResourceMilitaryForceBreakdownCcoCampaignMilitaryForceReturns the breakdown context for this pooled resource on the specified military force
PercentageOfCapacityPostTransactionFloatFloat, Float (optional)Returns the percentage value of the current resource value with another value added to it
IconPathStringVoidReturns the icon filepath
FactorTotalIntVoidReturns the total of all the current factors (not same as total, as factors could be leading to Total changing per turn)
SettlementBreakdownContextCcoCampaignPooledResourceSettlementBreakdownCcoCampaignSettlementReturns the breakdown context for this pooled resource on the specified settlement
PositiveFactorTotalIntVoidReturns the total of all the current positive factors
KeyStringVoidReturns the record key
PredictedPercentageOfCapacityFloatFloat (optional)Returns the prediced percentage value of max on the next turn
ProvinceBreakdownContextCcoCampaignPooledResourceProvinceBreakdownCcoCampaignProvinceReturns the breakdown context for this pooled resource on the specified province
NegativeFactorTotalIntVoidReturns the total of all the current negative factors
AchievementThresholdSetListCcoPooledResourceThresholdOperationSetRecord (list)VoidReturns a list of thresholds that can be unlocked with achievements
TotalAndChangeStringUniStringExpressionStateReturns a localised text display of total with change (like: 10 (+20)), as a convenient function to display this in most places we show resources (as usually useful to know total/change at a glance like with treasury)
PercentageOfCapacityFloatExpressionState, Float (optional), Float (optional)Returns the current percentage the value is of the max
ActiveThresholdSetListCcoPooledResourceThresholdOperationSetRecord (list)VoidReturns a list of active threshold sets, which have a range that confers effects and armory items
DescriptionUniStringVoidReturns the localised description
PredictedTurnsToReachAmountIntInt, Int (optional)Returns the predicted number of turns needed to reach a certain amount. Optionally you can specify an extra delta for the current amount.
NegativePendingFactorListCcoStringValue (list)VoidReturns a list of the pending factors that can be negative (but aren't necessarily currently)
AvailableThresholdSetListCcoPooledResourceThresholdOperationSetRecord (list)VoidReturns a list of available threshold sets, which have a range that confers effects and armory items
NegativeFactorsNameUniStringVoidReturns the localised name given for the negative factors
TotalPostTransactionIntExpressionState, IntReturns the total value after applying a transaction with a passed value to add
PositivePendingFactorListCcoStringValue (list)VoidReturns a list of the pending factors that can be positive (but aren't necessarily currently)
PendingFactorsNameUniStringVoidReturns the localised name given for the pending factors
RangedTierListCcoRangeWithContext (list)ExpressionState, String (optional)Returns a list of effects with tiers so can see effects at each tier of values
PendingFactorListCcoStringValue (list)VoidReturns the list of pending factors that will be added to the value in the next turn
PositiveFactorsNameUniStringVoidReturns the localised name given for the positive factors
NextGroupPooledResourceEffectContextCcoGroupPooledResourceEffectRecordExpressionState, String (optional)Returns the next CcoGroupPooledResourceEffectRecord. Optionally can specify an effect type, defaults to percentage of capacity effect type
NameUniStringVoidReturns the localised name
AreFactorsDBSortedBoolVoidReturns true if any factor junction for this resource has a non-zero sort_order in the database.
SortOrderIntVoidReturns the sort order for this pooled resource (for when have multiple linked pooled resources like corruption)
PredictedGroupPooledResourceEffectContextCcoGroupPooledResourceEffectRecordExpressionState, Int, String (optional)Returns the CcoGroupPooledResourceEffectRecord taking into account a delta amount to apply to the total. Optionally can specify an effect type, defaults to percentage of capacity effect type
CurrentGroupPooledResourceEffectContextCcoGroupPooledResourceEffectRecordExpressionState, String (optional)Returns the current CcoGroupPooledResourceEffectRecord. Optionally can specify an effect type, defaults to percentage of capacity effect type
InitialMaxIntVoidReturns the maximum value specified in the record, so that we can display the original value even after getting changed by effects
NegativeFactorListCcoStringValue (list)VoidReturns a list of the factors that can be negative (but aren't necessarily currently)
PositiveFactorListCcoStringValue (list)VoidReturns a list of the factors that can be positive (but aren't necessarily currently)
MaxIntVoidReturns the maximum value
ReverseEffectBarPercentageFloatExpressionState, String (optional)Returns the bar percentage starting from the current max based on effect bounds. Optionally can specify an effect type, defaults to percentage of capacity effect type
MinIntVoidReturns the minimum value
ShouldDisplayZeroFactorsBoolVoidReturns true if the resource should always display zero factors
FactorListCcoStringValue (list)VoidReturns list of factors that are contributing to current value
DevAddAmountVoidIntadds a specified amount to this pooled resource by going through factors and adding values until value change by amount we specify). Can use negatives.debug, hide_in_uied
EffectBarPercentageFloatExpressionState, Bool, String (optional), Int (optional)Returns the bar percentage based on effect bounds. The last effect can be ignored and will be always full as soon at the total becomes more than the lower bound. Optionally can specify an effect type, defaults to percentage of capacity effect type
EffectBundleForPercentListCcoEffectBundle (list)Float, CcoCampaignFaction (optional)Returns a list of effect bundles that would be active at the specified percent value. Can optionally specify faction to get effects for. Prefiltered to not include those that shouldnt appear in UI
TotalLessThanZeroAndNotCertainResourcesBoolExpressionStateReturns true if this pooled resource has a negative total and isnt specific hardcoded resources (sigh, added in wh2)
PercentageToNextEffectFloatExpressionState, String (optional)Returns the percentage of the way to the next effect
EffectListCcoGroupPooledResourceEffectRecord (list)ExpressionState, String (optional)Returns the current effects active due to this pooled resource. Optionally can specify an effect type, defaults to percentage of capacity effect type
IsPersistentResourceBoolVoidReturns true if this pooled resource has persistant factors (as in they arent evaluated per turn and instead stockpile)

CcoCampaignPooledResourceDistributor

Wrapper for a pooled resource distributor. Can exist on anything that has an ENTITY_ID

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SetDistributionEnabledVoidCcoCampaignPooledResource, BoolSets whether this entity allows pooled resource distribution for the provided pooled resource
IsDistributionEnabledBoolCcoCampaignPooledResourceReturns whether distribution of the specified pooled resource is allowed to this entity

CcoCampaignPooledResourceManager

Context wrapper for pooled resource manager.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanAffordSpecificPooledResourceCostBoolCcoCampaignPooledResourceTransactionReturns true if can afford the specific pooled resource cost specified by provided CcoCampaignPooledResourceTransaction
CanAffordResourceCostBoolCcoResourceCostRecordReturns true if can afford the resource cost of the specified resource cost record
CanAffordPooledResourceCostBoolCcoCampaignResourceTransactionReturns true if can afford the pooled resource cost of the specified resource transaction
CanAffordBoolCcoCampaignResourceTransactionReturns true if can afford the resource cost of the specified resource transaction
PooledResourceContextCcoCampaignPooledResourceStringReturns the pooled resource context with the specified resource key, if it exists in this pooled resource manager.
HasRequiredTradeResourcesBoolCcoCampaignResourceTransactionReturns true if this transaction has the required trade resources
CanAffordTreasuryCostBoolCcoCampaignResourceTransactionReturns true if can afford the treasury cost of the specified resource transaction

CcoCampaignPooledResourceMilitaryForceBreakdown

Wrapper for a military force breakdown of a pooled resource

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactorListCcoStringValue (list)VoidReturns a list of factors for this pooled resource in this force
FactorValueIntStringReturns value of a specific factor given the specified factor key
FactorTotalIntVoidReturns the total value from the factor list
TotalIntVoidReturns the total amount of pooled resource in this force
PooledResourceContextCcoCampaignPooledResourceVoidReturns the pooled resource this breakdown is for
NegativeFactorListCcoStringValue (list)VoidReturns a list of only the factors that can be negative (but arent necessarily right now)
PositiveFactorListCcoStringValue (list)VoidReturns a list of only the factors that can be positive (but arent necessarily right now)

CcoCampaignPooledResourceProvinceBreakdown

Wrapper for a province breakdown of a pooled resource

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactorValueIntStringReturns value of a specific factor given the specified factor key
FactorTotalIntVoidReturns the total value from the factor list
TotalIntVoidReturns the total amount of pooled resource in this province
PooledResourceContextCcoCampaignPooledResourceVoidReturns the pooled resource this breakdown is for
NegativeFactorListCcoStringValue (list)VoidReturns a list of only the factors that can be negative (but arent necessarily right now)
PositiveFactorListCcoStringValue (list)VoidReturns a list of only the factors that can be positive (but arent necessarily right now)
FactorListCcoStringValue (list)VoidReturns a list of factors for this pooled resource in this province

CcoCampaignPooledResourceSettlementBreakdown

Wrapper for a region/settlement breakdown of a pooled resource

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactorValueIntStringReturns value of a specific factor given the specified factor key
FactorTotalIntVoidReturns the total value from the factor list
TotalIntVoidReturns the total amount of pooled resource in this settlement
PooledResourceContextCcoCampaignPooledResourceVoidReturns the pooled resource this breakdown is for
NegativeFactorListCcoStringValue (list)VoidReturns a list of only the factors that can be negative (but arent necessarily right now)
PositiveFactorListCcoStringValue (list)VoidReturns a list of only the factors that can be positive (but arent necessarily right now)
FactorListCcoStringValue (list)VoidReturns a list of factors for this pooled resource in this settlement

CcoCampaignPooledResourceTrackedFaction

Wrapper for a pooled resource tracked faction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetDilemmasSortedCcoDilemmaRecord (list)VoidReturns a list of dilemma record contexts sorted by 1. increasing order of the amount of settlements required, 2. increasing order of their number of choices
GetDilemmasCcoDilemmaRecord (list)VoidReturns a list of dilemma record contexts
GetBestAvailableDilemmaContextCcoDilemmaRecordVoidReturns the CcoDilemmaRecord for the best dilemma that can be performed currently using this tracked faction
GetActiveDilemmaRitualContextCcoCampaignRitualVoidReturns the active CcoCampaignRitual of Asur Domination Category if there is any.
TrackedResourceContextCcoCampaignPooledResourceVoidReturns a CcoCampaignPooledResource context for the resource the tracking faction is using to track this tracked faction
FactionLeaderContextCcoCampaignCharacterVoidReturns a CcoCampaignCharacter context for the faction leader of the tracked faction
TrackingFactionContextCcoCampaignFactionVoidReturns a CcoCampaignFaction context for the tracking faction
FactionContextCcoCampaignFactionVoidReturns a CcoCampaignFaction context for the tracked faction
WasConfederatedByTrackingFactionBoolVoidReturns true if this tracked faction was confederated by its tracking faction
HasNumSettlementsRequiredForDilemmaBoolCcoDilemmaRecordReturns true if we have gifted enough settlements to this tracked faction to activate this dilemma
GetNumSettlementsRequiredForDilemmaIntCcoDilemmaRecordReturns the amount of settlements required to be owned to unlock the specified dilemma
UniqueChoicesForDilemmaCcoCdirEventsDilemmaChoiceDetailRecord (list)CcoDilemmaRecordReturns a list of the dilemma choices without including the choices found in dilemmas unlocked before it
GetUnlockedDilemmasCcoDilemmaRecord (list)VoidReturns a list of dilemma record contexts that are currently unlocked

CcoCampaignPooledResourceTransaction

Context wrapper for pooled resource transactions.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ValuePercentageIntVoidReturns the value as a percentage of max could be
OrderIntVoidReturns the sort order
AbsoluteValueIntVoidReturns the absolute value (always positive)
ValueIntVoidReturns the value
DescriptionUniStringVoidReturns the localised description
NameNegativeUniStringVoidReturns the localised name to show when negative
NamePositiveUniStringVoidReturns the localised name to show when positive
LocalisedTextUniStringVoidReturns the localised text which is value and name combination
NameUniStringVoidReturns the localised name
IconStringVoidReturns the icon path for the transaction
ResourceKeyStringVoidReturns the resource record key
SupplementColourColourVoidReturns the colour for the transaction

CcoCampaignProvince

Wrapper for a campaign province.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CapitalSettlementContextCcoCampaignSettlementVoidReturns the context of the capital settlement of this province
EntitySharedStateValueExistsBoolStringTakes a String id, and returns if there's any state stored with that id.registry
PlayerFactionForeignSlotIncomeIntVoidReturns the province income that the player makes from foreign slots
IsPlayerCompleteOwnerBoolVoidReturns true if player owns all the settlements in the province
ZoomToVoidVoidZooms to capital of province
PatronFactionContextCcoCampaignFactionVoidReturns the patron faction this province is associated with if there is one set in patron_faction_to_associated_provinces table
IsPlayerInvolvedBoolVoidReturns true if the player faction own any regions in this province.
MercenaryPoolContextCcoCampaignProvinceMercenaryPoolVoidReturns the context of mercenary pool of this province
IncomeIntVoidReturns the income that this province generates
FactionContextCcoCampaignFactionVoidReturns the faction that owns all settlements in the province. If there is no such faction, returns nullptr
ModelProvinceContextCcoCampaignModelProvinceVoidReturns the CcoCampaignModelContext for this province
IsContestedBoolVoidReturns true if it's being contested by another faction.
WindsOfMagicAreaContextCcoCampaignWindsOfMagicAreaVoidReturns the context of the winds of magic area in this province.
DevAddGrowthVoidIntDev command that adds or removes growth points from this province.debug, hide_in_uied
SelectAndZoomVoidVoidSelects and zooms to a settlement in this order: player capital, player owned settlement, province capital.
DevRemoveDevPointVoidVoidDev command that removes development points from this province.debug, hide_in_uied
IsSelectedBoolVoidReturns true if any settlement in this province is selected.
NumRegionsIntVoidReturns an int with the number of regions in the province.
DevAddDevPointVoidVoidDev command that adds development points to this province.debug, hide_in_uied
SettlementListContextListVoidReturns the settlement list in the province.
PooledResourceManagerContextCcoCampaignPooledResourceManagerVoidReturns the context of the pooled resource manager of this province, which can calculate if the province can afford transactions.
PersistentPooledResourceManagerContextForFactionCcoCampaignPooledResourceManagerCcoCampaignFactionReturns the context of the persistent pooled resource manager of the specified faction, if it exists in this province.
KeyStringVoidReturns the record key for this province.
NameUniStringVoidReturns the localised name of the province.
ProvinceManagerForFactionCcoCampaignFactionProvinceManagerCcoCampaignFactionReturns the context of the province manager of the faction that is passed in, if it exists in this province.
EntitySharedStateReadStringStringStringTakes a String id, and returns stored string value in shared state for this province with that key. Value will be empty if doesnt exist in registry.registry
LocalPlayerProvinceManagerContextCcoCampaignFactionProvinceManagerVoidReturns the context of the local player province manager, if this exists in this province.
PooledResourceListContextListVoidReturns a list with all the pooled resources from this province.
EntitySharedStateReadBoolBoolStringTakes a String id, and returns stored bool value in shared state for this province with that key. Value will be false if doesnt exist in registry.registry
EntitySharedStateReadFloatFloatStringTakes a String id, and returns stored float value in shared state for this province with that key. Value will be -1 if doesnt exist in registry.registry
PooledResourceContextCcoCampaignPooledResourceStringReturns the context of the pooled resource with the key specified, if this resource exists in the province.
CQIIntVoidReturns an int with the cqi of this object.

CcoCampaignProvinceAutoManagement

Wrapper for province auto-management logic

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ChooseFocusVoidCcoProvinceAutomanagementFocusRecordChooses a focus for this province
ToggleHighPriorityVoidVoidSets this province as high priority, or sets it as normal priority if already high priority
CurrentFocusContextCcoProvinceAutomanagementFocusRecordVoidReturns the current focus records that is selected in this province
FocusListCcoProvinceAutomanagementFocusRecord (list)VoidReturns a list of focus records that can be set for this province
ToggleAutoManagingVoidVoidActivates the auto management for this province or deactivates it if already active
IsHighPriorityBoolVoidReturns true if the province is currently considered as high priority
IsAutoManagingBoolVoidReturns true if the province is currently being auto managed by the AI

CcoCampaignProvinceGovernorship

Wrapper for a province governorship

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsOnCooldownBoolVoidReturns true if the effects of the governor are on cooldown
CharacterDetailsContextCcoCampaignCharacterVoidReturns the detail of the character that governs this province
PendingDecisionContextCcoCampaignDecisionRecordVoidReturns the pending decision for this governorship if it exists
ProvinceContextCcoCampaignProvinceVoidReturns the context of the province for this governorship

CcoCampaignPublicOrder

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProvidedEffectBundleVoidVoid
HappinessRangeEffectBundleListVoidVoid
DetailsVoidVoid
BalancePercentageVoidVoid
BreakdownListVoidVoid
ChangePerTurnStateVoidVoid
ChangePerTurnVoidVoid
StateVoidVoid
BalanceVoidVoid

CcoCampaignResourceTransaction

Context wrapper for resource transactions.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AddCcoCampaignResourceTransactionCcoCampaignResourceTransactionReturns the result of adding 2 transactions together
TradeResourceListCcoResourceRecord (list)VoidReturns the list of required trade resources
TreasuryTransactionListCcoCampaignTreasuryTransaction (list)VoidReturns the list of pooled resource treasure transactions
PooledResourceTransactionListCcoCampaignPooledResourceTransaction (list)VoidReturns the list of pooled resource transactions
CanAffordResourceTransactionBoolCcoCampaignPooledResourceChecks if the passed pooled resource can afford this resource transaction
TotalResourceChangeIntCcoCampaignPooledResourceReturns the absolute resource change (always positive)
AbsoluteTreasuryChangeIntVoidReturns the absolute treasury change (always positive)

CcoCampaignRitual

Wrapper for a campaign ritual

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DevResetCooldownVoidVoidDev function to reset the cooldown of the ritual. This is not intended for use in production code and should only be used for debugging purposes.debug, hide_in_uied
IsScriptLockedBoolContext (optional)Returns true if the ritual is locked by script
CanPerformRitualBoolContext (optional), CcoCampaignCharacter (optional)Returns true if the ritual can be performed. Optional context param for the target, in case the ritual requires one
CanPayloadBeCreatedBoolContext (optional)Returns true if the ritual payload can be created
InvalidTargetReasonUniStringContextReturns a localised string with text explaining why the supplied target isnt valid to perform the ritual on. If valid to perform on, or no target supplied will return empty string
PerformVoidContext (optional), CcoCampaignCharacter (optional)Performs the ritual. Optional context parameter can be a CcoCampaignMilitaryForce, CcoCampaignSettlement or CcoCampaignFaction
RequiresUnlockMissionBoolVoidReturns true if the ritual requires a mission to be unlocked
TargetCriteriaIconStringVoidReturns the custom icon path set for the target criteria
IsRestrictedBoolContext (optional)Returns true if the ritual target is restricted
IsTargetValidBoolContext, CcoCampaignCharacter (optional)Returns true if the provided target is valid. Context parameter can be a CcoCampaignMilitaryForce, CcoCampaignSettlement or CcoCampaignFaction
IsActiveBoolVoidReturns true if the ritual is active
TargetCriteriaTextUniStringBool (optional)Returns a localised string with text explaining the necessary target criteria requirements
LockedByPreviousInChainBoolVoidReturns true if the ritual is locked by having to complete a previous ritual in the same chain
LastCompletedRitualRemainingEffectBundleDurationIntExpressionStateReturns an int with the remaining duration of the longest effect bundle from the last ritual completed
RitualChainContextCcoCampaignRitualChainVoidReturns a context to the ritual chain this ritual belongs to or nullptr if it doesn't belong to any.
RequiresTargetBoolVoidReturns true if the ritual requires a target
IsCompleteBoolVoidReturns true if the ritual is completed
LastCompletedRitualRemainingPayloadDurationIntExpressionStateReturns an int with the remaining duration of the payload of the last ritual completed
RitualContextCcoRitualRecordVoidReturns a context to the ritual
ScriptRequirementsCcoScriptRequirement (list)StringReturns a list of CcoScriptRequirement for this ritual from the given script object id. Looks up ScriptObjectContext(script_object_id), expects a table keyed by ritual DB key to a list of requirement tables, and parses each entry. Returns an empty list if the script object or ritual entry is missing. See CcoScriptRequirement for the expected Lua table schema.
IsRepeatableRitualBoolVoidReturns true if the rituals cooldown_time is not set to -1
CompletedRitualTargetAndDurationListCcoPair (list)ExpressionStateGoes through all completed rituals of this type and returns a list of all targets and their remaining payload duration
ResourceTransactionContextCcoCampaignResourceTransactionContext (optional)Returns a context to the resource transaction
LastCompletedRitualTargetContextContextVoidReturns the context of the target that was used when last performing the ritual
IsDisabledViaBonusValuesBoolVoidReturns true if the ritual is disabled via bonus values. Ignores whether it's locked or not.
UnlockMissionContextCcoMissionRecordVoidReturns the mission record which unlocks this ritual
RitualInteractionContextCcoCampaignRitualInteractionCcoCampaignCharacter (optional)Returns the context of the ritual targeting interface, used for selecting targets in 3d space.
PerformedTimesCountIntVoidReturns how many times this ritual has been performed.
MortuaryCategoryContextCcoMortuaryCultCategoryRecordVoidReturns the mortuary cult category if it exists
IsAvailableBoolVoidReturns true if the ritual is available
TargetTypeStringVoidReturns a string with the type of target this ritual requires. Returns empty string if no target is required.
CanAffordInfluenceCostBoolContext (optional)Returns true if we can afford the influence cost of this ritual
TargetCategoryCooldownUponActivationIntVoidReturns the cooldown for the ritual target category. Faction bonus values are checked.
CanAffordSpecificPooledResourceCostBoolCcoCampaignPooledResourceTransactionReturns true if we can afford the specific pooled resource cost of this ritual
InfluenceCostIntContext (optional)Returns the amount of influence the ritual costs, taking bonus values and custom costs into account
IndexInRitualChainIntVoidReturns the index of the ritual in the ritual chain it belongs to. If it's not a part of a chain it returns -1
TargetCooldownUponActivationIntVoidReturns the cooldown for the ritual target. Faction bonus values are checked.
IsRitualEffectBundleActiveOnTargetBoolContextReturns true if the ritual effect is active on target. Context parameter can be a CcoCampaignMilitaryForce, CcoCampaignSettlement or CcoCampaignFaction
CanAffordTreasuryCostBoolContext (optional)Returns true if we can afford the treasury cost of this ritual
SlaveCostIntVoidReturns the amount of slaves the ritual costs, taking bonus values into account
RemainingCastTimeIntVoidReturns the remaining cast time of the ritual
CooldownUponActivationIntVoidReturns the cooldown for the ritual. Faction bonus values are checked.
CanAffordBoolContext (optional)Returns true if we can afford the cost of this ritual
TargetExpendedResourceTransactionContextCcoCampaignResourceTransactionContextReturns a context to the target expended resource. Target can be a CcoCampaignMilitaryForce, CcoCampaignSettlement or CcoCampaignFaction
FactionContextCcoCampaignFactionVoidReturns the faction context of the ritual
RemainingScriptLockTimeIntVoidReturns the remaining time that the ritual is locked by script
InvalidReasonForRitualWithAnyValidTargetUniStringExpressionState, CcoCampaignCharacter (optional)Returns a localised string with text explaining why the ritual cannot be performed with any of the valid targets it has, or that it has no valid targets if there are none
DefaultFactionTargetContextCcoCampaignFactionVoidReturns the default faction target (if any) this ritual is setup to point at
RemainingCooldownIntVoidReturns the remaining cooldown for the ritual
CanPerformRitualWithAnyValidTargetBoolCcoCampaignCharacter (optional)Checks if there are any valid targets for a ritual that doesn't target self, and if there are returns true if we can perform the ritual with any of those valid targets. Optional param for a performer.
ExpendedResourceTransactionContextCcoCampaignResourceTransactionContext (optional)Returns a context to the expended resource
RitualCompletionEffectBundleDurationIntExpressionStateReturns an int with the duration of the longest effect bundle in the completion payload
IsRitualCategoryActiveBoolVoidReturns true if a ritual category is active
TargetResourceTransactionContextCcoCampaignResourceTransactionContextReturns a context to the target resource. Parameter can be a CcoCampaignMilitaryForce, CcoCampaignSettlement or CcoCampaignFaction
RitualCompletionPayloadDurationIntExpressionStateReturns an int with the completion payload duration
IsOnCooldownBoolBool (optional)Returns true if the ritual is on cooldown
NagashConfederationRitualsToMissionContextCcoNagashConfederationRitualsToMissionRecordVoidReturns the Nagash Confederation Rituals to Mission Context if this ritual has one.
DevUnlockRitualVoidVoidDev function to unlock the ritual. This is not intended for use in production code and should only be used for debugging purposes.debug, hide_in_uied
RemainingRitualCooldownForTargetIntContextReturns the remaining cooldown for a target. Context parameter can be a CcoCampaignMilitaryForce, CcoCampaignSettlement or CcoCampaignFaction
VampireCountsConfederationRitualsToMissionContextCcoVampireCountsConfederationRitualsToMissionRecordVoidReturns the Vampire Counts Confederation Rituals to Mission Context if this ritual has one.
ScriptLockedReasonUniStringVoidReturns the reason for why a ritual is locked by script
RemainingCategoryCooldownForTargetIntContextReturns the remaining cooldown for a target category. Context parameter can be a CcoCampaignMilitaryForce, CcoCampaignSettlement or CcoCampaignFaction
InvalidRitualReasonUniStringExpressionState, Context (optional), CcoCampaignCharacter (optional)Returns a localised string with text explaining why the ritual cannot be performed
CanPayloadBeCarriedOutBoolContext (optional)Returns true if the ritual payload can be carried out

CcoCampaignRitualChain

Wrapper for a live campaign ritual chain, can be used to query position in chain

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NextInChainContextCcoCampaignRitualVoidGet context of next ritual in the chain, if any
LastCompletedOrFirstRitualContextCcoCampaignRitualVoidGet context of last completed ritual in chain, or first if none
LastCompletedContextCcoCampaignRitualVoidGet context of last completed ritual in chain if any completed
RitualChainContextCcoRitualChainRecordVoidGet record context for the chain
RitualsListCcoCampaignRitual (list)VoidGet list of CcoCampaignRituals in the chain

CcoCampaignRitualInteraction

Class that manages targetting interface interaction for a ritual

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ZoomToTargetVoidVoidZooms to the stored target
IsValidTargetBoolContextReturns true if the passed in object is a valid target
IsTargettingActiveBoolVoidReturns true if this is the currently active targetting interface
InvalidReasonsForTargetUniStringContextReturns the reasons why the passed in target is invalid. Returns empty string if valid
RitualContextCcoCampaignRitualVoidReturns the context of the ritual associated with this class.
IsRepeatableBoolVoidReturns true if the ritual is repeatable
WasActionPerformedBoolVoidReturns true if the ritual is completed
IsContextTargetedBoolContextReturns whether the given context is targeted. (Allows child classes to add unique targeting conditions)
CurrentTargetContextContextVoidReturns the context of the current target, if any has been set
SetupInitialTargetFactionVoidCcoCampaignFaction, Bool (optional)Does the initial setup of the factions without notifying. If passed in faction is not valid, sets target to first known faction instead
TargetFactionContextCcoCampaignFactionVoidReturns the target faction context if any
ActionPerformTooltipUniStringVoidReturns a tooltip specifying whether can perform the ritual or not, exmplaining the reason if cannot be performed
CanPerformActionBoolCcoCampaignCharacter (optional)Returns true if can perform ritual with the current target setup
ActionCostCcoCampaignResourceTransactionVoidReturns the cost of the ritual.
PerformActionVoidCcoCampaignCharacter (optional)Performs a ritual with the current target stored
SetTargetVoidContextSets the target to the object passed in
ClearTargetVoidVoidClears the currently stored target
ToggleTargettingVoidVoidToggles the targetting system through the CampaignTargettingInterface.
UpdateTargetFactionVoidBool (optional)Updates the faction with the current targetting interface faction. This is so all targetting interfaces are in sync
EnableTargettingVoidBoolIs passed true, enables this as the targetting interface, else disables it.

CcoCampaignRitualManager

Wrapper for a faction's ritual manager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AvailableRitualListCcoCampaignRitual (list)VoidGet list of available rituals
RemainingRitualCategoryCooldownIntStringIf the category uses global cooldown time, returns the remaining cooldown for rituals in that category
IsRitualCategoryOnCooldownBoolStringReturns true if all rituals from the category are using global cooldown and any of them are on cooldown currently.
IsRitualCategoryUsingGlobalCooldownBoolCcoRitualCategoryRecordReturns true if all rituals in the category have global cooldown time set
IsAnyRitualFromCategoryValidForTargetBoolString, ContextReturns if any ritual from the supplied category is with a valid target from the supplied context
RemainingEffectBundleTurnsOfLastCompletedRitualFromCategoryCcoPairString, Context (optional)Returns the remaining turns for the longest effect bundle of the last completed ritual from the category. CcoPair
RitualChainContextFromCategoryCcoCampaignRitualChain (list)StringReturns list of ritual chains for given ritual category string
RitualChainContextFromKeyCcoCampaignRitualChain (list)StringReturns list of ritual chains matching given key
HasAccessToRitualCategoryBoolCcoRitualCategoryRecordReturns whether faction has access to provided ritual category
RitualContextCcoCampaignRitualCcoRitualRecordGet a CcoCampaignRitual if one exists from a provided ritual record
UnlockableRitualListCcoCampaignRitual (list)VoidGet list of unlockable rituals

CcoCampaignRoot

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProvinceListCcoCampaignProvince (list)VoidReturns list of all provinces in the campaign
SettlementListCcoCampaignSettlement (list)VoidReturns list of all settlements in the campaign
DevTriggerIncidentVoidStringTriggers incident for player faction, only for dev usagedebug, hide_in_uied
CampaignKeyStringVoidReturns the campaign record key
MilitaryForceListCcoCampaignMilitaryForce (list)VoidReturns list of all military forces in the campaign
DateStringUniStringVoidReturns the current data as a localised string
DevTriggerMissionVoidStringTriggers mission for player faction, only for dev usagedebug, hide_in_uied
SetOverlayVisibleVoidBoolSets whether map colouring overlay is visible
CharacterListCcoCampaignCharacter (list)VoidReturns list of all characters in the campaign
TriggerModelScriptNotificationEventVoidCcoCampaignFaction, StringSends a UITriggerScriptEvent to script with specified faction id and key so can have delayed script events to handle (like perform a command and then tell to script to react once command processed for example
RoundNameUniStringVoidReturns the current round name (such as season for example)
CanAdvanceSelectionBoolVoidReturns true if can select next or previous item
FactionListCcoCampaignFaction (list)VoidReturns list of all factions in the campaign
ShowEscapeMenuVoidVoidShows the campaign escape menu
IsTacticalViewActiveBoolVoidReturns true if tactical view is active
RebelFactionContextCcoCampaignFactionVoidReturns the CcoCampaignFaction for rebels
IsLocomotionCompleteBoolVoidReturns true if all character locomotion is complete (no characters moving)
QuickSaveVoidVoidCreates a quick save for campaign
PendingActionContextCcoCampaignPendingActionVoidReturns the pending action context to get information on current pending action (if any)
CanQuickSaveBoolVoidReturns true if can currently save the campaign
DevEndTurnJustForMeVoidVoidEnds the current campaign turn just for local player, skips all other factions turn. Only for dev usage.debug, hide_in_uied
DiplomacyManagerContextCcoCampaignDiplomacyManagerVoidReturns the diplomacy manager context for getting pending negotiations, etc
EndTurnVoidVoidEnds the current campaign turn
CanCycleSelectionBoolVoidReturns true if can currently cycle selection
NotificationQueueContextCcoCampaignPendingActionNotificationQueueVoidReturns the notification queue context
SelectPreviousVoidVoidCycles selection backwards
WindsOfMagicSystemCcoCampaignWindsOfMagicSystemVoidReturns the winds of magic system
IsCinematicModeEnabledBoolVoidReturns true if cinematic mode is currently enabled
SelectNextVoidVoidCycles selection forward
ClearSavedSelectionVoidVoidClears any saved selection in campaign
CursorContextCcoCampaignCursorContextVoidReturns the current cursor context based on current mouseover (to get information on what is moused over)
CampaignMapPlayableAreaRecordContextCcoCampaignMapPlayableAreaRecordVoidReturns the CcoCampaignMapPlayableAreaRecord for the current campaign
ClearSelectionVoidVoidClears any selection in campaign
IsHUDVisibleBoolVoidReturns true if the campaign HUD is currently visible
CampaignFactionCheatSheetListCcoCampaignFactionCheatSheetEntryRecord (list)VoidReturns list of CcoCampaignFactionCheatSheetEntryRecords for the player faction's cheat sheet
ToggleHUDVoidVoidToggles the campaign HUD visibility
IsPlayersTurnBoolVoidReturns true if currently the players turn
OpenTeleportationNodeListCcoTeleportationNetworkNodeRecord (list)VoidReturns list of the teleportation nodes that are currently open
IsMultiplayerBoolVoidReturns true if campaign is multiplayer
ToggleCinematicModeVoidVoidToggles cinematic mode
IsPrologueBoolVoidReturns true if the current campaign is the prologue
SetOverlayLockedVoidBoolSets whether the map overlay is locked or not
NetworkPlayerListCcoNetworkPlayer (list)VoidReturns list of all the human players in the current mp game
ChangeOverlayModeWithRegionsVoidString, CcoCampaignFaction, ContextListChanges mode of the map overlay using the provided list of regions or region keys
YearIntVoidReturns the current year as a number
AreaOfInterestListCcoCampaignAreaOfInterest (list)VoidReturns list of all the areas of interest in the campaign
ChangeOverlayModeVoidStringChanges mode of the map overlay
DevTriggerDilemmaVoidStringTriggers dilemma for player faction, only for dev usagedebug, hide_in_uied
TurnNumberIntVoidReturns the current turn number

CcoCampaignRouteNode

Wrapper for campaign route node

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ResourceRewardForContractAndCargoContextCcoCampaignResourceTransactionCcoCampaignCharacter, CcoCaravanContractRecord, IntReturns a CcoCampaignResourceTransaction with the resource that the passed in cargo and contract would generate in this node
ResourceRewardForCaravanContextCcoCampaignResourceTransactionCcoCampaignCaravanReturns a CcoCampaignResourceTransaction with the resources that the caravan will generate when it reaches this node
IsActiveBoolCcoCampaignCaravanReturns true if the node can be clicked to change the path
IsSelectedBoolCcoCampaignCaravanReturns true if the node is on the path of the passed in caravan, or the selected start node
IsVisibleBoolVoidReturns true if the node is currently visible
SegmentTowardsNodeContextCcoCampaignRouteSegmentCcoCampaignRouteNodeReturns the segment connecting this node with the one passed in, if any
IsDestinationAvailableBoolCcoCampaignCaravanReturns true if this node is available as a destination for the specified caravan
IsEndNodeBoolVoidReturns true if this node is an ending node for its network
IsStartNodeBoolVoidReturns true if this node is a starting node for its network
SettlementContextCcoCampaignSettlementVoidReturns a CcoCampaignSettlement with the region where this node is
OwningFactionContextCcoCampaignFactionVoidReturns a CcoCampaignFaction with the faction that own the region where this node is, if any
ActiveContractListCcoCaravanContractRecord (list)VoidReturns a list of available resource contracts at this node
NodeSegmentLinkListCcoCampaignRouteSegment (list)VoidReturns a list with all the nodes segments connected to this one
PositionVector4VoidReturns the display position of the node
RoundsToRefreshIntVoidReturns an int with the rounds left until the contracts refresh for this node

CcoCampaignRouteSegment

Wrapper for campaign route segment

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ShouldShowThreatIconBoolVoidReturns true if the threat icon should be shown
HighBanditryLevelThresholdIntVoidReturns an int with the minimum amount for banditry to be considered a high threat
MediumBanditryLevelThresholdIntVoidReturns an int with the minimum amount for banditry to be considered a medium threat
BanditryLevelIntVoidReturns an int with the average amount of banditry in the regions contained in the segment
SettlementListCcoCampaignSettlement (list)VoidReturns a list of CcoCampaignSettlements that are present along the segment
EndNodeContextCcoCampaignRouteNodeVoidReturns a CcoCampaignRouteNode with the ending node of the segment
StartNodeContextCcoCampaignRouteNodeVoidReturns a CcoCampaignRouteNode with the starting node of the segment

CcoCampaignSeafangDestination

Component Context Wrapper for a Seafang port settlement teleport destination

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TeleportVoidVoidPerform the teleportation ritual to this settlement target.
CanPerformRitualBoolVoidReturns true if the ritual can be performed. Optional context param for the performer character
GetRitualCooldownTimeIntVoidReturns the cooldown turns required before performing the ritual again.
InvalidRitualReasonUniStringVoidReturns a localised string with text explaining why the ritual cannot be performed
CharacterContextCcoCampaignCharacterVoidReturns the associated Character context.
SettlementContextCcoCampaignSettlementVoidReturns the associated Settlement context.

CcoCampaignSettlement

Wrapper for a campaign settlement.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SettlementTypeStringVoidReturns the type of the settlement, if it has one.
ResourceListCcoResourceRecord (list)VoidReturns a list with the resources present in this region.
MaxBuildingSlotCountIntVoidReturns the maximum amount of building slots that the settlement can have for the current faction occupying it
DevOccupySettlementTypeListCcoSettlementTypeRecord (list)VoidReturns the settlement types available when the local player occupies this settlementdebug, hide_in_uied
IsAbandoningBoolVoidReturns true if this settlement is in the process of being abandoned.
HasOwningLimitBoolVoidReturns whether this settlement's type is linked to a shared owning limit group.
AlliedForeignSlotListCcoCampaignBuildingSlot (list)CcoCampaignFactionReturns a list with all the allied slots in the region if any.
HasGarrisonBoolVoidReturns true if the settlement has an army or navy garrisoned, otherwise returns false.
TurnsUntilSiegeSurrenderIntVoidReturns an int with how many turns the siege will last, Returns -1 if the settlement is not under siege.
CapitalIconStringVoidReturns the capital icon of this settlement.
PlayersFactionChainListCcoBuildingChainRecord (list)VoidReturns an ordered list with all the buildable chains in this settlement for the players faction, even if the player doesn't currently own the settlement (for previewing buildings that player can have in a settlement)
DevTakeControlVoidString (optional)Dev command that makes the local player take control of this settlementdebug, hide_in_uied
IsUnderSiegeBoolVoidReturns true if under siege.
BuildingCanEverBeBuiltBoolCcoBuildingLevelRecord, CcoCampaignBuildingSlotReturns true if the building can ever be built
ChainListCcoBuildingChainRecord (list)VoidReturns an ordered list with all the buildable chains in this settlement.
PlagueInfectionContextCcoCampaignPlagueInfectionVoidReturns a CcoPlagueInfection context if this settlement currently has a plague infection active
FactionFlagRotatedStringVoidReturns the rotated faction flag of this settlement.
FactionFlagMediumStringVoidReturns the medium faction flag of this settlement.
WarCoordinationTargetterListContextListVoidReturns a list with all the objects targetting this settlement, if any.
ModelRegionContextCcoCampaignModelRegionVoidReturns the CcoCampaignModelRegion context for this settlement
ResetSettlementTypeVoidString, IntCommand that resets a settlement to a different type.
IsMouseOverBoolVoidReturns true if mousing over this settlement.
IsEffectBundleActiveBoolStringReturns true if specific effect bundle is active on the settlement's region
IndexIntoProvinceIntVoidReturns the index of this settlement in the province's settlement list.
UnmarkForTypeConversionVoidVoidCommand that cancels the mark for type comversion command.
FactionFlagSmallStringVoidReturns the small faction flag of this settlement.
ContainedCharacterListCcoCampaignCharacter (list)VoidReturns a list with all the characters garrisoned in the settlement.
IsConvertingTypeBoolVoidReturns true if this settlement is converting type.
FactionProvinceManagerContextCcoCampaignFactionProvinceManagerVoidReturns the faction province manager of this settlement.
HasPortBoolVoidReturns whether the settlement has a port
NumWallBreachesIntVoidReturns an int with the number of times the wall has been breached.
IsOccupationImmuneBoolVoidReturns whether the settlement is immune to occupation
MarkForTypeConversionVoidString, IntCommand that marks the settlement for type conversion, which means this will be converted next turn.
IsAbandonedBoolVoidReturns true if this settlement is abandoned.
PooledResourceListCcoCampaignPooledResource (list)VoidReturns a list with all pooled resources present in the region.
FactionFlagLargeStringVoidReturns the large faction flag of this settlement.
BuildingSlotListCcoCampaignBuildingSlot (list)VoidReturns a list with the all the slots in the settlement.
BesiegeingCharacterContextCcoCampaignCharacterVoidReturns the context of the character that is besiegeing this settlement.
RegionRecordKeyStringVoidReturns the key of the region record.
IsSelectedBoolVoidReturns true if this settlement is currently selected
GarrisonSizeIntVoidReturns the size of the garrison in this settlement.
PlagueImmunityTurnsIntVoidReturns the number of turns the settlement is immune to plagues for, or 0 if none
UnmarkForAbandonVoidVoidCommand that cancels the mark for abandon command.
OriginalSubcultureContextCcoSubcultureRecordVoidReturns the context of the original subculture record
FactionFlagDirStringVoidReturns the directory of the faction flags
MarkForAbandonVoidVoidCommand that marks the settlement for abandon, which means this will be abandoned next turn.
TowerLevelIntVoidReturns an int with the tower level in this settlement.
EffectBundleUnfilteredListCcoEffectBundle (list)VoidReturns a list with the effect bundles in the region, without any filtering (so includes those that dont show in the UI)hide_in_uied
IsOnScreenBoolVoidReturns true if this settlement is currently on screen
IsImmuneToPlaguesBoolVoidReturns whether the settlement is currently immune to plagues
PooledResourceContextCcoCampaignPooledResourceStringReturns the context of the pooled resource with the key specified, if it exists.
SettlementKeyStringVoidReturns a string with the key of the settlement.
SelectAndZoomVoidVoidSelects and zooms to this settlement
CanConvertToSettlementTypeBoolStringReturns true if settlement can convert to the given settlement type
AllianceColourColourVoidReturns the alliance colour which for most part is owning factions, but a special case for abandoned/disguised settlements
EffectBundleListCcoEffectBundle (list)VoidReturns a list with the effect bundles in the region, pre-filtered to only include those that should show in the UI
IsShroudedBoolVoidReturns true if it's covered by shroud.
PlayerFactionForeignSlotIncomeIntVoidReturns the income of the player faction foreign slots in this region
StationedForceContextCcoCampaignMilitaryForceVoidReturns the military force context of the army stationed in this settlement, if any.
FindPooledResourceManagerFromSettlementRegionGroupsForResourceCcoCampaignPooledResourceManagerStringReturns a CcoCampaignPooledResourceManager for the resource with the given key found in any of the region groups the settlement's region belongs to
HostileForeignSlotListCcoCampaignBuildingSlot (list)CcoCampaignFaction, CcoSlotSetRecord (optional)Returns a list with the foreign slots in this settlement, for the passed in faction.
BelongsToRegionGroupBoolStringReturns if this settlement belongs to region group with passed key
SelectVoidVoidCommand that selects this settlement.
IncomeIntVoidReturns the tax income from the region.
CQIIntVoidReturns the CQI of the region.
HasPlagueBoolVoidReturns true if settlement has a plague
GarrisonForceContextCcoCampaignMilitaryForceVoidReturns the military force context of the garrison in this settlement.
FindHostileForeignBuildingSlotBySetKeyMaskAndTemplateCcoCampaignBuildingSlotString, StringGet a CcoCampaignBuildingSlot with the given slot_template_key from a foreign slot with the given foreign_slot_set_key_mask
HasCharacterGarrisonedBoolVoidReturns true if a character is garrisoned in this settlement.
HostileForeignSlotSetListCcoSlotSetRecord (list)CcoCampaignFactionReturns a list with all the hostile foreign slot sets in this settlement for the passed in faction.
IsAssociatedWithVassalBoolStringReturns if a vassal is associated with the settlement
ZoomToVoidVector4 (optional)Command that zooms to this settlement. Can optionally provide an offset for the zoom.
RenameVoidVoidCommand that renames the settlement.
PrimarySlotContextCcoCampaignBuildingSlotVoidReturns the context of the primary building slot.
PlagueResistanceFloatVoidReturns additive modifier to the chance of receiving plagues
ProvinceContextCcoCampaignProvinceVoidReturns the context of the province that this settlement is part of.
HasHostileForeignSlotSetBoolCcoCampaignFaction, CcoSlotSetRecord (optional)Returns whether the specified hostile foreign slot set exists for a given faction in this settlement. If no set is specified, it checks for any set
IsRebellionImminentBoolVoidReturns true if there will be a rebellion next turn.
IsVisibleBoolVoidReturns true if information about this settlement is visible to the player. (so if garrison and slot info is known to the player, not to do with being shrouded)
FindPooledResourceFromSettlementRegionGroupsCcoCampaignPooledResourceStringReturns a CcoCampaignPooledResource for the resource with the given key found in any of the region groups the settlement's region belongs to
WallsHealthPercentFloatVoidReturns a float with the health percentage of the wall.
ForeignSlotListCcoCampaignBuildingSlot (list)VoidReturns a list with all foreign slots (including allied slots) in this settlement independent of faction owner.
CanRenameBoolVoidReturns true if this settlement can be renamed
GetBuildingLifecycleResourceUpkeepIntStringReturns the settlement's total building lifecycle upkeep for the provided pooled resource key
HasWallsBoolVoidReturns true if this settlement has any walls.
OwningLimitIntCcoCampaignFactionReturns the maximum amount of settlements of this type that the given faction can own
FactionContextCcoCampaignFactionVoidReturns the context of the faction that owns it.
ScriptedBonusValueFloatStringReturns the value of the scripted bonus value with the passed key.
IsProvinceCapitalBoolVoidReturns true if this settlement is the capital of its province.
PositionVector4VoidReturns the position of the settlement on the map.
HasActiveInitiativeFromInitiativeSetBoolCcoInitiativeSetRecordReturns whether the settlement has an active initiative from the given initiative set
IsFactionCapitalBoolVoidReturns true if it's the capital of the faction that owns it.
EntitySharedStateRemoveVoidStringRemoves a shared state on this settlement's region entity
HostileBuildingSetListForBuildingBrowserCcoBuildingSetRecord (list)CcoCampaignFactionReturns a list of CcoBuildingSetRecord with all the building sets in the hostile slots owned by the passed in faction that are not excluded from the building browser, sorted by their sort order
VassalFactionContextCcoCampaignFactionStringReturns the context of the vassal faction that owns it.
HasActiveInitiativeFromInitiativeSetWithKeyBoolStringReturns whether the settlement has an active initiative from the initiative set with the given key
AbandonTooltipUniStringVoidReturns tooltip with resources/treasury returned when this settlement gets abandoned.
BreakForDebuggingVoidVoidCommand that triggers a breakpoint, useful for debugging.debug, hide_in_uied
TotalResourceChangeFromBuildingEffectsIntStringReturns the total resource change from all building effects in the settlement for the given pooled resource
DevSpawnRebellionVoidVoidDev command that forces a rebellion to spawn in settlementdebug, hide_in_uied
PlagueEffectBundleListCcoEffectBundle (list)VoidReturns a list of the plague effect bundles present in this settlement
EntitySharedStateWriteStringVoidString, StringWrites a string shared state on this settlement's region entity with the provided key and value
HostileBuildingSetListCcoBuildingSetRecord (list)CcoCampaignFactionReturns a list of CcoBuildingSetRecord with all the building sets in the hostile slots owned by the passed in faction, sorted by their sort order
InitiativeManagerCcoCampaignInitiativeManagerVoidReturns the region initiative manager
FactionNameUniStringVoidReturns the name of the faction, taking rebel factions into account.
IsPlayerOwnedBoolVoidReturns true if the local player owns this settlement.
OccupationImmunityDurationIntVoidReturns the duration of the occupation immunity for this settlement
IsUpgradeableBoolVoidReturns true if the settlement can be upgraded.
AlliedSlotsGroupListCcoGroupList (list)VoidReturns a list with all the allied foreign slots in the region, grouped based on the faction that owns each manager
BuildingSetListCcoBuildingSetRecord (list)VoidReturns a list with all the building sets in the settlement, sorted by their sort order
SettlementTypeRecordContextCcoSettlementTypeRecordVoidReturns the CcoSettlementTypeRecord context for the settlement, if any
HasMultipleDevOccupySettlementTypesBoolVoidReturns true if the local player has more than one settlement type choice when occupying this settlementdebug, hide_in_uied
NameUniStringVoidReturns the localized name for this settlement.
ChaoticPlanContextCcoCampaignChaoticPlanVoidReturns CcoCampaignChaoticPlan if the local faction has an active Chaotic plan in the settlement
RegionRecordContextCcoRegionRecordVoidReturns a CcoRegionRecord context of the region record
SettlementTreasuryValueIntVoidReturns the treasury value of this settlement based on building levels
HostileSlotsGroupListCcoGroupList (list)VoidReturns a list with all the hostile foreign slots in the region, grouped based on the faction that owns each manager

CcoCampaignSkavenCorruptionOverlay

Record wrapper for a Skaven corruption overlay

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PublicOrderFactorNameUniStringVoidReturns the name of the public order skaven corruption factor
MenaceChargesIntVoidReturns the menace charges provided by Skaven corruption
PublicOrderChangeIntVoidReturns the public order contribution by Skaven corruption

CcoCampaignSlaves

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanReceiveTransferBoolVoidReturns a bool specifying whether the province can receive a slave transfer.
SlaveSpaceAvailableIntVoidReturns an int with the amount of space still available in the province (max - current)
GrowthContributionIntVoidReturns an int with the growth contribution that the slaves provide.
PublicOrderContributionIntVoidReturns an int with the public order contribution that the slaves provide.
IncomeIncreaseModifierFloatVoidReturns a float with the income increase modifier that the slaves provide.
MaximumSlavesIntVoidReturns an int the maximum number of slaves that the province can have.
SlavesCapPercentageFloatVoidReturns the percentage of used the slave cap
SlavesNumberIntVoidReturns an int with the current number of slaves in the province.
PercentageReducedPerTurnFloatVoidReturns a float with the percent of slaves that will be lost next turn
FactionProvinceManagerContextCcoCampaignFactionProvinceManagerVoidReturns the context of the faction province manager that owns the slaves.
PercentageDiscardedOnTransferFloatIntReturns a float with the percent of slaves that will be discarded in a transfer, from the amount passed as a parameter
IsSlaveEffectTypeActiveBoolStringReturns if the passed in effect(public_order, growth, income_modifier) is active or not.
ToggleSlavesEffectTypeVoidStringCommand that toggles the passed in effect type.(public_order, growth, income_modifier)
SlaveDistributionControlStringVoidReturns a string with the slave distribution control type.
ChangeSlaveDistributionControlVoidStringCommand that changes the distribution control to the specified distribution type(none/normal/high)
TransferSlavesToProvinceVoidCcoCampaignProvinceCommand that transfers slaves to the passed province (Takes CcoCampaignProvince as arg)

CcoCampaignTechnology

Component context wrapper for a campaign technology

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CharacterTraitListCcoCharacterTraitLevelRecord (list)VoidReturns the list of CcoCharacterTraitLevelRecord provided by this tech
FactionContextCcoCampaignFactionVoidReturns the context of the faction that this technology belongs to
IsResearchedBoolVoidReturns true if already been researched
UiGroupContextCcoTechnologyUiGroupRecordVoidReturns the context of the ui group that this technology is part of, if it exists
AncillaryListCcoAncillaryRecord (list)VoidReturns the list of CcoCampaignAncillary provided by this tech
CurrentStateStringVoidCurrent state as a string (available/researched, etc
ResourceTransactionContextCcoCampaignResourceTransactionVoidReturns the context of the required resource transaction
BuildingListCcoBuildingLevelRecord (list)VoidReturns the list of CcoBuildingLevelRecord provided by this tech
ColourColourVoidColour defined by tech node set
IconPathStringVoidFull icon filepath for tech icons
DevDisableTechVoidVoidInstantly disables tech for dev purposesdebug, hide_in_uied
HasProgressedBoolVoidReturns true if any progress has been made
UnitListCcoMainUnitRecord (list)VoidReturns the list of CcoMainUnitRecord provided by this tech
EffectUnfilteredListCcoEffect (list)VoidReturns the list of CcoEffect that this tech enables when researched, includes those not shown in uihide_in_uied
DevEnableTechVoidBool (optional)Instantly enables tech for dev purposes. Can pass in true if want to report in event feed the new tech researched, otherwise will suppress this by default so as not to take out of tech panel to see event (better for testing tech tree)debug, hide_in_uied
LongDescriptionUniStringVoidLocalised long description
OverrideSoundCategoryStringVoidReturns the override sound category for this technology if it exists
EffectListCcoEffect (list)VoidReturns the list of CcoEffect that this tech enables when researched, prefiltered to not show those that shouldnt appear in ui
ShortDescriptionUniStringVoidLocalised short description
IndentIntVoidReturns the indent value from db (x position)
TierIntVoidReturns tier value from db (y position)
EffectsGrantedToInitiativeCcoEffect (list)CcoInitiativeRecordReturns list of effects (flagged as visible in UI) that this tech grants to given initiative
NameUniStringVoidLocalised name
AffectedInitiativeListCcoInitiativeRecord (list)Bool (optional)Returns list of initiatives affected by unlocking this tech, can pass to EffectsGrantedToInitiative to get specific effects
DurationIntVoidReturns the number of turns it takes to finish researching this tech
PositionVector4VoidReturns a VECTOR_4 that can be used with things like ContextRadarIcon for positioning free form using tier and indent from db
TechnologyManagerContextCcoCampaignTechnologyManagerVoidReturns the context of the technology manager
CanAffordBoolVoidReturns true if can afford the Cost of researching this tech
ResearchPointsCostIntVoidReturns required research points minus completed research points for this tech
ScriptLockedReasonUniStringVoidReturns script locked reasons for tech with challenge numbers formatted in, if any
NodeSetNameUniStringVoidReturns the unlocalised name of the technology node set this technology belongs to
UiTabContextCcoTechnologyUiTabRecordVoidreturns the context of the ui tab if any
CostIntVoidReturns financial cost to research this tech
TrainingGroupContextCcoCampaignCharacterTrainingGroupVoidIf one of the effects unlocks a training slot, returns the group of that
BreakForDebuggingVoidVoidBreaks into attached IDE for debugging and getting full information from internal objectsdebug, hide_in_uied
CanResearchBoolVoidReturns true if available and can currently research meeting any additional requirements like cost, etc
UnresearchedParentRecordsCcoTechnologyRecord (list)VoidReturns the records of the unresearched parents of this technology
DisablingTechContextCcoCampaignTechnologyVoidReturns the CcoCampaignTechnology that disabled us when it was researched (some techs mutually exclusive)
IsAtLeastAvailableBoolVoidReturns true if available, researching or researched
ResearchedParentsIntVoidReturns the number of parents that have already been researched
RecordContextCcoTechnologyRecordVoidReturns the CcoTechnologyRecord context
RequiredTechnologiesListCcoTechnologyRecord (list)VoidReturns the list of CcoCampaignTechnology required before player can research this tech
IsAtLeastResearchingBoolVoidReturns true if researching or researched
MatchesQueryBoolUniStringReturns true if this technology matches given query text
RequiredBuildingListCcoBuildingLevelRecord (list)VoidReturns the list of CcoBuildingLevelRecord required to be built by player before can research this tech
IsQueuedBoolVoidReturns true if this technology is part of the research map
IsAvailableBoolVoidReturns true if available to be researched
HasBuildingRequirementBoolVoidReturns true if this tech has building requirements before can start researtching
RequiredParentsNumberIntVoidReturns required number of parents to unlock this technology
IsResearchingBoolVoidReturns true if currently researching
StartResearchingVoidVoidStarts researching this tech
NodeKeyStringVoidReturns the key of technology node record

CcoCampaignTechnologyManager

Wrapper for a faction's technology manager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectsGrantedCcoEffect (list)VoidReturn a list of effects granted by technology in this manager
ResearchedTechnologyListCcoCampaignTechnology (list)VoidReturn a list of researched technology from this manager
TechnologyListCcoCampaignTechnology (list)VoidReturn a list of technology available to this manager
HasResearchedAllTechInUiGroupBoolCcoTechnologyUiGroupRecordCheck whether all technologies in the provided UI group have been researched
CanResearchAnyTechInUiGroupBoolCcoTechnologyUiGroupRecordCheck whether any technology in the provided UI group is available to research
IsResearchingTechBoolVoidReturn if this manager is currently researching a technology or not
ResearchPointsIntVoidReturn research points for this manager
GoalTechnologyContextCcoCampaignTechnologyVoidReturn a context to the goal research technology if valid
CurrentResearchingTechnologyContextCcoCampaignTechnologyVoidReturn a context to the current technology this manager is researching, if valid

CcoCampaignTreasuryTransaction

Context wrapper for treasury transactions.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LocalisedTextKeyStringVoidReturns the localised text key for what text to use (NOT sure why done this way instead of returning text, see Mikaela)
ValueIntVoidReturns the value

CcoCampaignUnit

Component context wrapper for a campaign unit

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DevLevelUpVoidIntLevels up or down a unit by given number of levelsdebug, hide_in_uied
ExperienceLevelIntVoidReturns the current experience level of the unit (0-9)
PurchasableEffectCostContextCcoCampaignUnitPurchasableEffectCostCcoUnitPurchasableEffectRecordReturns the CcoCampaignUnitPurchasableEffectCost for a supplied CcoUnitPurchasableEffectRecord
FactionContextCcoCampaignFactionVoidReturns the faction of this unit
DevHealVoidVoidFully heals the unit, useful for dev purposesdebug, hide_in_uied
RemoveMissingCookingDishVoidVoidRemoves the missing cooking dish of the unit
PurchasableEffectsCostListCcoCampaignUnitPurchasableEffectCost (list)VoidReturns a list of CcoCampaignUnitPurchasableEffectCost that this unit can use
UpkeepCostIntVoidReturns the upkeep cost of this unit (how much pay each turn)
AlliedOriginFactionContextCcoCampaignFactionVoidReturns the allied origin faction of this unit (if this unit has been recruited through allied recruitment)
PurchasableEffectsListCcoUnitPurchasableEffectRecord (list)VoidReturns a list of CcoUnitPurchasableEffectRecord that this unit can use
CostIntVoidReturns the recruitment cost of this unit (one off payment when first recruit)
CharacterContextCcoCampaignCharacterVoidReturns the CcoCampaignCharacter if any (for agents/generals)
NumEntitiesInitialIntVoidReturns the max number of entities this unit can have
UpgradeUnitVoidCcoMainUnitRecordUpgrades the unit to the supplied CcoMainUnitRecord
UpgradeUnavailableTextUniStringCcoUnitPurchasableEffectRecordReturns the reason why the unit cannot upgrade using the supplied CcoUnitPurchasableEffectRecord
NumEntitiesIntVoidReturns the current number of entities
MilitaryForceContextCcoCampaignMilitaryForceVoidReturns the owning CcoCampaignMilitaryForce
UnitDetailsIfEffectPurchasedCcoUnitDetailsCcoUnitPurchasableEffectRecordReturns a CcoUnitDetails object describing the unit with a given purchasable effect applied.
UnitDetailsContextCcoUnitDetailsExpressionStateReturns the CcoUnitDetails for this unit (used on unit info panel which shows unit info from various sources)
IsExperienceKnownBoolVoidReturns true if player knows enough about army to know how experience (might not be close enough to army, etc)
HealthMaxIntVoidReturns the max raw health value this unit can have
PurchasableEffectsIncrementalScrapCostIntVoidReturns the incremental cost per each subsequent scrap upgrade for this unit. It can be 0.
UnitRecordContextCcoMainUnitRecordVoidReturns the CcoMainUnitRecord
IsNumMenKnownBoolVoidReturns true if player knows enough about army to know how many men they have left (might not be close enough to army, etc)
HealthValueIntVoidReturns the raw health value (hitpoints)
GetPurchasableEffectLockingTechnologyRecordCcoTechnologyRecordCcoUnitPurchasableEffectRecordReturns the CcoTechnologyRecord that locks the provided CcoUnitPurchasableEffectRecord.
AbilityListContextListVoidReturns the list of CcoUnitAbility that this unit can use in battle
IsUnknownBoolVoidReturns true if player doesn't know details about this unit due to spying level (might not be close enough to army, etc)
GetPurchasableEffectLockedStatusIntCcoUnitPurchasableEffectRecordDetermines whether the provided CcoUnitPurchasableEffectRecord is locked behind an unresearched technology.
AttritionPercentFloatVoidReturns how much attrition will take in the next turn (how much health will lose) (0-1)
CanUpgradeBoolCcoUnitPurchasableEffectRecordReturns true if this unit can upgrade using the supplied CcoUnitPurchasableEffectRecord
IsLoanedBoolVoidReturns true if unit is loaned from another faction
HealthPercentNextTurnFloatVoidReturns the health percent that will be next turn (0-1)
HasPurchasedEffectBoolCcoUnitPurchasableEffectRecordReturns true if unit have purchased the supplied CcoUnitPurchasableEffectRecord
UpgradeVoidCcoUnitPurchasableEffectRecordUpgrades the unit with the supplied CcoUnitPurchasableEffectRecord
HealthReplenishPercentFloatVoidReturns the amount of health that will be replenished on the next turn as a percentage (0-1)
HaveAccessToPurchasableEffectBoolCcoUnitPurchasableEffectRecordReturns true if unit have access to the supplied CcoUnitPurchasableEffectRecord
RemoveUpgradeVoidCcoUnitPurchasableEffectRecordRemoves the purchasable effect with the supplied CcoUnitPurchasableEffectRecord from the unit
ExperiencePercentFloatVoidReturns the current experience progression to next level as a percent (0-1)
HasPurchasedAllAvailableEffectsBoolVoidReturns true if unit has purchased all available purchasable effects.
DisbandVoidVoidRemoves the unit from the army, essentially deleting the unit
HealthPercentFloatVoidReturns the current health as a percentage (0-1)
RenameVoidVoidBrings up a prompt to rename the unit to give it a custom name
CanPurchaseAvailableEffectsBoolVoidReturns true if the unit has effects available for purchase. If it has no purchasable effects available, or has purchasable effects available that cannot currently be purchased it returns false.
IconPathStringVoidReturns the icon filepath used for things like unit card images
PurchasedEffectsListCcoUnitPurchasableEffectRecord (list)VoidReturns a list of CcoUnitPurchasableEffectRecord that this unit have purchased
WillSufferAttritionBoolVoidReturns true if this unit will suffer attrition on the next turn (take damage)
UniqueUiIdStringVoidReturns unique string identifier for this unit
PurchasableEffectIncreasedPurchaseCostCcoCampaignResourceTransactionCcoUnitPurchasableEffectRecord, IntReturns a CcoCampaignResourceTransaction for the purchase cost of a supplied CcoUnitPurchasableEffectRecord, including any cost increase from all previously purchased upgrades and a given number of ones selected to be purchased.
NameUniStringVoidReturns the localised name
IsCharacterBoolVoidReturns true if this unit is for a character (general or agent)
ActorVOIntVoidReturns the actor voice-over id
AllianceColourColourVoidReturns the alliance colour of this unit (usually same as factions colour, but if we have an origin faction it will use that colour)
TurnsUntilReplenishedIntVoidReturns how many turns it will take for this unit to be back to full strength
PurchasableEffectsTotalPurchaseCostCcoCampaignResourceTransactionContextListReturns a CcoCampaignResourceTransaction for the total purchase cost of a supplied list of CcoUnitPurchasableEffectRecord as a whole, including the cost increases caused by earlier upgrades to the later ones.
MissingCookingDishContextCcoCookingRecipeRecordVoidCooking dishes are auto reapplied to units if they had those the previous battle. If there isn't an available dish of the type to apply to this unit, then the missing dish is saved and returned here.

CcoCampaignUnitGroupUpgrade

Component context wrapper for a UNIT_GROUP_UPGRADE

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitRankAfterUpgradeIntCcoCampaignUnitReturns the provided units rank after upgrade have been applied
RankRequirementMetBoolVoidReturns if the requirement of the unit rank is met
RankRequiredIntVoidReturns rank required on the unit for the upgrade
BuildingRequirementsListCcoCampaignUnitUpgradesBuildingRequirement (list)VoidReturns a list of CcoCampaignUnitUpgradesBuildingRequirement for the unit group
TechRequirementsListCcoCampaignUnitUpgradesTechRequirement (list)VoidReturns a list of CcoCampaignUnitUpgradesRequirement for the unit group
CategoryStringVoidReturns the category that the unit group upgrade belong to for filtering purposes
CanUpgradeBoolVoidReturns true if unit can apply this upgrade
ResourceTransactionContextCcoCampaignResourceTransactionCcoCampaignUnitReturns the CcoCampaignResourceTransaction belonging to the unit upgrade
UnitsListCcoMainUnitRecord (list)VoidReturns a list of CcoMainUnitRecords that belongs to this unit group

CcoCampaignUnitPurchasableEffectCost

Context wrapper for pairing purchasable effect record and resource transaction.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectRecordCcoUnitPurchasableEffectRecordVoidReturns purchasable effect record cco
ResourceTransactionCcoCampaignResourceTransactionVoidReturns resource transaction cco

CcoCampaignUnitUpgradeManager

Component context wrapper for a UNIT_UPGRADE_MANAGER

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitHasUpgradesBoolCcoCampaignUnitReturns if unit has any unit group upgrades
FirstValidUpgradeCategoryForUnitStringCcoCampaignUnit, String (optional)Returns the first valid unit upgrade category that the given unit have access to
UnitGroupUpgradesTreeTreeDataContextListReturns a list of CcoCampaignUnitGroupUpgrades for a list of CcoCampaignUnitGroupUpgrades
ForceUnitGroupUpgradesListCcoCampaignUnitGroupUpgrade (list)CcoCampaignMilitaryForce, CcoCampaignUnit (optional)Returns a list of CcoCampaignUnitGroupUpgrades for a given CcoCampaignMilitaryForce
UnitsUpgradeGroupListCcoCampaignUnitGroupUpgrade (list)CcoCampaignUnitReturns a list of CcoCampaignUnitGroupUpgrades for the given CcoCampaignUnit
FirstAvailableUnitUpgradeGroupContextCcoCampaignUnitGroupUpgradeCcoCampaignUnitReturns the first valid upgrade group for the given CcoCampaignUnit
UnitUpgradeMainUnitRecordListCcoMainUnitRecord (list)CcoCampaignUnitReturns a list of CcoMainUnitRecord which the unit can upgrade to for a given CcoCampaignUnit

CcoCampaignUnitUpgradesBuildingRequirement

Component context wrapper for a UNIT_GROUP_TECH_REQUIREMENT

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BuildingRequiredRecordContextCcoBuildingLevelRecordVoidReturns the CcoBuildingLevelRecord required to unlock the unit group
IsRequirementMetBoolVoidReturns true if unit have met the requirement

CcoCampaignUnitUpgradesTechRequirement

Component context wrapper for a UNIT_GROUP_TECH_REQUIREMENT

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TechRequiredRecordContextCcoTechnologyRecordVoidReturns the CcoTechnologyRecord required to unlock the unit group
RequirementTextUniStringVoidReturns the requirement display text
IsRequirementMetBoolVoidReturns true if unit have met the requirement

CcoCampaignWarContract

Wrapper for a campaign war contract

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TargetFactionsListCcoCampaignFaction (list)VoidReturns the list of targets for the contract
CustomDescriptionUniStringVoidReturns the localised description text for this contract if it has one
RewardPayloadInfoContextCcoCampaignPayloadInfoVoidReturns the reward payload info context for the contract
IsActiveBoolVoidReturns if this is contract is currently active or not
ClientFactionCcoCampaignFactionVoidReturns the client faction for the contract
HiredFactionCcoCampaignFactionVoidReturns the hired faction for the contract
HasFactionExceededTargetPointsForActiveContractBoolVoidReturns true if the faction has more that the target contract points for their active contract
ContractPointsResourceContextCcoCampaignPooledResourceVoidReturns CcoCampaignPooledResource that the hired faction for this contract uses for contract points
CompleteContractVoidVoidCompletes the current active contract
BreakContractVoidVoidTries to break this contract if active
ActivateContractVoidVoidTries to activate this contract if available
CurrentPointsIntVoidReturns the current contract points accumulated for the contract
TargetPointsIntVoidReturns the required contract points to complete the contract
RemainingDurationIntVoidReturns the remaining duration of the contract. If it's not an active contract this is equal to the contract duration
ContractDurationIntVoidReturns the duration of the contract

CcoCampaignWarCoordinationRequest

Component context wrapper for a war coordination request from the AI with details of the mission

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FavourPointsRewardIntVoidReturns the favour points reward for completing the request
TargetTypeStringVoidReturns the type of target used for state names (attack_army/defend_army/attack_settlement/defend_settlement)
TargetContextContextVoidReturns the context of the target to defend/attack, either a CcoCampaignMilitaryForce or CcoCampaignSettlement
TargetFactionContextCcoCampaignFactionVoidReturns the target faction who we are requesting to attack/defend (the settlement or forces owning faction)
RecipientFactionContextCcoCampaignFactionVoidReturns the faction receiving this request
IssuingFactionContextCcoCampaignFactionVoidReturns the faction issuing this request
FactionInteractionContextCcoCampaignFactionInteractionVoidReturns the CcoCampaignFactionInteraction this request belongs to
AcceptRequestVoidVoidAccepts the request for pending target
IsPendingBoolVoidReturns true if this request is still pending and hasnt been accepted yet, if not pending then it is an accepted request currently active
CanCurrentlyRequestBoolVoidReturns if can currently perform this request (if can afford, etc)
TurnsRemainingIntVoidReturns the turns remaining until this request becomes invalid

CcoCampaignWinStreak

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentStreakEffectContextVoidVoid
TurnsUntilDecayVoidVoid
WinStreakPercentVoidVoid
EffectUnfilteredListVoidVoid
EffectListVoidVoid
InvalidationRoundVoidVoid
CurrentWinStreakVoidVoid
CampaignStreakContextVoidVoid

CcoCampaignWindsOfMagicArea

Wrapper for a winds of magic area.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DoesFactionHaveAreaOwnershipBoolCcoCampaignFactionReturns true if the passed in faction has ownership of this area
ManipulateWindsOfMagicTooltipUniStringExpressionState, BoolReturns a tooltip with the reason winds of magic can't be activated, or with the cost if it can. If passed true, will return tooltip for increasing strength, otherwise for decreasing.
CanManipulateWindsOfMagicBoolBoolReturns true if the wind can be changed. If passed true, will return if the wind strength can be increased, otherwise if it can be decreased.
WindsOfMagicManipulationCostCcoCampaignResourceTransactionBoolReturns the cost of performing a wind manipulation in this area. If passed true, will return cost for increasing strength, otherwise for decreasing
ChangeAreaStrengthVoidBoolChanges the current area strength. If the bool passed in is true, then it increases the strength, else it decreases it.
RoundsUntilTransitionIntVoidReturns the number of rounds until the next transition.
TransitionRoundIntVoidReturns an int with the round number when the duration of the current strength finishes.
CurrentStrengthContextCcoCampaignMapWindsOfMagicStrengthRecordVoidReturns the context of the current wind strength record in the area.
RegionListCcoRegionRecord (list)VoidReturns a list with all the regions in the area.
RecordContextCcoCampaignMapWindsOfMagicAreaRecordVoidReturns the context of the winds of magic area record.

CcoCampaignWindsOfMagicSystem

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ChangeAreaStrengthVoidCcoCampaignWindsOfMagicArea, CcoCampaignMapWindsOfMagicStrengthRecord
AllAreaContextsContextListVoid
AreaContextForProvinceCcoCampaignWindsOfMagicAreaCcoCampaignProvince
AreaContextForRegionCcoCampaignWindsOfMagicAreaCcoRegionRecord

CcoCampaignWomCompassDirection

Wrapper for wom compass direction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanFactionSetDirectionBoolCcoCampaignFactionReturns true if the passed in faction can set this compass direction
KeyStringVoidReturns the key of the direction record
FactorListCcoStringValue (list)VoidReturns a list of factors that have affected the power level of this direction
TurnsUntilUnlockScriptKeyStringVoidReturns the script key for the turns until unlocked script object
ActionTooltipUniStringStringReturns the tooltip for the action of the type specified
CanActivateActionBoolStringReturns true if the action with the type specified can be activated
PowerLevelRangeListCcoCampaignWomCompassPowerLevelRange (list)VoidReturns a list of power level ranges grouped based on effects
IsCurrentDirectionBoolVoidReturns true if this direction is the currently selected one
DescriptionUniStringVoidReturns the localised description of the direction
TitleUniStringVoidReturns the localised title of the direction
TurnsUntilUnlockIntVoidReturns the number of turns until this direction will be unlocked
DisplayOrderIntVoidReturns an int with the sort order of the direction
CurrentPowerLevelIntVoidReturns an int with the current power level that this direction has
MaxPowerLevelIntVoidReturns an int with the maximum power level this direction can have
MinPowerLevelIntVoidReturns an int with the minimum power level this direction can have
IsInitiallyLockedBoolVoidReturns true if this direction was initially locked
SelectionEffectListCcoEffect (list)VoidReturns a list with the effects that this direction gets while it's selected
HasAccessToActionBoolStringReturns true if this direction has access to the passed in action
PowerLevelEffectListCcoEffect (list)VoidReturns a list with the current effects of this direction based on the power level

CcoCampaignWomCompassPowerLevelRange

Wrapper for a direction power level to make it easier to have a list of them with their own effect list

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MaxLevelIntVoidReturns the maximum level of this range
MinLevelIntVoidReturns the minimum level of this range
SegmentPercentageFloatVoidReturns the percentage that this segment has based on the range's min and max
EffectListCcoEffect (list)VoidReturns a list of effects for this level
DirectionContextCcoCampaignWomCompassDirectionVoidReturns the compass direction context

CcoCookingDish

Wrapper for a COOKING_DISH struct

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AlliedUnitEffectsListCcoEffect (list)VoidReturns a list of CcoEffect with the allied unit effects provided by this dish
EnemyUnitEffectsListCcoEffect (list)VoidReturns a list of CcoEffect with the enemy unit effects provided by this dish
FactionEffectListCcoEffect (list)VoidReturns a list of CcoEffect with the faction effects provided by this dish
FactionLeaderEffectListCcoEffect (list)VoidReturns a list of CcoEffect with the faction leader effects provided by this dish
IngredientListCcoCookingIngredientRecord (list)VoidReturns a list of CcoCookingIngredientRecord with the ingredients of this dish
CookingDishRecordContextCcoCookingRecipeRecordVoidReturns a CcoCookingRecipeRecord with the recipe record of this dish
RoundsLeftIntVoidReturns the number of rounds left on the active dish effect

CcoCookingSystem

Wrapper for the cooking system for a given faction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetUnlockedIngredientRecordsCcoCookingIngredientRecord (list)VoidReturns a list of CcoCookingIngredientRecord with all the unlocked ingredients
UnlockAllIngredientsVoidVoidDev command to unlock all ingredientsdebug, hide_in_uied
PrimaryIngredientsForRecipeCcoCookingIngredientRecord (list)CcoCookingRecipeRecord, BoolReturns a list of CcoCookingIngredientRecord with primary ingredients needed for the CcoCookingRecipeRecord passed in
HasValidIngredientsForRecipeBoolCcoCookingRecipeRecordReturns true if the passed in recipe has all the ingredients unlocked and not on cooldown
RevertDishAppliedToUnitVoidCcoCampaignUnit, CcoCookingDishReverts the passed in cooking dish on the passed in unit
RecipeForIngredientsCcoCookingRecipeRecordContextList, ContextListReturns a CcoCookingRecipeRecord that would result from the primary and secondary CONTEXT_LIST ingredients passed in
DishesAppliedToAllUnitsListCcoCookingDish (list)VoidReturns a list of CcoCookingDish with the dishes applied to all units
IngredientCooldownIntCcoCookingIngredientRecordReturns an int with the cooldown of the passed in ingredient (returns 0 if not on cooldown)
DishesAppliedToUnitListCcoCookingDish (list)CcoCampaignUnitReturns a list of CcoCookingDish with the dishes applied to the passed in unit
StoredAmountForDishIntCcoCookingDishReturns an int with the number of dishes stored of the dish passed in
StoredCookingDishListCcoCookingDish (list)VoidReturns a list of CcoCookingDish with all stored cooking dishes
StoredAmountForRecipeIntCcoCookingRecipeRecordReturns an int with the number of dishes stored for the passed in recipe
PossibleIngredientCategoriesCcoCookingIngredientGroupRecord (list)VoidReturns a list of CcoCookingIngredientGroupRecord with all ingredient categories
CanCookIngredientsBoolContextList, ContextListReturns true if the passed in ingredients can be cooked into a valid dish
PossibleIngredientsForCategoryCcoCookingIngredientRecord (list)CcoCookingIngredientGroupRecordReturns a list of CcoCookingIngredientRecord for the CcoCookingIngredientGroupRecord passed in
IngredientSlotIsUnlockedBoolInt, BoolReturns true if the slot with the passed in number is unlocked. Needs to also pass true for whether should check primary slots, or false for secondary slots
AnyIngredientOfCategoryIsUnlockedBoolCcoCookingIngredientGroupRecordReturns true if any ingredient from the passed in CcoCookingIngredientGroupRecord is unlocked
MaximumNumberOfSecondaryIngredientsIntVoidReturns an int with the maximum number of allowed secondary ingredients
IngredientIsUnlockedBoolCcoCookingIngredientRecordReturns true if the passed in CcoCookingIngredientRecord is unlocked
MaximumNumberOfPrimaryIngredientsIntVoidReturns an int with the maximum number of allowed primary ingredients
AllIngredientsUnlockedForRecipeBoolCcoCookingRecipeRecordReturns a list of CcoCookingIngredientRecord for the CcoCookingRecipeRecord passed in
DevRemoveItemsVoidCcoCookingRecipeRecordCheat: Removes a crafted itemd from the storage of the faction (if possible)
CurrentActiveDishContextCcoCookingDishVoidReturns a CcoCookingDish with the current dish context
RecipeIsUnlockedBoolCcoCookingRecipeRecordReturns true if the passed in CcoCookingRecipeRecord is unlocked
DevAddItemsVoidCcoCookingRecipeRecordCheat: Adds a crafted item to the storage of the faction (if possible)
IsDishActiveBoolVoidReturns true if a dish is currently active
ForceCookRecipeVoidCcoCookingRecipeRecord, BoolCalls a CCQ command to cook the passed in recipe directly. Will use default ingredients.
GetPossibleRecipeRecordsCcoCookingRecipeRecord (list)VoidReturns a list of CcoCookingRecipeRecord with all recipes
CookIngredientsVoidContextList, ContextList, BoolCalls a CCQ command to cook the primary and secondary CONTEXT_LIST ingredients passed in
DevUnlockIngredientVoidCcoCookingIngredientRecordDev command to unlock the passed in ingredientdebug, hide_in_uied
GetPossibleIngredientRecordsCcoCookingIngredientRecord (list)VoidReturns a list of CcoCookingIngredientRecord with all ingredients
UnlockAllRecipesVoidVoidDev command to unlock all recipesdebug, hide_in_uied
GetUnlockedRecipeRecordsCcoCookingRecipeRecord (list)VoidReturns a list of CcoCookingRecipeRecord with all the unlocked recipes
SecondaryIngredientsForRecipeCcoCookingIngredientRecord (list)CcoCookingRecipeRecord, BoolReturns a list of CcoCookingIngredientRecord with secondary ingredients needed for the CcoCookingRecipeRecord passed in

CcoDiplomacyThreatLevel

Wrapper for FACTION_STRATEGIC_THREAT_LEVEL_RECORD and flag stating whether for the player or not

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TitleUniStringVoidLocalised title for threat level based on if for player or AI
DescriptionUniStringVoidLocalised description for threat level based on if for player or AI
RecordKeyStringVoidRecord key for FACTION_STRATEGIC_THREAT_LEVEL_RECORD wrapping
FactionContextCcoCampaignFactionVoidRecord CcoCampaignFaction for faction this threat is for

CcoEpisodeEventPopup

Component context handling the episode popups

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetElementsFromSectionCcoEpisodeEventPopupElement (list)StringReturns the list of elements in the section

CcoEpisodeEventPopupElement

Holds info for a single element for the episode popup - icon and text

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OrderIntVoidUsed to sort the elements predictably
AdditionalSoundEventStringVoidReturns the element's additional sound event
MoviePathStringVoidThe path for the video we show for this element
IconPathStringVoidThe path for the icon we show for this element
DisplayStringUniStringVoidThe string we show for this element

CcoEpisodicOverride

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsOverridenVoidVoid

CcoEternalDanceInstanceData

Wrapper for Eternal Dance Dance data

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsLockedBoolVoidReturns if the dance is locked.
CategoryRecordCcoInitiativeSetCategoryRecordVoidReturns the initiative_set_category context
FactionContextCcoCampaignFactionVoidReturns the faction context
AssignedCharacterCcoCampaignCharacterVoidReturns the character assigned to this dance (if any), nullptr otherwise
ChosenInitiativeSetRecordListCcoInitiativeSetRecord (list)VoidGets a list of the chosen initiatve set record ccos from finished dance.
ChosenInitiativeRecordListCcoInitiativeRecord (list)VoidGets a list of the chosen initiatve record ccos from finished dance.
ChosenInitiativeRecordListForTempoTierCcoInitiativeRecord (list)StringGets a list of the chosen initiatve record ccos from finished dance.
EffectListCcoEffect (list)VoidGets the effects provided by this dance currently.
EffectListUnfilteredCcoEffect (list)VoidGets the effects provided by this dance currently.
GetRitualsForInitiativeCcoCampaignRitual (list)CcoCampaignInitiativeGets the rituals provided by the effects of a given initiative
GetAbilitiesForInitiativeCcoUnitAbility (list)CcoCampaignInitiativeGets the abilities provided by the effects of a given initiative
GetInitiativeRecordCcoCcoInitiativeRecordStringReturns the CcoInitiativeRecord context for a given key
GetAbilitiesFromGroupCcoUnitAbility (list)CcoCampaignInitiativeGets the group of 4 abilities for step 3 from the step 2 initiative
GetSetRecordCcoCcoInitiativeSetRecordStringReturns the CcoInitiativeSetRecord context for a given key
InitiativeSetListWithCharacterCcoCampaignInitiativeSet (list)CcoCampaignCharacter (optional)Returns the list of initiative sets for this dance using provided character
ResetDanceVoidVoidResets the dance preset. Only works on finished dances. Does nothing otherwise
InitiativeSetListCcoCampaignInitiativeSet (list)VoidReturns the list of initiative sets for this dance
CanPickInitiativeForTempoBoolStringReturns true if the sets before the passed tempo level all have chosen initiatives.
IsDanceFinishedBoolVoidReturns if the dance is completed.

CcoFloatingTextAgentActionEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AgentNameVoidVoid
TextTypeVoidVoid
TargetFlagPathVoidVoid
AgentFlagPathVoidVoid
IsSuccessVoidVoid
TargetNameVoidVoid
ActionNameVoidVoid

CcoFloatingTextBattleEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TextTypeVoidVoid
DefenderFlagPathVoidVoid
AttackerFlagPathVoidVoid
DefenderVoidVoid
AttackerVoidVoid

CcoFloatingTextStanceEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TextTypeVoidVoid
GeneralFlagPathVoidVoid
GeneralNameVoidVoid
OldStanceNameVoidVoid
NewStanceNameVoidVoid

CcoJadeMissionElement

Wrapper for a quest chain mission

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MarkAsSeenVoidVoidMark the mission notification as seen
HasSeenBoolVoidReturn true if the mission notification has been seen
HasMissionBeenIssuedBoolVoidReturn if the mission is available in the current campaign
IsMissionAvailableInCurrentCampaignBoolVoidReturn if the mission is available in the current campaign
ImagePathStringVoidReturns a string with the image path for the mission
SortOrderIntVoidReturn the sort order for the mission in the quest chain
MissionContextCcoCampaignMissionVoidReturn the CcoCampaignMission
MissionRecordContextCcoMissionRecordVoidReturn the CcoMissionRecord

CcoMalakaiOathsQuestChain

Wrapper for a battles of legend quest chain

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HighlightedEffectBundleListCcoEffectBundle (list)VoidReturn a list of CcoEffectBundle
HighlightedUnitListCcoMainUnitRecord (list)VoidReturn a list of CcoMainUnitRecord
BulletPointTextUniStringVoidReturns the localised bullet point text of the chain
OathsMissionListCcoJadeMissionElement (list)VoidReturn a list of CcoMalakaiOathsMission
DescriptionUniStringVoidReturns the localised description of the chain
IsPinnedBoolVoidReturns whether this quest chain is pinned
IsUnlockedBoolVoidReturns whether this quest chain is unlocked
SwitchingRitualContextCcoRitualRecordVoidReturn a CcoRitualRecord with the ritual required to switch to this quest
ActivatingRitualContextCcoRitualRecordVoidReturn a CcoRitualRecord with the ritual required to activate this quest
CompletedQuestsRequiredToUnlockIntVoidReturn the number of other quest chains that need to be completed for this quest to be unlocked
NumMissionsRequiredIntVoidReturn the number of required missions to unlock the final quest
SortOrderIntVoidReturn the sort order of the quest chain
IconPathStringVoidReturn the icon path of the quest chain
QuestChainNameStringVoidReturn the name of the quest chain
AncillaryRecordContextCcoAncillaryRecordVoidReturn associated CcoAncillaryRecord
EffectBundleCcoEffectBundleVoidReturn associated CcoEffectBundle
MainUnitRecordContextCcoMainUnitRecordVoidReturn a CcoMainUnitRecord associated with the battles of legend quest chain

CcoPooledResourceTransfer

Component context manager for pooled resource transfer

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ClearVoidVoidClears source selection and sets selected value to 0. Normally used on panel close.
ApplyVoidCcoCampaignMilitaryForceApplies the transfer to the provided forces
SetSelectedValueVoidIntSet the value to transfer
SetSourceVoidCcoCampaignMilitaryForceSet the military force used as the source of the transfer
CanApplyBoolCcoCampaignMilitaryForceReturns true if the selected source has the selected amount of resource and can pay the cost to transfer it to the provided sink
CostIntCcoCampaignMilitaryForceReturns the cost to transfer the selected value from the selected source to the provided sink
SelectedValueIntVoidReturns the current value set to transfer
IsSelectedSourceBoolCcoCampaignMilitaryForceReturns true if the force is the currently selected source
CanBeSourceBoolCcoCampaignMilitaryForceReturns true if the provided force can transfer the pooled resource to another.
ValidSinksCcoCampaignMilitaryForce (list)CcoCampaignMilitaryForce (optional)Returns the list of military forces that can receive meat from the selected source or from the provided source override.
ValidSourcesCcoCampaignMilitaryForce (list)VoidReturns the list of military forces that can transfer meat.

CcoPreBattleAIAvailableGenerals

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetGeneralsListContextListVoid

CcoPreBattleChallenge

Wraps the pre-battle challenge mechanic.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TooltipTextUniStringVoidReturns a localised string explaining the pre-battle challenge mechanic, the player's chance of success, and any reasons if the option is currently unavailable.
LocalisedUnavailabilityReasonsUniStringVoidReturns a localised string explaining why the challenge option is unavailable.
IsOptionAvailableBoolCcoCampaignCharacterReturns true if the pre-battle challenge option is available for the given character context.
ShouldShowOptionBoolCcoCampaignCharacterReturns true if the pre-battle challenge option should be visible for the given character context.
DevForceFailVoidVoidForces the pre-battle challenge to fail. Debug method used in the dev UI.
DevForceSucceedVoidVoidForces the pre-battle challenge to succeed. Debug method used in the dev UI.
PerformVoidVoidTriggers the pre-battle challenge via a CCQ command.
SuccessChanceIntVoidReturns the player's chance of success in the duel as an integer between 0 and 100.

CcoPreBattleFactionVote

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsVoteAvailableBoolStringReturns whether passed in String representing the vote is available for the this faction of this vote
SelectedVoteUniStringVoidReturns localised stringrepresenting the vote cast, can return empty string
SelectedVoteKeyStringVoidReturns UNlocalised stringrepresenting the vote cast, can return empty string
IsPermittedToChangeVoteBoolVoidReturns bool whetehr the faction is permitted to change its vote
SupportDefenderFactionContextCcoCampaignFactionVoidReturns the primary defending faction, which if choose to support defender you would be supporting
SupportAttackerFactionContextCcoCampaignFactionVoidReturns the primary attacking faction, which if choose to support attacker you would be supporting
SelectedPlayAsAIFactionCcoCampaignFactionVoidReturns CcoCampaignFaction context for the selected to play as ai faction, can return nullptr
IsComponentOnAttackingUISideOfPrebattleBoolExpressionStateReturns true if component this is called on is a child of the panel side in prebattle showing attackers (used for determining which faction would be supporting)
IsVoteDisabledBoolString, Bool (optional)Returns true if this vote is currently disabled (used to set button inactive). Takes the vote option id as string, and if any factions available to select for if play as ai option
FactionCcoCampaignFactionVoidReturns CcoCampaignFaction context this vote belongs to
HasVotedBoolVoidReturns whether a vote has been cast
HasSelectedPlayAsAiFactionBoolVoidReturns whether a Play as AI faction has been selected
PlayAsAIFactionSelectedContextContextVoidReturns Play as AI faction selected, can return nullptr
IsFactionAvailableAsPlayAsAIBoolCcoCampaignFactionReturns whether the vote's faction and play as passed in AI faction
CastVoteVoidString, Bool, CcoCampaignFaction (optional)Submits a vote for a faction, takes in String representing the vote, a bool for if want to toggle off if already active, and optional CcoCampaignFaction for play as ai vote

CcoPreBattleUnitTargetedAbility

Component context wrapper for EMPIRECAMPAIGN::PRE_BATTLE_UNIT_TARGETED_ABILITY

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CostPerUnitTierIntVoidAbility cost per tier of the targeted unit.
MaxTargetableUnitTierIntVoidMaximum tier of unit that can be targeted by this ability.

CcoPreBattleVotingSystem

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsReadyTimerActiveBoolVoidReturns true if all players selected a vote and battle is counting down to start
FactionsAvailableToPlayAsAICcoCampaignFaction (list)CcoCampaignFactionReturn context list of CcoCampaignFaction representing the factions of armies that are available to be played as AI
AllVotesCcoPreBattleFactionVote (list)VoidReturns context list of all CcoPreBattleFactionVote contexts in the voting system
FactionPlayingAsAiFactionCcoCampaignFactionCcoCampaignFactionReturns the faction context for who is playing as AI for the specified faction (null if no one and will be controlled by AI)
VoteForFactionCcoPreBattleFactionVoteCcoCampaignFactionReturns CcoPreBattleFactionVote context for the CcoCampaignFaction passed in, can return nullptr
CanCancelReadyBoolVoidReturns true if can call CancelReady
CancelReadyVoidVoidCancels ready status of local player which will reset their vote and cancel the current countdown timer for battle to commence
ReadyCountdownTimeUniStringVoidReturns formatted localised time until battle will commence

CcoPrisonSystem

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsPrisonFullVoidVoid
MaxNumberOfPrisonersVoidVoid
CurrentNumberOfPrisonersVoidVoid

CcoSaveGameHeader

Wrapper for a save game header

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FilenameStringVoidReturns the filename
TimeTextUniStringVoidReturns the formatted time the save was made
DateTextUniStringVoidReturns the formatted date the save was made
DifficultyTextUniStringVoidReturns the difficulty of the campaign
FactionNameUniStringVoidReturns name of faction playing as (use this instead of record as supports renaming of faction)
SeasonTextUniStringVoidCurrent season in the save game
CampaignRecordContextCcoCampaignMapPlayableAreaRecordVoidReturns the CcoCampaignMapPlayableAreaRecord for campaign
FactionRecordContextCcoFactionRecordVoidReturns the CcoFactionRecord for faction playing as
IsDifferentBuildVersionBoolVoidReturns true if save made with different build to current game, to warn of potential issues/changes
IsCloudSaveBoolVoidReturns true if save is in the cloud
YearIntVoidCurrent year in the save game
TurnNumberIntVoidCurrent turn number in the save game

CcoScriptRequirement

Temporary wrapper for a script-driven unlock requirement shown in UI (e.g. initiative or ritual locks).
Script pushes data via common.set_context_value(script_object_id, { [record_key] = { requirement, ... } }). UI reads it with CcoCampaignInitiative.ScriptRequirements(script_object_id) or CcoCampaignRitual.ScriptRequirements(script_object_id).
Each requirement table field:
- condition_met (bool, optional, default false): whether the requirement is currently met
- localisation_key (string, optional): stringtable key for Description
- localisation_params (list, optional): format params for the localisation string (max 3 used)
- zoom_to (string, optional): ZoomToLink target; leave empty if no zoom
Each localisation_params entry is { type, value } where type is:
- int: value formatted as decimal
- string: value as UniString
- localisation_key: value looked up in the stringtable
zoom_to supported prefixes: character_cqi:, region_cqi:, building_level_record_key:.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ZoomToVoidVoidZooms via ZoomToLink(zoom_to, try_select=true). Supported prefixes: character_cqi:, region_cqi:, building_level_record_key:. Errors if zoom_to is empty.
HasZoomToBoolVoidReturns true if zoom_to is non-empty. Use to show/hide the zoom button.
ConditionMetBoolVoidReturns true if condition_met was set true in the script requirement table.
DescriptionUniStringVoidReturns the localised description from localisation_key, formatted with up to 3 localisation_params. Returns empty if localisation_key is missing.

CcoSeafangArmies

Component Context Wrapper for the system for the Seafang Wulfrik teleporting army and any army that could tag along for the teleport

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PotentialTagalongArmiesCountIntVoidReturns the number of armies that can be teleported
GetRitualCooldownTimeIntVoidReturns the number of turns the ritual will be on cooldown (can change depending on units teleported)
GetMaxTeleportedUnitsCountIntVoidReturns the maximum amount of units that can be teleported
GetCurrentTeleportedUnitsCountIntVoidReturns the current number of units selected for teleport
TeleportingCharacterContextCcoCampaignCharacterVoidReturns the context for the teleporting character

CcoTempleOfTheOldOnes

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionVoidVoid
NameVoidVoid
ColourVoidVoid
CurrentEffectBundleVoidVoid
NumberOfBuildingsVoidVoid
CurrentLevelVoidVoid

Common

CcoAdvisor

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ClearHistoryVoidVoid
AdviceHistoryListVoidVoid

CcoAgentSubtypeAgentPair

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitDetailsContextCcoUnitDetailsVoid
AgentContextCcoAgentRecordVoid
AgentSubtypeContextCcoAgentSubtypeRecordVoid

CcoBattleResult

Wrapper for a battle result

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ResultTypeRecordContextCcoBattleResultTypeRecordVoid
IsDrawBoolVoid
IsLocalPlayerWinnerBoolVoid
OtherResultAllianceContextCcoBattleResultAllianceVoid
LocalResultPlayerAllianceContextCcoBattleResultAllianceVoid
DurationUniStringVoid

CcoBattleResultAlliance

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ResultTypeVoidVoid
ResultNameVoidVoid
ArmyListVoidVoid
ArmyContextVoidVoid

CcoBattleResultArmy

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NumEntitiesInitialVoidVoid
NumEntitiesVoidVoid
GeneralsNameVoidVoid
SetupArmyContextVoidVoid
IsHumanVoidVoid
PlayerNameVoidVoid
UnitListVoidVoid
FactionRecordContextVoidVoid
FactionFlagDirVoidVoid
FactionNameVoidVoid

CcoBattleResultUnit

Wrapper for a battle result unit

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NumKillsIntVoidNumber of kills the unit got in the result
UnitRecordContextCcoMainUnitRecordVoidReturns a CcoMainUnitRecord context for the unit
ImagePathStringExpressionStatePath to the unit card image for the unit
DidLeaveBattlefieldBoolVoidReturns true if the unit left the battle (a shameful display)
DidRoutBoolVoidReturns true if the unit routed during the battle
IsCommanderBoolVoidReturns true if the unit is a commander
HealthPercentFloatVoidPercentage health remaining for the unit
DamageDealtCostIntVoidGold value of the damage dealt by the unit
DamageDealtIntVoidDamage dealt by the unit
ExperienceLevelIntVoidExperience level of the unit
NameUniStringVoidLocalised name of the unit
NumHitPointsInitialIntVoidNumber of hitpoints before result
NumHitPointsIntVoidNumber of hitpoints post result
NumEntitiesInitialIntVoidInitial number of entities before result
NumEntitiesIntVoidNumber of entities post result
NumKillsFriendliesIntVoidNumber of friendly kills the unit got in the result

CcoCallbackExpressionStore

A class representing a one-to-one relationship between a component and one of its callbacks.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ValueListContextListVoidReturns a list of all the expression values stored for this callback-component pair.ui, debug

CcoCampaignCharacterPoolEntry

Component context wrapper for a character recruitment pool entry

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AgentRecordContextCcoAgentRecordVoidReturns the agent record of this character pool entry
MainUnitRecordContextCcoMainUnitRecordVoidReturns the main unit record of this character pool entry
CharacterContextCcoCampaignCharacterVoidReturns the character cco of the character entry
CanRecruitCharacterBoolVoidReturns true if this character is unlocked for recruitment

CcoCampaignEffectGroup

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectListVoidVoid
LocalisedTitleVoidVoid

CcoCampaignFactionMercenaryPool

Component context wrapper for a faction mercenary pool

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanRecruitUnitForFactionBoolCcoCampaignFaction, CcoCampaignMercenaryPoolUnitReturns if the unit can be recruited from the pool for a faction
IsProvidingMercenaryUnitForFactionBoolCcoCampaignFactionReturns if the mercenary pool provides any unit for the given faction
MercenaryPoolSizeFilteredByFactionIntCcoCampaignFactionReturns the size of the list of available mercenary pool units filtered by faction
MercenaryPoolSizeIntVoidReturns the size of the list of available mercenary pool units
MercenaryPoolUnitListCcoCampaignMercenaryPoolUnit (list)VoidReturns the list of available mercenary pool units

CcoCampaignMercenaryPoolUnit

Component context wrapper for a mercenary pool unit

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MainUnitRecordContextCcoMainUnitRecordVoidReturns the main unit record of this mercenary pool unit
HasInfiniteUnitCountBoolVoidReturns if the mercenary pool unit has infinite amount available
CurrentMaxUnitCountIntVoidReturns the max mercenary pool unit count
AvailableUnitCountIntVoidReturns the available mercenary pool unit count

CcoCampaignModelBuilding

Model safe context wrapper for a campaign building

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsDamagedBoolVoidReturns true if this building is damaged
LevelIntVoidReturns the level of this building
ForeignSlotDiscoveredByFactionBoolCcoCampaignModelFactionReturns true if this foreign slot has been discovered by the faction passed in
ArmyCcoCampaignModelMilitaryForceVoidArmy that contains this building
ProvinceCcoCampaignModelProvinceVoidProvince that contains this building
RegionCcoCampaignModelRegionVoidRegion that contains this building
OwnerCcoCampaignModelFactionVoidFaction that owns this building and the region
ChainRecordKeyStringVoidDatabase record key of the building chain this building belongs to
RecordKeyStringVoidDatabase record key of this building

CcoCampaignModelCharacter

Model safe context wrapper for a campaign character

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsFactionLeaderBoolVoidReturns true if the character is a faction leader.
SubtypeKeyStringVoidReturns the character's subtype record key
ForceCcoCampaignModelMilitaryForceVoidThe commanded military force of this military force if available.
OwnerCcoCampaignModelFactionVoidFaction that owns this character

CcoCampaignModelFaction

Model safe context wrapper for a campaign faction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsRitualActiveBoolStringReturns true if ritual for ritual key is currently active
ModelPooledResourceContextCcoCampaignModelPooledResourceStringModel pooled resource context for given key, if valid
SettlementListCcoCampaignModelSettlement (list)VoidReturns a model-side context list of settlements owned by the faction.
IsEffectBundleActiveBoolStringTest if specific effect bundle is active on the faction
IsCampaignFeatureAvailableBoolStringTest if specific campaign feature is available
IsTechnologyResearchedBoolStringTest if tech for given tech key is researched or not
IsInFactionSetBoolStringTest if the faction is contained in the specified faction set
SubcultureIsOneOfBoolArgumentPackTest if the subculture key is one of the specified list. Can accept any number of subculture keys
HasTradeAgreementWithBoolCcoCampaignModelFactionReturns true if has a trade agreement with the faction passed in
CultureIsOneOfBoolArgumentPackTest if the culture key is one of the specified list. Can accept any number of culture keys
IsVassalOfBoolCcoCampaignModelFactionReturns true if vassal of the faction passed in
RecordKeyIsOneOfBoolArgumentPackTest if the faction key is one of the specified list. Can accept any number of faction keys
IsRogueFactionBoolVoidIs this faction a rogue faction?
IsAlliedWithBoolCcoCampaignModelFactionReturns true if allied with the faction passed in
SubcultureKeyStringVoidDatabase record key of this factions subculture
EntitySharedStateReadStringStringStringTakes a String id, and returns stored string value in shared state for this faction with that key. Value will be empty if doesnt exist in registry.registry
CultureKeyStringVoidDatabase record key of this factions culture
EntitySharedStateReadBoolBoolStringTakes a String id, and returns stored bool value in shared state for this faction with that key. Value will be false if doesnt exist in registry.registry
UnitCapForUnitIntStringUnit cap for main unit record key. -1 if uncapped or not valid
TreasuryIntVoidCurrent treasury balance
EntitySharedStateReadFloatFloatStringTakes a String id, and returns stored float value in shared state for this faction with that key. Value will be -1 if doesnt exist in registry.registry
RecordKeyStringVoidDatabase record key of this faction
EntitySharedStateValueExistsBoolStringTakes a String id, and returns if there's any state stored for this faction with that key.registry
IsOwnershipProductUnlockedBoolStringChecks if ownership product is unlocked for a faction
InitiativeManagerContextCcoCampaignModelInitiativeManagerVoidFaction level initiative manager context

CcoCampaignModelFactionProvinceManager

Model safe context wrapper for a campaign faction province

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsEffectBundleActiveBoolStringTest if specific effect bundle is active in the province
PooledResourceContextForKeyCcoCampaignModelPooledResourceStringModel pooled resource context for given key for Faction province pooled resources, if valid

CcoCampaignModelInitiative

Initiative wrapper safe to use in campaign model contexts

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsActiveBoolVoidTest if initiative is active
KeyStringVoidDb key of the initiative

CcoCampaignModelInitiativeManager

Cco wrapper for a initiative manager, safe to use in campaign model contexts

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactionContextCcoCampaignModelFactionVoidOwning faction of the manager
InitiativeSetContextCcoCampaignModelInitiativeSetStringInitiative set context for given key if valid
OwnedSetsCcoCampaignModelInitiativeSet (list)VoidList of owned initiative sets

CcoCampaignModelInitiativeSet

Initiative set wrapper safe to use in campaign model contexts

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
InitiativeContextCcoCampaignModelInitiativeStringInitiative context for given key, if valid
ActiveInitiativesCcoCampaignModelInitiative (list)VoidList of active initiatives in set

CcoCampaignModelMilitaryForce

Model safe context wrapper for a campaign military force

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentStanceKeyStringVoidReturns the military force current stance key from the campaign_stances db table
UnitActionPointsAlwaysZeroThisTurnBoolVoidReturns whether the m_action_points_always_zero flag is set for units in this force, meaning they won't be able to gain AP this turn
IsEffectBundleActiveBoolStringReturns true if specific effect bundle is active on the force
IsLoanedArmyBoolVoidReturns whether this force was loaned from another faction
CanMoveInCurrentStanceBoolVoidReturns whether the military force can move in the current stance
FactionLoanedFromContextCcoCampaignModelFactionVoidReturns the CcoCampaignModelFaction that we were loaned from if any
SeaRegionCcoCampaignModelSeaRegionVoidThe sea region this force is currently in, if any
RegionCcoCampaignModelRegionVoidThe region this force is currently in, if any
GeneralCcoCampaignModelCharacterVoidThe general character of this military force.
OwnerCcoCampaignModelFactionVoidFaction that owns this military force.

CcoCampaignModelPooledResource

Campaign model wrapper for a pooled resource

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MaxIntVoidMaximum bound of this resource
MinIntVoidMinimum bound of this resource
PercentageOfCapacityFloatVoidPercentage towards full capacity for this resource
TotalIntVoidCurrent total of this resource

CcoCampaignModelPooledResourceManager

Model safe context wrapper for a campaign pooled resource manager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PooledResourceContextForKeyCcoCampaignModelPooledResourceStringModel pooled resource context for the given key, if valid for this manager

CcoCampaignModelProvince

Model safe context wrapper for a campaign province

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsFactionAgentSubtypePresentBoolString, CcoCampaignModelFactionTest if the a character of the specified agent subtype, owned by the specified faction, is present in the province
IsFactionAgentPresentBoolString, CcoCampaignModelFactionTest if the a character of the specified agent type, owned by the specified faction, is present in the province
IsAgentSubtypePresentBoolStringTest if any character of the specified agent subtype is present in the province
IsAgentPresentBoolStringTest if any character of the specified agent type is present in the province
IsFactionOwnerOfEntireProvinceBoolCcoCampaignModelFactionDoes the specified faction own the entire province?
PooledResourceContextForKeyCcoCampaignModelPooledResourceStringModel province's pooled resource context for given key, if valid
FactionPersistendPooledResourceManagerCcoCampaignModelPooledResourceManagerCcoCampaignModelFactionReturns the persistent pooled resource manager for the given faction, if available in this province
FactionProvinceManagerCcoCampaignModelFactionProvinceManagerCcoCampaignModelFactionReturns the faction province manager for the given faction, if available in this province
DoesFactionOwnMajorityOfRegionsBoolCcoCampaignModelFactionTest if the faction owns more than half of the regions in the province
FactionRegionsCcoCampaignModelRegion (list)CcoCampaignModelFactionRegions contained in this province, owned by the specified faction
RegionsCcoCampaignModelRegion (list)VoidRegions contained in this province
IsEnemyOfFactionMilitaryForcePresentBoolCcoCampaignModelFactionTest if a military force that is an enemy of the specified faction is present in the province
RecordKeyStringVoidDatabase record key of this province
IsFactionMilitaryForcePresentBoolCcoCampaignModelFactionTest if a military force belonging to the specified faction is present in the province
IsAnyMilitaryForcePresentBoolVoidTest if any military force is present in the province
IsEnemyOfFactionAgentSubtypePresentBoolString, CcoCampaignModelFactionTest if the a character of the specified agent subtype, owned by an enemy of the specified faction, is present in the province
IsEnemyOfFactionAgentPresentBoolString, CcoCampaignModelFactionTest if the a character of the specified agent type, owned by an enemy of the specified faction, is present in the province

CcoCampaignModelRegion

Model safe context wrapper for a campaign region

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsAgentPresentBoolStringTest if the specified agent type is present in the region
ClimateKeyStringVoidReturns the key of the climate of the settlement attached to this region
FactionProvinceGDPIntVoidGDP (income) that the owning faction generates from all of its regions in the province
RecordKeyIsOneOfBoolArgumentPackTest if the region key is one of the specified list. Can accept any number of region keys
HasResourceBoolStringReturns true if the region has a specific pooled resource
GDPIntVoidGDP (income) that this Region generates. Cannot be negative
HasPooledResourceBoolStringReturns true if the region has a specific pooled resource
IsOriginatingSubcultureOneOfBoolArgumentPackTest if the originating subculture key is one of the specified list. Can accept any number of subculture keys
DevelopmentPointsIntVoidAmount of development points accumulated and unspent. This value will be the same for every region owned by the faction in this province
OriginatingSubcultureKeyStringVoidReturns the record key of the originating subculture of this region
IsPortBoolVoidReturns true if the region is/has a port
GrowthPerTurnIntVoidAmount of growth accumulated per-turn. This value will be the same for every region owned by the faction in this province
IsHomeRegionBoolVoidIs this the factions home region?
IsProvinceCapitalBoolVoidReturns true if the region is the province capital
GrowthIntVoidAmount of growth accumulated towards the next development point. This value will be the same for every region owned by the faction in this province
OwnerCcoCampaignModelFactionVoidReturns the faction that owns this region. May be rebel if abandoned or following a successful rebellion
BelongsToRegionGroupBoolStringReturns true if the region belongs to the region group with the passed in key
PublicOrderChangePerTurnIntVoidAmount that public order is currently changing per-turn. This value will be the same for every region owned by the faction in this province
SettlementCcoCampaignModelSettlementVoidReturns the settlement of this region
IsAbandonedBoolVoidReturns true if the region is abandoned
NextTurnPublicOrderIntVoidPublic order balance for next turn. This value will be the same for every region owned by the faction in this province
IsEffectBundleActiveBoolStringTest if specific effect bundle is active in the region
FactionProvinceManagerCcoCampaignModelFactionProvinceManagerVoidFaction Province that contains this region
PublicOrderIntVoidPublic order balance for this turn. This value will be the same for every region owned by the faction in this province
IsOwnMilitaryForcePresentBoolCcoCampaignModelFaction (optional)Test if any military force owned by the local faction is present in the region
ProvinceCcoCampaignModelProvinceVoidProvince that contains this region
IsFactionAgentSubtypePresentBoolString, CcoCampaignModelFactionTest if the specified agent subtype is present in the region and owned by the specified faction
RecordKeyStringVoidReturns the record key of this region
IsAnyOwnAgentPresentBoolCcoCampaignModelFaction (optional)Test if any agent owned by the local faction is present in the region
IsFactionAgentPresentBoolString, CcoCampaignModelFactionTest if the specified agent type is present in the region and owned by the specified faction
IsAnyEnemyMilitaryForcePresentBoolCcoCampaignModelFaction (optional)Test if any enemy military force is present in the region
IsOwnAgentSubtypePresentBoolString, CcoCampaignModelFaction (optional)Test if the specified agent subtype is present in the region and owned by the local faction
ModelPooledResourceContextCcoCampaignModelPooledResourceStringModel pooled resource context for given key, if valid
EntitySharedStateValueExistsBoolStringTakes a String id, and returns if there's any state stored with that id in this entity (bool EntitySharedStateValueExists(String key)).registry
IsOwnAgentPresentBoolString, CcoCampaignModelFaction (optional)Test if the specified agent type is present in the region and owned by the local faction
IsAnyEnemyAgentPresentBoolCcoCampaignModelFaction (optional)Test if any enemy agent is present in the region
EntitySharedStateReadStringStringStringTakes a String id, and returns stored String value in shared state with that key in this entity (bool EntitySharedStateReadString(String key)). Value will be "" if doesn't exist in registry.registry
IsEnemyAgentSubtypePresentBoolString, CcoCampaignModelFaction (optional)Test if the specified agent subtype is present in the region and owned by an enemy faction
IsAnyMilitaryForcePresentBoolVoidTest if any force is present in the region
IsAnyAgentPresentBoolVoidTest if any agent is present in the region
EntitySharedStateReadFloatFloatStringTakes a String id, and returns stored float value in shared state with that key in this entity (int EntitySharedStateReadFloat(String key)). Value will be -1 if doesn't exist in registry.registry
IsEnemyAgentPresentBoolString, CcoCampaignModelFaction (optional)Test if the specified agent type is present in the region and owned by an enemy faction
WindsOfMagicStrengthKeyStringVoidRecord key of the currently active winds of magic strength level for the region
EntitySharedStateReadBoolBoolStringTakes a String id, and returns stored bool value in shared state with that key in this entity (bool EntitySharedStateReadBool(String key)). Value will be false if doesn't exist in registry.registry
IsAgentSubtypePresentBoolStringTest if the specified agent subtype is present in the region
WindsOfMagicStrengthLevelIntVoidCurrently active winds of magic strength level for the region

CcoCampaignModelRoot

Model safe context wrapper for the campaign root, allows access to other model ccos from context viewer for example

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsMultiplayerBoolVoidReturns if it's a multiplayer game
CampaignKeyStringVoidReturns the campaign key for this campaign

CcoCampaignModelSeaRegion

Model safe context wrapper for a campaign region

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsFactionAgentSubtypePresentBoolString, CcoCampaignModelFactionTest if the specified agent subtype is present in the region and owned by the specified faction
IsFactionAgentPresentBoolString, CcoCampaignModelFactionTest if the specified agent type is present in the region and owned by the specified faction
IsOwnAgentSubtypePresentBoolString, CcoCampaignModelFactionTest if the specified agent subtype is present in the region and owned by the local faction
IsOwnAgentPresentBoolString, CcoCampaignModelFactionTest if the specified agent type is present in the region and owned by the local faction
IsEnemyAgentSubtypePresentBoolString, CcoCampaignModelFactionTest if the specified agent subtype is present in the region and owned by an enemy faction
IsEnemyAgentPresentBoolString, CcoCampaignModelFactionTest if the specified agent type is present in the region and owned by an enemy faction
IsAgentSubtypePresentBoolStringTest if the specified agent subtype is present in the region
IsAgentPresentBoolStringTest if the specified agent type is present in the region
BelongsToRegionGroupBoolStringReturns true if the sea region belongs to the region group with the passed in key
IsOwnMilitaryForcePresentBoolCcoCampaignModelFactionTest if any military force owned by the local faction is present in the region
IsAnyOwnAgentPresentBoolCcoCampaignModelFactionTest if any agent owned by the local faction is present in the region
IsAnyEnemyMilitaryForcePresentBoolCcoCampaignModelFactionTest if any enemy military force is present in the region
IsAnyEnemyAgentPresentBoolCcoCampaignModelFactionTest if any enemy agent is present in the region
IsAnyMilitaryForcePresentBoolVoidTest if any force is present in the region
IsAnyAgentPresentBoolVoidTest if any agent is present in the region

CcoCampaignModelSettlement

Model safe context wrapper for a campaign settlement

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SettlementTypeStringVoidReturns a String key with the settlement's type (key from settlements_type database table).
IsProvinceCapitalBoolVoidReturns true if this is a major settlement, or in other words if it's the capital of a province.
HasGarrisonBoolVoidReturns true if the settlement has an army or navy garrisoned, otherwise returns false.
HasPortBoolVoidReturns true if the settlement has a port, otherwise returns false.
BuildingsCcoCampaignModelBuilding (list)VoidReturns a list of ModelBuilding contexts that this settlement has.
PrimaryBuildingCcoCampaignModelBuildingVoidReturns the ModelBuilding context of the primary building in this settlement.
RegionCcoCampaignModelRegionVoidReturns the ModelRegion context that this settlement belongs to.
OwnerCcoCampaignModelFactionVoidReturns the ModelFaction context that owns this settlement.

CcoCampaignModelUnit

Model safe context wrapper for a campaign unit

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OwningFactionContextCcoCampaignModelFactionVoidContext of the unit's faction
ExperienceLevelIntVoidCurrent level of the unit

CcoCampaignProvinceMercenaryPool

Component context wrapper for a province mercenary pool

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanRecruitUnitForFactionBoolCcoCampaignFaction, CcoCampaignMercenaryPoolUnitReturns if the unit can be recruited from the pool for a faction
IsProvidingMercenaryUnitForFactionBoolCcoCampaignFactionReturns if the mercenary pool provides any unit for the given faction
MercenaryPoolSizeFilteredByFactionIntCcoCampaignFactionReturns the size of the list of available mercenary pool units filtered by faction
MercenaryPoolSizeIntVoidReturns the size of the list of available mercenary pool units
MercenaryPoolUnitListCcoCampaignMercenaryPoolUnit (list)VoidReturns the list of available mercenary pool units

CcoCampaignStartInfo

Wrapper for frontend campaign start info

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LordListForFactionCcoFrontendFactionLeader (list)CcoCultureRecordReturns a list of CcoFrontendFactionLeaders for a passed in culture
UnownedCultureListCcoCultureRecord (list)VoidReturns a list of CcoCultureRecord for this campaign that the player doesn't own
OwnedCultureListCcoCultureRecord (list)VoidReturns a list of CcoCultureRecord for this campaign that the player owns
CultureListCcoCultureRecord (list)VoidReturns a list of CcoCultureRecords with the cultures from this campaign
FactionListCcoFactionRecord (list)VoidReturns a list of CcoFactionRecords with the factions in this campaign
StartDateIntVoidReturns an int with the start date of the campaign
VictoryDescriptionTextUniStringVoidReturns the localised victory description of the campaign which describes how to obtain victory
DescriptionTextUniStringVoidReturns the localised description of the campaign
NameUniStringVoidReturns the localised name of the campaign
TimeOfLegendsCampaignRecordContextCcoTimeOfLegendsCampaignRecordVoidReturns the CcoTimeOfLegendsCampaignRecord for this campaign, if any (only used in a subset of mp campaigns)
GenerateMapOverlayForFactionVoidExpressionState, CcoFactionRecordGenerates overlay for supplied faction and sets up component called on
ShowEndgameSettingsBoolVoidReturns true if Endgame Scenario settings should be shown for this campaign
CampaignMapPlayableAreaRecordContextCcoCampaignMapPlayableAreaRecordVoidReturns a CcoCampaignMapPlayableAreaRecord with the playable area record for this campaign
IsCampaignMapUnlockedBoolVoidReturns true if the campaign is unlocked for the player
CharacterListCcoFrontendFactionLeaderRecord (list)VoidReturns a list of CcoFrontendFactionLeaderRecord with faction leaders that are part of this campaign
IsResumedBoolVoidReturns true if the campaign is resumed
KeyStringVoidReturns a string with the campaign key
LordForFactionCcoFrontendFactionLeaderCcoFactionRecord, IntReturns a CcoFrontendFactionLeader for the specified CcoFactionRecord if one exists
MechanicListForCultureCcoEffect (list)CcoCultureRecordReturns a list of effects that describe the unique traits of the passed in culture
OwnedLordListForFactionCcoFrontendFactionLeader (list)CcoCultureRecordReturns a list of CcoFrontendFactionLeaders for a passed in culture that the player owns

CcoCharacterSpecialUnitAvailability

Component context wrapper for a character special units availability

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsLockedBoolVoidReturns true if the character special unit is locked
UnitDetailsContextCcoUnitDetailsVoidReturns the CcoUnitDetails

CcoClickHoldContext

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HoldPercentFloatVoidReturns the percentage hold value

CcoComponent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetPropertyStringStringReturns the value of the specified user property key
StartDraggingVoidVoidWill pin component to follow cursor until next left click. Primarily added for dev purposes so can find components easily and workaround overlap issues
IsParentOfBoolCcoComponentReturns true if the component is a parent of the other component passed.
CurrentTooltipLocalisationStringsStringVoidReturns the localisation string sources for the component tooltip
CustomTooltipClearVoidVoidClears any tooltip created with CustomTooltipCreatedebug, hide_in_uied
SetContextVoidContextSets the context on a component only (not children) using a specified context object given as a parameter
LayoutPathStringVoidReturns the layout path so know which layout this component is authored in
PropertyExistsBoolStringReturns true if the specified property key exists
SetTextVoidUniStringSets the current text on the component
IsDisabledBoolVoidReturns true if the component is currently disabled
CurrentTextLocalisationStringsStringVoidReturns the localisation string sources for the component text
ToggleHighlightVoidVoidToggles a highlighting effect on the component to make it easier to finddebug, hide_in_uied
CustomTooltipCreateVoidVoidIf this component has a custom tooltip layout, this command will create that layout and pin it allowing you to inspect itdebug, hide_in_uied
SetContextFromIdVoidStringSets the context on a component using a specified context object id (type + objectid) to get it from the cache
IsMouseOverChildrenBoolVoidReturns true if the mouse is currently over this component or its children
IsInteractiveBoolVoidReturns true if the component is currently interactive
CurrentTooltipUniStringVoidReturns the current tooltip for the component
ListLayoutContextCcoListLayoutVoidReturns list engine tied to the component if valid
CurrentPriorityLockerCcoComponentVoidReturns the CcoComponent that is the current priority lock
StoredContextRequiredFromParentContextStringReturns the stored context with the specified type id on any of our parents, and will assert if it fails
SetImageVoidInt, StringSets image using specified image index and filepath
IsMouseOverBoolVoidReturns true if the mouse is currently over this component
SortChildrenVoidExpressionState, Bool, ExpressionSorts children using the provided expression
GetAnimationFramePropertyVector4String, Int, StringGets the values set for a given animation property on a specific frame of an animation on this component.
SoundCategoryStringVoidReturns the sound category of the componentsound
CurrentTextUniStringVoidReturns the current text for the component
IsVisibleFromRootBoolVoidReturns true if visible and all parents to root are visible (meaning it can actually be seen by player if in the bounds of the screen and not occluded)
StoredContextRequiredContextStringReturns the stored context with the specified type id and will assert if it fails
WarningListCcoUiWarning (list)Bool (optional)Returns list of warnings of potential issues with this component
SetIsTopmostObjectVoidBoolSets a component to be a topmost object, meaning it will render on top of everything else
SetAnimationFramePropertyVoidString, Int, String, Vector4Sets the specified property on a specific frame of a given animation on this component.
PropagateContextVoidContextSets the context on a component (including children) using a specified context object given as a parameter
CallbackStoreListCcoCallbackExpressionStore (list)Voiddebug, hide_in_uied
IsVisibleBoolVoidReturns true if visible property is set (can be true if this is visible but not parent)
IsSameGuidBoolStringReturnstrue if supplied guid is same as ours
IsTopmostObjectBoolVoidReturns true if the component is a topmost object, meaning it will render on top of everything else
SetVisibleVoidBoolSets the visibility of the component based on specified bool
FinishCurrentAnimationInstantlyVoidVoidFinishes the current animation instantly if there is one playing
OverrideSoundCategoryVoidStringSets the sound category of the component to the provided one
StoredContextFromParentContextStringReturns the stored context with the specified type id (if one exists) on any of our parents
GuidOriginalDebugIDStringVoidThis is the guid id to use when using conditional breakpoints, can just use CopyDebugGuidToClipboard to make this process smoother
IsUpdatingBoolVoidReturns true if the last update time of the component matches the root i.e. did update this frame
ResizeVoidInt, Int, Bool (optional)Resizes this component to the specified size
SetPropertyVoidString, StringSets a property on the component using the supplied key and value
TriggerAnimationVoidStringTriggers the specified animation
HasPlaceholderImageBoolVoidReturns true if any image on component is currently set to placeholder due to image tried to set not existingdebug
StoredContextContextStringReturns the stored context with the specified type id (if one exists)
GuidOriginalStringVoidThis is the globally unique id that the layout has in uied, but not the same necessarily it has in game since gets regenerated to ensure uniqueness. Useful for debug breakpoints
ContextCallbacksStringVoidReturns all context callbacks, context objects and functions as one big string for viewing in context viewer
ClearPriorityLockVoidVoidClears the current priority lock
TrashVoidVoidDestroys this component
CurrentAnimationStringVoidReturns the current animations id if any
ContextsListContextListVoidReturns list of all contexts stored on this component and its callbacks
IsActiveBoolVoidReturns true if component is in an active state
IsFullscreenBoolVoidReturns true if component dimensions are the same as the root component dimensions (so same size as screen). Used to easily toggle child components on based on if a panel is occupying whole of screen for example.
GuidStringVoidThis is the globally unique id has currently in game, for layouts created in game will be different to UiEd as we regenerate to ensure unique
PushPriorityLockVoidIntPushes a priority lock, any component with a priority under the value supplied will be made non-interactive
EnableDebugDisplayVoidBoolEnables/disables debug display which helps to visualise the bounds of this component and any additional debug infodebug, hide_in_uied
IsActiveFocusBoolVoidReturns true if this component is the current focus (for example if a text input typing into)
AnimationListStringVoidReturns a list of the animations on the component as a string
SimulateLClickVoidVoidSimulates a left click on the component
HasCallbackBoolStringReturns whether the component have a specific callback
SpineContextCcoSpineControllerVoidReturns a CcoSpineController context for the component if it has a spine controller
SpawnerContextCcoComponentVoidReturns the spawner of this tooltip component where applicable
SetPriorityVoidIntSets the priority of the component to the supplied priority
IsSelectedBoolVoidReturns true if in a selected state
BreakForDebuggingVoidVoidBreaks into code when attached to VS so can inspect internal component in greater detaildebug, hide_in_uied
ToggleDebugDisplayVoidVoidToggles debug display which helps to visualise the bounds of this component and any additional debug infodebug, hide_in_uied
ClearContextVoidString, BoolClears specified context type, and propagates if specified
ImagePathStringIntReturns the image path of the image at the specified index
SetImageMetricSizeVoidInt, Int, IntSets the size of the image metric on the current state
CurrentStateStringVoidReturns the current state name as a string
ModelViewContextCcoComponentModelViewVoidReturns a CcoComponentModelView context for the component if it has a model view (3d model display)
IsDebugDisplayEnabledBoolVoidChecks if there is currently an active debug display for the componentdebug, hide_in_uied
SetDisabledVoidBoolSets the components disabled flag to the specified bool value. Only relevant if a component is interactive, if a component is interactive but disabled it will handle mouseovers but not clicks
ChildCountPropagatedIntVoidReturns the number of children recursively (so number of our children, and childrens children, and so forth)
ChildContextCcoComponentStringReturns the child with the id specified (essentially does a find from this component, so child doesnt have to be direct children of us but can be a child of a child)
ExportComponentAndChildrenToXMLVoidVoidExports the current component and its children to an xml located in working_data/UI/GameLayoutExportsdebug, hide_in_uied
NumChildrenIntVoidReturns number of children
ImageListStringVoidReturns list of all image paths as string with each path on new line
SetInteractiveVoidBool, Bool (optional)Sets the components interactive flag to the specified bool value, and if specify false as a second parameter will just apply to current state (defaults to all states). Interactivity determines if a component can handle mouse interactions like clicks and mouseovers
SetStateBoolStringSets the state of the component to the supplied state
ParentContextCcoComponentString (optional)Returns the parent component if we have one
ToggleVisibilityVoidVoidToggles the visibility of the component
DimensionsVector4VoidReturns the current dimensions of the component
LastScriptCallLocationStringVoidReturns last location in script that did anything to the component which is useful when investigating functionality/issuesdebug, hide_in_uied
CopyDebugGuidToClipboardVoidVoidCopies the debug guid to clipboard so can set conditional breakpoints easilydebug, hide_in_uied
SetDebugDisplayColourVoidInt, Int, IntSets the colour of the debug display activated with ToggleDebugDisplay. Useful for when debugging layout engines within layout engines for example
HasChildrenBoolVoidReturns true if has any children
ExportLayoutToXMLVoidVoidExports the entire layout that the current component is in to an xml located in working_data/UI/GameLayoutExportsdebug, hide_in_uied
RelativePositionVector4VoidReturns the relative position of the component
StateListStringVoidReturns the list of state names as a string
CopyFullPathToClipboardVoidVoidReturns the components path from the root so can see all the parent ids that lead to this componentdebug, hide_in_uied
ChildListCcoComponent (list)VoidReturns list of all children
IsCreatedFromScriptBoolVoidReturns true if this component was created from script
SetDockPointVoidStringSets the dock point using specified string key (tl, tc, tr, cl, c, cr, bl, bc, tle, tce, tre, cle, ce, cre, ble, bce, bre)
MoveToAbsoluteVoidVector4Changes the absolute position of the component to the position specified
FindWithPredicateCcoComponent (list)ExpressionState, ExpressionReturns a list of every child component matching the passed predicate.
IsPriorityLockedBoolVoidReturns true if this components priority is lower than the current priority lock, meaning this component cannot be interacted with
RotateImageVoidInt, FloatRotates the specified image index by the specified angle in degrees
DockOffsetVector4VoidReturns the dock offset of the component
ForceUpdateContextDisplayVoidVoidForces the ContextCallback::UpdateDisplay call to hit, which is very handy for debugging combined with conditional breakpointsdebug, hide_in_uied
FontCategoryNameStringVoidReturns the current name of the current font category in the current state
TemplatePathStringVoidReturns the template layout path this component is authored from if any
NumVisibleChildrenIntVoidReturns the number of visible children
ContextHistoryListContextListVoidAllows to view the history of what contexts have been present on a component and where they originated from, useful for debugging flow of contextsdebug, hide_in_uied
SetListOffsetVoidInt, IntSets list offset on component (only works if in a list)
IdStringVoidReturns the id of the componentui
ChildIndexIntVoidReturns the index we are in our parents child list
PriorityIntVoidReturns the priority of the component
ShortcutKeyTextUniString (list)VoidReturns a string that represents the tooltip text for the component
CopyMemoryAddressToClipboardVoidVoidCopies the memory address of this component so that it can be used in conditional breakpointsdebug, hide_in_uied
SetDockOffsetVoidInt, IntSets dock offset on component (only works if already docked)
SetCallbackPropertyVoidString, String, StringSets the specified property key and value on the specified callback id
PositionVector4VoidReturns the absolute position of the component
MoveToRelativeVoidVector4Changes the relative position of the component to the position specified
SelectInActiveUiEdVoidVoidIf UiEd is open, this will open the layout this component is authored in and select itdebug, hide_in_uied
MemoryAddressStringVoidReturns the memory address of this componentdebug, hide_in_uied

CcoComponentModelView

Wrapper for a Components model view, so can get/set model/camera info

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SetCameraThetaVoidFloatSets the camera theta orientation in degrees
EnvironmentFilepathStringVoidReturns the environment filepath that is being used (that affects lighting)
CameraTargetVector4VoidReturns the x,y,z,0 of the cameras target position
CameraDistanceFloatVoidReturns the distance of the camera from the target
CameraFovFloatVoidReturns the field of view of the camera in degrees
CameraPhiFloatVoidReturns the phi angle for the orientation of the camera in degrees
CameraThetaFloatVoidReturns the pheta angle for the orientation of the camera in degrees
SetCameraTargetVoidVector4Sets the cameras target position
SetCameraDistanceVoidFloatSets the cameras distance from the target
SetCameraFovVoidFloatSets the camera field of view in degrees
SetCameraPhiVoidFloatSets the camera phi orientation in degrees

CcoContextHistoryObject

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ContextIdStringVoid
TimeIntVoid
ReasonStringVoid
ContextObjectIdStringVoid
CcoContextContextVoid
OriginComponentContextContextVoid
CallbackIdStringVoid

CcoContextSelection

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SelectionParentContextCcoComponentVoidReturns the CcoComponent that has the selection parent that is sending us
MouseOverContextContextVoidReturns the context currently mousing over if we have one
FirstObjectContextVoidReturns the first selected context object
SelectedObjectListContextListVoidReturns the list of selected context objects

CcoCustomBattleArmyPreset

Wrapper for an army preset that can be saved / loaded

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsPinnedBoolVoidReturns true if this army preset is pinned in the save / load army preset panel
IsCustomBudgetBoolVoidReturns true if this army preset was saved with a custom budget
IsValidBoolVoidReturns true if the preset is valid. Invalid files either failed to load or did not pass DLC checks
TimeStampRawIntVoidReturns the raw time stamp
ReinforcingArmyCostIntVoidReturns the cost of reinforcing units of the army
MainArmyCostIntVoidReturns the cost of the main army
FactionKeyStringVoidReturns the key of the faction that this is a preset for
TimeStampFormatUniStringStringReturns timestamp formatted with given string
NameUniStringVoidReturns the name of the preset
BattleTypeContextCcoBattleTypeRecordVoidReturns a context to the battle type stored in the preset
FactionContextCcoFactionRecordVoidReturns a context to the faction that this preset stores an army for
SiegeEquipmentListCcoBattlefieldSiegeVehicleRecord (list)VoidReturns a list of siege equipment saved in the army preset
ReinforcingUnitListCcoMainUnitRecord (list)VoidReturns a list of reinforcing units saved in the army preset
TogglePinnedVoidVoidToggles the preset as pinned in the save / load army presets panel
DeleteVoidVoidRemoves the army preset from the filesystem, and removes it from the context cache
UnitListCcoMainUnitRecord (list)VoidReturns a list of unit saved in the army preset
LoadForPlayerSlotVoidCcoCustomBattlePlayerSlotLoads the preset for the given player slot context
IsHiddenBoolVoidReturns whether the preset is hidden to save / load panel

CcoCustomBattleArmyPresetFileHandler

Singleton wrapper for army preset file handler

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ArmyPresetListCcoCustomBattleArmyPreset (list)IntReturns a list of army presets saved to disk
ArmyPresetExistsBoolUniStringReturns true if an army preset exists with the given filename
ConfirmSaveOverwriteVoidVoidSaves army preset once the overwrite operation has been accepted
SaveArmyPresetForPlayerSlotVoidUniString, CcoCustomBattlePlayerSlotSaves the provided player slot's army with name given as the first argument

CcoCustomBattleLobby

Wrapper for the custom battle lobby

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsReadyCountdownActiveBoolVoidReturns true if the ready countdown is active (active once all players readied up)
ReadyStatusTextUniStringVoidReturns the text used on tooltip for ready button (to show ready errors)
DefaultSelectedPlayerSlotContextCcoCustomBattlePlayerSlotVoidReturns the default CcoCustomBattlePlayerSlot to select when entering lobby (default army shown)
CanAutoResolveBoolVoidReturns true if can use autoresolve simulationdebug, hide_in_uied
IsActiveBoolVoidReturns true if lobby is currently active/in use
ArmyPresetFileHandlerContextCcoCustomBattleArmyPresetFileHandlerVoidReturns the CcoCustomBattleArmyPresetFileHandler context which handles loading/saving army presets
CanInviteBoolVoidReturns true if can currently invite a player to the lobby
IsLocalPlayerFactionLockedBoolVoidReturns true if the player can no longer change their faction
AutoresolveBattleResultsContextCcoBattleResultVoidReturns the CcoBattleResult for an autoresolve simulation of units armies currently in the lobbydebug, hide_in_uied
IsLocalPlayerReadyBoolVoidReturns true if the local player is ready to play
HostSlotContextCcoCustomBattlePlayerSlotVoidReturns the host players CcoCustomBattlePlayerSlot
IsLocalPlayerSpectatingBoolVoidReturns true if the local player is currently spectating
LocalPlayerSlotContextCcoCustomBattlePlayerSlotVoidReturns the local players CcoCustomBattlePlayerSlot
IsLocalPlayerHostBoolVoidReturns true if the local player is currently the host
SettingsContextCcoCustomBattleSettingsVoidReturns the CcoCustomBattleSettings context that handles settings for lobby
IsSinglePlayerBoolVoidReturns true if this is a single player lobby (custom battle)
SpectatorSlotListCcoCustomBattlePlayerSlot (list)VoidReturns list of CcoCustomBattlePlayerSlot that are currently spectators
IsMatchmadeBattleBoolVoidReturns true if this lobby is for a matchmade quick battle
DevUISetCorruptionTileTypeVoidStringFor dev purposes, sets corruption tile type for trying out different corruptions in battles to make testing easier for env artistsdebug, hide_in_uied
PlayerSlotListCcoCustomBattlePlayerSlot (list)VoidReturns list of CcoCustomBattlePlayerSlot that are active in lobby
CountdownTimeSecsIntVoidReturns the current auto/faction lock/commencement countdown in seconds (only used in quick battles). Returns -1 if not active
TeamListCcoCustomBattleTeam (list)VoidReturns list of CcoCustomBattleTeam that are active in lobby
AddSpectatorSlotVoidVoidAdds a new spectator slot to lobby
ToggleFactionLockReadyVoidVoidToggles ready-for-faction-lock status of player
NumberOfPlayersIntVoidReturns the number of active players in the lobby
ToggleReadyVoidVoidToggles ready status of player
NumberOfPlayerSlotsIntVoidReturns the number of player slots in the lobby
LocalBalanceOfPowerPercentFloatVoidReturns a simulate autoresolve balance of power based on armies in the lobby
IsFactionSelectionCountdownPhaseBoolVoidReturns whether the current phase is faction selection (ready button locks in faction rather than starts game)
IsUsingSmallCardsBoolVoidReturns true if should use small card format (based on resolution)
ReadyButtonTextUniStringVoidReturns ready button text
CanAddSpectatorSlotBoolVoidReturns true if can currently add a spectator slot
ReadyButtonStateStringExpressionStateReturns the current state to set on the ready button for local player

CcoCustomBattleMap

Wrapper for a custom map

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ClickgenProvinceNameUniStringVoidReturns the clickgen province name
ClickgenRegionNameUniStringVoidReturns the clickgen region name
DevInfoUniStringVoidReturns string containing technical details about the mapdebug, hide_in_uied
NameUniStringVoidReturns the name of the map
OpenTerrainHTMLVoidVoidOpens the terrain.html file in your appdata/logs folder so you can see more details about the current selected map in custom battledebug, hide_in_uied
BattleTypeStringStringVoidReturns the battle type for the map
ClickgenClimateContextCcoClimateRecordVoidReturns the climate context for the map
TogglePinnedVoidVoidToggled this map as pinned in custom battle UI
CampaignMapRecordContextCcoCampaignMapPlayableAreaRecordVoidReturns the campaign map record context for the map
ToggleFavouriteVoidVoidToggles this map as a favourite
CampaignBattlePresetRecordContextCcoCampaignBattlePresetRecordVoidReturns the campaign battle preset context for the map
BattleRecordContextCcoBattleRecordVoidReturns the battle context for the map
IsPinnedBoolVoidReturns whether the map is pinned in custom battle UI
IsFavouriteBoolVoidReturns whether the map is favourited
IsPresetBoolVoidReturns whether the map is a preset
ClickgenCoordsRawVector4VoidReturns the raw clickgen co-ordinates
ClickgenCoordsVector4VoidReturns the clickgen co-ordinates
ClickgenGroundTypeNameUniStringVoidReturns the clickgen ground type

CcoCustomBattlePlayerSlot

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RemoveSiegeEquipmentVoidVoid
AutogenerateMainArmyVoidVoid
GetReinforcementFundsMultiplierVoidVoid
IsSpectatorVoidVoid
AddSiegeEquipmentVoidVoid
AutogenerateUnitsVoidVoid
IsLocalPlayerVoidVoid
FundsRemainingVoidVoid
IsUsingAutogenUnitsVoidVoid
CanAddSiegeEquipmentVoidVoid
ClearReinforcementsVoidVoid
GetTotalBudgetVoidVoid
SiegeEquipmentListVoidVoid
IsReadyVoidVoid
IsEmptyVoidVoid
ClearMainArmyVoidVoid
SetFactionVoidVoid
FundsBudgetVoidVoid
AvailableSiegeEquipmentListVoidVoid
IsHumanVoidVoid
ClearUnitsVoidVoid
TeamContextVoidVoid
IsAvailableForAutogenForDevVoidVoid
RecruitUnitVoidVoid
IsAIVoidVoid
ReinforcingUnitListVoidVoid
ToggleAutogenAvailabilityForDevVoidVoid
IsAllocatedVoidVoid
SwitchTeamVoidVoid
UnitListVoidVoid
UnitListForUnitGroupParentVoidVoid
CycleFactionForCurrentSubcultureVoidVoid
KickPlayerInSlotVoidVoid
IsOpenVoidVoid
TooltipToModifyUnitsVoidVoid
AffectedByAnyUnitCapVoidVoid
AvailableFactionsForCurrentSubcultureListVoidVoid
RemovePlayerSlotVoidVoid
IsTeamLeaderVoidVoid
IsHostVoidVoid
NumEntitiesVoidVoid
IsSynchronisedWithLobbyVoidVoid
OnMouseOffVoidVoid
SetSubcultureVoidVoid
CanInviteVoidVoid
NumSiegeVehiclesAvailableVoidVoid
OnMouseOnVoidVoid
AvailableSubcultureListVoidVoid
IsRecruitingReinforcementsVoidVoid
CanSwitchTeamVoidVoid
FactionsForCultureVoidVoid
SubcultureContextVoidVoid
AllianceColourVoidVoid
CanViewUnitsVoidVoid
SiegeVehicleTooltipVoidVoid
CanSelectFactionVoidVoid
NetworkPlayerContextVoidVoid
AvailableFactionListVoidVoid
TooltipForUnitVoidVoid
FactionSavedCharactersContextVoidVoid
SlotIndexVoidVoid
CanRecruitUnitVoidVoid
FactionRecordContextVoidVoid
CanModifyUnitsVoidVoid
CanModifySlotVoidVoid
SetIsRecruitingReinforcementsVoidVoid
AutogenerateReinforcementsVoidVoid
PlayerNameVoidVoid
IsFactionVisibleToLocalPlayerVoidVoid
CanKickOrRemoveVoidVoid

CcoCustomBattleSettings

Wrapper for the settings of custom battles

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsTimeoutDrawBoolVoidReturns whether timeouts result in a draw
SeasonRecordListCcoSeasonRecord (list)VoidReturns a list of available season records
FavouriteMapListCcoCustomBattleMap (list)VoidReturns a list of favourited custom battle maps
IsUsingLargeArmiesBoolVoidReturns whether large armies are being used
ToggleSplitFundsVoidExpressionStateToggle the split funds mode
MaxUnitsCanReinforceIntIntReturns the maximum number of units that can reinforce
TimeLimitSettingListCcoCustomBattleSettingRecord (list)VoidReturns a context list of time limit settings
SetBattleTypeRecordContextVoidExpressionState, CcoBattleTypeRecordSets the given context as the battle type
HistoryMapListCcoCustomBattleMap (list)VoidReturns list of custom battle map history
MaxUnitsCanRecruitIntIntReturns the maximum number of units that can currently be recruited
CanUseSplitFundsBoolVoidReturns whether can use the split funds mode
SeasonRecordContextCcoSeasonRecordVoidReturns a context to the season record
CanAddAiBoolVoidReturns true if current battle type supports adding of AI
SetMapCoordinateVoidExpressionState, String, StringSets the co-ord at index give ('x' or 'y'), to the value given
ToggleRealismModeVoidExpressionStateToggles realism mode
CustomTicketLimitAmountIntVoidReturns the value of the current custom ticket limit
SetWeatherTypeRecordContextVoidExpressionState, CcoBattleWeatherTypeRecordSets the given context as the weather type
TimeLimitSettingContextCcoCustomBattleSettingRecordVoidReturns a context to the setting record for time limit
IsSplitFundsEnabledBoolVoidReturns true if split funds mode is enabled
SetMapContextVoidExpressionState, CcoCustomBattleMapSets the given custom map context as the current map
SetUnitScaleSettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the given context as the unit scale setting
IsFreeForAllBoolVoidReturns whether this is a free for all battle
IsUsingCustomTicketLimitBoolVoidReturns true if currently using custom ticket limit
WeatherTypeRecordListCcoBattleWeatherTypeRecord (list)VoidReturns a list of available records for weather types
IsRealismModeBoolVoidReturns whether realism mode is being used
MapPresetListCcoCustomBattleMap (list)VoidReturns a list of currently available custom battle maps
ToggleStormOfMagicVoidExpressionStateToggles storm of magic setting (storm of magic is for warhammer, where magic is greatly empowered and the lore boosted changes every so often)
TimeLimitSecondsIntVoidReturns the time limit of the battle in seconds
UnitScaleSettingListCcoCustomBattleSettingRecord (list)VoidReturns a list of available unit scale settings
SetCustomTicketLimitVoidExpressionState, UniStringSets the given amount as the custom ticket limit
ToggleAttackingTeamVoidExpressionStateSwitches the attacking team
WeatherTypeRecordContextCcoBattleWeatherTypeRecordVoidReturns a context to the weather type record
CampaignBattleTypeStringStringVoidReturns a string representation of the battle type
ForceSettingResyncVoidVoidForces settings to be resynced
SetTicketLimitSettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the ticket limit setting value
CanToggleAttackingTeamBoolVoidReturns whether the attacking team can be toggled (switched), some battle types do not allow toggling
UnitScaleSettingContextCcoCustomBattleSettingRecordVoidReturns a context to the unit scale setting
CanEnableStormOfMagicBoolVoidReturns whether can enable storm of magic setting (not matchmade and not survival battle)
IsCommanderRequiredFirstBoolVoidReturns whether a commander is required before the battle can start
SetTimeOfDaySettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the given context as the time of day setting
HasConfigurableTicketLimitBoolVoidReturns whether the game type has a configurable ticket limit
SetEscalationLevelSettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the given context as the escalation level setting
CanChangeSettingsBoolVoidReturns whether custom battle settings can be changed
IsStormOfMagicAvailableBoolVoidReturns if storm of magic setting available to use (currently just a dev thing accessible via dev_custom_battle tweaker
TimeOfDaySettingListCcoCustomBattleSettingRecord (list)VoidReturns a list of available setting records for times of day
HasAttackerDefenderBoolVoidReturns whether this battle has attackers and defenders
SetCorruptionTypeRecordContextVoidExpressionState, CcoCustomBattleCorruptionTypeSets corruption type for map supplying a CcoCorruptionTypeRecord, if pass empty then removes any corruption type (has visual impact on battlefield)
EscalationLevelSettingListCcoCustomBattleSettingRecord (list)VoidReturns a list of available escalation level settings
IsUsingReinforcingUnitsBoolVoidReturns whether reinforcing units are used
HasTwoAlliancesBoolVoidReturns whether this battle has attackers and defenders
IsStormOfMagicEnabledBoolVoidReturns whether storm of magic setting enabled (storm of magic is for warhammer, where magic is greatly empowered and the lore boosted changes every so often)
TicketLimitSettingListCcoCustomBattleSettingRecord (list)VoidReturns a context list of ticket limit settings
CorruptionTypeRecordListCcoCustomBattleCorruptionType (list)VoidReturns a list of available CcoCorruptionTypeRecord
IsSettlementBattleTypeBoolVoidReturns whether this is a settlement battle type
TimeOfDaySettingContextCcoCustomBattleSettingRecordVoidReturns a context to the time of day setting
ToggleLoadingCharactersVoidExpressionStateToggles unit caps
EscalationLevelSettingContextCcoCustomBattleSettingRecordVoidReturns a context to the escalation level setting
AttackingTeamIndexIntVoidReturns the index of the attacking team
SetCustomFundsAmountVoidExpressionState, UniStringSets the given amount as the custom funds limit
TicketLimitSettingContextCcoCustomBattleSettingRecordVoidReturns a context to the setting record for ticket limit
CorruptionTypeRecordContextCcoCustomBattleCorruptionTypeVoidReturns the CcoCorruptionTypeRecord being used for the corruption setting, null if none (has visual impact on battlefield)
SetSettlementLevelSettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the given context as the settlement level setting
IsSiegeBattleTypeBoolVoidReturns whether this is a siege battle type
SetDifficultyLevelSettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the given context as the difficulty level
SetFundTypeSettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the given context as the fund type setting
SetBattleAiStatsModifierVoidExpressionState, FloatSets the value of the ai stats modifier setting
IsLoadingCharactersEnabledBoolVoidReturns whether unit set caps are enforced
ToggleNoLordsVoidExpressionStateToggles no-lords enabled bool
BattleAiStatsModifierFloatVoidReturns the value of the ai stats modifier setting
CostForSettlementLevelIntCcoCustomBattleSettingRecordReturns the cost for the given settlement level context
BattleTypeRecordListCcoBattleTypeRecord (list)VoidReturns a list of available battle types for custom battle
DifficultyLevelSettingListCcoCustomBattleSettingRecord (list)VoidReturns a list of available difficulty levels
ToggleUnitCapsVoidExpressionStateToggles unit caps
LaboratoryInfoContextCcoBattleLaboratoryInfoVoidReturns the context of the laboratory info
SettlementLevelSettingListCcoCustomBattleSettingRecord (list)VoidReturns a list of available settlement level settings
CustomBudgetAmountIntVoidReturns the amount of the custom budget if being used
IsNoLordsEnabledBoolVoidReturns whether we can start a game without lords
BattleTypeRecordContextCcoBattleTypeRecordVoidReturns a context to the battle type
ToggleLabModeVoidExpressionStateToggles the lab mode on/off
DifficultyLevelSettingContextCcoCustomBattleSettingRecordVoidReturns a context to the difficulty level
IsUsingCustomFundsBoolVoidReturns whether custom funds amount is being used
IsUsingUnitCapsBoolVoidReturns whether unit set caps are enforced
ToggleMultipleLordsVoidExpressionStateToggles multiple lords enabled bool
SettlementLevelSettingContextCcoCustomBattleSettingRecordVoidReturns a context to the settlement level setting
SetTimeLimitSettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the given time limit setting context
FundTypeSettingListCcoCustomBattleSettingRecord (list)VoidReturns a list of available setting records for funds
IsLabModeBoolVoidReturns if lab mode has been chosen for this battle
ToggleIsUsingLargeArmiesVoidExpressionStateToggles large armies setting
SettlementMapListCcoCustomBattleMap (list)VoidReturns a list of custom battle maps that have settlements
SetSeasonRecordContextVoidExpressionState, CcoSeasonRecordSets the given context as the season
CanUseLargeArmiesBoolVoidReturns whether large armies can be used
IsMultipleLordsEnabledBoolVoidReturns whether we can use multiple lords
IsTimeLimitUsedBoolVoidReturns whether a time limit is used
ChooseRandomMapVoidExpressionStateChooses a random map and sets it as the current map
MapContextCcoCustomBattleMapVoidReturns a context to the current map
FundTypeSettingContextCcoCustomBattleSettingRecordVoidReturns a context to the fund type setting

CcoCustomBattleTeam

Wrapper for the custom battle team

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TeamLeaderPlayerSlotContextCcoCustomBattlePlayerSlotVoidReturns the CcoCustomBattlePlayerSlots that is the current team leader for this team
PlayerSlotListCcoCustomBattlePlayerSlot (list)VoidReturns list of CcoCustomBattlePlayerSlots on this team
AddAIBotVoidVoidAdds an AI slot to this team
AddPlayerSlotVoidExpressionStateAdds an open player slot to this team for a player to join
CanAddAIBoolVoidReturns true if can add an AI slot to this team
NumPlayerSlotsCanAddIntVoidReturns the number of slots that can be added to this team
CanAddPlayerSlotBoolVoidReturns true if can add a player slot to this team
IsAttackerBoolVoidReturns true if this is the attacking team
HasHumansOnTeamBoolVoidReturns true if the team contains any human players
TeamIndexIntVoidReturns the numeric index of this team (team id)
DefaultSelectedPlayerSlotContextCcoCustomBattlePlayerSlotVoidReturns the default CcoCustomBattlePlayerSlots that should be selected for the player on this team (when players/added removed, etc)

CcoCustomBattleUnit

Context object for a given player/unit/reinforcement slot combo

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PlayerSlotContextCcoCustomBattlePlayerSlotVoidReturns the CcoCustomBattlePlayerSlot associated with the slot index stored on this context
HasArmoryBoolVoidReturns whether the unit associated with the unit index stored on this context has an armory
IsPersistentCharacterBoolVoidReturns whether the unit associated with the unit index stored on this context is a loaded character
UnitTypesCcoUnitsCustomBattleTypeRecord (list)VoidReturns variants for this unit, eg different ammo or spell lore overrides
CurrentUpgradeListCcoCustomBattleUnitUpgrade (list)VoidReturns the current CcoCustomBattleUnitUpgrades of the unit associated with the unit index stored on this context
CanIncreaseExperienceBoolVoidReturns whether the unit associated with the unit index stored on this context can currently increase its level
AvailableUpgradeListCcoCustomBattleUnitUpgrade (list)VoidReturns the CcoCustomBattleUnitUpgrades available to the unit associated with the unit index stored on this context
CanEverIncreaseExperienceBoolVoidReturns whether the unit associated with the unit index stored on this context can ever increase its level
TransformationUnitOverrideContextCcoMainUnitRecordVoidReturns the unit's transformation unit override.
AvailableMountsListCcoUnitsCustomBattleMountRecord (list)VoidReturns the CcoUnitsCustomBattleMountRecords available to the unit associated with the unit index stored on this context
IsCommanderBoolVoidReturns whether the unit associated with the unit index stored on this context is a commander
IsReinforcementBoolVoidReturns whether the unit associated with the unit index stored on this context is a reinforcement
SetTransformationUnitOverrideVoidCcoMainUnitRecordSets the unit's transformation unit override.
IsValidBoolVoidReturns whether the unit associated with the unit index stored on this context is valid
MoveToDraggableUnitVoidExpressionStateAttempts to move the current context to the position of the context associated with state component passed in
CostIntVoidReturns the cost of the unit associated with the unit index stored on this context
ExperienceLevelIntVoidReturns the level of the unit associated with the unit index stored on this context
RemoveMountVoidVoidRemoves the mount of the unit associated with the unit index stored on this context
CostAtLevelIntIntReturns the cost at a provided level of the unit with the unit index stored on this context
ChangeUnitTypeVoidCcoUnitsCustomBattleTypeRecordChanges, to the provided alternate unit type, specified by the provided CcoUnitsCustomBattleTypeRecord
ImagePathStringVoidReturns the portrait path of the unit with the unit index stored on this context
ChangeMountVoidCcoUnitsCustomBattleMountRecordChanges, to the provided CcoUnitsCustomBattleMountRecord, the mount of the unit associated with the unit index stored on this context
NameUniStringVoidReturns the name of the unit with the unit index stored on this context
DecreaseExperienceVoidVoidDecreases the level of the unit associated with the unit index stored on this context
CurrentMountRecordContextCcoUnitsCustomBattleMountRecordVoidReturns the CcoUnitsCustomBattleMountRecord associated with the unit index stored on this context
IncreaseExperienceVoidVoidIncreases the level of the unit associated with the unit index stored on this context
UnitDetailsContextCcoUnitDetailsVoidReturns the CcoUnitDetails associated with this unit index stored on this context
RemoveUnitVoidVoidRemoves this unit from the player slot
CustomBattleUnitRecordContextCcoUnitsCustomBattlePermissionRecordVoidReturns the CcoUnitsCustomBattlePermissionRecord record associated with the unit index stored on this context
CanAffordMountBoolCcoUnitsCustomBattleMountRecordReturns whether the unit index stored on this context can change mount
UnmountedRecordContextCcoMainUnitRecordVoidReturns the CcoMainUnitRecord associated with the unmounted version of the unit index stored on this context
CanChangeMountBoolCcoUnitsCustomBattleMountRecordReturns whether the unit index stored on this context can change mount
UnitRecordContextCcoMainUnitRecordVoidReturns the CcoMainUnitRecord associated with the unit index stored on this context

CcoCustomBattleUnitUpgrade

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconPathVoidVoid
NameVoidVoid
TypeNameVoidVoid
ToggleEquippedVoidVoid
CanAffordVoidVoid
CostVoidVoid
TooltipVoidVoid
CanToggleVoidVoid
IsEquippedVoidVoid
AncillaryContextVoidVoid
SkillContextVoidVoid
AbilityContextVoidVoid
UnitContextVoidVoid

CcoEffect

Component context wrapper for an effect, just a text and icon pair basically! Allows it to be generically created for different effect systems

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RitualContextCcoRitualRecordExpressionStateReturns the first linked CcoRitualRecord if it exists
GetRitualBonusValueFloatExpressionState, CcoRitualRecord, StringReturns the value for the specified ritual and bonus value ID.
EffectScopeContextCcoCampaignEffectScopeRecordVoidReturns the CcoCampaignEffectScopeRecord if it exists
RitualListCcoRitualRecord (list)VoidReturns a list of all linked CcoRitualRecord.
PooledResourceContextCcoCampaignPooledResourceExpressionState, String, ContextReturns the linked CcoCampaignPooledResource for the object passed in (faction, province manager etc), with the specified key, only valid to call when created with a CAMPAIGN_EFFECT
AttributeContextCcoUnitAttributeRecordExpressionStateReturns the linked CcoUnitAttributeRecord with this effect if exists, only valid to call when created with a CAMPAIGN_EFFECT
UnitsFromEffectNotExcludedCcoMainUnitRecord (list)ExpressionStateReturns a list of all the units affected by the CAMPAIGN_EFFECT that are not excluded.
UnitSetsFromAllSourcesListCcoUnitSetRecord (list)ExpressionStateReturns a list of linked unit sets from any sources that junction to unit sets, only valid to call when created with a CAMPAIGN_EFFECT
AbilityContextCcoUnitAbilityExpressionStateReturns the linked CcoUnitAbility with this effect if exists, only valid to call when created with a CAMPAIGN_EFFECT
UniqueAgentSubtypeAgentPairListCcoAgentSubtypeAgentPair (list)ExpressionStateReturns a list of linked agent subtype and agent pairs if they exist, only valid to call when created with a CAMPAIGN_EFFECT
AdditionalDetailsUniStringVoidReturns the additional description for this effect, if it exists
AgentListCcoAgentRecord (list)ExpressionStateReturns a list of linked agent records if they exist, only valid to call when created with a CAMPAIGN_EFFECT
LocalisedTextWithCustomValueUniStringFloatReturns the localised text for the effect with a custom value
LocalisedTextUniStringVoidReturns the localised text for the effect
PlagueListCcoPlagueRecord (list)ExpressionStateReturns a list of linked plague records if they exits, only valid to call when created with a CAMPAIGN_EFFECT
CategoryStringVoidReturns the category setup for this effect in DB column 'category' from the 'effects' table.
UnitSetsListCcoUnitSetRecord (list)ExpressionStateReturns a list of linked unit sets if they exist, only valid to call when created with a CAMPAIGN_EFFECT
AdditionalDetailsIconStringVoidReturns the icon for the additional description of this effect, if it exists
UnitListCcoMainUnitRecord (list)ExpressionStateReturns a list of linked units if they exits, only valid to call when created with a CAMPAIGN_EFFECT
ValueIntVoidReturns the raw value of the effect as a number
IconPathStringVoidReturns the icon path
UnitListsListCcoUnitListRecord (list)VoidReturns a list of linked UNIT_LIST_RECORDs
InitiativeSetsListCcoInitiativeSetRecord (list)VoidReturns a list of linked INITIATIVE_SET_RECORDs
PriorityIntVoidReturns the priority of the effect, used for ordering and if 0 isn't shown in UI
EffectKeyStringExpressionStateReturns the effect record key, only valid to call when created with a CAMPAIGN_EFFECT
IsPositiveBoolVoidReturns true if this is a positive effect
UnitAbilityListCcoUnitAbility (list)VoidReturns a list of unit abilities linked to effect
InitiativeListCcoInitiativeRecord (list)VoidReturns a list of linked INITIATIVE_RECORDs for this effect
DevUnitSetStringsFromEffectExcludedCcoString (list)ExpressionStateReturns a list of all the unit sets affected by the CAMPAIGN_EFFECT that are excluded (as strings with their owning effect key).debug, hide_in_ui
SpecialAbilityPhaseRecordContextCcoSpecialAbilityPhaseRecordVoidReturns the first linked special ability phase record if it exists
PlagueComponentContextCcoCampaignPlagueIngredientCcoCampaignFactionReturns the first linked plague component if it exists
DevUnitSetsFromEffectExcludedCcoUnitSetRecord (list)ExpressionStateReturns a list of all the unit sets affected by the CAMPAIGN_EFFECT that are excluded.debug, hide_in_ui
ManipulationInfoContextCcoCampaignDiplomacyManipulationInfoExpressionState, CcoCampaignFactionReturns the first linked CcoCampaignDiplomacyManipulationInfo if it exists
DevUnitsFromEffectExcludedCcoMainUnitRecord (list)ExpressionStateReturns a list of all the units affected by the CAMPAIGN_EFFECT that are excluded.debug, hide_in_ui

CcoEffectBundle

Component context wrapper for an effect bundle, stores ptr to record and turns remaining. Used mostly for campaign effects. Can also get a list of effects.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TurnsRemainingIntVoidReturns the turns remaining for this effect bundle, 0 if infinite
EffectsIncludingHiddenListCcoEffect (list)ExpressionStateReturns the list of all effects for this effect bundle, including hidden ones. This should never be used for displaying the effects, use EffectList for that
EffectListCcoEffect (list)ExpressionStateReturns the list of effects for this effect bundle (CcoEffect)
DescriptionUniStringVoidReturns the localised description
NameWithTooltipAvailableUniString (list)VoidReturns the localised name followed by the 'icon_tooltip_available'
NameUniStringVoidReturns the localised name
IconPathStringVoidReturns the icon path
KeyStringVoidReturns the unique key of the effect bundle record
RecordListCcoEffectBundle (list)VoidReturns the list of all effect bundle records
ShowHighlightedOnOwnerOnlyBoolVoidReturns true if owner_only is set to true on effect bundle record, used in conjunction with show_in_3d_space to highlight effect bundles on the 3d UI
IsHighlightedEffectBundleBoolVoidReturns true if show_in_3d_space is set to true on effect bundle record, used in conjunction with owner_only to highlight effect bundles on the 3d UI
IsGlobalEffectBundleBoolVoidReturns true if is_global_effect is set to true on effect bundle record
HasOverrideEffectsBoolVoidReturns true if has different effects to the effect bundle record, for example if the bundle was constructed from script
PriorityIntVoidReturns the priority (used for ordering and if 0 generally isnt shown in UI)

CcoFactionSavedCharacters

Wrapper for a SAVED_CHARACTER_INFO struct

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsCampaignBoolVoidReturns true if we're in campaign, since some info will only show there
DeleteSavedCharacterVoidCcoSavedCharacterInfoDeletes the passed in saved character file from the local machine's saved characters folder
LoadSavedCharacterVoidCcoSavedCharacterInfo, ContextLoads the passed in saved character at the settlement or military force passed in
FilteredCampaignCharacterInfoListCcoSavedCharacterInfo (list)VoidReturns a list of saved characters for this faction, filtered on whether should show agents or lords
SavedCharacterInfoListCcoSavedCharacterInfo (list)VoidReturns a list with all saved characters for this faction

CcoFactorBreakdown

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HeaderVoidVoid
ListVoidVoid
DescriptionVoidVoid

CcoFrontendFactionLeader

Wrapper for a frontend faction leader

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitListCcoUnitDetails (list)VoidReturns a list of CcoUnitDetails of units that are present in the leader's military force
GeneralKeyStringVoidReturns the start pos character key for the general
IsRecommendedFactionLeaderOverrideBoolVoidReturns true if the lord is the recommendation override for the current campaign
IsOwnedBoolVoidReturns true if the lord can be played
IsLockedBoolVoidReturns true if cant play as lord due to them being locked behind achievement currently
AchievementLockedTextUniStringVoidReturns localised text to show for achievement locked lord
LockedReasonTextUniStringCcoCampaignMapPlayableAreaRecordReturns the a localised description of why cant start campaign with this lord currently. Empty if nothing stopping starting the campaign
NameUniStringVoidReturns the localised name of the general
RandomiseNameVoidVoidGenerates a random name for the general
SetNameVoidUniStringSets the name of the general to the one passed in
PinLocationVector4VoidReturns the location of the lord on the map
FactionEffectBundleCcoEffectBundleVoidReturns a list of faction effects to be displayed in frontend
FrontendFactionLeaderRecordContextCcoFrontendFactionLeaderRecordVoidReturns a CcoFrontendFactionLeaderRecord with the leader record
FactionRecordContextCcoFactionRecordVoidReturns a CcoFactionRecord with the faction record that the lord is part of
SetAsActiveModelVoidVoidSets this leader as the active model

CcoFrontendRoot

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
StartCampaignVoidString, String, StringStarts campaign with specified campaign and faction key
AreIntroMoviesFinishedBoolVoidReturns true if intro movies finished playing on loading into game
CurrentMenuIdStringVoidReturns the id of the current menu that is open in the frontend
IngameMessagingContextCcoIngameMessagingVoidReturns the in game messaging manager context
CampaignLobbyContextCcoMPCampaignLobbyVoidReturns the current multiplayer campaign lobby context
CustomBattleLobbyContextCcoCustomBattleLobbyVoidReturns the current custom battle lobby context

CcoGameCore

Wrapper for the game core

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsDebugBuildBoolVoidReturns whether the build is a debug build, i.e. non final release
IsOnlineBoolVoidReturns whether the game is connected to an online service, e.g. Steam
BuildNumberShortStringVoidReturns the short version of the current build number
BuildNumberStringVoidReturns the current build number
DevSetTextScaleVoidFloatSet the ui text scaledev
DevSetUiScaleVoidFloatSet the ui scaledev
DevUiScaleFloatVoidGet the current ui scaledev
InstalledProductListCcoOwnershipProductRecord (list)VoidReturns the list of installed product contexts
ServiceManagerContextCcoServiceManagerVoidReturns the Service Manager context
TrialManagerCcoMoMTrialManagerVoidReturns the Mirrors of Madness Trial Manager context
NarrativeManagerContextCcoNarrativeManagerVoidReturns the Narrative Manager context
AdvisorContextCcoAdvisorVoidReturns the Advisor context
IsMemoryLeakReportingEnabledBoolVoidReturns whether the -memory_leak_report is defined and so we are tracking memory allocations

CcoIngameMessaging

Ingame messaging singleton, used to get ingame news items

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FilteredNewsItemsCcoIngameMessagingItem (list)VoidReturns all news items that could be visible (DLC permission checks, platform checks, etc)
EnabledBoolVoidReturns true if ingame messaging is enabled
PreviousPageVoidVoidGoes back to previous page of news
NextPageVoidVoidAdvances news page by 1 to view next set of news
CurrentPageIntVoidReturns the current page of news being viewed on frontend
IsReadyBoolVoidReturns true if ingame messaging is loaded and ready
HasMoreNewsBoolVoidReturns true if there is more news to be shown
CanGetAnyNewsBoolVoidReturns true if we are able to get any news at all
CurrentNewsItemsCcoIngameMessagingItem (list)VoidReturns news items for the current page of news

CcoIngameMessagingItem

A messaging item, basically news item. Can get fields based on JSON response for different templates

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasFieldBoolStringReturns true if given field is not empty (value has non-zero length and exists)
FieldUniStringStringGiven a key return value for stored field on messaging item, from original JSON response
TemplateIdStringVoidReturns the ID of the template used as a string
CategoryStringVoidReturns the category of the item as a string
OpenLinkVoidExpressionStateOpens up the button url in an external browser

CcoJadeDatabase

Wrapper for the Jade database

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PlagueComponentUiDataListCcoPlagueComponentUiDataRecord (list)VoidReturns a list of CcoPlagueComponentUiDataRecord.
PlagueMutationUiInfoListCcoPlagueMutationUiDataRecord (list)VoidReturns a list of CcoPlagueMutationUiDataRecord.
MalakaiOathsQuestChainListCcoMalakaiOathsQuestChain (list)VoidReturns a list of CcoMalakaiOathsQuestChain.

CcoListLayout

Wrapper for a component list engine

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SetSizeToContentsVoidBoolSets whether list layout resizes to contents
SetSpacingVoidVector4Sets spacing of list layout
SetSecondaryMarginsVoidVector4Sets secondary margins of list layout
SetMarginsVoidVector4Sets margins of list layout
IsVerticalBoolVoidReturns true if the list layout is a vertical list, or false if horizontal
SizeToContentsBoolVoidReturns whether the list layout resizes to contents
ItemsPerRowIntVoidReturns the number of items per row the list layout allows
SpacingVector4VoidReturns list layout spacing
SecondaryMarginsVector4VoidReturns list layout secondary margins
MarginsVector4VoidReturns list layout margins
SetItemsPerRowVoidIntSets items allowed per row in list layout

CcoLobbyBase

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsReadyCountdownActiveVoidVoid
ReadyCountdownTimeSecsVoidVoid
HostSlotContextVoidVoid
LocalPlayerSlotContextVoidVoid
PlayerSlotListVoidVoid
NumberOfPlayersVoidVoid
NumberOfPlayerSlotsVoidVoid
ReadyStatusTextVoidVoid
ReadyButtonStateVoidVoid
IsLocalPlayerReadyVoidVoid
ToggleReadyVoidVoid
IsLocalPlayerSpectatingVoidVoid
AddSpectatorSlotVoidVoid
IsLocalPlayerHostVoidVoid
CanAddSpectatorSlotVoidVoid
IsSinglePlayerVoidVoid
SpectatorSlotListVoidVoid
IsMatchmadeBattleVoidVoid
IsAutoReadyCountdownActiveVoidVoid
IsActiveVoidVoid
AutoReadyCountdownTimeSecsVoidVoid

CcoLobbyPlayer

Wrapper for a lobby player slot

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentFactionContextCcoFactionRecordVoidReturns the currently chosen faction
TeamIDIntVoidReturns the team id of the player
PlayerIDIntVoidReturns the id of the player
GetCurrentStateStringVoidReturns the current state of the player (ready/not ready)
CampaignDifficultyNameUniStringVoidReturns the name of the current campaign difficulty
BattleDifficultyNameUniStringVoidReturns the name of the current battle difficulty
KickPlayerVoidVoidKicks this player out of the lobby
StartingGeneralCustomNameUniStringVoidReturns the starting general custom name
NameUniStringVoidReturns the name of the player
SetCultureVoidCcoCultureRecordSets the culture to the passed in one
SetLordVoidCcoFrontendFactionLeaderSets the lord to the passed in one
SetFactionVoidCcoFactionRecordSets the faction to the passed in one
IsHostBoolVoidReturns true if this player is the host of the lobby
IsLocalPlayerBoolVoidReturns true if this player is the local player
CanKickBoolVoidReturns true if this player can be kicked from the lobby
CanSetFactionBoolCcoFactionRecordReturns true if the passed in faction is valid to be set for this player
NetworkPlayerContextCcoNetworkPlayerVoidReturns the context of the network player
CurrentLordContextCcoFrontendFactionLeaderVoidReturns the currently chosen lord

CcoLobbyTeam

Component context wrapper for a MPC lobby team

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
JoinVoidIntMakes the supplied player slot join this team
ShouldShowBoolVoidReturns true if we should show this team in the UI
CanLocalPlayerJoinBoolVoidReturns true if the local player can currently join this team
IsFFATeamBoolVoidReturns true if this is free for all team
TeamIDIntVoidReturns the team id (index)

CcoMPCampaignLobby

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetTeamsVoidVoid
IsActiveVoidVoid
PlayersForTeamVoidVoid
HostSlotContextVoidVoid
PlayerSlotListVoidVoid
ToggleReadyVoidVoid
IsAutoReadyCountdownActiveVoidVoid
AutoReadyCountdownTimeSecsVoidVoid
SettingsContextVoidVoid
IsReadyCountdownActiveVoidVoid
UnselectedLordsVoidVoid
ReadyCountdownTimeSecsVoidVoid
NumberOfPlayersVoidVoid
SelectedLordsVoidVoid
NumberOfPlayerSlotsVoidVoid
NumSelectedFactionsForCultureVoidVoid
LocalPlayerSlotContextVoidVoid
DownloadProgressPercentVoidVoid
ReadyStatusTextVoidVoid
CanInviteVoidVoid
ReadyButtonStateVoidVoid
IsLocalPlayerReadyVoidVoid
PlayerForFactionLeaderContextVoidVoid
IsLocalPlayerSpectatingVoidVoid
IsResumedVoidVoid
MPCampaignSettingsVoidVoid
IsLocalPlayerHostVoidVoid
IsSinglePlayerVoidVoid
CampaignStartInfoContextVoidVoid
IsMatchmadeBattleVoidVoid

CcoMPCampaignMap

Wrapper for a playable map in multiplayer campaigns

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MapImagePathStringVoidReturns the map image path to be used on map displays
ImagePathStringVoidReturns the image path to be used on selectable entries
DescriptionUniStringVoidReturns the localised description for the map
NameUniStringVoidReturns the localised name for the map
CampaignStartInfoContextCcoCampaignStartInfoVoidReturns CcoCampaignStartInfo used for campaign select screen in mpc lobby in frontend, use this one instead of playable area record as it includes time of legend info
TimeOfLegendCampaignRecordContextCcoTimeOfLegendsCampaignRecordVoidReturns the CcoTimeOfLegendsCampaignRecord for this map (can be empty)
CampaignMapRecordContextCcoCampaignMapPlayableAreaRecordVoidReturns the CcoCampaignMapPlayableAreaRecord for this map
MaxPlayersIntVoidReturns the max number of players that can play in this campaign

CcoMPCampaignSettings

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SetNumberForSettingVoidVoid
SetBattleAiStatsModifierVoidVoid
GetBattleAiStatsModifierVoidVoid
ToggleAllianceOnlyVoidVoid
ToggleOptionForSettingVoidVoid
SetOptionForSettingVoidVoid
GetCurrentNumberForSettingVoidVoid
IsAllianceOnlyVoidVoid
IsAllianceOnlySettingActiveVoidVoid
CanChangeSettingVoidVoid
GetCurrentOptionForSettingVoidVoid
GetOptionsForSettingVoidVoid

CcoMoMTrialManager

Wrapper for Mirrors of Madness Trials

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TrialSilverMedalScoreIntVoidReturns an int with the score needed to achieve a silver medal in a trials battle
TrialBronzeMedalScoreIntVoidReturns an int with the score needed to achieve a bronze medal in a trials battle
NextTierScoreIntIntReturns an int with the score needed to achieve the next tier relative to the passed in score
CurrentTierScoreIntIntReturns an int with the last tier that was already achieved relative to the passed in score
TrialsHighScoreForBattleIntStringReturns an int with the highscore of the trial battle piece key passed
TrialPlatinumMedalScoreIntVoidReturns an int with the score needed to achieve a gold medal in a trials battle
TrialGoldMedalScoreIntVoidReturns an int with the score needed to achieve a gold medal in a trials battle

CcoMultiplayerRoot

Component context wrapper for the root of the mp system, so can get useful information such as local player, players in game, players waiting on, etc

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FriendListCcoNetworkPlayer (list)VoidReturns the friend list of the local player as a list of CcoNetworkPlayer
StalledNetworkPlayerListCcoNetworkPlayer (list)VoidReturns list of CcoNetworkPlayers waiting to load into the game still
PlayerListCcoNetworkPlayer (list)VoidReturns list of CcoNetworkPlayers in the current game
HostPlayerContextCcoNetworkPlayerVoidReturns the CcoNetworkPlayer for the host player
LocalPlayerContextCcoNetworkPlayerVoidReturns the CcoNetworkPlayer for the local player

CcoNarrativeManager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DlcTabsListCcoNarrativeViewerTabRecord (list)VoidReturns a list of all CcoNarrativeViewerTabRecords for dlcs in the current context
CultureTabsListCcoNarrativeViewerTabRecord (list)VoidReturns a list of all CcoNarrativeViewerTabRecords for cultures in the current context
SetTabUsingContextVoidCcoNarrativeViewerTabRecordSets the current tab given a tab record context
SetTabUsingKeyVoidStringSets the current tab given a tab key
EnableSubtitlesIfNecessaryVoidVoidEnables subtitles if the ENV_BOOL for subtitles is true or the language being used requires subtitles
ContextSelectAppropriateTabVoidVoidSelects an appropriate tab using the current campaign
PageSpreadsForSelectedTabIntVoidReturns the number of two page spreads to show for this tab
CurrentPageSpreadIntVoidReturns the current page spread as a number
SelectedTabIndexIntVoidReturns the selected tab key
SelectedTabKeyStringVoidReturns the selected tab index
TurnPageRightVoidVoidIncrements the page spread value if possible
TurnPageLeftVoidVoidDecrements the page spread value if possible
NumEntriesForSelectedTabIntVoidReturns the number of CcoCampaignVideoRecords and CcoIncidentRecords associated with the current tab
SelectedTabContextCcoNarrativeViewerTabRecordVoidReturns the selected tab as a context object

CcoNetworkPlayer

Wrapper for a player in the multiplayer system, can query current state, and send invites, view steam profile, etc

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentGameArmyContextCcoBattleArmyVoidReturns the battle army context for the player if they are currently in a battle
IdStringVoidUnique mp client id
CurrentGameCampaignFactionContextCcoCampaignFactionVoidReturns the campaign faction for the player if they are currently in campaign
CurrentGameFactionRecordContextCcoFactionRecordVoidReturns the faction record for the player, if they are currently in a lobby (battle/campaign)
AddAsFriendVoidVoidSends a friend invite via mp client
ShowProfileVoidVoidShows the players profile in mp client (like steam overlay)
InviteVoidVoidSends a game invite to the player via mp client
IsPassiveParticipantBoolVoidReturns true if this player is currently a passive participant in battle (spectating but can receive units from active players to join in)
IsSpectatingBoolVoidReturns true if this player is currently spectating in battle
IsLocalPlayerBoolVoidReturns true if this player is the local player
IsFriendBoolVoidReturns true if this player is a friend of the local player
IsOnlineBoolVoidReturns true if this player is currently online
SortIdIntVoidUsed for sorting in player lists. In frontend its just slot id, in battle its based on alliance/army, in campaign its based on team
TeamIdIntVoidReturns team id for current game
SessionPlayerIdIntVoidSession player id for current game
PlayerSlotIntVoidSlot id for current game
AllianceColourColourVoidReturns the alliance colour of this player in relation to local player
CurrentGameControllableUnitListCcoBattleUnit (list)VoidReturns the units currently controllable by this player in a battle (either if active their armies units, or if passive participant the units they have been gifted)
NameUniStringVoidDisplay Name from mp client

CcoOwnershipProductRequirement

Wrapper for an ownership product mask

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OwnershipProductPurchasableRecordListCcoOwnershipProductRecord (list)VoidReturns a list of CcoOwnershipProductRecord
OwnershipProductRecordListCcoOwnershipProductRecord (list)VoidReturns a list of CcoOwnershipProductRecord

CcoPieData

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SliceListCcoPieSlice (list)VoidReturns the list of pie slices (CcoPieSlice)

CcoPieSlice

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NameUniStringVoidReturns localised name for display on pie slice
ColourColourVoidReturns the colour for the pie slice
ValueFloatVoidReturns the value for the pie slice

CcoPollDataEntry

Poll data entry

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
VotesIntVoidReturns the number of votes for the entry
LabelUniStringVoidReturns the localised label of the entry

CcoRangeWithContext

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PercentageOfTotalFloatVoidReturns the percentage of the total difference between the ranges
RangeMinIntVoidReturns the min range value
RangeMaxIntVoidReturns the max range value
ContextContextVoidReturns the context associated with this range

CcoSavedCharacterInfo

Wrapper for a SAVED_CHARACTER_INFO struct

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BackgroundSkillRecordContextCcoCharacterSkillRecordVoidReturns the background skill record of the character
CanRecruitBoolVoidReturns true if the character can be recruited
PortraitImagePathStringVoidReturns portrait image filepath
TooltipReasonUniStringVoidReturns a tooltip explaining why the character cannot be recruited, for campaign only
IsAgentBoolVoidReturns true if this character is an agent
RecruitmentCostIntVoidReturns an int with the cost to recruit this character
CharacterTraitLevelListCcoCharacterTraitLevelRecord (list)VoidReturns a list of traits that the saved character has
CharacterTypeNameUniStringVoidReturns the localised character type name
NameUniStringVoidReturns the localised name of the saved character
UnitDetailsContextCcoUnitDetailsVoidReturns the unit details associated with this unit
UnitRecordContextCcoMainUnitRecordVoidReturns the main unit record for this saved character
AgentSubtypeContextCcoAgentSubtypeRecordVoidReturns the agent subtype record context of the saved character
AgentContextCcoAgentRecordVoidReturns the agent record context of the saved character

CcoScriptObject

Script adds these via script function effect.set_context_value.Then allows us to leverage context framework so for example could show fill bar for faction awesomeness without requiring any C++ code.Also these can be used in layouts for a global value registry system where can get/set arbitrary global values using ContextInitScriptObject in conjunction with other callbacks like ContextVisibilitySetter and ContextCommandLeftClick for example

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IdStringVoidReturns the unique key of this script object
SetNumericValueVoidExpressionState, FloatSets the numeric value of the script object from the context system (instead of via script)
SetStringValueVoidExpressionState, StringSets the string value of the script object from the context system (instead of via script)
LastComponentThatSetOurValueStringVoidReturns the id of the last component that set our valuedebug, hide_in_uied
TableValueCcoScriptTableNodeVoidIf script object for a table, returns root of table which is a recursive type which can point have child table nodes
StringValueStringVoidReturns the string value of this script value
NumericValueFloatVoidReturns the numeric value of this script value

CcoScriptObjectList

Used purely for Context viewer, has function to expose list of all script objects currently in cache so can track in context viewer

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ScriptObjectListContextListVoidReturns the list of all script objects currently in cache so can track in the context viewer

CcoScriptTableNode

A wrapper for of a Lua Table, recursive type

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasValueForKeyBoolString, BoolReturns if there's a value for the key in the table value of the current node, can recurse through children.
ValueForKeyArgumentPackStringReturns the value for the matching key in the table value of the current node if present, doesn't traverse more nodes.
FindValueForKeyArgumentPackStringReturns the value for the matching key in the table value of the current node if present, will traverse children using DFS.
ValueArgumentPackVoidReturns the value of this node, can be a bool, String, numerical value, or another list of nodes
KeyArgumentPackVoidReturns the key of this node, can be a bool, String, numerical value, or another list of nodes

CcoServiceManager

Wrapper for the Service Manager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ClearPollDataVoidVoidClear the current poll data
ResetAuthStateVoidVoidResets the state of the authentication service, in order to allow starting authentication again in edge cases
GetRaffleUnitIndexIntCcoCampaignUnitGet the index of the unit in the raffle selection, or -1 if the unit is not selected for name raffle
HasPollDataBoolVoidChecks whether there is data for a current poll
IsAuthStateFailedBoolVoidCheck whether the auth service in in the state FAILED
GetRaffleParticipantsCountIntVoidGet the number of participants in the current raffle
GetPollRemainingTimeFloatVoidGet the remaining time of the current poll
IsAuthStateWaitSessionBoolVoidCheck whether the auth service in in the state WAIT_SESSION
GetRaffleWinnersCcoString (list)VoidGet a list of the raffle winner names
IsAuthStateGetSessionBoolVoidCheck whether the auth service in in the state GET_SESSION
EndPollVoidVoidEnd Poll.
ClearRaffleDataVoidVoidClear the current raffle data
IsAuthStateIdleBoolVoidCheck whether the auth service in in the state IDLE
GetPollVoidVoidGet Active Poll.
StartDilemmaPollVoidStringStart Dilemma poll for the provided dilemma key
HasRaffleDataBoolVoidChecks whether there is data for a current raffle
IsPollStateAwaitingEndResponseBoolVoidCheck whether the voting service in in the state AWAITING_END_RESPONSE
GetRaffleRemainingTimeFloatVoidGet the remaining time of the current raffle
EndRaffleVoidVoidEnd Raffle.
IsPollStateAwaitingStartResponseBoolVoidCheck whether the voting service in in the state AWAITING_START_RESPONSE
IsPollStateActiveBoolVoidCheck whether the voting service in in the state ACTIVE
GetRaffleVoidVoidGet Active Raffle.
IsPollStateIdleBoolVoidCheck whether the voting service in in the state IDLE
StartRaffleVoidVoidStart Raffle.
SettingsCcoServiceManagerSettingsVoidReturns the settings context
IsAllIdleBoolVoidChecks whether there is nothing happening at the moment
IsRaffleStateAwaitingEndResponseBoolVoidCheck whether the raffle service in in the state AWAITING_END_RESPONSE
MessageLogCcoString (list)Int (optional)Returns the message log from the Twitch service
ViewersCountIntVoidReturns the number of current viewers
IsRaffleStateAwaitingStartResponseBoolVoidCheck whether the raffle service in in the state AWAITING_START_RESPONSE
GetConnectionInfoVoidVoidGet Connection Info.
IsRaffleStateActiveBoolVoidCheck whether the raffle service in in the state ACTIVE
IsLiveBoolVoidChecks whether the game is currently being streamed live on twitch
GetSystemMessagesVoidVoidGet System Messages.
HasValidTokenBoolVoidChecks whether the authentication token for the Twitch service is present - therefore whether the player is logged in.
IsRaffleStateIdleBoolVoidCheck whether the raffle service in in the state IDLE
UpdateVoidVoidUpdate anything that needs periodic checks, like timers
GetPollTotalVotesIntVoidGet the total number of votes in the current poll
ResetTokenVoidVoidResets the authentication token for the Twitch service. This will require re-authentication on the next use.
ApplyRaffleResultsVoidVoidApply the results of a name raflle - rename the units with the names of the selected winners
GetPollDataEntriesCcoPollDataEntry (list)VoidGet a list of the entries in a poll data
StartAuthVoidVoidStarts the authentication process for the Twitch service. This will open a web browser to log in to Twitch.
SetRaffleWinnerSelectedVoidInt, BoolSet whether to use the name of a particular raffle winner, by index

CcoServiceManagerSettings

Service Manager settings

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SetRaffleTimerSecondsVoidIntSets the duration of a raffle in seconds
GetRaffleTimerSecondsIntVoidReturns the duration of a raffle in seconds
SetPollAutoEndViewersPercentageVoidIntSets the required percentage of voting viewers that triggers auto-end of a poll
GetPollAutoEndViewersPercentageIntVoidReturns the required percentage of voting viewers that triggers auto-end of a poll
SetPollTimerSecondsVoidIntSets the duration of a poll in seconds
GetPollTimerSecondsIntVoidReturns the duration of a poll in seconds
SetAutoLoginVoidBoolSets whether auto-login is enabled
GetAutoLoginBoolVoidReturns whether auto-login is enabled

CcoShapeshiftForm

Temporary information about a shapeshifting form constructed with a form ancillary record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CharacterContextCcoCampaignCharacterVoidReturns the nearest CcoCampaignCharacter to the selected player for this form (or null)
MainUnitRecordContextCcoMainUnitRecordVoidReturns the associated CcoMainUnitRecord
AgentSubtypeRecordContextCcoAgentSubtypeRecordVoidReturns the associated CcoAgentSubtypeRecord
PortraitPathStringVoidReturns the portrait path for this form. Looks in the 'ui/portraits/frontend_leaders' folder
DevUnlockVoidVoidUnlocks this form for the current factiondebug, hide_in_ui
EquipVoidVoidEquips this form for the players faction
IsEquippedBoolVoidReturns whether the form is equipped for the current player
IsLockedBoolVoidReturns whether the form is locked for the current player
HasCharacterBoolVoidReturns whether there is a character on the map for this form
IsPartOfCultureBoolCcoCultureRecordReturns whether this form is part of the given CcoCultureRecord
MatchesQueryBoolUniStringReturns whether this form should be in the list given a search string
CulturesPartOfListCcoCultureRecord (list)VoidReturns a list of CcoCultureRecords this form is part of

CcoSliderValueContext

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SliderValueFloatVoidReturns the percentage value of the slider

CcoSpineAnimationState

Wraps a spine animation state from a spine renderer

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TrackCcoSpineTrackEntryInt
SetEmptyAnimationCcoSpineTrackEntryInt, Float
AddEmptyAnimationCcoSpineTrackEntryInt, Float, Float
ApplyVoidCcoSpineSkeleton
SetAnimationCcoSpineTrackEntryString, Int, Bool
UpdateAnimationVoidFloat
AddAnimationCcoSpineTrackEntryString, Int, Bool, Float
ClearAnimationsVoidInt

CcoSpineBone

Wrapper for a bone in spine that allows it to be modified through context

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SetPositionVoidInt, Int
SetRotationVoidFloat
RotationFloatVoid
WorldPositionVector4Void

CcoSpineController

Wrapper for a spine rendering controller on a component

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AnimationStateContextCcoSpineAnimationStateVoidReturns the animation state context of the spine controller
SkeletonContextCcoSpineSkeletonVoidReturns the skeleton context of the spine controller
SetAnimationVoidString, Bool (optional), Int (optional)Sets the spine animation on the component. Can pass it if it should loop (false by default) and also the track number (0 by default)
SetDockPointVoidStringSets the spine dock point

CcoSpineSkeleton

Wrapper for a skeleton in spine that allows it to be modified through context

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RootBoneCcoSpineBoneVoid
SetScaleVoidVector2
SetSkinVoidString
SetToSetupPoseVoidVoid
ScaleVector2Void
BoneCcoSpineBoneString

CcoSpineTrackEntry

Wraps an animation track entry in spine

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentAnimationNameStringVoid
SetMixDurationVoidFloat
SetAnimationTimeScaleVoidFloat
SetAnimationTimeVoidFloat

CcoStringValue

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SortOrderIntVoidReturns sort order which could be set from db or somewhere else
FloatValueFloatVoidReturns the numeric part of the value as a float
IntValueIntVoidReturns the numeric part of the value as an int
StringValueUniStringVoidReturns the string part of the value

CcoSymbolTest

This is an example

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ThisContextCcoSymbolTestVoid
GetStringStringVoidstring, depreciated
GetFloatFloatVoidfloat, depreciated
GetIntIntVoidint, depreciated
oldVoidVoid
TenIntVoid
ContextContextVoid
id_argsIntInt
UsefulExtensionMethodBoolCcoSymbolTest
idIntVoidUseful functiondebug, depreciated
UsefulExtensionMethodWithConstBoolCcoSymbolTest
SameNameStringVoid
VariadicArgumentsIntArgumentPack
IsOptionalEmptyBoolCcoSymbolTest (optional)
GetContextIdOptionalIntCcoSymbolTest (optional)

CcoSymbolTestSecond

This is a second example

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SameNameStringVoid
id2StringCcoSymbolTest
idStringCcoSymbolTest
ContextContextVoid

CcoTreeLink

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ChildContextContextVoidReturns the child slot context linking to
ParentContextContextVoidReturns the parent slot context linking from

CcoTreeLinkWithContexts

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ChildContextContextVoidReturns the child context associated with the slot the link is going to
ChildComponentContextContextVoidReturns the child component context the link is going to
ParentContextContextVoidReturns the parent context associated with the slot from
ParentComponentContextContextVoidReturns the parent component context the link is from

CcoURI

Wrapper for a URI, allows access to fields and arguments provided

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasArgumentBoolStringReturn true if argument exists in query, otherwise false
ArgumentStringStringReturn the value of the argument provided if it exists in URI
PathStringVoidReturns the URI's path, or empty if none
HostStringVoidReturns the URI's host, or empty if no authority
SchemeStringVoidReturns the URI's scheme

CcoUiWarning

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ComponentContextCcoComponentVoidReturns the component context for this warning
SeverityStringVoidReturns the severity (high, medium, low) of this warning
DescriptionStringVoidReturns a description of this warning
KeyStringVoidReturns a key associated with this warning, unique within this type of warning (type + key is globally unique)
WarningTypeStringVoidReturns the type of warning this is (category)
IsDisplayedInLocationBoolVoidReturns whether this ui warning is displayed in location
ToggleIsDisplayedInLocationVoidVoidToggles whether this ui location should be displayed in location

CcoUnitAbility

Wrapper for a BATTLE_SETUP_SPECIAL_ABILITY

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsPassiveBoolVoidReturns whether the unit ability is passive
RechargeContextNameUniStringVoidReturns the recharge context details for this unit ability
SpawnedUnitLandRecordContextCcoUnitLandRecordVoidReturns the unit ability's spawned unit as a CcoUnitLandRecord if it exists
SpecialAbilityBehaviourGroupStringVoidReturns the special ability behaviour group key if possible (As a string)
AffectsOnlyFriendlyBoolVoidReturns whether additional ui effects are present for this unit ability
ProjectileRecordContextCcoProjectileRecordVoidReturns the unit ability's projectile record context
TimingDetailsTextUniStringVoidReturns the timing details text for this unit ability
AffectsOnlyEnemyBoolVoidReturns whether additional ui effects are present for this unit ability
VortexRecordContextCcoBattleVortexRecordVoidReturns the vortex record context for this ability
EnabledIfDescriptionUniStringExpressionStateReturns the unit ability's enabled if description
MiscastChanceFloatVoidReturns the chance that this unit ability will miscast
BombardmentRecordContextCcoProjectileBombardmentRecordVoidReturns the bombardment record context for this ability
CastRangeFloatVoidReturns the cast range of the unit ability
UniquenessRecordContextCcoAncillaryUniquenessGroupingRecordVoidReturns the uniqueness record context for this ability
ValidTargetDescriptionUniStringExpressionStateReturns the unit ability's valid target description
AbilityGroupContextCcoSpecialAbilityGroupRecordVoidReturns the ability group context for this ability
MaxAffectedEnemyCountIntVoidReturns maximum number of enemies might be affected by this ability
ShouldShowTimingDetailsBoolVoidReturns whether the timing details should be shown for this unit ability
MaxAffectedAllyCountIntVoidReturns maximum number of allies might be affected by this ability
ValidUsageDescriptionUniStringExpressionStateReturns the unit ability's valid usage description
IsHiddenInUIBoolVoidReturns whether this unit ability is hidden in the UI
WindUpTimeIntVoidReturns the duration of time between triggering the unit ability and it actually being performed
TypeContextCcoUnitAbilityTypeRecordVoidReturns the unit ability's type as a CcoUnitAbilityTypeRecord cco
OpenSpellBrowserVoidCcoMainUnitRecord (optional)Opens the spell browser entry for this unit ability. Can supply an optional unit to open its page
TargetTypeUniStringVoidReturns the unit ability's target type
HasEnabledIfFlagsBoolVoidReturns whether the unit ability has enabled if flags
SharedRechargeTimeIntVoidReturns the duration of shared time the unit ability takes to recharge when any other ability with shared cooldown is used
HasMirrorBehaviourBoolVoidReturns true if the ability has mirror behaviour associated with it
SourceTypeNameUniStringVoidReturns the source type name of this unit ability
HasInvalidTargetFlagsBoolVoidReturns whether the unit ability has invalid target flags
RechargeTimeIntVoidReturns the duration of time the unit ability takes to recharge
HasSharedRechargeTimerBoolVoidReturns true if the ability has a shared cooldown
TooltipTextUniStringVoidReturns the unit ability's tooltip
HasInvalidUsageFlagsBoolVoidReturns whether the unit ability has invalid usage flags
NameUniStringVoidReturns the name of the unit ability
ActiveTimeIntVoidReturns the duration of time that the unit ability is active
HasAdditionalUiEffectsBoolVoidReturns whether additional ui effects are present for this unit ability
UpdatesEveryFrameBoolVoidReturns whether the unit ability updates every frame
IconPathStringVoidReturns the file path to the unit ability's icon
AdditionalUiEffectListCcoUnitAbilitiesAdditionalUiEffectRecord (list)VoidReturns the additional ui effect list of this unit ability
SpreadRangeIntVoidReturns how far this ability can spread (for hex abilities like contagion)
ManaUsedIntVoidReturns the amount of mana used by this unit ability
AffectsAlliesBoolVoidReturns whether allied units are affected by this ability
RecordKeyStringVoidReturns the unit ability's record key
AllChannelsPhaseListCcoSpecialAbilityPhaseRecord (list)VoidReturns a list of all CcoSpecialAbilityPhaseRecord from all channels
NumUsesIntVoidReturns the number of times this ability can be used. -1 indicates unlimited uses
AffectsEnemyBoolVoidReturns whether enemy units are affected by this ability
TargetRangeIntVoidReturns the maximum range of a target an ability can be used on
PhaseChannelListCcoPair (list)VoidReturns a list of CcoPair>; each channels name with the phases within that channel
EffectRangeIntVoidReturns the effect range of the ability
IsTargetedAbilityBoolVoidReturns whether this unit ability is targetted
UnitSpecialAbilityRecordContextCcoUnitSpecialAbilityRecordVoidReturns the unit special ability record
AffectsSelfBoolVoidReturns whether the unit ability affects the unit that triggered it
SpawnedMainUnitRecordContextCcoMainUnitRecordVoidReturns the unit ability's spawned unit as a CcoMainUnitRecord if it exists
MinimumRangeIntVoidReturns the minimum range to use the ability

CcoUnitAbilityDetails

Component context wrapper for unit ability details, any capability shown on unit info basically (traits, abilities, shot types, etc)

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BehavioursSoundCategoryStringVoidReturns the sound event related to this ability behavioursound
CategoryStateListCcoString (list)VoidReturns a list of the ability categories
StateStringVoidReturns active/inactive depending on if the unit ability is locked/unlocked
NameUniStringExpressionStateReturns the localised name of this unit ability
KeyStringVoidReturns the key of this unit ability details
IconStringVoidReturns the icon path of the ability icon
CategoryStateNameStringVoidReturns the category state name this unit ability belongs to
TooltipUniStringExpressionStateReturns the localised tooltip of the unit ability
ProjectileRecordContextCcoProjectileRecordVoidReturns the CcoProjectileRecord if the unit ability has a missile weapon record
AbilityCollectionContextCcoAbilityCollectionRecordVoidReturns the CcoAbilityCollection associated with the unit ability details
AbilityContextCcoUnitAbilityVoidReturns the CcoUnitAbility associated with the unit ability details
IsLockedBoolVoidReturns true if this unit ability is locked
IsPassiveBoolVoidReturns true if this unit ability is a passive ability
ShotTypesSoundCategoryStringVoidReturns the sound event related to this projectile shot type sound

CcoUnitBulletPoint

Wrapper for a UI_UNIT_BULLET_POINT object

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LocalisedTextUniStringVoidReturns a localised string with the name of the bullet point
SortOrderIntVoidReturns the sort order of the bullet point
IconPathStringVoidReturns a string with the icon path of the bullet point
StateStringVoidReturns a string with the state of the bullet point
TooltipTextUniStringVoidReturns a localised string with the tooltip of the bullet point
LocalisedTextWithIconUniString (list)VoidReturns a localised string with the name of the bullet point with the bullet icon in front

CcoUnitDetails

Component context wrapper for sharing common information for units of different types (battle, campaign, recruitable, etc) so can be shown on unit information panel as one type

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ComparisonContextCcoUnitDetailsExpressionStateReturns the comparison context of this unit compared to the currently pinned unit
HitPointsInitialIntVoidReturns the number of initial hit points of this unit
IsCampaignBoolVoidReturns true if we're in campaign
CampaignUnitContextCcoCampaignUnitVoidReturns the CcoCampaignUnit of this unit, if we're in campaigncampaign
HitPointsIntVoidReturns the number of hit points left in this unit
ShowFoodCostBoolVoidReturns whether cost should be shown
BattleUnitContextCcoBattleUnitVoidReturns the CcoBattleUnit for this unit, if we're in battlebattle
PurchasedEffectsListCcoUnitPurchasableEffectRecord (list)VoidReturns the list of effects purchased for this unit
CharacterRankIntVoidReturns the rank of the commander of this unit, if in campaigncampaign
ShowCostBoolVoidReturns whether cost should be shown
BaseStatValueFromKeyIntStringReturns this unit's starting value of the given stat (key)
BarrierHpPercentFloatVoidReturns the current hp percent of the barrier attached to this unit
HealthBarColourColourVoidReturns the colour of the alliance this unit belongs tobattle
HasExperienceBoolVoidReturns whether the unit has experience
MassFloatVoidReturns the mass of the unit
BarrierHpIntVoidReturns the current hp of the barrier attached to this unit
AllianceColourColourVoidReturns the colour of the alliance this unit belongs tobattle
BaseStatContextFromKeyCcoUnitStatStringReturns the base CcoUnitStat with the given key if it exists (and is visible) for this unit
FoodCostIntVoidReturns the number of kills caused by this unit in a battle
IsUnitInSetBoolStringReturns true if the unit is part of the unit_set
BarrierMaxHpIntVoidReturns the max hp of the barrier attached to this unit
HarmonyStateStringVoidReturns the state of the unit harmony(yin/yang) or empty if the unit doesn't have a harmony effect
StatContextFromKeyCcoUnitStatStringReturns the CcoUnitStat with the given key if it exists (and is visible) for this unit
IsBeingRecruitedBoolVoidReturns true if the unit is being recruited
KillCountIntVoidReturns the number of kills caused by this unit in a battle
HealthTooltipUniStringVoidReturns the health bar tooltip
StatListCcoUnitStat (list)ExpressionStateReturns the list of stats, such as weapon damage and defences, for this unit
HasRandomisedSpellsBoolVoidReturns true if the unit uses randomised spells on cast
UpkeepCostIntVoidReturns the upkeep cost of this unit
BretonniaIconTooltipTextUniStringVoidReturns the text for bretonnia icon
RecruitCostIntVoidReturns the recruit cost of this unit
BulletPointListCcoUnitBulletPoint (list)VoidReturns the bullet point list
IsPartOfTransportArmyBoolVoidReturns is the unit is part of a transport army
ExperienceThresholdIntVoidReturns the threshold of the next level
NameUniStringVoidReturns the localised name of this unit
ExperienceEffectListCcoStringValue (list)VoidReturns the list of experience effects for this unit
IsKnownHpBoolVoidReturns whether the unit hp is known to the player
ExperienceRequiredForNextLevelIntVoidReturns the required experience to rank up
FactionContextCcoCampaignFactionVoidReturns the CcoCampaignFaction of this unitcampaign
AbilityIconListContextListVoidReturns the list of abilities attached to this unit
IsKnownXpBoolVoidReturns whether the unit xp known to the player
AbilityDetailsListCcoUnitAbilityDetails (list)VoidReturns the list of abilities attached to this unit
ExperienceScoreIntVoidReturns the current experience of this unit
IsLargeEntityBoolVoidReturns whether the unit is a large entity
PreBonusUnitDetailsContextCcoUnitDetailsVoidReturns a CcoUnitDetails with the same unit details but without any previews
ExperienceProgressFloatVoidReturns a percentage of how close this unit is to level up
IsBretonnianPeasantBoolVoidReturns whether the unit is a bretonnian peasant.
CharacterContextCcoCampaignCharacterVoidReturns the CcoCampaignCharacter of this unit
UnitRecordContextCcoMainUnitRecordVoidReturns the CcoUnitRecord of this unit
ExperienceLevelIntVoidReturns the current experience level of the unit
IsCharacterBoolVoidReturns true if this unit is a character
HasComparisonBoolExpressionStateReturns true if a unit can be compared with another pinned unit
AgentSubtypeAgentPairContextCcoAgentSubtypeAgentPairVoidReturns the CcoAgentSubtypeAgentPair of this unit
NumEntitiesInitialIntVoidReturns the number of initial men in this unit
IsSpellBrowserBoolExpressionStateReturns true if the spell browser is open
NumEntitiesIntVoidReturns the number of men alive in this unit
SetupUnitContextCcoBattleSetupUnitVoidReturns the CcoBattleSetupUnit
IsBattleBoolVoidReturns true if we're in battle
HitPointsPercentFloatVoidReturns the hit point percentage left

CcoUnitStat

Component context wrapper for a unit stat shown in stat list from CcoUnitDetails::StatList

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MinValueFloatVoidReturns the min value of the unit stat
MaxValueFloatVoidReturns the max value of the unit stat
ComparisonValuePercentFloatExpressionStateReturns the difference between this and compared stat's value in percentage
ComparisonValueFloatExpressionStateReturns the comparison value of this ability and pinned ability stat
ComparisonStateStringExpressionStateReturns if stat is higher/lower/same than compared stat as a string
NameUniStringVoidReturns the name of the unit stat
TooltipUniStringVoidReturns the localised tooltip for the unit stat
KeyStringVoidReturns the db key for the stat
IconStringVoidReturns the icon path
IsPercentageBoolVoidReturns true if stat should be represented as a percentage
SortOrderIntVoidReturns the sort order of the unit stat
UnitDetailsContextCcoUnitDetailsExpressionStateReturns the CcoUnitDetails context of the unit detail that this stat belongs to
ValuePercentHighestFloatExpressionStateGets highest percentage for stat from either modified stat or base stat. Used for back fill bar so can see buffs/debuffs.
PreBonusStatContextCcoUnitStatExpressionStateReturns the CcoUnitStat of the unit stat without any previews
ValuePercentLowestFloatExpressionStateGets lowest percentage for stat from either modified stat or base stat. Used for front fill bar so can see buffs/debuffs behind
ComparisonStatContextCcoUnitStatExpressionStateReturns the CcoUnitStat of the compared unit stat
ValuePercentBaseFloatExpressionStateReturns percent value of stat with no mods/buffs/debuffs
ValuePercentFloatVoidReturns the current percentage of the stat
ModifierIconListCcoUnitStatModIcon (list)VoidReturns a list of stat modifier icons
ComparisonModifierIconListCcoUnitStatModIcon (list)ExpressionStateReturns a list of stat modifier icons for compared stat
ValueBaseFloatExpressionStateReturns value of stat with no mods/buffs/debuffs
DisplayedValueFloatVoidReturns the displayed value of the unit stat, clamping it if necessary
ValueFloatVoidReturns returns the current value of the unit stat

CcoUnitStatModIcon

Component context wrapper for a unit stat modifier icon

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PhaseContextCcoSpecialAbilityPhaseRecordVoidReturns the CcoSpecialAbilityPhaseRecord for this stat modifier icon
TooltipUniStringVoidReturns localised tooltip
IconStringVoidReturns the icon path

Global Functions

flow

NameReturn TypeArgumentsDescriptionTagsEvents
TryArgumentPackExpressionState, ExpressionUsed to avoid asserts when calling an expression that is expected to fail on certain callsflow

file

NameReturn TypeArgumentsDescriptionTagsEvents
FileExistsBoolString, Bool (optional)Returns true if specified file existsfile

random

NameReturn TypeArgumentsDescriptionTagsEvents
RandomInRangeIntInt, IntReturns a random number between [min,max]random

chain_global

NameReturn TypeArgumentsDescriptionTagsEvents
HasFunctionBoolString, ExpressionStateReturns true if the context has the specified function (passed in as a string)chain_global

string

NameReturn TypeArgumentsDescriptionTagsEvents
NewLineUniStringVoidReturns a string for a new linestring
ParseFactionTextReplacementUniStringExpressionState, UniString, CcoFactionRecordReturns parsed text replacement tags in the given string and uses the faction record to retrieve the correct stringstring
FormatUniStringExpressionState, UniString, ArgumentPackFormat the given string based on the argument liststring
StringLengthIntStringReturns the length of the given stringstring, deprecated
StringReplaceUniStringExpressionState, UniString, UniString, UniStringTakes a source string as the first parameter, then replaces all instances of the second string param with the third string parameterstring, deprecated
StringContainsBoolExpressionState, UniString, UniStringReturns true if the first string contains the second stringstring, deprecated
StringSubStringStringString, Int, Int (optional)Returns a substring between the given start position and optional lengthstring, deprecated
ParseTextReplacementsUniStringExpressionState, UniStringReturns a string that has had text replacements parsed (any text replacement tags will be replaced with actual text)string, deprecated
StringEndsWithBoolExpressionState, UniString, UniStringReturns true if the first string ends with the second stringstring, deprecated
StringStartsWithBoolExpressionState, UniString, UniStringReturns true if the first string starts with the second stringstring, deprecated
IsStringEmptyBoolUniStringReturns true if the string is emptystring, deprecated
IsStringEmptyBoolStringReturns true if the string is emptystring, deprecated
FormatPercentageCustomUniStringFloat, IntReturns a formatted percentage using ICU library with the specified numebr of decimal places.string
FormatPercentageUniStringFloatReturns a formatted percentage using ICU library.string
FormatNumberCustomUniStringFloat, FloatReturns a formatted number using ICU library.string
ParseTextReplacementUniStringExpressionState, UniString, ArgumentPackReturns parsed text replacement tags in the given string and uses the list of overrides in priority order to retrieve the correct stringstring
FormatNumberUniStringFloatReturns a formatted number using ICU library.string

debug

NameReturn TypeArgumentsDescriptionTagsEvents
SearchContextContextListString, StringReturns list of matching search result context objects, given the type and a search term which is used to check against object id and Name functions of object ids of this type. Used for dev tools search functionality to look for particular matching contexts with search text inputs for exampledebug
FindContextContextExpressionState, String, String, Bool (optional)Returns context given the type and object ids. Can also specify false as 3rd parameter to suppress errors if fail to find (otherwise defaults to error). Handy for debugging in context expression tester and creating own debug layouts, but NOT ADVISED use in layouts as ids can change and break layouts!debug
MeasureStringExpressionState, ExpressionUsed to wrap an expression and will return a string containing the number of milliseconds that execution took (the real return value is lost)debug
BreakpointArgumentPackExpressionState, Expression, Expression (optional)Used to wrap an expression and will break in debugger before evaluationdebug
RunCLIMultiplayerVoidStringSsame as RunCLI but if mp campaign runs the command on all players games at the same timedebug
RunCLIVoidStringRuns console command supplied, but not in final release to avoid calling commands not meant todebug

prefs

NameReturn TypeArgumentsDescriptionTagsEvents
PrefAsUniStringUniStringStringRetrieve the specified environment setting as a unistringprefs
PrefAsFloatFloatStringRetrieve the specified environment setting as a floatprefs
PrefAsIntIntStringRetrieve the specified environment setting as an intprefs
PrefAsBoolBoolStringRetrieve the specified environment setting as a boolprefs
SetPrefAsUniStringVoidString, UniStringSets the specified unistring environment settingprefs
SetPrefAsIntVoidString, IntSets the specified int environment settingprefs
SetPrefAsFloatVoidString, FloatSets the specified float environment settingprefs
SetPrefAsBoolVoidString, BoolSets the specified boolean environment settingprefs
TogglePrefBoolVoidStringToggles the specified boolean environment settingprefs

deprecated

NameReturn TypeArgumentsDescriptionTagsEvents
StringLengthIntStringReturns the length of the given stringstring, deprecated
StringReplaceUniStringExpressionState, UniString, UniString, UniStringTakes a source string as the first parameter, then replaces all instances of the second string param with the third string parameterstring, deprecated
StringContainsBoolExpressionState, UniString, UniStringReturns true if the first string contains the second stringstring, deprecated
StringSubStringStringString, Int, Int (optional)Returns a substring between the given start position and optional lengthstring, deprecated
ParseTextReplacementsUniStringExpressionState, UniStringReturns a string that has had text replacements parsed (any text replacement tags will be replaced with actual text)string, deprecated
StringEndsWithBoolExpressionState, UniString, UniStringReturns true if the first string ends with the second stringstring, deprecated
StringStartsWithBoolExpressionState, UniString, UniStringReturns true if the first string starts with the second stringstring, deprecated
IsStringEmptyBoolUniStringReturns true if the string is emptystring, deprecated
IsStringEmptyBoolStringReturns true if the string is emptystring, deprecated
FloatToPercentFloatFloatReturns value *100...math, deprecated

database

NameReturn TypeArgumentsDescriptionTagsEvents
DatabaseRecordContextContextExpressionState, String, StringTakes a database record wrapper context type id and a db key, and returns the wrapper for that recorddatabase
DefaultDatabaseRecordContextStringTakes a database record wrapper context type id and returns the default record for this type.database
DatabaseRecordsContextListExpressionState, StringTakes a database record wrapper context type id and returns a list of all the wrappers of this type.database
DatabaseRecordsForKeysContextListString, ArgumentPackTakes a database record wrapper context type id as the first parameter, then any number of keys to retrieve (CONTEXT_LIST DatabaseRecordsForKeys(String object_type, String db_key...))database

context

NameReturn TypeArgumentsDescriptionTagsEvents
StoredContextFromParentContextExpressionState, StringReturns the stored context of specified type from the specified parentcontext
GenerateContextListExpressionState, Int, Expression (optional)Returns a list with the given context repeated N amount of times.context
StoreListCcoContextListContextList, StringStores a context list with an id so you can easily retrieve itcontext
StoredContextContextExpressionState, String, String (optional), String (optional)Returns the stored context specified by type id, from this component by default or by a target if specify target/parent idscontext
JoinContextListExpressionState, ArgumentPackReturns a context list of all the contexts of the functions passed as argumentscontext
EvaluateExpressionArgumentPackString, ExpressionStateEvaluates specified expressioncontext
IsContextValidBoolContextReturns true if specified context is not nullcontext
IsValidContextBoolExpressionStateReturns true if we currently have a root context that isnt empty (our context has been set)context
IsCurrentContextBoolContext, ExpressionStateReturns true if supplied context is the top context on the stack (for things like when iterating through a list to check the current iterator basically)context
StoredContextFromParentRequiredContextExpressionState, StringReturns the stored context of specified type from the specified parent, and will assert on failurecontext
StoredContextRequiredContextExpressionState, String, String (optional), String (optional)Returns the stored context specified by type id, from this component by default or by a target if specify target/parent ids, and will assert on failurecontext

Misc

NameReturn TypeArgumentsDescriptionTagsEvents
SetExpandedVoidBool
OpenCaravanRecruitmentPanelVoidCcoCampaignSettlementOpens the caravan recruitment panel
DevAdjustTierPosVoidCcoComponent, Int, Int
ColourProfileStringVoidReturns the current colour profile setting
PendingBattleEnemyFactionCcoCampaignFactionVoidReturns the current enemy faction to player in prebattle screen
FindCharactersOfUnitCcoCampaignCharacter (list)CcoMainUnitRecord, Bool (optional)Tries to find characters with the given main unit record, returns a list of any found. Can optionally just get the first one found
GetInitiativesForClusterRecordCcoInitiativeRecord (list)Context, Bool
InitialiseIntriguePanelVoidVoid
IsLocChineseBoolVoidReturns true if using chinese
HasRecipeBeenCookedBoolCcoCookingRecipeRecord
FactionContextFromKeyCcoCampaignFactionStringReturns the faction context for the faction key supplied if it exists
FreeCcoSymbolTestContextVoid
ScriptObjectContextCcoScriptObjectStringThis is a way to lookup a CcoScriptObject context via id for use in expression. Consider using ContextInitScriptObject if want automatic updates and trivial function
rule_testBoolVoid
GetValueAllocatedLowerIntVoid
ClearPanelFromCacheVoidStringClear the supplied panel from cache
CurrentSelectionCcoContextSelectionVoid
MinContextContextContextList, ExpressionState, ExpressionReturns the context with the smallest evaluated value (for example if MinContext(CeoList, RarityLevel) would return ceo context with smallest rarity level)
HasSelectedNodesForAllocationBoolVoid
ClearSearchResultsVoidVoid
ShortcutKeyListCcoString (list)StringReturns keys involved for primary shortcut as separate string values so can show keys (modifier and shortcut) as separate entries (so look like keyboard keys)
DevGetEntryOffsetVector4CcoComponent
IntensitySettingContextCcoSpecialAbilityIntensitySettingRecordExpressionStateReturns the ability intensity setting context (from either the CcoBattleAbility or CcoBattleUnitEffect stored in the parent
NodeCumulativeCostIntCcoInitiativeRecord
MaxValueFloatContextList, ExpressionState, ExpressionReturns the largest evaluated value (for example if MaxValue(CeoList, RarityLevel) would return largest rarity level)
SortCombinedStringValueListCcoStringValue (list)ContextListSorts supplied string value list. Used for sorting combined string value lists (shouldnt need to use on normal lists as they should have it in the functions themselves)
IsExpandedBoolVoid
ShowTechTreeVoidCcoTechnologyRecord (optional)Opens the tech tree. Opens to specified tech if optionally provided
CloseUnitRecruitmentPanelVoidVoidCloses the unit recruitment panel if it's currently open
CampaignVariableIntValueIntStringReturn an int value of the campaign variable passed in, if such variable exists
CanShowEventsBoolVoidReturns true if can currently show events
LocLanguageUniStringVoidReturns the localisation language the game is using
FactorBreakdownCcoFactorBreakdownContextList, String, StringReturns a CcoFactorBreakdown created with context_lists passed as arguments.
TrueRandomInRangeIntInt, IntReturns a true random number (different each game session) in the given range
PassContextContextContext
ClosePanelVoidString, Bool (optional)Will close a specified panel
StopMovieVoidVoid
SetValueAllocatedLowerVoidInt, Bool (optional)
ResetRevealVoidVoidResets the text reveal, starts from beginning again
SetComponentDockPointVoidString
ClearSelectionVoidBool (optional)
SelectContextBoolContext
IsWorldPositionOnScreenBoolVector4, Vector2 (optional), Bool (optional), Float (optional)Returns true if the given world position is on screen. If required, can extend screen size by a given amount, take into account camera fading and offset the distance that objects are faded out.
SearchForComponentWithPredicateVoidExpressionState, String
HasSelectedNodesBoolVoid
PlayersFactionCcoCampaignFactionVoidReturn the players faction context
MinValueFloatContextList, ExpressionState, ExpressionReturns the smallest evaluated value (for example if MinValue(CeoList, RarityLevel) would return smallest rarity level)
IsAnyTeleportHUDPanelOpenBoolVoidReturns true if any teleport HUD panel is open
SetValueVoidFloat
ShortcutKeyUniStringStringReturns current key as string for the specified shortcut
ResetAnimationVoidVoid
CloseDiplomacyPanelVoidVoidCloses the diplomacy panel if it's currently open
IsShowingExpandedUnitInfoBoolExpressionStateSpecific to WH3, added to ensure multiple places that use keep in sync. Returns true if in custom battle and 1080p or above res, determines when to show abilities at same time as stats on unit info panel
IsLocalPlayersTurnBoolVoidReturns whether it is the local players turn
StringExistsBoolStringReturns true if supplied string key exists. Will search all tables (key is in format tablename_fieldname_recordkey)
SkipRevealVoidVoidSkips the reveal of text, shows all the text
CustomBattleShapeshiftFormsListCcoShapeshiftForm (list)VoidReturns a list of forms avaialable for custom battle as CcoMainUnitRecords
CalculateUnitsInUnitSetCcoMainUnitRecord (list)String, String (optional)Returns a list of units contained in the given unit set. This is an expensive query for dev use, do not use it in panel contexts
FreeContextContextVoid
KislevFollowersPercentageFloatExpressionState, CcoCampaignPooledResourceSpecific function for kislev_winter panel, put in code as way too complicated/confusing to do as an expression. Takes pooled resource, and gets percentage compared the the campaign_group numeric ranges up to wh3_main_ksl_followers_tresholds_5
PlayMovieVoidVoid
IsCameraHeightTransitioningBoolVoidReturns true if camera currently doing a height transition between tacmap and normal mode (camera locked to the height transition)
CampaignMinimapZoomScaleFloatVoidReturns the current zoom scale for the minimap
AbilityApplyIntensityFloatExpressionState, FloatReturns the value of an effect multiplied by the current intensity (calculated from CcoBattleAbility stored in parent)
DevAdjustOffsetVoidCcoComponent, Int, Int
IsUnitPartOfSetBoolCcoCampaignUnit
test_get_listsContextVoid
CurrentSearchResultsCcoComponent (list)Void
ConfirmNodeSelectionVoidVoid
PartitionContextListContextList, ExpressionState, ExpressionReorders the elements in such a way that all elements for which the predicate returns true precede the elements for which predicate p returns false.
SetMaxSliderValueVoidInt
CloseAllContextLayoutTooltipsVoidVoidCloses any open ContextLayoutTooltips anywhere in the UI
HasTargetSelectedBoolVoid
DoesGUIDExistBoolString, ExpressionStateReturns true if a component with the given GUID exists.
IsPanelOpenBoolString (optional), Bool (optional)Returns true if specified panel is open, or if any are open if none specified
EpisodePopupContextFromStringCcoEpisodeEventPopupStringCreates CcoEpisodeEventPopup from a specified key
CloseCurrentHUDPanelVoidVoidCloses the currently opened HUD panel
ToRomanNumeralUniStringIntConvert a positive integer to a roman numeral
IsPlayingBoolVoid
GetValueFloatVoid
CampaignKeyStringVoidReturns the campaign key
StringGetUniStringStringReturns a string for supplied key. Will search all tables (key is in format tablename_fieldname_recordkey)
CampaignRadarPositionVector4Vector4Converts a world position to a radar position (0-1 percent used for ContextRadarIcon)
StorePlatformIdStringVoidReturns the id of the platform currently playing on (e.g. steam, epic, microsoft)
DiplomacyLocUniStringArgumentPackReturns a localised string in the diplomacy_strings table given key
CampaignCulturesCcoCultureRecord (list)VoidReturns a list of all cultures present in the current campaign
SelectOccupationOptionCcoVoidCcoCultureSettlementOccupationOptionRecord
IsAnyHUDPanelOpenBoolVoidReturns true if any HUD panel is open
BattleIsDisplayingAllUIBoolVoidReturns true if holding space shortcut to force display all UI
ResumeVoidVoid
ToggleEditModeVoidVoid
GetEffectsListContextListVoid
SetMinSliderValueVoidInt
ClearSelectionForParentVoidString, String
ScrollToComponentVoidCcoComponent
GetBookContextFromKeyCcoCampaignBookOfNagashStringReturns a CcoCampaignBookOfNagash from the given book record key
SumArgumentPackContextList, ExpressionState, ExpressionReturns the numerical sum of the transformed elements.
IsRefreshingBoolVoid
UnitAbilityContextFromStringCcoUnitAbilityStringCreates CcoUnitAbility for ability with specified key
OpenOverlayToUrlVoidExpressionState, String, BoolOpens given url in overlay if available, if not in external browser
TargetSettlementContextCcoCampaignSettlementVoid
WorldSpaceToScreenSpaceVector4Vector4, Bool, BoolReturns the screen space position for specified world position
StartAnimationVoidVoid
SetVfxScaleVoidFloat
KillVoidVoid
LookUpTechnologyCcoCampaignTechnologyCcoTechnologyRecordReturns a CcoCampaignTechnology given a provided CcoTechnologyRecord.
CloseVoidVoid
test_get_6ContextVoid
IsSelectedBoolVoid
PauseVoidVoid
IsTacticalMapBoolVoidReturns true if currently in tacmap view
PasteStringFromClipboardUniStringVoidReturns the text currently in the clipboard
CurrentInspectedContextContextVoid
ShouldShowWarCoordinationPendingRequestBoolContextUsed to determine when to show icons indicating there is a pending war coordination request for this target (target being the supplied force or settlement). Currently returns true if the target is a request from the faction talking to in diplomacy)
IsComponentCloseToCursorBoolExpressionState, IntReturns if the Component's centre is within the distance given in the args
OpenUnitBrowserVoidCcoFactionRecordSpecific to WH3, opens unit browser, and if a CcoCultureRecord is specified selects that culture to view units for
IsTargetsOutlineHighlightEnabledBoolVoidReturns true if the outline highlight for targetting interfaces is currently enabled
IsCurrentlyInEditModeBoolVoid
test_get_5ContextVoid
HandleEquipVoidVoid
GetBookContextForRecordCcoCampaignBookOfNagashCcoBooksOfNagashDetailsRecordReturns a CcoCampaignBookOfNagash from the given book details record
ZoomToPointVoidVector4Zoom to the specified location
HasAnySavedGamesBoolVoidReturns true if player has any saved games (for continue campaign functionality for example)
SkipContextListContextList, IntSkip the first x elements of the list.
IsHUDPanelOpenBoolStringReturns true is the specified HUD panel is open
LocUniStringString, ArgumentPackReturns a localised string for supplied key. In campaign will check campaign_localisation_strings first. After that will use random_localisation_strings table
RitualCastTimePercentageFloatVoid
UpdateOccupationOptionCcoIconsAndEffectsVoidCcoCultureSettlementOccupationOptionRecord, CcoComponent
CanGiftUnitsToPlayerBoolInt
LogicalToDisplayPosVector4Vector4, Bool (optional)Converts a logical position to a display position for campaign
ExprToJSONStringString
SelectionParentContextCcoComponentVoid
IsCulturePresentInCampaignBoolCcoCultureRecordReturns true if the specified culture is present in the current campaign
test_get_4ContextVoid
IsPlayingMovieBoolVoid
HighlightNodesForThresholdVoidInt, Bool
ShouldShowMissionBoolCcoCampaignMission
RestartEmitterVoidVoid
IsFullscreenPanelOpenBoolVoidReturns true if a fullscreen panel is open
ValueIntVoid
IsUnitSelectedBoolVoidReturns true if any unit is currently selected
SetSelectedVoidBool, Bool (optional)
ShouldShowShadowyDealingsInfoBoolVoidReturns true if should show shadowy dealings info, specific to some skaven factions in WH3
CopyStringToClipboardVoidUniStringCopies the supplied text to the clipboard for pasting
CurrentSelectedContextContextVoid
DeallocateAllNodesVoidVoid
IndexOfEntryIntContext
OpenAcademyVoidExpressionStateOpens up the TW academy in the browser supplying the component clicked on so can open a relevant page
ToggleHUDPanelVoidStringToggles the specified HUD panel
SetEnabledVoidBool
GiftUnitsVoidInt (optional)
CanUseUiFeatureBoolString, Context (optional)returns true if faction has access to a UI Feature, don't use to block access to feature since players can then get around the DLC check
GetOccupationOptionCcosForGroupCcoCultureSettlementOccupationOptionRecord (list)CcoCultureSettlementOccupationOptionsGroupRecord
LocalisedColonWithSpaceUniString (list)VoidReturns a localised colon: fullwidth in Chinese or halfwidth + space in other languages.
RitualCastTimeLeftIntVoid
RemovePinVoidVoid
TakeContextListContextList, IntReturns the first n elements of the list.
SetVfxPositionVoidFloat, Float, Float
CameraTargetPositionVector4VoidGets the target position of the campaign camera
NameOfCampaignLocationUniStringVector4Gets the region or sea region name at specified location
TargettingContextContextVoidReturns the context of the current targetting interface if there is one(for example if targetting war coordination might return the CcoCampaignFactionInteraction currently targetting this
IsTimeOfLegendsCampaignBoolVoidReturns true if currently playing a multiplayer time of legends campaign
BattleRadarPositionVector4Vector4Converts world space position to 2d radar position percentage
CurrentSelectedTabNameStringVoid
PanelContextCcoComponentStringReturns the CcoComponent context of the specified panel if it's open
SelectVoidVoid
SaveRadarImageVoidVoid
test_get_3ContextVoid
HasPlayedMovieBoolVoid
ClearSelectedNodesVoidVoid
TestReturnAnyTypesArgumentPackInt
ModelFactionContextFromKeyCcoCampaignModelFactionStringReturns a campaign model faction context for the faction key, if valid. Otherwise returns null
IsCampaignOverlayShowingBoolVoidReturns true if campaign overlay showing (when hold space)
PlayFullscreenMovieVoidStringPlays a fullscreen movie with supplied path, once movie finishes the movie player trashes itself
GetBooksofNagashCcoCampaignBookOfNagash (list)VoidReturns a list of all Books of Nagash
ColourTextForCurrentSkinUniStringUniStringReplaces colour tags with dark colour versions if the current skin is not wh3.
DistanceToCameraFloatVector4Returns distance of specified position from camera
IsContentLockedBoolStringCheck if content is locked. WARNING - DO NOT RELY ON THIS AS ONLY MEANS OF LOCKING ACCESS TO CONTENT SINCE EASY TO MOD!
SetVfxOrientationVoidFloat, Float, Float
ShowBuildingBrowserVoidCcoBuildingLevelRecord (optional)Opens the building browser and passes the context of the building level if any has been provided
VramUsageStringVoidReturns the current VRAM memory used (requested for GSAT autotest script for storing information for benchmarks)
ForEachVoidContextList, ExpressionState, ExpressionPerforms expression on each context in list (for giving commands to multiple contexts)
InitialiseVoidVoid
LocalisedCommaWithSpaceUniString (list)VoidReturns a localised comma: fullwidth in Chinese or halfwidth + space in other languages.
test_get_2ContextVoid
SettlementForRegionKeyCcoCampaignSettlementStringReturns the settlement context for the specified region key
GetNumberOfNodesNeededToUnlockNodeIntCcoComponent
RegionSlotFromBuildingChainCcoCampaignBuildingSlotCcoBuildingChainRecordReturns the slot that contains a building from the given chain
test_get_1ContextVoid
CameraPositionVector4VoidGets the position of the campaign camera
SelectVoidBool
IsSkinActiveBoolStringReturns whether the specified skin is currently being used
ResetUnitCardStatesVoidVoid
IsShowingTheActiveHuntBoolVoid
ScrollByValueVoidInt, Bool (optional)
GetListContextListVoid
CampaignModelRootCcoCampaignModelRootVoidReturn the root campaign model context in campaign
SetValueVoidInt, Bool (optional)
CloseSpellBrowserVoidVoidSpecific to WH3, Closes the spell/unit browser
AddDefaultSkinPathStringStringAdds default skin path to beginning of supplied image name (ui/skins/default/). Actually skinning handled internally so dont need to worry about that.
IsWarCoordinationOpenBoolVoidReturns true if war coordination panel open
EltharionChallengeRecipeNumberIntVoid
SetVfxVelocityVoidFloat, Float, Float
TestReturnAnyArgumentPackVoid
SetRitualToShowRangeForVoidCcoRitualRecord (optional)Sets the ritual for which to render the casting range around the selected character. Without argument, will clear the current ritual.
IsMultiplayerLobbyActiveBoolVoidReturns true if a multiplayer lobby currently active, handy for checking if current game is multiplayer in frontend, battle or loading screens
IsWaaaghActiveBoolVoid
TransformContextListContextList, ExpressionState, ExpressionTransforms the list into a new one where each element is produced by the given expression (like the map function).
DevRunPostBattleRewardAnimVoidString
BattleSelectionContextCcoBattleSelectionVoidGets the battle selection context (info on what is selected, commands to select, etc)
ExpectedSymbolStringString, String
QuitToMainMenuVoidVoidQuits to frontend main menu from battle or campaign
GetAllocatedNodesCountIntVoid
ScriptLockListStringVoidReturns a list of all script locks that are currently active, in case want to check a few and save typing in IsScriptLockActive for them all
ActiveHuntStringVoid
SettlementAtPointCcoCampaignSettlementVector4Returns the settlement context at the specified position
HandleUnequipVoidVoid
UnitsCountIntVoidGet the number of units currently selected for the raffle
SelectedComponentCcoComponentVoid
SaveCampaignVoidUniStringSaves game with specified name (used by script for example)
ClearPinVoidVoid
ForceContainsUpgradableUnitsBoolVoid
ScrollToValueVoidInt, Bool (optional)
FrontendRootCcoFrontendRootVoidGets the frontend root context in frontend (handy starting point for all things frontend related)
QuitCampaignVoidVoidQuits the current campaign
ApplyUiSkinVoidStringApplies the supplied ui skin to the game
ToggleComponentVoidExpressionState, StringSimilar to CreateComponent above, but if component already exists it will trash it. Added mainly to simplify dev ui creation.
LoadMetadataVoidVoid
NumberOfCookedRecipesIntVoid
ValueMaxIntVoid
CharacterFromFamilyMemberCQICcoCampaignCharacterFloatReturns a CcoCampaignCharacter with either the character, if alive, or the character_details
SetCharacterSkillPieChartVoidCcoComponent, CcoCampaignCharacterInitialize the character skill pie chart
TestArgPack_IntIntArgumentPack
MultiplayerRootContextCcoMultiplayerRootVoidReturns the CcoMultiplayerRoot context, useful for getting information on current mp setup
SelectedOrContainedCharacterCcoCampaignCharacterVoidReturns either the contained character(agent) if exists, or the selected character if any
IsLoadingScreenActiveBoolVoidReturns true if currently in the loading screen
BattleCursorContextCcoBattleCursorContextVoidGets the battle cursor context (mouseover info)
SetSelectedStateVoidBool
IsGraphInValidStateBoolVoid
ChildNodeContextCcoComponentVoid
IsShroudedBoolVector4Returns true if the specified display/real position is covered under the shroud
SelectionManagingComponentContextCcoComponentVoid
ScrollToComponentVoidCcoComponent, Bool (optional)
SettlementPanelBackgroundsEnabledBoolVoidReturns true if settlement panel backgrounds are enabled
AvailableSkinListCcoString (list)VoidReturns list of available skins the game uses assuming that all skins have a folder in the skins/ folder
ExportMetadataVoidVoid
ShowEscapeMenuVoidVoidShows the Escape menu in battle/campaign
TooltipParentCcoComponentVoidReturns the component that created this ContextLayoutTooltip
PooledResourceTransferContextCcoPooledResourceTransferStringReturns a Cco holding the state of the current pooled resource transfer
SetVfxColourAlphaVoidFloat
test_get_0ContextVoid
TestArgPack_StringStringArgumentPack
PinVoidVoid
SelectAndShowDetailsForCharacterVoidCcoCampaignCharacter, String (optional), Bool (optional)Selects the passed in character and opens character details panel. Optional string specifies which tab to select
SetScriptLockVoidString, BoolSets episodic script override flag to be enabled / disabled specified by key
GameCoreContextCcoGameCoreVoidReturns the game core context
IsSelectedBoolVoid
IsTutorialBoolVoidReturns true if current game mode is part of the prologue/tutorial (in battle or campaign)
ParentNodeContextCcoComponentVoid
HighlightNodesFromClusterRecordVoidContext, Bool
TooltipParentCcoComponentVoid
ComponentCcoComponentString, String (optional), ExpressionState
TryEnsureUpgradableUnitsSelectedCcoCampaignUnitVoid
InitialiseCameraVoidVoid
JadeDatabaseContextCcoJadeDatabaseVoidReturns the CcoJadeDatabase
IsParchmentOnlyCameraHeightBoolVoidReturns true if the current camera height is the parchement only height
SetMinRangeValueVoidInt, Bool (optional)
ShowAlternativeExtendedRitualTargetingPanelVoidVoidShows the alternative extended ritual targeting panel
SelectedCharacterCcoCampaignCharacterVoidReturn the selected character if any
FormatTimeUniStringFloatGiven a number in seconds, formats into minutes and seconds
DiplomacySelectedFactionContextCcoCampaignFactionVoidReturns the faction currently selected in diplomacy
SetVfxColourTintVoidColour
PlayerArmyCcoBattleArmyVoidGets the players army context in battle
TenIntVoid
ContextCacheIdStringContextReturns the combination of ContextTypeId + ContextObjectId, which is used by script get_context_value to retrieve values so useful to be able to query.
IsDemoUIEnabledBoolVoidReturns true if demo ifdef enabled for bespoke demos
PlayOneShotAnimationVoidVoid
CanAffordCurrentSelectionDeallocationBoolVoid
UpgradingUnitsContextListCcoCampaignUnit (list)Void
MainThemeBackgroundColourColourExpressionStateReturns the background theme colour, used in fullscreen panels, of the main theme skin
CurrentSkinStringVoidReturns the current UI skin
ShowCustomPromptVoidExpressionState, String, String, UniString, UniString, Expression, Expression (optional), UniString (optional), UniString (optional), Context (optional)Shows a prompt with two buttons, using a custom layout.
IsScriptLockActiveBoolStringReturns true if specified script ui override is currently set to locked by script
YearSeasonFormatUniStringInt, UniStringTakes a year then season string, and puts in right order based on language (asian languages have other way around)
SetVfxSpawnRateScaleFactorVoidFloat
IsCellUnlockedBoolVoid
IsMultiplayerBoolVoidReturns true if current game mode is multiplayer (in battle or campaign)
ShapeshiftFormsThisCampaignListCcoShapeshiftForm (list)VoidReturns a list of CcoShapeshiftForms in this campaign
EnemyAllianceCcoBattleAllianceVoidGets the enemy alliance context in battle
IsBenchmarkBoolVoidReturns true if current game mode is a benchmark (in battle or campaign)
ZoomToDefaultCameraHeightVoidVoidZooms the camera to the default camera height
ClearStoredTechRecordsVoidVoid
OpenShadowyDealingPanelForCurrentTargetVoidVoidOpens the shadowy dealings with the current selection as a target
InvalidateAvatarImageVoidVoid
SelectedComponentsCcoComponent (list)Void
ContextObjectIdStringContextReturns the unique name of the supplied context object within a type (such as the unique id of a particular CcoBattleUnit or a record key). Useful for script
CurrentColourColourVoid
CurrentNegotiatingFactionContextCcoCampaignFactionVoidReturns the faction currently negotiating with in diplomacy
CentreOverTargetContextVoidFloat, Float, Float (optional), Float (optional), Bool (optional)Centres the map 'camera' over the given world position. Can also pass a pixel offset and whether the transition is instant
SummedValueListContextListContextList, ExpressionState, Expression, ExpressionReturns a list that has combined similar contexts.
ChangeCursorSizeVoidIntSets the cursor scaling setting. 0-default, 1-2k, 2-4k
RefreshValuesVoidString
IsCurrentlySelectedComponentBoolCcoComponent
ShowPromptWithAudioSettingsVoidExpressionState, UniString, UniString, Expression, String (optional), Bool (optional)Shows a prompt with two buttons, allowing to set only the audio-related settings.
FreeFunctionIntInt
MainThemeColourColourExpressionStateReturns the colour of the main theme skin
InPostBattleBoolVoidReturns whether the current battle phase is post battle
SelectedContextsContextListVoid
CurrentSelectionCostIntVoid
SetMaxRangeValueVoidInt, Bool (optional)
LoadSaveVoidStringLoads the specified save file
SetVfxSpawnSpeedVoidFloat
SelectedProvinceCcoCampaignProvinceVoidReturn the selected province if any
SelectDropdownItemVoidContext
LocalisedDateFormatStringVoidReturns the localised date format
OpenBloodLinesPanelVoidVoidOpens the bloodlines panel
IsInitiativeScriptLockedBoolCcoInitiativeRecord
AnySelectedBoolVoid
ContextTypeIdStringContextReturns the type name of the supplied context object (the class name, such as CcoBattleUnit). Useful for script
PreBattleChallengeContextCcoPreBattleChallengeVoidReturns a context wrapping the pre-battle Challenge option.
CloseUnitInfoPanelVoidVoidCloses the Unit info panel type.
UnlockCursorVoidVoidUnlocks the cursor
BattleAiStatsModifierFromDifficultyFloatIntReturns a float with the battle ai stats modifier converted from the passed in difficulty
SelectFirstVisibleVoidVoid
SetValueVoidInt, Bool (optional)
SelectedSettlementCcoCampaignSettlementVoidReturn the selected settlement if any
DistinctContextListContextList, ExpressionState, Expression (optional)Returns the distinct elements of the list.
DirectoryFileListCcoString (list)String, String, BoolReturns list of files in specified directory
PlayerAllianceCcoBattleAllianceVoidGets the players alliance context in battle
GetCurrentCostForDeallocationIntVoid
GetPaddingDimensionsVector2Void
RegionRecordContextAtPositionCcoRegionRecordVector4Returns the CcoRegionRecord at the given position
ZoomToMaxCameraHeightVoidVoidZooms the camera to the max height
StopVfxVoidVoid
ToUpperCaseUniStringUniStringConvert string to an uppercase string
NullContextObjectContextVoidReturns a null context object for when you have a function with multiple optional arguments and you want to skip some of them
IsSearchActiveBoolVoid
IsInitiativeActiveBoolCcoInitiativeRecord
ShowPromptVoidExpressionState, UniString, UniString, Expression, Expression (optional), UniString (optional), UniString (optional), Context (optional), String (optional), Bool (optional)Shows a prompt with two buttons.
CloseInfoPanelVoidStringCloses the specified info panel type.
InterpolateColoursColourColour, Colour, FloatReturns the interpolation of two colours using specified colours and percent
SelectButtonBoolCcoComponent
SelectContextVoidContext
IsOfTypeBoolContext, ArgumentPackReturns true if the type of the given context is the one specified in the argument list.
CompileExpressionArgumentPackStringReturns the list of symbols associated with the given cco.
LockCursorVoidStringLocks cursor to specified type
AllBoolContextList, ExpressionState, ExpressionReturns true if all objects of the list satisfy the given expression.
GetValueAllocatedUpperIntVoid
InputSetTextVoidUniString
BattleRootCcoBattleRootVoidGets the battle root context in battle (handy starting point for all things battle related)
JoinStringUniStringContextList, ExpressionState, Expression, UniStringReturns a string with each of the elements combined into a string with the given separator between each element.
ValueIntVoid
GetBudgetWithoutAllocatedNodesIntVoid
InPendingBattleBoolVoidReturns whether there is a pending battle going on
OpenCharacterRecruitmentPanelVoidCcoCampaignSettlement, StringOpens the character recruitment panel
IsChildOfAnySearchResultBoolExpressionState, CcoComponent
ZoomToTacticalViewVoidVoidZooms the camera to the tactical view
CampaignBattleContextCcoCampaignBattleVoidReturns the CcoCampaignBattle singleton if we are in a pending battle
UnitUpgradeManagerContextCcoCampaignUnitUpgradeManagerVoidReturns the CcoCampaignUnitUpgradesManager.
PlayVfxVoidVoid
DoubleIntInt
EventFeedContextCcoCampaignEventFeedVoidReturn the event feed context
GetInitiativesForNodesSelectedForAllocationCcoInitiativeRecord (list)Void
ClearSelectionVoidVoid
GetColourColourStringReturns the colour of the given key from the ui_colours table
GetContextObjectIdStringContextReturns the object id of the given cco.
TriggerUIScriptEventVoidStringSends a UITrigger event with the specified key to script for script to handle (useful for contexts interacting with script). Should not be used to directly change the model
OpenUnitInfoPanelVoidContextOpens the unit info panel.
UiMsgVoidStringTriggers the specified UI_UPDATE_MSG event
OpenPanelVoidString, ArgumentPackWill open a specified panel with the given context list passed to the component. Can also optionally pass a bool before each context to specify if they should propagate or not
SetValueAllocatedUpperVoidInt, Bool (optional)
AnyBoolContextList, ExpressionState, ExpressionReturns true if at least one object of the list satisfies the given expression.
AnimationStateCcoSpineAnimationStateVoid
GetTextUniStringVoid
IsFirstTimeBoolVoid
DeselectContextVoidContext
BattleVictoryMeansCcoStringValue (list)VoidLists all BATTLE_VICTORY_MEANS as CcoStringValue (StringValue = battle_victory_means_to_string, IntValue = enum as card32)
IsSimultaneousTurnsBoolVoidReturns true if simultaneous turns mode
ZoomToLinkVoidString, Bool (optional)Zooms to the location specified by the link
DevGetEntryTierPosVector4CcoComponent
OpenSchemerRecruitmentPanelVoidCcoCampaignSettlement, StringOpens the schemer recruitment panel for Chaotic Plans
OpenWarCoordinationPanelVoidCcoCampaignFaction (optional)Opens the war-coordination panel with faction pre-selected if given one.
FreeSecondContextVoid
UiMsgCampaignCommandVoidStringSimilar to UiMsg in that it broadcasts the specified string as a UI_UPDATE_MSG to allow anything to react to it, but sends the message through the command system so can use to say perform a command and send a message for things to react once that command has been processed since order guaranteed!
FilterProfanityUniStringUniStringGiven some text, returns a filtered version of text replacing any profanity with *
CampaignRootCcoCampaignRootVoidReturn the root campaign context in campaign
ShowEncyclopediaVoidStringOpens the encyclopedia.
RetrieveSelectedItemListContextListExpressionState, String, String (optional)Returns the list of selected items from the ContextSelectionManager provided.
RetrieveSymbolsListContextListContextCompiles the given expression and returns it as a CcoContextExpression. If it fails to compile, it will return a list of CcoContextExpressionCompilationError instead.
CloseAllPanelsVoidVoidCloses all open panels
FilterContextListContextList, ExpressionState, ExpressionReturns a list with all the elements of the given list that satisfy the condition.
TriggerScriptEventVoidStringSends a UITrigger event with the specified key to script for script to handle (useful for contexts interacting with script). In campaign will go via command queue.
SkeletonCcoSpineSkeletonVoid
MaxContextContextContextList, ExpressionState, ExpressionReturns the context with the largest evaluated value (for example if MaxContext(CeoList, RarityLevel) would return ceo context with largest rarity level)
GetBudgetIncludingSelectionIntVoid
IsHumanPlayersTurnBoolVoidReturns whether it is any human players turn (local player or another human in mpc)
ShowBattleObjectiveVoidUniString, IntShows a battle objective (handy for testing out show_objective script func and historical_objective_panel layout). Takes a message to display and a duration in ms for how long to show for
IsInSearchResultsBoolExpressionState, CcoComponent
CurrentSelectedComponentsCcoComponent (list)Void

sound

NameReturn TypeArgumentsDescriptionTagsEvents
StopLoadingScreenMusicVoidVoidStop playing loading screen musicsound
StopLoadingScreenVoiceoverVoidVoidStop playing loading screen voiceoversound
StopLoadingScreenSoundVoidVoidStops a specified sound in loading screensound
PlayLoadingScreenSoundVoidStringPlays a specified sound in loading screensound
PlaySoundEventVoidStringPlays a specified sound event by namesound

math

NameReturn TypeArgumentsDescriptionTagsEvents
TruncIntFloatLooses the fractional part of the numbermath
DegreesToRadiansFloatFloatConverts degrees to radiansmath
MidPointVector4Vector4, Vector4Returns vector3 middle point between two vector3 points (takes vector4s but ignores the wmath
RadiansToDegreesFloatFloatConverts radians to degreesmath
ArcTan2FloatFloat, FloatComputes the arc tangent of y / x using the signs of arguments to determine the correct quadrantmath
MaxNumericValueFloatFloat, FloatTakes 2 numbers and returns max value (called this instead of Max to not conflict with existing member functions which is an issue in runtime objects currently)math
ArcTanFloatFloatComputes arc tangent of numbermath
MinNumericValueFloatFloat, FloatTakes 2 numbers and returns min value (called this instead of Min to not conflict with existing member functions which is an issue in runtime objects currently)math
ModIntInt, IntModulus operation. Takes the number and the value to mod bymath
IntMaxIntVoidReturns maximum integer valuemath
ArcCosFloatFloatComputes arc cosine of numbermath
ArcSinFloatFloatComputes arc sine of numbermath
FloatToPercentFloatFloatReturns value *100...math, deprecated
PercentageFloatFloat, FloatReturns percentage of first value number against second value which is total (with guard against divide by zeromath
TanFloatFloatComputes tangent of numbermath
AbsFloatFloatReturns the absolute of the value passed inmath
CosFloatFloatComputes cosine of numbermath
ClampFloatFloat, Float, FloatClamps a float between two valuesmath
SinFloatFloatComputes sine of numbermath
FloorIntFloatFloors a float and returns it as an intmath
CeilingIntFloatCeilings a float and returns it as an intmath
RoundFloatIntFloatRounds a float to nearest intmath

registry

NameReturn TypeArgumentsDescriptionTagsEvents
SharedStateWriteBoolVoidString, BoolTakes a String id, and writes supplied bool value to shared state with that key (void SharedStateWriteBool(String key, bool value))registry
SharedStateValueExistsBoolStringTakes a String id, and returns if there's any state stored with that id (bool SharedStateReadBool(String key)).registry
ScriptedValueRegistryReadBoolBoolStringTakes a String id, and returns the stored Bool value in the registry for that key (Bool RegistryReadInt(String key))registry
SharedStateReadStringStringStringTakes a String id, and returns stored string value in shared state with that key (String SharedStateReadString(String key)). Value will be empty string if doesn't exist in registry.registry
RegistryReadStringStringStringTakes a String id, and returns stored String value in registry with that key (String RegistryReadInt(String key)). Value will be String::empty_string() if doesnt exist in registry.registry
RegistryWriteStringVoidString, StringTakes a String id, and writes supplied String value to registry with that key (void RegistryWriteInt(String key, String value))registry
RegistryReadIntIntStringTakes a String id, and returns stored integer value in registry with that key (int RegistryReadInt(String key)). Value will be -1 if doesnt exist in registry.registry
RegistryWriteIntVoidString, IntTakes a String id, and writes supplied integer value to registry with that key (void RegistryWriteInt(String key, int value))registry
IsFirstTimeBoolStringTakes a String id, checks if this value is in registry and if not returns true. Then sets value in registry. Use for showing components or setting states for first time in panels, etcregistry
SharedStateReadBoolBoolStringTakes a String id, and returns stored bool value in shared state with that key (bool SharedStateReadBool(String key)). Value will be false if doesnt exist in registry.registry
SharedStateReadFloatFloatStringTakes a String id, and returns stored float value in shared state with that key (int SharedStateReadFloat(String key)). Value will be -1 if doesnt exist in registry.registry
SharedStateWriteFloatVoidString, FloatTakes a String id, and writes supplied float value to shared state with that key (void SharedStateWriteFloat(String key, float value))registry

flow

NameReturn TypeArgumentsDescriptionTagsEvents
GetIfElseArgumentPackExpressionState, Expression, Expression, ExpressionIf the conditional expression is true it will get value of the second expression otherwise the value of the third.flow
GetIfArgumentPackExpressionState, Expression, ExpressionWill return the value of the expression only if the condition is true.flow
GetArgumentPackArgumentPackEvaluates all arguments and returns the value of the last one. Like Do but with a return value.flow
DoIfElseVoidExpressionState, Expression, Expression, ExpressionEvaluates condition (1st param), calls first expression (2nd param) if true, second expression (3rd param) if falseflow
DoIfVoidExpressionState, Expression, ArgumentPackRuns the given expressions only if the condition is trueflow
DoVoidArgumentPackSimple way to join multiple commands in a single expressionflow

component

NameReturn TypeArgumentsDescriptionTagsEvents
RootComponentCcoComponentVoidReturns context of the root componentcomponent
CurrentDisabledMouseOverComponentContextCcoComponentVoidReturns current disabled component mouse overcomponent
CurrentMouseOverComponentContextCcoComponentVoidReturns current component mouseovercomponent
CreateComponentVoidExpressionState, String, CcoComponent, ArgumentPackCreates a component from specified layout, with specified parent as second param (use RootComponent for this param to just create as child of root); and will pass any number of optional contexts to the created layout, handy for testing out layouts without having to go through repro steps (can use CcoComponent::SetContext to then give context to fully test)component

convert

NameReturn TypeArgumentsDescriptionTagsEvents
MakePairCcoPairExpressionState, Expression, ExpressionCreates a CcoPair from the two parameters passed inconvert
ToColourColourInt, Int, Int, Int (optional)Convert a set of numbers (0-255) to a colour (rgba, a is optional and defaults to 255 if not specified)convert
ToNumberFloatStringConvert a string to a floating point numberconvert
ToVectorVector4ArgumentPackConvert set of numbers to a vector (up to 4)convert
MakePieCcoPieDataExpressionState, ContextList, Expression, Expression, ExpressionCreates a CcoPieData from functionconvert
CreateSelectionListCcoContextSelectionContextListCreates a CcoContextSelection from a CONTEXT_LISTconvert
ToVector4Vector4Float, Float, Float, FloatConvert set of numbers to a vector4 (up to 4)convert
ToVector3Vector3Float, Float, FloatConvert set of numbers to a vector3 (up to 3)convert
ToVector2Vector2Float, FloatConvert set of numbers to a vector2 (up to 2)convert

tweakers

NameReturn TypeArgumentsDescriptionTagsEvents
TweakerAsIntIntStringRetrieve the specified tweaker as an inttweakers
TweakerAsFloatFloatStringRetrieve the specified tweaker as an floattweakers
TweakerAsBoolBoolStringRetrieve the specified tweaker as an booltweakers

Misc

CcoContextExpression

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EvaluateExpressionArgumentPackContext, ArgumentPack
TextRepresentationStringVoid

CcoContextExpressionCompilationError

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionStringVoid

CcoContextExpressionResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasStringRepresentationBoolVoid
ResultTypeCcoContextObjectTypeVoid
ValueArgumentPackVoid

CcoContextExpressionRuntimeError

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionStringVoid

CcoContextList

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DistinctContextListExpressionState, Expression (optional)Returns the distinct elements of the list
FilterContextListExpressionState, ExpressionReturns a list with all the elements of the given list that satisfy the condition.
AppendContextListExpressionState, ArgumentPackReturns a list new list, containing the current list's elements + any elements passed in as an argument (the argument must be a context expression, and must return either a single context object or another context object list).
AnyBoolExpressionState, ExpressionReturns true if any of the contexts return true for the given expression
CountIntExpressionState, ExpressionReturns the number of elements that satisfy the given expression
AllBoolExpressionState, ExpressionReturns true if all the contexts return true for the given expression
MaxValueFloatExpressionState, ExpressionReturns the largest value evaluated for each context in the list using expression
ForEachVoidExpressionState, ExpressionPerforms the supplied expression on each context
MinValueFloatExpressionState, ExpressionReturns the smallest value evaluated for each context in the list using expression
MaxContextContextExpressionState, ExpressionReturns the context with the largest value evaluated for each context in the list using expression
TransformContextListExpressionState, ExpressionTransforms the list into a new one where each element is produced by the given expression
AtContextIntReturns the context at the specified index
MinContextContextExpressionState, ExpressionReturns the context with the smallest value evaluated for each context in the list using expression
NextContextContextContextGiven a context that exists in the list, returns the next context if one exists, will also wrap around the end of the list. If list only has one element will return the one element
PartitionContextListExpressionState, ExpressionReturns the subset of the list at the point where the first context matches the given expression
LastContextContextExpressionState, Expression (optional)Returns the last context by default, if supply an expression as a parameter it will return the last context that returns true for the condition and otherwise return null
PreviousContextContextContextGiven a context that exists in the list, returns the previous context if one exists, will also wrap around the beginning of the list. If list only has one element will return the one element
JoinStringUniStringExpressionState, Expression, UniStringReturns a combined string using the first expression to determine how to get the string for each context, and splitting each entry with the supplied separator
IndexForFirstContextIntExpressionState, ExpressionReturns the index of the first context that returns true for the supplied expression
FindIfContextExpressionState, Expression
FindContextContext
ReduceArgumentPackExpressionState, Expression, Expression (optional)Reduces the list based on given predicate starting at optional initialiser value
FirstContextContextExpressionState, Expression (optional)Returns the first context by default, if supply an expression as a parameter it will return the first context that returns true for the condition and otherwise return null
CompareSortContextListCcoContextList, ExpressionState, Expression
SumArgumentPackExpressionState, ExpressionAccumulates the values returns by each contexts expression (for adding up totals)
ListContextListVoidReturns internal list of contexts
SkipContextListIntSkip the first x elements of the list
IsEmptyBoolVoidReturns true if the list is empty
ReverseContextListVoidReturns the list in the opposite order
TakeContextListIntReturns the first N elements of the list
SizeIntVoidReturns the number of elements in the list
ContainsBoolContextReturns true if supplied context exists in the list
BSortContextListExpressionState, ExpressionSort based on a function that expects left and right and returns true if their relative position is correct and false if they need to swap places
SummedValueListContextListExpressionState, Expression, ExpressionReturns a list of CcoSummedValueContext, where the first expression supplied is to determine what groups two contexts, and the second expression is used to calculate the value for each context for summing the values
SortContextListExpressionState, Expression, Bool (optional)Returns the list sorted by the given expression, pass true for second parameter to sort in ascending order (defaults to descending)
PadRightContextListExpressionState, Int, Expression (optional)Returns a list with at least N number of elements. If the original list had less than N elements, the new elements will be either CcoEmptyObject or the object returned by the given expression.

CcoContextObjectType

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SymbolsListContextListVoid
IsListBoolVoid
IsArithmeticBoolVoid
HasStringRepresentationBoolVoid
NameStringVoid

CcoContextSymbol

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TypeContextCcoContextObjectTypeVoid
TagsStringVoid
NameStringVoid
EvaluateSymbolArgumentPackContext, ArgumentPack
IsCommandBoolVoid
DocumentationStringVoid

CcoFindResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IndexIntVoid
ContextContextVoid

CcoGroupList

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GroupedListContextListVoid
CategoryObjectContextVoid

CcoPair

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SecondArgumentPackVoidSecond member of the pair
FirstArgumentPackVoidFirst member of the pair

CcoRuntimeObject

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
InternalContextVoid

CcoString

Wrapper for string type, for dealing with text (localised and unlocalised, we abstract the difference between wide/narrow for simplicity of context system users)

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ToLowerUnlocalisedUniStringCcoStringReturns a copy of this string where all letters are lowercase, this uses default string lowercase and will not take localisation into account
ToLowerLocalisedUniStringCcoString, ExpressionStateReturns a copy of this string where all letters are lowercase, this uses current locale so the string will use special characters and might not be same as English lowercase
HashIntVoidReturns hash of the string
ToUpperUnlocalisedUniStringCcoStringReturns a copy of this string where all letters are uppercase, this uses default string uppercase and will not take localisation into account
SplitCcoString (list)UniStringReturns list of CcoStrings based on delimiter supplied used to split it up (handy to convert a string into a list of entries to show as bullet points in a ContextList for example
ToUpperLocalisedUniStringCcoString, ExpressionStateReturns a copy of this string where all letters are uppercase, this uses current locale so the string will use special characters and might not be same as English uppercase
ExtractColourFromTextUniStringVoidReturns the colour tag from the specified text
ExtractImageIconFromTextUniStringVoidReturns the image path inside the image tag in the specified text
RemoveFilepathExtensionUniStringVoidReturns a copy of this string with the file extension removed, assuming this string is a filepath
RemoveFilepathDirectoryUniStringVoidReturns a copy of this string with the parent directory removed, assuming this string is a filepath
RemoveLeadingWhitespaceUniStringVoidReturns a copy of this string with leading whitespace removed
ReplaceUniStringCcoString, ExpressionState, UniString, UniStringReturns a copy of this string where all instances of the first string supplied are replaced with the second string supplied
RemoveTextTagsUniStringVoidReturns a copy of this string with all text tags removed
SubstrUniStringInt, Int (optional)Returns a sub-section of this string as specified by the starting index and optional length (if no length will return from start index to end of string)
RFindIntCcoString, ExpressionState, UniString, Int (optional)Returns the first index of the specified string, searching from the back. Returns -1 if none found. Can specify a starting position to search from as second parameter, this defaults to 0 if none specified
FindIntCcoString, ExpressionState, UniString, Int (optional)Returns the first index of the specified string, searching from the front. Returns -1 if none found. Can specify a starting position to search from as second parameter, this defaults to 0 if none specified
LengthIntVoidReturns the length of this string
IsEmptyBoolVoidReturns true if this string is empty/blank
ContainsBoolCcoString, ExpressionState, UniStringReturns true if this string contains the specified string
EndsWithBoolCcoString, ExpressionState, UniStringReturns true if this string ends with the specified string
ValueUniStringVoidReturns the string value represented by this string
StartsWithBoolCcoString, ExpressionState, UniStringReturns true if this string starts with the specified string
ParseTextReplacementsUniStringCcoString, ExpressionStateReturns a copy of this string where any text tags are parsed and replaced in with the actual text

CcoSummedValueContext

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SummedListContextListVoid
OriginalContextContextVoid
SummedValueFloatVoid

CcoVector2

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ValueVector2Void
DistanceFloatVector2
ModulusFloatVoid
yFloatVoid
xFloatVoid

CcoVector3

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DistanceFloatVector3
ModulusFloatVoid
zFloatVoid
yFloatVoid
xFloatVoid
ValueVector3Void

CcoVector4

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ModulusFloatVoid
wFloatVoid
zFloatVoid
yFloatVoid
xFloatVoid
ValueVector4Void
DistanceFloatVector4

Record

CcoAbilityCollectionRecord

Wrapper for an AbilityCollection for nested abilities

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ShouldHideAbilityDescriptionBoolCcoUnitAbilityHides a component based on record is_hidden entry
AbilitySortOrderIntCcoUnitAbilityDetailsReturns the sort order for a given ability
PrimaryAbilityForUnitCcoUnitAbilityDetailsCcoUnitDetailsReturns the primary ability of this collection for the given unit
IconPathForUnitStringCcoUnitDetailsReturns the collection's icon file path for the given unit
AttributesForUnitCcoStringValue (list)CcoUnitDetailsReturns the attributes associated with this collection and given unit (CcoUnitDetails)
AbilitiesForUnitCcoUnitAbility (list)CcoUnitDetailsReturns the unit abilities associated with this collection and given unit (CcoUnitDetails)
RecordListCcoAbilityCollectionRecord (list)VoidReturns a list of all CcoAbilityCollection records

CcoAbilityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
ViewInDbVoidVoid
RecordListVoidVoid
OnScreenDescriptionVoidVoid
OnScreenNameVoidVoid
AbilityVoidVoid

CcoActionResultRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
TargetEffectBundleTurnsVoidVoid
ActorEffectBundleTurnsVoidVoid
TargetEffectBundleVoidVoid
ActorEffectBundleVoidVoid
KeyVoidVoid

CcoAdviceLevelRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
AdvisorNameVoidVoid
InfoTextVoidVoid
TextVoidVoid
TitleVoidVoid
SubCategoryVoidVoid
CategoryVoidVoid
AdviceThreadVoidVoid
KeyVoidVoid

CcoAgentActionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LocalisedActionNameKeyVoidVoid
AgentContextVoidVoid
AbilityContextVoidVoid
UniqueIdVoidVoid
RecordListVoidVoid
IconPathVoidVoid
ChanceOfSuccessVoidVoid
CriticalFailureProportionModifierVoidVoid
OpportuneFailureProportionModifierVoidVoid
CriticalSuccessProportionModifierVoidVoid
LocalisedActionDescriptionVoidVoid
LocalisedActionDescriptionKeyVoidVoid
LocalisedActionNameVoidVoid

CcoAgentCultureDetailRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionVoidVoid
DescriptionKeyVoidVoid
OnscreenNameVoidVoid
OnscreenNameKeyVoidVoid
CultureContextVoidVoid
AgentVoidVoid
RecordListVoidVoid
RecruitableInUiVoidVoid
SmallIconVoidVoid
IconVoidVoid
GenderVoidVoid
AgentRecruitedMovieVoidVoid
LevelVoidVoid
SeasonVoidVoid
KeyVoidVoid
AssociatedUnitContextVoidVoid

CcoAgentRecord

Record wrapper for an AGENT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PortraitOverrideStringVoidReturns the portait override path
IsGeneralBoolVoidReturns true if the agent is a general
PlayableBoolVoidReturns true if the agent is playable
LineOfSightIntVoidReturns how much line of sight the agent has
MovePointsIntVoidReturns the amount of move points the agent has
CultureDetailsContextCcoAgentCultureDetailRecordString (optional)Returns the culture details context for the agent record, using optionally provided culture key
KeyStringVoidReturns the key of the agent record
UnlockedByPooledResourceSetListCcoPooledResourceThresholdOperationSetRecord (list)CcoCampaignFactionReturns a list of UnlockedByPooledResourceSetList that will unlock this agent, if any
RecordListCcoAgentRecord (list)VoidReturns a list of all agent records in the table
SortOrderIntVoidReturns the sort order for the agent record
EncyclopediaUrlStringVoidReturns the encyclopedia url of the agent
InEncyclopediaBoolVoidReturns true if the agent has an encyclopedia entry
FactionCapIntVoidReturns how many agents of this type a faction can have

CcoAgentSubtypeRecord

Record wrapper for agent_subtypr_record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanBeLoadedInCampaignBoolVoidReturns true if this subtype can be loaded in campaign
IsSaveableBoolVoidReturns true if this subtype can be saved/loaded
IsCasterBoolVoidReturns true if this agent subtype can cast spells
OnscreenNameOverrideKeyStringVoidReturns a string with the name override key
OnscreenNameOverrideUniStringVoidReturns the name override for this agent subtype if any
AutoGenerateBoolVoidReturns true if this agent subtype can be auto generated
KeyStringVoidReturns the key of the record
UniqueAgentContextCcoAgentRecordVoidIf this subtype is an unique agent, returns the agent record of it
AgentSubtypeAgentPairContextCcoAgentSubtypeAgentPairCcoAgentRecordReturns the pair of this agent subtype and the agent record passed in
RecordListCcoAgentSubtypeRecord (list)VoidReturns a list with all agent subtypes in the table
CharacterAncillaryQuestListCcoCharacterAncillaryQuestUiDetailRecord (list)VoidReturns a list with all ancillary quests associated with this agent subtype, if any
HasFemaleNameBoolVoidReturns true if it has a female name
CapIntVoidReturns the max number of characters that can have this agent subtype
ShowInUiBoolVoidReturns true if this agent subtype should show in UI
DescriptionTextOverrideUniStringVoidReturns the description override if any
AssociatedUnitOverrideCcoMainUnitRecordVoidReturns the associated unit override if any
SmallIconStringVoidReturns the small image path of this agent subtype

CcoAncillariesCategoryRecord

Record wrapper for an ancillaries_category_record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DefaultEntryNameUniStringVoidReturns a localised default name, for when no ancillary of this category is equipped
SortOrderIntVoidReturns an int with the category sort order
IconNameStringVoidReturns the name of the icon that is used for this category
OnscreenNameUniStringVoidReturns the localised name of the category
CategoryStringVoidReturns a string from the category enum
KeyStringVoidReturns the key of the record
IsHiddenBoolVoidReturns true if this ancillary catgeory should be hidden in ui
NumAllowedPerCharacterForFactionIntCcoCampaignCharacter, CcoFactionRecord (optional)Returns the number of ancillaries that can be equipped into this category per category for a (optionally provided) faction, e.g. 3 for runes
RecordListCcoAncillariesCategoryRecord (list)VoidReturns a list with all entries from the ancillaries_category_table
IsFusableBoolVoidReturns true if items from this category can be fused
DefaultEntryTooltipUniStringVoidReturns a localised default tooltip, for when no ancillary of this category is equipped

CcoAncillariesSubcategoryRecord

Context wrapper for a ANCILLARIES_SUBCATEGORY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsRuneBoolVoidReturns true if this subcategory is a rune
RecordListCcoAncillariesSubcategoryRecord (list)VoidReturns a list of all subcategories in the database
SubcategoryStringVoidReturns the subcategory string/key
OnscreenNameUniStringVoidReturns the localised name of the subcategory

CcoAncillaryRecord

Record wrapper for a ancillary_record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconStateStringVoidReturns a string with the state name that should be set on the icon based on the ancillary category
IncludedAgentSubtypesListCcoAgentSubtypeRecord (list)VoidReturns a list with agent subtypes that can equip this ancillary
GrantedTextUniStringVoidReturns a string showing the message to use when an ancillary is granted by tech etc.
IncludedAgentsListCcoAgentRecord (list)VoidReturns a list with the agents that can equip this ancillary
FrameStateStringVoidReturns a string with the state name that should be set on the frame based on the ancillary category
ExplanationTextUniStringVoidReturns a string explaining the reason why this ancillary was dropped
RarityStateStringVoidReturns a string with the rarity state of the ancillary category
MaxExpiryAgeIntVoidReturns the maximum expiry age
AncillarySetContextCcoAncillarySetRecordVoidReturns the context of the ancillary set that this belongs to
IconPathStringVoidReturns the icon path of the ancillary
EffectUnfilteredListCcoEffect (list)VoidReturns a list of effects from this ancillary record, includes those not shown in uihide_in_uied
MinExpiryAgeIntVoidReturns the minimum expiry age
MaxStartingAgeIntVoidReturns the maximum starting age for this ancillary
EffectListCcoEffect (list)VoidReturns a list of effects from this ancillary record, prefiltered to not show those that shouldnt appear in ui
OnscreenNameUniStringVoidReturns the localised name of the ancillary
MinStartingAgeIntVoidReturns the minimum starting age for this ancillary
UniquenessRecordContextCcoAncillaryUniquenessGroupingRecordVoidReturns the context of the uniqueness group where this fits, based on its uniqueness score.
KeyStringVoidReturns the key of the record
CategoryContextCcoAncillariesCategoryRecordVoidReturns the context of the ancillary category
RarityNameUniStringVoidReturns the localised name of the rarity name of the ancillary, based on the uniqueness score
RecordListCcoAncillaryRecord (list)VoidReturns a list with all ancillaries in the table
LegendaryItemBoolVoidReturns true if this item is legendary
SubcategoryContextCcoAncillariesSubcategoryRecordVoidReturns the context of the ancillary sub category
ColourTextUniStringVoidReturns localised description for the ancillary
EffectTextUniStringVoidReturns localised text for the ancillary effects
TurnsBeforeSwapAllowedIntVoidReturns an int with the number of turns until this ancillary can be swapped with another of the same category
EndDateIntVoidReturns an int with the end date of the ancillary
UniquenessScoreIntVoidReturns the uniqueness score of this ancillary
StartDateIntVoidReturns an int with the start date of the ancillary
ProvidedBannerContextCcoBannerRecordVoidReturns the context of the banner assiciated with this ancillary, used for ancillaries with banner subcategory
FirstLinkedUnitRecordCcoMainUnitRecordVoidReturns the first linked unit record
PrecedenceIntVoidReturns an int with the precedence of the ancillary
UniqueToFactionBoolVoidReturns true if this ancillary is unique factionwide
ProvidedBodyguardUnitContextCcoMainUnitRecordVoidReturns the context of the provided bodyguard context, usually used for mounts
OwningCharacterContextCcoCampaignCharacterCcoCampaignFaction (optional)Returns the CcoCampaignCharacter that owns this ancillary. Searches in the players faction, or the optionally provided CcoCampaignFaction
UniqueToWorldBoolVoidReturns true if this ancillary is unique to the world
ImmortalBoolVoidReturns true if this ancillary is immortal
CanFactionUseAncillaryBoolCcoFactionRecordReturns true if the passed in faction record can use this ancillary
RandomlyDroppedBoolVoidReturns true if this ancillary is randomly dropped
IsWifeAncillaryBoolVoidReturns true if this is a wife ancillary
TransferrableBoolVoidReturns true if this ancillary can be transferred between characters
TypeContextCcoAncillaryTypeRecordVoidReturns the context of the type record associated with this ancillary
CanBeDestroyedBoolVoidReturns true if this ancillary can be destroyed
IncludedSubculturesListCcoSubcultureRecord (list)VoidReturns a list of subcultures that can use this ancillary

CcoAncillarySetRecord

Record wrapper for an ancillary set record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoAncillarySetRecord (list)VoidReturns a list of all ancillary sets in the table
RequiredAncillariesListCcoAncillaryRecord (list)VoidReturns a list of ancillaries that are required for this set to be complete.
EffectUnfilteredListCcoEffect (list)VoidReturns a list of effects that will be provided by this ancillary set when it completes, includes those not shown in uihide_in_uied
EffectListCcoEffect (list)VoidReturns a list of effects that will be provided by this ancillary set when it completes, prefiltered to not show those that shouldnt appear in ui
IconPathStringVoidReturns the icon path of the set
DescriptionUniStringVoidReturns the description of the set
NameUniStringVoidReturns the localised name of the set

CcoAncillaryTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
IconVoidVoid
KeyVoidVoid

CcoAncillaryUniquenessGroupingRecord

Record wrapper for a ancillary_uniqueness_grouping_record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyStringVoidReturns the key of the record
RecordListCcoAncillaryUniquenessGroupingRecord (list)VoidReturns a list with all uniqueness groups in the table
IsFusableBoolVoidReturns true if this items in this group can be fused
MaxIntVoidReturns an int with the upper bound of this group
MinIntVoidReturns an int with the lower bound of this group
UiStateStringVoidReturns the ui state for this group
ColourColourVoidReturns the colour of this uniqueness group

CcoArmoryItemRecord

Record wrapper for armory item record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ItemSetListCcoArmoryItemSetRecord (list)VoidReturns a list of all the sets this item is part of
VariantContextCcoArmoryItemVariantRecordStringReturns the context of the variant with the key passed in
DefaultOrFirstVariantContextForCharacterCcoCampaignArmoryItemVariantCcoCampaignCharacterReturns either the default variant if exists, or the first in the list of variants, for the character passed in
DefaultVariantContextCcoArmoryItemVariantRecordVoidReturns the context of the default variant for this item
SlotTypeContextCcoArmorySlotTypeRecordVoidReturns the context of the slot type record
IsLockedByAchievementBoolVoidReturns true if this item is currently locked by an achievement
ItemTypeContextCcoArmoryItemUiTypeRecordVoidReturns the type context of the armory item
AchievementUnlockScoreIntVoidReturns the score needed to unlock this item through achievements
DescriptionUniStringVoidReturns the localised description of the record.
RoundUnlockedForCharacterIntCcoCampaignCharacterReturns the round when the item was made available to the passed in character
NameUniStringVoidReturns the localised name of the armory item record.
ImagePathStringVoidReturns the image path of either the default or the first variant
MatchesQueryBoolUniStringReturns true if the item or its effects match (possibly partially) the query text given
KeyStringVoidReturns the key of the record.
DefaultItemSetCcoArmoryItemSetRecordVoidReturns the first set that has effects (each item should only have max 1 set with effects, rest are used for custom battle)
MarkAsSeenVoidVoidMarks the equipment as seen so that HasSeen will return false
HasSeenBoolVoidReturns true if the user has already 'seen' this ancillary (MarkAsSeen has been called on it). This is to highlight new equipment
RecordListCcoArmoryItemRecord (list)VoidReturns a list with all the armory item records in the table
EffectListCcoEffect (list)VoidReturns a list with the effects provided by this item
IsEquippedForCharacterBoolCcoCampaignCharacterReturns true if the item is equipped for the character (campaign only)
VariantRecordListCcoArmoryItemVariantRecord (list)VoidReturns a list with all the variants of this item

CcoArmoryItemSetRecord

Wrapper for a ARMORY_ITEM_SET_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectUnfilteredListCcoEffect (list)VoidReturns the effect list provided when all items in the set are equipped, includes those not shown in uihide_in_uied
EffectListCcoEffect (list)VoidReturns the effect list provided when all items in the set are equipped
IconStringVoidReturns the icon path of the item set
DescriptionUniStringVoidReturns the localised description of the item set
NameUniStringVoidReturns the localised name of the item set
KeyStringVoidReturns a string with the key of the record
RecordListCcoArmoryItemSetRecord (list)VoidReturns a list with all item sets in the table
ItemListCcoArmoryItemRecord (list)VoidReturns all the armory items that are part of this set

CcoArmoryItemUiTypeRecord

Wrapper for a ARMORY_ITEM_UI_TYPE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyStringVoidReturns the type of the armory items linked to this (generic/khorne/nurgle/tzeentch/slaanesh).
RecordListCcoArmoryItemUiTypeRecord (list)VoidReturns a list with all records in this table

CcoArmoryItemVariantRecord

Wrapper for an armory item variant record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoArmoryItemVariantRecord (list)VoidReturns a list with all armory item variants in the database table.
UseAsDefaultBoolVoidReturns a bool that specifies whether this variant is used as the default
ArmoryItemContextCcoArmoryItemRecordVoidReturns the context of the armory item associated with this item variant
DescriptionUniStringVoidReturns the description of this variant
NameUniStringVoidReturns the localised name of the item variant
ImagePathStringVoidReturns the image path of this variant
KeyStringVoidReturns a string with the key of this record

CcoArmorySlotTypeRecord

Wrapper for an armory slot type record.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EquippedItemVariantForCharacterContextCcoCampaignArmoryItemVariantCcoCampaignCharacterReturns a CcoCampaignArmoryItemVariant with the equipped variant in the slot for the character passed in (campaign only)
RecordListCcoArmorySlotTypeRecord (list)VoidReturns a list with all armory slot type records from the database table
SortOrderIntVoidReturns an int with the sort order
NameUniStringVoidReturns a the localised name of the slot type
KeyStringVoidReturns a string with the key of the record

CcoArmySpecialAbilityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitSpecialAbilityContextVoidVoid
EnablesSiegeAssaultVoidVoid
UniqueIDVoidVoid
ArmySpecialAbilityKeyVoidVoid

CcoBannerRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PermittedUnitSetsVoidVoid
CombatPotentialAdjustmentsVoidVoid
BannerVoidVoid
EffectBundleRecordVoidVoid

CcoBattleClimateWeatherDescriptionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HeatFatigueVoidVoid
SeasonRecordContextVoidVoid
WeatherRecordContextVoidVoid
ClimateRecordContextVoidVoid
RecordListVoidVoid
SpottingScalarVoidVoid
ProbabilityVoidVoid
ColdFatigueVoidVoid

CcoBattleCurrencyArmySpecialAbilitiesCostValueRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CostValueVoidVoid
BattleSecondaryCurrencyTypeContextVoidVoid
ArmySpecialAbilityContextVoidVoid

CcoBattleCurrencyUnitAbilitiesCostValueRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CostValueVoidVoid
ItemTypeContextVoidVoid
CurrencyTypeContextVoidVoid

CcoBattleEntityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RadiusVoidVoid
WalkSpeedVoidVoid
CanClimbLadderAndStairPipesVoidVoid
TypeVoidVoid
SoftCollisionOffsetZVoidVoid
GradientStrategyVoidVoid
KnockInterruptsIgnoreChanceVoidVoid
KeyVoidVoid
SoftCollisionSizeVoidVoid
ChargeDistancePickTargetSqVoidVoid
HitReactionsIgnoreChanceVoidVoid
ChargeDistanceAdoptChargePoseSqVoidVoid
RecordListVoidVoid
CombatReactionRadiusVoidVoid
ChargeDistanceCommenceRunSqVoidVoid
DismemberArmsAliveHpRatioVoidVoid
MinTurningSpeedVoidVoid
ChargeDistancePickTargetVoidVoid
DismemberHeadAliveHpRatioVoidVoid
AllowStaticTurnAnimVoidVoid
ChargeDistanceAdoptChargePoseVoidVoid
HasBloodVoidVoid
AllowTurnToMoveAnimVoidVoid
ChargeDistanceCommenceRunVoidVoid
CanCastProjectileVoidVoid
TurnSpeedVoidVoid
VfxFilterIdVoidVoid
MaxTrackingRatioVoidVoid
StrafeSpeedVoidVoid
QuarterFireArcCloseCosineVoidVoid
FlyingChargeSpeedVoidVoid
MinTrackingRatioVoidVoid
HalfFireArcCloseCosineVoidVoid
AuraVfxVoidVoid
ChargeSpeedVoidVoid
FireArcCloseVoidVoid
ProjectilePenetrationResistanceVoidVoid
DecelerationVoidVoid
HeightVoidVoid
AccelerationVoidVoid
MassVoidVoid
ProjectilePenetrationSpeedChangeVoidVoid
FlySpeedVoidVoid
RadiiRatioVoidVoid
ProjectileIntersectionRadiusRatioVoidVoid
RunSpeedContextVoidVoid
ShapeVoidVoid

CcoBattlePurchasableGroupRecord

Wrapper for a battle purchasable group record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PurchasableArmyAbilitiesListCcoBattlePurchasableArmyAbility (list)VoidReturn the list of purchasable army usesabilities in the group
PurchasableUnitAbilitiesListCcoBattlePurchasableUnitAbility (list)VoidReturn the list of purchasable abilities in the group

CcoBattlePurchasableItemsJunctionRecord

Wrapper for a Battle Purchasable Items Junction record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListForCategoryCcoBattlePurchasableUnitAbility (list)String(CategoryKey) Get the list of CcoBattlePurchasableUnitAbility's in the specified category
GroupsForCategoryCcoBattlePurchasableGroupRecord (list)String(CategoryKey) Get the list of CcoBattlePurchasableGroupRecord's in the specified category
RecordListCcoBattlePurchasableItemsJunctionRecord (list)VoidGet the full list of available CcoBattlePurchasableItemsJunctionRecord's
RecordListForCategoryFilteredCcoBattlePurchasableUnitAbility (list)String, ContextList(CategoryKey, UnitList) Get a list of CcoBattlePurchasableUnitAbility's, in the specified category, filtered by which abilities can be applied to any of a list of units

CcoBattlePurchasableItemsUiCategoryRecord

Wrapper for a UI Battle Purchasable Items Junction record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoBattlePurchasableItemsUiCategoryRecord (list)Void
CategoryKeyStringVoid

CcoBattleRecord

Record wrapper for a BATTLE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SingleplayerBoolVoid
IsCommunityBoolVoid
MultiplayerBoolVoid
StartBattleVoidExpressionState
ReleaseMapBoolVoid
RecordListCcoBattleRecord (list)Void
DescriptionUniStringVoid
NameUniStringVoid
EnvironmentAudioTypeStringVoid
MapStringVoid
EnvironmentPathStringVoid
ScreenshotStringVoid
Has15mWallsBoolVoid
SpecificationStringVoid
IsLargeSettlementBoolVoid
IsNavalBoolVoid
PlayableAreaHeightFloatVoid
BattleTypeStringUniStringVoid
PlayableAreaWidthFloatVoid
UserCreatedBoolVoid
BattleTypeStringVoid
AuthorStringVoid
CatchmentNameStringVoid
MatchmakingBoolVoid
KeyStringVoid
HasKeyBuildingsBoolVoid
DefenderFundsRatioFloatVoid
YearIntVoid
IntroMovieStringVoid
IsOfficialBoolVoid

CcoBattleResultTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
UnitXpGainVoidVoid
ResultDescriptionVoidVoid
BattleResultTypeVoidVoid
ResultScreenNameVoidVoid

CcoBattleSecondaryCurrencySourceTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsAllianceBasedVoidVoid
SourceTypeVoidVoid
DescriptionVoidVoid
RecordListVoidVoid
UiLocalisedNameVoidVoid

CcoBattleSecondaryCurrencyTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
UiIconPathVoidVoid
UiLocalisedNameVoidVoid
CurrencyTypeVoidVoid

CcoBattleSetPieceArmiesCharacterRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AgentSubtypeContextVoidVoid
AgentTypeContextVoidVoid
NumMenVoidVoid
CharacterLevelVoidVoid
UnitRecordContextVoidVoid
MagicLoreContextVoidVoid
NameVoidVoid
RecordListVoidVoid
MaleVoidVoid
PortraitForCardVoidVoid
PortraitVoidVoid
SkillsListVoidVoid
ItemsListVoidVoid

CcoBattleSetPieceArmiesCharactersItemRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CharacterItemContextVoidVoid
NameVoidVoid

CcoBattleSetPieceArmiesCharactersSkillRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
LevelVoidVoid
SkillContextVoidVoid
CharacterNameVoidVoid

CcoBattleSetPieceArmiesUnitRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PercentageNumMenVoidVoid
KeyVoidVoid
UnitLevelVoidVoid
UnitRecordContextVoidVoid

CcoBattleSetPieceArmyRecord

Wrapper for a BATTLE_SET_PIECE_ARMY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitsListCcoBattleSetPieceArmiesUnitRecord (list)Void
CharactersListCcoBattleSetPieceArmiesCharacterRecord (list)Void
UseDefaultDeploymentZonesBoolVoid
IsFrontendPlayerArmyBoolVoid
RecordListCcoBattleSetPieceArmyRecord (list)Void
IsReinforcementArmyBoolVoid
IsAlliedToPlayerBoolVoid
DeploymentZoneIdIntVoid
FlagPathRotatedStringVoid
ApproachAngleIntVoid
FlagPathLargeStringVoid
AiArmyTacticStringVoid
FlagPathMediumStringVoid
NameUniStringVoid
FlagPathSmallStringVoid
FactionContextCcoFactionRecordVoid
FlagDirStringVoid
KeyStringVoid
ShouldMergeArmyBoolVoid
IsHiddenArmyBoolVoid
DefaultArmyAbilityListCcoUnitSpecialAbilityRecord (list)Void
EffectBundlesListCcoEffectBundle (list)Void

CcoBattleSetPieceFrontendGroupRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
BattleListVoidVoid
CharacterListVoidVoid
CampaignMapContextVoidVoid
SortOrderVoidVoid
KeyVoidVoid

CcoBattleSetPieceFrontendGroupsToCharacterRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
FrontendGroupContextVoidVoid
CharacterContextVoidVoid

CcoBattleSetPieceRecord

Wrapper for a BATTLE_SET_PIECE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BattlefieldFolderStringVoid
PlayerFrontendArmiesListCcoBattleSetPieceArmyRecord (list)Void
ArmiesListCcoBattleSetPieceArmyRecord (list)Void
DescriptionUniStringVoid
ArmoryItemAchievementUnlockListCcoArmoryItemRecord (list)Void
NameUniStringVoid
UseLargeArmiesBoolVoid
RecordListCcoBattleSetPieceRecord (list)Void
IsPlayerAttackerBoolVoid
StartBattleVoidExpressionState, CcoCampaignMapPlayableAreaRecord
BattleScriptStringVoid
ScreenshotPathStringVoid
BattleSetupContextCcoBattleSetupVoid
BattleEnvironmentStringVoid
HasBeenCompletedBoolVoid
BattleTypeContextCcoBattleTypeRecordVoid
CampaignPreBattleIntroMovieContextCcoVideoRecordVoid
BattleDurationIntVoid
KeyStringVoid
OutroMovieLoseContextCcoVideoRecordVoid
OutroMovieWinContextCcoVideoRecordVoid
IntroMovieContextCcoVideoRecordVoid
CatchmentAreaStringVoid
TeleportCostIntVoid

CcoBattleTypeCheatSheetEntryRecord

Wrapper for a Battle UI Cheatsheet Item Record. Used for individual entries used in creating cheat sheet layouts

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionTextUniStringVoid
HeaderTextUniStringVoid
IconPathStringVoid
KeyStringVoid
VisualKeyStringStringVoidGets the string which is used to key the item into the cheat sheet screenshot or similar
ColumnIndexIntVoidSpecifies which column group the entry should be in. This index is filtered when the cheat sheet list is collated
PriorityIndexIntVoidSpecifies the priority which this item will be listed in the current column. Lower = Higher up the list

CcoBattleTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
RecordListVoidVoid
DescriptionVoidVoid
MaxTeamsizeVoidVoid
DefenderFundsRatioVoidVoid
DefenderVictoryConditionsListVoidVoid
AttackerVictoryConditionsListVoidVoid
ListOrderVoidVoid
NameVoidVoid

CcoBattleVortexRecord

Wrapper for a BATTLE_VORTEX_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoBattleVortexRecord (list)VoidReturns a list of all battle vortex records
IsMagicalBoolVoidReturns true if the vortex deals magical damage
DelayBetweenVortexesFloatVoidReturns the delay between creating additional vortexes
KeyStringVoidReturns the db key for this record
DelayFloatVoidReturns the delay before the vortex starts dealing damage / applying contact effects
DetonationForceFloatVoidReturns the force that the vortex detonates with
IgnitionAmountFloatVoidReturns the ignition amount of the vortex
MovementSpeedFloatVoidReturns the speed that the vortex moves at (m/s)
GoalHeightFloatVoidReturns the height that the vortex will expand to at the end of its duration
GoalRadiusFloatVoidReturns the radius that the vortex will expand to at the end of its duration
ExpansionSpeedFloatVoidReturns the speed that the vortex expands at
DurationFloatVoidReturns the duration in seconds of the vortex
ArmourPiercingPercentageIntVoidReturns the calculated armour piercing value based on the damage AP to damage ratio, as a percentage
NumVortexesIntVoidReturns the number of vortexes that this spell creates
DamageAPIntVoidReturns the armour-piercing damage per second per entity hit of the vortex
DamageIntVoidReturns the damage per second per entity hit of the vortex
ChangeMaxAngleIntVoidReturn the max angle change of the vortex
ContactEffectPhaseContextCcoSpecialAbilityPhaseRecordVoidReturns the contact effect context for this battle vortex record (nullptr if not set)
IsCircleBoolVoidReturns whether this vortex shape is Circle
AffectsAlliesBoolVoidReturns true if the vortex also affects allied units

CcoBattleWeatherTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
IconPathVoidVoid
GunReloadBonusVoidVoid
BowReloadBonusVoidVoid
AccuracyMultiplierVoidVoid
NavalAppropriateVoidVoid
ListOrderVoidVoid
OnscreenNameVoidVoid
LevelVoidVoid
KeyVoidVoid

CcoBattlefieldEngineRecord

Wrapper for a BATTLEFIELD_ENGINE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BattleEntityContextCcoBattleEntityRecordVoid
MissileWeaponContextCcoMissileWeaponRecordVoid
KeyStringVoid
RecordListCcoBattlefieldEngineRecord (list)Void
CanBeDismantledBoolVoid

CcoBattlefieldSiegeVehicleRecord

Wrapper for BATTLEFIELD_SIEGE_VEHICLE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AttackDamageFloatVoidReturns damage causes (for attacking gates, etc)
IgnitionThresholdIntVoidReturns the threshold of fire damage will take before catching fire
AvailableToFactionsListCcoFactionRecord (list)VoidReturns list of CcoFactionRecord that can use this record
CategoryImagePathStringVoidReturns the category image path
CostIntVoidReturns the cost to purchase
Uses15mWallBoolVoidReturns true if valid for 15m walls
Uses8mWallBoolVoidReturns true if valid for 8m walls
RecordListCcoBattlefieldSiegeVehicleRecord (list)VoidReturns list of all CcoBattlefieldSiegeVehicleRecord in table
RecruitmentCapIntVoidReturns max number can recruit
ImagePathStringVoidReturns the image path
DescriptionUniStringVoidReturns the localised description
NameUniStringVoidReturns the localised name
VehicleCategoryStringVoidReturns vehicle category (battering ram, siege tower, etc)
SiegeVehicleEntityContextCcoBattleEntityRecordVoidReturns the entity record context
KeyStringVoidReturns unique key for db record
HitPointsIntVoidReturns the hit points (health) of equipment
SortOrderIntVoidReturns sort order used by UI

CcoBattlefieldSiegeVehiclesCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
ProbabilityVoidVoid
CapVoidVoid
VehicleContextVoidVoid

CcoBooksOfNagashDetailsRecord

Wrapper for a BOOKS_OF_NAGASH_DETAIL_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconStringVoidReturns the icon for this record
DescriptionUniStringVoidReturns the localised description of this record
NameUniStringVoidReturns the localised name of this record
KeyStringVoidReturns the key of this record
RecordListCcoBooksOfNagashDetailsRecord (list)VoidReturns a list of all records from the table
RogueArmyFactionEffectBundleCcoEffectBundleVoidReturns the effect bundle applied when a rogue army faction holds this book
NonParticipantFactionEffectBundleCcoEffectBundleVoidReturns the effect bundle applied when a faction that cannot interact with the feature holds this book

CcoBooksOfNagashFactionEffectBundleJunctionRecord

Wrapper for a BOOKS_OF_NAGASH_TO_FACTION_EFFECT_BUNDLE_JUNCTION_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoBooksOfNagashFactionEffectBundleJunctionRecord (list)VoidReturns a list of all records from the table
EffectBundleContextCcoEffectBundleVoidReturns the CcoEffectBundle for this bundle
FactionContextCcoCampaignFactionVoidReturns the CcoCampaignFaction for this faction
BookRecordContextCcoBooksOfNagashDetailsRecordVoidReturns the CcoBooksOfNagashDetailsRecord for this book
EffectBundleKeyStringVoidReturns the key of the effect bundle in this record
FactionKeyStringVoidReturns the key of the faction in this record
BookKeyStringVoidReturns the key of the book in this record
KeyStringVoidReturns the key of this record

CcoBuildingChainRecord

Wrapper for a building chain record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PercentageUntilNextCyclicLevelFloatCcoCampaignBuildingSlotHelper function to calculate the percentage of fill, taking the amount of time left until next cyclic building level.
LevelsListCcoBuildingLevelRecord (list)VoidReturns a list with all the levels in this chain.
MaximumLevelIntVoidReturns the maximum level in this chain.
LevelZeroBuildingLevelContextCcoBuildingLevelRecordVoidReturns the context of the first building level in the chain.
BuildingSetContextCcoBuildingSetRecordVoidReturns the context of this chain's set.
InEncyclopediaBoolVoidReturns true if the record can be found in the encyclopedia.
NextBuildingLevelInChainCcoBuildingLevelRecordCcoBuildingLevelRecordReturns the building level that's next in line in the building chain of the one passed in.
TechnologyCategoryStringVoidReturns a string with the building chain category type.
MaximumLevelBuiltInRegionCcoBuildingLevelRecordCcoCampaignSettlementReturns the maximum building level context from this chain that has been built in the region.
KeyStringVoidReturns the key of the record.
MaximumChainColumnIntVoidReturns the maximum number of building levels that share the same level (for branching trees)
BuildingBrowserSlotContextCcoCampaignBuildingSlotContext, CcoCampaignFaction (optional), CcoSlotSetRecord (optional)Returns the slot where this chain is built if that exists. If not, returns the next empty slot available. Returns null if there is no active empty slot.
RecordListCcoBuildingChainRecord (list)VoidReturns a list with all the records in building_chains table.
CyclicBuildingTreeTreeDataContextReturns a cyclical tree structure for buildings that have a lifecycle.
BuildingTreeTreeDataCcoCampaignBuildingSlotReturns a tree structure with all the levels in the chain.
CurrentSlotUpgradeListCcoBuildingLevelRecord (list)CcoCampaignBuildingSlotReturns a list with the upgrades of the slot passed in that are part of this chain.
NameUniStringVoidReturns the localised name of this chain.
OptionalSortOrderIntVoidReturns an int with the sort order of this chain (compared to other chains)
OptionalTierIconStringVoidReturns the optional tier icon defined in the table, or an empty string if this doesn't exist
BuildingSuperchainContextCcoBuildingSuperchainRecordVoidReturns the context of the superchain that this chain is part of.
MinUniqueLevelIntVoidReturns an int with the minimum level that is faction unique. Returns -1 if no such level exists.

CcoBuildingCultureVariantRecord

Record wrapper for a BUILDING_CULTURE_VARIANT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoBuildingCultureVariantRecord (list)VoidReturns a list of all CcoBuildingCultureVariantRecord instances
DisablesBoolVoidReturns true if this record has its disable set
NameKeyStringVoidReturns the name key of this building
BuildingFrameOverrideStringVoidReturns an icon path that can be used to override the building frame for this building
IconStringVoidReturns the icon path to be set for this record
LongDescriptionUniStringVoidReturns a long description of this record
ShortDescriptionUniStringVoidReturns a short description of this record
NameUniStringVoidReturns the display name of this record
FactionRecordContextCcoFactionRecordVoidReturns a CCO of the linked faction to this record
SubcultureRecordContextCcoSubcultureRecordVoidReturns a CCO of the subculture record
CultureRecordContextCcoCultureRecordVoidReturns a CCO of the culture record
BuildingLevelStringVoidReturns the key of the building level
KeyStringVoidReturns the key of the record

CcoBuildingLevelRecord

Record wrapper for a BUILDING_LEVEL_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AgentListCcoAgentSubtypeAgentPair (list)VoidReturns a list with the agents provided by this building level
HasResourceRequirementsBoolVoidReturns true if this building level needs resources to build
BuildingChainRecordContextCcoBuildingChainRecordVoidReturns the context of the building chain record that this level is part of
DevelopmentPointCostIntContextReturns the development point cost of this building level. If passed a settlement or character, it will return the cost depending on any bonus values they might have
IsLockedByLevelBoolContextReturns true if this level is not available due to primary building requirements
TechListCcoTechnologyRecord (list)VoidReturns a list with technologies unlocked by this building
PlayerVariantRecordContextCcoBuildingCultureVariantRecordVoidReturns the culture variant of this building for the player faction
OpenBuildingInfoPanelForRecordVoidExpressionState, CcoCampaignFactionIf the component has a BuildingInfoPanelMouseOver callback, it will initialise this with building info without needing a specific settlement or slot info.
SlaveCapContributionIntVoidReturns the slave constribution for this building
OpenBuildingInfoPanelVoidExpressionState, Context, CcoCampaignBuildingSlot, Bool (optional), CcoCampaignFaction (optional)If the component has a BuildingInfoPanelMouseOver callback, it will initialise this with building info. Otherwise, it opens info panel with building info. If second argument is true, it will only show technology info
SetupTooltipForHordeBuildingVoidExpressionState, CcoCampaignCharacterIf the component has a BuildingInfoPanelMouseOver callback, it will initialise this with building info.
DowngradesToLevelContextCcoBuildingLevelRecordVoidReturns the context of the level it downgrades to
UnitListCcoMainUnitRecord (list)ExpressionState, Context, CcoCampaignFaction (optional)Returns a list with the units provided by this building. Needs passing a settlement or character context in order to check for permissions
IsActiveForBuildingBrowserBoolCcoCampaignBuildingSlotReturns true if this building can be shows as the active state in the building browser
ResourceRecordContextCcoResourceRecordVoidReturns the context of the resource for this building, if any
ShouldShowRestrictionRedirectionButtonBoolCcoCampaignBuildingSlotReturns true if the building is restricted by mission etc and has a redirection path
UpkeepCostIntVoidReturns the upkeep cost for this building level
OnlyInCapitalBoolVoidReturns true if this can only be built in the capital
CreateCostIntContext, CcoCampaignFaction (optional), CcoSlotSetRecord (optional)Returns the cost to create this building. If passed either a settlement or a character, it will return the cost based on any bonus values those might have
ResourceCostContextCcoCampaignResourceTransactionCcoCampaignBuildingSlotReturns the context of the (pooled) resource transaction cost of this building
IsEpisodicRestrictedBoolCcoCampaignBuildingSlotReturns true if the building is restricted by mission etc
IsBuildingForCurrentSlotBoolCcoCampaignBuildingSlotReturns true if this is the building level that is currently built in the passed in slot
CreateTimeIntCcoCampaignBuildingSlotReturns the number of turns it would take to construct this
ShouldShowMouseOverComponentBoolCcoCampaignBuildingSlotReturns true if the mouseover that shows cost/turns should show
CanBuildInCurrentSlotBoolCcoCampaignBuildingSlotReturns true if this building can be built in the slot passed in
MercenaryUnitAndAmountPairListCcoPair (list)VoidReturns a list of pairs with mercenary units and amount provided by this building level, if any
LevelIntVoidReturns the level of this building level
HealthOverrideFloatVoidReturns the health override of this building level
HasEnoughDevelopmentPointsBoolContextReturns true if the settlement/character passed in has enough development points to build this
IsBuiltInProvinceBoolCcoCampaignProvince, Bool (optional)Returns true if this building level, or a building level above this, is built in the passed in province
CharacterTraitListCcoCharacterTraitLevelRecord (list)VoidReturns a list with this building's provided character traits
AdditionalDependentUnitsListCcoMainUnitRecord (list)VoidReturns a list with this building's additional dependent units
GetEpisodicRestrictedRestrictionsRedirectionPathStringVoidReturns the panel path that needs to be opened
IsBuiltInRegionBoolCcoCampaignSettlement, Bool (optional)Returns true if this building level, is built in the specified settlement's region (works for foreign slots too).
CanAffordBoolContext, CcoCampaignFaction (optional), CcoSlotSetRecord (optional)Returns true if the settlement/character passed in can afford to build this
GetEpisodicRestrictedRestrictionsIconStringVoidReturns the image of the icon to be used in the restrictions button
FactionUniqueBoolVoidReturns true if this building is unique in the faction/can only be built once in the faction
CanAffordResourceCostForSlotBoolCcoCampaignBuildingSlotReturns true if we can afford the pooled resource transaction for this slot
IsCurrentConstructionItemForSlotBoolCcoCampaignBuildingSlotReturns true if this level is the one currently in construction in the slot passed in
GetEpisodicRestrictedTooltipUniStringVoidReturns the tooltip for reason this building is episodic restricted
VisibleInUiBoolCcoCampaignBuildingSlotReturns true if visible in ui. If passed true, will take into account that this is a primary level slot(and therefore return false if it't ruin level for that)
IsLockedByAnyTechBoolCcoCampaignFaction (optional)Returns true if it's restricted by any technologies, optional param, if none is provided, it checks the player's faction.
HasLifecycleStateBoolVoidReturns true if this building is part of a lifecycle chain
CanBeDamagedBoolVoidReturns true if this building can be damaged
RequiredTechnologiesListCcoTechnologyRecord (list)VoidReturns a list with the required technologies for this building to become available
DoesBuildingExceedCapBoolCcoCampaignBuildingSlotReturns true if this building exceeds the cap of this type of building in the province
TooltipForCurrentSlotUniStringCcoCampaignBuildingSlotReturns the tooltip for this building, depending if it can build/is in construction etc. Need to pass building slot where this is built.
ShouldShowBuildingLevelInUiForTechnologyBoolVoidReturns true if this building should be shown in ui as a requirement for a technology
UnbranchingUpgradesListCcoBuildingLevelRecord (list)VoidReturns a list with this building's unbranching upgrades (recursively), in ascending order by level
IsRedundantDuplicateBoolCcoCampaignSettlementReturns true if there is already a building of this type in the province, which might not provide any other benefits
EncyclopediaRedirectBuildingStringVoidReturns a string with the encyclopedia redirect link for this building
CanConvertBoolVoidReturns true if this building level can be converted
UpgradesListCcoBuildingLevelRecord (list)VoidReturns a list with this building level's direct upgrades
IsBuiltInSlotBoolCcoCampaignBuildingSlot, Bool (optional)Returns true if this building level is built in the passed in slot, or if any building level above it is built
KeyStringVoidReturns the key of the building level record
IssueCommandForBuildingBrowserVoidCcoCampaignBuildingSlotIssues the appropriate command when clicking on a building (cancel construction if building, build if it can etc)
LifecycleTransitionTimeIntContextReturns the time it will take the previous building to transition to this one. Returns 0 if this level is not part of a cyclic chain
RecordListCcoBuildingLevelRecord (list)VoidReturns a list with all the building level records in the table
IsResourceBuildingBoolVoidReturns true if this building is a resource building(provides resource when built)
BuildingGenericAndActiveContextualEffectsCcoEffect (list)VoidReturns a list with the contextual effects provided by this building
ConstructionItemForCurrentSlotContextCcoCampaignConstructionItemCcoCampaignBuildingSlotReturns the CcoConstructionItem context for this building level, if any. Need to pass in the building slot where this is built.
FoodCostIntVoidReturns the amount of food this building will require to be constructed
EffectListCcoEffect (list)CcoCampaignBuildingSlot (optional)Returns a list with the effects provided by this building
CanPlayerBuildThisBoolVoidReturns true if this building is available to the players faction
ResourceRequirementContextCcoResourceRecordVoidReturns the context of the required resource for this building, if any
PrimarySlotBuildingLevelRequirementIntVoidReturns the level of the primary slot that needs to be built for this level to be available

CcoBuildingSetRecord

Record wrapper for a BUILDING_SET_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MaximumChainBuildingsIntContext, CcoCampaignFaction (optional)Returns the maximum number of buildings in this set. Used for calculating the radius of the list. Can pass a settlement or character (horde) to only use chains available there.
BuildingSuperChainsForSettlementCcoBuildingSuperchainRecord (list)CcoCampaignSettlementReturns a list with all the building superchains for the settlement passed in
BuildingChainsCcoBuildingChainRecord (list)Context, CcoCampaignFaction (optional)Returns a list with all the building chains in the set. Can pass a settlement or character (horde) to get the chains that are only available there
RecordListCcoBuildingSetRecord (list)VoidReturns a list with all building set records from the database
ColourColourVoidReturns a Pixel8888 with the colour of the set
SortOrderIntVoidReturns an int with the sort order
OnscreenDescriptionUniStringVoidReturns the localised description of the building set
AudioSwitchStringVoidReturns the audio switch for the building set
NameUniStringVoidReturns the localised name of the set
IconStringVoidReturns the icon path of the building set
KeyStringVoidReturns the key of the record

CcoBuildingSuperchainRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
ChainsForProvinceListVoidVoid
ChainListVoidVoid

CcoBulletPoint

Context wrapper for a bullet point

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BulletPointTextUniStringVoidReturns the text of the bullet point
BulletPointImagePathStringVoidReturns the image path of the bullet point

CcoCampaignBattlePresetRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
ScreenshotPathVoidVoid
CampaignMapContextVoidVoid
IsUniqueSettlementVoidVoid
TileUpgradeVoidVoid
OnscreenNameVoidVoid
KeyVoidVoid
DescriptionVoidVoid
CoordYVoidVoid
CoordXVoidVoid
BattleTypeVoidVoid

CcoCampaignDecisionChoiceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
IndexVoidVoid
DecisionRecordContextVoidVoid
PayloadCharacterTraitListVoidVoid
LabelVoidVoid
TitleVoidVoid

CcoCampaignDecisionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
DescriptionVoidVoid
TitleVoidVoid
KeyVoidVoid
ImageVoidVoid
ChoiceListVoidVoid

CcoCampaignEffectListRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectListVoidVoid
RecordListVoidVoid
EffectsVoidVoid
KeyVoidVoid

CcoCampaignEffectScopeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DistributorTypeVoidVoid
RecordListVoidVoid
LocalisedTextVoidVoid
KeyVoidVoid

CcoCampaignFactionCheatSheetEntryRecord

Wrapper for a Campaign UI Cheatsheet Item Record. Used for individual entries used in creating cheat sheet layouts

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PriorityIndexIntVoidSpecifies the priority which this item will be listed in the current column. Lower = Higher up the list
DescriptionTextUniStringVoid
HeaderTextUniStringVoid
ImagePathStringVoid
KeyStringVoid

CcoCampaignGroupRecord

Wrapper for a campaign group record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoCampaignGroupRecord (list)VoidReturns list of all CcoCampaignGroupRecord in db
MaxRangeIntVoidReturns the max range specified in a linked numeric range criteria table
MinRangeIntVoidReturns the min range specified in a linked numeric range criteria table
KeyStringVoidReturns unique key for campaign group
EffectBundleContextCcoEffectBundleVoidReturns the CcoEffectBundle linked to the campaign group if one exists

CcoCampaignMapPlayableAreaRecord

Wrapper for CAMPAIGN_MAP_PLAYABLE_AREA_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionTextUniStringVoidReturns localised description of campaign
NameUniStringVoidReturns localised name of campaign
IsValidCampaignBoolVoidReturns true if this campaign is valid for the current build
ShowsInCampaignSelectionBoolVoidReturns true if this campaign can be played via new campaign screen (owns dlc, not defined out for a special build, etc
RadarImagePathStringVoidReturns the radar image for map preview
MoviePathStringVoidReturns movie to use for frontend campaign select screen
FrontendImagePathStringVoidReturns image to use in frontend campaign select screen
CampaignKeyStringVoidReturns key for campaign map
KeyStringVoidReturns unique key of record
OwnershipProductRequirementListCcoOwnershipProductRequirement (list)VoidReturns a list of CcoOwnershipProductRequirement for this campaign
OwnershipProductRecordListCcoOwnershipProductRecord (list)VoidReturns the list of CcoOwnershipProductRecord required to be owned for this campaign
RecordListCcoCampaignMapPlayableAreaRecord (list)VoidReturns list of all CcoCampaignMapPlayableAreaRecord in table
CampaignStartInfoContextCcoCampaignStartInfoVoidReturns CcoCampaignStartInfo used for campaign select screen in frontend (sp, for mp use CcoMpCampaignMap::CampaignStartInfoContext as that includes time of legend info)
SortOrderIntVoidReturns the sort order of the campaign

CcoCampaignMapWindsOfMagicAreaRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoCampaignMapWindsOfMagicAreaRecord (list)Void
PercentageChanceToChangePerRoundFloatVoid
InitialStrengthContextCcoCampaignMapWindsOfMagicStrengthRecordVoid
LocalisedNameUniStringVoid
CampaignStringVoid
KeyStringVoid

CcoCampaignMapWindsOfMagicStrengthRecord

Wrapper for a CAMPAIGN_MAP_WINDS_OF_MAGIC_STRENGTH_RECORD record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PreviewChangedEffectListCcoEffect (list)CcoCampaignFactionProvinceManager, Int (optional)Returns a list of CcoEffect that would change if this strength was set as current. Optionally can pass a level to compare with instead of comparing with current
RecordListCcoCampaignMapWindsOfMagicStrengthRecord (list)VoidReturns a list of CcoEffect with all wom strength records from the database table
EnableStormOfMagicBoolVoidReturns true if this strength enables storm of magic
DurationIntVoidReturns and int the duration of this wom strength level
LevelIntVoidReturns an int with the level of this strengh
FrequencyIntVoidReturns an int with the frequency of this level
EffectListCcoEffect (list)VoidReturns a list of effects applied when this level is active
LocalisedNameUniStringVoidReturns a localised string with the name of the strength
KeyStringVoidReturns a string with the database key of this strength level

CcoCampaignOperationSetRecord

Wrapper for a CAMPAIGN_OPERATION_SET_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoCampaignOperationSetRecord (list)VoidReturns a list of all operation sets in the table
AgentListCcoAgentRecord (list)VoidReturns a list of agents that will get unlocked by the effects in this set
UnitListCcoMainUnitRecord (list)VoidReturns a list of units that will get unlocked by the effects in this set
ArmoryItemListCcoArmoryItemRecord (list)VoidReturns a list of armory items for this set
EffectBundleListCcoEffectBundle (list)VoidReturns a list of effect bundles for this set

CcoCampaignPayloadRecord

Wrapper for a CAMPAIGN_PAYLOAD_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BasicValueComponentsVoidVoid
BasicComponentsVoidVoid
SetSubPayloadsVoidVoid
KeyStringVoid
RandomSubPayloadsVoidVoid
EffectBundlesCcoEffectBundle (list)Void
RecordListCcoCampaignPayloadRecord (list)Void
WindsOfMagicStrengthChangeContextVoidVoid
RegionGroupResourceTransactionsCcoCampaignPayloadRegionGroupResourceTransactionRecord (list)Void
ResourceTransactionsCcoCampaignPayloadResourceTransactionRecord (list)Void
PooledResourceComponentsVoidVoid
WarCoordinationTargetComponentsVoidVoid
UnitComponentsCcoCampaignPayloadUnitComponentRecord (list)Void
CharacterTraitChangeComponentsVoidVoid

CcoCampaignPayloadRegionGroupResourceTransactionRecord

Wrapper for a CAMPAIGN_PAYLOAD_REGION_GROUP_RESOURCE_TRANSACTION_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoCampaignPayloadRegionGroupResourceTransactionRecord (list)VoidReturns a list of all records in this table
RequiredBoolVoidIf true, any choices that trigger this payload will require that the target is able to pay it
RegionGroupIdStringVoidReturns the region group id tied to this record
ResourceTransactionContextCcoResourceCostRecordVoidReturns the CcoResourceCostRecord tied to this record
PayloadContextCcoCampaignPayloadRecordVoidReturns the CcoCampaignPayloadRecord tied to this record

CcoCampaignPayloadResourceTransactionRecord

Wrapper for a CAMPAIGN_PAYLOAD_RESOURCE_TRANSACTION_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DurationIntVoid
ResourceTransactionContextCcoResourceCostRecordVoid
PayloadContextCcoCampaignPayloadRecordVoid
RecordListCcoCampaignPayloadResourceTransactionRecord (list)Void
RequiredBoolVoid
ApplyImmediatelyBoolVoid

CcoCampaignPayloadUiDetailsRecord

Record wrapper for a campaign_payload_ui_details record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoCampaignPayloadUiDetailsRecord (list)VoidReturns a list of all records in the table
SortOrderIntVoidReturns the sort order of the record
StateStringVoidReturns the campaign_payload_ui_states record key for the effect (holding whether it is positive, negative or other
IconStringVoidReturns the icon path for the record
DescriptionWithNoTextTagsUniStringVoidReturns the localised description of the record without applying any text tags to color it
DescriptionUniStringVoidReturns the localised description of the record
KeyStringVoidReturns the key of the record

CcoCampaignPayloadUnitComponentRecord

Wrapper for a CAMPAIGN_PAYLOAD_UNIT_COMPONENT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoCampaignPayloadUnitComponentRecord (list)Void
XpVoidVoid
AmountIntVoid
ComponentTypeVoidVoid
UnitContextCcoMainUnitRecordVoid
PayloadContextCcoCampaignPayloadRecordVoid

CcoCampaignStormTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
RespectExcludedRegionsTableVoidVoid
CanSpawnOverCharacterVoidVoid
ForSeaVoidVoid
ForLandVoidVoid
CanMoveVoidVoid
CanDecayVoidVoid
KeyVoidVoid

CcoCampaignStreakEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OnScreenNameVoidVoid
RecordListVoidVoid
MinVoidVoid
MaxVoidVoid
KeyVoidVoid
CampaignStreakKeyVoidVoid
EffectUnfilteredListVoidVoid
EffectListVoidVoid

CcoCampaignStreakRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
MinVoidVoid
ResetTurnsVoidVoid
MaxVoidVoid
TypeVoidVoid
KeyVoidVoid
StreakEffectListVoidVoid

CcoCampaignVideoRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ScriptedValueRegistryKeyStringVoidReturns the scripted value registry key of the video (used for unlocking videos)
StillPathStringVoidReturns the still/thumbnail path for the video
LocalisedTitleUniStringVoidReturns the video's localised title
VideoRecordContextCcoVideoRecordVoidReturns the CcoVideoRecord associated with the video

CcoCapturePointCategoryTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
IconPathVoidVoid
LocalisedNameVoidVoid

CcoCapturePointTypeRecord

A DB record wrapper for a battle capture point type

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoCapturePointTypeRecord (list)Void
VisibilitySpottingRangeFloatVoidGets the spotting range (in metres) that the capture point can be spotted
OnscreenNameUniStringVoidReturns a localised UniString that should be the displayed name for this capture point type
KeyStringVoidReturns the DB primary key for this capture point type
IconNameStringVoidReturns a string path of this capture point types' icon

CcoCaravanContractRecord

Wrapper for a CARAVAN_CONTRACT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoCaravanContractRecord (list)VoidReturns a list of all contract in the db
IrrevocableBoolVoidReturns true if the contract cannot be revoked
CargoToResourceBoughtRateFloatVoidReturns a float with the rate at which the cargo is bought
CargoToResourceSoldRateFloatVoidReturns a float with the rate at which the cargo is sold
ResourceSoldContextCcoCampaignPooledResourceCcoCampaignFaction (optional)Returns a CcoCampaignPooledResource with the resource sold context. Tries to get resource from faction then from faction capital
ResourceBoughtContextCcoCampaignPooledResourceCcoCampaignFaction (optional)Returns a CcoCampaignPooledResource with the resource bought context. Tries to get resource from faction then from faction capital
KeyStringVoidReturns the key of the record

CcoCdirEventsCategoryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TypeVoidVoid
OnScreenNameVoidVoid
CategoryKeyVoidVoid
RecordListVoidVoid

CcoCdirEventsDilemmaChoiceDetailRecord

Record wrapper for a CDIR_EVENTS_DILEMMA_CHOICE_DETAIL_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AudioHoverEventStringVoidReturns the event to play when hovering this choice
TextDisplayListCcoCampaignPayloadUiDetailsRecord (list)VoidReturns a list of the text display strings for this payload
EffectBundleListCcoEffectBundle (list)VoidReturns a list with all effect bundles granted by the payload of this choice
TreasuryTransactionListCcoCampaignResourceTransaction (list)VoidReturns a list with all treasury transactions granted by the payload of this choice
ResourceTransactionListCcoCampaignResourceTransaction (list)VoidReturns a list with all pooled resource transactions granted by the payload of this choice
AncillaryListCcoAncillaryRecord (list)VoidReturns a list with all ancillaries granted by the payload of this choice
RecordListCcoCdirEventsDilemmaChoiceDetailRecord (list)VoidReturns a list with all choice records from the database table
TreasureHuntImageListCcoString (list)CcoTreasureHuntExtraInformationRecordReturns a list with all treasure hunt symbols for the this choice, given the treasure hunt info passed in
LocalisedChoiceTitleUniStringVoidReturns a localised title for the choice
LocalisedChoiceLabelUniStringVoidReturns a localised label for the choice
DilemmaKeyStringVoidReturns the key of the dilemma that this choice is part of
ChoiceKeyStringVoidReturns the key of the choice
RecordKeyStringVoidReturns the key of the record

CcoChaoticPlanRecord

Record wrapper for a CHAOTIC_PLAN_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IncreaseDrawTokensPerTurnIntVoidReturns the number of rounds the token is on cooldown
BaseDrawTokensPerTurnIntVoidReturns the number of uses of the token
StartingDrawTokensIntVoidReturns the chance weight of the token
PlanTypeStringVoidReturns a string with the plan type of the token
DescriptionUniStringVoidReturns a string with the description of the token
NameUniStringVoidReturns a string with the icon of the token
BagIconStringVoidReturns a string with the icon of the token
KeyStringVoidReturns a string with the key of the token

CcoChaoticPlanResourceActivatedTokenRecord

Record wrapper for a CHAOTIC_PLAN_RESOURCE_ACTIVATED_TOKEN_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconStringVoidReturns an icon for the resource activated token, but can be empty
HasFillerTokenSetBoolVoidReturns whether there is an associated filler token set configured
ActivationRequirementContextCcoResourceCostRecordVoidReturns the resource cost context of the activation requirement
TokenRecordContextCcoChaoticPlanTokenRecordVoidReturns the main token record context

CcoChaoticPlanSchemersSpecialInfoRecord

Record wrapper for a CHAOTIC_PLAN_SCHEMERS_SPECIAL_INFO_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OrderIntVoidReturns a number with the order of the schemer on the list
DescriptionUniStringVoidReturns a string with the description of the schemer character
RoundIconStringVoidReturns a string with the round icon that is used for this schemer
BigCardIconStringVoidReturns a string with the big card icon that is used for this schemer
StartPosIDStringVoidReturns the unique start pos id for the schemer
CharacterContextCcoCampaignCharacterVoidReturns a Character context for the schemer if it s part of the local player faction

CcoChaoticPlanShopCategoryObjectRecord

Record wrapper for a CHAOTIC_PLAN_SHOP_CATEGORY_OBJECT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OrderInChainIntVoidReturns the order of this category object in its chain
OwnershipLimitIntVoidReturns the limit on the amount of the category object the can be owned
AmountNeededToUnlockIntVoidReturns the amount of other objects from the same category, needed to unlock the category object
QuantityIntVoidReturns the quantity received of the category object
NextOrderObjectContextCcoChaoticPlanShopCategoryObjectRecordVoidReturns the next order object in the same chain, if such exists
PreviousOrderObjectContextCcoChaoticPlanShopCategoryObjectRecordVoidReturns the previous order object in the same chain, if such exists
CostRecordContextCcoResourceCostRecordVoidReturns the resource cost record context associated with the category object
TokenRecordContextCcoChaoticPlanTokenRecordVoidReturns the token record context associated with the category object
KeyStringVoidReturns a string with the key of the category object

CcoChaoticPlanShopCategoryRecord

Record wrapper for a CHAOTIC_PLAN_SHOP_CATEGORY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OrderIntVoidReturns the order from the schemer special infos table for the schemer that owns this category. Thanquol's category is always last.
LargeIconStringVoidReturns a string with the large icon of the category
IconStringVoidReturns a string with the icon of the category
DescriptionUniStringVoidReturns a string with the description of the category
NameUniStringVoidReturns a string with the icon of the category
KeyStringVoidReturns a string with the key of the category
HasStartPosCharacterAssociatedBoolVoidReturns true if this category is associated with a specific Start Pos Character
CharacterContextCcoCampaignCharacterVoidReturns a Character context for the schemer if it s part of the local player faction

CcoChaoticPlanTokenRecord

Record wrapper for a CHAOTIC_PLAN_TOKEN_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AllPayloadInfoEntryContextsOutsidePlanCcoCampaignPayloadInfoEntry (list)VoidReturns all the payload info entry contexts from all payloads associated with this token
AllPayloadInfoEntryContextsCcoCampaignPayloadInfoEntry (list)CcoCampaignChaoticPlanReturns all the payload info entry contexts from all payloads associated with this token passing a CcoChaoticPlan
FilteredPayloadInfoContextsCcoCampaignPayloadInfo (list)CcoCampaignFactionReturns the payload info contexts associated with this token after running through a custom filter
PayloadInfoContextsCcoCampaignPayloadInfo (list)CcoCampaignChaoticPlanReturns the payload info contexts associated with this token
ResourceActivatedTokenRecordContextCcoChaoticPlanResourceActivatedTokenRecordVoidReturns the context of the resource activated token record details, if it exists for this token
TokenTypeRecordContextCcoChaoticPlanTokenTypeRecordVoidReturns the context of the type for this token
TierIntVoidReturns the tier of the token
RemovedPoolTokensCcoChaoticPlanTokenRecord (list)VoidReturns a list of removed pool tokens for this token.
BagPriceRecordContextCcoResourceCostRecordVoidReturns the price to put the token in the bag
RoundsCoolDownBeforeUseIntVoidReturns the number of rounds the token is on cooldown
GeneratedPoolTokensCcoChaoticPlanTokenRecord (list)VoidReturns a list of generated pool tokens for this token.
NumberOfUsesIntVoidReturns the number of uses of the token
HowToUseDescriptionUniStringVoidReturns a localized string with the how to use description of the token to be used in the abilities and other tokens that can be used.
WeightIntVoidReturns the chance weight of the token
SpecialDescriptionUniStringVoidReturns a localized string with the special description of the token to be used in the lore panel.
DescriptionUniStringVoidReturns a string with the description of the token
MaximumCopiesDrawnAllowedIntVoidReturns the max amount of drawn copies of this token we can have in a plan.
IconStringVoidReturns a string with the icon of the token
ModNegativeDrawPctIntVoidReturns the pct that this token modifies the total negative draw token pct of the plan with.
KeyStringVoidReturns a string with the key of the token.
NameUniStringVoidReturns a unistring with the localized name of the token
UnitsFromPayloadsCcoMainUnitRecord (list)VoidReturns all units added from payloads on this token.
FilteredlPayloadInfoEntryContextsCcoCampaignPayloadInfoEntry (list)CcoCampaignFactionReturns the filtered payload info entry contexts from all payloads associated with this token

CcoChaoticPlanTokenTypeRecord

Record wrapper for a CHAOTIC_PLAN_TOKEN_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TokenTypeKeyStringVoidReturns a string with the key of the token type
DescriptionUniStringVoidReturns a string with the description of the token type
IconStringVoidReturns a string with the icon of the token type
NameUniStringVoidReturns a string with the key of the token type

CcoCharacterAncillaryQuestUiDetailRecord

Record wrapper for character ancillary quest details

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AncillaryContextCcoAncillaryRecordVoidReturns the context of the ancillary of this junction
AgentSubtypeContextCcoAgentSubtypeRecordVoidReturns the context of the agent subtype of this junction
RecordListCcoCharacterAncillaryQuestUiDetailRecord (list)VoidReturns a list of all character ancillary quest details from the table
IsQuestBattleBoolVoidReturns true if the ancillary will be awarded after a quest battle
InstantBoolVoidReturns true if the ancillary is instantly awarded without a quest or mission
RankIntVoidReturns the rank at which the ancillary quest gets unlocked for the agent subtype

CcoCharacterSkillRecord

Wrapper for a character skill record.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectListForLevelCcoEffect (list)IntReturns a list of CcoEffect with all default effects for the level passed in
RecordListCcoCharacterSkillRecord (list)VoidReturns a list with all skills in the database
IsMaleOnlyBackgroundSkillBoolVoidReturns true if this is a male only background skill
IsFemaleOnlyBackgroundSkillBoolVoidReturns true if this is a female only background skill
IsBackgroundSkillBoolVoidReturns true if this is a background skill
UnlockedAtRankIntVoidReturns an int with the rank at which this skill unlocks
DefaultLocalisedNameUniStringVoidReturns the default localised name of the skill
DefaultLocalisedDescriptionUniStringVoidReturns the default localised description of the skill
DefaultImagePathStringVoidReturns the default image path of the skill
KeyStringVoidReturns the key of the record

CcoCharacterTrainingDilemmaChoiceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
RecordListVoidVoid
IndexVoidVoid
ChoiceEffectRecordVoidVoid
DilemmaRecordContextVoidVoid
LocalisedLabelVoidVoid

CcoCharacterTrainingDilemmaRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
TrainingEffectTypeVoidVoid
KeyVoidVoid
ChoiceListVoidVoid
LocalisedDescriptionVoidVoid
LocalisedTitleVoidVoid

CcoCharacterTraitLevelRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NameVoidVoid
LevelVoidVoid
TraitKeyVoidVoid
KeyVoidVoid
RecordListVoidVoid
BonusValuesVoidVoid
EffectUnfilteredListVoidVoid
EffectListVoidVoid
EffectTextVoidVoid
LoseLevelDescriptionVoidVoid
ExplanationDescriptionVoidVoid
FlavourDescriptionVoidVoid
TraitRecordContextVoidVoid
ThresholdPointsVoidVoid

CcoCharacterTraitRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconPathVoidVoid
PrecedenceVoidVoid
HasMultipleLevelsVoidVoid
HiddenVoidVoid
NoGoingBackLevelVoidVoid
KeyVoidVoid
RecordListVoidVoid
AllTraitsListVoidVoid
AntitraitsListVoidVoid
TraitLevelsListVoidVoid
ExcludedCulturesListVoidVoid
IncludedAgentsListVoidVoid
PreBattleSpeechParameterVoidVoid

CcoClimateRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid

CcoCookingIngredientGroupRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FlavourTextVoidVoid
RecordListVoidVoid
ColourVoidVoid
IngredientsVoidVoid
KeyVoidVoid
IconVoidVoid
DisplayNameVoidVoid

CcoCookingIngredientRecord

Record wrapper for a COOKING_INGREDIENT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoCookingIngredientRecord (list)VoidReturns a list of all ingredients in the db
GroupContextCcoCookingIngredientGroupRecordVoidReturns a CcoCookingIngredientGroupRecord with the group the ingredient is part of
AlliedUnitEffectsContextCcoCampaignEffectListRecordVoidReturns a CcoCampaignEffectListRecord with the allied unit effect list of this ingredient
EnemyUnitEffectsContextCcoCampaignEffectListRecordVoidReturns a CcoCampaignEffectListRecord with the enemy unit effect list of this ingredient
FactionLeaderEffectsContextCcoCampaignEffectListRecordVoidReturns a CcoCampaignEffectListRecord with the faction leader effect list context
FactionEffectsContextCcoCampaignEffectListRecordVoidReturns a CcoCampaignEffectListRecord with the faction effect list context
IngredientVOTriggerIntVoidReturns an int with the VO enum type
IndexIntVoidReturns the index of the db record
DisplayUnlockTextUniStringVoidReturns a localised string with the text displaying how to unlock the ingredient
FlavourTextUniStringVoidReturns a localised string with the flavour text/description of the ingredient
DisplayTextUniStringVoidReturns a localised string with the display text/name of the ingredient
IconStringVoidReturns a string with the icon path of the ingredient
KeyStringVoidReturns a string with the key of the ingredient

CcoCookingRecipeRecord

Record wrapper for a COOKING_RECIPE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FlavourTextUniStringVoidReturns a localised string with the flavour text/description of the recipe
DisplayTextUniStringVoidReturns a localised string with the display text/name of the recipe
IconStringVoidReturns a string with the icon of the recipe
IsRequiredIngredientBoolCcoCookingIngredientRecordReturns true if the passed in ingredient is part of the required ingredients for this recipe
KeyStringVoidReturns a string with the key of the record
RecordListCcoCookingRecipeRecord (list)VoidReturns a list of all recipes from the db
RecipeUpgradeCostCcoResourceCostRecordVoidReturns a CcoResourceCostRecord of the cost to upgrade this recipe, if it exists
RecipeUpgradeCcoCookingRecipeRecordVoidReturns a CcoCookingRecipeRecord of the upgrade of this recipe, if it exists
AlliedUnitEffectsContextCcoCampaignEffectListRecordVoidReturns a CcoCampaignEffectListRecord with the allied unit effect list of this recipe
EnemyUnitEffectsContextCcoCampaignEffectListRecordVoidReturns a CcoCampaignEffectListRecord with the enemy unit effect list of this recipe
FactionLeaderEffectsContextCcoCampaignEffectListRecordVoidReturns a CcoCampaignEffectListRecord with the faction leader effect list of this recipe
FactionEffectsContextCcoCampaignEffectListRecordVoidReturns a CcoCampaignEffectListRecord with the faction effect list of this recipe
ResourceCostContextCcoResourceCostRecordVoidReturns a CcoResourceCostRecord with the cost of this recipe
RequiresSpecificIngredientBoolVoidReturns true if this recipe requires a specific ingredient
LevelIntVoidReturns the recipe's level. A record must exist for this recipe in cooking_recipe_chains table, otherwise 1 will be returned.
AmountOfCooksIntVoidReturns how many dishes the recipe will cook
CookingRecipieVOIntVoidReturns an int with the VO type
DurationIntVoidReturns an int with the duration of the recipe
IndexIntVoidReturns an int with the db index of this recipe

CcoCorruptionCounterIntervalRecord

Wrapper for a CORRUPTION_COUNTER_INTERVAL_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LowerBoundIntVoidReturns the lower bound of the interval
KeyStringVoidReturns the key of the record
RecordListCcoCorruptionCounterIntervalRecord (list)VoidReturns a list of all intervals in the table
SegmentPercentageFloatIntReturns what percentage this interval takes out of a max value passed in
UpperBoundIntVoidReturns the upper bound of the interval

CcoCorruptionTypeRecord

Wrapper for a CORRUPTION_TYPE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CorruptionColourColourVoidReturn the colour of the corruption record
IconPathString (list)VoidReturn the optional icon path for the corruption type
RecordListCcoCorruptionTypeRecord (list)VoidReturns list of all corruption types in the db
NameUniStringVoidReturn the localised name for the corruption type for display in the UI
BattleTileUpgradeStringStringVoidReturn the tile upgrade name that gets applied as tile upgrade to battle when corruption active
KeyStringVoidReturn the unique key for the record

CcoCultureRecord

Wrapper for a culture record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoCultureRecord (list)Void
UiBackgroundImageStringVoid
IsOgreKingdomsBoolVoid
NameUniStringVoid
IsNurgleBoolVoid
IsLizardBoolVoid
FallbackStringVoid
IsKhorneBoolVoid
IndexVoidVoidNot Implemented
IsGreenskinsBoolVoid
KeyStringVoid
IsDaemonBoolVoid
GroupByCultureBoolVoid
FrontendDescriptionUniStringVoid
QuestBattleGroupListCcoBattleSetPieceFrontendGroupRecord (list)Void
GroupedUnitListCcoGroupList (list)Bool (optional)
UnitListCcoUnitsCustomBattlePermissionRecord (list)Void
StripLargeImagePathStringVoid
StripImagePathStringVoid
IsHighElfBoolVoid
FramePathStringVoid
IsTzeentchBoolVoid
LargeImagePathStringVoid
IsSlaaneshBoolVoid
ImagePathStringVoid
IsSkavenBoolVoid

CcoCultureSettlementOccupationOptionRecord

Record wrapper for a culture_settlement_occupation_option record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SortOrderOverrideIntVoidReturns the optional override sort order to be used instead of the one in settlement_occupation_options table if not set to -1
ActingArmyFactionEffectBundleCcoEffectBundleVoidReturns the CcoEffectBundle applied to the acting army's faction on occupation
OccupationNameUniStringVoidReturns the localised name, which is the first part of the tooltip text for this record
TooltipUniStringVoidReturns the localised button text and tooltip for this record
AudioOverrideKeyStringVoidReturns the key for the audio_campaign_post_battle_sounds record specified for this occupation option
IconStringVoidReturns the icon path for this record
KeyStringVoidReturns the key of the record

CcoCultureSettlementOccupationOptionsGroupRecord

Record wrapper for a culture_settlement_occupation_options_group record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CustomComponentIdStringVoidReturns the id for a custom component to be used for choosing the occupation option instead of a separate panel
CustomPanelLayoutPathStringVoidReturns the layout path to a custom panel to use for choosing the occupation option
OccupationOptionTemplateButtonIdStringVoidReturns the id of the template button used for the occupation option in the settlement captured panel
KeyStringVoidReturns the key of the record
DisplayLootWhenNoOptionSelectedBoolVoidReturns whether to display the rewards/loot from the occupation option before a choice has been made; useful when each entry from the group has the same rewards/loot
OccupationEntryImageIndexIntVoidReturns the image index for the occupation entry template component; defaults to 0
EditChoiceButtonIdStringVoidReturns the id for the component to allow editing of the chosen occupation entry for this group after one has already been selected
ShowChoicesButtonIdStringVoidReturns the id for the component to open the custom panel or show the custom component for this group
OccupationEntryTemplateIdStringVoidReturns the id for the template component to spawn for each entry inside the custom component or custom panel

CcoCustomBattleCorruptionType

Wrapper for the corruption type setting in custom battle

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordContextCcoCorruptionTypeRecordVoidReturns the record context (which can be null)
NameUniStringVoidReturns the localised name for the corruption type to display in the UI

CcoCustomBattleFactionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CultureSortOrderVoidVoid
SortOrderVoidVoid
FactionContextVoidVoid

CcoCustomBattleSettingRecord

Wrapper for a CUSTOM_BATTLE_SETTING_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoCustomBattleSettingRecord (list)VoidReturns a list with all custom battle settings in the db
ValueFloatVoidReturns the value of the custom battle setting
KeyStringVoidReturns the key of the custom battle setting
NameUniStringVoidReturns the name of the custom battle setting

CcoDaemonAbilityBarDescriptionRecord

wrapper for a DAEMON_ABILITY_BAR_DESCRIPTION_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyStringVoidReturns the record's key
RecordListCcoDaemonAbilityBarDescriptionRecord (list)VoidReturns a list of all Daemon ability bar description records
ContainsFactionBoolCcoFactionRecordReturns true if the faction set of this record contains the passed in faction
DescriptionUniStringVoidReturns the record's description
TitleUniStringVoidReturns the record's title

CcoDeployableRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CustomBattleEnabledVoidVoid
DescriptionVoidVoid
TooltipVoidVoid
IgnitionThresholdVoidVoid
CanAttackVoidVoid
RecruitmentCapVoidVoid
DamageValueVoidVoid
NameVoidVoid
IconNameVoidVoid
HitpointsVoidVoid
KeyVoidVoid

CcoDeployablesCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
ProbabilityVoidVoid
CapVoidVoid
DeployableContextVoidVoid

CcoDilemmaRecord

Record wrapper for a DILEMMA_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoDilemmaRecord (list)VoidReturns a list with all dilemma records in the database
ChoiceListCcoCdirEventsDilemmaChoiceDetailRecord (list)VoidReturns a list of CcoCdirEventsDilemmaChoiceDetailRecord with the choices of this dilemma
EventCategoryContextCcoCdirEventsCategoryRecordVoidReturns a CcoCdirEventsCategoryRecord with the event category context
PrioritizedBoolVoidReturns true if this dilemma should be prioritized
GenerateBoolVoidReturns true if should generate the dilemma
LocalisedTitleUniStringVoidReturns the localised title of the dilemma
LocalisedDescriptionUniStringVoidReturns the localised description of the dilemma
SoundClickOverrideStringVoidReturns the sound click override string, if any
SoundPopupOverrideStringVoidReturns the sound popup override string, if any
UiImageStringVoidReturns the ui image of the dilemma
KeyStringVoidReturns the db key of the dilemma

CcoDiplomaticStanceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
StatusStateVoidVoid
RecordListVoidVoid
StanceVoidVoid
OnscreenTextVoidVoid

CcoElectorCountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
UnitRewardContextVoidVoid
AncillaryRewardContextVoidVoid
MapPosVoidVoid
MapPosYVoidVoid
MapPosXVoidVoid
MinisterialPositionEffectBundleVoidVoid
CapitalRegionContextVoidVoid

CcoEndTurnNotificationRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DisplayTextVoidVoid
IconVoidVoid
RecordListVoidVoid
IsRelevantToPlayersFactionVoidVoid
CanBeSuppressedByPlayerVoidVoid
DetailedDescriptionVoidVoid
TitleVoidVoid
BlockingVoidVoid
EnabledByDefaultVoidVoid
IdVoidVoid

CcoEventFeedCategoryRecord

Record wrapper for an event feed category record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoEventFeedCategoryRecord (list)VoidReturns a list of all CcoEventFeedCategoryRecord in the database
NameUniStringVoidReturns a string from the category enum
KeyStringVoidReturns the key of the record

CcoFactionRecord

Wrapper for a faction record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BannerSecondaryColourColourVoidReturns the faction's banner secondary colour
SubcultureContextCcoSubcultureRecordVoidReturns the faction's subculture context
BannerPrimaryColourColourVoidReturns the faction's banner primary colour
FactionSpecificAscendancyEffectListCcoEffect (list)VoidReturns the effects provided to this faction by all storm of magic ascendancy lores
PrimaryColourColourVoidReturns the faction's primary colour
MechanicListCcoEffect (list)VoidReturns the faction's mechanics as a list of CcoEffects
KeyStringVoidReturns the key of this faction record
ClimatesListCcoSettlementClimateTypeRecord (list)String, StringReturns the list of CcoSettlementClimateTypeRecord with the climate list for this faction
OwnershipProductRequirementListExcludingCcoOwnershipProductRequirement (list)ContextListReturns the list of CcoOwnershipProductRequirement required to be owned for this faction, if it came in a DLC, but excluding the passed in requirements
RecordListCcoFactionRecord (list)VoidReturns a list of all CcoFactionRecords
OwnershipProductRecordListCcoOwnershipProductRecord (list)VoidReturns the list of CcoOwnershipProductRecord required to be owned for this faction, if it came in a DLC
TextReplacementKeysString (list)VoidReturns the list of text replacement keys for this faction in order evaluated. Used to "skin" text using the ui_text_replacements table
FlagDirStringVoidReturns flag directory for this faction
FlagPathRotatedStringVoidReturns the path to the rotated version of the faction's flag
FlagPathLargeStringVoidReturns the path to the large version of the faction's flag
IsUnitPossibleToRecruitBoolCcoMainUnitRecordReturns true if the faction is allowed by the data setup to recruit this unit
FlagPathMediumStringVoidReturns the path to the medium version of the factio'n flag
MarkAsHasSeenContentVoidVoidMarks this faction as seen content
FlagPathSmallStringVoidReturns the path to the small version of the faction's flag
NameWithIconUniStringVoidReturns the faction's name along with a small icon of their flag
OwnershipProductRequirementListCcoOwnershipProductRequirement (list)VoidReturns the list of CcoOwnershipProductRequirement required to be owned for this faction, if it came in a DLC
NameUniStringVoidReturns the faction's localised name
HasSeenContentBoolVoidReturns true if the faction hasn't been seen by the player yet
IsFactionUnlockedBoolVoidReturns if the faction is unlocked
AudioVoiceoverCultureIntVoidReturns the faction audio voiceover culture
FactionSkinStringVoidReturns faction's skin
BannerTertiaryColourColourVoidReturns the faction's banner tertiary colour

CcoFactionSetRecord

Wrapper for a FACTION_SET_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoFactionSetRecord (list)VoidReturns a list with all faction sets in the database
ContainsFactionBoolCcoFactionRecordReturns true if the set contains the passed in faction record
NameUniStringVoidReturns the name of the faction set
KeyStringVoidReturns the key of the faction set

CcoFormationRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OrderVoidVoid
TooltipVoidVoid
NameVoidVoid
IsNavalVoidVoid
IsArmyVoidVoid
IconNameVoidVoid
FormationVoidVoid
DescriptionVoidVoid
RecordListVoidVoid

CcoFrontendFactionLeaderRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ActionPointsTextVoidVoid
DescriptionTextVoidVoid
ImagePathVoidVoid
KeyVoidVoid
RecordListVoidVoid
HasAccessToCampaignTypeVoidVoid
VoiceoverVoidVoid
FrontendDescriptionVoidVoid
StartPosDescriptionVoidVoid
StartPosMapVoidVoid
DifficultyLocalisedVoidVoid
DifficultyVoidVoid
SkillEffectListVoidVoid
MoviePathVoidVoid
NameVoidVoid
LoadingScreenImagePathVoidVoid
LoadingScreenTextVoidVoid

CcoGroundTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ColourRedVoidVoid
DescriptionVoidVoid
OnscreenNameVoidVoid
BurnRateVoidVoid
KeyVoidVoid
IgnorePenaltiesAttributeVoidVoid
RecordListVoidVoid
IconPathVoidVoid
EffectsForSelectionListVoidVoid
MinimumThresholdVoidVoid
ColourBlueVoidVoid
ColourGreenVoidVoid

CcoGroundTypeToStatEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
EffectTextWithValueVoidVoid
EffectTextVoidVoid
IsPositiveVoidVoid
AffectedGroupNameVoidVoid
ValueForDisplayVoidVoid
ValueVoidVoid
GroundTypeVoidVoid

CcoGroupPooledResourceEffectRecord

Wrapper for a campaign group pooled resource effect, which provides an effect bundle when the pooled resource is between the lower and upper bounds

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LowerBoundIntVoidReturns an int with the lower bound of this group
KeyStringVoidReturns the key of the record
IconStringVoidReturns the (optional) custom icon path
RecordListCcoGroupPooledResourceEffectRecord (list)VoidReturns a list with all group pooled resource effects from the table
EffectBundleCcoEffectBundleVoidReturns the effect bundle that is provided by this group when the pooled resource is between the lower and upper bounds
UpperBoundIntVoidReturns an int with the upper bound of this group

CcoIncidentRecord

Wrapper for an incident record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PrioritisedBoolVoidReturns true if this incident is prioritised
CampaignVOActorGroupIntVoidReturns the incident's campaign voice over actor group
CampaignVODelayFloatVoidReturns the incident's campaign voice over delay
SepiaFadeMultiplierFloatVoidReturns the incident's sepia fade multiplier
MoviePathStringVoidReturns the incident's movie path pointed to the correct EventPic movie folder
ImagePathStringVoidReturns the incident's image path pointed to the correct EventPic image folder
CampaignVOEventNameStringVoidReturns the incident's campaign voice over event name
IsLargeIncidentBoolVoidReturns if the incident is a large incident
AdditionalSoundEventStringVoidReturns the incident's additional sound event
ImageStringVoidReturns the ui image of this incident record
KeyStringVoidReturns the key of this incident record
ButtonTextUniStringVoidReturns the incident's localised button text
DescriptionUniStringVoidReturns the incident's localised description
TitleUniStringVoidReturns the incident's localised title
EventCategoryCcoCdirEventsCategoryRecordVoidReturns the event category of this incident if it has one assigned to it
RecordListCcoIncidentRecord (list)VoidReturns a list of all CcoIncidentRecord
UseRevealingTextBoolVoidReturns true if this incidents uses revealing text
HasSepiaFadeBoolVoidReturns if the incident has a sepia fade

CcoInitiativeRecord

Record wrapper for a INITIATIVE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MatchesQueryBoolUniStringReturns true if the initiative name or its effects (partially) match the query text given
ForceMeetsUnitRequirementsBoolCcoCampaignMilitaryForceReturns a flag whether all the unit requirements have been met for a force
SortOrderIntVoidReturns the sort order of the record for the UI
PercentageRequirementFulfilledFloatCcoCampaignMilitaryForceReturns the progress of the completion in percentage
TotalNumberOfRequirementsMetForForceIntCcoCampaignMilitaryForceReturns the number of unit requirements met for a millitary force
EffectListCcoEffect (list)VoidReturns a list of the effects with priority higher than 0, that are provided when active
TotalCountOfRequiredUnitsIntVoidReturns the total count of required units
DurationIntVoidReturns the duration of the initiative
SwapResourceTransactionContextsCcoCampaignResourceTransaction (list)VoidReturns a list of all valid scoped transactions for the swap cost.
UnitRequirementsCcoInitiativeUnitSetRequirementsRecord (list)VoidReturns a list of all requrement records CCOs for this initiative
CooldownForPayloadIntCcoCampaignPayloadRecordReturns the cooldown of the paylaod
RequiredUnitsCcoMainUnitRecord (list)VoidReturns a list of all required units for this initiative
CooldownIntVoidReturns the cooldown for the initiative from the database record
RecordListCcoInitiativeRecord (list)VoidReturns a list of all initiatives from the database
DescriptionUniStringVoidReturns the localised description of the initiative
NameUniStringVoidReturns the localised name of the initiative
LinkedAgentSubtypeListCcoAgentSubtypeRecord (list)VoidReturns a list of agent subtypes that are linked to this initiative
ImagePathStringVoidReturns the image path of the initiative
PayloadRecordListCcoCampaignPayloadRecord (list)VoidReturns a list of payloads for the initiative
KeyStringVoidReturns the key of the initiative
EffectUnfilteredListCcoEffect (list)VoidReturns a list of all the effects provided when active
UpkeepResourceTransactionContextCcoCampaignResourceTransactionVoidReturns the upkeep of the resources used while the initiative is active
RequiredResourceTransactionContextCcoCampaignResourceTransactionVoidReturns the resources required to activate the initiative
ExpendedResourceTransactionContextCcoCampaignResourceTransactionVoidReturns the resources that will be spent to activate the initiative

CcoInitiativeSetCategoryRecord

Wrapper for a INITIATIVE_SET_CATEGORY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconStringVoidThe icon of the initiative set category.
KeyStringVoidThe key of the initiative set category.
DescriptionUniStringVoidThe description of the initiative set category.
DisplayNameUniStringVoidThe display name of the initiative set category.
RecordListCcoInitiativeSetCategoryRecord (list)VoidReturns a list of all initiative set category records.

CcoInitiativeSetRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SortOrderVoidVoid
DescriptionVoidVoid
NameVoidVoid
RecordListVoidVoid
CategoryContextVoidVoid
ActivationCooldownVoidVoid
ActiveInitiativeLimitVoidVoid
ItemsVoidVoid
KeyVoidVoid

CcoInitiativeUnitSetRequirementsRecord

Record wrapper for a INITIATIVE_UNIT_SET_REQUIREMENT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NumberOfRequirementsMetForForceIntCcoCampaignMilitaryForceReturns the number of requirements met for a particular force
RequiredNumberIntVoidReturns the number of required units to fulfill this requirement
IconPathStringVoidReturns the path to an optional icon representing this requirement
RequiredUnitsCcoMainUnitRecord (list)VoidReturns a list of main unic records of the unit set
UnitSetContextCcoUnitSetRecordVoidReturns the CCO of the unit set record this requirement is linked to
InitiativeContextCcoInitiativeRecordVoidReturns the CCO of the initiative record this requirement is linked to
DisplayNameUniStringVoidReturns localised display name, or empty if it has none
ForceMeetsUnitRequirementsBoolCcoCampaignMilitaryForceReturns the flag whether the requirements are met for this requirement CCO

CcoLabSettingRecord

Wrapper for a LAB_SETTING_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DefaultValueFloatVoid
StepSizeFloatVoid
MinValueFloatVoid
MaxValueFloatVoid
SortOrderIntVoid
LocalisedTooltipUniStringVoid
LocalisedNameUniStringVoid
VideoPathStringVoid
ComparisonImagePathStringVoid
ImagePathStringVoid
KeyStringVoid
RecordListCcoLabSettingRecord (list)Void
IsWindsOfMagicSettingBoolVoid
DisplayAsPercentageBoolVoid

CcoLandUnitArticulatedVehicleRecord

Wrapper for a LAND_UNIT_ARTICULATED_VEHICLE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ArticulationNode3RadiusFloatVoid
ArticulationNode3OffsetFloatVoid
ArticulationNode2RadiusFloatVoid
ArticulationNode2OffsetFloatVoid
ArticulationNode1RadiusFloatVoid
ArticulationNode1OffsetFloatVoid
KeyStringVoid
ArticulatedEntityContextCcoBattleEntityRecordVoid
GunMountEntityContextCcoBattleEntityRecordVoid
AmmoCaissionKeyStringVoid
AmmoCaissonEntityContextCcoBattleEntityRecordVoid
AmmoCaissonDestroyedModelStringVoid
RecordListCcoLandUnitArticulatedVehicleRecord (list)Void
HeadOffsetFloatVoid
ArticulationMaxAngleFloatVoid

CcoLandUnitsToExtraEngineRecord

Wrapper for a LAND_UNITS_TO_EXTRA_ENGINE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoLandUnitsToExtraEngineRecord (list)Void
AttachArticulationIntVoid
BattleEngineContextCcoBattlefieldEngineRecordVoid
LandUnitContextCcoUnitLandRecordVoid

CcoLoadingScreenQuotesRecord

Record wrapper for a loading screen quote record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsOfCharacterQuoteCategoryBoolVoidReturns if the quote category is of character quote
HasNoImageBoolVoidReturns if the image path is empty
HasPortraitImageBoolVoidReturns if the image path points to a portrait image
HasUnitImageBoolVoidReturns if the image path points to a unit image
CharacterQuoteTextUniStringVoidReturns the character quote text of the loading screen quote
DescriptionUniStringVoidReturns the long description of the loading screen quote
ImagePathStringVoidReturns the image path of the loading screen quote
TitleUniStringVoidReturns the title of the loading screen quote
KeyStringVoidReturns the key of the record
RecordListCcoLoadingScreenQuotesRecord (list)VoidReturns a list with all loading screen quotes in the table
BulletPointListCcoBulletPoint (list)VoidReturns the bullet points of the loading screen quote

CcoMainUnitRecord

Wrapper for a main unit

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsTrainBoolVoidReturns whether this unit is a train unit
CategoryParentIconStringVoidReturns the name of the parent category's icon
SpecialCategoryKeyStringVoidReturns the key of the special category of the unit (default if none)
CategoryTooltipUniStringVoidReturns the tooltip text for the category of the unit
TrainCarriageCompositionListCcoMainUnitRecord (list)VoidReturns a list of CcoMainUnitRecords with the records that the unit is composed of, i.e. carriges for a train
IsOwnedBoolVoidReturns whether this unit is owned by the player
CategoryNameUniStringVoidReturns the category name of the unit
UpgradedUnitDetailsContextCcoUnitDetailsCcoCampaignUnit, Int (optional)Returns a context to the unit details the provided unit would have if upgraded to this unit record
OwnershipProductRequirementListCcoOwnershipProductRequirement (list)VoidReturns a list of CcoOwnershipProductRequirement for this unit
RecruitableUnitDetailsContextCcoUnitDetailsVoidReturns a context to the unit details of the unit with predicted values a unit might be recruited with
CategoryIconStringExpressionStateReturns a path to the category icon of the unit
BaseCostIntInt (optional)Returns the base cost to recruit the unit
UnitDetailsContextCcoUnitDetailsVoidReturns a context to the unit details of the unit
IsRecruitmentDisabledBoolCcoCampaignFaction (optional)Returns whether the recruitment is disabled for this unit. Optional pass the faction for which to check, defaults to players faction
DefaultProjectileRecordCcoProjectileRecord (list)VoidReturns a record of the default projectile for the unit (if there is one)
CostIntInt (optional)Returns the cost to recruit the unit
UsesHitpointsInCampaignBoolVoidReturns whether this unit uses hitpoints.
AbilityListCcoUnitAbility (list)VoidReturns a list of abilities for the unit
BuildingUnlockTooltipUniStringVoidReturns a tooltip with the additional requirements to unlock this unit.
IsRenownBoolVoidReturns true if this is a unit of renown
DescriptionUniStringVoidReturns a description of the unit
KeyStringVoidReturns the unit's key
ParentGroupSortOrderIntVoidReturns the sort order of the parent group that this unit record is part of
NameUniStringVoidReturns the name of the unit
ClassNameUniStringVoidReturns the class name for the unit
AdditionalBuildingRequirementContextCcoBuildingLevelRecordVoidReturns the context of the additional building requirement for this unit, if any
IsNavalBoolVoidReturns true if the unit is a naval one
InfoPicPathStringVoidReturns a path to the icon of the unit
UnitSetUnitCapListCcoUnitSetToMpUnitCapRecord (list)VoidReturns list of unit sets to unit caps for the unit
UpkeepIntVoidReturns the upkeep for the unit
IconPathStringVoidReturns a path to the icon of the unit
SpecialAbilityGroupListCcoSpecialAbilityGroupRecord (list)VoidReturns a list of special abilities for the unit
TierIntVoidReturns the tier of the unit
CategoryParentTooltipUniStringVoidReturns the name of the parent category
RecordListCcoMainUnitRecord (list)VoidReturn a context list of all main units
BannerHpIntVoidReturns the banner hitpoints for the unit
ShapeshiftFormContextCcoShapeshiftFormVoidReturns the associated CcoShapeshiftForm if there is one
HistoricalDescriptionUniStringVoidReturns the historical description of the unit
UnitLandRecordContextCcoUnitLandRecordVoidReturns this or the base version of the mount according to unit permissions table
PortholeCameraSettingContextCcoUnitPortholeCameraSettingRecordVoidReturns a context to the unit porthole camera setting for the unit record
DaemonicInfluenceEffectsContextCcoCampaignEffectListRecordCcoCampaignFactionReturns a CcoCampaignEffectListRecord with the faction daemonic influence effect list context
UnmountedUnitRecordContextCcoMainUnitRecordVoidReturns this or the base version of the mount according to unit permissions table
CustomBattlePermissionsContextCcoUnitsCustomBattlePermissionRecordCcoFactionRecord (optional)Returns a context to the battle permissions of the unit
IsVisuallyExcludedFromEffectsBoolVoidReturns whether this unit should be hidden from effect lists by the UI
PortholeCompositeSceneStringVoidReturns the porthole composite scene filepath used by this record if any (optional in db)
UiUnitGroupContextCcoUiUnitGroupingRecordVoidReturns a context to the unit group of the unit

CcoMeleeWeaponRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SplashAttackTargetSizeVoidVoid
RecordListVoidVoid
MeleeWeaponTypeVoidVoid
WeaponLengthVoidVoid
SplashAttackPowerMultiplierContextVoidVoid
ApDamageContextVoidVoid
DamageContextVoidVoid
CollisionAttackMaxTargetsCooldownVoidVoid
CollisionAttackMaxTargetsVoidVoid
ContactPhaseVoidVoid
BonusVInfantryContextVoidVoid
IsMagicalVoidVoid
IgnitionAmountVoidVoid
BuildingDamageContextVoidVoid
BonusVLargeContextVoidVoid
KeyVoidVoid
SplashAttackMaxAttacksVoidVoid

CcoMercenaryRecruitmentInfoRecord

Record wrapper for a mercenary recruitment info record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OrnamentIconPathStringVoidReturns the image path of the ornament icon of the confirmation button
HUDButtonIconPathStringVoidReturns the image path of the HUD button of the mercenary recruitment info
ConfirmButtonIconPathStringVoidReturns the image path of the confirm button of the mercenary recruitment info
ConfirmButtonTitleUniStringVoidReturns the confirm button title of the mercenary recruitment info

CcoMissileWeaponRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
RecordListVoidVoid
UseSecondaryAmmoPoolVoidVoid
ProjectileContextListVoidVoid
PrecursorVoidVoid

CcoMissionIssuerRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
NameVoidVoid
IconPathVoidVoid
DefaultRoundsBetweenVoidVoid
KeyVoidVoid

CcoMissionRecord

Wrapper for a MISSION_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LocalisedSupplementaryTextUniStringVoid
LocalisedTitleUniStringVoid
QuestCharacterStringVoid
BattleSetPieceRecordContextCcoBattleSetPieceRecordVoid
UiImageStringVoid
LocalisedTitleKeyStringVoid
IsQuestBoolVoid
LocalisedDescriptionKeyStringVoid
RecordListCcoMissionRecord (list)Void
QuestMissionBoolVoid
KeyStringVoid
StickyByDefaultBoolVoid
PrioritisedBoolVoid
GenerateBoolVoid
BaseCategoryWeightFloatVoid
TriggerRadiusFloatVoid
LocationYIntVoid
LocationXIntVoid
EventCategoryContextCcoCdirEventsCategoryRecordVoid
LocalisedMissionCompletedTextUniStringVoid
LocalisedDescriptionUniStringVoid

CcoMortuaryCultCategoryRecord

Wrapper for a MORTUARY_CULT_CATEGORY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoMortuaryCultCategoryRecord (list)Void
ShowOrderIntVoid
LocalisedButtonDescriptionUniStringVoid
CraftButtonTextUniStringVoid
LocalisedNameUniStringVoid
LocalisedDescriptionUniStringVoid
CategoryIconStringVoid
KeyStringVoid

CcoMountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
EntityVoidVoid
KeyVoidVoid

CcoMountableArtilleryUnitsCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CapVoidVoid
UnitRecordContextVoidVoid
RecordListVoidVoid
FactionContextVoidVoid
ProbabilityVoidVoid

CcoMultiplayerCampaignSettingRecord

Wrapper for a MULTIPLAYER_CAMPAIGN_SETTING_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoMultiplayerCampaignSettingRecord (list)VoidReturn a context list of all mp campaign settings, sorted in the right order
IsPerPlayerSettingBoolVoidReturns true if this setting can be set by all players (like difficulty), if false only host can set
KeyStringVoidReturn unique db key for setting
LocalisedTooltipUniStringVoidReturns localised tooltip for the setting
LocalisedNameUniStringVoidReturns localised name for the setting

CcoMultiplayerCampaignSettingsOptionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TooltipVoidVoid
ValueVoidVoid
OrderVoidVoid
LocalisedNameVoidVoid
MultiplayerCampaignSettingContextVoidVoid
RecordListVoidVoid

CcoNagashConfederationRitualsToMissionRecord

Wrapper for a NAGASH_CONFEDERATION_RITUALS_TO_MISSION_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoNagashConfederationRitualsToMissionRecord (list)Void
TargetFactionContextCcoCampaignFactionVoid
MissionContextCcoMissionRecordVoid
RitualContextCcoRitualRecordVoid

CcoNarrativeViewerEntryRecord

Wrapper for a NARRATIVE_VIEWER_ENTRY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CampaignVideoContextCcoCampaignVideoRecordVoidReturns the CcoCampaignVideoRecord associated with this entry
StoryPanelIncidentContextCcoIncidentRecordVoidReturns the CcoIncidentRecord associated with this entry
ScriptedValueRegistryKeyStringVoidReturns the string id which should be looked up in the registry to tell whether this entry has been unlocked
ThumbnailImagePathStringVoidReturns the thumbnail image path from it's campaign video record or story panel incident
LocalisedTitleUniStringVoidReturns the localised title from it's campaign video record or story panel incident
KeyStringVoidReturns the key of this NARRATIVE_VIEWER_ENTRY_RECORD
RecordListCcoNarrativeViewerEntryRecord (list)Void
AudioStateIntVoidReturns the audio state used for this entry
IsContentOwnedBoolVoidReturns true if this entry should be visible for the player's owned content (frontend ownership filter)
DefaultLockedBoolVoidReturns true if the entry is locked by default
IsStoryIncidentEntryBoolVoidReturns true when this entry has a valid story incident
IsCampaignVideoEntryBoolVoidReturns true when this entry has a valid campaign video
SortIntVoidReturns the sort value used to order entries in tabs
NarrativeViewerTabContextCcoNarrativeViewerTabRecordVoidReturns the CcoNarrativeViewerTabRecord associated with this entry

CcoNarrativeViewerTabRecord

Wrapper for a NARRATIVE_VIEWER_TAB_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoNarrativeViewerTabRecord (list)VoidReturns a list of all CcoNarrativeViewerTabRecords
EntriesListCcoNarrativeViewerEntryRecord (list)VoidReturns a list of this tab's entries
OffsetXIntVoidReturns the offset in the x direction of the tab
SortIntVoidReturns the integer used to sort the tabs
CultureContextCcoCultureRecordVoidReturns the CcoCultureRecord for the tab
ImagePathStringVoidReturns the tab image path
NameUniStringVoidReturns the localised name of the tab
KeyStringVoidReturns the tab key

CcoNewContentPatchNoteRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
OrderVoidVoid
KeyVoidVoid
LocalisedPatchNoteVoidVoid

CcoOwnershipProductRecord

Wrapper for a OWNERSHIP_PRODUCT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoOwnershipProductRecord (list)VoidReturns list of all product records
OpenStoreVoidVoidOpens up a store page for the product (like in steam overlay)
IsPurchasableBoolVoidReturns true if this product could be purchased
IsOwnedBoolVoidReturns true if this product is currently owned and installed (so accessible basically)
IsTwaBoolVoidReturns true if this product is free as part of Total War Access
IsFlcBoolVoidReturns true if this product is free
ReleaseOrderIntVoidReturns the release order, used to determine which order dlcs came in for sorting purposes, etc
DescriptionUniStringVoidReturns a localised description to describe the product in the UI
SteamAppIdIntVoidReturns the product id linked to a store front for this product
KeyStringVoidReturns the unique key for this record

CcoPatronFactionToAssociatedProvincesRecord

Record wrapper for a patron_faction_to_associated_provinces_record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoPatronFactionToAssociatedProvincesRecord (list)VoidReturns a list of all the records in the table
AssociatedProvinceContextCcoCampaignProvinceVoidReturns the CcoCampaignProvince for the province associated with this record
PatronFactionContextCcoCampaignFactionVoidReturns the CcoCampaignFaction of the patron faction
AssociatedProvinceKeyString (list)VoidReturns the key of the associated province in the record
PatronFactionKeyString (list)VoidReturns the key of the patron faction in the record
KeyString (list)VoidReturns the key of the record

CcoPatronageSlotRecord

Record wrapper for a patronage_slot_record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoPatronageSlotRecord (list)VoidReturns a list of all the records in the table
EffectBundleCcoEffectBundleVoidReturns a CcoEffectBundle for the effect bundle this slot provides
RankIntVoidReturns the rank for the patronage slot
SlotNameStringVoidReturns only the name of the patronage slot
KeyString (list)VoidReturns the key of the record

CcoPlagueComponentUiDataRecord

Wrapper for a plague component slot defined in Jade, used by the UI

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OffsetVector4Void
IdIntVoid
LinkedSlotsListCcoPlagueComponentUiDataRecord (list)Void

CcoPlagueEffectList

A class that wraps a plague effect list together with its faction sets and target types

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactionSetListCcoFactionSetRecord (list)VoidReturns a list of faction sets that the effects apply to
TargetTypeListCcoString (list)VoidReturns a list of valid targets in string form
NameUniStringVoidReturns the name of the effect list, including the faction sets and the taregt list (example: 'Plague effects on Nurgle armies and settlements)
EffectListWithSourceListCcoCampaignPlagueCompositionEffectList (list)VoidReturns the list of effect lists, each with a source where they come from (if no sources are included, there will be a single list with null as source)

CcoPlagueEffectRecord

Wrapper for a PLAGUE_EFFECT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoPlagueEffectRecord (list)VoidReturns a list of all plague effect records in the table
EffectsAndTypeListCcoPlagueEffectList (list)ExpressionState, Context (optional)Returns a list of CcoPlagueEffectList, which provide a list of effects, together with targets and faction sets specifying where the effects will apply
EffectBundleListCcoEffectBundle (list)VoidReturns a list of effect bundles
KeyStringVoidReturns the key of the record

CcoPlagueMutationUiDataRecord

Wrapper for a mutation type defined in Jade, used by the UI

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SortOrderIntVoidReturns the sorting order used by the UI
TotalValueExpressionStringVoidString representation of expression used to calculate value of combined effect value shown in UI
ValueExpressionStringVoidString representation of expression used to calculate value shown in UI
LocalisedTooltipUniStringVoidLocalised tooltip to be used in the UI
LocalisedHintUniStringVoidLocalised hint to be used in the UI
MutationLevelsListCcoCampaignPlagueIngredient (list)CcoCampaignPlaguesCompositionSystem (optional)Returns each of the mutation levels

CcoPlagueParameterRecord

Wrapper for a PLAGUE_PARAMETER_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
InfectionDurationIntVoid
KeyStringVoid
RecordListCcoPlagueParameterRecord (list)Void
MinimumInfectionChanceUnaryFloatVoid
InfectionChanceReductionPostSpreadUnaryFloatVoid
RegionToRegionInfectionChanceUnaryFloatVoid
RegionToForceInfectionChanceUnaryFloatVoid
ForceToRegionInfectionChanceUnaryFloatVoid
ForceToForceInfectionChanceUnaryFloatVoid
ForceToForceBattleInfectionChanceUnaryFloatVoid
ImmunityDurationIntVoid
SpreadCountMaxIntVoid

CcoPlagueRecord

Wrapper for a PLAGUE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoPlagueRecord (list)VoidReturns a list with all plague records in the table
ImagePathStringVoidReturns the image path of the plague
SortOrderIntVoidReturns the lifetime of the plague
LifetimeIntVoidReturns the lifetime of the plague
KeyStringVoidReturns the key of the plague record

CcoPlagueSpecialCompositionRecord

Wrapper for a PLAGUE_SPECIAL_COMPOSITION_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyStringVoidReturns the key of the record
RecordListCcoPlagueSpecialCompositionRecord (list)VoidReturns a list with all compositions in the table
AwardedIngredientContextCcoCampaignPlagueIngredientVoidReturns the component that will be awarded when using the components from the plague composition
FactionPlagueCompositionContextCcoCampaignPlagueCompositionCcoCampaignFactionReturns the plague composition for the given faction

CcoPooledResourceThresholdOperationSetRecord

Wrapper for a pooled_resource_threshold_operation_set_record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsLockedByAchievementBoolVoidReturns true if this operation set is currently locked by an achievement
IsGrantedByAchievementBoolVoidReturns true if this operation set is granted by unlocking an achievement
UnlocksAgentBoolCcoAgentRecordReturns true if any of the operation sets unlock the passed in agent
UnlocksUnitBoolCcoMainUnitRecordReturns true if any of the operation sets unlock the passed in unit
ChooseOperationSetVoidCcoCampaignFaction, CcoCampaignOperationSetRecordChooses the passed in operation set
RecordListCcoPooledResourceThresholdOperationSetRecord (list)VoidReturns a list with all records in the table
ActiveOperationSetListCcoCampaignOperationSetRecord (list)CcoCampaignFactionReturns the operation set record that has been selected for this threshold, if any
PooledResourceListCcoCampaignPooledResource (list)CcoCampaignFaction (optional)Returns the pooled resource from the faction passed in, which sets the bounds of the operations. If no faction gets passed in, default to player faction
CampaignOperationSetListCcoCampaignOperationSetRecord (list)VoidReturns a list of operation sets in this threshold
UpperBoundIntVoidReturns the upper bound, which is used for the exit operations
LowerBoundIntVoidReturns the lower bound, which is used for the enter operations
KeyStringVoidReturns the key of the record

CcoProjectileBombardmentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
NumProjectilesVoidVoid
RadiusSpreadVoidVoid
ProjectileContextVoidVoid
KeyVoidVoid

CcoProjectileRecord

Cco wrapper for querying a projectile record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BaseReloadTimeContextCcoUnitStatVoidGets CcoUnitStat for the projectile base reload time
ExplosiveApDamageContextCcoUnitStatVoidGets CcoUnitStat for the projectile explosive armour piercing damage context
ExplosiveDamageContextCcoUnitStatVoidGets CcoUnitStat for the projectile explosive damage
ApDamageContextCcoUnitStatVoidGets CcoUnitStat for the projectile armour piercing damage
ExplosiveArmourPiercingPercentageIntVoidReturns the calculated explosive armour piercing value as a percentage
DamageContextCcoUnitStatVoidGets CcoUnitStat for the projectile damage
ArmourPiercingPercentageIntVoidReturns the calculated armour piercing value as a percentage
EffectiveRangeContextCcoUnitStatVoidGets CcoUnitStat for the effective range of the projectile
TotalProjectilesPerReloadIntVoid
IconPathStringVoidReturns a path for the associated icon for this projectile
ShotsPerVolleyIntVoid
TooltipUniStringVoidReturns a string of the associated tooltip text for this projectile
NameUniStringVoidReturns a string for the onscreen name of the projectile
BurstSizeIntVoid
NumProjectilesIntVoidThe number of projectiles associated with this projectile record
ShotTypeKeyStringVoid
KeyStringVoid
IsFlamingBoolVoidReturns whether the projectile inflicts flaming damage
IsMagicalBoolVoidReturns whether the projectile inflicts magical damage
RecordListCcoProjectileRecord (list)Void
OverheadPhaseContextCcoSpecialAbilityPhaseRecordVoidGets the CcoSpecialAbilityPhaseRecord for the effect of the projectile flying overhead
ContactPhaseContextCcoSpecialAbilityPhaseRecordVoidGets the CcoSpecialAbilityPhaseRecord for the effect of contact with the projectile
CanDamageBuildingsBoolVoid
BonusVsLargeContextCcoUnitStatVoidGets CcoUnitStat for the projectile bonus vs large units
BonusVsInfantryContextCcoUnitStatVoidGets CcoUnitStat for the projectile bonus vs infantry

CcoProphecyOfSotekStageRecord

Wrapper for a PROPHECY_OF_SOTEK_STAGE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LocalisedDescriptionUniStringVoid
LocalisedNameUniStringVoid
EffectBundleContextCcoEffectBundleVoid
RecordListCcoProphecyOfSotekStageRecord (list)Void
TooltipTypeStringVoid
StageStringVoid
OrderIntVoid

CcoProphecyOfSotekStagesToMissionRecord

Wrapper for a PROPHECY_OF_SOTEK_STAGES_TO_MISSION_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoProphecyOfSotekStagesToMissionRecord (list)Void
OrderIntVoid
MissionContextCcoMissionRecordVoid
StageContextCcoProphecyOfSotekStageRecordVoid

CcoProvinceAutomanagementFocusRecord

Wrapper for a PROVINCE_AUTOMANAGEMENT_FOCUS_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoProvinceAutomanagementFocusRecord (list)VoidReturns a list with all focus records in the table
DescriptionUniStringVoidReturn the localised description of the focus
NameUniStringVoidReturn the localised name of the focus
KeyStringVoidReturns the key of the record

CcoProvinceInitiativeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OrderVoidVoid
LocalisedNameVoidVoid
KeyVoidVoid
EffectBundleContextVoidVoid
RecordListVoidVoid
EffectBundleContextForCurrentProvinceVoidVoid
StatusForCurrentProvinceVoidVoid
IconPathVoidVoid

CcoPurchasableEffectLevelRecord

Record wrapper for a PURCHASABLE_EFFECT_LEVEL_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LevelIntVoidReturns the level of the PurchasableEffectLevelRecord
EffectBundleCcoEffectBundleVoidReturns the effect bundle of the PurchasableEffectLevelRecord
PurchasableEffectRecordContextCcoPurchasableEffectRecordVoidReturns the PurchasableEffectRecordContext from which this PurchasableEffectLevelRecord is part of
KeyStringVoidReturns the key of the PurchasableEffectLevelRecord

CcoPurchasableEffectRecord

Record wrapper for a PURCHASABLE_EFFECT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LevelsCcoPurchasableEffectLevelRecord (list)VoidReturns a list of PurchasableEffectLevelrecords
KeyStringVoidReturns the key of the PurchasableEffect

CcoRegionGroupRecord

Wrapper for a REGION_GROUP_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoRegionGroupRecord (list)VoidReturns a list of all CcoRegionGroupRecords
OrderSortedRegionRecordsListCcoRegionRecord (list)VoidReturns a list of CcoRegionGroups linked to this region group
ZoomToGroupAtHeightVoidFloatMoves the camera to the average position of regions in the group and zooms it to the desired amount
LocalisedNameUniStringVoidReturns the localised name of the region group
KeyStringVoidReturns the key of the region group

CcoRegionRecord

Wrapper for a REGION_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoRegionRecord (list)VoidReturns a list of all regions in the database
OwnerEffectBundleListCcoEffectBundle (list)VoidReturns a list of CcoEffectBundle with the owner bundle effects
RegionGroupsListCcoRegionGroupRecord (list)VoidReturns a list of CcoRegionGroupRecords that this region is part of
SettlementContextCcoCampaignSettlementVoidReturns a CcoCampaignSettlement with the settlement context of this region
FactionSwappingIdStringVoidReturns a string with the faction swapping id of the region
BattleNameKeyStringVoidReturns a string with the battle name key of the region
OnscreenNameKeyStringVoidReturns a string with the onscreen name key of the region
KeyStringVoidReturns a string with the key of the region

CcoReignOfChaosRecord

Wrapper for a REIGN_OF_CHAOS_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ArmyAbilityCcoUnitAbilityVoidReturns the CcoUnitAbility associated with this record
GodTypeStringVoidReturns a string key for the god type associated with this record
TierIntVoidReturns the tier of this effect
DescriptionUniStringVoidReturns the description of the outcome's effects
NameUniStringVoidReturns the name of the outcome
RecordListCcoReignOfChaosRecord (list)VoidReturns a list of reign of chaos records

CcoResourceCostRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PooledResourceCostsListVoidVoid
RequiredAncillariesListVoidVoid
RequiredTradeResourcesListVoidVoid
ExpenditureTypeVoidVoid
IncomeTypeVoidVoid
TreasuryCostAbsoluteVoidVoid
TreasuryCostVoidVoid
IdVoidVoid

CcoResourceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TradeValueVoidVoid
PricePerUnitVoidVoid
UnitNamePluralVoidVoid
UnitNameSingularVoidVoid
HasUnitNameVoidVoid
OnscreenTextVoidVoid
KeyVoidVoid
RecordListVoidVoid
DescriptionVoidVoid
StrategicValueVoidVoid
IconFilepathVoidVoid

CcoRitualCategoryGroupRecord

Wrapper for a RITUAL_CATEGORY_GROUP_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CategoryListCcoRitualCategoryRecord (list)Void
RecordListCcoRitualCategoryGroupRecord (list)Void
KeyStringVoid
SortOrderIntVoid
DisplayNameUniStringVoid

CcoRitualCategoryRecord

Wrapper for a RITUAL_CATEGORY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SortOrderIntVoid
RecordListCcoRitualCategoryRecord (list)Void
RitualListForManagerCcoCampaignRitual (list)CcoCampaignRitualManager
GroupContextCcoRitualCategoryGroupRecordVoid
DisplayNameUniStringVoid
IconPathStringVoid
CategoryStringVoid
IdStringVoid

CcoRitualChainRecord

Wrapper for a RITUAL_CHAIN_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoRitualChainRecord (list)Void
ColourColourVoid
SortOrderIntVoid
RitualSitesRequiredIntVoid
DisplayNameUniStringVoid
DescriptionUniStringVoid
CategoryContextCcoRitualCategoryRecordVoid
RitualsListCcoRitualRecord (list)Void
KeyStringVoid

CcoRitualPayloadAddForeignSlotRecord

Wrapper for a ritual payload add foreign slot record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SlotSetContextCcoSlotSetRecordVoidReturns the slot set of the foreign slot
RitualPayloadContextCcoRitualPayloadRecordVoidReturns the ritual payload this belongs to

CcoRitualPayloadAncillaryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
AncillaryContextVoidVoid
PayloadVoidVoid

CcoRitualPayloadChangeAgentCapacityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CapacityVoidVoid
PayloadContextVoidVoid
AgentRecordContextVoidVoid

CcoRitualPayloadChangeUnitAllowanceCapacityRecord

Wrapper for a RITUAL_PAYLOAD_CHANGE_UNIT_CAPACITY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoRitualPayloadChangeUnitAllowanceCapacityRecord (list)Void
CapacityIntVoid
UnitListRecordContextCcoUnitListRecordVoid
PayloadContextCcoRitualPayloadRecordVoid

CcoRitualPayloadChangeUnitCapacityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CapacityVoidVoid
UnitRecordContextVoidVoid
PayloadContextVoidVoid

CcoRitualPayloadConvertSettlementRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SettlementTypeContextVoidVoid
RegionContextVoidVoid
PayloadVoidVoid
RecordListVoidVoid

CcoRitualPayloadCookingRecipeRecord

Wrapper for a ritual payload cooking recipe

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CookingRecipeRecordContextCcoCookingRecipeRecordVoidReturns the cooking recipe record
RitualPayloadContextCcoRitualPayloadRecordVoidReturns the ritual payload this belongs to

CcoRitualPayloadDiplomaticAttitudeChangeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
AttitudeDeltaVoidVoid
PayloadVoidVoid

CcoRitualPayloadReassignAgentRecord

Record wrapper for a RITUAL_PAYLOAD_REASSIGN_AGENT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoRitualPayloadReassignAgentRecord (list)VoidReturns a list of all nodes from the database
AgentSubtypeContextCcoAgentSubtypeRecordVoidReturns a CcoAgentSubtypeRecord with the agent subtype to be reassigned
AgentTypeContextCcoAgentRecordVoidReturns a CcoAgentRecord for the type of agent to be reassigned
PayloadContextCcoRitualPayloadRecordVoidReturns a CcoRitualPayloadRecord with the payload tied to this record
KeyStringVoidReturns the key of the record

CcoRitualPayloadRecord

Wrapper for a ritual payload record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ConfederatedFactionsListCcoCampaignFaction (list)VoidReturns a list with factions that will be confederated by this payload
AgentCapListCcoRitualPayloadChangeAgentCapacityRecord (list)VoidReturns a list with agent caps affected by this payload
HumanOnlyBoolVoidReturns true if the payload only applies to human factions
KeyStringVoidReturns the key of the payload record
UnitAllowanceCapListCcoRitualPayloadChangeUnitAllowanceCapacityRecord (list)VoidReturns a list with unit allowance caps affected by this payload
UnitCapUnitListCcoRitualPayloadChangeUnitCapacityRecord (list)VoidReturns a list with unit caps affected by this payload
ArmyTeleportListCcoRitualPayloadTeleportArmyRecord (list)VoidReturns a list of CcoRitualPayloadTeleportArmyRecord
RecordListCcoRitualPayloadRecord (list)VoidReturns a list with all payload records in the database
EffectBundleAndDurationPairListCcoPair (list)VoidReturns a list of effect bundles and their duration that this payload will provide
EffectBundleListCcoEffectBundle (list)VoidReturns a list of effect bundles that this payload will provide
StormSpawnsListCcoRitualPayloadSpawnStormRecord (list)VoidReturns a list of storms that this payload will spawn
AncillariesListCcoRitualPayloadAncillaryRecord (list)VoidReturns a list of ancillaries that this payload will provide
ResourceTransactionsListCcoResourceCostRecord (list)VoidReturns a list of resource transactions that this payload will apply
MercenarySpawnsListCcoRitualPayloadSpawnMercenaryRecord (list)VoidReturns a list of mercenaries that the payload will spawn
DurationIntVoidReturns the duration of the payload
ArmySpawnsListCcoRitualPayloadSpawnArmyRecord (list)VoidReturns a list of armies that the payload will spawn
AgentSpawnsListCcoRitualPayloadSpawnAgentRecord (list)VoidReturns a list of agents that the payload will spawn
ReassignAgentsListCcoRitualPayloadReassignAgentRecord (list)VoidReturns a list of agents that the payload will reassign
CampaignPayloadContextCcoCampaignPayloadRecordVoidReturns the campaign payload that will activate with this ritual payload, if valid
CookingRecipesListCcoRitualPayloadCookingRecipeRecord (list)VoidReturns a list with cooking recipe payloads
AddForeignSlotListCcoRitualPayloadAddForeignSlotRecord (list)VoidReturns a list with foreign slot add payloads
DiplomaticAttitudeChangeContextCcoRitualPayloadDiplomaticAttitudeChangeRecordVoidReturns a CcoRitualPayloadDiplomaticAttitudeChangeRecord with the diplomatic attitude that this payload will change
DilemmaContextCcoRitualPayloadTriggerDilemmaRecordVoidReturns a CcoRitualPayloadTriggerDilemmaRecord with the context of the dilemma that this payload will trigger, if any

CcoRitualPayloadSpawnAgentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
SpawnToPoolVoidVoid
AgentSubtypeContextVoidVoid
AgentTypeContextVoidVoid
PayloadVoidVoid

CcoRitualPayloadSpawnArmyRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SpawnAtRitualSiteVoidVoid
FactionOverrideContextVoidVoid
IdVoidVoid
SpawnableForceContextVoidVoid
PayloadVoidVoid
RecordListVoidVoid

CcoRitualPayloadSpawnMercenaryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
IdVoidVoid
SpawnableUnitContextVoidVoid
PayloadVoidVoid

CcoRitualPayloadSpawnStormRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
StrengthVoidVoid
MaxTurnsDurationVoidVoid
RegionContextVoidVoid
PayloadVoidVoid
StormTypeContextVoidVoid

CcoRitualPayloadTeleportArmyRecord

Wrapper for a RITUAL_PAYLOAD_TELEPORT_ARMY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanTeleportOnLandBoolVoidReturns whether we can teleport on land. If false then we can only teleport to sea.
ShouldTeleportOnlySameFactionForcesBoolVoidReturns whether to teleport neighboring forces only of the same faction as the one of the primary force.
VicinityRadiusIntVoidReturns integer signifying the radius around the primary force to teleport other forces along.
RegionContextCcoRegionRecordVoidReturns a CcoRegionRecord with the region record where the army will teleport to
PayloadContextCcoRitualPayloadRecordVoidReturns a CcoRitualPayloadRecord with the payload context
RecordListCcoRitualPayloadTeleportArmyRecord (list)VoidReturns a list of all teleport payloads in the database
CanTeleportFromLandBoolVoidReturns whether we can teleport from land. If false then we can only teleport from sea.

CcoRitualPayloadTriggerDilemmaRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
DilemmaContextVoidVoid
PayloadVoidVoid

CcoRitualRecord

Record wrapper for a RITUAL_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FailureCooldownTimeIntVoidReturns the cooldown time of the ritual after failing to perform
CompletionPayloadContextCcoRitualPayloadRecordVoidReturns a CcoRitualPayloadRecord with the payload that gets applied at the completion of the ritual
GlobalCooldownTimeIntVoidReturns the cooldown time of the ritual among all campaign faction
DevelopmentPointCostIntVoidReturns the amount of development points needed to perform this ritual
StartPayloadContextCcoRitualPayloadRecordVoidReturns a CcoRitualPayloadRecord with the payload that gets applied at the start of the ritual
SlaveCostIntVoidReturns the amount of slaves needed to perform this ritual
ActiveEffectListCcoEffect (list)VoidReturns a list of effects that are applied while the ritual is active
CompletionPayloadEffectBundleListCcoEffectBundle (list)VoidReturns a list of effect bundles that get applied at the completion of the ritual
SpawnedMilitaryForceTypeUniStringVoidThe display name without the first part (only the actual name)
StartPayloadEffectBundleListCcoEffectBundle (list)VoidReturns a list of effect bundles that get applied at the start of the ritual
AdditionalExplanationTextUniStringVoidReturns the additional ui explanation text of the ritual
DisplayNameUniStringVoidReturns the localised name of the ritual
RecordListCcoRitualRecord (list)VoidReturns a list with all ritual records from the database
DelayPayloadApplicationBoolVoidReturns true if payload application is delayed for this ritual
DescriptionUniStringVoidReturns the localised description of the ritual
CategoryStringVoidReturns a string with the category the ritual is part of
InterruptableBoolVoidReturns true if the ritual can be interrupted
IconStringVoidReturns the icon path of the ritual
HostileBoolVoidReturns true if the ritual is hostile
KeyStringVoidReturns the key of the ritual
IsContentUnlockedBoolVoidReturns true if the ritual is content unlocked for the local player
RequiredPerformingCharacterMinimumLevelIntVoidReturns the minimum character rank required by the first required performing character for this ritual, or 0 if none
SortOrderIntVoidReturns the sort order of the ritual
TargetCategoryCooldownIntVoidReturns the cooldown of the ritual category
TargetCooldownIntVoidReturns the cooldown of the ritual target
CooldownTimeIntVoidReturns the cooldown time until the ritual can be performed again
ExpendedResourceTransactionContextCcoCampaignResourceTransactionVoidReturns the expended resource cost of the ritual
ResourceTransactionContextCcoCampaignResourceTransactionVoidReturns the base resource cost of the ritual
CastTimeIntVoidReturns the cast time of the ritual
CategoryContextCcoRitualCategoryRecordVoidReturns a CcoRitualCategoryRecord with the category the ritual is part of

CcoSeasonRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OnscreenVoidVoid
KeyVoidVoid
RecordListVoidVoid

CcoSettlementClimateTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
UiDescriptionVoidVoid
UiNameVoidVoid
UiBackgroundImageVoidVoid
UiIconImageVoidVoid
TypeVoidVoid

CcoSettlementTypeRecord

Record wrapper for a settlement_types record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TooltipUniString (list)VoidReturns a tooltip for the record, combining the name and description
DescriptionUniStringVoidReturns the localised description of the record
NameUniStringVoidReturns the localised name of the record
IconStringVoidReturns the icon path for the record
OwningLimitIntVoidReturns the base shared owning limit for this settlement type's group, before faction bonus-value modifiers.
HasOwningLimitBoolVoidReturns whether this settlement type is linked to a shared owning limit group.
KeyStringVoidReturns the key of the record

CcoSlotSetItemRecord

Wrapper for a ritual payload add foreign slot record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SlotSetContextCcoSlotSetRecordVoidReturns the slot set this item belongs to
BuildingLevelContextCcoBuildingLevelRecordVoidReturns the building level for this item
SlotTemplateKeyStringVoidReturns the key of the slot template

CcoSlotSetRecord

Wrapper for a slot set record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SetItemsCcoSlotSetItemRecord (list)VoidReturns the list of items within this set
KeyStringVoidReturns the key of the record

CcoSpawnableForceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitListsListVoidVoid
UnitsListVoidVoid
KeyVoidVoid
RecordListVoidVoid

CcoSpawnableForceUnitJunctionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
MinXpVoidVoid
MinAmountVoidVoid
MaxXpVoidVoid
MaxAmountVoidVoid
IdVoidVoid
UnitContextVoidVoid
SpawnableForceVoidVoid

CcoSpawnableForceUnitListJunctionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MinAmountVoidVoid
MaxXpVoidVoid
MaxAmountVoidVoid
IdVoidVoid
UnitListContextVoidVoid
SpawnableForceVoidVoid
RecordListVoidVoid
MinXpVoidVoid

CcoSpecialAbilityGroupRecord

Wrapper for a SPECIAL_ABILITY_GROUP_RECORD record from special_ability_groups_tables

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsRunicLoreBoolVoidReturns true if this is a runic lore
IsSkavenLoreBoolVoidReturns true if this is one of the three skaven lores
IsCompositeGroupBoolVoidReturns true if this is a group that consists of abilities from other groups (special cases where some units have mix of lores)
SortOrderIntVoidReturns the sort order for ability groups
ColourColourVoidReturns the colour for this ability group
ButtonNameStringVoidReturns the state name for use on buttons
NameUniStringVoidReturns the localised name to use for the ability group
ButtonIconPathStringVoidReturns the icon path to use specifically for buttons on the UI
IconPathStringVoidReturns the icon path for UI
KeyStringVoidReturns the db key
ParentLoreContextCcoSpecialAbilityGroupRecordVoidReturns the CcoSpecialAbilityGroupRecord context for our parent lore if we are a child (sub) lore, such as a specific vampires vampiric lore
RecordListCcoSpecialAbilityGroupRecord (list)VoidReturns the list of all CcoSpecialAbilityGroupRecord in the special_ability_groups_table
CataclysmAbilityCcoUnitAbilityVoidReturns the the cataclysm CcoUnitAbility for the Storm of Magic ascendancy
AscendancyPhaseRecordCcoSpecialAbilityPhaseRecordVoidReturns the the phase record for the current Storm of Magic ascendancy, which contains the effects and attributes lists
AbilityListCcoUnitSpecialAbilityRecord (list)VoidReturns the list of CcoUnitSpecialAbilityRecord in this ability group

CcoSpecialAbilityIntensitySettingRecord

Wrapper for a SPECIAL_ABILITY_INTENSITY_SETTING_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IntensityTypeStringVoid
RecordListCcoSpecialAbilityIntensitySettingRecord (list)Void
MaxIntensityFloatVoid
HasConstantIntensityBoolVoid
UpdatesOnlyWhenAbilityActiveBoolVoid
InverseBoolVoid
MaxAmountFloatVoid
DefaultAmountFloatVoid
AbilityRecordContextCcoUnitSpecialAbilityRecordVoid

CcoSpecialAbilityPhaseRecord

Wrapper for a SPECIAL_ABILITY_PHASE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DurationIntVoidReturns the duration in seconds that this phase lasts
AffectsAlliesBoolVoidReturns true if this phase affects allies
AdditionalUiEffectListCcoUnitAbilitiesAdditionalUiEffectRecord (list)VoidReturns the additional ui effect list of this phase
TotalBarrierHealPercentFloatVoidPercentage of targets max barrier HP will heal after all HpChangeFrequency ticks, (so if phase lasts 10 seconds and HpChangeFrequency is 1 and HealPercent is 0.01, then will heal 10%)
IsHiddenInUiBoolVoidReturns true if this phase should NOT be displayed in the UI
RecordListCcoSpecialAbilityPhaseRecord (list)VoidReturns list of all CcoSpecialAbilityPhaseRecord in db table special_ability_phases_table
TotalHealPercentFloatVoidPercentage of targets max HP will heal after all HpChangeFrequency ticks, (so if phase lasts 10 seconds and HpChangeFrequency is 1 and HealPercent is 0.01, then will heal 10%)
ImbueIgnitionBoolVoidReturns true if this imbues a units attack with flaming attack bonuses
UnitAttributeListCcoUnitAttributeRecord (list)VoidReturns a list of CcoUnitAttributeRecord provided by phase
HealPercentFloatVoidPercentage of targets max HP will heal for each HpChangeFrequency (0-1), (so if phase lasts 10 seconds and HpChangeFrequency is 2, then will heal this amount 5 times)
EffectListCcoEffect (list)ExpressionState, Float (optional)Returns a list of CcoEffect so can see effects of phase
RemoveMagicalBoolVoidReturns true if this removes magical attacks on the target
AbilityPhaseEffectsListCcoSpecialAbilityPhaseStatEffectRecord (list)VoidReturns a list of CcoSpecialAbilityPhaseStatEffectRecord so know what stats affected by phase
AbilityRechargeChangeFloatVoidReturns the modifier applied to recharge times of abilities
HasAmmunitionReplenishmentBoolVoidReturns true if this phase replenish or destroy ammunition. positive value replenish ammunition, negative value destroys ammunition
ImbueMagicalBoolVoidReturns true if this imbues a units attack with magic attack bonuses
ResurrectBoolVoidReturns true if this resurrects a unit
InspirationAuraRangeModFloatVoidReturns the modifier applies to inspiration aura of a unit
AmmunitionReplenishmentFloatVoidReturns the ammunition replenishment this phase gives. positive value replenish ammunition, negative value destroys ammunition
PhaseEffectFlagListCcoStringValue (list)VoidReturns a list of CcoStringValues for the phase effect flags (special case things like freeze fatigue)
FatigueChangeRatioFloatVoidReturns the multiplier applies to fatigue (for freezing fatigue or tiring a unit out)
IntensityFloatExpressionStateReturns the ability intensity value
RemovesAttributeBoolCcoUnitAttributeRecordReturns true if this phase removes provided unit attribute, e.g. removes causes fear attribute on Whip of Agony
SpreadRangeIntVoidReturns the range the effect can spread like a contagion if this is set to a non-zero value
IntensifiedRangeIntValueTextUniStringExpressionState, Int, UniString, FloatTakes unintensified value and an int formatter then returns the range value of label as string (e.g if we have intensity as 0.4f and max is 1, then we pass 10 and %d. It will format int into value fields with (2 - 4) and (5 - 10))
HasUnitAttributesBoolVoidReturns true if this phase provides unit attributes
IntensifiedRangeValueTextUniStringExpressionState, Float, UniString, FloatTakes unintensified value and a float formatter then returns the range value of label as string (e.g if we have intensity as 0.4f and max is 1, then we pass 8 and %f. It will format float into value fields with (1.6 - 3.2) and (4 - 8))
ManaMaxDepletionModFloatVoidReturns the modifier to the maxa max depletion
HasEffectsBoolVoidReturns true if this phase has effects
ManaRegenModFloatVoidReturns the modifier to mana regeneration
HasManaMaxDepletionModBoolVoidReturns true if this depletes mana
IntensifiedIntValueTextUniStringExpressionState, Int, UniStringTakes unintensified value and an int formatter then returns the value of label as string (e.g if we have intensity as 0.4f and max is 1, then we pass 10 and %d. It will format int into value fields with 4 and 10)
MaxDamagedEntitiesIntVoidReturns the max number of entities that can be damaged by this phase
IntensifiedValueTextUniStringExpressionState, Float, UniStringTakes unintensified value and a float formatter then returns the value of label as string (e.g if we have intensity as 0.4f and max intensity is 1, then we pass 8 and %f. It will format float into value fields with 3.2f and 8)
HasManaRegenModBoolVoidReturns true if regenerates mana
DamagePerSecondIntVoidReturns the calculated damage per second amount
OnscreenNameUniStringVoidReturns the localised name to display on the UI
HasDamageAmountBoolVoidReturns true if this phase deals damage
DamageAmountIntVoidReturns the record wrapped damage amount
HasBarrierHealAmountBoolVoidReturns true if this phase heals barrier
IconPathStringVoidReturns icon path to use in UI icons representing the phase
HasHealAmountBoolVoidReturns true if this phase heals
EffectTypeStringVoidReturns string for positive, negative or both
DamageIntVoidReturns the calculated overall damage amount
HpChangeFrequencyIntVoidReturns how often applys HealPercent to target
HasAbilityRechargeChangeBoolVoidReturns true if this phase affects recharge
KeyStringVoidReturns the db key of the phase record
MoraleChangeIntVoidReturns the modifier to morale
AffectsEnemiesBoolVoidReturns true if this phase affects enemies
ImbueContactContextCcoSpecialAbilityPhaseRecordVoidReturns the CcoSpecialAbilityPhaseRecord for the effect imbued to the target

CcoSpecialAbilityPhaseStatEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HowVoidVoid
StatVoidVoid
ValueVoidVoid
PhaseVoidVoid
RecordListVoidVoid

CcoSubcultureRecord

Wrapper for a subculture record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoSubcultureRecord (list)Void
ArmyAbilityListCcoArmySpecialAbilityRecord (list)VoidReturns list of CcoArmySpecialAbilityRecord where each faction in custom battle with this culture has this army ability (so race army abilities)
BattlePlaystyleDescriptionUniStringVoid
ConfederationSummaryNameUniStringVoid
ConfederationScreenNameUniStringVoid
NameUniStringVoid
IndexIntVoid
CultureCcoCultureRecordVoid
KeyStringVoid

CcoTechnologyRecord

Record wrapper for a technology record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ShortDescriptionUniStringVoidReturns the short description of the technology
OnscreenNameUniStringVoidReturns the localised name of the technology
KeyStringVoidReturns the key of the record
RecordListCcoTechnologyRecord (list)VoidReturns a list with all technologies in the table
IsHiddenBoolVoidReturns true if this technology should be hidden in the technology screen
LongDescriptionUniStringVoidReturns the long description of the technology

CcoTechnologyUiGroupRecord

Record wrapper for technology ui group record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ChildAndLinkPositionsListCcoPair (list)VoidReturns a list of CcoPair, where each pair has a CcoTechnologyUiGroupRecord and a VECTOR_4 with link positions
RightMostTechnologyCcoCampaignTechnologyCcoCampaignFaction (optional)Returns the context of the right-most technology for this group
LeftMostTechnologyCcoCampaignTechnologyCcoCampaignFaction (optional)Returns the context of the left-most technology for this group
BottomMostTechnologyCcoCampaignTechnologyCcoCampaignFaction (optional)Returns the context of the bottom-most technology for this group
TopMostTechnologyCcoCampaignTechnologyCcoCampaignFaction (optional)Returns the context of the top-most technology for this group
RecordListCcoTechnologyUiGroupRecord (list)VoidReturns a list with all technology ui groups in the table
BackgroundImageStringVoidReturns the background image for this group
DescriptionUniStringVoidReturns the localised description of this group, if any
NameUniStringVoidReturns the localised name of this group, if any
ColourColourVoidReturns the colour of the group
KeyStringVoidReturns the key of this record

CcoTechnologyUiTabRecord

Wrapper for a TECHNOLOGY_UI_TAB_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyStringVoid
RecordListCcoTechnologyUiTabRecord (list)Void
TierOffsetIntVoid
SortOrderIntVoid
TooltipStringUniStringVoid
LocalisedNameUniStringVoid

CcoTeleportationNetworkNodeRecord

Wrapper for a TELEPORTATION_NETWORK_NODE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectListCcoEffect (list)VoidReturns a list with the effects the node provides, will be an empty list if the node is closed
RecordListCcoTeleportationNetworkNodeRecord (list)VoidReturns a list with all records in the database
OwningFactionContextCcoCampaignFactionVoidReturns a CcoCampaignFaction of the faction that own the region where the node is positioned
ProvinceContextCcoCampaignProvinceVoidReturns a CcoCampaignProvince of the province in which the teleport node is positioned
PositionVector4VoidReturns the display position of the node
TravelTimeIntVoidReturns the time it takes to travel to this node
HandleDoubleClickVoidVoidHandles a double click event
TeleportationTemplateContextCcoTeleportationNodeTemplateRecordVoidReturns the context of the teleportation template that the node is part of, if any
KeyStringVoidReturns the key of the record

CcoTeleportationNodeTemplateRecord

Wrapper for a TELEPORTATION_NODE_TEMPLATE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyStringVoidReturns the key of the record
RecordListCcoTeleportationNodeTemplateRecord (list)VoidReturns a list of all templates in the table
ShouldDisplayTimerBoolVoidReturns true if the teleportation nodes using this template display timer
ClosableBoolVoidReturns true if the teleportation nodes in this template can be closed by the player
EffectListCcoEffect (list)VoidReturns a list of effects that the teleportation nodes from this template provide
DescriptionUniStringVoidReturns the localised description of the template
NameUniStringVoidReturns the localised name of the template
LayoutStringVoidReturns the layout name of the template
IconPathStringVoidReturns the image path of the template

CcoTimeOfLegendsCampaignRecord

Wrapper for a TIME_OF_LEGENDS_CAMPAIGN_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoTimeOfLegendsCampaignRecord (list)Void
LocalisedDescriptionUniStringVoid
ImagePathStringVoid
LocalisedTitleUniStringVoid
CampaignMapStringVoid
KeyStringVoid

CcoTransportedMilitaryForceRecord

Wrapper for a TRANSPORTED_MILITARY_FORCE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TooltipUniStringVoidThe tooltip associated with the transported military force record
IconStringVoidThe icon associated with the transported military force record
KeyStringVoidThe unique key identifier for the transported military force record
RecordListCcoTransportedMilitaryForceRecord (list)VoidA list of transported military force records
DurationIntVoidThe duration in rounds for the transported military force record

CcoTreasureHuntExtraInformationRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OverlayImageVoidVoid
ColourBlindModeOverlayVoidVoid
Option4ImageVoidVoid
Option3ImageVoidVoid
Option2ImageVoidVoid
Option1ImageVoidVoid
KeyVoidVoid

CcoUiColourRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionVoidVoid
TypeVoidVoid
BlueVoidVoid
GreenVoidVoid
RedVoidVoid
KeyVoidVoid
ColourVoidVoid
SetCustomColourVoidVoid
RecordListVoidVoid
CanPlayerSetVoidVoid
ShowInUiedVoidVoid
PlayerDescriptionVoidVoid

CcoUiGraphNodeClusterRecord

Record wrapper for a UI_GRAPH_NODE_CLUSTER_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUiGraphNodeClusterRecord (list)VoidReturns a list of all records from the database
SuperclusterRecordContextCcoUiGraphNodeSuperclusterRecordVoidReturns the context for this cluster's supercluster record
SortOrderIntVoidReturns the sort order of this record
DescriptionUniStringVoidReturns the localised description of this record
TitleUniStringVoidReturns the localised title of this record
ImagePathStringVoidReturns the image associated with this record
KeyStringVoidReturns the key of this record

CcoUiGraphNodeLinkRecord

Record wrapper for a UI_GRAPH_NODE_LINK_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUiGraphNodeLinkRecord (list)VoidReturns a list of all nodes from the database
ChildNodeContextCcoUiGraphNodeRecordVoidReturns a context object for the child node record
ParentNodeContextCcoUiGraphNodeRecordVoidReturns a context object for the parent node record

CcoUiGraphNodeRecord

Record wrapper for a UI_GRAPH_NODE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyStringVoidReturns the key of the node
RecordListCcoUiGraphNodeRecord (list)VoidReturns a list of all nodes from the database
LinkedNodesListCcoUiGraphNodeRecord (list)VoidReturns a list of all nodes this node is connected to
NodeTypeStringVoidReturns the type of node this is as a string
GraphStringVoidReturns the key of the graph this node belongs to
ClusterRecordContextCcoUiGraphNodeClusterRecordVoidReturns the CcoUiGraphNodeClusterRecord this node belongs to if it is part of a node cluster
InitiativeRecordContextCcoInitiativeRecordVoidReturns the CcoInitiativeRecord tied to this node if it has one
YPosIntVoidReturns the y position of the node
XPosIntVoidReturns the x position of the node

CcoUiGraphNodeSuperclusterRecord

Record wrapper for a UI_GRAPH_NODE_SUPERCLUSTER_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUiGraphNodeSuperclusterRecord (list)VoidReturns a list of all records from the database
ClusterRecordsListCcoUiGraphNodeClusterRecord (list)VoidReturns a list of all cluster records in this supercluster
SortOrderIntVoidReturns the sort order of this record
DescriptionUniStringVoidReturns the localised description of this record
TitleUniStringVoidReturns the localised title of this record
ImagePathStringVoidReturns the image associated with this record
KeyStringVoidReturns the key of this record

CcoUiMainThemeOptionRecord

Wrapper for a UI_MAIN_THEME_OPTION_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MainThemeNameUniStringVoidReturns the display name for the main theme
RecordListCcoUiMainThemeOptionRecord (list)VoidReturn list of CcoUiMainThemeOptionRecords in the database
FullscreenBackgroundColourColourVoidReturns the colour used by fullscreen background images for the main theme
ColourColourVoidReturns the colour for the main theme
MainThemeStringVoidReturns the key of the main theme record
TooltipTextUniStringVoidReturns the tooltip text for the main theme

CcoUiPurchasableEffectsToHexIdRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
TierVoidVoid
CategoryVoidVoid
HexIdVoidVoid
UnitPurchasableEffectContextVoidVoid

CcoUiUnitGroupParentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
GroupListVoidVoid
UnitListVoidVoid
MpCapVoidVoid
OrderVoidVoid
KeyVoidVoid
IconVoidVoid
OnscreenNameVoidVoid

CcoUiUnitGroupingRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
ParentGroupVoidVoid
KeyVoidVoid
IconVoidVoid
OnscreenVoidVoid
TooltipVoidVoid

CcoUiUnitStatRecord

Wrapper for a UI_UNIT_STAT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ClampDisplayedMaximumBoolVoidReturns whether the value should be clamped when above the maximum
ClampDisplayedMinimumBoolVoidReturns whether the value should be clamped when below the minimum
SortOrderIntVoidReturns the integer used to sort stats (Lower is higher priority)
MinValueIntVoidReturns the min value permitted for this stat
MaxValueIntVoidReturns the max value permitted for this stat
IconPathStringVoidReturns the icon path associated with the stat
TooltipTextUniStringVoidReturns the localised tooltip text for the stat
NameUniStringVoidReturns the localised name of the stat (Sometimes with a leading image)
KeyStringVoidReturns the key of the stat
RecordListCcoUiUnitStatRecord (list)VoidReturns a list of all CcoUiUnitStatRecords
PreviewAiStatModifierStringStringFloatReturns a string with the modifier the ai would receive from the passed in float.

CcoUiUnitStatusRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PriorityVoidVoid
KeyVoidVoid
IconPathVoidVoid
TooltipVoidVoid

CcoUnitAbilitiesAdditionalUiEffectRecord

Wrapper for a UNIT_ABILITIES_ADDITIONAL_UI_EFFECT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUnitAbilitiesAdditionalUiEffectRecord (list)Void
EffectStateStringVoid
SortOrderIntVoid
KeyStringVoid
LocalisedTextUniStringVoid

CcoUnitAbilityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
IsHiddenInUiVoidVoid
IsUnitUpgradeVoidVoid
VideoNameVoidVoid
IconNameVoidVoid
TooltipTextVoidVoid
RequiresEffectEnablingVoidVoid
KeyVoidVoid
IconPathSmallVoidVoid
IconPathVoidVoid

CcoUnitAbilityTypeRecord

Wrapper for a UNIT_ABILITY_TYPE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUnitAbilityTypeRecord (list)VoidReturns all CcoUnitAbilityTypeRecords
ShowCursorTrailBoolVoidReturns whether a cursor trail should be shown
IconPathStringVoidReturns the icon path for this ability type
DescriptionUniStringVoidReturns the localised description of this ability type (Used in tooltips)
NameUniStringVoidReturns the localised name of this ability type
KeyStringVoidReturns the key of the ability type record

CcoUnitAttributeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
IconPathVoidVoid
BulletTextVoidVoid
RemovesEffectTextVoidVoid
ImuedEffectTextVoidVoid
KeyVoidVoid

CcoUnitLandRecord

Wrapper for a UNIT_LAND_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MountRecordContextCcoMountRecordVoid
SpotDistTreeFloatVoid
EngineRecordContextCcoBattlefieldEngineRecordVoid
ExtraEnginesListCcoLandUnitsToExtraEngineRecord (list)Void
ManEntityContextCcoBattleEntityRecordVoid
VisibilitySpottingRangeMaxFloatVoid
ManAnimationsTableStringVoid
VisibilitySpottingRangeMinFloatVoid
CampaignActionPointsIntVoid
RecordListCcoUnitLandRecord (list)Void
SyncLocomotionBoolVoid
IsMaleBoolVoid
ReloadIntVoid
MountedDraughtsBoolVoid
IsCamelsBoolVoid
MoraleIntVoid
CanBraceBoolVoid
NumEnginesIntVoid
MeleeDefenceIntVoid
CanSkirmishBoolVoid
ArticulatedRecordContextCcoLandUnitArticulatedVehicleRecordVoid
MeleeAttackIntVoid
DamageModAllIntVoid
TrainingLevelVoidVoid
ChargeBonusIntVoid
BonusHitPointsIntVoid
DamageModMissileIntVoid
RankDepthIntVoid
AccuracyIntVoid
DamageModPhysicalIntVoid
PrimaryMissileWeaponContextCcoMissileWeaponRecordVoid
FactionsUnitVariantsVoidVoid
DamageModMagicIntVoid
PrimaryMeleeWeaponContextCcoMeleeWeaponRecordVoid
DamageModFlameIntVoid
KeyStringVoid
BattlePersonalitiesVoidVoid
PrimaryAmmoIntVoid
OnScreenNameKeyStringVoid
SelectionVOTertiaryVoidVoid
OnScreenNameUniStringVoid
SecondaryAmmoIntVoid
ConcealedNameUniStringVoid
HidingScalarFloatVoid
SelectionVOSecondaryVoidVoid
NumMountsIntVoid
SpotDistScrubFloatVoid
SelectionVOPrimaryVoidVoid

CcoUnitListRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
UnitsListVoidVoid
KeyVoidVoid

CcoUnitPortholeCameraSettingRecord

Wrapper for a UNIT_PORTHOLE_CAMERA_SETTING_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUnitPortholeCameraSettingRecord (list)VoidReturns list of all records of this type
TargetVector4VoidReturns x,y,z,0 of camera target
ThetaFloatVoidReturns camera theta in degrees
PhiFloatVoidReturns camera phi in degrees
FovFloatVoidReturns camera fov in degrees
DistanceFloatVoidReturns camera distance
EnvironmentFileStringVoidReturns the environment filepath to use
KeyStringVoidReturns the db records unique key

CcoUnitPurchasableEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CategoryContextVoidVoid
EffectBundleContextVoidVoid
ResourceIconVoidVoid
ResourceNameVoidVoid
ResourceCostVoidVoid
CostContextVoidVoid
KeyVoidVoid
RecordListVoidVoid

CcoUnitPurchasableEffectsCategoryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
IconPathVoidVoid
OnscreenDescriptionVoidVoid
OnscreenNameVoidVoid

CcoUnitSetRecord

Wrapper for a UNIT_SET_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUnitSetRecord (list)Void
MaxUnitExpLevelInclusiveIntVoid
MinUnitExpLevelInclusiveIntVoid
UseUnitExpLevelRangeBoolVoid
SpecialEditionMaskVoidVoid
UnitsInSetListCcoMainUnitRecord (list)Void
DevCcoStringObjectIdCcoStringVoid

CcoUnitSetToMpUnitCapRecord

Wrapper for a UNIT_SET_TO_MP_UNIT_CAP_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUnitSetToMpUnitCapRecord (list)Void
CapIntVoid
LocalisedNameUniStringVoid

CcoUnitSpecialAbilityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MiscastGlobalBonusVoidVoid
NumEffectedEnemyUnitsVoidVoid
IsMurderousProwessVoidVoid
NumEffectedFriendlyUnitsVoidVoid
ParentAbilityKeyVoidVoid
OnlyAffectTargetVoidVoid
AdditionalMissileCpVoidVoid
AlwaysAffectSelfVoidVoid
AdditionalMeleeCpVoidVoid
AffectSelfVoidVoid
MiscastChanceVoidVoid
IsPassiveVoidVoid
MinRangeVoidVoid
EffectRangeVoidVoid
ManaCostVoidVoid
WindUpTimeVoidVoid
TargetInterceptRangeVoidVoid
RechargeTimeVoidVoid
TargetGroundUnderEnemiesVoidVoid
ActiveTimeVoidVoid
TargetGroundUnderAlliesVoidVoid
NumUsesVoidVoid
BasicOptionAbilityContextVoidVoid
BaseRecordContextVoidVoid
TargetGroundVoidVoid
OverpowerOptionContextVoidVoid
TargetEnemiesVoidVoid
TargetFriendsVoidVoid
RecordListVoidVoid
ActivatedProjectileContextVoidVoid
UnitAbilityContextVoidVoid
InitialRechargeVoidVoid
TargetSelfVoidVoid
UpdateTargetsEveryFrameVoidVoid

CcoUnitsCustomBattleMountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CostVoidVoid
LocalisedDescriptionVoidVoid
IconNameVoidVoid
MountNameVoidVoid
MountedUnitContextVoidVoid
BaseUnitContextVoidVoid

CcoUnitsCustomBattlePermissionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsGeneralUnitVoidVoid
FactionContextVoidVoid
HasCustomBattleUpgradesVoidVoid
CostVoidVoid
RecordListVoidVoid
ArmoryItemListVoidVoid
IconPathVoidVoid
SetPieceCharacterContextVoidVoid
GeneralPortraitVoidVoid
SiegeUnitDefenderVoidVoid
SiegeUnitAttackerVoidVoid
UnitDetailsContextVoidVoid
UnitContextVoidVoid

CcoUnitsCustomBattleTypeCategoryRecord

Wrapper for a UNITS_CUSTOM_BATTLE_TYPE_CATEGORY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUnitsCustomBattleTypeCategoryRecord (list)Void
IsHorizontalGroupBoolVoid
CategoryKeyStringVoid
CategoryNameUniStringVoid
CategoryDescriptionUniStringVoid

CcoUnitsCustomBattleTypeRecord

Wrapper for a UNITS_CUSTOM_BATTLE_TYPE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUnitsCustomBattleTypeRecord (list)Void
SortOrderIntVoid
ColourColourVoid
LocalisedDescriptionUniStringVoid
CategoryTypeNameUniStringVoid
TypeIconStringVoid
TypeCategoryContextCcoUnitsCustomBattleTypeCategoryRecordVoid
RootTypeContextCcoUnitsCustomBattleTypeRecordVoid
BaseUnitContextCcoMainUnitRecordVoid
AlternateUnitContextCcoMainUnitRecordVoid

CcoVampireCountsConfederationRitualsToMissionRecord

Wrapper for a VAMPIRE_COUNTS_CONFEDERATION_RITUALS_TO_MISSION_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TargetFactionContextCcoCampaignFactionVoid
MissionContextCcoMissionRecordVoid
RitualContextCcoRitualRecordVoid

CcoVictoryConditionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid

CcoVideoRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PlayVideoVoidVoid
KeyVoidVoid

Callbacks

UI Update Messages

MessageAdditional Context
AdviceHistoryCleared
AgentActionPerformed
AncillaryAddedToPool
AncillaryFused
ArmyAbilityPurchased
ArmyAbilityUpgraded
AudioUiCategoriesReloaded
BattleCardsLayoutCalled
BattleConflictStarted
BattleCurrencyUpdate
BattleLocalPlayerChanged
BattleResultsCalculated
BattleSelectionChanged
BattleTimeSpeedChanged
CameraZoomChanged
Campaign::Events::DilemmaChoiceTaken
CampaignAreaOfInterestMouseOfftrue
CampaignAreaOfInterestMouseOntrue
CampaignBattleFinished
CampaignBattleFullyCompleted
CampaignBattleStarted
CampaignBuildingStateChanged
CampaignCharacterAncillaryAssigned
CampaignCharacterArmorChange
CampaignCharacterSelectedAny
CampaignCinematicModeDisabled
CampaignCinematicModeEnabled
CampaignFactionStrengthRanksUpdated
CampaignFactionTurnEndChange
CampaignForceGrowthChanged
CampaignHUDVisibilityChanged
CampaignHumanFactionChangedToAI
CampaignLocalFactionChanged
CampaignMilitaryForceDetailsChanged
CampaignNegotiationChange
CampaignProvinceGrowthChanged
CampaignRitualLockStatusChanged
CampaignRitualLockStatusChangedSpecifictrue
CampaignScriptLockChangedAny
CampaignScriptLockChanged_
CampaignSelectionChanged
CampaignSettlementSelectedAny
CampaignShroudUpdated
CampaignSlavesChanged
CampaignTechnologyResearchCancelledtrue
CampaignTechnologyResearchComplete
CampaignTechnologyResearchCompletetrue
CampaignTechnologyResearchStartedtrue
CampaignTechnologyStateChangeAny
CampaignTreasuryChanged
CampaignTurnEnd
CampaignTurnStart
CampaignUnitRecruited
CampaignUnitRecruitedtrue
CapturePointMouseOverChanged
CapturePointStickyTooltipChanged
CaravanPathChanged
CaravanSpawned
ChaoticPlanAbandonedEvent
ChaoticPlanAddedTokenEvent
ChaoticPlanChangedTokenPinEvent
ChaoticPlanCreatedEvent
ChaoticPlanCreationCanceledEvent
ChaoticPlanCreationStartedEvent
ChaoticPlanDestroyedEvent
ChaoticPlanExecutedEvent
ChaoticPlanPlacedTokenOnBoardEvent
ChaoticPlanRemovedTokenFromBoardEvent
ChaoticPlanRerolledEvent
ChaoticPlanSelectedPlanRegionEvent
ChaoticPlanSelectedPlanSchemerEvent
ChaoticPlanSelectedPlanTypeEvent
ChaoticPlanSelectedPreselectedTokenEvent
ChaoticPlanShopToggledFilter
ChaoticPlansModifiedTokensAtInventory
CharacterApReplenished
CharacterContainerChanged
CharacterContainerChangedtrue
CharacterConvalescenceChange
CharacterConvalescenceChangetrue
CharacterCreatedtrue
CharacterCreatedAny
CharacterDestroyedtrue
CharacterDestroyedAny
CharacterDetailsPanel_ModeSwitched
CharacterDetailsUnitInfoUpdated
CharacterEnterLimbo
CharacterExitLimbo
CharacterInitiativeActivationChanged
CharacterInitiativePresetActivated
CharacterInitiativePresetCompleted
CharacterMoveEndtrue
CharacterMoveEndAny
CharacterMoveStarttrue
CharacterMoveStartAny
CharacterNameChangedtrue
CharacterPostChanged
CharacterPromotedtrue
CharacterRankUp
CharacterRankUptrue
CharacterSkillsUpdate
CharacterSkillsUpdatetrue
CharacterTrainingStateChanged
CharacterTraitGained
CharacterTraitLost
CloseUnitUpgradePanel
ClosedAllPanels
ColourProfileChanged
CompassActionTriggered
CompassDirectionChanged
ContextLayoutTooltipSettingsChanged
ContextViewerCurrentSelectedContextChanged
ContextViewerInspectedContextChanged
ContextViewerRightClickPressed
ControlsChanged
CookingDishApplied
CustomBattleAutogenAvailabilityChange
CustomBattleOnArmyPresetChanged
CustomBattleOnArmyPresetPinned
CustomBattleOnAutoReadyCountdownUpdate
CustomBattleOnDisconnect
CustomBattleOnFundsChanged
CustomBattleOnHostMigrated
CustomBattleOnLobbyCreated
CustomBattleOnMapFavouritesChanged
CustomBattleOnMapPinned
CustomBattleOnNetworkPlayerImageReady" + String::format("%d
CustomBattleOnPlayerArmyChanged
CustomBattleOnPlayerArmyChangedAny
CustomBattleOnPlayerFactionChanged
CustomBattleOnPlayerFactionChangedAny
CustomBattleOnPlayerFactionChangedLocalPlayer
CustomBattleOnPlayerFactionChangedPlayer
CustomBattleOnPlayerJoined
CustomBattleOnPlayerJoinedAny
CustomBattleOnPlayerLeft
CustomBattleOnPlayerLeftAny
CustomBattleOnPlayerNameChanged
CustomBattleOnPlayerReadyChanged
CustomBattleOnPlayerReadyChangedAny
CustomBattleOnPlayerSlotAdded
CustomBattleOnPlayerSlotAddedAny
CustomBattleOnPlayerSlotRemoved
CustomBattleOnPlayerSlotRemovedAny
CustomBattleOnPlayerTeamChanged
CustomBattleOnPlayersSwapped
CustomBattleOnReadyCountdownUpdate
CustomBattleOnSettingChangedAiStats
CustomBattleOnSettingChangedAny
CustomBattleOnSettingChangedAttackDirection
CustomBattleOnSettingChangedAttackingTeam
CustomBattleOnSettingChangedBattleType
CustomBattleOnSettingChangedCorruptionChanged
CustomBattleOnSettingChangedDifficulty
CustomBattleOnSettingChangedFunds
CustomBattleOnSettingChangedIsLoadingCharactersEnabled
CustomBattleOnSettingChangedIsStormOfMagicEnabled
CustomBattleOnSettingChangedIsUsingUnitCaps
CustomBattleOnSettingChangedLargeArmies
CustomBattleOnSettingChangedLimitlessWom
CustomBattleOnSettingChangedMap
CustomBattleOnSettingChangedMultipleLordsEnabled
CustomBattleOnSettingChangedNoLordsEnabled
CustomBattleOnSettingChangedRealismMode
CustomBattleOnSettingChangedSeason
CustomBattleOnSettingChangedSplitFunds
CustomBattleOnSettingChangedTicketLimit
CustomBattleOnSettingChangedTileUpgrade
CustomBattleOnSettingChangedTimeLimit
CustomBattleOnSettingChangedTimeOfDay
CustomBattleOnSettingChangedUnitScale
CustomBattleOnSettingChangedWeather
CustomBattleOnSpectatorJoined
CustomBattleOnTeamChanged
CustomBattleOnTeamChangedAny
CustomBattleOnTeamLeaderChanged
CustomBattleOnUnitCardMouseOff
CustomBattleOnUnitCardMouseOn
CustomBattleOnUnitsChanged
CustomBattleOnUnitsChangedAny
CustomBattleOnUserCreatedMapSync
CustomBattleRecruitmentModeChanged
DevoteesEffectsChanged
DialogueBoxClosed
DilemmaChoiceTaken_
DiplomacyFactionSelectionChange
DiplomacyManipulationExecuted
DiplomacyManipulationTargetSelectionModeChanged
DiplomacyRequest
EffectsListUpdated
EnvironmentSettingChanged
EnvironmentSettingChangedincremental_autosave_enabled
EnvironmentSettingChangedsave_to_cloud
EternalDance_DanceCompleted
EternalDance_PresetActivated
EternalDance_PresetSaved
EternalDance_StepClosed
EternalDance_StepSelected
EventFeed::ClearWhiteList
EventFeed::InstantOpenFilterChanged
EventFeed::TryOpenNext
EventFeedAutoOpen
EventFeedFilterChanged
EventFeedRepopulate
FactionCapitalChangedtrue
FactionContentSeen
FactionCookedDish
FactionCookedDishSpecific
FactionDeathtrue
FactionDiplomacyChangetrue
FactionDiplomacyChangeAny
FactionDiscoveredAny
FactionFeaturesChanged
FactionInitiativeActivationChanged
FactionJoinsConfederation
FactionMercenaryPoolUpdated
FactionUpgradedDish
FavourPointsChanged
ForeignManagerCreated
ForeignSlotAdded
ForeignSlotRemoved
ForeignSlotRemovedUniquetrue
FrontEndNameRandomised
FrontendGeneralNameChanged
GridArranged
InfluenceChange
InfoPanelClosed
InfoPanelOpened
IngameMessagingNextPage
IngameMessagingPreviousPage
IngredientUnlocked
InitiativeActivationChanged
InitiativeScriptLockStatusChanged
ItemMarkedAsSeen
LabSettingsLoaded
LayoutFinished_
LevyMercenaryPoolUpdated
LoadingScreenUIDestroyed
MPLobbyOnBattleDifficultyChanged
MPLobbyOnBattleParamsChanged
MPLobbyOnBattleStatsModifierChanged
MPLobbyOnCampaignDifficultyChanged
MPLobbyOnCampaignParamsChanged
MPLobbyOnDisconnect
MPLobbyOnHostMigrated
MPLobbyOnLocalPlayerJoined
MPLobbyOnNetworkPlayerImageReady" + String::format("%d
MPLobbyOnPlayerArmyChanged
MPLobbyOnPlayerArmyChangedAny
MPLobbyOnPlayerCustomGeneralNameChanged
MPLobbyOnPlayerFactionChanged
MPLobbyOnPlayerFactionChangedAny
MPLobbyOnPlayerFactionFailed
MPLobbyOnPlayerFactionFailedAny
MPLobbyOnPlayerJoined
MPLobbyOnPlayerJoinedAny
MPLobbyOnPlayerLeft
MPLobbyOnPlayerLeftAny
MPLobbyOnPlayerNameChanged
MPLobbyOnPlayerNameChangedAny
MPLobbyOnPlayerReadyChanged
MPLobbyOnPlayerReadyChangedAny
MPLobbyOnPlayerSlotAdded
MPLobbyOnPlayerSlotAddedAny
MPLobbyOnPlayerSlotRemoved
MPLobbyOnPlayerSlotRemovedAny
MPLobbyOnPlayerTeamChanged
MPLobbyOnPlayerTeamChangedAny
MPLobbyOnPlayersSwapped
MPLobbyOnReadyCountdownUpdate
MPLobbyOnSpectatorJoined
MPLobbyOnTeamChanged
MPLobbyOnTeamLeaderChanged
MPLobbyOnUserCreatedMapSync
MapControllerZoomUpdated
MilitaryForceFactionChangetrue
MilitaryForceFactionChangeAny
MilitaryForceMercenaryPoolUpdated
MilitaryForceRecruitedAny
MilitaryForceStanceChanged
MissionEnded
MissionIssued
MissionMarkedAsSeenUpdated
MissionPinned
MissionTextChanged
MoviePlaybackFinished_
NotificationQueue::CurrentIndexChanged
NotificationQueue::Refresh::All
OnToggleableLclickDowntrue
OnToggleableLclickNotOn
PanelClosed
PanelOpened
PanelOpenedNotEvents
PendingMissionsChanged
PlagueSelectionChanged
PlayerDisconnected
PooledResourceEffectChanged
PooledResourceThresholdSetEvaluated
PooledResourceTransaction
PooledResourceTransactionSpecific
PreBattleChallengeIssued
PreBattleUnitsUpdated
PreBattleVotingUpdate
PrisonCellRefreshed
PrisonStateChanged
ProvinceGovernorshipStateChanged
ProvinceMercenaryPoolUpdated
ReadStatusUpdated
RecipeLocked
RecipeUnlocked
RefreshUI
RefreshUnitSelection
RegionInitiativeActivationChanged
Reopen_
ResourceOverrideChanged
RitualComplete
RitualComplete_
RitualStarted
ScriptObjectValueUpdated
SelectionParentNoSelectionLeft
SelectionParentSelectionChanged
SelectionPropagatorMouseoverSelectionChanged
ServiceManagerLogMessage
SettingsApplied
SettlementClimateChanged
SettlementExposedAny
SettlementFactionChangetrue
SettlementFactionChangeAny
SettlementNameChangedtrue
SettlementNameplateOffsetsPerPrimaryBuildingLevelsReloaded
SettlementTypeConversion
SharedStateChanged
SharedStateChangedSpecific_
SharedStateRemoved
SharedStateRemovedSpecific
ShowCampaignBattleResults
SlavesTransferred
SliderValueChanged_
SlotItemDragEnd
SlotItemDragStart
StagedList::ListUpdated
StormOfMagicAscendancyChange
StormOfMagicAscendancyTransitionStart
StormOfMagicSelectLore
StormOfMagicSelectLoreCompleted
SurvivalWaveUnitsUpdated
TargettingInterfaceChanged
TargettingInterfaceTargetSet
TaxLevelChanged
TeleportNetworkPanelOpened
TextInputChanged
TextInputFocusLost_
ToggleNotifications
ToggleableBuildingDestroyed
ToggleableSlotActiveChangedtrue
ToggleableSlotUpdatetrue
TransformableAgentEquipped
TransformableAgentUnlocked
TreeCreated
TrespassWarningIssued
TriggerSelectNextSpawnZone
TriggerSelectPreviousSpawnZone
UIColourChanged
UiGraphNodeLinksReloaded
UiGraphNodesReloaded
UiMainThemeReverted
UiRootSizeChanged
UiScaleChanged
UiSkinChanged
UiTextScaleSettingChanged
UnitAbilityActivationCancelled
UnitAbilityEffectAdded
UnitAbilityEffectRemoved
UnitAbilityIntensityChanged
UnitAbilityPurchased
UnitAddedToUItrue
UnitAddedToUIAny
UnitAllegianceChangedtrue
UnitAllegianceChangedAny
UnitBannerChanged
UnitBehaviourChangedtrue
UnitDisbanded
UnitEffectPurchased
UnitEffectUnpurchased
UnitExperienceGain
UnitOrderDispatchedtrue
UnitPortholeCameraSettingsReloaded
UnitRemovedFromUItrue
UnitRemovedFromUIAny
UnitTransformedtrue
UnitUpgradeGroupUiInfoReloaded
UnitUpgraded
UnitsCustomBattlePermissionsReloaded
UnitsCustomBattleTypesReloaded
UpdateAugmentsList
UpdateHexStates
UpgradeTrainUnitsRequested
UpgradeUnitsRequested
VampireMercenaryPoolUpdated
WaaaghDropDownUpdated
WarContractAccepted
WarContractCancelled
WarContractFailed
WarContractSuccess
WarCoordinationStateChanged
WarCoordinationTargetSet
WindsOfMagicGamblerVisibilityChanged
WindsOfMagicStrengthChanged
battle_purchasable
building_available_event
clear_hunting_party
commandment_available
horde_upgrade_available
hostile_slot_available_event
monster_hunt_on_show
monster_hunt_on_switch_to_tab_from_anim
negative_pooled_resource_event
negative_pooled_resource_event_
selection_changed_
selection_cleared_
siege_construction_available_event
zhao_ming_tab_requested