Wiki

effect · unlock_mio_policy_tooltip

Definition

  • Supported scope:any
  • Supported target:none

Description

Display a tooltip saying the MIO policy is made available (aka unlocked).
ex:
unlock_mio_policy_tooltip = my_policy_token
unlock_mio_policy_tooltip = {
	policy = my_policy_token
	show_modifiers = no # show bonuses in tooltip - optional, default = yes
}

Hands-On Notes

Hands-on notes are AI-generated and checked against the vanilla command vocabulary — treat them as a starting point, not authoritative reference. The definition above is the game's own documentation.

Hands-On Usage

unlock_mio_policy_tooltip is primarily used within focus, decision, or event option blocks to display a tooltip indicating "a certain MIO policy is about to be unlocked," allowing players to understand the forthcoming changes before clicking. When separated from the actual unlock effect (for example, when the real unlock is written inside hidden_effect), this command can handle the UI feedback layer independently, maintaining a decoupled design between visual hints and logical execution.

option = {
    name = my_event.option.a
    # Display tooltip only, does not execute actual unlock
    unlock_mio_policy_tooltip = {
        policy = mio_policy_advanced_production
        show_modifiers = yes
    }
    # Actual unlock logic is placed elsewhere or triggered by hidden_effect
    hidden_effect = {
        # True unlock effect
    }
}

Synergy

  • [custom_effect_tooltip](/wiki/effect/custom_effect_tooltip): When additional custom explanatory text needs to be appended within the same UI block, use this command alongside the policy tooltip to form a complete "policy unlock + additional explanation" composite tooltip.
  • [hidden_effect](/wiki/effect/hidden_effect): Conceal actual gameplay state changes (such as calling the real unlock function) within hidden_effect, while using this command alone to control the player-visible tooltip, achieving a separation between hint and execution.
  • [effect_tooltip](/wiki/effect/effect_tooltip): If other effects requiring advance notice exist within the same option block, effect_tooltip can work in tandem with this command to construct a complete "advance notice tooltip" layer.

Common Pitfalls

  1. Mistaking this command for actually unlocking the policy: unlock_mio_policy_tooltip only handles displaying the hint text and produces no actual impact on game state; forgetting to call the true unlock effect in the logic block will result in the contradictory phenomenon where the interface shows "unlocked" but the policy is actually unavailable.
  2. Misunderstanding when the show_modifiers field is absent: This field defaults to yes; if the policy's modifiers are not yet fully populated or values are still under testing, the tooltip will directly expose blank or incorrect modifier values to the player. You should temporarily set show_modifiers = no during the debugging phase to avoid misleading players.