GameMaker Studio · GML · Setup & session

gmda_Updatefunction

Drives the whole lifecycle. Call EVERY Step on the persistent controller.

Signature

gmda_Updatefunction() -> real

What it does

The heartbeat of the client. Each Step it advances the phase machine: starting the session, loading tables one at a time, renewing the session before it expires, and retrying any pending offline scores. It auto-emits session_started { player_id, player_name, is_new }, tables_loaded { success }, and on failure error { event_for, error, http_status } onto the event queue.

Parameters

This function takes no parameters.

How to call it

Call it once, every Step, in the persistent controller object. Pair it with gmda_HTTPfunction() in the Async HTTP event and gmda_pollEvent() to read what it emits.

Example

// objGamdatoController Step event
gmda_Updatefunction();

Use cases

• Keep the session alive and tables fresh for the whole game.
• Automatically resend scores that were queued while offline.