UI Symbols Documentation

Contexts


Campaign

CcoCampaignAncillary

Component context wrapper for a campaign ancillary

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanCharacterEquipBoolCcoCampaignCharacterReturns true if specified character can equip this 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
NameUniStringVoidReturns localised name of ancillary
RemoveAncillaryVoidVoidRemoves itself from the character that it's equipped to.
SalvageVoidCcoCampaignFaction (optional)Salvages the ancillary.
IconPathStringVoidReturns icon path for images
CharacterEquippedToContextCcoCampaignCharacterVoidReturns the player character context where this ancillary is equipped, if any.
EquipToCharacterVoidCcoCampaignCharacter, CcoCampaignAncillaryEquips itself to the specified character, and swaps with the ancillary passed in if this exists.
EffectListCcoEffect (list)VoidReturns a list of CcoEffect given by this ancillary when equipped, prefiltered to not show those that shouldnt appear in ui
FuseForPlayerVoidCcoCampaignAncillaryFuses with the specified ancillary for the players faction (if possible)
EffectUnfilteredListCcoEffect (list)VoidReturns a list of CcoEffect given by this ancillary when equipped, includes those not shown in uihide_in_uied
AncillaryRecordContextCcoAncillaryRecordVoidReturns the ancillary record context.
ProvidedBodyguardsContextListVoidReturns list of CcoMainUnitRecord that are provided as bodyguards as a result of ancillary being equipped
CanFuseBoolCcoCampaignAncillaryReturns true if can fuse with the specified ancillary
TypeIconPathStringVoidReturns the icon path for the ancillary type
MarkAsSeenVoidVoidMarks the equipment as seen so that HasSeen will return false
EffectTextUniStringVoidReturns localised effect text from record
ColourTextUniStringVoidReturns localised colour 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.

CcoCampaignBattle

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsQuestBattleBoolVoidReturns true if current battle is a quest battle
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)

CcoCampaignCharacter

Component context wrapper for a campaign character

Functions

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

CcoCampaignCharacterSkill

Component context wrapper for a campaign character skill

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectUnfilteredListCcoEffect (list)VoidReturns a list of CcoEffect that we are currently providing, including those filtered out usually to not show in uihide_in_uied
ParentSkillsListContextListVoidReturns list of CcoCampaignCharacterSkill which are parent links to us (we are unlocked by)
TierIntVoidReturns the y grid position
ChildSkillsListContextListVoidReturns list of CcoCampaignCharacterSkill which are child links to us (unlocked by us)
StatusStringVoidReturns the status of the skill as an unlocalised string (available, complete, locked, etc)
ImagePathStringVoidReturns the image path for the skill
NameUniStringVoidReturns the localised name of the skill
DescriptionUniStringVoidReturns the localised description of the skill
KeyStringVoidReturns the campaign skill record key
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
CharacterContextCcoCampaignCharacterVoidReturns the owning CcoCampaignCharacter for this skill
SpawningUnitAndRankPairListCcoPair (list)VoidReturns a pair with units and their ranks, that characters with this skill will spawn with
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
CurrentLevelContextCcoCampaignCharacterSkillLevelDetailsVoidReturns the current CcoCampaignCharacterSkillLevelDetails active
UnitAttributeListContextListVoidReturns a list of CcoUnitAttributeRecord that we are currently providing
LevelsDetailsListContextListVoidReturns the list of CcoCampaignCharacterSkillLevelDetails for each level of this skill
AddPointVoidVoidAdds a point into skill. Effects not applied until committed via character
RemovePointVoidVoidRemoves a point from skill. Effects not applied until committed via character
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)
CanRemovePointBoolVoidReturns true if can remove a point (added a point but didnt commit the skill choices)
IndentIntVoidReturns the x grid position
LevelIntVoidReturns the current level of the skill
EffectListCcoEffect (list)VoidReturns a list of CcoEffect that we are currently providing, prefiltered to not show those that shouldnt appear in ui

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

CcoCampaignEventFeed

Context wrapper for the event feed

Functions

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

CcoCampaignFaction

Wrapper for a campaign faction

Functions

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

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
ReverseInteractionContextCcoCampaignFactionInteractionVoidReturns the interaction the opposite way around (so can see requests in opposite direction, etc)
DevAddFavourPointsVoidIntAdd favour points for dev functionality, can be positive or negativedebug, hide_in_uied
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
IsValidTargetBoolContextReturns true if supplied context is a valid war coordination target (CcoCampaignMilitaryForce or CcoCampaignSettlement)
WarCoordinationPendingRequestsListCcoCampaignWarCoordinationRequest (list)VoidAdd favour points for dev functionality, can be positive or negative
ZoomToTargetVoidVoidZooms the camera to the current war coordination target
IsTargettingActiveBoolVoidReturns true if targetting mode is currently active
LoanMilitaryForceVoidCcoCampaignMilitaryForceLoans the specified force of the target faction to the source faction
FavourPointsCostForTargetIntContextReturns the favour point cost to set a particular war coordination target (CcoCampaignMilitaryForce or CcoCampaignSettlement)
FavourPointsCostToLoanMilitaryForceIntCcoCampaignMilitaryForceReturns the favour point cost to loan the specified force from the target to the source faction
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)
CanLoanMilitaryForceBoolCcoCampaignMilitaryForceReturns true if the specified force of the target faction can be loaned to the source faction
IsWarCoordinationAvailableBoolVoidReturns true if the source and target faction have war coordination available (military allies)
MilitaryForcesToLoanListCcoCampaignMilitaryForce (list)VoidReturns a list of military forces available to loan from target faction to source faction
SharedEnemyListCcoCampaignFaction (list)VoidReturns a list of enemies common to both the source and target faction who can target with war coordination
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)
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)
FavourPointsIntVoidHow many favour points have to spend between factions to pay for actions such as war coordination or requesting armies
IsWarTargettingAllowedBoolVoidReturns true if can ever use war targetting (only disabled between human players at the minute)
SourceFactionContextCcoCampaignFactionVoidThe source faction (usually player)
OpenWarCoordinationPanelVoidString (optional)Opens up the war coordination panel, pass a specific tab key to select that section otherwise defaults to first available
SetTargetVoidContextSelects a war coordination target (CcoCampaignMilitaryForce or CcoCampaignSettlement)
TargetFactionContextCcoCampaignFactionVoidThe target faction interacting with
CurrentTargetRequestContextCcoCampaignWarCoordinationRequestVoidReturns the CcoCampaignWarCoordinationRequest requested from the target faction to the source faction (for war coordinations requests from AI, the request accepted from WarCoordinationPendingRequestsList basically)
ClearTargetVoidVoidClears the curent war coordination target
ToggleTargettingVoidVoidToggles targetting mode on/off to pick a target

CcoCampaignMilitaryForce

Component context wrapper for a campaign military force

Functions

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

CcoCampaignMission

Component context wrapper for a CAMPAIGN_MISSION

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MoviePathStringVoidReturns the file path to the movie for 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
ImagePathStringVoidReturns the file path to the image for this mission
IsCancelledBoolVoidReturns whether the mission is cancelled
CompletedBoolVoidReturns whether the mission is completed
CancelMissionVoidVoidCancels this mission
IsObjectivePanelOpenBoolVoidReturns whether the objective panel is open
HasZoomLocationBoolVoidReturns whether the mission has a zoom location
ZoomToLocationVoidVoidZooms the camera to the location of this mission
TargetCharacterContextCcoCampaignCharacterVoidReturns the target character if any (if character part of objectives like to kill character)
ShowObjectivePanelVoidVoidShows the mission panel
BattleSetPieceArmyListCcoBattleSetPieceArmyRecord (list)VoidReturns a list with the armies in the battle piece setup
BattleSetupInfoContextCcoBattleSetupInfoVoidReturns the battle setup info context for this mission
ShowMissionPanelVoidVoidShows the mission panel with this mission selected
TeleportCharacterVoidVoidTeleports the selected character or character associated with this mission to the quest battle for this mission
QuestCharacterContextCcoCampaignCharacterVoidReturns the quest character context if this mission is a quest battle
IsPrologueStoryMissionBoolVoidReturns true if this is a story line mission for prologue, we show some special fx on events related to these
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
MissionDefinitionContextCcoCampaignMissionDefinitionVoidReturns the mission definition context for this mission
CanBeCancelledBoolVoidReturns true if the mission can be cancelled
MissionIssuerContextCcoMissionIssuerRecordVoidReturns the mission issuer context for this mission
CompletionStatusIntVoidReturns the completion status. 0 Active, 1 Succeeded, 2 Cancelled, 3 Expired
TurnsRemainingIntVoidReturns the number of turns remaining for this mission
ShouldShowTeleportButtonBoolVoidReturns whether to show the teleport button for this mission
IsTeleportEnabledBoolVoidReturns whether teleport is enabled for this mission
QuestBattleWinChanceFloatVoidReturns the chance of winning the quest battle associated with 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
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
ActionTypeStringVoidReturns UNlocalised name of current pending action
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
OwningFactionContextCcoCampaignFactionVoidReturns owning faction who has main responsibility of resolving this action

CcoCampaignPooledResource

Wrapper for a campaign pooled resource

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
InitialMaxIntVoidReturns the maximum value specified in the record, so that we can display the original value even after getting changed by effects
OwningFactionContextCcoCampaignFactionVoidReturns the faction that owns this context if any
NegativeFactorTotalIntVoidReturns the total of all the current negative factors
PercentageToNextEffectFloatExpressionState, String (optional)Returns the percentage of the way to the next effect
SortOrderIntVoidReturns the sort order for this pooled resource (for when have multiple linked pooled resources like corruption)
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
PositivePendingFactorListCcoStringValue (list)VoidReturns a list of the pending factors that can be positive (but aren't necessarily currently)
MinIntVoidReturns the minimum value
MaxIntVoidReturns the maximum value
NegativePendingFactorListCcoStringValue (list)VoidReturns a list of the pending factors that can be negative (but aren't necessarily currently)
MilitaryForceBreakdownContextCcoCampaignPooledResourceMilitaryForceBreakdownCcoCampaignMilitaryForceReturns the breakdown context for this pooled resource on the specified military force
AchievementThresholdSetListCcoPooledResourceThresholdOperationSetRecord (list)VoidReturns a list of thresholds that can be unlocked with achievements
TotalLessThanZeroAndNotCertainResourcesBoolExpressionStateReturns true if this pooled resource has a negative total and isnt specific hardcoded resources (sigh, added in wh2)
PendingFactorListCcoStringValue (list)VoidReturns the list of pending factors that will be added to the value in the next turn
ProvinceBreakdownContextCcoCampaignPooledResourceProvinceBreakdownCcoCampaignProvinceReturns the breakdown context for this pooled resource on the specified province
ShouldDisplayZeroFactorsBoolVoidReturns true if the resource should always display zero factors
IconPathStringVoidReturns the icon filepath
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
IsPersistentResourceBoolVoidReturns true if this pooled resource has persistant factors (as in they arent evaluated per turn and instead stockpile)
NegativeFactorListCcoStringValue (list)VoidReturns a list of the factors that can be negative (but aren't necessarily currently)
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
NextGroupPooledResourceEffectContextCcoGroupPooledResourceEffectRecordExpressionState, String (optional)Returns the next CcoGroupPooledResourceEffectRecord. Optionally can specify an effect type, defaults to percentage of capacity effect type
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)
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
NegativeFactorsNameUniStringVoidReturns the localised name given for the negative factors
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
CurrentGroupPooledResourceEffectContextCcoGroupPooledResourceEffectRecordExpressionState, String (optional)Returns the current CcoGroupPooledResourceEffectRecord. Optionally can specify an effect type, defaults to percentage of capacity effect type
DescriptionUniStringVoidReturns the localised description
PendingFactorTotalIntVoidReturns the total of the pending factor list
PositiveFactorsNameUniStringVoidReturns the localised name given for the positive factors
PredictedPercentageOfCapacityFloatVoidReturns the prediced percentage value of max on the next turn
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
PendingFactorsNameUniStringVoidReturns the localised name given for the pending factors
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
NameUniStringVoidReturns the localised name
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)

CcoCampaignProvince

Wrapper for a campaign province.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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.
CapitalSettlementContextCcoCampaignSettlementVoidReturns the context of the capital settlement of 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.
IsPlayerInvolvedBoolVoidReturns true if the player faction own any regions in this province.
IsPlayerCompleteOwnerBoolVoidReturns true if player owns all the settlements in the province
IncomeIntVoidReturns the income that this province generates
ZoomToVoidVoidZooms to capital of province
SelectAndZoomVoidVoidSelects and zooms to a settlement in this order: player capital, player owned settlement, province capital.
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
IsSelectedBoolVoidReturns true if any settlement in this province is selected.
MercenaryPoolContextCcoCampaignProvinceMercenaryPoolVoidReturns the context of mercenary pool of this province
NameUniStringVoidReturns the localised name of the province.
DevAddDevPointVoidVoidDev command that adds development points to this province.debug, hide_in_uied
WindsOfMagicAreaContextCcoCampaignWindsOfMagicAreaVoidReturns the context of the winds of magic area in this province.
SettlementListContextListVoidReturns the settlement list in the province.

CcoCampaignRoot

Functions

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

CcoCampaignSettlement

Wrapper for a campaign settlement.

Functions

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

CcoCampaignTechnology

Component context wrapper for a campaign technology

Functions

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

CcoCampaignUnit

Component context wrapper for a campaign unit

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UpgradeVoidCcoUnitPurchasableEffectRecordUpgrades the unit with the supplied CcoUnitPurchasableEffectRecord
AllianceColourColourVoidReturns the alliance colour of this unit (usually same as factions colour, but if we have an origin faction it will use that colour)
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)
DevLevelUpVoidIntLevels up or down a unit by given number of levelsdebug, hide_in_uied
UniqueUiIdStringVoidReturns unique string identifier for this unit
RenameVoidVoidBrings up a prompt to rename the unit to give it a custom name
CharacterContextCcoCampaignCharacterVoidReturns the CcoCampaignCharacter if any (for agents/generals)
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
AlliedOriginFactionContextCcoCampaignFactionVoidReturns the allied origin faction of this unit (if this unit has been recruited through allied recruitment)
IsCharacterBoolVoidReturns true if this unit is for a character (general or agent)
UpgradeUnitVoidCcoMainUnitRecordUpgrades the unit to the supplied CcoMainUnitRecord
CostIntVoidReturns the recruitment cost of this unit (one off payment when first recruit)
PurchasedEffectsListCcoUnitPurchasableEffectRecord (list)VoidReturns a list of CcoUnitPurchasableEffectRecord that this unit have purchased
UnitDetailsContextCcoUnitDetailsExpressionStateReturns the CcoUnitDetails for this unit (used on unit info panel which shows unit info from various sources)
MilitaryForceContextCcoCampaignMilitaryForceVoidReturns the owning CcoCampaignMilitaryForce
UpkeepCostIntVoidReturns the upkeep cost of this unit (how much pay each turn)
HaveAccessToPurchasableEffectBoolCcoUnitPurchasableEffectRecordReturns true if unit have access to the supplied CcoUnitPurchasableEffectRecord
ExperienceLevelIntVoidReturns the current experience level of the unit (0-9)
PurchasableEffectsCostListCcoCampaignUnitPurchasableEffectCost (list)VoidReturns a list of CcoCampaignUnitPurchasableEffectCost that this unit can use
NumEntitiesIntVoidReturns the current number of entities
AbilityListContextListVoidReturns the list of CcoUnitAbility that this unit can use in battle
PurchasableEffectCostContextCcoCampaignUnitPurchasableEffectCostCcoUnitPurchasableEffectRecordReturns the CcoCampaignUnitPurchasableEffectCost for a supplied CcoUnitPurchasableEffectRecord
UnitRecordContextCcoMainUnitRecordVoidReturns the CcoMainUnitRecord
NumEntitiesInitialIntVoidReturns the max number of entities this unit can have
UpgradeUnavailableTextUniStringCcoUnitPurchasableEffectRecordReturns the reason why the unit cannot upgrade using the supplied CcoUnitPurchasableEffectRecord
HealthValueIntVoidReturns the raw health value (hitpoints)
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)
IsExperienceKnownBoolVoidReturns true if player knows enough about army to know how experience (might not be close enough to army, etc)
AttritionPercentFloatVoidReturns how much attrition will take in the next turn (how much health will lose) (0-1)
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)
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
HealthPercentFloatVoidReturns the current health as a percentage (0-1)

Record

CcoAbilityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ViewInDbVoidVoid
OnScreenDescriptionVoidVoid
RecordListVoidVoid
AbilityVoidVoid
OnScreenNameVoidVoid
KeyVoidVoid

CcoActionResultRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
ActorEffectBundleVoidVoid
TargetEffectBundleTurnsVoidVoid
RecordListVoidVoid
TargetEffectBundleVoidVoid
ActorEffectBundleTurnsVoidVoid

CcoAdviceLevelRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AdvisorNameVoidVoid
RecordListVoidVoid
TextVoidVoid
InfoTextVoidVoid
SubCategoryVoidVoid
TitleVoidVoid
AdviceThreadVoidVoid
CategoryVoidVoid
KeyVoidVoid

CcoAgentActionRecord

Functions

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

CcoAgentCultureDetailRecord

Functions

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

CcoAgentRecord

Record wrapper for an AGENT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
UnlockedByPooledResourceSetListCcoPooledResourceThresholdOperationSetRecord (list)CcoCampaignFactionReturns a list of UnlockedByPooledResourceSetList that will unlock this agent, if any
SortOrderIntVoidReturns the sort order for the agent record
RecordListCcoAgentRecord (list)VoidReturns a list of all agent records in the table
InEncyclopediaBoolVoidReturns true if the agent has an encyclopedia entry
EncyclopediaUrlStringVoidReturns the encyclopedia url of the agent
PortraitOverrideStringVoidReturns the portait override path
FactionCapIntVoidReturns how many agents of this type a faction can have
PlayableBoolVoidReturns true if the agent is playable

CcoAgentSubtypeRecord

Record wrapper for agent_subtypr_record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OnscreenNameOverrideUniStringVoidReturns the name override for this agent subtype if any
OnscreenNameOverrideKeyStringVoidReturns a string with the name override key
KeyStringVoidReturns the key of the record
AutoGenerateBoolVoidReturns true if this agent subtype can be auto generated
AgentSubtypeAgentPairContextCcoAgentSubtypeAgentPairCcoAgentRecordReturns the pair of this agent subtype and the agent record passed in
UniqueAgentContextCcoAgentRecordVoidIf this subtype is an unique agent, returns the agent record of it
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
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
CanBeLoadedInCampaignBoolVoidReturns true if this subtype can be loaded in campaign
SmallIconStringVoidReturns the small image path of this agent subtype
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

CcoAncillariesCategoryRecord

Record wrapper for an ancillaries_category_record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
RecordListCcoAncillariesCategoryRecord (list)VoidReturns a list with all entries from the ancillaries_category_table
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
SortOrderIntVoidReturns an int with the category sort order
DefaultEntryNameUniStringVoidReturns a localised default name, for when no ancillary of this category is equipped

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
IncludedAgentsListCcoAgentRecord (list)VoidReturns a list with the agents that can equip this ancillary
FrameStateStringVoidReturns a string with the state name that should be set on the frame based on the ancillary category
GrantedTextUniStringVoidReturns a string showing the message to use when an ancillary is granted by tech etc.
IncludedAgentSubtypesListCcoAgentSubtypeRecord (list)VoidReturns a list with agent subtypes that can equip this ancillary
CanBeDestroyedBoolVoidReturns true if this ancillary can be destroyed
IconStateStringVoidReturns a string with the state name that should be set on the icon based on the ancillary category
MinExpiryAgeIntVoidReturns the minimum expiry age
AncillarySetContextCcoAncillarySetRecordVoidReturns the context of the ancillary set that this belongs to
IconPathStringVoidReturns the icon path of the ancillary
MaxExpiryAgeIntVoidReturns the maximum expiry age
RarityStateStringVoidReturns a string with the rarity state of the ancillary category
ExplanationTextUniStringVoidReturns a string explaining the reason why this ancillary was dropped
UniquenessRecordContextCcoAncillaryUniquenessGroupingRecordVoidReturns the context of the uniqueness group where this fits, based on its uniqueness score.
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
MinStartingAgeIntVoidReturns the minimum starting age for this ancillary
EffectUnfilteredListCcoEffect (list)VoidReturns a list of effects from this ancillary record, includes those not shown in uihide_in_uied
OnscreenNameUniStringVoidReturns the localised name of the ancillary
MaxStartingAgeIntVoidReturns the maximum starting age for this 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
EndDateIntVoidReturns an int with the end date of the ancillary
EffectTextUniStringVoidReturns localised text for the ancillary effects
SubcategoryContextCcoAncillariesSubcategoryRecordVoidReturns the context of the ancillary sub category
RecordListCcoAncillaryRecord (list)VoidReturns a list with all ancillaries in the table
ColourTextUniStringVoidReturns localised description for the ancillary
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
UniquenessScoreIntVoidReturns the uniqueness score of this ancillary
StartDateIntVoidReturns an int with the start 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
ImmortalBoolVoidReturns true if this ancillary is immortal
UniqueToFactionBoolVoidReturns true if this ancillary is unique factionwide
ProvidedBodyguardUnitContextCcoMainUnitRecordVoidReturns the context of the provided bodyguard context, usually used for mounts
TypeContextCcoAncillaryTypeRecordVoidReturns the context of the type record associated with this ancillary
IncludedSubculturesListCcoSubcultureRecord (list)VoidReturns a list of subcultures that can use this ancillary
OwningCharacterContextCcoCampaignCharacterCcoCampaignFaction (optional)Returns the CcoCampaignCharacter that owns this ancillary. Searches in the players faction, or the optionally provided CcoCampaignFaction
TransferrableBoolVoidReturns true if this ancillary can be transferred between characters
IsWifeAncillaryBoolVoidReturns true if this is a wife ancillary

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
MinIntVoidReturns an int with the lower bound of this group
MaxIntVoidReturns an int with the upper bound of this group
ColourColourVoidReturns the colour of this uniqueness group
UiStateStringVoidReturns the ui state for this group
KeyStringVoidReturns the key of the record
IsFusableBoolVoidReturns true if this items in this group can be fused
RecordListCcoAncillaryUniquenessGroupingRecord (list)VoidReturns a list with all uniqueness groups in the table

CcoArmoryItemRecord

Record wrapper for armory item record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectListCcoEffect (list)VoidReturns a list with the effects provided by this item
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)
VariantContextCcoArmoryItemVariantRecordStringReturns the context of the variant with the key passed in
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
SlotTypeContextCcoArmorySlotTypeRecordVoidReturns the context of the slot type record
DefaultVariantContextCcoArmoryItemVariantRecordVoidReturns the context of the default variant for this item
NameUniStringVoidReturns the localised name of the armory item record.
DescriptionUniStringVoidReturns the localised description of the record.
AchievementUnlockScoreIntVoidReturns the score needed to unlock this item through achievements
ItemTypeContextCcoArmoryItemUiTypeRecordVoidReturns the type context of the armory item
IsLockedByAchievementBoolVoidReturns true if this item is currently locked by an achievement
KeyStringVoidReturns the key of the record.
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
MarkAsSeenVoidVoidMarks the equipment as seen so that HasSeen will return false
DefaultItemSetCcoArmoryItemSetRecordVoidReturns the first set that has effects (each item should only have max 1 set with effects, rest are used for custom battle)

CcoArmoryItemSetRecord

Wrapper for a ARMORY_ITEM_SET_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ItemListCcoArmoryItemRecord (list)VoidReturns all the armory items that are part of this set
RecordListCcoArmoryItemSetRecord (list)VoidReturns a list with all item sets in the table
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
KeyStringVoidReturns a string with the key of the record
NameUniStringVoidReturns the localised name of the item 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
UseAsDefaultBoolVoidReturns a bool that specifies whether this variant is used as the default
RecordListCcoArmoryItemVariantRecord (list)VoidReturns a list with all armory item variants in the database table.
DescriptionUniStringVoidReturns the description of this variant
ArmoryItemContextCcoArmoryItemRecordVoidReturns the context of the armory item associated with this item variant
ImagePathStringVoidReturns the image path of this variant
NameUniStringVoidReturns the localised name of the item variant
KeyStringVoidReturns a string with the key of this record

CcoArmorySlotTypeRecord

Wrapper for an armory slot type record.

Functions

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

CcoArmySpecialAbilityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EnablesSiegeAssaultVoidVoid
UnitSpecialAbilityContextVoidVoid
ArmySpecialAbilityKeyVoidVoid
UniqueIDVoidVoid

CcoBannerRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PermittedUnitSetsVoidVoid
RecordListVoidVoid
BannerVoidVoid
CombatPotentialAdjustmentsVoidVoid
EffectBundleRecordVoidVoid

CcoBattleClimateWeatherDescriptionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SpottingScalarVoidVoid
RecordListVoidVoid
HeatFatigueVoidVoid
ColdFatigueVoidVoid
ProbabilityVoidVoid
WeatherRecordContextVoidVoid
SeasonRecordContextVoidVoid
ClimateRecordContextVoidVoid

CcoBattleCurrencyArmySpecialAbilitiesCostValueRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BattleSecondaryCurrencyTypeContextVoidVoid
CostValueVoidVoid
ArmySpecialAbilityContextVoidVoid

CcoBattleCurrencyUnitAbilitiesCostValueRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ItemTypeContextVoidVoid
CostValueVoidVoid
CurrencyTypeContextVoidVoid
RecordListVoidVoid

CcoBattleEntityRecord

Functions

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

CcoBattlePurchasableGroupRecord

Wrapper for a battle purchasable group record

Functions

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

CcoBattlePurchasableItemsJunctionRecord

Wrapper for a Battle Purchasable Items Junction record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
RecordListForCategoryCcoBattlePurchasableUnitAbility (list)String(CategoryKey) Get the list of CcoBattlePurchasableUnitAbility's in the specified category
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
PlayableAreaHeightVoidVoid
KeyVoidVoid
MatchmakingVoidVoid
AuthorVoidVoid
CatchmentNameVoidVoid
UserCreatedVoidVoid
HasKeyBuildingsVoidVoid
IntroMovieVoidVoid
YearVoidVoid
DefenderFundsRatioVoidVoid
MultiplayerVoidVoid
SingleplayerVoidVoid
RecordListVoidVoid
DescriptionVoidVoid
StartBattleVoidVoid
ReleaseMapVoidVoid
MapVoidVoid
EnvironmentPathVoidVoid
NameVoidVoid
EnvironmentAudioTypeVoidVoid
IsNavalVoidVoid
IsLargeSettlementVoidVoid
SpecificationVoidVoid
ScreenshotVoidVoid
Has15mWallsVoidVoid
TypeVoidVoid
PlayableAreaWidthVoidVoid
TypeStringVoidVoid

CcoBattleResultTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitXpGainVoidVoid
ResultScreenNameVoidVoid
BattleResultTypeVoidVoid
RecordListVoidVoid
ResultDescriptionVoidVoid

CcoBattleSecondaryCurrencySourceTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsAllianceBasedVoidVoid
UiLocalisedNameVoidVoid
RecordListVoidVoid
DescriptionVoidVoid
SourceTypeVoidVoid

CcoBattleSecondaryCurrencyTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UiIconPathVoidVoid
RecordListVoidVoid
CurrencyTypeVoidVoid
UiLocalisedNameVoidVoid

CcoBattleSetPieceArmiesCharacterRecord

Functions

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

CcoBattleSetPieceArmiesCharactersItemRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NameVoidVoid
CharacterItemContextVoidVoid
RecordListVoidVoid

CcoBattleSetPieceArmiesCharactersSkillRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LevelVoidVoid
RecordListVoidVoid
CharacterNameVoidVoid
SkillContextVoidVoid

CcoBattleSetPieceArmiesUnitRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
PercentageNumMenVoidVoid
UnitRecordContextVoidVoid
UnitLevelVoidVoid

CcoBattleSetPieceArmyRecord

Functions

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

CcoBattleSetPieceFrontendGroupRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BattleListVoidVoid
RecordListVoidVoid
CampaignMapContextVoidVoid
CharacterListVoidVoid
KeyVoidVoid
SortOrderVoidVoid

CcoBattleSetPieceFrontendGroupsToCharacterRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FrontendGroupContextVoidVoid
RecordListVoidVoid
CharacterContextVoidVoid

CcoBattleSetPieceRecord

Wrapper for a BATTLE_SET_PIECE_RECORD

Functions

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

CcoBattleTypeCheatSheetEntryRecord

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
DescriptionTextUniStringVoid
PriorityIndexIntVoidSpecifies the priority which this item will be listed in the current column. Lower = Higher up the list
IconPathStringVoid
HeaderTextUniStringVoid
KeyStringVoid

CcoBattleTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MaxTeamsizeVoidVoid
DescriptionVoidVoid
AttackerVictoryConditionsListVoidVoid
DefenderVictoryConditionsListVoidVoid
DefenderFundsRatioVoidVoid
NameVoidVoid
ListOrderVoidVoid
KeyVoidVoid
RecordListVoidVoid

CcoBattleVortexRecord

Wrapper for a BATTLE_VORTEX_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyStringVoidReturns the db key for this record
IsMagicalBoolVoidReturns true if the vortex deals magical damage
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)
IgnitionAmountFloatVoidReturns the ignition amount of the vortex
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
ChangeMaxAngleIntVoidReturn the max angle change of the vortex
DamageIntVoidReturns the damage per second per entity hit of the vortex
RecordListCcoBattleVortexRecord (list)VoidReturns a list of all battle vortex records
AffectsAlliesBoolVoidReturns true if the vortex also affects allied units
IsCircleBoolVoidReturns whether this vortex shape is Circle
ContactEffectPhaseContextCcoSpecialAbilityPhaseRecordVoidReturns the contact effect context for this battle vortex record (nullptr if not set)
DelayBetweenVortexesFloatVoidReturns the delay between creating additional vortexes

CcoBattleWeatherTypeRecord

Functions

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

CcoBattlefieldEngineRecord

Wrapper for a BATTLEFIELD_ENGINE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanBeDismantledBoolVoid
RecordListCcoBattlefieldEngineRecord (list)Void
MissileWeaponContextCcoMissileWeaponRecordVoid
BattleEntityContextCcoBattleEntityRecordVoid
KeyStringVoid

CcoBattlefieldSiegeVehicleRecord

Wrapper for BATTLEFIELD_SIEGE_VEHICLE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ImagePathStringVoidReturns the image path
SiegeVehicleEntityContextCcoBattleEntityRecordVoidReturns the entity record context
VehicleCategoryStringVoidReturns vehicle category (battering ram, siege tower, etc)
HitPointsIntVoidReturns the hit points (health) of equipment
KeyStringVoidReturns unique key for db record
IgnitionThresholdIntVoidReturns the threshold of fire damage will take before catching fire
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
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
NameUniStringVoidReturns the localised name
DescriptionUniStringVoidReturns the localised description

CcoBattlefieldSiegeVehiclesCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProbabilityVoidVoid
RecordListVoidVoid
VehicleContextVoidVoid
CapVoidVoid

CcoBuildingChainRecord

Wrapper for a building chain record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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.
TechnologyCategoryStringVoidReturns a string with the building chain category type.
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.
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.
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.

CcoBuildingCultureVariantRecord

Functions

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

CcoBuildingLevelRecord

Record wrapper for a BUILDING_LEVEL_RECORD

Functions

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

CcoBuildingSetRecord

Record wrapper for a BUILDING_SET_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
SortOrderIntVoidReturns an int with the sort order
ColourColourVoidReturns a Pixel8888 with the colour of the set
AudioSwitchStringVoidReturns the audio switch for the building set
OnscreenDescriptionUniStringVoidReturns the localised description of the building set
IconStringVoidReturns the icon path of the building set
NameUniStringVoidReturns the localised name of the set
KeyStringVoidReturns the key of the record

CcoBuildingSuperchainRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
RecordListVoidVoid
ChainListVoidVoid
ChainsForProvinceListVoidVoid

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
RecordListVoidVoid
IsUniqueSettlementVoidVoid
CampaignMapContextVoidVoid
ScreenshotPathVoidVoid
OnscreenNameVoidVoid
TileUpgradeVoidVoid
DescriptionVoidVoid
KeyVoidVoid
CoordXVoidVoid
CoordYVoidVoid
BattleTypeVoidVoid

CcoCampaignDecisionChoiceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DecisionRecordContextVoidVoid
TitleVoidVoid
LabelVoidVoid
IndexVoidVoid
RecordListVoidVoid
PayloadCharacterTraitListVoidVoid

CcoCampaignDecisionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionVoidVoid
RecordListVoidVoid
ImageVoidVoid
KeyVoidVoid
TitleVoidVoid
ChoiceListVoidVoid

CcoCampaignEffectListRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectsVoidVoid
RecordListVoidVoid
KeyVoidVoid

CcoCampaignEffectScopeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
LocalisedTextVoidVoid
RecordListVoidVoid

CcoCampaignFactionCheatSheetEntryRecord

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

Functions

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

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
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
RadarImagePathStringVoidReturns the radar image for map preview
CampaignKeyStringVoidReturns key for campaign map
FrontendImagePathStringVoidReturns image to use in frontend campaign select screen
MoviePathStringVoidReturns movie to use for frontend campaign select screen
OwnershipProductRecordListCcoOwnershipProductRecord (list)VoidReturns the list of CcoOwnershipProductRecord required to be owned for this campaign
KeyStringVoidReturns unique key of record

CcoCampaignMapWindsOfMagicAreaRecord

Functions

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

CcoCampaignMapWindsOfMagicStrengthRecord

Functions

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

CcoCampaignOperationSetRecord

Wrapper for a CAMPAIGN_OPERATION_SET_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AgentListCcoAgentRecord (list)VoidReturns a list of agents that will get unlocked by the effects in this set
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

CcoCampaignPayloadRecord

Wrapper for a CAMPAIGN_PAYLOAD_RECORD

Functions

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

CcoCampaignPayloadResourceTransactionRecord

Wrapper for a CAMPAIGN_PAYLOAD_RESOURCE_TRANSACTION_RECORD

Functions

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

CcoCampaignPayloadUnitComponentRecord

Wrapper for a CAMPAIGN_PAYLOAD_UNIT_COMPONENT_RECORD

Functions

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

CcoCampaignStormTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RespectExcludedRegionsTableVoidVoid
RecordListVoidVoid
KeyVoidVoid
ForSeaVoidVoid
CanSpawnOverCharacterVoidVoid
CanMoveVoidVoid
ForLandVoidVoid
CanDecayVoidVoid

CcoCampaignStreakEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OnScreenNameVoidVoid
KeyVoidVoid
MaxVoidVoid
MinVoidVoid
EffectUnfilteredListVoidVoid
CampaignStreakKeyVoidVoid
EffectListVoidVoid
RecordListVoidVoid

CcoCampaignStreakRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
ResetTurnsVoidVoid
MinVoidVoid
KeyVoidVoid
TypeVoidVoid
MaxVoidVoid
StreakEffectListVoidVoid

CcoCampaignVideoRecord

Functions

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

CcoCapturePointCategoryTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
LocalisedNameVoidVoid
IconPathVoidVoid
KeyVoidVoid

CcoCapturePointTypeRecord

A DB record wrapper for a battle capture point type

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
RecordListCcoCapturePointTypeRecord (list)Void
IconNameStringVoidReturns a string path of this capture point types' icon
KeyStringVoidReturns the DB primary key for this capture point type

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
CategoryKeyVoidVoid
OnScreenNameVoidVoid
TypeVoidVoid

CcoCdirEventsDilemmaChoiceDetailRecord

Record wrapper for a CDIR_EVENTS_DILEMMA_CHOICE_DETAIL_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
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
LocalisedChoiceTitleUniStringVoidReturns a localised title for the choice
TreasureHuntImageListCcoString (list)CcoTreasureHuntExtraInformationRecordReturns a list with all treasure hunt symbols for the this choice, given the treasure hunt info passed in
DilemmaKeyStringVoidReturns the key of the dilemma that this choice is part of
LocalisedChoiceLabelUniStringVoidReturns a localised label for the choice
RecordKeyStringVoidReturns the key of the record
ChoiceKeyStringVoidReturns the key of the choice

CcoCharacterAncillaryQuestUiDetailRecord

Record wrapper for character ancillary quest details

Functions

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

CcoCharacterSkillRecord

Wrapper for a character skill record.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsFemaleOnlyBackgroundSkillBoolVoidReturns true if this is a female only background skill
IsMaleOnlyBackgroundSkillBoolVoidReturns true if this is a male 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
DefaultLocalisedNameUniStringVoidReturns the default localised name of the skill
EffectListForLevelCcoEffect (list)IntReturns a list of CcoEffect with all default effects for the level passed in
KeyStringVoidReturns the key of the record
DefaultImagePathStringVoidReturns the default image path of the skill
RecordListCcoCharacterSkillRecord (list)VoidReturns a list with all skills in the database

CcoCharacterTrainingDilemmaChoiceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IndexVoidVoid
RecordListVoidVoid
DilemmaRecordContextVoidVoid
ChoiceEffectRecordVoidVoid
KeyVoidVoid
LocalisedLabelVoidVoid

CcoCharacterTrainingDilemmaRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ChoiceListVoidVoid
KeyVoidVoid
LocalisedTitleVoidVoid
LocalisedDescriptionVoidVoid
TrainingEffectTypeVoidVoid
RecordListVoidVoid

CcoCharacterTraitLevelRecord

Functions

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

CcoCharacterTraitRecord

Functions

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

CcoClimateRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid

CcoCookingIngredientGroupRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
FlavourTextVoidVoid
KeyVoidVoid
IngredientsVoidVoid
ColourVoidVoid
DisplayNameVoidVoid
IconVoidVoid

CcoCookingIngredientRecord

Functions

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

CcoCookingRecipeRecord

Functions

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

CcoCorruptionCounterIntervalRecord

Wrapper for a CORRUPTION_COUNTER_INTERVAL_RECORD

Functions

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

CcoCorruptionTypeRecord

Wrapper for a CORRUPTION_TYPE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CorruptionColourColourVoidReturn the colour of the corruption record
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
NameUniStringVoidReturn the localised name for the corruption type for display in the UI
KeyStringVoidReturn the unique key for the record

CcoCultureRecord

Wrapper for a culture record

Functions

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

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
TitleUniStringVoidReturns the record's title
DescriptionUniStringVoidReturns the record's description
ContainsFactionBoolCcoFactionRecordReturns true if the faction set of this record contains the passed in faction
RecordListCcoDaemonAbilityBarDescriptionRecord (list)VoidReturns a list of all Daemon ability bar description records
KeyStringVoidReturns the record's key

CcoDeployableRecord

Functions

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

CcoDeployablesCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProbabilityVoidVoid
RecordListVoidVoid
DeployableContextVoidVoid
CapVoidVoid

CcoDilemmaRecord

Record wrapper for a DILEMMA_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
UiImageStringVoidReturns the ui image of the dilemma
KeyStringVoidReturns the db key of the dilemma
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

CcoDiplomaticStanceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
StatusStateVoidVoid
OnscreenTextVoidVoid
StanceVoidVoid
RecordListVoidVoid
KeyVoidVoid

CcoElectorCountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitRewardContextVoidVoid
RecordListVoidVoid
MapPosVoidVoid
AncillaryRewardContextVoidVoid
MinisterialPositionEffectBundleVoidVoid
MapPosXVoidVoid
MapPosYVoidVoid
CapitalRegionContextVoidVoid

CcoEndTurnNotificationRecord

Functions

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

CcoFactionRecord

Wrapper for a faction record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
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
FlagPathLargeStringVoidReturns the path to the large version of the faction's flag
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
NameUniStringVoidReturns the faction's localised name
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

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
DescriptionVoidVoid
TooltipVoidVoid
OrderVoidVoid
IsArmyVoidVoid
IsNavalVoidVoid
NameVoidVoid
FormationVoidVoid
IconNameVoidVoid
RecordListVoidVoid

CcoFrontendFactionLeaderRecord

Functions

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

CcoGroundTypeRecord

Functions

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

CcoGroundTypeToStatEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectTextWithValueVoidVoid
RecordListVoidVoid
IsPositiveVoidVoid
EffectTextVoidVoid
ValueForDisplayVoidVoid
AffectedGroupNameVoidVoid
GroundTypeVoidVoid
ValueVoidVoid

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

CcoIncidentRecord

Wrapper for an incident record

Functions

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

CcoInitiativeRecord

Record wrapper for a INITIATIVE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DurationIntVoidReturns the duration of the initiative
ImagePathStringVoidReturns the image path of the initiative
NameUniStringVoidReturns the localised name of the initiative
DescriptionUniStringVoidReturns the localised description of the initiative
KeyStringVoidReturns the key of the initiative
LinkedAgentSubtypeListCcoAgentSubtypeRecord (list)VoidReturns a list of agent subtypes that are linked to this initiative
RecordListCcoInitiativeRecord (list)VoidReturns a list of all initiatives from the database
EffectUnfilteredListCcoEffect (list)VoidReturns a list of all the effects provided when active
PayloadRecordListCcoCampaignPayloadRecord (list)VoidReturns a list of payloads for the initiative
UpkeepResourceTransactionContextCcoCampaignResourceTransactionVoidReturns the upkeep of the resources used while the initiative is active
EffectListCcoEffect (list)VoidReturns a list of the effects with priority higher than 0, that are 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

CcoInitiativeSetCategoryRecord

Wrapper for a INITIATIVE_SET_CATEGORY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoInitiativeSetCategoryRecord (list)Void
DisplayNameUniStringVoid
KeyStringVoid

CcoInitiativeSetRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CategoryContextVoidVoid
KeyVoidVoid
ItemsVoidVoid
ActiveInitiativeLimitVoidVoid
RecordListVoidVoid
ActivationCooldownVoidVoid

CcoLabSettingRecord

Wrapper for a LAB_SETTING_RECORD

Functions

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

CcoLandUnitArticulatedVehicleRecord

Wrapper for a LAND_UNIT_ARTICULATED_VEHICLE_RECORD

Functions

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

CcoLandUnitsToExtraEngineRecord

Wrapper for a LAND_UNITS_TO_EXTRA_ENGINE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BattleEngineContextCcoBattlefieldEngineRecordVoid
AttachArticulationIntVoid
RecordListCcoLandUnitsToExtraEngineRecord (list)Void
LandUnitContextCcoUnitLandRecordVoid

CcoLoadingScreenQuotesRecord

Record wrapper for a loading screen quote record

Functions

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

CcoMainUnitRecord

Wrapper for a main unit

Functions

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

CcoMeleeWeaponRecord

Functions

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

CcoMercenaryRecruitmentInfoRecord

Record wrapper for a mercenary recruitment info record

Functions

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

CcoMissileWeaponRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProjectileContextListVoidVoid
KeyVoidVoid
UseSecondaryAmmoPoolVoidVoid
RecordListVoidVoid
PrecursorVoidVoid

CcoMissionIssuerRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NameVoidVoid
RecordListVoidVoid
DefaultRoundsBetweenVoidVoid
IconPathVoidVoid
KeyVoidVoid

CcoMissionRecord

Functions

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

CcoMortuaryCultCategoryRecord

Wrapper for a MORTUARY_CULT_CATEGORY_RECORD

Functions

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

CcoMountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
EntityVoidVoid
RecordListVoidVoid

CcoMountableArtilleryUnitsCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactionContextVoidVoid
UnitRecordContextVoidVoid
CapVoidVoid
RecordListVoidVoid
ProbabilityVoidVoid

CcoMultiplayerCampaignSettingRecord

Wrapper for a MULTIPLAYER_CAMPAIGN_SETTING_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoMultiplayerCampaignSettingRecord (list)VoidReturn a context list of all mp campaign settings, sorted in the right order
LocalisedTooltipUniStringVoidReturns localised tooltip for the setting
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

CcoMultiplayerCampaignSettingsOptionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OrderVoidVoid
ValueVoidVoid
MultiplayerCampaignSettingContextVoidVoid
LocalisedNameVoidVoid
TooltipVoidVoid
RecordListVoidVoid

CcoNarrativeViewerEntryRecord

Wrapper for a NARRATIVE_VIEWER_ENTRY_RECORD

Functions

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

CcoNarrativeViewerTabRecord

Wrapper for a NARRATIVE_VIEWER_TAB_RECORD

Functions

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

CcoNewContentPatchNoteRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OrderVoidVoid
RecordListVoidVoid
LocalisedPatchNoteVoidVoid
KeyVoidVoid

CcoOwnershipProductRecord

Wrapper for a OWNERSHIP_PRODUCT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SteamAppIdIntVoidReturns the product id linked to a store front for this product
RecordListCcoOwnershipProductRecord (list)VoidReturns list of all product records
IsOwnedBoolVoidReturns true if this product is currently owned and installed (so accessible basically)
OpenStoreVoidVoidOpens up a store page for the product (like in steam overlay)
IsFlcBoolVoidReturns true if this product is free
IsTwaBoolVoidReturns true if this product is free as part of Total War Access
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
KeyStringVoidReturns the unique key for this record

CcoPlagueEffectList

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactionSetListCcoFactionSetRecord (list)VoidReturns a list of faction sets that the effects apply to
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)
TargetTypeListCcoString (list)VoidReturns a list of valid targets in string form

CcoPlagueEffectRecord

Wrapper for a PLAGUE_EFFECT_RECORD

Functions

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

CcoPlagueRecord

Wrapper for a PLAGUE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoPlagueRecord (list)VoidReturns a list with all plague records in the table
SortOrderIntVoidReturns the lifetime of the plague
ImagePathStringVoidReturns the image path of the plague
KeyStringVoidReturns the key of the plague record
LifetimeIntVoidReturns 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
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
RecordListCcoPooledResourceThresholdOperationSetRecord (list)VoidReturns a list with all records in the table

CcoProjectileBombardmentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
NumProjectilesVoidVoid
ProjectileContextVoidVoid
RecordListVoidVoid
RadiusSpreadVoidVoid

CcoProjectileRecord

Cco wrapper for querying a projectile record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
IconPathStringVoidReturns a path for the associated icon for this projectile
TotalProjectilesPerReloadIntVoid
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
BurstSizeIntVoid
NameUniStringVoidReturns a string for the onscreen name of the projectile
TooltipUniStringVoidReturns a string of the associated tooltip text for this projectile
ShotsPerVolleyIntVoid
KeyStringVoid
IsFlamingBoolVoidReturns whether the projectile inflicts flaming damage
NumProjectilesIntVoidThe number of projectiles associated with this projectile record
ShotTypeKeyStringVoid
OverheadPhaseContextCcoSpecialAbilityPhaseRecordVoidGets the CcoSpecialAbilityPhaseRecord for the effect of the projectile flying overhead
RecordListCcoProjectileRecord (list)Void
IsMagicalBoolVoidReturns whether the projectile inflicts magical damage
CanDamageBuildingsBoolVoid

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
LocalisedNameVoidVoid
EffectBundleContextVoidVoid
EffectBundleContextForCurrentProvinceVoidVoid
RecordListVoidVoid
OrderVoidVoid
IconPathVoidVoid
StatusForCurrentProvinceVoidVoid
KeyVoidVoid

CcoRegionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OwnerBundleContextVoidVoid
FactionSwappingIdVoidVoid
RecordListVoidVoid
BattleNameKeyVoidVoid
RegionGroupsVoidVoid
OnscreenNameKeyVoidVoid
PaletteRgbVoidVoid
KeyVoidVoid

CcoReignOfChaosRecord

Wrapper for a REIGN_OF_CHAOS_RECORD

Functions

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

CcoResourceCostRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RequiredAncillariesListVoidVoid
PooledResourceCostsListVoidVoid
RecordListVoidVoid
ExpenditureTypeVoidVoid
RequiredTradeResourcesListVoidVoid
TreasuryCostVoidVoid
IncomeTypeVoidVoid
IdVoidVoid

CcoResourceRecord

Functions

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

CcoRitualCategoryGroupRecord

Wrapper for a RITUAL_CATEGORY_GROUP_RECORD

Functions

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

CcoRitualCategoryRecord

Wrapper for a RITUAL_CATEGORY_RECORD

Functions

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

CcoRitualChainRecord

Wrapper for a RITUAL_CHAIN_RECORD

Functions

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

CcoRitualPayloadAncillaryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AncillaryContextVoidVoid
RecordListVoidVoid
PayloadVoidVoid

CcoRitualPayloadChangeAgentCapacityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PayloadContextVoidVoid
CapacityVoidVoid
AgentRecordContextVoidVoid
RecordListVoidVoid

CcoRitualPayloadChangeUnitCapacityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PayloadContextVoidVoid
UnitRecordContextVoidVoid
CapacityVoidVoid

CcoRitualPayloadDiplomaticAttitudeChangeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PayloadVoidVoid
AttitudeDeltaVoidVoid

CcoRitualPayloadRecord

Wrapper for a ritual payload record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ResourceTransactionsListCcoResourceCostRecord (list)VoidReturns a list of resource transactions that this payload will apply
AgentSpawnsListCcoRitualPayloadSpawnAgentRecord (list)VoidReturns a list of agents that the payload will spawn
ArmySpawnsListCcoRitualPayloadSpawnArmyRecord (list)VoidReturns a list of armies that the payload will spawn
DiplomaticAttitudeChangeContextCcoRitualPayloadDiplomaticAttitudeChangeRecordVoidReturns a CcoRitualPayloadDiplomaticAttitudeChangeRecord with the diplomatic attitude that this payload will change
CampaignPayloadContextCcoCampaignPayloadRecordVoidReturns the campaign payload that will activate with this ritual payload, if valid
ConfederatedFactionsListCcoCampaignFaction (list)VoidReturns a list with factions that will be confederated by this payload
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
UnitCapUnitListCcoRitualPayloadChangeUnitCapacityRecord (list)VoidReturns a list with unit caps affected by this payload
AgentCapListCcoRitualPayloadChangeAgentCapacityRecord (list)VoidReturns a list with agent caps affected by this payload
KeyStringVoidReturns the key of the payload record
RecordListCcoRitualPayloadRecord (list)VoidReturns a list with all payload records in the database
ArmyTeleportListCcoRitualPayloadTeleportArmyRecord (list)VoidReturns a list of CcoRitualPayloadTeleportArmyRecord
EffectBundleListCcoEffectBundle (list)VoidReturns a list of effect bundles that this payload will provide
EffectBundleAndDurationPairListCcoPair (list)VoidReturns a list of effect bundles and their duration that this payload will provide
AncillariesListCcoRitualPayloadAncillaryRecord (list)VoidReturns a list of ancillaries that this payload will provide
StormSpawnsListCcoRitualPayloadSpawnStormRecord (list)VoidReturns a list of storms that this payload will spawn
MercenarySpawnsListCcoRitualPayloadSpawnMercenaryRecord (list)VoidReturns a list of mercenaries that the payload will spawn

CcoRitualPayloadSpawnAgentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SpawnToPoolVoidVoid
RecordListVoidVoid
PayloadVoidVoid
AgentTypeContextVoidVoid
AgentSubtypeContextVoidVoid

CcoRitualPayloadSpawnArmyRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PayloadVoidVoid
RecordListVoidVoid
FactionOverrideContextVoidVoid
SpawnAtRitualSiteVoidVoid
SpawnableForceContextVoidVoid
IdVoidVoid

CcoRitualPayloadSpawnMercenaryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
SpawnableUnitContextVoidVoid
IdVoidVoid
PayloadVoidVoid

CcoRitualPayloadSpawnStormRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RegionContextVoidVoid
MaxTurnsDurationVoidVoid
StormTypeContextVoidVoid
PayloadVoidVoid
StrengthVoidVoid
RecordListVoidVoid

CcoRitualPayloadTeleportArmyRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PayloadContextVoidVoid
RegionContextVoidVoid
RecordListVoidVoid

CcoRitualPayloadTriggerDilemmaRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PayloadVoidVoid
DilemmaContextVoidVoid

CcoRitualRecord

Record wrapper for a RITUAL_RECORD

Functions

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

CcoSeasonRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
OnscreenVoidVoid
RecordListVoidVoid

CcoSettlementClimateTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UiDescriptionVoidVoid
RecordListVoidVoid
UiBackgroundImageVoidVoid
UiNameVoidVoid
TypeVoidVoid
UiIconImageVoidVoid

CcoSpawnableForceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitListsListVoidVoid
RecordListVoidVoid
KeyVoidVoid
UnitsListVoidVoid

CcoSpawnableForceUnitJunctionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MaxAmountVoidVoid
SpawnableForceVoidVoid
UnitContextVoidVoid
MinXpVoidVoid
RecordListVoidVoid
MaxXpVoidVoid
MinAmountVoidVoid
IdVoidVoid

CcoSpawnableForceUnitListJunctionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MinXpVoidVoid
RecordListVoidVoid
MaxXpVoidVoid
MinAmountVoidVoid
UnitListContextVoidVoid
IdVoidVoid
MaxAmountVoidVoid
SpawnableForceVoidVoid

CcoSpecialAbilityGroupRecord

Wrapper for a SPECIAL_ABILITY_GROUP_RECORD record from special_ability_groups_tables

Functions

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

CcoSpecialAbilityIntensitySettingRecord

Wrapper for a SPECIAL_ABILITY_INTENSITY_SETTING_RECORD

Functions

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

CcoSpecialAbilityPhaseRecord

Wrapper for a SPECIAL_ABILITY_PHASE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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))
SpreadRangeIntVoidReturns the range the effect can spread like a contagion if this is set to a non-zero value
HasManaMaxDepletionModBoolVoidReturns true if this depletes mana
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)
HasEffectsBoolVoidReturns true if this phase has effects
ManaRegenModFloatVoidReturns the modifier to mana regeneration
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)
HasUnitAttributesBoolVoidReturns true if this phase provides unit attributes
EffectTypeStringVoidReturns string for positive, negative or both
DamageIntVoidReturns the calculated overall damage amount
HasDamageAmountBoolVoidReturns true if this phase deals damage
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
MoraleChangeIntVoidReturns the modifier to morale
ImbueContactContextCcoSpecialAbilityPhaseRecordVoidReturns the CcoSpecialAbilityPhaseRecord for the effect imbued to the target
HasHealAmountBoolVoidReturns true if this phase heals
HasBarrierHealAmountBoolVoidReturns true if this phase heals barrier
KeyStringVoidReturns the db key of the phase record
HpChangeFrequencyIntVoidReturns how often applys HealPercent to target
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%)
HasAbilityRechargeChangeBoolVoidReturns true if this phase affects recharge
DurationIntVoidReturns the duration in seconds that this phase lasts
AdditionalUiEffectListCcoUnitAbilitiesAdditionalUiEffectRecord (list)VoidReturns the additional ui effect list of this phase
EffectListCcoEffect (list)ExpressionState, Float (optional)Returns a list of CcoEffect so can see effects of phase
HealPercentFloatVoidPercentage of targets max HP will heal for each HpChangeFrequency (0-1), (so if phase lasts 10 seconds and HpChangeFrequency is 2, then will heal this amount 5 times)
IsHiddenInUiBoolVoidReturns true if this phase should NOT be displayed in the UI
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
PhaseEffectFlagListCcoStringValue (list)VoidReturns a list of CcoStringValues for the phase effect flags (special case things like freeze fatigue)
ResurrectBoolVoidReturns true if this resurrects a unit
InspirationAuraRangeModFloatVoidReturns the modifier applies to inspiration aura of a unit
ImbueMagicalBoolVoidReturns true if this imbues a units attack with magic attack bonuses
ImbueIgnitionBoolVoidReturns true if this imbues a units attack with flaming attack bonuses
AbilityPhaseEffectsListCcoSpecialAbilityPhaseStatEffectRecord (list)VoidReturns a list of CcoSpecialAbilityPhaseStatEffectRecord so know what stats affected by phase
AbilityRechargeChangeFloatVoidReturns the modifier applied to recharge times of abilities
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))
IntensityFloatExpressionStateReturns the ability intensity value
FatigueChangeRatioFloatVoidReturns the multiplier applies to fatigue (for freezing fatigue or tiring a unit out)
RemovesAttributeBoolCcoUnitAttributeRecordReturns true if this phase removes provided unit attribute, e.g. removes causes fear attribute on Whip of Agony
ManaMaxDepletionModFloatVoidReturns the modifier to the maxa max depletion

CcoSpecialAbilityPhaseStatEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
StatVoidVoid
HowVoidVoid
PhaseVoidVoid
ValueVoidVoid

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)
ConfederationScreenNameUniStringVoid
ConfederationSummaryNameUniStringVoid
IndexIntVoid
NameUniStringVoid
KeyStringVoid
CultureCcoCultureRecordVoid
RecordListCcoSubcultureRecord (list)Void
BattlePlaystyleDescriptionUniStringVoid

CcoTechnologyRecord

Record wrapper for a technology record

Functions

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

CcoTechnologyUiGroupRecord

Record wrapper for technology ui group record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RightMostTechnologyCcoCampaignTechnologyCcoCampaignFaction (optional)Returns the context of the right-most technology for this group
TopMostTechnologyCcoCampaignTechnologyCcoCampaignFaction (optional)Returns the context of the top-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
ColourColourVoidReturns the colour of the 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
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

CcoTechnologyUiTabRecord

Wrapper for a TECHNOLOGY_UI_TAB_RECORD

Functions

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

CcoTeleportationNetworkNodeRecord

Wrapper for a TELEPORTATION_NETWORK_NODE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectListCcoEffect (list)VoidReturns a list with the effects the node provides, will be an empty list if the node is closed
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
HandleDoubleClickVoidVoidHandles a double click event
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
KeyStringVoidReturns the key of the record
RecordListCcoTeleportationNetworkNodeRecord (list)VoidReturns a list with all records in the database

CcoTeleportationNodeTemplateRecord

Wrapper for a TELEPORTATION_NODE_TEMPLATE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
ShouldDisplayTimerBoolVoidReturns true if the teleportation nodes using this template display timer
NameUniStringVoidReturns the localised name of the template
DescriptionUniStringVoidReturns the localised description of the template
KeyStringVoidReturns the key of the record
IconPathStringVoidReturns the image path of the template

CcoTimeOfLegendsCampaignRecord

Wrapper for a TIME_OF_LEGENDS_CAMPAIGN_RECORD

Functions

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

CcoTreasureHuntExtraInformationRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
Option1ImageVoidVoid
Option4ImageVoidVoid
ColourBlindModeOverlayVoidVoid
OverlayImageVoidVoid
Option2ImageVoidVoid
Option3ImageVoidVoid
KeyVoidVoid

CcoUiColourRecord

Functions

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

CcoUiMainThemeOptionRecord

Wrapper for a UI_MAIN_THEME_OPTION_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
MainThemeStringVoidReturns the key of the main theme record
ColourColourVoidReturns the colour for the main theme
MainThemeNameUniStringVoidReturns the display name for the main theme

CcoUiPurchasableEffectsToHexIdRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TierVoidVoid
RecordListVoidVoid
HexIdVoidVoid
CategoryVoidVoid
UnitPurchasableEffectContextVoidVoid

CcoUiUnitGroupParentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GroupListVoidVoid
RecordListVoidVoid
MpCapVoidVoid
UnitListVoidVoid
IconVoidVoid
KeyVoidVoid
OrderVoidVoid
OnscreenNameVoidVoid

CcoUiUnitGroupingRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
TooltipVoidVoid
OnscreenVoidVoid
ParentGroupVoidVoid
RecordListVoidVoid
IconVoidVoid

CcoUiUnitStatusRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
PriorityVoidVoid
TooltipVoidVoid
IconPathVoidVoid
RecordListVoidVoid

CcoUnitAbilitiesAdditionalUiEffectRecord

Wrapper for a UNIT_ABILITIES_ADDITIONAL_UI_EFFECT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LocalisedTextUniStringVoid
EffectStateStringVoid
RecordListCcoUnitAbilitiesAdditionalUiEffectRecord (list)Void
KeyStringVoid
SortOrderIntVoid

CcoUnitAbilityRecord

Functions

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

CcoUnitAttributeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
BulletTextVoidVoid
IconPathVoidVoid
ImuedEffectTextVoidVoid
RemovesEffectTextVoidVoid
KeyVoidVoid

CcoUnitLandRecord

Wrapper for a UNIT_LAND_RECORD

Functions

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

CcoUnitListRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
UnitsListVoidVoid

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
CostContextVoidVoid
RecordListVoidVoid
EffectBundleContextVoidVoid
CategoryContextVoidVoid
ResourceCostVoidVoid
ResourceNameVoidVoid
ResourceIconVoidVoid
KeyVoidVoid

CcoUnitPurchasableEffectsCategoryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconPathVoidVoid
KeyVoidVoid
RecordListVoidVoid
OnscreenNameVoidVoid
OnscreenDescriptionVoidVoid

CcoUnitSetRecord

Wrapper for a UNIT_SET_RECORD

Functions

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

CcoUnitSetToMpUnitCapRecord

Wrapper for a UNIT_SET_TO_MP_UNIT_CAP_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUnitSetToMpUnitCapRecord (list)Void
LocalisedNameUniStringVoid
CapIntVoid

CcoUnitSpecialAbilityRecord

Functions

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

CcoUnitsCustomBattleMountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LocalisedDescriptionVoidVoid
MountedUnitContextVoidVoid
MountNameVoidVoid
BaseUnitContextVoidVoid
CostVoidVoid
RecordListVoidVoid
IconNameVoidVoid

CcoUnitsCustomBattlePermissionRecord

Functions

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

CcoUnitsCustomBattleTypeCategoryRecord

Wrapper for a UNITS_CUSTOM_BATTLE_TYPE_CATEGORY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CategoryNameUniStringVoid
RecordListCcoUnitsCustomBattleTypeCategoryRecord (list)Void
CategoryKeyStringVoid
IsHorizontalGroupBoolVoid
CategoryDescriptionUniStringVoid

CcoUnitsCustomBattleTypeRecord

Wrapper for a UNITS_CUSTOM_BATTLE_TYPE_RECORD

Functions

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

CcoVictoryConditionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid

CcoVideoRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
PlayVideoVoidVoid
RecordListVoidVoid

Common

CcoAgentSubtypeAgentPair

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AgentContextCcoAgentRecordVoid
UnitDetailsContextCcoUnitDetailsVoid
AgentSubtypeContextCcoAgentSubtypeRecordVoid

CcoBattleResult

Wrapper for a battle result

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsDrawBoolVoid
ResultTypeRecordContextCcoBattleResultTypeRecordVoid
OtherResultAllianceContextCcoBattleResultAllianceVoid
IsLocalPlayerWinnerBoolVoid
DurationUniStringVoid
LocalResultPlayerAllianceContextCcoBattleResultAllianceVoid

CcoBattleResultUnit

Wrapper for a battle result unit

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
DamageDealtIntVoidDamage dealt by 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
NameUniStringVoidLocalised name of the unit
UnitRecordContextCcoMainUnitRecordVoidReturns a CcoMainUnitRecord context for the unit
NumKillsIntVoidNumber of kills the unit got in the result
ImagePathStringExpressionStatePath to the unit card image for the unit
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

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
SelectedObjectListContextListVoidReturns the list of selected context objects
FirstObjectContextVoidReturns the first selected context object
MouseOverContextContextVoidReturns the context currently mousing over if we have one
SelectionParentContextCcoComponentVoidReturns the CcoComponent that has the selection parent that is sending us

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

CcoMultiplayerRoot

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

Functions

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

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
StringValueStringVoidReturns the string value of this script value
IdStringVoidReturns the unique key of this script object
SetStringValueVoidExpressionState, StringSets the string value of the script object from the context system (instead of via script)
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
NumericValueFloatVoidReturns the numeric value of this script value

CcoScriptObjectList

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

Functions

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

CcoScriptTableNode

A wrapper for of a Lua Table, recursive type

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasValueForKeyBoolString, BoolReturns if there's a value for the key in the table value of the current node, can recurse through children.
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
ParentContextContextVoidReturns the parent slot context linking from
ChildContextContextVoidReturns the child slot context linking to

CcoTreeLinkWithContexts

Functions

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

CcoUnitAbility

Wrapper for a BATTLE_SETUP_SPECIAL_ABILITY

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BombardmentRecordContextCcoProjectileBombardmentRecordVoidReturns the bombardment record context for this ability
ValidUsageDescriptionUniStringExpressionStateReturns the unit ability's valid usage description
CastRangeFloatVoidReturns the cast range of the unit ability
IsHiddenInUIBoolVoidReturns whether this unit ability is hidden in the UI
TypeNameUniStringBool (optional)Returns the type name of the ability
WindUpTimeIntVoidReturns the duration of time between triggering the unit ability and it actually being performed
ShouldShowTimingDetailsBoolVoidReturns whether the timing details should be shown for this unit ability
TypeDescriptionUniStringVoidReturns the unit ability's type description
MaxAffectedAllyCountIntVoidReturns maximum number of allies might be affected by this ability
NameUniStringVoidReturns the name of the unit ability
ActiveTimeIntVoidReturns the duration of time that the unit ability is active
HasInvalidTargetFlagsBoolVoidReturns whether the unit ability has invalid target flags
TooltipTextUniStringVoidReturns the unit ability's tooltip
RechargeTimeIntVoidReturns the duration of time the unit ability takes to recharge
HasEnabledIfFlagsBoolVoidReturns whether the unit ability has enabled if flags
SourceTypeNameUniStringVoidReturns the source type name of this unit ability
SharedRechargeTimeIntVoidReturns the duration of shared time the unit ability takes to recharge when any other ability with shared cooldown is used
ManaUsedIntVoidReturns the amount of mana used by this unit ability
UpdatesEveryFrameBoolVoidReturns whether the unit ability updates every frame
IconPathStringVoidReturns the file path to the unit ability's icon
OpenSpellBrowserVoidCcoMainUnitRecord (optional)Opens the spell browser entry for this unit ability. Can supply an optional unit to open its page
TypeIconStringVoidReturns the unit ability's type icon file path
HasInvalidUsageFlagsBoolVoidReturns whether the unit ability has invalid usage flags
SpreadRangeIntVoidReturns how far this ability can spread (for hex abilities like contagion)
HasSharedRechargeTimerBoolVoidReturns true if the ability has a shared cooldown
AffectsEnemyBoolVoidReturns whether enemy units are affected by this ability
TargetRangeIntVoidReturns the maximum range of a target an ability can be used on
AffectsAlliesBoolVoidReturns whether allied units are affected by this ability
HasMirrorBehaviourBoolVoidReturns true if the ability has mirror behaviour associated with it
RecordKeyStringVoidReturns the unit ability's record key
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
AdditionalUiEffectListCcoUnitAbilitiesAdditionalUiEffectRecord (list)VoidReturns the additional ui effect list of this unit ability
MinimumRangeIntVoidReturns the minimum range to use the ability
EffectRangeIntVoidReturns the effect range of the ability
HasAdditionalUiEffectsBoolVoidReturns whether additional ui effects are present for this unit ability
IsTargetedAbilityBoolVoidReturns whether this unit ability is targetted
AffectsOnlyFriendlyBoolVoidReturns whether additional ui effects are present for this unit ability
PhaseChannelListCcoPair (list)VoidReturns a list of CcoPair>; each channels name with the phases within that channel
TimingDetailsTextUniStringVoidReturns the timing details text for this unit ability
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
MiscastChanceFloatVoidReturns the chance that this unit ability will miscast
VortexRecordContextCcoBattleVortexRecordVoidReturns the vortex record context for this ability
ValidTargetDescriptionUniStringExpressionStateReturns the unit ability's valid target description
AffectsOnlyEnemyBoolVoidReturns whether additional ui effects are present for this unit ability
ProjectileRecordContextCcoProjectileRecordVoidReturns the unit ability's projectile record context
EnabledIfDescriptionUniStringExpressionStateReturns the unit ability's enabled if description
AbilityGroupContextCcoSpecialAbilityGroupRecordVoidReturns the ability group context for this ability
UniquenessRecordContextCcoAncillaryUniquenessGroupingRecordVoidReturns the uniqueness record context for this ability
TargetTypeUniStringVoidReturns the unit ability's target type
MaxAffectedEnemyCountIntVoidReturns maximum number of enemies might be affected by this 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
BarrierHpPercentFloatVoidReturns the current hp percent of the barrier attached to this unit
ExperienceEffectListCcoStringValue (list)VoidReturns the list of experience effects for this unit
ShowCostBoolVoidReturns whether cost should be shown
KillCountIntVoidReturns the number of kills caused by this unit in a battle
UpkeepCostIntVoidReturns the upkeep cost of this unit
FoodCostIntVoidReturns the number of kills caused by this unit in a battle
HarmonyStateStringVoidReturns the state of the unit harmony(yin/yang) or empty if the unit doesn't have a harmony effect
MassFloatVoidReturns the mass of the unit
BarrierMaxHpIntVoidReturns the max hp of the barrier attached to this unit
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
HealthTooltipUniStringVoidReturns the health bar tooltip
HealthBarColourColourVoidReturns the colour of the alliance this unit belongs tobattle
ExperienceRequiredForNextLevelIntVoidReturns the required experience to rank up
CharacterContextCcoCampaignCharacterVoidReturns the CcoCampaignCharacter of this unit
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
IsBretonnianPeasantBoolVoidReturns whether the unit is a bretonnian peasant.
IsLargeEntityBoolVoidReturns whether the unit is a large entity
AgentSubtypeAgentPairContextCcoAgentSubtypeAgentPairVoidReturns the CcoAgentSubtypeAgentPair of this unit
UnitRecordContextCcoMainUnitRecordVoidReturns the CcoUnitRecord of this unit
ExperienceScoreIntVoidReturns the current experience of this unit
IsKnownXpBoolVoidReturns whether the unit xp known to the player
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
SetupUnitContextCcoBattleSetupUnitVoidReturns the CcoBattleSetupUnit
IsBattleBoolVoidReturns true if we're in battle
HitPointsInitialIntVoidReturns the number of initial hit points of this unit
HitPointsPercentFloatVoidReturns the hit point percentage left
BattleUnitContextCcoBattleUnitVoidReturns the CcoBattleUnit for this unit, if we're in battlebattle
IsSpellBrowserBoolExpressionStateReturns true if the spell browser is open
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
ShowFoodCostBoolVoidReturns whether cost should be shown
BulletPointListCcoUnitBulletPoint (list)VoidReturns the bullet point list
IsCampaignBoolVoidReturns true if we're in campaign
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
AbilityIconListContextListVoidReturns the list of abilities attached to this unit
HasExperienceBoolVoidReturns whether the unit has experience
BarrierHpIntVoidReturns the current hp of the barrier attached to this unit

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
FormatNumberCustomUniStringFloat, FloatReturns a formatted number using ICU library.string
FormatUniStringExpressionState, UniString, ArgumentPackFormat the given string based on the argument liststring
StringSubStringStringString, Int, Int (optional)Returns a substring between the given start position and optional lengthstring, deprecated
IsStringEmptyBoolStringReturns true if the string is emptystring, deprecated
FormatNumberUniStringFloatReturns a formatted number using ICU library.string
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
IsStringEmptyBoolUniStringReturns true if the string is emptystring, deprecated
ToUpperUniStringExpressionState, UniStringConvert string to an uppercase stringstring, deprecated
StringStartsWithBoolExpressionState, UniString, UniStringReturns true if the first string starts with the second stringstring, deprecated
ParseTextReplacementsUniStringExpressionState, UniStringReturns a string that has had text replacements parsed (any text replacement tags will be replaced with actual text)string, deprecated
ParseFactionTextReplacementUniStringExpressionState, UniString, CcoFactionRecordReturns parsed text replacement tags in the given string and uses the faction record to retrieve the correct stringstring
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
StringLengthIntStringReturns the length of the given stringstring, deprecated

debug

NameReturn TypeArgumentsDescriptionTagsEvents
RunCLIMultiplayerVoidStringSsame as RunCLI but if mp campaign runs the command on all players games at the same timedebug
RunCLIVoidStringRuns console command supplied, but not in final release to avoid calling commands not meant todebug
BreakpointArgumentPackExpressionState, Expression, Expression (optional)Used to wrap an expression and will break in debugger before evaluationdebug
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
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

prefs

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

deprecated

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

context

NameReturn TypeArgumentsDescriptionTagsEvents
GenerateContextListExpressionState, Int, Expression (optional)Returns a list with the given context repeated N amount of times.context
StoredContextFromParentRequiredContextExpressionState, StringReturns the stored context of specified type from the specified parent, and will assert on failurecontext
JoinContextListExpressionState, ArgumentPackReturns a context list of all the contexts of the functions passed as argumentscontext
StoredContextFromParentContextExpressionState, StringReturns the stored context of specified type from the specified parentcontext
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
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
IsContextValidBoolContextReturns true if specified context is not nullcontext
IsValidContextBoolExpressionStateReturns true if we currently have a root context that isnt empty (our context has been set)context
IsCurrentContextBoolContext, ExpressionStateReturns true if supplied context is the top context on the stack (for things like when iterating through a list to check the current iterator basically)context
StoreListCcoContextListContextList, StringStores a context list with an id so you can easily retrieve itcontext

Misc

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

sound

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

math

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

registry

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

flow

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

convert

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

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
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
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
OwnedCultureListCcoCultureRecord (list)VoidReturns a list of CcoCultureRecord for this campaign that the player owns
VictoryDescriptionTextUniStringVoidReturns the localised victory description of the campaign which describes how to obtain victory

CcoCustomBattleLobby

Wrapper for the custom battle lobby

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsLocalPlayerSpectatingBoolVoidReturns true if the local player is currently spectating
IsLocalPlayerReadyBoolVoidReturns true if the local player is ready to play
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)
TeamListCcoCustomBattleTeam (list)VoidReturns list of CcoCustomBattleTeam that are active in lobby
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
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
NumberOfPlayersIntVoidReturns the number of active players in the lobby
ToggleFactionLockReadyVoidVoidToggles ready-for-faction-lock status of player
IsUsingSmallCardsBoolVoidReturns true if should use small card format (based on resolution)
ReadyButtonTextUniStringVoidReturns ready button text
IsFactionSelectionCountdownPhaseBoolVoidReturns whether the current phase is faction selection (ready button locks in faction rather than starts game)
LocalBalanceOfPowerPercentFloatVoidReturns a simulate autoresolve balance of power based on armies in the lobby
IsReadyCountdownActiveBoolVoidReturns true if the ready countdown is active (active once all players readied up)
DefaultSelectedPlayerSlotContextCcoCustomBattlePlayerSlotVoidReturns the default CcoCustomBattlePlayerSlot to select when entering lobby (default army shown)
ReadyStatusTextUniStringVoidReturns the text used on tooltip for ready button (to show ready errors)
CanAddSpectatorSlotBoolVoidReturns true if can currently add a spectator slot
ReadyButtonStateStringExpressionStateReturns the current state to set on the ready button for local player
CanInviteBoolVoidReturns true if can currently invite a player to the lobby
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
HostSlotContextCcoCustomBattlePlayerSlotVoidReturns the host players CcoCustomBattlePlayerSlot
IsLocalPlayerFactionLockedBoolVoidReturns true if the player can no longer change their faction
AutoresolveBattleResultsContextCcoBattleResultVoidReturns the CcoBattleResult for an autoresolve simulation of units armies currently in the lobbydebug, hide_in_uied
IsLocalPlayerHostBoolVoidReturns true if the local player is currently the host
SettingsContextCcoCustomBattleSettingsVoidReturns the CcoCustomBattleSettings context that handles settings for lobby

CcoCustomBattleMap

Wrapper for a custom map

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ClickgenClimateContextCcoClimateRecordVoidReturns the climate 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
BattleRecordContextCcoBattleRecordVoidReturns the battle context for the map
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
ClickgenRegionNameUniStringVoidReturns the clickgen region name
ClickgenProvinceNameUniStringVoidReturns the clickgen province name
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

CcoCustomBattlePlayerSlot

Functions

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

CcoCustomBattleSettings

Wrapper for the settings of custom battles

Functions

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

CcoCustomBattleTeam

Wrapper for the custom battle team

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AddPlayerSlotVoidExpressionStateAdds an open player slot to this team for a player to join
AddAIBotVoidVoidAdds an AI slot to this team
CanAddAIBoolVoidReturns true if can add an AI slot to this team
IsAttackerBoolVoidReturns true if this is the attacking team
CanAddPlayerSlotBoolVoidReturns true if can add a player slot to this team
TeamIndexIntVoidReturns the numeric index of this team (team id)
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

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

CcoLobbyBase

Functions

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

CcoMPCampaignLobby

Functions

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

CcoMPCampaignMap

Wrapper for a playable map in multiplayer campaigns

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ImagePathStringVoidReturns the image path to be used on selectable entries
MapImagePathStringVoidReturns the map image path to be used on map displays
MaxPlayersIntVoidReturns the max number of players that can play in this campaign
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
CampaignMapRecordContextCcoCampaignMapPlayableAreaRecordVoidReturns the CcoCampaignMapPlayableAreaRecord for this map

CcoMPCampaignSettings

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsAllianceOnlyVoidVoid
GetCurrentOptionForSettingVoidVoid
CanChangeSettingVoidVoid
GetOptionsForSettingVoidVoid
ToggleAllianceOnlyVoidVoid
SetOptionForSettingVoidVoid
ToggleOptionForSettingVoidVoid
ShouldShowAllianceOnlySettingVoidVoid

Misc

CcoAbilityCollection

Wrapper for an AbilityCollection for nested abilities

Functions

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

CcoAdvisor

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ClearHistoryVoidVoid
AdviceHistoryListVoidVoid

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
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
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
EffectRangeFloatVoidReturns the range in metres that this ability will affect from the cast point
IsReignOfChaosRewardBoolVoidReturns true if this is an amry ability that can be rewarded as a reign of chaos outcome
IsRechargeEnabledBoolVoidReturns true if all recharge contexts for this ability are true (eg engaged in melee)
HasLimitedUsesBoolVoidReturns true if the ability has a limited number of uses (queried by RemainingUses)
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
IntensityFloatVoidReturns the intensity that modifiable stats of this ability will be multiplied by
IsCurrentlyTargettingBoolVoidReturns true if this ability is currently being targetted by the player
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)
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.
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
RechargePercentFloatVoidReturns the cooldown percentage if in cooldown (0-1), 0 if not in cooldown
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)
CanCurrentlyPerformBoolVoidReturns true if abiltiy can currently be activated
ActiveTimeRemainingSecsFloatVoid
PerformAbilityForOwnerVoidVoidActivates the ability for the owner (unit/army)

CcoBattleCaptureLocationsManager

Functions

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

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
CurrencyTypeStringToEnumIntStringTakes db key of the currency type and returns int32 of the currency type enum
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
PurchaseItemVoidString, Int, ContextTakes db key of the item, int32 for the currency item type enum and CcoBattleArmy and purchases the item
GetArmyCurrencyForTypeFloatCcoBattleArmy, StringTakes db key of the currency and returns the amount of that currency for the players army
GetCostForItemFloatString, Int, ContextTakes db key of the item, int32 for the currency item type enum and CcoBattleArmy and returns the cost for that item

CcoBattleEntity

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

Functions

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

CcoBattleGroup

Functions

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

CcoBattleLaboratoryInfo

Wrapper for the lab settings of a battle.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BloodMultiplierFloatVoidReturns the blood multiplier value
SetAbilityCooldownMultiplierVoidFloatSets the ability cooldown multiplier value to the one passed in
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
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
AbilityEffectRadiusMultiplierFloatVoidReturns the ability effect radius multiplier value
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
ProjectilePenetrationMultiplierFloatVoidReturns the projectile penetration 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
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
SetMoraleMultiplierVoidFloatSets the morale multiplier value to the one passed in
ToggleWindsOfMagicLimitlessVoidVoidToggles the winds of magic limitless setting
ExplosionRadiusMultiplierFloatVoidReturns the explosion radius multiplier value
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
SetDamageMultiplierVoidFloatSets the damage multiplier value to the one passed in
MoraleMultiplierFloatVoidReturns the morale multiplier value
ValueForLabSettingFloatCcoLabSettingRecordReturns the value for the passed in lab setting
SetChargeBonusMultiplierVoidFloatSets the charge bonus multiplier value to the one passed in
UnitSizeFloatVoidReturns the unit size multiplier value
IsWindsOfMagicLimitlessBoolVoidReturns true of winds of magic is set to limitless
DamageMultiplierFloatVoidReturns the damage multiplier value
SingleEntityScaleMultiplierFloatVoidReturns the single entity scale multiplier value
SetAbilityEffectRadiusMultiplierVoidFloatSets the ability effect radius multiplier value to the one passed in

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
IsAvailableInGroupBoolCcoBattleArmyReturns true if the item is available
ArmySpecialAbilityRecordContextCcoArmySpecialAbilityRecordVoidReturns the army ability record context
GetCostForThisActionFloatCcoBattleArmyReturns the cost of this action

CcoBattlePurchasableUnit

Functions

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

CcoBattlePurchasableUnitAbility

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

Functions

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

CcoBattleReinforcementDebugUnits

Functions

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

CcoBattleReinforcementPool

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanUseUnitBoolCcoBattleUnitReturn whether a specific unit is available to deploy (even if it cannot be deployed currently)
NumSpawnZonesAvailableToArmyIntCcoBattleArmy, ContextListReturns how many of the listed spawn zones are currently available to the specified army
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
GetHealthPercentageForUnitFloatCcoBattlePurchasableUnitGets health percentage of a unit in replenishment pool, returns 0 if unit is not found
UnitsUnlockedFromCapturePointCcoBattleUnit (list)CcoBattleArmy, CcoBattleCapturePointReturn vector of units that are unlocked on a specific capture point
UnitsCategorisedForArmyCcoGroupList (list)CcoBattleArmy, IntReturn vector of units available to an army
UnitsForArmyCcoBattlePurchasableUnit (list)CcoBattleArmy, IntReturn vector of units available to an army
PurchaseUnitVoidCcoBattlePurchasableUnit, CcoBattleArmy, IntPurchases a single unit for an army at a spawn zone
HaveAnyUnitsBeenOnBattlefieldBoolContextListHave any of the units been on the battlefield during this battle?
PurchaseUnitsVoidContextList, CcoBattleArmy, IntPurchases the list of units for an army at a spawn zone
CanPurchaseUnitBoolCcoBattlePurchasableUnit, CcoBattleArmy, IntReturn whether a specific unit is affordable to an army
CanPurchaseUnitsBoolContextList, CcoBattleArmy, IntReturn whether list of units 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?
CanUseSpawnZoneBoolCcoBattleArmy, IntReturn whether the specific spawn zone can be used

CcoBattleResultAlliance

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ArmyContextVoidVoid
ArmyListVoidVoid
ResultNameVoidVoid
ResultTypeVoidVoid

CcoBattleResultArmy

Functions

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

CcoBattleSettlement

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MountedArtilleryLocationListVoidVoid
DestroyedPercentVoidVoid
DestructionEffectsListVoidVoid

CcoBattleSetup

Wrapper for a battle setup

Functions

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

CcoBattleSetupAlliance

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

Functions

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

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)
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
PlayerNameUniStringVoidReturns the name of the player if human or the localised string for cpu if AI

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
UnitRecordContextVoidVoid
UnitDetailsContextVoidVoid
ImagePathVoidVoid
CombatPotentialVoidVoid
NameVoidVoid
IsCommanderVoidVoid

CcoBattleStormOfMagic

Cco wrapper for querying and controlling the Storm Of Magic manager

Functions

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

CcoBattleTimeControl

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

Functions

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

CcoBattleToggleableSlotBuildable

Functions

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

CcoBattleUnitEffect

Wrapper for a battle unit effect

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconPathString (list)VoidReturns the icon path for the effect
IconPathSmallString (list)VoidReturns the small icon path for the effect
TooltipLayoutString (list)VoidReturns the tooltip layout that should be used for this effect
HasIntensityBoolVoidReturns true if this effect is modified by an intensity value greater than 1.0f
NameUniString (list)VoidReturns the name of the 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
StartTimeSecondsIntVoidReturn the start time in seconds for this effect
TotalDurationSecondsFloatVoidReturns the total duration of this effect
BattleAbilityContextCcoBattleAbilityVoidReturn the battle ability for this effect
TimeRemainingSecondsIntVoidReturn the time in seconds remaining for this effect
PhaseRecordContextCcoSpecialAbilityPhaseRecordVoidReturn the activating phase record for this effect
AbilityContextCcoUnitAbilityVoidReturn the setup ability for this effect

CcoBattleVehicle

Functions

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

CcoBattleWindsOfMagicPool

Functions

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

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
EffectListVoidVoid
IsMouseOverVoidVoid
ZoomToClosestVoidVoid
EffectBundleListVoidVoid
DescriptionVoidVoid
IconPathVoidVoid
PositionVoidVoid
KeyVoidVoid
TitleVoidVoid

CcoCampaignArmoryItemVariant

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ArmoryItemVariantRecordContextCcoArmoryItemVariantRecordVoidReturns the context of the armory item variant
UnequipItemVariantVoidVoidUnequips this variant from the family member
EquipItemSetVoidVoidEquips the set that this item is part of
CanEquipItemBoolVoidReturns true if this item can be equipped on the family member
IsCompatibleWithAgentSubtypeBoolVoidReturns true if this variant if compatible with the agent subtype of the family member
EquipItemVariantVoidVoidEquips this variant to 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.

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
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
PlagueRecordContextCcoPlagueRecordVoidReturns the record of the plague

CcoCampaignBuilding

Functions

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

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
CurrentBuildingLevelContextCcoBuildingLevelRecordVoidReturns the building level whose effects are currently active
TurnsUntilNextStateIntVoidReturns the amount of turns until the lifecycle transitions to the next building level

CcoCampaignBuildingSlot

Functions

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

CcoCampaignBuildingVariant

Functions

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

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

CcoCampaignCaravanRecruitmentItem

Wrapper for a campaign FACTION_CARAVANS struct

Functions

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

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

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
SourceCharacterContextCcoCampaignCharacterVoidReturns a CcoCampaignCharacter with the interacting character
EnableTargettingVoidBoolEnables or disables the targetting depending on the bool passed in
SetTargetVoidContextSets the target to the context passed in if valid
ClearTargetVoidVoidClears the current target
ToggleTargettingVoidVoidToggles the targetting from active/inactive
IsTargettingActiveBoolVoidReturns true if the targetting for this interface is active
IsValidTargetBoolContextReturns true if the passed in target is valid
CurrentTargetContextContextVoidReturns the current target selected (should always be a CcoTeleportationNetworkNodeRecord)

CcoCampaignCharacterTeleportationSystem

Wrapper for character teleportation logic

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanTeleportToNodeBoolCcoTeleportationNetworkNodeRecordCloses true if the character can teleport to the passed in node
CloseTeleportationNodeVoidVoidCloses the teleportation node that the character is interacting with
InteractingNodeContextCcoTeleportationNetworkNodeRecordVoidReturns a CcoTeleportationNetworkNodeRecord with the node that the character is currently interacting with, if any
CanCloseTeleportationNodeBoolVoidReturns true if the character can close the node that it's currently interacting with
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
TeleportToNodeVoidCcoTeleportationNetworkNodeRecordTeleports the character to the passed in node
TeleportToRandomNodeInTemplateVoidCcoTeleportationNodeTemplateRecordTeleports the character to a random node with the template passed in

CcoCampaignCharacterTrainingGroup

Wrapper for a campaign training group

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
TrainingSlotListCcoCampaignCharacterTrainingSlot (list)VoidReturns a list with all the training slots in this group, including dummy ones for locked slots
MaximumSlotCountIntVoidReturns an int with the maximum slots in the group

CcoCampaignCharacterTrainingSlot

Wrapper for a campaign training slot

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
PossibleAbilityGroupListCcoSpecialAbilityGroupRecord (list)VoidReturns a list with possible abilities for this slot
CharacterPortraitStringVoidReturns a string with the character portrait path
IsPurchaseButtonActiveBoolVoidReturns true if this slot is purchasable
AgentSubtypeAgentPairContextListCcoAgentSubtypeAgentPair (list)VoidReturns all possible associated agent subtype agent pair context
TraitListCcoCharacterTraitLevelRecord (list)VoidReturns a list with the chosen traits
AgentSubTypeContextCcoAgentSubtypeRecordVoidReturns the selected agent subtype context
AgentSubtypeAgentPairContextCcoAgentSubtypeAgentPairVoidReturns the selected agent subtype agent pair context
IndexIntVoidReturns the index of the slot in the training group that it's part of
AgentContextCcoAgentRecordVoidReturns the selected agent context
IsLockedBoolVoidReturns true if the slot is locked
IsActiveBoolVoidReturns true if the slot is active

CcoCampaignConstructionItem

Functions

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

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
CharacterContextCcoCampaignCharacterVoidReturns the character currently mousing over
FactionContextCcoCampaignFactionVoidReturns the faction currently mousing over
LogicalPositionStringVoidReturns logical position on map currently mousing over as a stringdebug
CurrentCursorKeyStringVoidReturns the current cursor_record key of the cursor being used
SettlementContextCcoCampaignSettlementVoidReturns the settlement currently mousing over

CcoCampaignDiplomacyManager

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NegotiationForFactionCcoCampaignNegotiationCcoCampaignFactionReturns a CcoCampaignNegotiaton for the given proposing faction if there is one
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)
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
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
PerformManipulationVoidCcoCampaignFaction, CcoCampaignFaction (optional), Context (optional)Performs the manipulation on targets passed in
DiplomacyManipulationInteractionContextCcoCampaignDiplomacyManipulationInteractionVoidReturns the context of the diplomacy interaction of this info
OwnerFactionContextCcoCampaignFactionVoidReturns the context of the faction that owns this diplomacy manipulation info
RemainingCooldownIntVoidReturns the remaining cooldown of the manipulation info

CcoCampaignDiplomacyManipulationInteraction

Class that manages targetting interface interaction for a manipulation info

Functions

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

CcoCampaignEffectGroup

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectListVoidVoid
LocalisedTitleVoidVoid

CcoCampaignElectorSeat

Functions

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

CcoCampaignEventAgentTargetsCharacter

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsReferingToPlayerVoidVoid
TargetFactionContextVoidVoid
ActionResultContextVoidVoid
DiplomaticStateContextVoidVoid
TargetContextVoidVoid
AgentFactionContextVoidVoid
AgentContextVoidVoid

CcoCampaignEventAgentTargetsSettlement

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DiplomaticStateContextVoidVoid
IsReferingToPlayerVoidVoid
AgentFactionContextVoidVoid
TargetFactionContextVoidVoid
ActionResultContextVoidVoid
AgentContextVoidVoid
TargetContextVoidVoid

CcoCampaignEventAncillaryOrTrait

Functions

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

CcoCampaignEventArmoryItem

Context wrapper for a campaign ARMORY_ITEM custom layout event

Functions

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

CcoCampaignEventBattleResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PlayersBattleResultVoidVoid
DefendingFactionContextVoidVoid
AttackingBattleResultVoidVoid
DefendingCharacterContextVoidVoid
AttackingFactionContextVoidVoid
AttackingCharacterContextVoidVoid
DefendingBattleResultVoidVoid

CcoCampaignEventBuildingConstructed

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BuildingVoidVoid

CcoCampaignEventDilemma

Component context wrapper for an event dilemma

Functions

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

CcoCampaignEventDiplomacy

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EventIconPathVoidVoid
EventTypeVoidVoid
HasZoomLocationVoidVoid
SecondFactionVoidVoid
IsTreatyBrokenVoidVoid
FirstFactionVoidVoid
ZoomToVoidVoid

CcoCampaignEventFaction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasZoomLocationVoidVoid
SecondFactionContextVoidVoid
DiplomaticStateContextVoidVoid
FirstFactionContextVoidVoid

CcoCampaignEventFeedCustomMission

Component context wrapper for an event mission

Functions

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

CcoCampaignEventFeedFilter

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ToggleCategoryVoidVoid
InclusionStateVoidVoid
IsCategoryIncludedVoidVoid

CcoCampaignEventFeedGroup

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ShouldAutoExpandVoidVoid
TitleVoidVoid
EventListVoidVoid

CcoCampaignEventFeedMessageDetails

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EventSoundStringVoid
PrimaryDetailsWithTagsUniStringVoid
LayoutStringVoid
SecondaryDetailsWithTagsUniStringVoid
IsReadBoolVoid
MarkAsReadVoidVoid
HasZoomLocationBoolExpressionState
ZoomToVoidExpressionState
EventTypeStringVoid
IconPathStringVoid
HasSepiaFadeBoolVoidReturns true if the incident has a sepia fade multiplier
PositionVector4Void
CustomContextContextVoid
MissionContextCcoCampaignEventFeedCustomMissionVoid
FlavourTextUniStringVoid
IsLargeIncidentBoolVoidReturns true if we are an incident and event image is over default event size (current 800x450) as we use a different incident layout for these, originally for story panel on wh3
FullFlavourTextUniStringVoid
SepiaFadeMultiplierFloatVoidReturns the sepia fade multiplier, used for story panels to fade out a few seconds of at the end of the movie
TitleUniStringVoid
ShouldRepositionBoolVoid
PrimaryDetailUniStringVoid
SecondaryDetailUniStringVoid
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
ImagePathStringVoid
RequiresResponseBoolVoid
MoviePathStringVoid

CcoCampaignEventFeedOpenEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconContextContextVoid
ShouldRepositionBoolVoid
EventContextCcoCampaignEventFeedMessageDetailsVoid

CcoCampaignEventFeedRecords

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RoundsListVoidVoid
StartYearVoidVoid
EndYearVoidVoid
YearListVoidVoid
YearContextVoidVoid

CcoCampaignEventFeedRound

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsEmptyVoidVoid
SummaryListVoidVoid
RoundTitleVoidVoid

CcoCampaignEventFeedSummary

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MarkAsReadVoidVoid
TotalEventsVoidVoid
IsReadVoidVoid
IconPathVoidVoid
FirstEventContextVoidVoid
EventListVoidVoid
TitleVoidVoid

CcoCampaignEventFeedYear

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactionListVoidVoid
ProvinceListVoidVoid
RoundsListVoidVoid
CharacterListVoidVoid

CcoCampaignEventHostileAction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DiplomaticStateContextVoidVoid
IsReferingToPlayerVoidVoid
ActingCharacterContextVoidVoid
TargetFactionContextVoidVoid
ActingFactionContextVoidVoid

CcoCampaignEventIncident

Context wrapper for a campaign incident

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
HasZoomLocationBoolVoidReturns true if this incident can be zoomed to
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
CampaignVOEventNameStringVoidReturns the event name of VO
IncidentCcoIncidentRecordVoidReturns a CcoIncidentRecord with the record of this incident
CampaignVOActorGroupIntVoidReturns the actor group of VO
PrimaryTargetFactionContextCcoCampaignFactionVoidReturns a CcoCampaignFaction with the primary faction target
ZoomToVoidVoidZooms to the incident location
PrimaryTargetSettlementContextCcoCampaignSettlementVoidReturns a CcoCampaignSettlement with the primary settlement target
PrimaryTargetMilitaryForceContextCcoCampaignMilitaryForceVoidReturns a CcoCampaignMilitaryForce with the primary force target

CcoCampaignEventMercenaryUnitUnlock

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitVoidVoid

CcoCampaignEventTechnologyResearched

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ZoomToVoidVoid
NextTechnologyVoidVoid
FactionVoidVoid
HasZoomLocationVoidVoid
ResearchedTechnologyVoidVoid

CcoCampaignEventTrainingDilemmaAvailable

Context wrapper for a campaign TRAINING_DILEMMA_AVAILABLE custom layout event

Functions

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

CcoCampaignEventUnitRecruitment

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NameVoidVoid
DescriptionVoidVoid
UnitVoidVoid
AgentVoidVoid

CcoCampaignFactionAlliedBuildings

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RemoveAlliedBuildingVoidVoidRemoves the outpost from the settlement where it's constructed
RecruitableUnitsForSettlementListCcoMainUnitRecord (list)CcoCampaignSettlementReturns a list with units that could be recruited if an outpost is built in the passed in settlement
AlliedSettlementContextCcoCampaignSettlementVoidReturns the context of the settlement where an outpost is built, if any
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.
AllyPermittedSettlementListCcoCampaignSettlement (list)VoidReturns a list with settlements owned by the ally faction, in which an outpost can be constructed
ConstructInSettlementTimeIntCcoCampaignSettlementReturns the amount of time it will take to construct the outpost in this settlement.
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
MiddleDistanceThresholdIntVoidReturns the middle distance threshold, used for displaying the correct shared enemy distance state
CanMoveToSettlementBoolCcoCampaignSettlementReturns true if the slot can be moved to the passed in settlement
MoveToSettlementCostIntCcoCampaignSettlementReturns the amount it will cost to move the slot to this settlement

CcoCampaignFactionCaravans

Wrapper for a campaign FACTION_CARAVANS struct

Functions

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

CcoCampaignFactionGovernorship

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ClosestPendingDecisionGovernorshipContextCcoCampaignProvinceGovernorshipVoidReturns a CcoCampaignProvinceGovernorship with the closest governorship that has a pending decision, if no governorship has decisions then returns null
MaximumGovernorCountIntVoidReturns the maximum number of governors that can be present
UnassignedGovernorsCountIntVoidReturns the number of unassigned governors
ProvinceGovernashipFromProvinceCcoCampaignProvinceGovernorshipCcoCampaignProvinceReturns the province governorship that contains the passed in province, if any
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
ProvinceListCcoCampaignProvince (list)VoidReturns a list with all provinces that the faction can use to establish governorship
GovernorListCcoCampaignCharacter (list)VoidReturns a list with all governors that can be used to establish new governorships
SelectFirstValidTargettingInterfaceVoidVoidSelects the first valid governorship targetting interface, if any

CcoCampaignFactionProvinceManager

Wrapper for a campaign FACTION_PROVINCE_MANAGER

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CQIIntVoidReturns the unique command queue index identifier of this province
GrowthFactorListCcoStringValue (list)VoidReturns a list of CcoStringValue factors for the growth
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
IncomeBreakdownListCcoStringValue (list)VoidReturns a list of CcoStringValue with the breakdown of the income spent/gained
SetInitiativeVoidExpressionStateSets the CcoProvinceInitiativeRecord initiative that is stored on the component that calls this function
IsGrowthEnabledBoolVoidReturns true if growth 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
IsWealthEnabledBoolVoidReturns true if wealth is enabled for this province
GrowthPredictedNextTurnIntVoidReturns the amount of growth that the province is predicted to have next turn
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
ZealLevelIntVoidReturns the current level of zeal
FoodTotalIntVoidReturns the total food
SlavesContextCcoCampaignSlavesVoidReturns the context of the slave system if the faction has access to the feature
DevelopmentPointsIntVoidReturns the current development point
PooledResourceDistributorContextCcoCampaignPooledResourceDistributorVoidReturns the context of the pooled resource distributor of this province
PublicOrderContextCcoCampaignPublicOrderVoidReturns the public order context
CommandLevelIntVoidReturns the current level of the command/authority
SubterfugeLevelIntVoidReturns the current level of subterfuge
ProvinceContextCcoCampaignProvinceVoidReturns the province context
FactionContextCcoCampaignFactionVoidReturns the faction context
SelectedInitiativeCcoProvinceInitiativeRecordVoidReturns the context of the selected initiative that will be installed next turn
GeomanticWebLevelTextUniStringVoidReturns the geomantic web text for the current level
GrossIncomeIntVoidReturns the gross income that the province produces
PooledResourceContextCcoCampaignPooledResourceStringReturns the pooled resource context for the key passed in
PredictedGrowthPercentageFloatVoidReturns the percentage of predicted next turn growth to max growth
IsPublicOrderEnabledBoolVoidReturns true if public order is enabled for this province
InstalledInitiativeCcoProvinceInitiativeRecordVoidReturns the context of the currently installed initiative in this province
GeomanticWebLevelIntVoidReturns the current level of the geomantic web of the province
AddPooledResourceVoidCcoCampaignPooledResource, String, IntAdds a pooled resource to this province
IsTaxExemptBoolVoidReturns true if the province is not currently taking tax
GrowthPercentageFloatVoidReturns the percentage of current growth to max growth
CanSetInitiativeBoolVoidReturns true if the selected initiative can be set

CcoCampaignFactionWomCompass

Wrapper for wom compass

Functions

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

CcoCampaignGovernorshipInteraction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SourceCharacterContextCcoCampaignCharacterVoidReturns a CcoCampaignCharacter with the character
CurrentTargetContextContextVoidReturns the context of the current target
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
IncomeCombinedValueIntVoidReturns an int with the combined income value of all the effects on the character
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
SetTargetVoidContextSets the target to the passed in one
IsValidTargetBoolContextReturns true if the passed in target is valid
ClearTargetVoidVoidClears the current target
InvalidReasonsForTargetUniStringContextReturns the reason why the target is not valid
IsTargettingActiveBoolVoidReturns true if this targetting interface is active

CcoCampaignInitiative

Wrapper for a campaign initiative

Functions

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

CcoCampaignInitiativeSet

Functions

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

CcoCampaignMercenaryPoolUnit

Component context wrapper for a mercenary pool unit

Functions

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

CcoCampaignMilitaryForceHorde

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
GrowthFactorListCcoStringValue (list)VoidReturns a list of CcoStringValue with the name and value of the factors that went towards the current amount of growth
ChainListCcoBuildingChainRecord (list)VoidReturns a list of CcoBuildingChainRecord with all the building chains in the horde
GrowthThresholdForPointIntVoidReturns an int the growth amount needed for the next development point
TurnsUntilNextGrowthPointIntVoidReturns an int with the number of turns needed until the next development point
PredictedGrowthPercentageFloatVoidReturns a float with the percentage of growth value the horde will have next turn, relative to the next development point
GrowthPerTurnIntVoidReturns an int with the amount of growth the horde receives each turn
DevelopmentPointsIntVoidReturns an int with the current number of development points

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
PredictedBreakdownCcoStringValue (list)VoidReturns the predicted (next turn list of effects as a list of CcoStringValue
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

CcoCampaignMilitaryForceStance

Functions

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

CcoCampaignMilitaryForceWarTargetting

Functions

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

CcoCampaignMissionDefinition

Component context wrapper for a CAMPAIGN_MISSION_DEFINITION

Functions

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

CcoCampaignMissionObjective

Component context wrapper for a CAMPAIGN_MISSION_OBJECTIVE

Functions

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

CcoCampaignMissionObjectiveRequirements

Component context wrapper for a CAMPAIGN_MISSION_COMPLETION_STATUS_LINE

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsCompletedBoolVoidReturns whether the objective has been completed
HasZoomToLocationBoolVoidReturns whether the objective has a zoom to location
TooltipUniStringVoidReturns the tooltip of the objective
BuildingLevelRecordContextCcoBuildingLevelRecordVoidReturns the optional building level record context of this objective
UnitRecordContextCcoMainUnitRecordVoidReturns the optional unit record context of this objective
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

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
SortOrderIntVoidReturns sort order of the payload
IsAccessibleBoolVoidReturns true if payload is accessible (with DLC permissions)
UnitRankIntVoidReturns the unit rank, will return 0 if the payload doesn't provide a unit
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
StateStringVoidReturns the state to use in layout, this is either thte rarity state of the ancillary, if no ancillary just returns 'effect'
TurnsRemainingIntVoidReturns how many turns the payload lasts
EffectBundleCcoEffectBundleVoidReturns the CcoEffectBundle provided by the payload if there is any
TitleUniStringVoidReturns localised name of payload entry reward
IconStringVoidReturns icon filepath to use

CcoCampaignPendingActionNotification

Component context wrapper for an individual notification/warning for CcoCampaignPendingActionNotificationQueue

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CharacterContextCcoCampaignCharacterVoidReturns the CcoCampaignCharacter related to notification if exists
IsSkippableBoolVoidReturns true if this notification can be skipped
CanBeSupressedBoolVoidReturns true if this notification can be suppressed
ActivateVoidVoidActivates the notification, taking context sensitive action (like opening tech panel for tech available for example)
DescriptionUniStringVoidReturns localised detailed description from end_turn_notification record
IconPathStringVoidReturns icon path from end_turn_notification record
TitleUniStringVoidReturns localised title from end_turn_notification record
DisplayTextUniStringVoidReturns localised display text from end_turn_notification record
MilitaryForceContextCcoCampaignMilitaryForceVoidReturns the CcoCampaignMilitaryForce related to notification if exists
FactionContextCcoCampaignFactionVoidReturns the CcoCampaignFaction related to notification if exists
PooledResourceContextCcoCampaignPooledResourceVoidReturns the CcoCampaignPooledResource related to notification if exists
SettlementContextCcoCampaignSettlementVoidReturns the CcoCampaignSettlement related to notification if exists
ProvinceContextCcoCampaignProvinceVoidReturns the CcoCamapignProvince 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
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
SetAllNotificationsSuppressedVoidBoolSets the suppression of all types of notification.
CycleNotificationVoidBoolCycles through the current CurrentContext through NotificationsList (pass true for forwards, false for backwards)
SetActiveVoidVoidTurns the notification system on
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)
IsNotificationTypeSupressedBoolStringReturns true if specified type has been suppressed
ToggleNotificationsVoidVoidToggles the notification system to be on/off
AreNotificationsVisibleBoolVoidReturns true if notification system currently activated
IsNotificationListEmptyBoolVoidReturns true if there are currently no notifications so can just end turn
CurrentContextCcoCampaignPendingActionNotificationVoidReturns the current CcoCampaignPendingActionNotification to show in UI (we have cycle functionality in wh3)
PendingActionsOfTypeListContextListStringReturns list of CcoCampaignPendingActionNotification matching specified type string (matching key in notifications table in db)
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)

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
EffectListCcoEffect (list)VoidReturns the list of effects
PlagueOrIngredientContextContextVoidReturns the plague or ingredient that the effect bundle belongs to

CcoCampaignPlagueIngredient

Wrapper for a campaign plague component

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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)
NameUniStringVoidReturns the name of the plague component record
DescriptionUniStringVoidReturns the description of the plague component record
PlagueEffectContextCcoPlagueEffectRecordVoidReturns a CcoPlagueEffectRecord which contains all effect bundles for this ingredient
KeyStringVoidReturns the key of the plague component record
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
PlagueSpecialCompositionListCcoPlagueSpecialCompositionRecord (list)VoidReturns a the list of special compositions that the faction has access to
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

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
CanAffordTreasuryCostBoolCcoCampaignResourceTransactionReturns true if can afford the treasury cost of the specified resource transaction
HasRequiredTradeResourcesBoolCcoCampaignResourceTransactionReturns true if this transaction has the required trade resources
CanAffordSpecificPooledResourceCostBoolCcoCampaignPooledResourceTransactionReturns true if can afford the specific pooled resource cost specified by provided CcoCampaignPooledResourceTransaction
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
PositiveFactorListCcoStringValue (list)VoidReturns a list of only the factors that can be positive (but arent necessarily right now)
FactorListCcoStringValue (list)VoidReturns a list of factors for this pooled resource in this force
FactorTotalIntVoidReturns the total value from the factor list
FactorValueIntStringReturns value of a specific factor given the specified factor key
NegativeFactorListCcoStringValue (list)VoidReturns a list of only the factors that can be negative (but arent necessarily right now)
PooledResourceContextCcoCampaignPooledResourceVoidReturns the pooled resource this breakdown is for
TotalIntVoidReturns the total amount of pooled resource in this force

CcoCampaignPooledResourceProvinceBreakdown

Wrapper for a province 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 province
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 province

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
NegativeFactorListCcoStringValue (list)VoidReturns a list of only the factors that can be negative (but arent necessarily right now)
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)
FactorListCcoStringValue (list)VoidReturns a list of factors for this pooled resource in this settlement

CcoCampaignPooledResourceTransaction

Context wrapper for pooled resource transactions.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AbsoluteValueIntVoidReturns the absolute value (always positive)
OrderIntVoidReturns the sort order
DescriptionUniStringVoidReturns the localised description
ValueIntVoidReturns the value
NamePositiveUniStringVoidReturns the localised name to show when positive
NameNegativeUniStringVoidReturns the localised name to show when negative
IconStringVoidReturns the icon path for the transaction
NameUniStringVoidReturns the localised name
LocalisedTextUniStringVoidReturns the localised text which is value and name combination
ResourceKeyStringVoidReturns the resource record key
ValuePercentageIntVoidReturns the value as a percentage of max could be
SupplementColourColourVoidReturns the colour 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
ProvinceContextCcoCampaignProvinceVoidReturns the context of the province for this governorship
PendingDecisionContextCcoCampaignDecisionRecordVoidReturns the pending decision for this governorship if it exists

CcoCampaignPublicOrder

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HappinessRangeEffectBundleListVoidVoid
ProvidedEffectBundleVoidVoid
BalancePercentageVoidVoid
DetailsVoidVoid
ChangePerTurnStateVoidVoid
BreakdownListVoidVoid
StateVoidVoid
ChangePerTurnVoidVoid
BalanceVoidVoid

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
SlaveCostIntVoidReturns the amount of slaves the ritual costs, taking bonus values into account
RitualInteractionContextCcoCampaignRitualInteractionVoidReturns the context of the ritual targeting interface, used for selecting targets in 3d space.
RemainingCooldownIntVoidReturns the remaining cooldown for the ritual
MortuaryCategoryContextCcoMortuaryCultCategoryRecordVoidReturns the mortuary cult category if it exists
LastCompletedRitualTargetContextContextVoidReturns the context of the target that was used when last performing the ritual
RemainingScriptLockTimeIntVoidReturns the remaining time that the ritual is locked by script
DefaultFactionTargetContextCcoCampaignFactionVoidReturns the default faction target (if any) this ritual is setup to point at
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
TargetTypeStringVoidReturns a string with the type of target this ritual requires. Returns empty string if no target is required.
IsOnCooldownBoolVoidReturns true if the ritual is on cooldown
RitualContextCcoRitualRecordVoidReturns a context to the ritual
TargetResourceTransactionContextCcoCampaignResourceTransactionContextReturns a context to the target resource. Parameter can be a CcoCampaignMilitaryForce, CcoCampaignSettlement or CcoCampaignFaction
IsActiveBoolVoidReturns true if the ritual is active
RemainingCastTimeIntVoidReturns the remaining cast time of the ritual
RitualCompletionPayloadDurationIntExpressionStateReturns an int with the completion payload duration
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
CompletedRitualTargetAndDurationListCcoPair (list)ExpressionStateGoes through all completed rituals of this type and returns a list of all targets and their remaining payload duration
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
ResourceTransactionContextCcoCampaignResourceTransactionContext (optional)Returns a context to the resource transaction
ScriptLockedReasonUniStringVoidReturns the reason for why a ritual is locked by script
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

CcoCampaignRitualChain

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
LastCompletedOrFirstRitualContextCcoCampaignRitualVoidGet context of last completed ritual in chain, or first if none
RitualsListCcoCampaignRitual (list)VoidGet list of CcoCampaignRituals in the chain

CcoCampaignRitualInteraction

Class that manages targetting interface interaction for a ritual

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PerformActionVoidVoidPerforms a ritual with the current target stored
ActionCostCcoCampaignResourceTransactionVoidReturns the cost of the ritual.
ClearTargetVoidVoidClears the currently stored target
SetTargetVoidContextSets the target to the object passed in
ZoomToTargetVoidVoidZooms to the stored target
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
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
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
CurrentTargetContextContextVoidReturns the context of the current target, if any has been set
TargetFactionContextCcoCampaignFactionVoidReturns the target faction context if any
UpdateTargetFactionVoidBool (optional)Updates the faction with the current targetting interface faction. This is so all targetting interfaces are in sync
CanPerformActionBoolVoidReturns true if can perform ritual with the current target setup
ActionPerformTooltipUniStringVoidReturns a tooltip specifying whether can perform the ritual or not, exmplaining the reason if cannot be performed

CcoCampaignRitualManager

Wrapper for a faction's ritual manager

Functions

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

CcoCampaignRouteNode

Wrapper for campaign route node

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
IsEndNodeBoolVoidReturns true if this node is an ending node for its network
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
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
ResourceRewardForContractAndCargoContextCcoCampaignResourceTransactionCcoCampaignCharacter, CcoCaravanContractRecord, IntReturns a CcoCampaignResourceTransaction with the resource that the passed in cargo and contract would generate in this node

CcoCampaignRouteSegment

Wrapper for campaign route segment

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
StartNodeContextCcoCampaignRouteNodeVoidReturns a CcoCampaignRouteNode with the starting node of the segment

CcoCampaignSkavenCorruptionOverlay

Record wrapper for a Skaven corruption overlay

Functions

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

CcoCampaignSlaves

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
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.
PublicOrderContributionIntVoidReturns an int with the public order contribution that the slaves provide.
GrowthContributionIntVoidReturns an int with the growth contribution that the slaves provide.
IncomeIncreaseModifierFloatVoidReturns a float with the income increase modifier that the slaves provide.
SlavesCapPercentageFloatVoidReturns the percentage of used the slave cap
SlavesNumberIntVoidReturns an int with the current number of slaves in the province.

CcoCampaignTechnologyManager

Wrapper for a faction's technology manager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
CurrentResearchingTechnologyContextCcoCampaignTechnologyVoidReturn a context to the current technology this manager is researching, if valid
GoalTechnologyContextCcoCampaignTechnologyVoidReturn a context to the goal research technology if valid
EffectsGrantedCcoEffect (list)VoidReturn a list of effects granted by technology in this manager
ResearchedTechnologyListCcoCampaignTechnology (list)VoidReturn a list of researched technology from this manager

CcoCampaignTreasuryTransaction

Context wrapper for treasury transactions.

Functions

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

CcoCampaignUnitGroupUpgrade

Component context wrapper for a UNIT_GROUP_UPGRADE

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitRankAfterUpgradeIntCcoCampaignUnitReturns the provided units rank after upgrade have been applied
RankRequiredIntVoidReturns rank required on the unit for the upgrade
RankRequirementMetBoolVoidReturns if the requirement of the unit rank is met
TechRequirementsListCcoCampaignUnitUpgradesTechRequirement (list)VoidReturns a list of CcoCampaignUnitUpgradesRequirement for the unit group
BuildingRequirementsListCcoCampaignUnitUpgradesBuildingRequirement (list)VoidReturns a list of CcoCampaignUnitUpgradesBuildingRequirement for the unit group
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
EffectRecordCcoUnitPurchasableEffectRecordVoidReturns purchasable effect record cco
ResourceTransactionCcoCampaignResourceTransactionVoidReturns resource transaction cco

CcoCampaignUnitUpgradeManager

Component context wrapper for a UNIT_UPGRADE_MANAGER

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitHasUpgradesBoolCcoCampaignUnitReturns if unit has any unit group upgrades
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
UnitUpgradeMainUnitRecordListCcoMainUnitRecord (list)CcoCampaignUnitReturns a list of CcoMainUnitRecord which the unit can upgrade to for a given CcoCampaignUnit

CcoCampaignUnitUpgradesBuildingRequirement

Component context wrapper for a UNIT_GROUP_TECH_REQUIREMENT

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
RequirementTextUniStringVoidReturns the requirement display text
TechRequiredRecordContextCcoTechnologyRecordVoidReturns the CcoTechnologyRecord required to unlock the unit group
IsRequirementMetBoolVoidReturns true if unit have met the requirement

CcoCampaignWarCoordinationRequest

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
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
TurnsRemainingIntVoidReturns the turns remaining until this request becomes invalid
CanCurrentlyRequestBoolVoidReturns if can currently perform this request (if can afford, etc)

CcoCampaignWinStreak

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TurnsUntilDecayVoidVoid
CurrentStreakEffectContextVoidVoid
EffectUnfilteredListVoidVoid
WinStreakPercentVoidVoid
InvalidationRoundVoidVoid
EffectListVoidVoid
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
TransitionRoundIntVoidReturns an int with the round number when the duration of the current strength finishes.
RoundsUntilTransitionIntVoidReturns the number of rounds until the next transition.
CurrentStrengthContextCcoCampaignMapWindsOfMagicStrengthRecordVoidReturns the context of the current wind strength record in the area.
RecordContextCcoCampaignMapWindsOfMagicAreaRecordVoidReturns the context of the winds of magic area record.
RegionListContextListVoidReturns a list with all the regions in the area.

CcoCampaignWindsOfMagicSystem

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ChangeAreaStrengthVoidCcoCampaignWindsOfMagicArea, CcoCampaignMapWindsOfMagicStrengthRecord
AreaContextForProvinceCcoCampaignWindsOfMagicAreaCcoCampaignProvince
AllAreaContextsContextListVoid
AreaContextForRegionCcoCampaignWindsOfMagicAreaCcoRegionRecord

CcoCampaignWomCompassDirection

Wrapper for wom compass direction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PowerLevelEffectListCcoEffect (list)VoidReturns a list with the current effects of this direction based on the power level
KeyStringVoidReturns the key of the direction record
FactorListCcoStringValue (list)VoidReturns a list of factors that have affected the power level of this direction
ActionTooltipUniStringStringReturns the tooltip for the action of the type specified
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
DescriptionUniStringVoidReturns the localised description of the direction
IsCurrentDirectionBoolVoidReturns true if this direction is the currently selected one
MaxPowerLevelIntVoidReturns an int with the maximum power level this direction can have
CurrentPowerLevelIntVoidReturns an int with the current power level that this direction has
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

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

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

CcoComponentModelView

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SetCameraDistanceVoidFloatSets the cameras distance from the target
SetCameraThetaVoidFloatSets the camera theta orientation in degrees
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)
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
SetCameraTargetVoidVector4Sets the cameras target position
SetCameraFovVoidFloatSets the camera field of view in degrees

CcoContextExpression

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TextRepresentationStringVoid
EvaluateExpressionArgumentPackContext, ArgumentPack

CcoContextExpressionCompilationError

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionStringVoid

CcoContextExpressionResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasStringRepresentationBoolVoid
ValueArgumentPackVoid
ResultTypeCcoContextObjectTypeVoid

CcoContextExpressionRuntimeError

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionStringVoid

CcoContextHistoryObject

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ContextIdStringVoid
TimeIntVoid
ContextObjectIdStringVoid
ReasonStringVoid
CcoContextContextVoid
CallbackIdStringVoid
OriginComponentContextContextVoid

CcoContextList

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IndexForFirstContextIntExpressionState, ExpressionReturns the index of the first context that returns true for the supplied expression
MaxContextContextExpressionState, ExpressionReturns the context with the largest value evaluated for each context in the list using expression
AtContextIntReturns the context at the specified index
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
PartitionContextListExpressionState, ExpressionReturns the subset of the list at the point where the first context matches the given expression
NextContextContextContextGiven a context that exists in the list, returns the next context if one exists, will also wrap around the end of the list. If list only has one element will return the one element
FindContextContext
SumArgumentPackExpressionState, ExpressionAccumulates the values returns by each contexts expression (for adding up totals)
FindIfContextExpressionState, Expression
ReduceArgumentPackExpressionState, Expression, Expression (optional)Reduces the list based on given predicate starting at optional initialiser value
TakeContextListIntReturns the first N elements of the list
SkipContextListIntSkip the first x elements of the list
ListContextListVoidReturns internal list of contexts
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
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
SizeIntVoidReturns the number of elements in the list
ContainsBoolContextReturns true if supplied context exists 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
FilterContextListExpressionState, ExpressionReturns a list with all the elements of the given list that satisfy the condition.
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)
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
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
TransformContextListExpressionState, ExpressionTransforms the list into a new one where each element is produced by the given expression
MinValueFloatExpressionState, ExpressionReturns the smallest value evaluated for each context in the list using 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
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

CcoContextObjectType

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasStringRepresentationBoolVoid
NameStringVoid
SymbolsListContextListVoid
IsArithmeticBoolVoid
IsListBoolVoid

CcoContextSymbol

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DocumentationStringVoid
NameStringVoid
TagsStringVoid
IsCommandBoolVoid
EvaluateSymbolArgumentPackContext, ArgumentPack
TypeContextCcoContextObjectTypeVoid

CcoCookingDish

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RoundsLeftVoidVoid
FactionLeaderEffectListVoidVoid
FactionEffectListVoidVoid
CookingDishRecordContextVoidVoid

CcoCookingSystem

Functions

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

CcoCustomBattleArmyPreset

Wrapper for an army preset that can be saved / loaded

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
UnitListCcoMainUnitRecord (list)VoidReturns a list of unit saved in the army preset
DeleteVoidVoidRemoves the army preset from the filesystem, and removes it from the context cache
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
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

CcoCustomBattleArmyPresetFileHandler

Singleton wrapper for army preset file handler

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ConfirmSaveOverwriteVoidVoidSaves army preset once the overwrite operation has been accepted
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
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
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
CurrentUpgradeListCcoCustomBattleUnitUpgrade (list)VoidReturns the current CcoCustomBattleUnitUpgrades of the unit associated with the unit index stored on this context
IsPersistentCharacterBoolVoidReturns whether the unit associated with the unit index stored on this context is a loaded character
UnitTypesCcoUnitsCustomBattleTypeRecord (list)VoidReturns variants for this unit, eg different ammo or spell lore overrides
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
CanEverIncreaseExperienceBoolVoidReturns whether the unit associated with the unit index stored on this context can ever increase its level
AvailableUpgradeListCcoCustomBattleUnitUpgrade (list)VoidReturns the CcoCustomBattleUnitUpgrades available to the unit associated with the unit index stored on this context
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
ExperienceLevelIntVoidReturns the level of the unit associated with the unit index stored on this context
RemoveMountVoidVoidRemoves the mount of the unit associated with the unit index stored on this context
CostIntVoidReturns the cost 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
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
CostAtLevelIntIntReturns the cost at a provided level of the unit with the unit index stored on this context
ChangeUnitTypeVoidCcoUnitsCustomBattleTypeRecordChanges, to the provided alternate unit type, specified by the provided CcoUnitsCustomBattleTypeRecord
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

CcoCustomBattleUnitUpgrade

Functions

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

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
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
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
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
NameUniStringVoidReturns the localised name
DescriptionUniStringVoidReturns the localised description
KeyStringVoidReturns the unique key of the effect bundle record
IconPathStringVoidReturns the icon path
RecordListCcoEffectBundle (list)VoidReturns the list of all effect bundle records

CcoEpisodicOverride

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsOverridenVoidVoid

CcoFactionSavedCharacters

Wrapper for a SAVED_CHARACTER_INFO struct

Functions

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

CcoFactorBreakdown

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionVoidVoid
ListVoidVoid
HeaderVoidVoid

CcoFindResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ContextContextVoid
IndexIntVoid

CcoFloatingTextAgentActionEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TargetFlagPathVoidVoid
TargetNameVoidVoid
IsSuccessVoidVoid
AgentNameVoidVoid
ActionNameVoidVoid
TextTypeVoidVoid
AgentFlagPathVoidVoid

CcoFloatingTextBattleEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TextTypeVoidVoid
AttackerFlagPathVoidVoid
DefenderFlagPathVoidVoid
AttackerVoidVoid
DefenderVoidVoid

CcoFloatingTextStanceEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GeneralNameVoidVoid
GeneralFlagPathVoidVoid
NewStanceNameVoidVoid
OldStanceNameVoidVoid
TextTypeVoidVoid

CcoFrontendFactionLeader

Wrapper for a frontend faction leader

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SetAsActiveModelVoidVoidSets this leader as the active model
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
FactionEffectBundleCcoEffectBundleVoidReturns a list of faction effects to be displayed in frontend
PinLocationVector4VoidReturns the location of the lord on the map
FactionRecordContextCcoFactionRecordVoidReturns a CcoFactionRecord with the faction record that the lord is part of
FrontendFactionLeaderRecordContextCcoFrontendFactionLeaderRecordVoidReturns a CcoFrontendFactionLeaderRecord with the leader record
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

CcoFrontendRoot

Functions

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

CcoGameCore

Wrapper for the game core

Functions

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

CcoGroupList

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GroupedListContextListVoid
CategoryObjectContextVoid

CcoIngameMessaging

Ingame messaging singleton, used to get ingame news items

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FilteredNewsItemsCcoIngameMessagingItem (list)VoidReturns all news items that could be visible (DLC permission checks, platform checks, etc)
NextPageVoidVoidAdvances news page by 1 to view next set of news
PreviousPageVoidVoidGoes back to previous page of news
IsReadyBoolVoidReturns true if ingame messaging is loaded and ready
CurrentPageIntVoidReturns the current page of news being viewed on frontend
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

CcoListLayout

Wrapper for a component list engine

Functions

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

CcoLobbyPlayer

Wrapper for a lobby player slot

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsHostBoolVoidReturns true if this player is the host of the lobby
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
SetCultureVoidCcoCultureRecordSets the culture to the passed in one
NameUniStringVoidReturns the name of the player
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

CcoLobbyTeam

Component context wrapper for a MPC lobby team

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
ShouldShowBoolVoidReturns true if we should show this team in the UI
TeamIDIntVoidReturns the team id (index)

CcoMoMTrialManager

Wrapper for Mirrors of Madness Trials

Functions

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

CcoNarrativeManager

Functions

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

CcoNetworkPlayer

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

Functions

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

CcoPair

Functions

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

CcoPreBattleAIAvailableGenerals

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetGeneralsListContextListVoid

CcoPreBattleFactionVote

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
PlayAsAIFactionSelectedContextContextVoidReturns Play as AI faction selected, can return nullptr
HasSelectedPlayAsAiFactionBoolVoidReturns whether a Play as AI faction has been selected
IsFactionAvailableAsPlayAsAIBoolCcoCampaignFactionReturns whether the vote's faction and play as passed in AI faction
IsVoteAvailableBoolStringReturns whether passed in String representing the vote is available for the this faction of this vote
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
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
SelectedPlayAsAIFactionCcoCampaignFactionVoidReturns CcoCampaignFaction context for the selected to play as ai faction, can return nullptr
IsComponentOnAttackingUISideOfPrebattleBoolExpressionStateReturns true if component this is called on is a child of the panel side in prebattle showing attackers (used for determining which faction would be supporting)

CcoPreBattleVotingSystem

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CancelReadyVoidVoidCancels ready status of local player which will reset their vote and cancel the current countdown timer for battle to commence
CanCancelReadyBoolVoidReturns true if can call CancelReady
IsReadyTimerActiveBoolVoidReturns true if all players selected a vote and battle is counting down to start
ReadyCountdownTimeUniStringVoidReturns formatted localised time until battle will commence
FactionsAvailableToPlayAsAICcoCampaignFaction (list)CcoCampaignFactionReturn context list of CcoCampaignFaction representing the factions of armies that are available to be played as AI
FactionPlayingAsAiFactionCcoCampaignFactionCcoCampaignFactionReturns the faction context for who is playing as AI for the specified faction (null if no one and will be controlled by AI)
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
MaxNumberOfPrisonersVoidVoid
IsPrisonFullVoidVoid
CurrentNumberOfPrisonersVoidVoid

CcoReinforcementArmy

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DelayVoidVoid
EntryPositionVoidVoid

CcoRuntimeObject

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
InternalContextVoid

CcoSaveGameHeader

Wrapper for a save game header

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsCloudSaveBoolVoidReturns true if save is in the cloud
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
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
CampaignRecordContextCcoCampaignMapPlayableAreaRecordVoidReturns the CcoCampaignMapPlayableAreaRecord for campaign
SeasonTextUniStringVoidCurrent season in the save game
FactionNameUniStringVoidReturns name of faction playing as (use this instead of record as supports renaming of faction)
FactionRecordContextCcoFactionRecordVoidReturns the CcoFactionRecord for faction playing as

CcoSavedCharacterInfo

Wrapper for a SAVED_CHARACTER_INFO struct

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanRecruitBoolVoidReturns true if the character can be recruited
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
CharacterTraitLevelListCcoCharacterTraitLevelRecord (list)VoidReturns a list of traits that the saved character has
RecruitmentCostIntVoidReturns an int with the cost to recruit this character
IsAgentBoolVoidReturns true if this character is an agent
NameUniStringVoidReturns the localised name of the saved character
CharacterTypeNameUniStringVoidReturns the localised character type name
UnitRecordContextCcoMainUnitRecordVoidReturns the main unit record for this saved character
UnitDetailsContextCcoUnitDetailsVoidReturns the unit details associated with this unit
AgentContextCcoAgentRecordVoidReturns the agent record context of the saved character
AgentSubtypeContextCcoAgentSubtypeRecordVoidReturns the agent subtype record context of the saved character

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
ValueUniStringVoidReturns the string value represented by this string
RFindIntCcoString, ExpressionState, UniString, Int (optional)Returns the first index of the specified string, searching from the back. Returns -1 if none found. Can specify a starting position to search from as second parameter, this defaults to 0 if none specified
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
ExtractImageIconFromTextUniStringVoidReturns the image path inside the image tag in the specified text
ExtractColourFromTextUniStringVoidReturns the colour tag from the specified text
EndsWithBoolCcoString, ExpressionState, UniStringReturns true if this string ends with the specified string
ContainsBoolCcoString, ExpressionState, UniStringReturns true if this string contains the specified string
RemoveFilepathDirectoryUniStringVoidReturns a copy of this string with the parent directory removed, assuming this string is a filepath
ParseTextReplacementsUniStringCcoString, ExpressionStateReturns a copy of this string where any text tags are parsed and replaced in with the actual text
RemoveFilepathExtensionUniStringVoidReturns a copy of this string with the file extension removed, assuming this string is a filepath
RemoveTextTagsUniStringVoidReturns a copy of this string with all text tags removed
StartsWithBoolCcoString, ExpressionState, UniStringReturns true if this string starts with the specified string
ToUpperUniStringCcoString, ExpressionStateReturns a copy of this string where all letters are uppercase
RemoveLeadingWhitespaceUniStringVoidReturns a copy of this string with leading whitespace removed
LengthIntVoidReturns the length of this string
ToLowerUniStringCcoString, ExpressionStateReturns a copy of this string where all letters are lowercase
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)
IsEmptyBoolVoidReturns true if this string is empty/blank

CcoSummedValueContext

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OriginalContextContextVoid
SummedListContextListVoid
SummedValueFloatVoid

CcoSymbolTest

This is an example

Functions

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

CcoSymbolTestSecond

This is a second example

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SameNameStringVoid
ContextContextVoid
idStringCcoSymbolTest
id2StringCcoSymbolTest

CcoTempleOfTheOldOnes

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentLevelVoidVoid
NumberOfBuildingsVoidVoid
NameVoidVoid
DescriptionVoidVoid
CurrentEffectBundleVoidVoid
ColourVoidVoid

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
IsDisplayedInLocationBoolVoidReturns whether this ui warning is displayed in location
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
WarningTypeStringVoidReturns the type of warning this is (category)
KeyStringVoidReturns a key associated with this warning, unique within this type of warning (type + key is globally unique)
DescriptionStringVoidReturns a description of 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
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
IsPassiveBoolVoidReturns true if this unit ability is a passive ability
IsLockedBoolVoidReturns true if this unit ability is locked
BehavioursSoundCategoryStringVoidReturns the sound event related to this ability behavioursound
ShotTypesSoundCategoryStringVoidReturns the sound event related to this projectile shot type sound
NameUniStringExpressionStateReturns the localised name of this unit ability
StateStringVoidReturns active/inactive depending on if the unit ability is locked/unlocked
TooltipUniStringExpressionStateReturns the localised tooltip of the unit ability
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

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
KeyStringVoidReturns the db key for the stat
TooltipUniStringVoidReturns the localised tooltip for the unit stat
ValuePercentHighestFloatExpressionStateGets highest percentage for stat from either modified stat or base stat. Used for back fill bar so can see buffs/debuffs.
PreBonusStatContextCcoUnitStatExpressionStateReturns the CcoUnitStat of the unit stat without any previews
SortOrderIntVoidReturns the sort order of the unit stat
UnitDetailsContextCcoUnitDetailsExpressionStateReturns the CcoUnitDetails context of the unit detail that this stat belongs to
IconStringVoidReturns the icon path
IsPercentageBoolVoidReturns true if stat should be represented as a percentage
ModifierIconListCcoUnitStatModIcon (list)VoidReturns a list of stat modifier icons
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
ValuePercentBaseFloatExpressionStateReturns percent value of stat with no mods/buffs/debuffs
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
ValueFloatVoidReturns returns the current value of the unit stat
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

CcoUnitStatModIcon

Component context wrapper for a unit stat modifier icon

Functions

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

CcoVector4

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
wFloatVoid
ModulusFloatVoid
yFloatVoid
zFloatVoid
ValueVector4Void
xFloatVoid

Battle

CcoBattleAlliance

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CpKillScoreIntVoidReturns the score for this alliance, the higher the better the alliance performed (earned by unit experience and capturing capture points)
TicketsRemainingIntVoidReturns the capture point tickets remaining (when 0 lose if defending)
TicketsIncomePerSecondIntVoidReturns the total capture point tickets income rate, per second.
ArmyListCcoBattleArmy (list)VoidReturns the list of armies in this alliance
IdIntVoidReturns the index of 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
NumArmiesIntVoidReturns the number of armies in this alliance
NumUnitsIntVoidReturns the number of units in this alliance
StartingTicketsIntVoidReturns the capture point tickets started the battle with

CcoBattleArmy

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

Functions

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

CcoBattleBuilding

Functions

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

CcoBattleCapturePoint

Functions

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

CcoBattleCursorContext

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

Functions

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

CcoBattleReinforcementArmy

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
IsDeployedBoolVoidHas the reinforcement army been deployed into the battlefield yet?

CcoBattleRoot

The root for battle that gives access to anything battle related

Functions

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

CcoBattleSelection

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NumUnitsIntVoidReturns number of units currently selected
AnyUnitSelectedBoolVoidReturns true if any controllable unit is selected
AnyUnitSelectedIncludingEnemyBoolVoidReturns true if any unit selected including the enemy
ToggleFlyingVoidVoidToggles flying state of units that can fly in the current selection
IsOrderableBoolVoidReturns true if the current selection can be issued orders
DeselectAllVoidVoidDeselects any currently selected units
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
ToggleRunVoidVoidToggles run/walk speed on the current selection
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
IsTakingDamageBoolVoidReturns true if the current selection is taking damage

CcoBattleSpawnZone

Functions

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

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
ConstructionTimeRemainingSecondsFloatVoidHow long is left in the current construction timer
HidePreviewForIndexVoidIntHides the ghost preview for the buildable on the associated slot
IsConstructionInProgressBoolVoidIs there anything being constructed or a toggle switch being deferred?
ShowPreviewForIndexVoidIntShows the ghost preview for the buildable on the associated slot
CanInteractBoolCcoBattleArmyCan the slot be interacted with?
HasArtilleryMountLocationBoolVoidDoes the slot support an artillery mount?
WorldPositionVector4VoidReturns a Vector3 of the world position of the slot origin
CanOwnerInteractBoolVoidCan the slot be interacted with by the army that owns it?
IsMapBarrierBoolVoidDoes the slot represent a toggleable barrier?
EnabledIndexIntVoidWhich of the buildables is currently enabled? -1 for none
IsFreeRotationAllowedBoolVoidCan the slot be rotated?
IsUnitBoolVoidDoes the slot represent a toggleable unit?
IsAnyEnabledBoolVoidAre any of the buildables associated with this slot, enabled?
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
IsActiveBoolVoidIs the slot radial visible?
CurrentBuildableOwnerCcoBattleArmyVoidGet the CcoBattleArmy of the owner of the currently enabled buildable. Falls back to the capture point owner if this fails
IconPathForIndexStringCcoBattleArmy, IntRetrieve the icon asset path for the associated slot buildable index
SetActiveVoidBoolSet if the slot radial visible
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)

CcoBattleUnit

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsBuffedByHarmonyBoolVoidReturns true if the unit is currently receiving a battle harmony buff
ArmyContextCcoBattleArmyVoidReturns the CcoBattleArmy this unit belongs to
AbilityListCcoUnitAbility (list)VoidReturns the list of abilities this unit can use as a list of CcoUnitAbility
DevTeleportVoidString, StringTeleports a unitdebug, hide_in_uied
IsBarrierChargingBoolVoidReturns true if the unit has a barrier and it is currently recharging (barrier is a kind of rechargable shield)
IsAliveBoolVoidReturns true if this unit is still alive
IsShatteredBoolVoidReturns true if this unit is shattered (morale so low that they will no longer recover and are essentially lost)
ToggleHighlightVoidVoidToggles the highlight shown with Highlight command
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
CharacterRankIntVoidReturns the rank of the character this unit is for if any
ThreatPercentOfUnitFloatCcoBattleUnitReturns the threat of the specified unit. -1 is invalid, 1 is high threat, 0 is low threat
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
IsFiringMissilesBoolVoidReturns true if this unit is currently firing missilees
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
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)
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)
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)
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
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)
NumKillsIntVoidReturns the number of kills this unit has performed in this battle
IconPathStringVoidReturns the icon path used for unit cards, etc
MaxHealthPercentCanReplenishFloatVoidReturns the max health percent that can be replenished by abilities
UnlockedAbilitiesCcoUnitSpecialAbilityRecord (list)ContextList); Returns a list of the unlocked abilities from the list of groups supplied
DevSetArmyVoidIntGives control of the unit to a given armydebug, hide_in_uied
IsTakingDamageBoolVoidReturns true if this unit is currently taking damage
IsPartOfWaveBoolVoidReturns true if this unit is currently routing (running away due to low morale, but might recover and come back)
BuildingContextCcoBattleBuildingVoidReturns the CcoBattleBuilding this unit is currently on/in
SelectVoidVoidSelects this unit to control
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
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
ThreatPercentOfUnitMouseoverFloatVoidReturns the threat of the unit currently mousing over (used on tooltips). -1 is invalid, 1 is high threat, 0 is low threat
HasCharacterRankBoolVoidReturns whether the unit supports having a rank or not
HighlightVoidBoolHighlights on the 3d battlefield in same way script can (flashes entity markers and unit ids for example)
StatusMostImportantCcoUiUnitStatusRecordVoidReturns the current most important CcoUiUnitStatusRecord that is active
IsVisibleBoolVoidReturns true if this unit is currently visible to player (taking into account hidden state and line of sight
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
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
PercentHpLostRecentlyFloatVoidReturns the percentage of HP lost in the last 4 seconds
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
IsCharacterBoolVoidReturns true if this unit is a character (general or agent basically)
FatigueNameUniStringVoidReturns the localised name of the current FatigueState
UnitDetailsContextCcoUnitDetailsVoidReturns the CcoUnitDetails for this unit, used for unit info panel that shows unit information from various sources
IsWaveringBoolVoidReturns true if this unit is currently in wavering morale state (brink of routing)
FatigueStateIntVoidReturns the current fatigue state as an int (mirrors enum in code)
PercentCasualtiesRecentlyFloatVoidReturns the percentage of men lost in the last 4 seconds
DevTakeControlVoidVoidGives control of the unit to the playerdebug, hide_in_uied
IsUnderPlayerControlBoolVoidReturns true if this unit is currently under the players control
UniqueUiIdIntVoidReturns the unique ui id of the unit as an int, unique amongst all units in the battle
IsInMeleeBoolVoidRturns true if this unit is currently in melee combat
CooldownPassiveAbilityListCcoBattleAbility (list)VoidReturns a list of passive battle abilities current on cooldown
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
IsOrderableBoolVoidReturns true if this can be given orders
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
MoraleGreatestEffectUniStringVoidReturns the localised name of the effect that is having the greatest effect on morale currently
MoralePercentFloatVoidReturns the current morale as a percentage of best morale could be
IsSelectedBoolVoidReturns true if this unit is currently selected
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)
DevSetInvincibleVoidBoolSets the unit invincible based on the supplied booldebug, hide_in_uied
MoraleStateIntVoidReturns morale state as an int (mirrors enum in code)
IsGiftedBoolVoidReturns true if this unit has been gifted so the original owner isnt currently controlling
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
IsOutOfControlBoolVoidReturns true if this unit is currently out of control (meaning player has no control over them and they just attack the nearest unit)
IsHiddenBoolVoidReturns true if this unit is currently hidden (using terrain types, etc)
ToggleFlyingCooldownTimerFloatVoidReturns the time (in seconds) remaining on the toggle flying cooldown timer
NumEntitiesIntVoidReturns the current number of entities
CustomNameUniStringVoidReturns any custom name given to this unit
IsEnemyUnitBoolVoidReturns true if this unit belongs to the enemy alliance
DevSetAmmoAmountVoidInt, BoolSets the ammo amount to the specified valuedebug, hide_in_uied
HasStatusBoolVoidReturns true if unit has any CcoUiUnitStatusRecord currently
CanAlwaysFlyingBoolVoidReturns true if this unit has the ability to be always flying
IsUnderMyControlBoolVoidReturns true if the unit is under the player control
SecondaryAmmoPercentFloatVoidReturns the percentage of secondary ammo remaining(0 - 1)
ActiveProjectileContextCcoProjectileRecordVoidReturns the current CcoProjectileRecord context the unit is using for ranged attacks
MoraleNameUniStringVoidReturns the localised name of the current MoraleState
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
IsHighlightedBoolVoidReturns true if the unit is currently highlighted
NumEntitiesInitialIntVoidReturns the number of entities the unit entered the battle with
IsUnspottableBoolVoidReturns true if this unit has unspottable unit behaviour
ExperienceLevelIntVoidReturns the current experience level
OfficerEntityContextCcoBattleEntityVoidReturns the CcoBattleEntity for the current officer entity (entity leading this unit)
IsFlyingBoolVoidReturns true if this unit is currently flying
HasArtilleryDroppedEnginesBoolVoidReturns true if artillery unit that has dropped their engines
IsGeneralBoolVoidReturns true if this unit is a commanding general unit
DevRespawnVoidVoidWill respawn the unitdebug, hide_in_uied
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
DelayedHealthPercentFloatVoidReturns the delayed health of the unit as a percentage (0-1)
HealthValueIntVoidReturns the raw health value
BattleResultUnitContextCcoBattleResultUnitVoidReturns the CcoBattleResultUnit for the current unit
IsRenownBoolVoidRturns true if a unit of renown (special limited units that have certain perks and we highlight in the UI)
NameUniStringVoidReturns the localised name of the unit
IsPlayerUnitBoolVoidReturns true if this unit belongs to the player
DevRoutVoidVoidWill rout the unitdebug, hide_in_uied
CanFlyBoolVoidReturns true if this unit has the ability to fly
IsUnderAIControlOriginallyBoolVoidReturns true if the unit started the battle under AI control
HealthMaxIntVoidReturns the max health
PrimaryAmmoPercentFloatVoidReturns the percentage of primary ammo remaining (0-1)
VehicleContextCcoBattleVehicleVoidReturns the current CcoBattleVehicle this unit is using if any
HasInfiniteSecondaryAmmoBoolVoidReturns true if has infinite secondary ammo
IsTeleportWithdrawingBoolVoidReturns whether unit is currently teleporting to withdraw
CanGuerrillaDeployCurrentlyBoolVoidReturns true if the unit CanGuerrillaDeploy and can do this currently (has extra checks like not in a vehicle, etc)
BreakForDebuggingVoidVoidBreaks in to attached IDE to inspect model UNIT in greater detaildebug, hide_in_uied
MountListCcoBattleEntity (list)VoidReturns the list of CcoBattleEntity just for mount entities
IsIdleBoolVoidReturns true if this unit has no orders currently and is standing still
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)
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)
IsSpawnedUnitBoolVoidReturns true if a spawned unit (came from an ability for example during the battle)
SecondsLeftToTeleportIntVoidReturns number of seconds left in teleporting to withdraw process
ShouldShowAmmoBoolVoidReturns true if we should show ammo UI for this unit
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
DevKillVoidVoidWill kill the unitdebug, hide_in_uied
DamageInflictedRecentlyIntVoidReturns the amount of damage inflicted in the last 4 seconds
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
HealthPercentFloatVoidReturns the health of the unit as a percentage (0-1)
IsOriginallyOwnedByLocalPlayerBoolVoidReturns whether the local player originally owned this unit i.e. if it is gifted but still belongs to this player
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
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
DelayedBarrierHpPercentFloatVoidReturns the units delayed barrier HP percent if any (barrier is a kind of rechargable shield)
HasHarmonyEffectBoolVoidReturns true if the unit is tagged as a Yin or Yang battle harmony unit
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)
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
HasInfinitePrimaryAmmoBoolVoidReturns true if has infinite primary ammo
DevResetAbilityUsesVoidVoidReset ability usesdebug, hide_in_uied
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
CanGuerrillaDeployBoolVoidReturns true if the unit has the ability to guerilla deploy (deploy outside deployment zone)
OwningNetworkPlayerContextCcoNetworkPlayerVoidReturns the CcoNetworkPlayer that is currently in control of this unit, for mp battles where unit sharing possible
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)
PositionVector4VoidReturns the current position

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
RecordKeyStringVoidDatabase record key of this building
ChainRecordKeyStringVoidDatabase record key of the building chain this building belongs to

CcoCampaignModelFaction

Model safe context wrapper for a campaign faction

Functions

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

CcoCampaignModelInitiative

Initiative wrapper safe to use in campaign model contexts

Functions

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

CcoCampaignModelInitiativeManager

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactionContextCcoCampaignModelFactionVoidOwning faction of the manager
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
InitiativeContextCcoCampaignModelInitiativeStringInitiative context for given key, if valid
ActiveInitiativesCcoCampaignModelInitiative (list)VoidList of active initiatives in set

CcoCampaignModelPooledResource

Campaign model wrapper for a pooled resource

Functions

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

CcoCampaignModelProvince

Model safe context wrapper for a campaign province

Functions

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

CcoCampaignModelRoot

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

Functions

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

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