Wiki

effect · set_faction_manifest

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Changes current country's faction manifest, the previous manifest is removed.

### Examples

TAG = { set_faction_manifest = faction_goal_id }

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

set_faction_manifest is used to dynamically switch a nation's faction "ideology goals" in mods, commonly employed when scripted events trigger a major power to shift its factional strategic direction—for example, reestablishing ideological bloc objectives after a civil war concludes. Note that each call removes the previous manifest and replaces it with the new one, making it suitable for use within option blocks or hidden_effect paired with diplomatic events.

# A nation switches its faction manifest after focus completion
focus = {
    id = GER_new_order
    ...
    completion_reward = {
        GER = {
            set_faction_manifest = faction_goal_new_order
        }
    }
}

Synergy

  • [add_faction_goal](/wiki/effect/add_faction_goal): After setting a manifest, typically you must synchronously add concrete objective slots to the faction; manifests and goals synergize to drive AI behavior.
  • [add_faction_goal_slot](/wiki/effect/add_faction_goal_slot): Opens additional objective slots for the new manifest, used together to prevent faction goal capacity shortages.
  • [faction_manifest_fulfillment](/wiki/trigger/faction_manifest_fulfillment): Checks the fulfillment progress of the current manifest, useful in event or decision conditions to determine whether it is time to switch manifests again.
  • [has_completed_faction_goal](/wiki/trigger/has_completed_faction_goal): Verifies whether goals under the old manifest have been completed, ensuring the timing logic for switching manifests is sound.

Common Pitfalls

  1. Using directly outside COUNTRY scope: This effect only works within nation scope; if mistakenly placed in STATE or CHARACTER scope it will not error but silently fail, so always confirm the scope of the execution block.
  2. Switching manifest without pre-creating a faction: If the target nation does not currently belong to any faction, switching the manifest may fail or produce unexpected behavior; ensure the nation has already established a faction via [create_faction](/wiki/effect/create_faction) or [create_faction_from_template](/wiki/effect/create_faction_from_template) first.