Playgama
  • Welcome
  • 🚀Quick start
  • Submitting a game
  • Game Requirments
    • 💥Self-check
    • Technical Requirements
    • Advertising Requirements
    • User Experience Requirements
    • Content Requirements
    • Other Requirements
    • Platform-Specific Requirements
  • FAQ
    • General
    • Submitting a Game
    • Game Moderation
    • Payments and Statistics
  • SDK
    • Getting started
    • Engines
      • Core (Plain JS)
        • 💥Intro
        • Setup
        • Platform Parameters
        • User Data
        • Advertising
          • Banner
          • Interstitial
          • Rewarded
          • AdBlock
        • User Parameters
        • Social Interactions
        • Leaderboards
        • Achievements
        • In-Game Purchases
        • Remote Configuration
      • Unity
        • 💥Intro
        • Setup
        • Platform Parameters
        • User Data
        • Advertising
          • Banner
          • Interstitial
          • Rewarded
          • AdBlock
        • User Parameters
        • Social Interactions
        • Leaderboards
        • Achievements
        • In-Game Purchases
        • Remote Configuration
      • Construct 3
        • 💥Intro
        • Setup
        • Platform Parameters
        • User Data
        • Advertising
          • Banner
          • Interstitial
          • Rewarded
          • AdBlock
        • User Parameters
        • Social Interactions
        • Leaderboards
        • Achievements
        • In-Game Purchases
        • Remote Configuration
      • GDevelop
        • 💥Intro
        • Setup
        • Platform Parameters
        • User Data
        • Advertising
          • Banner
          • Interstitial
          • Rewarded
          • AdBlock
        • User Parameters
        • Social Interactions
        • Leaderboards
        • Achievements
        • In-Game Purchases
        • Remote Configuration
      • Godot
        • 💥Intro
        • Setup
        • Platform Parameters
        • User Data
        • Advertising
          • Banner
          • Interstitial
          • Rewarded
          • AdBlock
        • User Parameters
        • Social Interactions
        • Leaderboards
        • Achievements
        • In-Game Purchases
        • Remote Configuration
      • Game Maker
        • 💥Intro
        • Setup
        • Platform Parameters
        • User Data
        • Advertising
          • Banner
          • Interstitial
          • Rewarded
          • AdBlock
        • User Parameters
        • Social Interactions
        • Leaderboards
        • Achievements
        • In-Game Purchases
        • Remote Configuration
      • Defold
        • 💥Intro
        • Setup
        • Platform Parameters
        • User Data
        • Advertising
          • Banner
          • Interstitial
          • Rewarded
          • AdBlock
        • User Parameters
        • Social Interactions
        • Leaderboards
        • Achievements
        • In-Game Purchases
        • Remote Configuration
    • Changelog
Powered by GitBook
On this page
  1. SDK
  2. Engines
  3. Construct 3

Leaderboards

PreviousSocial InteractionsNextAchievements

Last updated 3 months ago

Enhance competitiveness by integrating leaderboards, allowing players to compare their scores and achievements.

Support

Use this to determine if you can implement leaderboards for your game on the current platform.

Check if the leaderboard feature is supported on the platform.

Check if built-in popup is supported.

Check if multiple boards are supported.

Check if user can set score to leaderboard.

Check if user can retrieve their score.

Check if user can access leaderboard entries including other players' scores.

Player Scores. Set

Submit the player's score to the leaderboard to update their rank and position.

Copy This Example
{"is-c3-clipboard-data":true,"type":"events","items":[{"eventType":"block","conditions":[{"id":"on-clicked","objectClass":"Button"}],"actions":[],"children":[{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.PlatformId","comparison":0,"second-value":"\"yandex\""}}],"actions":[{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"leaderboardName\"","value":"\"YOUR_LEADERBOARD_NAME\""}},{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"score\"","value":"42"}}]},{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.PlatformId","comparison":0,"second-value":"\"facebook\""}}],"actions":[{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"leaderboardName\"","value":"\"YOUR_LEADERBOARD_NAME\""}},{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"score\"","value":"42"}}]},{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.PlatformId","comparison":0,"second-value":"\"lagged\""}}],"actions":[{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"boardId\"","value":"\"YOUR_LEADERBOARD_ID\""}},{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"score\"","value":"42"}}]},{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.PlatformId","comparison":0,"second-value":"\"y8\""}}],"actions":[{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"table\"","value":"\"YOUR_LEADERBOARD_NAME\""}},{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"points\"","value":"42"}}]},{"eventType":"block","conditions":[],"actions":[{"id":"leaderboard-set-score","objectClass":"PlaygamaBridge"}]}]}]}

Player Scores. Get

Retrieve the player's score from the leaderboard to display their current standing.

Copy This Example
{"is-c3-clipboard-data":true,"type":"events","items":[{"eventType":"block","conditions":[{"id":"on-clicked","objectClass":"Button"}],"actions":[],"children":[{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.PlatformId","comparison":0,"second-value":"\"yandex\""}}],"actions":[{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"leaderboardName\"","value":"\"YOUR_LEADERBOARD_NAME\""}}]},{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.PlatformId","comparison":0,"second-value":"\"facebook\""}}],"actions":[{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"leaderboardName\"","value":"\"YOUR_LEADERBOARD_NAME\""}}]},{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.PlatformId","comparison":0,"second-value":"\"y8\""}}],"actions":[{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"table\"","value":"\"YOUR_LEADERBOARD_NAME\""}}]},{"eventType":"block","conditions":[],"actions":[{"id":"leaderboard-get-score","objectClass":"PlaygamaBridge"}]}]},{"eventType":"block","conditions":[{"id":"on-leaderboard-get-score-completed","objectClass":"PlaygamaBridge"}],"actions":[],"children":[{"eventType":"block","conditions":[{"id":"is-last-action-completed-successfully","objectClass":"PlaygamaBridge"}],"actions":[{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"PlaygamaBridge.LeaderboardPlayerScore"}}]}]}]}

Read Full Leaderboard

Retrieve entries from the leaderboard, including the player's rank and score, to display a comprehensive leaderboard.

Copy Example (extended)
{"is-c3-clipboard-data":true,"type":"events","items":[{"eventType":"block","conditions":[{"id":"on-clicked","objectClass":"Button"}],"actions":[],"children":[{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.PlatformId","comparison":0,"second-value":"\"yandex\""}}],"actions":[{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"leaderboardName\"","value":"\"YOUR_LEADERBOARD_NAME\""}},{"id":"add-bool-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"includeUser\"","value":true}},{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"quantityAround\"","value":"10"}},{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"quantityTop\"","value":"10"}}]},{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.PlatformId","comparison":0,"second-value":"\"facebook\""}}],"actions":[{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"leaderboardName\"","value":"\"YOUR_LEADERBOARD_NAME\""}},{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"count\"","value":"10"}},{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"offset\"","value":"10"}}]},{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.PlatformId","comparison":0,"second-value":"\"y8\""}}],"actions":[{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"table\"","value":"\"YOUR_LEADERBOARD_NAME\""}},{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"perPage\"","value":"10"}},{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"page\"","value":"1"}}]},{"eventType":"block","conditions":[],"actions":[{"id":"leaderboard-get-entries","objectClass":"PlaygamaBridge"}]}]},{"eventType":"block","conditions":[{"id":"on-leaderboard-get-entries-completed","objectClass":"PlaygamaBridge"}],"actions":[],"children":[{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.LeaderboardEntriesCount","comparison":4,"second-value":"0"}}],"actions":[],"children":[{"eventType":"block","conditions":[{"id":"for","objectClass":"System","parameters":{"name":"\"entries\"","start-index":"0","end-index":"PlaygamaBridge.LeaderboardEntriesCount - 1"}}],"actions":[],"children":[{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.PlatformId","comparison":0,"second-value":"\"yandex\""}}],"actions":[{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"ID:\" & PlaygamaBridge.LeaderboardEntryPropertyValue(loopindex(\"entries\"),\"id\")"}},{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"Score:\" & PlaygamaBridge.LeaderboardEntryPropertyValue(loopindex(\"entries\"),\"score\")"}},{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"Rank:\" & PlaygamaBridge.LeaderboardEntryPropertyValue(loopindex(\"entries\"),\"rank\")"}},{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"Name:\" & PlaygamaBridge.LeaderboardEntryPropertyValue(loopindex(\"entries\"),\"name\")"}},{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"Photo:\" & PlaygamaBridge.LeaderboardEntryPropertyValue(loopindex(\"entries\"),\"photo\")"}}]},{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.PlatformId","comparison":0,"second-value":"\"facebook\""}}],"actions":[{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"Player ID:\" & PlaygamaBridge.LeaderboardEntryPropertyValue(loopindex(\"entries\"),\"playerId\")"}},{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"Score:\" & PlaygamaBridge.LeaderboardEntryPropertyValue(loopindex(\"entries\"),\"score\")"}},{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"Rank:\" & PlaygamaBridge.LeaderboardEntryPropertyValue(loopindex(\"entries\"),\"rank\")"}},{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"Player Name:\" & PlaygamaBridge.LeaderboardEntryPropertyValue(loopindex(\"entries\"),\"playerName\")"}},{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"Player Photo:\" & PlaygamaBridge.LeaderboardEntryPropertyValue(loopindex(\"entries\"),\"playerPhoto\")"}}]},{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.PlatformId","comparison":0,"second-value":"\"y8\""}}],"actions":[{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"Player ID:\" & PlaygamaBridge.LeaderboardEntryPropertyValue(loopindex(\"entries\"),\"playerid\")"}},{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"Score:\" & PlaygamaBridge.LeaderboardEntryPropertyValue(loopindex(\"entries\"),\"points\")"}},{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"Rank:\" & PlaygamaBridge.LeaderboardEntryPropertyValue(loopindex(\"entries\"),\"rank\")"}},{"id":"log","objectClass":"Browser","parameters":{"type":"log","message":"\"Player Name:\" & PlaygamaBridge.LeaderboardEntryPropertyValue(loopindex(\"entries\"),\"playername\")"}}]}]}]}]}]}

Show Native Popup

Shows leaderboard entries built-in popup

Copy This Example
{"is-c3-clipboard-data":true,"type":"events","items":[{"eventType":"block","conditions":[{"id":"on-clicked","objectClass":"Button"}],"actions":[],"children":[{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"PlaygamaBridge.PlatformId","comparison":0,"second-value":"\"y8\""}}],"actions":[{"id":"add-action-parameter","objectClass":"PlaygamaBridge","parameters":{"key":"\"table\"","value":"\"YOUR_LEADERBOARD_NAME\""}}]},{"eventType":"block","conditions":[],"actions":[{"id":"leaderboard-show-native-popup","objectClass":"PlaygamaBridge"}]}]},{"eventType":"block","conditions":[{"id":"on-leaderboard-show-native-popup-completed","objectClass":"PlaygamaBridge"}],"actions":[{"type":"comment","text":"success"}]}]}