Skip to content
LootLockerLootLocker

Work with Player Names

This how-to updates, retrieves, and looks up player names, and views them in the Web Console.

Prerequisites

Section titled “Prerequisites”

Automatic Platform Names

Section titled “Automatic Platform Names”

When possible, LootLocker attaches a name to the player when starting a session. This is only possible for platforms where the player already has a name, such as Steam or PlayStation Network.

Platforms Supporting Automatic Names: Steam, PlayStation Network.

If you're using a platform without automatic player names, or want to update the name LootLocker has stored for the player, you can change the name using the SDK or API.

Player names can also be viewed in the Web Console:

Players with names in the web console

Unique Player Names

Section titled “Unique Player Names”

To ensure no two players in your game have the same name, use the Unique Player Names setting in your game settings. Enabling this toggle returns an error when updating a player's name if that name is already taken.

Update Player Name in Game

Section titled “Update Player Name in Game”
LootLockerSDKManager.SetPlayerName("Some other name", (response) =>
{
    if (response.success)
    {
        Debug.Log("Successfully set player name");
    } else
    {
        Debug.Log("Error setting player name");
    }
});

Retrieve Player Name in Game

Section titled “Retrieve Player Name in Game”
LootLockerSDKManager.GetPlayerName((response) =>
{
    if (response.success)
    {
        Debug.Log("Successfully retrieved player name: " + response.name);
    } else
    {
        Debug.Log("Error getting player name");
    }
});

Lookup Multiple Player Names Using Player IDs

Section titled “Lookup Multiple Player Names Using Player IDs”
ulong player1ID = 1;
ulong player2ID = 2;
ulong player3ID = 3;


LootLockerSDKManager.LookupPlayerNamesByPlayerIds(new ulong[] { player1ID, player2ID, player3ID }, response =>
{
    if (response.success)
    {
        foreach (var player in response.players)
        {
            Debug.Log(player.player_id);
            Debug.Log(player.player_public_uid);
            Debug.Log(player.name);
            Debug.Log(player.last_active_platform);
            Debug.Log(player.platform_player_id);
        }
    } else
    {
        Debug.Log("Error looking up player names");
    }
});

Multiple platforms and public UID are also supported:

- LookupPlayerNamesByPlayerPublicUIds(string[] playerPublicUIds, Action onComplete)
- LookupPlayerNamesBySteamIds(ulong[] steamIds, Action onComplete)
- LookupPlayerNamesBySteamIds(string[] steamIds, Action onComplete)
- LookupPlayerNamesByPSNIds(ulong[] psnIds, Action onComplete)
- LookupPlayerNamesByPSNIds(string[] psnIds, Action onComplete)
- LookupPlayerNamesByXboxIds(string[] xboxIds, Action onComplete)

Conclusion

Section titled “Conclusion”

You've updated, retrieved, and looked up player names, and can view them in the Web Console. Next, review LootLocker's full feature set to decide which other features to implement.