---
title: "live"
description: "The live namespace — the engine's Luau API reference for live."
section: "API Reference"
slug: "api-live"
canonical: "https://origozero.ai/docs/api-live"
updated: "2026-08-22T18:22:38.070166414+00:00"
tags: ["api", "reference"]
---

# live

The `live` namespace — 1 function.

## live/isConnected {#live-isconnected}

```lua
live.isConnected() -> boolean
```

True when the engine currently holds an established live SpacetimeDB session — the handshake completed and the connection has not dropped. Mirrors the engine's SpacetimeClientResource state, refreshed once per frame by the connection observer. Use it to gate connection-dependent work or to drive reconnect / status UI. The trusted entrypoint additionally receives an `onLiveConnectionChanged(connected)` lifecycle callback on every transition (drop -> false, (re)connect -> true), so a banner can be raised/torn down without polling.

**Returns** `boolean` — true iff a live session is currently established.