effect · promote_officer_to_general

Hands-On Usage

promote_officer_to_general is commonly used in events or decision chains to automatically promote a division's commander to general rank, making it ideal for "rise of legendary generals" or campaign reward mod scenarios. For example, after a major victory event triggers, you can promote your elite division commander directly to general:

country_event = {
    id = my_mod.1
    # ...
    option = {
        name = my_mod.1.a
        # Current scope is the division scope
        promote_officer_to_general = yes
    }
}

Synergy

Since the current scope whitelist contains no equivalent-level effect or trigger commands, no useful cross-references can be listed. It is recommended to verify in the outer logic before calling this effect that the target division exists and has an assigned officer, to avoid silent failures.

Common Pitfalls

1. Incorrect scope object: This effect must be executed within the correct division scope. If written directly in a country scope or character scope, the promotion will not take effect and no error will be reported—this is the hardest silent issue to debug.
2. Calling when division has no officer: If the target division currently has no assigned officer (commander slot is empty), executing this command will have no effect. New modders often mistake this for a script syntax error, when in reality you need to ensure the division has an officer assigned beforehand.