trigger · `faction_influence_rank`

Definition

Supported scope:COUNTRY
Supported target:any

Description

Checks influence rank in the faction of the current country

### Examples

TAG = { faction_influence_rank < 5 }

实战 · 配合 · 坑

实战内容由 AI 生成,并已对照 vanilla 命令词表校验 —— 请当作起点而非权威依据。上方的定义节才是游戏自带文档原文。

实战用法

faction_influence_rank 常用于派系内政治博弈类 mod，例如判断某国在派系中的影响力排名是否足够靠前，从而解锁特定的决议或国策选项。典型场景：当一个小国想要挑战派系领袖地位时，需要先积累足够高的影响力排名才能触发相关事件链。

# 只有当本国在派系中排名前3时，才能发起"争夺领导权"决议
available = {
    is_faction_leader = no
    faction_influence_rank < 4
}

配合关系

[faction_influence_score](/wiki/trigger/faction_influence_score)：通常与排名判断配合使用，前者检查具体的影响力分值门槛，后者检查相对排名，二者结合能更精确地描述"分值够且排名够高"的条件。
[faction_influence_ratio](/wiki/trigger/faction_influence_ratio)：用于检查本国影响力占派系总量的比例，与排名判断互补——排名靠前但比例很低说明派系成员实力接近，可据此设计不同的剧情分支。
[add_faction_influence_score](/wiki/effect/add_faction_influence_score)：在 effect 块中为国家增减影响力分数，常作为满足排名条件后的奖励或惩罚手段，形成"达到排名→触发事件→调整分值"的闭环。
[add_faction_influence_ratio](/wiki/effect/add_faction_influence_ratio)：与排名 trigger 搭配，在某国排名发生变化时同步调整比例，保持派系内部数值的逻辑一致性。

常见坑

排名数值方向混淆：faction_influence_rank < 2 表示排名第1（数值越小排名越靠前），新手容易误以为数值越大越好，导致条件逻辑反转，永远触发或永远无法触发。
无派系时不报错但永远为假：若该国当前不属于任何派系，trigger 不会报脚本错误，但会静默返回 false，排查时容易忽略"国家是否已入派系"这一前置条件，建议在外层先加 is_in_faction = yes 进行保护。

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

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

trigger · faction_influence_rank