TableForge User Guide

Your tabletop RPG command center

This guide is for new Game Masters and players. It covers setup, hosting, and how to use each major tool well—without needing every tool every session.

In the GM desktop app, open Help on the home page for a short interactive version of these topics.

Table of contents

  1. What TableForge is
  2. Starting the app
  3. Roles at a glance
  4. For Game Masters — getting started
  5. How tools and tabs work
  6. Core library tools
  7. Campaign prep tools
  8. During-play tools
  9. Campaign Maps in depth
  10. Hosting players
  11. Table Chat
  12. For players (desktop)
  13. For players (mobile)
  14. A recommended first-session path
  15. Tips for a smooth session
  16. Import and export
  17. Troubleshooting
  18. Related documents

1. What TableForge is

TableForge is a local-first toolkit for running tabletop sessions:

TableForge commercial builds are LAN-only (no built-in internet relay).

Content: Built-in rules text and monsters come from the SRD (5.1 / 5.2). You can add homebrew entries; those are your content. Legal notices are on this site’s Legal page, and under Legal on the GM home page.

You do not need every tool every night. Open what the scene requires; leave the rest closed.

Most content is scoped to an active campaign. Switch campaigns on the GM home page before creating sheets, maps, notes, or other library content for a different game.

2. Starting the app

Install

Download TableForge from this site, run the installer, and open it from the Start menu.

If you have a key, enter it when the app asks. The key unlocks the full tools on that PC.

3. Roles at a glance

RoleWhere you workMain jobs
Game MasterDesktop app (GM session)Campaigns, prep, combat, maps, hosting
Player (desktop)Same app, player sign-inSheets, travel, battle, maps, notes
Player (mobile)Phone browser via LAN QR/addressSame player tools, touch-first layout

Players never see the full GM home columns—only player-safe tools.

4. For Game Masters — getting started

First launch checklist

  1. Sign in as GM (PIN).
  2. Create or select an Active Campaign.
  3. Create player profiles with PINs for each player.
  4. Build library content as needed (sheets, maps, notes, World Forge entries).
  5. When players should connect, start the LAN host from the bottom bar and share the QR code or address.

Campaigns

Rules & Settings

Each campaign has a rules profile: 2014, 2024, or Custom.

Backup: Active Campaign menu → Export campaign… / Import campaign… (includes rules profile). Details: .

Multiclassing: When Multiclassing allowed is on in Rules, the level-up wizard adds a Class step so you can raise an existing class or start a new one at 1st level. Combined spell slots follow the standard multiclass table when you have multiple casting classes.

Player profiles

Typical session flow

  1. Before play — Review Codex or Session Planner; optionally cue Sound Forge.
  2. Host — Start the LAN host. Confirm players signed in and selected a character.
  3. At the table — Session Table for calendar, weather, quests, and live notes.
  4. Characters — Player Sheets for HP, inventory, and conditions.
  5. Combat — Battle Table; import PCs and monsters as needed.
  6. Exploration — Share a Live map, or assign Owned maps to online characters.
  7. Rewards — Loot Chest or Party Chest to generate and grant treasure.

5. How tools and tabs work

Practical habit: keep Session Table + Player Sheets open for most nights; open Battle Table, Maps, or Loot only when those moments arrive.

6. Core library tools

These hold lasting campaign pieces: characters, party stash, travel, and rules reference.

Player Sheets

Use it for: full PC and NPC sheets—roster, character builder, combat action board, inventory, spells, rests, and sync with Battle Table and vehicles.

Create your first character

  1. Open Player Sheets.
  2. Click + New Character and walk the Character Builder (Identity → Ancestry → Class & Background → Starting Equipment → Ability Scores → Name & Review).
  3. Open the finished sheet and, if needed, assign the campaign in Settings.
  4. Or use Import on the roster for a JSON character or pack.

Main areas

Prep vs play

PrepDuring play
Build or import characters and NPCsTrack HP, temp HP, death saves, exhaustion
Assign ownership to player profilesShort/long rest; Action Board attacks and casts
Level-up, spell prep, inventory setupWatch client Viewing status; Unlock Editing when you need to edit a player-owned sheet

Highlights for new users

Key terms: Roster, GM PC, Client sheet, Builder, Dashboard, Action Board, Attunement, Unlock Editing

Party Chest

Use it for: a shared party stash—coins and gear the whole table can see. The GM adds loot here; players claim items onto their sheets when connected.

Get started

  1. Open Party Chest (Core section).
  2. Confirm the campaign label matches your active game.
  3. Use Edit coins to set the party purse (pp/gp/ep/sp/cp).
  4. + Add item to pull from the Compendium catalog or add custom gear.
  5. During play, assign items or coin splits to connected characters.

Main areas

Prep vs play

PrepDuring play
Seed starting party funds or a shared cacheAdd post-combat loot from Loot Chest or manual entry
Stage items before revealing themPlayers claim to their active character sheet

Highlights for new users

Key terms: Claim, Party purse, Assign, Weight summary

Vehicles & Mounts

Use it for: wagons, ships, and other vehicles, plus rideable mounts—crew or draft teams, cargo zones, travel speed, malfunctions, and who is aboard.

Create your first sheet

  1. Open Vehicles & Mounts.
  2. Click + Vehicle and pick a type, or + Mount for a blank mount.
  3. Or use From compendium to import an SRD/homebrew vehicle or mount template.
  4. Or Import a JSON vehicle/mount pack.

Main areas

Prep vs play

PrepDuring play
Create sheets; assign Access to charactersBoard/unboard characters; move cargo to/from player sheets
Set draft team, driver, passengers, or rider/ownerTrack load vs pull capacity and travel speed
Configure cargo zonesRoll malfunctions when a vehicle’s hull is badly damaged

Highlights for new users

Key terms: Draft team, Pull capacity, Cargo zone, Pin locker, Access, On board, Malfunction

Compendium

Use it for: searchable SRD 5e content plus your homebrew—races, classes, items, spells, feats, vehicles, and more. Other tools pull from it (builder, loot, sheets).

Get started

  1. Open Compendium — SRD content loads automatically.
  2. Browse Home or pick a category chip (Races, Classes, Items, Spells, and so on).
  3. Use + New to create a homebrew entry.

Main areas

Prep vs play

PrepDuring play
Create homebrew; duplicate SRD → customQuick rules and spell lookup
Import/export homebrew JSONFeed builder, loot catalog, and sheet equipment picks

Highlights for new users

Key terms: Homebrew (HB), SRD, Duplicate as Custom, Source filter, Entry kind

7. Campaign prep tools

Use these between sessions or while planning tonight’s adventure.

Campaign Codex

Use it for: a per-campaign vault of Markdown notes—lore, session logs, NPC write-ups, and shared handouts. Supports folders, multi-pane editing, optional vault sync, and player sharing.

Create your first note

  1. Open Campaign Codex.
  2. Select the Campaign in the Codex header (Codex has its own campaign selector—keep it aligned with your active game).
  3. Use + New → New file, New folder, or New subfolder.
  4. Or Import Markdown / Import Vault Folder for bulk import.

Optional: Link Vault… to sync with an external Obsidian-style folder (auto-sync about every 15 seconds).

Main areas

Cross-links in notes

Prep vs play

PrepDuring play
Write lore and handouts; share with playersOpen reference notes during scenes
Insert monster blocks; link an external vaultSync Now if vault-linked; skim player session notes
Link notes with [[wikilinks]]; check Linked fromView on timeline jumps to Chronicle

Highlights for new users

Key terms: Vault, Pane, Share audience, Link Vault, Player session notes, Tags, Wikilink, Linked from, Story so far

Campaign Chronicle

Use it for: a zoomable canvas timeline plus page-turn history reader — the story-so-far in short entries. Codex holds long write-ups; Chronicle is the dated sequence of what happened.

Create your first entry

  1. Open Campaign Chronicle (Prep section, next to Codex).
  2. Select the Campaign in the header.
  3. Click + Entry, or open World Updates to accept a suggestion from a completed session, ended combat, quest progress on the Session Table, or a Codex append proposal.

Main areas

Writing entries

Sharing with players

Prep vs play

PrepDuring play
Write entries after sessions; link Codex session logsSkim the timeline or Campaign Journal for “where we left off”
Accept or split World Updates; summarize long draftsPlayers read shared entries on their own Chronicle
Manage eras; open Campaign links to trace referencesJump to Session Planner or Codex from link chips

Key terms: Canvas timeline, Event list, Minimap, World Updates, Page turn, Era, Codex link, World date, Table date, Wikilink, Campaign links, Summarize, Split

Session Planner

Use it for: laying out tonight’s session on a board—scenes, NPCs, encounters, clues—and optionally building a combat roster that starts on Battle Table.

Create your first session

  1. Open Session Planner.
  2. Click + Create Session (title, campaign, folder, Prep style).
  3. The board opens with columns based on your prep style (Kanban default: Intro → Exploration → Roleplay → Combat → Finale).

Main areas

Arcs

Prep styles: Prep Sheet (story-arc slots), Kanban, Beat sheet, Agenda + annex, Flowchart (branching nodes).

Card types: Scene, NPC, Location, Encounter, Clue, Music, Loot, Note.

Cross-links

Prep vs play

PrepDuring play
Build the board; drag assets from the explorerSet status Active; move cards; mark In play / Done
Fill Overview / Prep Sheet slotsCombat tab → Start on Battle Table
Save encounter templatesDuplicate a finished session from the overflow menu

Highlights for new users

Key terms: Prep style, Board, Column, Card, Inspector, Asset Explorer, Encounter template, In play, Arc, Wikilink

World Forge

Use it for: quick, editable generators for NPCs, Locations, Shops, Taverns, Travel encounters, and Rumors/quests. Everything saves into a mode-specific campaign library.

Create your first entry

  1. Open World Forge.
  2. Pick a mode tab (NPCs, Locations, Shops, Taverns, Travel, Rumors).
  3. Confirm Campaign, set generator options in the left dock.
  4. Click Generate (or Start fresh), edit freely, then Save.

Main areas

Prep vs play

PrepDuring play
Stock shops, taverns, travel days, rumor hooksOpen a saved NPC, encounter, or rumor mid-scene
Create player sheet from an NPCRe-roll individual fields; feed Session Planner / Combat From World Forge

Highlights for new users

Key terms: Generator, Library, Generated, Travel encounters, Rumor kind, Create player sheet

Random Tables

Use it for: simple campaign tables you can roll at the table—encounters, weather flavor, rumors, whimsy.

Create your first table

  1. Open Random Tables.
  2. Click + Table, or Load samples for starter tables.
  3. Name the table, pick a die (d6–d100), enter one entry per line, Save.

Main areas: left table list; right editor with name, die, Roll, entries, Save/Delete.

Highlights for new users

Key terms: Die, Entries, Roll result

TableForge connects prep tools with wikilinks and a shared link index.

Syntax

Where links appear

SurfaceGMPlayer
Codex previewClickable chipsShared notes only (read-only Codex)
Chronicle page readerSummary + margin chipsSummary chips to shared Codex only
Session Planner inspectorChips in the card preview—
Map pin notesInspector preview—

Campaign links graph

Backlinks

Key terms: Wikilink, Chip, Campaign links, Backlinks, Linked from

Campaign Maps (summary)

Use it for: uploading or creating maps; pinning routes, areas, and notes; sharing a Live table map; assigning Owned maps to characters.

Full detail is in §9 Campaign Maps in depth.

8. During-play tools

Reach for these while the table is live.

Session Table

Use it for: a live GM dashboard—an infinite canvas of widgets for calendar/clock, weather, notes, checklists, quests, random tables, and a pinned Session Planner session. Also drives scene cues and optional Sound Forge auto-match.

Get started

  1. Open Session Table (campaign context appears in the header).
  2. Use + Widget to add Calendar & Clock, Weather, Note, Checklist, Quest Progress, Plot board, Sticky Note, Random Table, Session Planner, or House rules.
  3. Use + beside the canvas selector to create extra canvases (for example one per major location).

Main areas

Prep vs play

PrepDuring play
Customize calendar (era, months, dawn/dusk, seasons)Advance world clock and weather
Build checklists, quests, notes; pin planner/tablesUse Scene to broadcast RP ideas; Auto sound to match a Sound Forge board by name
Duplicate canvases per locationJump to Battle Table or pin a World Forge encounter/rumor from the menu

Highlights for new users

Key terms: Canvas, Widget, Scene mode, World clock, Auto sound, Presence strip

Battle Table (Command Desk)

Use it for: live combat—initiative order, the active combatant inspector, combat log, player turn sync, and world-clock advance.

Start a fight

  1. Open Battle Table, or use Session Planner Start on Battle Table.
  2. Import combatants: From Player Sheets, NPC Sheets, Bestiary, or Session Planner.
  3. Collect initiative (manual or from sheet bonuses).
  4. Run turns with Pass Turn; use the inspector for HP, conditions, and actions.
  5. End Combat for review, or New Combat to clear the field.

Prep vs play

PrepDuring play
Import roster; use Session Planner encounter templatesPass / previous turn; combat actions; collect late joiners
—Watch player reactions; advance world clock with rounds

Highlights for new users

Key terms: Command Desk, Initiative rail, Pass Turn, Collect, Combatant, Battle Log, End Combat

Bestiary

Use it for: searchable creature stat blocks (SRD + homebrew) for prep and for importing into Battle Table, Session Planner, or Codex.

Get started

  1. Open Bestiary — SRD creatures load automatically.
  2. Browse/filter, or click + New Monster for homebrew.
  3. Use Duplicate as Custom on an SRD creature when you want a variant without editing the original.

Highlights for new users

Key terms: Creature, CR, Stat block, Homebrew, Duplicate as Custom

Loot Chest

Use it for: generating treasure—quick tiers or DMG-style hoard/individual tables by CR—with coins, gems, art, gear, and magic items from the compendium catalog.

Roll treasure

  1. Open Loot Chest.
  2. Choose Quick or DMG mode.
  3. Set tier (Quick) or hoard/individual + CR (DMG), optionally No dupes, then Roll.
  4. Review the results vault; Copy to clipboard or Roll again as needed.
  5. During play, right-click an item → Send to player for connected sheets—or add bulk loot to Party Chest for the table to split.

Highlights for new users

Key terms: Quick tier, DMG Hoard, Individual, CR, No dupes, Budget cap, Grant loot

Sound Forge

Use it for: campaign audio—upload music and SFX, organize folders, and build session boards with a playlist plus an SFX trigger grid.

Build a board

  1. Open Sound Forge.
  2. + Board to create a session board; select it in the header dropdown.
  3. + Upload into the Music or SFX libraries; drag tracks onto Playlist or SFX Board.
  4. Use the transport bar (play/pause/next/loop/volume) during scenes.

Prep vs play

PrepDuring play
Upload ambience and stingers; name boards per scenePlay music; click SFX tiles; Stop SFX to kill effects
Match board names to Session Table scenesLet Session Table Auto sound pick a board by name

Highlights for new users

Key terms: Board, Playlist, SFX Board, Transport, Library, Now Playing

Quick Reference

Use it for: a searchable rules cheatsheet—built-in 5e summaries (actions, conditions, movement, and more) plus your own house-rule topics in folders.

Get started

  1. Open Quick Reference — default topics load automatically.
  2. Search mid-session, or + New → New reference / New folder for table conventions.
  3. Use Edit to change title, folder, tags, and body.

Highlights for new users

Key terms: Topic, Folder, Reference, Tags, Read-only mode

9. Campaign Maps in depth

Maps are campaign-scoped. Players see two modes:

ModeWho sees itPurpose
LiveAny connected playerOne shared table map (marked Shared / Share live by the GM)
OwnedOnly characters on the Owners listPersonal maps, per character—not per player account

Create and mark a map

  1. Set the correct Active Campaign on the home page.
  2. Open Campaign Maps.
  3. + Upload (PNG/JPEG/WebP/GIF) or + Blank for an empty exploration map.
  4. Select the map in the library; use the toolbar: Pan, Pin, Pathway, Area, Label, Measure.
  5. Double-click a pin, path, label, or the party token to select it. Drag a selected item to move it; use the toolbar to swap a pin’s icon or a path’s line style. Details stay in the inspector.
  6. Set Scale (miles across map width) in map settings when you want travel-time estimates.
  7. Organize with folders if useful.

Useful shortcuts: H pan, P pin, L path, A area, G fog reveal, T label, M measure.

Fog of war (live map)

  1. In Map settings, enable Hide map from players until revealed.
  2. Select the Fog reveal tool (G); click corners of a polygon, double-click to finish. Repeat for each visible area.
  3. On a Shared / live map, players on LAN mobile maps only see revealed polygons; the GM sees dimmed unrevealed areas.

Pathways and Codex

Measure and travel time

  1. Select the Measure tool (M).
  2. Choose a mode:

- Straight — drag A→B. - Draw route — drag freehand like the path pen, or click an existing path to measure it.

  1. When scale is set, the HUD shows miles plus estimated walk / ride / wagon days (or sail when ending on a sea pin).
  2. Terrain along the route adjusts day estimates (roads faster, mountains slower).

Pins, nested maps, and party position

Share live and lock edits

  1. Enable Share live so the map appears under players’ Live tab.
  2. Optionally Lock edits so players can view but not move marks.
  3. Player marks are tracked as player-owned overlays—use the GM layer filter (All / GM / character) to focus.
  4. Breadcrumb navigation appears when you drill into linked child maps.

Owned maps

  1. Open Owners on a map.
  2. Assign online characters in that campaign (player connected + character selected).
  3. Already-assigned characters stay listed when offline so you can uncheck them.
  4. Two characters on the same player profile do not share Owned maps.

Players may organize Owned maps into private folders on their client. Those folders are per character and are not shared with other characters.

Key terms: Share live, Lock edits, Owners, Overlay, Pathway, Layer filter, Player-owned mark, Scale, Measure, Linked map, Layer entry, Party sync, Breadcrumb, Terrain

10. Hosting players

Same network (LAN)

  1. Start the LAN host from the status / bottom bar.
  2. Share the QR code or URL with players on the same Wi‑Fi.
  3. Players sign in with their profile PIN.
  4. Players choose an active character.

Network tips

Remote players

This TableForge build does not include cloud internet relay. Everyone who joins live must reach the GM PC on the same LAN (typical home Wi‑Fi). Options if players are not in the room:

Quick reference: .

11. Table Chat

While the LAN host is running:

Use chat for table logistics and private notes—not as a replacement for voice at the table.

12. For players (desktop)

  1. Open TableForge and sign in as a player with your profile PIN (or connect to the GM host when prompted).
  2. Select your active character.
  3. Use the player tools available in player mode:
ToolNotes
Player SheetsYour characters (attacks/casts go to Battle when combat is live)
Party ChestView shared party coins and gear; claim items to your active character
Vehicles & MountsTravel sheets you have Access to
Battle TableFollow live combat; Plan Turn / End Turn when imported
Campaign MapLive + Owned for the active character; drill-down when the GM allows
Campaign ChronicleShared timeline entries and story-so-far (read-only)
Session NotesPrivate notes; shared Codex handouts appear read-only when shared
Compendium / Quick RefRules lookup (often read-only against the host library)
  1. Keep an active character selected during play so the GM can assign maps and see you as viewing.

Changing the active character changes your Owned map list and how you appear to the GM.

13. For players (mobile)

  1. Join the GM’s session (scan QR or enter the LAN address).
  2. Sign in with your profile PIN.
  3. Choose an active character on Home / Sheets.
  4. Use the bottom navigation:
TabScreen
HomeSession hub
SheetsCharacter sheet and builder
TravelVehicles and mounts
BattleLive battle view
MapLive and Owned maps
ChestShared party coins and gear
ChronicleShared campaign timeline (when the GM shares entries)
NotesSession notes
CodexCompendium (read-only)
RefQuick reference (read-only)

The bar scrolls sideways when every tab does not fit. Party Chest and Chronicle are also on the Home grid.

Mobile tips

If you are brand new, this order builds confidence without opening everything at once:

  1. Home: create Active Campaign + player profiles; start LAN host when players arrive.
  2. Compendium: skim once so you know SRD content is there.
  3. Player Sheets: build or import the party; assign ownership.
  4. Campaign Codex: one folder for tonight’s lore or handouts.
  5. Session Planner: one session board for the evening’s beats. Use Spine on the planner home screen to see chapters and the beat list.
  6. World Forge (optional): generate a shop, tavern, or NPC you expect to need.
  7. At the table: Session Table + Sound Forge for atmosphere.
  8. When combat starts: Battle Table (import PCs + monsters).
  9. After the fight: Loot Chest → grant to sheets or Party Chest for shared loot.
  10. Exploration: Campaign Maps Share live, or Owned handouts as needed.
  11. After the session: accept World Updates in Campaign Chronicle (or write an entry manually).

Add Vehicles & Mounts, Random Tables, Party Chest, and deeper Codex/Chronicle vaults once the basic loop feels comfortable.

15. Tips for a smooth session

16. Import and export

AreaWhat you can move
Player SheetsSingle sheets or packs (import/export from the title bar)
Party ChestStored in the campaign database; syncs live when hosting
Vehicles & MountsVehicles, mounts, and packs; also From compendium templates
CompendiumPer-category JSON export; import single entries or packs
Campaign CodexMarkdown — single note or full vault; optional linked vault folder
Campaign ChronicleEvent timeline entries, eras, and inbox state in the campaign database
Session PlannerExport board JSON from the session overflow menu
Loot ChestCopy results to clipboard; grant items to connected player sheets
World Forge / Random Tables / Session Table / Sound Forge / MapsGenerally stored in the campaign database (maps upload images; Sound Forge uploads audio)

After import, confirm the active campaign still matches where you intended the content to land.

17. Troubleshooting

ProblemWhat to try
Player not online / not viewingConfirm LAN host is running, same network, signed in, and an active character is selected. On mobile, open Sheets or Map once.
Cannot assign map ownerOwners lists online characters for the campaign (plus existing assignees). Have the player select a character, wait a few seconds, reselect the map.
Owned map missingOwnership is per character. Switching characters shows a different list. Check campaign scope.
Cannot join LANRestart host, re-share QR/address, allow the app through the firewall, avoid guest Wi‑Fi isolation.
Remote friend cannot join from another cityThis build is LAN-only; use a shared VPN or play with local devices on the GM Wi‑Fi.
Wrong campaign dataSet Active Campaign on the GM home page before creating content. (In Codex, also check the Codex campaign selector.)
Live map not visibleConfirm the map is marked Share live / Shared and the host is running.
Edits locked on a mapThe GM may have locked player editing; viewing still works.
Cannot edit a player’s sheetUse Unlock Editing on that client-owned sheet, or ask the player to make the change.
Vehicle missing for a playerCheck Access on the vehicle/mount sheet.
World Forge entry “vanished”Confirm you clicked Save, and that you are in the same mode tab and campaign.
Auto sound did nothingName the Sound Forge board similarly to the Session Table scene; ensure audio is on a board playlist/SFX grid.
App feels slow after opening many toolsClose unused tabs; keep only what the current scene needs.
Player character wizard uses wrong edition (2014 vs 2024)On the GM machine, select a specific campaign (not All campaigns) with the rules you want. The player home GM campaign chip should show the campaign name and rules (e.g. 2014 rules). Restart TableForge on the host and reconnect players after an update. New characters follow the GM campaign; characters already finished keep the rules they were built with. If the GM has not picked a campaign yet, the player wizard offers Create with 2014 rules / Create with 2024 rules on the first step.
Player does not see which campaign the GM selectedConnect to the LAN host and open the player home screen. The campaign chip is read-only and should update within a couple of seconds when the GM switches campaigns.
Shared player note not showing (or showing for everyone)Open Session Notes, use Share with players… on your note, and check only the players who should read it. Everyone must use the same campaign and stay connected to the host. Edits sync within a few seconds. GM handouts are separate (marked GM).
SRD warning on every pageThe short footer is meant to appear once per install ( Got it on the first tool page or GM home banner). After that, open Legal on the GM home for the full CC BY attribution anytime.

18. If you need a hand

Write to tableforgeapp@gmail.com.

The in-app Help panel on the GM home page covers the same topics in a shorter form.