Hands-On Usage
unlock_mio_trait_tooltip is commonly used in MIO (Military Industrial Organization) trait unlock logic when you want to display tooltip information only within an effect block without actually executing the unlock. Typical scenarios include preview stages in custom_effect_tooltip alternatives or focus/decision windows where you want players to see the "this trait will be unlocked" notification. For example, when completing a focus, write it together with the actual execution command:
# In focus complete_effect
mio:my_country_mio = {
unlock_mio_trait_tooltip = {
trait = advanced_assembly_line
show_modifiers = no
}
complete_mio_trait = advanced_assembly_line
}
Synergy
[complete_mio_trait](/wiki/effect/complete_mio_trait): The most direct partner—tooltip handles displaying "about to unlock" descriptions to the player, while complete_mio_trait handles the actual unlock execution. These two typically appear as a pair.
[is_mio_trait_available](/wiki/trigger/is_mio_trait_available): Use this trigger before execution to check whether the trait is already in an available state, preventing duplicate triggers or logical conflicts. The tooltip display will also be more accurate.
[is_mio_trait_completed](/wiki/trigger/is_mio_trait_completed): Used for conditional gating to ensure the tooltip only displays when the trait hasn't been completed yet, preventing redundant notifications about already-unlocked traits.
[add_mio_research_bonus](/wiki/effect/add_mio_research_bonus): A common combination scenario where the same focus or decision both unlocks a trait and grants research bonuses. The tooltip and this command appear side by side to fully present all benefits of that decision.
Common Pitfalls
- Mistaking this command for actually unlocking the trait:
unlock_mio_trait_tooltip only generates UI tooltips and doesn't change any game state. Beginners often forget to also write complete_mio_trait, resulting in the trait appearing as unlocked in the player's interface after focus completion, but with no actual changes in the MIO panel.
- Calling it outside an INDUSTRIAL_ORG scope: This command must be used within an
mio:xxx = { } block. Writing it directly in a nation scope's effect block will cause script errors or silent failures. Ensure you've correctly switched to the target MIO's scope using the mio: prefix.