trigger · `is_leading_volunteer_group`

Definition

Supported scope:CHARACTER, COMBATANT
Supported target:THIS, ROOT, PREV, FROM, OWNER, CONTROLLER, OCCUPIED, CAPITAL

Description

is_leading_volunteer_group = FRA

实战 · 配合 · 坑

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

实战用法

此 trigger 常用于志愿军相关事件或决议中，判断某角色是否正在指挥某国的志愿军部队，从而触发特定对话或奖励。例如在外战结束后，检测指挥官是否仍在率领志愿军，以决定是否解散其指挥权或给予特殊特质：

# 在某角色事件中，判断该角色是否正在为法国指挥志愿军
character_event = {
    id = my_mod.10
    trigger = {
        is_leading_volunteer_group = FRA
    }
    option = {
        name = my_mod.10.a
        add_trait = { trait = war_hero }
    }
}

配合关系

[is_leading_volunteer_group_with_original_country](/wiki/trigger/is_leading_volunteer_group_with_original_country)：与其配合可以进一步区分"代为指挥的志愿军"和"来自原始派遣国的指挥官"，在国籍判断逻辑更复杂时形成互补。
[is_corps_commander](/wiki/trigger/is_corps_commander) / [is_field_marshal](/wiki/trigger/is_field_marshal)：志愿军指挥官必然拥有某个军事职级，联合使用可以精确筛选特定级别的志愿军领袖。
[add_unit_leader_trait](/wiki/effect/add_unit_leader_trait)：确认角色正在指挥志愿军后，为其添加专属特质，实现志愿军服役经历的建模。
[remove_unit_leader](/wiki/effect/remove_unit_leader)：志愿军任务结束后的清理逻辑中，先用此 trigger 确认身份再执行移除，避免误删非志愿军指挥官。

常见坑

国家标签填写错误：参数应为大写的国家标签（如 FRA、SOV），新手容易误写成小写或填入变量名，导致条件永远不成立且没有错误提示。
Scope 用错：此 trigger 必须处于 CHARACTER 或 COMBATANT scope 下才有效，若直接写在国家 scope 的 focus 或 decision 的顶层 trigger 块中而未切换 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

This trigger is commonly used in events or decisions related to volunteer forces, determining whether a character is currently commanding volunteer units for a specific nation, thereby triggering specific dialogue or rewards. For example, after a foreign campaign concludes, you can check whether the commander is still leading volunteer forces to decide whether to revoke their command or grant special traits:

# In a character event, check if the character is commanding volunteer forces for France
character_event = {
    id = my_mod.10
    trigger = {
        is_leading_volunteer_group = FRA
    }
    option = {
        name = my_mod.10.a
        add_trait = { trait = war_hero }
    }
}

Synergy

[is_leading_volunteer_group_with_original_country](/wiki/trigger/is_leading_volunteer_group_with_original_country): When combined with this trigger, you can further distinguish between "volunteers commanded on behalf of another nation" and "commanders from the original dispatching country," providing complementary logic when nationality checks become more complex.
[is_corps_commander](/wiki/trigger/is_corps_commander) / [is_field_marshal](/wiki/trigger/is_field_marshal): Volunteer commanders invariably hold some military rank; using these together enables precise filtering of volunteer leaders at specific levels.
[add_unit_leader_trait](/wiki/effect/add_unit_leader_trait): After confirming a character is commanding volunteer forces, add exclusive traits to model their volunteer service experience.
[remove_unit_leader](/wiki/effect/remove_unit_leader): In cleanup logic after volunteer assignments end, use this trigger to confirm identity before executing removal, preventing accidental deletion of non-volunteer commanders.

Common Pitfalls

Incorrect country tag formatting: The parameter should be an uppercase country tag (e.g., FRA, SOV); newcomers often mistakenly use lowercase or pass variable names, causing the condition to never evaluate true with no error message.
Wrong scope: This trigger only works within CHARACTER or COMBATANT scope; if placed directly in a nation-scoped focus or decision trigger block without scope switching, the game will silently ignore it or throw an error, making troubleshooting difficult for newcomers.

trigger · is_leading_volunteer_group