trigger · is_navy_leader

Hands-On Usage

is_navy_leader is commonly used to restrict certain traits, promotion paths, or event options to naval leaders only, such as in dynamic modifier trigger conditions or advisor role validation to differentiate unit types. For example, in character events, you can grant a naval-exclusive trait only when the current character is a naval leader:

# Restrict the scope of action in character event trigger conditions
trigger = {
    is_navy_leader = yes
    has_trait = bold
}

# After validation, add a naval trait to the character
effect = {
    add_unit_leader_trait = naval_invincibility
}

Synergy

• [is_unit_leader](/wiki/trigger/is_unit_leader): First confirm the character is a unit commander, then use is_navy_leader to refine by unit type and avoid misidentifying characters without assigned unit types.
• [has_trait](/wiki/trigger/has_trait): Commonly used together with trait detection to filter characters that are "both naval leaders and possess specific traits" as targets for events or decisions.
• [add_naval_commander_role](/wiki/effect/add_naval_commander_role): When used in combination, you can first exclude characters already serving as naval leaders using is_navy_leader = no, then safely assign the naval commander role to prevent stacking duplicates.
• [add_unit_leader_trait](/wiki/effect/add_unit_leader_trait): After restricting with is_navy_leader = yes in a limit block, attach naval-exclusive traits to ensure they are not mistakenly assigned to army or air force leaders.

Common Pitfalls

1. Using it outside CHARACTER scope: This trigger only works in CHARACTER scope. If called directly in country or division scope, the script will not error but will silently return false, causing the condition to never be satisfied and making it difficult to debug.
2. Confusing it with is_unit_leader: is_navy_leader specifically refers to naval leaders (admirals), while is_unit_leader returns true for all unit commanders. Beginners sometimes mistakenly use is_unit_leader to filter naval leaders, causing army leaders to be incorrectly matched into logic branches.