命令百科

effect · unlock_decision_category_tooltip

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

localizes name of category and displays tooltip that shows it will be unlocked

实战 · 配合 · 坑

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

实战用法

unlock_decision_category_tooltip 主要用在国策或决策的 complete_effect / option 块中，当你想在执行逻辑的同时向玩家显示即将解锁某个决策类别的提示文本，而不是静默地解锁。例如在某科技树国策完成后，向玩家明确展示"某外交行动类别将被解锁"的本地化名称与说明：

complete_effect = {
    # 实际解锁逻辑由其他 effect 完成
    # 此处仅显示解锁提示 tooltip
    unlock_decision_category_tooltip = {
        decision_category = my_mod_diplomacy_category
    }
    add_political_power = 50
}

配合关系

  • [has_decision](/wiki/trigger/has_decision)：常用于 available 或 visible 条件检查，确认当前某决策状态后再触发 tooltip 展示，避免在不合适的时机显示提示。
  • [activate_decision](/wiki/effect/activate_decision)：与 tooltip 效果互补——activate_decision 负责真正激活决策，而 unlock_decision_category_tooltip 仅提供玩家可见的 UI 反馈，两者配合实现"展示 + 执行"的完整流程。
  • [activate_mission_tooltip](/wiki/effect/activate_mission_tooltip)：同为纯 tooltip 类效果，常在同一 option 块中并列使用，统一向玩家展示多个即将发生的变化，保持 UI 提示风格一致。
  • [add_political_power](/wiki/effect/add_political_power)：典型的"实质性效果 + tooltip 提示"组合，在给予实际奖励的同时用 tooltip 向玩家说明后续决策类别的解锁情况。

常见坑

  1. 误以为该 effect 会真正解锁决策类别：此命令仅负责显示本地化名称和 tooltip，不会改变任何游戏状态，必须配合实际控制决策可见/可用的条件逻辑（如 visible/available 块中的 flag 或 trigger）才能完成真正的"解锁"，单独使用不会有任何功能性效果。
  2. 引用了不存在的 decision_category 键：如果填写的决策类别 ID 在 common/decision_categories/ 中未定义，游戏不会报错崩溃，但 tooltip 会显示为空字符串或本地化缺失的 key，导致玩家看到乱码提示，需确保 category ID 与文件定义完全一致。