GameMaker Studio · GML · Leaderboards & scores

gmda_getExtrainfo

Returns the player's own custom_data struct on a table.

Synchronous (returns directly)

Signature

gmda_getExtrainfo(table) -> struct

What it does

Returns the cached custom_data the player submitted with their best score on that table, using the field names you defined in the panel, e.g. a table with fields level and country yields { level: 3, country: "MX" }. No network call.

Parameters

Name	Type	Default	Description
table	real	required	Table number to read. 1-based: the first declared table is 1, the second is 2, and so on.

How to call it

Call any time after the tables_loaded event to read back the extra fields you attached to the player's score.

Returns: struct keyed by the custom-field names defined in the panel (e.g. { level, country }), exactly as submitted, same shape as the Godot client's get_extra_info(). Empty struct {} when the table is invalid or there are no scores yet.

Example

var info = gmda_getExtrainfo(1);
show_debug_message("reached level " + string(info.level) + " in " + string(info.country));

Use cases

Show the level or character the player used for their best score.
Restore per-score metadata (country, mode, difficulty) in the UI.