effect · `add_faction_influence_ratio`

Definition

Supported scope:COUNTRY
Supported target:none

Description

Adds influence to the country based on the given ratio of the faction's total influence

	### Examples
	```
	TAG = {
		add_faction_influence_ratio = 0.1
	}
	```

实战 · 配合 · 坑

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

实战用法

add_faction_influence_ratio 常用于派系系统的 mod 场景，例如在某国完成特定国策或决议后，按派系总影响力的比例给予奖励，从而避免硬编码固定数值导致的数值失衡。它在"意识形态竞争"或"大国博弈"类 mod 中尤为常见，用于动态调整各国对某一派系的话语权。

# 完成国策后，按比例提升本国在派系中的影响力
focus = {
    id = strengthen_faction_ties
    ...
    completion_reward = {
        add_faction_influence_ratio = 0.15
    }
}

配合关系

[faction_influence_ratio](/wiki/trigger/faction_influence_ratio)：在条件判断中检查当前影响力占比，与 add_faction_influence_ratio 搭配可实现"达到某比例才允许进一步增长"的门控逻辑。
[faction_influence_rank](/wiki/trigger/faction_influence_rank)：检查本国在派系内的影响力排名，配合使用可在排名较低时才触发补偿性加成，避免强国垄断。
[add_faction_influence_score](/wiki/effect/add_faction_influence_score)：两者均修改派系影响力，但一个按比例、一个按绝对值；混合使用可在不同阶段提供细粒度控制。
[add_faction_power_projection](/wiki/effect/add_faction_power_projection)：在提升影响力比例的同时增加权力投射，常见于"崛起大国"事件链，两者共同强化派系地位。

常见坑

数值范围误解：参数是相对于派系总影响力的比例，而非本国当前影响力的比例，若直接填入较大的小数（如 1.0）将一次性获得与派系总量等值的影响力，极易造成数值爆炸。
Scope 错误：此 effect 必须在 COUNTRY scope 下执行；若写在 STATE scope 的 hidden_effect 或 every_owned_state 块内未切回国家 scope，脚本会静默失效且不报错，排查时容易遗漏。

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

add_faction_influence_ratio is commonly used in faction system mod scenarios, such as granting proportional rewards based on the faction's total influence after a country completes a specific focus or decision, thereby avoiding numerical imbalance caused by hardcoded fixed values. It is particularly prevalent in "ideological competition" or "great power rivalry" mods, where it dynamically adjusts each country's influence over a specific faction.

# After completing a focus, increase this nation's influence ratio in the faction proportionally
focus = {
    id = strengthen_faction_ties
    ...
    completion_reward = {
        add_faction_influence_ratio = 0.15
    }
}

Synergy

[faction_influence_ratio](/wiki/trigger/faction_influence_ratio): Check the current influence ratio in conditional statements; pairing with add_faction_influence_ratio enables gating logic such as "only allow further growth upon reaching a certain ratio."
[faction_influence_rank](/wiki/trigger/faction_influence_rank): Check this nation's influence ranking within the faction; combined usage can trigger compensatory bonuses when ranking is low, preventing major powers from monopolizing influence.
[add_faction_influence_score](/wiki/effect/add_faction_influence_score): Both modify faction influence, but one by ratio and one by absolute value; hybrid usage provides fine-grained control at different stages.
[add_faction_power_projection](/wiki/effect/add_faction_power_projection): Increase power projection while boosting influence ratio, commonly seen in "rising power" event chains, where both effects reinforce the faction's standing.

Common Pitfalls

Misunderstanding value ranges: The parameter is a ratio relative to the faction's total influence, not the ratio of the current nation's influence. Entering a large decimal directly (such as 1.0) will grant influence equivalent to the entire faction's total in a single instance, easily causing numerical explosions.
Scope errors: This effect must execute under COUNTRY scope; if written inside a STATE scope's hidden_effect or every_owned_state block without switching back to country scope, the script will silently fail without error messages, making it easy to overlook during debugging.

effect · add_faction_influence_ratio