effect · add_ace

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

1. 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.
2. 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.