Players Data

Get Player Data

+1 Request

You can access other players' data, including achievements and purchases.

All fields marked public will be available to other players.

JavaScript

const result = await gp.players.fetch({
    // Search by player ID
    ids: [66506, 66254],
});

// Response
const { players } = result;

// Player state
players[0].state

// Examples
players[0].state.id
players[0].state.name
players[0].state.score
players[0].state.gold

// Player achievements, see Achievements section
players[0].achievements

// Examples
players[0].achievements[0].id
players[0].achievements[0].createdAt

// Player purchases, see Payments section
players[0].purchases

// Examples
players[0].purchases[0].id
players[0].purchases[0].createdAt

Construct 3

→System

On start of layout

fetch players by IDs

GamePush

Players: Fetch "66506, 66254" players, tag: "players"

or fetch a single player

GamePush

Players: Fetch one 66506 player, tag: "player"

Add action

→GamePush

Players: On "players" fetch

Add action

GamePush

Players: For Each Player

player ID

Text

Set text to "ID: " & GamePush.PlayersCurPlayerID

player name

Text

Set text to "Name: " & GamePush.PlayersCurPlayerName

player score

Text

Set text to "Score: " & GamePush.PlayersCurPlayerScore

player avatar URL

Text

Set text to "Avatar: " & GamePush.PlayersCurPlayerAvatar

index in the fetched list

Text

Set text to "Index: " & GamePush.PlayersCurPlayerIndex

custom public field, e.g. gold

Text

Set text to "Gold: " & GamePush.PlayersCurPlayerField("gold")

Add action

GamePush

Players: For Each Player Achievement

achievement ID

Text

Set text to "Achievement ID: " & GamePush.AchievementsCurPlayerAchievementID

unlock date (createdAt)

Text

Set text to "Unlocked: " & GamePush.AchievementsCurPlayerAchievementUnlockDate

Add action

GamePush

Players: For Each Player Purchase

purchase / product ID

Text

Set text to "Purchase ID: " & GamePush.PaymentsCurPurchaseID

purchase date (createdAt)

Text

Set text to "Purchased: " & GamePush.PaymentsCurPurchaseDate

Add action

→GamePush

Players: On any fetch

any successful players fetch

Add action

→GamePush

Players: On "players" fetch error

fetch failed for this tag

Add action

→GamePush

Players: On any fetch error

any players fetch error

Add action

LegendSystemGamePushText

• System›Construct 3 System object
• GamePush›GamePush plugin
• Text — Object Text (Text)

Unity

private void FetchPlayers(List<int> playersId)
{
    GP_Players.Fetch(playersId, OnPlayersFetchSuccess, OnPlayersFetchError);
}

// Fetch response
private void OnPlayersFetchSuccess(GP_Data data)
{
    var players = data.GetList<PlayersData>();

    for (int i = 0; i < players.Count; i++)
    {
        Debug.Log("PLAYER STATE: AVATAR " + players[i].state.avatar);
        Debug.Log("PLAYER STATE: CREDITIALS " + players[i].state.credentials);
        Debug.Log("PLAYER STATE: ID " + players[i].state.id);
        Debug.Log("PLAYER STATE: NAME " + players[i].state.name);
        Debug.Log("PLAYER STATE: PLATFORM TYPE " + players[i].state.platformType);
        Debug.Log("PLAYER STATE: PROJECT ID " + players[i].state.projectId);
        Debug.Log("PLAYER STATE: SCORE " + players[i].state.score);

        // Player achievements, see Achievements section
        for (int a = 0; a < players[i].achievements.Length; a++)
        {
            Debug.Log("PLAYER ACHIEVEMENTS: ID " + players[i].achievements[a].id);
            Debug.Log("PLAYER ACHIEVEMENTS: TAG " + players[i].achievements[a].tag);
            Debug.Log("PLAYER ACHIEVEMENTS: CREATED AT " + players[i].achievements[a].createdAt);
        }

        // Player purchases, see Payments section
        for (int x = 0; x < players[i].purchasesList.Length; x++)
        {
            Debug.Log("PLAYER PURCHASES: CREATED AT " + players[i].purchasesList[x].createdAt);
            Debug.Log("PLAYER PURCHASES: EXPIRED AT " + players[i].purchasesList[x].expiredAt);
            Debug.Log("PLAYER PURCHASES: GIFT " + players[i].purchasesList[x].gift);
            Debug.Log("PLAYER PURCHASES: PRODUCT ID " + players[i].purchasesList[x].productId);
            Debug.Log("PLAYER PURCHASES: SUBSCRIBED " + players[i].purchasesList[x].subscribed);
            Debug.Log("PLAYER PURCHASES: TAG " + players[i].purchasesList[x].tag);
        }
    }
}

//On fetch error
private void OnPlayersFetchError() => Debug.Log("PLAYERS FETCH: ERROR");

Stay in Touch

Other documents of this chapter available Here. To get started, welcome to the Tutorials chapter.

GamePush Community Telegram: @gs_community.

For your suggestions e-mail: official@gamepush.com

We Wish you Success!