Wiki

effect · add_faction_goal_slot

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Adds extra goal slots to the faction for a specific category

	### Examples
	```
	add_faction_goal_slot = {
		category = medium_term # options: short_term, medium_term, long_term
		value = 1
	}
	```

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

When working with faction system-related mods and you want to provide players or a specific nation more strategic planning space for faction objectives, you can use this effect to dynamically expand the objective slots for particular categories. For example, after completing a focus tree, you might reward the faction leader by allowing them to define more strategies in the medium-term objectives section:

focus = {
    id = expand_faction_agenda
    # ...
    completion_reward = {
        add_faction_goal_slot = {
            category = medium_term
            value = 1
        }
    }
}

Synergy

  • [add_faction_goal](/wiki/effect/add_faction_goal): Typically used first to add specific objective content to a faction, then use add_faction_goal_slot to expand slot capacity. Both must work together for new objectives to display and function properly.
  • [faction_goal_fulfillment](/wiki/trigger/faction_goal_fulfillment): Can be used in condition checks to evaluate the completion progress of existing objectives, triggering additional slot unlocks based on completion status, creating a "completion-as-reward" feedback loop.
  • [has_completed_faction_goal](/wiki/trigger/has_completed_faction_goal): Used to verify whether a specific objective has been completed, serving as a prerequisite condition for adding new slots, preventing slot spam before objectives are actually fulfilled.
  • [add_faction_initiative](/wiki/effect/add_faction_initiative): Distribute alongside slot expansion within the same reward block to strengthen faction operational capacity from both "quantity" and "action power" dimensions.

Common Pitfalls

  1. Typos in the category field value: The category field only accepts three fixed values: short_term, medium_term, and long_term. Misspellings (such as midterm or mid_term) will not trigger errors but the effect won't take effect—newcomers often overlook the underscore formatting.
  2. Calling on a non-faction leader nation: Although this effect's scope is COUNTRY, if that nation is not currently a member or leader of any faction, the expanded slots may be meaningless or fail silently. Before using, verify faction status with [has_completed_faction_goal](/wiki/trigger/has_completed_faction_goal) or similar conditions.