Documentation
Guides and answers about TTCraft: rooms, channels, game tables and modules.
-
Getting started
What TTCraft is, how to sign up with a one-time email code, and how rooms, channels, game tables and modules fit together.
getting-started.md
Tables
-
Table archives
How a table is saved, downloaded and loaded — the archive format (game.json, manifest.json, blobs by SHA-256), save slots, modules, how assets get onto a table, and why saves from other tabletops are not accepted.
table-archives.md -
Table plan
The table's coordinate frame, and the plan — a JSON description of the outline, the seats, the named areas and the snap points — that a module author or an AI agent writes instead of drawing; what applying it produces, how it travels with a module, and the Table API scripts read it with.
table-plan.md
Table scripting
-
Table scripting
Lua scripting on TTCraft game tables — the execution model, writing handlers, the Global script, persistence, sandbox limits, and what is not available.
scripting.md -
Events and veto hooks
Every event an object or Global script can handle, every try-hook that can cancel a player action, and the exact rules for when each fires.
scripting-events.md -
Objects reference
Every method on the tableweb object handle — identity, transform, physics, containers, counters, clocks, tablets, visuals and per-object UI.
scripting-objects.md -
World reference
The tw global and friends — finding and spawning objects, zones, snap points, physics casts, persistent storage, grid, hands, lighting, music, timers, vectors.
scripting-world.md -
Players and turns
The player handle — capabilities, hands, dialogs, camera and tools, moderation — and the Turns system for turn order.
scripting-players.md -
Custom UI
Ribbon tabs, floating panels, context menus, hotkeys and hiding built-in UI — the declarative control vocabulary tableweb's own interface is built on.
scripting-ui.md -
Build tables with an AI agent
Install TTCraft MCP for Claude Code, Codex and other local MCP clients. Sign in, build a table and watch the result live in your browser.
mcp.md -
Scripting recipes
Complete worked examples — dealers, scoring zones, custom dice, turn rules, hidden information and templated spawning.
scripting-recipes.md -
Scripting from VS Code
The TTCraft VSC extension — sign in from the editor, mirror a running table's Lua scripts as real files, save straight to the table, read the console, and let an AI coding agent work on the scripts.
vscode.md -
TTCraft MCP setup for agents
A complete installation and verification procedure for an assistant configuring TTCraft MCP on the user's computer.
mcp-setup.md
Machine-readable index for LLM agents: llms.txt · llms-full.txt