Quest-Net

August 5, 2026 · View on GitHub

Quest-Net is a real-time collaborative tabletop RPG manager for DMs and players. It brings campaign prep, live play, peer-to-peer sessions, 3D voxel maps, character sheets, combat tools, dice, images, scenes, audio, and world rules into one browser app.

At the table, the DM view keeps the 3D terrain, active actors, environment controls, calendar, rests, and stat cards visible in one workspace.

Quest-Net DM world view with a voxel terrain and session controls

Start A Campaign

Quest-Net opens with a focused launch screen for local prep, wiki access, settings, and campaign entry.

Quest-Net homepage with animated title

Campaigns can be created locally, imported from JSON, resumed from the campaign list, or joined by room code as a player.

Campaign creation form and campaign list

Run The Table

Movement range is visualized directly on the terrain, so the DM and players can reason about reachable spaces in context.

Movement highlight shown on a 3D terrain

Scene art can be displayed over the map during play while the active actor list and campaign clock stay available.

Scene artwork displayed over the active map

The map can also switch into first-person mode from a character's point of view for exploration, positioning, and table-facing reveals.

First-person character point of view on terrain

The dice roller supports TTRPG formulas and quick dice buttons, with the panel floating over the active session.

Dice roller with several dice and formula results

Build The World

The terrain editor supports high-resolution voxel maps, .vox imports, tile and voxel brush modes, actor overlays, material palettes, lighting presets, and preview tools.

Voxel terrain editor with cathedral terrain and palette

Campaign settings let the DM define stat pools, action economy, attributes, combat rules, rest rules, visibility, terrain presets, shared inventories, and world-rule scripts.

Campaign settings for stats, actions, and attributes

Manage The Campaign

Item templates can include art, descriptions, tags, folders, scripted behavior, and spawn controls for dropping objects into the live scene.

Item templates grid with images and spawn actions

Entity templates use the same campaign database patterns, making NPCs, enemies, hazards, and reusable encounter pieces easy to browse and spawn.

Entity templates grid with illustrated entities

Images live in a campaign image library and can be reused for characters, entities, scenes, focus art, maps, and item cards.

Campaign image library with upload drop zone and thumbnails

Tech Stack

App framework: React, TypeScript, React Router, and Vite
UI and styling: Tailwind CSS, DaisyUI, and Iconify
3D map: Three.js and postprocessing
Animation and panels: GSAP, Motion, and react-rnd
State and data utilities: Valtio, colorjs.io, fast-json-patch, and mathjs
Multiplayer: Trystero for peer-to-peer rooms and WebRTC signaling
Storage: localStorage for compact app state, plus IndexedDB and OPFS-backed payload storage for images and large voxel terrains

Quick Start

npm install
npm run dev

The dev server runs at http://localhost:3000/.

Useful Scripts

npm run dev       # Start the local Vite dev server
npm run build     # Type-check and build for production
npm run preview   # Preview the production build locally

Project Layout

src/
  components/     Reusable UI, map, dice, form, and input components
  domains/        Campaign, character, entity, terrain, combat, item, audio, and other feature domains
  services/       Action dispatch, sync, storage, image, terrain, audio, and scripting services
  hooks/          Peer tracking and UI hooks
  utils/          Dice, terrain, storage, migration, folder, math, and parsing utilities
  migrations/     Versioned context and campaign migrations
  wiki/           In-app documentation pages

Documentation

Quest-Net includes an in-app wiki covering campaign setup, networking, combat, terrains, scripting, data structures, and DM/player workflows. Development-specific notes live in src/DEVELOPMENT_NOTES.md.