# DiceyTable Developer Docs > How to build games, rooms and asset packs for DiceyTable, a free browser-based 3D tabletop with real physics: the in-browser editor, table and mod scripting, the mod manifest and publishing, plugins, and connecting an AI agent such as Claude Code through the DiceyTable MCP server. Every docs page has a Markdown twin at its URL plus `.md` (for example https://diceytable.com/docs/ai-agents.md). ## Start here - [DiceyTable Developer Docs](https://diceytable.com/docs.md): What can I build with DiceyTable, and where do I start? - [How to Read These Docs](https://diceytable.com/docs/reading-these-docs.md): The conventions behind every page — generated versus hand-written sections, badges, verified examples, disclosed drift, date stamps, and the AI reference. ## Editor Guide Scenes, entities, materials, decks, seats and zones: everything inside Edit Mode. Full text: https://diceytable.com/docs/editor/llms-full.txt - [Edit Mode](https://diceytable.com/docs/editor.md): Edit Mode is DiceyTable's authoring environment: a scene document you edit directly, with physics frozen by default and nothing uploaded to a server. - [The Scene Model](https://diceytable.com/docs/editor/concepts/scene-model.md): Entity, Component, System, Folder and Tag Group — the five composition nouns DiceyTable uses, and why Component never means a thing you place on the table. - [Provenance and Lifecycle](https://diceytable.com/docs/editor/concepts/provenance.md): Where a thing came from — Engine, Platform or Project — and what stage it is at: Definition, Scene Entity or Live Entity. Every noun has a coordinate on both. - [Document vs Engine](https://diceytable.com/docs/editor/concepts/document-vs-engine.md): The scene document is the source of truth and the PlayCanvas graph is a render artefact rebuilt from it. Patching a live entity without a write-back is a bug. - [Render Layers](https://diceytable.com/docs/editor/concepts/render-layers.md): Scene, Table and Game — the three render layers a DiceyTable scene draws through, what lands on each, and how a light chooses which ones it reaches. - [IDs, Names and Tags](https://diceytable.com/docs/editor/concepts/ids-names-tags.md): Three names per entity and only one of them is an address: id resolves, label is the slug and card identity, displayName is for humans. Plus the dt: prefix. - [Editor URLs and Modes](https://diceytable.com/docs/editor/concepts/editor-urls.md): Every URL that opens Edit Mode, what each editor mode edits, how a link names the mod it opens, and why a second tab on the same mod opens read-only. - [Glossary](https://diceytable.com/docs/editor/concepts/glossary.md): Every term the DiceyTable Developer Docs use, defined once: the ECS nouns, the three names, seat templates and zone types, and the provenance axis. - [The Topbar and Menu Bar](https://diceytable.com/docs/editor/interface/topbar.md): Edit Mode's top two rows — the logo bar (project, variant, save pill, Save Draft, Preview, Publish) and the File / Edit / View / Mod / Help menu bar. - [The Screenshots Gallery](https://diceytable.com/docs/editor/interface/screenshots.md): The gallery of Preview photo-mode captures stored under screenshots/ — download, delete, promote one to the store page or cover, or retake it. - [The Transform Rail](https://diceytable.com/docs/editor/interface/transform-rail.md): The narrow left rail — Select, Move, Rotate and Scale on Q/W/E/R, the snap-point flyout, the radius toggle, the grid tool, and Frame selection. - [Opening Projects](https://diceytable.com/docs/editor/interface/projects.md): Create a mod, find the ones you own by kind, switch between them, delete one you never published, and open one in another mode or tab. - [The Hierarchy Panel](https://diceytable.com/docs/editor/interface/hierarchy.md): Edit Mode's authoring tree — filter and tag pills, folders and seat folders, Seat Template and Snap Points rows, eye and lock, context menus. - [The Versions Panel](https://diceytable.com/docs/editor/interface/versions.md): Restore points in Edit Mode — the draft label, the optional note, how a version is numbered and captured, and exactly what Restore overwrites. - [The Viewport](https://diceytable.com/docs/editor/interface/viewport.md): The stage and its toolbar — World and Local, Frozen and Live, script play controls, the camera, room-geometry and render-layer view controls. - [The Inspector Panel](https://diceytable.com/docs/editor/interface/inspector.md): Where the Inspector sits in Edit Mode, how it tracks selection across the Hierarchy, viewport and asset explorer, and its own resize handle. - [The Asset Explorer](https://diceytable.com/docs/editor/interface/asset-explorer.md): The Edit Mode bottom panel — Project and read-only Library panes, six views, multi-select, group move/copy/delete, Upload, and what each item does. - [The Script Console](https://diceytable.com/docs/editor/interface/script-console.md): The collapsible strip under the viewport that shows log, broadcast, diagnostic and system output while a scene's table scripts run inside Edit Mode. - [The Status Bar](https://diceytable.com/docs/editor/interface/status-bar.md): Edit Mode's footer strip — the save, draft and scene validity dots, the Problems panel they open, the project name, and the GitHub checkpoint and sync status. - [Preferences and Display Units](https://diceytable.com/docs/editor/interface/preferences.md): File ▸ Preferences… picks the unit the editor shows and reads lengths in — mm, cm, m, inches, feet or yards. Display only: your mod's files never change. - [The Inspector](https://diceytable.com/docs/editor/inspector.md): How the Inspector is organized — Engine components vs Platform panels, the ENTITY header, and which page documents each selectable node kind. - [ENTITY](https://diceytable.com/docs/editor/inspector/entity.md): The entity header on every object selection: enabled state, the two names, parent, tags and transform. Disabling it disables every component too. - [PIECE](https://diceytable.com/docs/editor/inspector/piece.md): The PIECE panel — Platform kind, Surface, the seat an entity belongs to, token and coin flipping and card paper thickness. A Platform panel, not a component. - [RENDER](https://diceytable.com/docs/editor/inspector/render.md): The RENDER engine component — material assignment only. It has no enable checkbox by design; the ENTITY header's Enabled toggle is the only visibility control. - [RIGIDBODY](https://diceytable.com/docs/editor/inspector/rigidbody.md): The RIGIDBODY engine component — body type, mass, friction, restitution, damping, weld, and why Static is what keeps a triangle-mesh collider. - [COLLISION](https://diceytable.com/docs/editor/inspector/collision.md): The COLLISION engine component — shape, the custom-model box collider editor, the three mesh-collider refusals, and the collisionEnabled checkbox. - [LIGHT](https://diceytable.com/docs/editor/inspector/light.md): The LIGHT engine component on a table object — addable and removable, and not the same thing as a room Light. Its basics, bake, shadow and layer fields. - [CAMERA](https://diceytable.com/docs/editor/inspector/camera.md): The CAMERA engine component on a table object — three guardrails enforced by the runtime so an added object camera can never take over what players see. - [SCRIPT](https://diceytable.com/docs/editor/inspector/script.md): The SCRIPT engine component — attaching a Table Script to one object, distinct from a scene script attached to the whole table. - [Material and Texture Fields](https://diceytable.com/docs/editor/inspector/materials-and-textures.md): Every field in the 15-section material inspector, the Advanced toggle, and the texture inspector's info block, Sampling, Compression and WebP panels. - [Platform Panels](https://diceytable.com/docs/editor/inspector/platform-panels.md): Field reference for every Inspector section that is a DiceyTable classification, not an engine component: dice, sound, room, walls, lights, seats and zones. - [Add Component](https://diceytable.com/docs/editor/inspector/add-component.md): The + ADD COMPONENT flow — the addable light and camera set, kebab menus, enable checkboxes — and the component rail's scroll-spy and filter. - [Entity (Advanced)](https://diceytable.com/docs/editor/inspector/entity-advanced.md): The read-only ENTITY (ADVANCED) section — live guid, path and real engine components behind a Scene Entity, unreachable from any script or mod. - [Finding and Selecting Entities](https://diceytable.com/docs/editor/working/hierarchy-and-selection.md): How to search the Hierarchy by name, id or #tag, what the eye and lock icons toggle, and how selection ties the Hierarchy to the viewport. - [Multi-select](https://diceytable.com/docs/editor/working/multi-select.md): Selecting several entities from the Hierarchy or viewport box-select, one gizmo for the whole selection, SELECTION panel bulk actions and group scale modes. - [Parenting](https://diceytable.com/docs/editor/working/parenting.md): How object-to-object parenting works — the kinematic-child rule, grab escalation, the grabbableWhileParented opt-out, and the depth-8 cycle guard. - [Welding](https://diceytable.com/docs/editor/working/welding.md): Weld children turns a parented assembly into one compound rigidbody — what it changes physically, when it is rejected, and how it differs from parenting. - [Tags and Groups](https://diceytable.com/docs/editor/working/tags-and-groups.md): Authoring tags, the unauthorable dt: platform namespace, why it still shows up in read results, and the one case-sensitivity quirk worth knowing about. - [Moving, Rotating and Scaling Entities](https://diceytable.com/docs/editor/working/transform-and-gizmos.md): The Q/W/E/R transform tools, multi-selection gizmos, World vs Local, move assists (snap points, grid, magnetism), arrow-key nudging and Snap Points. - [Importing and Optimizing Models](https://diceytable.com/docs/editor/working/models.md): Accepted formats and the in-browser conversion pipeline, Draco, the stats panel, giving a model a collider, and optimizing without losing the original. - [Assigning and Editing Materials](https://diceytable.com/docs/editor/working/materials.md): How to drag a material onto a Material box, built-in vs project materials, how editing a built-in makes a project copy, and the clear-doesn't-revert gotcha. - [Working with Textures](https://diceytable.com/docs/editor/working/textures.md): Choosing sampler settings, when KTX2/Basis compression pays off and why it is safe across devices, and the known gap where .ktx2 assets skip the Textures tab. - [Working with Decks](https://diceytable.com/docs/editor/working/decks.md): How a deck asset becomes a table entity, why re-editing a deck after placing it needs a re-place rather than a refresh, and when to use a deck at all. - [Attaching and Running Scripts](https://diceytable.com/docs/editor/working/scripts.md): Object scripts vs global scripts, the kind-specific starter each gets, and how Play Scripts runs them live inside the editor. - [Player Zones, Seats and Seat Templates](https://diceytable.com/docs/editor/working/zones-and-seats.md): Seat templates (linked, layout-detached, mirrored seats), seat-local +Z, seat dice and pieces, zone types and options, table zones, seat variables. - [Working with Room and Lighting](https://diceytable.com/docs/editor/working/room-and-lighting.md): Floor, ceiling and wall surfaces, posters, openings, ambient/fog/skybox settings, the three room light types and ambient sound emitters, field by field. - [Model Editor](https://diceytable.com/docs/editor/item-editors/model.md): The model tree, the COLLISION, TRIGGER VOLUME and CONTAINER INTERIOR panels, viewport toggles, Edit in viewport, Re-apply, and the four save-bar states. - [Prefab Editor](https://diceytable.com/docs/editor/item-editors/prefab.md): The 3D .prefab.json editor — arrange a body and bolt-on parts, weld or join them with hinges and springs, and place snap points on the result. - [Die Editor](https://diceytable.com/docs/editor/item-editors/die.md): Design a custom die: shape and edge rounding, materials like resin or granite, a model sealed inside, and per-face art and values. - [Texture Editor](https://diceytable.com/docs/editor/item-editors/texture.md): Sampling, KTX2/Basis compression and WebP re-encode panels for a texture, plus an in-place Resize tool and the quick and advanced image editors. - [Audio Editor](https://diceytable.com/docs/editor/item-editors/audio.md): Trim, fade, normalize, loop-crossfade and re-encode a sound file from its lossless original, with a waveform, draggable trim handles and a looping preview. - [Material Editor](https://diceytable.com/docs/editor/item-editors/material.md): A live interactive sphere preview next to the 15-section material inspector, with admin-only global publishing for built-in materials. - [Deck Editor](https://diceytable.com/docs/editor/item-editors/deck.md): Build a custom deck from card images: resolution presets, card art (fit, bleed, corner rounding), copies, data models, the back picker, sheet generation. - [Card Data Editor](https://diceytable.com/docs/editor/item-editors/card-data.md): Describe a card game to DiceyTable — fields, roles, filters, columns, deck stats and partitions — so the deck builder works for your mod without any code. - [Card Layouts Editor](https://diceytable.com/docs/editor/item-editors/card-layouts.md): Map regions onto a card face, bind them to card fields or live counters, and control exactly what an opponent is allowed to see. - [UI Layout Editor](https://diceytable.com/docs/editor/item-editors/ui-layout.md): Design a game's HUD visually, style widgets and regions, and preview it on real desktop, tablet, phone and VR screens beside the table's own controls. - [Script Editor](https://diceytable.com/docs/editor/item-editors/script.md): The Monaco script editor - API autocomplete, suggestions for tags and names your project really uses, snippets, drag-to-reference and transpile on save. - [Plain File Editor](https://diceytable.com/docs/editor/item-editors/file.md): A text editor for any repo-relative project file — TypeScript, JSON, Markdown, CSS and more — reading and writing bytes straight through the draft filesystem. - [Manifest: the Bots Tab](https://diceytable.com/docs/editor/manifest/bots.md): The manifest editor's Bots tab - import and check AI models, declare scripted and AI bots, wire their handlers and difficulties, and open the training page. - [The Training Page](https://diceytable.com/docs/editor/training.md): The /editor/train page - train a bot model in your browser on your project's rules kernel, watch its strength gauge, resume runs and export a checkpoint. - [Workflow: Starting a New Mod](https://diceytable.com/docs/editor/workflows/new-mod.md): The numbered click-path from opening Edit Mode to a named mod of a chosen kind, in its own public GitHub repository, ready to author. - [Workflow: Importing a Model](https://diceytable.com/docs/editor/workflows/import-a-model.md): The numbered click-path for uploading a GLB, glTF or convertible DCC model, reading its findings, giving it a collider, and placing it on the table. - [Workflow: Making a Board from an Image](https://diceytable.com/docs/editor/workflows/board-from-image.md): Turn one image into a game board — a rectangular slab, or its non-transparent shape extruded — producing a texture, material, model and prefab at once. - [Workflow: Building a Deck](https://diceytable.com/docs/editor/workflows/build-a-deck.md): The numbered click-path for creating a deck asset, uploading card images, generating its sheet, and placing it on the table. - [Workflow: Lighting a Scene](https://diceytable.com/docs/editor/workflows/light-a-scene.md): The numbered click-path for adding room lights, checking their effect with Live physics, and setting ambient, fog, and skybox for the whole room. - [Assigning a Room or Table](https://diceytable.com/docs/editor/workflows/assign-a-room-or-table.md): How a game picks the published room and table packs it uses, why the pick is pinned to an exact version, and why nobody can change either mid-session. - [Workflow: Making a Variant of Your Game](https://diceytable.com/docs/editor/workflows/make-a-variant.md): Add a second set-up to a game (a smaller board, a bigger table, play by hand, a ranked version), then switch variants, preview each and publish. - [Building an Asset Pack](https://diceytable.com/docs/editor/workflows/build-an-asset-pack.md): How to author prefabs, decks, materials, textures and scripts as a publishable Asset pack, and what its published document will and will not carry. - [Importing an Asset Pack](https://diceytable.com/docs/editor/workflows/import-an-asset-pack.md): Browse published Asset packs from the Game Editor, preview a prefab in 3D, and import it by reference or as a copy — with the trade-off spelled out. - [Lifting Content Out of a Pack](https://diceytable.com/docs/editor/workflows/lift-out-of-a-pack.md): Take just the room, just the table or one prefab out of any published pack — the link is cut, and the lift-out is recorded so the source stays credited. - [Scene Check](https://diceytable.com/docs/editor/workflows/scene-check.md): Find the collider problems Edit Mode cannot show you, and save every model's real collider in one click before pieces scatter at a live table. - [Deck and Bag Search](https://diceytable.com/docs/editor/workflows/deck-search.md): Author who may privately look through a deck or bag, what happens to the pile afterwards, and how a deck's own setting overrides the Area zone it sits in. - [Verifying as a New Player](https://diceytable.com/docs/editor/workflows/verify-as-a-new-player.md): Re-fetch your published project and every pack it pins cold from upstream, skipping your own cached copies, to catch a dependency that has gone away. - [Previewing a Draft and Photo Mode](https://diceytable.com/docs/editor/workflows/preview-and-photo-mode.md): Play your unpublished draft in a preview tab that saves nothing, then use photo mode to hide the interface per category and capture Ultra screenshots. - [Workflow: Saving, Versioning and Restoring](https://diceytable.com/docs/editor/workflows/save-versions-restore.md): The numbered click-path for the draft save, named restore points, and how restoring a version overwrites your current draft after a confirmation. - [Workflow: Exporting a Project Snapshot](https://diceytable.com/docs/editor/workflows/export.md): The numbered click-path for downloading your project as a JSON file, and what that file is (and isn't) useful for compared to a GitHub publish. - [Workflow: Opening a Mod on Another Device](https://diceytable.com/docs/editor/workflows/open-on-another-device.md): How opening a GitHub-linked mod re-syncs missing and changed files from your repo automatically, without ever overwriting edits you haven't pushed yet. - [Workflow: Where My Files Live](https://diceytable.com/docs/editor/workflows/where-my-files-live.md): Everything you author is written to a browser-local mirror of your GitHub repo, never a DiceyTable server, with a persistence request and eviction safety net. - [Keyboard Shortcuts](https://diceytable.com/docs/editor/keyboard-shortcuts.md): Every Edit Mode keyboard shortcut, enumerated from the shell's actual key handlers, with what it does and when it's suppressed while typing. - [Troubleshooting](https://diceytable.com/docs/editor/troubleshooting.md): Real, current Edit Mode gaps with a workaround for each - material clear, empty folders, KTX2 listing, long asset paths, AVIF decode, and texture compression. ## Scripting Table scripts with world, mod scripts with api, and how host authority shapes both. Full text: https://diceytable.com/docs/scripting/llms-full.txt - [Scripting API](https://diceytable.com/docs/scripting-api.md): The two DiceyTable script surfaces side by side - Table Scripting's world, globalEvents and refObject, and Mod Scripting's api - and how to pick one. - [Scripting concepts](https://diceytable.com/docs/scripting/concepts.md): The shared ideas behind both DiceyTable script surfaces - where code runs, in what order, how events arrive, and what every reference badge means. - [Host authority](https://diceytable.com/docs/scripting/concepts/host-authority.md): Why a table script runs on exactly one peer, what the other players actually receive, and what the host-only, all-peers and host-authoritative badges mean. - [Execution order](https://diceytable.com/docs/scripting/concepts/execution-order.md): The deterministic order a table script host boots in - handles, scene scripts, object scripts - what already exists when your code runs, and what never re-runs. - [Events and delegates](https://diceytable.com/docs/scripting/concepts/events-and-delegates.md): Delegate scope, handler ordering, how many times each table event fires, which peer raises it, and the plain fact that nothing can cancel an action. - [Async and snapshots](https://diceytable.com/docs/scripting/concepts/async-and-snapshots.md): What a promise means when the answer comes back from the host, why a sync mutator leaves its own handle stale, and when the rest of the table finds out. - [Sandbox limits](https://diceytable.com/docs/scripting/concepts/sandbox-limits.md): The ES-only language subset both script surfaces compile against, what the sandbox frame removes at run time, and the static scanner that reads your comments. - [Choosing a surface](https://diceytable.com/docs/scripting/concepts/choosing-a-surface.md): Table script or mod script? A capability-by-capability decision table, what each surface alone can do, and why moving between them later is a rewrite. - [Game UI (HUD)](https://diceytable.com/docs/scripting/concepts/game-ui.md): The Game UI, or HUD - status lines, prompts, action strips, logs and hints drawn off the table, private per seat, from a table script or a mod. - [Highlights and clicks](https://diceytable.com/docs/scripting/concepts/highlights-and-clicks.md): Outline entities with named styles, publicly or privately per seat, and hear which entity a player clicked - the pick-a-card loop of a scripted game. - [Asset Pack Script Scope](https://diceytable.com/docs/scripting/concepts/pack-script-scope.md): A prefab's script runs under its own pack scope, pinned to a version, so it cannot read another pack's saved data or the game's - and what follows for authors. - [World](https://diceytable.com/docs/scripting-api/world.md): The world global every table script receives - spawn entities, query the table, read players and turns, log, broadcast to chat, persist data and pace work. - [ObjectHandle](https://diceytable.com/docs/scripting-api/objecthandle.md): A live handle to one entity on the table - the ten read-only fields a table script can see, and the fourteen methods it can call to move, act on and read it. - [Object Types](https://diceytable.com/docs/scripting-api/object-types.md): The per-kind handle types a table script sees - CardObject, DeckObject and the rest, what each adds to ObjectHandle, and how refObject gets one without a cast. - [Events](https://diceytable.com/docs/scripting-api/events.md): The 21 globalEvents delegates a table script can subscribe to - each one's payload, who raises it, and when - plus ZoneEvent and TriggerEvent. - [Types](https://diceytable.com/docs/scripting-api/types.md): The fourteen ambient declarations a table script compiles against - Vec3, ObjectKind, the action unions, SpawnObjectOptions, DiceRollSummary, declareVariables. - [Bots and AI](https://diceytable.com/docs/scripting-api/bots-and-ai.md): The bots and ai globals a table script receives - register the code that plays a bot, search with a rules kernel, and run a game's own AI model on the host. - [Matches and Variants](https://diceytable.com/docs/scripting-api/matches.md): The match global that starts a match, records its moves and reports the result, plus world.getVariant for branching one script across variants. - [Game UI (ui)](https://diceytable.com/docs/scripting-api/game-ui.md): The ui global for table scripts - show HUD widgets, bind their text to state, ask a seat with ui.prompt and answer presses in ui.onAction. - [The mod api object](https://diceytable.com/docs/scripting-api/api.md): Every method a mod script can call - the capability-gated members of the injected api object, the exports.setup entry point, and the types they exchange. - [Mod hooks and capabilities](https://diceytable.com/docs/scripting-api/hooks-and-capabilities.md): The 14 hooks a mod can subscribe to with api.on, the exact payload each one carries, which peer raises it, plus the unbounded custom UI-hook channel. ## Mods & Publishing The manifest, the file layout, the security scanner and the trip from draft to live table. Full text: https://diceytable.com/docs/mods/llms-full.txt - [Mods](https://diceytable.com/docs/mods.md): What a DiceyTable mod is, the three manifest types, and why GitHub — not our servers — holds the files that make a mod real and multiplayer-ready. - [Your first mod](https://diceytable.com/docs/mods/getting-started/your-first-mod.md): One continuous path from a blank New Mod dialog to a mod you can open in a real multiplayer room — every step with a definition of done and its failure branch. - [Anatomy of a mod](https://diceytable.com/docs/mods/getting-started/anatomy-of-a-mod.md): A complete, annotated file tree for a real DiceyTable mod — what each file is, who reads it, and which parts are required versus editor convention. - [Manifest reference](https://diceytable.com/docs/mods/manifest/reference.md): Every field of diceytable.mod.json — what it does, who reads it, its constraints and exact validation message, and a worked example, verified against source. - [Mod Capabilities](https://diceytable.com/docs/mods/manifest/capabilities.md): The 16 capabilities that gate the mod api object — which methods each unlocks, how one is detected, and what the table discloses to players. - [Game Variants](https://diceytable.com/docs/mods/manifest/variants.md): Offer one game pack in several set-ups, from board sizes to a fully scripted ranked version. The manifest list, the setup.json block and what is refused. - [Mod categories](https://diceytable.com/docs/mods/manifest/categories.md): The curated category slugs a mod manifest's category field accepts — one list per pack type, with the rule that a slug can never be renamed. - [Engine compatibility](https://diceytable.com/docs/mods/manifest/compatibility.md): The exact grammar compatibility.engine is checked against — a hand-rolled two-token parser, not semver, including a form that silently matches everything. - [Game Bots](https://diceytable.com/docs/mods/concepts/bots.md): Opponents that hold a seat - scripted and AI bots, models as data, hardware tiers, host migration, hidden information and what a trained model is worth. - [Training a Bot Model](https://diceytable.com/docs/mods/guides/training-bots.md): From a rules kernel to an ONNX model your AI bot can use - training in the browser or with the trainer CLI, measuring strength, and importing the result. - [Ranked Games, Rankings and Player Trust](https://diceytable.com/docs/mods/concepts/ranked-games.md): What a ranked match guarantees and what it does not: grades, disputes, consent takebacks, placement, ladders and seasons, Scores and Player Trust. - [Required and conventional files](https://diceytable.com/docs/mods/files/required-and-conventional.md): The crisp answer — exactly one file is required. Everything else is manifest-declared, plus the full convention table the editor actually produces on disk. - [Setup JSON](https://diceytable.com/docs/mods/files/setup-json.md): The edit-scene setup.json format every mod authored in Edit Mode produces, how it is detected, and a note on the older mod-setup format it replaced. - [Assets](https://diceytable.com/docs/mods/files/assets.md): The 20 file extensions a mod may declare, their content-type policy, size caps (incl. the 10 MB HDR sky cap), and the 7 decodable texture formats. - [Sidecars](https://diceytable.com/docs/mods/files/sidecars.md): Files beside a mod's assets — model meta, deck definitions and assemblies — plus the link records, thumbnails and folder keepers the editor manages. - [Cover art and screenshots](https://diceytable.com/docs/mods/files/media.md): The reserved media/ folder's exact sizes, crop math, WebP encoding, and the image-only rule the scanner enforces on every file placed there. - [What Gets Rejected](https://diceytable.com/docs/mods/scanner/what-gets-rejected.md): Every rule the scanner, the registry and the editor use to reject a script, asset, manifest, pack or dependency graph, with the code and message for all 99. - [Script Safety](https://diceytable.com/docs/mods/scanner/script-safety.md): The 5 whole-word regex patterns that reject a mod script on sight, why false positives are accepted by design, and how to work around them safely. - [Fixing a Rejection](https://diceytable.com/docs/mods/scanner/fixing-a-rejection.md): Pasted an error code from a rejected mod? Look it up here for the exact cause and the fix, without touching any allowlist or sandbox rule. - [Connect GitHub](https://diceytable.com/docs/mods/publishing/github-setup.md): How DiceyTable's GitHub OAuth App works, how linking or creating a repository fits into mod authoring, and why new repositories are created public. - [The Publish Flow](https://diceytable.com/docs/mods/publishing/publish-flow.md): What happens when you edit a mod in Edit Mode: the debounced auto-checkpoint, Publish, the wip-to-main merge, the generated repository README, and registration. - [wip and main: the Two-Branch Model](https://diceytable.com/docs/mods/publishing/wip-and-main.md): Why Edit Mode pushes to a wip branch on every checkpoint, how that differs from a publish, and what lives on each branch at any given moment. - [Registration & Multiplayer Play](https://diceytable.com/docs/mods/publishing/registration-and-play.md): Why a mod must be registered from GitHub before it can be selected for a room, and how each peer independently pulls and caches a published mod's files. - [Asset Delivery and the CDN](https://diceytable.com/docs/mods/publishing/asset-delivery.md): How mod files and declared plugin resources reach browsers through cdn.diceytable.com, the rules the edge enforces, and what stays on GitHub. - [Offline Play](https://diceytable.com/docs/mods/publishing/offline-play.md): How DiceyTable installs as an app, which two caches have to be warm before a table boots with no network, and what makes a published mod solo-offline-capable. - [Credit and Being Credited](https://diceytable.com/docs/mods/publishing/attribution.md): How a pack's listing page credits what it uses, how the reverse "Used by" listing works, and why credit is derived from dependencies rather than typed in. - [Publishing Troubleshooting](https://diceytable.com/docs/mods/publishing/troubleshooting.md): Fixes for the most common GitHub publishing problems in Edit Mode — OAuth setup, disconnects, a disabled Publish button, merge conflicts, and missing assets. - [Object kinds](https://diceytable.com/docs/mods/reference/object-kinds.md): The 11 TableObjectKind values (card to coin) — what each does at the table, its physics defaults, its default scale/color, and which fields matter. - [Object actions](https://diceytable.com/docs/mods/reference/object-actions.md): The 27 TableObjectAction values and their per-kind gating — a full kind-by-action matrix, with the state-dependent exceptions called out. - [Object state](https://diceytable.com/docs/mods/reference/object-state.md): Every TableObjectState field and its 7 sub-collections — zones, snapPoints, vectorLines, decals, textLabels, joints and ui — with each schema. - [Intents](https://diceytable.com/docs/mods/reference/intents.md): All 26 TableIntent variants, grouped by area, including the three declared-but-not-implemented edit-* intents that are not reachable from any authoring surface. - [Standard presets](https://diceytable.com/docs/mods/reference/standard-presets.md): The 160 built-in STANDARD_OBJECT_PRESETS definitions — verified counts, the 22 hidden from spawn catalogs, and the pattern behind which ones are hidden. - [Sound sets](https://diceytable.com/docs/mods/reference/sound-sets.md): The five sound enums (12 materials, 18 actions, 16 runtime events, 3 counts, 2 intensities), a mod's soundSets, and how a SoundRef stays license-safe. - [Limits and caps](https://diceytable.com/docs/mods/reference/limits-and-caps.md): Every size and count cap a mod author is likely to hit — table state, setup and manifest arrays, file trees, assets, and the mod draft text fields. ## Plugins Card data from an outside provider, through declared functions and a server-side allowlist. Full text: https://diceytable.com/docs/plugins/llms-full.txt - [Plugins](https://diceytable.com/docs/plugins.md): What a plugin is, why its data and table halves run on two machines, its three capabilities, the files it can ship, and how one reaches a table. - [Writing a Plugin](https://diceytable.com/docs/plugins/authoring.md): The diceytable.plugin.json manifest end to end - origins, endpoints, card mapping, deck import, exposed API, capabilities, resources and quotas. - [A Worked Example - Scryfall Card Data](https://diceytable.com/docs/plugins/scryfall-example.md): A complete, validated plugin manifest read block by block - origins, endpoints, the card mapping, the UI descriptor, and the four things it cannot do yet. - [breakingVersion and Migration](https://diceytable.com/docs/plugins/breaking-changes.md): When to bump breakingVersion, what a bump does to saved decks, how a changed resource file is re-registered, and worked examples of each. - [Calling a Plugin from a Mod](https://diceytable.com/docs/plugins/calling-from-a-mod.md): How a mod declares plugins, calls a declared function with api.callPlugin, and why a dynamic or undeclared plugin call is rejected at publish time. ## Reference Enums, action vocabularies, limits and an honest list of what does not work yet. Full text: https://diceytable.com/docs/reference/llms-full.txt - [Action vocabularies](https://diceytable.com/docs/reference/action-vocabularies.md): Three object-action vocabularies - 27 engine actions, the 13 a table script may request, the 10 a mod may - what each one does, and exactly why they differ. - [Prop surfaces](https://diceytable.com/docs/reference/prop-surfaces.md): Interactive screens on table objects - the surface rect, the widget tree, how a press becomes host-authoritative state, and what can be shown in world. - [ObjectKind vs TableObjectKind](https://diceytable.com/docs/reference/enums/object-kind.md): The eleven entity kinds the engine can spawn, which of the two declared unions names each one, and the open escape hatch that keeps a typo from erroring. - [ObjectAction (table script)](https://diceytable.com/docs/reference/enums/object-action.md): The 13 actions a table script may request, the 9 that have an ObjectHandle method, the 4 that do not, and what the script host does with each one. - [TableObjectAction (engine)](https://diceytable.com/docs/reference/enums/table-object-action.md): All 27 actions the runtime can apply to one entity, what each does, which kinds a player may send it for, and which script surfaces can request it. - [SANDBOX_SAFE_OBJECT_ACTIONS](https://diceytable.com/docs/reference/enums/sandbox-safe-object-actions.md): The 10 object actions a mod may request through api.objectAction, what each does per kind, and the three independent checks that enforce the list. - [ModCapability](https://diceytable.com/docs/reference/enums/mod-capability.md): The 16 capability slugs a mod manifest can declare, the api methods each one unlocks, and which context reads them - as a compact value table. - [SoundMaterial](https://diceytable.com/docs/reference/enums/sound-material.md): The 12 materials that pick a piece's sound and colour whatever lands on them — each kind's default, the struck-surface tone, and how a mod names one. - [SoundAction](https://diceytable.com/docs/reference/enums/sound-action.md): The 18 logical interactions that can emit a sound, which entity kinds bind each one, and why this list is not the object-action list. - [RuntimeSoundEvent](https://diceytable.com/docs/reference/enums/runtime-sound-event.md): The 16 runtime moments that can emit a sound, the sound action each one maps to for every entity kind, and which moments a mod can trigger itself. - [TableUiWidgetType](https://diceytable.com/docs/reference/enums/table-ui-widget-type.md): The 8 table UI widget types a mod can create, the props each one reads, and which four of them actually dispatch an interaction back to your script. - [Scanner rule codes](https://diceytable.com/docs/reference/enums/scanner-rule-codes.md): The 5 script-content rule codes, the exact tokens each regex rejects, its error message, and the fact that both script surfaces are scanned. - [Known limitations](https://diceytable.com/docs/reference/known-limitations.md): Every documented gap and deliberate boundary in DiceyTable scripting, in one dated list - what you observe, whether it will change, and what to do instead. ## AI Agents Let Claude Code, Cursor or VS Code build and play-test in a tab you connect, as you. Full text: https://diceytable.com/docs/ai-agents/llms-full.txt - [AI Agents in DiceyTable](https://diceytable.com/docs/ai-agents.md): What can an AI agent do in DiceyTable? - [Connect an AI Agent to DiceyTable](https://diceytable.com/docs/ai-agents/quick-start.md): How do I connect an AI agent like Claude to DiceyTable? - [What Is MCP? AI Agents and DiceyTable](https://diceytable.com/docs/ai-agents/concepts/what-is-mcp.md): What is MCP, and why does DiceyTable use it? - [Install the DiceyTable MCP Bridge](https://diceytable.com/docs/ai-agents/setup/install.md): What do I need to install the DiceyTable MCP bridge? - [Add the DiceyTable MCP Server to Claude Code](https://diceytable.com/docs/ai-agents/setup/claude-code.md): How do I add the DiceyTable MCP server to Claude Code? - [Add DiceyTable to Claude Desktop](https://diceytable.com/docs/ai-agents/setup/claude-desktop.md): How do I add the DiceyTable MCP server to Claude Desktop? - [Add the DiceyTable MCP Server to Cursor](https://diceytable.com/docs/ai-agents/setup/cursor.md): How do I add the DiceyTable MCP server to Cursor? - [Use DiceyTable With Copilot in VS Code](https://diceytable.com/docs/ai-agents/setup/vs-code.md): How do I add the DiceyTable MCP server to VS Code? - [Create an API Key for Your AI Agent](https://diceytable.com/docs/ai-agents/setup/api-keys.md): How do I create a DiceyTable API key for an AI agent? - [Pair a DiceyTable Tab With Your Agent](https://diceytable.com/docs/ai-agents/setup/pairing.md): How do I connect a DiceyTable tab to my agent with a pairing code? - [Allow Local Network Access for the Bridge](https://diceytable.com/docs/ai-agents/setup/local-network-access.md): Why does my browser ask to access devices on my local network? - [Check Your Agent Is Connected](https://diceytable.com/docs/ai-agents/setup/verify.md): How do I check my AI agent is connected to DiceyTable? - [Use One Agent Across Several Tabs](https://diceytable.com/docs/ai-agents/setup/multiple-tabs.md): How does one agent work across several DiceyTable tabs? - [In-Browser AI Agents (WebMCP)](https://diceytable.com/docs/ai-agents/setup/webmcp.md): Can my browser's built-in AI agent use DiceyTable? - [How the DiceyTable MCP Bridge Works](https://diceytable.com/docs/ai-agents/concepts/how-it-works.md): How does the bridge connect my agent to my browser tab? - [Build a Game With an AI Agent](https://diceytable.com/docs/ai-agents/workflows/build-a-game.md): How does an AI agent build a game from start to finish? - [Example Prompts for Building Games With AI](https://diceytable.com/docs/ai-agents/workflows/example-prompts.md): What can I ask an AI agent to do in DiceyTable? - [Instructions to Give Your AI Agent](https://diceytable.com/docs/ai-agents/workflows/agent-instructions.md): What standing instructions should I give my agent for DiceyTable? - [Let an Agent Edit Your Scene](https://diceytable.com/docs/ai-agents/workflows/edit-the-scene.md): How does an agent place and change things in the editor? - [Build a Deck of Cards With an Agent](https://diceytable.com/docs/ai-agents/workflows/build-a-deck.md): How does an agent turn card art into a playable deck? - [Write Game Scripts With an Agent](https://diceytable.com/docs/ai-agents/workflows/write-scripts.md): How does an agent write and check my game's scripts? - [Build a Room or Table Pack With an Agent](https://diceytable.com/docs/ai-agents/workflows/build-a-room-or-table.md): How does an agent build a room or a table pack? - [Import Models, Images and Sounds With an Agent](https://diceytable.com/docs/ai-agents/workflows/importing-assets.md): How does an agent import models, images and sounds into my project? - [Play-Test Your Game With an Agent](https://diceytable.com/docs/ai-agents/workflows/playtest.md): How does an agent play-test my game? - [Find Errors With the Diagnostics Hub](https://diceytable.com/docs/ai-agents/workflows/diagnostics.md): How does an agent find errors in my game? - [Take Screenshots With an Agent](https://diceytable.com/docs/ai-agents/workflows/screenshots.md): How does an agent take screenshots of my game? - [Exact Panel Capture for AI Agents](https://diceytable.com/docs/ai-agents/workflows/exact-panel-capture.md): What is exact panel capture, and when should I allow it? - [Set Up a Multiplayer Lobby With an Agent](https://diceytable.com/docs/ai-agents/workflows/lobby.md): How does an agent set up and start a multiplayer game? - [Add Game Bots to a Lobby With an Agent](https://diceytable.com/docs/ai-agents/workflows/lobby-bots.md): How does an agent add bots to a game lobby? - [Test Multiplayer With Two Agents](https://diceytable.com/docs/ai-agents/workflows/multiplayer-testing.md): How do I test my game with two players at once? - [Get Your Game Ready to Publish With an Agent](https://diceytable.com/docs/ai-agents/workflows/publish.md): Can an AI agent publish my game? - [AI Agent Safety in DiceyTable](https://diceytable.com/docs/ai-agents/concepts/security-model.md): Is it safe to let an AI agent use my DiceyTable account? - [Hidden Cards and AI Agents](https://diceytable.com/docs/ai-agents/concepts/hidden-information.md): Can an AI agent see hidden cards or the deck order? - [Actions That Need Your Click](https://diceytable.com/docs/ai-agents/concepts/confirmations.md): Which agent actions need my approval? - [Watch, Pause or Stop Your Agent](https://diceytable.com/docs/ai-agents/setup/indicator.md): How do I see what my agent is doing, or stop it? - [Disconnect, Revoke or Remove the Agent](https://diceytable.com/docs/ai-agents/setup/uninstall.md): How do I switch off or remove the DiceyTable agent? - [AI Agent Privacy: What Leaves Your Computer](https://diceytable.com/docs/ai-agents/concepts/privacy.md): What data leaves my computer when an agent works in DiceyTable? - [Which Local Files an Agent Can Read](https://diceytable.com/docs/ai-agents/concepts/local-file-access.md): Which files on my computer can an agent read or write? - [How URL Imports Are Fetched Safely](https://diceytable.com/docs/ai-agents/concepts/url-imports.md): How does DiceyTable download a web file for my agent? - [Prompt Injection Protection for AI Agents](https://diceytable.com/docs/ai-agents/concepts/prompt-injection.md): How does DiceyTable stop text in a game from tricking my agent? - [Review Credits an AI Agent Added](https://diceytable.com/docs/ai-agents/concepts/ai-attested-credits.md): Why must I review credits an AI agent added before publishing? - [The AI Badge Other Players See](https://diceytable.com/docs/ai-agents/concepts/multiplayer-disclosure.md): Will other players know I'm using an AI agent? - [AI Agents, Dice Chips and Stats](https://diceytable.com/docs/ai-agents/concepts/chips-and-stats.md): Does using an AI agent cost me dice chips or stats? - [AI Agents and Ranked Matches](https://diceytable.com/docs/ai-agents/concepts/ranked-play.md): Can an AI agent play ranked matches? - [AI Agent Tool Reference](https://diceytable.com/docs/ai-agents/reference/tools.md): Which tools does the DiceyTable MCP server give an agent? - [Session Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/sessions.md): Which tools connect an agent and pick the DiceyTable tab it works in? - [Page, Panel and Field Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/pages-and-fields.md): Which tools let an agent read a page and set any field or button? - [Project and Publishing Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/projects-and-publishing.md): Which tools let an agent open, save, version and publish a project? - [Scene Editing Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/scene.md): Which tools let an agent place and change things in the editor scene? - [Room, Pack and Manifest Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/rooms-packs-manifest.md): Which tools let an agent set up the room, table pack and mod manifest? - [Asset and Credit Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/assets-and-credits.md): Which tools let an agent manage project files, imports and credits? - [Script and UI Layout Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/scripts-and-ui.md): Which tools let an agent write scripts and game UI layouts? - [Deck, Card and Image Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/decks-cards-images.md): Which tools let an agent build decks and cards and edit images? - [Play-Test Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/playtest.md): Which tools let an agent run and check a play-test preview? - [Table Reading Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/table-reading.md): Which tools let an agent see what is on the table? - [Table Action Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/table-actions.md): Which tools let an agent move, deal and roll at the table? - [Screenshot Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/screenshots.md): Which tools let an agent take screenshots of DiceyTable? - [Diagnostics Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/diagnostics.md): Which tools let an agent read errors and warnings from a tab? - [Lobby Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/lobby.md): Which tools let an agent set up and start a multiplayer lobby? - [Rankings and Match Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/rankings.md): Which tools let an agent read rankings, matches and Player Trust? - [Game Bot and AI Model Tools for AI Agents](https://diceytable.com/docs/ai-agents/reference/tools/bots-and-ai-models.md): Which tools let an agent add game bots and AI models? - [AI Agent Field Catalogue](https://diceytable.com/docs/ai-agents/reference/fields.md): How does an agent find and set any control in DiceyTable? - [Editor Fields for AI Agents](https://diceytable.com/docs/ai-agents/reference/fields/editor.md): Which Edit Mode fields and buttons can an agent set? - [Inspector Fields for AI Agents](https://diceytable.com/docs/ai-agents/reference/fields/inspector.md): Which Inspector fields can an agent set? - [Item Editor Fields for AI Agents](https://diceytable.com/docs/ai-agents/reference/fields/item-editors.md): Which item editor fields can an agent set? - [Deck and Card Layout Editor Fields for AI Agents](https://diceytable.com/docs/ai-agents/reference/fields/deck-and-layout-editors.md): Which deck and card layout fields can an agent set? - [UI Layout Editor Fields for AI Agents](https://diceytable.com/docs/ai-agents/reference/fields/ui-layout-editor.md): Which UI layout fields, including style and region layout, can an agent set? - [Editor Dialog Fields for AI Agents](https://diceytable.com/docs/ai-agents/reference/fields/dialogs.md): Which editor dialog fields can an agent set? - [Table Fields for AI Agents](https://diceytable.com/docs/ai-agents/reference/fields/table.md): Which table menus and settings can an agent set? - [Seat Fields for AI Agents](https://diceytable.com/docs/ai-agents/reference/fields/seats.md): Which seat and zone fields can an agent set? - [Room and Pack Fields for AI Agents](https://diceytable.com/docs/ai-agents/reference/fields/rooms-and-packs.md): Which room and table pack fields can an agent set? - [Lobby Fields for AI Agents](https://diceytable.com/docs/ai-agents/reference/fields/lobby.md): Which lobby fields and buttons can an agent use? - [AI Agent Error Codes](https://diceytable.com/docs/ai-agents/reference/errors.md): What does this agent error code mean? - [AI Agent Limits and Quotas](https://diceytable.com/docs/ai-agents/reference/limits.md): What are the limits on what an agent can do? - [Diagnostics Sources Reference](https://diceytable.com/docs/ai-agents/reference/diagnostics.md): Which sources feed an agent's diagnostics hub? - [Bridge Command Line Reference](https://diceytable.com/docs/ai-agents/reference/bridge-cli.md): What commands and flags does the DiceyTable bridge accept? - [Fix AI Agent Problems](https://diceytable.com/docs/ai-agents/troubleshooting.md): My AI agent isn't working. Where do I start? - [Fix an Agent That Won't Connect](https://diceytable.com/docs/ai-agents/troubleshooting/connection.md): Why won't my agent connect to DiceyTable? - [Fix Pairing Code Problems](https://diceytable.com/docs/ai-agents/troubleshooting/pairing-code.md): Why does DiceyTable ask me for a new pairing code?