Understand the platform. Build your own tools.

Learn to build modules and systems

Choose what you want to build and follow it from the first file to a working tabletop feature.

Create, install and update your first module

From an empty folder to a table button, with complete files, installation, activation and a second version.

All extension capabilities and where to implement them

An explicit method-by-method map to projects, local helpers, surfaces, server integrations and release limits.

How to create a complete original system package

One installable ZIP with working actor/token sheets, item types, stored initiative and three original compendium packs.

How to create a journal module

Build, install and run a normal module that creates private journals and appends saved GM session drafts.

Create a journal from a module, from scratch

Use the public create operation from a table.interface form and open the resulting private document.

How to create a module that acts on a sheet

Start with an empty folder and ship a working rename action on existing actor and token sheets.

How to build and replace a complete system sheet

Use the working Example Expedition package, install it, create actors and verify linked and independent tokens.

How to create a compendium module

Build the complete package from an empty directory, install it and verify its original content.

How to include compendiums in a system

Build the complete package from an empty directory, install it and verify its original content.

How to create a scene tools module

Build a working module to inspect scene layers, edit metadata, manage folders, draw a native door and broadcast a test scene.

How to create a token tools module

Place, move, duplicate, configure and remove tokens; control native vision/visibility and timed conditions.

How to create a combat tools module

Build a working encounter laboratory covering participants, initiative, order, flags, turns, rounds and cleanup.

How to build item and inventory tools

Create, organize, duplicate, share and edit original items with native revisions and permissions.

How to build deck and card tools

Create reusable deck definitions, draw, reveal, move, transfer and recover cards with real ownership.

How to build scene audio and soundtrack tools

Configure native tracks, playlists, spatial sources, scene voices and timed scores with the correct revisions.

How to build chat, dice and ready-check tools

Create a working module that sends messages, publishes rolls, moderates chat, searches documents and updates readiness.

How to create quest automation and quest-board actions

Create and read a real quest, advance objectives, assign actors and manage every board relationship.

How to create, draw and reset weighted roll tables

Build an original journal roll table, edit a weight without losing data and publish native draws with or without replacement.

How to create, organize and share journal documents

Build native rich diaries, preserve pages when editing, organize folder trees and control access and presentations.

Build an actor-directory module

Create, organize, rename and authorize actors using system-owned types.

Persist module settings safely

Implement personal, shared and browser-local JSON with revisions and cleanup.

Upload and use module and campaign files

Use File/Blob, actor images, card assets, native file providers and downloads.

Translate a module and react to changes

Read package files, format translated UI and subscribe without leaking listeners.

Maintain a module using the original host.call SDK

Concrete actor/token DTOs, opaque revisions and the remaining multipart/local operations.

Build Customize forms and native module windows

A complete personal settings form with migration, CAS, translations, modal lifecycle and preferences mounting.

Create a trusted Django integration and server hooks

Complete Python app with authenticated routes, native mutations and after-commit signals.

How to create and activate an installation language package

Package six original interface strings, install globally, choose a personal locale and verify English fallback.

How to version, sign and distribute a module

Prepare immutable ZIP releases, verify Ed25519 catalog records and understand installation, activation and revocation.

Examples by kind 29

Complete examples by kind

Choose a contract and jump to complete code, downloadable files, expected behavior and validation.

Browser module: a campaign summary

A complete package with a table action, authorized API read and native modal.

System package: an editable character sheet

A single original system package with actor types, a complete minimal sheet and revision-aware saving.

Language package: Portuguese and Spanish catalogs

A minimal installation-wide language package with valid catalogs, activation and English fallback.

Django package: an owner-only server endpoint

A trusted server app with a valid manifest, AppConfig, URL and permission-checked read view.

actor.directory: Readable actor counter

Count actors whose sheets the current member may open, and update after actor changes.

actor.sheet: Actor sheet revision inspector

Read the real actor sheet and display its name, sheet revision and top-level data keys beneath the native sheet.

token.sheet: Linked or independent token inspector

Read the token’s own sheet context, so an independent snapshot is never replaced by actor data.

item.directory: Item counts by type

Group readable items by their package-owned type, without assuming an RPG catalog.

item.sheet: Item data inspector

Show the actual item name, type, version and system-owned data as safe JSON below its native editor.

scene.directory: Scene broadcast status

Distinguish the scene broadcast to players from the scene the GM is navigating.

scene.controls: Scene information control

Add a working button that reads the mounted scene and opens its dimensions and grid in the native modal.

scene.overlay: Scene center marker

Mark the scene center and keep its position correct under pan and zoom without capturing pointer input.

chat.log: Visible chat statistics

Count only the messages returned by the authorized history and report their visible authors.

combat.tracker: Current turn summary

Show encounter activity, round and the current visible combatant, without implementing initiative rules.

journal.sheet: Journal outline

Show the journal title, type and only the section titles in its authorized projection.

preferences: Persistent personal density preference

Save a personal compact/comfortable preference with compare-and-swap revisions, and make a concurrent conflict visible.

table.interface: Authorized document search

Search table documents from a workspace panel and render their names, kinds and snippets as text.

Search: all 7 kinds and the empty filter

Eight concrete browser functions, quest versus journal categories, authorized recents and validation.

Actor images: portrait and token

Two complete File-picker mount functions using the actual multipart host.call operation.

Compendium entries: all five kinds

Capture actor, item, journal, scene and deck resources with authorized reads and GM imports.

Compendium packs: 3 installed and 7 local types

Complete original JSON for every pack type, exact manifest restrictions and downloadable fixtures.

Blueprint examples for every object kind

Choose a complete recipe for door, lever, torch or region, then inspect execution/data connections and all 44 node types.

Blueprint kind door: open, close and preserve a lock

A complete v2 door graph that opens a closed door, closes an open door and leaves a locked door unchanged.

Blueprint kind lever: a two-state switch and an Empty Object

A complete off/on toggle, with the same kind reused by an image-free private controller.

Blueprint kind torch: turn the mechanism and set the flame

A composed torch example with independent state and flame actions in both toggle branches.

Blueprint kind region: a pressure plate with first/last occupancy

Complete enter/exit graphs that open a referenced door on first arrival and close it on last departure.

Connection kinds: execution and data, a complete graph

Trace a lever graph that reads a state through typed data edges and runs actions through ordered execution edges.

All 44 Blueprint node types, with complete examples

Concrete configurations and downloadable validated graphs for every NODE_TYPES entry, from event to cooldown.

Project reference 19

Getting started

Installation, prerequisites, first launch and source checkout setup.

Architecture

Runtime boundaries, domain services, permissions and persistence.

Code map

Find the files and domain responsible for each application workflow.

Development

Development workflow, migrations, generated contracts and release preparation.

Public API reference

Python API, browser domain API, SDK operations, payloads and error contracts.

Systems and modules

Installable packages, system declarations, browser lifecycle, signing and SDK contracts.

Frontend architecture

Jinja2, Datastar, native JavaScript, PixiJS, styles and asset preparation.

Testing

Django, node:test, Playwright and native validation with disposable data.

Configuration

Installation-local configuration, execution profiles and environment settings.

Deployment

Hosting, security, reverse proxies, backups and operational recovery.

Windows installer and Runner

Native Windows preparation, portable tools, startup and recovery.

Linux installer and Runner

Native Linux preparation, portable tools, dependencies and platform limits.

macOS installer and Runner

Native macOS preparation, portable tools, startup and platform support.

Map Builder reference

Builder workflows, Smart Objects, automation, supported limits and developer contracts.

Universal VTT import and export

Import/export workflows, coordinates, limits and authorization.

Application workflow reference

Complete project guide to campaign preparation and tabletop tools.

Ethical module porting

Licenses, content rights and mapping an integration to the owning domains.

Contributing

Contribution conventions, licensing, review and validation requirements.