Dicey Table

Edit Mode

Edit Mode is DiceyTable's authoring environment: a scene document you edit directly, with physics frozen by default and nothing uploaded to a server.

pages
79
to your first deck
~18 min

Start here

  1. Workflow: Starting a New Mod6 min · a blank project, saved
  2. The Scene Model5 min · what a scene holds
  3. Finding and Selecting Entities4 min · find and pick things
  4. Workflow: Building a Deck3 min · your first deck

Edit Mode is where you build a game. It is the same PlayCanvas table players sit at, put into an authoring state: physics held still, an editable hierarchy on the left, an Inspector on the right, and an asset explorer underneath. You reach it at /editor, or from the Edit Mode toggle on the /table toolbar.

Everything you do in Edit Mode writes to one thing — the scene document. Understanding that single fact explains most of the editor's behavior, so it has a page of its own.

Edit Mode is built for a desktop or tablet. On a tablet the panels and buttons are touch-sized and the transform gizmo is operable by finger; opening it on a phone shows a prompt to switch to a larger screen, because the hierarchy, Inspector and gizmos need the room. The live /table itself is fully playable on a phone — only authoring needs the space.

What you are actually editing#

You are not moving PlayCanvas entities around. You are editing a document, and the engine is redrawn from it.

When you drag a die two feet to the left, the editor writes the new position into the scene document and the runtime rebuilds the die's live entity to match. The live entity is a render artefact. It is destroyed and recreated whenever the document is re-applied, and nothing that lives only on it survives that.

This is why the editor can save, version, restore, replicate and export a scene without ever serializing the engine's scene graph — and why "it looked right until I reloaded" is almost always a symptom of something written to the engine but not to the document.

How Edit Mode differs from the live table#

Live table Edit Mode
What you manipulate A replicated TableSnapshot An EditSceneSnapshot — the scene document
Physics Always simulating Frozen by default — entities hold their authored position
The hierarchy Not shown The full authoring tree: Room, Walls, Lights, Table, Player Zones, Entities
Names Display names only Both the human Name and the machine Slug, side by side
Where changes go Broadcast to every peer by the host Into your local draft until you save a version or publish

Frozen vs Live#

The viewport toolbar has a Frozen / Live pair, and it starts on Frozen.

  • Frozen — entities hold their position. This is what makes authoring deterministic: you can place a board, set a die on top of it and reload without everything having settled somewhere else overnight.
  • Live — physics runs, so you can test how entities actually behave.

Frozen is not a "preview off" switch — the scene is fully rendered either way. It only governs whether the simulation steps. Running a scene script switches Frozen to Live automatically, because most scripts need physics to observe motion at all.

Frozen mode is the single most commonly misread editor behavior. If an entity refuses to fall, drop or settle, check this toggle first.

The vocabulary comes first#

DiceyTable borrows PlayCanvas's ECS vocabulary and uses it strictly. That strictness is load-bearing: "Component" always means an engine component — render, rigidbody, collision, light, camera, script — and never means a thing you place on the table. A thing you place on the table is an Entity.

Read these four pages before the rest of the editor guide. Every other page in the guide, and the scripting and mod references too, assume you have.

  • The scene model — Entity, Component, System, Folder, Tag Group, and the two-tier component split.
  • Provenance and lifecycle — Engine vs Platform vs Project; Definition vs Scene Entity vs Live Entity.
  • Document vs engine — why the schema document is the source of truth, and what that rules out.
  • IDs, names and tags — the three names an entity has, which one is an address, and the reserved dt: tag namespace.

There is also a glossary that defines every term the Developer Docs use, exactly once, with a stable anchor per term.

What Edit Mode is not#

  • It is not a PlayCanvas project editor. You author a DiceyTable scene document. You do not get scenes, script attributes, render layers or the engine's asset registry.
  • It is not a code sandbox with engine access. Scene scripts and mods address entities through the replicated document. pc.Entity, findByTag, entity.tags and engine guids are not reachable from either surface.
  • It is not a server-side workspace. Your draft lives in your browser and, when you publish, in your GitHub repository. Model and texture files are never stored on DiceyTable servers.

Concepts

The Interface

The Topbar and Menu Bar

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.

29 min

The Screenshots Gallery

The gallery of Preview photo-mode captures stored under screenshots/ — download, delete, promote one to the store page or cover, or retake it.

3 min

The Transform Rail

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.

7 min

Opening Projects

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.

6 min

The Hierarchy Panel

Edit Mode's authoring tree — filter and tag pills, folders and seat folders, Seat Template and Snap Points rows, eye and lock, context menus.

18 min

The Versions Panel

Restore points in Edit Mode — the draft label, the optional note, how a version is numbered and captured, and exactly what Restore overwrites.

3 min

The Viewport

The stage and its toolbar — World and Local, Frozen and Live, script play controls, the camera, room-geometry and render-layer view controls.

15 min

The Inspector Panel

Where the Inspector sits in Edit Mode, how it tracks selection across the Hierarchy, viewport and asset explorer, and its own resize handle.

3 min

The Asset Explorer

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.

29 min

The Script Console

The collapsible strip under the viewport that shows log, broadcast, diagnostic and system output while a scene's table scripts run inside Edit Mode.

2 min

The Status Bar

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.

9 min

Preferences and Display Units

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.

4 min

Inspector Sections

The Inspector

How the Inspector is organized — Engine components vs Platform panels, the ENTITY header, and which page documents each selectable node kind.

4 min

ENTITY

The entity header on every object selection: enabled state, the two names, parent, tags and transform. Disabling it disables every component too.

3 min

PIECE

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.

5 min

RENDER

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.

1 min

RIGIDBODY

The RIGIDBODY engine component — body type, mass, friction, restitution, damping, weld, and why Static is what keeps a triangle-mesh collider.

3 min

COLLISION

The COLLISION engine component — shape, the custom-model box collider editor, the three mesh-collider refusals, and the collisionEnabled checkbox.

7 min

LIGHT

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.

5 min

CAMERA

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.

2 min

SCRIPT

The SCRIPT engine component — attaching a Table Script to one object, distinct from a scene script attached to the whole table.

2 min

Material and Texture Fields

Every field in the 15-section material inspector, the Advanced toggle, and the texture inspector's info block, Sampling, Compression and WebP panels.

4 min

Platform Panels

Field reference for every Inspector section that is a DiceyTable classification, not an engine component: dice, sound, room, walls, lights, seats and zones.

43 min

Add Component

The + ADD COMPONENT flow — the addable light and camera set, kebab menus, enable checkboxes — and the component rail's scroll-spy and filter.

5 min

Entity (Advanced)

The read-only ENTITY (ADVANCED) section — live guid, path and real engine components behind a Scene Entity, unreachable from any script or mod.

3 min

Working in the Editor

Finding and Selecting Entities

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.

4 min

Multi-select

Selecting several entities from the Hierarchy or viewport box-select, one gizmo for the whole selection, SELECTION panel bulk actions and group scale modes.

9 min

Parenting

How object-to-object parenting works — the kinematic-child rule, grab escalation, the grabbableWhileParented opt-out, and the depth-8 cycle guard.

7 min

Welding

Weld children turns a parented assembly into one compound rigidbody — what it changes physically, when it is rejected, and how it differs from parenting.

5 min

Tags and Groups

Authoring tags, the unauthorable dt: platform namespace, why it still shows up in read results, and the one case-sensitivity quirk worth knowing about.

4 min

Moving, Rotating and Scaling Entities

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.

7 min

Importing and Optimizing Models

Accepted formats and the in-browser conversion pipeline, Draco, the stats panel, giving a model a collider, and optimizing without losing the original.

9 min

Assigning and Editing Materials

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.

8 min

Working with Textures

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.

3 min

Working with Decks

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.

3 min

Attaching and Running Scripts

Object scripts vs global scripts, the kind-specific starter each gets, and how Play Scripts runs them live inside the editor.

4 min

Player Zones, Seats and Seat Templates

Seat templates (linked, layout-detached, mirrored seats), seat-local +Z, seat dice and pieces, zone types and options, table zones, seat variables.

42 min

Working with Room and Lighting

Floor, ceiling and wall surfaces, posters, openings, ambient/fog/skybox settings, the three room light types and ambient sound emitters, field by field.

21 min

Item Editors

Model Editor

The model tree, the COLLISION, TRIGGER VOLUME and CONTAINER INTERIOR panels, viewport toggles, Edit in viewport, Re-apply, and the four save-bar states.

36 min

Prefab Editor

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.

6 min

Die Editor

Design a custom die: shape and edge rounding, materials like resin or granite, a model sealed inside, and per-face art and values.

9 min

Texture Editor

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.

4 min

Audio Editor

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.

5 min

Material Editor

A live interactive sphere preview next to the 15-section material inspector, with admin-only global publishing for built-in materials.

3 min

Deck Editor

Build a custom deck from card images: resolution presets, card art (fit, bleed, corner rounding), copies, data models, the back picker, sheet generation.

15 min

Card Data Editor

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.

7 min

Card Layouts Editor

Map regions onto a card face, bind them to card fields or live counters, and control exactly what an opponent is allowed to see.

12 min

UI Layout Editor

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.

13 min

Script Editor

The Monaco script editor - API autocomplete, suggestions for tags and names your project really uses, snippets, drag-to-reference and transpile on save.

6 min

Plain File Editor

A text editor for any repo-relative project file — TypeScript, JSON, Markdown, CSS and more — reading and writing bytes straight through the draft filesystem.

2 min

Manifest: the Bots Tab

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.

4 min

The Training Page

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.

6 min

Workflows

Workflow: Starting a New Mod

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.

6 min

Workflow: Importing a Model

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.

3 min

Workflow: Making a Board from an Image

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.

5 min

Workflow: Building a Deck

The numbered click-path for creating a deck asset, uploading card images, generating its sheet, and placing it on the table.

3 min

Workflow: Lighting a Scene

The numbered click-path for adding room lights, checking their effect with Live physics, and setting ambient, fog, and skybox for the whole room.

1 min

Assigning a Room or Table

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.

22 min

Workflow: Making a Variant of Your Game

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.

8 min

Building an Asset Pack

How to author prefabs, decks, materials, textures and scripts as a publishable Asset pack, and what its published document will and will not carry.

4 min

Importing an Asset Pack

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.

7 min

Lifting Content Out of a Pack

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.

4 min

Scene Check

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.

3 min

Deck and Bag Search

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.

4 min

Verifying as a New Player

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.

3 min

Previewing a Draft and Photo Mode

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.

13 min

Workflow: Saving, Versioning and Restoring

The numbered click-path for the draft save, named restore points, and how restoring a version overwrites your current draft after a confirmation.

2 min

Workflow: Exporting a Project Snapshot

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.

1 min

Workflow: Opening a Mod on Another Device

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.

2 min

Workflow: Where My Files Live

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.

5 min

More pages