Create a new leaderboard for your game.


GML Code Example

steam_create_leaderboard(lb_name, sort_method, display_type);

Argument Description
lb_name The name of the leaderboard that you are creating (a string).
sort_method The method for sorting the leaderboard entries (see constants listed below).
display_type The way to display the leaderboard to the user (see constants listed below).

Returns: Real


With this function you can create a new leaderboard for your game. The first argument is a string which defines the name of your leaderboard, and this name should be used in any further function calls relating to the leaderboard being created. You can then define the sort method (see the constants listed below) as well as the way in which the information is displayed (again, one of the constants listed below). The function will return a value of -1 if it fails to create the leaderboard or a value greater than -1 if it has succeeded.

NOTE: If you have previously created a leaderboard with the same name (either through code or through your Steam page for the game) this function will be ignored!

Sort Constant Description
lb_sort_none No sorting. The information will be displayed "as is".
lb_sort_ascending Sort the leaderboard in ascending order.
lb_sort_descending Sort the leaderboard in descending order.
Display Constant Description
lb_disp_none Show the leaderboard "as is".
lb_disp_numeric Show the leaderboard as a numeric display.
lb_disp_time_sec Show the leaderboard values as times, with the base value being seconds.
lb_disp_time_ms Show the leaderboard values as times, with the base value being milli-seconds.


GML Code Example

steam_create_leaderboard("Game Times", lb_sort_ascending, lb_disp_time_sec);

The above code will create a leaderboard called "Game Times", and set it to display the results in ascending order and with a display in seconds.

No Examples Submitted

Does this page need better examples? Be the first to Submit

No Edits Suggested

Is this page unclear or not descriptive enough? Suggest an edit to the page and with enough upvotes your changes will be made.

No Questions Have Been Ask

Do you have a question about this page? Ask it Here