Skip to content

Alpha v0.20 - Steam Achievements Fix

Choose a tag to compare

View all tags
@binary-knight binary-knight released this 06 Feb 06:58
· 377 commits to main since this release
v0.20
a1dce45

Usurper Reborn v0.20.0-alpha - Steam Achievements Fix

Release Highlights

This release fixes a critical issue where Steam achievements were not syncing properly, along with improved testing tools for Steam integration.

Bug Fixes

Steam Achievements Not Syncing (Critical)

  • Root Cause: CI/CD pipeline was building Steam releases with -c Release instead of -c Steam, which meant the STEAM_BUILD preprocessor directive was never defined. All Steam-specific code (achievement unlocks, stat syncing, etc.) was being compiled out of the executable.
  • Fix: Updated CI/CD workflow to use -c Steam configuration for all Steam builds. Added explicit Steam build configurations to the project file with proper STEAM_BUILD definition.
  • Impact: Manual achievement unlocks (marriage, friendships, no-death runs, etc.) now properly sync to Steam. Stat-linked achievements were partially working before because Steam's server-side processing handles those automatically when stats are uploaded.

Flaky Spell System Test

  • Fixed CastSpell_ReturnsValidResult test that had a 5% failure rate due to natural 1 critical failures on the d20 roll. Test now validates result structure rather than asserting success.

New Features

Steam Stats Reset (Dev Menu)

  • Added [R] Reset Steam Stats & Achievements option to the Developer Menu
  • Allows testers to reset all Steam stats and achievements for their account
  • Includes confirmation prompt to prevent accidental resets
  • Only affects the currently logged-in Steam user (not a global reset)

Achievement Sync on Load

  • Game now syncs previously-unlocked achievements to Steam when loading a save
  • Ensures achievements earned offline or before the fix are properly registered with Steam

Enhanced Steam Diagnostics

  • Added detailed logging for Steam initialization status
  • Achievement unlock attempts now log success/failure with achievement IDs
  • Helps diagnose Steam integration issues in debug.log

Technical Changes

Build Configuration

  • Added explicit Steam and SteamRelease configurations to project file
  • Steam configurations include:
    • STEAM_BUILD preprocessor directive
    • Release optimizations enabled
    • Debug symbols disabled

CI/CD Updates

  • Steam Windows build: -c Steam -r win-x64
  • Steam Linux build: -c Steam -r linux-x64
  • Steam macOS build: -c Steam -r osx-x64

Files Changed

  • .github/workflows/ci-cd.yml - Fixed Steam build configuration
  • usurper-reloaded.csproj - Added Steam build configurations
  • Scripts/Systems/SteamIntegration.cs - Added ResetAllStats(), enhanced logging
  • Scripts/Systems/AchievementSystem.cs - Added SyncUnlockedToSteam()
  • Scripts/Locations/DevMenuLocation.cs - Added Steam reset option
  • Scripts/Core/GameConfig.cs - Version bump to 0.20.0-alpha
  • Tests/SpellSystemTests.cs - Fixed flaky test

Upgrade Notes

Players who earned achievements before this fix should:

  1. Load their save game
  2. The game will automatically sync any previously-unlocked achievements to Steam

For testers needing a fresh start:

  1. Access the Developer Menu (if enabled)
  2. Select [R] Reset Steam Stats & Achievements
  3. Confirm the reset

Full Changelog: https://github.com/yourrepo/usurper-reborn/compare/v0.19.0...v0.20.0

Assets 8
Loading