Links

Weekly Changelog

This is where you will find our log of changes to the APIs, SDKs, the Console and any other services LootLocker provides.

2024-01-12 - Changelog

Console

Changes

  • The LootLocker Console is now response, allowing you to manage your game from any device, anywhere.

Unity SDK

Changes

  • Refresh Remote Sessions: Remote sessions now provide a refresh token that can be used to refresh the session without fully re-authorizing.
  • Grant and Remove Assets You can now grant and delete assets from a player directly from the game if you allow it in the console.

Bug Fixes

  • The catalog now correctly handles the pagination cursor.

Continuous Integration

We have significantly improved our continuous integration and testing. Here for example is the run for this release: https://github.com/lootlocker/unity-sdk/actions/runs/7486064145

Unreal SDK

Changes

  • Refresh Remote Sessions: Remote sessions now provide a refresh token that can be used to refresh the session without fully re-authorizing.
  • Grant and Remove Assets You can now grant and delete assets from a player directly from the game if you allow it in the console.

Bug Fixes

  • The catalog now correctly handles the pagination cursor.

Unreal Server SDK

Bug Fixes

  • BREAKING CHANGE, moved all of the header files to the public folder. You will no longer need to use the #include "LootLockerServerSDK/Private/ServerAPI/<file>.h; include line. Instead use #include "LootLockerServerSDK/Public/ServerAPI/<file>.h;
  • Fixed uninitialized parameters
  • Added unit tests

2023-11-17 - Changelog

Unreal SDK

Unreal SDK v3.1.0 released

Changes

  • Progression Currencies - 🪙 Currencies can now be rewarded from progressions 🎉
  • Session Leasing - 🎁 You can now lease a session on your client. You will get a url and a qr code that can be used by the same or another device to authorise the session.

Bug Fixes

  • RemoveAssetFromHeroLoadout is working again
  • Packaging has been failing for certain platforms due to LootLockerConfig not being found. This issue has been fixed.

Unreal Server SDK v2.2.0 released

Changes

  • Currency Progressions - Progressions can now reward currencies 🎉

Bug Fixes

  • Documentation clarifications to balance requests

2023-11-10 - Changelog

This week we have added economy support to our progression system, meaning you can now reward currencies from any progression.
Additionally we have also recently shipped two major updates to our SDKs.

Web Console

Changes

  • Added support for currencies in progression rewards

Admin API

Changes

  • Added support for currencies in progression rewards

Game API

Changes

  • Added support for currencies in progression rewards

Server API

Changes

  • Added support for currencies in progression rewards

Unity SDK

Changes

Unity SDK v2.0.0 Released
v2.0.0 removes a lot of code that has previosly been deprecated, you can read more in our docs about what that means.
  • How you get error information from the SDK has changed. Instead of the fields hasError and Error in each response there is now a field named errorData within which all error information resides. Instead of hasError you use !success, and instead of Error you should use the fields in errorData. The exact replacement is errorData.message.
  • The field "texture" on each response has been removed (it was never used)
  • Dev Mode is deprecated, so is the "support" for deprecated api keys
  • Game ID is no longer needed for White Label Signup
  • When calling Init explicitly with parameters, then platform and onDevelopmentMode are no longer needed. The method now looks like this: bool Init(string apiKey, string gameVersion, string domainKey)
  • void StartSession(string deviceId, Action<LootLockerSessionResponse> onComplete) is removed. If you're using this method you need to switch over to the topical start session methods instead. For example if you were using this to start a session for Android, then you should now use StartAndroidSession instead. If you're unsure of what to use, we recommend Guest or White Label.
  • EndSession no longer takes deviceId as an argument, use void EndSession(Action<LootLockerSessionResponse> onComplete) instead
  • Calling StartWhiteLabelSession with email and password is no longer supported. Instead, we cache the needed information and you should call StartWhiteLabelSession(Action<LootLockerSessionResponse> onComplete). Or even better, replace the separate Login and StartSession calls with using WhiteLabelLoginAndStartSession
  • All leaderboard methods that were using the leaderboard id (integer) have been removed. You should use the methods that take the leaderboard keys instead. The reason for this is that the leaderboard key is independent across environments meaning your code can stay the same when the game releases. Affected methods are:
    • GetMemberRank
    • GetByListOfMembers
    • GetScoreList
    • GetNextScoreList
    • GetPrevScoreList
    • GetScoreListOriginal
    • SubmitScore
  • Starting a LootLocker Session from a White Label Login Token no longer needs a password in the request (LootLockerWhiteLabelSessionRequest)
  • Renamed types (deprecated the old one, use the new one)
    • LootLockerActivateARentalAssetResponse renamed to LootLockerActivateRentalAssetResponse
    • LootLockerGettingCollectablesResponse renamed to LootLockerGetCollectablesResponse
    • LootLockerCollectingAnItemResponse renamed to LootLockerCollectItemResponse
    • LootLockerFinishingAMissionRequest renamed to LootLockerFinishMissionRequest
    • LootLockerGettingAllMissionsResponse renamed to LootLockerGetAllMissionsResponse
    • LootLockerGettingASingleMissionResponse renamed to LootLockerGetMissionResponse
    • LootLockerStartingAMissionResponse renamed to LootLockerStartMissionResponse
    • LootLockerFinishingAMissionResponse renamed to LootLockerFinishMissionResponse
    • LootLockerTriggerAnEventRequest renamed to LootLockerExecuteTriggerRequest
    • LootLockerTriggerAnEventResponse renamed to LootLockerExecuteTriggerResponse
    • LootLockerListingAllTriggersResponse renamed to LootLockerListAllTriggersResponse
  • Renamed methods (deprecated the old one, use the new one)
    • GettingCollectables renamed to GetCollectables
    • CollectingAnItem renamed to CollectItem
    • GettingAllMaps renamed to GetAllMaps
    • GettingAllMissions renamed to GetAllMissions
    • GettingASingleMission renamed to GetMission
    • StartingAMission renamed to StartMission
    • FinishingAMission renamed to FinishMission
    • PollingOrderStatus renamed to PollOrderStatus
    • ActivatingARentalAsset renamed to ActivateRentalAsset
    • TriggeringAnEvent renamed to ExecuteTrigger
    • ListingTriggeredTriggerEvents renamed to ListAllExecutedTriggers

Bug Fixes

  • The SDK will no longer cause editor versions newer than 2021 to lose their External Tools section in Preferences

Unreal SDK

Changes

Unreal SDK v3.0.0 Released
v3.0.0 removes a lot of code that has previosly been deprecated, you can read more in our docs about what that means.
  • How you get error information from the SDK has changed. Instead of the field Error in each response there is now a field named ErrorData within which all error information resides. Instead of Error you should use the fields in errorData. The exact replacement is errorData.Message. Additionally the field ServerCallStatusCode has been replaced with the field StatusCode.
  • void StartSession(const FString& PlayerIdentifier, const FAuthResponseBP& OnStartedSessionRequestCompleted) is removed. If you're using this method you need to switch over to the topical start session methods instead. For example if you were using this to start a session for Android, then you should now use StartAndroidSession instead. If you're unsure of what to use, we recommend Guest or White Label. Along with this the configuration of Platform in LootLockers config file is removed.
  • DevelopmentMode is deprecated, so is the "support" for deprecated api keys. If you're using an api key that does not start with dev_ or prod_ you need to migrate from the api key you're using to a new one for continued development. You can do that here. Remember that if you have released versions of your game that are using the old API key those will continue working as long as you do not remove the old API key from the console. If you don't have released versions however we recommend that you do remove the old API key.
  • Renamed methods (deprecated the old one, use the new one)
    • GetAllKeyValuePairsToAnInstanceForAssetInstance renamed to GetAllKeyValuePairsForAssetInstance

2023-10-20 - Changelog

This week we shipped our new Base and Hero Class System, as well as the long anticipated Economy System.

Web Console

Changes

  • Our new Base and Hero Class System has launched, with a much improved UI. Find it in the Console under Systems.
  • Economy has been launched. This also brings a fresh new UI for managing your games Economy and Currencies. Find it in the Console under Content.

Unity SDK

Changes

  • Economy - LootLocker's economy system is released 🎉 With this you can now create virtual currencies, in game economies, and so much more. Read more in our blog post announcing the release.

Bug Fixes

  • The LootLocker Editor extension that shipped in v1.2.6 had a few bugs that have now been fixed.
    • Primarily, the build error for a rouge [HideInEditor] decorator has been fixed
    • Adding the SDK from github url should now work
  • The new flag on messages is fixed

Unreal SDK

Changes

  • Economy - LootLocker's economy system is released 🎉 With this you can now create virtual currencies, in game economies, and so much more. Read more in our blog post announcing the release.
  • Improved Errors - The way that LootLocker tells you what's wrong has changed. Instead of the Response.Error field there's now a structure: Response.ErrorData that contains some more valuable information. Read more here: https://docs.lootlocker.com/reference/error-codes
  • Exposed method CreateHeroWithVariation to Blueprints
  • Added ability to equip global asset with the default variation for heroes
  • Added Public_UID to the authentication responses

Bug Fixes

  • Fixed build problems for Unreal Engine 5.3 when packaging for Linux

Game API

Changes

  • The Game API of course benefits from the new Economy System, allowing you to use virtual currencies, in game economies and so much more. Read more in our blog post announcing the release.

Server API

Changes

  • The Server API of course also benefits from the new Economy System, allowing you to use virtual currencies, in game economies and so much more. Read more in our blog post announcing the release.

Admin API

Changes

  • The Admin API of course also supports the new Economy System, allowing you to create virtual currencies, in game economies and so much more. Read more in our blog post announcing the release.

2023-09-29 - Changelog

Web Console

Bug Fixes

  • Fixed issue with not being able to view players using the legacy Google platform

Unity SDK

Changes

  • GetProgressionTier - You can now get the tiers in a progression!
  • Admin extension - If you're using Unity 2021 or newer, look at a new way to manage API Keys inside Unity! You can find it under Tools/LootLocker/Menu on the top of Unity!

Bug Fixes

  • Fixed the MacFsWatcher include error
  • Errors return correctly again

2023-09-22 - Changelog

Unreal Engine

Changes

LootLocker Unreal SDKs now support Unreal Engine 5.3 🎉

2023-09-15 - Changelog

Web Console

Bug Fixes

  • Fixed an issue where the price on assets could be hidden by mistake in a situation where it should be shown.

Game API

Bug Fixes

  • A bug was fixed which had caused duplicate white label users to be created. The duplicate users have been removed, but this means some white label users who changed their password, might have the wrong password on their user now.

Admin API

Changes

2023-09-08 - Changelog

Web Console

Changes

  • Users will be asked to confirm their game name on game deletion as an extra precaution

Unity SDK v1.2.5

Changes

  • Meta/Oculus - Added support for authentication using Meta/Oculus
  • Last active authentication - You can now query the SDK through GetLastActivePlatform() to see which authentication method was last used on this device
  • Heroes - The SDK now supports interaction with the hero feature.
  • List Player Characters - A new method to list all the characters that a player has
  • Improved error messages - We are revamping how we deal with error messages (See https://docs.lootlocker.com/reference/error-codes) and the SDK now supports this structure. This means that the old Error data (response.Error) has been deprecated, the same data now lives inside the field response.errorData.message. Along with it, you now have the new fields code, doc_url, request_id, and trace_id for improved ability to find the fix for your problem.

Unreal SDK v2.0.11

Changes

  • Multiple Google Platforms - Google sign in now supports signing in from different google platforms.
  • Last active authentication - You can now query the SDK through GetLastActivePlatform() to see which authentication method was last used on this device
  • Meta/Oculus - Added support for authentication using Meta/Oculus
  • Obfuscation - The SDK now obfuscates sensitive data before logging
  • List Player Characters - A new method to list all the characters that a player has

Bug Fixes

  • Replace the game key with the Session Token in custom headers

Unreal Server SDK

Changes

  • Support for UE 4.24 and up - LootLockerServerSDK now supports all Unreal versions from 4.24 to 5.2
  • Asset instance progressions - You can now use progressions on asset instances
  • Diagnostics data added to request headers.

Bug Fixes

  • Guest player lookup now uses the correct search term
  • Hero methods use the correct HTTP methods
  • HTTP Client is only created once

2023-09-01 - Changelog

Web Console

Changes

  • Our new pricing is released, and you can now see it in the console! You can read more about it here: https://lootlocker.com/blog/new-pricing-2023

Bug Fixes

  • You can once again delete Server API keys in the console.
  • The colors for the player list environment pill now follow the same color scheme as the rest of the console.
  • Fixed an issue where Data Entities couldn’t be deleted

Game API

Changes

  • We have improved the performance and reliability of session registration for Sign in with Apple and Google Sign In.

2023-08-18 - Changelog

Web Console

Changes

  • You can now choose which of your Asset Image Types to use as a thumbnail in the LootLocker Console! Go here to set it up: https://console.lootlocker.com/assets/settings/image-types

Game API

Changes

  • A large rework of Player Storage has been completed this week, resulting in much better performance and stability. We did have a few issues immediately surrounding the launch of this as some of you might have noticed. These have been resolved and everything is running smoothly now!

Bug Fixes

  • Fixed issue where promoting asset candidates with thumbnails attached, would not work for some games.

Admin API

Changes

  • Added the ability to mark an Asset Image Type as thumbnail, resulting in thumbnail images being returned in the Admin API.

2023-08-11 - Changelog

Web Console

Changes

  • We have introduced Access Control which allows you to control which users have access to which features. This is a feature that has been requested by many of you and we are happy to finally be able to provide it. You can find it in the Game Settings page. You can also read more about it here: https://lootlocker.com/blog/access-control
  • Updated the side menu for Assets, moving Contexts from Game Settings to the Asset menu
  • Improved the Add Asset menu, making it possible to create Contexts when creating new Assets
  • Users can update their name in settings

Admin API

Changes

  • Added support for Access Control

Documentation

Our documentation has seen various updates and improvements these last few weeks, including:
  • Updated screenshots for the Web Console
  • Updated and improved examples for both Unreal Blueprints, C++ and Unity
  • We have added a section on getting help: https://docs.lootlocker.com/support/getting-help

2023-07-07 - Changelog

Game API

Bug Fixes

  • Fixed an issue related to White Label Login, where enabling “Block Unverified Players” would not function correctly, causing player to not be prevented from logging in. It now works as intended.

2023-06-30 - Changelog

Unreal SDK

Changes

  • Apple Game Center Authentication - We've added support for authentication using Apple Game Center, for more information check out: https://docs.lootlocker.com/players/authentication/apple-game-center 🍏
  • Instance Progressions - We've added a new feature called instance progressions: your asset instances can now have their own progressions 🎉
  • Add more validation when setting player names

Bug Fixes

  • Google session requests now use the correct request object

Unity SDK

Changes

  • Add support for asset instance progressions
  • Implement support for multiple Google Sign-in platforms
  • Player Files Examples added
  • Add more validation when setting player names

Bug Fixes

  • Fix an issue with 'Other character' methods
  • Removed unnecessary warning logs

Server API

Bug Fixes

  • We stomped out an oddly shaped bug that would cause a few endpoints to return completely empty responses in some cases. 🐛

Admin API

Bug Fixes

  • Rejoice! The Last Seen property on players have made a return and can now be relied upon again 📆

2023-06-23 - Changelog

Web Console

Bug Fixes

  • Fixed an issue with player file revisions not listing properly

Unity SDK

Changes

  • New examples for Player Files

Game API

Changes

  • Added support for asset instance progressions

Server API

Changes

  • Added support for asset instance progressions

Admin API

Changes

  • Added support for asset instance progressions

2023-06-16 - Changelog

Web Console

Bug Fixes

  • The web console has seen a lot of behind the scenes improvements this week, which will result in a more stable and performant experience for you.

2023-06-09 - Changelog

Web Console

Bug Fixes

  • Corrected issue where inactive assets were not filtered out when granting an asset to a players inventory.

2023-05-26 - Changelog

Web Console

Bug Fixes

  • Fixed an issue where searching in the player list would not return correct info on exact matches.
  • Fixed a bug related to rendering drop tables in game merging, causing the entire page to crash.

Admin API

Bug Fixes

  • Fixed an issue where sometimes game merging would report with no changes even if there were changes to merge.

2023-05-19 - Changelog

Web Console

Bug Fixes

  • Fixed a bug with progression tiers incorrectly counting the next step and points

2023-05-12 - Changelog

Web Console

Changes

  • Multiple types of OAuth2 Client ID’s can now be configured for Google Sign In in the platform settings.
  • AngularJS removed - the console now runs only on React/NextJS.
  • Character Classes had a facelift from AngularJS to React.

Bug Fixes

  • Fixed an issue with switching environment on Asset pages.
  • Fixed an issue with ordering of assets on the Asset page.

Unity SDK

Release v1.2.2

Changes

  • Apple Game Center: The SDK now supports using Apple Game Center as authorization system.
  • New samples for using the fresh progressions system.
  • Expired sessions will now automatically try to refresh if there is a refresh token.

Bug Fixes

  • Fixes for GetPlayerStorage.
  • Fixes for incisistent line endings warnings.

Game API

Changes

  • Google Sign In now supports multiple types of OAuth2 Client ID’s.

2023-04-28 - Changelog

Web Console

Changes

  • You can now delete your own games. Find it in Game Settings.

Unity SDK

Release v1.2.0

Bug Fixes

  • Fixed the build errors of namespace Plastic not existing. We have moved to using an internal JSON library which you can find here: This removes the reliance on Newtonsoft all together. Please be vigilant for any bugs or errors that are caused by JSON parsing in the next few weeks and let us know.

2023-04-21 - Changelog

Web Console

Changes

  • Released small UI revamps for Segments, Heroes and Missions
  • We have removed the Metrics page from the Web Console. It was part of our legacy feature set and most of the numbers were inaccurate

Unity SDK

Released v1.1.48

Changes

  • Adds possibility to get persistent storage as dictionary
  • Adds ability to update public key values for a player
  • Makes client side timeout limit configurable

Bug Fixes

  • Fixed the Newtonsoft compiler errors when adding the SDK to Unity
  • Adds safeguard to avoid uploads of null files

2023-03-31 - Changelog

Web Console

Bug Fixes

  • Fixed an issue with the player pages, where players from Google and Epic Games would break the frontend.
  • Fixed an issue where Asset ULIDs would show up as changes in Game Merge, when it shouldn’t
  • Fixed an issue where creating a context, but using the default complexity, would set the wrong complexity in the backend. Issue is resolved and data has been updated for existing games which encountered this issue.

Unreal SDK

Changes

  • Epic Sign In - Added methods StartEpicSession and RefreshEpicSession, for more information go to our documentation
  • All LootLocker Responses now have an Error property (if there is an error) that is a cleaned up version of the FullTextFromServer property

Unity SDK

Changes

  • Epic Sign In - Added methods StartEpicSession and RefreshEpicSession, for more information go to our documentation
  • Added a method to register a progression without adding points to it

Bug Fixes

  • Added a client side rate limiter to avoid being blacklisted due to improper usage

Game API

Bug Fixes

  • Fixed an issue where starting sessions for Google and Epic required you to send development_mode in the request, this is no longer the case

2023-03-24 - Changelog

Web Console

Changes

  • Messages, Mission settings, asset rarirites, context settings and DLCs have had a facelift from old Angular to new React
  • Asset filters now auto-open when you add a new one
  • You can now require players to have unique names in your game. Change it in your games settings

Bug Fixes

  • Fixed an issue with adding lootboxes to assets

Game API

Changes

  • Added support for Epic Games Sign in
  • If you have Unique Player Names enabled in your games settings, you will now receive an error if you try to set a name that is already taken

2023-03-17 - Changelog

Web Console

Changes

  • The old progressions system has been hidden from the user interface.
  • We’ve colour coded the sidebar to make it more identifiable when you’re in staging and live. Stage mode remains green, and Live presents as Orange. Let us know what you think!

Bug Fixes

  • Leaderboards will now warn you if you try to create one with a conflicting key
  • Fixed an issue where clicking save on Image Types would create multiple
  • Fixed an issue allowing collectables to be created in Live mode
  • Fixed an issue with the validation of Max Title and Max Summary lengths
  • Fixed an issue with collectables sometimes returning an error
  • Fixed an issue allowing triggers to be created in Live mode
  • Fixed an issue with Nintendo icon on players

Game API

Changes

  • We’ve decided to turn on player verification for all new games, for Steam and PlayStation sessions. This means all sessions created for these platforms will need to be verified before the session can start. If you want to have this enabled for your existing game, please reach out on our discord or on email.

Bug Fixes

  • Fixed an issue where some errors were not being returned correctly when starting guest and steam/psn/android sessions. It should be easier to figure out what an error is now.

2023-03-10 - Changelog

Unity SDK

Changes

  • The SDK now supports Google Sign In
  • The SDK will now automatically resolve and use the domain API if the domain key is set
  • The SDK will now store and automatically use the Apple and Google refresh tokens if not done manually

Bug Fixes

  • The SDK now supports Enter Play Mode Options allowing you to speed up your development process
  • The SDK will now now relies on a newer version of Newtonsoft
  • The SDK will no longer silently discard requests with an expected body that is null
  • Player and Asset Reports now have a message instead of a text
  • Requests are now allowed to timeout
  • Local session data is now cleared upon ending a session and deleting a player

Unreal SDK

Changes

Bug Fixes

  • StartSteamSession now sets the correct platform
  • Fixed Critical WhiteLabel bug that caused white label sessions to fail for old Unreal projects

Game API

Changes

  • Google Sign In - Game API now supports starting player sessions using Google ID tokens

2023-03-03 - Changelog

Web console

Bug Fixes

  • Fixed an issue making it impossible to clear leaderboards
    • We still have a known issue where the UI won't show success when clearing leaderboards, but it does work

2023-02-24 - Changelog

Web Console

Changes

Your asset page has had an overhaul! With an updated design more in line with the rest of the web console, you’ll also find some stability improvements. We’re not perfect however, and if you find something not working as it should, you still have access to the legacy page for now.

2023-02-17 - Changelog

Web Console

Changes

  • Overhauled Progression System: We're excited to give you a new feature. Learn more under Progressions.
  • Platform keys and other sensitive information are now behaves like a password input, with toggleable visibility, except the first four characters are visible for easy identification.
  • Assets in the asset list and grid views are now able to be filtered by their context type eg. Soft Currency Package, Feature Unlocks, or any of your custom contexts.
  • You can now see player file revisions in the Player files section and revert to previous versions of the file.

Unreal SDK

Changes

  • Overhauled Progression System: We're excited to give you a new feature. Learn more under Progressions.
  • Major overhaul of LootLocker settings
    • Deprecated Platform selector: No need to set the platform here, instead you should use the appropriate StartSession method for your platform.
    • Deprecated legacy API keys (that don't start with dev or prod): If you're on one of those, generate new keys and use those instead
    • Clarified descriptions