Wiki

trigger · faction_upgrade_level

Definition

  • Supported scope:COUNTRY
  • Supported target:THIS, ROOT, PREV, FROM, OWNER, CONTROLLER, OCCUPIED, CAPITAL

Description

Checks the active faction member upgrade against the specified upgrade. works with >, <, = 
### Examples

TAG = { faction_upgrade_level > upgrade_token }

Hands-On Notes

Hands-on notes are AI-generated and checked against the vanilla command vocabulary — treat them as a starting point, not authoritative reference. The definition above is the game's own documentation.

Hands-On Usage

faction_upgrade_level is commonly used in faction system mods to unlock specific decisions or national focuses based on a member's upgrade progress. For example, only when a nation's faction upgrade reaches a specific tier does it allow other members to gain bonuses or conduct joint operations:

# Decision is only available when the nation's faction upgrade reaches the target tier
available = {
    TAG = {
        faction_upgrade_level > upgrade_industrial_tier2
    }
}

Synergy

  • [has_completed_faction_goal](/wiki/trigger/has_completed_faction_goal) — Usually paired with upgrade level checks to confirm that faction goals are completed before allowing further upgrade logic, preventing logical jumps.
  • [faction_goal_fulfillment](/wiki/trigger/faction_goal_fulfillment) — Also a faction progress trigger, commonly used in parallel to construct multi-stage faction growth condition chains.
  • [add_faction_goal_slot](/wiki/effect/add_faction_goal_slot) — When the upgrade tier condition is met, serves as an effect reward to unlock new faction goal slots, forming a complete feedback loop of "reach tier → unlock new goal".
  • [compare_ideology_with_faction](/wiki/trigger/compare_ideology_with_faction) — Checks whether the initiating nation's ideology matches the faction's ideology, combined with upgrade tier checks to restrict content that can only trigger for specific ideological factions.

Common Pitfalls

  1. Missing spaces between comparison operators and tokens: Writing faction_upgrade_level >upgrade_token instead of faction_upgrade_level > upgrade_token causes parsing errors and silent script failures; the game log may not provide clear error messages, making it extremely difficult to debug.
  2. Incorrect scope targeting: This trigger must be used within COUNTRY scope. Beginners often call it directly in a STATE scope limit block without first switching to the corresponding nation scope, causing the condition to never trigger or resulting in scope errors.