effect · set_garrison_strength

Hands-On Usage

set_garrison_strength is commonly used in mods to reset or initialize the garrison strength of occupied states—for example, setting a low value when a player first occupies a state to simulate insufficient forces, or forcibly restoring a region's garrison to full strength during scripted events. Typical scenarios include reducing garrison after resistance event chains trigger, and increasing initial garrison strength in key states after specific national focuses complete.

# After a national focus completes, set the target state's garrison to full strength
some_state = {
    set_garrison_strength = 1.0
}

# After a resistance event triggers, reduce garrison in the contested state
event_target:contested_state = {
    set_garrison_strength = 0.3
}

Synergy

• [has_active_resistance](/wiki/trigger/has_active_resistance): Before modifying garrison strength, check whether the state has active resistance to avoid unnecessary operations on stable regions.
• [set_resistance](/wiki/effect/set_resistance): These two are often used in pairs—simultaneously setting resistance value and garrison strength to establish a complete initial occupied state.
• [add_compliance](/wiki/effect/add_compliance): After adjusting garrison strength, pairing it with compliance modifications allows synchronized calibration of the occupied region's overall stability metrics, ensuring the state matches scenario expectations.
• [set_occupation_law](/wiki/effect/set_occupation_law): Occupation law and garrison strength jointly determine suppression efficiency; resetting garrison strength when switching occupation laws prevents value misalignment.

Common Pitfalls

1. Misunderstanding value ranges: This effect's parameter is a proportional value (0.0 ~ 1.0), and beginners often mistakenly input absolute force numbers (e.g., 500), causing garrison to be set to abnormally high strength or be truncated by the engine. Always use decimal form.
2. Wrong scope usage: This command must execute within STATE scope. If written directly in a COUNTRY scope's immediate block without first switching to a specific state, the script fails silently without error, making it easy to overlook during troubleshooting.