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
	}
	```

实战 · 配合 · 坑

实战内容由 AI 生成,并已对照 vanilla 命令词表校验 —— 请当作起点而非权威依据。上方的定义节才是游戏自带文档原文。

实战用法

在派系系统相关的 mod 中,当你希望为玩家或某个国家的派系增加更多目标规划空间时,可以使用此 effect 动态扩展特定类别的目标槽位。例如在某个国策完成后奖励派系领袖,使其能够在中期目标栏位中制定更多战略:

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

配合关系

  • [add_faction_goal](/wiki/effect/add_faction_goal):通常先用此命令为派系添加具体目标内容,再用 add_faction_goal_slot 扩展槽位容量,两者配合才能让新目标有效落地显示。
  • [faction_goal_fulfillment](/wiki/trigger/faction_goal_fulfillment):可在条件检测中判断现有目标的完成度,根据完成情况触发是否解锁额外槽位,形成"完成即奖励"的循环逻辑。
  • [has_completed_faction_goal](/wiki/trigger/has_completed_faction_goal):用于检测某个目标是否已经完成,以此作为增加新槽位的前置条件,避免在目标未消化时滥发槽位。
  • [add_faction_initiative](/wiki/effect/add_faction_initiative):在同一奖励块中与槽位扩展一起发放,从"数量"和"行动力"两个维度共同强化派系的运作能力。

常见坑

  1. category 字段值拼写错误category 只接受 short_termmedium_termlong_term 三个固定值,若拼错(如写成 midtermmid_term)游戏不会报错但效果不会生效,新手容易忽略下划线格式。
  2. 在非派系领袖国家调用:此 effect 的 scope 为 COUNTRY,但若该国当前不是任何派系的成员或领袖,扩展的槽位可能没有意义甚至静默失效,使用前应用 [has_completed_faction_goal](/wiki/trigger/has_completed_faction_goal) 或类似条件先确认派系状态。

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.