Hands-On Usage
This effect is specifically designed to display a "military industrial organization unlocking soon" tooltip at the interface level without actually executing the unlock operation. It commonly appears in focus trees or decisions within completion_reward blocks, paired with the actual unlock logic, allowing players to clearly see the rewards when hovering over previews. For example, in a mod focused on military industrial systems, a nation can display the MIO it will soon acquire to the player after completing a focus:
focus = {
id = FIN_develop_defense_industry
...
completion_reward = {
unlock_military_industrial_organization_tooltip = mio:fin_patria_mio
# Paired here with the actual unlock effect
}
}
Synergy
[every_military_industrial_organization](/wiki/effect/every_military_industrial_organization): When iterating through existing MIOs, it's often necessary to first use the tooltip effect to clarify which MIO will be affected, then execute the actual operation for clearer logic.
[any_military_industrial_organization](/wiki/trigger/any_military_industrial_organization): When checking in a trigger block whether an MIO exists or meets conditions, combining with the tooltip effect enables dynamic descriptions like "show unlock hints only when conditions are met."
[add_ideas](/wiki/effect/add_ideas): Unlocking an MIO is often accompanied by adding national ideologies or special policies; placing both in the same execution block together forms a complete reward package.
[activate_mission_tooltip](/wiki/effect/activate_mission_tooltip): Belongs to the same "tooltip-only" effect category and is commonly placed side-by-side in the same completion_reward or option block to uniformly manage visible reward previews for players.
Common Pitfalls
- Mistaking this command for actually unlocking an MIO: The
_tooltip suffix indicates it only generates interface hint text and does not execute actual unlock logic. If only this command is written without a corresponding real unlock effect, players will see the hint but won't receive the MIO, resulting in a "false promise" bug.
- Using it in the wrong scope: This effect must be placed within a
COUNTRY scope. If mistakenly written in a state scope or character scope, it will cause script errors or silent failures. Beginners are especially prone to overlooking the current scope when nesting levels are deep.