trigger · `faction_influence_ratio`

Definition

Supported scope:COUNTRY
Supported target:any

Description

Checks influence ratio of current country in the faction

### Examples

TAG = { faction_influence_ratio > 0.1 }

实战 · 配合 · 坑

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

实战用法

faction_influence_ratio 常用于阵营内权力博弈类 mod，例如判断某国是否已掌握阵营主导权，从而解锁特殊决议或触发政治事件。也适合用在 AI 策略和动态事件中，当某小国影响力过低时自动触发求援或叛离逻辑。

# 当当前国家在阵营中的影响力超过 50% 时，才能使用该决议
available = {
    faction_influence_ratio > 0.5
}

配合关系

[faction_influence_score](/wiki/trigger/faction_influence_score)：影响力比值与原始分数互补，通常同时检查二者以区分"大阵营里的小份额"与"小阵营里的大份额"两种情形。
[faction_influence_rank](/wiki/trigger/faction_influence_rank)：配合排名 trigger 可精确筛选"影响力第一但比值不足"的边缘情况，避免逻辑漏洞。
[add_faction_influence_ratio](/wiki/effect/add_faction_influence_ratio)：作为对应的 effect，条件满足后直接增减比值，形成"检查→奖励/惩罚"的完整闭环。
[compare_ideology_with_faction](/wiki/trigger/compare_ideology_with_faction)：常在同一 limit 块中联用，确保只有意识形态契合的国家才能凭借高影响力获得收益。

常见坑

忘记指定 TAG 作用域：该 trigger 需在具体国家 scope 下调用，直接写在顶层 trigger 块而不套 TAG = { } 或 ROOT = { } 会导致脚本报错或永远返回假，新手极易遗漏这一层包裹。
把比值当百分比整数用：faction_influence_ratio 返回的是 0–1 的小数，写成 > 50 而非 > 0.5 会导致条件永远不成立，调试时却看不出明显报错。

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

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

trigger · faction_influence_ratio