Wiki

trigger · career_profile_check_medal

Definition

  • Supported scope:any
  • Supported target:any

Description

Checks if the required medal is achieved and collected

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

career_profile_check_medal is commonly used in career mode mods to unlock new options, events, or rewards based on whether the player has obtained and claimed specific medals. For example, in an achievement unlock system, a special event or hidden focus can only be triggered after the player collects all designated medals:

available = {
    career_profile_check_medal = {
        medal = my_mod_veteran_medal
    }
}

Synergy

  • [career_profile_check_ribbon](/wiki/trigger/career_profile_check_ribbon): Medals and ribbons often serve as parallel collection targets in career profiles; combining both can establish compound unlock conditions.
  • [career_profile_check_points](/wiki/trigger/career_profile_check_points): Used to require the player to reach a certain career score threshold while checking medals, preventing conditions from being too permissive.
  • [has_completed_custom_achievement](/wiki/trigger/has_completed_custom_achievement): When used with custom achievement checks, conditions are considered satisfied only after both medal and achievement verification pass.
  • [custom_effect_tooltip](/wiki/effect/custom_effect_tooltip): Displays hints like "Medal not yet obtained" in the UI, improving readability.

Common Pitfalls

  1. Confusing "obtained" with "claimed": This trigger requires that the medal has been collected (claimed); merely meeting the acquisition condition in the profile without actually claiming it will return false. Beginners often mistakenly assume that completing the corresponding challenge is sufficient to pass the check.
  2. Using in non-career mode saves: If the mod does not restrict this trigger to career mode only (such as gating it with related conditions like [career_profile_check_playthrough_ratio](/wiki/trigger/career_profile_check_playthrough_ratio)), calling it in standard saves may cause the condition to always be false, leading to difficult-to-debug logic errors.