spacetimedb-unity

To integrate SpacetimeDB with Unity, create a SpacetimeManager MonoBehaviour singleton using DontDestroyOnLoad. Build a DbConnection, call Connection.FrameTick() from Update() to process queued network messages, and subscribe to tables for real-time state updates.

SpacetimeDB callbacks fail or cause thread-safety violations if Connection.FrameTick() is not called from the main thread. Invoke FrameTick() inside the MonoBehaviour Update() loop to ensure queued network messages are processed correctly on the main thread.

Persist SpacetimeDB auth tokens in Unity using PlayerPrefs. In your OnConnected callback, save the token to PlayerPrefs to enable seamless reconnects and prevent token loss across game sessions without requiring external storage solutions.

Yes, SpacetimeDB works with Unity 2022.3+ projects using the MonoBehaviour lifecycle. The SDK integrates with Awake, Start, Update, and OnDestroy hooks, and is installed via Unity Package Manager to ensure proper connection lifecycle management.

To prevent lost connections on scene loads, use a SpacetimeManager MonoBehaviour singleton with DontDestroyOnLoad. This ensures the DbConnection persists across scene transitions, maintaining active subscriptions and avoiding unexpected disconnects during gameplay.

Generate C# module bindings for your SpacetimeDB tables, register OnInsert, OnUpdate, and OnDelete handlers for subscribed tables, and invoke reducers directly from Unity UI events. The FrameTick loop ensures these client cache updates process on the main thread.