Wiki

trigger · faction_influence_score

Definition

  • Supported scope:COUNTRY
  • Supported target:any

Description

Checks influence value of current country in the faction

### Examples

TAG = { faction_influence_score > 100 }

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

faction_influence_score is commonly used in faction competition mods to determine whether a nation's influence score within a faction reaches a specific threshold, thereby unlocking exclusive decisions, focuses, or triggering events. For example, once a smaller nation accumulates sufficient influence, it may be permitted to challenge the faction's leadership or obtain special rewards.

# This decision is only available when the current nation's faction influence score exceeds 200
available = {
    faction_influence_score > 200
}

Synergy

  • [faction_influence_rank](/wiki/trigger/faction_influence_rank): Often used together with this trigger for dual verification—checking both the absolute score value of influence and the relative ranking within the faction, ensuring more precise conditional logic.
  • [faction_influence_ratio](/wiki/trigger/faction_influence_ratio): Used to simultaneously limit both the ratio and absolute value of influence, preventing false triggers when the ratio is artificially inflated due to very few faction members.
  • [add_faction_influence_score](/wiki/effect/add_faction_influence_score): Acts as a reward effect after conditions are met, forming a positive feedback loop design of "meet threshold → continue gaining benefits" with this trigger.
  • [add_faction_goal_slot](/wiki/effect/add_faction_goal_slot): When influence score is sufficiently high, grants this nation the permission to propose new objectives within the faction, representing a typical companion usage of the influence system.

Common Pitfalls

  1. Forgetting scope limitation: This trigger only functions under COUNTRY scope. If mistakenly written within conditional blocks of STATE or CHARACTER scopes, the game will not error but the evaluation will always return false, making the condition impossible to satisfy and extremely difficult to debug.
  2. Confusing score with ratio: faction_influence_score compares the absolute score of faction influence, not a percentage; beginners often incorrectly input decimal thresholds like 0.5 or 1.0 (which is the syntax for faction_influence_ratio), resulting in completely incorrect conditional logic.