SpacetimeDB Client SDK for Godot (GDScript)

A pure-GDScript client for SpacetimeDB. Talk to a SpacetimeDB module from standard Godot — no .NET / Mono build required — and export to web via the Compatibility renderer.

Features

• Typed bindings, generated from your schema. Point the codegen at your module and get typed tables, rows, reducer and procedure wrappers.
• BSATN over WebSocket. The current SpacetimeDB wire protocol, including message batching, with GZIP and Brotli compression.
• Local database cache. Primary-key and PK-less tables, unique-index O(1) lookups, btree multimap and sorted range queries (filter_range / filter_gte / filter_lt), typed per-field finders, and insert / update / delete row signals.
• Subscriptions. Subscribe with SQL queries; rows stream into the cache and fire signals. Await helpers, server-error propagation, subscribe_all_tables().
• Reducers and procedures with structured outcomes. OK / OK_EMPTY / ERROR / INTERNAL_ERROR / TIMEOUT / DISCONNECTED, plus typed decode() of return values.
• Auto-reconnect. Exponential backoff with jitter; subscriptions are restored across the reconnect and in-flight handles are invalidated cleanly.
• Frame-budgeted apply. Large bursts drain across frames instead of stalling one. BSATN parsing runs on a background thread by default.
• Fluent query builder. SpacetimeDBQuery.table("user").where("online", true).
• SpacetimeAuth OIDC token exchange. Trade a provider credential for a SpacetimeDB token and feed it straight to the connection.
• Token persistence + auto-rejoin. Reconnect with the same identity.
• Request latency stats, bucketed per request category.

Compatibility

• Godot 4.6 or newer. No .NET / Mono build required.
• SpacetimeDB 2.2.0 or newer. For older servers, use an SDK 1.x release.

Every release names the exact Godot and SpacetimeDB versions it was verified against — see Compatibility in the README and the CHANGELOG.

Getting started

See the README and EXAMPLE.md for setup, codegen, and a complete Blackholio example client.