effect · destroy_unit

实战用法

destroy_unit 用于在特定事件或决议触发时将当前作用域内的单位彻底移除，常见于剧本事件（如内战结束后解散叛军部队）或任务链中清理临时生成的测试部队。需注意该 effect 直接作用于已进入 unit scope 的单位对象，通常配合 unit 范围迭代使用。

# 事件触发：内战结束，销毁所有叛军单位
country_event = {
    id = civil_war.5
    ...
    option = {
        name = civil_war.5.a
        # 遍历敌方阵营单位并逐一销毁
        enemy_country = {
            every_unit = {
                destroy_unit = yes
            }
        }
    }
}

配合关系

由于当前白名单中同 scope 下无其他可交叉引用的 effect 或 trigger 命令，暂无可列出的白名单内配合命令。实际开发中该指令通常依赖游戏原生的 every_unit 等迭代块来确定作用范围，但这些不在本次提供的白名单之内，请参阅官方 Wiki 获取完整列表。

常见坑

1. scope 指向错误：新手常在 country scope 下直接写 destroy_unit = yes，而非先进入具体的 unit scope（如通过 every_unit 迭代），导致脚本报错或无效果，务必确认当前 scope 已经是目标单位本身。
2. 误以为可以撤销：destroy_unit 是永久销毁，无法像转移部队一样保留单位数据，若只是想让部队暂时消失或转移控制权，应考虑其他手段而非此指令，否则部队数据将彻底丢失。