effect · set_state_name

实战用法

set_state_name 常用于动态叙事类 mod，例如在事件触发后将某个州的名称改为历史上曾用的地名，或在占领/解放剧本中赋予新政权自定义的行政区划名称。配合 state_event 可在故事线推进时即时呈现命名变化，增强沉浸感。

# 事件选项中将某州重命名
option = {
    name = my_event.1.a
    set_state_name = "新共和国特区"
}

配合关系

• [reset_state_name](/wiki/effect/reset_state_name)：当命名任务完成或条件撤销时用于恢复默认名称，是 set_state_name 的逆操作，二者成对使用保证名称生命周期完整。
• [set_state_flag](/wiki/effect/set_state_flag) / [has_state_flag](/wiki/trigger/has_state_flag)：先用 flag 记录"已重命名"状态，再用 trigger 防止重复触发，避免同一州被多次覆盖命名。
• [set_state_owner_to](/wiki/effect/set_state_owner_to)：占领剧本中往往同时更换州的所有者并赋予新名称，两条命令通常写在同一 option 或 hidden_effect 块内。
• [state_event](/wiki/effect/state_event)：在完成重命名后立即触发后续事件，形成"改名 → 弹窗通知"的完整叙事链。

常见坑

1. Scope 错误：set_state_name 必须在 STATE scope 下执行。新手常在 COUNTRY scope 中直接调用而不先切换到具体州，导致脚本报错或静默失效；正确做法是先用 <state_id> = { set_state_name = "..." } 明确进入州 scope。
2. 本地化缺失误解：该命令接受的是一个直接字符串而非本地化键名，填入本地化键名（如 MY_STATE_NAME）不会自动转译，游戏会原样显示键名字符串；若需要多语言支持，需要配合其他文本替换手段或确认引擎版本的实际行为后再决策。