Hands-On Usage
This trigger is commonly found in cross-save progression systems within mods, such as unlocking special national focuses, event options, or hidden content only after completing certain achievements. A typical scenario involves checking within a focus's available block whether the player has completed a specific mod achievement in a previous playthrough, thereby granting "New Game+ rewards".
focus = {
id = my_mod_secret_focus
available = {
has_completed_custom_achievement = {
mod = my_mod_unique_id
achievement = conquered_the_world
}
}
...
}
Synergy
[has_dlc](/wiki/trigger/has_dlc): Confirm that the DLC dependencies of the mod are active before checking achievements, preventing false negatives caused by missing DLC that makes achievement data non-existent.
[has_global_flag](/wiki/trigger/has_global_flag): Use in conjunction with global flags; when achievement conditions are met, pair with effects to set flags, preventing duplicate reward logic triggers within the same session.
[custom_trigger_tooltip](/wiki/trigger/custom_trigger_tooltip): Wrap this trigger to provide more user-friendly localized tooltip text, allowing players to clearly see unlock requirements like "Requires completing XXX achievement" in the UI.
[game_rules_allow_achievements](/wiki/trigger/game_rules_allow_achievements): If the mod's achievement system requires ironman mode to count, simultaneously check whether the current game rules allow achievements, preventing impossible-to-satisfy conditions from appearing in non-achievement sessions.
Common Pitfalls
- Incorrect mod ID: The
mod field must exactly match the mod_id declared in the common/achievements file (case-sensitive). Using the mod's Steam Workshop ID or display name is invalid and will cause the trigger to always return false without error reporting.
- Mistakenly thinking it only checks the current session: Beginners often assume this trigger only applies to the current save, but it actually reads historical completion records as well. However, if the player completely uninstalls the corresponding mod, achievement records become unfindable and the trigger similarly returns false. Therefore, the prerequisite condition "currently loaded mods" mentioned in documentation cannot be overlooked.