effect · `add_ace`

Definition

Supported scope:COUNTRY
Supported target:none

Description

adds an air ace

实战 · 配合 · 坑

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

实战用法

add_ace 常用于剧本事件或国家焦点中，为某个国家随机生成一位空战王牌飞行员，以增强空军的叙事感或提供战斗加成。例如在特殊剧本中，当某国完成特定空军相关焦点时触发：

focus = {
    id = legendary_air_program
    ...
    completion_reward = {
        add_ace = yes
        air_experience = 50
    }
}

配合关系

[air_experience](/wiki/effect/air_experience)：王牌飞行员的出现通常伴随空军经验值奖励，共同营造"精英空军"的主题感。
[has_air_experience](/wiki/trigger/has_air_experience)：用作前置条件判断，确保国家已有足够的空军底蕴再触发王牌的出现，逻辑更合理。
[add_ideas](/wiki/effect/add_ideas)：可同步添加与空军相关的国家思潮/顾问，与王牌飞行员共同构成完整的空军强化奖励包。
[country_event](/wiki/effect/country_event)：配合触发事件来给予玩家叙事反馈，描述王牌飞行员的诞生背景故事。

常见坑

Scope 用错：add_ace 只能在 COUNTRY scope 下使用，若误写在 STATE 或 CHARACTER scope 内会导致脚本报错或静默失效，需特别注意当前所在的作用域层级。
误以为可指定飞行员属性：该命令不接受任何子参数来自定义王牌的名字、技能或所属机型，生成结果完全由游戏随机决定，试图添加额外字段只会引发语法错误。

Hands-On Notes

Hands-on notes are AI-generated and checked against the vanilla command vocabulary — treat them as a starting point, not authoritative reference. The definition above is the game's own documentation.

Hands-On Usage

add_ace is commonly used in scripted events or national focuses to randomly generate an elite air force pilot for a country, enhancing narrative immersion or providing combat bonuses. For example, in special scenarios where a country completes an air force-related focus:

focus = {
    id = legendary_air_program
    ...
    completion_reward = {
        add_ace = yes
        air_experience = 50
    }
}

Synergy

[air_experience](/wiki/effect/air_experience): The appearance of elite pilots typically accompanies air experience rewards, together reinforcing the "elite air force" thematic narrative.
[has_air_experience](/wiki/trigger/has_air_experience): Serves as a precondition check to ensure the country has sufficient air force foundation before triggering pilot generation, making the logic more coherent.
[add_ideas](/wiki/effect/add_ideas): Can simultaneously add air force-related national ideas or advisors, forming a comprehensive air force enhancement reward package alongside the ace pilot.
[country_event](/wiki/effect/country_event): Can be paired with triggered events to provide narrative feedback to the player, describing the background story of the elite pilot's emergence.

Common Pitfalls

Incorrect Scope: add_ace can only be used within the COUNTRY scope. Mistakenly placing it in STATE or CHARACTER scope will cause script errors or silent failures. Pay close attention to the current scope level.
Assuming Pilot Attributes Can Be Customized: This command does not accept any sub-parameters to customize the pilot's name, skills, or aircraft type. Generation results are entirely random and determined by the game. Attempting to add extra fields will only trigger syntax errors.

effect · add_ace