Dice Bot: Difference between revisions

From The Undead Archive
TheUnburied (talk | contribs)
Bureaucrats, Interface administrators, Administrators
289 edits
VisualWikitext
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..."
 
No edit summary
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
==Getting started==
==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


    3 ability level-ups
Starting skill level-ups cannot raise a skill above 3. Later level-ups can raise skills and abilities up to 10.
    5 skill level-ups
 
==Character Commands==
 
__TOC__
 
===/character create name:<name>===
 
:Creates a new character for you.
:If you create more than one character, use <code>/character list</code> to find the character ID, then use <code>/select id:<id></code> or <code>/character switch id:<id></code>.
 
===/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.


Starting skill level-ups cannot raise a skill above 3. Later level-ups can raise skills and abilities up to 10.
===/character rename name:<name>===
Character commands
/character create name:<name>


Creates a new character for you.
:Renames your selected character.


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 switch id:<id>===
/character list


Shows all of your characters, their IDs and which one is selected.
:Switches your active character.


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


Sets the image shown on your selected character sheet.
:Deletes one of your characters.
:Deleted characters cannot be recovered from inside Discord.


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


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


Switches your active character.
:Selects one of your characters as active.
/character delete id:<id>


Deletes one of your characters.
===/sheet or /character sheet===


Deleted characters cannot be recovered from inside Discord.
:Shows your active character sheet.
Selection and sheet commands
: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.
/select id:<id>


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


Shows your active character sheet.
===/roll stat:<ability-or-skill> mode:<normal|adv|dis> label:<optional-label>===


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.
:Rolls a d20 check for an ability or skill.
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:'''


Ability rolls use:
d20 + ability


d20 + ability
:'''Skill rolls use:'''


Skill rolls use:
d20 + parent ability + skill


d20 + parent ability + skill
:'''Examples:'''


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


/roll stat:Physique mode:normal
:The mode option is optional. If you leave it blank, the roll is 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:'''


Available modes:
normal: roll once
adv: advantage
dis: disadvantage


    normal: roll once
===/rollraw dice:<notation> label:<optional-label>===
    adv: advantage
    dis: disadvantage


/rollraw dice:<notation> label:<optional-label>
:Rolls free-form dice notation.


Rolls free-form dice notation.
:'''Examples:'''


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


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


/history
:Shows the last 10 rolls for your selected character.


Shows the last 10 rolls for your selected character.
==Resource Commands==
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.
/ap amount:<number>


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


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


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


Adjusts your selected character's stress.
:Adjusts your selected character's health.


When stress is maxed out, the bot rolls Morale and resets stress to 0.
===/movement amount:<number>===
/end


Ends your turn.
:Adjusts your selected character's movement.


This command:
===/stress amount:<number>===


    Applies end-turn effects
:Adjusts your selected character's stress.
    Reduces timed condition durations by 1 round
:When stress is maxed out, the bot rolls Morale and resets stress to 0.
    Removes expired timed conditions
    Resets AP to full
    Resets movement to full


Conditions
===/end===
/condition add name:<condition> time:<rounds>


Adds a condition to your selected character.
:Ends your turn.


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


Removes a condition from your selected character.
Applies end-turn effects
/condition list
Reduces timed condition durations by 1 round
Removes expired timed conditions
Resets AP to full
Resets movement to full


Lists active conditions on your selected character.
==[[Conditions]]==
Injuries
/injury add name:<injury>


Adds an injury to your selected character.
===/condition add name:<condition> time:<rounds>===


Some injuries automatically add persistent conditions.
:Adds a [[condition]] to your selected character.
/injury remove name:<injury>
:The time option is optional and defaults to 1 round.


Removes an injury from your selected character.
===/condition remove name:<condition>===


Any persistent conditions granted by that injury are also removed.
:Removes a condition from your selected character.
/injury list


Lists active injuries on your selected character.
===/condition list===
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.
:Lists active conditions on your selected character.


Examples:
==[[Injuries]]==


/advance stat:Physique
===/injury add name:<injury>===
/advance stat:Melee


Admin commands
: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.
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.
===/levelup user:<player> character_id:<id> type:<skill|ability> amount:<number>===
/setstat user:<player> character_id:<id> stat:<stat> value:<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.


Sets an ability or skill to a specific value.
==Tips==
Tips


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

Latest revision as of 22:29, 29 May 2026

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.
Retrieved from "https://www.theundeadarchive.com/index.php?title=Dice_Bot&oldid=319"