About • Installation • Configuration • Updating • Support • Development
LootLocker is a game backend-as-a-service that unlocks cross-platform systems so you can build, ship, and run your best games.
Full documentation is available here https://docs.lootlocker.com/
The preferred way of installing the LootLocker SDK is through Open UPM. This way you will receive future updates in a streamlined way. Please refer to OpenUPM for their simple install instructions or our official documentation.
Before you start you need to have git installed on your computer.
- In the Unity Editor go to
Window > Package Manager - Click the + at the top left of the Package Manager window
- Select
Add package from git URL... - Paste the following URL
https://github.com/LootLocker/unity-sdk.gitand clickAdd
For other methods, please refer to our official documentation.
For a full walkthrough of how to configure the SDK, please see our Guide to Configuring the Unity SDK. But here's a short explanation:
- Open the LootLocker Extension in Unity (Windows > LootLocker)
- Sign in with your LootLocker account
- Select your game, environment, and game key.
- Log on to the LootLocker management console and find your Game Settings.
- Find your Game Key in the API section of the settings
- Open
Edit > Project Settingsin the Unity Editor and find theLootLocker SDKtab. - Input Api Key using the Game Key from the LootLocker console page
If you have installed the SDK from Open UPM then all you have to do in Package Manager is press the Update button when that tells you there's a new version.
For other install methods and more information, head over to our official documentation.
The SDK ships a link.xml at the package root that preserves the types and members it reaches through reflection when deserializing server responses. The Unity linker only reads link.xml files that live under your project's Assets/ folder, so the SDK registers its own file with the linker through an IUnityLinkerProcessor (Runtime/Editor/LootLockerLinkXmlProcessor.cs). This happens automatically — no setup required.
If you enable Managed Stripping Level (Medium or High) in Player Settings, do not delete the package's link.xml or the processor. Without them, responses deserialize into non-null objects whose members are all default values, which fails silently rather than throwing.
If you need to add preservations for your own types, put them in a separate link.xml under your project's Assets/ folder. Multiple link.xml files are supported and are merged by the Unity linker.
If you have any issues or just wanna chat you can reach us on our Discord Server
Status: 
To set up the tests, you must add our package to the manifest.json testables underneath dependencies. Your manifest.json should look something like this:
{
"dependencies": {
"com.lootlocker.lootlockersdk": "https://github.com/lootlocker/unity-sdk.git",
many more dependencies...
},
"testables": ["com.lootlocker.lootlockersdk"]
}Once you have done this, you can go into Unity and go to Window -> General -> Test Runner. This will open a new window which should already include all the tests available, Then all you have to do is press Run All and the tests will begin.
If you are running the tests towards the LootLocker production environment you will need to provide a username and password to an existing user either by setting the values directly in LootLockerTestConfigurationUser::GetProductionUser or via command line arguments -adminemail and -adminpassword. Bear in mind that your tests will be rate limited when running towards production (and in general this is a bad idea).