trigger · faction_influence_ratio

Hands-On Usage

faction_influence_ratio is commonly used in faction power struggle mods, such as determining whether a nation has gained dominance within a faction to unlock special decisions or trigger political events. It is also suitable for AI strategies and dynamic events—when a minor nation's influence falls too low, it can automatically trigger rescue or defection logic.

# This decision is only available when the current nation's faction influence exceeds 50%
available = {
    faction_influence_ratio > 0.5
}

Synergy

• [faction_influence_score](/wiki/trigger/faction_influence_score): Influence ratio and raw score are complementary; checking both simultaneously helps distinguish between "small share in a large faction" and "large share in a small faction" scenarios.
• [faction_influence_rank](/wiki/trigger/faction_influence_rank): Combined with ranking triggers, this precisely filters edge cases like "highest influence but insufficient ratio," preventing logic gaps.
• [add_faction_influence_ratio](/wiki/effect/add_faction_influence_ratio): The corresponding effect directly increases or decreases the ratio after conditions are met, forming a complete "check → reward/penalty" loop.
• [compare_ideology_with_faction](/wiki/trigger/compare_ideology_with_faction): Frequently used together in the same limit block to ensure only ideologically aligned nations benefit from high influence.

Common Pitfalls

1. Forgetting to specify TAG scope: This trigger must be called within a specific nation's scope. Placing it directly in a top-level trigger block without wrapping it in TAG = { } or ROOT = { } causes script errors or always returns false—a common oversight for beginners.
2. Treating ratio as a percentage integer: faction_influence_ratio returns a decimal between 0–1; writing > 50 instead of > 0.5 causes the condition to never be true, yet produces no obvious error during debugging.