Discord Bot Commands Reference

This is a complete reference for all Cipher Discord bot commands. All commands use Discord's slash command system - just type / in any channel where Cipher is present to see available commands.

Command Categories

• General Commands - Basic bot functionality
• Campaign Management - Create and manage campaigns
• Character Management - Create and manage characters
• Cipher AI - Interact with the AI Dungeon Master
• Dice Rolling - Roll dice and check results
• Session Management - Start, track, and end game sessions
• Combat - Initiative and combat tracking
• Lookup & Browse - Search D&D content
• DM Tools - DM-only utilities

General Commands

Commands for basic bot interaction and information.

/ping

Description: Check if the bot is responsive

Permissions: Everyone

Usage:

/ping

What it does: Returns the bot's current latency and confirms it's online.

Example Response:

Pong! Latency: 42ms

/info

Description: Display information about the bot

Permissions: Everyone

Usage:

/info

What it does: Shows bot version, server count, uptime, and useful links.

Example Response:

Cipher Bot Information Version: 2.0.1 Servers: 156 Uptime: 3 days, 5 hours Website | Documentation | Support

/help

Description: Get help with bot commands

Permissions: Everyone

Usage:

/help

What it does: Displays an organized list of all commands with brief descriptions.

/stats

Description: View bot and database statistics

Permissions: Everyone

Usage:

/stats

What it does: Shows detailed statistics about campaigns, characters, sessions, and AI usage.

Example Response:

Global Statistics Total Campaigns: 342 Total Characters: 1,247 Sessions This Week: 89 AI Hours Used (24h): 156 hours

Campaign Management

Commands for creating and managing D&D campaigns.

/select-campaign

Description: Select your active campaign for character creation

Permissions: Everyone

Usage:

/select-campaign

What it does: Opens an interactive menu to choose which campaign you want to interact with. This sets your "active campaign" context for character creation and other commands.

When to use: Before creating characters or when switching between campaigns.

/current-campaign

Description: Show your current campaign context

Permissions: Everyone

Usage:

/current-campaign

What it does: Displays details about your currently selected campaign including name, DM, players, and setting.

Example Response:

Current Campaign: The Lost Mines of Phandelver DM: @DungeonMaster Players: 5 active Setting: Forgotten Realms Session: #12 (Active)

/list-campaigns

Description: List all campaigns in this server

Permissions: Everyone

Usage:

/list-campaigns

What it does: Shows all campaigns running in the current Discord server with their DMs and player counts.

/view-campaign

Description: View detailed information about a specific campaign

Permissions: Everyone

Parameters:

• campaign_name (required): Name of the campaign to view

Usage:

/view-campaign campaign_name: The Lost Mines

What it does: Displays comprehensive campaign details including description, current session, active quests, and recent activity.

/campaign-members

Description: View all members of a campaign

Permissions: Everyone

Parameters:

• campaign_name (required): Name of the campaign

Usage:

/campaign-members campaign_name: The Lost Mines

What it does: Lists all players and their characters in the specified campaign.

Character Management

Commands for creating and managing your D&D characters.

/character-create

Description: Start the interactive character creation wizard

Permissions: Everyone

Usage:

/character-create

What it does: Launches a step-by-step character creation process:

1. Choose species (race)
2. Choose class
3. Select background
4. Roll/assign ability scores
5. Choose equipment
6. Add personality traits

Note: You must have an active campaign selected first (use /select-campaign).

/character-list

Description: View all your characters

Permissions: Everyone

Parameters:

• show_all (optional): Show characters from all campaigns (default: active campaign only)

Usage:

/character-list
/character-list show_all: True

What it does: Displays a list of your characters with their levels, classes, and campaigns.

Example Response:

Your Characters

1. Thorin Ironforge - Level 5 Fighter (The Lost Mines)
2. Aria Moonwhisper - Level 3 Wizard (Dragon Heist)
3. Kael Shadowstep - Level 7 Rogue (Curse of Strahd)

/character-sheet

Description: View a character's full sheet

Permissions: Everyone (own characters) / DM (any character)

Parameters:

• character_name (optional): Name of your character (opens selector if empty)

Usage:

/character-sheet
/character-sheet character_name: Thorin Ironforge

What it does: Displays a complete character sheet including:

• Ability scores and modifiers
• HP, AC, and saving throws
• Skills and proficiencies
• Spells (if applicable)
• Equipment and inventory
• Features and traits

/character-delete

Description: Delete one of your characters (cannot be undone!)

Permissions: Everyone (own characters)

Usage:

/character-delete

What it does: Opens a confirmation dialog to permanently delete a character. This action cannot be undone.

Warning: All character data, including session history, will be lost.

/character-update

Description: Update your character's information

Permissions: Everyone (own characters) / DM (any character)

Usage:

/character-update

What it does: Opens an interactive menu to update:

• HP (current/maximum)
• Level
• Experience points
• Equipment
• Spell slots
• Conditions

/character-set-active

Description: Set a character as your active character for Cipher

Permissions: Everyone

Usage:

/character-set-active

What it does: Designates which character Cipher should use when you interact with the AI. This character's personality and knowledge will influence how Cipher responds to you.

/character-link-campaign

Description: Link a character to a campaign

Permissions: Everyone (own characters) / DM

Usage:

/character-link-campaign

What it does: Allows you to add an existing character to a new campaign. Useful when:

• Bringing a character from another campaign
• Joining a new campaign mid-game
• Running the same character in multiple campaigns

/character-active

Description: View your currently active character(s)

Permissions: Everyone

Usage:

/character-active

What it does: Shows which character is active for Cipher interactions in the current campaign.

Cipher AI Commands

Commands for interacting with Cipher, the AI Dungeon Master.

/ask-cipher

Description: Ask Cipher any D&D question

Permissions: Everyone

Parameters:

• question (required): Your question for Cipher
• private (optional): Send response as an ephemeral message (default: false)

Usage:

/ask-cipher question: How does concentration work?
/ask-cipher question: What's a good backstory for a tiefling warlock? private: True

What it does: Uses Claude AI to answer D&D questions including:

• Rules clarifications
• Spell descriptions
• Character building advice
• Campaign ideas
• Lore questions

Note: Uses AI hours from your account.

/cipher-help

Description: Learn about Cipher and how to use AI DM features

Permissions: Everyone

Usage:

/cipher-help

What it does: Displays a guide to using Cipher's AI features effectively.

/cipher-clear-memory

Description: Clear Cipher's conversation memory for this channel

Permissions: DM only

Usage:

/cipher-clear-memory

What it does: Resets Cipher's conversational context for the current channel. Use this when:

• Starting a new campaign arc
• Cipher is referencing outdated information
• You want a fresh start

Warning: This removes recent conversation history but preserves campaign data.

/set-dm-character

Description: Enable private character conversations with Cipher in DMs

Permissions: Everyone

Usage:

/set-dm-character

What it does: Allows you to have private, in-character conversations with Cipher via Discord DMs. Great for:

• Character backstory development
• Private character decisions
• Solo roleplay

Dice Rolling

Commands for rolling dice with various modifiers and advantages.

/roll

Description: Roll dice with optional character modifiers

Permissions: Everyone

Parameters:

• dice (required): Dice notation (e.g., 1d20, 2d6+3, d100)
• skill (optional): Auto-apply skill modifier from active character
• private (optional): Roll privately (only you see result)

Usage:

/roll dice: 1d20+5
/roll dice: 2d6 skill: Athletics
/roll dice: 4d6 private: True

Supported Notation:

• 1d20 - Single d20
• 2d6+3 - 2d6 with +3 modifier
• 3d8-2 - 3d8 with -2 modifier
• d100 or 1d100 - Percentile dice

Example Response:

@Player rolls 1d20+5 [17] + 5 = 22

/advantage

Description: Roll with advantage (2d20, take highest)

Permissions: Everyone

Usage:

/advantage

What it does: Rolls 2d20 and automatically takes the higher result. Shows both rolls for transparency.

Example Response:

@Player rolls with ADVANTAGE [13] / [18] = 18 (higher result)

/disadvantage

Description: Roll with disadvantage (2d20, take lowest)

Permissions: Everyone

Usage:

/disadvantage

What it does: Rolls 2d20 and automatically takes the lower result. Shows both rolls for transparency.

Example Response:

@Player rolls with DISADVANTAGE [8] / [15] = 8 (lower result)

Session Management

Commands for starting, tracking, and ending game sessions.

/start-session

Description: Start a new game session

Permissions: DM only

Parameters:

• title (optional): Session title (e.g., "Into the Dragon's Lair")
• campaign_name (optional): Campaign name (uses active campaign if not specified)

Usage:

/start-session
/start-session title: The Tomb of Horrors

What it does:

1. Creates a new session record
2. Starts tracking AI hour usage
3. Marks participating characters
4. Begins session transcript recording

Note: Only one session can be active per campaign at a time.

/end-session

Description: End the current game session

Permissions: DM only

Parameters:

• summary (optional): Brief summary of what happened
• xp_awarded (optional): XP to award all participants

Usage:

/end-session
/end-session summary: Party defeated the dragon! xp_awarded: 1500

What it does:

1. Stops AI hour tracking
2. Generates AI-powered session summary
3. Awards XP (if specified)
4. Updates character sheets
5. Saves session transcript

Summary includes:

• Key events and highlights
• Character actions and achievements
• NPCs encountered
• Loot acquired
• Quest progress
• Next session hook

/mark-present

Description: Mark players as present in current session

Permissions: DM only

Usage:

/mark-present

What it does: Opens a checklist to mark which players attended the session. Used for:

• Attendance tracking
• XP distribution (if only present players get XP)
• Session analytics

/pause-session

Description: Pause the current game session

Permissions: DM only

Usage:

/pause-session

What it does: Temporarily pauses:

• AI hour tracking
• Session timer
• Transcript recording

Use this during breaks or when switching to out-of-character discussion.

/resume-session

Description: Resume a paused game session

Permissions: DM only

Usage:

/resume-session

What it does: Resumes AI tracking and recording after a pause.

/session-summary

Description: View current/recent session details

Permissions: Everyone

Usage:

/session-summary

What it does: Shows summary of the current or most recent session including:

• Duration
• Participants
• AI hours used
• Key events (if session has ended)

Combat Commands

Commands for managing combat encounters and initiative.

/initiative

Description: Roll initiative

Permissions: Everyone

Parameters:

• modifier (optional): Initiative modifier (e.g., +3)

Usage:

/initiative
/initiative modifier: 3

What it does: Rolls initiative (1d20 + modifier) and automatically adds you to the initiative tracker if combat is active.

Note: If your character has an initiative bonus, you can set it in your character sheet to auto-apply.

/combat-start

Description: Start a combat encounter

Permissions: DM only

Usage:

/combat-start

What it does:

1. Initiates combat tracking mode
2. Prompts all players to roll initiative
3. Creates initiative order
4. Starts tracking combat rounds

/combat-end

Description: End current combat

Permissions: DM only

Usage:

/combat-end

What it does:

1. Stops combat tracking
2. Generates combat summary (rounds, damage dealt, etc.)
3. Clears temporary effects/conditions
4. Returns to exploration mode

Lookup & Browse

Commands for searching and browsing D&D content.

/lookup

Description: Look up D&D rules, spells, monsters, or other content

Permissions: Everyone

Parameters:

• query (required): What to search for
• type (optional): Filter by content type (spell, monster, class, etc.)

Usage:

/lookup query: Fireball
/lookup query: Beholder type: monster
/lookup query: Sneak Attack type: feature

What it does: Searches the SRD database and returns detailed information about:

• Spells (description, level, components, range)
• Monsters (stat blocks, abilities, CR)
• Classes (features, proficiencies)
• Equipment (properties, cost, weight)
• Conditions (effects, duration)
• Rules (how mechanics work)

Example Response:

Fireball (3rd-level evocation) Casting Time: 1 action Range: 150 feet Components: V, S, M (a tiny ball of bat guano and sulfur) Duration: Instantaneous

A bright streak flashes from your pointing finger to a point you choose...

/browse

Description: Browse D&D content by category

Permissions: Everyone

Parameters:

• category (required): What category to browse (spells, monsters, classes, etc.)

Usage:

/browse category: Spells
/browse category: Monsters

What it does: Opens an interactive menu to browse all content in a category. You can filter by:

• Spells: Level, school, class
• Monsters: CR, type, size
• Classes: Role, complexity
• Equipment: Type, rarity

DM Tools

DM-only commands for managing the game.

/dm-notes

Description: Add private DM notes

Permissions: DM only

Parameters:

• note (required): Note to save

Usage:

/dm-notes note: Players suspect the mayor is evil

What it does: Saves private notes only you (the DM) can see. Notes are associated with the current campaign and can be viewed in Scrollbook.

Use cases:

• Track plot threads
• Remember NPC motivations
• Note player theories
• Plan future sessions

/dm-roll

Description: Roll dice secretly (only you see result)

Permissions: DM only

Parameters:

• dice (required): Dice to roll (e.g., 2d20+5)

Usage:

/dm-roll dice: 1d20+8

What it does: Rolls dice and sends the result as an ephemeral message (only visible to you). Perfect for:

• Secret checks (Stealth, Investigation)
• Hidden monster rolls
• Determining random events
• Maintaining suspense

/dm-npc

Description: Generate a quick NPC

Permissions: DM only

Usage:

/dm-npc

What it does: Uses AI to instantly generate a random NPC with:

• Name and species
• Personality traits
• Appearance
• Occupation
• Quirk or secret

Example:

Generated NPC Name: Eldrin Thornberry Species: Halfling Occupation: Tavern owner Personality: Jovial but secretive Quirk: Collects exotic spices, hides a smuggling operation Appearance: Round face, always flour-dusted, whistles while working

Tips & Best Practices

Command Shortcuts

Most commands have short names you can type quickly:

• /char autocompletes to /character-*
• /camp autocompletes to /campaign-*

Using Modifiers

When rolling dice, you can chain modifiers:

/roll dice: 1d20+3+2+1

This adds proficiency (+3), ability modifier (+2), and magic item (+1).

Private Rolls

Any dice command can be made private by adding private: True:

/roll dice: 1d20 private: True

Only you will see the result - not even the DM can see private rolls.

Campaign Context

Many commands work differently based on your active campaign:

• /character-list shows characters in your active campaign by default
• /ask-cipher uses your active campaign's lore and NPCs

Use /select-campaign to switch context.

DM vs Player Commands

Commands with these prefixes are DM-only:

• /dm-* - DM tools
• /combat-start, /combat-end - Combat management
• /start-session, /end-session - Session management

Troubleshooting

"Command not found"

Solution: Make sure you're typing / first. Discord's autocomplete will show available commands.

"You don't have permission"

Solution: This command requires DM permissions. Contact your campaign DM or use /current-campaign to verify your role.

"No active campaign"

Solution: Use /select-campaign to choose an active campaign before creating characters or using campaign-specific commands.

"Character not found"

Solution:

1. Verify spelling with /character-list
2. Make sure you're in the right campaign
3. The character may have been deleted

"AI hours depleted"

Solution: Your tier has run out of AI hours for this month. You can:

1. Purchase hour packs from scrollbook.app/pricing
2. Upgrade your tier
3. Wait until your next billing cycle

Need More Help?

• Full Documentation: scrollbook.app/docs
• Getting Started: 5-Minute Quickstart
• FAQ: Common Questions
• Discord Support: Join our community
• Contact Us: scrollbook.app/contact

Command Reference Version: 2.0.1 Last Updated: January 15, 2025