Wiki

effect · add_collaboration

Definition

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

Description

Adds the collaboration in a target country with our currently scoped country
GER = {
  add_collaboration = {
    target = POL
    value = 0.3
  }
}

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

add_collaboration is commonly used as narrative groundwork before puppet state establishment or occupation—for example, allowing a major power to accumulate collaboration through espionage or diplomatic events in the target nation, making subsequent occupation and compliance smoother. A typical scenario involves automatically adding a baseline collaboration value to neighboring countries for the player after completing a specific focus.

# After Germany completes a certain infiltration focus, add collaboration to Poland
focus = {
    id = GER_infiltrate_poland
    # ...
    completion_reward = {
        GER = {
            add_collaboration = {
                target = POL
                value = 0.3
            }
        }
    }
}

Synergy

  • [has_collaboration](/wiki/trigger/has_collaboration): Use before or after adding collaboration to detect whether current collaboration level has reached a certain threshold, determining whether to trigger further events or options.
  • [add_opinion_modifier](/wiki/effect/add_opinion_modifier): Rising collaboration is often accompanied by improved diplomatic relations; using both together makes the target nation more favorable toward the perpetrator and enhances narrative authenticity.
  • [add_dynamic_modifier](/wiki/effect/add_dynamic_modifier): Can apply dynamic modifiers once collaboration accumulates to a certain level, imposing economic or political infiltration effects on the target nation and strengthening gameplay feedback.
  • [country_event](/wiki/effect/country_event): Commonly paired with collaboration increases to trigger exclusive events, allowing the target nation's player or AI to respond to external infiltration, enriching the interaction chain.

Common Pitfalls

  1. Confusion between scope and target: add_collaboration must be executed within the perpetrator's (infiltrating nation's) country scope, with target specifying the target nation's tag; newcomers often reverse scope and target, causing collaboration to be applied to the wrong nation, and the game provides no error warning.
  2. value is an absolute value, not a percentage string: value accepts a direct numeric value (such as 0.3 representing 30%), not 30 or with a percent sign; otherwise it will exceed valid range or produce unexpectedly large collaboration jumps.