命令百科

effect · reset_province_name

Definition

  • Supported scope:any
  • Supported target:none

Description

reset name of a province back to localization one.

实战 · 配合 · 坑

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

实战用法

reset_province_name 常用于动态地名 mod 中，当某个国家失去省份控制权、或特定事件结束后，需要将之前通过 set_province_name 自定义的省份名称恢复为本地化文件中的默认名称。例如在一场战争结束的事件选项中恢复被占领省份的名称：

# 在战争结束事件的 option 块中，恢复某省份原始名称
option = {
    name = my_event.1.a
    # 假设当前 scope 已通过触发切换到目标省份
    reset_province_name = yes
}

配合关系

  • [set_province_name](/wiki/effect/set_province_name) — 与 reset_province_name 形成"设置 / 还原"的完整生命周期，先用它设置自定义名称，再用 reset_province_name 在适当时机撤销。
  • [if](/wiki/effect/if) — 通常需要在条件分支内判断当前是否满足恢复名称的条件（如占领国变更、事件标记等），避免无条件重置造成逻辑混乱。
  • [set_global_flag](/wiki/effect/set_global_flag) / [has_global_flag](/wiki/trigger/has_global_flag) — 配合全局标记记录"是否已自定义地名"的状态，在 trigger 侧检测后再决定是否执行重置，防止重复或遗漏调用。
  • [hidden_effect](/wiki/effect/hidden_effect) — 将 reset_province_name 包裹在隐藏效果块中，避免在事件日志或工具提示中显示无意义的地名还原信息，保持 UI 整洁。

常见坑

  1. Scope 指向错误：reset_province_name 作用于省份 scope 而非州（state）scope，新手常在 state scope 下直接调用，导致脚本无效或报错，需要先通过迭代或事件目标正确切换到具体省份。
  2. 遗漏恢复时机：在 mod 中用 set_province_name 设置了自定义名称后，若没有在对应的"撤销事件"或权力移交逻辑中调用 reset_province_name，自定义名称会永久残留，即使换了控制国也不会自动恢复。