Wiki

effect · change_division_template

Definition

  • Supported scope:(none)
  • Supported target:none

Description

change_division_template = "My Template Name"

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

change_division_template is commonly used in scripted events or decisions to switch a nation's division template name to a new one. For example, it can automatically upgrade outdated infantry divisions to motorized division templates after tech completion. It's also frequently seen in mods to trigger template changes for AI nations at specific historical points, simulating organizational reforms.

country_event = {
    id = my_mod.1
    title = "Army Reorganization Reform"
    option = {
        name = "Implement New Organization"
        change_division_template = "Elite Infantry Division"
    }
}

Synergy

Since this effect's scope whitelist currently contains no other cross-referenceable commands, no compatible entries can be listed. In actual development, this command typically requires safe usage by combining it with outer scope constraints and conditional checks. It is recommended to verify supported companion commands in the current game version on the official wiki before combining them.

Common Pitfalls

  1. Template name case and spacing must match exactly: The game performs case-sensitive and space-sensitive matching when identifying templates. If the provided string differs from the actual template name by even a single character, the effect will silently fail without error messages, making it difficult to detect.

  2. Unclear target scope: This command affects divisions within the current scope. If the scope is not correctly locked to the target unit, it may unexpectedly change unintended division templates. It is recommended to verify the effect line by line in the console during testing.