Dice Bot: Difference between revisions
TheUnburied (talk | contribs) Created page with "==Getting started== #Create your character with <code>/character create name:<name></code> #Use <code>/character sheet</code> or <code>/sheet</code> to view your character sheet #Spend your starting level-ups with <code>/advance stat:<ability-or-skill></code> #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. Ch..." |
TheUnburied (talk | contribs) No edit summary |
||
| Line 11: | Line 11: | ||
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. | ||
Character | |||
==Commands== | |||
===Character Commands=== | |||
/character create name:<name> | /character create name:<name> | ||
| Line 38: | Line 41: | ||
Deleted characters cannot be recovered from inside Discord. | Deleted characters cannot be recovered from inside Discord. | ||
Selection and | |||
==Selection and Sheet Commands== | |||
/select id:<id> | /select id:<id> | ||
| Line 47: | Line 52: | ||
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. | 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 | |||
===Rolling Commands=== | |||
/roll stat:<ability-or-skill> mode:<normal|adv|dis> label:<optional-label> | /roll stat:<ability-or-skill> mode:<normal|adv|dis> label:<optional-label> | ||
| Line 86: | Line 93: | ||
Shows the last 10 rolls for your selected character. | Shows the last 10 rolls for your selected character. | ||
Resource | |||
===Resource Commands=== | |||
Use positive numbers to add resources and negative numbers to spend, lose, or take damage. | Use positive numbers to add resources and negative numbers to spend, lose, or take damage. | ||
Revision as of 21:26, 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.
Commands
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.
