effect · effect_tooltip

实战用法

effect_tooltip 用于在不真正执行效果的情况下，将某段效果的提示文本展示给玩家，常见于需要向玩家预告某个选项将来可能触发的结果、或者在 hidden_effect 外层补充说明文字。例如，在事件选项中，你已经把真正的效果写在 hidden_effect 里，但仍希望玩家在选项界面看到完整的说明，就可以用它来"假装"展示那段效果的 tooltip。

option = {
    name = my_event.1.a
    hidden_effect = {
        # 真正执行的复杂逻辑放这里，不会直接显示给玩家
        add_victory_points = { province = 3 value = 5 }
    }
    # 只展示 tooltip，不重复执行效果
    effect_tooltip = {
        add_victory_points = { province = 3 value = 5 }
    }
}

配合关系

• [hidden_effect](/wiki/effect/hidden_effect)：最典型的搭档——将实际执行逻辑藏进 hidden_effect，再用 effect_tooltip 在外层补回可见的 tooltip，避免效果被展示两次或逻辑暴露给玩家。
• [custom_effect_tooltip](/wiki/effect/custom_effect_tooltip)：当 effect_tooltip 展示的内容仍不够直观时，可额外用 custom_effect_tooltip 配合本地化字符串提供更友好的说明文字。
• [if](/wiki/effect/if)：在条件分支中，若某分支的效果只想在满足条件时才提示（而非执行），可将 effect_tooltip 嵌套在 if 块内，实现"条件性 tooltip"。

常见坑

1. 误以为它会真正执行效果：effect_tooltip 只渲染 tooltip 文字，不会对游戏状态产生任何实际改变。新手常在 hidden_effect 外同时写了 effect_tooltip 又漏掉 hidden_effect，导致效果根本没有执行，只是看起来"好像发生了"。
2. 与 custom_effect_tooltip 混用导致重复描述：若已经用 custom_effect_tooltip 写了自定义说明，再套一层 effect_tooltip 展示同样的内容，玩家会在 UI 中看到重复的两段 tooltip，需要仔细规划哪种方式负责最终展示。