Hands-On Usage
This trigger is commonly used in the available condition of focuses or decisions related to "seizing faction leadership," ensuring that the player's or AI's country has sufficient military strength to challenge and replace the current faction leader. For example, in a custom faction-rivalry mod, it can be used to restrict a "challenge for faction leadership" decision so that it only fires when the contender's actual military strength decisively outclasses the leader's:
# Example available condition for a decision to contest faction leadership
available = {
is_in_faction = yes
is_faction_leader = no
has_war = no
has_manpower_to_become_leader = yes
has_stability > 0.5
}
Synergy
- is_in_faction: First confirms that the country is already part of a faction, then checks whether it has enough manpower to challenge the leader — both conditions are indispensable.
- is_faction_leader: Typically paired with
is_faction_leader = no to exclude countries that are already the faction leader, so this trigger only applies to non-leader members.
- has_war: Commonly used alongside
has_war = no to prevent leadership-transfer logic from firing while the country is at war, avoiding unreasonable mid-war power grabs within a faction.
- create_faction: If the conditions are met and the decision is made to strike out independently, this effect can be used in the effect block — leaving the old faction first and then founding a new one.
Common Pitfalls
- Assuming this trigger compares total manpower reserves: It actually compares deployed manpower, not the stockpile sitting in the manpower pool. This means that even if a country has a large manpower reserve, the trigger will still return false if the number of divisions actually fielded is insufficient.
- Using it on a country that is not a faction member: The trigger's comparison target is "the current faction leader and its subjects." If the country in question does not belong to any faction, the reference point for the comparison does not exist and the result may be unexpected. It is strongly recommended to always pair this trigger with
is_in_faction = yes as a prerequisite.