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/scripts/run-tests.ps1

@@ -124,6 +124,10 @@ function Initialize-TestProject {
     if (-not [string]::IsNullOrEmpty($scriptingDefines)) {
         $psContent += $nl + '  scriptingDefineSymbols:' + $nl + '    1: ' + $scriptingDefines
     }
+    if ($UseLocalEnv) {
+        # The local devenv is plain http; Unity blocks insecure connections unless this is set.
+        $psContent += $nl + '  insecureHttpOption: 2'
+    }
     [IO.File]::WriteAllText((Join-Path $TempProject 'ProjectSettings\ProjectSettings.asset'), $psContent)
 }
 
@@ -144,6 +148,46 @@ if (-not [string]::IsNullOrWhiteSpace($CustomProject) -and (Test-Path $CustomPro
     $ProjectPath = $TempProject
 }
 
+# Reused and custom projects need the same local settings as freshly initialized projects.
+if ($UseLocalEnv) {
+    $ProjectSettingsFile = Join-Path $ProjectPath "ProjectSettings\ProjectSettings.asset"
+    if (Test-Path $ProjectSettingsFile) {
+        $nl = [char]10
+        $settingsContent = [IO.File]::ReadAllText($ProjectSettingsFile)
+        if ($settingsContent -notmatch 'LOOTLOCKER_COMMANDLINE_SETTINGS') {
+            $defineProperty = [Regex]::Match($settingsContent, '(?m)^  scriptingDefineSymbols:[^\r\n]*(?:\r?\n|$)')
+            if ($defineProperty.Success) {
+                $groupOne = [Regex]::Match($settingsContent.Substring($defineProperty.Index + $defineProperty.Length), '\A(?:    [^\r\n]*\r?\n)*?    1:[ \t]*[^\r\n]*')
+                if ($groupOne.Success) {
+                    $start = $defineProperty.Index + $defineProperty.Length + $groupOne.Index
+                    $newGroup = if ($groupOne.Value -match '^    1:[ \t]*$') {
+                        '    1: LOOTLOCKER_COMMANDLINE_SETTINGS'
+                    } else {
+                        $groupOne.Value + ';LOOTLOCKER_COMMANDLINE_SETTINGS'
+                    }
+                    $settingsContent = $settingsContent.Remove($start, $groupOne.Length).Insert($start, $newGroup)
+                } else {
+                    $settingsContent = $settingsContent.Insert($defineProperty.Index + $defineProperty.Length, '    1: LOOTLOCKER_COMMANDLINE_SETTINGS' + $nl)
+                }
+            } else {
+                $settingsContent = $settingsContent.TrimEnd() + $nl + '  scriptingDefineSymbols:' + $nl + '    1: LOOTLOCKER_COMMANDLINE_SETTINGS' + $nl
+            }
+        }
+        if ($settingsContent -match '(?m)^[ \t]*insecureHttpOption:') {
+            $updatedContent = [Regex]::Replace($settingsContent, '(?m)^[ \t]*insecureHttpOption:.*$', '  insecureHttpOption: 2')
+        } else {
+            $updatedContent = $settingsContent.TrimEnd() + $nl + '  insecureHttpOption: 2' + $nl
+        }
+        if ($updatedContent -ne $settingsContent) {
+            [IO.File]::WriteAllText($ProjectSettingsFile, $updatedContent)
+            Write-Step "Enabled insecure http in $ProjectSettingsFile"
+        }
+    } else {
+        Write-Fail "ProjectSettings.asset not found at $ProjectSettingsFile; cannot enable local http."
+        exit 1
+    }
+}
+
 $ResultsFile = Join-Path $ProjectPath "TestResults.xml"
 $LogFile     = Join-Path $ProjectPath "test-run.log"
 

.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);
@@ -336,6 +349,16 @@ public class LootLockerEndPoints
         // Presence (WebSocket)
         [Header("Presence")]
         public static EndPointClass presenceWebSocket = new EndPointClass("presence/v1", LootLockerHTTPMethod.GET);
+
+        // Items
+        [Header("Items")]
+        public static EndPointClass listItemTemplates = new EndPointClass("player/inventory/v1", LootLockerHTTPMethod.GET);
+        public static EndPointClass listPlayerInventoryItems = new EndPointClass("player/inventory/v1/my", LootLockerHTTPMethod.GET);
+        public static EndPointClass getPlayerInventoryItem = new EndPointClass("player/inventory/v1/{0}", LootLockerHTTPMethod.GET);
+        public static EndPointClass deletePlayerInventoryItem = new EndPointClass("player/inventory/v1/{0}", LootLockerHTTPMethod.DELETE);
+        public static EndPointClass consumePlayerInventoryItem = new EndPointClass("player/inventory/v1/{0}/consume", LootLockerHTTPMethod.POST);
+        public static EndPointClass splitPlayerInventoryItemStack = new EndPointClass("player/inventory/v1/{0}/split", LootLockerHTTPMethod.POST);
+        public static EndPointClass mergePlayerInventoryItemStacks = new EndPointClass("player/inventory/v1/merge", LootLockerHTTPMethod.POST);
     }
 
     [Serializable]

Runtime/Client/LootLockerHTTPClient.cs

@@ -747,12 +747,10 @@ private void CallListenersAndMarkDone(LootLockerHTTPExecutionQueueItem execution
 
             response.requestContext = new LootLockerRequestContext(executionItem.RequestData.ForPlayerWithUlid, executionItem.RequestData.RequestStartTime, executionItem.RequestData.RequestId);
 
-#if LOOTLOCKER_BETA_ENABLE_ERROR_REPORTING
             if (response != null && !response.success)
             {
                 StoreFailedRequestReport(response, executionItem);
             }
-#endif
 
             CurrentlyOngoingRequests.Remove(executionItem.RequestData.RequestId);
             executionItem.IsWaitingForSessionRefresh = false;

Runtime/Client/LootLockerLifecycleManager.cs

@@ -46,7 +46,11 @@ public class LootLockerLifecycleManager : MonoBehaviour
         #region Instance Handling
 
         private static LootLockerLifecycleManager _instance;
-        private static int _instanceId = 0;
+#if UNITY_6000_5_OR_NEWER
+        private static EntityId _instanceId = default;
+#else
+        private static int _instanceId = default;
+#endif
         private static GameObject _hostingGameObject = null;
         private static readonly object _instanceLock = new object();
 
@@ -70,7 +74,7 @@ private static void AutoInitialize()
             {
                 Debug.LogWarning($"[LootLocker] LifecycleManager auto-initialization failed: {ex.Message}. Services will be initialized on first use.");
                 _instance = null;
-                _instanceId = 0;
+                _instanceId = default;
                 if (_hostingGameObject != null)
                 {
                     Destroy(_hostingGameObject);
@@ -115,7 +119,11 @@ private static void Instantiate()
             {                
                 var gameObject = new GameObject("LootLockerLifecycleManager");
                 _instance = gameObject.AddComponent<LootLockerLifecycleManager>();
+#if UNITY_6000_5_OR_NEWER
+                _instanceId = _instance.GetEntityId();
+#else
                 _instanceId = _instance.GetInstanceID();
+#endif
                 _hostingGameObject = gameObject;
 
                 if (Application.isPlaying)
@@ -150,7 +158,7 @@ private static void TeardownInstance()
 #endif
 
                     _instance = null;
-                    _instanceId = 0;
+                    _instanceId = default;
                     _hostingGameObject = null;
                 }
 
@@ -168,13 +176,22 @@ public static IEnumerator CleanUpOldInstances()
 #endif
             foreach (LootLockerLifecycleManager manager in managers)
             {
-                if (manager != null && _instanceId != manager.GetInstanceID() && manager.gameObject != null && ((LootLockerLifecycleManager)manager)._isInitialized)
+                if (manager != null && manager.gameObject != null && ((LootLockerLifecycleManager)manager)._isInitialized)
                 {
+                    bool isCurrentInstance;
+#if UNITY_6000_5_OR_NEWER
+                    isCurrentInstance = _instanceId == manager.GetEntityId();
+#else
+                    isCurrentInstance = _instanceId == manager.GetInstanceID();
+#endif
+                    if (!isCurrentInstance)
+                    {
 #if UNITY_EDITOR
-                    DestroyImmediate(manager.gameObject);
+                        DestroyImmediate(manager.gameObject);
 #else
-                    Destroy(manager.gameObject);
+                        Destroy(manager.gameObject);
 #endif
+                    }
                 }
             }
             yield return null;
@@ -572,7 +589,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);
                 }
             }
         }