trigger · is_leading_volunteer_group

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

1. 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.
2. 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.