Structures
This section describes all data structures used throughout the PloxTools: Google Play Games Services plugin. These structures represent data returned by Google Play Games Services APIs and are used consistently across Blueprint and C++ workflows.
All structures are populated internally by the plugin based on data received from Google Play Games Services.
Achievements
FGooglePlayAchievement
Contains detailed information about a Google Play achievement.
| Field | Type | Description |
|---|---|---|
| ID | FString |
Unique identifier of the achievement. |
| Name | FString |
Display name of the achievement. |
| Description | FString |
Description shown to the player. |
| State | EGooglePlayAchievementState |
Current achievement state (hidden, revealed, unlocked). |
| Type | EGooglePlayAchievementType |
Achievement type (standard or incremental). |
| CurrentSteps | int32 |
Current progress steps for incremental achievements. |
| TotalSteps | int32 |
Total required steps to unlock an incremental achievement. |
| LastUpdatedTimestamp | int64 |
Timestamp of the last update in milliseconds since epoch. |
| ExperienceValue | int64 |
Experience points granted for unlocking the achievement. |
| RevealedImageURL | FString |
URL of the image shown when the achievement is revealed. |
| UnlockedImageURL | FString |
URL of the image shown when the achievement is unlocked. |
Events
FGooglePlayEvent
Represents a Google Play Games event and its current value.
| Field | Type | Description |
|---|---|---|
| EventID | FString |
Unique identifier of the event. |
| Value | int64 |
Current value associated with the event. |
Leaderboards
FGooglePlayLeaderboardScore
Represents a single leaderboard score entry.
| Field | Type | Description |
|---|---|---|
| DisplayRank | FString |
Formatted rank string displayed to the user. |
| DisplayScore | FString |
Formatted score string displayed to the user. |
| Rank | int64 |
Numeric rank position in the leaderboard. |
| RawScore | int64 |
Raw unformatted score value. |
| ScoreHolderDisplayName | FString |
Display name of the score holder. |
| ScoreHolderHiResImageURL | FString |
High resolution avatar image URL of the score holder. |
| ScoreHolderIconImageURL | FString |
Icon size avatar image URL of the score holder. |
| TimestampMillis | int64 |
Timestamp of when the score was recorded in milliseconds since epoch. |
FGooglePlayLeaderboardVariant
Represents a leaderboard variant for a specific collection and time span.
| Field | Type | Description |
|---|---|---|
| Collection | EGooglePlayLeaderboardCollection |
Leaderboard collection type. |
| TimeSpan | EGooglePlayLeaderboardTimeSpan |
Leaderboard time span. |
| DisplayPlayerRank | FString |
Formatted rank of the current player. |
| DisplayPlayerScore | FString |
Formatted score of the current player. |
| NumScores | int64 |
Total number of scores available. |
| PlayerRank | int64 |
Numeric rank of the current player. |
| RawPlayerScore | int64 |
Raw unformatted score of the current player. |
| bHasPlayerInfo | bool |
Indicates whether player-specific information is available. |
FGooglePlayLeaderboard
Represents a Google Play leaderboard definition.
| Field | Type | Description |
|---|---|---|
| ID | FString |
Unique identifier of the leaderboard. |
| DisplayName | FString |
Display name of the leaderboard. |
| IconImageURL | FString |
URL of the leaderboard icon image. |
| ScoreOrder | EGooglePlayLeaderboardScoreOrder |
Defines how scores are ordered in this leaderboard. |
| Variants | TArray<FGooglePlayLeaderboardVariant> |
List of available leaderboard variants. |
FGooglePlayLeaderboardScoreSubmissionResult
Represents the result of a score submission for a specific time span.
| Field | Type | Description |
|---|---|---|
| FormattedScore | FString |
Formatted score returned after submission. |
| bNewBest | bool |
Indicates whether the submitted score is a new personal best. |
| RawScore | int64 |
Raw unformatted submitted score value. |
FGooglePlayLeaderboardScoreSubmissionData
Contains score submission results grouped by time span.
| Field | Type | Description |
|---|---|---|
| LeaderboardID | FString |
Identifier of the leaderboard the score was submitted to. |
| PlayerID | FString |
Identifier of the player who submitted the score. |
| ScoreResults | TMap<EGooglePlayLeaderboardTimeSpan, FGooglePlayLeaderboardScoreSubmissionResult> |
Submission results mapped by leaderboard time span. |
Player Profile
FGooglePlayGamesPlayer
Contains basic profile information about a Google Play Games player.
| Field | Type | Description |
|---|---|---|
| PlayerID | FString |
Unique identifier of the player. |
| DisplayName | FString |
Display name of the player. |
| IconImageURL | FString |
URL of the player's icon size profile image. |
| HiResImageURL | FString |
URL of the player's high resolution profile image. |
| bHasIconImage | bool |
Indicates whether an icon image is available. |
| bHasHiResImage | bool |
Indicates whether a high resolution image is available. |
Saved Games
FGooglePlaySavedGameMetadata
Contains metadata associated with a saved game snapshot.
| Field | Type | Description |
|---|---|---|
| Description | FString |
Description of the saved game provided by the developer. |
| PlayedTimeMillis | int64 |
Total played time associated with this snapshot in milliseconds. |
| ProgressValue | int64 |
Custom progress value used for conflict resolution. |
| SnapshotID | FString |
Unique identifier of the snapshot. |
| SlotName | FString |
Slot name of the saved game. |
| LastModifiedTimestamp | int64 |
Timestamp of the last modification in milliseconds since epoch. |
| DeviceName | FString |
Name of the device that last modified the snapshot. |
FGooglePlaySavedGame
Represents a saved game including metadata and binary data.
| Field | Type | Description |
|---|---|---|
| Metadata | FGooglePlaySavedGameMetadata |
Metadata describing the saved game snapshot. |
| Data | TArray<uint8> |
Raw binary data of the saved game. |
FGooglePlaySavedGameConflict
Represents a conflict between local and remote saved game versions.
| Field | Type | Description |
|---|---|---|
| ConflictID | FString |
Unique identifier of the conflict. |
| Local | FGooglePlaySavedGame |
Local version of the saved game. |
| Remote | FGooglePlaySavedGame |
Remote version of the saved game. |