Release v8.2.0

.doxygen/groups.dox

@@ -214,6 +214,15 @@
 ///
 /// See the [LootLocker documentation](https://docs.lootlocker.com/commerce/wallets).
 
+/// @defgroup PlatformKeys Platform Keys
+/// @brief List platform keys redeemed by the authenticated player.
+///
+/// Platform keys are keys distributed through LootLocker's Campaign system
+/// (e.g. Steam keys, Discord keys). This endpoint returns all keys redeemed
+/// by the currently authenticated player, grouped by campaign.
+///
+/// See the [LootLocker documentation](https://docs.lootlocker.com/campaigns/overview).
+
 /// @defgroup Catalog Catalog
 /// @brief Browse item listings and prices in the LootLocker storefront catalog.
 ///

.github/workflows/create-release.yml

@@ -59,7 +59,7 @@ jobs:
 
           PR_JSON=$(gh pr view "$PR_NUMBER" --json number,body,labels,title,state --jq '.')
           PR_TITLE=$(echo "$PR_JSON" | jq -r '.title')
-          HAS_RC_LABEL=$(echo "$PR_JSON" | jq -r '[.labels[].name] | index("release candidate") != null')
+          HAS_RC_LABEL=$(echo "$PR_JSON" | jq -r '.labels[].name' | tr '[:upper:]' '[:lower:]' | grep -q 'release candidate' && echo "true" || echo "false")
           PR_STATE=$(echo "$PR_JSON" | jq -r '.state')
 
           echo "Found PR #${PR_NUMBER}: ${PR_TITLE} (state: ${PR_STATE})"

.github/workflows/enforce-release-pr.yml

@@ -16,7 +16,7 @@ jobs:
     name: Validate release candidate PR
     runs-on: ubuntu-latest
     timeout-minutes: 3
-    if: contains(github.event.pull_request.labels.*.name, 'release candidate')
+    if: contains(github.event.pull_request.labels.*.name, 'Release Candidate') || contains(github.event.pull_request.labels.*.name, 'release candidate')
 
     steps:
       - name: Checkout

.github/workflows/open-release-pr.yml

@@ -41,19 +41,21 @@ jobs:
         id: current
         run: |
           VERSION=$(jq -r '.version' package.json)
+          if [ -z "$VERSION" ] || [ "$VERSION" = "null" ]; then
+            echo "::error::Could not read version from package.json"
+            exit 1
+          fi
           echo "VERSION=${VERSION}" >> "$GITHUB_OUTPUT"
           echo "Current version: ${VERSION}"
 
       - name: Get previous release tag and commit log
         id: prev-tag
         run: |
-          LATEST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "")
+          LATEST_TAG=$(git describe --tags --abbrev=0 2>/dev/null || echo "v0.0.0")
           echo "TAG=${LATEST_TAG}" >> "$GITHUB_OUTPUT"
-          echo "Previous tag: ${LATEST_TAG:-none}"
-
-          # Collect commits since last tag (or all commits if no tag yet)
+          echo "Previous tag: ${LATEST_TAG}"
           REV_RANGE=""
-          if [ -n "$LATEST_TAG" ]; then
+          if [ -n "$LATEST_TAG" ] && [ "$LATEST_TAG" != "v0.0.0" ]; then
             REV_RANGE="${LATEST_TAG}..HEAD"
           else
             REV_RANGE="HEAD"
@@ -81,23 +83,24 @@ jobs:
           if [ "$BUMP" = "auto" ] && [ "$ALREADY_CALCULATED" = "false" ]; then
             echo "Auto-detecting version from OpenRouter..."
             if [ -z "${{ secrets.OPENROUTER_API_KEY }}" ]; then
-              echo "::error::OPENROUTER_API_KEY secret not set. Use manual bump or set secret."
-              exit 1
-            fi
-            COMMITS=$(head -100 /tmp/commits.log)
-            printf 'Based on these commit messages since the last release (v%s), determine the correct semver version for the next release. Analyze breaking changes, new features, and fixes. Respond with only the version number (e.g., 9.0.0).\n\n%s\n' "$CURRENT" "$COMMITS" > /tmp/version-prompt.txt
-            RESPONSE=$(curl -s "https://openrouter.ai/api/v1/chat/completions" \
-              -H "Authorization: Bearer ${{ secrets.OPENROUTER_API_KEY }}" \
-              -H "Content-Type: application/json" \
-              -d "$(jq -n --rawfile prompt /tmp/version-prompt.txt '{model:"deepseek/deepseek-v4-pro",messages:[{role:"user",content:$prompt}],reasoning:{effort:"low"},max_tokens:2000,temperature:0}')")
-            NEW=$(echo "$RESPONSE" | jq -r '.choices[0].message.content // ""' | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
-            if [ -z "$NEW" ]; then
-              echo "::warning::AI returned no parseable version, falling back to patch bump."
-              PATCH=$(echo "$CURRENT" | cut -d. -f3)
-              NEW="$(echo "$CURRENT" | cut -d. -f1).$(echo "$CURRENT" | cut -d. -f2).$((PATCH + 1))"
+              echo "::warning::OPENROUTER_API_KEY not set. Falling back to patch bump."
+              BUMP="patch"
+            else
+              COMMITS=$(head -100 /tmp/commits.log)
+              printf 'The current version is v%s. Based on these commit messages since the last release, determine the correct semver version for the next release. Analyze breaking changes, new features, and fixes. Respond with only the version number (e.g., 9.0.0).\n\n%s\n' "$CURRENT" "$COMMITS" > /tmp/version-prompt.txt
+              RESPONSE=$(curl -s "https://openrouter.ai/api/v1/chat/completions" \
+                -H "Authorization: Bearer ${{ secrets.OPENROUTER_API_KEY }}" \
+                -H "Content-Type: application/json" \
+                -d "$(jq -n --rawfile prompt /tmp/version-prompt.txt '{model:"deepseek/deepseek-v4-pro",messages:[{role:"user",content:$prompt}],reasoning:{effort:"low"},max_tokens:2000,temperature:0}')")
+              NEW=$(echo "$RESPONSE" | jq -r '.choices[0].message.content // ""' | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
+              if [ -z "$NEW" ]; then
+                echo "::warning::AI returned no parseable version. Falling back to patch bump."
+                BUMP="patch"
+              else
+                echo "AI suggested version: ${NEW}"
+                ALREADY_CALCULATED=true
+              fi
             fi
-            echo "AI suggested version: ${NEW}"
-            ALREADY_CALCULATED=true
           fi
 
           if [ "$ALREADY_CALCULATED" = "false" ]; then

.github/workflows/package-sdk.yml

@@ -68,7 +68,8 @@ jobs:
       - name: Attach .unitypackage to release
         if: github.event_name == 'release'
         run: |
-          for f in unity-sdk-packager/LootLockerSDK*.unitypackage; do
+          cd unity-sdk
+          for f in ../unity-sdk-packager/LootLockerSDK*.unitypackage; do
             echo "Uploading $f"
             gh release upload --clobber "${{ github.ref_name }}" "$f"
           done

Runtime/Client/LootLockerEndPoints.cs

@@ -43,6 +43,7 @@ public class LootLockerEndPoints
         // White Label Login
         [Header("White Label Login")]
         public static EndPointClass whiteLabelSignUp = new EndPointClass("white-label-login/sign-up", LootLockerHTTPMethod.POST, LootLockerEnums.LootLockerCallerRole.Base);
+        public static EndPointClass whiteLabelSignUpFields = new EndPointClass("white-label-login/sign-up/fields", LootLockerHTTPMethod.GET, LootLockerEnums.LootLockerCallerRole.Base);
         public static EndPointClass whiteLabelLogin = new EndPointClass("white-label-login/login", LootLockerHTTPMethod.POST, LootLockerEnums.LootLockerCallerRole.Base);
         public static EndPointClass whiteLabelVerifySession = new EndPointClass("white-label-login/verify-session", LootLockerHTTPMethod.POST, LootLockerEnums.LootLockerCallerRole.Base);
         public static EndPointClass whiteLabelRequestPasswordReset = new EndPointClass("white-label-login/request-reset-password", LootLockerHTTPMethod.POST, LootLockerEnums.LootLockerCallerRole.Base);
@@ -73,6 +74,14 @@ public class LootLockerEndPoints
         public static EndPointClass uploadPlayerFile = new EndPointClass("player/files", LootLockerHTTPMethod.UPLOAD_FILE);
         public static EndPointClass updatePlayerFile = new EndPointClass("/player/files/{0}", LootLockerHTTPMethod.UPDATE_FILE);
         public static EndPointClass deletePlayerFile = new EndPointClass("/player/files/{0}", LootLockerHTTPMethod.DELETE);
+        public static EndPointClass listPlayerFileRevisions = new EndPointClass("player/files/{0}/revisions", LootLockerHTTPMethod.GET);
+        public static EndPointClass getPlayerFileRevision = new EndPointClass("player/files/{0}/revisions/{1}", LootLockerHTTPMethod.GET);
+        public static EndPointClass promotePlayerFileRevision = new EndPointClass("player/files/{0}/revisions/{1}/current", LootLockerHTTPMethod.POST);
+        public static EndPointClass getPlayerFileByKey = new EndPointClass("player/files/key/{0}", LootLockerHTTPMethod.GET);
+        public static EndPointClass listPlayerFileRevisionsByKey = new EndPointClass("player/files/key/{0}/revisions", LootLockerHTTPMethod.GET);
+        public static EndPointClass getPlayerFileRevisionByKey = new EndPointClass("player/files/key/{0}/revisions/{1}", LootLockerHTTPMethod.GET);
+        public static EndPointClass promotePlayerFileRevisionByKey = new EndPointClass("player/files/key/{0}/revisions/{1}/current", LootLockerHTTPMethod.POST);
+        public static EndPointClass deletePlayerFileByKey = new EndPointClass("player/files/key/{0}", LootLockerHTTPMethod.DELETE);
 
         // Player Progressions
         [Header("Player Progressions")]
@@ -253,6 +262,10 @@ public class LootLockerEndPoints
         public static EndPointClass getCurrencyDetails = new EndPointClass("currency/code/{0}", LootLockerHTTPMethod.GET);
         public static EndPointClass getCurrencyDenominationsByCode = new EndPointClass("currency/code/{0}/denominations", LootLockerHTTPMethod.GET);
 
+        // Platform Keys
+        [Header("Platform Keys")]
+        public static EndPointClass listPlatformKeys = new EndPointClass("platform-keys/v1", LootLockerHTTPMethod.GET);
+
         // Balances
         [Header("Balances")]
         public static EndPointClass listBalancesInWallet = new EndPointClass("balances/wallet/{0}", LootLockerHTTPMethod.GET);

Runtime/Client/LootLockerLifecycleManager.cs

@@ -572,7 +572,7 @@ private IEnumerator ServiceHealthMonitor()
 
             while (_serviceHealthMonitoringEnabled && Application.isPlaying)
             {
-                yield return new WaitForSeconds(healthCheckInterval);
+                yield return new WaitForSecondsRealtime(healthCheckInterval);
 
                 if (_state != LifecycleManagerState.Ready)
                 {

Runtime/Client/LootLockerPresenceClient.cs

@@ -478,7 +478,7 @@ private IEnumerator WaitForConnectionAndUpdateStatus(string status, Dictionary<s
             int waitCount = 0;
             while(!IsConnectedAndAuthenticated && waitCount < maxWaitTimes)
             {
-                yield return new WaitForSeconds(0.1f);
+                yield return new WaitForSecondsRealtime(0.1f);
                 waitCount++;
             }
 
@@ -1122,7 +1122,7 @@ private IEnumerator PingCoroutine()
             while (IsConnectedAndAuthenticated)
             {
                 SendPing();
-                yield return new WaitForSeconds(PING_INTERVAL);
+                yield return new WaitForSecondsRealtime(PING_INTERVAL);
             }
         }
 
@@ -1138,7 +1138,7 @@ private IEnumerator ScheduleReconnectCoroutine(float customDelay = -1f)
             LootLockerLogger.Log($"Scheduling Presence reconnect attempt {reconnectAttempts}/{MAX_RECONNECT_ATTEMPTS} in {delayToUse} seconds", LootLockerLogger.LogLevel.Debug);
             ChangeConnectionState(LootLockerPresenceConnectionState.Reconnecting);
 
-            yield return new WaitForSeconds(delayToUse);
+            yield return new WaitForSecondsRealtime(delayToUse);
 
             if (shouldReconnect && connectionState == LootLockerPresenceConnectionState.Reconnecting)
             {

Runtime/Client/LootLockerPresenceManager.cs

@@ -1132,7 +1132,7 @@ private IEnumerator _AutoConnectExistingSessions()
                     ConnectPresence(state.ULID);
 
                     // Small delay between connections to avoid overwhelming the system
-                    yield return new WaitForSeconds(0.1f);
+                    yield return new WaitForSecondsRealtime(0.1f);
                 }
             }
         }

Runtime/Client/LootLockerStateData.cs

@@ -211,6 +211,11 @@ public void OverrideStateWriter(ILootLockerStateWriter newWriter)
             }
         }
 
+        public static ILootLockerStateWriter GetStateWriter()
+        {
+            return _stateWriter;
+        }
+
         //==================================================
         // Constants
         //==================================================

Runtime/Client/LootLockerStateWriter.cs

@@ -27,6 +27,19 @@ public interface ILootLockerStateWriter
         /// <param name="key">The key to set the value for.</param>
         /// <param name="value">The value to set.</param>
         void SetString(string key, string value);
+        /// <summary>
+        /// Get an int from persistent storage. If the key does not exist then return the provided default value.
+        /// </summary>
+        /// <param name="key">The key to retrieve the value for.</param>
+        /// <param name="defaultValue">The value to return if the key does not exist.</param>
+        /// <returns>The value associated with the key, or the default value if the key does not exist.</returns>
+        int GetInt(string key, int defaultValue = 0);
+        /// <summary>
+        /// Set an integer in persistent storage.
+        /// </summary>
+        /// <param name="key">The key to set the value for.</param>
+        /// <param name="value">The value to set.</param>
+        void SetInt(string key, int value);
 
         /// <summary>
         /// Delete a key from persistent storage.
@@ -64,6 +77,17 @@ public string GetString(string key, string defaultValue = "")
             return PlayerPrefs.GetString(key, defaultValue);
         }
 
+        /// <summary>
+        /// Gets an int from PlayerPrefs.
+        /// </summary>
+        /// <param name="key">The key to retrieve the value for.</param>
+        /// <param name="defaultValue">The value to return if the key does not exist.</param>
+        /// <returns>The value associated with the key, or the default value if the key does not exist.</returns>
+        public int GetInt(string key, int defaultValue = 0)
+        {
+            return PlayerPrefs.GetInt(key, defaultValue);
+        }
+
         /// <summary>
         /// Checks if a key exists in PlayerPrefs.
         /// </summary>
@@ -74,6 +98,17 @@ public bool HasKey(string key)
             return PlayerPrefs.HasKey(key);
         }
 
+        /// <summary>
+        /// Sets an int in PlayerPrefs and saves the changes.
+        /// </summary>
+        /// <param name="key">The key to set the value for.</param>
+        /// <param name="value">The value to set.</param>
+        public void SetInt(string key, int value)
+        {
+            PlayerPrefs.SetInt(key, value);
+            PlayerPrefs.Save();
+        }
+
         /// <summary>
         /// Sets a string in PlayerPrefs and saves the changes.
         /// </summary>
@@ -98,6 +133,11 @@ public string GetString(string key, string defaultValue = "")
             return defaultValue;
         }
 
+        public int GetInt(string key, int defaultValue = 0)
+        {
+            return defaultValue;
+        }
+
         public bool HasKey(string key)
         {
             return false;
@@ -107,5 +147,10 @@ public void SetString(string key, string value)
         {
             // Do nothing
         }
+
+        public void SetInt(string key, int value)
+        {
+            // Do nothing
+        }
     }
 }

Runtime/Editor/Editor UI/LootLockerAdminExtension.cs

@@ -96,7 +96,7 @@ public partial class LootLockerAdminExtension : EditorWindow
         [MenuItem("Window/" + LootLockerConfig.PackageName + "/Tools/Clear Local Player Data", true, 101)]
         public static bool ValidateClearLocalPlayerData()
         {
-            return LootLockerConfig.current.enableEditorAdminExtension;
+            return true;
         }
 
         [MenuItem("Window/" + LootLockerConfig.PackageName + "/Tools/Clear Local Player Data", false, 101)]