命令百科

effect · show_unit_leaders_tooltip

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

show unit leader's name

实战 · 配合 · 坑

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

实战用法

show_unit_leaders_tooltip 常用于自定义事件或决策的 tooltip 展示中，当玩家需要直观了解某国当前指挥官列表时触发，例如在一个"检阅部队"类型的决策 option 里调用它来显示该国所有单位领袖的名字。它本质上是一个纯展示性 effect，不改变任何游戏状态，仅用于 UI 信息反馈。

country_event = {
    id = my_mod.1
    title = my_mod.1.t
    desc = my_mod.1.d

    option = {
        name = my_mod.1.a
        # 向玩家展示本国的单位领袖名单
        show_unit_leaders_tooltip = yes
    }
}

配合关系

  • [every_unit_leader](/wiki/effect/every_unit_leader)：在用 every_unit_leader 批量操作指挥官（如添加特性）之后，紧接着调用本 effect 可以让玩家立即看到被影响的领袖列表，形成操作+反馈的完整流程。
  • [add_trait](/wiki/effect/add_trait)：为单位领袖添加特质后，配合本 effect 向玩家直观展示谁获得了改变，增强可读性。
  • [character_list_tooltip](/wiki/effect/character_list_tooltip)：两者都是纯展示类 effect，可搭配使用以同时呈现角色列表和单位领袖名单，提供更全面的 tooltip 信息。
  • [any_unit_leader](/wiki/trigger/any_unit_leader)：在触发条件中用 any_unit_leader 判断是否存在符合条件的领袖，满足条件后再调用本 effect 展示，避免在无领袖时显示空白 tooltip。

常见坑

  1. 误当功能性 effect 使用：新手容易以为该 effect 会"召唤"或"创建"领袖，实际上它仅渲染 tooltip 文字，不会对任何游戏数据产生修改，若放在 hidden_effect 中调用则完全没有意义，因为隐藏块里的 tooltip 展示根本不会显示给玩家。
  2. Scope 混用：该 effect 只能在 COUNTRY scope 下调用，若在 STATE 或 CHARACTER scope 内使用会导致脚本报错或静默失效，需要确保执行块处于正确的国家 scope 中。