effect · `uncomplete_national_focus`

Definition

Supported scope:COUNTRY
Supported target:none

Description

uncompletes a focus for a country. If specified, the 'on_uncomplete' effect will be executed on each uncompleted focus.
Example: uncomplete_national_focus = {
	focus = GER_oppose_hitler
	uncomplete_children = yes # Optional. Default is no. If yes, all proceeding focuses will also be uncompleted if their prerequisite aren't met after the preceeding focuses are uncompleted.
	refund_political_power = no # Optional. Default is no. If yes, the country is refunded the political power invested in the current focus if it's canceled as a result of its prerequisites being uncompleted.
}

实战 · 配合 · 坑

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

实战用法

uncomplete_national_focus 常用于剧本重置类 mod，例如在玩家选择某个"历史回溯"选项或内战爆发后，需要将某国已完成的国策撤销，使其回到未解锁的状态。配合 uncomplete_children = yes 可以级联撤销后续依赖国策，适合大幅重置科技树走向或阵营路线。

# 某国家内战爆发，重置其工业化路线相关国策
option = {
    name = "重置工业化路线"
    uncomplete_national_focus = {
        focus = GER_four_year_plan
        uncomplete_children = yes
        refund_political_power = no
    }
    add_political_power = -50
}

配合关系

[has_completed_focus](/wiki/trigger/has_completed_focus)：在执行撤销前先用此触发器判断目标国策是否已完成，避免对未完成国策执行无效操作或引发逻辑错误。
[complete_national_focus](/wiki/effect/complete_national_focus)：与本命令形成互补，可在撤销旧路线后立即引导玩家/AI走向新路线，实现国策路线的"切换"效果。
[add_political_power](/wiki/effect/add_political_power)：若选择不自动退还政治点（refund_political_power = no），通常需要手动通过此命令对国家进行补偿或惩罚，保持游戏平衡。
[add_ideas](/wiki/effect/add_ideas)：撤销国策后，该国策带来的 idea 并不会自动移除，需配合此命令的逆操作（remove_ideas）手动清理相关加成，否则效果会残留。

常见坑

国策附带的 idea 不会自动消失：uncomplete_national_focus 仅将国策标记为未完成，但国策 on_complete 中通过 add_ideas 添加的 modifier 或 idea 并不会被自动撤销，需要在 on_uncomplete 块或手动脚本中明确移除，否则加成会永久残留在国家身上。
uncomplete_children 的前提判断依赖已撤销状态：启用 uncomplete_children = yes 时，子国策是否被连带撤销取决于其前提条件在父级被撤销后是否仍满足，若子国策有多条前提路径仍被满足，则不会被撤销——新手常误以为该参数会无条件级联移除所有后续国策。

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

uncomplete_national_focus is commonly used in scenario reset mods, such as when players select a "historical rollback" option or a civil war breaks out, requiring the completion status of a nation's focuses to be reverted to an unlocked state. Combined with uncomplete_children = yes, it can cascade-revert dependent focuses, making it suitable for major overhauls of tech tree progression or faction alignment routes.

# A nation's civil war breaks out, resetting its industrialization path focuses
option = {
    name = "Reset Industrialization Path"
    uncomplete_national_focus = {
        focus = GER_four_year_plan
        uncomplete_children = yes
        refund_political_power = no
    }
    add_political_power = -50
}

Synergy

[has_completed_focus](/wiki/trigger/has_completed_focus): Use this trigger before executing the revert to check whether the target focus is actually completed, preventing ineffective operations on incomplete focuses or logic errors.
[complete_national_focus](/wiki/effect/complete_national_focus): Forms a complementary pair with this command, allowing you to immediately guide the player/AI toward a new path after reverting the old route, achieving a "switch" effect for focus paths.
[add_political_power](/wiki/effect/add_political_power): If choosing not to automatically refund political power (refund_political_power = no), you typically need to manually compensate or penalize the nation through this command to maintain game balance.
[add_ideas](/wiki/effect/add_ideas): Reverting a focus does not automatically remove the ideas it grants. You must pair this with its inverse operation (remove_ideas) to manually clean up associated bonuses, or the effects will persist indefinitely.

Common Pitfalls

Ideas granted by focuses are not automatically removed: uncomplete_national_focus only marks a focus as incomplete, but modifiers or ideas added via add_ideas in the focus's on_complete block are not automatically reverted. They must be explicitly removed in an on_uncomplete block or through manual scripting, otherwise bonuses will permanently remain on the nation.
The prerequisite evaluation of uncomplete_children depends on the reverted state: When uncomplete_children = yes is enabled, whether child focuses are cascade-reverted depends on whether their prerequisites are still satisfied after the parent is reverted. If a child focus has multiple prerequisite paths that remain satisfied, it will not be reverted—beginners often mistakenly assume this parameter unconditionally cascade-removes all subsequent focuses.

effect · uncomplete_national_focus