GameMaker Studio · GML · Leaderboards & scores

gmda_getPending

Returns the queued (not-yet-sent) score for a table, or {} if none.

Synchronous (returns directly)

Signature

gmda_getPending(table) -> struct

What it does

Reads the local pending-submit queue for that table. No network call: it just reports what gmda_submitWithRetry() has queued and not yet delivered.

Parameters

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

How to call it

Call any time to check whether a score is still waiting to be sent, e.g. to show a "syncing..." badge. Use variable_struct_exists() (or check for the score field) to tell a real entry from the empty {}.

Returns: struct { score, meta } for the queued submission, or {} (an empty struct) if nothing is pending.

Example

var p = gmda_getPending(1);
if (variable_struct_exists(p, "score")) {
    show_debug_message("waiting to send: " + string(p.score));
}

Use cases

Show a 'pending upload' indicator while offline.
Decide whether to warn the player about an unsent score before they quit.