UI Symbols Documentation

Contexts


Campaign

CcoCampaignAncillary

Component context wrapper for a campaign ancillary

Functions

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

CcoCampaignBattle

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

Functions

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

CcoCampaignCharacter

Component context wrapper for a campaign character

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TransportedInMilitaryForceContextCcoCampaignMilitaryForceVoidReturns a CcoCampaignMilitaryForce with the force in which this character is part of (useful for getting force that an agent is part of)
IsColonelBoolVoidReturns true if this character is a colonel (temporary general until general replaced on players next turn)
TraitsListCcoCharacterTraitLevelRecord (list)VoidReturns list of CcoCampaignTrait that this character has
FactionFlagLargeStringVoidReturns the filepath for large faction flag. PREFER to use FactionFlagDirdeprecated
TurnsToResurrectionIntVoidReturns how many turns will be until character gets resurrected and is available again
DevAddAllArmoryItemsVoidVoidEnables all armory items for characterdebug, hide_in_uied
IsAgentBoolVoidReturns true if this character is an agent
UnitDetailsContextCcoUnitDetailsExpressionStateReturns the CcoUnitDetails for unit for use on unit info panel that shows unit stats from various sources
CharacterTypeIconPathStringVoidReturns the character type icon path
CanRenameBoolVoidReturns true if this character can be renamed (immortal characters cannot be renamed for example)
CanBeLoadedInCampaignBoolVoidReturns true if character can be loaded in campaign and false if can only be loaded in custom battle
CurrentXpIntVoidReturns the current raw xp value
DevReplenishApVoidVoidReplenishes action points to be fulldebug, hide_in_uied
IsInMotionBoolVoidReturns true if character is currently moving
FactionFlagSmallStringVoidReturns the filepath for small faction flag. PREFER to use FactionFlagDirdeprecated
AncillaryListCcoCampaignAncillary (list)VoidReturns list of equipped CcoCampaignAncillary
NextLevelThresholdIntVoidReturns the raw threshold level CurrentXP needs to be to reach next rank
IsFactionLeaderBoolVoidReturns true if this character is a faction leader
IsGarrisonCommanderBoolVoidReturns true if this character is the commander of a settlement garrison
DevRankUpVoidVoidRanks up the characterdebug, hide_in_uied
UnitListCcoCampaignUnit (list)VoidReturns list of CcoCampaignUnit in this characters force
IsGarrisonedBoolVoidReturns true if this character is garrisoned
GovernorshipInteractionContextCcoCampaignGovernorshipInteractionVoidReturns the CcoCampaignGovernorshipInteraction for governor related queries/commands
ComeOfAgeBoolVoidReturns true if this character is an adult
CQIIntVoidReturns the unique command queue index of the character
HasUncommitedSkillsBoolVoidReturns true if this character has skill choices made but not committed (clicked on skills but not applied by closing screen for example)
AgentSubtypeRecordContextCcoAgentSubtypeRecordVoidReturns the CcoAgentSubtypeRecord
IsAliveBoolVoidReturns true if this character is alive
EffectBundleUnfilteredListCcoEffectBundle (list)VoidReturns list of active CcoEffectBundle, without any filtering (so includes those that dont show in the UI)hide_in_uied
CategoryIconPathStringExpressionStateReturns the unit category icon path
ToggleIgnoreFromEndTurnNotificationsVoidVoidToggles adding or removing the character from the end turn notification ignore list based on whether it's already in the list or not
RankIntVoidReturns the current rank level
IsSaveableBoolVoidReturns true if character can be saved as part of persistent character feature (so can load in other campaigns or custom battle)
BreakForDebuggingVoidVoidBreaks into debugger so can inspect internal object in greater detaildebug, hide_in_uied
IsArmyBoolVoidReturns true if this character is a general of an army
RemainingTravelTimeIntVoidReturns the remaining travel time of a character
IsVisibleBoolVoidReturns true if character visible to player on map (not shrouded, hidden, etc)
SelectSkillChoiceVoidCcoCampaignCharacterSkillSelects the specified skill ready to be committed
PortraitPathStringVoidReturns portrait image path used on portholes
CanAffordMovePreviewBoolVoidReturns true if can afford to perform the current movement preview
BackgroundSkillContextCcoCampaignCharacterSkillVoidReturns to CcoCampaignCharacterSkill for the characters single background skill they start with
ActorVOIntVoidReturns the actor vo id
EffectBundleListCcoEffectBundle (list)VoidReturns list of active CcoEffectBundle, pre-filtered to only include those that should show in the UI
RenameVoidVoidBrings up a dialog to rename this character
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)
CanCharacterRankUpBoolVoidReturns true if this character can currently rank up
IsInLimboBoolVoidReturns true if character is in limbo
AgentRecordContextCcoAgentRecordVoidReturns the CcoAgentRecord
ImageCardPathStringVoidReturns portrait image path used on unit cards
IsGovernorBoolVoidReturns true if this character is governing a province
DescriptionUniStringVoidReturns localised description of the character
SubterfugeLevelIntVoidReturns the subterfuge level
MilitaryForceContextCcoCampaignMilitaryForceVoidReturns the CcoCampaignMilitaryForce if character is a general
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
SkillPointsAvailableIntVoidReturns the current amount of skill points have to spend
ClearAllSkillChoicesVoidVoidClears all skill choices currently made
IsHeirBoolVoidReturns true if this character is an heir to be faction leader
CharacterTypeNameUniStringVoidReturns localised character type (general, agent type, faction leader, etc)
ActionPointPercentFloatVoidReturns the remaining action point percent (0-1)
IsPreviewingMoveBoolVoidReturns true if currently previewing where to move for this character (holding right click down on map with character selected)
FactionFlagDirStringVoidReturns directory faction flag images live in. Use this instead of getting from faction so works correctly for rebels
LoyaltyContextCcoCampaignCharacterLoyaltyVoidReturns the CcoCampaignCharacterLoyalty
CanUseArmoryItemsBoolVoidReturns true if this character can use armory items.
ZealLevelIntVoidReturns the zeal level
FactionNameUniStringVoidReturns the factions localised name (use this instead of getting from faction so works correctly with rebels)
ArmoryItemVariantListCcoCampaignArmoryItemVariant (list)VoidReturns a list with all the armory item variants that are registered to this character.
IsOnMapBoolVoidReturns true if this character is currently on the map
FactionNameWithIconUniStringVoidReturns the factions localised name with icon (use this instead of getting from faction so works correctly with rebels)
ArmoryItemRecordListCcoArmoryItemRecord (list)VoidReturns a list with all the armory item records that are registered to this character.
CommitSkillChoicesVoidVoidCommits skills choices currently made
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
AuthorityLevelIntVoidReturns the authority level
TintColourColourVoidReturns the colour tint of the character, in wh3 this is used for daemon prince based on equipment select and alignment to gods
IsSelectedBoolVoidReturns true if this character is selected
FactionContextCcoCampaignFactionVoidReturns the CcoCampaignFaction of the character
ClearSkillChoiceVoidCcoCampaignCharacterSkillClears specified skill choice currently made
ZoomToVoidVoidZooms camera to this character
PlagueCompositionContextCcoCampaignPlagueCompositionVoidReturns a CcoCampaignPlagueComposition with the plague composition of this character, if any
CanUseAncillaryCategoryBoolCcoAncillariesCategoryRecordReturns true if this character can use the ancillary category passed in.
ActionPointsRemainingIntVoidReturns the number of action points remaining this turn
IsEffectPresentBoolStringReturns true if the specified effect key is present on the character
SkillTreeTreeDataVoidReturns the skill tree data for creating a skill tree
InitiativeSetListCcoCampaignInitiativeSet (list)VoidReturns list of CcoCampaignInitiativeSet available to character
ActionPointsPerTurnIntVoidReturns the total action points available for this character per turn
CanEquipAncillaryBoolCcoCampaignAncillaryReturns true if this character can equip the ancillary passed in.
UnitContextCcoCampaignUnitVoidReturns the CcoCampaignUnit if this character has one (if commander in army, or agent embedded in army)
SelectVoidBool (optional)Selects this character. Plays character selection voice line. Pass false to not play VO.
NameUniStringVoidReturns the localised name
PositionVector4VoidReturns the position on the map, will be VECTOR_4_ZERO if not not on map
CopyMemoryAddressToClipboardVoidVoidCopies memory address of internal character to clipboard, useful for conditional breakpointsdebug, hide_in_uied
IsActiveBoolVoidReturns true if this character is currently alive and in use on the map
IsTravellingInTeleportationNodeBoolVoidReturns true if the character is travelling in a teleportation node
IsWoundedBoolVoidReturns true if this character is wounded
AutoManagementContextCcoCampaignCharacterAutoManagementVoidReturns a CcoCampaignCharacterAutoManagement that handles auto management logic for this character
IsPlayerCharacterBoolVoidReturns true if this character belongs to the player
FactionFlagRotatedStringVoidReturns the filepath for rotated faction flag. PREFER to use FactionFlagDirdeprecated
DevKillVoidVoidKills the character, useful for dev purposes (NOTE: doesnt kill the force, use CcoCampaignMilitaryForce::DevKill for that)debug, hide_in_uied
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
IsOnScreenBoolVoidReturns true if this character is currently on screen
TeleportationSystemContextCcoCampaignCharacterTeleportationSystemVoidReturns a CcoCampaignCharacterTeleportationSystem that manages the character interacting with the teleportation network system
SelectAndZoomVoidBool (optional)Selects and zooms to this character. Plays character selection voice line. Pass false to not play VO.
RadarIconPathStringVoidReturns the icon path used for display on minimap
UpkeepIntVoidReturns the cost to maintain this character per turn (if army this is for whole army not just the individual)
SkillListCcoCampaignCharacterSkill (list)VoidReturns list of CcoCampaignCharacterSkill that are available to a character (regardless of current state)
IsOnLandBoolVoidReturns true if this character is currently positioned on land and not sea
CanOpenDetailsBoolVoidReturns true if character details can be opened for this character
CaravanContextCcoCampaignCaravanVoidReturns the CcoCampaignCaravan associated with this character if it exists
FactionFlagMediumStringVoidReturns the filepath for medium faction flag. PREFER to use FactionFlagDirdeprecated
DevEnableAllSkillsVoidVoidEnables all the characters skillsdebug, hide_in_uied
AgeIntVoidReturns the current age in years
IsIgnoredFromEndTurnNotificationsBoolVoidReturns true if character is in end turn notification ignore list

CcoCampaignCharacterSkill

Component context wrapper for a campaign character skill

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LevelsDetailsListContextListVoidReturns the list of CcoCampaignCharacterSkillLevelDetails for each level of this skill
AddPointVoidVoidAdds a point into skill. Effects not applied until committed via character
EffectUnfilteredListCcoEffect (list)VoidReturns a list of CcoEffect that we are currently providing, including those filtered out usually to not show in uihide_in_uied
TotalLevelsIntVoidReturns the max level of the skill
AbilityListContextListVoidReturns a list of CcoUnitAbility that we are currently providing
IsBackgroundSkillBoolVoidReturns true if this is a characters background skill (automatic and not chosen)
ChildSkillsListContextListVoidReturns list of CcoCampaignCharacterSkill which are child links to us (unlocked by us)
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
LevelIntVoidReturns the current level of the skill
ImagePathStringVoidReturns the image path for the skill
ParentSkillsListContextListVoidReturns list of CcoCampaignCharacterSkill which are parent links to us (we are unlocked by)
TierIntVoidReturns the y grid position
KeyStringVoidReturns the campaign skill record key
StatusStringVoidReturns the status of the skill as an unlocalised string (available, complete, locked, etc)
CharacterContextCcoCampaignCharacterVoidReturns the owning CcoCampaignCharacter for this skill
NameUniStringVoidReturns the localised name of the skill
DescriptionUniStringVoidReturns the localised description of the skill
CurrentLevelContextCcoCampaignCharacterSkillLevelDetailsVoidReturns the current CcoCampaignCharacterSkillLevelDetails active
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
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
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
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

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
IsLockedBoolVoidReturns if this skill level is currently locked
LevelIntVoidReturns the level index
RankRequiredIntVoidReturns the rank required to research this skill level
AbilityListContextListVoidReturns list of CcoUnitAbility provided by this skill level
UnitAttributeListContextListVoidReturns a list of CcoUnitAttributeRecord provided by this skill level
EffectListContextListVoidReturns list of CcoEffect provided by this skill level

CcoCampaignEventFeed

Context wrapper for the event feed

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NextAutoOpenEventContextCcoCampaignEventFeedMessageDetailsVoidReturns the context of the next auto open event if any
EventGroupListCcoCampaignEventFeedGroup (list)VoidReturns a list of event groups

CcoCampaignFaction

Wrapper for a campaign faction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
StrengthValueIntVoidReturns the strength value used to evaluate a factions strength rank amongst all factions
FactionFlagRotatedStringExpressionStateReturns faction flag rotated icon path - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied
ActiveMissionListCcoCampaignMission (list)VoidReturns the list of active missions
SubcultureContextCcoSubcultureRecordVoidReturns the CcoSubcultureRecord for this faction
DevAddAllAncillariesVoidVoidEnables all ancillaries for characterdebug, hide_in_ui
IsCampaignFeatureAvailableBoolExpressionState, StringReturns true if the specified campaign feature key is available for this faction
FactionWomCompassContextCcoCampaignFactionWomCompassVoidReturns the faction CcoCampaignFactionWomCompass context if this faction can use the winds of magic compass feature
HasTradeAgreementBoolVoidReturns true if faction has a trade agreement with the player
ProvinceListCcoCampaignProvince (list)VoidReturns a list of provinces this faction has a stake in
FactionInteractionContextCcoCampaignFactionInteractionCcoCampaignFactionReturns the faction CcoCampaignFactionInteraction context with supplied target faction (for things like war coordination, loan armies, etc)
FactionRecordContextCcoFactionRecordVoidReturns the CcoFactionRecord for this faction
CanUseMortuaryCultsBoolVoidReturns true if can use mortuary cults functionality (tomb kings usually use this on warhammer)
FactionFlagSmallStringExpressionStateReturns faction flag small icon path - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied
FoodTotalIntVoidReturns the total amount of food the faction has
IsEffectPresentBoolExpressionState, StringReturns true if a specified effect key is present on a faction
MissionListCcoCampaignMission (list)VoidReturns list of current active missions for this faction
FactionFlagMediumStringExpressionStateReturns faction flag medium icon path - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied
FactionCaravansContextCcoCampaignFactionCaravansVoidReturns the faction CcoCampaignFactionCaravans context if this faction can use the caravans system
DevEnableAllTechVoidVoidResearches all techs for the faction instantlydebug, hide_in_ui
ModelFactionContextCcoCampaignModelFactionVoidReturns the CcoCampaignModelFaction for this faction
IsEnemyBoolVoidReturns true if faction is an enemy of the player
SettlementListCcoCampaignSettlement (list)VoidReturns a list of settlements owned by this faction
IsFactionFeatureAvailableBoolExpressionState, StringReturns true if the specified faction feature key is available for this faction
CQIIntVoidReturns the command queue index for the faction
PinnedMissionListCcoCampaignMission (list)VoidReturns list of the missions currently pinned for this faction
IsResearchingTechBoolVoidReturns true if this faction is currently researching a tech
RitualChainContextFromKeyCcoCampaignRitualChain (list)StringReturns list of ritual chains matching given key
CookingSystemCcoCookingSystemVoidReturns the faction's cooking system
CanPerformRitualsBoolVoidReturns true if this faction can currently perform rituals
FactionLevelIntVoidReturns the factions 'level' which determines things like how many armies can field, etc
AcceptPendingMissionVoidStringAccepts the specified pending mission (contract)
ClimatesListCcoSettlementClimateTypeRecord (list)StringReturns the list of climates that are applicable to this faction based on the supplied suitability key
PrisonSystemCcoPrisonSystemVoidReturns the faction's prison system
AttitudeTooltipUniStringVoidReturns a localised string with the attitude towards the player (friendly, hostile etc)
IsRebelFactionBoolVoidReturns true if faction is a rebel faction
RitualChainContextFromCategoryCcoCampaignRitualChain (list)StringReturns list of ritual chains for given ritual category string
AttitudeCategoryIntVoidReturns the attitude category with the players faction (hostile->friendly)
SalvageAncillariesVoidContextListSalvages all the ancillaries passed into the context list
IsTechSelectNeededBoolVoidReturns true if this faction is not currently researching a tech but has the ability to do so (reminder for end turn)
PooledResourceListCcoCampaignPooledResource (list)VoidReturns the list of all pooled resources for the faction
NumAncillariesAllowedPerCharacterForFactionIntStringReturns the number of ancillaries that can be equipped into this category per category for a (optionally provided) faction, e.g. 3 for runes
OpenDiplomacyWithVoidVoidStarts negotiation with this faction
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
IsIdleHumanBoolVoidReturns true if this faction used to be controlled by human but the player has disconnected from the game
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
IncomeIntVoidReturns the amount of income per turn this faction is earning
NameUniStringExpressionStateReturns name of faction
FactionGovernorshipContextCcoCampaignFactionGovernorshipVoidReturns the faction governorship context, manager responsible for all governor functionality
AutoManagementBudgetPercentageFloatVoidReturns the percentage of the faction's treasury that's being used for auto managing provinces/characters
IsSameFactionBoolCcoCampaignFactionReturns true if the specified faction is the same as this one
FactionsKnownListCcoCampaignFaction (list)VoidReturns a list of all the factions this faction knows (that it can see in diplomacy basically)
BreakForDebuggingVoidVoidAllows to step into code to fully inspec model side FACTION objectdebug, hide_in_uied
NameWithIconUniStringExpressionStateReturns name of faction with faction flag as image tag next to it
RenameVoidVoidRenames the faction to the given name, opens a text prompt to do so)
TreasuryAmountIntVoidReturns the current treasury amount of this faction
PooledResourceManagerContextCcoCampaignPooledResourceManagerVoidReturns the pooled resource manager which manages all responsibility for pooled resources on a faction
EnemiesCountIntVoidReturns the number of enemies that this faction has
WasConfederatedBoolVoidReturns if the faction was confederated by another faction
AllianceColourColourVoidReturns the colour based on alliance to local player (as in colour based on player/ally/enemy/neutral)
ParentFactionContextCcoCampaignFactionVoidReturns the parent faction (for waagh factions)
TechnologyListCcoCampaignTechnology (list)VoidReturns a list of all technologies linked to this faction (regardless of state)
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
AncillaryListCcoCampaignAncillary (list)VoidReturns list of all ancillaries in the faction ancillary pool, plus any assigned ones on the characters from this faction.
TechnologyTreeTreeDataCcoTechnologyUiTabRecord (optional)Returns a TreeCallback with all the technologies for this faction
ZoomToVoidVoidZooms to the faction, tries capital first, then faction leader, then first character on map
InitiativeSetListCcoCampaignInitiativeSet (list)VoidReturns the list of available initiative sets
RitualContextForKeyCcoCampaignRitualStringReturns the specified CcoCampaignRitual for a faction given a ritual key
IsHumanBoolVoidReturns true if this faction is currently under human control
SlavesAmountIntVoidReturns the current number of slaves the faction has
DiplomacyManipulationInfoListCcoCampaignDiplomacyManipulationInfo (list)VoidReturns list of the diplomacy manipulation infos, if the faction has any.
TechnologyUiGroupListCcoTechnologyUiGroupRecord (list)VoidReturns a TreeCallback with all the ui groups that exists for the technologies in this faction(if any)
TechnologyResearchPointsIntVoidReturns how many tech research points this faction has (the percentage which determines how quickly they research tech)
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
ActiveMissionCountIntArgumentPackReturns the number of active missions if no args, or number of active mission matching any of the mission category strings passed in
PooledResourceContextCcoCampaignPooledResourceStringReturns the specified CcoCampaignPooledResource given a pooled resource key if it exists
CanCaptureTerritoryBoolVoidReturns true if faction can capture territory (so not a horde faction)
TechnologyManagerContextCcoCampaignTechnologyManagerVoidReturns the context of the faction technology manager if the faction has one
UnlockableRitualListCcoCampaignRitual (list)ArgumentPackReturns the list of rituals not yet unlocked for a faction. Deprecated, please use the ritual manager insteaddeprecated
ChildFactionContextCcoCampaignFactionVoidReturns child faction (for waagh parents)
AlliesCountIntVoidReturns the number of allies that this faction has
IsVassalOfPlayerBoolVoidReturns if the faction is vassal of the player
MilitaryForceListCcoCampaignMilitaryForce (list)VoidReturns the list of all military forces in the faction
IsDeadBoolVoidReturns true if this faction has been killed
PendingMissionListCcoCampaignMission (list)VoidReturns list of pending missions that are available to opt in to (contracts)
RitualManagerContextCcoCampaignRitualManagerVoidReturns the context of the faction ritual manager if the faction has one
PrimaryColourColourVoidReturns the primary colour for this faction
UnitCapForUnitIntCcoMainUnitRecordReturns unit cap for provided main unit record for this faction
IsPlayersFactionBoolVoidReturns true if this is the players faction
AllianceStateStringVoidReturns the alliance state with the players faction
CharacterListCcoCampaignCharacter (list)VoidReturns the list of all characters in the faction
PositionVector4VoidReturns the faction position, depending on if the current campaign is the prologue
FactionLeaderContextCcoCampaignCharacterVoidReturns the CcoCampaignCharacter of the factions current leader
HasPendingActionBoolVoidReturns true if faction has an active battle or pending action, used to report that a player is blocking gameplay in simultaneous turns
PlaguesCompositionSystemContextCcoCampaignPlaguesCompositionSystemVoidReturns the plague system of the faction if it exists
CharacterTrainingActiveDilemmaListCcoCharacterTrainingDilemmaRecord (list)VoidReturns the list of active training group dilemmas
UnitCapForAgentIntCcoAgentRecordReturns unit cap modifier for provided agent record for this faction
AvailableRitualListCcoCampaignRitual (list)ArgumentPackReturns the list of available rituals for a faction (alreay unlocked). Deprecated, please use the ritual manager insteaddeprecated
HasValidPositionBoolVoidReturns true if faction has a valid position
CapitalSettlementContextCcoCampaignSettlementVoidReturns the CcoCampaignSettlement of the factions capital (home region)
IsFactionsTurnBoolVoidReturns true if it is currently this factions turn
CorruptionCounterContextCcoCampaignCorruptionCounterVoidReturns the context of the corruption counter for this faction if it exists
ControllableMilitaryForceListCcoCampaignMilitaryForce (list)VoidReturns the list of all controllable military forces (non-caravan & non-garrison) in the faction
StrengthRankIntVoidReturns the rank amongst all current active factions in terms of strength
IsBankruptBoolVoidReturns true if the players faction currently has negative funds
CurrentTechContextCcoCampaignTechnologyVoidReturns the current technology being researched
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)
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
CanIssueTrespassWarningBoolCcoCampaignFactionReturns true if can send faction a trespass warning (if cooldown expired since last did this or havent done yet)
DiscoveredProvinceListCcoCampaignProvince (list)VoidReturns a list of provinces this faction has discovered
FactionIconStringVoidReturns faction flag icon path - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied
TrespassWarningCooldownIntVoidReturns how many turns until can issue trespass warning again (cooldown)
FactionFlagDirStringExpressionStateReturns directory for faction flag icons - append image name including extension for use in setting images
TradeStateStringVoidReturns trade state with players faction
HasEnoughSlavesBoolIntReturns true if specified amount of slaves are available
SetAutoManagementBudgetPercentageVoidFloatSets the auto management budget to use the percentage passed in of the faction's treasury
MainRivalDiplomaticThreatLevelContextCcoDiplomacyThreatLevelVoidReturns the faction CcoDiplomacyThreatLevel for the faction this faction considers its main threat (only for AI, returns null for human players)
CharacterTrainingGroupListCcoCampaignCharacterTrainingGroup (list)VoidReturns the list of character training groups
NetworkPlayerContextCcoNetworkPlayerVoidReturns the network player that is controlling this faction (humans steam info)
IsAllyBoolVoidReturns true if faction is an ally of the player
FactionInteractionListCcoCampaignFactionInteraction (list)VoidReturns the list of faction interactions with all factions have interactions setup with (for things like waagh)
TurnIndexIntVoidReturns the index of this faction in the end turn process (which turn is theirs)
DevToggleHumanVoidVoidToggles whether faction played by human or AIdebug, hide_in_ui
CultureContextCcoCultureRecordVoidReturns the CcoCultureRecord for this faction
FactionFlagLargeStringExpressionStateReturns faction flag large icon path - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied

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
SetTargetVoidContextSelects a war coordination target (CcoCampaignMilitaryForce or CcoCampaignSettlement)
TargetFactionContextCcoCampaignFactionVoidThe target faction interacting with
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)
ReverseInteractionContextCcoCampaignFactionInteractionVoidReturns the interaction the opposite way around (so can see requests in opposite direction, etc)
ToggleTargettingVoidVoidToggles targetting mode on/off to pick a target
SourceFactionContextCcoCampaignFactionVoidThe source faction (usually player)
WarCoordinationPendingRequestsListCcoCampaignWarCoordinationRequest (list)VoidAdd favour points for dev functionality, can be positive or negative
IsValidTargetBoolContextReturns true if supplied context is a valid war coordination target (CcoCampaignMilitaryForce or CcoCampaignSettlement)
ZoomToTargetVoidVoidZooms the camera to the current war coordination target
FavourPointsCostForTargetIntContextReturns the favour point cost to set a particular war coordination target (CcoCampaignMilitaryForce or CcoCampaignSettlement)
LoanMilitaryForceVoidCcoCampaignMilitaryForceLoans the specified force of the target faction to the source faction
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
EnableTargettingVoidBoolSets the targetting mode on/off as specified to pick a target
InvalidReasonsForTargetUniStringContextReturns the reasons if any as a localised string of why you cannot target a specified attack target (CcoCampaignMilitaryForce or CcoCampaignSettlement)
FavourPointsCostToLoanMilitaryForceIntCcoCampaignMilitaryForceReturns the favour point cost to loan the specified force from the target to the source faction
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
SharedEnemyListCcoCampaignFaction (list)VoidReturns a list of enemies common to both the source and target faction who can target with war coordination
MilitaryForcesToLoanListCcoCampaignMilitaryForce (list)VoidReturns a list of military forces available to loan from target faction to source faction
MilitaryForcesLoanedListCcoCampaignMilitaryForce (list)VoidReturns a list of military forces loaned from the target to the source faction
CurrentTargetContextContextVoidReturns the current target to attack or defend for war coordination (CcoCampaignMilitaryForce or CcoCampaignSettlement)
ToggleTargettingForTypeVoidStringEnables targetting with the passed in option type
FavourPointsChangePerTurnIntVoidHow many favour points generate each turn (determined by relationship have between factions)
IsWarCoordinationAvailableBoolVoidReturns true if the source and target faction have war coordination available (military allies)
NumAvailableWarCoordOptionsIntVoidReturns the number of available war coord options, used for sorting
AlliedBuildingsContextCcoCampaignFactionAlliedBuildingsVoidGets the CcoCampaignFactionAlliedBuildings context to deal with outposts
HasAnyValidTargetToPickBoolString (optional)Returns true if we have anything we can actually target now. Can optionally pass the targetting type(OFFENSIVE, DEFENSIVE, OCCUPY)
IsWarTargettingAllowedBoolVoidReturns true if can ever use war targetting (only disabled between human players at the minute)
FavourPointsIntVoidHow many favour points have to spend between factions to pay for actions such as war coordination or requesting armies
OpenWarCoordinationPanelVoidString (optional)Opens up the war coordination panel, pass a specific tab key to select that section otherwise defaults to first available

CcoCampaignMilitaryForce

Component context wrapper for a campaign military force

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanPlayerLoanBoolVoidReturns true if this force can currently be loaned to the player by the forces owning faction
WinStreakListCcoCampaignWinStreak (list)VoidReturns list of CcoCampaignWinStreak
EnableFixedCampAreaOfInfluencePreviewVoidBoolIf true, enables preview of visualisation for how large fixed camp area of influence would be if deployed in current position (false disables it)
CampRequiredResourceCostContextCcoCampaignResourceTransactionStringReturns the CcoCampaignResourceTransaction for spawning a camp for the specified spawnable_force_key
IsSufferingAttritionBoolVoidReturns true if this force is suffering attrition and will take damage in the next turn
CombatComparisonStrengthRelativeToForceFloatCcoCampaignMilitaryForceReturns a percentage of relative strength againt specified force (where 1 is will definately beat and 0 is definately will lose)
FactionFlagRotatedStringVoidReturns the filepath for rotated faction flag.deprecated
ParentForceContextCcoCampaignMilitaryForceVoidReturns the CcoCampaignMilitaryForce of the parent army (for waagh parent)
IsNotGarrisonForceBoolVoidReturns true if this force is not a garrison army
PooledResourceListCcoCampaignPooledResource (list)VoidReturns the list of CcoCampaignPooledResource attached to this force
ZoomToVoidVoidZooms to the military force
StancePreviewPercentCostFloatVoidReturns the percentage AP cost to switch to specified stance (0-1)
IsTrespassingAgainstPlayerBoolVoidReturns true if this force is trespassing on the players territory
ArmyPlagueContextCcoCampaignArmyPlagueVoidReturns the CcoCampaignArmyPlague for any plague present
WarCoordinationTargetterListContextListVoidReturns list of contexts who are targetting us (mix of factions and armies as war coordination can be on both these levels)
IsFixedCampBoolVoidReturns true if this force is a fixed camp (like ogre camps in wh3)
ForceEffectListCcoEffect (list)VoidReturns current active list of CcoEffect coming from force itself
IsSelectedBoolVoidReturns true if this force is selected
FactionFlagMediumStringVoidReturns the filepath for medium faction flag.deprecated
WarCoordTargettingContextCcoCampaignMilitaryForceWarTargettingVoidReturns the CcoCampaignMilitaryForceWarTargetting for handling setting war coordination targets
HealthPercentFloatVoidReturns current hp percentage of recruited units against their max health (0-1)
HasPlagueBoolVoidReturns true if this force has a plague attached
ChildForceContextCcoCampaignMilitaryForceVoidReturns the CcoCampaignMilitaryForce of any child armies (for waagh children)
AverageHealthPercentageFloatVoidReturns the average health percentage of units (0-1)
CanSpawnForceBoolStringReturns true if this force can spawn the specified spawnable_force_key
IsRaidingBoolVoidReturns true if this force is raiding
FactionFlagLargeStringVoidReturns the filepath for large faction flag.deprecated
LocationEffectListCcoEffect (list)VoidReturns current active list of CcoEffect coming from current location
ForceTypeStringVoidReturns a string with the type of the military force
LoanTurnsRemainingIntVoidReturns the number of turns remaining until loan is over and will return to FactionLoanedFromContext if any (0 if not on loan)
ActiveStanceContextCcoCampaignMilitaryForceStanceVoidReturns the current selected CcoCampaignStance
IsPreviewingStanceBoolVoidReturns true if this force is currently previewing an alternative stance (mousing over a stance choice for example)
FactionFlagSmallStringVoidReturns the filepath for small faction flag.deprecated
PooledResourceContextCcoCampaignPooledResourceStringReturns the specified CcoCampaignPooledResource by record key
EffectBundleUnfilteredListCcoEffectBundle (list)VoidReturns current active list of CcoEffectBundle, without any filtering (so includes those that dont show in the UI)hide_in_uied
CanSwitchToPreviewStanceBoolVoidReturns true if this force can switch to the current stance being previewed
TrespassGracePeriodIntVoidReturns the number of turns until war can be declared without penalty on an army if it does not vacate your territory
IsAgentEmbeddedBoolVoidReturns true if this force has an agent embedded within
SiegeTurnsRemainingIntVoidReturns the number of turns remaining before settlement sieging falls without a fight (if sieging)
CharacterListCcoCampaignCharacter (list)VoidReturns list of CcoCampaignCharacter in this force
UnitCountPercentFloatVoidReturns the percentage unit count of current units against max can have (0-1)
DevHealVoidVoidReplenishes the force, useful for dev purposesdebug, hide_in_uied
WillReplenishThisTurnBoolVoidReturns true if this force is replenishing and will increase in health in next turn
CQIIntVoidReturns the command queue index (unique id of force)
MoraleContextCcoCampaignMilitaryForceMoraleVoidReturns the CcoCampaignMilitaryForceMorale
TrespassWarningIsIssuedBoolVoidReturns whether a trespass warning has been issued by the player to this military force
StanceListCcoCampaignMilitaryForceStance (list)VoidReturns the available CcoCampaignStance (that force can ever do, not just available right now)
EffectBundleListCcoEffectBundle (list)VoidReturns current active list of CcoEffectBundle, pre-filtered to only include those that should show in the UI
DisbandVoidVoidDisbands the entire force essentially killing it
FactionContextCcoCampaignFactionVoidReturns the CcoCampaignFaction this force belongs to
UnitListCcoCampaignUnit (list)VoidReturns list of CcoCampaignUnit in this force
TooltipForCanLoanStatusUniStringVoidReturns a tooltip displaying information relating to whether an army can be loaned
UpkeepIntVoidReturns the cost per to turn to keep this force active
IsLayingAmbushBoolVoidReturns true if this force is currently in ambush stance
PositionVector4VoidReturns the map position of the force
DevSetDebugMoraleEffectValueVoidIntSets morale debug effect value for increasing/decreasing moraledebug, hide_in_uied
IsHordeBoolVoidReturns true if this force is a horde
RaidingIncomeIntVoidReturns the amount of income this force is providing in via raiding
DevKillVoidVoidKills the force, useful for dev purposesdebug, hide_in_uied
FactionLoanedFromContextCcoCampaignFactionVoidReturns the CcoCampaignFaction that we were loaned from if any
SoldierCountIntVoidReturns the number of current entities
SpawnForceVoidStringSpawns the specified spawnable_force_key if possible
TooltipForSpawnForceUniStringStringReturns the tooltip for spawning a force using supplied spawnable_force_key
CommandingCharacterContextCcoCampaignCharacterVoidReturn the CcoCampaignCharacter for the commanding character who is leading the force
SettlementContextCcoCampaignSettlementVoidReturns the CcoCampaignSettlement we are in if any
IsLayingSiegeBoolVoidReturns true if this force is currently besieging a settlement
DevAddDevPointVoidVoidAdds development points for hordesdebug, hide_in_uied
AITargetListContextListVoidReturns list of targets the AI is targetting (forces/settlements)
HordeContextCcoCampaignMilitaryForceHordeVoidReturns the CcoCampaignMilitaryForceHorde for getting horde specific info like settlements etc
AutoresolvePredictionInaccuracyPercentFloatCcoCampaignMilitaryForceReturns a percentage of inaccuracy the general calculating correct CombatComparisonStrengthRelativeToForce. Larger battles and lower general rankings make this larger. (0-1)
NameUniStringVoidReturns the localised name
PlagueEffectBundleListCcoEffectBundle (list)VoidReturns the list of CcoEffectBundle provided by the plague on this army
IsNavalTransportBoolVoidReturns true if this force is a naval transport
UnitCountIntVoidReturns the number of units recruited
IsGarrisonedBoolVoidReturns true if this force is currently inside a settlement
IsTransportedArmyBoolVoidReturns whether a this force is a transported army
FactionNameUniStringVoidReturns the factions localised name (use this instead of getting from faction so works correctly with rebels)
ReturnLoanedArmyVoidVoidIf the army is a loaned army, returns them to their lending faction
PooledResourceManagerContextCcoCampaignPooledResourceManagerVoidReturns the CcoCampaignPooledResourceManager for calculating pooled resource costs
CanShowBalanceOfPowerPreviewBoolCcoCampaignMilitaryForceReturns true if can show the balance of power preview for the supplied army against this current army

CcoCampaignMission

Component context wrapper for a CAMPAIGN_MISSION

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsPrologueStoryMissionBoolVoidReturns true if this is a story line mission for prologue, we show some special fx on events related to these
MissionIssuerContextCcoMissionIssuerRecordVoidReturns the mission issuer context for this mission
ShouldShowTeleportButtonBoolVoidReturns whether to show the teleport button for this mission
TurnsRemainingIntVoidReturns the number of turns remaining for this mission
IsTeleportEnabledBoolVoidReturns whether teleport is enabled for this mission
QuestBattleWinChanceFloatVoidReturns the chance of winning the quest battle associated with this mission
IsQuestBoolVoidReturns whether the mission is a quest
TeleportReasonTooltipUniStringVoidReturns the teleport reason tooltip for the mission. Why you can or cannot teleport
IsPinnedBoolVoidReturns whether the mission is pinned
CompletionStatusIntVoidReturns the completion status. 0 Active, 1 Succeeded, 2 Cancelled, 3 Expired
IsCancelledBoolVoidReturns whether the mission is cancelled
ImagePathStringVoidReturns the file path to the image for this mission
CompletedBoolVoidReturns whether the mission is completed
MoviePathStringVoidReturns the file path to the movie for this mission
CancelMissionVoidVoidCancels this mission
IsObjectivePanelOpenBoolVoidReturns whether the objective panel is open
HasZoomLocationBoolVoidReturns whether the mission has a zoom location
TargetCharacterContextCcoCampaignCharacterVoidReturns the target character if any (if character part of objectives like to kill character)
ZoomToLocationVoidVoidZooms the camera to the location of this mission
BattleSetPieceArmyListCcoBattleSetPieceArmyRecord (list)VoidReturns a list with the armies in the battle piece setup
ShowObjectivePanelVoidVoidShows the mission panel
BattleSetupInfoContextCcoBattleSetupInfoVoidReturns the battle setup info context for this mission
ShowMissionPanelVoidVoidShows the mission panel with this mission selected
QuestCharacterContextCcoCampaignCharacterVoidReturns the quest character context if this mission is a quest battle
TeleportCharacterVoidVoidTeleports the selected character or character associated with this mission to the quest battle for this mission
PositionVector4VoidReturns the position of this mission on the campaign map
MissionRecordContextCcoMissionRecordVoidReturns the mission record context for this mission
FactionContextCcoCampaignFactionVoidReturns the faction context for this mission
PinMissionVoidVoidPins this mission
IsVictoryConditionBoolVoidReturns whether this mission is a campaign victory condition
CanBeCancelledBoolVoidReturns true if the mission can be cancelled
MissionDefinitionContextCcoCampaignMissionDefinitionVoidReturns the mission definition context for this mission

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

CcoCampaignPooledResource

Wrapper for a campaign pooled resource

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PendingFactorsNameUniStringVoidReturns the localised name given for the pending factors
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
PercentageOfCapacityFloatExpressionStateReturns the current percentage the value is of the max
FactorTotalIntVoidReturns the total of all the current factors (not same as total, as factors could be leading to Total changing per turn)
NameUniStringVoidReturns the localised name
PendingFactorTotalIntVoidReturns the total of the pending factor list
NegativeFactorTotalIntVoidReturns the total of all the current negative factors
OwningFactionContextCcoCampaignFactionVoidReturns the faction that owns this context if any
SortOrderIntVoidReturns the sort order for this pooled resource (for when have multiple linked pooled resources like corruption)
PercentageToNextEffectFloatExpressionState, String (optional)Returns the percentage of the way to the next effect
TotalIntExpressionStateReturns the current total value (not factor total, this is the current amount)
PositiveFactorTotalIntVoidReturns the total of all the current positive factors
SettlementBreakdownContextCcoCampaignPooledResourceSettlementBreakdownCcoCampaignSettlementReturns the breakdown context for this pooled resource on the specified settlement
MinIntVoidReturns the minimum value
NegativePendingFactorListCcoStringValue (list)VoidReturns a list of the pending factors that can be negative (but aren't necessarily currently)
MaxIntVoidReturns the maximum value
MilitaryForceBreakdownContextCcoCampaignPooledResourceMilitaryForceBreakdownCcoCampaignMilitaryForceReturns the breakdown context for this pooled resource on the specified military force
InitialMaxIntVoidReturns the maximum value specified in the record, so that we can display the original value even after getting changed by effects
TotalLessThanZeroAndNotCertainResourcesBoolExpressionStateReturns true if this pooled resource has a negative total and isnt specific hardcoded resources (sigh, added in wh2)
ProvinceBreakdownContextCcoCampaignPooledResourceProvinceBreakdownCcoCampaignProvinceReturns the breakdown context for this pooled resource on the specified province
PendingFactorListCcoStringValue (list)VoidReturns the list of pending factors that will be added to the value in the next turn
ShouldDisplayZeroFactorsBoolVoidReturns true if the resource should always display zero factors
PositivePendingFactorListCcoStringValue (list)VoidReturns a list of the pending factors that can be positive (but aren't necessarily currently)
AvailableThresholdSetListCcoPooledResourceThresholdOperationSetRecord (list)VoidReturns a list of available threshold sets, which have a range that confers effects and armory items
PositiveFactorListCcoStringValue (list)VoidReturns a list of the factors that can be positive (but aren't necessarily currently)
ActiveThresholdSetListCcoPooledResourceThresholdOperationSetRecord (list)VoidReturns a list of active threshold sets, which have a range that confers effects and armory items
NegativeFactorListCcoStringValue (list)VoidReturns a list of the factors that can be negative (but aren't necessarily currently)
IsPersistentResourceBoolVoidReturns true if this pooled resource has persistant factors (as in they arent evaluated per turn and instead stockpile)
AchievementThresholdSetListCcoPooledResourceThresholdOperationSetRecord (list)VoidReturns a list of thresholds that can be unlocked with achievements
NextGroupPooledResourceEffectContextCcoGroupPooledResourceEffectRecordExpressionState, String (optional)Returns the next CcoGroupPooledResourceEffectRecord. Optionally can specify an effect type, defaults to percentage of capacity effect type
FactorListCcoStringValue (list)VoidReturns list of factors that are contributing to current value
RangedTierListCcoRangeWithContext (list)VoidReturns a list of effects with tiers so can see effects at each tier of values
KeyStringVoidReturns the record key
IconPathStringVoidReturns the icon filepath
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
NegativeFactorsNameUniStringVoidReturns the localised name given for the negative factors
CurrentGroupPooledResourceEffectContextCcoGroupPooledResourceEffectRecordExpressionState, String (optional)Returns the current CcoGroupPooledResourceEffectRecord. Optionally can specify an effect type, defaults to percentage of capacity effect type
DescriptionUniStringVoidReturns the localised description
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)
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
PredictedPercentageOfCapacityFloatVoidReturns the prediced percentage value of max on the next turn
PositiveFactorsNameUniStringVoidReturns the localised name given for the positive factors
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
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

CcoCampaignProvince

Wrapper for a campaign province.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsSelectedBoolVoidReturns true if any settlement in this province is selected.
SelectAndZoomVoidVoidSelects and zooms to a settlement in this order: player capital, player owned settlement, province capital.
DevAddDevPointVoidVoidDev command that adds development points to this province.debug, hide_in_uied
NameUniStringVoidReturns the localised name of the province.
WindsOfMagicAreaContextCcoCampaignWindsOfMagicAreaVoidReturns the context of the winds of magic area in this province.
SettlementListContextListVoidReturns the settlement list in the province.
ProvinceManagerForFactionCcoCampaignFactionProvinceManagerCcoCampaignFactionReturns the context of the province manager of the faction that is passed in, if it exists in this province.
PooledResourceManagerContextCcoCampaignPooledResourceManagerVoidReturns the context of the pooled resource manager of this province, which can calculate if the province can afford transactions.
PooledResourceListContextListVoidReturns a list with all the pooled resources from this province.
LocalPlayerProvinceManagerContextCcoCampaignFactionProvinceManagerVoidReturns the context of the local player province manager, if this exists in this province.
CQIIntVoidReturns an int with the cqi of this object.
PooledResourceContextCcoCampaignPooledResourceStringReturns the context of the pooled resource with the key specified, if this resource exists in the province.
IsPlayerCompleteOwnerBoolVoidReturns true if player owns all the settlements in the province
CapitalSettlementContextCcoCampaignSettlementVoidReturns the context of the capital settlement of this province
IncomeIntVoidReturns the income that this province generates
IsPlayerInvolvedBoolVoidReturns true if the player faction own any regions in this province.
ZoomToVoidVoidZooms to capital of province
IsContestedBoolVoidReturns true if it's being contested by another faction.
FactionContextCcoCampaignFactionVoidReturns the faction that owns all settlements in the province. If there is no such faction, returns nullptr
NumRegionsIntVoidReturns an int with the number of regions in the province.
ModelProvinceContextCcoCampaignModelProvinceVoidReturns the CcoCampaignModelContext for this province
MercenaryPoolContextCcoCampaignProvinceMercenaryPoolVoidReturns the context of mercenary pool of this province

CcoCampaignRoot

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DevTriggerDilemmaVoidStringTriggers dilemma for player faction, only for dev usagedebug, hide_in_uied
WindsOfMagicSystemCcoCampaignWindsOfMagicSystemVoidReturns the winds of magic system
CanCycleSelectionBoolVoidReturns true if can currently cycle selection
DevTriggerMissionVoidStringTriggers mission for player faction, only for dev usagedebug, hide_in_uied
CampaignFactionCheatSheetListCcoCampaignFactionCheatSheetEntryRecord (list)VoidReturns list of CcoCampaignFactionCheatSheetEntryRecords for the player faction's cheat sheet
IsHUDVisibleBoolVoidReturns true if the campaign HUD is currently visible
CampaignMapPlayableAreaRecordContextCcoCampaignMapPlayableAreaRecordVoidReturns the CcoCampaignMapPlayableAreaRecord for the current campaign
DevTriggerIncidentVoidStringTriggers incident for player faction, only for dev usagedebug, hide_in_uied
NetworkPlayerListCcoNetworkPlayer (list)VoidReturns list of all the human players in the current mp game
IsPrologueBoolVoidReturns true if the current campaign is the prologue
IsMultiplayerBoolVoidReturns true if campaign is multiplayer
ShowEscapeMenuVoidVoidShows the campaign escape menu
OpenTeleportationNodeListCcoTeleportationNetworkNodeRecord (list)VoidReturns list of the teleportation nodes that are currently open
IsPlayersTurnBoolVoidReturns true if currently the players turn
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
ProvinceListCcoCampaignProvince (list)VoidReturns list of all provinces in the campaign
EndTurnVoidVoidEnds the current campaign turn
DevEndTurnJustForMeVoidVoidEnds the current campaign turn just for local player, skips all other factions turn. Only for dev usage.debug, hide_in_uied
YearIntVoidReturns the current year as a number
AreaOfInterestListCcoCampaignAreaOfInterest (list)VoidReturns list of all the areas of interest in the campaign
QuickSaveVoidVoidCreates a quick save for campaign
SelectNextVoidVoidCycles selection forward
MilitaryForceListCcoCampaignMilitaryForce (list)VoidReturns list of all military forces in the campaign
CampaignKeyStringVoidReturns the campaign record key
SelectPreviousVoidVoidCycles selection backwards
TurnNumberIntVoidReturns the current turn number
SettlementListCcoCampaignSettlement (list)VoidReturns list of all settlements in the campaign
FactionListCcoCampaignFaction (list)VoidReturns list of all factions in the campaign
RoundNameUniStringVoidReturns the current round name (such as season for example)
ClearSelectionVoidVoidClears any selection in campaign
CharacterListCcoCampaignCharacter (list)VoidReturns list of all characters in the campaign
DateStringUniStringVoidReturns the current data as a localised string
PendingActionContextCcoCampaignPendingActionVoidReturns the pending action context to get information on current pending action (if any)
ToggleCinematicModeVoidVoidToggles cinematic mode
ToggleHUDVoidVoidToggles the campaign HUD visibility
RebelFactionContextCcoCampaignFactionVoidReturns the CcoCampaignFaction for rebels
CanQuickSaveBoolVoidReturns true if can currently save the campaign
NotificationQueueContextCcoCampaignPendingActionNotificationQueueVoidReturns the notification queue context
IsLocomotionCompleteBoolVoidReturns true if all character locomotion is complete (no characters moving)
DiplomacyManagerContextCcoCampaignDiplomacyManagerVoidReturns the diplomacy manager context for getting pending negotiations, etc
IsCinematicModeEnabledBoolVoidReturns true if cinematic mode is currently enabled
CursorContextCcoCampaignCursorContextVoidReturns the current cursor context based on current mouseover (to get information on what is moused over)

CcoCampaignSettlement

Wrapper for a campaign settlement.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ModelRegionContextCcoCampaignModelRegionVoidReturns the CcoCampaignModelRegion context for this settlement
BreakForDebuggingVoidVoidCommand that triggers a breakpoint, useful for debugging.debug, hide_in_uied
TowerLevelIntVoidReturns an int with the tower level in this settlement.
ContainedCharacterListCcoCampaignCharacter (list)VoidReturns a list with all the characters garrisoned in the settlement.
WarCoordinationTargetterListContextListVoidReturns a list with all the objects targetting this settlement, if any.
ResetSettlementTypeVoidString, IntCommand that resets a settlement to a different type.
OriginalSubcultureContextCcoSubcultureRecordVoidReturns the context of the original subculture record
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
IsAbandoningBoolVoidReturns true if this settlement is in the process of being abandoned.
WallsHealthPercentFloatVoidReturns a float with the health percentage of the wall.
DevTakeControlVoidVoidDev command that makes the local player take control of this settlementdebug, hide_in_uied
BuildingSlotListCcoCampaignBuildingSlot (list)VoidReturns a list with the all the slots in the settlement.
BesiegeingCharacterContextCcoCampaignCharacterVoidReturns the context of the character that is besiegeing this settlement.
CQIIntVoidReturns the CQI of the region.
MarkForTypeConversionVoidString, IntCommand that marks the settlement for type conversion, which means this will be converted next turn.
StationedForceContextCcoCampaignMilitaryForceVoidReturns the military force context of the army stationed in this settlement, if any.
FactionNameUniStringVoidReturns the name of the faction, taking rebel factions into account.
IsConvertingTypeBoolVoidReturns true if this settlement is converting type.
HostileForeignSlotListCcoCampaignBuildingSlot (list)CcoCampaignFactionReturns a list with the foreign slots in this settlement, for the passed in faction.
AbandonTooltipUniStringVoidReturns tooltip with resources/treasury returned when this settlement gets abandoned.
UnmarkForTypeConversionVoidVoidCommand that cancels the mark for type comversion command.
EffectBundleListCcoEffectBundle (list)VoidReturns a list with the effect bundles in the region, pre-filtered to only include those that should show in the UI
IsMouseOverBoolVoidReturns true if mousing over this settlement.
PooledResourceContextCcoCampaignPooledResourceStringReturns the context of the pooled resource with the key specified, if it exists.
PositionVector4VoidReturns the position of the settlement on the map.
IsUnderSiegeBoolVoidReturns true if under siege.
PrimarySlotContextCcoCampaignBuildingSlotVoidReturns the context of the primary building slot.
ResourceListCcoResourceRecord (list)VoidReturns a list with the resources present in this region.
MarkForAbandonVoidVoidCommand that marks the settlement for abandon, which means this will be abandoned next turn.
IsAbandonedBoolVoidReturns true if this settlement is abandoned.
SettlementTypeStringVoidReturns the type of the settlement, if it has one.
UnmarkForAbandonVoidVoidCommand that cancels the mark for abandon command.
GarrisonForceContextCcoCampaignMilitaryForceVoidReturns the military force context of the garrison in this settlement.
NameUniStringVoidReturns the localized name for this settlement.
BuildingSetListCcoBuildingSetRecord (list)VoidReturns a list with all the building sets in the settlement, sorted by their sort order
FactionContextCcoCampaignFactionVoidReturns the context of the faction that owns it.
ChainListCcoBuildingChainRecord (list)VoidReturns an ordered list with all the buildable chains in this settlement.
FactionFlagRotatedStringVoidReturns the rotated faction flag of this settlement.
SelectVoidVoidCommand that selects this settlement.
SelectAndZoomVoidVoidSelects and zooms to 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)
IsOnScreenBoolVoidReturns true if this settlement is currently on screen
IsSelectedBoolVoidReturns true if this settlement is currently selected
CapitalIconStringVoidReturns the capital icon of this settlement.
ProvinceContextCcoCampaignProvinceVoidReturns the context of the province that this settlement is part of.
HasPlagueBoolVoidReturns true if settlement has a plague
MaxBuildingSlotCountIntVoidReturns the maximum amount of building slots that the settlement can have for the current faction occupying it
FactionFlagSmallStringVoidReturns the small faction flag of this settlement.
BelongsToRegionGroupBoolStringReturns if this settlement belongs to region group with passed key
RenameVoidVoidCommand that renames the settlement.
VassalFactionContextCcoCampaignFactionStringReturns the context of the vassal faction that owns it.
IsAssociatedWithVassalBoolStringReturns if a vassal is associated with the settlement
ZoomToVoidVector4 (optional)Command that zooms to this settlement.
IsShroudedBoolVoidReturns true if it's covered by shroud.
FactionFlagMediumStringVoidReturns the medium faction flag of this settlement.
CanConvertToSettlementTypeBoolStringReturns true if settlement can convert to the given settlement type
FactionFlagDirStringVoidReturns the directory of the faction flags
IndexIntoProvinceIntVoidReturns the index of this settlement in the province's settlement list.
HostileSlotsGroupListCcoGroupList (list)VoidReturns a list with all the hostile foreign slots in the region, grouped based on the faction that owns each manager
IsRebellionImminentBoolVoidReturns true if there will be a rebellion next turn.
RegionRecordKeyStringVoidReturns the key of the region record.
TurnsUntilSiegeSurrenderIntVoidReturns an int with how many turns the siege will last, Returns -1 if the settlement is not under siege.
AlliedSlotsGroupListCcoGroupList (list)VoidReturns a list with all the allied foreign slots in the region, grouped based on the faction that owns each manager
FactionFlagLargeStringVoidReturns the large faction flag of this settlement.
PlagueEffectBundleListCcoEffectBundle (list)VoidReturns a list of the plague effect bundles present in this settlement
HasCharacterGarrisonedBoolVoidReturns true if a character is garrisoned in this settlement.
HasWallsBoolVoidReturns true if this settlement has any walls.
GarrisonSizeIntVoidReturns the size of the garrison in this settlement.
IsFactionCapitalBoolVoidReturns true if it's the capital of the faction that owns it.
AllianceColourColourVoidReturns the alliance colour which for most part is owning factions, but a special case for abandoned/disguised settlements
SettlementKeyStringVoidReturns a string with the key of the settlement.
IsProvinceCapitalBoolVoidReturns true if this settlement is the capital of its province.
NumWallBreachesIntVoidReturns an int with the number of times the wall has been breached.
CanRenameBoolVoidReturns true if this settlement can be renamed
AlliedForeignSlotListCcoCampaignBuildingSlot (list)CcoCampaignFactionReturns a list with all the allied slots in the region if any.
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)
IncomeIntVoidReturns the tax income from the region.
DevSpawnRebellionVoidVoidDev command that forces a rebellion to spawn in settlementdebug, hide_in_uied
IsUpgradeableBoolVoidReturns true if the settlement can be upgraded.
PooledResourceListCcoCampaignPooledResource (list)VoidReturns a list with all pooled resources present in the region.
FactionProvinceManagerContextCcoCampaignFactionProvinceManagerVoidReturns the faction province manager of this settlement.
IsPlayerOwnedBoolVoidReturns true if the local player owns this settlement.

CcoCampaignTechnology

Component context wrapper for a campaign technology

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AncillaryListCcoAncillaryRecord (list)VoidReturns the list of CcoCampaignAncillary provided by this tech
EffectListCcoEffect (list)VoidReturns the list of CcoEffect that this tech enables when researched, prefiltered to not show those that shouldnt appear in ui
IconPathStringVoidFull icon filepath for tech icons
NameUniStringVoidLocalised name
IndentIntVoidReturns the indent value from db (x position)
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
EffectsGrantedToInitiativeCcoEffect (list)CcoInitiativeRecordReturns list of effects (flagged as visible in UI) that this tech grants to given initiative
CanAffordBoolVoidReturns true if can afford the Cost of 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
TierIntVoidReturns tier value from db (y position)
DurationIntVoidReturns the number of turns it takes to finish researching this tech
CanResearchBoolVoidReturns true if available and can currently research meeting any additional requirements like cost, etc
UiTabContextCcoTechnologyUiTabRecordVoidreturns the context of the ui tab if any
NodeSetNameUniStringVoidReturns the unlocalised name of the technology node set this technology belongs to
ScriptLockedReasonUniStringVoidReturns script locked reasons for tech with challenge numbers formatted in, if any
CostIntVoidReturns financial cost to research this tech
AffectedInitiativeListCcoInitiativeRecord (list)Bool (optional)Returns list of initiatives affected by unlocking this tech, can pass to EffectsGrantedToInitiative to get specific effects
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
BreakForDebuggingVoidVoidBreaks into attached IDE for debugging and getting full information from internal objectsdebug, hide_in_uied
TrainingGroupContextCcoCampaignCharacterTrainingGroupVoidIf one of the effects unlocks a training slot, returns the group of that
MatchesQueryBoolUniStringReturns true if this technology matches given query text
EffectUnfilteredListCcoEffect (list)VoidReturns the list of CcoEffect that this tech enables when researched, includes those not shown in uihide_in_uied
IsAvailableBoolVoidReturns true if available to be researched
RequiredTechnologiesListCcoTechnologyRecord (list)VoidReturns the list of CcoCampaignTechnology required before player can research this tech
IsAtLeastResearchingBoolVoidReturns true if researching or researched
RecordContextCcoTechnologyRecordVoidReturns the CcoTechnologyRecord context
ResearchedParentsIntVoidReturns the number of parents that have already been researched
IsResearchedBoolVoidReturns true if already been researched
HasBuildingRequirementBoolVoidReturns true if this tech has building requirements before can start researtching
RequiredParentsNumberIntVoidReturns required number of parents to unlock this technology
IsQueuedBoolVoidReturns true if this technology is part of the research map
IsResearchingBoolVoidReturns true if currently researching
RequiredBuildingListCcoBuildingLevelRecord (list)VoidReturns the list of CcoBuildingLevelRecord required to be built by player before can research this tech
UiGroupContextCcoTechnologyUiGroupRecordVoidReturns the context of the ui group that this technology is part of, if it exists
FactionContextCcoCampaignFactionVoidReturns the context of the faction that this technology belongs to
CharacterTraitListCcoCharacterTraitLevelRecord (list)VoidReturns the list of CcoCharacterTraitLevelRecord provided by this tech
ColourColourVoidColour defined by tech node set
CurrentStateStringVoidCurrent state as a string (available/researched, etc
StartResearchingVoidVoidStarts researching this tech
NodeKeyStringVoidReturns the key of technology node record
UnitListCcoMainUnitRecord (list)VoidReturns the list of CcoMainUnitRecord provided by this tech
DevDisableTechVoidVoidInstantly disables tech for dev purposesdebug, hide_in_uied
ShortDescriptionUniStringVoidLocalised short description
LongDescriptionUniStringVoidLocalised long description
ResourceTransactionContextCcoCampaignResourceTransactionVoidReturns the context of the required resource transaction
BuildingListCcoBuildingLevelRecord (list)VoidReturns the list of CcoBuildingLevelRecord provided by this tech

CcoCampaignUnit

Component context wrapper for a campaign unit

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsUnknownBoolVoidReturns true if player doesn't know details about this unit due to spying level (might not be close enough to army, etc)
DisbandVoidVoidRemoves the unit from the army, essentially deleting the unit
IconPathStringVoidReturns the icon filepath used for things like unit card images
UpgradeVoidCcoUnitPurchasableEffectRecordUpgrades the unit with the supplied CcoUnitPurchasableEffectRecord
HealthPercentFloatVoidReturns the current health as a percentage (0-1)
NameUniStringVoidReturns the localised name
DevHealVoidVoidFully heals the unit, useful for dev purposesdebug, hide_in_uied
WillSufferAttritionBoolVoidReturns true if this unit will suffer attrition on the next turn (take damage)
UniqueUiIdStringVoidReturns unique string identifier for this unit
DevLevelUpVoidIntLevels up or down a unit by given number of levelsdebug, hide_in_uied
RenameVoidVoidBrings up a prompt to rename the unit to give it a custom name
AlliedOriginFactionContextCcoCampaignFactionVoidReturns the allied origin faction of this unit (if this unit has been recruited through allied recruitment)
TurnsUntilReplenishedIntVoidReturns how many turns it will take for this unit to be back to full strength
HasPurchasedEffectBoolCcoUnitPurchasableEffectRecordReturns true if unit have purchased the supplied CcoUnitPurchasableEffectRecord
UpgradeUnitVoidCcoMainUnitRecordUpgrades the unit to the supplied CcoMainUnitRecord
AllianceColourColourVoidReturns the alliance colour of this unit (usually same as factions colour, but if we have an origin faction it will use that colour)
IsCharacterBoolVoidReturns true if this unit is for a character (general or agent)
UnitDetailsContextCcoUnitDetailsExpressionStateReturns the CcoUnitDetails for this unit (used on unit info panel which shows unit info from various sources)
PurchasedEffectsListCcoUnitPurchasableEffectRecord (list)VoidReturns a list of CcoUnitPurchasableEffectRecord that this unit have purchased
CostIntVoidReturns the recruitment cost of this unit (one off payment when first recruit)
UpkeepCostIntVoidReturns the upkeep cost of this unit (how much pay each turn)
HaveAccessToPurchasableEffectBoolCcoUnitPurchasableEffectRecordReturns true if unit have access to the supplied CcoUnitPurchasableEffectRecord
MilitaryForceContextCcoCampaignMilitaryForceVoidReturns the owning CcoCampaignMilitaryForce
CharacterContextCcoCampaignCharacterVoidReturns the CcoCampaignCharacter if any (for agents/generals)
ExperienceLevelIntVoidReturns the current experience level of the unit (0-9)
NumEntitiesIntVoidReturns the current number of entities
AbilityListContextListVoidReturns the list of CcoUnitAbility that this unit can use in battle
PurchasableEffectsCostListCcoCampaignUnitPurchasableEffectCost (list)VoidReturns a list of CcoCampaignUnitPurchasableEffectCost that this unit can use
NumEntitiesInitialIntVoidReturns the max number of entities this unit can have
UnitRecordContextCcoMainUnitRecordVoidReturns the CcoMainUnitRecord
PurchasableEffectCostContextCcoCampaignUnitPurchasableEffectCostCcoUnitPurchasableEffectRecordReturns the CcoCampaignUnitPurchasableEffectCost for a supplied CcoUnitPurchasableEffectRecord
HealthValueIntVoidReturns the raw health value (hitpoints)
UpgradeUnavailableTextUniStringCcoUnitPurchasableEffectRecordReturns the reason why the unit cannot upgrade using the supplied CcoUnitPurchasableEffectRecord
HealthMaxIntVoidReturns the max raw health value this unit can have
PurchasableEffectsListCcoUnitPurchasableEffectRecord (list)VoidReturns a list of CcoUnitPurchasableEffectRecord that this unit can use
IsNumMenKnownBoolVoidReturns true if player knows enough about army to know how many men they have left (might not be close enough to army, etc)
HealthPercentNextTurnFloatVoidReturns the health percent that will be next turn (0-1)
AttritionPercentFloatVoidReturns how much attrition will take in the next turn (how much health will lose) (0-1)
IsExperienceKnownBoolVoidReturns true if player knows enough about army to know how experience (might not be close enough to army, etc)
ExperiencePercentFloatVoidReturns the current experience progression to next level as a percent (0-1)
CanUpgradeBoolCcoUnitPurchasableEffectRecordReturns true if this unit can upgrade using the supplied CcoUnitPurchasableEffectRecord
HealthReplenishPercentFloatVoidReturns the amount of health that will be replenished on the next turn as a percentage (0-1)

Record

CcoAbilityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OnScreenDescriptionVoidVoid
RecordListVoidVoid
ViewInDbVoidVoid
AbilityVoidVoid
OnScreenNameVoidVoid
KeyVoidVoid

CcoActionResultRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TargetEffectBundleVoidVoid
ActorEffectBundleTurnsVoidVoid
KeyVoidVoid
ActorEffectBundleVoidVoid
TargetEffectBundleTurnsVoidVoid
RecordListVoidVoid

CcoAdviceLevelRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
InfoTextVoidVoid
AdvisorNameVoidVoid
SubCategoryVoidVoid
TitleVoidVoid
TextVoidVoid
AdviceThreadVoidVoid
CategoryVoidVoid
KeyVoidVoid

CcoAgentActionRecord

Functions

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

CcoAgentCultureDetailRecord

Functions

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

CcoAgentRecord

Record wrapper for an AGENT_RECORD

Functions

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

CcoAgentSubtypeRecord

Record wrapper for agent_subtypr_record

Functions

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

CcoAncillariesCategoryRecord

Record wrapper for an ancillaries_category_record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoAncillariesCategoryRecord (list)VoidReturns a list with all entries from the ancillaries_category_table
SortOrderIntVoidReturns an int with the category sort order
DefaultEntryNameUniStringVoidReturns a localised default name, for when no ancillary of this category is equipped
OnscreenNameUniStringVoidReturns the localised name of the category
IconNameStringVoidReturns the name of the icon that is used for this category
KeyStringVoidReturns the key of the record
CategoryStringVoidReturns a string from the category enum
NumAllowedPerCharacterForFactionIntCcoFactionRecord (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
DefaultEntryTooltipUniStringVoidReturns a localised default tooltip, for when no ancillary of this category is equipped
IsFusableBoolVoidReturns true if items from this category can be fused

CcoAncillariesSubcategoryRecord

Context wrapper for a ANCILLARIES_SUBCATEGORY_RECORD

Functions

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

CcoAncillaryRecord

Record wrapper for a ancillary_record

Functions

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

CcoAncillarySetRecord

Record wrapper for an ancillary set record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NameUniStringVoidReturns the localised name of the set
RequiredAncillariesListCcoAncillaryRecord (list)VoidReturns a list of ancillaries that are required for this set to be complete.
RecordListCcoAncillarySetRecord (list)VoidReturns a list of all ancillary sets in the table
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
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
DescriptionUniStringVoidReturns the description of the set
IconPathStringVoidReturns the icon path of the set

CcoAncillaryTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
IconVoidVoid

CcoAncillaryUniquenessGroupingRecord

Record wrapper for a ancillary_uniqueness_grouping_record

Functions

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

CcoArmoryItemRecord

Record wrapper for armory item record

Functions

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

CcoArmoryItemSetRecord

Wrapper for a ARMORY_ITEM_SET_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectListCcoEffect (list)VoidReturns the effect list provided when all items in the set are equipped
EffectUnfilteredListCcoEffect (list)VoidReturns the effect list provided when all items in the set are equipped, includes those not shown in uihide_in_uied
DescriptionUniStringVoidReturns the localised description of the item set
IconStringVoidReturns the icon path of the item set
RecordListCcoArmoryItemSetRecord (list)VoidReturns a list with all item sets in the table
KeyStringVoidReturns a string with the key of the record
NameUniStringVoidReturns the localised name of the item set
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
ArmoryItemContextCcoArmoryItemRecordVoidReturns the context of the armory item associated with this item variant
UseAsDefaultBoolVoidReturns a bool that specifies whether this variant is used as the default
ImagePathStringVoidReturns the image path of this variant
NameUniStringVoidReturns the localised name of the item variant
DescriptionUniStringVoidReturns the description of this variant
KeyStringVoidReturns a string with the key of this record
RecordListCcoArmoryItemVariantRecord (list)VoidReturns a list with all armory item variants in the database table.

CcoArmorySlotTypeRecord

Wrapper for an armory slot type record.

Functions

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

CcoArmySpecialAbilityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitSpecialAbilityContextVoidVoid
UniqueIDVoidVoid
EnablesSiegeAssaultVoidVoid
ArmySpecialAbilityKeyVoidVoid

CcoBannerRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CombatPotentialAdjustmentsVoidVoid
PermittedUnitSetsVoidVoid
EffectBundleRecordVoidVoid
BannerVoidVoid
RecordListVoidVoid

CcoBattleClimateWeatherDescriptionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
ColdFatigueVoidVoid
ProbabilityVoidVoid
SpottingScalarVoidVoid
SeasonRecordContextVoidVoid
HeatFatigueVoidVoid
ClimateRecordContextVoidVoid
WeatherRecordContextVoidVoid

CcoBattleCurrencyArmySpecialAbilitiesCostValueRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CostValueVoidVoid
ArmySpecialAbilityContextVoidVoid
BattleSecondaryCurrencyTypeContextVoidVoid

CcoBattleCurrencyUnitAbilitiesCostValueRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CurrencyTypeContextVoidVoid
ItemTypeContextVoidVoid
CostValueVoidVoid

CcoBattleEntityRecord

Functions

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

CcoBattlePurchasableGroupRecord

Wrapper for a battle purchasable group record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PurchasableUnitAbilitiesListCcoBattlePurchasableUnitAbility (list)VoidReturn the list of purchasable abilities in the group
PurchasableArmyAbilitiesListCcoBattlePurchasableArmyAbility (list)VoidReturn the list of purchasable army usesabilities 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
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
RecordListCcoBattlePurchasableItemsJunctionRecord (list)VoidGet the full list of available CcoBattlePurchasableItemsJunctionRecord's
GroupsForCategoryCcoBattlePurchasableGroupRecord (list)String(CategoryKey) Get the list of CcoBattlePurchasableGroupRecord's in the specified category

CcoBattlePurchasableItemsUiCategoryRecord

Wrapper for a UI Battle Purchasable Items Junction record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoBattlePurchasableItemsUiCategoryRecord (list)Void
CategoryKeyStringVoid

CcoBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ScreenshotVoidVoid
PlayableAreaWidthVoidVoid
TypeVoidVoid
TypeStringVoidVoid
PlayableAreaHeightVoidVoid
IsNavalVoidVoid
KeyVoidVoid
AuthorVoidVoid
CatchmentNameVoidVoid
UserCreatedVoidVoid
HasKeyBuildingsVoidVoid
MatchmakingVoidVoid
YearVoidVoid
DefenderFundsRatioVoidVoid
MultiplayerVoidVoid
SingleplayerVoidVoid
IntroMovieVoidVoid
DescriptionVoidVoid
RecordListVoidVoid
StartBattleVoidVoid
ReleaseMapVoidVoid
EnvironmentPathVoidVoid
MapVoidVoid
EnvironmentAudioTypeVoidVoid
NameVoidVoid
IsLargeSettlementVoidVoid
SpecificationVoidVoid
Has15mWallsVoidVoid

CcoBattleResultTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitXpGainVoidVoid
RecordListVoidVoid
BattleResultTypeVoidVoid
ResultDescriptionVoidVoid
ResultScreenNameVoidVoid

CcoBattleSecondaryCurrencySourceTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SourceTypeVoidVoid
RecordListVoidVoid
IsAllianceBasedVoidVoid
UiLocalisedNameVoidVoid
DescriptionVoidVoid

CcoBattleSecondaryCurrencyTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UiIconPathVoidVoid
RecordListVoidVoid
CurrencyTypeVoidVoid
UiLocalisedNameVoidVoid

CcoBattleSetPieceArmiesCharacterRecord

Functions

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

CcoBattleSetPieceArmiesCharactersItemRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
NameVoidVoid
CharacterItemContextVoidVoid

CcoBattleSetPieceArmiesCharactersSkillRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LevelVoidVoid
RecordListVoidVoid
CharacterNameVoidVoid
SkillContextVoidVoid

CcoBattleSetPieceArmiesUnitRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
PercentageNumMenVoidVoid
UnitRecordContextVoidVoid
UnitLevelVoidVoid

CcoBattleSetPieceArmyRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsAlliedToPlayerVoidVoid
NameVoidVoid
AiArmyTacticVoidVoid
ApproachAngleVoidVoid
KeyVoidVoid
FactionContextVoidVoid
ShouldMergeArmyVoidVoid
DefaultArmyAbilityListVoidVoid
IsHiddenArmyVoidVoid
UnitsListVoidVoid
EffectBundlesListVoidVoid
UseDefaultDeploymentZonesVoidVoid
CharactersListVoidVoid
IsReinforcementArmyVoidVoid
RecordListVoidVoid
IsFrontendPlayerArmyVoidVoid
DeploymentZoneIdVoidVoid

CcoBattleSetPieceFrontendGroupRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
SortOrderVoidVoid
CampaignMapContextVoidVoid
CharacterListVoidVoid
KeyVoidVoid
BattleListVoidVoid

CcoBattleSetPieceFrontendGroupsToCharacterRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FrontendGroupContextVoidVoid
RecordListVoidVoid
CharacterContextVoidVoid

CcoBattleSetPieceRecord

Wrapper for a BATTLE_SET_PIECE_RECORD

Functions

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

CcoBattleTypeCheatSheetEntryRecord

Wrapper for a Battle 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
IconPathStringVoid
KeyStringVoid
ColumnIndexIntVoidSpecifies which column group the entry should be in. This index is filtered when the cheat sheet list is collated
VisualKeyStringStringVoidGets the string which is used to key the item into the cheat sheet screenshot or similar
HeaderTextUniStringVoid
DescriptionTextUniStringVoid

CcoBattleTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
DefenderFundsRatioVoidVoid
MaxTeamsizeVoidVoid
DescriptionVoidVoid
AttackerVictoryConditionsListVoidVoid
DefenderVictoryConditionsListVoidVoid
NameVoidVoid
ListOrderVoidVoid
KeyVoidVoid

CcoBattleVortexRecord

Wrapper for a BATTLE_VORTEX_RECORD

Functions

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

CcoBattleWeatherTypeRecord

Functions

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

CcoBattlefieldEngineRecord

Wrapper for a BATTLEFIELD_ENGINE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoBattlefieldEngineRecord (list)Void
BattleEntityContextCcoBattleEntityRecordVoid
CanBeDismantledBoolVoid
KeyStringVoid
MissileWeaponContextCcoMissileWeaponRecordVoid

CcoBattlefieldSiegeVehicleRecord

Wrapper for BATTLEFIELD_SIEGE_VEHICLE_RECORD

Functions

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

CcoBattlefieldSiegeVehiclesCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProbabilityVoidVoid
RecordListVoidVoid
VehicleContextVoidVoid
CapVoidVoid

CcoBuildingChainRecord

Wrapper for a building chain record

Functions

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

CcoBuildingCultureVariantRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CultureRecordContextVoidVoid
KeyVoidVoid
DisablesVoidVoid
RecordListVoidVoid
IconVoidVoid
NameKeyVoidVoid
ShortDescriptionVoidVoid
LongDescriptionVoidVoid
SubcultureRecordContextVoidVoid
FactionRecordContextVoidVoid
NameVoidVoid
BuildingLevelVoidVoid

CcoBuildingLevelRecord

Record wrapper for a BUILDING_LEVEL_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsLockedByLevelBoolContextReturns true if this level is not available due to primary building requirements
MercenaryUnitListCcoMainUnitRecord (list)VoidReturns a list with mercenary units provided by this building level, if any
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
IssueCommandForBuildingBrowserVoidCcoCampaignBuildingSlotIssues the appropriate command when clicking on a building (cancel construction if building, build if it can etc)
UpgradesListCcoBuildingLevelRecord (list)VoidReturns a list with this building level's upgrades
OnlyInCapitalBoolVoidReturns true if this can only be built in the capital
CreateCostIntContextReturns 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
RequiredTechnologiesListCcoTechnologyRecord (list)VoidReturns a list with the required technologies for this building to become available
HasEnoughDevelopmentPointsBoolContextReturns true if the settlement/character passed in has enough development points to build this
AgentListCcoAgentSubtypeAgentPair (list)VoidReturns a list with the agents provided by this building level
IsEpisodicRestrictedBoolVoidReturns true if the building is restricted by mission etc
EffectListCcoEffect (list)CcoCampaignBuildingSlot (optional)Returns a list with the effects provided by this building
HealthOverrideFloatVoidReturns the health override of this building level
CanBuildInCurrentSlotBoolCcoCampaignBuildingSlotReturns true if this building can be built in the slot passed in
RecordListCcoBuildingLevelRecord (list)VoidReturns a list with all the building level records in the table
LevelIntVoidReturns the level of this building level
OpenBuildingInfoPanelVoidExpressionState, Context, CcoCampaignBuildingSlot, Bool (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
FactionUniqueBoolVoidReturns true if this building is unique in the faction/can only be built once in the faction
EncyclopediaRedirectBuildingStringVoidReturns a string with the encyclopedia redirect link for this building
IsBuiltInProvinceBoolCcoCampaignProvinceReturns true if this building level, or a building level above this, is built in the passed in province
TechListCcoTechnologyRecord (list)VoidReturns a list with technologies unlocked by this building
CanAffordBoolContextReturns true if the settlement/character passed in can afford to build this
TooltipForCurrentSlotUniStringCcoCampaignBuildingSlotReturns the tooltip for this building, depending if it can build/is in construction etc. Need to pass building slot where this is built.
ShouldShowMouseOverComponentBoolCcoCampaignBuildingSlotReturns true if the mouseover that shows cost/turns should show
HasLifecycleStateBoolVoidReturns true if this building is part of a lifecycle chain
ConstructionItemForCurrentSlotContextCcoCampaignConstructionItemCcoCampaignBuildingSlotReturns the CcoConstructionItem context for this building level, if any. Need to pass in the building slot where this is built.
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)
KeyStringVoidReturns the key of the building level record
UnitListCcoMainUnitRecord (list)ContextReturns a list with the units provided by this building. Needs passing a settlement or character context in order to check for permissions
IsCurrentConstructionItemForSlotBoolCcoCampaignBuildingSlotReturns true if this level is the one currently in construction in the slot passed in
IsRedundantDuplicateBoolCcoCampaignSettlementReturns true if there is already a building of this type in the province, which might not provide any other benefits
BuildingChainRecordContextCcoBuildingChainRecordVoidReturns the context of the building chain record that this level is part of
DoesBuildingExceedCapBoolCcoCampaignBuildingSlotReturns true if this building exceeds the cap of this type of building in the province
ShouldShowBuildingLevelInUiForTechnologyBoolVoidReturns true if this building should be shown in ui as a requirement for a technology
CanBeDamagedBoolVoidReturns true if this building can be damaged
ResourceRequirementContextCcoResourceRecordVoidReturns the context of the required resource for this building, if any
IsResourceBuildingBoolVoidReturns true if this building is a resource building(provides resource when built)
FoodCostIntVoidReturns the amount of food this building will require to be constructed
DowngradesToLevelContextCcoBuildingLevelRecordVoidReturns the context of the level it downgrades to
IsBuiltInSlotBoolCcoCampaignBuildingSlotReturns true if this building level is built in the passed in slot, or if any building level above it is built
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
CanConvertBoolVoidReturns true if this building level can be converted
PlayerVariantRecordContextCcoBuildingCultureVariantRecordVoidReturns the culture variant of this building for the player faction
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
ResourceCostContextCcoCampaignResourceTransactionCcoCampaignBuildingSlotReturns the context of the (pooled) resource transaction cost of this building
HasResourceRequirementsBoolVoidReturns true if this building level needs resources to build
PrimarySlotBuildingLevelRequirementIntVoidReturns the level of the primary slot that needs to be built for this level to be available
CanPlayerBuildThisBoolVoidReturns true if this building is available to the players faction
ResourceRecordContextCcoResourceRecordVoidReturns the context of the resource for this building, if any
IsActiveForBuildingBrowserBoolCcoCampaignBuildingSlotReturns true if this building can be shows as the active state in the building browser
UpkeepCostIntVoidReturns the upkeep cost for this building level
AdditionalDependentUnitsListCcoMainUnitRecord (list)VoidReturns a list with this building's additional dependent units
SlaveCapContributionIntVoidReturns the slave constribution for this building

CcoBuildingSetRecord

Record wrapper for a BUILDING_SET_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconStringVoidReturns the icon path of the building set
BuildingSuperChainsForSettlementCcoBuildingSuperchainRecord (list)CcoCampaignSettlementReturns a list with all the building superchains for the settlement passed in
MaximumChainBuildingsIntContextReturns 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.
RecordListCcoBuildingSetRecord (list)VoidReturns a list with all building set records from the database
BuildingChainsCcoBuildingChainRecord (list)ContextReturns 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
OnscreenDescriptionUniStringVoidReturns the localised description of the building set
SortOrderIntVoidReturns an int with the sort order
ColourColourVoidReturns a Pixel8888 with the colour of the set
NameUniStringVoidReturns the localised name of the set
AudioSwitchStringVoidReturns the audio switch for the building set
KeyStringVoidReturns the key of the record

CcoBuildingSuperchainRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ChainsForProvinceListVoidVoid
RecordListVoidVoid
ChainListVoidVoid
KeyVoidVoid

CcoBulletPoint

Context wrapper for a bullet point

Functions

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

CcoCampaignBattlePresetRecord

Functions

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

CcoCampaignDecisionChoiceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IndexVoidVoid
RecordListVoidVoid
PayloadCharacterTraitListVoidVoid
DecisionRecordContextVoidVoid
TitleVoidVoid
LabelVoidVoid

CcoCampaignDecisionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TitleVoidVoid
DescriptionVoidVoid
RecordListVoidVoid
ImageVoidVoid
KeyVoidVoid
ChoiceListVoidVoid

CcoCampaignEffectListRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
EffectsVoidVoid

CcoCampaignEffectScopeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LocalisedTextVoidVoid
RecordListVoidVoid
KeyVoidVoid

CcoCampaignFactionCheatSheetEntryRecord

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

Functions

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

CcoCampaignGroupRecord

Wrapper for a campaign group record

Functions

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

CcoCampaignMapPlayableAreaRecord

Wrapper for CAMPAIGN_MAP_PLAYABLE_AREA_RECORD

Functions

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

CcoCampaignMapWindsOfMagicAreaRecord

Functions

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

CcoCampaignMapWindsOfMagicStrengthRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FrequencyIntVoid
LevelIntVoid
LocalisedNameUniStringVoid
EffectListContextListVoid
KeyStringVoid
RecordListCcoCampaignMapWindsOfMagicStrengthRecord (list)Void
DurationIntVoid
EnableStormOfMagicBoolVoid

CcoCampaignOperationSetRecord

Wrapper for a CAMPAIGN_OPERATION_SET_RECORD

Functions

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

CcoCampaignPayloadRecord

Wrapper for a CAMPAIGN_PAYLOAD_RECORD

Functions

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

CcoCampaignPayloadResourceTransactionRecord

Wrapper for a CAMPAIGN_PAYLOAD_RESOURCE_TRANSACTION_RECORD

Functions

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

CcoCampaignPayloadUnitComponentRecord

Wrapper for a CAMPAIGN_PAYLOAD_UNIT_COMPONENT_RECORD

Functions

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

CcoCampaignStormTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanMoveVoidVoid
KeyVoidVoid
RespectExcludedRegionsTableVoidVoid
RecordListVoidVoid
ForLandVoidVoid
ForSeaVoidVoid
CanSpawnOverCharacterVoidVoid
CanDecayVoidVoid

CcoCampaignStreakEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MinVoidVoid
RecordListVoidVoid
OnScreenNameVoidVoid
KeyVoidVoid
MaxVoidVoid
EffectUnfilteredListVoidVoid
CampaignStreakKeyVoidVoid
EffectListVoidVoid

CcoCampaignStreakRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TypeVoidVoid
StreakEffectListVoidVoid
MinVoidVoid
RecordListVoidVoid
MaxVoidVoid
ResetTurnsVoidVoid
KeyVoidVoid

CcoCampaignVideoRecord

Functions

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

CcoCapturePointCategoryTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
RecordListVoidVoid
LocalisedNameVoidVoid
IconPathVoidVoid

CcoCapturePointTypeRecord

A DB record wrapper for a battle capture point type

Functions

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

CcoCaravanContractRecord

Wrapper for a CARAVAN_CONTRACT_RECORD

Functions

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

CcoCdirEventsCategoryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
OnScreenNameVoidVoid
TypeVoidVoid
CategoryKeyVoidVoid

CcoCdirEventsDilemmaChoiceDetailRecord

Record wrapper for a CDIR_EVENTS_DILEMMA_CHOICE_DETAIL_RECORD

Functions

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

CcoCharacterAncillaryQuestUiDetailRecord

Record wrapper for character ancillary quest details

Functions

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

CcoCharacterSkillRecord

Wrapper for a character skill record.

Functions

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

CcoCharacterTrainingDilemmaChoiceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IndexVoidVoid
RecordListVoidVoid
DilemmaRecordContextVoidVoid
ChoiceEffectRecordVoidVoid
KeyVoidVoid
LocalisedLabelVoidVoid

CcoCharacterTrainingDilemmaRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TrainingEffectTypeVoidVoid
RecordListVoidVoid
LocalisedDescriptionVoidVoid
ChoiceListVoidVoid
KeyVoidVoid
LocalisedTitleVoidVoid

CcoCharacterTraitLevelRecord

Functions

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

CcoCharacterTraitRecord

Functions

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

CcoClimateRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
RecordListVoidVoid

CcoCookingIngredientGroupRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
IngredientsVoidVoid
DisplayNameVoidVoid
IconVoidVoid
ColourVoidVoid
RecordListVoidVoid
FlavourTextVoidVoid

CcoCookingIngredientRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IngredientVOTriggerVoidVoid
IndexVoidVoid
RecordListVoidVoid
FlavourTextVoidVoid
IconVoidVoid
KeyVoidVoid
DisplayUnlockTextVoidVoid
DisplayTextVoidVoid
FactionLeaderEffectsContextVoidVoid
GroupContextVoidVoid
FactionEffectsContextVoidVoid

CcoCookingRecipeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RequiredIngredientGroupsVoidVoid
FlavourTextVoidVoid
DurationVoidVoid
CookingRecipieVOVoidVoid
IndexVoidVoid
RecordListVoidVoid
RequiresSpecificIngredientVoidVoid
ResourceCostContextVoidVoid
DisplayTextVoidVoid
IconVoidVoid
KeyVoidVoid
FactionEffectsContextVoidVoid
FactionLeaderEffectsContextVoidVoid
RequiredIngredientsVoidVoid

CcoCorruptionCounterIntervalRecord

Wrapper for a CORRUPTION_COUNTER_INTERVAL_RECORD

Functions

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

CcoCorruptionTypeRecord

Wrapper for a CORRUPTION_TYPE_RECORD

Functions

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

CcoCultureRecord

Wrapper for a culture record

Functions

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

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
CultureSortOrderVoidVoid
RecordListVoidVoid
FactionContextVoidVoid
SortOrderVoidVoid

CcoCustomBattleSettingRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ValueVoidVoid
RecordListVoidVoid
NameVoidVoid
KeyVoidVoid

CcoDaemonAbilityBarDescriptionRecord

wrapper for a DAEMON_ABILITY_BAR_DESCRIPTION_RECORD

Functions

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

CcoDeployableRecord

Functions

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

CcoDeployablesCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProbabilityVoidVoid
RecordListVoidVoid
DeployableContextVoidVoid
CapVoidVoid

CcoDilemmaRecord

Record wrapper for a DILEMMA_RECORD

Functions

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

CcoDiplomaticStanceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
StatusStateVoidVoid
OnscreenTextVoidVoid
StanceVoidVoid
KeyVoidVoid

CcoElectorCountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MinisterialPositionEffectBundleVoidVoid
MapPosXVoidVoid
CapitalRegionContextVoidVoid
AncillaryRewardContextVoidVoid
UnitRewardContextVoidVoid
RecordListVoidVoid
MapPosYVoidVoid
MapPosVoidVoid

CcoEndTurnNotificationRecord

Functions

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

CcoFactionRecord

Wrapper for a faction record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactionSkinStringVoidReturns faction's skin
RecordListCcoFactionRecord (list)VoidReturns a list of all CcoFactionRecords
IsFactionUnlockedBoolVoidReturns if the faction is unlocked
FactionSpecificAscendancyEffectListCcoEffect (list)VoidReturns the effects provided to this faction by all storm of magic ascendancy lores
SubcultureContextCcoSubcultureRecordVoidReturns the faction's subculture context
OwnershipProductRequirementListCcoOwnershipProductRequirement (list)VoidReturns the list of CcoOwnershipProductRequirement required to be owned for this faction, if it came in a DLC
MechanicListCcoEffect (list)VoidReturns the faction's mechanics as a list of CcoEffects
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
OwnershipProductRecordListCcoOwnershipProductRecord (list)VoidReturns the list of CcoOwnershipProductRecord required to be owned for this faction, if it came in a DLC
FlagPathLargeStringVoidReturns the path to the large version of the faction's flag
FlagPathRotatedStringVoidReturns the path to the rotated version of the faction's flag
FlagDirStringVoidReturns flag directory for this faction
FlagPathMediumStringVoidReturns the path to the medium version of the factio'n flag
NameUniStringVoidReturns the faction's localised name
NameWithIconUniStringVoidReturns the faction's name along with a small icon of their flag
FlagPathSmallStringVoidReturns the path to the small version of the faction's flag
KeyStringVoidReturns the key of this faction record
PrimaryColourColourVoidReturns the faction's primary colour

CcoFactionSetRecord

Wrapper for a FACTION_SET_RECORD

Functions

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

CcoFormationRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsArmyVoidVoid
RecordListVoidVoid
DescriptionVoidVoid
TooltipVoidVoid
OrderVoidVoid
IsNavalVoidVoid
NameVoidVoid
FormationVoidVoid
IconNameVoidVoid

CcoFrontendFactionLeaderRecord

Functions

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

CcoGroundTypeRecord

Functions

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

CcoGroundTypeToStatEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AffectedGroupNameVoidVoid
IsPositiveVoidVoid
GroundTypeVoidVoid
ValueVoidVoid
RecordListVoidVoid
EffectTextVoidVoid
EffectTextWithValueVoidVoid
ValueForDisplayVoidVoid

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
RecordListCcoGroupPooledResourceEffectRecord (list)VoidReturns a list with all group pooled resource effects from the table
UpperBoundIntVoidReturns an int with the upper bound of this group
EffectBundleCcoEffectBundleVoidReturns the effect bundle that is provided by this group when the pooled resource is between the lower and upper bounds
LowerBoundIntVoidReturns an int with the lower bound of this group

CcoIncidentRecord

Wrapper for an incident record

Functions

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

CcoInitiativeRecord

Record wrapper for a INITIATIVE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectListCcoEffect (list)VoidReturns a list of the effects with priority higher than 0, that are provided when active
EffectUnfilteredListCcoEffect (list)VoidReturns a list of all the effects provided when active
ExpendedResourceTransactionContextCcoCampaignResourceTransactionVoidReturns the resources that will be spent to activate the initiative
RequiredResourceTransactionContextCcoCampaignResourceTransactionVoidReturns the resources required to activate the initiative
CooldownForPayloadIntCcoCampaignPayloadRecordReturns the cooldown of the paylaod
DurationIntVoidReturns the duration of the initiative
NameUniStringVoidReturns the localised name of the initiative
DescriptionUniStringVoidReturns the localised description of the initiative
KeyStringVoidReturns the key of the initiative
ImagePathStringVoidReturns the image path of the initiative
RecordListCcoInitiativeRecord (list)VoidReturns a list of all initiatives from the database
PayloadRecordListCcoCampaignPayloadRecord (list)VoidReturns a list of payloads for the initiative
LinkedAgentSubtypeListCcoAgentSubtypeRecord (list)VoidReturns a list of agent subtypes that are linked to this initiative
UpkeepResourceTransactionContextCcoCampaignResourceTransactionVoidReturns the upkeep of the resources used while the initiative is active

CcoInitiativeSetCategoryRecord

Wrapper for a INITIATIVE_SET_CATEGORY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyStringVoid
RecordListCcoInitiativeSetCategoryRecord (list)Void
DisplayNameUniStringVoid

CcoInitiativeSetRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ActivationCooldownVoidVoid
CategoryContextVoidVoid
RecordListVoidVoid
ItemsVoidVoid
ActiveInitiativeLimitVoidVoid
KeyVoidVoid

CcoLabSettingRecord

Wrapper for a LAB_SETTING_RECORD

Functions

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

CcoLandUnitArticulatedVehicleRecord

Wrapper for a LAND_UNIT_ARTICULATED_VEHICLE_RECORD

Functions

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

CcoLandUnitsToExtraEngineRecord

Wrapper for a LAND_UNITS_TO_EXTRA_ENGINE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoLandUnitsToExtraEngineRecord (list)Void
BattleEngineContextCcoBattlefieldEngineRecordVoid
AttachArticulationIntVoid
LandUnitContextCcoUnitLandRecordVoid

CcoLoadingScreenQuotesRecord

Record wrapper for a loading screen quote record

Functions

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

CcoMainUnitRecord

Wrapper for a main unit

Functions

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

CcoMeleeWeaponRecord

Functions

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

CcoMercenaryRecruitmentInfoRecord

Record wrapper for a mercenary recruitment info record

Functions

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

CcoMissileWeaponRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UseSecondaryAmmoPoolVoidVoid
RecordListVoidVoid
PrecursorVoidVoid
ProjectileContextListVoidVoid
KeyVoidVoid

CcoMissionIssuerRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DefaultRoundsBetweenVoidVoid
RecordListVoidVoid
IconPathVoidVoid
NameVoidVoid
KeyVoidVoid

CcoMissionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LocationXVoidVoid
LocalisedDescriptionVoidVoid
LocalisedMissionCompletedTextVoidVoid
LocalisedTitleVoidVoid
LocalisedSupplementaryTextVoidVoid
UiImageVoidVoid
QuestCharacterVoidVoid
RecordListVoidVoid
LocalisedDescriptionKeyVoidVoid
IsQuestVoidVoid
LocalisedTitleKeyVoidVoid
StickyByDefaultVoidVoid
KeyVoidVoid
QuestMissionVoidVoid
GenerateVoidVoid
PrioritisedVoidVoid
LocationYVoidVoid
TriggerRadiusVoidVoid
BaseCategoryWeightVoidVoid
EventCategoryContextVoidVoid

CcoMortuaryCultCategoryRecord

Wrapper for a MORTUARY_CULT_CATEGORY_RECORD

Functions

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

CcoMountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
EntityVoidVoid

CcoMountableArtilleryUnitsCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProbabilityVoidVoid
FactionContextVoidVoid
RecordListVoidVoid
UnitRecordContextVoidVoid
CapVoidVoid

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
KeyStringVoidReturn unique db key for setting
IsPerPlayerSettingBoolVoidReturns true if this setting can be set by all players (like difficulty), if false only host can set
LocalisedNameUniStringVoidReturns localised name for the setting
LocalisedTooltipUniStringVoidReturns localised tooltip for the setting

CcoMultiplayerCampaignSettingsOptionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
ValueVoidVoid
TooltipVoidVoid
MultiplayerCampaignSettingContextVoidVoid
LocalisedNameVoidVoid
OrderVoidVoid

CcoNarrativeViewerEntryRecord

Wrapper for a NARRATIVE_VIEWER_ENTRY_RECORD

Functions

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

CcoNarrativeViewerTabRecord

Wrapper for a NARRATIVE_VIEWER_TAB_RECORD

Functions

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

CcoNewContentPatchNoteRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OrderVoidVoid
RecordListVoidVoid
LocalisedPatchNoteVoidVoid
KeyVoidVoid

CcoOwnershipProductRecord

Wrapper for a OWNERSHIP_PRODUCT_RECORD

Functions

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

CcoPlagueEffectList

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TargetTypeListCcoString (list)VoidReturns a list of valid targets in string form
FactionSetListCcoFactionSetRecord (list)VoidReturns a list of faction sets that the effects apply to
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)
NameUniStringVoidReturns the name of the effect list, including the faction sets and the taregt list (example: 'Plague effects on Nurgle armies and settlements)

CcoPlagueEffectRecord

Wrapper for a PLAGUE_EFFECT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoPlagueEffectRecord (list)VoidReturns a list of all plague effect records in the table
EffectBundleListCcoEffectBundle (list)VoidReturns a list of effect bundles
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
KeyStringVoidReturns the key of the record

CcoPlagueRecord

Wrapper for a PLAGUE_RECORD

Functions

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

CcoPlagueSpecialCompositionRecord

Wrapper for a PLAGUE_SPECIAL_COMPOSITION_RECORD

Functions

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

CcoPooledResourceThresholdOperationSetRecord

Wrapper for a pooled_resource_threshold_operation_set_record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoPooledResourceThresholdOperationSetRecord (list)VoidReturns a list with all records in the table
CampaignOperationSetListCcoCampaignOperationSetRecord (list)VoidReturns a list of operation sets in this threshold
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
LowerBoundIntVoidReturns the lower bound, which is used for the enter operations
IsLockedByAchievementBoolVoidReturns true if this operation set is currently locked by an achievement
UpperBoundIntVoidReturns the upper bound, which is used for the exit operations
UnlocksAgentBoolCcoAgentRecordReturns true if any of the operation sets unlock the passed in agent
KeyStringVoidReturns the key of the record
IsGrantedByAchievementBoolVoidReturns true if this operation set is granted by unlocking an achievement
ChooseOperationSetVoidCcoCampaignFaction, CcoCampaignOperationSetRecordChooses the passed in operation set
UnlocksUnitBoolCcoMainUnitRecordReturns true if any of the operation sets unlock the passed in unit
ActiveOperationSetListCcoCampaignOperationSetRecord (list)CcoCampaignFactionReturns the operation set record that has been selected for this threshold, if any

CcoProjectileBombardmentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
RadiusSpreadVoidVoid
NumProjectilesVoidVoid
RecordListVoidVoid
ProjectileContextVoidVoid

CcoProjectileRecord

Cco wrapper for querying a projectile record

Functions

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

CcoProvinceAutomanagementFocusRecord

Wrapper for a PROVINCE_AUTOMANAGEMENT_FOCUS_RECORD

Functions

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

CcoProvinceInitiativeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
IconPathVoidVoid
StatusForCurrentProvinceVoidVoid
LocalisedNameVoidVoid
OrderVoidVoid
EffectBundleContextVoidVoid
KeyVoidVoid
EffectBundleContextForCurrentProvinceVoidVoid

CcoRegionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactionSwappingIdVoidVoid
RecordListVoidVoid
RegionGroupsVoidVoid
OwnerBundleContextVoidVoid
PaletteRgbVoidVoid
BattleNameKeyVoidVoid
KeyVoidVoid
OnscreenNameKeyVoidVoid

CcoReignOfChaosRecord

Wrapper for a REIGN_OF_CHAOS_RECORD

Functions

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

CcoResourceCostRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IdVoidVoid
TreasuryCostVoidVoid
PooledResourceCostsListVoidVoid
RecordListVoidVoid
RequiredTradeResourcesListVoidVoid
RequiredAncillariesListVoidVoid
IncomeTypeVoidVoid
ExpenditureTypeVoidVoid

CcoResourceRecord

Functions

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

CcoRitualCategoryGroupRecord

Wrapper for a RITUAL_CATEGORY_GROUP_RECORD

Functions

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

CcoRitualCategoryRecord

Wrapper for a RITUAL_CATEGORY_RECORD

Functions

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

CcoRitualChainRecord

Wrapper for a RITUAL_CHAIN_RECORD

Functions

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

CcoRitualPayloadAncillaryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AncillaryContextVoidVoid
RecordListVoidVoid
PayloadVoidVoid

CcoRitualPayloadChangeAgentCapacityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CapacityVoidVoid
RecordListVoidVoid
AgentRecordContextVoidVoid
PayloadContextVoidVoid

CcoRitualPayloadChangeUnitCapacityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitRecordContextVoidVoid
CapacityVoidVoid
PayloadContextVoidVoid
RecordListVoidVoid

CcoRitualPayloadDiplomaticAttitudeChangeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PayloadVoidVoid
AttitudeDeltaVoidVoid
RecordListVoidVoid

CcoRitualPayloadRecord

Wrapper for a ritual payload record

Functions

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

CcoRitualPayloadSpawnAgentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SpawnToPoolVoidVoid
RecordListVoidVoid
AgentTypeContextVoidVoid
AgentSubtypeContextVoidVoid
PayloadVoidVoid

CcoRitualPayloadSpawnArmyRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SpawnAtRitualSiteVoidVoid
RecordListVoidVoid
IdVoidVoid
FactionOverrideContextVoidVoid
PayloadVoidVoid
SpawnableForceContextVoidVoid

CcoRitualPayloadSpawnMercenaryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
SpawnableUnitContextVoidVoid
IdVoidVoid
PayloadVoidVoid

CcoRitualPayloadSpawnStormRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
MaxTurnsDurationVoidVoid
StrengthVoidVoid
StormTypeContextVoidVoid
PayloadVoidVoid
RegionContextVoidVoid

CcoRitualPayloadTeleportArmyRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RegionContextVoidVoid
RecordListVoidVoid
PayloadContextVoidVoid

CcoRitualPayloadTriggerDilemmaRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PayloadVoidVoid
DilemmaContextVoidVoid
RecordListVoidVoid

CcoRitualRecord

Record wrapper for a RITUAL_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CastTimeIntVoidReturns the cast time of the ritual
CooldownTimeIntVoidReturns the cooldown time until the ritual can be performed again
SlaveCostIntVoidReturns the amount of slaves needed to perform this ritual
GlobalCooldownTimeIntVoidReturns the cooldown time of the ritual among all campaign faction
CategoryContextCcoRitualCategoryRecordVoidReturns a CcoRitualCategoryRecord with the category the ritual is part of
DisplayNameUniStringVoidReturns the localised name of the ritual
AdditionalExplanationTextUniStringVoidReturns the additional ui explanation text of the ritual
ResourceTransactionContextCcoCampaignResourceTransactionVoidReturns the base resource cost of the ritual
CategoryStringVoidReturns a string with the category the ritual is part of
StartPayloadContextCcoRitualPayloadRecordVoidReturns a CcoRitualPayloadRecord with the payload that gets applied at the start of the ritual
CompletionPayloadContextCcoRitualPayloadRecordVoidReturns a CcoRitualPayloadRecord with the payload that gets applied at the completion of the ritual
DescriptionUniStringVoidReturns the localised description of the ritual
CompletionPayloadEffectBundleListCcoEffectBundle (list)VoidReturns a list of effect bundles that get applied at the completion of the ritual
KeyStringVoidReturns the key of the ritual
IconStringVoidReturns the icon path of the ritual
ActiveEffectListCcoEffect (list)VoidReturns a list of effects that are applied while the ritual is active
RecordListCcoRitualRecord (list)VoidReturns a list with all ritual records from the database
StartPayloadEffectBundleListCcoEffectBundle (list)VoidReturns a list of effect bundles that get applied at the start of the ritual
InterruptableBoolVoidReturns true if the ritual can be interrupted
DelayPayloadApplicationBoolVoidReturns true if payload application is delayed for this ritual
TargetCategoryCooldownIntVoidReturns the cooldown of the ritual category
HostileBoolVoidReturns true if the ritual is hostile
FailureCooldownTimeIntVoidReturns the cooldown time of the ritual after failing to perform

CcoSeasonRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
OnscreenVoidVoid
RecordListVoidVoid

CcoSettlementClimateTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UiNameVoidVoid
UiDescriptionVoidVoid
UiIconImageVoidVoid
UiBackgroundImageVoidVoid
TypeVoidVoid
RecordListVoidVoid

CcoSpawnableForceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
UnitsListVoidVoid
UnitListsListVoidVoid

CcoSpawnableForceUnitJunctionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
MinAmountVoidVoid
MinXpVoidVoid
IdVoidVoid
MaxAmountVoidVoid
MaxXpVoidVoid
SpawnableForceVoidVoid
UnitContextVoidVoid

CcoSpawnableForceUnitListJunctionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
MaxXpVoidVoid
MinAmountVoidVoid
MinXpVoidVoid
IdVoidVoid
MaxAmountVoidVoid
SpawnableForceVoidVoid
UnitListContextVoidVoid

CcoSpecialAbilityGroupRecord

Wrapper for a SPECIAL_ABILITY_GROUP_RECORD record from special_ability_groups_tables

Functions

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

CcoSpecialAbilityIntensitySettingRecord

Wrapper for a SPECIAL_ABILITY_INTENSITY_SETTING_RECORD

Functions

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

CcoSpecialAbilityPhaseRecord

Wrapper for a SPECIAL_ABILITY_PHASE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AbilityPhaseEffectsListCcoSpecialAbilityPhaseStatEffectRecord (list)VoidReturns a list of CcoSpecialAbilityPhaseStatEffectRecord so know what stats affected by phase
AbilityRechargeChangeFloatVoidReturns the modifier applied to recharge times of abilities
ImbueIgnitionBoolVoidReturns true if this imbues a units attack with flaming attack bonuses
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)
FatigueChangeRatioFloatVoidReturns the multiplier applies to fatigue (for freezing fatigue or tiring a unit out)
ResurrectBoolVoidReturns true if this resurrects a unit
PhaseEffectFlagListCcoStringValue (list)VoidReturns a list of CcoStringValues for the phase effect flags (special case things like freeze fatigue)
RemovesAttributeBoolCcoUnitAttributeRecordReturns true if this phase removes provided unit attribute, e.g. removes causes fear attribute on Whip of Agony
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
SpreadRangeIntVoidReturns the range the effect can spread like a contagion if this is set to a non-zero value
IntensityFloatExpressionStateReturns the ability intensity 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))
HasEffectsBoolVoidReturns true if this phase has effects
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)
HasUnitAttributesBoolVoidReturns true if this phase provides unit attributes
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)
ManaRegenModFloatVoidReturns the modifier to mana regeneration
DamageAmountIntVoidReturns the record wrapped damage amount
IconPathStringVoidReturns icon path to use in UI icons representing the phase
HasManaRegenModBoolVoidReturns true if regenerates mana
OnscreenNameUniStringVoidReturns the localised name to display on the UI
DamagePerSecondIntVoidReturns the calculated damage per second amount
HasManaMaxDepletionModBoolVoidReturns true if this depletes mana
KeyStringVoidReturns the db key of the phase record
HpChangeFrequencyIntVoidReturns how often applys HealPercent to target
HasBarrierHealAmountBoolVoidReturns true if this phase heals barrier
DamageIntVoidReturns the calculated overall damage amount
HasDamageAmountBoolVoidReturns true if this phase deals damage
EffectTypeStringVoidReturns string for positive, negative or both
AdditionalUiEffectListCcoUnitAbilitiesAdditionalUiEffectRecord (list)VoidReturns the additional ui effect list of this phase
DurationIntVoidReturns the duration in seconds that this phase lasts
HasAbilityRechargeChangeBoolVoidReturns true if this phase affects recharge
ImbueContactContextCcoSpecialAbilityPhaseRecordVoidReturns the CcoSpecialAbilityPhaseRecord for the effect imbued to the target
HasHealAmountBoolVoidReturns true if this phase heals
MoraleChangeIntVoidReturns the modifier to morale
IsHiddenInUiBoolVoidReturns true if this phase should NOT be displayed in the UI
EffectListCcoEffect (list)ExpressionState, Float (optional)Returns a list of CcoEffect so can see effects of phase
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%)
AffectsAlliesBoolVoidReturns true if this phase affects allies
UnitAttributeListCcoUnitAttributeRecord (list)VoidReturns a list of CcoUnitAttributeRecord provided by phase
AffectsEnemiesBoolVoidReturns true if this phase affects enemies
RecordListCcoSpecialAbilityPhaseRecord (list)VoidReturns list of all CcoSpecialAbilityPhaseRecord in db table special_ability_phases_table
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%)
ImbueMagicalBoolVoidReturns true if this imbues a units attack with magic attack bonuses
InspirationAuraRangeModFloatVoidReturns the modifier applies to inspiration aura of a unit

CcoSpecialAbilityPhaseStatEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HowVoidVoid
PhaseVoidVoid
ValueVoidVoid
RecordListVoidVoid
StatVoidVoid

CcoSubcultureRecord

Wrapper for a subculture record

Functions

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

CcoTechnologyRecord

Record wrapper for a technology record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LongDescriptionUniStringVoidReturns the long description of the technology
KeyStringVoidReturns the key of the record
IsHiddenBoolVoidReturns true if this technology should be hidden in the technology screen
RecordListCcoTechnologyRecord (list)VoidReturns a list with all technologies in the table
OnscreenNameUniStringVoidReturns the localised name of the technology
ShortDescriptionUniStringVoidReturns the short 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
LeftMostTechnologyCcoCampaignTechnologyCcoCampaignFaction (optional)Returns the context of the left-most technology for this group
RightMostTechnologyCcoCampaignTechnologyCcoCampaignFaction (optional)Returns the context of the right-most technology for this group
BottomMostTechnologyCcoCampaignTechnologyCcoCampaignFaction (optional)Returns the context of the bottom-most technology for this group
BackgroundImageStringVoidReturns the background image for this group
RecordListCcoTechnologyUiGroupRecord (list)VoidReturns a list with all technology ui groups in the table
TopMostTechnologyCcoCampaignTechnologyCcoCampaignFaction (optional)Returns the context of the top-most technology for this group
NameUniStringVoidReturns the localised name of this group, if any
DescriptionUniStringVoidReturns the localised description of this group, if any
KeyStringVoidReturns the key of this record
ColourColourVoidReturns the colour of the group

CcoTechnologyUiTabRecord

Wrapper for a TECHNOLOGY_UI_TAB_RECORD

Functions

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

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
ProvinceContextCcoCampaignProvinceVoidReturns a CcoCampaignProvince of the province in which the teleport node is positioned
OwningFactionContextCcoCampaignFactionVoidReturns a CcoCampaignFaction of the faction that own the region where the node is positioned
RecordListCcoTeleportationNetworkNodeRecord (list)VoidReturns a list with all records in the database
TravelTimeIntVoidReturns the time it takes to travel to this node
PositionVector4VoidReturns the display position of the node
TeleportationTemplateContextCcoTeleportationNodeTemplateRecordVoidReturns the context of the teleportation template that the node is part of, if any
HandleDoubleClickVoidVoidHandles a double click event
KeyStringVoidReturns the key of the record

CcoTeleportationNodeTemplateRecord

Wrapper for a TELEPORTATION_NODE_TEMPLATE_RECORD

Functions

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

CcoTimeOfLegendsCampaignRecord

Wrapper for a TIME_OF_LEGENDS_CAMPAIGN_RECORD

Functions

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

CcoTreasureHuntExtraInformationRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ColourBlindModeOverlayVoidVoid
Option2ImageVoidVoid
Option3ImageVoidVoid
KeyVoidVoid
Option1ImageVoidVoid
OverlayImageVoidVoid
Option4ImageVoidVoid

CcoUiColourRecord

Functions

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

CcoUiMainThemeOptionRecord

Wrapper for a UI_MAIN_THEME_OPTION_RECORD

Functions

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

CcoUiPurchasableEffectsToHexIdRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TierVoidVoid
RecordListVoidVoid
HexIdVoidVoid
CategoryVoidVoid
UnitPurchasableEffectContextVoidVoid

CcoUiUnitGroupParentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OnscreenNameVoidVoid
GroupListVoidVoid
RecordListVoidVoid
MpCapVoidVoid
UnitListVoidVoid
IconVoidVoid
KeyVoidVoid
OrderVoidVoid

CcoUiUnitGroupingRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ParentGroupVoidVoid
RecordListVoidVoid
OnscreenVoidVoid
IconVoidVoid
KeyVoidVoid
TooltipVoidVoid

CcoUiUnitStatusRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
PriorityVoidVoid
TooltipVoidVoid
IconPathVoidVoid

CcoUnitAbilitiesAdditionalUiEffectRecord

Wrapper for a UNIT_ABILITIES_ADDITIONAL_UI_EFFECT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUnitAbilitiesAdditionalUiEffectRecord (list)Void
KeyStringVoid
SortOrderIntVoid
LocalisedTextUniStringVoid
EffectStateStringVoid

CcoUnitAbilityRecord

Functions

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

CcoUnitAttributeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
RecordListVoidVoid
BulletTextVoidVoid
IconPathVoidVoid
ImuedEffectTextVoidVoid
RemovesEffectTextVoidVoid

CcoUnitLandRecord

Wrapper for a UNIT_LAND_RECORD

Functions

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

CcoUnitListRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitsListVoidVoid
RecordListVoidVoid
KeyVoidVoid

CcoUnitPortholeCameraSettingRecord

Wrapper for a UNIT_PORTHOLE_CAMERA_SETTING_RECORD

Functions

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

CcoUnitPurchasableEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectBundleContextVoidVoid
CategoryContextVoidVoid
ResourceCostVoidVoid
ResourceNameVoidVoid
KeyVoidVoid
CostContextVoidVoid
RecordListVoidVoid
ResourceIconVoidVoid

CcoUnitPurchasableEffectsCategoryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconPathVoidVoid
KeyVoidVoid
RecordListVoidVoid
OnscreenNameVoidVoid
OnscreenDescriptionVoidVoid

CcoUnitSetRecord

Wrapper for a UNIT_SET_RECORD

Functions

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

CcoUnitSetToMpUnitCapRecord

Wrapper for a UNIT_SET_TO_MP_UNIT_CAP_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUnitSetToMpUnitCapRecord (list)Void
LocalisedNameUniStringVoid
CapIntVoid

CcoUnitSpecialAbilityRecord

Functions

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

CcoUnitsCustomBattleMountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CostVoidVoid
RecordListVoidVoid
IconNameVoidVoid
LocalisedDescriptionVoidVoid
MountedUnitContextVoidVoid
MountNameVoidVoid
BaseUnitContextVoidVoid

CcoUnitsCustomBattlePermissionRecord

Functions

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

CcoUnitsCustomBattleTypeCategoryRecord

Wrapper for a UNITS_CUSTOM_BATTLE_TYPE_CATEGORY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUnitsCustomBattleTypeCategoryRecord (list)Void
CategoryNameUniStringVoid
CategoryKeyStringVoid
IsHorizontalGroupBoolVoid
CategoryDescriptionUniStringVoid

CcoUnitsCustomBattleTypeRecord

Wrapper for a UNITS_CUSTOM_BATTLE_TYPE_RECORD

Functions

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

CcoVictoryConditionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid

CcoVideoRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
PlayVideoVoidVoid

Common

CcoAgentSubtypeAgentPair

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AgentContextCcoAgentRecordVoid
UnitDetailsContextCcoUnitDetailsVoid
AgentSubtypeContextCcoAgentSubtypeRecordVoid

CcoBattleResult

Wrapper for a battle result

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsDrawBoolVoid
ResultTypeRecordContextCcoBattleResultTypeRecordVoid
OtherResultAllianceContextCcoBattleResultAllianceVoid
IsLocalPlayerWinnerBoolVoid
LocalResultPlayerAllianceContextCcoBattleResultAllianceVoid
DurationUniStringVoid

CcoBattleResultUnit

Wrapper for a battle result unit

Functions

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

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
MercenaryPoolSizeFilteredByFactionIntCcoCampaignFactionReturns the size of the list of available mercenary pool units filtered by faction
IsProvidingMercenaryUnitForFactionBoolCcoCampaignFactionReturns if the mercenary pool provides any unit for the given faction
MercenaryPoolSizeIntVoidReturns the size of the list of available mercenary pool units
MercenaryPoolUnitListCcoCampaignMercenaryPoolUnit (list)VoidReturns the list of available mercenary pool units

CcoClickHoldContext

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HoldPercentFloatVoidReturns the percentage hold value

CcoContextSelection

Functions

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

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
PlagueComponentContextCcoCampaignPlagueIngredientCcoCampaignFactionReturns the first linked plague component if it exists
EffectScopeContextCcoCampaignEffectScopeRecordVoidReturns the CcoCampaignEffectScopeRecord if it exists
PriorityIntVoidReturns the priority of the effect, used for ordering and if 0 isn't shown in UI
ValueIntVoidReturns the raw value of the effect as a number
RitualContextCcoRitualRecordExpressionStateReturns the first linked CcoRitualRecord if it exists
AttributeContextCcoUnitAttributeRecordExpressionStateReturns the linked CcoUnitAttributeRecord with this effect if exists, only valid to call when created with a CAMPAIGN_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
PooledResourceContextCcoCampaignPooledResourceExpressionState, String, CcoCampaignFactionReturns the linked CcoCampaignPooledResource for the faction passed in, with the specified key, only valid to call when created with a CAMPAIGN_EFFECT
IsPositiveBoolVoidReturns true if this is a positive effect
AdditionalDetailsUniStringVoidReturns the additional description for this effect, if it exists
DevUnitsFromEffectExcludedCcoMainUnitRecord (list)ExpressionStateReturns a list of all the units affected by the CAMPAIGN_EFFECT that are excluded.debug, hide_in_ui
DevUnitSetsFromEffectExcludedCcoUnitSetRecord (list)ExpressionStateReturns a list of all the unit sets affected by the CAMPAIGN_EFFECT that are excluded.debug, hide_in_ui
AbilityContextCcoUnitAbilityExpressionStateReturns the linked CcoUnitAbility with this effect if exists, only valid to call when created with a CAMPAIGN_EFFECT
AdditionalDetailsIconStringVoidReturns the icon for the additional description of this effect, if it exists
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
LocalisedTextUniStringVoidReturns the localised text for the effect
UnitsFromEffectNotExcludedCcoMainUnitRecord (list)ExpressionStateReturns a list of all the units affected by the CAMPAIGN_EFFECT that are not excluded.
EffectKeyStringExpressionStateReturns the effect record key, only valid to call when created with a CAMPAIGN_EFFECT
PlagueListCcoPlagueRecord (list)ExpressionStateReturns a list of linked plague records if they exits, only valid to call when created with a CAMPAIGN_EFFECT
AgentListCcoAgentRecord (list)ExpressionStateReturns a list of linked agent records if they exist, only valid to call when created with a CAMPAIGN_EFFECT
IconPathStringVoidReturns the icon path
UnitSetsListCcoUnitSetRecord (list)ExpressionStateReturns a list of linked unit sets if they exist, only valid to call when created with a CAMPAIGN_EFFECT
InitiativeSetsListCcoInitiativeSetRecord (list)VoidReturns a list of linked INITIATIVE_SET_RECORDs
UnitListsListCcoUnitListRecord (list)VoidReturns a list of linked UNIT_LIST_RECORDs
UnitListCcoMainUnitRecord (list)ExpressionStateReturns a list of linked units if they exits, only valid to call when created with a CAMPAIGN_EFFECT
ManipulationInfoContextCcoCampaignDiplomacyManipulationInfoExpressionState, CcoCampaignFactionReturns the first linked CcoCampaignDiplomacyManipulationInfo if it exists

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
StalledNetworkPlayerListCcoNetworkPlayer (list)VoidReturns list of CcoNetworkPlayers waiting to load into the game still
HostPlayerContextCcoNetworkPlayerVoidReturns the CcoNetworkPlayer for the host player
LocalPlayerContextCcoNetworkPlayerVoidReturns the CcoNetworkPlayer for the local player
FriendListCcoNetworkPlayer (list)VoidReturns the friend list of the local player as a list of CcoNetworkPlayer
PlayerListCcoNetworkPlayer (list)VoidReturns list of CcoNetworkPlayers in the current game

CcoOwnershipProductRequirement

Wrapper for an ownership product mask

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OwnershipProductRecordListCcoOwnershipProductRecord (list)VoidReturns a list of CcoOwnershipProductRecord

CcoPieData

Functions

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

CcoPieSlice

Functions

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

CcoRangeWithContext

Functions

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

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

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.
FindValueForKeyArgumentPackStringReturns the value for the matching key in the table value of the current node if present, will traverse children using DFS.
ValueForKeyArgumentPackStringReturns the value for the matching key in the table value of the current node if present, doesn't traverse more nodes.
KeyArgumentPackVoidReturns the key of this node, can be a bool, String, numerical value, or another list of nodes
ValueArgumentPackVoidReturns the value of this node, can be a bool, String, numerical value, or another list of nodes

CcoSliderValueContext

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SliderValueFloatVoidReturns the percentage value of the slider

CcoStringValue

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IntValueIntVoidReturns the numeric part of the value as an int
FloatValueFloatVoidReturns the numeric part of the value as a float
StringValueUniStringVoidReturns the string part of the value

CcoTreeLink

Functions

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

CcoTreeLinkWithContexts

Functions

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

CcoUnitAbility

Wrapper for a BATTLE_SETUP_SPECIAL_ABILITY

Functions

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

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

Global Functions

file

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

flow

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

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
ParseFactionTextReplacementUniStringExpressionState, UniString, CcoFactionRecordReturns parsed text replacement tags in the given string and uses the faction record to retrieve the correct stringstring
FormatNumberCustomUniStringFloat, FloatReturns a formatted number using ICU library.string
StringLengthIntStringReturns the length of the given stringstring, deprecated
FormatNumberUniStringFloatReturns a formatted number using ICU library.string
StringSubStringStringString, Int, Int (optional)Returns a substring between the given start position and optional lengthstring, 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
FormatUniStringExpressionState, UniString, ArgumentPackFormat the given string based on the argument liststring
StringEndsWithBoolExpressionState, UniString, UniStringReturns true if the first string ends with the second stringstring, deprecated
StringContainsBoolExpressionState, UniString, UniStringReturns true if the first string contains the second stringstring, deprecated
IsStringEmptyBoolStringReturns true if the string is emptystring, deprecated
ToUpperUniStringExpressionState, UniStringConvert string to an uppercase stringstring, deprecated
IsStringEmptyBoolUniStringReturns true if the string is emptystring, deprecated
ParseTextReplacementsUniStringExpressionState, UniStringReturns a string that has had text replacements parsed (any text replacement tags will be replaced with actual text)string, deprecated
StringStartsWithBoolExpressionState, UniString, UniStringReturns true if the first string starts with the second stringstring, deprecated
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
FormatPercentageUniStringFloatReturns a formatted percentage using ICU library.string
FormatPercentageCustomUniStringFloat, IntReturns a formatted percentage using ICU library with the specified numebr of decimal places.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
RunCLIMultiplayerVoidStringSsame as RunCLI but if mp campaign runs the command on all players games at the same timedebug
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
RunCLIVoidStringRuns console command supplied, but not in final release to avoid calling commands not meant todebug
BreakpointArgumentPackExpressionState, Expression, Expression (optional)Used to wrap an expression and will break in debugger before evaluationdebug

prefs

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

deprecated

NameReturn TypeArgumentsDescriptionTagsEvents
StringLengthIntStringReturns the length of the given stringstring, deprecated
StringSubStringStringString, Int, Int (optional)Returns a substring between the given start position and optional lengthstring, 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
StringEndsWithBoolExpressionState, UniString, UniStringReturns true if the first string ends with the second stringstring, deprecated
StringContainsBoolExpressionState, UniString, UniStringReturns true if the first string contains the second stringstring, deprecated
IsStringEmptyBoolStringReturns true if the string is emptystring, deprecated
ToUpperUniStringExpressionState, UniStringConvert string to an uppercase stringstring, deprecated
IsStringEmptyBoolUniStringReturns true if the string is emptystring, deprecated
ParseTextReplacementsUniStringExpressionState, UniStringReturns a string that has had text replacements parsed (any text replacement tags will be replaced with actual text)string, deprecated
StringStartsWithBoolExpressionState, UniString, UniStringReturns true if the first string starts with the second stringstring, deprecated
FloatToPercentFloatFloatReturns value *100...math, deprecated

database

NameReturn TypeArgumentsDescriptionTagsEvents
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
DatabaseRecordContextContextExpressionState, String, StringTakes a database record wrapper context type id and a db key, and returns the wrapper for that recorddatabase
DatabaseRecordsContextListExpressionState, StringTakes a database record wrapper context type id and returns a list of all the wrappers of this type.database
DefaultDatabaseRecordContextStringTakes a database record wrapper context type id and returns the default record for this type.database

context

NameReturn TypeArgumentsDescriptionTagsEvents
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
GenerateContextListExpressionState, Int, Expression (optional)Returns a list with the given context repeated N amount of times.context
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
JoinContextListExpressionState, ArgumentPackReturns a context list of all the contexts of the functions passed as argumentscontext
StoredContextFromParentRequiredContextExpressionState, StringReturns the stored context of specified type from the specified parent, and will assert on failurecontext
StoreListCcoContextListContextList, StringStores a context list with an id so you can easily retrieve itcontext
EvaluateExpressionArgumentPackString, ExpressionStateEvaluates specified expressioncontext
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
StoredContextFromParentContextExpressionState, StringReturns the stored context of specified type from the specified parentcontext
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

Misc

NameReturn TypeArgumentsDescriptionTagsEvents
SaveRadarImageVoidVoid
SetValueVoidVoid
UnitAbilityContextFromStringCcoUnitAbilityStringCreates CcoUnitAbility for ability with specified key
IsFullscreenPanelOpenBoolVoidReturns true if a fullscreen panel is open
IsCameraHeightTransitioningBoolVoidReturns true if camera currently doing a height transition between tacmap and normal mode (camera locked to the height transition)
StorePlatformIdStringVoidReturns the id of the platform currently playing on (e.g. steam, epic, microsoft)
ClearSelectionVoidVoid
IsOfTypeBoolContext, ArgumentPackReturns true if the type of the given context is the one specified in the argument list.
IsRefreshingVoidVoid
SetVfxColourTintVoidVoid
AddDefaultSkinPathStringStringAdds default skin path to beginning of supplied image name (ui/skins/default/). Actually skinning handled internally so dont need to worry about that.
CurrentSkinStringVoidReturns the current UI skin
CampaignRadarPositionVector4Vector4Converts a world position to a radar position (0-1 percent used for ContextRadarIcon)
IsTacticalMapBoolVoidReturns true if currently in tacmap view
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
ExportMetadataVoidVoid
SetSelectedVoidVoid
HasRecipeBeenCookedVoidVoid
PassContextContextContext
MinValueFloatContextList, ExpressionState, ExpressionReturns the smallest evaluated value (for example if MinValue(CeoList, RarityLevel) would return smallest rarity level)
PlayOneShotAnimationVoidVoid
YearSeasonFormatUniStringInt, UniStringTakes a year then season string, and puts in right order based on language (asian languages have other way around)
QuitCampaignVoidVoidQuits the current campaign
SkipRevealVoidVoidSkips the reveal of text, shows all the text
IsMultiplayerLobbyActiveBoolVoidReturns true if a multiplayer lobby currently active, handy for checking if current game is multiplayer in frontend, battle or loading screens
ToggleComponentVoidExpressionState, StringSimilar to CreateComponent above, but if component already exists it will trash it. Added mainly to simplify dev ui creation.
ShouldShowShadowyDealingsInfoBoolVoidReturns true if should show shadowy dealings info, specific to some skaven factions in WH3
SetEnabledVoidVoid
MainThemeColourColourExpressionStateReturns the colour of the main theme skin
CurrentSelectedContextContextVoid
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
SetVfxColourAlphaVoidVoid
TakeContextListContextList, IntReturns the first n elements of the list.
OpenWarCoordinationPanelVoidCcoCampaignFaction (optional)Opens the war-coordination panel with faction pre-selected if given one.
IsLocChineseBoolVoidReturns true if using chinese
IsSelectedVoidVoid
ClearSelectionVoidVoid
NumberOfCookedRecipesVoidVoid
BattleIsDisplayingAllUIBoolVoidReturns true if holding space shortcut to force display all UI
FreeCcoSymbolTestContextVoid
SaveCampaignVoidUniStringSaves game with specified name (used by script for example)
FormatTimeUniStringFloatGiven a number in seconds, formats into minutes and seconds
SelectPanelButtonVoidVoid
IndexOfEntryVoidVoid
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)
IsContentLockedBoolStringCheck if content is locked. WARNING - DO NOT RELY ON THIS AS ONLY MEANS OF LOCKING ACCESS TO CONTENT SINCE EASY TO MOD!
SelectedOrContainedCharacterCcoCampaignCharacterVoidReturns either the contained character(agent) if exists, or the selected character if any
CurrentColourVoidVoid
CloseSpellBrowserVoidVoidSpecific to WH3, Closes the spell/unit browser
TooltipParentVoidVoid
FilterProfanityUniStringUniStringGiven some text, returns a filtered version of text replacing any profanity with *
SkipContextListContextList, IntSkip the first x elements of the list.
SetVfxSpawnSpeedVoidVoid
UnitUpgradeManagerContextCcoCampaignUnitUpgradeManagerVoidReturns the CcoCampaignUnitUpgradesManager.
HasAnySavedGamesBoolVoidReturns true if player has any saved games (for continue campaign functionality for example)
RegionSlotFromBuildingChainCcoCampaignBuildingSlotCcoBuildingChainRecordReturns the slot that contains a building from the given chain
AvailableSkinListCcoString (list)VoidReturns list of available skins the game uses assuming that all skins have a folder in the skins/ folder
DirectoryFileListCcoString (list)String, String, BoolReturns list of files in specified directory
GetListVoidVoid
IsUnitSelectedBoolVoidReturns true if any unit is currently selected
ClearSelectionForParentVoidVoid
ShowTechTreeVoidCcoTechnologyRecord (optional)Opens the tech tree. Opens to specified tech if optionally provided
IsWarCoordinationOpenBoolVoidReturns true if war coordination panel open
IsScriptLockActiveBoolStringReturns true if specified script ui override is currently set to locked by script
ValueMaxVoidVoid
GameCoreContextCcoGameCoreVoidReturns the game core context
ClearSelectionVoidVoid
QuitToMainMenuVoidVoidQuits to frontend main menu from battle or campaign
StringExistsBoolStringReturns true if supplied string key exists. Will search all tables (key is in format tablename_fieldname_recordkey)
ShowCustomPromptVoidExpressionState, String, String, UniString, UniString, Expression, Expression (optional), UniString (optional), UniString (optional), Context (optional)Shows a prompt with two buttons.
SetVfxSpawnRateScaleFactorVoidVoid
TransformContextListContextList, ExpressionState, ExpressionTransforms the list into a new one where each element is produced by the given expression (like the map function).
SelectedProvinceCcoCampaignProvinceVoidReturn the selected province if any
FreeContextContextVoid
LoadSaveVoidStringLoads the specified save file
VramUsageStringVoidReturns the current VRAM memory used (requested for GSAT autotest script for storing information for benchmarks)
CampaignVariableIntValueIntStringReturn an int value of the campaign variable passed in, if such variable exists
HandleEquipVoidVoid
LocalisedDateFormatStringVoidReturns the localised date format
ShowEscapeMenuVoidVoidShows the Escape menu in battle/campaign
MultiplayerRootContextCcoMultiplayerRootVoidReturns the CcoMultiplayerRoot context, useful for getting information on current mp setup
IsCampaignOverlayShowingBoolVoidReturns true if campaign overlay showing (when hold space)
ForEachVoidContextList, ExpressionState, ExpressionPerforms expression on each context in list (for giving commands to multiple contexts)
LocLanguageUniStringVoidReturns the localisation language the game is using
SelectedCharacterCcoCampaignCharacterVoidReturn the selected character if any
SelectVoidVoid
PendingBattleEnemyFactionCcoCampaignFactionVoidReturns the current enemy faction to player in prebattle screen
SelectedComponentVoidVoid
GiftUnitsVoidVoid
ZoomToTacticalViewVoidVoidZooms the camera to the tactical view
SetScriptLockVoidString, BoolSets episodic script override flag to be enabled / disabled specified by key
IsSelectedVoidVoid
SetMaxRangeValueVoidVoid
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
GetTextVoidVoid
RemovePinVoidVoid
ScrollToComponentVoidVoid
BattleSelectionContextCcoBattleSelectionVoidGets the battle selection context (info on what is selected, commands to select, etc)
ChangeCursorSizeVoidIntSets the cursor scaling setting. 0-default, 1-2k, 2-4k
LocUniStringString, ArgumentPackReturns a localised string for supplied key. In campaign will check campaign_localisation_strings first. After that will use random_localisation_strings table
IsAnyHUDPanelOpenBoolVoidReturns true if any HUD panel is open
PlayerAllianceCcoBattleAllianceVoidGets the players alliance context in battle
StopMovieVoidVoid
rule_testBoolVoid
InPostBattleBoolVoidReturns whether the current battle phase is post battle
PasteStringFromClipboardUniStringVoidReturns the text currently in the clipboard
DistinctContextListContextList, ExpressionState, Expression (optional)Returns the distinct elements of the list.
IsTutorialBoolVoidReturns true if current game mode is part of the prologue/tutorial (in battle or campaign)
GetEffectsListVoidVoid
IsShroudedBoolVector4Returns true if the specified display/real position is covered under the shroud
SetMinRangeValueVoidVoid
ShowPromptVoidExpressionState, UniString, UniString, Expression, Expression (optional), UniString (optional), UniString (optional), Context (optional)Shows a prompt with two buttons.
HasTargetSelectedVoidVoid
CanGiftUnitsToPlayerVoidVoid
SelectionParentContextVoidVoid
BattleRadarPositionVector4Vector4Converts world space position to 2d radar position percentage
IsAnyTeleportHUDPanelOpenBoolVoidReturns true if any teleport HUD panel is open
StringGetUniStringStringReturns a string for supplied key. Will search all tables (key is in format tablename_fieldname_recordkey)
ClearSelectionVoidVoid
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
IsDemoUIEnabledBoolVoidReturns true if demo ifdef enabled for bespoke demos
TestReturnAnyArgumentPackVoid
SelectedSettlementCcoCampaignSettlementVoidReturn the selected settlement if any
IsUnitPartOfSetVoidVoid
SummedValueListContextListContextList, ExpressionState, Expression, ExpressionReturns a list that has combined similar contexts.
IsLoadingScreenActiveBoolVoidReturns true if currently in the loading screen
EnemyAllianceCcoBattleAllianceVoidGets the enemy alliance context in battle
CloseUnitInfoPanelVoidVoidCloses the Unit info panel type.
SelectedContextsVoidVoid
SetValueVoidVoid
PlayerArmyCcoBattleArmyVoidGets the players army context in battle
ClearPinVoidVoid
ClosePanelVoidString, Bool (optional)Will close a specified panel
CurrentSelectionVoidVoid
HasPlayedMovieVoidVoid
TestReturnAnyTypesArgumentPackInt
AnySelectedVoidVoid
AnyBoolContextList, ExpressionState, ExpressionReturns true if at least one object of the list satisfies the given expression.
IsSimultaneousTurnsBoolVoidReturns true if simultaneous turns mode
RitualCastTimePercentageVoidVoid
LockCursorVoidStringLocks cursor to specified type
CampaignRootCcoCampaignRootVoidReturn the root campaign context in campaign
UpgradingUnitsContextListVoidVoid
IsTimeOfLegendsCampaignBoolVoidReturns true if currently playing a multiplayer time of legends campaign
test_get_listsContextVoid
GetListVoidVoid
CloseAllPanelsVoidVoidCloses all open panels
IsHUDPanelOpenBoolStringReturns true is the specified HUD panel is open
CurrentNegotiatingFactionContextCcoCampaignFactionVoidReturns the faction currently negotiating with in diplomacy
CopyStringToClipboardVoidUniStringCopies the supplied text to the clipboard for pasting
CloseVoidVoid
IsBenchmarkBoolVoidReturns true if current game mode is a benchmark (in battle or campaign)
GetContextObjectIdStringContextReturns the object id of the given cco.
IsPlayingMovieVoidVoid
BattleCursorContextCcoBattleCursorContextVoidGets the battle cursor context (mouseover info)
TargetSettlementContextVoidVoid
PlayMovieVoidVoid
InPendingBattleBoolVoidReturns whether there is a pending battle going on
TestArgPack_StringStringArgumentPack
UnlockCursorVoidVoidUnlocks the cursor
IsMultiplayerBoolVoidReturns true if current game mode is multiplayer (in battle or campaign)
IsSkinActiveBoolStringReturns whether the specified skin is currently being used
IsChildOfAnySearchResultBoolExpressionState, CcoComponent
ResetUnitCardStatesVoidVoid
AllBoolContextList, ExpressionState, ExpressionReturns true if all objects of the list satisfy the given expression.
InterpolateColoursColourColour, Colour, FloatReturns the interpolation of two colours using specified colours and percent
EventFeedContextCcoCampaignEventFeedVoidReturn the event feed context
CorruptionPendingFactorListCcoStringValue (list)CcoCampaignPooledResourceSpecial case function to return pending factor list for corruption pooled resources. This is so we dont give away skaven presence basically.
PinVoidVoid
OpenUnitInfoPanelVoidContextOpens the unit info panel.
DiplomacySelectedFactionContextCcoCampaignFactionVoidReturns the faction currently selected in diplomacy
test_get_5ContextVoid
WorldSpaceToScreenSpaceVector4Vector4, Bool, BoolReturns the screen space position for specified world position
ExprToJSONStringString
SelectionManagingComponentContextVoidVoid
CompileExpressionArgumentPackStringReturns the list of symbols associated with the given cco.
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)
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
IsWaaaghActiveVoidVoid
IsSearchActiveBoolVoid
SelectButtonVoidVoid
TestArgPack_IntIntArgumentPack
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!
ScrollToComponentVoidVoid
CampaignModelRootCcoCampaignModelRootVoidReturn the root campaign model context in campaign
IsHumanPlayersTurnBoolVoidReturns whether it is any human players turn (local player or another human in mpc)
IsComponentCloseToCursorBoolExpressionState, IntReturns if the Component's centre is within the distance given in the args
ShouldShowMissionVoidVoid
test_get_6ContextVoid
CloseInfoPanelVoidStringCloses the specified info panel type.
ShowBuildingBrowserVoidCcoBuildingLevelRecord (optional)Opens the building browser and passes the context of the building level if any has been provided
GetValueVoidVoid
FreeFunctionIntInt
ValueMaxVoidVoid
IsPanelOpenBoolString (optional), Bool (optional)Returns true if specified panel is open, or if any are open if none specified
SelectFirstVisibleVoidVoid
RitualCastTimeLeftVoidVoid
CampaignBattleContextCcoCampaignBattleVoidReturns the CcoCampaignBattle singleton if we are in a pending battle
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.
test_get_3ContextVoid
DoesGUIDExistBoolString, ExpressionStateReturns true if a component with the given GUID exists.
IsExpandedVoidVoid
FilterContextListContextList, ExpressionState, ExpressionReturns a list with all the elements of the given list that satisfy the condition.
ClearSearchResultsVoidVoid
ToggleHUDPanelVoidStringToggles the specified HUD panel
PlayersFactionCcoCampaignFactionVoidReturn the players faction context
SelectDropdownItemVoidVoid
FactorBreakdownCcoFactorBreakdownContextList, String, StringReturns a CcoFactorBreakdown created with context_lists passed as arguments.
RetrieveSymbolsListContextListContextCompiles the given expression and returns it as a CcoContextExpression. If it fails to compile, it will return a list of CcoContextExpressionCompilationError instead.
DistanceToCameraFloatVector4Returns distance of specified position from camera
OpenCaravanRecruitmentPanelVoidCcoCampaignSettlementOpens the caravan recruitment panel
CampaignKeyStringVoidReturns the campaign key
CloseAllContextLayoutTooltipsVoidVoidCloses any open ContextLayoutTooltips anywhere in the UI
UiMsgVoidStringTriggers the specified UI_UPDATE_MSG event
TenIntVoid
IsInSearchResultsBoolExpressionState, CcoComponent
SetValueVoidVoid
test_get_4ContextVoid
GetColourColourStringReturns the colour of the given key from the ui_colours table
ContextCacheIdStringContextReturns the combination of ContextTypeId + ContextObjectId, which is used by script get_context_value to retrieve values so useful to be able to query.
CurrentSearchResultsCcoComponent (list)Void
ShortcutKeyUniStringStringReturns current key as string for the specified shortcut
ZoomToPointVoidVector4Zoom to the specified location
ToUpperCaseUniStringUniStringConvert string to an uppercase string
ShowEncyclopediaVoidStringOpens the encyclopedia.
MaxContextContextContextList, ExpressionState, ExpressionReturns the context with the largest evaluated value (for example if MaxContext(CeoList, RarityLevel) would return ceo context with largest rarity level)
IsLocalPlayersTurnBoolVoidReturns whether it is the local players turn
SelectAndShowDetailsForCharacterVoidCcoCampaignCharacter, Bool (optional), Bool (optional)Selects the passed in character and opens character details panel. Optional bool specifies whether to select the skill tab
StartAnimationVoidVoid
FrontendRootCcoFrontendRootVoidGets the frontend root context in frontend (handy starting point for all things frontend related)
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
StopVfxVoidVoid
SetVfxPositionVoidVoid
JoinStringUniStringContextList, ExpressionState, Expression, UniStringReturns a string with each of the elements combined into a string with the given separator between each element.
DeselectContextVoidVoid
BattleRootCcoBattleRootVoidGets the battle root context in battle (handy starting point for all things battle related)
CloseCurrentHUDPanelVoidVoidCloses the currently opened HUD panel
LookUpTechnologyCcoCampaignTechnologyCcoTechnologyRecordReturns a CcoCampaignTechnology given a provided CcoTechnologyRecord.
test_get_1ContextVoid
SearchForComponentWithPredicateVoidExpressionState, String
TrueRandomInRangeIntInt, IntReturns a true random number (different each game session) in the given range
IsPlayingVoidVoid
SetExpandedVoidVoid
ColourTextForCurrentSkinUniStringUniStringReplaces colour tags with dark colour versions if the current skin is not wh3.
test_get_2ContextVoid
LocalisedCommaWithSpaceUniString (list)VoidReturns a localised comma: fullwidth in Chinese or halfwidth + space in other languages.
IsCellUnlockedVoidVoid
ContextTypeIdStringContextReturns the type name of the supplied context object (the class name, such as CcoBattleUnit). Useful for script
MaxValueFloatContextList, ExpressionState, ExpressionReturns the largest evaluated value (for example if MaxValue(CeoList, RarityLevel) would return largest rarity level)
CampaignMinimapZoomScaleFloatVoidReturns the current zoom scale for the minimap
SelectContextVoidVoid
OpenUnitBrowserVoidCcoFactionRecordSpecific to WH3, opens unit browser, and if a CcoCultureRecord is specified selects that culture to view units for
SetVfxScaleVoidVoid
ColourProfileStringVoidReturns the current colour profile setting
RefreshValuesVoidString
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
CloseDiplomacyPanelVoidVoidCloses the diplomacy panel if it's currently open
InitialiseCameraVoidVoid
ResetRevealVoidVoidResets the text reveal, starts from beginning again
DiplomacyLocUniStringArgumentPackReturns a localised string in the diplomacy_strings table given key
LoadMetadataVoidVoid
CurrentInspectedContextContextVoid
RetrieveSelectedItemListContextListExpressionState, String, String (optional)Returns the list of selected items from the ContextSelectionManager provided.
LocalisedColonWithSpaceUniString (list)VoidReturns a localised colon: fullwidth in Chinese or halfwidth + space in other languages.
CanShowEventsBoolVoidReturns true if can currently show events
AbilityApplyIntensityFloatExpressionState, FloatReturns the value of an effect multiplied by the current intensity (calculated from CcoBattleAbility stored in parent)
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
FreeSecondContextVoid
MinContextContextContextList, ExpressionState, ExpressionReturns the context with the smallest evaluated value (for example if MinContext(CeoList, RarityLevel) would return ceo context with smallest rarity level)
OpenOverlayToUrlVoidExpressionState, String, BoolOpens given url in overlay if available, if not in external browser
SetVfxVelocityVoidVoid
CurrentSelectionVoidVoid
MainThemeBackgroundColourColourExpressionStateReturns the background theme colour, used in fullscreen panels, of the main theme skin
DoubleIntInt
SettlementAtPointCcoCampaignSettlementVector4Returns the settlement context at the specified position
test_get_0ContextVoid
LogicalToDisplayPosVector4Vector4, Bool (optional)Converts a logical position to a display position for campaign
PanelContextCcoComponentStringReturns the CcoComponent context of the specified panel if it's open
OpenAcademyVoidExpressionStateOpens up the TW academy in the browser supplying the component clicked on so can open a relevant page
ApplyUiSkinVoidStringApplies the supplied ui skin to the game
ScrollToComponentVoidCcoComponent
EltharionChallengeRecipeNumberVoidVoid
SumArgumentPackContextList, ExpressionState, ExpressionReturns the numerical sum of the transformed elements.
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)
PlayVfxVoidVoid
ExpectedSymbolStringString, String
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
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
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.
SelectContextVoidVoid
CurrentSelectedComponentsVoidVoid
ComponentCcoComponentString, String (optional), ExpressionState
SetVfxOrientationVoidVoid
NameOfCampaignLocationUniStringVector4Gets the region or sea region name at specified location
PlayFullscreenMovieVoidStringPlays a fullscreen movie with supplied path, once movie finishes the movie player trashes itself

sound

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

math

NameReturn TypeArgumentsDescriptionTagsEvents
FloorIntFloatFloors a float and returns it as an intmath
RoundFloatIntFloatRounds a float to nearest intmath
ModIntInt, IntModulus operation. Takes the number and the value to mod bymath
TruncIntFloatLooses the fractional part of the numbermath
MidPointVector4Vector4, Vector4Returns vector3 middle point between two vector3 points (takes vector4s but ignores the wmath
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
IntMaxIntVoidReturns maximum integer valuemath
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
PercentageFloatFloat, FloatReturns percentage of first value number against second value which is total (with guard against divide by zeromath
FloatToPercentFloatFloatReturns value *100...math, deprecated
ClampFloatFloat, Float, FloatClamps a float between two valuesmath
AbsFloatFloatReturns the absolute of the value passed inmath
CeilingIntFloatCeilings a float and returns it as an intmath

registry

NameReturn TypeArgumentsDescriptionTagsEvents
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
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
SharedStateValueExistsBoolStringTakes a String id, and returns if there's any state stored with that id (bool SharedStateReadBool(String key)).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
ScriptedValueRegistryReadBoolBoolStringTakes a String id, and returns the stored Bool value in the registry for that key (Bool RegistryReadInt(String key))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
RegistryWriteStringVoidString, StringTakes a String id, and writes supplied String value to registry with that key (void RegistryWriteInt(String key, String value))registry
SharedStateWriteBoolVoidString, BoolTakes a String id, and writes supplied bool value to shared state with that key (void SharedStateWriteBool(String key, bool value))registry
SharedStateWriteFloatVoidString, FloatTakes a String id, and writes supplied float value to shared state with that key (void SharedStateWriteFloat(String key, float value))registry
RegistryWriteIntVoidString, IntTakes a String id, and writes supplied integer value to registry with that key (void RegistryWriteInt(String key, int value))registry

flow

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

convert

NameReturn TypeArgumentsDescriptionTagsEvents
MakePieCcoPieDataExpressionState, ContextList, Expression, Expression, ExpressionCreates a CcoPieData from functionconvert
CreateSelectionListCcoContextSelectionContextListCreates a CcoContextSelection from a CONTEXT_LISTconvert
MakePairCcoPairExpressionState, Expression, ExpressionCreates a CcoPair from the two parameters passed inconvert
ToNumberFloatStringConvert a string to a floating point numberconvert
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
ToVectorVector4ArgumentPackConvert set of numbers to a vector (up to 4)convert

component

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentDisabledMouseOverComponentContextCcoComponentVoidReturns current disabled component mouse overcomponent
RootComponentCcoComponentVoidReturns context of the root componentcomponent
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
CurrentMouseOverComponentContextCcoComponentVoidReturns current component mouseovercomponent

tweakers

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

Front End

CcoCampaignStartInfo

Wrapper for frontend campaign start info

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OwnedCultureListCcoCultureRecord (list)VoidReturns a list of CcoCultureRecord for this campaign that the player owns
LordListForFactionCcoFrontendFactionLeader (list)CcoCultureRecordReturns a list of CcoFrontendFactionLeaders for a passed in culture
FactionListCcoFactionRecord (list)VoidReturns a list of CcoFactionRecords with the factions in this campaign
CultureListCcoCultureRecord (list)VoidReturns a list of CcoCultureRecords with the cultures from this campaign
VictoryDescriptionTextUniStringVoidReturns the localised victory description of the campaign which describes how to obtain victory
StartDateIntVoidReturns an int with the start date of the campaign
NameUniStringVoidReturns the localised name of the campaign
DescriptionTextUniStringVoidReturns the localised description of the campaign
CharacterListCcoFrontendFactionLeaderRecord (list)VoidReturns a list of CcoFrontendFactionLeaderRecord with faction leaders that are part of this campaign
CampaignMapPlayableAreaRecordContextCcoCampaignMapPlayableAreaRecordVoidReturns a CcoCampaignMapPlayableAreaRecord with the playable area record for this 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
KeyStringVoidReturns a string with the campaign key
LordForFactionCcoFrontendFactionLeaderCcoFactionRecord, IntReturns a CcoFrontendFactionLeader for the specified CcoFactionRecord if one exists
IsResumedBoolVoidReturns true if the campaign is resumed
OwnedLordListForFactionCcoFrontendFactionLeader (list)CcoCultureRecordReturns a list of CcoFrontendFactionLeaders for a passed in culture that the player owns
MechanicListForCultureCcoEffect (list)CcoCultureRecordReturns a list of effects that describe the unique traits of the passed in culture

CcoCustomBattleLobby

Wrapper for the custom battle lobby

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ArmyPresetFileHandlerContextCcoCustomBattleArmyPresetFileHandlerVoidReturns the CcoCustomBattleArmyPresetFileHandler context which handles loading/saving army presets
IsActiveBoolVoidReturns true if lobby is currently active/in use
CanAutoResolveBoolVoidReturns true if can use autoresolve simulationdebug, hide_in_uied
IsLocalPlayerReadyBoolVoidReturns true if the local player is ready to play
HostSlotContextCcoCustomBattlePlayerSlotVoidReturns the host players CcoCustomBattlePlayerSlot
AutoresolveBattleResultsContextCcoBattleResultVoidReturns the CcoBattleResult for an autoresolve simulation of units armies currently in the lobbydebug, hide_in_uied
IsLocalPlayerFactionLockedBoolVoidReturns true if the player can no longer change their faction
IsLocalPlayerHostBoolVoidReturns true if the local player is currently the host
SettingsContextCcoCustomBattleSettingsVoidReturns the CcoCustomBattleSettings context that handles settings for lobby
IsLocalPlayerSpectatingBoolVoidReturns true if the local player is currently spectating
LocalPlayerSlotContextCcoCustomBattlePlayerSlotVoidReturns the local players CcoCustomBattlePlayerSlot
SpectatorSlotListCcoCustomBattlePlayerSlot (list)VoidReturns list of CcoCustomBattlePlayerSlot that are currently spectators
IsMatchmadeBattleBoolVoidReturns true if this lobby is for a matchmade quick battle
IsSinglePlayerBoolVoidReturns true if this is a single player lobby (custom battle)
AddSpectatorSlotVoidVoidAdds a new spectator slot to 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
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
ToggleReadyVoidVoidToggles ready status of player
NumberOfPlayerSlotsIntVoidReturns the number of player slots in the lobby
ToggleFactionLockReadyVoidVoidToggles ready-for-faction-lock status of player
NumberOfPlayersIntVoidReturns the number of active players in the lobby
ReadyButtonTextUniStringVoidReturns ready button text
IsUsingSmallCardsBoolVoidReturns true if should use small card format (based on resolution)
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)
DefaultSelectedPlayerSlotContextCcoCustomBattlePlayerSlotVoidReturns the default CcoCustomBattlePlayerSlot to select when entering lobby (default army shown)
IsReadyCountdownActiveBoolVoidReturns true if the ready countdown is active (active once all players readied up)
CanAddSpectatorSlotBoolVoidReturns true if can currently add a spectator slot
ReadyStatusTextUniStringVoidReturns the text used on tooltip for ready button (to show ready errors)
ReadyButtonStateStringExpressionStateReturns the current state to set on the ready button for local player
CanInviteBoolVoidReturns true if can currently invite a player to the lobby

CcoCustomBattleMap

Wrapper for a custom map

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ClickgenRegionNameUniStringVoidReturns the clickgen region name
ClickgenProvinceNameUniStringVoidReturns the clickgen province name
ClickgenClimateContextCcoClimateRecordVoidReturns the climate context for the map
BattleTypeStringStringVoidReturns the battle type for the map
NameUniStringVoidReturns the name of the map
CampaignBattlePresetRecordContextCcoCampaignBattlePresetRecordVoidReturns the campaign battle preset context for the map
CampaignMapRecordContextCcoCampaignMapPlayableAreaRecordVoidReturns the campaign map record context for the map
BattleRecordContextCcoBattleRecordVoidReturns the battle context for 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
ToggleFavouriteVoidVoidToggles this map as a favourite
TogglePinnedVoidVoidToggled this map as pinned in custom battle UI
IsFavouriteBoolVoidReturns whether the map is favourited
IsPinnedBoolVoidReturns whether the map is pinned in custom battle UI
ClickgenCoordsRawVector4VoidReturns the raw clickgen co-ordinates
IsPresetBoolVoidReturns whether the map is a preset
ClickgenGroundTypeNameUniStringVoidReturns the clickgen ground type
ClickgenCoordsVector4VoidReturns the clickgen co-ordinates

CcoCustomBattlePlayerSlot

Functions

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

CcoCustomBattleSettings

Wrapper for the settings of custom battles

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ToggleRealismModeVoidExpressionStateToggles realism mode
CorruptionTypeRecordListCcoCustomBattleCorruptionType (list)VoidReturns a list of available CcoCorruptionTypeRecord
SetWeatherTypeRecordContextVoidExpressionState, CcoBattleWeatherTypeRecordSets the given context as the weather type
TimeLimitSettingContextCcoCustomBattleSettingRecordVoidReturns a context to the setting record for time limit
SeasonRecordContextCcoSeasonRecordVoidReturns a context to the season record
CanAddAiBoolVoidReturns true if current battle type supports adding of AI
EscalationLevelSettingListCcoCustomBattleSettingRecord (list)VoidReturns a list of available escalation level settings
SetCorruptionTypeRecordContextVoidExpressionState, CcoCustomBattleCorruptionTypeSets corruption type for map supplying a CcoCorruptionTypeRecord, if pass empty then removes any corruption type (has visual impact on battlefield)
IsUsingLargeArmiesBoolVoidReturns whether large armies are being used
WeatherTypeRecordContextCcoBattleWeatherTypeRecordVoidReturns a context to the weather type record
ToggleAttackingTeamVoidExpressionStateSwitches the attacking team
SetSettlementLevelSettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the given context as the settlement level setting
ForceSettingResyncVoidVoidForces settings to be resynced
CampaignBattleTypeStringStringVoidReturns a string representation of the battle type
CorruptionTypeRecordContextCcoCustomBattleCorruptionTypeVoidReturns the CcoCorruptionTypeRecord being used for the corruption setting, null if none (has visual impact on battlefield)
IsRealismModeBoolVoidReturns whether realism mode is being used
EscalationLevelSettingContextCcoCustomBattleSettingRecordVoidReturns a context to the escalation level setting
TimeLimitSecondsIntVoidReturns the time limit of the battle in seconds
WeatherTypeRecordListCcoBattleWeatherTypeRecord (list)VoidReturns a list of available records for weather types
IsFreeForAllBoolVoidReturns whether this is a free for all battle
LaboratoryInfoContextCcoBattleLaboratoryInfoVoidReturns the context of the laboratory info
IsUsingReinforcingUnitsBoolVoidReturns whether reinforcing units are used
SettlementLevelSettingListCcoCustomBattleSettingRecord (list)VoidReturns a list of available settlement level settings
CanToggleAttackingTeamBoolVoidReturns whether the attacking team can be toggled (switched), some battle types do not allow toggling
SetTimeOfDaySettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the given context as the time of day 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
CanChangeSettingsBoolVoidReturns whether custom battle settings can be changed
ToggleStormOfMagicVoidExpressionStateToggles storm of magic setting (storm of magic is for warhammer, where magic is greatly empowered and the lore boosted changes every so often)
CostForSettlementLevelIntCcoCustomBattleSettingRecordReturns the cost for the given settlement level context
IsLabModeBoolVoidReturns if lab mode has been chosen for this battle
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)
HasTwoAlliancesBoolVoidReturns whether this battle has attackers and defenders
IsSettlementBattleTypeBoolVoidReturns whether this is a settlement battle type
TimeOfDaySettingContextCcoCustomBattleSettingRecordVoidReturns a context to the time of day setting
ToggleLabModeVoidExpressionStateToggles the lab mode on/off
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
SetFundTypeSettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the given context as the fund type setting
MaxUnitsCanReinforceIntIntReturns the maximum number of units that can reinforce
BattleTypeRecordListCcoBattleTypeRecord (list)VoidReturns a list of available battle types for custom battle
ChooseRandomMapVoidExpressionStateChooses a random map and sets it as the current map
SetCustomFundsAmountVoidExpressionState, UniStringSets the given amount as the custom funds limit
AttackingTeamIndexIntVoidReturns the index of the attacking team
SettlementMapListCcoCustomBattleMap (list)VoidReturns a list of custom battle maps that have settlements
ToggleLoadingCharactersVoidExpressionStateToggles unit caps
IsSiegeBattleTypeBoolVoidReturns whether this is a siege battle type
ToggleUnitCapsVoidExpressionStateToggles unit caps
MaxUnitsCanRecruitIntIntReturns the maximum number of units that can currently be recruited
DifficultyLevelSettingListCcoCustomBattleSettingRecord (list)VoidReturns a list of available difficulty levels
HistoryMapListCcoCustomBattleMap (list)VoidReturns list of custom battle map history
CustomBudgetAmountIntVoidReturns the amount of the custom budget if being used
BattleTypeRecordContextCcoBattleTypeRecordVoidReturns a context to the battle type
FavouriteMapListCcoCustomBattleMap (list)VoidReturns a list of favourited custom battle maps
SetDifficultyLevelSettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the given context as the difficulty level
IsLoadingCharactersEnabledBoolVoidReturns whether unit set caps are enforced
SetSeasonRecordContextVoidExpressionState, CcoSeasonRecordSets the given context as the season
ToggleIsUsingLargeArmiesVoidExpressionStateToggles large armies setting
SetMapContextVoidExpressionState, CcoCustomBattleMapSets the given custom map context as the current map
FundTypeSettingListCcoCustomBattleSettingRecord (list)VoidReturns a list of available setting records for funds
UnitScaleSettingListCcoCustomBattleSettingRecord (list)VoidReturns a list of available unit scale settings
IsTimeLimitUsedBoolVoidReturns whether a time limit is used
DifficultyLevelSettingContextCcoCustomBattleSettingRecordVoidReturns a context to the difficulty level
IsUsingUnitCapsBoolVoidReturns whether unit set caps are enforced
IsUsingCustomFundsBoolVoidReturns whether custom funds amount is being used
SetMapCoordinateVoidExpressionState, String, StringSets the co-ord at index give ('x' or 'y'), to the value given
SetTimeLimitSettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the given time limit setting context
SetUnitScaleSettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the given context as the unit scale setting
SetBattleTypeRecordContextVoidExpressionState, CcoBattleTypeRecordSets the given context as the battle type
SetEscalationLevelSettingContextVoidExpressionState, CcoCustomBattleSettingRecordSets the given context as the escalation level setting
SeasonRecordListCcoSeasonRecord (list)VoidReturns a list of available season records
MapContextCcoCustomBattleMapVoidReturns a context to the current map
TimeLimitSettingListCcoCustomBattleSettingRecord (list)VoidReturns a context list of time limit settings
UnitScaleSettingContextCcoCustomBattleSettingRecordVoidReturns a context to the unit scale setting
FundTypeSettingContextCcoCustomBattleSettingRecordVoidReturns a context to the fund type setting
IsTimeoutDrawBoolVoidReturns whether timeouts result in a draw
CanUseLargeArmiesBoolVoidReturns whether large armies can be used
MapPresetListCcoCustomBattleMap (list)VoidReturns a list of currently available custom battle maps
SettlementLevelSettingContextCcoCustomBattleSettingRecordVoidReturns a context to the settlement level setting

CcoCustomBattleTeam

Wrapper for the custom battle team

Functions

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

CcoLobbyBase

Functions

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

CcoMPCampaignLobby

Functions

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

CcoMPCampaignMap

Wrapper for a playable map in multiplayer campaigns

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CampaignMapRecordContextCcoCampaignMapPlayableAreaRecordVoidReturns the CcoCampaignMapPlayableAreaRecord for this map
MaxPlayersIntVoidReturns the max number of players that can play in this campaign
ImagePathStringVoidReturns the image path to be used on selectable entries
MapImagePathStringVoidReturns the map image path to be used on map displays
NameUniStringVoidReturns the localised name for the map
DescriptionUniStringVoidReturns the localised description for the map
TimeOfLegendCampaignRecordContextCcoTimeOfLegendsCampaignRecordVoidReturns the CcoTimeOfLegendsCampaignRecord for this map (can be empty)
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

CcoMPCampaignSettings

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ToggleAllianceOnlyVoidVoid
IsAllianceOnlyVoidVoid
SetOptionForSettingVoidVoid
ToggleOptionForSettingVoidVoid
CanChangeSettingVoidVoid
ShouldShowAllianceOnlySettingVoidVoid
GetCurrentOptionForSettingVoidVoid
GetOptionsForSettingVoidVoid

Misc

CcoAbilityCollection

Wrapper for an AbilityCollection for nested abilities

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AttributesCcoStringValue (list)VoidReturns the attributes associated with this collection
ShouldHideAbilityDescriptionBoolCcoUnitAbilityHides a component based on record is_hidden entry
IconPathStringVoidReturns the collection's icon file path
UnitAbilitiesCcoUnitAbility (list)VoidReturns the unit abilities associated with this collection

CcoAdvisor

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AdviceHistoryListVoidVoid
ClearHistoryVoidVoid

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
CanCurrentlyPerformBoolVoidReturns true if abiltiy can currently be activated
PerformAbilityForOwnerVoidVoidActivates the ability for the owner (unit/army)
SetupAbilityContextCcoUnitAbilityVoidReturns the CcoUnitAbility setup for this ability (fixed information that doesnt change during the battle)
ActivePhaseListCcoPair (list)VoidReturns list of CcoPair; the active phases for each target essentially
IsPhaseActiveBoolCcoSpecialAbilityPhaseRecordReturns true if supplied CcoSpecialAbilityPhaseRecord is active in any of abilities phase trees
HasLimitedUsesBoolVoidReturns true if the ability has a limited number of uses (queried by RemainingUses)
IsRechargeEnabledBoolVoidReturns true if all recharge contexts for this ability are true (eg engaged in melee)
IsActiveBoolVoidReturns true if this abiltiy is currently active and applying its effects
IsTargettedAbilityBoolVoidReturns true if this is an ability that you have to select a target for
IsCurrentlyTargettingBoolVoidReturns true if this ability is currently being targetted by the player
IntensityFloatVoidReturns the intensity that modifiable stats of this ability will be multiplied by
IsReignOfChaosRewardBoolVoidReturns true if this is an amry ability that can be rewarded as a reign of chaos outcome
EffectRangeFloatVoidReturns the range in metres that this ability will affect from the cast point
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.
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
CurrentStateStringVoidReturns a String representing the current state (active/passive/selected/inactive
RechargePercentFloatVoidReturns the cooldown percentage if in cooldown (0-1), 0 if not in cooldown
LeftClickTextUniStringVoidReturns some localised text that explains what left clicking on a button for this ability would currently do (activate, toggle targetting, toggle overcharge, etc)
WindUpTimeRemainingSecsFloatVoidReturns the wind up time remaining in seconds. Wind up is the casting time essentially.
RechargeDisabledReasonsTextUniStringVoidReturns joined localised string of disabled reasons for this ability, if any (in melee, etc)
ActivePercentFloatVoidReturns the percent (0-1) the ability is through its active duration (progression until ability finishes), 0 if ability is not currently active
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.
RechargeTimeRemainingSecsFloatVoidReturns the cooldown time remaining seconds if ability is in cooldown
ManaUsedIntVoidReturns how much mana is used when activating this ability
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)
ActiveTimeRemainingSecsFloatVoid

CcoBattleCaptureLocationsManager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
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

CcoBattleCurrencyManager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SummaryListForCurrencySourcesCcoSummedValueContextString, IntTakes db key and army unique id and returns CcoSummedValueContext populated with CcoPair compposed of curency source record cco and amount value
CurrencyItemTypeStringToEnumIntStringTakes db key of the currency item type and returns int32 of the currency type enum
PurchaseArmyAbilityVoidString, Int, ContextTakes db key of ability, int32 for the currency item type enum and CcoBattleArmy and purchases the ability
PurchaseItemVoidString, Int, ContextTakes db key of the item, int32 for the currency item type enum and CcoBattleArmy and purchases the item
CurrencyTypeStringToEnumIntStringTakes db key of the currency type and returns int32 of the currency type enum
GetCostForItemFloatString, Int, ContextTakes db key of the item, int32 for the currency item type enum and CcoBattleArmy and returns the cost for that 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
GetArmyCurrencyForTypeFloatCcoBattleArmy, StringTakes db key of the currency and returns the amount of that currency for the players army

CcoBattleEntity

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

Functions

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

CcoBattleGroup

Functions

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

CcoBattleLaboratoryInfo

Wrapper for the lab settings of a battle.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SingleEntityScaleMultiplierFloatVoidReturns the single entity scale multiplier value
SetAbilityEffectRadiusMultiplierVoidFloatSets the ability effect radius multiplier value to the one passed in
BloodMultiplierFloatVoidReturns the blood multiplier value
AbilityEffectRadiusMultiplierFloatVoidReturns the ability effect radius multiplier value
SetProjectilePenetrationMultiplierVoidFloatSets the projectile penetration multiplier value to the one passed in
AbilityCooldownMultiplierFloatVoidReturns the ability cooldown multiplier value
ChargeBonusMultiplierFloatVoidReturns the charge bonus multiplier value
SetGravityMultiplierVoidFloatSets the gravity multiplier value to the one passed in
ProjectilePenetrationMultiplierFloatVoidReturns the projectile penetration multiplier value
SetReloadTimeMultiplierVoidFloatSets the reload time multiplier value to the one passed in
GravityMultiplierFloatVoidReturns the gravity multiplier value
SetAmmunitionMultiplierVoidFloatSets the ammunition multiplier value to the one passed in
SetExplosionRadiusMultiplierVoidFloatSets the explosion radius multiplier value to the one passed in
AmmunitionMultiplierFloatVoidReturns the ammunition multiplier value
SetFatigueMultiplierVoidFloatSets the fatigue multiplier value to the one passed in
SetMoraleMultiplierVoidFloatSets the morale multiplier value to the one passed in
ExplosionRadiusMultiplierFloatVoidReturns the explosion radius multiplier value
FatigueMultiplierFloatVoidReturns the fatigue multiplier value
SetWindsOfMagicMultiplierVoidFloatSets the winds of magic multiplier value to the one passed in
ReloadTimeMultiplierFloatVoidReturns the reload time multiplier value
SetDamageMultiplierVoidFloatSets the damage multiplier value to the one passed in
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
ToggleWindsOfMagicLimitlessVoidVoidToggles the winds of magic limitless setting
IsWindsOfMagicLimitlessBoolVoidReturns true of winds of magic is set to limitless
SetSingleEntityScaleMultiplierVoidFloatSets the single entity scale multiplier value to the one passed in
SetValueForLabSettingVoidCcoLabSettingRecord, FloatSets the value for the passed in lab setting to the one passed in
ImpactForceMultiplierFloatVoidReturns the impact force multiplier value
SetBloodMultiplierVoidFloatSets the blood multiplier value to the one passed in
MoraleMultiplierFloatVoidReturns the morale multiplier value
ValueForLabSettingFloatCcoLabSettingRecordReturns the value for the passed in lab setting
SetAbilityCooldownMultiplierVoidFloatSets the ability cooldown multiplier value to the one passed in
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
CanAffordBoolCcoBattleArmyReturns if can afford to purchase the item
SoundTypeStringVoidReturns the sound type used for this purchase group
GetCostForThisActionFloatCcoBattleArmyReturns the cost of this action
IsAvailableInGroupBoolCcoBattleArmyReturns true if the item is available
ArmySpecialAbilityRecordContextCcoArmySpecialAbilityRecordVoidReturns the army ability record context

CcoBattlePurchasableUnit

Functions

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

CcoBattlePurchasableUnitAbility

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitAbilityContextCcoUnitAbilityVoid
SoundTypeStringVoid
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
GetCostForSelectionFloatContextList, Int(UnitList, ArmyID) Get the cost to apply this upgrade to all of the listed units for the specific army id
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
IsAvailableInGroupBoolContextList(UnitList) Is the ability available to any of the units in the list
GetCostForThisActionFloatInt
FilterSelectionToApplicableCcoBattleUnit (list)ContextList(UnitList) Filter a unit list to only those who will be affected by this ability
UnitSpecialAbilityRecordContextCcoUnitSpecialAbilityRecordVoid

CcoBattleReinforcementDebugUnits

Functions

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

CcoBattleReinforcementPool

Functions

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

CcoBattleResultAlliance

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ResultNameVoidVoid
ResultTypeVoidVoid
ArmyContextVoidVoid
ArmyListVoidVoid

CcoBattleResultArmy

Functions

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

CcoBattleSettlement

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DestructionEffectsListVoidVoid
DestroyedPercentVoidVoid
MountedArtilleryLocationListVoidVoid

CcoBattleSetup

Wrapper for a battle setup

Functions

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

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

CcoBattleSetupFaction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FlagDirVoidVoid
FactionRecordContextVoidVoid
NameVoidVoid

CcoBattleSetupInfo

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

Functions

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

CcoBattleSetupUnit

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CombatPotentialVoidVoid
NameVoidVoid
IsCommanderVoidVoid
UnitRecordContextVoidVoid
UnitDetailsContextVoidVoid
ImagePathVoidVoid

CcoBattleStormOfMagic

Cco wrapper for querying and controlling the Storm Of Magic manager

Functions

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

CcoBattleSurvivalWave

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

Functions

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

CcoBattleTimeControl

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

Functions

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

CcoBattleToggleableSlotBuildable

Functions

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

CcoBattleUnitEffect

Wrapper for a battle unit effect

Functions

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

CcoBattleVehicle

Functions

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

CcoBattleWindsOfMagicPool

Functions

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

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

CcoCampaignAreaOfInterest

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectBundleListVoidVoid
EffectListVoidVoid
IsMouseOverVoidVoid
PositionVoidVoid
ZoomToClosestVoidVoid
DescriptionVoidVoid
IconPathVoidVoid
KeyVoidVoid
TitleVoidVoid

CcoCampaignArmoryItemVariant

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

Functions

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

CcoCampaignArmyPlague

Functions

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

CcoCampaignBasePlague

Wrapper for a base plague

Functions

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

CcoCampaignBuilding

Functions

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

CcoCampaignBuildingLifecycleState

Functions

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

CcoCampaignBuildingSlot

Functions

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

CcoCampaignBuildingVariant

Functions

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

CcoCampaignCaravan

Wrapper for a campaign caravan

Functions

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

CcoCampaignCaravanRecruitmentItem

Wrapper for a campaign FACTION_CARAVANS struct

Functions

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

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
RangeStateVoidVoid
LoyaltyVoidVoid
IsLoyaltyApplicableVoidVoid
OnScreenLoyaltyVoidVoid

CcoCampaignCharacterTeleportationInteraction

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
InvalidReasonsForTargetUniStringContextReturns the reason why a target cannot be selected
IsTargettingActiveBoolVoidReturns true if the targetting for this interface is active
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
ToggleTargettingVoidVoidToggles the targetting from active/inactive
EnableTargettingVoidBoolEnables or disables the targetting depending on the bool passed in
IsValidTargetBoolContextReturns true if the passed in target is valid
ClearTargetVoidVoidClears the current target

CcoCampaignCharacterTeleportationSystem

Wrapper for character teleportation logic

Functions

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

CcoCampaignCharacterTrainingGroup

Wrapper for a campaign training group

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
SelectDilemmaChoiceVoidInt, IntSelects dilemma choice for specified slot index and dilemma choice index
TreasuryCostIntVoidReturns the cost of training a character
LocalisedNameUniStringVoidReturns the localised name of the group
StartCharacterTrainingVoidVoidStarts character training in next available slot
InitialPortraitPathStringVoidReturns a string with the initial portrait path
CanStartCharacterTrainingBoolVoidReturns true if character training can be started
MaximumSlotCountIntVoidReturns an int with the maximum slots in the group

CcoCampaignCharacterTrainingSlot

Wrapper for a campaign training slot

Functions

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

CcoCampaignConstructionItem

Functions

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

CcoCampaignCorruptionCounter

Wrapper for a corruption counter

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AmountIntVoidReturns the total amount of corruption from all the corruption types in this counter
MaxIntVoidReturns the max corruption for 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
CurrentCursorKeyStringVoidReturns the current cursor_record key of the cursor being used
SettlementContextCcoCampaignSettlementVoidReturns the settlement currently mousing over
FactionContextCcoCampaignFactionVoidReturns the faction currently mousing over
CharacterContextCcoCampaignCharacterVoidReturns the character currently mousing over
LogicalPositionStringVoidReturns logical position on map currently mousing over as a stringdebug

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
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)
NegotiationForFactionCcoCampaignNegotiationCcoCampaignFactionReturns a CcoCampaignNegotiaton for the given proposing faction if there is one
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
PerformManipulationVoidCcoCampaignFaction, CcoCampaignFaction (optional), Context (optional)Performs the manipulation on targets passed in
RemainingCooldownIntVoidReturns the remaining cooldown of the manipulation info
ResourceTransactionContextCcoCampaignResourceTransactionCcoCampaignFaction, CcoCampaignFaction (optional), Context (optional)Returns the cost for performing the manipulation, taking into account the specified source and objective
DescriptionUniStringVoidReturns the description of the manipulation info
CooldownTimeIntVoidReturns the the total cooldown time of the manipulation info
IconStringVoidReturns the icon path of the manipulation info
DisplayNameUniStringVoidReturns the localised name of the manipulation info
CategoryStringVoidReturns the category of the manipulation info
DiplomacyManipulationInteractionContextCcoCampaignDiplomacyManipulationInteractionVoidReturns the context of the diplomacy interaction of this info
OwnerFactionContextCcoCampaignFactionVoidReturns the context of the faction that owns this diplomacy manipulation info

CcoCampaignDiplomacyManipulationInteraction

Class that manages targetting interface interaction for a manipulation info

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PerformActionVoidVoidPerforms the manipulation with the current source, objective and settlement target, if it can
SetTargetVoidContextSets the settlement target or the source/objective faction. Which faction will be set is determined by the m_setting_source flag
IsActionLockedBoolVoidReturns true if the manipulation hasn't been unlocked yet
SetSourceFactionVoidCcoCampaignFactionSets the source faction for this manipulation
IsActionBlockedByPendingBattleBoolVoidReturns true if the manipulation is blocked by active pending battle
UpdateTargetFactionVoidVoidUpdates the faction with the current targetting interface faction. This is so all targetting interfaces are in sync
ToggleTargettingVoidVoidToggles the targetting system through the CampaignTargettingInterface.
ClearTargetVoidVoidClears the settlement target is this exists
SetupInitialTargetFactionVoidCcoCampaignFactionDoes the initial setup of the factions without notifying.
AverageAttitideFloatVoidReturns the average relations between source and objective factions
ZoomToTargetVoidVoidZooms to the current settlement target, if this exists.
ShouldDisplayFactionDropdownBoolBool (optional)Returns true if we should display the faction dropdown in the changing of the way panel
EnableTargettingVoidBoolIs passed true, enables this as the targetting interface, else disables it.
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
UsesObjectiveFactionBoolVoidReturns true if objective/second faction is needed for the manuipulation type
IsTargettingActiveBoolVoidReturns true if this is the current targetting interface
AverageCorruptionFloatVoidReturns the average corruption between the source and objective factions
IsValidTargetBoolContextReturns true if the passed in object is valid. Can also be used for checking source/objective factions
ObjectiveFactionContextCcoCampaignFactionVoidReturns the context of the objective faction stored, if any
ValidObjectiveFactionListCcoCampaignFaction (list)VoidReturns a list with valid objective factions based on the selected source faction
DiplomacyManipulationInfoContextCcoCampaignDiplomacyManipulationInfoVoidReturns the context of the diplomacy manipulation info associated with this class
ValidSourceFactionListCcoCampaignFaction (list)VoidReturns a list of source factions that have at least 1 valid objective faction to target
ActionCostCcoCampaignResourceTransactionVoidReturns the cost for the manipulation with the current setup
SourceFactionContextCcoCampaignFactionVoidReturns the context of the source faction stored, if any
ActionPerformTooltipUniStringVoidReturns a tooltip with reason why cannot perform the manipulation with current setup, or returns specific text if can perform
SetIsSourceFactionFlagVoidBoolSets the m_setting_source flag. If this flag is set to true, will use the source faction in some functions, otherwise will use the objective faction(mostly so we can alternate setting the factions on the map)
CanPerformActionBoolVoidReturns true if the manipulation can be performed with the current source faction, objective faction and settlement (if the settlement is needed)
CurrentTargetContextContextVoidThis will only return if the manipulation type is TRANSFER_SETTLEMENT and we have a settlement target stored. Else returns nul
SetObjectiveFactionVoidCcoCampaignFactionSets the objective faction for this manipulation

CcoCampaignEffectGroup

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectListVoidVoid
LocalisedTitleVoidVoid

CcoCampaignElectorSeat

Functions

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

CcoCampaignEventAgentTargetsCharacter

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AgentContextVoidVoid
TargetContextVoidVoid
IsReferingToPlayerVoidVoid
ActionResultContextVoidVoid
DiplomaticStateContextVoidVoid
AgentFactionContextVoidVoid
TargetFactionContextVoidVoid

CcoCampaignEventAgentTargetsSettlement

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DiplomaticStateContextVoidVoid
IsReferingToPlayerVoidVoid
TargetFactionContextVoidVoid
ActionResultContextVoidVoid
TargetContextVoidVoid
AgentFactionContextVoidVoid
AgentContextVoidVoid

CcoCampaignEventAncillaryOrTrait

Functions

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

CcoCampaignEventArmoryItem

Context wrapper for a campaign ARMORY_ITEM custom layout event

Functions

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

CcoCampaignEventBattleResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DefendingBattleResultVoidVoid
PlayersBattleResultVoidVoid
DefendingFactionContextVoidVoid
AttackingBattleResultVoidVoid
DefendingCharacterContextVoidVoid
AttackingFactionContextVoidVoid
AttackingCharacterContextVoidVoid

CcoCampaignEventBuildingConstructed

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BuildingVoidVoid

CcoCampaignEventDilemma

Component context wrapper for an event dilemma

Functions

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

CcoCampaignEventDiplomacy

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ZoomToVoidVoid
EventTypeVoidVoid
HasZoomLocationVoidVoid
IsTreatyBrokenVoidVoid
EventIconPathVoidVoid
FirstFactionVoidVoid
SecondFactionVoidVoid

CcoCampaignEventFaction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasZoomLocationVoidVoid
FirstFactionContextVoidVoid
SecondFactionContextVoidVoid
DiplomaticStateContextVoidVoid

CcoCampaignEventFeedCustomMission

Component context wrapper for an event mission

Functions

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

CcoCampaignEventFeedFilter

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ToggleCategoryVoidVoid
InclusionStateVoidVoid
IsCategoryIncludedVoidVoid

CcoCampaignEventFeedGroup

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TitleVoidVoid
EventListVoidVoid
ShouldAutoExpandVoidVoid

CcoCampaignEventFeedMessageDetails

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SecondaryDetailUniStringVoid
RequiresResponseBoolVoid
ImagePathStringVoid
MoviePathStringVoid
EventSoundStringVoid
TitleUniStringVoid
PrimaryDetailsWithTagsUniStringVoid
LayoutStringVoid
SecondaryDetailsWithTagsUniStringVoid
MarkAsReadVoidVoid
ZoomToVoidExpressionState
IsReadBoolVoid
EventTypeStringVoid
IconPathStringVoid
HasZoomLocationBoolExpressionState
PositionVector4Void
HasSepiaFadeBoolVoidReturns true if the incident has a sepia fade multiplier
CustomContextContextVoid
MissionContextCcoCampaignEventFeedCustomMissionVoid
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
FlavourTextUniStringVoid
SepiaFadeMultiplierFloatVoidReturns the sepia fade multiplier, used for story panels to fade out a few seconds of at the end of the movie
FullFlavourTextUniStringVoid
ShouldRepositionBoolVoid
PrimaryDetailUniStringVoid
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

CcoCampaignEventFeedOpenEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconContextContextVoid
ShouldRepositionBoolVoid
EventContextCcoCampaignEventFeedMessageDetailsVoid

CcoCampaignEventFeedRecords

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RoundsListVoidVoid
StartYearVoidVoid
EndYearVoidVoid
YearListVoidVoid
YearContextVoidVoid

CcoCampaignEventFeedRound

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SummaryListVoidVoid
RoundTitleVoidVoid
IsEmptyVoidVoid

CcoCampaignEventFeedSummary

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MarkAsReadVoidVoid
TotalEventsVoidVoid
IsReadVoidVoid
FirstEventContextVoidVoid
EventListVoidVoid
TitleVoidVoid
IconPathVoidVoid

CcoCampaignEventFeedYear

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProvinceListVoidVoid
CharacterListVoidVoid
FactionListVoidVoid
RoundsListVoidVoid

CcoCampaignEventHostileAction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DiplomaticStateContextVoidVoid
IsReferingToPlayerVoidVoid
TargetFactionContextVoidVoid
ActingFactionContextVoidVoid
ActingCharacterContextVoidVoid

CcoCampaignEventIncident

Context wrapper for a campaign incident

Functions

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

CcoCampaignEventMercenaryUnitUnlock

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitVoidVoid

CcoCampaignEventTechnologyResearched

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ZoomToVoidVoid
FactionVoidVoid
HasZoomLocationVoidVoid
ResearchedTechnologyVoidVoid
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
NameVoidVoid
UnitVoidVoid
DescriptionVoidVoid
AgentVoidVoid

CcoCampaignFactionAlliedBuildings

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

Functions

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

CcoCampaignFactionCaravans

Wrapper for a campaign FACTION_CARAVANS struct

Functions

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

CcoCampaignFactionGovernorship

Functions

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

CcoCampaignFactionProvinceManager

Wrapper for a campaign FACTION_PROVINCE_MANAGER

Functions

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

CcoCampaignFactionWomCompass

Wrapper for wom compass

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentDirectionContextCcoCampaignWomCompassDirectionVoidReturns a CcoCampaignWomCompassDirection with the currently active direction
ActivateUserActionForDirectionVoidCcoCampaignWomCompassDirection, StringActivates the user action with the type passed in for the specified direction
TooltipReasonForDirectionUniStringCcoCampaignWomCompassDirectionReturns extra text for the passed in direction
ChooseCompassDirectionVoidCcoCampaignWomCompassDirectionChanges the compass direction to the one specified if possible
CanChangeDirectionBoolVoidReturns true if the selection can be changed by the faction
MaximumFactionCooldownIntVoidReturns an int with the maximum cooldown the faction can have (useful for calculating percentage)
MaximumCompassCooldownIntVoidReturns an int with the maximum cooldown the compass can have (useful for calculating percentage)
FactionCooldownIntVoidReturns an int with the cooldown until the faction can turn the compass again
CompassCooldownIntVoidReturns an int with the cooldown until the compass can be moved again by any faction
DirectionForKeyContextCcoCampaignWomCompassDirectionStringReturns a CcoCampaignWomCompassDirection with the key specified
DirectionListCcoCampaignWomCompassDirection (list)VoidReturns a list of CcoCampaignWomCompassDirection with all the directions of the compass

CcoCampaignGovernorshipInteraction

Functions

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

CcoCampaignInitiative

Wrapper for a campaign initiative

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MarkAsSeenVoidVoidMarks the initiative as seen
HasSeenBoolVoidReturns true if this initiative has been seen before (modified by MarkAsSeen)
ActivateVoidInt (optional)Activates the initiative, to an optionally provided slot index
IsScriptLockedBoolVoidReturns true if this initiative is script locked.
IsOnlyOnCooldownBoolInt (optional)Returns true if locked only because of being on cooldown. Can provide an optional slot index
HasInfiniteDurationBoolVoidReturns true if this initiative will not expire
IsLockedBoolInt (optional)Returns true if this initiative is locked. Alternatively given a slot index, return if locked for given slot
PointsCostIntVoidReturns how many points this initiative contributes towards the set's limits (can be negative)
IsActiveBoolVoidReturns true if this initiative is currently active
LockReasonsUniStringVoidReturns reasons that this initiative is locked as a string
RemainingDurationIntVoidReturns the remaining duration of the intiative
TurnsUntilPayloadIsActivatedIntCcoCampaignPayloadRecordReturns the number of turns until the payload is reactivated
RequiredCostContextCcoCampaignResourceTransactionVoidReturns context to required resource cost. Initiative is locked until these transactions have been met
LinkedTechnologyListCcoTechnologyRecord (list)VoidReturns list of technologies that modify this initiative
CostContextCcoCampaignResourceTransactionVoidReturns context to intitial cost
UpkeepCostContextCcoCampaignResourceTransactionVoidReturns context to per-turn upkeep cost
DeactivateVoidVoidDeactivates the initiative
InitiativeContextCcoInitiativeRecordVoidReturns associated initiative record wrapper

CcoCampaignInitiativeSet

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ActiveInitiativeLimitVoidVoid
RemainingCooldownVoidVoid
CanActivateInitiativesVoidVoid
CostForMultipleInitiativesVoidVoid
BaseCostContextVoidVoid
ActiveInitiativesVoidVoid
ActiveInitiativeForSlotVoidVoid
ToggleMultipleInitiativesVoidVoid
InitiativeSetContextVoidVoid
InitiativeListVoidVoid
IsOnCooldownVoidVoid
DevModifyLimitVoidVoid
PointsLimitVoidVoid
PointsAllocatedVoidVoid

CcoCampaignMercenaryPoolUnit

Component context wrapper for a mercenary pool unit

Functions

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

CcoCampaignMilitaryForceHorde

Functions

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

CcoCampaignMilitaryForceMorale

Component context wrapper for a campaign military force's morale

Functions

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

CcoCampaignMilitaryForceStance

Functions

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

CcoCampaignMilitaryForceWarTargetting

Functions

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

CcoCampaignMissionDefinition

Component context wrapper for a CAMPAIGN_MISSION_DEFINITION

Functions

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

CcoCampaignMissionObjective

Component context wrapper for a CAMPAIGN_MISSION_OBJECTIVE

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ObjectiveRequirementsListCcoCampaignMissionObjectiveRequirements (list)VoidReturns the mission objective requirements list
ObjectiveCompletedBoolVoidReturns whether the objective has been completed

CcoCampaignMissionObjectiveRequirements

Component context wrapper for a CAMPAIGN_MISSION_COMPLETION_STATUS_LINE

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ZoomToVoidVoidZooms the campaign camera to the objective's zoom to location
TechnologyRecordContextCcoTechnologyRecordVoidReturns the optional technology record context of this objective
DescriptionUniStringVoidReturns the description of the objective
BuildingLevelRecordContextCcoBuildingLevelRecordVoidReturns the optional building level record context of this objective
IsCompletedBoolVoidReturns whether the objective has been completed
HasZoomToLocationBoolVoidReturns whether the objective has a zoom to location
TooltipUniStringVoidReturns the tooltip of the objective
UnitRecordContextCcoMainUnitRecordVoidReturns the optional unit record context of this 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
EffectBundleCcoEffectBundleVoidReturns the CcoEffectBundle provided by the payload if there is any
IconStringVoidReturns icon filepath to use
StateStringVoidReturns the state to use in layout, this is either thte rarity state of the ancillary, if no ancillary just returns 'effect'
TitleUniStringVoidReturns localised name of payload entry reward
IsAccessibleBoolVoidReturns true if payload is accessible (with DLC permissions)
UnitRankIntVoidReturns the unit rank, will return 0 if the payload doesn't provide a unit
SortOrderIntVoidReturns sort order of the payload
UnitRecordContextCcoMainUnitRecordVoidReturns the CcoMainUnitRecord provided by the payload if there is any
IsUnitPayloadBoolVoidReturns true if there is a UnitRecordContext
AncillaryCcoAncillaryRecordVoidReturns the CcoAncillaryRecord provided by the payload if there is any
TraitLevelRecordContextCcoCharacterTraitLevelRecordVoidReturns the CcoCharacterTraitLevelRecord provided by the payload if there is any
TurnsRemainingIntVoidReturns how many turns the payload lasts

CcoCampaignPendingActionNotification

Component context wrapper for an individual notification/warning for CcoCampaignPendingActionNotificationQueue

Functions

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

CcoCampaignPendingActionNotificationQueue

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

Functions

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

CcoCampaignPlagueComposition

Wrapper for a plague composition (base plague plus ingredients)

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
SpecialCompositionForFactionContextCcoPlagueSpecialCompositionRecordCcoCampaignFactionReturns the special composition for this combination of plague and ingredients for the passed in faction, if any
PlagueIngredientListCcoCampaignPlagueIngredient (list)VoidReturns a list of plague ingredients 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
BasePlagueContextCcoCampaignBasePlagueVoidReturns the plague record context in the infection data

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

CcoCampaignPlagueIngredient

Wrapper for a campaign plague component

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NameUniStringVoidReturns the name of the plague component record
KeyStringVoidReturns the key of the plague component record
ResourceTransactionContextCcoCampaignResourceTransactionVoidReturns the resource transaction context with the cost of this ingredient
RequiredTechnologyContextCcoCampaignTechnologyVoidReturns the required technology needed to unlock this ingredient
IsUnlockedBoolCcoCampaignFaction (optional)Returns true if the component is unlocked for the faction passed in (or for players faction if no faction is passed)
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)
DescriptionUniStringVoidReturns the description of the plague component record
PlagueEffectContextCcoPlagueEffectRecordVoidReturns a CcoPlagueEffectRecord which contains all effect bundles for this ingredient
ImagePathStringVoidReturns the image path of the plague component record

CcoCampaignPlaguesCompositionSystem

Wrapper for a campaign plagues composition system

Functions

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

CcoCampaignPooledResourceDistributor

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

Functions

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

CcoCampaignPooledResourceManager

Context wrapper for pooled resource manager.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasRequiredTradeResourcesBoolCcoCampaignResourceTransactionReturns true if this transaction has the required trade resources
CanAffordSpecificPooledResourceCostBoolCcoCampaignPooledResourceTransactionReturns true if can afford the specific pooled resource cost specified by provided CcoCampaignPooledResourceTransaction
CanAffordTreasuryCostBoolCcoCampaignResourceTransactionReturns true if can afford the treasury cost of the specified resource transaction
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

CcoCampaignPooledResourceMilitaryForceBreakdown

Wrapper for a military force breakdown of a pooled resource

Functions

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

CcoCampaignPooledResourceProvinceBreakdown

Wrapper for a province breakdown of a pooled resource

Functions

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

CcoCampaignPooledResourceSettlementBreakdown

Wrapper for a region/settlement breakdown of a pooled resource

Functions

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

CcoCampaignPooledResourceTransaction

Context wrapper for pooled resource transactions.

Functions

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

CcoCampaignProvinceAutoManagement

Wrapper for province auto-management logic

Functions

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

CcoCampaignProvinceGovernorship

Wrapper for a province governorship

Functions

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

CcoCampaignPublicOrder

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ChangePerTurnVoidVoid
ChangePerTurnStateVoidVoid
BalanceVoidVoid
StateVoidVoid
ProvidedEffectBundleVoidVoid
DetailsVoidVoid
HappinessRangeEffectBundleListVoidVoid
BreakdownListVoidVoid
BalancePercentageVoidVoid

CcoCampaignResourceTransaction

Context wrapper for resource transactions.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AddCcoCampaignResourceTransactionCcoCampaignResourceTransactionReturns the result of adding 2 transactions together
TreasuryTransactionListCcoCampaignTreasuryTransaction (list)VoidReturns the list of pooled resource treasure transactions
TradeResourceListCcoResourceRecord (list)VoidReturns the list of required trade resources
AbsoluteTreasuryChangeIntVoidReturns the absolute treasury change (always positive)
PooledResourceTransactionListCcoCampaignPooledResourceTransaction (list)VoidReturns the list of pooled resource transactions

CcoCampaignRitual

Wrapper for a campaign ritual

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ResourceTransactionContextCcoCampaignResourceTransactionContext (optional)Returns a context to the resource transaction
LastCompletedRitualRemainingPayloadDurationIntExpressionStateReturns an int with the remaining duration of the payload of the last ritual completed
CooldownUponActivationIntVoidReturns the cooldown for the ritual. Faction bonus values are checked.
IsAvailableBoolVoidReturns true if the ritual is available
IsScriptLockedBoolContext (optional)Returns true if the ritual is locked by script
RemainingCooldownIntVoidReturns the remaining cooldown for the ritual
RitualInteractionContextCcoCampaignRitualInteractionVoidReturns the context of the ritual targeting interface, used for selecting targets in 3d space.
SlaveCostIntVoidReturns the amount of slaves the ritual costs, taking bonus values into account
LastCompletedRitualTargetContextContextVoidReturns the context of the target that was used when last performing the ritual
MortuaryCategoryContextCcoMortuaryCultCategoryRecordVoidReturns the mortuary cult category if it exists
RemainingScriptLockTimeIntVoidReturns the remaining time that the ritual is locked by script
IsRitualEffectBundleActiveOnTargetBoolContextReturns true if the ritual effect is active on target. Context parameter can be a CcoCampaignMilitaryForce, CcoCampaignSettlement or CcoCampaignFaction
PerformVoidContext (optional)Performs the ritual. Optional context parameter can be a CcoCampaignMilitaryForce, CcoCampaignSettlement or CcoCampaignFaction
FactionContextCcoCampaignFactionVoidReturns the faction context of the ritual
IsOnCooldownBoolVoidReturns true if the ritual is on cooldown
TargetTypeStringVoidReturns a string with the type of target this ritual requires. Returns empty string if no target is required.
RitualCompletionPayloadDurationIntExpressionStateReturns an int with the completion payload duration
IsActiveBoolVoidReturns true if the ritual is active
RemainingCastTimeIntVoidReturns the remaining cast time of the ritual
DefaultFactionTargetContextCcoCampaignFactionVoidReturns the default faction target (if any) this ritual is setup to point at
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
RemainingRitualCooldownForTargetIntContextReturns the remaining cooldown for a target. Context parameter can be a CcoCampaignMilitaryForce, CcoCampaignSettlement or CcoCampaignFaction
InvalidRitualReasonUniStringExpressionState, Context (optional)Returns a localised string with text explaining why the ritual cannot be performed
TargetResourceTransactionContextCcoCampaignResourceTransactionContextReturns a context to the target resource. Parameter can be a CcoCampaignMilitaryForce, CcoCampaignSettlement or CcoCampaignFaction
RitualContextCcoRitualRecordVoidReturns a context to the ritual
CanPerformRitualBoolContext (optional)Returns true if the ritual can be performed. Optional context param for the target, in case the ritual requires one
TargetCriteriaTextUniStringVoidReturns a localised string with text explaining the necessary target criteria requirements
RemainingCategoryCooldownForTargetIntContextReturns the remaining cooldown for a target category. Context parameter can be a CcoCampaignMilitaryForce, CcoCampaignSettlement or CcoCampaignFaction
IsRitualCategoryActiveBoolVoidReturns true if a ritual category is active
IsCompleteBoolVoidReturns true if the ritual is completed
CanAffordBoolContext (optional)Returns true if we can afford the cost of this ritual
IsTargetValidBoolContextReturns true if the provided target is valid. Context parameter can be a CcoCampaignMilitaryForce, CcoCampaignSettlement or CcoCampaignFaction
CompletedRitualTargetAndDurationListCcoPair (list)ExpressionStateGoes through all completed rituals of this type and returns a list of all targets and their remaining payload duration
ScriptLockedReasonUniStringVoidReturns the reason for why a ritual is locked by script

CcoCampaignRitualChain

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

Functions

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

CcoCampaignRitualInteraction

Class that manages targetting interface interaction for a ritual

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
ActionPerformTooltipUniStringVoidReturns a tooltip specifying whether can perform the ritual or not, exmplaining the reason if cannot be performed
TargetFactionContextCcoCampaignFactionVoidReturns the target faction context if any
PerformActionVoidVoidPerforms a ritual with the current target stored
ActionCostCcoCampaignResourceTransactionVoidReturns the cost of the ritual.
CanPerformActionBoolVoidReturns true if can perform ritual with the current target setup
ClearTargetVoidVoidClears the currently stored target
SetTargetVoidContextSets the target to the object passed in
EnableTargettingVoidBoolIs passed true, enables this as the targetting interface, else disables it.
ToggleTargettingVoidVoidToggles the targetting system through the CampaignTargettingInterface.
IsTargettingActiveBoolVoidReturns true if this is the currently active targetting interface
IsValidTargetBoolContextReturns true if the passed in object is a valid target
ZoomToTargetVoidVoidZooms to the stored target
RitualContextCcoCampaignRitualVoidReturns the context of the ritual associated with this class.
InvalidReasonsForTargetUniStringContextReturns the reasons why the passed in target is invalid. Returns empty string if valid
CurrentTargetContextContextVoidReturns the context of the current target, if any has been set
UpdateTargetFactionVoidBool (optional)Updates the faction with the current targetting interface faction. This is so all targetting interfaces are in sync

CcoCampaignRitualManager

Wrapper for a faction's ritual manager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RitualContextCcoCampaignRitualCcoRitualRecordGet a CcoCampaignRitual if one exists from a provided ritual record
HasAccessToRitualCategoryBoolCcoRitualCategoryRecordReturns whether faction has access to provided ritual category
AvailableRitualListCcoCampaignRitual (list)VoidGet list of available rituals
UnlockableRitualListCcoCampaignRitual (list)VoidGet list of unlockable rituals

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
IsActiveBoolCcoCampaignCaravanReturns true if the node can be clicked to change the path
ResourceRewardForCaravanContextCcoCampaignResourceTransactionCcoCampaignCaravanReturns a CcoCampaignResourceTransaction with the resources that the caravan will generate when it reaches this node
IsVisibleBoolVoidReturns true if the node is currently visible
IsSelectedBoolCcoCampaignCaravanReturns true if the node is on the path of the passed in caravan, or the selected start node
SegmentTowardsNodeContextCcoCampaignRouteSegmentCcoCampaignRouteNodeReturns the segment connecting this node with the one passed in, if any
SettlementContextCcoCampaignSettlementVoidReturns a CcoCampaignSettlement with the region where this node is
IsStartNodeBoolVoidReturns true if this node is a starting node for its network
IsEndNodeBoolVoidReturns true if this node is an ending node for its network
ActiveContractListCcoCaravanContractRecord (list)VoidReturns a list of available resource contracts at this node
OwningFactionContextCcoCampaignFactionVoidReturns a CcoCampaignFaction with the faction that own the region where this node is, if any
PositionVector4VoidReturns the display position of the node
NodeSegmentLinkListCcoCampaignRouteSegment (list)VoidReturns a list with all the nodes segments connected to this one
RoundsToRefreshIntVoidReturns an int with the rounds left until the contracts refresh for this node

CcoCampaignRouteSegment

Wrapper for campaign route segment

Functions

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

CcoCampaignSkavenCorruptionOverlay

Record wrapper for a Skaven corruption overlay

Functions

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

CcoCampaignSlaves

Functions

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

CcoCampaignTechnologyManager

Wrapper for a faction's technology manager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentResearchingTechnologyContextCcoCampaignTechnologyVoidReturn a context to the current technology this manager is researching, if valid
ResearchedTechnologyListCcoCampaignTechnology (list)VoidReturn a list of researched technology from this manager
TechnologyListCcoCampaignTechnology (list)VoidReturn a list of technology available to this manager
ResearchPointsIntVoidReturn research points for this manager
IsResearchingTechBoolVoidReturn if this manager is currently researching a technology or not
GoalTechnologyContextCcoCampaignTechnologyVoidReturn a context to the goal research technology if valid
EffectsGrantedCcoEffect (list)VoidReturn a list of effects granted by technology in this manager

CcoCampaignTreasuryTransaction

Context wrapper for treasury transactions.

Functions

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

CcoCampaignUnitGroupUpgrade

Component context wrapper for a UNIT_GROUP_UPGRADE

Functions

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

CcoCampaignUnitPurchasableEffectCost

Context wrapper for pairing purchasable effect record and resource transaction.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ResourceTransactionCcoCampaignResourceTransactionVoidReturns resource transaction cco
EffectRecordCcoUnitPurchasableEffectRecordVoidReturns purchasable effect record cco

CcoCampaignUnitUpgradeManager

Component context wrapper for a UNIT_UPGRADE_MANAGER

Functions

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

CcoCampaignUnitUpgradesBuildingRequirement

Component context wrapper for a UNIT_GROUP_TECH_REQUIREMENT

Functions

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

CcoCampaignUnitUpgradesTechRequirement

Component context wrapper for a UNIT_GROUP_TECH_REQUIREMENT

Functions

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

CcoCampaignWarCoordinationRequest

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

Functions

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

CcoCampaignWinStreak

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentStreakEffectContextVoidVoid
WinStreakPercentVoidVoid
TurnsUntilDecayVoidVoid
InvalidationRoundVoidVoid
EffectListVoidVoid
EffectUnfilteredListVoidVoid
CampaignStreakContextVoidVoid
CurrentWinStreakVoidVoid

CcoCampaignWindsOfMagicArea

Wrapper for a winds of magic area.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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.
DoesFactionHaveAreaOwnershipBoolCcoCampaignFactionReturns true if the passed in faction has ownership of this area
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.
ChangeAreaStrengthVoidBoolChanges the current area strength. If the bool passed in is true, then it increases the strength, else it decreases it.
WindsOfMagicManipulationCostCcoCampaignResourceTransactionBoolReturns the cost of performing a wind manipulation in this area. If passed true, will return cost for increasing strength, otherwise for decreasing
RoundsUntilTransitionIntVoidReturns the number of rounds until the next transition.
CurrentStrengthContextCcoCampaignMapWindsOfMagicStrengthRecordVoidReturns the context of the current wind strength record in the area.
TransitionRoundIntVoidReturns an int with the round number when the duration of the current strength finishes.
RecordContextCcoCampaignMapWindsOfMagicAreaRecordVoidReturns the context of the winds of magic area record.
RegionListContextListVoidReturns a list with all the regions in the area.

CcoCampaignWindsOfMagicSystem

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AreaContextForRegionCcoCampaignWindsOfMagicAreaCcoRegionRecord
ChangeAreaStrengthVoidCcoCampaignWindsOfMagicArea, CcoCampaignMapWindsOfMagicStrengthRecord
AreaContextForProvinceCcoCampaignWindsOfMagicAreaCcoCampaignProvince
AllAreaContextsContextListVoid

CcoCampaignWomCompassDirection

Wrapper for wom compass direction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionUniStringVoidReturns the localised description of the direction
SelectionEffectListCcoEffect (list)VoidReturns a list with the effects that this direction gets while it's selected
MinPowerLevelIntVoidReturns an int with the minimum power level this direction can have
MaxPowerLevelIntVoidReturns an int with the maximum power level this direction can have
PowerLevelEffectListCcoEffect (list)VoidReturns a list with the current effects of this direction based on the power level
KeyStringVoidReturns the key of the direction record
ActionTooltipUniStringStringReturns the tooltip for the action of the type specified
FactorListCcoStringValue (list)VoidReturns a list of factors that have affected the power level of this direction
PowerLevelRangeListCcoCampaignWomCompassPowerLevelRange (list)VoidReturns a list of power level ranges grouped based on effects
CanActivateActionBoolStringReturns true if the action with the type specified can be activated
IsCurrentDirectionBoolVoidReturns true if this direction is the currently selected one
CurrentPowerLevelIntVoidReturns an int with the current power level that this direction has

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
SegmentPercentageFloatVoidReturns the percentage that this segment has based on the range's min and max
MinLevelIntVoidReturns the minimum level of this range
DirectionContextCcoCampaignWomCompassDirectionVoidReturns the compass direction context
EffectListCcoEffect (list)VoidReturns a list of effects for this level

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

CcoComponent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsTopmostObjectBoolVoidReturns true if the component is a topmost object, meaning it will render on top of everything else
SetImageVoidInt, StringSets image using specified image index and filepath
NumChildrenIntVoidReturns number of children
RotateImageVoidInt, FloatRotates the specified image index by the specified angle in degrees
ContextsListContextListVoidReturns list of all contexts stored on this component and its callbacks
GetAnimationFramePropertyVector4String, Int, StringGets the values set for a given animation property on a specific frame of an animation on this component.
GuidOriginalDebugIDStringVoidThis is the guid id to use when using conditional breakpoints, can just use CopyDebugGuidToClipboard to make this process smoother
StoredContextContextStringReturns the stored context with the specified type id (if one exists)
SetIsTopmostObjectVoidBoolSets a component to be a topmost object, meaning it will render on top of everything else
CurrentStateStringVoidReturns the current state name as a string
SetTextVoidUniStringSets the current text on the component
IsCreatedFromScriptBoolVoidReturns true if this component was created from script
ParentContextCcoComponentString (optional)Returns the parent component if we have one
SetContextFromIdVoidStringSets the context on a component using a specified context object id (type + objectid) to get it from the cache
ChildListCcoComponent (list)VoidReturns list of all children
BreakForDebuggingVoidVoidBreaks into code when attached to VS so can inspect internal component in greater detaildebug, hide_in_uied
ClearPriorityLockVoidVoidClears the current priority lock
SetVisibleVoidBoolSets the visibility of the component based on specified bool
SetPropertyVoidString, StringSets a property on the component using the supplied key and value
MoveToRelativeVoidVector4Changes the relative position of the component to the position specified
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)
HasChildrenBoolVoidReturns true if has any children
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
SetAnimationFramePropertyVoidString, Int, String, Vector4Sets the specified property on a specific frame of a given animation on this component.
WarningListCcoUiWarning (list)Bool (optional)Returns list of warnings of potential issues with this component
ImageListStringVoidReturns list of all image paths as string with each path on new line
SetPriorityVoidIntSets the priority of the component to the supplied priority
RelativePositionVector4VoidReturns the relative position of the component
ChildIndexIntVoidReturns the index we are in our parents child list
CurrentAnimationStringVoidReturns the current animations id if any
DimensionsVector4VoidReturns the current dimensions of the component
CallbackStoreListCcoCallbackExpressionStore (list)Voiddebug, hide_in_uied
TrashVoidVoidDestroys this component
PushPriorityLockVoidIntPushes a priority lock, any component with a priority under the value supplied will be made non-interactive
TriggerAnimationVoidStringTriggers the specified animation
SetListOffsetVoidInt, IntSets list offset on component (only works if in a list)
ImagePathStringIntReturns the image path of the image at the specified index
IdStringVoidReturns the id of the componentui
ResizeVoidInt, Int, Bool (optional)Resizes this component to the specified size
ListLayoutContextCcoListLayoutVoidReturns list engine tied to the component if valid
CopyFullPathToClipboardVoidVoidReturns the components path from the root so can see all the parent ids that lead to this componentdebug, hide_in_uied
SetStateBoolStringSets the state of the component to the supplied state
IsParentOfBoolCcoComponentReturns true if the component is a parent of the other component passed.
MoveToAbsoluteVoidVector4Changes the absolute position of the component to the position specified
SimulateLClickVoidVoidSimulates a left click on the component
ClearContextVoidString, BoolClears specified context type, and propagates if specified
SetImageMetricSizeVoidInt, Int, IntSets the size of the image metric on the current state
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)
CopyDebugGuidToClipboardVoidVoidCopies the debug guid to clipboard so can set conditional breakpoints easilydebug, hide_in_uied
PositionVector4VoidReturns the absolute position of the component
AnimationListStringVoidReturns a list of the animations on the component as a string
HasPlaceholderImageBoolVoidReturns true if any image on component is currently set to placeholder due to image tried to set not existingdebug
IsActiveFocusBoolVoidReturns true if this component is the current focus (for example if a text input typing into)
IsInteractiveBoolVoidReturns true if the component is currently interactive
SetDockOffsetVoidInt, IntSets dock offset on component (only works if already docked)
StateListStringVoidReturns the list of state names as a string
MemoryAddressStringVoidReturns the memory address of this componentdebug, hide_in_uied
ForceUpdateContextDisplayVoidVoidForces the ContextCallback::UpdateDisplay call to hit, which is very handy for debugging combined with conditional breakpointsdebug, hide_in_uied
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
ToggleVisibilityVoidVoidToggles the visibility 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
IsDisabledBoolVoidReturns true if the component is currently disabled
ModelViewContextCcoComponentModelViewVoidReturns a CcoComponentModelView context for the component if it has a model view (3d model display)
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
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.
ChildCountPropagatedIntVoidReturns the number of children recursively (so number of our children, and childrens children, and so forth)
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)
FontCategoryNameStringVoidReturns the current name of the current font category in the current state
ToggleHighlightVoidVoidToggles a highlighting effect on the component to make it easier to finddebug, hide_in_uied
NumVisibleChildrenIntVoidReturns the number of visible children
PriorityIntVoidReturns the priority of the component
ExportLayoutToXMLVoidVoidExports the entire layout that the current component is in to an xml located in working_data/UI/GameLayoutExportsdebug, hide_in_uied
EnableDebugDisplayVoidBoolEnables/disables debug display which helps to visualise the bounds of this component and any additional debug infodebug, hide_in_uied
SoundCategoryStringVoidReturns the sound category of the componentsound
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
LayoutPathStringVoidReturns the layout path so know which layout this component is authored in
TemplatePathStringVoidReturns the template layout path this component is authored from if any
ExportComponentAndChildrenToXMLVoidVoidExports the current component and its children to an xml located in working_data/UI/GameLayoutExportsdebug, hide_in_uied
IsPriorityLockedBoolVoidReturns true if this components priority is lower than the current priority lock, meaning this component cannot be interacted with
SetDebugDisplayColourVoidInt, Int, IntSets the colour of the debug display activated with ToggleDebugDisplay. Useful for when debugging layout engines within layout engines for example
IsUpdatingBoolVoidReturns true if the last update time of the component matches the root i.e. did update this frame
StoredContextRequiredContextStringReturns the stored context with the specified type id and will assert if it fails
CustomTooltipClearVoidVoidClears any tooltip created with CustomTooltipCreatedebug, hide_in_uied
CurrentTooltipUniStringVoidReturns the current tooltip for the component
PropertyExistsBoolStringReturns true if the specified property key exists
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
IsVisibleBoolVoidReturns true if visible property is set (can be true if this is visible but not parent)
SortChildrenVoidExpressionState, Bool, ExpressionSorts children using the provided expression
StoredContextRequiredFromParentContextStringReturns the stored context with the specified type id on any of our parents, and will assert if it fails
FindWithPredicateCcoComponent (list)ExpressionState, ExpressionReturns a list of every child component matching the passed predicate.
SelectInActiveUiEdVoidVoidIf UiEd is open, this will open the layout this component is authored in and select itdebug, hide_in_uied
GetPropertyStringStringReturns the value of the specified user property key
ToggleDebugDisplayVoidVoidToggles debug display which helps to visualise the bounds of this component and any additional debug infodebug, hide_in_uied
CurrentPriorityLockerCcoComponentVoidReturns the CcoComponent that is the current priority lock
IsSelectedBoolVoidReturns true if in a selected state
IsMouseOverBoolVoidReturns true if the mouse is currently over this component
IsSameGuidBoolStringReturnstrue if supplied guid is same as ours
StartDraggingVoidVoidWill pin component to follow cursor until next left click. Primarily added for dev purposes so can find components easily and workaround overlap issues
IsMouseOverChildrenBoolVoidReturns true if the mouse is currently over this component or its children
ContextCallbacksStringVoidReturns all context callbacks, context objects and functions as one big string for viewing in context viewer
StoredContextFromParentContextStringReturns the stored context with the specified type id (if one exists) on any of our parents
LastScriptCallLocationStringVoidReturns last location in script that did anything to the component which is useful when investigating functionality/issuesdebug, hide_in_uied
SetContextVoidContextSets the context on a component only (not children) using a specified context object given as a parameter
SetCallbackPropertyVoidString, String, StringSets the specified property key and value on the specified callback id
CurrentTextUniStringVoidReturns the current text for the component
PropagateContextVoidContextSets the context on a component (including children) using a specified context object given as a parameter
IsDebugDisplayEnabledBoolVoidChecks if there is currently an active debug display for the componentdebug, hide_in_uied
HasCallbackBoolStringReturns whether the component have a specific callback
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

CcoComponentModelView

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

Functions

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

CcoContextExpression

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EvaluateExpressionArgumentPackContext, ArgumentPack
TextRepresentationStringVoid

CcoContextExpressionCompilationError

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionStringVoid

CcoContextExpressionResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasStringRepresentationBoolVoid
ResultTypeCcoContextObjectTypeVoid
ValueArgumentPackVoid

CcoContextExpressionRuntimeError

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionStringVoid

CcoContextHistoryObject

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ReasonStringVoid
CallbackIdStringVoid
TimeIntVoid
OriginComponentContextContextVoid
ContextIdStringVoid
ContextObjectIdStringVoid
CcoContextContextVoid

CcoContextList

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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.
AnyBoolExpressionState, ExpressionReturns true if any of the contexts return true for the given expression
MinValueFloatExpressionState, ExpressionReturns the smallest value evaluated for each context in the list using expression
IndexForFirstContextIntExpressionState, ExpressionReturns the index of the first context that returns true for the supplied expression
MaxValueFloatExpressionState, ExpressionReturns the largest value evaluated for each context in the list using expression
ForEachVoidExpressionState, ExpressionPerforms the supplied expression on each context
MinContextContextExpressionState, ExpressionReturns the context with the smallest value evaluated for each context in the list using expression
AtContextIntReturns the context at the specified index
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
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
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
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
FindIfContextExpressionState, Expression
SumArgumentPackExpressionState, ExpressionAccumulates the values returns by each contexts expression (for adding up totals)
ReduceArgumentPackExpressionState, Expression, Expression (optional)Reduces the list based on given predicate starting at optional initialiser value
ListContextListVoidReturns internal list of contexts
SkipContextListIntSkip the first x elements of the list
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
FindContextContext
ContainsBoolContextReturns true if supplied context exists in the list
SizeIntVoidReturns the number of elements in the list
ReverseContextListVoidReturns the list in the opposite order
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
IsEmptyBoolVoidReturns true if the list is empty
TakeContextListIntReturns the first N elements of the list
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)
FilterContextListExpressionState, ExpressionReturns a list with all the elements of the given list that satisfy the condition.
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
DistinctContextListExpressionState, Expression (optional)Returns the distinct elements of the list
CountIntExpressionState, ExpressionReturns the number of elements that satisfy the given expression
AllBoolExpressionState, ExpressionReturns true if all the contexts return true for 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

CcoContextObjectType

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsArithmeticBoolVoid
IsListBoolVoid
HasStringRepresentationBoolVoid
NameStringVoid
SymbolsListContextListVoid

CcoContextSymbol

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EvaluateSymbolArgumentPackContext, ArgumentPack
TypeContextCcoContextObjectTypeVoid
DocumentationStringVoid
IsCommandBoolVoid
TagsStringVoid
NameStringVoid

CcoCookingDish

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CookingDishRecordContextVoidVoid
RoundsLeftVoidVoid
FactionLeaderEffectListVoidVoid
FactionEffectListVoidVoid

CcoCookingSystem

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PrimaryIngredientsForRecipeVoidVoid
SecondaryIngredientsForRecipeVoidVoid
PossibleIngredientCategoriesVoidVoid
RecipeForIngredientsVoidVoid
AnyIngredientOfCategoryIsUnlockedVoidVoid
PossibleIngredientsForCategoryVoidVoid
AllIngredientsUnlockedForRecipeVoidVoid
IngredientIsUnlockedVoidVoid
GetPossibleRecipeRecordsVoidVoid
UnlockAllIngredientsVoidVoid
RecipeIsUnlockedVoidVoid
UnlockAllRecipesVoidVoid
GetUnlockedRecipeRecordsVoidVoid
MaximumNumberOfSecondaryIngredientsVoidVoid
GetPossibleIngredientRecordsVoidVoid
IngredientSlotIsUnlockedVoidVoid
CurrentActiveDishContextVoidVoid
GetUnlockedIngredientRecordsVoidVoid
MaximumNumberOfPrimaryIngredientsVoidVoid
CookIngredientsVoidVoid
IsDishActiveVoidVoid

CcoCustomBattleArmyPreset

Wrapper for an army preset that can be saved / loaded

Functions

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

CcoCustomBattleArmyPresetFileHandler

Singleton wrapper for army preset file handler

Functions

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

CcoCustomBattleUnit

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
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
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
RemoveUnitVoidVoidRemoves this unit from the player slot
CustomBattleUnitRecordContextCcoUnitsCustomBattlePermissionRecordVoidReturns the CcoUnitsCustomBattlePermissionRecord record associated with the unit index stored on this context
HasArmoryBoolVoidReturns whether the unit associated with the unit index stored on this context has an armory
PlayerSlotContextCcoCustomBattlePlayerSlotVoidReturns the CcoCustomBattlePlayerSlot associated with the slot 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
CanIncreaseExperienceBoolVoidReturns whether the unit associated with the unit index stored on this context can currently increase its level
IsPersistentCharacterBoolVoidReturns whether the unit associated with the unit index stored on this context is a loaded character
CurrentUpgradeListCcoCustomBattleUnitUpgrade (list)VoidReturns the current CcoCustomBattleUnitUpgrades of the unit associated with the unit index stored on this context
UnitTypesCcoUnitsCustomBattleTypeRecord (list)VoidReturns variants for this unit, eg different ammo or spell lore overrides
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
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
IsValidBoolVoidReturns whether the unit associated with the unit index stored on this context is valid
IsReinforcementBoolVoidReturns whether the unit associated with the unit index stored on this context is a reinforcement
CostAtLevelIntIntReturns the cost at a provided level of the unit with the unit index stored on this context
RemoveMountVoidVoidRemoves the mount 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
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
NameUniStringVoidReturns the name 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
ImagePathStringVoidReturns the portrait path of the unit with the unit index stored on this context
ChangeUnitTypeVoidCcoUnitsCustomBattleTypeRecordChanges, to the provided alternate unit type, specified by the provided CcoUnitsCustomBattleTypeRecord

CcoCustomBattleUnitUpgrade

Functions

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

CcoDiplomacyThreatLevel

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

Functions

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

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
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
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
HasOverrideEffectsBoolVoidReturns true if has different effects to the effect bundle record, for example if the bundle was constructed from script
IsGlobalEffectBundleBoolVoidReturns true if is_global_effect is set to true on effect bundle record
TurnsRemainingIntVoidReturns the turns remaining for this effect bundle, 0 if infinite
PriorityIntVoidReturns the priority (used for ordering and if 0 generally isnt shown in UI)
EffectListCcoEffect (list)ExpressionStateReturns the list of effects for this effect bundle (CcoEffect)
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
IconPathStringVoidReturns the icon path
NameUniStringVoidReturns the localised name
DescriptionUniStringVoidReturns the localised description
RecordListCcoEffectBundle (list)VoidReturns the list of all effect bundle records
KeyStringVoidReturns the unique key of the effect bundle record

CcoEpisodicOverride

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsOverridenVoidVoid

CcoFactionSavedCharacters

Wrapper for a SAVED_CHARACTER_INFO struct

Functions

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

CcoFactorBreakdown

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ListVoidVoid
HeaderVoidVoid
DescriptionVoidVoid

CcoFindResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ContextContextVoid
IndexIntVoid

CcoFloatingTextAgentActionEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsSuccessVoidVoid
AgentFlagPathVoidVoid
ActionNameVoidVoid
TargetNameVoidVoid
AgentNameVoidVoid
TargetFlagPathVoidVoid
TextTypeVoidVoid

CcoFloatingTextBattleEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TextTypeVoidVoid
AttackerFlagPathVoidVoid
DefenderFlagPathVoidVoid
AttackerVoidVoid
DefenderVoidVoid

CcoFloatingTextStanceEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NewStanceNameVoidVoid
GeneralNameVoidVoid
OldStanceNameVoidVoid
TextTypeVoidVoid
GeneralFlagPathVoidVoid

CcoFrontendFactionLeader

Wrapper for a frontend faction leader

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactionEffectBundleCcoEffectBundleVoidReturns a list of faction effects to be displayed in frontend
PinLocationVector4VoidReturns the location of the lord on the map
SetAsActiveModelVoidVoidSets this leader as the active model
FactionRecordContextCcoFactionRecordVoidReturns a CcoFactionRecord with the faction record that the lord is part of
GeneralKeyStringVoidReturns the start pos character key for the general
UnitListCcoUnitDetails (list)VoidReturns a list of CcoUnitDetails of units that are present in the leader's military force
AchievementLockedTextUniStringVoidReturns localised text to show for achievement locked lord
IsLockedBoolVoidReturns true if cant play as lord due to them being locked behind achievement currently
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
SetNameVoidUniStringSets the name of the general to the one passed in
RandomiseNameVoidVoidGenerates a random name for the general
FrontendFactionLeaderRecordContextCcoFrontendFactionLeaderRecordVoidReturns a CcoFrontendFactionLeaderRecord with the leader record

CcoFrontendRoot

Functions

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

CcoGameCore

Wrapper for the game core

Functions

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

CcoGroupList

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CategoryObjectContextVoid
GroupedListContextListVoid

CcoIngameMessaging

Ingame messaging singleton, used to get ingame news items

Functions

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

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)
OpenLinkVoidExpressionStateOpens up the button url in an external browser
TemplateIdStringVoidReturns the ID of the template used as a string
FieldUniStringStringGiven a key return value for stored field on messaging item, from original JSON response
CategoryStringVoidReturns the category of the item as a string

CcoListLayout

Wrapper for a component list engine

Functions

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

CcoLobbyPlayer

Wrapper for a lobby player slot

Functions

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

CcoLobbyTeam

Component context wrapper for a MPC lobby team

Functions

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

CcoMoMTrialManager

Wrapper for Mirrors of Madness Trials

Functions

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

CcoNarrativeManager

Functions

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

CcoNetworkPlayer

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ShowProfileVoidVoidShows the players profile in mp client (like steam overlay)
IsSpectatingBoolVoidReturns true if this player is currently spectating in battle
IsPassiveParticipantBoolVoidReturns true if this player is currently a passive participant in battle (spectating but can receive units from active players to join in)
IsFriendBoolVoidReturns true if this player is a friend of the local player
IsLocalPlayerBoolVoidReturns true if this player is the local player
TeamIdIntVoidReturns team id for current game
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
IsOnlineBoolVoidReturns true if this player is currently online
PlayerSlotIntVoidSlot id for current game
SessionPlayerIdIntVoidSession player id for current game
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
AllianceColourColourVoidReturns the alliance colour of this player in relation to local player
CurrentGameCampaignFactionContextCcoCampaignFactionVoidReturns the campaign faction for the player if they are currently in campaign
CurrentGameArmyContextCcoBattleArmyVoidReturns the battle army context for the player if they are currently in a battle
IdStringVoidUnique mp client id
AddAsFriendVoidVoidSends a friend invite via mp client
CurrentGameFactionRecordContextCcoFactionRecordVoidReturns the faction record for the player, if they are currently in a lobby (battle/campaign)
InviteVoidVoidSends a game invite to the player via mp client

CcoPair

Functions

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

CcoPreBattleAIAvailableGenerals

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetGeneralsListContextListVoid

CcoPreBattleFactionVote

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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)
SelectedPlayAsAIFactionCcoCampaignFactionVoidReturns CcoCampaignFaction context for the selected to play as ai faction, can return nullptr
HasVotedBoolVoidReturns whether a vote has been cast
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
HasSelectedPlayAsAiFactionBoolVoidReturns whether a Play as AI faction has been selected
IsFactionAvailableAsPlayAsAIBoolCcoCampaignFactionReturns whether the vote's faction and play as passed in AI faction
PlayAsAIFactionSelectedContextContextVoidReturns Play as AI faction selected, can return nullptr
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
SelectedVoteUniStringVoidReturns localised stringrepresenting the vote cast, can return empty string
IsVoteAvailableBoolStringReturns whether passed in String representing the vote is available for the this faction of this vote
IsPermittedToChangeVoteBoolVoidReturns bool whetehr the faction is permitted to change its vote
SelectedVoteKeyStringVoidReturns UNlocalised stringrepresenting the vote cast, can return empty string
SupportAttackerFactionContextCcoCampaignFactionVoidReturns the primary attacking faction, which if choose to support attacker you would be supporting
SupportDefenderFactionContextCcoCampaignFactionVoidReturns the primary defending faction, which if choose to support defender you would be supporting

CcoPreBattleVotingSystem

Functions

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

CcoPrisonSystem

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsPrisonFullVoidVoid
CurrentNumberOfPrisonersVoidVoid
MaxNumberOfPrisonersVoidVoid

CcoReinforcementArmy

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DelayVoidVoid
EntryPositionVoidVoid

CcoRuntimeObject

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
InternalContextVoid

CcoSaveGameHeader

Wrapper for a save game header

Functions

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

CcoSavedCharacterInfo

Wrapper for a SAVED_CHARACTER_INFO struct

Functions

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

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
RemoveTextTagsUniStringVoidReturns a copy of this string with all text tags removed
IsEmptyBoolVoidReturns true if this string is empty/blank
LengthIntVoidReturns the length of this string
ValueUniStringVoidReturns the string value represented by this string
ReplaceUniStringCcoString, ExpressionState, UniString, UniStringReturns a copy of this string where all instances of the first string supplied are replaced with the second string supplied
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
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
EndsWithBoolCcoString, ExpressionState, UniStringReturns true if this string ends with the specified string
ContainsBoolCcoString, ExpressionState, UniStringReturns true if this string contains the specified string
ExtractColourFromTextUniStringVoidReturns the colour tag from the specified text
ParseTextReplacementsUniStringCcoString, ExpressionStateReturns a copy of this string where any text tags are parsed and replaced in with the actual text
StartsWithBoolCcoString, ExpressionState, UniStringReturns true if this string starts with the specified string
RemoveFilepathExtensionUniStringVoidReturns a copy of this string with the file extension removed, assuming this string is a filepath
ToUpperUniStringCcoString, ExpressionStateReturns a copy of this string where all letters are uppercase
ExtractImageIconFromTextUniStringVoidReturns the image path inside the image tag in the specified text
ToLowerUniStringCcoString, ExpressionStateReturns a copy of this string where all letters are lowercase
RemoveLeadingWhitespaceUniStringVoidReturns a copy of this string with leading whitespace removed
RemoveFilepathDirectoryUniStringVoidReturns a copy of this string with the parent directory removed, assuming this string is a filepath
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)

CcoSummedValueContext

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SummedListContextListVoid
SummedValueFloatVoid
OriginalContextContextVoid

CcoSymbolTest

This is an example

Functions

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

CcoSymbolTestSecond

This is a second example

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
id2StringCcoSymbolTest
SameNameStringVoid
idStringCcoSymbolTest
ContextContextVoid

CcoTempleOfTheOldOnes

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentEffectBundleVoidVoid
ColourVoidVoid
CurrentLevelVoidVoid
NumberOfBuildingsVoidVoid
NameVoidVoid
DescriptionVoidVoid

CcoURI

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

Functions

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

CcoUiWarning

Functions

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

CcoUnitAbilityDetails

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

Functions

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

CcoUnitBulletPoint

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SortOrderVoidVoid
LocalisedTextVoidVoid
TooltipTextVoidVoid
StateVoidVoid

CcoUnitStat

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

Functions

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

CcoUnitStatModIcon

Component context wrapper for a unit stat modifier icon

Functions

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

CcoVector4

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ValueVector4Void
ModulusFloatVoid
zFloatVoid
wFloatVoid
xFloatVoid
yFloatVoid

Battle

CcoBattleAlliance

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

Functions

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

CcoBattleArmy

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

Functions

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

CcoBattleBuilding

Functions

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

CcoBattleCapturePoint

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsLockedBoolVoid
CapturePointScoreNormalisedFloatInt
IsTimeBasedBoolVoid
IsContestedBoolVoid
IsEnabledBoolVoid
IsPointBasedBoolVoid
IsNeutralBoolVoid
ColourBaseColourVoid
ContestingFactorForAllianceFloatInt
ColourFillColourVoid
CapturePercentFloatVoid
FillPercentFloatVoid
SetMouseOverVoidBoolSets the `mouse_over` value to true or false based on the passed argument.
IsLinkedBuildingDestroyedBoolVoid
DescriptionUniStringVoid
DevCaptureForArmyVoidCcoBattleArmyFor dev purposes, captures the capture point immediately for supplied armydebug, hide_in_uied
ColourForHolderColourVoid
CaptureBuildingCcoBattleBuildingVoid
ScriptIdStringVoid
ZoomToVoidVoid
HasCaptureBuildingBoolVoidDoes this capture location have an associated building
IsMouseOverBoolVoidReturns true if the capture point is currently being moused over.
SetHighlightVoidBoolEnables or disables a pulsing highlight effect on the capture location
NameUniStringVoidReturns the string name for this capture point type
HoldingArmyContextCcoBattleArmyVoid
KeyStringVoid
ToggleableSlotsListContextListVoid
ContestingArmycontextCcoBattleArmyVoid
TypeRecordContextCcoCapturePointTypeRecordVoid
HasMoraleEffectsBoolVoid
RadiusFloatVoid
IconPathStringVoid
ToggleableSlotTowersListContextListVoid
DisplayNameUniStringVoidReturns the displayable name for this capture point i.e. the header for the capture point tooltip
BuildingListContextListVoid
ToggleableSlotBarricadesListContextListVoid
ContestingProportionForAllianceFloatInt
FlagPositionVector4VoidReturns the flag position in world space in VECTOR_4
HoldingUnitListContextListVoid
ContestingUnitListContextListVoid
UnitsForAllianceContextListInt
ContributesToVictoryBoolVoid
CapturePointScoreFloatVoid
CanCurrentOwnerBuildBoolVoidReturns if the current owner of the capture point is allowed to build
PositionVector4VoidReturns a position in world space in VECTOR_4

CcoBattleCursorContext

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

Functions

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

CcoBattleReinforcementArmy

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

Functions

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

CcoBattleRoot

The root for battle that gives access to anything battle related

Functions

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

CcoBattleSelection

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

Functions

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

CcoBattleSpawnZone

Functions

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

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

CcoBattleUnit

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ManListCcoBattleEntity (list)VoidReturns the list of CcoBattleEntity just for man entities
IsInvincibleBoolVoidReturns true if the unit is invincible and cant take damage
IsWalkingBoolVoidRetuns true if this unit is currently moving at walking pace
RadarPositionVector4VoidReturns the radar position (0-1, 0-1) as a percentage to be used with ContextRadarIcon
OriginalOwningNetworkPlayerContextCcoNetworkPlayerVoidReturns the CcoNetworkPlayer that originally had control of this unit (if unit gifted for example)
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)
SecondsLeftToTeleportIntVoidReturns number of seconds left in teleporting to withdraw process
ShouldShowAmmoBoolVoidReturns true if we should show ammo UI for this unit
HealthPercentFloatVoidReturns the health of the unit as a percentage (0-1)
DevKillVoidVoidWill kill the unitdebug, hide_in_uied
IsSpawnedUnitBoolVoidReturns true if a spawned unit (came from an ability for example during the battle)
BattleHarmonyEffectContextCcoBattleUnitEffectVoidReturn a context to the currently active battle harmony effect, if there is one
IsUndeadBoolVoidReturns true if unit is undead or construct (different morale rules apply to these, have crumbling and unstable states)
AllianceColourColourVoidReturns the colour based on alliance (player/friendly/enemy/neutral)
BarrierHpPercentFloatVoidReturns the units barrier HP percent if any (barrier is a kind of rechargable shield)
GiftToOriginalOwnerVoidVoidGifts the unit back to their original owning player when the unit is currently a shared unit
BarrierMaxHpIntVoidReturns the units barrier max HP if any (barrier is a kind of rechargable shield)
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
EntityListCcoBattleEntity (list)VoidReturns the list of CcoBattleEntity in the unit
IsWithdrawingBoolVoidReturns true if this unit is withdrawing from the map (running to edge of map to retire from battle)
DevResetAbilityRechargeVoidVoidReset ability rechargedebug, hide_in_uied
HasHarmonyEffectBoolVoidReturns true if the unit is tagged as a Yin or Yang battle harmony unit
EngineListCcoBattleEntity (list)VoidReturns the list of CcoBattleEntity just for engine entities
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
DelayedBarrierHpPercentFloatVoidReturns the units delayed barrier HP percent if any (barrier is a kind of rechargable shield)
HasInfinitePrimaryAmmoBoolVoidReturns true if has infinite primary ammo
DevResetAbilityUsesVoidVoidReset ability usesdebug, hide_in_uied
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
CanGuerrillaDeployBoolVoidReturns true if the unit has the ability to guerilla deploy (deploy outside deployment zone)
CopyMemoryAddressToClipboardVoidVoidCopies the memory address of this models actual unit to the clipboard which is handy for creating conditional breakpointsdebug, hide_in_uied
IsCapturingBoolVoidReturns true if this unit is currently capturing a capture point
StatusMostImportantCcoUiUnitStatusRecordVoidReturns the current most important CcoUiUnitStatusRecord that is active
HighlightVoidBoolHighlights on the 3d battlefield in same way script can (flashes entity markers and unit ids for example)
IsBarrierChargingBoolVoidReturns true if the unit has a barrier and it is currently recharging (barrier is a kind of rechargable shield)
DevTeleportVoidString, StringTeleports a unitdebug, hide_in_uied
IsAliveBoolVoidReturns true if this unit is still alive
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
HasCharacterRankBoolVoidReturns whether the unit supports having a rank or not
ThreatPercentOfUnitMouseoverFloatVoidReturns the threat of the unit currently mousing over (used on tooltips). -1 is invalid, 1 is high threat, 0 is low threat
IsShatteredBoolVoidReturns true if this unit is shattered (morale so low that they will no longer recover and are essentially lost)
AbilityListCcoUnitAbility (list)VoidReturns the list of abilities this unit can use as a list of CcoUnitAbility
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
MoraleColourColourVoidReturns the colour that represents the current MoraleState
IsReadyToExtractBoolVoidReturns true if an ambush battle with an extraction location and they are in the extraction zone ready to safely recover
ThreatPercentOfUnitFloatCcoBattleUnitReturns the threat of the specified unit. -1 is invalid, 1 is high threat, 0 is low threat
CharacterRankIntVoidReturns the rank of the character this unit is for if any
ToggleHighlightVoidVoidToggles the highlight shown with Highlight command
IsFiringMissilesBoolVoidReturns true if this unit is currently firing missilees
BarrierHpIntVoidReturns the units barrier HP if any (barrier is a kind of rechargable shield)
ToggleFlyingVoidVoidToggles a unit between flying in the air and moving on the ground (for units that CanFly)
IsTerrifiedBoolVoidReturns true if unit is currently in a terrified state which seriously affects their morale (comes from units that have terrifying unit behaviour)
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
DevResetAbilityManagerVoidVoidReset ability managerdebug, hide_in_uied
DevTakeControlVoidVoidGives control of the unit to the playerdebug, hide_in_uied
UniqueUiIdIntVoidReturns the unique ui id of the unit as an int, unique amongst all units in the battle
IsUnderPlayerControlBoolVoidReturns true if this unit is currently under the players control
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
CooldownPassiveAbilityListCcoBattleAbility (list)VoidReturns a list of passive battle abilities current on cooldown
PercentCasualtiesRecentlyFloatVoidReturns the percentage of men lost in the last 4 seconds
IsUnderMissileAttackBoolVoidReturns true if this unit is currently being fired upon
SetupUnitContextCcoBattleSetupUnitVoidReturns the CcoBattleSetupContext which wraps BATTLE_SETUP_UNIT for this unit (setup info came into battle with)
IsRoutingBoolVoidReturns true if this unit is currently routing (running away due to low morale, but might recover and come back)
ZoomToVoidVoidZooms camera to look at this unit
DevSetArmyVoidIntGives control of the unit to a given armydebug, hide_in_uied
UnlockedAbilitiesCcoUnitSpecialAbilityRecord (list)ContextList); Returns a list of the unlocked abilities from the list of groups supplied
SelectVoidVoidSelects this unit to control
BuildingContextCcoBattleBuildingVoidReturns the CcoBattleBuilding this unit is currently on/in
IconPathStringVoidReturns the icon path used for unit cards, etc
NumKillsIntVoidReturns the number of kills this unit has performed in this battle
MaxHealthPercentCanReplenishFloatVoidReturns the max health percent that can be replenished by abilities
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
IsPartOfWaveBoolVoidReturns true if this unit is currently routing (running away due to low morale, but might recover and come back)
IsTakingDamageBoolVoidReturns true if this unit is currently taking damage
IsOutOfControlBoolVoidReturns true if this unit is currently out of control (meaning player has no control over them and they just attack the nearest unit)
ToggleFlyingCooldownTimerFloatVoidReturns the time (in seconds) remaining on the toggle flying cooldown timer
MoraleNameWithGreatestEffectUniStringVoidReturns a combination of MoraleName and MoraleGreatestEffect. No longer needed since can add strings with expressionsdeprecated
DevSetForceRampageVoidBoolForces a unit to do rampage booldebug, hide_in_uied
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
UnitRecordContextCcoMainUnitRecordVoidReturns the CcoMainUnitRecord for this unit
ActiveFactionSpecificEffectListCcoEffect (list)Void(Returns a list of the CcoEffects that are being applied to the unit from Storm of Magic ascendancies
IsCharacterBoolVoidReturns true if this unit is a character (general or agent basically)
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
IsVisibleBoolVoidReturns true if this unit is currently visible to player (taking into account hidden state and line of sight
DevToggleControlVoidVoidToggles control between player and UI, useful for taking control of enemy units for exampledebug, hide_in_uied
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
FatigueStateIntVoidReturns the current fatigue state as an int (mirrors enum in code)
FatigueNameUniStringVoidReturns the localised name of the current FatigueState
PercentHpLostRecentlyFloatVoidReturns the percentage of HP lost in the last 4 seconds
IsWaveringBoolVoidReturns true if this unit is currently in wavering morale state (brink of routing)
IsInMeleeBoolVoidRturns true if this unit is currently in melee combat
UnitDetailsContextCcoUnitDetailsVoidReturns the CcoUnitDetails for this unit, used for unit info panel that shows unit information from various sources
IsUnspottableBoolVoidReturns true if this unit has unspottable unit behaviour
ExperienceLevelIntVoidReturns the current experience level
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
IsFlyingBoolVoidReturns true if this unit is currently flying
OfficerEntityContextCcoBattleEntityVoidReturns the CcoBattleEntity for the current officer entity (entity leading this unit)
IsOrderableBoolVoidReturns true if this can be given orders
MoraleGreatestEffectUniStringVoidReturns the localised name of the effect that is having the greatest effect on morale currently
IsGiftedBoolVoidReturns true if this unit has been gifted so the original owner isnt currently controlling
DevSetInvincibleVoidBoolSets the unit invincible based on the supplied booldebug, hide_in_uied
BannerHolderEntityContextCcoBattleEntityVoidReturns the CcoBattleEntity for the entity currently holding the unit banner (entity who UI baner floats above)
CanToggleFlyingBoolVoidReturns true if this unit can currently choose to toggle its flying state (taking into account interruptions, etc)
MoralePercentFloatVoidReturns the current morale as a percentage of best morale could be
IsSelectedBoolVoidReturns true if this unit is currently selected
MoraleStateIntVoidReturns morale state as an int (mirrors enum in code)
IsHiddenBoolVoidReturns true if this unit is currently hidden (using terrain types, etc)
IsUnderAIControlOriginallyBoolVoidReturns true if the unit started the battle under AI control
VehicleContextCcoBattleVehicleVoidReturns the current CcoBattleVehicle this unit is using if any
CanFlyBoolVoidReturns true if this unit has the ability to fly
SecondaryAmmoPercentFloatVoidReturns the percentage of secondary ammo remaining(0 - 1)
HasStatusBoolVoidReturns true if unit has any CcoUiUnitStatusRecord currently
CustomNameUniStringVoidReturns any custom name given to this unit
NumEntitiesIntVoidReturns the current number of entities
IsEnemyUnitBoolVoidReturns true if this unit belongs to the enemy alliance
DevSetAmmoAmountVoidInt, BoolSets the ammo amount to the specified valuedebug, hide_in_uied
IsUnderMyControlBoolVoidReturns true if the unit is under the player control
IsHighlightedBoolVoidReturns true if the unit is currently highlighted
ActiveProjectileContextCcoProjectileRecordVoidReturns the current CcoProjectileRecord context the unit is using for ranged attacks
CanAlwaysFlyingBoolVoidReturns true if this unit has the ability to be always flying
ExperiencePercentFloatVoidReturns the experience percentage of progress to next level
DevSetHealAmountVoidInt, BoolSets the heal amount to the specified percentage value [0-100]debug, hide_in_uied
IsSelectableBoolVoidReturns true if this unit can be selected
NumEntitiesInitialIntVoidReturns the number of entities the unit entered the battle with
MoraleNameUniStringVoidReturns the localised name of the current MoraleState
StatusListCcoUiUnitStatusRecord (list)VoidReturns a list of CcoUiUnitStatusRecord that are currently active sorted in order of importance
IsForceRampageBoolVoidReturns true if the unit has a forced rampage
IsRunningBoolVoidReturns true if this unit is currently moving at running pace
IsOriginallyOwnedByLocalPlayerBoolVoidReturns whether the local player originally owned this unit i.e. if it is gifted but still belongs to this player
DamageInflictedRecentlyIntVoidReturns the amount of damage inflicted in the last 4 seconds
DelayedHealthPercentFloatVoidReturns the delayed health of the unit as a percentage (0-1)
DevRespawnVoidVoidWill respawn the unitdebug, hide_in_uied
HasArtilleryDroppedEnginesBoolVoidReturns true if artillery unit that has dropped their engines
IsGeneralBoolVoidReturns true if this unit is a commanding general unit
IsUnderAIControlBoolVoidReturns true if the unit is currently under AI control (instead of script or player)
PurchasedEffectsListCcoUnitPurchasableEffectRecord (list)VoidReturns a list of CcoUiUnitStatusRecord that are currently active sorted in order of importance
IsFiringAtWillBoolVoidReturns true if this unit has fire at will enabled
HealthValueIntVoidReturns the raw health value
BattleResultUnitContextCcoBattleResultUnitVoidReturns the CcoBattleResultUnit for the current unit
NameUniStringVoidReturns the localised name of the unit
HealthMaxIntVoidReturns the max health
PrimaryAmmoPercentFloatVoidReturns the percentage of primary ammo remaining (0-1)
DevRoutVoidVoidWill rout the unitdebug, hide_in_uied
IsPlayerUnitBoolVoidReturns true if this unit belongs to the player
IsRenownBoolVoidRturns true if a unit of renown (special limited units that have certain perks and we highlight in the UI)
IsBuffedByHarmonyBoolVoidReturns true if the unit is currently receiving a battle harmony buff
PositionVector4VoidReturns the current position
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)
HasInfiniteSecondaryAmmoBoolVoidReturns true if has infinite secondary ammo
IsTeleportWithdrawingBoolVoidReturns whether unit is currently teleporting to withdraw
BreakForDebuggingVoidVoidBreaks in to attached IDE to inspect model UNIT in greater detaildebug, hide_in_uied
CanGuerrillaDeployCurrentlyBoolVoidReturns true if the unit CanGuerrillaDeploy and can do this currently (has extra checks like not in a vehicle, etc)
MountListCcoBattleEntity (list)VoidReturns the list of CcoBattleEntity just for mount entities
IsIdleBoolVoidReturns true if this unit has no orders currently and is standing still

Campaign Model

CcoCampaignModelBuilding

Model safe context wrapper for a campaign building

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProvinceCcoCampaignModelProvinceVoidProvince that contains this building
OwnerCcoCampaignModelFactionVoidFaction that owns this building and the region
RegionCcoCampaignModelRegionVoidRegion that contains this building
ChainRecordKeyStringVoidDatabase record key of the building chain this building belongs to
RecordKeyStringVoidDatabase record key of this building

CcoCampaignModelFaction

Model safe context wrapper for a campaign faction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsRogueFactionBoolVoidIs this faction a rogue faction?
TreasuryIntVoidCurrent treasury balance
UnitCapForUnitIntStringUnit cap for main unit record key. -1 if uncapped or not valid
InitiativeManagerContextCcoCampaignModelInitiativeManagerVoidFaction level initiative manager context
RecordKeyStringVoidDatabase record key of this faction
IsRitualActiveBoolStringReturns true if ritual for ritual key is currently active
ModelPooledResourceContextCcoCampaignModelPooledResourceStringModel pooled resource context for given key, if valid
IsOwnershipProductUnlockedBoolStringChecks if ownership product is unlocked for a faction
IsCampaignFeatureAvailableBoolStringTest if specific campaign feature is available
IsEffectBundleActiveBoolStringTest if specific effect bundle is active on the faction
IsInFactionSetBoolStringTest if the faction is contained in the specified faction set
IsTechnologyResearchedBoolStringTest if tech for given tech key is researched or not
SubcultureIsOneOfBoolArgumentPackTest if the subculture key is one of the specified list. Can accept any number of subculture keys
RecordKeyIsOneOfBoolArgumentPackTest if the faction key is one of the specified list. Can accept any number of faction keys
CultureIsOneOfBoolArgumentPackTest if the culture key is one of the specified list. Can accept any number of culture keys
CultureKeyStringVoidDatabase record key of this factions culture
SubcultureKeyStringVoidDatabase record key of this factions subculture

CcoCampaignModelInitiative

Initiative wrapper safe to use in campaign model contexts

Functions

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

CcoCampaignModelInitiativeManager

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

Functions

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

CcoCampaignModelInitiativeSet

Initiative set wrapper safe to use in campaign model contexts

Functions

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

CcoCampaignModelPooledResource

Campaign model wrapper for a pooled resource

Functions

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

CcoCampaignModelProvince

Model safe context wrapper for a campaign province

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsEnemyOfFactionAgentPresentBoolString, CcoCampaignModelFactionTest if the a character of the specified agent type, owned by an enemy of the specified faction, is present in the province
IsAgentSubtypePresentBoolStringTest if any character of the specified agent subtype 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
IsFactionOwnerOfEntireProvinceBoolCcoCampaignModelFactionDoes the specified faction own the entire province?
IsAgentPresentBoolStringTest if any character of the specified agent type is present in the province
RegionsCcoCampaignModelRegion (list)VoidRegions contained in this province
FactionRegionsCcoCampaignModelRegion (list)CcoCampaignModelFactionRegions contained in this province, owned by the specified faction
RecordKeyStringVoidDatabase record key of this province
IsEnemyOfFactionMilitaryForcePresentBoolCcoCampaignModelFactionTest if a military force that is an enemy of the specified faction is present in the province
IsAnyMilitaryForcePresentBoolVoidTest if any military force is present in the province
IsFactionMilitaryForcePresentBoolCcoCampaignModelFactionTest if a military force belonging to the specified faction 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
IsFactionAgentSubtypePresentBoolString, CcoCampaignModelFactionTest if the a character of the specified agent subtype, owned by the specified faction, is present in the province

CcoCampaignModelRegion

Model safe context wrapper for a campaign region

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsAnyAgentPresentBoolVoidTest if any agent is present in the region
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
IsFactionAgentSubtypePresentBoolString, CcoCampaignModelFactionTest if the specified agent subtype is present in the region and owned by the specified faction
IsAnyMilitaryForcePresentBoolVoidTest if any force is present in the region
WindsOfMagicStrengthLevelIntVoidCurrently active winds of magic strength level for the region
PublicOrderIntVoidPublic order balance for this turn. This value will be the same for every region owned by the faction in this province
WindsOfMagicStrengthKeyStringVoidRecord key of the currently active winds of magic strength level for the region
IsOwnAgentSubtypePresentBoolStringTest if the specified agent subtype is present in the region and owned by the local faction
DevelopmentPointsIntVoidAmount of development points accumulated and unspent. This value will be the same for every region owned by the faction in this province
IsFactionAgentPresentBoolString, CcoCampaignModelFactionTest if the specified agent type is present in the region and owned by the specified faction
GDPIntVoidGDP (income) that this Region generates. Cannot be negative
FactionProvinceGDPIntVoidGDP (income) that the owning faction generates from all of its regions in the province
IsEnemyAgentSubtypePresentBoolStringTest if the specified agent subtype is present in the region and owned by an enemy faction
ProvinceCcoCampaignModelProvinceVoidProvince that contains this region
IsOwnAgentPresentBoolStringTest if the specified agent type is present in the region and owned by the local faction
GrowthPerTurnIntVoidAmount of growth accumulated per-turn. This value will be the same for every region owned by the faction in this province
IsEnemyAgentPresentBoolStringTest if the specified agent type is present in the region and owned by an enemy faction
RecordKeyStringVoidReturns the record key of this region
IsOriginatingSubcultureOneOfBoolArgumentPackTest if the originating subculture key is one of the specified list. Can accept any number of subculture keys
IsAgentPresentBoolStringTest if the specified agent type is present in the region
IsAgentSubtypePresentBoolStringTest if the specified agent subtype is present in the region
IsHomeRegionBoolVoidIs this the factions home region?
IsAnyOwnAgentPresentBoolVoidTest if any agent owned by the local faction is present in the region
OriginatingSubcultureKeyStringVoidReturns the record key of the originating subculture of this region
IsOwnMilitaryForcePresentBoolVoidTest if any military force owned by the local faction is present in the region
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
IsAnyEnemyAgentPresentBoolVoidTest if any enemy agent is present in the region
OwnerCcoCampaignModelFactionVoidReturns the faction that owns this region. May be rebel if abandoned or following a successful rebellion
IsAnyEnemyMilitaryForcePresentBoolVoidTest if any enemy military force is present in the region
NextTurnPublicOrderIntVoidPublic order balance for next turn. This value will be the same for every region owned by the faction in this province

CcoCampaignModelRoot

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

Functions

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

CcoCampaignModelUnit

Model safe context wrapper for a campaign unit

Functions

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

Callbacks

UI Update Messages

MessageAdditional Context
AdviceHistoryCleared
AgentActionPerformed
AncillaryAddedToPool
AncillaryFused
ArmyAbilityPurchased
ArmyAbilityUpgraded
AudioUiCategoriesReloaded
BattleCardsLayoutCalled
BattleConflictStarted
BattleCurrencyUpdate
BattleLocalPlayerChanged
BattleResultsCalculated
BattleSelectionChanged
BattleTimeSpeedChanged
Campaign::Events::DilemmaChoiceTaken
CampaignAreaOfInterestMouseOfftrue
CampaignAreaOfInterestMouseOntrue
CampaignBattleFinished
CampaignBattleFullyCompleted
CampaignBattleStarted
CampaignBuildingStateChanged
CampaignCharacterAncillaryAssigned
CampaignCharacterArmorChange
CampaignCharacterSelectedAny
CampaignCinematicModeDisabled
CampaignCinematicModeEnabled
CampaignFactionStrengthRanksUpdated
CampaignFactionTurnEndChange
CampaignForceGrowthChanged
CampaignHUDVisibilityChanged
CampaignHumanFactionChangedToAI
CampaignLocalFactionChanged
CampaignMilitaryForceDetailsChanged
CampaignNegotiationChange
CampaignProvinceGrowthChanged
CampaignRitualLockStatusChanged
CampaignScriptLockChangedAny
CampaignScriptLockChanged_
CampaignSelectionChanged
CampaignSettlementSelectedAny
CampaignShroudUpdated
CampaignSlavesChanged
CampaignTechnologyResearchCancelledtrue
CampaignTechnologyResearchComplete
CampaignTechnologyResearchCompletetrue
CampaignTechnologyResearchStartedtrue
CampaignTechnologyStateChangeAny
CampaignTreasuryChanged
CampaignTurnEnd
CampaignTurnStart
CampaignUnitRecruited
CampaignUnitRecruitedtrue
CapturePointMouseOverChanged
CaravanPathChanged
CaravanSpawned
CharacterApReplenished
CharacterContainerChanged
CharacterContainerChangedtrue
CharacterConvalescenceChangetrue
CharacterCreatedtrue
CharacterCreatedAny
CharacterDestroyedtrue
CharacterDestroyedAny
CharacterDetailsUnitInfoUpdated
CharacterEnterLimbo
CharacterExitLimbo
CharacterInitiativeActivationChanged
CharacterMoveEndtrue
CharacterMoveEndAny
CharacterMoveStarttrue
CharacterMoveStartAny
CharacterNameChangedtrue
CharacterPostChanged
CharacterPromotedtrue
CharacterRankUptrue
CharacterSkillsUpdate
CharacterSkillsUpdatetrue
CharacterTrainingStateChanged
CharacterTraitGained
CharacterTraitLost
CloseUnitUpgradePanel
ClosedAllPanels
ColourProfileChanged
CompassActionTriggered
CompassDirectionChanged
ContextLayoutTooltipDelaysChanged
ContextViewerCurrentSelectedContextChanged
ContextViewerInspectedContextChanged
ContextViewerRightClickPressed
ControlsChanged
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
CustomBattleOnSettingChangedAny
CustomBattleOnSettingChangedAttackDirection
CustomBattleOnSettingChangedAttackingTeam
CustomBattleOnSettingChangedBattleType
CustomBattleOnSettingChangedCorruptionChanged
CustomBattleOnSettingChangedDifficulty
CustomBattleOnSettingChangedFunds
CustomBattleOnSettingChangedIsLoadingCharactersEnabled
CustomBattleOnSettingChangedIsStormOfMagicEnabled
CustomBattleOnSettingChangedIsUsingUnitCaps
CustomBattleOnSettingChangedLargeArmies
CustomBattleOnSettingChangedLimitlessWom
CustomBattleOnSettingChangedMap
CustomBattleOnSettingChangedRealismMode
CustomBattleOnSettingChangedSeason
CustomBattleOnSettingChangedTileUpgrade
CustomBattleOnSettingChangedTimeLimit
CustomBattleOnSettingChangedTimeOfDay
CustomBattleOnSettingChangedUnitScale
CustomBattleOnSettingChangedWeather
CustomBattleOnSpectatorJoined
CustomBattleOnTeamChanged
CustomBattleOnTeamChangedAny
CustomBattleOnTeamLeaderChanged
CustomBattleOnUnitsChanged
CustomBattleOnUnitsChangedAny
CustomBattleOnUserCreatedMapSync
CustomBattleRecruitmentModeChanged
DevoteesEffectsChanged
DiplomacyFactionSelectionChange
DiplomacyManipulationExecuted
DiplomacyRequest
EffectsListUpdated
EnvironmentSettingChanged
EnvironmentSettingChangedincremental_autosave_enabled
EnvironmentSettingChangedsave_to_cloud
EventFeed::ClearWhiteList
EventFeed::TryOpenNext
EventFeedAutoOpen
EventFeedFilterChanged
EventFeedRepopulate
FactionCapitalChangedtrue
FactionCookedDish
FactionDeathtrue
FactionDiplomacyChangetrue
FactionDiplomacyChangeAny
FactionDiscoveredAny
FactionFeaturesChanged
FactionInitiativeActivationChanged
FactionMercenaryPoolUpdated
FavourPointsChanged
ForeignManagerCreated
ForeignSlotAdded
ForeignSlotRemoved
FrontEndNameRandomised
FrontendGeneralNameChanged
InfoPanelClosed
InfoPanelOpened
IngameMessagingNextPage
IngameMessagingPreviousPage
ItemMarkedAsSeen
LabSettingsLoaded
LayoutFinished_
LevyMercenaryPoolUpdated
LoadingScreenUIDestroyed
MPLobbyOnBattleDifficultyChanged
MPLobbyOnBattleParamsChanged
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
MilitaryForceStanceChanged
MissionEnded
MissionIssued
MissionPinned
MoviePlaybackFinished_
NotificationQueue::CurrentIndexChanged
NotificationQueue::Refresh::All
OnToggleableLclickDowntrue
OnToggleableLclickNotOn
PanelClosed
PanelOpened
PendingMissionsChanged
PlagueSelectionChanged
PlayerDisconnected
PooledResourceEffectChanged
PooledResourceThresholdSetEvaluated
PooledResourceTransaction
PooledResourceTransactionSpecifictrue
PreBattleVotingUpdate
PrisonCellRefreshed
PrisonStateChanged
ProvinceGovernorshipStateChanged
ProvinceMercenaryPoolUpdated
ReadStatusUpdated
RefreshUnitSelection
Reopen_
ResourceChanged
ResourceChanged_
RitualComplete
RitualStarted
ScriptObjectValueUpdated
SelectionParentSelectionChanged
SettlementFactionChangetrue
SettlementFactionChangeAny
SettlementNameChangedtrue
SharedStateChanged
ShowCampaignBattleResults
SlavesTransferred
SlotItemDragEnd
SlotItemDragStart
StagedList::ListUpdated
StormOfMagicAscendancyChange
StormOfMagicAscendancyTransitionStart
StormOfMagicSelectLore
StormOfMagicSelectLoreCompleted
SurvivalWaveUnitsUpdated
TargettingInterfaceChanged
TargettingInterfaceTargetSet
TaxLevelChanged
TeleportNetworkPanelOpened
TextInputChanged
TextInputFocusLost_
ToggleNotifications
ToggleableSlotActiveChangedtrue
ToggleableSlotUpdatetrue
TreeCreated
TrespassWarningIssued
TriggerSelectNextSpawnZone
TriggerSelectPreviousSpawnZone
UIColourChanged
UiMainThemeReverted
UiRootSizeChanged
UiScaleChanged
UiSkinChanged
UiTextScaleSettingChanged
UnitAbilityActivationCancelled
UnitAbilityEffectAdded
UnitAbilityEffectRemoved
UnitAbilityIntensityChanged
UnitAbilityPurchased
UnitAddedToUItrue
UnitAddedToUIAny
UnitAllegianceChangedtrue
UnitAllegianceChangedAny
UnitBannerChanged
UnitBehaviourChangedtrue
UnitDisbanded
UnitEffectPurchased
UnitExperienceGain
UnitOrderDispatchedtrue
UnitPortholeCameraSettingsReloaded
UnitRemovedFromUItrue
UnitRemovedFromUIAny
UnitTransformedtrue
UnitUpgradeGroupUiInfoReloaded
UnitUpgraded
UnitsCustomBattlePermissionsReloaded
UnitsCustomBattleTypesReloaded
UpdateAugmentsList
UpdateHexStates
UpgradeTrainUnitsRequested
UpgradeUnitsRequested
VampireMercenaryPoolUpdated
WaaaghDropDownUpdated
WarCoordinationStateChanged
WarCoordinationTargetSet
WindsOfMagicGamblerVisibilityChanged
WindsOfMagicStrengthChanged
battle_purchasable
building_available_event
commandment_available
negative_pooled_resource_event
negative_pooled_resource_event_
selection_changed_
siege_construction_available_event