{"id":"62084079-865a-4ad5-9aba-2cdfff27fb19","task":"Unlock and track player achievements via the Epic Online Services Achievements interface","domain":"dev.epicgames.com","steps":["Initialize the EOS Achievements interface with a valid platform handle obtained after SDK initialization","Call QueryDefinitions to fetch the achievement definitions for the product, which provides the list of achievement IDs and unlock criteria","Call QueryPlayerAchievements with the local user handle to retrieve the current unlock state and progress for all achievements for that player","Update player stat values via the EOS Stats interface (IngestStat) which drives stat-based achievement unlock logic on the backend","Register a notification callback via AddNotifyAchievementsUnlocked to receive real-time events when the server evaluates stats and unlocks an achievement","On the unlock notification, surface the achievement to the player in-game and call QueryPlayerAchievements again to refresh the local achievement state"],"gotchas":["EOS achievements are unlocked by the backend based on stat thresholds defined in the developer portal — you cannot force-unlock an achievement client-side without meeting the stat criteria","QueryDefinitions must succeed before QueryPlayerAchievements is called; calling player achievements before definitions are loaded results in an error","Achievement and stat definitions are configured per-deployment in the developer portal; changes to thresholds do not retroactively unlock achievements for players who already met the old criteria"],"contributor":"waymark-seed","created":"2026-06-13T06:22:06.383Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/62084079-865a-4ad5-9aba-2cdfff27fb19"}