命令百科

trigger · has_advisor_role

Definition

  • Supported scope:CHARACTER
  • Supported target:none

Description

has_advisor_role = 'character_slot_name' - Checks if the character in scope has an advisor role for the given slot

实战 · 配合 · 坑

实战内容由 AI 生成,并已对照 vanilla 命令词表校验 —— 请当作起点而非权威依据。上方的定义节才是游戏自带文档原文。

实战用法

has_advisor_role 常用于在顾问招募或事件脚本中检查某个角色是否已被配置了特定顾问槽位的角色定义，从而决定是否显示某个选项或触发特定事件分支。例如在 DLC 角色包 mod 中，可以用它来避免重复给同一角色添加同类顾问角色：

# 在 focus 或 event option 的 available 块中
available = {
    FROM = {         # FROM 指向目标角色 (CHARACTER scope)
        NOT = {
            has_advisor_role = political_advisor
        }
    }
}

配合关系

  • [is_advisor](/wiki/trigger/is_advisor) — 先用 is_advisor 判断角色当前是否正在被雇用，再配合 has_advisor_role 确认其所属槽位类型，两者叠用可精准定位"正在担任某槽顾问"的角色。
  • [add_advisor_role](/wiki/effect/add_advisor_role) — 在 effect 块中给角色追加新顾问角色前，先用 has_advisor_role 做存在性检查，防止重复定义同一槽位导致脚本报错或逻辑冲突。
  • [remove_advisor_role](/wiki/effect/remove_advisor_role) — 移除顾问角色的前提往往是确认该角色确实拥有对应角色定义，用 has_advisor_role 作为 limit/trigger 保护可避免对不存在角色的无效移除。
  • [is_hired_as_advisor](/wiki/trigger/is_hired_as_advisor) — has_advisor_role 只检查角色定义了哪个槽位，而 is_hired_as_advisor 检查是否已被雇用，两者组合才能完整区分"有资格但未上岗"与"已在岗"两种状态。

常见坑

  1. 混淆"拥有角色定义"与"正在被雇用"：has_advisor_role 仅判断角色档案里是否注册了对应槽位的 advisor role，即使该角色未被任何国家雇用也会返回真，因此不能用它代替 is_hired_as_advisor 来判断顾问是否在职。
  2. Scope 必须是 CHARACTER 而非 Country：新手常在国家 scope 下直接写此 trigger，导致脚本静默失败或报错；正确做法是先通过 any_character、every_character 或具名角色变量切换到 CHARACTER scope 后再调用。