UI Symbols Documentation

Contexts


Campaign

CcoCampaignAncillary

Component context wrapper for a campaign ancillary

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ColourTextUniStringVoidReturns localised colour text from record
ProvidedBodyguardsContextListVoidReturns list of CcoMainUnitRecord that are provided as bodyguards as a result of ancillary being equipped
TypeIconPathStringVoidReturns the icon path for the ancillary type
EffectTextUniStringVoidReturns localised effect text from record
MarkAsSeenVoidVoidMarks the equipment as seen so that HasSeen will return false
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
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
IsFusableBoolVoidReturns true if this ancillary can ever be fused.
TurnsEquippedIntVoidReturns the number of turns this has been equipped
CanCharacterEquipBoolCcoCampaignCharacterReturns true if specified character can equip this ancillary
SalvageVoidCcoCampaignFaction (optional)Salvages the ancillary.
NameUniStringVoidReturns localised name of ancillary
IconPathStringVoidReturns icon path for images
SalvageValueCcoCampaignResourceTransactionCcoCampaignFaction (optional)Returns an int with the value of the ancillary if it were to get salvaged.
EquipToCharacterVoidCcoCampaignCharacter, CcoCampaignAncillaryEquips itself to the specified character, and swaps with the ancillary passed in if this exists.
RemoveAncillaryVoidVoidRemoves itself from the character that it's equipped to.
AncillaryRecordContextCcoAncillaryRecordVoidReturns the ancillary record context.
CharacterEquippedToContextCcoCampaignCharacterVoidReturns the player character context where this ancillary is equipped, if any.
CanFuseBoolCcoCampaignAncillaryReturns true if can fuse with the specified ancillary
FuseForPlayerVoidCcoCampaignAncillaryFuses with the specified ancillary for the players faction (if possible)

CcoCampaignAreaOfInterest

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
TitleVoidVoid
EffectBundleListVoidVoid
EffectListVoidVoid
IsMouseOverVoidVoid
PositionVoidVoid
ZoomToClosestVoidVoid
DescriptionVoidVoid
IconPathVoidVoid

CcoCampaignArmoryItemVariant

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

Functions

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

CcoCampaignArmyPlague

Functions

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

CcoCampaignBasePlague

Wrapper for a base plague

Functions

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

CcoCampaignBattle

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

Functions

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

CcoCampaignBuilding

Functions

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

CcoCampaignBuildingLifecycleState

Functions

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

CcoCampaignBuildingSlot

Functions

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

CcoCampaignBuildingVariant

Functions

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

CcoCampaignCaravan

Wrapper for a campaign caravan

Functions

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

CcoCampaignCaravanRecruitmentItem

Wrapper for a campaign FACTION_CARAVANS struct

Functions

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

CcoCampaignCharacter

Component context wrapper for a campaign character

Functions

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

CcoCampaignCharacterAutoManagement

Wrapper for character auto-management logic

Functions

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

CcoCampaignCharacterLoyalty

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsLoyaltyApplicableVoidVoid
RangeStateVoidVoid
OnScreenLoyaltyVoidVoid
LoyaltyVoidVoid

CcoCampaignCharacterSkill

Component context wrapper for a campaign character skill

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyStringVoidReturns the campaign skill record key
StatusStringVoidReturns the status of the skill as an unlocalised string (available, complete, locked, etc)
CharacterContextCcoCampaignCharacterVoidReturns the owning CcoCampaignCharacter for this skill
NameUniStringVoidReturns the localised name of the skill
DescriptionUniStringVoidReturns the localised description of the skill
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
AddPointVoidVoidAdds a point into skill. Effects not applied until committed via character
RemovePointVoidVoidRemoves a point from skill. Effects not applied until committed via character
SpawningUnitAndRankPairListCcoPair (list)VoidReturns a pair with units and their ranks, that characters with this skill will spawn with
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
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)
LevelsDetailsListContextListVoidReturns the list of CcoCampaignCharacterSkillLevelDetails for each level of this 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
TotalLevelsIntVoidReturns the max level of the skill
AbilityListContextListVoidReturns a list of CcoUnitAbility that we are currently providing
IsBackgroundSkillBoolVoidReturns true if this is a characters background skill (automatic and not chosen)
ChildSkillsListContextListVoidReturns list of CcoCampaignCharacterSkill which are child links to us (unlocked by us)
IndentIntVoidReturns the x grid position
EffectListCcoEffect (list)VoidReturns a list of CcoEffect that we are currently providing, prefiltered to not show those that shouldnt appear in ui
LevelIntVoidReturns the current level of the skill
ParentSkillsListContextListVoidReturns list of CcoCampaignCharacterSkill which are parent links to us (we are unlocked by)
ImagePathStringVoidReturns the image path for the skill
TierIntVoidReturns the y 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
UnitAttributeListContextListVoidReturns a list of CcoUnitAttributeRecord provided by this skill level
LevelIntVoidReturns the level index
RankRequiredIntVoidReturns the rank required to research this skill level
EffectListContextListVoidReturns list of CcoEffect provided by this skill level
AbilityListContextListVoidReturns list of CcoUnitAbility provided by this skill level
IsLockedBoolVoidReturns if this skill level is currently locked

CcoCampaignCharacterTeleportationInteraction

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

Functions

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

CcoCampaignCharacterTeleportationSystem

Wrapper for character teleportation logic

Functions

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

CcoCampaignCharacterTrainingGroup

Wrapper for a campaign training group

Functions

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

CcoCampaignCharacterTrainingSlot

Wrapper for a campaign training slot

Functions

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

CcoCampaignConstructionItem

Functions

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

CcoCampaignCorruptionCounter

Wrapper for a corruption counter

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AmountIntVoidReturns the total amount of corruption from all the corruption types in this counter
MaxIntVoidReturns the max corruption for this counter
ActiveIntervalListCcoCorruptionCounterIntervalRecord (list)VoidReturns a list of intervals that are currently active
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
FactionContextCcoCampaignFactionVoidReturns the faction currently mousing over
LogicalPositionStringVoidReturns logical position on map currently mousing over as a stringdebug
CharacterContextCcoCampaignCharacterVoidReturns the character currently mousing over
SettlementContextCcoCampaignSettlementVoidReturns the settlement currently mousing over

CcoCampaignDiplomacyManager

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

Functions

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

CcoCampaignDiplomacyManipulationInfo

Wrapper for a diplomacy manipulation info

Functions

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

CcoCampaignDiplomacyManipulationInteraction

Class that manages targetting interface interaction for a manipulation info

Functions

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

CcoCampaignElectorSeat

Functions

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

CcoCampaignEventAgentTargetsCharacter

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsReferingToPlayerVoidVoid
ActionResultContextVoidVoid
DiplomaticStateContextVoidVoid
TargetContextVoidVoid
AgentFactionContextVoidVoid
TargetFactionContextVoidVoid
AgentContextVoidVoid

CcoCampaignEventAgentTargetsSettlement

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ActionResultContextVoidVoid
AgentContextVoidVoid
TargetContextVoidVoid
AgentFactionContextVoidVoid
DiplomaticStateContextVoidVoid
IsReferingToPlayerVoidVoid
TargetFactionContextVoidVoid

CcoCampaignEventAncillaryOrTrait

Functions

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

CcoCampaignEventArmoryItem

Context wrapper for a campaign ARMORY_ITEM custom layout event

Functions

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

CcoCampaignEventBattleResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AttackingCharacterContextVoidVoid
DefendingBattleResultVoidVoid
PlayersBattleResultVoidVoid
DefendingFactionContextVoidVoid
AttackingBattleResultVoidVoid
DefendingCharacterContextVoidVoid
AttackingFactionContextVoidVoid

CcoCampaignEventBuildingConstructed

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
BuildingCcoCampaignBuildingVariantVoidReturns a CcoCampaignBuildingVariant with the building variant data

CcoCampaignEventDilemma

Component context wrapper for an event dilemma

Functions

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

CcoCampaignEventDiplomacy

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HasZoomLocationVoidVoid
ZoomToVoidVoid
IsTreatyBrokenVoidVoid
EventIconPathVoidVoid
EventTypeVoidVoid
FirstFactionVoidVoid
SecondFactionVoidVoid

CcoCampaignEventFaction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DiplomaticStateContextVoidVoid
HasZoomLocationVoidVoid
FirstFactionContextVoidVoid
SecondFactionContextVoidVoid

CcoCampaignEventFeed

Context wrapper for the event feed

Functions

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

CcoCampaignEventFeedCustomMission

Component context wrapper for an event mission

Functions

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

CcoCampaignEventFeedFilter

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ToggleCategoryVoidVoid
InclusionStateVoidVoid
IsCategoryIncludedVoidVoid

CcoCampaignEventFeedGroup

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TitleVoidVoid
EventListVoidVoid
ShouldAutoExpandVoidVoid

CcoCampaignEventFeedMessageDetails

Functions

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

CcoCampaignEventFeedOpenEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ShouldRepositionBoolVoid
EventContextCcoCampaignEventFeedMessageDetailsVoid
IconContextContextVoid

CcoCampaignEventFeedRecords

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
YearContextVoidVoid
StartYearVoidVoid
YearListVoidVoid
EndYearVoidVoid
RoundsListVoidVoid

CcoCampaignEventFeedRound

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RoundTitleVoidVoid
IsEmptyVoidVoid
SummaryListVoidVoid

CcoCampaignEventFeedSummary

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MarkAsReadVoidVoid
TotalEventsVoidVoid
IsReadVoidVoid
FirstEventContextVoidVoid
EventListVoidVoid
TitleVoidVoid
IconPathVoidVoid

CcoCampaignEventFeedYear

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CharacterListVoidVoid
FactionListVoidVoid
ProvinceListVoidVoid
RoundsListVoidVoid

CcoCampaignEventHostileAction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsReferingToPlayerVoidVoid
ActingFactionContextVoidVoid
DiplomaticStateContextVoidVoid
ActingCharacterContextVoidVoid
TargetFactionContextVoidVoid

CcoCampaignEventIncident

Context wrapper for a campaign incident

Functions

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

CcoCampaignEventMercenaryUnitUnlock

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitVoidVoid

CcoCampaignEventTechnologyResearched

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ResearchedTechnologyVoidVoid
NextTechnologyVoidVoid
ZoomToVoidVoid
FactionVoidVoid
HasZoomLocationVoidVoid

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
AgentVoidVoid
NameVoidVoid
DescriptionVoidVoid
UnitVoidVoid

CcoCampaignFaction

Wrapper for a campaign faction

Functions

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

CcoCampaignFactionAlliedBuildings

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ConstructInSettlementCostIntCcoCampaignSettlementReturns the cost of constructing the outpost in this settlement.
AllyPermittedSettlementListCcoCampaignSettlement (list)VoidReturns a list with settlements owned by the ally faction, in which an outpost can be constructed
LongDistanceThresholdIntVoidReturns the long distance threshold, used for displaying the correct shared enemy distance state
CanConstructInSettlementBoolCcoCampaignSettlementReturns true if can construct the outpost in this settlement
SharedEnemyDistanceFromSettlementFloatCcoCampaignSettlementReturns the distance between the closest enemy from the allied settlement specified. Returns 0 if the 2 factions have no shared enemies
MiddleDistanceThresholdIntVoidReturns the middle distance threshold, used for displaying the correct shared enemy distance state
CanMoveToSettlementBoolCcoCampaignSettlementReturns true if the slot can be moved to the passed in settlement
MoveToSettlementCostIntCcoCampaignSettlementReturns the amount it will cost to move the slot to this settlement
RemoveAlliedBuildingVoidVoidRemoves the outpost from the settlement where it's constructed
RecruitableUnitsForSettlementListCcoMainUnitRecord (list)CcoCampaignSettlementReturns a list with units that could be recruited if an outpost is built in the passed in settlement
MoveToSettlementVoidCcoCampaignSettlementMoves the current outpost to the settlement specified
AlliedSettlementContextCcoCampaignSettlementVoidReturns the context of the settlement where an outpost is built, if any
PlayerFactionContextCcoCampaignFactionVoidReturns the context of the faction that interacts with the outposts.
AllyFactionContextCcoCampaignFactionVoidReturns the context of the ally faction in whose regions the player faction can construct outposts
ConstructInSettlementTimeIntCcoCampaignSettlementReturns the amount of time it will take to construct the outpost in this settlement.
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
RecruitCaravanVoidCcoCampaignCharacterRecruits a caravan with the caravan master passed in
InitialZoomPositionVector4VoidReturns a VECTOR_4 with a position where the camera should zoom when first opening the panel
MaximumCaravansIntVoidReturns an int with the maximum number of caravans that a faction can have active at the same time
StartCaravanVoidCcoCampaignCaravan, CcoCaravanContractRecord, IntStarts the caravan with the amount of cargo passed in
CaravanMasterListCcoCampaignCaravanRecruitmentItem (list)VoidReturns a list of CcoPair with the first entry as CcoCampaignCharacter and second as an int with the cost of recruiting the character as a caravan master
NodeListCcoCampaignRouteNode (list)VoidReturns a list of CcoCampaignRouteNode with all the route nodes that can be used by this faction
ActiveCaravanListCcoCampaignCaravan (list)VoidReturns a list of CcoCampaignCaravan with all active caravans
IdleCaravanListCcoCampaignCaravan (list)VoidReturns a list of CcoCampaignCaravan with all the caravans that are idle
FactionContextCcoCampaignFactionVoidReturns the faction context of this class

CcoCampaignFactionGovernorship

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EstablishProvinceGovernorshipVoidCcoCampaignProvince, CcoCampaignCharacterEstablishes a new governorship with the province and governor passed in
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
UnassignedGovernorsCountIntVoidReturns the number of unassigned governors
SelectFirstValidTargettingInterfaceVoidVoidSelects the first valid governorship targetting interface, if any
ProvinceGovernashipFromProvinceCcoCampaignProvinceGovernorshipCcoCampaignProvinceReturns the province governorship that contains the passed in province, if any
MaximumGovernorCountIntVoidReturns the maximum number of governors that can be present
MoveProvinceGovernorVoidCcoCampaignProvince, CcoCampaignProvinceMoves a governor from one province to another
ProvinceGovernashipFromGovernorCcoCampaignProvinceGovernorshipCcoCampaignCharacterReturns the province governorship that contains the passed in governor, if any
SelectProvinceDecisionChoiceVoidCcoCampaignProvince, CcoCampaignDecisionChoiceRecordSelect dilemma choice for the passed in governor
ProvinceGovernorshipListCcoCampaignProvinceGovernorship (list)VoidReturns a list of all province governorships that have been already established

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
IsWarCoordinationAvailableBoolVoidReturns true if the source and target faction have war coordination available (military allies)
SetTargetVoidContextSelects a war coordination target (CcoCampaignMilitaryForce or CcoCampaignSettlement)
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)
OpenWarCoordinationPanelVoidString (optional)Opens up the war coordination panel, pass a specific tab key to select that section otherwise defaults to first available
ReverseInteractionContextCcoCampaignFactionInteractionVoidReturns the interaction the opposite way around (so can see requests in opposite direction, etc)
TargetFactionContextCcoCampaignFactionVoidThe target faction interacting with
EnableTargettingVoidBoolSets the targetting mode on/off as specified to pick a target
AlliedBuildingsContextCcoCampaignFactionAlliedBuildingsVoidGets the CcoCampaignFactionAlliedBuildings context to deal with outposts
ZoomToTargetVoidVoidZooms the camera to the current war coordination target
WarCoordinationPendingRequestsListCcoCampaignWarCoordinationRequest (list)VoidAdd favour points for dev functionality, can be positive or negative
CurrentTargetRequestContextCcoCampaignWarCoordinationRequestVoidReturns the CcoCampaignWarCoordinationRequest requested from the target faction to the source faction (for war coordinations requests from AI, the request accepted from WarCoordinationPendingRequestsList basically)
ClearTargetVoidVoidClears the curent war coordination target
SourceFactionContextCcoCampaignFactionVoidThe source faction (usually player)
DevAddFavourPointsVoidIntAdd favour points for dev functionality, can be positive or negativedebug, hide_in_uied
CheapestTargetFavourPointsCostIntString (optional)Returns the favour point cost for the cheapest target. Can optionally pass the targetting type(OFFENSIVE, DEFENSIVE, OCCUPY) (used to show on tooltip so know how much need to use set target button for example). Returns 0 if no valid targets
IsValidTargetBoolContextReturns true if supplied context is a valid war coordination target (CcoCampaignMilitaryForce or CcoCampaignSettlement)
IsTargettingActiveBoolVoidReturns true if targetting mode is currently active
CanLoanMilitaryForceBoolCcoCampaignMilitaryForceReturns true if the specified force of the target faction can be loaned to the source faction
FavourPointsCostForTargetIntContextReturns the favour point cost to set a particular war coordination target (CcoCampaignMilitaryForce or CcoCampaignSettlement)
LoanMilitaryForceVoidCcoCampaignMilitaryForceLoans the specified force of the target faction to the source faction
MilitaryForcesLoanedListCcoCampaignMilitaryForce (list)VoidReturns a list of military forces loaned from the target to the source faction
IsContextTargetedBoolContextReturns whether the given context is targeted. (Allows child classes to add unique targeting conditions)
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)
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
CurrentTargetContextContextVoidReturns the current target to attack or defend for war coordination (CcoCampaignMilitaryForce or CcoCampaignSettlement)
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
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)
ToggleTargettingForTypeVoidStringEnables targetting with the passed in option type

CcoCampaignFactionProvinceManager

Wrapper for a campaign FACTION_PROVINCE_MANAGER

Functions

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

CcoCampaignFactionWarContracts

Wrapper for a campaign FACTION_WAR_CONTRACTS struct

Functions

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

CcoCampaignFactionWomCompass

Wrapper for wom compass

Functions

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

CcoCampaignGovernorshipInteraction

Functions

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

CcoCampaignInitiative

Wrapper for a campaign initiative

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PointsCostIntVoidReturns how many points this initiative contributes towards the set's limits (can be negative)
TotalCountOfRequiredUnitsIntVoidReturns the total count of required units
RemainingDurationIntVoidReturns the remaining duration of the intiative
MarkAsSeenVoidVoidMarks the initiative as seen
TurnsUntilPayloadIsActivatedIntCcoCampaignPayloadRecordReturns the number of turns until the payload is reactivated
ActivateVoidInt (optional)Activates the initiative, to an optionally provided slot index
CooldownIntVoidReturns the cooldown for the initiative, or 0 if it does not have a cooldown period
RemainingCooldownIntVoidReturns the remaining cooldown for the initiative, or 0 if it is not on cooldown
DeactivateVoidVoidDeactivates the initiative
ForceMeetsUnitRequirementsBoolCcoCampaignMilitaryForceReturns true if this initiative meets the units requirements set in the required_units field
LockReasonsUniStringVoidReturns reasons that this initiative is locked as a string
DurationIntVoidReturns the duration for the initiative, or 0 if it has infinite duration, which should be queried seperately
ToggleVoidInt (optional)Activates an initiative, to an optionally provided slot index, or deactivates an activated initiative.
IsOnCooldownBoolVoidReturns true if the initiative itself is on cooldown
RequiredCostContextCcoCampaignResourceTransactionVoidReturns context to required resource cost. Initiative is locked until these transactions have been met
HasSeenBoolVoidReturns true if this initiative has been seen before (modified by MarkAsSeen)
LinkedTechnologyListCcoTechnologyRecord (list)VoidReturns list of technologies that modify this initiative
IsScriptLockedBoolVoidReturns true if this initiative is script locked.
CostContextCcoCampaignResourceTransactionVoidReturns context to intitial cost
IsOnlyOnCooldownBoolInt (optional)Returns true if locked only because of being on cooldown. Can provide an optional slot index
UpkeepCostContextCcoCampaignResourceTransactionVoidReturns context to per-turn upkeep cost
HasInfiniteDurationBoolVoidReturns true if this initiative will not expire
InitiativeSetContextCcoCampaignInitiativeSetVoidReturns the initiative set this initiative belongs to
IsLockedBoolInt (optional)Returns true if this initiative is locked. Alternatively given a slot index, return if locked for given slot
InitiativeContextCcoInitiativeRecordVoidReturns associated initiative record wrapper
TotalNumberOfRequirementsMetForForceIntCcoCampaignMilitaryForceReturns the total count of required units met in a force
IsActiveBoolVoidReturns true if this initiative is currently active

CcoCampaignInitiativeManager

Component context manager for campaign initiatives

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TotalUpkeepIntCcoCampaignPooledResource (optional)Get the value of what the total upkeep will be after the selection has been confirmed
InitiativesMarkedForActivationCcoCampaignInitiative (list)CcoCampaignInitiativeSet (optional)Returns the initiatives which have been marked for activation
InitiativesMarkedForDeactivationCcoCampaignInitiative (list)CcoCampaignInitiativeSet (optional)Returns the initiatives which have been marked for deactivation
InitiativeSetListCcoCampaignInitiativeSet (list)String (optional)Returns all the initiative sets within the manager optionally filtered for a category
ApplyPendingInitiativeChangesVoidVoidHandler when the confirmation button is clicked
ClearListsVoidVoidClears the lists of to-be activated and de-activated initiatives. For when the panel is closing
ToggleInitiativeVoidCcoCampaignInitiativeHandler when the initiative buttons are clicked
ToggleInitiativeAndDependantLevelsVoidCcoCampaignInitiativeHandler when the initiative buttons are clicked
CanPayPendingInitiativesExpenditureCostBoolCcoCampaignPooledResourceReturns true if the pending initiatives cost can be paid.
IsInitiativeSelectedBoolCcoCampaignInitiativeCheck if the initiative button should be displayed as selected (active or to-be active)
TotalCostForConfirmationIntCcoCampaignPooledResource (optional)Get the total cost to confirm the selection
PostConfirmActiveInitiativeListCcoCampaignInitiative (list)CcoCampaignInitiativeSet (optional)Returns the initiatives which will be active once the confirm button is clicked. This is used to display the potential active effects

CcoCampaignInitiativeSet

Component context wrapper for a campaign initiatives

Functions

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

CcoCampaignMilitaryForce

Component context wrapper for a campaign military force

Functions

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

CcoCampaignMilitaryForceHorde

Functions

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

CcoCampaignMilitaryForceMorale

Component context wrapper for a campaign military force's morale

Functions

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

CcoCampaignMilitaryForceStance

Functions

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

CcoCampaignMilitaryForceWarTargetting

Functions

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

CcoCampaignMission

Component context wrapper for a CAMPAIGN_MISSION

Functions

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

CcoCampaignMissionDefinition

Component context wrapper for a CAMPAIGN_MISSION_DEFINITION

Functions

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

CcoCampaignMissionObjective

Component context wrapper for a CAMPAIGN_MISSION_OBJECTIVE

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MaxProgressValueIntVoidReturns the max progress value
ObjectiveRequirementsListCcoCampaignMissionObjectiveRequirements (list)Bool (optional)Returns the mission objective requirements list
CanTrackProgressBoolVoidReturns whether progress can be tracked on this mission
ObjectiveCompletedBoolVoidReturns whether the objective has been completed
ObjectiveCancelledBoolVoidReturns whether the objective has been cancelled
CurrentProgressValueIntVoidReturns the current progress value

CcoCampaignMissionObjectiveRequirements

Component context wrapper for a CAMPAIGN_MISSION_COMPLETION_STATUS_LINE

Functions

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

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

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)
IconPathStringVoidReturns icon path from end_turn_notification record
NotificationTypeStringVoidReturns the notification type from end_turn_notification record
DisplayTextUniStringVoidReturns localised display text from end_turn_notification record
DescriptionUniStringVoidReturns localised detailed description from end_turn_notification record
PooledResourceContextCcoCampaignPooledResourceVoidReturns the CcoCampaignPooledResource related to notification if exists
TitleUniStringVoidReturns localised title from end_turn_notification record
ProvinceContextCcoCampaignProvinceVoidReturns the CcoCamapignProvince related to notification if exists
MilitaryForceContextCcoCampaignMilitaryForceVoidReturns the CcoCampaignMilitaryForce related to notification if exists
FactionContextCcoCampaignFactionVoidReturns the CcoCampaignFaction related to notification if exists
CharacterContextCcoCampaignCharacterVoidReturns the CcoCampaignCharacter related to notification if exists
SettlementContextCcoCampaignSettlementVoidReturns the CcoCampaignSettlement related to notification if exists
IsSkippableBoolVoidReturns true if this notification can be skipped
CanBeSupressedBoolVoidReturns true if this notification can be suppressed

CcoCampaignPendingActionNotificationQueue

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

Functions

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

CcoCampaignPlagueComposition

Wrapper for a plague composition (base plague plus ingredients)

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SpreadChanceToForcesPercentageFloatCcoCampaignFactionReturns an float between with the percentage the spread change for force targets
SpreadChanceToRegionFloatCcoCampaignSettlement, CcoCampaignFactionReturns the chance for this plague to spread to a specific region for the creator
ReductionPostSpreadPercentageFloatCcoCampaignFactionReturns an float between with the percentage spread change reduction after spreading
SpreadChanceToRegionsPercentageFloatCcoCampaignFactionReturns an float between with the percentage the spread change for region targets
InfectionDurationForTargetIntCcoCampaignFaction, ContextReturns an int with the duration of this compositio for the passed in target
ImmunityDurationIntCcoCampaignFactionReturns an int with the immunity duration of a target after being infected
InfectionDurationIntCcoCampaignFactionReturns an int with the duration of this composition
PlagueIngredientListCcoCampaignPlagueIngredient (list)VoidReturns a list of plague ingredients in the infection data
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
BasePlagueContextCcoCampaignBasePlagueVoidReturns the plague record context in the infection data
SpecialCompositionForFactionContextCcoPlagueSpecialCompositionRecordCcoCampaignFactionReturns the special composition for this combination of plague and ingredients for the passed in faction, if any
NameUniStringVoidReturns the name of the composition. Will be either the name of the reciepe if exists, if not the combination of base and ingredients
SpreadChanceToForceFloatCcoCampaignMilitaryForce, CcoCampaignFactionReturns the chance for this plague to spread to a specific military force for the creator

CcoCampaignPlagueCompositionEffectList

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

Functions

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

CcoCampaignPlagueInfection

Wrapper for a campaign REGION_INFECTION or MILITARY_FORCE_INFECTION

Functions

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

CcoCampaignPlagueIngredient

Wrapper for a campaign plague component

Functions

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

CcoCampaignPlaguesCompositionSystem

Wrapper for a campaign plagues composition system

Functions

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

CcoCampaignPooledResource

Wrapper for a campaign pooled resource

Functions

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

CcoCampaignPooledResourceDistributor

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

Functions

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

CcoCampaignPooledResourceManager

Context wrapper for pooled resource manager.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanAffordTreasuryCostBoolCcoCampaignResourceTransactionReturns true if can afford the treasury cost of the specified resource transaction
HasRequiredTradeResourcesBoolCcoCampaignResourceTransactionReturns true if this transaction has the required trade resources
CanAffordSpecificPooledResourceCostBoolCcoCampaignPooledResourceTransactionReturns true if can afford the specific pooled resource cost specified by provided CcoCampaignPooledResourceTransaction
CanAffordPooledResourceCostBoolCcoCampaignResourceTransactionReturns true if can afford the pooled resource cost of the specified resource transaction
CanAffordBoolCcoCampaignResourceTransactionReturns true if can afford the resource cost of the specified resource transaction

CcoCampaignPooledResourceMilitaryForceBreakdown

Wrapper for a military force breakdown of a pooled resource

Functions

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

CcoCampaignPooledResourceProvinceBreakdown

Wrapper for a province breakdown of a pooled resource

Functions

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

CcoCampaignPooledResourceSettlementBreakdown

Wrapper for a region/settlement breakdown of a pooled resource

Functions

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

CcoCampaignPooledResourceTransaction

Context wrapper for pooled resource transactions.

Functions

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

CcoCampaignProvince

Wrapper for a campaign province.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsContestedBoolVoidReturns true if it's being contested by another faction.
NumRegionsIntVoidReturns an int with the number of regions in the province.
WindsOfMagicAreaContextCcoCampaignWindsOfMagicAreaVoidReturns the context of the winds of magic area in this province.
IsSelectedBoolVoidReturns true if any settlement in this province is selected.
ModelProvinceContextCcoCampaignModelProvinceVoidReturns the CcoCampaignModelContext for this province
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.
SettlementListContextListVoidReturns the settlement list in the province.
DevAddDevPointVoidVoidDev command that adds development points to this province.debug, hide_in_uied
LocalPlayerProvinceManagerContextCcoCampaignFactionProvinceManagerVoidReturns the context of the local player province manager, if this exists in this province.
ProvinceManagerForFactionCcoCampaignFactionProvinceManagerCcoCampaignFactionReturns the context of the province manager of the faction that is passed in, if it exists in this province.
PooledResourceContextCcoCampaignPooledResourceStringReturns the context of the pooled resource with the key specified, if this resource exists in the province.
PooledResourceListContextListVoidReturns a list with all the pooled resources from this province.
CapitalSettlementContextCcoCampaignSettlementVoidReturns the context of the capital settlement of this province
CQIIntVoidReturns an int with the cqi of this object.
IsPlayerInvolvedBoolVoidReturns true if the player faction own any regions in this province.
IsPlayerCompleteOwnerBoolVoidReturns true if player owns all the settlements in the province
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
IncomeIntVoidReturns the income that this province generates
MercenaryPoolContextCcoCampaignProvinceMercenaryPoolVoidReturns the context of mercenary pool of this province
SelectAndZoomVoidVoidSelects and zooms to a settlement in this order: player capital, player owned settlement, province capital.
ZoomToVoidVoidZooms to capital of province

CcoCampaignProvinceAutoManagement

Wrapper for province auto-management logic

Functions

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

CcoCampaignProvinceGovernorship

Wrapper for a province governorship

Functions

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

CcoCampaignPublicOrder

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HappinessRangeEffectBundleListVoidVoid
ProvidedEffectBundleVoidVoid
BalancePercentageVoidVoid
DetailsVoidVoid
ChangePerTurnVoidVoid
ChangePerTurnStateVoidVoid
BreakdownListVoidVoid
BalanceVoidVoid
StateVoidVoid

CcoCampaignResourceTransaction

Context wrapper for resource transactions.

Functions

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

CcoCampaignRitual

Wrapper for a campaign ritual

Functions

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

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
RitualChainContextCcoRitualChainRecordVoidGet record context for the chain
LastCompletedContextCcoCampaignRitualVoidGet context of last completed ritual in chain if any completed
RitualsListCcoCampaignRitual (list)VoidGet list of CcoCampaignRituals in the chain

CcoCampaignRitualInteraction

Class that manages targetting interface interaction for a ritual

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
InvalidReasonsForTargetUniStringContextReturns the reasons why the passed in target is invalid. Returns empty string if valid
IsTargettingActiveBoolVoidReturns true if this is the currently active targetting interface
IsContextTargetedBoolContextReturns whether the given context is targeted. (Allows child classes to add unique targeting conditions)
WasActionPerformedBoolVoidReturns true if the ritual is completed
RitualContextCcoCampaignRitualVoidReturns the context of the ritual associated with this class.
IsRepeatableBoolVoidReturns true if the ritual is repeatable
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
ActionPerformTooltipUniStringVoidReturns a tooltip specifying whether can perform the ritual or not, exmplaining the reason if cannot be performed
TargetFactionContextCcoCampaignFactionVoidReturns the target faction context if any
ActionCostCcoCampaignResourceTransactionVoidReturns the cost of the ritual.
CanPerformActionBoolCcoCampaignCharacter (optional)Returns true if can perform ritual with the current target setup
SetTargetVoidContextSets the target to the object passed in
PerformActionVoidCcoCampaignCharacter (optional)Performs a ritual with the current target stored
UpdateTargetFactionVoidBool (optional)Updates the faction with the current targetting interface faction. This is so all targetting interfaces are in sync
ToggleTargettingVoidVoidToggles the targetting system through the CampaignTargettingInterface.
ClearTargetVoidVoidClears the currently stored target
IsValidTargetBoolContextReturns true if the passed in object is a valid target
ZoomToTargetVoidVoidZooms to the stored target
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
AvailableRitualListCcoCampaignRitual (list)VoidGet list of available rituals
UnlockableRitualListCcoCampaignRitual (list)VoidGet list of unlockable rituals
RitualChainContextFromKeyCcoCampaignRitualChain (list)StringReturns list of ritual chains matching given key
RitualChainContextFromCategoryCcoCampaignRitualChain (list)StringReturns list of ritual chains for given ritual category string
RitualContextCcoCampaignRitualCcoRitualRecordGet a CcoCampaignRitual if one exists from a provided ritual record

CcoCampaignRoot

Functions

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

CcoCampaignRouteNode

Wrapper for campaign route node

Functions

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

CcoCampaignRouteSegment

Wrapper for campaign route segment

Functions

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

CcoCampaignSettlement

Wrapper for a campaign settlement.

Functions

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

CcoCampaignSkavenCorruptionOverlay

Record wrapper for a Skaven corruption overlay

Functions

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

CcoCampaignSlaves

Functions

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

CcoCampaignTechnology

Component context wrapper for a campaign technology

Functions

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

CcoCampaignTechnologyManager

Wrapper for a faction's technology manager

Functions

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

CcoCampaignTreasuryTransaction

Context wrapper for treasury transactions.

Functions

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

CcoCampaignUnit

Component context wrapper for a campaign unit

Functions

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

CcoCampaignUnitGroupUpgrade

Component context wrapper for a UNIT_GROUP_UPGRADE

Functions

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

CcoCampaignUnitPurchasableEffectCost

Context wrapper for pairing purchasable effect record and resource transaction.

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectRecordCcoUnitPurchasableEffectRecordVoidReturns purchasable effect record cco
ResourceTransactionCcoCampaignResourceTransactionVoidReturns resource transaction cco

CcoCampaignUnitUpgradeManager

Component context wrapper for a UNIT_UPGRADE_MANAGER

Functions

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

CcoCampaignUnitUpgradesBuildingRequirement

Component context wrapper for a UNIT_GROUP_TECH_REQUIREMENT

Functions

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

CcoCampaignUnitUpgradesTechRequirement

Component context wrapper for a UNIT_GROUP_TECH_REQUIREMENT

Functions

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

CcoCampaignWarContract

Wrapper for a campaign war contract

Functions

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

CcoCampaignWarCoordinationRequest

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

Functions

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

CcoCampaignWinStreak

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TurnsUntilDecayVoidVoid
CurrentStreakEffectContextVoidVoid
EffectUnfilteredListVoidVoid
WinStreakPercentVoidVoid
InvalidationRoundVoidVoid
EffectListVoidVoid
CampaignStreakContextVoidVoid
CurrentWinStreakVoidVoid

CcoCampaignWindsOfMagicArea

Wrapper for a winds of magic area.

Functions

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

CcoCampaignWindsOfMagicSystem

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AreaContextForRegionCcoCampaignWindsOfMagicAreaCcoRegionRecord
ChangeAreaStrengthVoidCcoCampaignWindsOfMagicArea, CcoCampaignMapWindsOfMagicStrengthRecord
AreaContextForProvinceCcoCampaignWindsOfMagicAreaCcoCampaignProvince
AllAreaContextsContextListVoid

CcoCampaignWomCompassDirection

Wrapper for wom compass direction

Functions

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

CcoCampaignWomCompassPowerLevelRange

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

Functions

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

CcoCookingDish

Wrapper for a COOKING_DISH struct

Functions

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

CcoCookingSystem

Wrapper for the cooking system for a given faction

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetPossibleRecipeRecordsCcoCookingRecipeRecord (list)VoidReturns a list of CcoCookingRecipeRecord with all recipes
UnlockAllRecipesVoidVoidDev command to unlock all recipesdebug, hide_in_uied
GetUnlockedIngredientRecordsCcoCookingIngredientRecord (list)VoidReturns a list of CcoCookingIngredientRecord with all the unlocked ingredients
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
GetUnlockedRecipeRecordsCcoCookingRecipeRecord (list)VoidReturns a list of CcoCookingRecipeRecord with all the unlocked recipes
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
UnlockAllIngredientsVoidVoidDev command to unlock all ingredientsdebug, hide_in_uied
PrimaryIngredientsForRecipeCcoCookingIngredientRecord (list)CcoCookingRecipeRecord, BoolReturns a list of CcoCookingIngredientRecord with primary ingredients needed for the CcoCookingRecipeRecord passed in
DishesAppliedToUnitListCcoCookingDish (list)CcoCampaignUnitReturns a list of CcoCookingDish with the dishes applied to the passed in unit
RevertDishAppliedToUnitVoidCcoCampaignUnit, CcoCookingDishReverts the passed in cooking dish on the passed in unit
DishesAppliedToAllUnitsListCcoCookingDish (list)VoidReturns a list of CcoCookingDish with the dishes applied to all units
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
StoredCookingDishListCcoCookingDish (list)VoidReturns a list of CcoCookingDish with all stored cooking dishes
IngredientCooldownIntCcoCookingIngredientRecordReturns an int with the cooldown of the passed in ingredient (returns 0 if not on cooldown)
CanCookIngredientsBoolContextList, ContextListReturns true if the passed in ingredients can be cooked into a valid dish
PossibleIngredientsForCategoryCcoCookingIngredientRecord (list)CcoCookingIngredientGroupRecordReturns a list of CcoCookingIngredientRecord for the CcoCookingIngredientGroupRecord passed in
StoredAmountForRecipeIntCcoCookingRecipeRecordReturns an int with the number of dishes stored for the passed in recipe
MaximumNumberOfSecondaryIngredientsIntVoidReturns an int with the maximum number of allowed secondary ingredients
IngredientIsUnlockedBoolCcoCookingIngredientRecordReturns true if the passed in CcoCookingIngredientRecord 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
AnyIngredientOfCategoryIsUnlockedBoolCcoCookingIngredientGroupRecordReturns true if any ingredient from the passed in CcoCookingIngredientGroupRecord is unlocked
CurrentActiveDishContextCcoCookingDishVoidReturns a CcoCookingDish with the current dish context
RecipeIsUnlockedBoolCcoCookingRecipeRecordReturns true if the passed in CcoCookingRecipeRecord is unlocked
MaximumNumberOfPrimaryIngredientsIntVoidReturns an int with the maximum number of allowed primary ingredients
AllIngredientsUnlockedForRecipeBoolCcoCookingRecipeRecordReturns a list of CcoCookingIngredientRecord for the CcoCookingRecipeRecord passed in
CookIngredientsVoidContextList, ContextList, BoolCalls a CCQ command to cook the primary and secondary CONTEXT_LIST ingredients passed in
GetPossibleIngredientRecordsCcoCookingIngredientRecord (list)VoidReturns a list of CcoCookingIngredientRecord with all ingredients
IsDishActiveBoolVoidReturns true if a dish is currently active

CcoDiplomacyThreatLevel

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

Functions

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

CcoEpisodicOverride

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsOverridenVoidVoid

CcoFloatingTextAgentActionEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TargetFlagPathVoidVoid
TextTypeVoidVoid
IsSuccessVoidVoid
AgentFlagPathVoidVoid
ActionNameVoidVoid
TargetNameVoidVoid
AgentNameVoidVoid

CcoFloatingTextBattleEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AttackerFlagPathVoidVoid
DefenderFlagPathVoidVoid
AttackerVoidVoid
DefenderVoidVoid
TextTypeVoidVoid

CcoFloatingTextStanceEvent

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GeneralNameVoidVoid
NewStanceNameVoidVoid
GeneralFlagPathVoidVoid
TextTypeVoidVoid
OldStanceNameVoidVoid

CcoJadeMissionElement

Wrapper for a quest chain mission

Functions

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

CcoMalakaiOathsQuestChain

Wrapper for a battles of legend quest chain

Functions

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

CcoPooledResourceTransfer

Component context manager for pooled resource transfer

Functions

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

CcoPreBattleAIAvailableGenerals

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GetGeneralsListContextListVoid

CcoPreBattleFactionVote

Functions

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

CcoPreBattleVotingSystem

Functions

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

CcoPrisonSystem

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsPrisonFullVoidVoid
CurrentNumberOfPrisonersVoidVoid
MaxNumberOfPrisonersVoidVoid

CcoSaveGameHeader

Wrapper for a save game header

Functions

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

CcoTempleOfTheOldOnes

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentLevelVoidVoid
NumberOfBuildingsVoidVoid
NameVoidVoid
DescriptionVoidVoid
CurrentEffectBundleVoidVoid
ColourVoidVoid

Record

CcoAbilityCollectionRecord

Wrapper for an AbilityCollection for nested abilities

Functions

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

CcoAbilityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
ViewInDbVoidVoid
OnScreenNameVoidVoid
OnScreenDescriptionVoidVoid
KeyVoidVoid
AbilityVoidVoid

CcoActionResultRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
ActorEffectBundleTurnsVoidVoid
TargetEffectBundleTurnsVoidVoid
ActorEffectBundleVoidVoid
TargetEffectBundleVoidVoid
KeyVoidVoid

CcoAdviceLevelRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
InfoTextVoidVoid
AdvisorNameVoidVoid
TitleVoidVoid
TextVoidVoid
AdviceThreadVoidVoid
CategoryVoidVoid
SubCategoryVoidVoid
KeyVoidVoid

CcoAgentActionRecord

Functions

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

CcoAgentCultureDetailRecord

Functions

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

CcoAgentRecord

Record wrapper for an AGENT_RECORD

Functions

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

CcoAgentSubtypeRecord

Record wrapper for agent_subtypr_record

Functions

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

CcoAncillariesCategoryRecord

Record wrapper for an ancillaries_category_record

Functions

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

CcoAncillariesSubcategoryRecord

Context wrapper for a ANCILLARIES_SUBCATEGORY_RECORD

Functions

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

CcoAncillaryRecord

Record wrapper for a ancillary_record

Functions

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

CcoAncillarySetRecord

Record wrapper for an ancillary set record

Functions

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

CcoAncillaryTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconVoidVoid
RecordListVoidVoid
KeyVoidVoid

CcoAncillaryUniquenessGroupingRecord

Record wrapper for a ancillary_uniqueness_grouping_record

Functions

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

CcoArmoryItemRecord

Record wrapper for armory item record

Functions

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

CcoArmoryItemSetRecord

Wrapper for a ARMORY_ITEM_SET_RECORD

Functions

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

CcoArmoryItemUiTypeRecord

Wrapper for a ARMORY_ITEM_UI_TYPE_RECORD

Functions

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

CcoArmoryItemVariantRecord

Wrapper for an armory item variant record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoArmoryItemVariantRecord (list)VoidReturns a list with all armory item variants in the database table.
ArmoryItemContextCcoArmoryItemRecordVoidReturns the context of the armory item associated with this item variant
UseAsDefaultBoolVoidReturns a bool that specifies whether this variant is used as the default
NameUniStringVoidReturns the localised name of the item variant
DescriptionUniStringVoidReturns the description of this variant
KeyStringVoidReturns a string with the key of this record
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)
NameUniStringVoidReturns a the localised name of the slot type
SortOrderIntVoidReturns an int with the sort order
RecordListCcoArmorySlotTypeRecord (list)VoidReturns a list with all armory slot type records from the database table
KeyStringVoidReturns a string with the key of the record

CcoArmySpecialAbilityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ArmySpecialAbilityKeyVoidVoid
UniqueIDVoidVoid
EnablesSiegeAssaultVoidVoid
UnitSpecialAbilityContextVoidVoid

CcoBannerRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PermittedUnitSetsVoidVoid
RecordListVoidVoid
BannerVoidVoid
CombatPotentialAdjustmentsVoidVoid
EffectBundleRecordVoidVoid

CcoBattleClimateWeatherDescriptionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProbabilityVoidVoid
SpottingScalarVoidVoid
RecordListVoidVoid
HeatFatigueVoidVoid
ColdFatigueVoidVoid
WeatherRecordContextVoidVoid
SeasonRecordContextVoidVoid
ClimateRecordContextVoidVoid

CcoBattleCurrencyArmySpecialAbilitiesCostValueRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CostValueVoidVoid
ArmySpecialAbilityContextVoidVoid
BattleSecondaryCurrencyTypeContextVoidVoid

CcoBattleCurrencyUnitAbilitiesCostValueRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CostValueVoidVoid
RecordListVoidVoid
CurrencyTypeContextVoidVoid
ItemTypeContextVoidVoid

CcoBattleEntityRecord

Functions

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

CcoBattlePurchasableGroupRecord

Wrapper for a battle purchasable group record

Functions

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

CcoBattlePurchasableItemsJunctionRecord

Wrapper for a Battle Purchasable Items Junction record

Functions

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

CcoBattlePurchasableItemsUiCategoryRecord

Wrapper for a UI Battle Purchasable Items Junction record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoBattlePurchasableItemsUiCategoryRecord (list)Void
CategoryKeyStringVoid

CcoBattleRecord

Record wrapper for a BATTLE_RECORD

Functions

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

CcoBattleResultTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
ResultDescriptionVoidVoid
UnitXpGainVoidVoid
ResultScreenNameVoidVoid
BattleResultTypeVoidVoid

CcoBattleSecondaryCurrencySourceTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SourceTypeVoidVoid
IsAllianceBasedVoidVoid
DescriptionVoidVoid
UiLocalisedNameVoidVoid
RecordListVoidVoid

CcoBattleSecondaryCurrencyTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
UiLocalisedNameVoidVoid
UiIconPathVoidVoid
CurrencyTypeVoidVoid

CcoBattleSetPieceArmiesCharacterRecord

Functions

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

CcoBattleSetPieceArmiesCharactersItemRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CharacterItemContextVoidVoid
RecordListVoidVoid
NameVoidVoid

CcoBattleSetPieceArmiesCharactersSkillRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CharacterNameVoidVoid
RecordListVoidVoid
SkillContextVoidVoid
LevelVoidVoid

CcoBattleSetPieceArmiesUnitRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
PercentageNumMenVoidVoid
RecordListVoidVoid
UnitRecordContextVoidVoid
UnitLevelVoidVoid

CcoBattleSetPieceArmyRecord

Wrapper for a BATTLE_SET_PIECE_ARMY_RECORD

Functions

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

CcoBattleSetPieceFrontendGroupRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CampaignMapContextVoidVoid
KeyVoidVoid
RecordListVoidVoid
CharacterListVoidVoid
BattleListVoidVoid
SortOrderVoidVoid

CcoBattleSetPieceFrontendGroupsToCharacterRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CharacterContextVoidVoid
FrontendGroupContextVoidVoid

CcoBattleSetPieceRecord

Wrapper for a BATTLE_SET_PIECE_RECORD

Functions

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

CcoBattleTypeCheatSheetEntryRecord

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

Functions

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

CcoBattleTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DefenderVictoryConditionsListVoidVoid
DefenderFundsRatioVoidVoid
ListOrderVoidVoid
AttackerVictoryConditionsListVoidVoid
KeyVoidVoid
NameVoidVoid
RecordListVoidVoid
MaxTeamsizeVoidVoid
DescriptionVoidVoid

CcoBattleVortexRecord

Wrapper for a BATTLE_VORTEX_RECORD

Functions

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

CcoBattleWeatherTypeRecord

Functions

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

CcoBattlefieldEngineRecord

Wrapper for a BATTLEFIELD_ENGINE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoBattlefieldEngineRecord (list)Void
BattleEntityContextCcoBattleEntityRecordVoid
CanBeDismantledBoolVoid
KeyStringVoid
MissileWeaponContextCcoMissileWeaponRecordVoid

CcoBattlefieldSiegeVehicleRecord

Wrapper for BATTLEFIELD_SIEGE_VEHICLE_RECORD

Functions

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

CcoBattlefieldSiegeVehiclesCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProbabilityVoidVoid
RecordListVoidVoid
VehicleContextVoidVoid
CapVoidVoid

CcoBuildingChainRecord

Wrapper for a building chain record

Functions

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

CcoBuildingCultureVariantRecord

Functions

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

CcoBuildingLevelRecord

Record wrapper for a BUILDING_LEVEL_RECORD

Functions

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

CcoBuildingSetRecord

Record wrapper for a BUILDING_SET_RECORD

Functions

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

CcoBuildingSuperchainRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ChainListVoidVoid
ChainsForProvinceListVoidVoid
KeyVoidVoid
RecordListVoidVoid

CcoBulletPoint

Context wrapper for a bullet point

Functions

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

CcoCampaignBattlePresetRecord

Functions

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

CcoCampaignDecisionChoiceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IndexVoidVoid
RecordListVoidVoid
PayloadCharacterTraitListVoidVoid
DecisionRecordContextVoidVoid
TitleVoidVoid
LabelVoidVoid

CcoCampaignDecisionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionVoidVoid
RecordListVoidVoid
ImageVoidVoid
KeyVoidVoid
TitleVoidVoid
ChoiceListVoidVoid

CcoCampaignEffectListRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
EffectsVoidVoid

CcoCampaignEffectScopeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LocalisedTextVoidVoid
RecordListVoidVoid
KeyVoidVoid

CcoCampaignFactionCheatSheetEntryRecord

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

Functions

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

CcoCampaignGroupRecord

Wrapper for a campaign group record

Functions

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

CcoCampaignMapPlayableAreaRecord

Wrapper for CAMPAIGN_MAP_PLAYABLE_AREA_RECORD

Functions

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

CcoCampaignMapWindsOfMagicAreaRecord

Functions

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

CcoCampaignMapWindsOfMagicStrengthRecord

Wrapper for a CAMPAIGN_MAP_WINDS_OF_MAGIC_STRENGTH_RECORD record

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyStringVoidReturns a string with the database key of this strength level
RecordListCcoCampaignMapWindsOfMagicStrengthRecord (list)VoidReturns a list of CcoEffect with all wom strength records from the database table
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
DurationIntVoidReturns and int the duration of this wom strength level
EnableStormOfMagicBoolVoidReturns true if this strength enables storm of magic
FrequencyIntVoidReturns an int with the frequency of this level
LevelIntVoidReturns an int with the level of this strengh
LocalisedNameUniStringVoidReturns a localised string with the name of the strength
EffectListCcoEffect (list)VoidReturns a list of effects applied when this level is active

CcoCampaignOperationSetRecord

Wrapper for a CAMPAIGN_OPERATION_SET_RECORD

Functions

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

CcoCampaignPayloadRecord

Wrapper for a CAMPAIGN_PAYLOAD_RECORD

Functions

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

CcoCampaignPayloadResourceTransactionRecord

Wrapper for a CAMPAIGN_PAYLOAD_RESOURCE_TRANSACTION_RECORD

Functions

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

CcoCampaignPayloadUnitComponentRecord

Wrapper for a CAMPAIGN_PAYLOAD_UNIT_COMPONENT_RECORD

Functions

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

CcoCampaignStormTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ForSeaVoidVoid
CanDecayVoidVoid
CanMoveVoidVoid
KeyVoidVoid
RecordListVoidVoid
CanSpawnOverCharacterVoidVoid
RespectExcludedRegionsTableVoidVoid
ForLandVoidVoid

CcoCampaignStreakEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OnScreenNameVoidVoid
MaxVoidVoid
MinVoidVoid
RecordListVoidVoid
CampaignStreakKeyVoidVoid
KeyVoidVoid
EffectListVoidVoid
EffectUnfilteredListVoidVoid

CcoCampaignStreakRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
MaxVoidVoid
StreakEffectListVoidVoid
KeyVoidVoid
ResetTurnsVoidVoid
MinVoidVoid
RecordListVoidVoid
TypeVoidVoid

CcoCampaignVideoRecord

Functions

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

CcoCapturePointCategoryTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
IconPathVoidVoid
KeyVoidVoid
LocalisedNameVoidVoid

CcoCapturePointTypeRecord

A DB record wrapper for a battle capture point type

Functions

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

CcoCaravanContractRecord

Wrapper for a CARAVAN_CONTRACT_RECORD

Functions

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

CcoCdirEventsCategoryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TypeVoidVoid
RecordListVoidVoid
CategoryKeyVoidVoid
OnScreenNameVoidVoid

CcoCdirEventsDilemmaChoiceDetailRecord

Record wrapper for a CDIR_EVENTS_DILEMMA_CHOICE_DETAIL_RECORD

Functions

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

CcoCharacterAncillaryQuestUiDetailRecord

Record wrapper for character ancillary quest details

Functions

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

CcoCharacterSkillRecord

Wrapper for a character skill record.

Functions

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

CcoCharacterTrainingDilemmaChoiceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
DilemmaRecordContextVoidVoid
ChoiceEffectRecordVoidVoid
IndexVoidVoid
KeyVoidVoid
LocalisedLabelVoidVoid

CcoCharacterTrainingDilemmaRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
LocalisedDescriptionVoidVoid
TrainingEffectTypeVoidVoid
RecordListVoidVoid
ChoiceListVoidVoid
KeyVoidVoid
LocalisedTitleVoidVoid

CcoCharacterTraitLevelRecord

Functions

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

CcoCharacterTraitRecord

Functions

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

CcoClimateRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
RecordListVoidVoid

CcoCookingIngredientGroupRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ColourVoidVoid
RecordListVoidVoid
FlavourTextVoidVoid
KeyVoidVoid
IngredientsVoidVoid
DisplayNameVoidVoid
IconVoidVoid

CcoCookingIngredientRecord

Record wrapper for a COOKING_INGREDIENT_RECORD

Functions

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

CcoCookingRecipeRecord

Record wrapper for a COOKING_RECIPE_RECORD

Functions

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

CcoCorruptionCounterIntervalRecord

Wrapper for a CORRUPTION_COUNTER_INTERVAL_RECORD

Functions

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

CcoCorruptionTypeRecord

Wrapper for a CORRUPTION_TYPE_RECORD

Functions

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

CcoCultureRecord

Wrapper for a culture record

Functions

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

CcoCustomBattleCorruptionType

Wrapper for the corruption type setting in custom battle

Functions

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

CcoCustomBattleFactionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SortOrderVoidVoid
CultureSortOrderVoidVoid
FactionContextVoidVoid
RecordListVoidVoid

CcoCustomBattleSettingRecord

Wrapper for a CUSTOM_BATTLE_SETTING_RECORD

Functions

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

CcoDaemonAbilityBarDescriptionRecord

wrapper for a DAEMON_ABILITY_BAR_DESCRIPTION_RECORD

Functions

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

CcoDeployableRecord

Functions

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

CcoDeployablesCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
CapVoidVoid
ProbabilityVoidVoid
DeployableContextVoidVoid

CcoDilemmaRecord

Record wrapper for a DILEMMA_RECORD

Functions

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

CcoDiplomaticStanceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
StatusStateVoidVoid
StanceVoidVoid
RecordListVoidVoid
KeyVoidVoid
OnscreenTextVoidVoid

CcoElectorCountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
AncillaryRewardContextVoidVoid
UnitRewardContextVoidVoid
MapPosYVoidVoid
MapPosVoidVoid
MinisterialPositionEffectBundleVoidVoid
MapPosXVoidVoid
CapitalRegionContextVoidVoid

CcoEndTurnNotificationRecord

Functions

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

CcoEventFeedCategoryRecord

Record wrapper for an event feed category record

Functions

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

CcoFactionRecord

Wrapper for a faction record

Functions

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

CcoFactionSetRecord

Wrapper for a FACTION_SET_RECORD

Functions

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

CcoFormationRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NameVoidVoid
TooltipVoidVoid
OrderVoidVoid
IsArmyVoidVoid
IsNavalVoidVoid
FormationVoidVoid
IconNameVoidVoid
RecordListVoidVoid
DescriptionVoidVoid

CcoFrontendFactionLeaderRecord

Functions

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

CcoGroundTypeRecord

Functions

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

CcoGroundTypeToStatEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
EffectTextVoidVoid
EffectTextWithValueVoidVoid
AffectedGroupNameVoidVoid
IsPositiveVoidVoid
ValueVoidVoid
ValueForDisplayVoidVoid
GroundTypeVoidVoid

CcoGroupPooledResourceEffectRecord

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

Functions

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

CcoIncidentRecord

Wrapper for an incident record

Functions

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

CcoInitiativeRecord

Record wrapper for a INITIATIVE_RECORD

Functions

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

CcoInitiativeSetCategoryRecord

Wrapper for a INITIATIVE_SET_CATEGORY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoInitiativeSetCategoryRecord (list)Void
DisplayNameUniStringVoid
KeyStringVoid

CcoInitiativeSetRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
ActiveInitiativeLimitVoidVoid
ActivationCooldownVoidVoid
CategoryContextVoidVoid
KeyVoidVoid
ItemsVoidVoid

CcoInitiativeUnitSetRequirementsRecord

Record wrapper for a INITIATIVE_UNIT_SET_REQUIREMENT_RECORD

Functions

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

CcoLabSettingRecord

Wrapper for a LAB_SETTING_RECORD

Functions

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

CcoLandUnitArticulatedVehicleRecord

Wrapper for a LAND_UNIT_ARTICULATED_VEHICLE_RECORD

Functions

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

CcoLandUnitsToExtraEngineRecord

Wrapper for a LAND_UNITS_TO_EXTRA_ENGINE_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListCcoLandUnitsToExtraEngineRecord (list)Void
BattleEngineContextCcoBattlefieldEngineRecordVoid
AttachArticulationIntVoid
LandUnitContextCcoUnitLandRecordVoid

CcoLoadingScreenQuotesRecord

Record wrapper for a loading screen quote record

Functions

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

CcoMainUnitRecord

Wrapper for a main unit

Functions

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

CcoMeleeWeaponRecord

Functions

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

CcoMercenaryRecruitmentInfoRecord

Record wrapper for a mercenary recruitment info record

Functions

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

CcoMissileWeaponRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UseSecondaryAmmoPoolVoidVoid
RecordListVoidVoid
PrecursorVoidVoid
ProjectileContextListVoidVoid
KeyVoidVoid

CcoMissionIssuerRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
NameVoidVoid
RecordListVoidVoid
DefaultRoundsBetweenVoidVoid
IconPathVoidVoid
KeyVoidVoid

CcoMissionRecord

Wrapper for a MISSION_RECORD

Functions

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

CcoMortuaryCultCategoryRecord

Wrapper for a MORTUARY_CULT_CATEGORY_RECORD

Functions

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

CcoMountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
EntityVoidVoid
RecordListVoidVoid

CcoMountableArtilleryUnitsCustomBattleRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ProbabilityVoidVoid
FactionContextVoidVoid
RecordListVoidVoid
UnitRecordContextVoidVoid
CapVoidVoid

CcoMultiplayerCampaignSettingRecord

Wrapper for a MULTIPLAYER_CAMPAIGN_SETTING_RECORD

Functions

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

CcoMultiplayerCampaignSettingsOptionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TooltipVoidVoid
RecordListVoidVoid
OrderVoidVoid
ValueVoidVoid
MultiplayerCampaignSettingContextVoidVoid
LocalisedNameVoidVoid

CcoNarrativeViewerEntryRecord

Wrapper for a NARRATIVE_VIEWER_ENTRY_RECORD

Functions

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

CcoNarrativeViewerTabRecord

Wrapper for a NARRATIVE_VIEWER_TAB_RECORD

Functions

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

CcoNewContentPatchNoteRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OrderVoidVoid
RecordListVoidVoid
LocalisedPatchNoteVoidVoid
KeyVoidVoid

CcoOwnershipProductRecord

Wrapper for a OWNERSHIP_PRODUCT_RECORD

Functions

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

CcoPlagueComponentUiDataRecord

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OffsetVector4Void
LinkedSlotsListCcoPlagueComponentUiDataRecord (list)Void
IdIntVoid

CcoPlagueEffectList

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

Functions

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

CcoPlagueEffectRecord

Wrapper for a PLAGUE_EFFECT_RECORD

Functions

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

CcoPlagueMutationUiDataRecord

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

Functions

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

CcoPlagueParameterRecord

Wrapper for a PLAGUE_PARAMETER_RECORD

Functions

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

CcoPlagueRecord

Wrapper for a PLAGUE_RECORD

Functions

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

CcoPlagueSpecialCompositionRecord

Wrapper for a PLAGUE_SPECIAL_COMPOSITION_RECORD

Functions

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

CcoPooledResourceThresholdOperationSetRecord

Wrapper for a pooled_resource_threshold_operation_set_record

Functions

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

CcoProjectileBombardmentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
RadiusSpreadVoidVoid
NumProjectilesVoidVoid
KeyVoidVoid
ProjectileContextVoidVoid

CcoProjectileRecord

Cco wrapper for querying a projectile record

Functions

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

CcoProphecyOfSotekStageRecord

Wrapper for a PROPHECY_OF_SOTEK_STAGE_RECORD

Functions

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

CcoProphecyOfSotekStagesToMissionRecord

Wrapper for a PROPHECY_OF_SOTEK_STAGES_TO_MISSION_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OrderIntVoid
RecordListCcoProphecyOfSotekStagesToMissionRecord (list)Void
StageContextCcoProphecyOfSotekStageRecordVoid
MissionContextCcoMissionRecordVoid

CcoProvinceAutomanagementFocusRecord

Wrapper for a PROVINCE_AUTOMANAGEMENT_FOCUS_RECORD

Functions

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

CcoProvinceInitiativeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OrderVoidVoid
EffectBundleContextVoidVoid
KeyVoidVoid
EffectBundleContextForCurrentProvinceVoidVoid
RecordListVoidVoid
IconPathVoidVoid
StatusForCurrentProvinceVoidVoid
LocalisedNameVoidVoid

CcoRegionGroupRecord

Wrapper for a REGION_GROUP_RECORD

Functions

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

CcoRegionRecord

Wrapper for a REGION_RECORD

Functions

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

CcoReignOfChaosRecord

Wrapper for a REIGN_OF_CHAOS_RECORD

Functions

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

CcoResourceCostRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RequiredAncillariesListVoidVoid
PooledResourceCostsListVoidVoid
ExpenditureTypeVoidVoid
RequiredTradeResourcesListVoidVoid
TreasuryCostVoidVoid
IncomeTypeVoidVoid
IdVoidVoid
RecordListVoidVoid

CcoResourceRecord

Functions

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

CcoRitualCategoryGroupRecord

Wrapper for a RITUAL_CATEGORY_GROUP_RECORD

Functions

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

CcoRitualCategoryRecord

Wrapper for a RITUAL_CATEGORY_RECORD

Functions

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

CcoRitualChainRecord

Wrapper for a RITUAL_CHAIN_RECORD

Functions

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

CcoRitualPayloadAncillaryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PayloadVoidVoid
AncillaryContextVoidVoid

CcoRitualPayloadChangeAgentCapacityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CapacityVoidVoid
RecordListVoidVoid
AgentRecordContextVoidVoid
PayloadContextVoidVoid

CcoRitualPayloadChangeUnitAllowanceCapacityRecord

Wrapper for a RITUAL_PAYLOAD_CHANGE_UNIT_CAPACITY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CapacityIntVoid
RecordListCcoRitualPayloadChangeUnitAllowanceCapacityRecord (list)Void
PayloadContextCcoRitualPayloadRecordVoid
UnitListRecordContextCcoUnitListRecordVoid

CcoRitualPayloadChangeUnitCapacityRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
PayloadContextVoidVoid
UnitRecordContextVoidVoid
CapacityVoidVoid

CcoRitualPayloadDiplomaticAttitudeChangeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AttitudeDeltaVoidVoid
RecordListVoidVoid
PayloadVoidVoid

CcoRitualPayloadRecord

Wrapper for a ritual payload record

Functions

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

CcoRitualPayloadSpawnAgentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SpawnToPoolVoidVoid
RecordListVoidVoid
AgentTypeContextVoidVoid
AgentSubtypeContextVoidVoid
PayloadVoidVoid

CcoRitualPayloadSpawnArmyRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
FactionOverrideContextVoidVoid
SpawnAtRitualSiteVoidVoid
SpawnableForceContextVoidVoid
IdVoidVoid
PayloadVoidVoid

CcoRitualPayloadSpawnMercenaryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
SpawnableUnitContextVoidVoid
IdVoidVoid
PayloadVoidVoid

CcoRitualPayloadSpawnStormRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
RegionContextVoidVoid
MaxTurnsDurationVoidVoid
StormTypeContextVoidVoid
PayloadVoidVoid
StrengthVoidVoid

CcoRitualPayloadTeleportArmyRecord

Wrapper for a RITUAL_PAYLOAD_TELEPORT_ARMY_RECORD

Functions

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

CcoRitualPayloadTriggerDilemmaRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DilemmaContextVoidVoid
RecordListVoidVoid
PayloadVoidVoid

CcoRitualRecord

Record wrapper for a RITUAL_RECORD

Functions

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

CcoSeasonRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
OnscreenVoidVoid
RecordListVoidVoid

CcoSettlementClimateTypeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UiBackgroundImageVoidVoid
TypeVoidVoid
RecordListVoidVoid
UiNameVoidVoid
UiDescriptionVoidVoid
UiIconImageVoidVoid

CcoSpawnableForceRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
RecordListVoidVoid
UnitsListVoidVoid
UnitListsListVoidVoid

CcoSpawnableForceUnitJunctionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
MinAmountVoidVoid
MinXpVoidVoid
MaxAmountVoidVoid
MaxXpVoidVoid
SpawnableForceVoidVoid
UnitContextVoidVoid
IdVoidVoid

CcoSpawnableForceUnitListJunctionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitListContextVoidVoid
RecordListVoidVoid
MinAmountVoidVoid
MinXpVoidVoid
IdVoidVoid
MaxAmountVoidVoid
MaxXpVoidVoid
SpawnableForceVoidVoid

CcoSpecialAbilityGroupRecord

Wrapper for a SPECIAL_ABILITY_GROUP_RECORD record from special_ability_groups_tables

Functions

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

CcoSpecialAbilityIntensitySettingRecord

Wrapper for a SPECIAL_ABILITY_INTENSITY_SETTING_RECORD

Functions

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

CcoSpecialAbilityPhaseRecord

Wrapper for a SPECIAL_ABILITY_PHASE_RECORD

Functions

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

CcoSpecialAbilityPhaseStatEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HowVoidVoid
RecordListVoidVoid
PhaseVoidVoid
ValueVoidVoid
StatVoidVoid

CcoSubcultureRecord

Wrapper for a subculture record

Functions

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

CcoTechnologyRecord

Record wrapper for a technology record

Functions

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

CcoTechnologyUiGroupRecord

Record wrapper for technology ui group record

Functions

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

CcoTechnologyUiTabRecord

Wrapper for a TECHNOLOGY_UI_TAB_RECORD

Functions

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

CcoTeleportationNetworkNodeRecord

Wrapper for a TELEPORTATION_NETWORK_NODE_RECORD

Functions

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

CcoTeleportationNodeTemplateRecord

Wrapper for a TELEPORTATION_NODE_TEMPLATE_RECORD

Functions

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

CcoTimeOfLegendsCampaignRecord

Wrapper for a TIME_OF_LEGENDS_CAMPAIGN_RECORD

Functions

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

CcoTreasureHuntExtraInformationRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
Option1ImageVoidVoid
OverlayImageVoidVoid
Option4ImageVoidVoid
ColourBlindModeOverlayVoidVoid
Option2ImageVoidVoid
Option3ImageVoidVoid
KeyVoidVoid

CcoUiColourRecord

Functions

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

CcoUiMainThemeOptionRecord

Wrapper for a UI_MAIN_THEME_OPTION_RECORD

Functions

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

CcoUiPurchasableEffectsToHexIdRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TierVoidVoid
RecordListVoidVoid
HexIdVoidVoid
CategoryVoidVoid
UnitPurchasableEffectContextVoidVoid

CcoUiUnitGroupParentRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GroupListVoidVoid
RecordListVoidVoid
MpCapVoidVoid
UnitListVoidVoid
IconVoidVoid
KeyVoidVoid
OrderVoidVoid
OnscreenNameVoidVoid

CcoUiUnitGroupingRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconVoidVoid
KeyVoidVoid
TooltipVoidVoid
ParentGroupVoidVoid
RecordListVoidVoid
OnscreenVoidVoid

CcoUiUnitStatRecord

Wrapper for a UI_UNIT_STAT_RECORD

Functions

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

CcoUiUnitStatusRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
PriorityVoidVoid
RecordListVoidVoid
TooltipVoidVoid
IconPathVoidVoid

CcoUnitAbilitiesAdditionalUiEffectRecord

Wrapper for a UNIT_ABILITIES_ADDITIONAL_UI_EFFECT_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyStringVoid
SortOrderIntVoid
EffectStateStringVoid
RecordListCcoUnitAbilitiesAdditionalUiEffectRecord (list)Void
LocalisedTextUniStringVoid

CcoUnitAbilityRecord

Functions

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

CcoUnitAbilityTypeRecord

Wrapper for a UNIT_ABILITY_TYPE_RECORD

Functions

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

CcoUnitAttributeRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconPathVoidVoid
ImuedEffectTextVoidVoid
RemovesEffectTextVoidVoid
KeyVoidVoid
RecordListVoidVoid
BulletTextVoidVoid

CcoUnitLandRecord

Wrapper for a UNIT_LAND_RECORD

Functions

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

CcoUnitListRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
KeyVoidVoid
UnitsListVoidVoid

CcoUnitPortholeCameraSettingRecord

Wrapper for a UNIT_PORTHOLE_CAMERA_SETTING_RECORD

Functions

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

CcoUnitPurchasableEffectRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
RecordListVoidVoid
ResourceIconVoidVoid
EffectBundleContextVoidVoid
CategoryContextVoidVoid
ResourceCostVoidVoid
ResourceNameVoidVoid
KeyVoidVoid
CostContextVoidVoid

CcoUnitPurchasableEffectsCategoryRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IconPathVoidVoid
KeyVoidVoid
OnscreenNameVoidVoid
OnscreenDescriptionVoidVoid
RecordListVoidVoid

CcoUnitSetRecord

Wrapper for a UNIT_SET_RECORD

Functions

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

CcoUnitSetToMpUnitCapRecord

Wrapper for a UNIT_SET_TO_MP_UNIT_CAP_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CapIntVoid
RecordListCcoUnitSetToMpUnitCapRecord (list)Void
LocalisedNameUniStringVoid

CcoUnitSpecialAbilityRecord

Functions

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

CcoUnitsCustomBattleMountRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CostVoidVoid
RecordListVoidVoid
MountNameVoidVoid
IconNameVoidVoid
LocalisedDescriptionVoidVoid
BaseUnitContextVoidVoid
MountedUnitContextVoidVoid

CcoUnitsCustomBattlePermissionRecord

Functions

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

CcoUnitsCustomBattleTypeCategoryRecord

Wrapper for a UNITS_CUSTOM_BATTLE_TYPE_CATEGORY_RECORD

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsHorizontalGroupBoolVoid
RecordListCcoUnitsCustomBattleTypeCategoryRecord (list)Void
CategoryNameUniStringVoid
CategoryKeyStringVoid
CategoryDescriptionUniStringVoid

CcoUnitsCustomBattleTypeRecord

Wrapper for a UNITS_CUSTOM_BATTLE_TYPE_RECORD

Functions

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

CcoVictoryConditionRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
KeyVoidVoid
RecordListVoidVoid

CcoVideoRecord

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PlayVideoVoidVoid
RecordListVoidVoid
KeyVoidVoid

Common

CcoAdvisor

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AdviceHistoryListVoidVoid
ClearHistoryVoidVoid

CcoAgentSubtypeAgentPair

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
AgentContextCcoAgentRecordVoid
UnitDetailsContextCcoUnitDetailsVoid
AgentSubtypeContextCcoAgentSubtypeRecordVoid

CcoBattleResult

Wrapper for a battle result

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsDrawBoolVoid
ResultTypeRecordContextCcoBattleResultTypeRecordVoid
OtherResultAllianceContextCcoBattleResultAllianceVoid
IsLocalPlayerWinnerBoolVoid
LocalResultPlayerAllianceContextCcoBattleResultAllianceVoid
DurationUniStringVoid

CcoBattleResultAlliance

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ResultNameVoidVoid
ResultTypeVoidVoid
ArmyContextVoidVoid
ArmyListVoidVoid

CcoBattleResultArmy

Functions

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

CcoBattleResultUnit

Wrapper for a battle result unit

Functions

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

CcoCallbackExpressionStore

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

Functions

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

CcoCampaignEffectGroup

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EffectListVoidVoid
LocalisedTitleVoidVoid

CcoCampaignFactionMercenaryPool

Component context wrapper for a faction mercenary pool

Functions

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

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
CurrentMaxUnitCountIntVoidReturns the max mercenary pool unit count
MainUnitRecordContextCcoMainUnitRecordVoidReturns the main unit record of this mercenary pool unit

CcoCampaignModelBuilding

Model safe context wrapper for a campaign building

Functions

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

CcoCampaignModelFaction

Model safe context wrapper for a campaign faction

Functions

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

CcoCampaignModelInitiative

Initiative wrapper safe to use in campaign model contexts

Functions

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

CcoCampaignModelInitiativeManager

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

Functions

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

CcoCampaignModelMilitaryForce

Model safe context wrapper for a campaign military force

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CanMoveInCurrentStanceBoolVoidReturns whether the military force can move in the current stance

CcoCampaignModelPooledResource

Campaign model wrapper for a pooled resource

Functions

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

CcoCampaignModelProvince

Model safe context wrapper for a campaign province

Functions

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

CcoCampaignModelRegion

Model safe context wrapper for a campaign region

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OwnerCcoCampaignModelFactionVoidReturns the faction that owns this region. May be rebel if abandoned or following a successful rebellion
BelongsToRegionGroupBoolStringReturns true if the region belongs to the region group with the passed in key
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
ClimateKeyStringVoidReturns the key of the climate of the settlement attached to this region
IsHomeRegionBoolVoidIs this the factions home region?
IsEffectBundleActiveBoolStringTest if specific effect bundle is active in the region
PublicOrderIntVoidPublic order balance for this turn. This value will be the same for every region owned by the faction in this province
RecordKeyStringVoidReturns the record key 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
ProvinceCcoCampaignModelProvinceVoidProvince that contains this region
IsAbandonedBoolVoidReturns true if the region is abandoned
IsAnyOwnAgentPresentBoolCcoCampaignModelFaction (optional)Test if any agent owned by the local faction is present in the region
IsFactionAgentPresentBoolString, CcoCampaignModelFactionTest if the specified agent type is present in the region and owned by the specified faction
IsOwnMilitaryForcePresentBoolCcoCampaignModelFaction (optional)Test if any military force owned by the local faction is present in the region
IsFactionAgentSubtypePresentBoolString, CcoCampaignModelFactionTest if the specified agent subtype is present in the region and owned by the specified faction
IsOwnAgentPresentBoolString, CcoCampaignModelFaction (optional)Test if the specified agent type is present in the region and owned by the local faction
IsAnyEnemyAgentPresentBoolCcoCampaignModelFaction (optional)Test if any enemy agent is present in the region
IsAnyEnemyMilitaryForcePresentBoolCcoCampaignModelFaction (optional)Test if any enemy military force is present in the region
IsOwnAgentSubtypePresentBoolString, CcoCampaignModelFaction (optional)Test if the specified agent subtype is present in the region and owned by the local faction
IsAnyAgentPresentBoolVoidTest if any agent is present in the region
IsEnemyAgentSubtypePresentBoolString, CcoCampaignModelFaction (optional)Test if the specified agent subtype is present in the region and owned by an enemy faction
IsAnyMilitaryForcePresentBoolVoidTest if any force is present in the region
WindsOfMagicStrengthLevelIntVoidCurrently active winds of magic strength level for the region
IsAgentSubtypePresentBoolStringTest if the specified agent subtype is present in the region
WindsOfMagicStrengthKeyStringVoidRecord key of the currently active winds of magic strength level for the region
IsEnemyAgentPresentBoolString, CcoCampaignModelFaction (optional)Test if the specified agent type is present in the region and owned by an enemy faction
GDPIntVoidGDP (income) that this Region generates. Cannot be negative
RecordKeyIsOneOfBoolArgumentPackTest if the region key is one of the specified list. Can accept any number of region keys
FactionProvinceGDPIntVoidGDP (income) that the owning faction generates from all of its regions in the province
IsAgentPresentBoolStringTest if the specified agent type is present in the region
GrowthPerTurnIntVoidAmount of growth accumulated 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
DevelopmentPointsIntVoidAmount of development points accumulated and unspent. This value will be the same for every region owned by the faction in this province
IsOriginatingSubcultureOneOfBoolArgumentPackTest if the originating subculture key is one of the specified list. Can accept any number of subculture keys
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

CcoCampaignModelRoot

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

Functions

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

CcoCampaignModelUnit

Model safe context wrapper for a campaign unit

Functions

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

CcoCampaignProvinceMercenaryPool

Component context wrapper for a province mercenary pool

Functions

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

CcoCampaignStartInfo

Wrapper for frontend campaign start info

Functions

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

CcoCharacterSpecialUnitAvailability

Component context wrapper for a character special units availability

Functions

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

CcoClickHoldContext

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HoldPercentFloatVoidReturns the percentage hold value

CcoComponent

Functions

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

CcoContextHistoryObject

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ContextObjectIdStringVoid
ReasonStringVoid
TimeIntVoid
OriginComponentContextContextVoid
CcoContextContextVoid
CallbackIdStringVoid
ContextIdStringVoid

CcoContextSelection

Functions

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

CcoCustomBattleArmyPreset

Wrapper for an army preset that can be saved / loaded

Functions

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

CcoCustomBattleArmyPresetFileHandler

Singleton wrapper for army preset file handler

Functions

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

CcoCustomBattleLobby

Wrapper for the custom battle lobby

Functions

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

CcoCustomBattleMap

Wrapper for a custom map

Functions

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

CcoCustomBattlePlayerSlot

Functions

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

CcoCustomBattleSettings

Wrapper for the settings of custom battles

Functions

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

CcoCustomBattleTeam

Wrapper for the custom battle team

Functions

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

CcoCustomBattleUnit

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TransformationUnitOverrideContextCcoMainUnitRecordVoidReturns the unit's transformation unit override.
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
IsValidBoolVoidReturns whether the unit associated with the unit index stored on this context is valid
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
RemoveMountVoidVoidRemoves the mount of the unit associated with the unit index stored on this context
ExperienceLevelIntVoidReturns the level of the unit associated with the unit index stored on this context
CurrentMountRecordContextCcoUnitsCustomBattleMountRecordVoidReturns the CcoUnitsCustomBattleMountRecord associated with the unit index stored on this context
NameUniStringVoidReturns the name of the unit with the unit index stored on this context
DecreaseExperienceVoidVoidDecreases the level of the unit associated with the unit index stored on this context
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
CustomBattleUnitRecordContextCcoUnitsCustomBattlePermissionRecordVoidReturns the CcoUnitsCustomBattlePermissionRecord record associated with the unit index stored on this context
RemoveUnitVoidVoidRemoves this unit from the player slot
UnitDetailsContextCcoUnitDetailsVoidReturns the CcoUnitDetails associated with this unit index stored on this context
IncreaseExperienceVoidVoidIncreases the level of the unit associated with the unit index stored on this context
UnitRecordContextCcoMainUnitRecordVoidReturns the CcoMainUnitRecord associated with the unit index stored on this context
CanChangeMountBoolCcoUnitsCustomBattleMountRecordReturns 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
CanAffordMountBoolCcoUnitsCustomBattleMountRecordReturns whether the unit index stored on this context can change mount
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
HasArmoryBoolVoidReturns whether the unit associated with the unit index stored on this context has an armory
PlayerSlotContextCcoCustomBattlePlayerSlotVoidReturns the CcoCustomBattlePlayerSlot associated with the slot index stored on this context
CanEverIncreaseExperienceBoolVoidReturns whether the unit associated with the unit index stored on this context can ever increase its level
AvailableUpgradeListCcoCustomBattleUnitUpgrade (list)VoidReturns the CcoCustomBattleUnitUpgrades available to the unit associated with the unit index stored on this context
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
IsReinforcementBoolVoidReturns whether the unit associated with the unit index stored on this context is a reinforcement
SetTransformationUnitOverrideVoidCcoMainUnitRecordSets 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

CcoCustomBattleUnitUpgrade

Functions

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

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

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

CcoFactionSavedCharacters

Wrapper for a SAVED_CHARACTER_INFO struct

Functions

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

CcoFactorBreakdown

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
HeaderVoidVoid
DescriptionVoidVoid
ListVoidVoid

CcoFrontendFactionLeader

Wrapper for a frontend faction leader

Functions

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

CcoFrontendRoot

Functions

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

CcoGameCore

Wrapper for the game core

Functions

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

CcoIngameMessaging

Ingame messaging singleton, used to get ingame news items

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
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
CurrentPageIntVoidReturns the current page of news being viewed on frontend
NextPageVoidVoidAdvances news page by 1 to view next set of news
IsReadyBoolVoidReturns true if ingame messaging is loaded and ready
CanGetAnyNewsBoolVoidReturns true if we are able to get any news at all
HasMoreNewsBoolVoidReturns true if there is more news to be shown

CcoIngameMessagingItem

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

Functions

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

CcoJadeDatabase

Wrapper for the Jade database

Functions

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

CcoListLayout

Wrapper for a component list engine

Functions

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

CcoLobbyBase

Functions

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

CcoLobbyPlayer

Wrapper for a lobby player slot

Functions

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

CcoLobbyTeam

Component context wrapper for a MPC lobby team

Functions

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

CcoMPCampaignLobby

Functions

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

CcoMPCampaignMap

Wrapper for a playable map in multiplayer campaigns

Functions

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

CcoMPCampaignSettings

Functions

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

CcoMoMTrialManager

Wrapper for Mirrors of Madness Trials

Functions

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

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

CcoNarrativeManager

Functions

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

CcoNetworkPlayer

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

Functions

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

CcoOwnershipProductRequirement

Wrapper for an ownership product mask

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
OwnershipProductRecordListCcoOwnershipProductRecord (list)VoidReturns a list of CcoOwnershipProductRecord

CcoPieData

Functions

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

CcoPieSlice

Functions

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

CcoRangeWithContext

Functions

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

CcoSavedCharacterInfo

Wrapper for a SAVED_CHARACTER_INFO struct

Functions

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

CcoScriptObject

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

Functions

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

CcoScriptObjectList

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

Functions

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

CcoScriptTableNode

A wrapper for of a Lua Table, recursive type

Functions

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

CcoShapeshiftForm

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
EquipVoidVoidEquips this form for the players faction
DevUnlockVoidVoidUnlocks this form for the current factiondebug, hide_in_ui
IsLockedBoolVoidReturns whether the form is locked for the current player
IsEquippedBoolVoidReturns whether the form is equipped for the current player
IsPartOfCultureBoolCcoCultureRecordReturns whether this form is part of the given CcoCultureRecord
HasCharacterBoolVoidReturns whether there is a character on the map for this form
CharacterContextCcoCampaignCharacterVoidReturns the nearest CcoCampaignCharacter to the selected player for this form (or null)
CulturesPartOfListCcoCultureRecord (list)VoidReturns a list of CcoCultureRecords this form is part of
MatchesQueryBoolUniStringReturns whether this form should be in the list given a search string
AgentSubtypeRecordContextCcoAgentSubtypeRecordVoidReturns the associated CcoAgentSubtypeRecord
MainUnitRecordContextCcoMainUnitRecordVoidReturns the associated CcoMainUnitRecord
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

CcoSpineAnimationState

Wraps a spine animation state from a spine renderer

Functions

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

CcoSpineBone

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SetRotationVoidFloat
WorldPositionVector4Void
SetPositionVoidInt, Int
RotationFloatVoid

CcoSpineController

Wrapper for a spine rendering controller on a component

Functions

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

CcoSpineSkeleton

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SetScaleVoidVector2
SetToSetupPoseVoidVoid
SetSkinVoidString
BoneCcoSpineBoneString
ScaleVector2Void
RootBoneCcoSpineBoneVoid

CcoSpineTrackEntry

Wraps an animation track entry in spine

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
CurrentAnimationNameStringVoid
SetAnimationTimeScaleVoidFloat
SetMixDurationVoidFloat
SetAnimationTimeVoidFloat

CcoStringValue

Functions

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

CcoSymbolTest

This is an example

Functions

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

CcoSymbolTestSecond

This is a second example

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
id2StringCcoSymbolTest
SameNameStringVoid
idStringCcoSymbolTest
ContextContextVoid

CcoTreeLink

Functions

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

CcoTreeLinkWithContexts

Functions

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

CcoURI

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

Functions

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

CcoUiWarning

Functions

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

CcoUnitAbility

Wrapper for a BATTLE_SETUP_SPECIAL_ABILITY

Functions

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

CcoUnitAbilityDetails

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

Functions

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

CcoUnitBulletPoint

Wrapper for a UI_UNIT_BULLET_POINT object

Functions

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

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

CcoUnitStat

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

Functions

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

CcoUnitStatModIcon

Component context wrapper for a unit stat modifier icon

Functions

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

Global Functions

flow

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

file

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

random

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

chain_global

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

string

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

debug

NameReturn TypeArgumentsDescriptionTagsEvents
RunCLIMultiplayerVoidStringSsame as RunCLI but if mp campaign runs the command on all players games at the same timedebug
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
RunCLIVoidStringRuns console command supplied, but not in final release to avoid calling commands not meant todebug
FindContextContextExpressionState, String, String, Bool (optional)Returns context given the type and object ids. Can also specify false as 3rd parameter to suppress errors if fail to find (otherwise defaults to error). Handy for debugging in context expression tester and creating own debug layouts, but NOT ADVISED use in layouts as ids can change and break layouts!debug
MeasureStringExpressionState, ExpressionUsed to wrap an expression and will return a string containing the number of milliseconds that execution took (the real return value is lost)debug
BreakpointArgumentPackExpressionState, Expression, Expression (optional)Used to wrap an expression and will break in debugger before evaluationdebug

prefs

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

deprecated

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

database

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

context

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

Misc

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

sound

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

math

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

registry

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

flow

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

convert

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

component

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

tweakers

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

Battle

CcoBattleAbility

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ActivePhaseListCcoPair (list)VoidReturns list of CcoPair; the active phases for each target essentially
IsRechargeEnabledBoolVoidReturns true if all recharge contexts for this ability are true (eg engaged in melee)
IsPhaseActiveBoolCcoSpecialAbilityPhaseRecordReturns true if supplied CcoSpecialAbilityPhaseRecord is active in any of abilities phase trees
IntensityCanDecayBoolVoidReturns true if ability's intensity can decay
IsActiveBoolVoidReturns true if this abiltiy is currently active and applying its effects
TimeUntilIntensityDecayIntVoidReturns amount of time (in seconds) until intensity decay starts
IsTargettedAbilityBoolVoidReturns true if this is an ability that you have to select a target for
IsReignOfChaosRewardBoolVoidReturns true if this is an amry ability that can be rewarded as a reign of chaos outcome
EffectRangeFloatVoidReturns the range in metres that this ability will affect from the cast point
DefaultIntensityFloatVoidReturns the starting/default intensity that modifiable stats of this ability will be multiplied by
HasLimitedUsesBoolVoidReturns true if the ability has a limited number of uses (queried by RemainingUses)
MaxIntensityFloatVoidReturns the maximum intensity that modifiable stats of this ability will be multiplied by
RemainingUsesIntVoidReturns the number of remaining uses, -1 if unlimited
CanBePurchasedBoolVoidReturns true if this ability can currently be afforded based on any required currencies (see CurrencyCosts)
CurrentStateStringVoidReturns a String representing the current state (active/passive/selected/inactive
IsCurrentlyTargettingBoolVoidReturns true if this ability is currently being targetted by the player
IntensityFloatVoidReturns the intensity that modifiable stats of this ability will be multiplied by
WindUpTimeRemainingSecsFloatVoidReturns the wind up time remaining in seconds. Wind up is the casting time essentially.
WindUpPercentFloatVoidReturns the wind up percentage (0-1), 0 being not in windup and 1 being at the point where casts the spell. Wind up is the casting time essentially.
RechargeDisabledReasonsTextUniStringVoidReturns joined localised string of disabled reasons for this ability, if any (in melee, etc)
CurrencyCostsCcoPair (list)VoidReturns a list of CcoPair representing the costs required to activate 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.
RechargePercentFloatVoidReturns the cooldown percentage if in cooldown (0-1), 0 if not in cooldown
ManaUsedIntVoidReturns how much mana is used when activating this ability
LeftClickTextUniStringVoidReturns some localised text that explains what left clicking on a button for this ability would currently do (activate, toggle targetting, toggle overcharge, etc)
IntensityDecayTimerStartedBoolVoidReturns true if the timer for the intensity decay has started
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)
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
PerformAbilityForOwnerVoidVoidActivates the ability for the owner (unit/army)
IntensityDecayIsActiveBoolVoidReturns true if intensity decay is active for the ability
SetupAbilityContextCcoUnitAbilityVoidReturns the CcoUnitAbility setup for this ability (fixed information that doesnt change during the battle)

CcoBattleAlliance

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsDefenderBoolVoidReturns true if this faction is the defender in the battle
NumEntitiesInitialIntVoidReturns the number of entitie this alliance started the battle with
NumUnitsIntVoidReturns the number of units in this alliance
NumEntitiesIntVoidReturns the number of entities in this alliance
CpKillScoreIntVoidReturns the score for this alliance, the higher the better the alliance performed (earned by unit experience and capturing capture points)
NumArmiesIntVoidReturns the number of armies in this alliance
TicketsIncomePerSecondIntVoidReturns the total capture point tickets income rate, per second.
StartingTicketsIntVoidReturns the capture point tickets started the battle with
IdIntVoidReturns the index of this alliance
TicketsRemainingIntVoidReturns the capture point tickets remaining (when 0 lose if defending)
DevWinBattleVoidVoidFor dev purposes, forces win for this alliance by killing all units on other alliances in battlehide_in_uied, debug
ArmyListCcoBattleArmy (list)VoidReturns the list of armies in this alliance
IsPlayersAllianceBoolVoidReturns true if this is the player controlled alliance
DoesKeepScoreBoolVoidReturns true if we are keeping scores (CpKillScore)
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
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
ScoreIntVoidReturns the cp score for this army
FactionFlagDirStringVoidReturns directory for faction flag icons - append image name including extension for use in setting images
ArmyAbilityIndexIntStringReturns the index (ordered by cost) of the army ability specified by given key
ArmyIndexIntVoidReturns the index of this army in this alliance
GodWeightingFloatStringReturns the Reign of Chaos weighting towards a particular god when rolling for abilities
FactionFlagMediumStringVoidReturns the faction flag medium image filepath - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied
IsHumanBoolVoidReturns true if controlled by a human
NumMenDiedIntVoidReturns the number of men who have died
IsLocalPlayerBoolVoidReturns true if controlled by local player
IsAbilityWithCostBoolStringReturns if the specified ability key requires currency to activate
MaxUnitsCanControlIntVoidReturns the maximum number of units allowed at once on the battlefield at any one time
ArmyAbilityIndexCostFloatIntReturns the cost of the ability at the given by index
FactionContextCcoFactionRecordVoidReturns the faction context for this army
CurrentWaaaghThresholdIntVoidReturns the current Waaagh threshold. Need to hit this to trigger a Waaagh
AllianceIndexIntVoidReturns the index of the alliance
FactionFlagSmallStringVoidReturns the faction flag small image filepath - prefer to use FactionFlagDir insteaddeprecated, hide_in_uied
HasReignOfChaosBoolVoidReturns true if the faction has the reign of chaos feature (Daemon prince only)
CurrentWaaaghPercentFloatVoidReturns the current Waaagh percent
NumUnitsIntVoidReturns the number of units currently alive
NumEntitiesIntVoidReturns the number of entities currently alive
AllianceContextCcoBattleAllianceVoidReturns the CcoBattleAlliance for this army
CanPerformCataclysmAbilityBoolVoidReturns whether the current cataclysm ability (if it exists) can be used or performed
RealmOfSoulsThresholdIntIntReturns the value require to achieve realms of souls effect
NumEntitiesInitialIntVoidReturns the number of entities started the battle with
WindsOfMagicPoolContextCcoBattleWindsOfMagicPoolVoidReturns the CcoBattleWindsOfMagicPool for this army, controls how much magic has for spell casting
CurrentPercentToArmyAbilityFloatIntReturns the percentage of points you currently have towards ability given by index
CurrentWaaaghPointsIntVoidReturns the current Waaagh points
NumReinforcementsIntVoidReturns the number of units in the reinforcements pool
ArmyAbilitiesListCcoUnitAbility (list)VoidReturns the list of abilities available to this army
IsArmyAbilityUnlockedBoolIntReturns true of the ability specified by given index is unlocked
AiStatsModifierFloatVoidReturns a float with the ai stats modifier
NumTotalUnitsIntVoidReturns the total units alive and reinforcements available
CommandingUnitContextCcoBattleUnitVoidReturns the CcoBattleUnit of the commanding/general unit
RealmOfSoulsPercentFloatVoidReturns the percent complete to activate realm of souls effect
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
FormationListCcoFormationRecord (list)VoidReturns the list of formation records available to this army
MurderousProwessPercentFloatVoidReturns the percent of score vs thresh for murderous prowess
HasDaemonFeatureBoolVoidReturns true if the daemon feature is available
MurderousProwessShouldDeactivateBoolExpressionStateReturns true when murderous prowess ability should deactivate
ArmyAbilityCurrencyIntVoidReturns the army ability currency for this army
AllianceColourColourVoidReturns the alliance colour for this army (as in colour based on player/ally/enemy/neutral)
MurderousProwessScoreIntVoidReturns the murderous prowess score
PrimaryColourColourVoidReturns the primary faction colour of this army
UnitListCcoBattleUnit (list)VoidReturns the list of units in this army
HasWaaaghBoolVoidReturns true if Waaagh feature is available
HasRealmOfSoulsBoolVoidReturns true if Realm of Souls feature available
GlobalScoreIntVoidReturns the tickets remaining for this armies alliance
ArmyNameUniStringVoidReturns the localised name of this army
HasMurderousProwessBoolVoidReturns true if Murderous Prowess feature available
GlobalCurrencyIntVoidReturns the supplies currency for this army
FactionNameUniStringVoidReturns the localised name of this army's faction
CurrentArmyAbilityThresholdIntVoidReturns the threshold to the next unlockable ability (or the maximum if all are unlocked)
PlayerNameUniStringVoidReturns the name of the player controlling tis army
UniqueIDIntVoidReturns the unique id for this army (unique across all armies)

CcoBattleBuilding

Functions

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

CcoBattleCaptureLocationsManager

Functions

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

CcoBattleCapturePoint

Functions

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

CcoBattleCurrencyManager

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
PurchaseArmyAbilityVoidString, Int, ContextTakes db key of ability, int32 for the currency item type enum and CcoBattleArmy and purchases the ability
SummaryListForCurrencySourcesCcoSummedValueContextString, IntTakes db key and army unique id and returns CcoSummedValueContext populated with CcoPair compposed of curency source record cco and amount value
CurrencyTypeStringToEnumIntStringTakes db key of the currency type and returns int32 of the currency type enum
CurrencyItemTypeStringToEnumIntStringTakes db key of the currency item type and returns int32 of the currency type enum
CanAffordItemBoolString, Int, ContextTakes db key of the item, int32 for the currency item type enum and CcoBattleArmy and returns boolean indicating whther the item can be afforded
PurchaseItemVoidString, Int, ContextTakes db key of the item, int32 for the currency item type enum and CcoBattleArmy and purchases the item
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

CcoBattleCursorContext

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

Functions

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

CcoBattleEntity

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

Functions

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

CcoBattleGroup

Functions

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

CcoBattleLaboratoryInfo

Wrapper for the lab settings of a battle.

Functions

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

CcoBattlePurchasableArmyAbility

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

Functions

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

CcoBattlePurchasableUnit

Functions

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

CcoBattlePurchasableUnitAbility

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
UnitSpecialAbilityRecordContextCcoUnitSpecialAbilityRecordVoid
GetCostForThisActionFloatInt
UnitAbilityContextCcoUnitAbilityVoid
SoundTypeStringVoid
CanAffordBoolContextList, Int(UnitList, ArmyID) Can the army afford to purchase the ability for all of the units (who can get the ability) in the UnitList
PurchaseForCurrentSelectionVoidContextList, CcoBattleArmy, Bool(UnitList, CcoBattleArmy) Purchase the ability for the units in the list for the specific army
GetCostForSelectionFloatContextList, Int(UnitList, ArmyID) Get the cost to apply this upgrade to all of the listed units for the specific army id
IsAvailableInGroupBoolContextList(UnitList) Is the ability available to any of the units in the list
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

CcoBattleReinforcementArmy

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

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsDeployedUsingTimerBoolVoidIs this reinforcement army's spawn based on a timer/countdown?
TimeUntilDeploySecsFloatVoidHow long (in seconds) until the reinforcement army is deployed
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.
NumUnitsRemainingIntVoidHow many more units are left to be deployed, as not all units are deployed at the same time
TargetArmyContextCcoBattleArmyVoidReturns the CcoBattleArmy that this army's units will join after entering the field.

CcoBattleReinforcementDebugUnits

Functions

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

CcoBattleReinforcementPool

Functions

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

CcoBattleRoot

The root for battle that gives access to anything battle related

Functions

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

CcoBattleSelection

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

Functions

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

CcoBattleSettlement

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DestructionEffectsListVoidVoid
MountedArtilleryLocationListVoidVoid
DestroyedPercentVoidVoid

CcoBattleSetup

Wrapper for a battle setup

Functions

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

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
UnitListCcoBattleSetupUnit (list)Bool (optional)Returns the list of units in this setup army, optional bool argument for whether hidden armies should be excluded
FlagDirStringVoidReturns path to flags for the faction
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
FlagDirVoidVoid
FactionRecordContextVoidVoid
NameVoidVoid

CcoBattleSetupInfo

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

Functions

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

CcoBattleSetupUnit

Wrapper for a BATTLE_SETUP_UNIT

Functions

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

CcoBattleSpawnZone

Functions

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

CcoBattleStormOfMagic

Cco wrapper for querying and controlling the Storm Of Magic manager

Functions

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

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

CcoBattleToggleableSlot

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

Functions

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

CcoBattleToggleableSlotBuildable

Functions

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

CcoBattleUnit

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

Functions

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

CcoBattleUnitEffect

Wrapper for a battle unit effect

Functions

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

CcoBattleVehicle

Functions

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

CcoBattleWindsOfMagicPool

Functions

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

CcoReinforcementArmy

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DelayVoidVoid
EntryPositionVoidVoid

Misc

CcoContextExpression

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TextRepresentationStringVoid
EvaluateExpressionArgumentPackContext, ArgumentPack

CcoContextExpressionCompilationError

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionStringVoid

CcoContextExpressionResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ResultTypeCcoContextObjectTypeVoid
HasStringRepresentationBoolVoid
ValueArgumentPackVoid

CcoContextExpressionRuntimeError

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DescriptionStringVoid

CcoContextList

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
TakeContextListIntReturns the first N elements of the list
SizeIntVoidReturns the number of elements in the list
ReverseContextListVoidReturns the list in the opposite order
SkipContextListIntSkip the first x elements of the list
IsEmptyBoolVoidReturns true if the list is empty
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)
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
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
ContainsBoolContextReturns true if supplied context exists in the list
FilterContextListExpressionState, ExpressionReturns a list with all the elements of the given list that satisfy the condition.
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.
DistinctContextListExpressionState, Expression (optional)Returns the distinct elements of the list
AllBoolExpressionState, ExpressionReturns true if all the contexts return true for the given expression
CountIntExpressionState, ExpressionReturns the number of elements that satisfy the given expression
AnyBoolExpressionState, ExpressionReturns true if any of the contexts return true for the given expression
AppendContextListExpressionState, ArgumentPackReturns a list new list, containing the current list's elements + any elements passed in as an argument (the argument must be a context expression, and must return either a single context object or another context object list).
MinValueFloatExpressionState, ExpressionReturns the smallest value evaluated for each context in the list using expression
CompareSortContextListCcoContextList, ExpressionState, Expression
ForEachVoidExpressionState, ExpressionPerforms the supplied expression on each context
MaxValueFloatExpressionState, ExpressionReturns the largest value evaluated for each context in the list using expression
AtContextIntReturns the context at the specified index
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
MinContextContextExpressionState, ExpressionReturns the context with the smallest value evaluated for each context in the list using expression
TransformContextListExpressionState, ExpressionTransforms the list into a new one where each element is produced by the given expression
MaxContextContextExpressionState, ExpressionReturns the context with the largest value evaluated for each context in the list using expression
IndexForFirstContextIntExpressionState, ExpressionReturns the index of the first context that returns true for the supplied expression
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
FindIfContextExpressionState, Expression
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
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
PartitionContextListExpressionState, ExpressionReturns the subset of the list at the point where the first context matches the given expression
SumArgumentPackExpressionState, ExpressionAccumulates the values returns by each contexts expression (for adding up totals)
ListContextListVoidReturns internal list of contexts
FirstContextContextExpressionState, Expression (optional)Returns the first context by default, if supply an expression as a parameter it will return the first context that returns true for the condition and otherwise return null
ReduceArgumentPackExpressionState, Expression, Expression (optional)Reduces the list based on given predicate starting at optional initialiser value
FindContextContext

CcoContextObjectType

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsArithmeticBoolVoid
IsListBoolVoid
NameStringVoid
HasStringRepresentationBoolVoid
SymbolsListContextListVoid

CcoContextSymbol

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IsCommandBoolVoid
EvaluateSymbolArgumentPackContext, ArgumentPack
TypeContextCcoContextObjectTypeVoid
DocumentationStringVoid
NameStringVoid
TagsStringVoid

CcoFindResult

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
IndexIntVoid
ContextContextVoid

CcoGroupList

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
GroupedListContextListVoid
CategoryObjectContextVoid

CcoPair

Functions

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

CcoRuntimeObject

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
InternalContextVoid

CcoString

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

Functions

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

CcoSummedValueContext

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
SummedListContextListVoid
OriginalContextContextVoid
SummedValueFloatVoid

CcoVector2

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ModulusFloatVoid
DistanceFloatVector2
xFloatVoid
yFloatVoid
ValueVector2Void

CcoVector3

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
DistanceFloatVector3
yFloatVoid
zFloatVoid
ModulusFloatVoid
ValueVector3Void
xFloatVoid

CcoVector4

Functions

NameReturn TypeArgumentsDescriptionTagsEvents
ModulusFloatVoid
DistanceFloatVector4
zFloatVoid
wFloatVoid
xFloatVoid
yFloatVoid
ValueVector4Void

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
CapturePointStickyTooltipChanged
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
CustomBattleOnSettingChangedMultipleLordsEnabled
CustomBattleOnSettingChangedRealismMode
CustomBattleOnSettingChangedSeason
CustomBattleOnSettingChangedSplitFunds
CustomBattleOnSettingChangedTicketLimit
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::InstantOpenFilterChanged
EventFeed::TryOpenNext
EventFeedAutoOpen
EventFeedFilterChanged
EventFeedRepopulate
FactionCapitalChangedtrue
FactionContentSeen
FactionCookedDish
FactionCookedDishSpecific
FactionDeathtrue
FactionDiplomacyChangetrue
FactionDiplomacyChangeAny
FactionDiscoveredAny
FactionFeaturesChanged
FactionInitiativeActivationChanged
FactionMercenaryPoolUpdated
FavourPointsChanged
ForeignManagerCreated
ForeignSlotAdded
ForeignSlotRemoved
ForeignSlotRemovedUniquetrue
FrontEndNameRandomised
FrontendGeneralNameChanged
InfoPanelClosed
InfoPanelOpened
IngameMessagingNextPage
IngameMessagingPreviousPage
IngredientUnlocked
InitiativeActivationChanged
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
MissionMarkedAsSeenUpdated
MissionPinned
MissionTextChanged
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_
ResourceOverrideChanged
RitualComplete
RitualStarted
ScriptObjectValueUpdated
SelectionParentSelectionChanged
SelectionPropagatorMouseoverSelectionChanged
SettingsApplied
SettlementExposedAny
SettlementFactionChangetrue
SettlementFactionChangeAny
SettlementNameChangedtrue
SharedStateChanged
ShowCampaignBattleResults
SlavesTransferred
SliderValueChanged_
SlotItemDragEnd
SlotItemDragStart
StagedList::ListUpdated
StormOfMagicAscendancyChange
StormOfMagicAscendancyTransitionStart
StormOfMagicSelectLore
StormOfMagicSelectLoreCompleted
SurvivalWaveUnitsUpdated
TargettingInterfaceChanged
TargettingInterfaceTargetSet
TaxLevelChanged
TeleportNetworkPanelOpened
TextInputChanged
TextInputFocusLost_
ToggleNotifications
ToggleableBuildingDestroyed
ToggleableSlotActiveChangedtrue
ToggleableSlotUpdatetrue
TransformableAgentEquipped
TransformableAgentUnlocked
TreeCreated
TrespassWarningIssued
TriggerSelectNextSpawnZone
TriggerSelectPreviousSpawnZone
UIColourChanged
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
WarContractAccepted
WarContractCancelled
WarContractFailed
WarContractSuccess
WarCoordinationStateChanged
WarCoordinationTargetSet
WindsOfMagicGamblerVisibilityChanged
WindsOfMagicStrengthChanged
battle_purchasable
building_available_event
commandment_available
horde_upgrade_available
hostile_slot_available_event
negative_pooled_resource_event
negative_pooled_resource_event_
selection_changed_
siege_construction_available_event