effect · army_experience

Hands-On Usage

army_experience is commonly used in focus tree and decision completion reward scenarios—for example, granting the player a certain amount of land army experience upon completing a military reform focus, which can then be used to unlock or upgrade division templates. It is also applicable in event triggers to simulate the narrative effect of troops accumulating combat experience after a successful campaign.

focus = {
    id = military_reform
    # ...
    completion_reward = {
        army_experience = 50
        add_political_power = 25
    }
}

Synergy

• [has_army_experience](/wiki/trigger/has_army_experience): Check whether the current land army experience is sufficient before deciding whether to trigger additional reward or penalty events, forming a complete condition-reward logic chain.
• [add_manpower](/wiki/effect/add_manpower): Both commonly appear together in military focus tree or decision rewards to replenish both manpower and experience simultaneously, enhancing the sense of military expansion.
• [add_tech_bonus](/wiki/effect/add_tech_bonus): In scenarios involving accelerated military technology research, distribute land army experience alongside tech bonuses so players can immediately invest the experience into researching new division templates for a smoother experience.
• [division_template](/wiki/effect/division_template): Define or unlock new division templates immediately after gaining experience—this is the most typical combined usage pattern in military mods.

Common Pitfalls

1. Misuse outside COUNTRY scope: army_experience only takes effect within a country scope. If written within a state or unit leader scope, the game will silently ignore it without throwing an error, but the effect simply won't trigger—an easy oversight during debugging.
2. Excessively large values breaking balance: Beginners often test with extremely large numbers, but land army experience has a practical upper limit in-game and affects AI division template upgrade pacing. Before publishing a mod officially, reference the experience reward magnitude from vanilla focuses to calibrate values and avoid disrupting game balance.