命令百科

trigger · has_ability

Definition

  • Supported scope:CHARACTER
  • Supported target:any

Description

does unit leader have the abilityCheck if a unit leader has the ability.
Example: has_ability = force_attack

实战 · 配合 · 坑

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

实战用法

has_ability 常用于检查某个将领是否已解锁特定主动技能，从而决定是否允许触发后续事件或特殊效果，例如为拥有"强攻"能力的将领提供额外奖励。在自定义将领成长体系的 mod 中，也可用它来限制某些特质只能被已掌握特定能力的将领获取。

# 仅当该角色拥有 force_attack 能力时，才允许添加特质
if = {
    limit = {
        has_ability = force_attack
    }
    add_unit_leader_trait = aggressive_assaulter
}

配合关系

  • [has_trait](/wiki/trigger/has_trait)：通常与 has_ability 联用，先判断将领持有某特质，再检查其是否解锁了对应的主动能力，两者共同构成更精确的条件门槛。
  • [add_trait](/wiki/effect/add_trait)：在确认将领已具备某项能力后，通过此 effect 赋予新特质，形成"能力解锁特质"的进阶逻辑链。
  • [add_timed_unit_leader_trait](/wiki/effect/add_timed_unit_leader_trait)：类似 add_trait，但可给满足能力条件的将领附加临时增益，适合设计限时激活的技能强化效果。
  • [is_corps_commander](/wiki/trigger/is_corps_commander) / [is_field_marshal](/wiki/trigger/is_field_marshal)：能力归属于特定指挥官类型，联用此类 trigger 可避免在错误的领导者 scope 下误触判断。

常见坑

  1. Scope 错误：has_ability 只在 CHARACTER scope 下有效，若在 country 或 state scope 中直接使用会导致脚本静默失败或报错，必须先通过 any_army_leader、random_army_leader 等方式进入正确的角色 scope。
  2. 能力 key 拼写依赖游戏文件：ability 的标识符来自 unit_leader_abilities 的定义，并非特质名，新手容易将特质名与能力名混淆，导致条件永远无法为真，需在 /common/unit_leader_abilities/ 目录下核实准确的 key。