trigger · `is_leading_volunteer_group_with_original_country`

Definition

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

Description

is_leading_volunteer_group_with_original_country = FRA

实战 · 配合 · 坑

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

实战用法

此 trigger 常用于志愿军相关事件或决策中，判断某角色是否正在以特定原籍国的身份率领志愿军部队，从而触发不同的剧情分支或奖励。例如在内战干涉类 mod 中，可用它识别来自某国的志愿军指挥官，给予专属特质或对话选项。

# 在角色事件中，检查该指挥官是否以法国原籍身份率领志愿军
character_event = {
    id = volunteer_mod.1
    trigger = {
        is_leading_volunteer_group_with_original_country = FRA
        is_corps_commander = yes
    }
    option = {
        name = "volunteer_mod.1.a"
        add_trait = { trait = brilliant_strategist }
    }
}

配合关系

[is_leading_volunteer_group](/wiki/trigger/is_leading_volunteer_group)：两者经常并列使用，前者只检查"是否在带志愿军"，后者进一步限定原籍国，组合后逻辑更精确。
[has_trait](/wiki/trigger/has_trait)：配合使用，在确认指挥官身份后进一步筛选其是否已持有某特质，避免重复添加。
[add_unit_leader_trait](/wiki/effect/add_unit_leader_trait)：确认条件成立后，给该志愿军指挥官添加专属特质作为奖励或惩罚。
[has_nationality](/wiki/trigger/has_nationality)：与原籍国判断互补，用于区分角色当前国籍与原籍国不同的边界情况，防止逻辑漏洞。

常见坑

scope 用错：此 trigger 必须在 CHARACTER 或 COMBATANT scope 下使用，若直接写在国家 scope（如 country_event 的顶层 trigger 块）中会静默失败或报错，需先用 any_character / any_unit_leader 等切换到正确 scope。
国家 tag 大小写：填写目标国家时必须使用大写三字母 tag（如 FRA 而非 fra），tag 填错不会有报错提示，只会让条件永远返回假，难以排查。

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 volunteer-related events or decisions to check whether a character is commanding volunteer forces under a specific original country's flag, enabling different story branches or rewards. For example, in civil war intervention mods, it can identify volunteer commanders from a particular nation and grant them exclusive traits or dialogue options.

# In a character event, check if the commander is leading volunteer forces with French origin
character_event = {
    id = volunteer_mod.1
    trigger = {
        is_leading_volunteer_group_with_original_country = FRA
        is_corps_commander = yes
    }
    option = {
        name = "volunteer_mod.1.a"
        add_trait = { trait = brilliant_strategist }
    }
}

Synergy

[is_leading_volunteer_group](/wiki/trigger/is_leading_volunteer_group): Often used together with this trigger. The former checks only "whether leading volunteers," while the latter further specifies the original country. Combined, the logic becomes more precise.
[has_trait](/wiki/trigger/has_trait): Used in conjunction to further filter whether the commander already possesses a specific trait after confirming their identity, preventing duplicate additions.
[add_unit_leader_trait](/wiki/effect/add_unit_leader_trait): Once the condition is confirmed, adds an exclusive trait to the volunteer commander as a reward or penalty.
[has_nationality](/wiki/trigger/has_nationality): Complements the original country check by distinguishing edge cases where a character's current nationality differs from their origin country, preventing logical gaps.

Common Pitfalls

Wrong scope: This trigger must be used under CHARACTER or COMBATANT scope. Placing it directly in a country scope (such as the top-level trigger block of a country_event) will silently fail or throw an error. Use any_character / any_unit_leader and similar constructs to switch to the correct scope first.
Country tag case sensitivity: When specifying the target country, always use uppercase three-letter tags (e.g., FRA not fra). Incorrect tags will not produce an error message but will simply cause the condition to always return false, making debugging difficult.

trigger · is_leading_volunteer_group_with_original_country