UI Symbols Documentation

Contexts


Campaign

CcoCampaignAncillary

Component context wrapper for a campaign ancillary

Functions

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

CcoCampaignBattle

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

Functions

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

CcoCampaignCharacter

Component context wrapper for a campaign character

Functions

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

CcoCampaignCharacterSkill

Component context wrapper for a campaign character skill

Functions

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

CcoCampaignCharacterSkillLevelDetails

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

Functions

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

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

CcoCampaignMilitaryForce

Component context wrapper for a campaign military force

Functions

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

CcoCampaignMission

Component context wrapper for a CAMPAIGN_MISSION

Functions

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

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

CcoCampaignPooledResource

Wrapper for a campaign pooled resource

Functions

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

CcoCampaignProvince

Wrapper for a campaign province.

Functions

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

CcoCampaignRoot

Functions

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

CcoCampaignSettlement

Wrapper for a campaign settlement.

Functions

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

CcoCampaignTechnology

Component context wrapper for a campaign technology

Functions

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

CcoCampaignUnit

Component context wrapper for a campaign unit

Functions

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

CcoCookingDish

Wrapper for a COOKING_DISH struct

Functions

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

Record

CcoAbilityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ViewInDbVoidVoid
RecordListVoidVoid
OnScreenDescriptionVoidVoid
OnScreenNameVoidVoid
AbilityVoidVoid
KeyVoidVoid

CcoActionResultRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TargetEffectBundleVoidVoid
ActorEffectBundleVoidVoid
KeyVoidVoid
RecordListVoidVoid
TargetEffectBundleTurnsVoidVoid
ActorEffectBundleTurnsVoidVoid

CcoAdviceLevelRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
AdvisorNameVoidVoid
InfoTextVoidVoid
TextVoidVoid
TitleVoidVoid
SubCategoryVoidVoid
CategoryVoidVoid
AdviceThreadVoidVoid
KeyVoidVoid

CcoAgentActionRecord

Functions

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

CcoAgentCultureDetailRecord

Functions

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

CcoAgentRecord

Record wrapper for an AGENT_RECORD

Functions

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

CcoAgentSubtypeRecord

Record wrapper for agent_subtypr_record

Functions

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

CcoAncillariesCategoryRecord

Record wrapper for an ancillaries_category_record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SortOrderIntVoidReturns an int with the category sort order
IconNameStringVoidReturns the name of the icon that is used for this category
OnscreenNameUniStringVoidReturns the localised name of the category
CategoryStringVoidReturns a string from the category enum
KeyStringVoidReturns the key of the record
IsHiddenBoolVoidReturns true if this ancillary catgeory should be hidden in ui
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
RecordListCcoAncillariesCategoryRecord (list)VoidReturns a list with all entries from the ancillaries_category_table
IsFusableBoolVoidReturns true if items from this category can be fused
DefaultEntryTooltipUniStringVoidReturns a localised default tooltip, for when no ancillary of this category is equipped
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
IsRuneBoolVoidReturns true if this subcategory is a rune
RecordListCcoAncillariesSubcategoryRecord (list)VoidReturns a list of all subcategories in the database
SubcategoryStringVoidReturns the subcategory string/key
OnscreenNameUniStringVoidReturns the localised name of the subcategory

CcoAncillaryRecord

Record wrapper for a ancillary_record

Functions

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

CcoAncillarySetRecord

Record wrapper for an ancillary set record

Functions

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

CcoAncillaryTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
IconVoidVoid
KeyVoidVoid

CcoAncillaryUniquenessGroupingRecord

Record wrapper for a ancillary_uniqueness_grouping_record

Functions

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

CcoArmoryItemRecord

Record wrapper for armory item record

Functions

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

CcoArmoryItemSetRecord

Wrapper for a ARMORY_ITEM_SET_RECORD

Functions

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

CcoArmoryItemUiTypeRecord

Wrapper for a ARMORY_ITEM_UI_TYPE_RECORD

Functions

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

CcoArmoryItemVariantRecord

Wrapper for an armory item variant record

Functions

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

CcoArmorySlotTypeRecord

Wrapper for an armory slot type record.

Functions

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

CcoArmySpecialAbilityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UniqueIDVoidVoid
ArmySpecialAbilityKeyVoidVoid
UnitSpecialAbilityContextVoidVoid
EnablesSiegeAssaultVoidVoid

CcoBannerRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PermittedUnitSetsVoidVoid
CombatPotentialAdjustmentsVoidVoid
BannerVoidVoid
EffectBundleRecordVoidVoid

CcoBattleClimateWeatherDescriptionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
SpottingScalarVoidVoid
ProbabilityVoidVoid
ColdFatigueVoidVoid
HeatFatigueVoidVoid
SeasonRecordContextVoidVoid
WeatherRecordContextVoidVoid
ClimateRecordContextVoidVoid

CcoBattleCurrencyArmySpecialAbilitiesCostValueRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CostValueVoidVoid
BattleSecondaryCurrencyTypeContextVoidVoid
ArmySpecialAbilityContextVoidVoid

CcoBattleCurrencyUnitAbilitiesCostValueRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CostValueVoidVoid
ItemTypeContextVoidVoid
CurrencyTypeContextVoidVoid

CcoBattleEntityRecord

Functions

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

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
GroupsForCategoryCcoBattlePurchasableGroupRecord (list)String(CategoryKey) Get the list of CcoBattlePurchasableGroupRecord's in the specified category
RecordListCcoBattlePurchasableItemsJunctionRecord (list)VoidGet the full list of available CcoBattlePurchasableItemsJunctionRecord's

CcoBattlePurchasableItemsUiCategoryRecord

Wrapper for a UI Battle Purchasable Items Junction record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoBattlePurchasableItemsUiCategoryRecord (list)Void
CategoryKeyStringVoid

CcoBattleRecord

Functions

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

CcoBattleResultTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BattleResultTypeVoidVoid
ResultScreenNameVoidVoid
RecordListVoidVoid
UnitXpGainVoidVoid
ResultDescriptionVoidVoid

CcoBattleSecondaryCurrencySourceTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
UiLocalisedNameVoidVoid
IsAllianceBasedVoidVoid
SourceTypeVoidVoid
DescriptionVoidVoid

CcoBattleSecondaryCurrencyTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
UiIconPathVoidVoid
UiLocalisedNameVoidVoid
CurrencyTypeVoidVoid

CcoBattleSetPieceArmiesCharacterRecord

Functions

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

CcoBattleSetPieceArmiesCharactersItemRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CharacterItemContextVoidVoid
NameVoidVoid

CcoBattleSetPieceArmiesCharactersSkillRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
LevelVoidVoid
SkillContextVoidVoid
CharacterNameVoidVoid

CcoBattleSetPieceArmiesUnitRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PercentageNumMenVoidVoid
KeyVoidVoid
UnitLevelVoidVoid
UnitRecordContextVoidVoid

CcoBattleSetPieceArmyRecord

Wrapper for a BATTLE_SET_PIECE_ARMY_RECORD

Functions

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

CcoBattleSetPieceFrontendGroupRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
BattleListVoidVoid
CharacterListVoidVoid
CampaignMapContextVoidVoid
SortOrderVoidVoid
KeyVoidVoid

CcoBattleSetPieceFrontendGroupsToCharacterRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
FrontendGroupContextVoidVoid
CharacterContextVoidVoid

CcoBattleSetPieceRecord

Wrapper for a BATTLE_SET_PIECE_RECORD

Functions

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

CcoBattleTypeCheatSheetEntryRecord

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

Functions

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

CcoBattleTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ListOrderVoidVoid
NameVoidVoid
KeyVoidVoid
RecordListVoidVoid
DescriptionVoidVoid
MaxTeamsizeVoidVoid
DefenderFundsRatioVoidVoid
DefenderVictoryConditionsListVoidVoid
AttackerVictoryConditionsListVoidVoid

CcoBattleVortexRecord

Wrapper for a BATTLE_VORTEX_RECORD

Functions

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

CcoBattleWeatherTypeRecord

Functions

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

CcoBattlefieldEngineRecord

Wrapper for a BATTLEFIELD_ENGINE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoBattlefieldEngineRecord (list)Void
CanBeDismantledBoolVoid
BattleEntityContextCcoBattleEntityRecordVoid
MissileWeaponContextCcoMissileWeaponRecordVoid
KeyStringVoid

CcoBattlefieldSiegeVehicleRecord

Wrapper for BATTLEFIELD_SIEGE_VEHICLE_RECORD

Functions

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

CcoBattlefieldSiegeVehiclesCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProbabilityVoidVoid
CapVoidVoid
VehicleContextVoidVoid
RecordListVoidVoid

CcoBuildingChainRecord

Wrapper for a building chain record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CyclicBuildingTreeTreeDataContextReturns a cyclical tree structure for buildings that have a lifecycle.
BuildingTreeTreeDataCcoCampaignBuildingSlotReturns a tree structure with all the levels in the chain.
CurrentSlotUpgradeListCcoBuildingLevelRecord (list)CcoCampaignBuildingSlotReturns a list with the upgrades of the slot passed in that are part of this chain.
NameUniStringVoidReturns the localised name of this chain.
OptionalSortOrderIntVoidReturns an int with the sort order of this chain (compared to other chains)
OptionalTierIconStringVoidReturns the optional tier icon defined in the table, or an empty string if this doesn't exist
BuildingSuperchainContextCcoBuildingSuperchainRecordVoidReturns the context of the superchain that this chain is part of.
MinUniqueLevelIntVoidReturns an int with the minimum level that is faction unique. Returns -1 if no such level exists.
LevelsListCcoBuildingLevelRecord (list)VoidReturns a list with all the levels in this chain.
LevelZeroBuildingLevelContextCcoBuildingLevelRecordVoidReturns the context of the first building level in the chain.
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.
TechnologyCategoryStringVoidReturns a string with the building chain category type.
MaximumLevelIntVoidReturns the maximum level in this chain.
BuildingSetContextCcoBuildingSetRecordVoidReturns the context of this chain's set.
KeyStringVoidReturns the key of the record.
MaximumChainColumnIntVoidReturns the maximum number of building levels that share the same level (for branching trees)
BuildingBrowserSlotContextCcoCampaignBuildingSlotContext, CcoCampaignFaction (optional)Returns the slot where this chain is built if that exists. If not, returns the next empty slot available. Returns null if there is no active empty slot.
RecordListCcoBuildingChainRecord (list)VoidReturns a list with all the records in building_chains table.

CcoBuildingCultureVariantRecord

Functions

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

CcoBuildingLevelRecord

Record wrapper for a BUILDING_LEVEL_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ShouldShowBuildingLevelInUiForTechnologyBoolVoidReturns true if this building should be shown in ui as a requirement for a technology
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
PlayerVariantRecordContextCcoBuildingCultureVariantRecordVoidReturns the culture variant of this building for the player faction
CanConvertBoolVoidReturns true if this building level can be converted
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
IsBuiltInSlotBoolCcoCampaignBuildingSlotReturns true if this building level is built in the passed in slot, or if any building level above it is built
DowngradesToLevelContextCcoBuildingLevelRecordVoidReturns the context of the level it downgrades to
FoodCostIntVoidReturns the amount of food this building will require to be constructed
IsResourceBuildingBoolVoidReturns true if this building is a resource building(provides resource when built)
ResourceRecordContextCcoResourceRecordVoidReturns the context of the resource for this building, if any
CanPlayerBuildThisBoolVoidReturns true if this building is available to the players faction
PrimarySlotBuildingLevelRequirementIntVoidReturns the level of the primary slot that needs to be built for this level to be available
ResourceCostContextCcoCampaignResourceTransactionCcoCampaignBuildingSlotReturns the context of the (pooled) resource transaction cost of this building
HasResourceRequirementsBoolVoidReturns true if this building level needs resources to build
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
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
SlaveCapContributionIntVoidReturns the slave constribution for this building
AdditionalDependentUnitsListCcoMainUnitRecord (list)VoidReturns a list with this building's additional dependent units
IsActiveForBuildingBrowserBoolCcoCampaignBuildingSlotReturns true if this building can be shows as the active state in the building browser
UpkeepCostIntVoidReturns the upkeep cost for this building level
RequiredTechnologiesListCcoTechnologyRecord (list)VoidReturns a list with the required technologies for this building to become available
CreateCostIntContext, CcoCampaignFaction (optional)Returns the cost to create this building. If passed either a settlement or a character, it will return the cost based on any bonus values those might have
OnlyInCapitalBoolVoidReturns true if this can only be built in the capital
UpgradesListCcoBuildingLevelRecord (list)VoidReturns a list with this building level's upgrades
IssueCommandForBuildingBrowserVoidCcoCampaignBuildingSlotIssues the appropriate command when clicking on a building (cancel construction if building, build if it can etc)
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
RecordListCcoBuildingLevelRecord (list)VoidReturns a list with all the building level records in the table
OpenBuildingInfoPanelVoidExpressionState, Context, CcoCampaignBuildingSlot, Bool (optional), CcoCampaignFaction (optional)If the component has a BuildingInfoPanelMouseOver callback, it will initialise this with building info. Otherwise, it opens info panel with building info. If second argument is true, it will only show technology info
LevelIntVoidReturns the level of this building level
CanBuildInCurrentSlotBoolCcoCampaignBuildingSlotReturns true if this building can be built in the slot passed in
HealthOverrideFloatVoidReturns the health override of this building level
EffectListCcoEffect (list)CcoCampaignBuildingSlot (optional)Returns a list with the effects provided by this building
IsEpisodicRestrictedBoolVoidReturns true if the building is restricted by mission etc
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
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.
CanAffordBoolContext, CcoCampaignFaction (optional)Returns true if the settlement/character passed in can afford to build this
TechListCcoTechnologyRecord (list)VoidReturns a list with technologies unlocked by this building
EncyclopediaRedirectBuildingStringVoidReturns a string with the encyclopedia redirect link for this building
IsBuiltInProvinceBoolCcoCampaignProvinceReturns true if this building level, or a building level above this, is built in the passed in province
FactionUniqueBoolVoidReturns true if this building is unique in the faction/can only be built once in the faction
IsCurrentConstructionItemForSlotBoolCcoCampaignBuildingSlotReturns true if this level is the one currently in construction in the slot passed in
KeyStringVoidReturns the key of the building level record
UnitListCcoMainUnitRecord (list)Context, CcoCampaignFaction (optional)Returns a list with the units provided by this building. Needs passing a settlement or character context in order to check for permissions
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)
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
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

CcoBuildingSetRecord

Record wrapper for a BUILDING_SET_RECORD

Functions

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

CcoBuildingSuperchainRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ChainsForProvinceListVoidVoid
ChainListVoidVoid
RecordListVoidVoid
KeyVoidVoid

CcoBulletPoint

Context wrapper for a bullet point

Functions

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

CcoCampaignBattlePresetRecord

Functions

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

CcoCampaignDecisionChoiceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
IndexVoidVoid
DecisionRecordContextVoidVoid
PayloadCharacterTraitListVoidVoid
LabelVoidVoid
TitleVoidVoid

CcoCampaignDecisionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
DescriptionVoidVoid
TitleVoidVoid
KeyVoidVoid
ImageVoidVoid
ChoiceListVoidVoid

CcoCampaignEffectListRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
EffectsVoidVoid
KeyVoidVoid

CcoCampaignEffectScopeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
LocalisedTextVoidVoid
KeyVoidVoid

CcoCampaignFactionCheatSheetEntryRecord

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

Functions

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

CcoCampaignGroupRecord

Wrapper for a campaign group record

Functions

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

CcoCampaignMapPlayableAreaRecord

Wrapper for CAMPAIGN_MAP_PLAYABLE_AREA_RECORD

Functions

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

CcoCampaignMapWindsOfMagicAreaRecord

Functions

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

CcoCampaignMapWindsOfMagicStrengthRecord

Wrapper for a CAMPAIGN_MAP_WINDS_OF_MAGIC_STRENGTH_RECORD record

Functions

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

CcoCampaignOperationSetRecord

Wrapper for a CAMPAIGN_OPERATION_SET_RECORD

Functions

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

CcoCampaignPayloadRecord

Wrapper for a CAMPAIGN_PAYLOAD_RECORD

Functions

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

CcoCampaignPayloadResourceTransactionRecord

Wrapper for a CAMPAIGN_PAYLOAD_RESOURCE_TRANSACTION_RECORD

Functions

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

CcoCampaignPayloadUnitComponentRecord

Wrapper for a CAMPAIGN_PAYLOAD_UNIT_COMPONENT_RECORD

Functions

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

CcoCampaignStormTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
RespectExcludedRegionsTableVoidVoid
CanSpawnOverCharacterVoidVoid
ForSeaVoidVoid
ForLandVoidVoid
CanMoveVoidVoid
CanDecayVoidVoid
KeyVoidVoid

CcoCampaignStreakEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
CampaignStreakKeyVoidVoid
EffectUnfilteredListVoidVoid
OnScreenNameVoidVoid
EffectListVoidVoid
RecordListVoidVoid
MinVoidVoid
MaxVoidVoid

CcoCampaignStreakRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
MinVoidVoid
ResetTurnsVoidVoid
MaxVoidVoid
TypeVoidVoid
KeyVoidVoid
StreakEffectListVoidVoid

CcoCampaignVideoRecord

Functions

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

CcoCapturePointCategoryTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LocalisedNameVoidVoid
RecordListVoidVoid
KeyVoidVoid
IconPathVoidVoid

CcoCapturePointTypeRecord

A DB record wrapper for a battle capture point type

Functions

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

CcoCaravanContractRecord

Wrapper for a CARAVAN_CONTRACT_RECORD

Functions

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

CcoCdirEventsCategoryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
TypeVoidVoid
OnScreenNameVoidVoid
CategoryKeyVoidVoid

CcoCdirEventsDilemmaChoiceDetailRecord

Record wrapper for a CDIR_EVENTS_DILEMMA_CHOICE_DETAIL_RECORD

Functions

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

CcoCharacterAncillaryQuestUiDetailRecord

Record wrapper for character ancillary quest details

Functions

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

CcoCharacterSkillRecord

Wrapper for a character skill record.

Functions

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

CcoCharacterTrainingDilemmaChoiceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LocalisedLabelVoidVoid
KeyVoidVoid
RecordListVoidVoid
IndexVoidVoid
ChoiceEffectRecordVoidVoid
DilemmaRecordContextVoidVoid

CcoCharacterTrainingDilemmaRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
TrainingEffectTypeVoidVoid
KeyVoidVoid
ChoiceListVoidVoid
LocalisedDescriptionVoidVoid
LocalisedTitleVoidVoid

CcoCharacterTraitLevelRecord

Functions

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

CcoCharacterTraitRecord

Functions

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

CcoClimateRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid

CcoCookingIngredientGroupRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FlavourTextVoidVoid
RecordListVoidVoid
ColourVoidVoid
IngredientsVoidVoid
KeyVoidVoid
IconVoidVoid
DisplayNameVoidVoid

CcoCookingIngredientRecord

Record wrapper for a COOKING_INGREDIENT_RECORD

Functions

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

CcoCookingRecipeRecord

Record wrapper for a COOKING_RECIPE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconStringVoidReturns a string with the icon of the recipe
IsRequiredIngredientBoolCcoCookingIngredientRecordReturns true if the passed in ingredient is part of the required ingredients for this recipe
RecordListCcoCookingRecipeRecord (list)VoidReturns a list of all recipes from the db
KeyStringVoidReturns a string with the key of the record
AlliedUnitEffectsContextCcoCampaignEffectListRecordVoidReturns a CcoCampaignEffectListRecord with the allied unit effect list of this recipe
EnemyUnitEffectsContextCcoCampaignEffectListRecordVoidReturns a CcoCampaignEffectListRecord with the enemy unit effect list of this recipe
FactionLeaderEffectsContextCcoCampaignEffectListRecordVoidReturns a CcoCampaignEffectListRecord with the faction leader effect list of this recipe
FactionEffectsContextCcoCampaignEffectListRecordVoidReturns a CcoCampaignEffectListRecord with the faction effect list of this recipe
ResourceCostContextCcoResourceCostRecordVoidReturns a CcoResourceCostRecord with the cost of this recipe
RequiresSpecificIngredientBoolVoidReturns true if this recipe requires a specific ingredient
CookingRecipieVOIntVoidReturns an int with the VO type
DurationIntVoidReturns an int with the duration of the recipe
IndexIntVoidReturns an int with the db index of this recipe
FlavourTextUniStringVoidReturns a localised string with the flavour text/description of the recipe
DisplayTextUniStringVoidReturns a localised string with the display text/name of the recipe

CcoCorruptionCounterIntervalRecord

Wrapper for a CORRUPTION_COUNTER_INTERVAL_RECORD

Functions

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

CcoCorruptionTypeRecord

Wrapper for a CORRUPTION_TYPE_RECORD

Functions

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

CcoCultureRecord

Wrapper for a culture record

Functions

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

CcoCustomBattleCorruptionType

Wrapper for the corruption type setting in custom battle

Functions

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

CcoCustomBattleFactionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CultureSortOrderVoidVoid
SortOrderVoidVoid
FactionContextVoidVoid

CcoCustomBattleSettingRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
ValueVoidVoid
KeyVoidVoid
NameVoidVoid

CcoDaemonAbilityBarDescriptionRecord

wrapper for a DAEMON_ABILITY_BAR_DESCRIPTION_RECORD

Functions

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

CcoDeployableRecord

Functions

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

CcoDeployablesCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CapVoidVoid
DeployableContextVoidVoid
RecordListVoidVoid
ProbabilityVoidVoid

CcoDilemmaRecord

Record wrapper for a DILEMMA_RECORD

Functions

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

CcoDiplomaticStanceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
StanceVoidVoid
OnscreenTextVoidVoid
KeyVoidVoid
StatusStateVoidVoid

CcoElectorCountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitRewardContextVoidVoid
AncillaryRewardContextVoidVoid
MapPosVoidVoid
MapPosYVoidVoid
MapPosXVoidVoid
MinisterialPositionEffectBundleVoidVoid
CapitalRegionContextVoidVoid
RecordListVoidVoid

CcoEndTurnNotificationRecord

Functions

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

CcoFactionRecord

Wrapper for a faction record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NameWithIconUniStringVoidReturns the faction's name along with a small icon of their flag
NameUniStringVoidReturns the faction's localised name
PrimaryColourColourVoidReturns the faction's primary colour
KeyStringVoidReturns the key of this faction record
IsFactionUnlockedBoolVoidReturns if the faction is unlocked
FactionSkinStringVoidReturns faction's skin
RecordListCcoFactionRecord (list)VoidReturns a list of all CcoFactionRecords
FactionSpecificAscendancyEffectListCcoEffect (list)VoidReturns the effects provided to this faction by all storm of magic ascendancy lores
MechanicListCcoEffect (list)VoidReturns the faction's mechanics as a list of CcoEffects
ClimatesListCcoSettlementClimateTypeRecord (list)String, StringReturns the list of CcoSettlementClimateTypeRecord with the climate list for this faction
OwnershipProductRequirementListCcoOwnershipProductRequirement (list)VoidReturns the list of CcoOwnershipProductRequirement required to be owned for this faction, if it came in a DLC
OwnershipProductRecordListCcoOwnershipProductRecord (list)VoidReturns the list of CcoOwnershipProductRecord required to be owned for this faction, if it came in a DLC
TextReplacementKeysString (list)VoidReturns the list of text replacement keys for this faction in order evaluated. Used to "skin" text using the ui_text_replacements table
FlagDirStringVoidReturns flag directory for this faction
FlagPathRotatedStringVoidReturns the path to the rotated version of the faction's flag
SubcultureContextCcoSubcultureRecordVoidReturns the faction's subculture context
FlagPathLargeStringVoidReturns the path to the large version of the faction's flag
FlagPathMediumStringVoidReturns the path to the medium version of the factio'n flag
FlagPathSmallStringVoidReturns the path to the small version of the faction's flag

CcoFactionSetRecord

Wrapper for a FACTION_SET_RECORD

Functions

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

CcoFormationRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NameVoidVoid
IsNavalVoidVoid
IsArmyVoidVoid
IconNameVoidVoid
FormationVoidVoid
DescriptionVoidVoid
RecordListVoidVoid
OrderVoidVoid
TooltipVoidVoid

CcoFrontendFactionLeaderRecord

Functions

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

CcoGroundTypeRecord

Functions

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

CcoGroundTypeToStatEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ValueForDisplayVoidVoid
ValueVoidVoid
GroundTypeVoidVoid
RecordListVoidVoid
EffectTextWithValueVoidVoid
EffectTextVoidVoid
IsPositiveVoidVoid
AffectedGroupNameVoidVoid

CcoGroupPooledResourceEffectRecord

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

Functions

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

CcoIncidentRecord

Wrapper for an incident record

Functions

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

CcoInitiativeRecord

Record wrapper for a INITIATIVE_RECORD

Functions

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

CcoInitiativeSetCategoryRecord

Wrapper for a INITIATIVE_SET_CATEGORY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoInitiativeSetCategoryRecord (list)Void
KeyStringVoid
DisplayNameUniStringVoid

CcoInitiativeSetRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CategoryContextVoidVoid
ActivationCooldownVoidVoid
ActiveInitiativeLimitVoidVoid
ItemsVoidVoid
KeyVoidVoid

CcoLabSettingRecord

Wrapper for a LAB_SETTING_RECORD

Functions

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

CcoLandUnitArticulatedVehicleRecord

Wrapper for a LAND_UNIT_ARTICULATED_VEHICLE_RECORD

Functions

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

CcoLandUnitsToExtraEngineRecord

Wrapper for a LAND_UNITS_TO_EXTRA_ENGINE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoLandUnitsToExtraEngineRecord (list)Void
AttachArticulationIntVoid
BattleEngineContextCcoBattlefieldEngineRecordVoid
LandUnitContextCcoUnitLandRecordVoid

CcoLoadingScreenQuotesRecord

Record wrapper for a loading screen quote record

Functions

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

CcoMainUnitRecord

Wrapper for a main unit

Functions

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

CcoMeleeWeaponRecord

Functions

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

CcoMercenaryRecruitmentInfoRecord

Record wrapper for a mercenary recruitment info record

Functions

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

CcoMissileWeaponRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
UseSecondaryAmmoPoolVoidVoid
ProjectileContextListVoidVoid
PrecursorVoidVoid
KeyVoidVoid

CcoMissionIssuerRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
NameVoidVoid
IconPathVoidVoid
DefaultRoundsBetweenVoidVoid
KeyVoidVoid

CcoMissionRecord

Wrapper for a MISSION_RECORD

Functions

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

CcoMortuaryCultCategoryRecord

Wrapper for a MORTUARY_CULT_CATEGORY_RECORD

Functions

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

CcoMountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
EntityVoidVoid
KeyVoidVoid

CcoMountableArtilleryUnitsCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
FactionContextVoidVoid
ProbabilityVoidVoid
CapVoidVoid
UnitRecordContextVoidVoid

CcoMultiplayerCampaignSettingRecord

Wrapper for a MULTIPLAYER_CAMPAIGN_SETTING_RECORD

Functions

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

CcoMultiplayerCampaignSettingsOptionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
TooltipVoidVoid
ValueVoidVoid
OrderVoidVoid
LocalisedNameVoidVoid
MultiplayerCampaignSettingContextVoidVoid

CcoNarrativeViewerEntryRecord

Wrapper for a NARRATIVE_VIEWER_ENTRY_RECORD

Functions

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

CcoNarrativeViewerTabRecord

Wrapper for a NARRATIVE_VIEWER_TAB_RECORD

Functions

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

CcoNewContentPatchNoteRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
OrderVoidVoid
KeyVoidVoid
LocalisedPatchNoteVoidVoid

CcoOwnershipProductRecord

Wrapper for a OWNERSHIP_PRODUCT_RECORD

Functions

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

CcoPlagueEffectList

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

Functions

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

CcoPlagueEffectRecord

Wrapper for a PLAGUE_EFFECT_RECORD

Functions

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

CcoPlagueRecord

Wrapper for a PLAGUE_RECORD

Functions

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

CcoPlagueSpecialCompositionRecord

Wrapper for a PLAGUE_SPECIAL_COMPOSITION_RECORD

Functions

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

CcoPooledResourceThresholdOperationSetRecord

Wrapper for a pooled_resource_threshold_operation_set_record

Functions

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

CcoProjectileBombardmentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
NumProjectilesVoidVoid
RadiusSpreadVoidVoid
ProjectileContextVoidVoid
KeyVoidVoid

CcoProjectileRecord

Cco wrapper for querying a projectile record

Functions

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

CcoProvinceAutomanagementFocusRecord

Wrapper for a PROVINCE_AUTOMANAGEMENT_FOCUS_RECORD

Functions

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

CcoProvinceInitiativeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
StatusForCurrentProvinceVoidVoid
IconPathVoidVoid
OrderVoidVoid
LocalisedNameVoidVoid
KeyVoidVoid
EffectBundleContextVoidVoid
RecordListVoidVoid
EffectBundleContextForCurrentProvinceVoidVoid

CcoRegionGroupRecord

Wrapper for a REGION_GROUP_RECORD

Functions

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

CcoRegionRecord

Wrapper for a REGION_RECORD

Functions

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

CcoReignOfChaosRecord

Wrapper for a REIGN_OF_CHAOS_RECORD

Functions

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

CcoResourceCostRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PooledResourceCostsListVoidVoid
RequiredAncillariesListVoidVoid
RequiredTradeResourcesListVoidVoid
ExpenditureTypeVoidVoid
IncomeTypeVoidVoid
TreasuryCostVoidVoid
IdVoidVoid

CcoResourceRecord

Functions

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

CcoRitualCategoryGroupRecord

Wrapper for a RITUAL_CATEGORY_GROUP_RECORD

Functions

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

CcoRitualCategoryRecord

Wrapper for a RITUAL_CATEGORY_RECORD

Functions

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

CcoRitualChainRecord

Wrapper for a RITUAL_CHAIN_RECORD

Functions

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

CcoRitualPayloadAncillaryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
AncillaryContextVoidVoid
PayloadVoidVoid

CcoRitualPayloadChangeAgentCapacityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PayloadContextVoidVoid
AgentRecordContextVoidVoid
RecordListVoidVoid
CapacityVoidVoid

CcoRitualPayloadChangeUnitCapacityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CapacityVoidVoid
UnitRecordContextVoidVoid
PayloadContextVoidVoid

CcoRitualPayloadDiplomaticAttitudeChangeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
AttitudeDeltaVoidVoid
PayloadVoidVoid

CcoRitualPayloadRecord

Wrapper for a ritual payload record

Functions

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

CcoRitualPayloadSpawnAgentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SpawnToPoolVoidVoid
AgentSubtypeContextVoidVoid
AgentTypeContextVoidVoid
PayloadVoidVoid
RecordListVoidVoid

CcoRitualPayloadSpawnArmyRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
SpawnAtRitualSiteVoidVoid
FactionOverrideContextVoidVoid
IdVoidVoid
SpawnableForceContextVoidVoid
PayloadVoidVoid

CcoRitualPayloadSpawnMercenaryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
IdVoidVoid
SpawnableUnitContextVoidVoid
PayloadVoidVoid

CcoRitualPayloadSpawnStormRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RegionContextVoidVoid
PayloadVoidVoid
StormTypeContextVoidVoid
RecordListVoidVoid
StrengthVoidVoid
MaxTurnsDurationVoidVoid

CcoRitualPayloadTeleportArmyRecord

Wrapper for a RITUAL_PAYLOAD_TELEPORT_ARMY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoRitualPayloadTeleportArmyRecord (list)VoidReturns a list of all teleport payloads in the database
RegionContextCcoRegionRecordVoidReturns a CcoRegionRecord with the region record where the army will teleport to
PayloadContextCcoRitualPayloadRecordVoidReturns a CcoRitualPayloadRecord with the payload context

CcoRitualPayloadTriggerDilemmaRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
DilemmaContextVoidVoid
PayloadVoidVoid

CcoRitualRecord

Record wrapper for a RITUAL_RECORD

Functions

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

CcoSeasonRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
OnscreenVoidVoid
KeyVoidVoid

CcoSettlementClimateTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UiIconImageVoidVoid
TypeVoidVoid
RecordListVoidVoid
UiDescriptionVoidVoid
UiNameVoidVoid
UiBackgroundImageVoidVoid

CcoSpawnableForceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
RecordListVoidVoid
UnitListsListVoidVoid
UnitsListVoidVoid

CcoSpawnableForceUnitJunctionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
MinXpVoidVoid
MinAmountVoidVoid
MaxXpVoidVoid
MaxAmountVoidVoid
IdVoidVoid
UnitContextVoidVoid
SpawnableForceVoidVoid

CcoSpawnableForceUnitListJunctionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MaxXpVoidVoid
MaxAmountVoidVoid
IdVoidVoid
UnitListContextVoidVoid
SpawnableForceVoidVoid
RecordListVoidVoid
MinXpVoidVoid
MinAmountVoidVoid

CcoSpecialAbilityGroupRecord

Wrapper for a SPECIAL_ABILITY_GROUP_RECORD record from special_ability_groups_tables

Functions

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

CcoSpecialAbilityIntensitySettingRecord

Wrapper for a SPECIAL_ABILITY_INTENSITY_SETTING_RECORD

Functions

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

CcoSpecialAbilityPhaseRecord

Wrapper for a SPECIAL_ABILITY_PHASE_RECORD

Functions

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

CcoSpecialAbilityPhaseStatEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
HowVoidVoid
StatVoidVoid
ValueVoidVoid
PhaseVoidVoid

CcoSubcultureRecord

Wrapper for a subculture record

Functions

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

CcoTechnologyRecord

Record wrapper for a technology record

Functions

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

CcoTechnologyUiGroupRecord

Record wrapper for technology ui group record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
RightMostTechnologyCcoCampaignTechnologyCcoCampaignFaction (optional)Returns the context of the right-most technology for this group
LeftMostTechnologyCcoCampaignTechnologyCcoCampaignFaction (optional)Returns the context of the left-most technology for this group
BottomMostTechnologyCcoCampaignTechnologyCcoCampaignFaction (optional)Returns the context of the bottom-most technology for this group
TopMostTechnologyCcoCampaignTechnologyCcoCampaignFaction (optional)Returns the context of the top-most technology for this group
RecordListCcoTechnologyUiGroupRecord (list)VoidReturns a list with all technology ui groups in the table
BackgroundImageStringVoidReturns the background image for this group
DescriptionUniStringVoidReturns the localised description of this group, if any
NameUniStringVoidReturns the localised name of this group, if any
ColourColourVoidReturns the colour of the group

CcoTechnologyUiTabRecord

Wrapper for a TECHNOLOGY_UI_TAB_RECORD

Functions

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

CcoTeleportationNetworkNodeRecord

Wrapper for a TELEPORTATION_NETWORK_NODE_RECORD

Functions

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

CcoTeleportationNodeTemplateRecord

Wrapper for a TELEPORTATION_NODE_TEMPLATE_RECORD

Functions

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

CcoTimeOfLegendsCampaignRecord

Wrapper for a TIME_OF_LEGENDS_CAMPAIGN_RECORD

Functions

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

CcoTreasureHuntExtraInformationRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OverlayImageVoidVoid
ColourBlindModeOverlayVoidVoid
Option4ImageVoidVoid
Option3ImageVoidVoid
Option2ImageVoidVoid
Option1ImageVoidVoid
KeyVoidVoid

CcoUiColourRecord

Functions

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

CcoUiMainThemeOptionRecord

Wrapper for a UI_MAIN_THEME_OPTION_RECORD

Functions

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

CcoUiPurchasableEffectsToHexIdRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
TierVoidVoid
CategoryVoidVoid
HexIdVoidVoid
UnitPurchasableEffectContextVoidVoid

CcoUiUnitGroupParentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
GroupListVoidVoid
UnitListVoidVoid
MpCapVoidVoid
OrderVoidVoid
KeyVoidVoid
IconVoidVoid
OnscreenNameVoidVoid

CcoUiUnitGroupingRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
ParentGroupVoidVoid
KeyVoidVoid
IconVoidVoid
OnscreenVoidVoid
TooltipVoidVoid

CcoUiUnitStatRecord

Wrapper for a UI_UNIT_STAT_RECORD

Functions

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

CcoUiUnitStatusRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PriorityVoidVoid
KeyVoidVoid
IconPathVoidVoid
TooltipVoidVoid

CcoUnitAbilitiesAdditionalUiEffectRecord

Wrapper for a UNIT_ABILITIES_ADDITIONAL_UI_EFFECT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUnitAbilitiesAdditionalUiEffectRecord (list)Void
EffectStateStringVoid
SortOrderIntVoid
KeyStringVoid
LocalisedTextUniStringVoid

CcoUnitAbilityRecord

Functions

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

CcoUnitAbilityTypeRecord

Wrapper for a UNIT_ABILITY_TYPE_RECORD

Functions

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

CcoUnitAttributeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
IconPathVoidVoid
BulletTextVoidVoid
RemovesEffectTextVoidVoid
ImuedEffectTextVoidVoid
KeyVoidVoid

CcoUnitLandRecord

Wrapper for a UNIT_LAND_RECORD

Functions

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

CcoUnitListRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
UnitsListVoidVoid
KeyVoidVoid

CcoUnitPortholeCameraSettingRecord

Wrapper for a UNIT_PORTHOLE_CAMERA_SETTING_RECORD

Functions

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

CcoUnitPurchasableEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CategoryContextVoidVoid
EffectBundleContextVoidVoid
ResourceIconVoidVoid
ResourceNameVoidVoid
ResourceCostVoidVoid
CostContextVoidVoid
KeyVoidVoid

CcoUnitPurchasableEffectsCategoryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
IconPathVoidVoid
OnscreenDescriptionVoidVoid
OnscreenNameVoidVoid

CcoUnitSetRecord

Wrapper for a UNIT_SET_RECORD

Functions

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

CcoUnitSetToMpUnitCapRecord

Wrapper for a UNIT_SET_TO_MP_UNIT_CAP_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUnitSetToMpUnitCapRecord (list)Void
CapIntVoid
LocalisedNameUniStringVoid

CcoUnitSpecialAbilityRecord

Functions

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

CcoUnitsCustomBattleMountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CostVoidVoid
LocalisedDescriptionVoidVoid
IconNameVoidVoid
MountNameVoidVoid
MountedUnitContextVoidVoid
BaseUnitContextVoidVoid

CcoUnitsCustomBattlePermissionRecord

Functions

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

CcoUnitsCustomBattleTypeCategoryRecord

Wrapper for a UNITS_CUSTOM_BATTLE_TYPE_CATEGORY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoUnitsCustomBattleTypeCategoryRecord (list)Void
IsHorizontalGroupBoolVoid
CategoryKeyStringVoid
CategoryNameUniStringVoid
CategoryDescriptionUniStringVoid

CcoUnitsCustomBattleTypeRecord

Wrapper for a UNITS_CUSTOM_BATTLE_TYPE_RECORD

Functions

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

CcoVictoryConditionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid

CcoVideoRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PlayVideoVoidVoid
KeyVoidVoid

Common

CcoAgentSubtypeAgentPair

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitDetailsContextCcoUnitDetailsVoid
AgentContextCcoAgentRecordVoid
AgentSubtypeContextCcoAgentSubtypeRecordVoid

CcoBattleResult

Wrapper for a battle result

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ResultTypeRecordContextCcoBattleResultTypeRecordVoid
IsDrawBoolVoid
IsLocalPlayerWinnerBoolVoid
OtherResultAllianceContextCcoBattleResultAllianceVoid
LocalResultPlayerAllianceContextCcoBattleResultAllianceVoid
DurationUniStringVoid

CcoBattleResultUnit

Wrapper for a battle result unit

Functions

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

CcoCampaignProvinceMercenaryPool

Component context wrapper for a province mercenary pool

Functions

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

CcoClickHoldContext

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HoldPercentFloatVoidReturns the percentage hold value

CcoContextSelection

Functions

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

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
UnitListCcoMainUnitRecord (list)ExpressionStateReturns a list of linked units if they exits, only valid to call when created with a CAMPAIGN_EFFECT
UnitListsListCcoUnitListRecord (list)VoidReturns a list of linked UNIT_LIST_RECORDs
InitiativeSetsListCcoInitiativeSetRecord (list)VoidReturns a list of linked INITIATIVE_SET_RECORDs
PlagueComponentContextCcoCampaignPlagueIngredientCcoCampaignFactionReturns the first linked plague component if it exists
ValueIntVoidReturns the raw value of the effect as a number
ManipulationInfoContextCcoCampaignDiplomacyManipulationInfoExpressionState, CcoCampaignFactionReturns the first linked CcoCampaignDiplomacyManipulationInfo if it exists
PriorityIntVoidReturns the priority of the effect, used for ordering and if 0 isn't shown in UI
RitualContextCcoRitualRecordExpressionStateReturns the first linked CcoRitualRecord if it exists
EffectScopeContextCcoCampaignEffectScopeRecordVoidReturns the CcoCampaignEffectScopeRecord if it exists
IsPositiveBoolVoidReturns true if this is a positive effect
DevUnitSetStringsFromEffectExcludedCcoString (list)ExpressionStateReturns a list of all the unit sets affected by the CAMPAIGN_EFFECT that are excluded (as strings with their owning effect key).debug, hide_in_ui
PooledResourceContextCcoCampaignPooledResourceExpressionState, String, ContextReturns the linked CcoCampaignPooledResource for the object passed in (faction, province manager etc), with the specified key, only valid to call when created with a CAMPAIGN_EFFECT
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
DevUnitsFromEffectExcludedCcoMainUnitRecord (list)ExpressionStateReturns a list of all the units affected by the CAMPAIGN_EFFECT that are excluded.debug, hide_in_ui
AbilityContextCcoUnitAbilityExpressionStateReturns the linked CcoUnitAbility with this effect if exists, only valid to call when created with a CAMPAIGN_EFFECT
AdditionalDetailsUniStringVoidReturns the additional description for this effect, if it exists
RitualListCcoRitualRecord (list)VoidReturns a list of all linked CcoRitualRecord.
LocalisedTextUniStringVoidReturns the localised text for the effect
UnitsFromEffectNotExcludedCcoMainUnitRecord (list)ExpressionStateReturns a list of all the units affected by the CAMPAIGN_EFFECT that are not excluded.
AdditionalDetailsIconStringVoidReturns the icon for the additional description of this effect, if it exists
UnitSetsFromAllSourcesListCcoUnitSetRecord (list)ExpressionStateReturns a list of linked unit sets from any sources that junction to unit sets, only valid to call when created with a CAMPAIGN_EFFECT
IconPathStringVoidReturns the icon path
AgentListCcoAgentRecord (list)ExpressionStateReturns a list of linked agent records if they exist, only valid to call when created with a CAMPAIGN_EFFECT
EffectKeyStringExpressionStateReturns the effect record key, only valid to call when created with a CAMPAIGN_EFFECT
PlagueListCcoPlagueRecord (list)ExpressionStateReturns a list of linked plague records if they exits, only valid to call when created with a CAMPAIGN_EFFECT
UnitSetsListCcoUnitSetRecord (list)ExpressionStateReturns a list of linked unit sets if they exist, 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
HostPlayerContextCcoNetworkPlayerVoidReturns the CcoNetworkPlayer for the host player
LocalPlayerContextCcoNetworkPlayerVoidReturns the CcoNetworkPlayer for the local player
FriendListCcoNetworkPlayer (list)VoidReturns the friend list of the local player as a list of CcoNetworkPlayer
StalledNetworkPlayerListCcoNetworkPlayer (list)VoidReturns list of CcoNetworkPlayers waiting to load into the game still
PlayerListCcoNetworkPlayer (list)VoidReturns list of CcoNetworkPlayers in the current game

CcoOwnershipProductRequirement

Wrapper for an ownership product mask

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OwnershipProductRecordListCcoOwnershipProductRecord (list)VoidReturns a list of CcoOwnershipProductRecord

CcoPieData

Functions

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

CcoPieSlice

Functions

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

CcoRangeWithContext

Functions

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

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

CcoScriptObjectList

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

Functions

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

CcoScriptTableNode

A wrapper for of a Lua Table, recursive type

Functions

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

CcoShapeshiftForm

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

Functions

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

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
StringValueUniStringVoidReturns the string part of the value
FloatValueFloatVoidReturns the numeric part of the value as a float

CcoTreeLink

Functions

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

CcoTreeLinkWithContexts

Functions

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

CcoUnitAbility

Wrapper for a BATTLE_SETUP_SPECIAL_ABILITY

Functions

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

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

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
FormatPercentageUniStringFloatReturns a formatted percentage using ICU library.string
StringLengthIntStringReturns the length of the given stringstring, deprecated
StringSubStringStringString, Int, Int (optional)Returns a substring between the given start position and optional lengthstring, deprecated
FormatNumberCustomUniStringFloat, FloatReturns a formatted number using ICU library.string
FormatNumberUniStringFloatReturns a formatted number using ICU library.string
IsStringEmptyBoolStringReturns true if the string is emptystring, deprecated
FormatUniStringExpressionState, UniString, ArgumentPackFormat the given string based on the argument liststring
StringReplaceUniStringExpressionState, UniString, UniString, UniStringTakes a source string as the first parameter, then replaces all instances of the second string param with the third string parameterstring, deprecated
StringContainsBoolExpressionState, UniString, UniStringReturns true if the first string contains the second stringstring, deprecated
StringEndsWithBoolExpressionState, UniString, UniStringReturns true if the first string ends 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
StringStartsWithBoolExpressionState, UniString, UniStringReturns true if the first string starts with the second stringstring, deprecated
ToUpperUniStringExpressionState, UniStringConvert string to an uppercase stringstring, deprecated
IsStringEmptyBoolUniStringReturns true if the string is emptystring, deprecated
ParseTextReplacementUniStringExpressionState, UniString, ArgumentPackReturns parsed text replacement tags in the given string and uses the list of overrides in priority order to retrieve the correct stringstring
FormatPercentageCustomUniStringFloat, IntReturns a formatted percentage using ICU library with the specified numebr of decimal places.string
ParseFactionTextReplacementUniStringExpressionState, UniString, CcoFactionRecordReturns parsed text replacement tags in the given string and uses the faction record to retrieve the correct stringstring

debug

NameReturn TypeArgumentsDescriptionTagsEvents
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
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
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
SetPrefAsIntVoidString, IntSets the specified int environment settingprefs
SetPrefAsFloatVoidString, FloatSets the specified float environment settingprefs
SetPrefAsBoolVoidString, BoolSets the specified boolean environment settingprefs
TogglePrefBoolVoidStringToggles the specified boolean environment settingprefs
PrefAsUniStringUniStringStringRetrieve the specified environment setting as a unistringprefs
PrefAsFloatFloatStringRetrieve the specified environment setting as a floatprefs
PrefAsIntIntStringRetrieve the specified environment setting as an intprefs
PrefAsBoolBoolStringRetrieve the specified environment setting as a boolprefs

deprecated

NameReturn TypeArgumentsDescriptionTagsEvents
StringLengthIntStringReturns the length of the given stringstring, deprecated
StringSubStringStringString, Int, Int (optional)Returns a substring between the given start position and optional lengthstring, deprecated
IsStringEmptyBoolStringReturns true if the string is emptystring, deprecated
StringReplaceUniStringExpressionState, UniString, UniString, UniStringTakes a source string as the first parameter, then replaces all instances of the second string param with the third string parameterstring, deprecated
StringContainsBoolExpressionState, UniString, UniStringReturns true if the first string contains the second stringstring, deprecated
FloatToPercentFloatFloatReturns value *100...math, deprecated
StringEndsWithBoolExpressionState, UniString, UniStringReturns true if the first string ends 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
StringStartsWithBoolExpressionState, UniString, UniStringReturns true if the first string starts with the second stringstring, deprecated
ToUpperUniStringExpressionState, UniStringConvert string to an uppercase stringstring, deprecated
IsStringEmptyBoolUniStringReturns true if the string is emptystring, deprecated

database

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

context

NameReturn TypeArgumentsDescriptionTagsEvents
GenerateContextListExpressionState, Int, Expression (optional)Returns a list with the given context repeated N amount of times.context
StoreListCcoContextListContextList, StringStores a context list with an id so you can easily retrieve itcontext
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
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
StoredContextFromParentContextExpressionState, StringReturns the stored context of specified type from the specified parentcontext
IsContextValidBoolContextReturns true if specified context is not nullcontext
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
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

Misc

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

sound

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

math

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

registry

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

flow

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

convert

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

component

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

tweakers

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

Front End

CcoCampaignStartInfo

Wrapper for frontend campaign start info

Functions

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

CcoCustomBattleLobby

Wrapper for the custom battle lobby

Functions

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

CcoCustomBattleMap

Wrapper for a custom map

Functions

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

CcoCustomBattlePlayerSlot

Functions

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

CcoCustomBattleSettings

Wrapper for the settings of custom battles

Functions

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

CcoCustomBattleTeam

Wrapper for the custom battle team

Functions

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

CcoLobbyBase

Functions

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

CcoMPCampaignLobby

Functions

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

CcoMPCampaignMap

Wrapper for a playable map in multiplayer campaigns

Functions

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

CcoMPCampaignSettings

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ToggleOptionForSettingVoidVoid
SetOptionForSettingVoidVoid
IsAllianceOnlyVoidVoid
ShouldShowAllianceOnlySettingVoidVoid
CanChangeSettingVoidVoid
GetCurrentOptionForSettingVoidVoid
GetOptionsForSettingVoidVoid
SetBattleAiStatsModifierVoidVoid
GetBattleAiStatsModifierVoidVoid
ToggleAllianceOnlyVoidVoid

Misc

CcoAbilityCollection

Wrapper for an AbilityCollection for nested abilities

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconPathStringVoidReturns the collection's icon file path
ShouldHideAbilityDescriptionBoolCcoUnitAbilityHides a component based on record is_hidden entry
AttributesCcoStringValue (list)VoidReturns the attributes associated with this collection
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
RechargeDisabledReasonsTextUniStringVoidReturns joined localised string of disabled reasons for this ability, if any (in melee, etc)
WindUpTimeRemainingSecsFloatVoidReturns the wind up time remaining in seconds. Wind up is the casting time essentially.
LeftClickTextUniStringVoidReturns some localised text that explains what left clicking on a button for this ability would currently do (activate, toggle targetting, toggle overcharge, etc)
RechargePercentFloatVoidReturns the cooldown percentage if in cooldown (0-1), 0 if not in cooldown
ManaUsedIntVoidReturns how much mana is used when activating this ability
RechargeTimeRemainingSecsFloatVoidReturns the cooldown time remaining seconds if ability is in cooldown
MiscastChanceFloatVoidReturns 0-1 value representing how likely to miscast when activate. A miscast will have negative impacts on the caster and the ability will fail to activate.
ActivePercentFloatVoidReturns the percent (0-1) the ability is through its active duration (progression until ability finishes), 0 if ability is not currently active
CanCurrentlyPerformBoolVoidReturns true if abiltiy can currently be activated
ActiveTimeRemainingSecsFloatVoid
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)
SetupAbilityContextCcoUnitAbilityVoidReturns the CcoUnitAbility setup for this ability (fixed information that doesnt change during the battle)
PerformAbilityForOwnerVoidVoidActivates the ability for the owner (unit/army)
IsPhaseActiveBoolCcoSpecialAbilityPhaseRecordReturns true if supplied CcoSpecialAbilityPhaseRecord is active in any of abilities phase trees
ActivePhaseListCcoPair (list)VoidReturns list of CcoPair; the active phases for each target essentially
IsTargettedAbilityBoolVoidReturns true if this is an ability that you have to select a target for
IsActiveBoolVoidReturns true if this abiltiy is currently active and applying its effects
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)
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
IntensityFloatVoidReturns the intensity that modifiable stats of this ability will be multiplied by
IsCurrentlyTargettingBoolVoidReturns true if this ability is currently being targetted by the player
CurrentStateStringVoidReturns a String representing the current state (active/passive/selected/inactive
CanBePurchasedBoolVoidReturns true if this ability can currently be afforded based on any required currencies (see CurrencyCosts)
RemainingUsesIntVoidReturns the number of remaining uses, -1 if unlimited
CurrencyCostsCcoPair (list)VoidReturns a list of CcoPair representing the costs required to activate this ability
WindUpPercentFloatVoidReturns the wind up percentage (0-1), 0 being not in windup and 1 being at the point where casts the spell. Wind up is the casting time essentially.

CcoBattleCaptureLocationsManager

Functions

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

CcoBattleCurrencyManager

Functions

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

CcoBattleEntity

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

Functions

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

CcoBattleGroup

Functions

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

CcoBattleLaboratoryInfo

Wrapper for the lab settings of a battle.

Functions

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

CcoBattlePurchasableArmyAbility

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

Functions

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

CcoBattlePurchasableUnit

Functions

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

CcoBattlePurchasableUnitAbility

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

Functions

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

CcoBattleReinforcementDebugUnits

Functions

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

CcoBattleReinforcementPool

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitsMatchCategoryBoolCcoBattlePurchasableUnit, CcoBattlePurchasableUnitDo the supplied purchasable units match the same unit category?
CanUseSpawnZoneReasonString (list)CcoBattleArmy, IntReturns the reason/state name of whether a spawn zone can be used or not
CanUseSpawnZoneBoolCcoBattleArmy, IntReturn whether the specific spawn zone can be used
NumSpawnZonesAvailableToArmyIntCcoBattleArmy, ContextListReturns how many of the listed spawn zones are currently available to the specified army
CanUseUnitBoolCcoBattleUnitReturn whether a specific unit is available to deploy (even if it cannot be deployed currently)
CostForUnitsFloatContextList, IntReturns cost for list of units for an army
UnitsMatchingUnitCategoryForArmyCcoBattlePurchasableUnit (list)CcoBattleArmy, CcoBattlePurchasableUnit, IntReturn vector of units in the matching category to the supplied unit, available to an army
UnitsCategorisedForArmyCcoGroupList (list)CcoBattleArmy, IntReturn vector of units available to 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
UnitsForArmyCcoBattlePurchasableUnit (list)CcoBattleArmy, IntReturn vector of units available to an army
PurchaseUnitVoidCcoBattlePurchasableUnit, CcoBattleArmy, IntPurchases a single unit for an army at a spawn zone
PurchaseUnitsVoidContextList, CcoBattleArmy, IntPurchases the list of units for an army at a spawn zone
HaveAnyUnitsBeenOnBattlefieldBoolContextListHave any of the units been on the battlefield during this battle?
CanPurchaseUnitsBoolContextList, CcoBattleArmy, IntReturn whether list of units is affordable to an army
CanPurchaseUnitBoolCcoBattlePurchasableUnit, CcoBattleArmy, IntReturn whether a specific unit is affordable to an army

CcoBattleResultAlliance

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ArmyContextVoidVoid
ResultTypeVoidVoid
ResultNameVoidVoid
ArmyListVoidVoid

CcoBattleResultArmy

Functions

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

CcoBattleSettlement

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MountedArtilleryLocationListVoidVoid
DestructionEffectsListVoidVoid
DestroyedPercentVoidVoid

CcoBattleSetup

Wrapper for a battle setup

Functions

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

CcoBattleSetupAlliance

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

Functions

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

CcoBattleSetupArmy

Contains initial setup data for the specified army

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PlayerNameUniStringVoidReturns the name of the player if human or the localised string for cpu if AI
FlagDirStringVoidReturns path to flags for the faction
UnitListCcoBattleSetupUnit (list)Bool (optional)Returns the list of units in this setup army, optional bool argument for whether hidden armies should be excluded
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)

CcoBattleSetupFaction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FactionRecordContextVoidVoid
FlagDirVoidVoid
NameVoidVoid

CcoBattleSetupInfo

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

Functions

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

CcoBattleSetupUnit

Wrapper for a BATTLE_SETUP_UNIT

Functions

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

CcoBattleStormOfMagic

Cco wrapper for querying and controlling the Storm Of Magic manager

Functions

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

CcoBattleSurvivalWave

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

Functions

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

CcoBattleTimeControl

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

Functions

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

CcoBattleToggleableSlotBuildable

Functions

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

CcoBattleUnitEffect

Wrapper for a battle unit effect

Functions

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

CcoBattleVehicle

Functions

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

CcoBattleWindsOfMagicPool

Functions

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

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

CcoCampaignArmoryItemVariant

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

Functions

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

CcoCampaignArmyPlague

Functions

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

CcoCampaignBasePlague

Wrapper for a base plague

Functions

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

CcoCampaignBuilding

Functions

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

CcoCampaignBuildingLifecycleState

Functions

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

CcoCampaignBuildingSlot

Functions

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

CcoCampaignBuildingVariant

Functions

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

CcoCampaignCaravan

Wrapper for a campaign caravan

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TravelledPathNodeListCcoCampaignRouteNode (list)VoidReturns the a list of nodes that the caravan has already traversed
PathNodeListCcoCampaignRouteNode (list)VoidReturns the a list of nodes that the caravan will transverse next
PositionVector4VoidReturns the current display position of the caravan
IsReturningBoolVoidReturns true if the caravan has already reached its destination and is now returning back to the starting point
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
MaximumCargoIntCcoCaravanContractRecordMaximum cargo for the caravan and passed in contract
CargoAmountIntVoidReturns the amount of cargo that this caravan currently has
ClearStartingPathVoidVoidClears the starting path of the caravan
SetAutoPathTowardsNodeVoidCcoCampaignRouteNode, CcoCaravanContractRecord (optional)Sets the caravan path towards the node passed in, if it's possible
IsReserveBoolVoidReturns true if this is a reserve caravan
SetStartingNodeVoidCcoCampaignRouteNodeSets the starting node for this caravan
DestinationNodeContextCcoCampaignRouteNodeVoidReturns a CcoCampaignRouteNode context with the destination node choice of the player
StartingNodeContextCcoCampaignRouteNodeVoidReturns a CcoCampaignRouteNode context with the starting node choice of the player
ChangePathSegmentVoidCcoCampaignRouteSegment, CcoCaravanContractRecord (optional)Changes the current path to include the segment passed in an updates the rest of the path to make sure it's valid
ContractContextCcoCaravanContractRecordVoidReturns a CcoCaravanContractRecord with the current contract for this caravan, if any
CharacterContextCcoCampaignCharacterVoidReturns a CcoCampaignCharacter with the character that owns the caravan
CurrentNodeContextCcoCampaignRouteNodeVoidReturns a CcoCampaignRoute node context where the caravan is currently positioned

CcoCampaignCaravanRecruitmentItem

Wrapper for a campaign FACTION_CARAVANS struct

Functions

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

CcoCampaignCharacterAutoManagement

Wrapper for character auto-management logic

Functions

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

CcoCampaignCharacterLoyalty

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RangeStateVoidVoid
IsLoyaltyApplicableVoidVoid
LoyaltyVoidVoid
OnScreenLoyaltyVoidVoid

CcoCampaignCharacterTeleportationInteraction

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

Functions

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

CcoCampaignCharacterTeleportationSystem

Wrapper for character teleportation logic

Functions

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

CcoCampaignCharacterTrainingGroup

Wrapper for a campaign training group

Functions

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

CcoCampaignCharacterTrainingSlot

Wrapper for a campaign training slot

Functions

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

CcoCampaignConstructionItem

Functions

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

CcoCampaignCorruptionCounter

Wrapper for a corruption counter

Functions

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

CcoCampaignCursorContext

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

Functions

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

CcoCampaignDiplomacyManager

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

Functions

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

CcoCampaignDiplomacyManipulationInfo

Wrapper for a diplomacy manipulation info

Functions

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

CcoCampaignDiplomacyManipulationInteraction

Class that manages targetting interface interaction for a manipulation info

Functions

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

CcoCampaignEffectGroup

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectListVoidVoid
LocalisedTitleVoidVoid

CcoCampaignElectorSeat

Functions

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

CcoCampaignEventAgentTargetsCharacter

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsReferingToPlayerVoidVoid
DiplomaticStateContextVoidVoid
ActionResultContextVoidVoid
TargetFactionContextVoidVoid
AgentFactionContextVoidVoid
TargetContextVoidVoid
AgentContextVoidVoid

CcoCampaignEventAgentTargetsSettlement

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsReferingToPlayerVoidVoid
DiplomaticStateContextVoidVoid
ActionResultContextVoidVoid
TargetFactionContextVoidVoid
AgentFactionContextVoidVoid
TargetContextVoidVoid
AgentContextVoidVoid

CcoCampaignEventAncillaryOrTrait

Functions

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

CcoCampaignEventArmoryItem

Context wrapper for a campaign ARMORY_ITEM custom layout event

Functions

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

CcoCampaignEventBattleResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DefendingBattleResultVoidVoid
AttackingBattleResultVoidVoid
DefendingFactionContextVoidVoid
AttackingFactionContextVoidVoid
DefendingCharacterContextVoidVoid
AttackingCharacterContextVoidVoid
PlayersBattleResultVoidVoid

CcoCampaignEventBuildingConstructed

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BuildingVoidVoid

CcoCampaignEventDilemma

Component context wrapper for an event dilemma

Functions

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

CcoCampaignEventDiplomacy

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ZoomToVoidVoid
HasZoomLocationVoidVoid
EventTypeVoidVoid
EventIconPathVoidVoid
IsTreatyBrokenVoidVoid
SecondFactionVoidVoid
FirstFactionVoidVoid

CcoCampaignEventFaction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
FirstFactionContextVoidVoid
HasZoomLocationVoidVoid
DiplomaticStateContextVoidVoid
SecondFactionContextVoidVoid

CcoCampaignEventFeedCustomMission

Component context wrapper for an event mission

Functions

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

CcoCampaignEventFeedFilter

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
InclusionStateVoidVoid
ToggleCategoryVoidVoid
IsCategoryIncludedVoidVoid

CcoCampaignEventFeedGroup

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ShouldAutoExpandVoidVoid
EventListVoidVoid
TitleVoidVoid

CcoCampaignEventFeedMessageDetails

Functions

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

CcoCampaignEventFeedOpenEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ShouldRepositionBoolVoid
IconContextContextVoid
EventContextCcoCampaignEventFeedMessageDetailsVoid

CcoCampaignEventFeedRecords

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RoundsListVoidVoid
EndYearVoidVoid
StartYearVoidVoid
YearContextVoidVoid
YearListVoidVoid

CcoCampaignEventFeedRound

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RoundTitleVoidVoid
SummaryListVoidVoid
IsEmptyVoidVoid

CcoCampaignEventFeedSummary

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MarkAsReadVoidVoid
IsReadVoidVoid
TotalEventsVoidVoid
EventListVoidVoid
FirstEventContextVoidVoid
IconPathVoidVoid
TitleVoidVoid

CcoCampaignEventFeedYear

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProvinceListVoidVoid
FactionListVoidVoid
CharacterListVoidVoid
RoundsListVoidVoid

CcoCampaignEventHostileAction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsReferingToPlayerVoidVoid
DiplomaticStateContextVoidVoid
ActingFactionContextVoidVoid
TargetFactionContextVoidVoid
ActingCharacterContextVoidVoid

CcoCampaignEventIncident

Context wrapper for a campaign incident

Functions

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

CcoCampaignEventMercenaryUnitUnlock

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitVoidVoid

CcoCampaignEventTechnologyResearched

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ZoomToVoidVoid
HasZoomLocationVoidVoid
FactionVoidVoid
NextTechnologyVoidVoid
ResearchedTechnologyVoidVoid

CcoCampaignEventTrainingDilemmaAvailable

Context wrapper for a campaign TRAINING_DILEMMA_AVAILABLE custom layout event

Functions

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

CcoCampaignEventUnitRecruitment

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionVoidVoid
NameVoidVoid
AgentVoidVoid
UnitVoidVoid

CcoCampaignFactionAlliedBuildings

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

Functions

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

CcoCampaignFactionCaravans

Wrapper for a campaign FACTION_CARAVANS struct

Functions

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

CcoCampaignFactionGovernorship

Functions

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

CcoCampaignFactionProvinceManager

Wrapper for a campaign FACTION_PROVINCE_MANAGER

Functions

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

CcoCampaignFactionWomCompass

Wrapper for wom compass

Functions

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

CcoCampaignGovernorshipInteraction

Functions

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

CcoCampaignInitiative

Wrapper for a campaign initiative

Functions

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

CcoCampaignInitiativeSet

Functions

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

CcoCampaignMercenaryPoolUnit

Component context wrapper for a mercenary pool unit

Functions

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

CcoCampaignMilitaryForceHorde

Functions

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

CcoCampaignMilitaryForceMorale

Component context wrapper for a campaign military force's morale

Functions

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

CcoCampaignMilitaryForceStance

Functions

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

CcoCampaignMilitaryForceWarTargetting

Functions

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

CcoCampaignMissionDefinition

Component context wrapper for a CAMPAIGN_MISSION_DEFINITION

Functions

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

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
DescriptionUniStringVoidReturns the description of the objective
UnitRecordContextCcoMainUnitRecordVoidReturns the optional unit record context of this objective
BuildingLevelRecordContextCcoBuildingLevelRecordVoidReturns the optional building level record context of this objective
TechnologyRecordContextCcoTechnologyRecordVoidReturns the optional technology record context of this objective
ZoomToVoidVoidZooms the campaign camera to the objective's zoom to location
HasZoomToLocationBoolVoidReturns whether the objective has a zoom to location
IsCompletedBoolVoidReturns whether the objective has been completed
TooltipUniStringVoidReturns the tooltip of the objective

CcoCampaignNegotiation

Component context wrapper for a campaign negotiation

Functions

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

CcoCampaignPayloadInfo

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

Functions

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

CcoCampaignPayloadInfoEntry

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

Functions

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

CcoCampaignPendingActionNotification

Component context wrapper for an individual notification/warning for CcoCampaignPendingActionNotificationQueue

Functions

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

CcoCampaignPendingActionNotificationQueue

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

Functions

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

CcoCampaignPlagueComposition

Wrapper for a plague composition (base plague plus ingredients)

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BasePlagueContextCcoCampaignBasePlagueVoidReturns the plague record context in the infection data
NameUniStringVoidReturns the name of the composition. Will be either the name of the reciepe if exists, if not the combination of base and ingredients
CombinedEffectsAndTypeListCcoPlagueEffectList (list)ExpressionState, Bool, CcoCampaignFaction (optional)Returns a list of combined effects from base and ingredients, grouped by type as a CcoPair. First in CcoPair is either list of CcoEffect if bool parameter is false or list of CcoCampaignPlagueCompositionEffectList is bool is true. Second returns the type
PlagueIngredientListCcoCampaignPlagueIngredient (list)VoidReturns a list of plague ingredients in the infection data
SpecialCompositionForFactionContextCcoPlagueSpecialCompositionRecordCcoCampaignFactionReturns the special composition for this combination of plague and ingredients for the passed in faction, if any

CcoCampaignPlagueCompositionEffectList

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

Functions

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

CcoCampaignPlagueIngredient

Wrapper for a campaign plague component

Functions

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

CcoCampaignPlaguesCompositionSystem

Wrapper for a campaign plagues composition system

Functions

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

CcoCampaignPooledResourceDistributor

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

Functions

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

CcoCampaignPooledResourceManager

Context wrapper for pooled resource manager.

Functions

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

CcoCampaignPooledResourceMilitaryForceBreakdown

Wrapper for a military force breakdown of a pooled resource

Functions

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

CcoCampaignPooledResourceProvinceBreakdown

Wrapper for a province breakdown of a pooled resource

Functions

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

CcoCampaignPooledResourceSettlementBreakdown

Wrapper for a region/settlement breakdown of a pooled resource

Functions

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

CcoCampaignPooledResourceTransaction

Context wrapper for pooled resource transactions.

Functions

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

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
CurrentFocusContextCcoProvinceAutomanagementFocusRecordVoidReturns the current focus records that is selected in this province
FocusListCcoProvinceAutomanagementFocusRecord (list)VoidReturns a list of focus records that can be set for this province
ToggleAutoManagingVoidVoidActivates the auto management for this province or deactivates it if already active
IsHighPriorityBoolVoidReturns true if the province is currently considered as high priority
IsAutoManagingBoolVoidReturns true if the province is currently being auto managed by the AI
ChooseFocusVoidCcoProvinceAutomanagementFocusRecordChooses a focus for this province

CcoCampaignProvinceGovernorship

Wrapper for a province governorship

Functions

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

CcoCampaignPublicOrder

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProvidedEffectBundleVoidVoid
HappinessRangeEffectBundleListVoidVoid
DetailsVoidVoid
BalancePercentageVoidVoid
BreakdownListVoidVoid
ChangePerTurnStateVoidVoid
ChangePerTurnVoidVoid
StateVoidVoid
BalanceVoidVoid

CcoCampaignResourceTransaction

Context wrapper for resource transactions.

Functions

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

CcoCampaignRitual

Wrapper for a campaign ritual

Functions

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

CcoCampaignRitualChain

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

Functions

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

CcoCampaignRitualInteraction

Class that manages targetting interface interaction for a ritual

Functions

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

CcoCampaignRitualManager

Wrapper for a faction's ritual manager

Functions

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

CcoCampaignRouteNode

Wrapper for campaign route node

Functions

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

CcoCampaignRouteSegment

Wrapper for campaign route segment

Functions

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

CcoCampaignSkavenCorruptionOverlay

Record wrapper for a Skaven corruption overlay

Functions

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

CcoCampaignSlaves

Functions

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

CcoCampaignTechnologyManager

Wrapper for a faction's technology manager

Functions

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

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

CcoCampaignUnitPurchasableEffectCost

Context wrapper for pairing purchasable effect record and resource transaction.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ResourceTransactionCcoCampaignResourceTransactionVoidReturns resource transaction cco
EffectRecordCcoUnitPurchasableEffectRecordVoidReturns purchasable effect record cco

CcoCampaignUnitUpgradeManager

Component context wrapper for a UNIT_UPGRADE_MANAGER

Functions

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

CcoCampaignUnitUpgradesBuildingRequirement

Component context wrapper for a UNIT_GROUP_TECH_REQUIREMENT

Functions

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

CcoCampaignUnitUpgradesTechRequirement

Component context wrapper for a UNIT_GROUP_TECH_REQUIREMENT

Functions

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

CcoCampaignWarCoordinationRequest

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

Functions

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

CcoCampaignWinStreak

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentWinStreakVoidVoid
CampaignStreakContextVoidVoid
CurrentStreakEffectContextVoidVoid
TurnsUntilDecayVoidVoid
WinStreakPercentVoidVoid
EffectUnfilteredListVoidVoid
EffectListVoidVoid
InvalidationRoundVoidVoid

CcoCampaignWindsOfMagicArea

Wrapper for a winds of magic area.

Functions

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

CcoCampaignWindsOfMagicSystem

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ChangeAreaStrengthVoidCcoCampaignWindsOfMagicArea, CcoCampaignMapWindsOfMagicStrengthRecord
AllAreaContextsContextListVoid
AreaContextForProvinceCcoCampaignWindsOfMagicAreaCcoCampaignProvince
AreaContextForRegionCcoCampaignWindsOfMagicAreaCcoRegionRecord

CcoCampaignWomCompassDirection

Wrapper for wom compass direction

Functions

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

CcoCampaignWomCompassPowerLevelRange

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

Functions

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

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

CcoComponentModelView

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

Functions

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

CcoContextExpression

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EvaluateExpressionArgumentPackContext, ArgumentPack
TextRepresentationStringVoid

CcoContextExpressionCompilationError

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionStringVoid

CcoContextExpressionResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasStringRepresentationBoolVoid
ResultTypeCcoContextObjectTypeVoid
ValueArgumentPackVoid

CcoContextExpressionRuntimeError

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionStringVoid

CcoContextHistoryObject

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CcoContextContextVoid
OriginComponentContextContextVoid
CallbackIdStringVoid
ContextIdStringVoid
TimeIntVoid
ReasonStringVoid
ContextObjectIdStringVoid

CcoContextList

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MinValueFloatExpressionState, ExpressionReturns the smallest value evaluated for each context in the list using expression
ContainsBoolContextReturns true if supplied context exists in the list
SizeIntVoidReturns the number of elements in the list
DistinctContextListExpressionState, Expression (optional)Returns the distinct elements of the list
MaxContextContextExpressionState, ExpressionReturns the context with the largest value evaluated for each context in the list using expression
FilterContextListExpressionState, ExpressionReturns a list with all the elements of the given list that satisfy the condition.
MinContextContextExpressionState, ExpressionReturns the context with the smallest value evaluated for each context in the list using expression
AnyBoolExpressionState, ExpressionReturns true if any of the contexts return true for the given expression
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
AllBoolExpressionState, ExpressionReturns true if all the contexts return true for the given expression
JoinStringUniStringExpressionState, Expression, UniStringReturns a combined string using the first expression to determine how to get the string for each context, and splitting each entry with the supplied separator
PreviousContextContextContextGiven a context that exists in the list, returns the previous context if one exists, will also wrap around the beginning of the list. If list only has one element will return the one element
ForEachVoidExpressionState, ExpressionPerforms the supplied expression on each context
ReduceArgumentPackExpressionState, Expression, Expression (optional)Reduces the list based on given predicate starting at optional initialiser value
FindIfContextExpressionState, Expression
SumArgumentPackExpressionState, ExpressionAccumulates the values returns by each contexts expression (for adding up totals)
TransformContextListExpressionState, ExpressionTransforms the list into a new one where each element is produced by the given expression
FindContextContext
SkipContextListIntSkip the first x elements of the list
AtContextIntReturns the context at the specified index
ReverseContextListVoidReturns the list in the opposite order
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
SortContextListExpressionState, Expression, Bool (optional)Returns the list sorted by the given expression, pass true for second parameter to sort in ascending order (defaults to descending)
PadRightContextListExpressionState, Int, Expression (optional)Returns a list with at least N number of elements. If the original list had less than N elements, the new elements will be either CcoEmptyObject or the object returned by the given expression.
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
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
IndexForFirstContextIntExpressionState, ExpressionReturns the index of the first context that returns true for the supplied expression
CountIntExpressionState, ExpressionReturns the number of elements that satisfy the given expression
ListContextListVoidReturns internal list of contexts
TakeContextListIntReturns the first N elements of the list
MaxValueFloatExpressionState, ExpressionReturns the largest value evaluated for each context in the list using expression
IsEmptyBoolVoidReturns true if the list is empty
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

CcoContextObjectType

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsArithmeticBoolVoid
NameStringVoid
HasStringRepresentationBoolVoid
SymbolsListContextListVoid
IsListBoolVoid

CcoContextSymbol

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsCommandBoolVoid
DocumentationStringVoid
TypeContextCcoContextObjectTypeVoid
TagsStringVoid
NameStringVoid
EvaluateSymbolArgumentPackContext, ArgumentPack

CcoCookingSystem

Wrapper for the cooking system for a given faction

Functions

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

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

CcoCustomBattleArmyPresetFileHandler

Singleton wrapper for army preset file handler

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ArmyPresetExistsBoolUniStringReturns true if an army preset exists with the given filename
ConfirmSaveOverwriteVoidVoidSaves army preset once the overwrite operation has been accepted
SaveArmyPresetForPlayerSlotVoidUniString, CcoCustomBattlePlayerSlotSaves the provided player slot's army with name given as the first argument
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
CanEverIncreaseExperienceBoolVoidReturns whether the unit associated with the unit index stored on this context can ever increase its level
TransformationUnitOverrideContextCcoMainUnitRecordVoidReturns the unit's transformation unit override.
AvailableMountsListCcoUnitsCustomBattleMountRecord (list)VoidReturns the CcoUnitsCustomBattleMountRecords available to the unit associated with the unit index stored on this context
IsCommanderBoolVoidReturns whether the unit associated with the unit index stored on this context is a commander
IsReinforcementBoolVoidReturns whether the unit associated with the unit index stored on this context is a reinforcement
SetTransformationUnitOverrideVoidCcoMainUnitRecordSets the unit's transformation unit override.
IsValidBoolVoidReturns whether the unit associated with the unit index stored on this context is valid
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
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
ChangeUnitTypeVoidCcoUnitsCustomBattleTypeRecordChanges, to the provided alternate unit type, specified by the provided CcoUnitsCustomBattleTypeRecord
CostAtLevelIntIntReturns the cost at a provided level 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
NameUniStringVoidReturns the name of the unit with the unit index stored on this context
DecreaseExperienceVoidVoidDecreases the level of the unit associated with the unit index stored on this context
CurrentMountRecordContextCcoUnitsCustomBattleMountRecordVoidReturns the CcoUnitsCustomBattleMountRecord associated with the unit index stored on this context
IncreaseExperienceVoidVoidIncreases the level of the unit associated with the unit index stored on this context
UnitDetailsContextCcoUnitDetailsVoidReturns the CcoUnitDetails associated with this unit index stored on this context
RemoveUnitVoidVoidRemoves this unit from the player slot
CustomBattleUnitRecordContextCcoUnitsCustomBattlePermissionRecordVoidReturns the CcoUnitsCustomBattlePermissionRecord record associated with the unit index stored on this context
CanAffordMountBoolCcoUnitsCustomBattleMountRecordReturns whether the unit index stored on this context can change mount
UnmountedRecordContextCcoMainUnitRecordVoidReturns the CcoMainUnitRecord associated with the unmounted version of the unit index stored on this context
UnitRecordContextCcoMainUnitRecordVoidReturns the CcoMainUnitRecord associated with the unit index stored on this context
PlayerSlotContextCcoCustomBattlePlayerSlotVoidReturns the CcoCustomBattlePlayerSlot associated with the slot index stored on this context
CanChangeMountBoolCcoUnitsCustomBattleMountRecordReturns whether the unit index stored on this context can change mount
HasArmoryBoolVoidReturns whether the unit associated with the unit index stored on this context has an armory
UnitTypesCcoUnitsCustomBattleTypeRecord (list)VoidReturns variants for this unit, eg different ammo or spell lore overrides
IsPersistentCharacterBoolVoidReturns whether the unit associated with the unit index stored on this context is a loaded character
CurrentUpgradeListCcoCustomBattleUnitUpgrade (list)VoidReturns the current CcoCustomBattleUnitUpgrades of the unit associated with the unit index stored on this context
CanIncreaseExperienceBoolVoidReturns whether the unit associated with the unit index stored on this context can currently increase its level
AvailableUpgradeListCcoCustomBattleUnitUpgrade (list)VoidReturns the CcoCustomBattleUnitUpgrades available to the unit associated with the unit index stored on this context

CcoCustomBattleUnitUpgrade

Functions

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

CcoDiplomacyThreatLevel

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

Functions

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

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

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
FilteredCampaignCharacterInfoListCcoSavedCharacterInfo (list)VoidReturns a list of saved characters for this faction, filtered on whether should show agents or lords
SavedCharacterInfoListCcoSavedCharacterInfo (list)VoidReturns a list with all saved characters for this faction
IsCampaignBoolVoidReturns true if we're in campaign, since some info will only show there
DeleteSavedCharacterVoidCcoSavedCharacterInfoDeletes the passed in saved character file from the local machine's saved characters folder

CcoFactorBreakdown

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ListVoidVoid
DescriptionVoidVoid
HeaderVoidVoid

CcoFindResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IndexIntVoid
ContextContextVoid

CcoFloatingTextAgentActionEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AgentNameVoidVoid
TextTypeVoidVoid
TargetFlagPathVoidVoid
AgentFlagPathVoidVoid
IsSuccessVoidVoid
TargetNameVoidVoid
ActionNameVoidVoid

CcoFloatingTextBattleEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TextTypeVoidVoid
DefenderFlagPathVoidVoid
AttackerFlagPathVoidVoid
DefenderVoidVoid
AttackerVoidVoid

CcoFloatingTextStanceEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TextTypeVoidVoid
GeneralFlagPathVoidVoid
GeneralNameVoidVoid
NewStanceNameVoidVoid
OldStanceNameVoidVoid

CcoFrontendFactionLeader

Wrapper for a frontend faction leader

Functions

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

CcoFrontendRoot

Functions

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

CcoGameCore

Wrapper for the game core

Functions

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

CcoGroupList

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GroupedListContextListVoid
CategoryObjectContextVoid

CcoIngameMessaging

Ingame messaging singleton, used to get ingame news items

Functions

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

CcoIngameMessagingItem

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

Functions

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

CcoListLayout

Wrapper for a component list engine

Functions

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

CcoLobbyPlayer

Wrapper for a lobby player slot

Functions

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

CcoLobbyTeam

Component context wrapper for a MPC lobby team

Functions

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

CcoMoMTrialManager

Wrapper for Mirrors of Madness Trials

Functions

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

CcoNarrativeManager

Functions

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

CcoNetworkPlayer

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

Functions

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

CcoPair

Functions

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

CcoPreBattleAIAvailableGenerals

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetGeneralsListContextListVoid

CcoPreBattleFactionVote

Functions

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

CcoPreBattleVotingSystem

Functions

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

CcoPrisonSystem

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsPrisonFullVoidVoid
MaxNumberOfPrisonersVoidVoid
CurrentNumberOfPrisonersVoidVoid

CcoReinforcementArmy

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DelayVoidVoid
EntryPositionVoidVoid

CcoRuntimeObject

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
InternalContextVoid

CcoSaveGameHeader

Wrapper for a save game header

Functions

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

CcoSavedCharacterInfo

Wrapper for a SAVED_CHARACTER_INFO struct

Functions

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

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

CcoSummedValueContext

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SummedListContextListVoid
OriginalContextContextVoid
SummedValueFloatVoid

CcoSymbolTest

This is an example

Functions

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

CcoSymbolTestSecond

This is a second example

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SameNameStringVoid
id2StringCcoSymbolTest
idStringCcoSymbolTest
ContextContextVoid

CcoTempleOfTheOldOnes

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ColourVoidVoid
CurrentEffectBundleVoidVoid
NumberOfBuildingsVoidVoid
CurrentLevelVoidVoid
DescriptionVoidVoid
NameVoidVoid

CcoURI

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

Functions

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

CcoUiWarning

Functions

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

CcoUnitAbilityDetails

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

Functions

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

CcoUnitBulletPoint

Wrapper for a UI_UNIT_BULLET_POINT object

Functions

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

CcoUnitStat

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

Functions

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

CcoUnitStatModIcon

Component context wrapper for a unit stat modifier icon

Functions

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

CcoVector4

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ModulusFloatVoid
wFloatVoid
zFloatVoid
yFloatVoid
xFloatVoid
ValueVector4Void

Battle

CcoBattleAlliance

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

Functions

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

CcoBattleArmy

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

Functions

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

CcoBattleBuilding

Functions

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

CcoBattleCapturePoint

Functions

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

CcoBattleCursorContext

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

Functions

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

CcoBattleReinforcementArmy

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

Functions

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

CcoBattleRoot

The root for battle that gives access to anything battle related

Functions

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

CcoBattleSelection

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

Functions

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

CcoBattleSpawnZone

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OnMouseOverVoidBool
UniqueIDIntVoid
IsVanguardOnlyBoolVoidIs the spawn zone only available for use by vanguard units or not
GetAllianceColourColourInt
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
SetActiveVoidBoolSet if the slot radial visible
IconPathForIndexStringCcoBattleArmy, IntRetrieve the 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
ConstructionTimeRemainingSecondsFloatVoidHow long is left in the current construction timer
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)
ShowPreviewForIndexVoidIntShows the ghost preview for the buildable on the associated slot
IsConstructionInProgressBoolVoidIs there anything being constructed or a toggle switch being deferred?
HidePreviewForIndexVoidIntHides the ghost preview for the buildable on the associated slot
WorldPositionVector4VoidReturns a Vector3 of the world position of the slot origin
CanOwnerInteractBoolVoidCan the slot be interacted with by the army that owns it?
CanInteractBoolCcoBattleArmyCan the slot be interacted with?
HasArtilleryMountLocationBoolVoidDoes the slot support an artillery mount?
IsFreeRotationAllowedBoolVoidCan the slot be rotated?
EnabledIndexIntVoidWhich of the buildables is currently enabled? -1 for none
IsMapBarrierBoolVoidDoes the slot represent a toggleable barrier?
IsBuildingBoolVoidDoes the slot represent a toggleable building?
IsAnyEnabledBoolVoidAre any of the buildables associated with this slot, enabled?
IsUnitBoolVoidDoes the slot represent a toggleable unit?
BuildablesListCcoBattleToggleableSlotBuildable (list)VoidGet the list of buildables associated with the slot (slot buildable indices associated with index-related functions in Toggleable Ccos)
TypeStringString (list)VoidReturns the type of the slot as an unlocalised string
IconBlendablePathForIndexString (list)CcoBattleArmy, IntRetrieve the white/blendable icon asset path for the associated slot buildable index
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

CcoBattleUnit

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

Functions

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

Campaign Model

CcoCampaignModelBuilding

Model safe context wrapper for a campaign building

Functions

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

CcoCampaignModelFaction

Model safe context wrapper for a campaign faction

Functions

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

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
InitiativeSetContextCcoCampaignModelInitiativeSetStringInitiative set context for given key if valid
OwnedSetsCcoCampaignModelInitiativeSet (list)VoidList of owned initiative sets
FactionContextCcoCampaignModelFactionVoidOwning faction of the manager

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
MinIntVoidMinimum bound of this resource
PercentageOfCapacityFloatVoidPercentage towards full capacity for this resource
TotalIntVoidCurrent total of this resource
MaxIntVoidMaximum bound of this resource

CcoCampaignModelProvince

Model safe context wrapper for a campaign province

Functions

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

CcoCampaignModelRegion

Model safe context wrapper for a campaign region

Functions

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

CcoCampaignModelUnit

Model safe context wrapper for a campaign unit

Functions

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

Callbacks

UI Update Messages

MessageAdditional Context
AdviceHistoryCleared
AgentActionPerformed
AncillaryAddedToPool
AncillaryFused
ArmyAbilityPurchased
ArmyAbilityUpgraded
AudioUiCategoriesReloaded
BattleCardsLayoutCalled
BattleConflictStarted
BattleCurrencyUpdate
BattleLocalPlayerChanged
BattleResultsCalculated
BattleSelectionChanged
BattleTimeSpeedChanged
Campaign::Events::DilemmaChoiceTaken
CampaignAreaOfInterestMouseOfftrue
CampaignAreaOfInterestMouseOntrue
CampaignBattleFinished
CampaignBattleFullyCompleted
CampaignBattleStarted
CampaignBuildingStateChanged
CampaignCharacterAncillaryAssigned
CampaignCharacterArmorChange
CampaignCharacterSelectedAny
CampaignCinematicModeDisabled
CampaignCinematicModeEnabled
CampaignFactionStrengthRanksUpdated
CampaignFactionTurnEndChange
CampaignForceGrowthChanged
CampaignHUDVisibilityChanged
CampaignHumanFactionChangedToAI
CampaignLocalFactionChanged
CampaignMilitaryForceDetailsChanged
CampaignNegotiationChange
CampaignProvinceGrowthChanged
CampaignRitualLockStatusChanged
CampaignRitualLockStatusChangedSpecifictrue
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
ContextLayoutTooltipSettingsChanged
ContextViewerCurrentSelectedContextChanged
ContextViewerInspectedContextChanged
ContextViewerRightClickPressed
ControlsChanged
CookingDishApplied
CustomBattleAutogenAvailabilityChange
CustomBattleOnArmyPresetChanged
CustomBattleOnArmyPresetPinned
CustomBattleOnAutoReadyCountdownUpdate
CustomBattleOnDisconnect
CustomBattleOnFundsChanged
CustomBattleOnHostMigrated
CustomBattleOnLobbyCreated
CustomBattleOnMapFavouritesChanged
CustomBattleOnMapPinned
CustomBattleOnNetworkPlayerImageReady" + String::format("%d
CustomBattleOnPlayerArmyChanged
CustomBattleOnPlayerArmyChangedAny
CustomBattleOnPlayerFactionChanged
CustomBattleOnPlayerFactionChangedAny
CustomBattleOnPlayerFactionChangedLocalPlayer
CustomBattleOnPlayerFactionChangedPlayer
CustomBattleOnPlayerJoined
CustomBattleOnPlayerJoinedAny
CustomBattleOnPlayerLeft
CustomBattleOnPlayerLeftAny
CustomBattleOnPlayerNameChanged
CustomBattleOnPlayerReadyChanged
CustomBattleOnPlayerReadyChangedAny
CustomBattleOnPlayerSlotAdded
CustomBattleOnPlayerSlotAddedAny
CustomBattleOnPlayerSlotRemoved
CustomBattleOnPlayerSlotRemovedAny
CustomBattleOnPlayerTeamChanged
CustomBattleOnPlayersSwapped
CustomBattleOnReadyCountdownUpdate
CustomBattleOnSettingChangedAiStats
CustomBattleOnSettingChangedAny
CustomBattleOnSettingChangedAttackDirection
CustomBattleOnSettingChangedAttackingTeam
CustomBattleOnSettingChangedBattleType
CustomBattleOnSettingChangedCorruptionChanged
CustomBattleOnSettingChangedDifficulty
CustomBattleOnSettingChangedFunds
CustomBattleOnSettingChangedIsLoadingCharactersEnabled
CustomBattleOnSettingChangedIsStormOfMagicEnabled
CustomBattleOnSettingChangedIsUsingUnitCaps
CustomBattleOnSettingChangedLargeArmies
CustomBattleOnSettingChangedLimitlessWom
CustomBattleOnSettingChangedMap
CustomBattleOnSettingChangedRealismMode
CustomBattleOnSettingChangedSeason
CustomBattleOnSettingChangedSplitFunds
CustomBattleOnSettingChangedTileUpgrade
CustomBattleOnSettingChangedTimeLimit
CustomBattleOnSettingChangedTimeOfDay
CustomBattleOnSettingChangedUnitScale
CustomBattleOnSettingChangedWeather
CustomBattleOnSpectatorJoined
CustomBattleOnTeamChanged
CustomBattleOnTeamChangedAny
CustomBattleOnTeamLeaderChanged
CustomBattleOnUnitsChanged
CustomBattleOnUnitsChangedAny
CustomBattleOnUserCreatedMapSync
CustomBattleRecruitmentModeChanged
DevoteesEffectsChanged
DiplomacyFactionSelectionChange
DiplomacyManipulationExecuted
DiplomacyManipulationTargetSelectionModeChanged
DiplomacyRequest
EffectsListUpdated
EnvironmentSettingChanged
EnvironmentSettingChangedincremental_autosave_enabled
EnvironmentSettingChangedsave_to_cloud
EventFeed::ClearWhiteList
EventFeed::TryOpenNext
EventFeedAutoOpen
EventFeedFilterChanged
EventFeedRepopulate
FactionCapitalChangedtrue
FactionCookedDish
FactionCookedDishSpecific
FactionDeathtrue
FactionDiplomacyChangetrue
FactionDiplomacyChangeAny
FactionDiscoveredAny
FactionFeaturesChanged
FactionInitiativeActivationChanged
FactionMercenaryPoolUpdated
FavourPointsChanged
ForeignManagerCreated
ForeignSlotAdded
ForeignSlotRemoved
FrontEndNameRandomised
FrontendGeneralNameChanged
InfoPanelClosed
InfoPanelOpened
IngameMessagingNextPage
IngameMessagingPreviousPage
IngredientUnlocked
ItemMarkedAsSeen
LabSettingsLoaded
LayoutFinished_
LevyMercenaryPoolUpdated
LoadingScreenUIDestroyed
MPLobbyOnBattleDifficultyChanged
MPLobbyOnBattleParamsChanged
MPLobbyOnBattleStatsModifierChanged
MPLobbyOnCampaignDifficultyChanged
MPLobbyOnCampaignParamsChanged
MPLobbyOnDisconnect
MPLobbyOnHostMigrated
MPLobbyOnLocalPlayerJoined
MPLobbyOnNetworkPlayerImageReady" + String::format("%d
MPLobbyOnPlayerArmyChanged
MPLobbyOnPlayerArmyChangedAny
MPLobbyOnPlayerCustomGeneralNameChanged
MPLobbyOnPlayerFactionChanged
MPLobbyOnPlayerFactionChangedAny
MPLobbyOnPlayerFactionFailed
MPLobbyOnPlayerFactionFailedAny
MPLobbyOnPlayerJoined
MPLobbyOnPlayerJoinedAny
MPLobbyOnPlayerLeft
MPLobbyOnPlayerLeftAny
MPLobbyOnPlayerNameChanged
MPLobbyOnPlayerNameChangedAny
MPLobbyOnPlayerReadyChanged
MPLobbyOnPlayerReadyChangedAny
MPLobbyOnPlayerSlotAdded
MPLobbyOnPlayerSlotAddedAny
MPLobbyOnPlayerSlotRemoved
MPLobbyOnPlayerSlotRemovedAny
MPLobbyOnPlayerTeamChanged
MPLobbyOnPlayerTeamChangedAny
MPLobbyOnPlayersSwapped
MPLobbyOnReadyCountdownUpdate
MPLobbyOnSpectatorJoined
MPLobbyOnTeamChanged
MPLobbyOnTeamLeaderChanged
MPLobbyOnUserCreatedMapSync
MapControllerZoomUpdated
MilitaryForceFactionChangetrue
MilitaryForceFactionChangeAny
MilitaryForceMercenaryPoolUpdated
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
RecipeUnlocked
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
TransformableAgentEquipped
TransformableAgentUnlocked
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
hostile_slot_available_event
negative_pooled_resource_event
negative_pooled_resource_event_
selection_changed_
siege_construction_available_event