命令百科

trigger · is_leading_army_group

Definition

  • Supported scope:CHARACTER
  • Supported target:none

Description

is_leading_army_group = yes/no - Checks if the current unit leader is leading an army group (not single army)

实战 · 配合 · 坑

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

实战用法

在晋升或特性分配类 mod 中，常用于区分指挥单支军队的将领与统领集团军群的元帅级角色，从而触发不同的奖励或限制逻辑。例如，当某角色正在统领集团军群时，才允许其获得特定的高级指挥特性：

# 在某个 on_action 或 decision 的 trigger 块中
character_event = {
    trigger = {
        is_leading_army_group = yes
        is_field_marshal = yes
    }
    # 仅对正在统领集团军群的陆军元帅触发
}

配合关系

  • [is_field_marshal](/wiki/trigger/is_field_marshal)：集团军群通常由陆军元帅指挥，两者组合可精确筛选"正在执行集团军群指挥职责的元帅"，避免误判普通将领。
  • [is_leading_army](/wiki/trigger/is_leading_army)：与 is_leading_army_group 互为补充，可用 NOT 套嵌区分"仅指挥单支军队"与"指挥集团军群"两种状态，实现分支逻辑。
  • [add_unit_leader_trait](/wiki/effect/add_unit_leader_trait)：满足条件后为角色动态添加专属指挥特性，常见于"升任集团军群指挥官时解锁新特性"的 mod 设计。
  • [add_skill_level](/wiki/effect/add_skill_level)：在确认角色正统领集团军群后给予技能加成，模拟大规模指挥经验带来的成长。

常见坑

  1. 将 is_leading_army_group 与 is_field_marshal 混淆：角色拥有陆军元帅职位不代表其当前一定在统领集团军群（可能处于未分配状态），必须同时检查该 trigger 才能确认其实际指挥状态。
  2. 在 COUNTRY scope 下调用：该 trigger 仅在 CHARACTER scope 下有效，若在国家事件的顶层 trigger 块中直接使用而未先切换到正确的角色 scope，会导致脚本报错或永远返回 false，需配合 any_character 或具体角色 scope 进行嵌套。