effect · drop_cosmetic_tag

Hands-On Usage

drop_cosmetic_tag is commonly used in mods for scenarios requiring dynamic switching of a nation's cosmetic appearance. For example, when a political event concludes, a faction dissolves, or a regime changes, you may need to revoke a previously assigned cosmetic tag to restore the nation to its original appearance and flag. Typical use cases include: a unified nation abandoning temporary tags after a civil war ends, or removing an "occupied government" cosmetic tag after completing an event chain.

# Civil war ends, ruling faction reverts to original appearance
country_event = {
    id = my_mod.50
    ...
    option = {
        name = my_mod.50.a
        # Revoke cosmetic tag first, then set new state
        drop_cosmetic_tag = yes
        add_stability = 0.05
    }
}

Synergy

• [has_cosmetic_tag](/wiki/trigger/has_cosmetic_tag): Use this trigger before executing drop_cosmetic_tag to check whether the current nation holds a specific cosmetic tag, avoiding meaningless operations or script warnings when no tag is present.
• [add_ideas](/wiki/effect/add_ideas): Cosmetic tags are often bound to specific ideas for visual theming. After revoking a tag, you typically need to synchronously add or replace corresponding ideas to maintain logical consistency.
• [country_event](/wiki/effect/country_event): Switching cosmetic tags is a critical narrative node in event chains, commonly executed by triggering subsequent events to complete the cosmetic transition.
• [add_political_power](/wiki/effect/add_political_power): Regime changes (requiring old cosmetic tags to be dropped) often come with political power rewards or penalties, frequently appearing together in the same option block.

Common Pitfalls

1. Scope confusion: drop_cosmetic_tag can only be called within COUNTRY scope. Beginners sometimes misuse it in sub-blocks of state scope or unit leader scope, causing script errors or silent failures. Always verify that the outer scope is a specific nation tag.
2. Dropping a tag without checking if it exists: If the nation currently holds no cosmetic tags when this command is called, while the game usually won't crash, it will generate meaningless log warnings. It's recommended to pair this with [has_cosmetic_tag](/wiki/trigger/has_cosmetic_tag) for conditional checks to write more robust scripts.