LootLocker_UnitySDKv3.3.0

Features

• Triggers 2.0 🕹️ - We’re excited to announce the re-release of one of LootLocker’s most versatile features—Triggers! This feature has undergone a complete overhaul and is now fully integrated with the same cross-feature rewards system that powers all our latest features. Triggers let you create and manage in-game actions tied to specific rewards, opening up countless opportunities to engage your players. Read more here
• Notifications 💬 - Notifications serve as a shared system that integrates seamlessly with multiple features, including Rewards, Leaderboards, Catalogs, Progressions, and Triggers. Acting as a central hub, Notifications track and communicate important player-related updates to the game, ensuring players stay informed about significant events and changes. Read more here
• .com - The LootLocker api has transitioned to .com instead of .io in preparation for an eventual potential phase out of the TLD.
• The version of the LootLocker SDK is now logged at start up time to help when reaching out to the team for support.
• All session responses now contain the wallet_id of the player.
• The define symbol LOOTLOCKER_DISABLE_EDITOR_EXTENSION has been added so that it is possible to disable the LootLocker editor extension.

Bug Fixes

• The LootLocker editor extension no longer logs out on compiles and builds.

Deprecations

• With the introduction of Triggers 2.0, the old triggers system is deprecated. Adressing this will require you to re-configure your triggers in the new triggers configuration. To do this, please refer to our documentation. Once you have done this, simply call the new InvokeTriggersByKey method in place of the ExecuteTrigger method. For a deeper understanding of using triggers in game, refer to our documentation.
• Group leaderboard rewards no longer contain the metadata field as it's no longer returned from the backend.

Full Changelog: v3.2.0...v3.3.0

LootLocker_UnitySDKv3.2.0

Features

• Metadata 🎉 - We're introducing the feature Metadata. Metadata brings a new level of flexibility to our existing systems allowing you to store custom information in several key places such as leaderboars, catalog items, and progressions. Read more in our blog post
• This is mostly internal, but our continuous integration has received a much needed overhaul. See the Readme for details about how to run the tests.

Bug Fixes

• Json serializer now serializes enums as strings instead of numbers
• Leaderboard details now return ulids
• The is_default field in classes and heroes is now correctly de-serialized.

Full Changelog: v3.1.0...v3.2.0

LootLocker_UnitySDKv3.1.0

Features

• Feedback 🎉 - We're introducing the feature Feedback. With this feature you can easily add a feedback loop into your game. Be it to moderate UGC, get bug reports from players, or to let players report malicious behaviour, this new system supports it all. Read more in our blog post
• Listing leaderboards - The SDK now has the ability to list the available leaderboards helping you if you have generated or seasonal leaderboards for example.
• Virtual Currency Purchasing Sample - We've added a sample to the SDK that shows you how you can implement an in game store with virtual currencies.
• Retry-After Header support - The SDK now supports the Retry-After header, so if a requst fails for a reason that is retryable and the LootLocker backend returns a Retry-After header, you can find that value in the response.

Bug Fixes

• Silenced the rate limiter logs when entering playmode.
• Fixed a bug in ZeroDepJSON that made generic objects that were members of a non generic object unparseable.
• When updating keys in persistent player storage the SDK now correctly handles the returned "public" fields.

Deprecations

• Renamed class LootLockerGetPersistentStoragResponse to LootLockerGetPersistentStorageResponse. Please use the new LootLockerGetPersistentStorageResponse class from now on.
• Renamed class LootLockerGetPersistentStoragResponseDictionary to LootLockerGetPersistentStorageResponseDictionary. Please use the new LootLockerGetPersistentStorageResponseDictionary class from now on.

Full Changelog: v3.0.0...v3.1.0

LootLocker_UnitySDKv3.0.0

Features

• Reward Groups - In leaderboards and catalogs you can now create groups of rewards. Read more here
• Added a method for getting a single item from the entitlement history
• The LootLocker SDK settings now help you in giving the correct domain key as there has been some confusion around domain key and domain url

Bug Fixes

• Fixed a bug that caused crashes if the responses were for some reason not json

Deprecations

• Due to the new feature of groupable rewards in catalogs, how you get information from the details dictionaries has changed. Before you would do for example

var entry = response.entries[0]; //Get the entry you're looking at
if(entry.entity_kind) {
  response.asset_details[entry.catalog_listing_id]
}

Now you will instead do

var entry = response.entries[0]; //Get the entry you're looking at
if(entry.entity_kind) {
  response.asset_details[entry.GetItemDetailsKey()];
}

Full Changelog: v2.2.0...v3.0.0

Lootlocker_UnitySDKv2.2.0

Features

• Entitlement History - You can now retrieve a list of the player's historical entitlements. Use this to retrieve information on entitlements the player has received regardless of their origin (for example as an effect of progression, purchases, or leaderboard rewards)
• You can now verify a steam player for a specified Steam App Id allowing your game to support multiple steam app ids (if you're for example splitting your beta out in a separate id)

Full Changelog: v2.1.5...v2.2.0

Lootlocker_UnitySDKv2.1.5

Features

• 🎉Added leaderboard scheduled resets and rewards 🏅- You can now configure resettable leaderboards, get the previous iterations of the leaderboards, and add rewards to your leaderboards. Read more here: https://lootlocker.com/blog/leaderboard-resets-rewards
• Added a convenience method that both verifies a steam player and then starts a steam session that will replace the two calls to the verifyplayer and startsteamsession methods.

Bug Fixes

• All session responses now contain player_name
• Made hero_equip_exceptions into an array
• Fixed a warning from the LootLocker extension about resetting LootLockerServerAPI class

Deprecations

• LootLockerSDK version 2.1.5 sees us move from the Unity Asset Store to to OpenUPM as our registry and the primary way of getting the LootLocker SDK for your Unity game. You can read more here: https://docs.lootlocker.com/reference/deprecation-guide/unity-sdk-deprecation-log/version-2.1.5-migration-to-open-upm

Full Changelog: v2.1.4...v2.1.5

Lootlocker_UnitySDKv2.1.4

Features

• In-App Purchase 💸 Steam store listings are added to catalog!
• Admin Extension is back! With new UI, helping you manage api keys easier than ever!

Deprecations

• Deprecated a poorly named function BeginSteamPurchaseRedemption(string entitlement_id... use QuerySteamPurchaseRedemption(string entitlement_id... instead!
• Legacy IAP methods have been marked deprecated.

Bug Fixes

• Increased client side timeout to 180s (3m)
• Calling errorData.ToString(); now returns a string formatted message, use this if you encounter errors!

Full Changelog: v2.1.3...v2.1.4

Lootlocker_UnitySDKv2.1.3

Features

• Unified Player Accounts - We're introducing a new feature called Unified Player Accounts and the concept of connecting accounts. This lets you add more than one authentication method to a LootLocker account enabling powerful cross platform functionality. Stay tuned for in detail guides.
• Steam In App Purchases - LootLocker now supports in app purchases using steam.
• Game Version help - We've added some guidance on how to utilize the game version configuration field

BugFixes

• Added missing UUID from asset classes
• acquisition_date is now nullable

Full Changelog: v2.1.2...v2.1.3

Lootlocker_UnitySDKv2.1.2

Features

• In App Purchases for Apple and Google: 🎉🪙 We have added support for in app purchases for IAP for Apple and Google. This feature is under review and the documentation and guides will be coming shortly.
• 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.

BugFixes

• The catalog now correctly handles the 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

Full Changelog: v2.1.1...v2.1.2

Lootlocker_UnitySDKv2.1.1

Bug Fixes

• We have fixed a bug that caused our LootLockerServeriApi to never destroy itself when it should, thus resulting in errors.