命令百科

effect · hidden_effect

Definition

  • Supported scope:any
  • Supported target:none

Description

Effect not shown in tooltips

实战 · 配合 · 坑

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

实战用法

hidden_effect 常用于在事件或决策触发时悄悄修改游戏状态，而不让玩家在 tooltip 中看到"幕后操作"，例如设置追踪用的全局变量、标记任务完成状态或给 AI 国家静默执行补偿逻辑。典型场景是在玩家触发某个事件选项时，同时在后台记录数据或调整 AI 行为，保持界面干净不暴露实现细节。

# 在事件选项中，显示给玩家看的效果正常写，额外的追踪逻辑藏进 hidden_effect
option = {
    name = my_event.1.a
    add_political_power = 50        # 玩家可见
    hidden_effect = {
        set_global_flag = my_mod_event_1_taken   # 玩家不可见
        set_variable = { my_mod_tracker = 1 }
    }
}

配合关系

  • [set_global_flag](/wiki/effect/set_global_flag) / [clr_global_flag](/wiki/effect/clr_global_flag)：最常见搭档，在 hidden_effect 中悄悄设置或清除全局标记，用于后续 trigger 判断而不污染 tooltip。
  • [set_variable](/wiki/effect/set_variable) / [add_to_variable](/wiki/effect/add_to_variable)：在不影响玩家阅读性的前提下维护数值型变量，适合积分系统或进度追踪。
  • [save_global_event_target_as](/wiki/effect/save_global_event_target_as)：在背景中静默绑定事件目标，避免 target 指定信息出现在 tooltip 里干扰玩家理解。
  • [custom_effect_tooltip](/wiki/effect/custom_effect_tooltip)：与 hidden_effect 形成互补——真实逻辑放进 hidden_effect 隐藏，再用 custom_effect_tooltip 在外部展示一条人工撰写的友好说明。

常见坑

  1. 把需要向玩家展示的核心效果也塞进去：hidden_effect 内的所有内容对玩家完全不可见，若把重要的政治力、科技等奖励写在里面，玩家在 tooltip 预览时看不到任何提示，会造成体验混乱甚至被误认为 bug。
  2. 在 hidden_effect 内再套 hidden_effect：嵌套毫无意义，内层块的行为与外层完全一致，只会增加代码冗余和阅读负担，应当将所有需要隐藏的指令平铺在同一个 hidden_effect 块中。