StatBlock Documentation

Getting Started

What is StatBlock?

StatBlock is a TTRPG matchmaking platform. Players browse and join open games. Game Masters post games, recruit players, and track sessions. Venues list their spaces for the community to discover. After each session, everyone rates each other — building a reputation that follows them across the platform.

Creating an Account

Open StatBlock and click Get Started. Enter your email address, choose a username and display name, and set a password. Your account is active immediately — you'll be taken through a short onboarding flow to set up your first profile.

If you ever need to reset your password, click Forgot password? on the login page. A reset link will be sent to your email address.

Choosing Your Role

During onboarding you'll choose which role (or roles) you want:

You can hold more than one role — for example, you might be both a Player and a GM. Each role you select creates a separate profile with its own settings and visibility.

Navigating the App

The top navigation bar gives you access to your dashboard, discovery search, messages, notifications, and your profile. On mobile and tablet, tap the menu icon in the top-right corner to open the navigation drawer. Your dashboard is your home base — it shows your upcoming sessions, pending seat requests, unread messages, and any ratings waiting to be submitted.

For Players

Setting Up Your Player Profile

Your player profile is how GMs and other players find and evaluate you. Head to Profile → Edit Profile to fill it out.

Basic info:

• Bio — a short description of who you are as a player, your experience level, and what you're looking for in a game
• Location — your city and state, used for proximity search so nearby games appear first; also set your travel radius (in miles) to control how far you're willing to go
• Pronouns — displayed on your profile and search cards

Game preferences:

• Looking For — whether you're seeking a One-shot, Campaign, Either, or not currently looking
• Format Preference — In-Person, Online, or Both
• Availability — select the days and time slots (Morning, Afternoon, Evening) when you're free to play
• Game Systems — the systems you play (D&D 5e, Pathfinder, Call of Cthulhu, etc.) and your experience level with each
• Play Style — tone tags that describe your preferred game feel (Combat Heavy, Deep Roleplay, Cinematic, Comedic, Horror, etc.)
• Typical Party Role — the roles you usually fill at the table (Storyteller, Tactician, Actor, Explorer, Socializer, Support, Wildcard)
• Scenarios I Love — ranked narrative tones you gravitate toward (Classic Adventure, Dark Horror, Political Intrigue, etc.)

Safety and comfort:

• Safety Tools — list the safety tools you're comfortable using, such as X-Card, Lines & Veils, or the Consent Checklist
• Content Comfort — set your comfort level (Comfortable, Fade to Black, or Avoid) for specific content categories such as Graphic Violence, Horror, Adult Themes, and others. This helps GMs understand what kind of table will be a good fit for you.

Between Sessions:

• Engagement Tags — indicate how you engage with games outside of session time: journaling, Discord roleplay, fan art, watching actual plays, or preferring to keep things fully unplugged

Your profile is public by default, meaning GMs can find and evaluate you through discovery. You can set it to private in your profile settings if you prefer not to appear in search results.

Managing Your Characters

Your character portfolio lets you keep track of characters across different game systems, so you can bring them to any game.

Creating a character:

1. Go to Dashboard → Characters → New Character
2. Pick the game system — this determines which stats are available and cannot be changed later
3. Fill in the character's name, class, level, and optionally a backstory and personal notes
4. Add system-specific stats (e.g. Strength, Dexterity for D&D 5e) and any custom traits you want to track
5. Choose an emoji to represent the character on your profile and in seat requests

You can attach a character to a seat request so the GM knows who you're bringing to the table.

Archiving a character: Open the character detail view and tap Archive. Archived characters are hidden from your active roster but preserved for your records. You can unarchive a character at any time.

Discovering Games

Click Discover in the navigation bar to search for open games. You can filter by:

• Game system (D&D 5e, Pathfinder, Call of Cthulhu, etc.)
• Format (In-Person, Online, Hybrid)
• Game type (Campaign or One-shot)
• Proximity — games near your set location appear on an interactive map; adjust the radius slider to widen or narrow the search
• Frequency (Weekly, Biweekly, Monthly, One-shot, Flexible)
• Pricing (Free or Paid)

Click any game listing to see its full details: the GM's profile and ratings, the game description, safety tools in use, available seats, session history, and pricing.

You can also browse GMs and Players directly from the Discover page — useful if you want to find a GM whose style matches yours before looking at their open games, or if you're a GM scouting for players.

Requesting a Seat

When you find a game you'd like to join, click Request a Seat on the game detail page.

You can attach a character from your portfolio and add a short note to the GM — use this to introduce yourself or explain why you'd be a good fit. Your request opens a message thread with the GM where you can continue the conversation.

Request statuses:

GMs have 72 hours to respond to a seat request before it expires. If a request expires without a response, you'll be notified and can apply elsewhere.

Attending Sessions

Once you're on a game's roster, your upcoming sessions appear on your dashboard. When a session happens, the GM will check you in. After the session is marked complete, you'll receive a notification that ratings are ready to submit.

The game detail page shows the full session history for every game you're part of, including session summaries written by the GM.

Rating Your Experience

After each completed session, you'll be prompted to rate the other participants. Ratings are anonymous and cover five dimensions, each scored 1–10:

• Communication — how well the person communicated before and during the session
• Reliability — whether they showed up on time and followed through
• Storytelling & Engagement — how much they contributed to the shared story
• Safety & Respect — how well they upheld table safety norms
• Would Play Again — your overall willingness to play with them again

Ratings feed into each user's public reputation summary. You can view a player's or GM's aggregated scores on their profile.

For Game Masters

Setting Up Your GM Profile

Your GM profile tells players what kind of games you run and what to expect at your table. Go to Profile → Edit GM Profile to set it up.

What to add:

• Bio — describe your GMing style, experience, and what players can expect at your table
• Location and travel radius — for in-person games, so players nearby can find you
• Game Systems — the systems you run and your experience level with each
• Availability — your available days and time slots
• Session format — In-Person, Online, or Both
• Frequency — how often you typically run (Weekly, Biweekly, Monthly, Flexible)
• Narrative style — where your games fall on the Combat Heavy ↔ Deep Roleplay spectrum
• Prep style — how much you prepare before each session (Light improv to Heavy prep)
• Typical party size — your preferred minimum and maximum number of players
• Campaign types — whether you run Campaigns, One-shots, or Short Campaigns
• Pricing — Free or Paid, with a price-per-session if applicable
• Safety tools — the tools you use at every table
• Tone tags — descriptors for the feel of your games (Cinematic, Gritty, Horror, Comedic, etc.)

Your GM profile appears in player-facing discovery, so filling it out thoroughly helps the right players find you.

Posting a Game

To create a new game listing, click New Game from your dashboard or GM profile.

Fill in:

• Title — the name of the game
• System — the game system you're running
• Type — Campaign (ongoing) or One-shot
• Format — In-Person, Online, or Hybrid
• Venue — select a registered venue if playing in-person, or provide an online meeting link
• Description — tell players what the game is about, tone, themes, and expectations
• Max players — the number of seats available
• Frequency — how often sessions will occur
• Pricing — Free or Paid (with price per session)
• Safety tools — list the tools in use at this table

Set the game status to Open when you're ready to accept seat requests. While the game is active you can update all of these fields at any time from the game's edit page.

Reference Library: Once a game is created, you can attach files (PDFs, images, Word documents, etc.) to the game's Reference Library. Files are visible to everyone on the roster — useful for sharing house rules, maps, lore documents, or campaign notes.

Photo Gallery: You can upload photos to a game's gallery. Any roster member can contribute photos, but only you (as GM) can delete them.

Managing Your Roster

Open the game detail page to view your current roster and pending seat requests. You can:

• Accept a seat request — moves the player onto the active roster and opens a message thread with them
• Decline a seat request with an optional note to the player
• Remove a player from the roster if needed

Each player card shows their character, class, level, and profile rating so you can evaluate them at a glance.

Running Sessions

Sessions are individual meetings within a game. Create a new session from the game detail page by clicking Add Session. For each session you can:

• Set the scheduled date and time
• Mark it as a Session Zero — a pre-game safety and expectation-setting session (Session Zeros are tracked separately from your main session count)
• Write a session summary for your roster to read after the fact
• Mark the session as Complete when it's done

Marking a session complete triggers rating prompts for everyone who attended. Your game's session streak — a count of consecutive completed sessions — is tracked automatically and displayed on your game card.

Closing a Game

When a game is finished or no longer running, use the 🔒 Close Game button on the game detail page (visible to you as GM whenever the game is Open or Active). You'll be asked to choose one of two outcomes:

Closing a game removes it from open-seat discovery and prevents new seat requests. The game's full session history, roster, and stats remain visible on your profile.

Broadcasting to Players

To send a message to your entire roster at once, use the Broadcast option from the messaging section or from the game detail page. Write your message and every active player in the game receives it in their inbox. Players can reply directly to a broadcast and you'll see all replies grouped together.

Broadcasts are useful for session reminders, schedule changes, or any announcement that goes to the whole table.

Rating Your Players

After marking a session complete, you'll be prompted to rate each player who attended using the same five-dimension rating system. Ratings are anonymous. Submitting them helps players build their reputation and makes it easier for other GMs to evaluate new applicants.

For Venue Owners

Creating a Venue Listing

If you run a game shop, café, library, or any space that hosts TTRPG games, you can list your venue on StatBlock so GMs can find and book it.

Go to Dashboard → Create Venue and fill in:

• Name — your venue's name
• Description — what the space is like and what you offer to tabletop gamers
• Location — your address (used for proximity search)
• Contact information — how GMs can get in touch to enquire about bookings

Venue listings are reviewed by a StatBlock admin before appearing publicly. You'll be notified once your listing is approved.

Managing Hours and Amenities

On your venue's edit page (Venue Detail → Edit Venue), you can set your opening hours for each day of the week. Mark any day as Closed if you're not open. For each open day, set your open and close times.

The Amenities section lets you mark which features your space offers — things like parking, Wi-Fi, food and drinks, accessible seating, and private rooms. Toggle each amenity on or off from the grid.

You can also manage individual tables — set the name, seating capacity, and availability for each table in your space. GMs use this information when booking through the platform.

Uploading Photos

A photo gallery makes your venue listing more appealing to GMs and players. From your venue edit page:

• Avatar — upload a main cover image that appears in search results and at the top of your listing
• Gallery — add additional photos showing your tables, decor, layout, or any other features you'd like to highlight

Photos are stored securely via Cloudinary and can be deleted from the gallery at any time.

House Rules and Facilities

The House Rules section lets you list any rules players and GMs should know before visiting — reservation policies, noise limits, food and drink rules, age restrictions, and so on. Each rule appears as a line item on your public listing.

The Facilities section covers gaming-specific amenities you provide: dice towers, miniature terrain, screen sets, battle maps, table toppers, and similar items available to hosted games.

Booking Requests

GMs can reserve a table at your venue directly through StatBlock. When a GM books a table you'll see the booking on your venue dashboard with the date, time, table, and party size. The platform handles payment processing — you set your pricing and StatBlock collects it at the time of booking.

You can also offer discount codes (percentage or flat amount off) for regular customers or promotional periods.

After a booking is completed, players and GMs can leave a venue rating covering four dimensions: Cleanliness, Gaming Suitability, Staff, and Amenities. These ratings are averaged and displayed publicly on your venue listing.

Platform Features

Messaging

StatBlock has a full messaging system with three conversation types:

• Direct messages — one-on-one conversations you can start with any user
• Seat request threads — automatically created when a player requests a seat; the player and GM can communicate within the thread before a decision is made
• GM outreach — a GM can initiate a conversation with a player directly from discovery to invite them to a game

Open Messages in the navigation bar to see your inbox. Use the filter tabs (All, Requests, Outreach, Direct, Broadcasts) to find what you're looking for. The inbox refreshes automatically so you don't miss a response.

Notifications

StatBlock sends you a notification whenever something important happens:

• A GM accepts or declines your seat request
• A player requests a seat in one of your games
• A session is scheduled or completed
• You receive a new message
• You earn a badge

View all your notifications by clicking the bell icon in the navigation bar. Notifications are marked as read when you open them.

Ratings and Badges

Ratings are collected after every completed session. Each person rates the others on five dimensions (see Rating Your Experience). Individual scores are anonymous, but the aggregated results — an average per dimension plus an overall score — are visible on every public profile.

Venues receive their own ratings after bookings on four dimensions: Cleanliness, Gaming Suitability, Staff, and Amenities.

Badges are awarded automatically when your ratings cross certain thresholds. They reflect your standing as a player, GM, or venue owner and appear prominently on your profile. Badges have a minimum review count requirement, so you need a meaningful number of ratings before they can be earned. You'll receive a notification the moment a new badge is added to your profile.

Safety Tools

StatBlock treats table safety as a first-class feature. Both players and GMs can list the safety tools they use or are comfortable with on their profiles. Games also display their own safety tool list on the game detail page.

Common tools you'll see listed include:

• X-Card — tap or hold up a card/signal to edit or skip content without explanation
• Lines & Veils — pre-game agreement on content that won't appear (lines) or will happen off-screen (veils)
• Consent Checklist — a written checklist of themes players review and mark comfortable, uncomfortable, or off-limits
• Open Door Policy — anyone can leave the table at any time, no questions asked
• Session Zero — a dedicated pre-campaign session for safety calibration, character creation, and expectation-setting

Players can also set granular Content Comfort preferences on their profile — marking specific content categories as Comfortable, Fade to Black, or Avoid. This helps GMs and players find tables where everyone is on the same page before the first session.

Discovery

The Discover page lets you search across four areas of the platform:

• Games — open game listings with seats available, filterable by system, format, type, proximity, frequency, and pricing
• Game Masters — GM profiles searchable by location, system, format, and availability
• Players — player profiles searchable by availability, systems, and engagement style (useful for GMs scouting for their table)
• Venues — venue listings filterable by location, amenities, and current game activity

Proximity search uses your saved location and a radius (in miles) you can adjust. Results are plotted on an interactive map powered by OpenStreetMap.

Blocking and Reporting

If you need to remove someone from your experience on StatBlock, you can block them. Blocking a user prevents them from seeing your profile and from contacting you. Blocking is private — the blocked user is not notified.

If you encounter behavior that violates community standards, use the Report option on a user's profile or in a conversation. Reports are reviewed by StatBlock admins. You can submit a report with or without also blocking the user.

Account Settings

Editing Your Profile

Go to Profile → Edit Profile (for players) or Profile → Edit GM Profile (for GMs) to update your information at any time. Changes to your display name, pronouns, bio, location, availability, and style tags take effect immediately.

To update your avatar, use the avatar upload section at the top of your edit profile page. Profile photos are hosted on Cloudinary — supported formats are JPEG and PNG. You can remove your avatar at any time to revert to your generated initial.

Your display name is what other users see throughout the platform. It can differ from your account username, which is permanent once set.

Password and Security

To change your password, go to Account Settings → Change Password. You'll need to enter your current password before setting a new one.

If you've lost access to your account, use the Forgot password? link on the login page to request a reset email. The link expires after a short window, so use it promptly.

For your security, StatBlock uses short-lived access tokens (valid for 15 minutes) with automatic silent refresh using a longer-lived refresh token (valid for 7 days). You'll stay logged in across sessions without needing to re-enter your password, as long as you use the app at least once a week.