Glossary

Game Version

To distinguish and order the versions of your game LootLocker requires that you utilize a numeric version of the Semantic Versioning standard. This is used in different API calls when using the REST API, and in the SDKs it is a required setting to use the SDK.

A numeric semver string consists of between 2 and 4 numbers separated by periods: X.Y(.Z.B). Some valid numeric semver strings would be 1.0, 0.0.2.6, 23.6.13. According to semver standard the position of the numbers is significant and can greatly help you in showing what a version "means". The positions are named MAJOR.MINOR.PATCH.BUILD. For LootLocker, the Patch and Build numbers are optional.

MAJOR - Increment this number when you make incompatible and/or very significant changes. This could for example be a complete re-balance of classes, a re-engineering of a crucial system, or a change that makes previous save files unreadable.

MINOR - Increment this number when you change something that isn't crucial, or add stuff to previous systems. This could be for example adding an achievement, moving assets within a level, or making internal tech changes only.

PATCH - This is optional for LootLocker. Increment this number when you make a small change that is very unlikely to have a significant impact on your users. This could be for example a bug fix, some localization changes, or chaning the color of UI items.

BUILD - This is optional for LootLocker. Increment this number when you produce a new build for an existing version. If you for some reason need to distribute a rebuild of version 1.2.3 without additional changes then use this number to make a version 1.2.3.1.

Identity Provider

Identy provider is the term we use to describe the service used to authenticate the player. This could be a 1st party platform like Steam, Google and Apple, but also White Login or even Guest Login.

This term is an umbrella term for all the different ways a player can authenticate with your game.

LootLocker Player Identifiers

There are a few different ways to identify a player that permeates the LootLocker systems. This is due to our service evolving over time. While we aim to remove usages of legacy identifiers, you are likely to run into methods using a few of these.

Player ULID

This is the standard identifier for players across LootLocker's systems. ULID stands for Universally Unique Lexicographically Sortable Identifier and is an industry standard identifying method that is practical for many applications.

The player ulid can in different endpoints be referred to as player_ulid, player_id, ulid, or simply id. Regardless, you can recognize it by its string representation format which is a long string (usually 26 characters) of alphanumeric characters. Example: 01BX5ZZKBKACTAV9WEVGEMMVRZ.

You can find it in all game api session responses (in both api and SDKs), in the server Get Player Info by Game Session Token endpoint (in both api and SDKs), or get it from another player identifier using the Game or Server Lookup Player Names by IDs endpoint (in both api and SDKs), and in the LootLocker console player view:

Player UID

This is a shorter identifier mainly to be used for public player display. The purpose is to have a shorter identifier that players can write down and share. UID simply stands for Unique Identifier.

The player uid can in different endpoints be referred to as player_uid, player_public_uid, or uid. Regardless, you can recognize it by its string representation format which is a shorter string (usually 12 characters) of alphanumeric characters. Example: AG5SG99GAJ5R.

You can find it in all game api session responses (in both api and SDKs), or get it from another player identifier using the Game or Server Lookup Player Names by IDs endpoint (in both api and SDKs), and in the LootLocker console player view:

Player ID (Legacy)

This is a numerical identifier of the player. This identifier, although still used in many endpoints, is deprecated and LootLocker is phasing it out.

The player id can in different endpoints be referred to as player_id, player_legacy_id, legacy_id, or id. Regardless, you can recognize it by that it's the only integer identifier of a player. Example: 9698530.

You can find it in all game api session responses (in both api and SDKs), in the server Get Player Info by Game Session Token endpoint (in both api and SDKs), or get it from another player identifier using the Game or Server Lookup Player Names by IDs endpoint (in both api and SDKs), and in the LootLocker console player view:

Player Identifier

This one is strictly related to guest login. The player identifier is the unique id that "authenticates" a guest user. As such, this is supposed to be a secret for the player that uses it. Any user with access to a player identifier can start a session as that guest user.

The player identifier can in different endpoints be referred to as player_identifier, player_guest_login_id, or identifier. Regardless, you can recognize it by its string representation format. Example: eefecf08-3b6c-4eec-82f6-322d41d1f2fd.

You can find it in the game api guest session response (in both api and SDKs), and in the LootLocker console player view:

Player Platform Identifier

This varies a lot, because there are a few. But you can also identify a player by their external id with another platform or authentication. This can be for example their White Label Email, their Steam ID, or their xbox id.

The player platform identifier can in different endpoints be referred to as player_platform_identifier, platform_identifier, or by their platform such as steam_id or psn_id.

You can find it in the Game Lookup Player Names by IDs endpoint (in both api and SDKs), or in the LootLocker console player view on the right side. Here's an example of how it looks for a Steam player (note that there can be many identifers here for unified player accounts):

Player Name

This is a lot more decorative than other identifiers. But can be uniquely identifying players if you enable Use Unique Player Names in your game.

The player platform identifier can in different endpoints be referred to as player_name, or simply as name.

This is the only "identifier" that the player can change, using the Game Set Player Name endpoint (in both api and SDKs). You as an admin can also change this value for a player in the console player view.

You can find it in all game api session responses (in both api and SDKs), or get it from another player identifier using the Game Lookup Player Names by IDs endpoint (in both api and SDKs), and in the LootLocker console player view: