effect · end_puppet

Hands-On Usage

end_puppet is commonly used in puppet independence events, autonomy level advancement scripts, or as the conclusion of specific focus chains—when the player or AI meets certain conditions, the overlord actively releases its subject as a fully independent nation. For example, in a focus effect concerning "imperial dissolution":

focus = {
    id = GER_release_puppets
    # ...
    completion_reward = {
        every_subject_country = {
            limit = {
                has_autonomy_state = autonomy_puppet
            }
            ROOT = { end_puppet = PREV }
        }
    }
}

Synergy

• [has_autonomy_state](/wiki/trigger/has_autonomy_state): Used before executing end_puppet to filter targets, ensuring only nations in true puppet status have their relationships severed, preventing logic errors.
• [every_subject_country](/wiki/effect/every_subject_country): Iterates through all subject nations in batch; paired with end_puppet, it can release multiple puppets at once, ideal for empire dissolution events.
• [give_guarantee](/wiki/effect/give_guarantee): Grants a guarantee immediately after releasing a puppet, useful for simulating "nominally independent yet still protected" historical scenarios, creating a smoother transition.
• [diplomatic_relation](/wiki/effect/diplomatic_relation): Adjusts bilateral diplomatic relations after releasing a puppet (such as setting non-aggression pacts or alliances), completing the post-liberation diplomatic status.

Common Pitfalls

1. Reversed scope direction: end_puppet must execute within the overlord's scope, with the target being the puppet nation to be released. Beginners often call it from the puppet nation's own scope without pointing to the overlord, resulting in the command being ineffective or throwing errors.
2. Failing to verify subject status first: Executing end_puppet directly on a nation that is not the current overlord's puppet won't error but will have no effect either. Always pair it with [has_autonomy_state](/wiki/trigger/has_autonomy_state) or [any_subject_country](/wiki/trigger/any_subject_country) for preliminary validation to prevent silent failures that are difficult to troubleshoot.