trigger · faction_influence_rank

Hands-On Usage

faction_influence_rank is commonly used in mods involving intra-faction political mechanics, such as determining whether a nation's influence ranking within a faction is high enough to unlock specific decisions or national focus options. Typical scenario: when a minor nation wants to challenge the faction leader's position, it must first accumulate a sufficiently high influence rank to trigger the relevant event chain.

# Can only initiate "Seize Leadership" decision when this nation ranks in top 3 of faction
available = {
    is_faction_leader = no
    faction_influence_rank < 4
}

Synergy

• [faction_influence_score](/wiki/trigger/faction_influence_score): Usually paired with rank checks—the former validates concrete influence score thresholds while the latter checks relative ranking. Combined, they precisely express conditions like "sufficient score AND high enough rank."
• [faction_influence_ratio](/wiki/trigger/faction_influence_ratio): Checks what percentage of total faction influence this nation holds. Complements rank checks—high rank with low ratio indicates faction members have comparable power, useful for branching storylines accordingly.
• [add_faction_influence_score](/wiki/effect/add_faction_influence_score): In effect blocks, adds or subtracts influence score for a nation. Often serves as reward or penalty after rank conditions are met, forming a closed loop: "reach rank → trigger event → adjust score."
• [add_faction_influence_ratio](/wiki/effect/add_faction_influence_ratio): Paired with rank triggers; syncs ratio adjustments when a nation's rank shifts, maintaining numerical consistency within faction dynamics.

Common Pitfalls

1. Confusion over rank value direction: faction_influence_rank < 2 means rank 1st (lower numbers = higher rank). Beginners often assume higher values are better, inverting condition logic and causing triggers to always fire or never fire.
2. Silent failure when not in a faction: If the nation currently belongs to no faction, the trigger throws no script error but silently returns false. It's easy to overlook "is the nation actually in a faction?" as a prerequisite during debugging. Recommend protecting with is_in_faction = yes at the outer level.