命令百科

effect · change_tag_from

Definition

  • Supported scope:any
  • Supported target:THIS, ROOT, PREV, FROM, OWNER, CONTROLLER, OCCUPIED, CAPITAL

Description

Changes player to other country

实战 · 配合 · 坑

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

实战用法

change_tag_from 常用于剧本事件中实现"玩家视角跳转"，例如在傀儡国建立后让玩家无缝切换到新成立的国家，或在分裂剧情中将操控权转移给分裂出的政权。以下示例演示在事件 option 中将玩家从当前国切换到目标国：

# 在某个 country_event 的 option 中
option = {
    name = my_event.1.a
    # 先执行其他状态变更...
    change_tag_from = ROOT   # 将"曾经控制 ROOT 的玩家"切换为控制当前 scope 国家
}

配合关系

  • [hidden_effect](/wiki/effect/hidden_effect)：通常将 change_tag_from 包裹在 hidden_effect 中，避免触发多余的界面提示，使切换过程更流畅。
  • [save_global_event_target_as](/wiki/effect/save_global_event_target_as)：切换前将原国家保存为全局事件目标，方便切换后继续对旧国家执行后续 effect。
  • [custom_effect_tooltip](/wiki/effect/custom_effect_tooltip)：由于切换行为对玩家不够直观，配合此命令在 UI 上给出友好的提示说明。
  • [country_exists](/wiki/trigger/country_exists)：在执行切换前用此 trigger 校验目标国是否存在，防止因目标国尚未创建而导致脚本报错或逻辑失效。

常见坑

  1. scope 方向搞反：change_tag_from 的语义是"把原本控制 <target> 所指国家的玩家，转移来控制当前 scope 国家"，而非"把当前 scope 玩家转移到 target"。新手容易将 scope 与 target 对调，导致切换目标完全相反。
  2. 在 AI 国家 scope 下调用：若当前 scope 所在国家没有人类玩家控制，效果会静默失败，不会有任何报错，极难排查——务必在调用前确认 scope 国家确实处于玩家控制之下，或配合条件判断加以保护。