Gravewright v2.1.0-alpha

Gravewright

An open-source virtual tabletop for tabletop RPGs, built for performance, extensibility, and control.

Self-hostable. Server-authoritative. SDK-driven. Package-ready.

Core Platform ↗ Gravewright-5e-srd ↗ Releases ↗ Documentation ↗ Issues ↗

What is Gravewright?

Gravewright is an open-source virtual tabletop platform for tabletop RPGs.

It is designed for groups, game masters, ruleset creators, package authors, and developers who want a VTT that is fast, extensible, self-hostable, and transparent by design.

Performance

Performance for large maps and realtime collaboration.

Extensibility

Extensibility through the Gravewright SDK and declarative packages.

Control

Control over hosting, data, rules, permissions, and gameplay experience.

Open development

Open development with clear architecture, public documentation, and permissive API materials.

Warning

Gravewright v2.1.0-alpha is an Alpha release.

Use it for testing, experiments, one-shots, and short Alpha arcs.

It is not recommended for long-running campaigns yet. Database schemas, storage layout, SDK package contracts, realtime events, and public APIs may change between Alpha releases.

There is no guaranteed upgrade path between Alpha releases. Back up before updating.

Install Guide and Demo

New to Gravewright? Start with the install guide and demo video.

Open the Gravewright install guide and demo ↗ Download the latest release ↗

Try Gravewright

Gravewright is currently distributed as v2.1.0-alpha for local testing and experimentation.

There is no stable desktop installer yet. The recommended way to try Gravewright is to download a GitHub release or clone the repository and run it locally.

Requirements Python 3.11 or newer uv

Quick local setup

git clone https://github.com/Gravewright/gravewright.git
cd gravewright
cp .env.example .env
uv sync
chmod +x grave
./grave doctor
./grave run --open

Then open: http://127.0.0.1:8000

On Windows PowerShell:

Fallback command:

uv run python -m app.cli doctor
uv run python -m app.cli run --open

Windows PowerShell

git clone https://github.com/Gravewright/gravewright.git
cd gravewright
Copy-Item .env.example .env
uv sync
.\grave.bat doctor
.\grave.bat run --open

Fallback: uv run python -m app.cli run --open

Grave CLI

Gravewright includes a local operator CLI called `grave`.

Common commands

grave doctor
grave run --open
grave backup -o backup.zip --include-assets --verify
grave restore backup.zip --dry-run
grave package list
grave package validate data/packages/rulesets/my-rpg
grave package install my-rpg --yes --enable
grave campaign package activate <campaign_id> my-addon
grave ruleset new my-rpg --name "My RPG" --sheets --rolls --combat --content
grave addon new my-addon --name "My Addon" --js --settings
grave lock -o grave.lock.json

CLI documentation ↗

For Players and Game Masters

Gravewright aims to provide a virtual tabletop that can be hosted and controlled by your own group, without depending on a closed platform.

campaigns
maps and scenes
fog, tokens, measurements, pings, and markers
actors and items
sheets
journals and quests
chat and dice rolls
combat
permissions
realtime collaboration

For Ruleset Creators

Rulesets are Gravewright SDK packages that define the base game system for a campaign.

actor types
item types
schemas
declarative sheets
derived rules
dice and roll behavior
combat configuration
starter content packs

Gravewright SDK ↗

For Addon and Package Developers

Supported package kinds:

Addon packages can add optional behavior, UI, plugins, settings, scene tools, overlays, content, themes, and browser runtime behavior through documented SDK capabilities.

SDK documentation ↗

For Contributors

Gravewright is early and actively evolving.

Good contribution areas include:

documentation
test coverage
UI/UX polish
accessibility
performance testing
SDK package examples
ruleset examples
addon examples
browser runtime feedback
backup/restore feedback
bug reports from one-shot testing

Contributing guide ↗ Architecture ↗ Testing ↗ Security ↗ SDK documentation ↗

Project Status

Gravewright is currently v2.1.0-alpha.

Core gameplay, realtime transport, maps, actors, items, journals, permissions, SDK packages, package tooling, diagnostics, and public APIs are available for Alpha testing and are still evolving.

Breaking changes may happen between Alpha releases.

Do not trust Alpha releases with irreplaceable campaign data.

Language

The primary project documentation is written in English.

Brazilian Portuguese documentation is also available under:

docs/pt-br/ ↗

Build the table. Control the rules. Own the experience.

Core Platform