Skip to content

Leaderboards Reference

Allow your game to send scores to your leaderboards (anonymously or from the logged-in player) or display existing leaderboards to the player. Read more explanations about it.

Actions

Close current leaderboard
Close the leaderboard currently displayed on top of the game.

See parameters

Technical note: parameter 0 are internal parameters handled by GDevelop.

Display leaderboard
Display the specified leaderboard on top of the game. If a leaderboard was already displayed on top of the game, the new leaderboard will replace it.

See parameters
  • Parameter 1 (🔤 Leaderboard Identifier (String)): Leaderboard
  • Parameter 2 (❓ Yes or No): Display loader while leaderboard is loading

Technical note: parameter 0 are internal parameters handled by GDevelop.

Save connected player score
Save the connected player's score to the given leaderboard.

See parameters
  • Parameter 1 (🔤 Leaderboard Identifier (String)): Leaderboard
  • Parameter 2 (🔢 Number): Score to register for the player

Technical note: parameter 0 are internal parameters handled by GDevelop.

Save player score
Save the player's score to the given leaderboard. If the player is connected, the score will be attached to the connected player (unless disabled).

See parameters
  • Parameter 1 (🔤 Leaderboard Identifier (String)): Leaderboard
  • Parameter 2 (🔢 Number): Score to register for the player
  • Parameter 3 (string): Name to register for the player Let this empty to let the leaderboard auto-generate a player name (e.g: "Player23464"). You can configure this in the leaderboard administration.

Technical note: parameter 0 are internal parameters handled by GDevelop.

Always attach scores to the connected player
Set if the score sent to a leaderboard is always attached to the connected player - if any. This is on by default.

See parameters
  • Parameter 1 (❓ Yes or No): Enable?

Technical note: parameter 0 are internal parameters handled by GDevelop.

Conditions

Last score save has errored
Check if the last attempt to save a score has errored.

See parameters
  • Parameter 0 (🔤 Leaderboard Identifier (String)): Leaderboard If no leaderboard is specified, will return the value related to the last leaderboard save action.

Last score save has succeeded
Check if the last attempt to save a score has succeeded.

See parameters
  • Parameter 0 (🔤 Leaderboard Identifier (String)): Leaderboard If no leaderboard is specified, will return the value related to the last leaderboard save action that successfully ended.

Closed by player
Check if the player has just closed the leaderboard view.

Leaderboard display has errored
Check if the display of the leaderboard errored.

Leaderboard display has loaded
Check if the display of the leaderboard has finished loading and been displayed on screen.

Leaderboard display is loading
Check if the display of the leaderboard is loading.

Score is saving
Check if a score is currently being saved in leaderboard.

See parameters
  • Parameter 0 (🔤 Leaderboard Identifier (String)): Leaderboard If no leaderboard is specified, will return the value related to the last leaderboard save action.

Expressions

Expression Description
Leaderboards::FormatPlayerName(string) Formats a name so that it can be submitted to a leaderboard.
string Raw player name
Leaderboards::LastSaveError(leaderboard identifier) Get the error of the last save attempt.
🔤 Leaderboard Identifier (String) Leaderboard If no leaderboard is specified, will return the value related to the last leaderboard save action. Optional.

The Leaderboards extension is always installed in all GDevelop projects: there is no need to add it from the Project Manager.

This page is an auto-generated reference page about the Leaderboards feature of GDevelop, the open-source, cross-platform game engine designed for everyone. Learn more about all GDevelop features here.