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
- 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.
- 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.