Dice Bot

Getting started

1. Create your character with /character create name:<name>
2. Use /character sheet or /sheet to view your character sheet
3. Spend your starting level-ups with /advance stat:<ability-or-skill>
4. Roll checks with /roll.

New characters start with:

   3 ability level-ups
   5 skill level-ups

Starting skill level-ups cannot raise a skill above 3. Later level-ups can raise skills and abilities up to 10.

Character Commands

/character create name:<name>

Creates a new character for you.

If you create more than one character, use /character list to find the character ID, then use /select id:<id> or /character switch id:<id>. /character list

Shows all of your characters, their IDs and which one is selected.

Use the listed ID when selecting, switching, or deleting a character. /character image link:<image-link>

Sets the image shown on your selected character sheet.

The link must start with http:// or https://. Direct image links work best. /character rename name:<name>

Renames your selected character. /character switch id:<id>

Switches your active character. /character delete id:<id>

Deletes one of your characters.

Deleted characters cannot be recovered from inside Discord.

Selection and Sheet Commands

/select id:<id>

Selects one of your characters as active. /sheet or /character sheet

Shows your active character sheet.

When a sheet message is pinned, the bot remembers it and automatically updates it when visible sheet values change, including resources, derived traits, conditions, injuries, images, renames, and level-up changes.

Rolling Commands

/roll stat:<ability-or-skill> mode:<normal|adv|dis> label:<optional-label>

Rolls a d20 check for an ability or skill.

Ability rolls use:

d20 + ability

Skill rolls use:

d20 + parent ability + skill

Examples:

/roll stat:Physique mode:normal /roll stat:Melee mode:adv label:Knife attack /roll stat:Stealth mode:dis label:Sneak past guard

The mode option is optional. If you leave it blank, the roll is normal.

Available modes:

   normal: roll once
   adv: advantage
   dis: disadvantage

/rollraw dice:<notation> label:<optional-label>

Rolls free-form dice notation.

Examples:

/rollraw dice:2d6+3 /rollraw dice:d20 label:Luck roll

/history

Shows the last 10 rolls for your selected character.

Resource Commands

Use positive numbers to add resources and negative numbers to spend, lose, or take damage. /ap amount:<number>

Adjusts your selected character's AP. /hp amount:<number>

Adjusts your selected character's health. /movement amount:<number>

Adjusts your selected character's movement. /stress amount:<number>

Adjusts your selected character's stress.

When stress is maxed out, the bot rolls Morale and resets stress to 0. /end

Ends your turn.

This command:

   Applies end-turn effects
   Reduces timed condition durations by 1 round
   Removes expired timed conditions
   Resets AP to full
   Resets movement to full

Conditions

/condition add name:<condition> time:<rounds>

Adds a condition to your selected character.

The time option is optional and defaults to 1 round. /condition remove name:<condition>

Removes a condition from your selected character. /condition list

Lists active conditions on your selected character.

Injuries

/injury add name:<injury>

Adds an injury to your selected character.

Some injuries automatically add persistent conditions. /injury remove name:<injury>

Removes an injury from your selected character.

Any persistent conditions granted by that injury are also removed. /injury list

Lists active injuries on your selected character.

Level-up Commands

/advance stat:<ability-or-skill>

Spends one pending ability or skill level-up. Choose the ability or skill from the single stat option, similar to /roll.

Examples:

/advance stat:Physique /advance stat:Melee

Admin Commands

These commands require admin or moderator permissions. /levelup user:<player> character_id:<id> type:<skill|ability> amount:<number>

Grants pending level-ups to a character. /setstat user:<player> character_id:<id> stat:<stat> value:<number>

Sets an ability or skill to a specific value.

Tips

   Use /character list when you forget a character ID.
   Use /sheet after creating or changing a character.
   Pin a sheet message if you want the bot to keep that sheet updated.