top of page

Player Manager

The Player Manager plugin is specifically designed to manage and retrieve detailed player information through the PlayFab service, for games built using Construct 3 and Construct 2.


Interconnected with major platforms including Google Play, Game Center, Apple Login, Instant Games, Facebook, Facebook Instant Games, Steam, Xbox Live, Nintendo Switch, PS4 and of course PlayFab's own profile management system allows you to access, gather and utilize the detailed profile information of players.


Information include player profile, player contact email addresses, account's origin of creation meaning the authentication method in which the player originally created the account, linked accounts from services or authentication methods like Facebook and Google Play, tracked locations, leaderboard statistics, player tags and player value in real currency based on legal tender purchases.


The Player Manager is most useful in making profile pages of players in your application.

PlayFab API v2.png

Introduction

Step 1.png

The Construct Master Collection supports the full and easy integration of the PlayFab service for both Construct 3 and Construct 2.


Please click here to learn more about PlayFab.

Features


Here are some of the features of the PlayFab service:

  • Player profile

  • Player information

  • Email Addresses

  • Original account creation authentication method

  • Linked authentication methods

  • Linked social network or platforms

  • Player's real currency or local legal tender currency

  • Organized profile request features

  • Organized profile utilization features


For more information about all the integrated PlayFab service features, please click here to learn the introductory lessons to PlayFab.


Network Services


Here are some of the platform services that can be linked:

  • PlayFab

  • Google Play

  • Game Center

  • Facebook

  • Facebook Instant Games

  • Steam

  • Xbox Live

  • Instant Games (Android Studio port)

  • Nintendo Switch (3rd party porting services)

  • PS4 (3rd party porting services)

  • Nintendo Switch (3rd party porting services)


Editor Features


Here are some of the features in the Construct editor:

  • All platforms support, including web, mobile and desktop.

  • Construct 3

  • Construct 2

Introduction
Features

How to use?

It is easy to use the Player Manager plugin, you will only need to follow the steps below.

  1. Set up the PlayFab API plugin, please click to visit the documentation. This includes creating a PlayFab account, studio and title.

  2. Set up the Authentication plugin, please click to visit the documentation.

  3. Finally, you can now use the Player Manager object, and include more PlayFab addons for more features.


Instructions
Documentation

Documentation

There is currently nothing to show, we will add more in the future.



Related Plugins


  • Account Info - is a plugin that retrieves and utilizes the player's user account data and information. In comparison, the Player Manager plugin manages, retrieves and utilizes the player profile data and information.

  • Account Manager - is a plugin that manages and makes requests for the user account. If the Account Manager manages the player's user accounts including changing information and making user account requests, the Player Manager plugin instead manages, retrieves and utilizes the players' account.

ACEs

Actions, Conditions & Expressions

Actions

The following action groups:

  • Player Profile

Player Profile​

  • Get Player Profile - The profile of the player. This profile is not guaranteed to be up-to-date. For a new player, this profile will not exist. Only the allowed client profile properties for the title may be requested.

    • PlayFab ID - ​Unique PlayFab assigned ID of the user on whom the operation will be performed.

Conditions

The following condition groups:

  • Player Profile

  • Player Profile : Contact Emails

  • Player Profile : Linked Accounts

  • Player Profile : Locations

  • Player Profile : Statistics

  • Player Profile : Tags

  • Player Profile : Values To Date

  • Player Account

  • Check Account Origin

Player Profile

  • On Get Player Profile - Triggers when the Get Player Profile Succeeded.


  • On Player Not In-Game - Triggers when the Get Player Profile responded that the Player is not In-Game.


  • On Profile Does Not Exist - Triggers when the Get Player Profile responded that the Profile Does Not Exist.


  • On Error - Triggers when the Get Player Profile failed with an error.

​

  • Is Getting Profile - Condition to check if the Get Player Profile is still loading.


Player Profile : Contact Emails​

  • For Each Email - Loops through the list of Email Addresses.

​

Player Profile : Linked Accounts

  • For Each Account - Loops through the list of Linked Accounts.

​

Player Profile : Locations​

  • For Each Locations - Loops through the list of Locations.

​

Player Profile : Statistics​

  • For Each Statistics - Loops through the list of Statistics.

​

Player Profile : Tags​

  • For Each Tags - Loops through the list of Tags.

​

Player Profile : ValuesToDate​

  • For Each Values - Loops through the list of Values To Date.

​

Player Account​

  • Is Account Linked - Condition to check if the "Player Account" is linked to a Sync Method.

    • Sync Method​ - The Sync Method to check if is linked to the account.

      • Company​

      • CustomID

      • GameCenter

      • GooglePlay

      • Steam

      • Xbox Live

      • Facebook

      • iOS Device

      • Android Device

      • Windows Hello

      • Facebook Instant Games


​ Check Account Origin​

  • Is Account Origin - Condition to check if where the "Player Account" is originally created.

    • Sync Method​ - The Sync Method to check if is linked to the account.

      • Company​

      • CustomID

      • GameCenter

      • GooglePlay

      • Steam

      • Xbox Live

      • Facebook

      • iOS Device

      • Android Device

      • Windows Hello

      • Facebook Instant Games

Expressions

The following expression groups:

  • Player Profile

  • Player Profile : Contact Emails

  • Player Profile : Linked Accounts

  • Player Profile : Locations

  • Player Profile : Statistics

  • Player Profile : Tags

  • Player Profile : Values To Date

  • Server Response

  • Request

Player Profile

  • getAvatarURL - Return the URL of the player's avatar image.


  • getBannedUntil - Return the Banned Until Date Time. If the player is currently banned, the UTC Date when the ban expires.


  • getCreatedDateTime - Return the Player record created Date Time.


  • getDisplayName - Return the Player display name.


  • getLastLogin - Return the UTC time when the player most recently logged in to the title.


  • getOrigin - Return the Player account origination. Either "Unknown", "PlayFab" and "Custom", "GameCenter", "GooglePlay", "Steam", "XBoxLive", "Kongregate", "Facebook", "IOSDevice", "AndroidDevice", "WindowsHello", "FacebookInstantGames".


  • getPlayerID - Return the PlayFab player account unique identifier.


  • getPublisherID - Return the Publisher this player belongs to.


  • getTitleID - Return the Title ID this player profile applies to.


  • getUSDValue - Return the Sum of the player's purchases made with real-money currencies, converted to US dollars.



Player Profile : Contact Emails

  • getEmail - Return the email address.

    • Index - ​The index of the for each loop.


  • getEmailName - Return the name of the email info data.

    • Index - ​The index of the for each loop.​


  • getEmailStatus - Return the verification status of the email. Either "Unverified", "Pending" and "Confirmed".

    • Index - ​The index of the for each loop.​

  • loopEmailList - Return the current loop item index of the Email Addresses list.


  • countEmails - Return the item count on the Email Addresses list.

​

Player Profile : Linked Accounts

  • getLinkedEmail - Return the Linked account email of the user on the platform, if available.

    • Index - ​The index of the for each loop.​​


  • getLinkedPlatform - Return the Authentication platform. Either "Unknown", "PlayFab" and "Custom", "GameCenter", "GooglePlay", "Steam", "XBoxLive", "Kongregate", "Facebook", "IOSDevice", "AndroidDevice", "WindowsHello", "FacebookInstantGames".

    • Index - ​The index of the for each loop.​​


  • getLinkedUserID - Return the Unique account identifier of the user on the platform.

    • Index - ​The index of the for each loop.​​


  • getLinkedUsername - Return the Linked account username of the user on the platform, if available.

    • Index - ​The index of the for each loop.​​

  • loopLinkedAccounts - Return the current loop item index of the Linked Accounts list.


  • countLinkedAccounts - Return the item count on the Linked Accounts list.

​

Player Profile : Locations

  • getCity - Return the City name.

    • Index - ​The index of the for each loop.​​


  • getContinentCode - Return the The two-character continent code for this location. Possible Values : "AF", "AN", "AS", "EU", "NA", "OC", "SA".

    • Index - ​The index of the for each loop.​​


  • getCountryCode - Return the The two-character ISO 3166-1 country code for the country associated with the location. For Example "PH" for the Philippines.

    • Index - ​The index of the for each loop.​​


  • getLatitude - Return the Latitude coordinate of the geographic location.

    • Index - ​The index of the for each loop.​​


  • getLongitude - Return the Longitude coordinate of the geographic location.

    • Index - ​The index of the for each loop.​​​

  • loopLocations - Return the current loop item index of the Locations list.


  • countLocations - Return the item count on the Locations list.

​

Player Profile : Statistics

  • getStatisticName - Return the Statistic name.

    • Index - ​The index of the for each loop.​​


  • getStatisticValue - Return the Statistic value.

    • Index - ​The index of the for each loop.​​


  • getStatisticVersion - Return the Statistic version (0 if not a versioned statistic).

    • Index - ​The index of the for each loop.​​

  • loopStatistics - Return the current loop item index of the Statistics list.


  • countStatistics - Return the item count on the Statistics list.

​

Player Profile : Tags

  • getTag - Return the Full value of the tag, including namespace.

    • Index - ​The index of the for each loop.​​

  • loopTags - Return the current loop item index of the Tags list.


  • countTags - Return the item count on the Tags list.

​

Player Profile : ValuesToDate

  • getValueCurrency - Return the ISO 4217 code of the currency used in the purchases.

    • Index - ​The index of the for each loop.​​


  • getTotalValue - Return the Total Value of the purchases.

    • Index - ​The index of the for each loop.​​


  • getTotalValueAsDec - Return the Total Value of the purchases in a string representation of decimal monetary units. For example, '9.99' indicates nine dollars and ninety-nine cents when Currency is 'USD'.

    • Index - ​The index of the for each loop.​​


  • loopValues - Return the current loop item index of the ValuesToDate list.


  • countValues - Return the item count on the ValuesToDate list.

​

Server Response

  • ServerResponse - Return the "Server Response" from every request from the PlayFab Server. The server response can also be shown in the "Chrome Developer Tools : Console", if in "debug mode".

​

Request

  • Tag - Return the "Tag" of the latest request.

Object   Properties

Plugin Properties

Properties
Showcase

Showcase

There is currently nothing to show, we will add more in the future.

Game Projects

Game Projects 

Instructions Kit

Specifications

  • Instructions - The game project contains instructions and steps on how to use the addon and its features.

  • Action, Conditions and Expressions - It covers the implementation of each action, condition and expression.

  • Tips and Tricks - It provides some tips and tricks on the recommended ways of using the addon.

Supporters

Only

bottom of page