Wiki

trigger · has_completed_track

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Checks if the given subdoctrine track has been completed

	### Examples
	```
	TAG = {
		has_completed_track = infantry
	}
	```

实战 · 配合 · 坑

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

实战用法

has_completed_track 常用于需要判断某条主义/教条分支是否已全部研究完毕的场景,例如在国策、决议或事件中根据玩家的教条研究进度解锁特殊奖励或触发剧情分支。典型场景包括:当某国完成特定装甲教条分支后才允许触发精英装甲师编制决议,或在顾问效果中检测教条完成度以给予额外加成。

# 当本国完成 infantry 分支后,允许激活一个特殊决议
available = {
    has_completed_track = infantry
}

配合关系

  • [has_completed_subdoctrine](/wiki/trigger/has_completed_subdoctrine):两者同属教条检测类 trigger,has_completed_subdoctrine 检查单个子教条节点是否研究,而 has_completed_track 检查整条分支,常组合使用以区分"部分完成"与"全部完成"的不同奖励门槛。
  • [add_doctrine_cost_reduction](/wiki/effect/add_doctrine_cost_reduction):在确认玩家已完成某条分支后,通过该 effect 给予后续教条研究折扣,形成"越深入研究越有优势"的激励链。
  • [has_doctrine](/wiki/trigger/has_doctrine):在检测分支完成前,通常先用 has_doctrine 确认某个具体教条节点已解锁,两者配合可构建更精细的多级条件判断。
  • [add_tech_bonus](/wiki/effect/add_tech_bonus):完成整条教条分支后通过该 effect 推送下一个研究方向的加速,常见于国策完成奖励或事件效果块中。

常见坑

  1. 误将装备/科技 tag 填入:该 trigger 的值应为教条分支名称(如 infantryarmor 等子教条 track 的标识符),而非科技树中的普通研究 key,填错不会报错但条件永远不会为真,难以排查。
  2. Scope 使用错误:该 trigger 只能在 COUNTRY scope 下使用,若写在 STATE 或 CHARACTER scope 内(例如不小心放进了 every_owned_state 的子块中)将无法正常求值,需确保外层 scope 指向的是国家。

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

has_completed_track is commonly used in scenarios where you need to check whether a specific ideology/doctrine branch has been fully researched. It's typically found in national focuses, decisions, or events where special rewards or story branches are unlocked based on the player's doctrine research progress. Common use cases include triggering an elite armor division organization decision only after a nation completes a specific armor doctrine branch, or checking doctrine completion in advisor effects to grant additional bonuses.

# Allow activating a special decision after this nation completes the infantry branch
available = {
    has_completed_track = infantry
}

Synergy

  • [has_completed_subdoctrine](/wiki/trigger/has_completed_subdoctrine): Both belong to the doctrine-checking trigger family. has_completed_subdoctrine checks whether a single sub-doctrine node is researched, while has_completed_track checks an entire branch. They are often combined to distinguish between different reward thresholds for "partially completed" versus "fully completed" states.
  • [add_doctrine_cost_reduction](/wiki/effect/add_doctrine_cost_reduction): After confirming the player has completed a branch, use this effect to grant subsequent doctrine research discounts, creating an incentive chain of "the deeper you research, the greater your advantage."
  • [has_doctrine](/wiki/trigger/has_doctrine): Before checking branch completion, it's common to first use has_doctrine to verify that a specific doctrine node is unlocked. The two can be paired to construct more granular multi-level conditional logic.
  • [add_tech_bonus](/wiki/effect/add_tech_bonus): After completing an entire doctrine branch, use this effect to accelerate research in the next direction, commonly seen in national focus completion rewards or event effect blocks.

Common Pitfalls

  1. Accidentally inserting equipment/technology tags: The value for this trigger should be a doctrine branch name (such as identifiers like infantry, armor, etc. from sub-doctrine tracks), not regular research keys from the technology tree. Entering the wrong value won't cause an error but the condition will never evaluate to true, making it difficult to debug.
  2. Incorrect scope usage: This trigger only works in COUNTRY scope. If written within STATE or CHARACTER scope (for example, accidentally placed inside a every_owned_state sub-block), it will fail to evaluate properly. Always ensure the outer scope points to a nation.