Player Guide

What is CSMS?

CSMS is a script running behind the scenes in your AI Dungeon adventure. It gives your character a proper stat sheet — like a D&D character card — and makes sure the AI always knows your character's abilities when making decisions about your story.

You don't need to understand how it works. You just need to know how to use it.

Your Character Sheet

Your character sheet lives in the Story Cards panel (the icon that looks like stacked cards). Look for a card with a 📋 emoji at the start of the title — that's yours.

It looks like this:

Name: Nikolai | Level: 3 | XP: 450
HP: 18/20 | AC: 15 | Speed: 30ft
Proficiency: +2

STR: 15 (+2)  DEX: 12 (+1)  CON: 14 (+2)
INT: 10 (+0)  WIS: 11 (+0)  CHA: 13 (+1)

The AI sees this card when writing your story. If your STR is 18, the AI knows you're incredibly strong. If your HP is low, the AI knows you're in danger.

Creating Your Character

Your sheet is created automatically when you set your name. Open the player menu — the fire icon at the top left of the screen — and change your name from You to your character's name. On the next action, your sheet appears. This works in both single player and multiplayer.

If you prefer to create it manually instead:

/csms create/YourName
/csms create/John Smith

Full names work. /csms create/John Smith creates a character named John Smith. Just be consistent — always type the name exactly the same way when using commands later.

Editing Your Stats

You can change any value on your sheet directly. Open the Story Cards panel, find your 📋 card, and click to edit it. Change any number you want, then just keep playing — the script reads your changes on the next action automatically.

Want it to update right now? Type /csms update/stats/YourName and your sheet syncs immediately.

Warning: If you type something that isn't a valid number, the script will reject that value and keep the old one. You'll see a notification telling you what was rejected.

What the Stats Mean

CSMS uses D&D 5e as its foundation, but your world maker may interpret these differently. In general:

Stat	What it affects
STR	Physical power, melee attacks, carrying capacity
DEX	Agility, ranged attacks, stealth, reflexes
CON	Endurance, health, resistance to pain
INT	Knowledge, memory, reasoning, magic (sometimes)
WIS	Perception, intuition, willpower
CHA	Persuasion, deception, social influence
HP	How much damage you can take before going down
AC	How hard you are to hit

The number in brackets after each stat (like +2 or -1) is your modifier — this is what actually gets applied to rolls and checks.

XP and Leveling

If your world maker has leveling enabled, your character earns XP automatically through play — no tracking needed. XP is awarded for taking actions, rolling dice, dealing and receiving damage, executing Ordinances, learning, and landing killing blows.

When you level up, your max HP increases and you receive Development Points (DP). Spend them on the stats that matter to your build:

/csms dp/check              — see your available DP and current stats
/csms dp/STR:2,DEX:1        — spend DP across stats in one command

Unspent DP carries over — no pressure to spend immediately.

Action Commands

Some actions trigger mechanics automatically. Add an act_ prefix before the action in your input — the prefix is stripped before the AI ever sees it, so the story reads naturally:

What you type	What happens
act_rest	Recover HP
act_eat, act_drink, act_consume	Consume something — restores HP
act_read, act_study, act_observe	Learn something — awards XP

I find a quiet corner and act_rest until morning.
I sit down and act_eat the bread from my pack.
I spend an hour act_reading the ancient tome.

Inventory

If inventory is enabled, you can pick up, drop, give, and throw items using the same act_ system:

What you type	What happens
act_take / act_grab	Pick up an item
act_drop / act_discard	Remove an item from your inventory
act_give / act_hand	Transfer an item to another character
act_throw / act_hurl	Throw an item, optional target

I walk over and act_grab the briefcase.
act_give the documents to Sarah.
I act_drop the wallet on the floor.
I turn and act_throw the bottle at the guard.

Always use the character's name — never pronouns. act_give her the files will fail. act_give files to Sarah works. You can only give to or take from characters with a 📋 sheet.

See the full Inventory guide for rules and tips.

Messages From CSMS

CSMS communicates with you using two formats. Both are visible to you and the AI — but the AI reads them as instructions rather than story content, so they never bleed into the narrative.

[Brackets] — notifications

The AI treats content in [brackets] as writing annotations — meta-notes about the story, not part of it. CSMS uses this to send you information: sheet updates, level ups, rejected values, inventory changes:

[!NOTIFICATION!
Nikolai leveled up to Level 4! Max HP increased to 22. You have 3 DP to spend.]

OOC: — process steps

The AI treats ## as a direct instruction — a rule it must follow. CSMS uses this during active Ordinance and roll sequences to guide the AI through each step. You see these as OOC: messages, which tell you what's happening and prompt you to press Continue:

OOC: Rolling for "Flashing Shadow"... 1d20+DEX = [14] + DEX(+2) = 16. Press Continue to resolve.

Re-running a command

When you type a command, CSMS processes it the moment you submit your input — before the AI generates anything. If you delete only the AI's response and press Continue, the command won't fire again, because Continue skips the input step entirely and goes straight to generating a new response.

To re-run a command, you need to delete both the AI's response and your original input, then retype your command and submit again.

Commands Cheat Sheet

Command	What it does
/csms create/Name	Create a new character sheet
/csms check/Name	Refresh a character sheet display
/csms update/stats/Name	Force sync your card edits to state right now
/csms dp/check	See your available DP and current stats
/csms dp/STR:2,INT:1	Spend DP across stats
/csms reset/pending	Clear a stuck Ordinance or roll process

Frequently Asked Questions

My sheet disappeared. What do I do?

Type /csms check/YourName to refresh it. If it's truly gone, type /csms create/YourName to recreate it — your stats will reset to defaults, so you'll need to edit them back.

Can I set my stats to whatever I want?

Yes — CSMS doesn't judge. The world maker may have set a maximum value (default is 50), but within that range you're free to set anything. Whether the AI respects those stats in the story is up to the world maker's scenario design.

My stat edit isn't sticking. Why?

Check that you entered a plain number — no letters, symbols, or spaces. If you get a notification saying a value was rejected, the old value was kept. Also make sure the card structure wasn't accidentally broken — the script reads values by position, so the format needs to stay intact.

I see "STR:10 DEX:10..." appear in the story text. Is that a bug?

This can happen if the tag system is generating a character sheet and something interrupted the process. It should only happen once and won't affect your story. Just keep playing.

I'm stuck mid-Ordinance and nothing's moving. What do I do?

Type /csms reset/pending to clear the stuck process. Then retype your Ordinance command and try again.