Handle Returning Users

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 reuse 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

// Remember to use the LootLocker namespace in the top of your file.
using LootLocker.Requests;

LootLockerSDKManager.CheckWhiteLabelSession(response =>
{
    if (response)
    {
        // Start a new session
        Debug.Log("session is valid, you can start a game session");
    }
    else
    {
        // Show login form here
        Debug.Log("session is NOT valid, we should show the login form");
    }
});

Unreal

This functionality is not yet implemented in the Unreal SDK

REST

curl -X POST "https://api.lootlocker.io/white-label-login/verify-session" \
  -H "domain-key: 11aaa11" \
  -H "is-development: true" \
  -H "Content-Type: application/json" \
  -d "{\"token\": \"afccd38d-09d5-48aa-8235-b9c4c9151596\", \"email\": \"[e-mail]\"}"

Example response:

{
  "game_id": 2,
  "user_id": 406,
  "email": "[e-mail]"
}

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.

Request Password Reset

If the user wants to reset their password we can use the following example 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

// Remember to use the LootLocker namespace in the top of your file.
using LootLocker.Requests;

// This code should be placed in a handler when user clicks reset password.
string email = "[e-mail]";
LootLockerSDKManager.WhiteLabelRequestPassword(email, (response) =>
{
    if (!response.success)
    {
        Debug.Log("error requesting password reset");

        return;
    }

    Debug.Log("requested password reset successfully");
});

Unreal

This requires that you have set up the Unreal SDK in your game.

Blueprint example of password reset for a White Label User

Above is an example of how to implement password reset for a White Label user using blueprints in Unreal Engine. For an example you can copy and paste into your editor, look here.

Input

You need to exchange the TriggerWhiteLabelResetPasswordevent for whatever event you want to use to trigger the login flow.

You also need to replace the node REPLACE: Input with the users email usually collected from user input.

Output

We recommend branching the completed events on the success flag, and if you do this you will probably want to add error handling in case the request fails as well as what (if any) continued actions you want on success.

REST

curl -X POST "https://api.lootlocker.io/white-label-login/request-reset-password" \
  -H "domain-key: 11aaa11" \
  -H "is-development: true" \
  -H "Content-Type: application/json" \
  -d "{\"email\": \"[e-mail]\"}"

This will return a 204 without a body response.