命令百科

effect · add_faction_initiative

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Adds Faction Initiative points to the current country's faction.

### Examples

TAG = { add_faction_initiative = VALUE }

实战 · 配合 · 坑

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

实战用法

add_faction_initiative 常用于阵营系统相关 mod 中，当一个国家完成特定国策、决议或事件选项时，为其所在阵营增加主动性积分，从而推动阵营升级或解锁阵营特权。例如在一个强化同盟机制的 mod 里，德国完成"扩大轴心国影响"国策后给阵营加分：

focus = {
    id = GER_expand_axis_influence
    ...
    completion_reward = {
        GER = {
            add_faction_initiative = 10
        }
    }
}

配合关系

  • [faction_upgrade_level](/wiki/trigger/faction_upgrade_level) —— 检测阵营当前升级等级，可在 initiative 积累到一定程度后触发不同奖励逻辑，形成"积分 → 升级 → 奖励"的完整链条。
  • [add_faction_influence_score](/wiki/effect/add_faction_influence_score) —— 两者同属阵营数值体系，常在同一事件选项里同时调用，兼顾主动性与影响力两个维度。
  • [faction_influence_ratio](/wiki/trigger/faction_influence_ratio) —— 作为前置条件判断本国在阵营中的影响力占比，只有主导成员才有资格触发 initiative 奖励，逻辑更严谨。
  • [add_faction_goal](/wiki/effect/add_faction_goal) —— initiative 积分通常与阵营目标配套设计，达成目标后用 add_faction_initiative 给予激励，形成正向反馈。

常见坑

  1. 在非阵营成员国的 scope 内调用：该 effect 作用于"当前国家所在阵营"，若触发时该国尚未加入任何阵营（例如中立国），脚本不会报错但积分会被静默丢弃，效果完全无效。务必用 [faction_influence_rank](/wiki/trigger/faction_influence_rank) 或类似条件先确认该国已属于某个阵营。
  2. 与 add_faction_influence_score 混淆：两者名称相近但作用于不同的阵营数值维度，initiative 影响主动性/行动点池，influence 影响影响力排名，错误替换会导致预期的阵营行为完全不触发。