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
- 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.
- 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.