The Questwright Manual

Getting Started

What is Questwright?

Questwright is a web-based D&D 5th Edition campaign manager powered by AI. Create characters, run campaigns, and play adventures through an immersive web interface - with optional Discord integration for players who prefer chat-based gameplay.

Unlike traditional tools, Questwright is your AI Dungeon Master. It tracks your character's story, manages NPCs, weaves your backstory into the narrative, and remembers every choice, relationship, and consequence. It creates a living world that responds to you.

Creating Your Character

The best way to create a character is using the Web Character Creator. It's a guided 7-step wizard that walks you through race, class, background, abilities, equipment, spells, and backstory - all in one place.

1. Log in to the web interface at questwright.app
2. Click Create Character or go to the Character Creator
3. Follow the step-by-step wizard to build your character
4. Your character is ready to play!

Joining a Session

Once your character is created, you can join campaigns directly from the web. Go to Campaigns in the navigation, select a campaign, and click Play to jump into the action. Your character is automatically linked to your account.

Basic Gameplay

From your campaign page, click the Play button to enter the gameplay interface. The core actions are:

• Say - Speak in character to NPCs or other players
• Do - Take actions in the game world
• Roll - Roll dice with custom notation
• Check - Make skill checks with auto-calculated modifiers
• Save - Make saving throws with auto-calculated modifiers

Questwright responds to your actions naturally. Describe what you want to do, and it will narrate the results, ask for rolls when appropriate, and move the story forward.

Infinite Campaign Mode

Questwright supports infinite campaign mode - continuous play without explicit session starts and stops. Players can take actions anytime and Questwright will respond, picking up right where you left off.

This is perfect for asynchronous play where different players are online at different times. The story continues whenever anyone engages, and Questwright remembers everything.

Your Account

Questwright's web interface uses accounts to keep your characters, campaigns, and progress organized. Your web account can be linked to Discord for seamless cross-platform integration.

Getting Access

Questwright is currently in private beta. To join, click Request Access on the login page or visit the request access page directly.

The fastest way to request access is to sign in with Discord - this automatically links your Discord account and lets us know who you are in the community.

Sign In Options

Questwright lets you sign in with accounts you already have:

When you sign in with one of these services for the first time, an account is created automatically. You can link multiple services to the same account from your profile page.

Profile Settings

Click your name in the navigation bar to access your profile page. From here you can:

• Change Password - Update your account password
• Update Display Name - Change how your name appears
• Link Discord - Connect your Discord account for character syncing
• View Your Characters - Quick access to all characters linked to your account

Linking Discord

Linking your Discord account enables powerful cross-platform features:

• Automatic character claiming - Characters you create are automatically linked to your account
• Web character access - View and manage all your characters from the web interface
• Cross-platform sync - Your Discord activity and web activity stay in sync

To link your Discord account, go to your profile page and click the Link Discord Account button. You'll be redirected to Discord to authorize the connection, then brought back to Questwright with your accounts linked.

Character Linking

Characters are automatically linked to your web account in several ways:

• Web Character Creator - Characters you create on the web are automatically linked if you're logged in
• Linked Discord Account - When you link your Discord account, any existing characters you've created through Discord are automatically connected
• Discord Commands - Using /register in Discord will link characters to your web account if your Discord is connected

Linked characters appear in your profile's "My Characters" section with quick links to their full character sheets.

Web Tools

Questwright's web interface is where the magic happens. Create characters with a guided wizard, manage campaigns, play live sessions, and track your party's journey - all from your browser.

Web Character Creator

The web character creator is a 7-step wizard that walks you through building a complete D&D 5e character. Access it in the Character Creator.

If you're logged in with a linked Discord account, characters you create are automatically connected to both your web account and Discord profile.

Step-by-Step Process

1. Race & Name - Choose your race, subrace, character name, and alignment. Use the random name generator for race-appropriate suggestions.
2. Class - Select your class and optionally a subclass. View hit dice, proficiencies, and starting features.
3. Background - Pick your background, which provides skill proficiencies, languages, equipment, and a special feature.
4. Abilities - Assign your ability scores using one of three methods:
   • Point Buy - Start at 8 in all stats, spend 27 points to customize
   • Standard Array - Use the fixed values: 15, 14, 13, 12, 10, 8
   • Roll for Stats - Roll 4d6 drop lowest for each ability
5. Equipment - See your guaranteed starting equipment and make choices where options are available.
6. Spells - If you're a spellcaster, select your cantrips and 1st-level spells.
7. Review - See your complete character and submit to create them.

Backstory Builder

On the Background step, you'll find an interactive backstory builder. Click on suggested story elements (origin, motivation, complication, goal) to compose a narrative, then edit it to make it your own. You can also use the "Let Questwright Enhance This" button to have AI polish your backstory into richer prose.

Web Campaign Creator

DMs can create new campaigns in the Campaign Creator. This sets up the campaign in the database so players can join and characters can be assigned. The creator offers three modes for different styles of play.

Campaign Modes

Campaign Settings

• Campaign Name - A unique name for your campaign
• Description - Brief description of the setting and story premise
• Leveling Mode - XP-based or Milestone progression
• Starting Level - Character level to begin at (1-20)
• Discord Integration (optional) - Enable Discord channel integration for chat-based play

Once created, players can create characters for your campaign using the web character creator and select your campaign from the dropdown on the final step. If Discord integration is enabled, a private channel is automatically created for your campaign.

Web Character Sheet

Each character has a full web-based character sheet with multiple tabs for managing different aspects of your character. Access your character sheet from your profile or campaigns page.

Character Sheet Tabs

Web Gameplay

Play D&D directly in your browser! The web gameplay interface lets you take actions, roll dice, and interact with Questwright. From any campaign page, click the Play button to enter the gameplay view.

Character Actions Panel

If your character has a web character sheet, you get access to the integrated actions panel. This lets you use your character's abilities directly during gameplay.

Basic Actions

• Say - Speak in character to NPCs or other players
• Do - Describe an action your character takes
• Roll - Roll any dice notation (1d20+5, 2d6, etc.)
• Continue - Prompt the DM to advance the story
• Hold/Go - Coordinate party actions before the DM responds

Web DM Tools Panel

If you're the DM, you'll see a DM Tools panel on the right side of the play interface. This gives you quick access to common DM actions without leaving the gameplay view.

For the full DM dashboard with additional tools, click "Full Dashboard" in the panel header.

NPC Directory

Each campaign has an NPC directory that tracks everyone the party has encountered. Access it from the campaign page by clicking NPCs in the navigation. NPCs are automatically added as you meet them during play.

• Biographies - Rich descriptions of appearance, personality, goals, and motivations
• Relationship tracking - See your relationship status with each NPC
• Interaction history - When you first met, last seen, and key interactions
• Status indicators - Alive, dead, missing, or other story states
• Cross-linking - NPCs who own establishments link to their business entries

Location Directory

The location directory tracks towns, cities, and settlements the party has discovered or heard about. Access it from the campaign page by clicking Locations in the navigation.

• Discovery levels - "Visited" shows full details, "Heard of" shows partial info
• Party reputation - Track standing (Hostile to Celebrated) in each location
• Wanted status - Flags locations where the party is wanted by authorities
• Establishments - Taverns, shops, temples grouped by type with proprietor info
• DM View - Toggle to see hidden locations and establishments

Click any location to see its detail page with all discovered establishments, their proprietors, disposition, and price levels.

Maps & Virtual Tabletop

Questwright includes a full procedural map generation system and virtual tabletop (VTT) for tactical combat. Maps are generated using algorithms and then enhanced by the AI for narrative richness.

World Maps

Each campaign can have a procedurally generated hex-based world map. Access it from the campaign page by clicking World Map in the navigation. World maps use Perlin noise terrain generation with multiple terrain types and fog of war.

Battle Maps

When combat begins, the DM can generate tactical battle maps for grid-based combat. Battle maps support tokens, terrain features, and fog of war for tactical play.

• Procedural Generation - Generate dungeon rooms, forest clearings, tavern interiors, and more
• D&D 5e Grid - 1 cell = 5 feet, supporting standard movement and range calculations
• Terrain Features - Walls, difficult terrain, water, lava, pits, and other hazards
• Multiple Map Sizes - From small encounters to large battle arenas

VTT Features

The virtual tabletop canvas provides tactical combat visualization with full token management:

Backstory System

Overview

The backstory system lets you define people, places, events, and secrets from your character's past. Questwright uses this information to create personalized story hooks, bring in characters from your past, and make the world feel connected to your character.

The more backstory you add, the more personalized your adventure becomes. Your mentor might appear when you need guidance. That rival from your past might show up at the worst possible moment. The artifact you've been seeking could be rumored to be in the next town.

Ways to Create Backstory

There are several ways to add backstory to your character:

• Web Character Creator - The backstory builder on step 3 (Background) lets you craft your story with guided prompts and AI enhancement
• /backstory-create - Interactive DM conversation that asks questions about your character's past
• /backstory add - Manually add specific backstory elements anytime

Backstory Types

Managing Your Backstory

Your backstory is displayed on the Backstory tab of your character sheet, where you can view all your backstory elements organized by type.

Story Tracking

Questwright automatically tracks your character's journey, recording significant events, relationships with NPCs, conditions, and reputation. View this information on your character sheet tabs:

• Story Tab - Active conditions and recent story events
• Relationships Tab - NPCs you've met with trust levels and relationship types

Relationships

The Relationships tab shows every NPC your character has met, along with:

• Relationship type - Ally, rival, mentor, contact, enemy, etc.
• Trust score - From -100 (sworn enemy) to +100 (unbreakable bond)
• Interaction history - When you first met and last interacted

Relationships evolve based on your interactions. Helping an NPC builds trust. Breaking promises or hostile actions damage relationships.

Conditions

The Story tab shows active conditions affecting your character - injuries, curses, blessings, debts, or other persistent effects. Conditions have severity levels (minor, moderate, severe, critical) and may require specific actions to resolve.

Taking Actions

The gameplay interface provides several ways to interact with your adventure. All actions work the same whether you're using the web interface or Discord.

Core Actions

In the play view, you'll find action buttons for the most common gameplay actions:

• Say - Speak in character. Use for dialogue with NPCs or other players.
• Do - Take an action. Describe what your character does and Questwright narrates the results.
• Roll - Roll dice using standard notation (1d20, 2d6+3, etc.).
• Continue - Let Questwright advance the story when you have nothing specific to add.

Skill Checks and Saves

When Questwright calls for a check or save, use your character's Actions Panel to roll with auto-calculated modifiers. The Skills tab shows all 18 skills, and clicking one rolls with your proficiency and ability modifier applied automatically.

• Proficiency bonuses are applied automatically based on your character sheet
• Advantage and disadvantage options are available for each roll
• Results automatically compare against the DC and report success or failure
• All rolls are logged for the campaign statistics page

Dice Notation

The dice roller supports standard D&D notation:

Combat

During combat, the interface shows the initiative order with current turn highlighted. Use the Attacks tab in your Actions Panel to attack with equipped weapons - attack bonus and damage dice are calculated automatically from your character data.

• Initiative order shows round number and all combatants
• Current turn is clearly marked
• Players and enemies are distinguished by icons

Party Coordination

Coordinating Actions

When multiple players want to act before Questwright responds, use the action queue. This lets everyone queue their actions, then release them together for a single, cohesive narrative response.

In the web interface, click Hold to start queuing. Other players can then submit their actions, which get queued instead of triggering immediate responses. When everyone's ready, click Go to release all actions at once.

Party Whispers

Need to coordinate with your party without NPCs hearing? Use party whispers. Questwright sees these for story continuity (and can use them for dramatic irony), but NPCs won't react unless they'd realistically overhear.

Inventory System

Managing Your Inventory

Your character sheet's Inventory tab shows all your items organized by category: weapons, armor, potions, gear, and more. Equipped items are highlighted, and you can equip or unequip items with a click.

Questwright tracks items automatically during play. When you find loot, buy equipment, or use consumables, your inventory updates in real-time. No manual tracking needed.

Automatic Tracking

During gameplay, Questwright automatically tracks:

• Loot acquisition - Items found on defeated enemies, in treasure chests, etc.
• Purchases - Items bought from shops, including gold deductions
• Consumables - Potions used, ammunition spent, etc.
• Currency changes - Gold earned, spent, or lost

Currency

Your currency is displayed at the top of the Inventory tab, showing all D&D denominations: copper (cp), silver (sp), electrum (ep), gold (gp), and platinum (pp).

Party Treasury

The campaign has a shared treasury for group loot. Access it from the campaign page to see unclaimed items and shared gold. You can transfer items between your inventory and the treasury, or give items directly to other players.

Your Characters

All your characters are accessible from the My Characters link in the navigation. Here you can see every character you've created across all campaigns, with quick links to their character sheets.

Character Sheets

Click any character to open their full character sheet with multiple tabs:

• Stats - Ability scores, skills, saving throws, combat stats
• Inventory - Equipment, items, and currency
• Spells - Spell slots, prepared/known spells, cantrips
• Relationships - NPCs you've met and your standing with them
• Story - Active conditions and recent events
• Backstory - Personality traits, backstory, and story hooks

Your character sheet updates automatically during play - items you find, NPCs you meet, and conditions you gain all appear without manual updating.

Multiple Characters

You can have multiple characters across different campaigns. When joining a campaign's play session, your character for that campaign is automatically selected.

Rules Database

Questwright includes a comprehensive D&D 5e rules database with over 1,500 entries. During play, you can ask rules questions and Questwright will provide accurate answers using AI combined with official game content.

Ask the DM

Need a rules clarification during play? Type your question and Questwright will answer using its rules database. Questions are clearly marked as out-of-character so they don't break the narrative flow.

Example questions:

• "How does grappling work?"
• "Can I cast two spells in one turn?"
• "What happens when I go to 0 HP?"

Database Contents

The database contains content from the D&D 5th Edition System Reference Document (SRD):

The DM Role

How DMing Works with Questwright

If you're used to traditional D&D, the DM role with Questwright is a bit different. Instead of narrating every scene, voicing every NPC, and tracking every rule yourself, Questwright handles the moment-to-moment storytelling. This frees you up to focus on the big picture.

Think of yourself less as a performer and more as a director. Questwright is your improvisational actor - it knows the rules, it can voice characters, and it keeps the story moving. Your job is to guide it when needed, course-correct if it goes astray, and inject your own creative ideas when inspiration strikes.

What Questwright Handles

• Narrating scenes and describing environments
• Voicing NPCs and their reactions
• Tracking story events, relationships, and conditions
• Remembering what happened in previous sessions
• Weaving player backstories into the narrative
• Managing inventory and currency during play
• Asking for appropriate skill checks

What You Handle

• Starting and ending sessions
• Setting up campaigns and approving characters
• Steering the story if it needs course correction
• Adding your own narrative flair when you want
• Making final calls on rules disputes
• Creating secrets, rumors, and plot hooks

Steering the Story

Sometimes Questwright might take the story in a direction you didn't intend, or you might have a specific idea you want to introduce. That's where your DM tools come in.

From the play interface, the DM Tools panel on the right gives you access to:

Session Management

Running Sessions

From the campaign page, use the session controls to manage play:

• Start Session - Begin tracking events and enable gameplay
• Pause Session - Pause play while preserving story state
• Resume Session - Continue from where you left off
• End Session - Wrap up with an AI-generated summary

Session Information

The campaign page displays current session status including location, active players, in-game time, and any ongoing effects. When you begin a new session, Questwright creates a dramatic opening that incorporates each character's backstory.

Session Recaps

Need a refresher? The recap feature generates an AI summary of recent sessions - perfect for catching up after a break or reminding players what happened last time.

DM Tools

Web DM Dashboard

As a DM, you have access to additional tools for managing your campaign. The DM Dashboard (accessible from your campaign page) provides a comprehensive interface for:

Leveling & Progression

Overview

Questwright supports both traditional XP-based leveling and story-based milestone leveling. The leveling system is set when a campaign is created and determines how characters advance.

• XP-Based - Characters earn experience points from combat, exploration, and roleplay. When they reach XP thresholds, they level up.
• Milestone - The DM decides when characters level up based on story progress. No XP tracking needed.

XP Tracking

For XP-based campaigns, your character sheet's Stats tab shows an XP progress bar indicating how close you are to the next level. The bar fills as you earn XP and shows both your current total and the threshold for the next level.

XP awards are recorded with notes about why they were earned (defeating enemies, clever roleplay, completing objectives). Your recent XP history is displayed below the progress bar so you can see what contributed to your advancement.

Standard D&D 5e XP Thresholds

Milestone Leveling

In milestone campaigns, the DM uses /dm level milestone to level up characters at appropriate story moments. This happens when the party completes major objectives, reaches significant story beats, or when the DM feels advancement is narratively appropriate.

Level-Up Process

When your character levels up, you'll need to make several choices depending on your class:

• Hit Points - Roll your hit die or take the average (rounded up)
• Class Features - Gain new abilities based on your class and level
• Spellcasters - New spell slots and potentially new spells known
• ASI Levels (4, 8, 12, 16, 19) - Increase ability scores by 2 or choose a feat

Your character sheet will show a "Level Up Available" indicator when you have enough XP to advance. The level-up process guides you through all required choices.

Spellcasting

Overview

If your class has spellcasting abilities, your character sheet includes a Spells tab for managing your magical abilities. The spellcasting system supports all D&D 5e caster types with their unique mechanics.

Spell Slots

The Spells tab displays your spell slots as visual circles for each spell level. Available slots appear filled, while used slots appear empty. Click a slot to use it when casting a spell of that level or higher.

Your spellcasting stats are displayed at the top of the tab:

• Spell Save DC - The DC enemies must beat to resist your spells
• Spell Attack Bonus - Added to attack rolls for spells that require them
• Spellcasting Ability - The ability score your magic is based on
• Max Spell Level - The highest level spell you can cast

Restoring Spell Slots

• Long Rest - Restores all spell slots for all casters
• Short Rest - Restores Warlock Pact Magic slots only

Preparing Spells

If you're a prepared caster (Wizard, Cleric, Druid, Paladin), your Spells tab shows all spells you have access to. Click on a spell to prepare or unprepare it. The maximum number of prepared spells is shown at the top.

For known casters, your spell list shows only the spells you've learned. These are always available to cast as long as you have the appropriate spell slot.

Rest & Recovery

Overview

The Rest & Recovery system on your character sheet's Stats tab lets you manage resting, hit dice, class resources, and recovery. Following D&D 5e rules, short and long rests restore different amounts of your character's resources.

Short Rest

A short rest is about 1 hour of downtime. During a short rest, you can spend hit dice to recover hit points. For each hit die spent, you roll your class's hit die and add your Constitution modifier (minimum 1 HP per die).

Click the Short Rest button to open the rest dialog. Choose how many hit dice to spend, then confirm to complete the rest.

What Recovers on Short Rest

• Hit Points - Spend hit dice to heal (roll + CON modifier per die)
• Warlock Pact Magic - All spell slots are restored
• Ki Points - Monks recover all Ki points
• Channel Divinity - Clerics and Paladins recover uses
• Action Surge/Second Wind - Fighters recover these abilities
• Wild Shape - Druids recover their Wild Shape uses
• Bardic Inspiration - Bards (level 5+) recover inspiration dice

Long Rest

A long rest is 8 hours of sleep in a safe location. Long rests fully restore your character's resources.

Click the Long Rest button to see what will be restored, then confirm to complete the rest.

What Recovers on Long Rest

• Hit Points - Restored to maximum
• Hit Dice - Recover half your total hit dice (minimum 1)
• Spell Slots - All spell slots are restored
• All Class Resources - Everything recovers (Ki, Rage, Sorcery Points, etc.)

Class Resources

Each class has unique resources that are tracked on your character sheet. Click on a resource box to use it (empty the slot) or restore it (fill the slot).

Bug Reporting

Found a bug? Questwright includes a bug reporting system that lets you report issues directly from Discord or the web interface. All bug reports are tracked and reviewed by the development team.

Web Bug Reports

You can also submit bug reports through the web interface by visiting the Bug Report page. This is useful for reporting issues with the web interface itself or when you're not in Discord.

How Questwright Works

AI Features

Questwright uses advanced AI to create a dynamic, responsive game experience. Here's what happens behind the scenes:

Time & Calendar System

Questwright tracks the passage of time in your campaign, including days, seasons, and special events. Time advances automatically during play (travel, resting, waiting) and affects the world around you.

Procedural Generation

Questwright uses a "code for determinism, Claude for creativity" approach. Procedural generators create consistent, rule-based content, while the AI adds narrative flavor and context.

Community

Join the Guild

Connect with fellow adventurers on our official Discord server. Get help, share your epic campaign moments, and stay updated on the latest features and updates.