effect · activate_advisor

Hands-On Usage

activate_advisor is commonly used to automatically appoint an advisor upon focus completion, unlock specific characters when events are triggered, and in DLC character systems, push pre-defined characters into corresponding slots once conditions are met. For example, when a nation's focus tree is completed, directly activate a preset air force chief:

focus = {
    id = GER_build_luftwaffe
    ...
    completion_reward = {
        activate_advisor = GER_character_token_air_chief
    }
}

Synergy

• [add_advisor_role](/wiki/effect/add_advisor_role): First use add_advisor_role to attach an advisor role definition to a character, then use activate_advisor to actually activate and appoint them, forming a complete "define → enable" workflow.
• [deactivate_advisor](/wiki/effect/deactivate_advisor): When replacing an advisor, first call deactivate_advisor to remove the old advisor, then activate the new one, avoiding slot conflicts.
• [has_character](/wiki/trigger/has_character): Use has_character before activation to confirm the target character exists in your country, preventing activation failures due to missing or deceased characters.
• [has_available_idea_with_traits](/wiki/trigger/has_available_idea_with_traits): Can check whether the corresponding advisor slot has available candidates before activation, combined with conditional logic to make scripts more robust.

Common Pitfalls

1. Token must belong to the current country: The parameter for activate_advisor is a character token. If the character does not currently belong to the country executing the scope (e.g., already exiled or never generated), the command will silently fail without error reporting. Beginners often mistakenly believe the script executed normally.
2. Repeated activation without clearing the advisor slot: When the same slot already has an activated advisor, directly activating another advisor of the same type will not automatically replace the old one. You must first explicitly remove it with deactivate_advisor, otherwise the new advisor cannot enter the slot.