White Label Login

Search…
White Label Login
White Label Login provides a way for you to have an email/password login not tied to any of the big platforms.
This is great for more advanced use cases, like making it possible for your players to sign in on your website with the same account they're using in the game.
Before using the SDK you must first enable and configure the White Label Login in Platform Settings​
Create a New User
Before we can register a session in the game, a user must first be created.
Passwords must be at least 8 characters long.
Unity
Unreal
1
// Remember to use the LootLocker namespace in the top of your file.
2
using LootLocker.Requests;
3
​
4
// This code should be placed in a handler when user clicks the sign up button.
5
string email = "[email protected]";
6
string password = "password here";
7
LootLockerSDKManager.WhiteLabelSignUp(email, password, (response) =>
8
{
9
    if (!response.success)
10
    {
11
        Debug.Log("error while creating user");
12
​
13
        return;
14
    }
15
​
16
    Debug.Log("user created successfully");
17
});
Copied!
White Label Login is not yet implemented in the Unreal SDK. 
If you need this feature, please let us know on our Discord server.
Logging in the User
White label login works a little differently than other platforms in the sense that we first have to create a white label login session, which is then used to create a game session.
When the player is logged in, the SDK will save the token, so you don't have to send it to StartWhiteLabelSession
Unity
Unreal
1
// Remember to use the LootLocker namespace in the top of your file.
2
using LootLocker.Requests;
3
​
4
// This code should be placed in a handler when user clicks the login button.
5
string email = "[email protected]";
6
string password = "password here";
7
bool rememberMe = true;
8
LootLockerSDKManager.WhiteLabelLogin(email, password, rememberMe, response =>
9
{
10
    if (!response.success)
11
    {
12
        Debug.Log("error while logging in");
13
        return;
14
    }
15
​
16
    string token = response.SessionToken;
17
    
18
    // Start game session here
19
});
Copied!
White Label Login is not yet implemented in the Unreal SDK. 
If you need this feature, please let us know on our Discord server.
Handle Returning Player
We don't want a player to have to type in their email and password every time they start the game, so for this we can re-use the session token provided by the WhiteLabelLogin call multiple times.
By default a session token is good for 24 hours, but if you send remember me to true a session will last for 30 days. Remember that these sessions are disconnected from the game session, so you still want to create a game session every time the player opens your game.
The length of a remember session can be changed in platform settings for White Label Login.
When a player opens the game we first want to check if they have a previous session we can use:
Unity
Unreal
1
// Remember to use the LootLocker namespace in the top of your file.
2
using LootLocker.Requests;
3
​
4
LootLockerSDKManager.CheckWhiteLabelSession(response =>
5
{
6
    if (response)
7
    {
8
        // Start a new session
9
        Debug.Log("session is valid, you can start a game session");
10
    }
11
    else
12
    {
13
        // Show login form here
14
        Debug.Log("session is NOT valid, we should show the login form");
15
    }
16
});
Copied!
​
Depending on the response from this code we can either show the login form and ask for email and password again or we can start a game session.
Register a Game Session
After creating a session token we can register a game session. When the session has been registered you can use other LootLocker features in your game.
​
Unity
Unreal
1
// Remember to use the LootLocker namespace in the top of your file.
2
using LootLocker.Requests;
3
​
4
// This code should be placed in a handler when user clicks login button.
5
LootLockerSDKManager.StartWhiteLabelSession((response) =>
6
{
7
    if (!response.success)
8
    {
9
        Debug.Log("error starting LootLocker session");
10
​
11
        return;
12
    }
13
​
14
    Debug.Log("session started successfully");
15
});
Copied!
To learn more about sessions you can read our page on Understanding the Session Registration Response​
White Label Login is not yet implemented in the Unreal SDK. 
If you need this feature, please let us know on our Discord server.
Request Password Reset
If they user wants to reset their password we can use the following code to send them an email with a link to a reset password page.
The page is hosted on LootLocker and will use the settings in Platform Settings for name and logo.
Unity
Unreal
1
// Remember to use the LootLocker namespace in the top of your file.
2
using LootLocker.Requests;
3
​
4
// This code should be placed in a handler when user clicks reset password.
5
string email = "[email protected]";
6
LootLockerSDKManager.WhiteLabelRequestPassword(email, (response) =>
7
{
8
    if (!response.success)
9
    {
10
        Debug.Log("error requesting password reset");
11
​
12
        return;
13
    }
14
​
15
    Debug.Log("requested password reset successfully");
16
});
Copied!
White Label Login is not yet implemented in the Unreal SDK. 
If you need this feature, please let us know on our Discord server.
​
Steam
Last modified 2mo ago
Copy link
Contents
Create a New User
Logging in the User
Handle Returning Player
Request Password Reset