GameMaker Studio · GML · Leaderboards & scores

gmda_clearPending

Drops the queued (not-yet-sent) score for a table.

Synchronous (returns directly)

Signature

gmda_clearPending(table) -> real

Removes that table's entry from the pending-submit queue (if any) and persists the change. No network call.

Name	Type	Default	Description
table	real	required	Table number whose pending submission should be removed. 1-based: the first declared table is 1, the second is 2, and so on.

Call to manually discard a queued gmda_submitWithRetry() score you no longer want sent, e.g. when the player abandons the run.

Returns: real: 1 on success (even when nothing was queued for that table), 0 only for an out-of-range table.

var p = gmda_getPending(1);
if (variable_struct_exists(p, "score")) {
    gmda_clearPending(1);
    show_debug_message("queued score discarded");
}