AI Dungeon Scripting System

Character Sheet &
Mechanics System

The AI handles judgment.
The script handles consistency.

v2.0.0 — Combat, Progression & Action System
📋 Nikolai
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)

Not a rules engine.
A narrative foundation.

Most stat systems for AI Dungeon try to simulate a TTRPG. They tell the AI what to do, hardcode outcomes, and fight against the AI's creativity.

CSMS takes the opposite approach. It gives the AI just enough mechanical context to make decisions feel earned — and then gets out of the way.

Every module is independent — use only what fits your adventure. Don't need leveling? Turn it off. Only want character sheets and dice? That works too. And when you want to tweak the numbers, the built-in config card lets you change everything live inside the game — no script editing, no computer required.

Other systems
  • Script decides outcomes
  • Hardcoded rules
  • Player vs numbers
  • Combat focused
  • Single character only
  • Fixed ruleset
vs
CSMS
  • AI decides outcomes
  • Flexible narrative mechanics
  • Player vs story
  • Story focused
  • Multi-character + NPCs
  • Designed to be extended

Everything you need.
Nothing you don't.

📋

Character Sheets

Dynamic story cards for every character — player and NPCs. Always visible, always in sync with your adventure.

✏️

Editable Stats

Edit values directly in the story card. Script validates, corrects errors, and rewrites cleanly. No commands needed.

🏷️

Tag System

Add [CSMS] to any card. When that character appears in your story, a sheet is auto-generated from the description.

👥

Multiplayer Ready

Sheets auto-create when players join. Active player detection. Name change sync. Works out of the box.

⚔️

Ordinance System

The core of CSMS. World makers write rules in plain language — combat techniques, signature moves, faction mechanics, anything. The AI interprets them. The script executes the numbers. Mechanics finally have real weight.

🎒

Inventory System

Natural language item management — pick up, drop, give, throw. No commands, no clutter. Just type what your character does.

⬆️

Leveling & Progression

XP awarded automatically through play. Level up increases HP and awards Development Points — spend them on stats you choose.

🎯

Action System

Rest, eat, drink, study — natural act_ commands trigger mechanics without breaking the story. The AI narrates, the script tracks.

🔧

Debug UI

Built-in debug card for world makers. Persistent log, live config overrides, and command console — all inside the game.

Quick Start

Up and running
in 5 minutes.

01

Copy the Scripts

Grab the files from the GitHub repo and paste them into your scenario's script tabs:

02

Configure (Optional)

On first action, a ⚙️ CSMS CFG card appears in your Story Cards. Edit it anytime to toggle modules, adjust XP rates, change heal values — all live, no script editing required.

03

Create a Character

If you added the Third Person plot component, your sheet is created automatically when you set your name. Otherwise, type /csms create/YourName to create it manually.

04

Play

That's it. The AI now knows your stats. Edit the card anytime. The script keeps everything in sync.

Full World Maker Guide Player Guide

Plays well with others.

CSMS is designed to run alongside other popular AID scripts without conflict.

Inner Self ✓ Compatible

Same architecture pattern. State namespaced to avoid conflicts.

Auto-Cards ✓ Compatible

CSMS cards use unique keys. Tag system works with AC-generated cards.

Third Person ✓ Compatible

Full multiplayer support built in. Add Third Person plot component and go.