effect · set_cosmetic_tag

实战用法

set_cosmetic_tag 常用于国家改名、改旗、改国歌等视觉变化场景，例如内战结束后让胜利方切换为特定的 cosmetic tag，或者在走某条国策线后让国家以不同的名称与旗帜示人，而不改变其实际 TAG（不影响条约、外交关系等底层数据）。

# 国策完成后，苏联切换为"苏维埃帝国"的外观标签
focus = {
    id = SOV_soviet_empire
    ...
    completion_reward = {
        set_cosmetic_tag = SOV_EMPIRE
    }
}

配合关系

• [drop_cosmetic_tag](/wiki/effect/drop_cosmetic_tag) — 与之相对，用于移除当前 cosmetic tag，恢复默认外观；常在特定条件失效或内战重置时配合使用。
• [has_cosmetic_tag](/wiki/trigger/has_cosmetic_tag) — 在触发器中检测当前是否处于某个 cosmetic tag，避免重复设置或用于条件分支判断。
• [add_ideas](/wiki/effect/add_ideas) — 切换外观标签通常伴随着意识形态或政策的变化，两者搭配可让视觉与实际效果同步呈现。
• [complete_national_focus](/wiki/effect/complete_national_focus) — 部分 mod 在脚本触发完成国策时，同步调用 set_cosmetic_tag 保证外观与剧情进展一致。

常见坑

1. cosmetic tag 必须在 common/cosmetic_tags/ 中预先定义，否则游戏会静默忽略或报错——新手常直接写一个不存在的 tag 名，导致外观没有任何变化却不报任何提示。
2. 重复调用不会"叠加"，后一次调用会直接覆盖前一次；如果多条事件链都可能修改同一国家的 cosmetic tag，需要用 [has_cosmetic_tag](/wiki/trigger/has_cosmetic_tag) 做好判断，避免意外覆盖掉预期的外观。