effect · set_party_name

Hands-On Usage

set_party_name is commonly used in political reform mods to replace party names with more lore-appropriate titles when players change their nation's ideology through focuses or decisions (for example, renaming a fascist party to a localized variant). It can also be used in historical accuracy mods to dynamically update party names after events trigger at specific timestamps, ensuring alignment with historical records.

# After a focus completes, rename the fascist ideology party to a custom name
focus = {
    id = rename_party_fascism
    ...
    completion_reward = {
        set_party_name = {
            ideology = fascism
            long_name = "National United Front"
            name = "Nat'l United"
        }
    }
}

Synergy

• [add_popularity](/wiki/effect/add_popularity): Increase the popularity of an ideology while renaming its party, ensuring political reforms take effect consistently in both mechanics and presentation.
• [create_country_leader](/wiki/effect/create_country_leader): Create or replace the leader of a newly renamed party, forming a complete political event chain linking party renaming with leadership transitions.
• [add_ideas](/wiki/effect/add_ideas): Pair party renaming with corresponding national spirits to reinforce the narrative and policy effects of the ideology faction.
• [has_country_leader_ideology](/wiki/trigger/has_country_leader_ideology): Check the current ruling ideology in trigger conditions to ensure renaming only occurs when the correct ruling party is in power, preventing logical errors.

Common Pitfalls

1. Incorrect ideology field: Must use the game's internal ideology key (such as fascism, democratic, communism, neutrality). Do not use sub-ideologies or custom strings, or the command will silently fail without error messages, making it extremely difficult to debug.
2. Confusing long_name and name: Both must be filled in. name is the short form (used where interface space is limited), while long_name is the full form (used in party lists, etc.). Omitting one will leave the other blank or revert to the default value.