GameMaker Studio · GML · Cloud saves

gmda_listSaves

Lists this player's cloud save slots (metadata only, no data).

Asynchronous (result via event)

Signature

gmda_listSaves()

What it does

POSTs /saves/list. The queued saves_listed event carries response = { saves: [...] }, an array of used slots with metadata only: each entry is { slot, size_bytes, updated_at }, ordered by slot ascending. The save payloads themselves are not included. response.saves is an empty array when no slots are used. Returns 0 immediately (no event) when there is no active session.

Parameters

This function takes no parameters.

How to call it

Fire gmda_listSaves(), then read response.saves in a Step event with gmda_pollEvent() when e.event == "saves_listed".

Result event: saves_listed { success, response }

Example

gmda_listSaves();

// later, in a Step event:
var e = gmda_pollEvent();
while (!is_undefined(e)) {
    if (e.event == "saves_listed" && e.success) {
        var _saves = e.response.saves;
        for (var _i = 0; _i < array_length(_saves); _i++) {
            var _s = _saves[_i];
            show_debug_message("Slot " + string(_s.slot) + " - updated " + string(_s.updated_at));
        }
    }
    e = gmda_pollEvent();
}

Use cases

Build a save-slot selection screen.
Show which slots are used and when they were last updated.