Wiki

effect · remove_faction_goal

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Remove a goal from the current's country faction.

### Examples

TAG = { remove_faction_goal = 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

remove_faction_goal is commonly used in faction mechanics mods to remove faction goals from a country's active goal list when objectives are completed, expired, or abandoned by the player/AI through specific decisions, keeping the faction goal pool clean and functional. For example, in a faction cooperation event, selecting an option revokes a previously added expansion objective:

# Remove the corresponding faction goal when this nation withdraws from the offensive plan
GER = {
    remove_faction_goal = faction_goal_expand_east
}

Synergy

  • [add_faction_goal](/wiki/effect/add_faction_goal): Typically appears in pairs—use add_faction_goal to add a goal first, then call remove_faction_goal when conditions are no longer met, forming a complete goal lifecycle management system.
  • [has_completed_faction_goal](/wiki/trigger/has_completed_faction_goal): Before removal, use this trigger to verify whether the goal is already completed, preventing accidental removal of still-valid unfinished goals that would cause logic conflicts.
  • [faction_goal_fulfillment](/wiki/trigger/faction_goal_fulfillment): Assess the current goal completion percentage and decide whether to abandon a low-completion goal by comparing against numerical thresholds before invoking the removal command.
  • [add_faction_goal_slot](/wiki/effect/add_faction_goal_slot): After removing old goals, frequently follow up by expanding goal slots or adding new goals to maintain faction goal counts within design specifications.

Common Pitfalls

  1. Typos in goal ID or unregistered goals: The faction_goal_id must match exactly the goal string defined and added in add_faction_goal. Misspelling the ID causes silent failure—the script won't error but produces no effect and the goal persists, making it extremely difficult to debug.
  2. Executing on non-faction-leader nations: This effect operates at the scoped nation level. If that nation is not the faction leader or doesn't currently hold the specified goal, execution silently fails. Verify goal ownership with relevant triggers before executing removal rather than blindly calling it on all member nations.