SpacetimeDB Client SDK for Godot (GDScript)

A pure-GDScript client for SpacetimeDB. Talk to a SpacetimeDB module from standard Godot 4.7 — 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, and reducer call wrappers.
• BSATN v3 over WebSocket. The current SpacetimeDB wire protocol, including v3 message batching.
• Local database cache. Primary-key and PK-less tables, unique-index and btree-index lookups, insert/update/delete row signals.
• Subscriptions. Subscribe with SQL queries; rows stream into the cache and fire typed signals.
• Reducer calls with structured outcomes. OK / OK_EMPTY / ERROR / INTERNAL_ERROR / TIMEOUT / DISCONNECTED, plus access to raw return bytes.
• Auto-reconnect. Exponential backoff with jitter; saved subscriptions are restored on reconnect.
• Fluent query builder. SpacetimeDBQuery.table("user").where("online", true).
• Token persistence + auto-rejoin. Reconnect with the same identity.

Compatibility

• Godot 4.4+
• SpacetimeDB 2.2.0 – 2.6.0 (schema v10, BSATN protocol v3)
• For servers below 2.2.0, use an SDK 1.x release.

Getting started

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