Talking in chat

Anything you type in the chat box without a / or @ prefix is normal table chatter — your party sees it, the Dungeon AI might react if it's something interesting (a kill, a crit, a scene change).

By design, the Dungeon AI is silent >95% of the time so it doesn't get annoying. If you want it to speak on demand, mention it directly:

Mentions are case-insensitive. @AI works too.

Slash commands

Slash commands run actual game mechanics — they're the way to roll dice, attack, heal, etc. They don't ask the AI for permission; they just execute and post the result to chat.

Most of these have buttons in the command bar above the chat input — use them as shortcuts.

Combat

Combat runs in 6 phases per round, in order:

1. Surprise — first round only, only the surprising side acts.
2. Mob Action Declaration — GM declares what mobs are attempting.
3. Crawler Reaction Phase — players can use reactions (interrupts, parries).
4. Mob Attack Resolution — mob attacks resolve. Use /damage N if you take a hit.
5. Crawler Action Phase — players act. Use /attack, /check, etc. You get 2 actions per round.
6. Clean Up — apply ongoing effects, then back to phase 2 for round +1.

Use /phase to advance. The phase bar in the Combat panel highlights the current phase.

Action economy: the panel shows actions remaining for each crawler. Each /attack spends one action.

Auto-end: when the last mob hits 0 HB, combat ends automatically and loot unlocks.

How to start combat: the GM (room creator) clicks Generate Encounter in the lobby panel. It spawns floor-appropriate mobs and a loot table.

Loot

When an encounter is generated, the loot drops appear in the Loot panel — but they're locked until all enemies are defeated. (We added this rule because Stockton tried to loot before killing the mushroom zombies. Lesson learned.)

You'll see a 🔒 "Defeat all enemies to claim loot" message and the Pick Up buttons will be greyed out until combat ends.

Once combat ends:

1. The Pick Up buttons go green and become clickable.
2. Clicking Pick Up adds the item to your character's Deep Inventory.
3. It's permanent and synced across all players.

If you really need to grab something mid-combat (boss puzzle, cursed item drop), use /endcombat to end combat manually. Or have the GM rule it.

Character Sheet

Click My Character in the top right. There are six tabs that mirror the official PDF:

• Identity — name, race, class, level, crawler number, the 5 stats (STR/INT/CON/DEX/CHA), HB track.
• Combat — evade, DR, move, step, AI Favor, mana, your attacks list (this is what /attack uses).
• Skills — your skills with ranks and governing stats (this is what /check uses).
• Inventory — Hotlist (10 items), Deep Inventory (unlimited), gear slots (head/torso/arms/hands/legs/feet), accessories.
• RP & Bio — sponsors, popularity, trauma, regrets, backstory, notes, personal space.
• ✨ AI Assistant — see next page.

Stat modifiers: use the standard d20 formula floor((unenhanced - 10) / 2). Enter unenhanced + enhanced; the mod field is yours to set or you can ask the AI Assistant to recalc it.

HB track: click the slot circles at the top of the Identity tab to toggle damage. Or use /damage and /heal in chat.

Save: hit the green Save Character button at the bottom. Saves are synced to your room instantly.

✨ AI Sheet Assistant

The character sheet has a lot of fields. Filling them all by hand is tedious. The AI Assistant lets you describe what you want in plain English and drafts the changes for you.

How it works:

1. Open My Character → click the ✨ AI Assistant tab.
2. Type what you want, e.g. "Add a fire sword that does 2d6+3 damage, +5 to hit".
3. Click Generate Draft. The AI proposes a JSON patch.
4. Review the explanation, the warnings, and the JSON itself. Edit it if you want — it's just a textarea.
5. Click ✅ Approve & Apply to merge the patch into your sheet, or ❌ Discard to throw it away.

What it can do:

• Add or modify attacks (with proper to-hit and damage formatting).
• Add or modify skills (with the right governing stat).
• Adjust stats and recalculate modifiers.
• Add items to your Hotlist, Deep Inventory, Accessories, or Gear slots.
• Set your backstory, sponsors, popularity, trauma, etc.
• Bump level, HB max, mana, etc.

What it won't do: the AI is a drafter, not an authority. It never applies changes without your approval. It will list its assumptions in the warnings section so you can sanity-check.

Tip: when adding to a list (skills, attacks, inventory), the AI is instructed to preserve your existing entries. But always glance at the JSON — if you see your old skills missing, edit them back in before approving.

Tips & FAQ

Q: The AI never speaks.
By design, it stays quiet 95% of the time. If you want narration, type @ai followed by what you want it to react to.

Q: My attack says "No attack configured".
You haven't added any attacks to your sheet yet. Open My Character → Combat tab and add at least one. Or use the AI Assistant: "Add a basic punch attack, 1d4+0 damage".

Q: My check says "Skill not found".
The skill name has to match what's in your sheet. Try /check STR 12 for a raw stat check instead.

Q: I want to GM, not play.
The room creator is the GM. Only the GM can generate encounters. We're building dedicated GM tools in v0.8.0.

Q: Can I bring my character to other rooms?
Not yet. Each room has its own party. Cross-room characters are coming in v1.0.

Q: The AI suggested something weird.
It's a draft. Edit the JSON before approving, or click Discard. Nothing changes without your green-light.

Q: Where's voice / TTS?
v0.9.0. Deepgram + ElevenLabs are scaffolded but not wired yet.

Built with way too much chaos. Roll well, crawler.