unreal-server-sdk

LootLocker Unreal Server SDK

About • Installation • Configuration • Sample App • Support

---

About

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

Installation

For a more detailed guide on installation, please see our User Documentation

1. Download the latest Unreal Package release or clone the repo.
2. Copy the LootLockerServerSDK folder.
3. Paste the LootLockerServerSDK folder into the plugins folder created in the root of your project (create if it doesn’t exist)
4. Right-click on the “Unreal Engine Project Launch” file in the root of your project and click on “Generate Visual Studio Project Files”
5. Open the .sln file of your project
6. Open your project’s Build.cs file

7. Add LootLockerServerSDK to the PublicDependencyModuleNames list

   Example:

    PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "InputCore", "LootLockerServerSDK" });
   

8. Add {"HTTP", "Json", "JsonUtilities"} to the PrivateDependencyModuleNames list

   Example:

    PrivateDependencyModuleNames.AddRange(new string[] { "HTTP", "Json", "JsonUtilities" });
   

Configuration

Editor Configuration

1. Navigate to Edit/Project Settings in the editor, Scroll down on the left panel until the plugins sections of the project settings, Click on LootLockerServerSDK
2. Modify the LootLockerServerKey, Domain Key, Game Version, and AllowTokenRefresh (Set to true if you want the LootLockerServerSDK to attempt to refresh the token if it expires). What values to set, you can find in the LootLocker dashboard. You should already have an account from https://console.lootlocker.com/login

Command Line Configuration

The LootLocker Server SDK supports command line configuration, which is useful for CI/CD pipelines, automated testing, or running different environments without modifying project settings.

How to Use

All config properties marked with UPROPERTY(Config, ...) in ULootLockerServerConfig are automatically exposed and can be overridden at runtime.

Example:

# Override LootLockerServerKey and GameVersion from the command line
MyGame.exe -ini:Game:[/Script/LootLockerServerSDK.LootLockerServerConfig]:LootLockerServerKey=your_key -ini:Game:[/Script/LootLockerServerSDK.LootLockerServerConfig]:GameVersion=1.0.0

More Examples:

# Dev environment
MyGame.exe -ini:Game:[/Script/LootLockerServerSDK.LootLockerServerConfig]:LootLockerServerKey=dev_abc123xyz -ini:Game:[/Script/LootLockerServerSDK.LootLockerServerConfig]:LootLockerDomainKey=mydevdomain -ini:Game:[/Script/LootLockerServerSDK.LootLockerServerConfig]:GameVersion=1.0.0

# Production with verbose logging
MyGame.exe -ini:Game:[/Script/LootLockerServerSDK.LootLockerServerConfig]:LootLockerServerKey=dev_xyz789abc -ini:Game:[/Script/LootLockerServerSDK.LootLockerServerConfig]:LimitLogLevelTo=Verbose -ini:Game:[/Script/LootLockerServerSDK.LootLockerServerConfig]:LogFileName=ProdLog

Notes

• This method works for any property marked with Config in the plugin’s config class.
• Overrides are applied at startup and take precedence over values set in the editor or config files.
• For more details, see Unreal’s documentation on Command Line Arguments and Config System.

Support

If you have any issues or just wanna chat you can reach us on our Discord Server

This site is open source. Improve this page.