命令百科

trigger · has_faction_goal

Definition

  • Supported scope:COUNTRY
  • Supported target:any

Description

Checks if the country's faction has an active or completed goal

### Examples

TAG = { has_faction_goal = goal_id }

实战 · 配合 · 坑

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

实战用法

has_faction_goal 常用于派系机制 mod 中，判断某个派系目标是否已经激活或完成，从而触发后续奖励、解锁选项或叙事事件。例如在自定义派系目标完成后，给予成员国政治点数或解锁特殊决议：

# 当派系已激活或完成某个目标时，才让该决议可用
available = {
    has_faction_goal = faction_goal_naval_supremacy
}

配合关系

  • [has_completed_faction_goal](/wiki/trigger/has_completed_faction_goal)：has_faction_goal 检查目标是否处于激活或完成状态，而此 trigger 专门判断目标是否已完成，两者搭配可区分"进行中"与"已完成"两个阶段的逻辑分支。
  • [add_faction_goal](/wiki/effect/add_faction_goal)：通常先用该 effect 向派系添加目标，再用 has_faction_goal 作为后续条件检查，形成"添加→检测"的完整流程。
  • [faction_goal_fulfillment](/wiki/trigger/faction_goal_fulfillment)：配合使用可在目标存在的前提下，进一步量化目标的完成进度，用于阶段性奖励判断。
  • [add_political_power](/wiki/effect/add_political_power)：常见的"目标达成后发放奖励"模式，在 has_faction_goal 确认目标存在后，通过此 effect 给予对应国家激励。

常见坑

  1. 混淆激活与完成状态：has_faction_goal 在目标激活中和已完成时均返回真，若只想判断已完成的情况（例如发放最终奖励），应改用 has_completed_faction_goal，否则奖励可能在目标刚激活时就被错误触发。
  2. 目标 ID 拼写错误导致永远为假：goal_id 必须与 add_faction_goal 或派系目标定义文件中的 key 完全一致（区分大小写），写错 ID 不会报错但条件永远不满足，排查时需仔细核对 common/faction_goals/ 下的定义文件。