Wiki

effect · transfer_state_to

Definition

  • Supported scope:STATE
  • Supported target:THIS

Description

Set owner and controller of a state to a given country
Example:\n"
USA {
	every_core_state = {
		transfer_state_to = JAM
	}
}

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

transfer_state_to is most commonly used in territorial reorganization events or upon focus tree completion, transferring both ownership and control of a region to a target nation. It's frequently employed when creating independence movements, puppet liberation, or post-war peace settlement mods to bulk transfer core provinces. The example below demonstrates transferring all of Poland's core states to the newly formed Polish regime upon focus completion:

POL = {
    every_core_state = {
        limit = {
            is_owned_by = GER
        }
        transfer_state_to = POL
    }
}

Synergy

  • [add_core_of](/wiki/effect/add_core_of) — Immediately add cores to the receiving nation after territorial transfer, preventing penalties from the "owned but without core" condition.
  • [set_state_controller_to](/wiki/effect/set_state_controller_to) — Use independently when only changing control without changing ownership; compare with transfer_state_to for fine-grained distinction between occupation and territorial assignment scenarios.
  • [is_owned_by](/wiki/trigger/is_owned_by) — Filter the current owner within a limit block to ensure transfer only triggers for states held by specific nations, preventing accidental operations on neutral or friendly territories.
  • [remove_core_of](/wiki/effect/remove_core_of) — Remove cores of the previous owner after transfer; using together can fully simulate complete territorial change of hands rather than mere handover.

Common Pitfalls

  1. Mistakenly assuming it only requires COUNTRY scope invocation: This effect must be executed within a STATE scope. Calling it directly under a country scope will cause errors or silent failure; you must first enter a specific state (e.g., via every_core_state, specific_state = X, etc.) before invoking it.
  2. Overlooking residual resistance and occupation law: transfer_state_to sets both owner and controller simultaneously, but does not automatically clear the previous occupation law or resistance values. Without pairing it with [set_occupation_law](/wiki/effect/set_occupation_law) or [set_resistance](/wiki/effect/set_resistance), the receiving nation may inherit abnormal occupation states.