Changelog.

We have updated how errors in the LootLocker web console are displayed.

When recieving an error you now are provided with plain-text information about what went wrong as well as a Trace ID that you can copy and share in Discord so that we can help fix the problem.

A new feature has been added to the API that allows you to specify a list of domains that are allowed to make requests to the API. This is useful if you want to restrict access to the API to only your own domains.

Documentation can be found here.

We have exposed a new setting in the LootLocker Console to allow you to configure whether or not the player name should be updated from the Identity Provider (eg. steam) when a session starts.

This is useful for games that do not want to update the player name on every session start, but only when the player explicitly changes their name in the game.

This setting is available in the Console under in "Game Settings", under the "Misc" tab. Look for "Preserve Player Names on Session Start".

It's now possible to create reward groups in LootLocker.

• Reward groups allows multiple rewards to be awarded to a player at once.
• This is currently available for catalogs and leaderboards rewards.

To learn more you can read our announcement post.

An update to leaderboards have been released, allowing for scheduling of resets and rewards.

• CRON expressions can be used to schedule resets.
• Rewards can be awards to players based on their leaderboard position.

To read more about leaderboard scheduling you can read our announcement post or go straight to the documentation.

White Label Login

Bug Fixes

• Fixed an issue where an unrelated topbar would show on the reset password and verify user pages
• Fixed an issue where the game logo would not show on the reset password page

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

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

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