ZapGM Player Guide — How to Join & Play

Getting Started as a Player

How do players join a ZapGM online D&D session?

Click the invite link your GM shares. It opens in any modern browser — Chrome is recommended. You'll be prompted to sign in or create a free ZapGM account, then you'll land directly in the live session. No app download or installation required. ZapGM works on desktop and laptop.

Do I need to create an account to play?

Yes — a free ZapGM account is required to join a live session. Sign-up takes a few seconds with email or Google. Player accounts use very little of the GM's AI usage allowance, so the free tier is fine for players in almost every case.

How do I change my display name during a session?

Find the "YOUR NAME" field in the Party sidebar. Update it and confirm — the change broadcasts to all connected players and the GM instantly.

Which browsers does ZapGM support?

ZapGM officially supports Google Chrome. Other Chromium-based browsers — including Microsoft Edge, Brave, and Opera — should also work. Chrome is strongly recommended for the best experience.

Broadcast Feed

What appears in the Broadcast Feed during a live session?

The Broadcast Feed is the main content area where the GM delivers story content:

How do I interact with items in the Broadcast Feed?

Click images to view them at full size. Expand lore cards to read the full details. Dice roll entries show the complete breakdown — individual die results, modifiers, and totals.

What happens when the battle map goes live?

When the GM activates the VTT battle map, it appears as a dedicated tab in your Player Canvas. You can pan and zoom the map independently, view all token positions and HP bars, see the initiative turn order, and use local drawing tools for personal reference.

Claiming Your Character

How do I claim my character in ZapGM?

In the Party sidebar, click on an unclaimed PC (Player Character) card to send a claim request to the GM. Your request goes to the GM's Claim Request Tray for approval.

What happens while my claim request is pending?

The character card shows an animated amber border with a "Pending" label while the GM reviews your request. Once they approve or deny it, the status updates immediately.

Can I claim more than one character?

Yes. Players can claim multiple PC cards — useful for companion characters, backup characters, or when you need to manage multiple roles in the party. Each claimed character appears in your Party tab.

What can I do with a claimed character?

Once claimed, you can edit the character sheet directly — update stats, add notes, change descriptions, upload artwork, and track your own HP on the battle map. All edits sync automatically back to the GM's campaign.

Can I see which characters other players have claimed?

Yes. The Party roster shows all claimed characters alongside each player's name. Unclaimed PCs are shown as available to request.

How do I speak as one of my characters in chat?

If you've claimed multiple PCs, use the character dropdown above the chat input to select which character is currently speaking. Chat messages will display that character's name.

Creating Characters & Summons

Can players create their own characters in ZapGM?

Yes. Click the "Create Character" button in the Party sidebar to build a new PC from scratch. Fill in your character's name, class, race, description, and backstory. Optionally use Flash Forge AI to generate character details from a brief concept description. Your new character is submitted to the GM's campaign for acceptance.

What is a Summon and how do I create one?

Summons are conjured creatures under your control — familiars, animated undead, elemental servants, or summoned allies. Choose "Summon" from the template dropdown when creating a character. Summons use a full stat block (HP, AC, attack bonuses, and special abilities) and appear alongside your PCs in the Party tab. The GM and AI narrator treat them as party members.

How does Flash Forge AI work for character creation?

Enter a brief concept description for your character and Flash Forge generates key details — personality traits, backstory highlights, and descriptive content — in seconds. You can edit everything it produces before submitting to the GM.

How do I update my character during an ongoing campaign?

After claiming a PC or Summon, an edit button appears on the character card. Make any changes — updates sync automatically back to the GM's campaign.

Lore Library

What is the Lore Library in the player view?

The Lore Library shows all lore cards your GM has marked as shared — world knowledge the GM wants you to access during play. This includes NPCs you've met, locations you've visited, plot hooks, item descriptions, factions, and more.

How do I filter and search the Lore Library?

Filter cards by Story Arc to focus on content relevant to the current storyline. Use the search bar to find specific NPCs, locations, or items by name or description. Click any card to expand it and read the full details.

Is the Lore Library available when I'm not in a live session?

Yes. A cached snapshot of the Lore Library is available in the Player Hub (offline mode). You can browse the last known state of shared lore even when the GM isn't currently broadcasting.

Can I roll my character's stats from the sheet?

Yes - hover a stat, save, skill, or attack to get a Roll/Edit popover, or use the Rollables tab in the dice tray. See the 3D Dice Tray section for details.

Chat & Private Messages

How does the chat system work for players?

The Chat tab shows multiple conversation channels:

How do I send a private message to the GM or another player?

Click the new message button in the Chat tab and select who to include. You can message the GM privately, message another player, or create a group conversation. Private messages are tagged with a lock icon so everyone knows they're not public.

What do unread message badges mean?

Red badge numbers on chat tabs indicate new unread messages. Private chat tabs show unread counts for messages you haven't seen yet.

Can I speak as one of my claimed characters in chat?

Yes. If you've claimed multiple PCs, use the character dropdown above the chat input to choose which character is currently speaking. Messages display that character's name instead of your player name.

3D Dice Tray

What dice can players roll in ZapGM?

The player dice tray (Dice tab) supports d4, d6, d8, d10, d12, d20, and d100 with a 3D physics simulation. Select any combination, set a +/- modifier, and press Roll. Results are broadcast to the chat feed so everyone sees them. The tray has three tabs - Dice, Rollables, and Saved Rolls - and you can drag it by the bar at the top.

How do advantage and disadvantage rolls work?

On the Dice tab, Advantage rolls twice and keeps the higher result, Disadvantage keeps the lower - both rolls are shown. You can also do this from any stat roll: Shift-click for Advantage, right-click for Disadvantage (on a character-sheet roll popover, a Rollables row, or a Saved Rolls row).

What is the Rollables tab?

The Rollables tab automatically lists every roll your claimed character(s) can make - ability checks, saves, skills, initiative, and attacks - pulled from your character sheet and grouped by character. Click any row to roll it; no need to build the dice by hand.

What is the Saved Rolls tab?

Saved Rolls holds custom rolls you have saved, grouped by the character they belong to, plus a "Personal" group for rolls not tied to a character. Click a row to roll, the pencil to edit, or the trash to delete (with a confirmation).

Can I roll a stat directly from my character sheet?

Yes. Hover a stat, save, skill, or attack on your sheet and a popover appears with the dice notation, a Roll button, and an Edit button. Roll fires the 3D dice and broadcasts a labeled result.

What happens when I edit a roll?

For a calculated stat (save, skill, initiative) you can either Save as Custom Roll (a separate entry in Other Rolls) or Save to [stat] (override the value on your sheet). Editing a weapon or spell attack updates that attack's bonus directly on the sheet. Define brand-new rolls (like damage) in the Other Rolls section of your sheet - they then appear in Saved Rolls.

What are private rolls?

Toggle Private Roll mode to roll dice only you can see - a "PRIVATE" label appears in your own log and the result is not broadcast to others. Useful for secret checks.

What gets saved with a roll, and what doesn't?

The dice and modifier are saved; advantage/disadvantage and private/public are not. Choose advantage/disadvantage each time (Shift-click / right-click), and private vs public follows the dice-tray toggle at the moment you roll.

Can I customize the appearance of my dice?

Yes - choose from eight visual themes (Cobalt, Rust, Oak, Jade, Royal, Void, Magma, Blight) or use the custom color picker to make your own.

Party Sidebar & Audio

What does the Party sidebar show?

The Party sidebar displays:

How do I control the GM narration audio?

Use the speaker toggle at the top of the Party sidebar to enable or disable AI narration audio. When enabled, the GM's narrated text plays automatically as speech through your speakers. Each NPC and narrator can have a distinct voice assigned by the GM for a more immersive experience.

Can I see when it is my character's turn in combat?

Yes. When the GM is running the VTT battle map, the current turn is highlighted in the initiative tracker bar at the top of the map view. Your character's token also receives a visual indicator when it is your turn to act.

Battle Map View

What can players see on the VTT battle map?

When the GM broadcasts the live battle map, players see:

Can players pan and zoom the battle map independently?

Yes. Pan by clicking and dragging, zoom with the mouse wheel or +/− buttons, and reset the view with the "Fit to Screen" button. Moving your personal view does not affect what the GM or other players see.

Can players interact with tokens on the battle map?

Click any token to view information about it. Clicking your own claimed character's token opens a full detail panel showing your stats and conditions. Clicking other tokens shows a read-only overview from their lore card.

Can players draw on the battle map?

Yes, but player annotations are local only and are not visible to the GM or other players. Use the drawing tools to mark your own range estimates, track threatened areas, or plan your next turn. Your personal drawings persist until you clear them.

Can players move their own tokens on the map?

No. Token movement is controlled by the GM. Players cannot drag or reposition tokens — this ensures the GM maintains full control over the game board state.

Offline Mode & Player Hub

What is the Player Hub?

The Player Hub is ZapGM's offline mode for players. It activates automatically when a broadcast session is not currently live — either because the GM hasn't started yet, the session has ended, or the connection was lost. From the Player Hub, you can browse a cached snapshot of the campaign without a live connection.

What can I access in the Player Hub without being in a live session?

The Player Hub provides read-only access to:

Does the Player Hub content update in real time?

No. The Player Hub shows a cached snapshot from the last live session. Content does not update until the GM goes live and you reconnect to an active broadcast.

How do I rejoin a live session from the Player Hub?

When the GM starts the broadcast, a "Join Live Session" option becomes available. Click it to switch from the Player Hub to the real-time Broadcast Feed and reconnect to the session.

Do I need to be re-invited every session?

No. Once you have claimed a character in a campaign, that campaign appears as a shortcut on your ZapGM home page. You can return at any time — even when the GM is offline — to browse shared lore, edit your characters, and create new ones. When the GM starts the next broadcast, you are automatically included in the live session. The initial invite link only needs to be used once.

Explore ZapGM