命令百科

effect · unlock_mio_trait_tooltip

Definition

  • Supported scope:INDUSTRIAL_ORG
  • Supported target:none

Description

Display a tooltip saying the trait is made available (aka unlocked).
ex:
mio:my_mio = {
  unlock_mio_trait_tooltip = trait
  unlock_mio_trait_tooltip = {
	trait = my_trait_token
	show_modifiers = no # Optional, default = yes
  }
}

实战 · 配合 · 坑

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

实战用法

unlock_mio_trait_tooltip 常用于 MIO（军事工业组织）的 trait 解锁逻辑中，当你希望在某个 effect 块里仅展示提示信息而不真正执行解锁时使用，典型场景是在 custom_effect_tooltip 替代方案或 focus/decision 的预览阶段让玩家看到"此特性将被解锁"的提示。例如在国策完成时，搭配实际执行命令一起写：

# 在 focus complete_effect 中
mio:my_country_mio = {
    unlock_mio_trait_tooltip = {
        trait = advanced_assembly_line
        show_modifiers = no
    }
    complete_mio_trait = advanced_assembly_line
}

配合关系

  • [complete_mio_trait](/wiki/effect/complete_mio_trait)：最直接的搭档——tooltip 负责向玩家展示"即将解锁"的说明，complete_mio_trait 负责真正执行解锁，两者通常成对出现。
  • [is_mio_trait_available](/wiki/trigger/is_mio_trait_available)：在执行前用该 trigger 判断特性是否已处于可用状态，避免重复触发或逻辑冲突，tooltip 的显示也更准确。
  • [is_mio_trait_completed](/wiki/trigger/is_mio_trait_completed)：用于条件门控，确保 tooltip 只在特性尚未完成时显示，防止向玩家展示已解锁特性的冗余提示。
  • [add_mio_research_bonus](/wiki/effect/add_mio_research_bonus)：常见组合场景是同一个 focus 或 decision 既解锁特性又给予研究加成，tooltip 与此命令并列出现以完整呈现该决策的所有收益。

常见坑

  1. 误以为该命令会真正解锁特性：unlock_mio_trait_tooltip 仅生成 UI 提示，不改变任何游戏状态。新手常忘记同时写 complete_mio_trait，结果国策完成后玩家界面显示特性已解锁，实际 MIO 面板中却没有任何变化。
  2. 在非 INDUSTRIAL_ORG scope 下调用：该命令必须在 mio:xxx = { } 块内使用，若直接写在国家 scope 的 effect 块中会导致脚本报错或静默失效，需确保已通过 mio: 前缀正确切换到目标 MIO 的 scope。