Player's Manual

Getting started

ChatQuest is a D&D-style adventure that runs inside your Telegram or Discord group. The engine runs the rules, the map, and the monsters — no dungeon master required (or add the AI DM to improvise). To begin:

1. Add the bot to your group chat.
2. Load a campaign — /install <slug> from the store, or /loadmodule with a campaign JSON (build one with /setupprompt).
3. Everyone makes a hero — /createchar (pick a class).
4. Play together — explore, fight, and roleplay right in the chat.

↑ Back to top

How to play & interact

Two ways to do everything: tap the buttons the bot posts (/actions or /next open the action menu), or type slash commands. They do the same things — use whichever is handier.

Inventory items are tagged by what they do: 🧪 a consumable you can /use, 🗝 a key that opens a lock, 🎯 a quest item. Quest & key items go to a shared party stash (/stash) anyone can use.

↑ Back to top

Command reference

Every command, grouped as in /help. Most have a button equivalent in the action menu.

Basics

Setup

Play

Character

Explore

GM

Combat

↑ Back to top

Classes

The seven playable classes. Everyone starts with the abilities shown; on level-up each hero raises stats and learns from their skill tree (up to 5 actions total) via /levelup. Heroes climb to level 20 (new spell slots & ability picks through level 10).

Abilities in full

The exact mechanics of every ability — how it's rolled, what it costs, and what it does. Tags: maneuver ×N = martial, N uses per fight; cantrip / L-spell = spends a spell slot; ⚡ bonus action = doesn't cost your main action.

Fighter

• Second Wind ⚡ bonus action · maneuver · 1 per rest — Restores 1d10 (+ casting mod) HP to yourself; can revive a downed ally.
• Cleave maneuver · 2 per rest — Melee/finesse strike at one enemy: STR attack roll (can crit), 2d8 + STR mod damage on a hit.
• Taunt maneuver · 2 per rest — Every foe must attack you on their next turn (draws fire off the party).
• Riposte maneuver · 2 per rest — Melee/finesse strike at one enemy: STR attack roll (can crit), 2d10 + STR mod damage on a hit.
• Rally maneuver · 1 per rest — Restores 2d6 (+ casting mod) HP to an ally; can revive a downed ally.
• Shield Bash maneuver · 2 per rest — one enemy rolls a STR save (your spell save DC (8 + prof + casting mod)) or is 'prone' for 1 rounds.
• Precision Strike maneuver · 2 per rest — Melee/finesse strike at one enemy: STR attack roll (can crit), 2d8 + STR mod damage on a hit.
• Menacing Strike maneuver · 2 per rest — one enemy rolls a WIS save (your spell save DC (8 + prof + casting mod)) or is 'frightened' for 2 rounds.
• Sweeping Blow maneuver · 1 per rest — Auto-hits all enemies for 3d6 (no roll).
• Executioner's Strike maneuver · 2 per rest — Melee/finesse strike at one enemy: STR attack roll (can crit), 3d10 + STR mod damage on a hit.

Wizard

• Fire Bolt cantrip · at will — Spell attack vs one enemy's AC (can crit): 1d10 damage on a hit.
• Magic Missile level-1 spell · spends an L1+ slot — Auto-hits one enemy for 3d4+3 (no attack roll). ⬆️ Upcast: +1 dart (1d4+1) per slot level above 1.
• Shatter level-2 spell · spends an L2+ slot — all enemies each roll a CON save (your spell save DC (8 + prof + casting mod)); 3d8, half on a save. ⬆️ Upcast: +1d8 damage per slot level above 2.
• Hold Ray level-2 spell · spends an L2+ slot — one enemy rolls a WIS save (your spell save DC (8 + prof + casting mod)) or is 'stunned' for 3 rounds.
• Frost Ray cantrip · at will — Spell attack vs one enemy's AC (can crit): 1d8 damage on a hit.
• Scorching Burst level-2 spell · spends an L2+ slot — all enemies each roll a DEX save (your spell save DC (8 + prof + casting mod)); 3d6, half on a save. ⬆️ Upcast: +1d6 damage per slot level above 2.
• Shocking Grasp cantrip · at will — Spell attack vs one enemy's AC (can crit): 1d8 damage on a hit.
• Ice Storm level-3 spell · spends an L3+ slot — all enemies each roll a CON save (your spell save DC (8 + prof + casting mod)); 4d6, half on a save. ⬆️ Upcast: +1d6 damage per slot level above 3.
• Fireball level-3 spell · spends an L3+ slot — all enemies each roll a DEX save (your spell save DC (8 + prof + casting mod)); 6d6, half on a save. ⬆️ Upcast: +1d6 damage per slot level above 3.
• Blight level-4 spell · spends an L4+ slot — one enemy rolls a CON save (your spell save DC (8 + prof + casting mod)); 8d8 on a fail, half on a save. ⬆️ Upcast: +1d8 damage per slot level above 4.
• Cone of Cold level-5 spell · spends an L5+ slot — all enemies each roll a CON save (your spell save DC (8 + prof + casting mod)); 8d6, half on a save. ⬆️ Upcast: +1d6 damage per slot level above 5.

Rogue

• Sneak Attack maneuver · 3 per rest — Melee/finesse strike at one enemy: DEX attack roll (can crit), 3d6 + DEX mod damage on a hit.
• Cunning Strike maneuver · 2 per rest — Melee/finesse strike at one enemy: DEX attack roll (can crit), 2d6 + DEX mod damage on a hit.
• Dagger Toss maneuver · 2 per rest — Melee/finesse strike at one enemy: DEX attack roll (can crit), 2d4 + DEX mod damage on a hit.
• Blinding Powder maneuver · 2 per rest — one enemy rolls a DEX save (your spell save DC (8 + prof + casting mod)) or is 'blinded' for 1 rounds.
• Assassinate maneuver · 2 per rest — Melee/finesse strike at one enemy: DEX attack roll (can crit), 4d6 + DEX mod damage on a hit.
• Fan of Knives maneuver · 1 per rest — Auto-hits all enemies for 2d6 (no roll).
• Garrote maneuver · 1 per rest — one enemy rolls a CON save (your spell save DC (8 + prof + casting mod)) or is 'stunned' for 2 rounds.

Cleric

• Sacred Flame cantrip · at will — one enemy rolls a DEX save (your spell save DC (8 + prof + casting mod)); 1d8 on a fail, none on a save.
• Cure Wounds level-1 spell · spends an L1+ slot — Restores 1d8 (+ casting mod) HP to an ally; can revive a downed ally. ⬆️ Upcast: +1d8 healing per slot level above 1.
• Bless level-1 spell · spends an L1+ slot — all allies gain 'blessed' for 3 rounds.
• Guiding Bolt level-1 spell · spends an L1+ slot — Spell attack vs one enemy's AC (can crit): 4d6 damage on a hit. ⬆️ Upcast: +1d6 damage per slot level above 1.
• Healing Word ⚡ bonus action · level-1 spell · spends an L1+ slot — Restores 1d4 (+ casting mod) HP to an ally; can revive a downed ally. ⬆️ Upcast: +1d4 healing per slot level above 1.
• Prayer of Healing level-2 spell · spends an L2+ slot — Restores 2d8 (+ casting mod) HP to an ally; can revive a downed ally. ⬆️ Upcast: +1d8 healing per slot level above 2.
• Spirit Guardians level-3 spell · spends an L3+ slot — all enemies each roll a WIS save (your spell save DC (8 + prof + casting mod)); 3d8, half on a save. ⬆️ Upcast: +1d8 damage per slot level above 3.
• Sunbeam level-4 spell · spends an L4+ slot — all enemies each roll a CON save (your spell save DC (8 + prof + casting mod)); 6d8, half on a save. ⬆️ Upcast: +1d8 damage per slot level above 4.
• Heal level-4 spell · spends an L4+ slot — Restores 5d8 (+ casting mod) HP to an ally; can revive a downed ally. ⬆️ Upcast: +1d8 healing per slot level above 4.
• Flame Strike level-5 spell · spends an L5+ slot — all enemies each roll a DEX save (your spell save DC (8 + prof + casting mod)); 6d8, half on a save. ⬆️ Upcast: +1d8 damage per slot level above 5.
• Turn Undead maneuver · 1 per rest — all enemies each roll a WIS save (your spell save DC (8 + prof + casting mod)); any that fail are 'frightened' for 2 rounds (no damage).

Ranger

• Hunter's Mark ⚡ bonus action · level-1 spell · spends an L1+ slot — Marks one enemy (concentration); the whole party's hits on it deal +1d6 for 5 rounds. ⬆️ Upcast: +1d6 damage and +2 rounds of duration per slot level above 1.
• Volley maneuver · 1 per rest (unlimited at L11) — A separate DEX attack roll against all enemies (can crit; Bless/advantage apply); 2d6 + DEX mod damage on each hit.
• Ensnaring Strike level-1 spell · spends an L1+ slot — one enemy rolls a STR save (your spell save DC (8 + prof + casting mod)) or is 'restrained' for 3 rounds.
• Crippling Shot maneuver · 2 per rest — Melee/finesse strike at one enemy: DEX attack roll (can crit), 2d10 + DEX mod damage on a hit.
• Snare Trap maneuver · 2 per rest — one enemy rolls a STR save (your spell save DC (8 + prof + casting mod)) or is 'restrained' for 2 rounds.
• Multishot maneuver · 1 per rest — Auto-hits all enemies for 2d6 (no roll).
• Colossus Slayer maneuver · 2 per rest — Melee/finesse strike at one enemy: DEX attack roll (can crit), 3d10 + DEX mod damage on a hit.
• Conjure Volley maneuver · 1 per rest — Auto-hits all enemies for 3d6 (no roll).
• Hamstring Shot maneuver · 2 per rest — one enemy rolls a STR save (your spell save DC (8 + prof + casting mod)) or is 'restrained' for 2 rounds.

Barbarian

• Reckless Attack maneuver · 2 per rest — Melee/finesse strike at one enemy: STR attack roll (can crit), 2d12 + STR mod damage on a hit.
• Whirlwind maneuver · 1 per rest — Auto-hits all enemies for 2d6 (no roll).
• Taunt maneuver · 2 per rest — Every foe must attack you on their next turn (draws fire off the party).
• Frenzy maneuver · 1 per rest — Melee/finesse strike at one enemy: STR attack roll (can crit), 3d12 + STR mod damage on a hit.
• Reckless Cleave maneuver · 2 per rest — Melee/finesse strike at one enemy: STR attack roll (can crit), 2d12 + STR mod damage on a hit.
• Intimidating Roar maneuver · 1 per rest — one enemy rolls a WIS save (your spell save DC (8 + prof + casting mod)) or is 'frightened' for 2 rounds.
• Brutal Strike maneuver · 1 per rest — Melee/finesse strike at one enemy: STR attack roll (can crit), 4d12 + STR mod damage on a hit.
• Great Cleave maneuver · 1 per rest — Auto-hits all enemies for 3d6 (no roll).
• Crushing Blow maneuver · 1 per rest — one enemy rolls a CON save (your spell save DC (8 + prof + casting mod)) or is 'stunned' for 1 rounds.

Bard

• Vicious Mockery cantrip · at will — one enemy rolls a WIS save (your spell save DC (8 + prof + casting mod)); 1d6 on a fail, none on a save, plus 'mocked' on a fail.
• Healing Word ⚡ bonus action · level-1 spell · spends an L1+ slot — Restores 1d4 (+ casting mod) HP to an ally; can revive a downed ally. ⬆️ Upcast: +1d4 healing per slot level above 1.
• Inspiration level-1 spell · spends an L1+ slot — all allies gain 'blessed' for 3 rounds.
• Cutting Insult cantrip · at will — one enemy rolls a WIS save (your spell save DC (8 + prof + casting mod)); 1d8 on a fail, none on a save.
• Dissonant Whispers level-1 spell · spends an L1+ slot — one enemy rolls a WIS save (your spell save DC (8 + prof + casting mod)); 3d6 on a fail, none on a save. ⬆️ Upcast: +1d6 damage per slot level above 1.
• Frightful Aria level-2 spell · spends an L2+ slot — one enemy rolls a WIS save (your spell save DC (8 + prof + casting mod)) or is 'frightened' for 2 rounds.
• Thunderwave level-1 spell · spends an L1+ slot — all enemies each roll a CON save (your spell save DC (8 + prof + casting mod)); 2d8, half on a save. ⬆️ Upcast: +1d8 damage per slot level above 1.
• Hypnotic Pattern level-3 spell · spends an L3+ slot — one enemy rolls a WIS save (your spell save DC (8 + prof + casting mod)) or is 'stunned' for 3 rounds.
• Psychic Lance level-4 spell · spends an L4+ slot — one enemy rolls a INT save (your spell save DC (8 + prof + casting mod)); 7d6 on a fail, half on a save. ⬆️ Upcast: +1d6 damage per slot level above 4.
• Prismatic Blast level-5 spell · spends an L5+ slot — all enemies each roll a DEX save (your spell save DC (8 + prof + casting mod)); 7d6, half on a save. ⬆️ Upcast: +1d6 damage per slot level above 5.

Shared — any class can learn these

• Adrenaline Rush maneuver · 1 per rest — Restores 1d10 (+ casting mod) HP to yourself; can revive a downed ally.
• Improvised Throw maneuver · 2 per rest — Melee/finesse strike at one enemy: STR attack roll (can crit), 2d6 + STR mod damage on a hit.
• Battle Cry maneuver · 1 per rest — all allies gain 'blessed' for 3 rounds.
• Dirty Trick maneuver · 2 per rest — one enemy rolls a DEX save (your spell save DC (8 + prof + casting mod)) or is 'blinded' for 1 rounds.
• Field Medic maneuver · 2 per rest — Restores 2d4 (+ casting mod) HP to an ally; can revive a downed ally.
• Reckless Swing maneuver · 2 per rest — Melee/finesse strike at one enemy: STR attack roll (can crit), 2d10 + STR mod damage on a hit.
• Defensive Stance maneuver · 1 per rest — Restores 2d8 (+ casting mod) HP to yourself; can revive a downed ally.
• Hamstring maneuver · 2 per rest — one enemy rolls a DEX save (your spell save DC (8 + prof + casting mod)) or is 'restrained' for 1 rounds.

↑ Back to top

Combat

Combat begins when the party walks into a room with foes, or when someone runs /combat for a skirmish. Everyone rolls initiative (d20 + DEX) and takes turns in order; the bot posts a status board each round and, on your turn, a card of action buttons (typed commands work too).

↑ Back to top

The AI Dungeon Master

Optional, and off unless someone configures an AI provider. The golden rule never changes: the engine is the sole authority on what actually happens. The AI only proposes actions through a fixed set of tools; the engine validates, clamps every number to a level-appropriate band, refuses anything unsafe (it won't strand the party or mint an outcome you didn't earn), and reports the true result — which is what the AI then narrates.

↑ Back to top

Buffs & debuffs

Status effects abilities can inflict or grant. Advantage means roll the d20 twice and take the higher; disadvantage, the lower. "Skips turn" (incapacitated) means the creature can't act at all. Most last a few rounds or until a save ends them.

↑ Back to top