Dice Bot: Difference between revisions
TheUnburied (talk | contribs) No edit summary |
TheUnburied (talk | contribs) No edit summary |
||
| Line 1: | Line 1: | ||
==Getting | ==Getting Started== | ||
#Create your character with <code>/character create name:<name></code> | #Create your character with <code>/character create name:<name></code> | ||
#Use <code>/character sheet</code> or <code>/sheet</code> to view your character sheet | #Use <code>/character sheet</code> or <code>/sheet</code> to view your character sheet | ||
| Line 5: | Line 5: | ||
#Roll checks with /roll. | #Roll checks with /roll. | ||
New characters start with: | '''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. | Starting skill level-ups cannot raise a skill above 3. Later level-ups can raise skills and abilities up to 10. | ||
| Line 14: | Line 13: | ||
==Character Commands== | ==Character Commands== | ||
/character create name:<name> | ===/character create name:<name>=== | ||
:Creates a new character for you. | |||
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>. | 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>. | ||
Revision as of 21:34, 29 May 2026
Getting Started
- Create your character with
/character create name:<name> - Use
/character sheetor/sheetto view your character sheet - Spend your starting level-ups with
/advance stat:<ability-or-skill> - 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.
