effect · activate_advisor

实战用法

activate_advisor 常用于国策完成后自动上任顾问、事件触发时解锁特定角色，以及 DLC 人物系统中在满足条件后将已定义的角色推入对应槽位。例如在某国家专注树完成时，直接激活预设的空军总司令：

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

配合关系

• [add_advisor_role](/wiki/effect/add_advisor_role)：先用 add_advisor_role 为角色挂载顾问角色定义，再用 activate_advisor 将其实际激活上岗，两者形成"定义→启用"的完整流程。
• [deactivate_advisor](/wiki/effect/deactivate_advisor)：需要替换顾问时，先调用 deactivate_advisor 卸下旧顾问，再激活新顾问，避免同槽冲突。
• [has_character](/wiki/trigger/has_character)：激活前用 has_character 确认目标角色存在于本国，防止因角色不存在或已阵亡导致激活失败。
• [has_available_idea_with_traits](/wiki/trigger/has_available_idea_with_traits)：可在激活前检测对应顾问槽位是否有可用候选，配合条件判断让脚本更健壮。

常见坑

1. Token 必须归属于当前国家：activate_advisor 的参数是角色 token，若该角色当前不属于执行 scope 的国家（例如已流亡或从未生成），指令会静默失败，不会报错，新手往往误以为脚本正常执行。
2. 顾问槽位未清空就重复激活：同一槽位已有激活的顾问时直接再次激活另一个同类顾问，并不会自动顶替旧顾问，需先用 deactivate_advisor 显式移除，否则新顾问无法进入槽位。