Accessing Player Records


An important capability for a back-end is that it gives you the ability to access your player's info in real-time and allows you to change this data. GameSparks gives you the ability to do this using multiple approaches.

This tutorial explores how to access player records using the NoSQL Explorer and Cloud Code.

Updating Player Records? Please see the following tutorial in this section for guidance on how to update your player records.

Working with the NoSQL Explorer

The NoSQL Explorer is a powerful tool you can use to access and find any Collection of data in the Mongo DB that you have in your game:

1. To open the NoSQL Explorer, click Data Explorer in the left-hand navigation panel.

Important! If you're working on a new game that was created after the Game Data Service was launched in January 2018, you won't be able to create new Mongo Runtime collections in the Collections panel and you'll get an error if you try to do this or if you try to create a Runtime collection using Cloud Code. For details on how to work with the new Game Data Service, see Data Type Explorer.

2. To access player data, under Collections expand the System heading and select player. An interactive panel for the player Mongo database Collection opens, which contains options for submitting the available database operations for this Collection. The operations panel opens with the Find operation selected by default.

3. Click the Find button:

Data Types? The Data Types panel allows you to view and manage the custom data you've created for persisting data against the platform. For details, see the Data Type Explorer page.

4. When records are retrieved, you can click on them to expand them. Once expanded you can see all the data that are linked to the player including data you can't normally see when you call an account details request - data such as authentication tokens, external IDs, reserved currency, and private data, which you may not see and use often.

Here's an example of a newly created player's record:

More Information! For more information about using the NoSQL Explorer, click here.

Using the Player Management Screen

You can use the Player Management screen to offer a visual experience while you access player data and change variables realtime. The Player Management screen can be found in the Manage section of the portal.

1. To access player data, click Manage>Players.

2. On the Player Search panel, build and submit a query for the player data you want. The results of the query are returned into the Results panel.

3. To view the player data for a result, click the edit icon. The Edit Player screen appears:

More Information! For more information about dynamic forms, click here.

Accessing Data through Cloud Code

You can use Cloud Code to retrieve players and access their records. You can do this through a specified ID which you can retrieve using the AccountDetailsRequest.

//You can have the player ID saved or manually passed in
var playerID = "5602c3dce4b07961f34b68c3" //Manually set the ID

//Finding the player through their ID
var playerVar = Spark.loadPlayer(playerData.$oid); //or (playerID) //Make a reference for that player through their ID.