Dice Bot: Difference between revisions

From The Undead Archive
← Older edit
TheUnburied (talk | contribs)
Bureaucrats, Interface administrators, Administrators
289 edits
VisualWikitext
No edit summary
No edit summary
 
(8 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==


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


==Commands==
===/character create name:<name>===
===Character Commands===


/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>.


Creates a new character for you.
===/character list===


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>.
:Shows all of your characters, their IDs and which one is selected.
/character list
:Use the listed ID when selecting, switching, or deleting a character.


Shows all of your characters, their IDs and which one is selected.
===/character image link:<image-link>===


Use the listed ID when selecting, switching, or deleting a character.
:Sets the image shown on your selected character sheet.
/character image link:<image-link>
:The link must start with http:// or https://. Direct image links work best.


Sets the image shown on your selected character sheet.
===/character rename name:<name>===


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


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


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


Deletes one of your characters.
===/character delete id:<id>===


Deleted characters cannot be recovered from inside Discord.
:Deletes one of your characters.
:Deleted characters cannot be recovered from inside Discord.


==Selection and Sheet Commands==
==Selection and Sheet Commands==


/select id:<id>
===/select id:<id>===


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


Shows your active character sheet.
===/sheet or /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.
: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===
==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>===


Rolls a d20 check for an ability or skill.
: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:Physique mode:normal
/roll stat:Melee mode:adv label:Knife attack
/roll stat:Melee mode:adv label:Knife attack
/roll stat:Stealth mode:dis label:Sneak past guard
/roll stat:Stealth mode:dis label:Sneak past guard


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


Available modes:
:'''Available modes:'''


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


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


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


Examples:
:'''Examples:'''


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


/history
===/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 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:'''


Adjusts your selected character's health.
Applies end-turn effects
/movement amount:<number>
Reduces timed condition durations by 1 round
Removes expired timed conditions
Resets AP to full
Resets movement to full


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


Adjusts your selected character's stress.
===/condition add name:<condition> time:<rounds>===


When stress is maxed out, the bot rolls Morale and resets stress to 0.
:Adds a [[condition]] to your selected character.
/end
:The time option is optional and defaults to 1 round.


Ends your turn.
===/condition remove name:<condition>===


This command:
: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


Conditions
:Lists active conditions on your selected character.
/condition add name:<condition> time:<rounds>


Adds a condition to your selected character.
==[[Injuries]]==


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


Removes a condition from your selected character.
:Adds an [[injury]] to your selected character.
/condition list
:Some injuries automatically add persistent conditions.


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


Adds an injury to your selected character.
:Removes an injury from your selected character.
:Any persistent conditions granted by that injury are also removed.


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


Removes an injury from your selected character.
:Lists active injuries on your selected character.


Any persistent conditions granted by that injury are also removed.
==Level-up Commands==
/injury list


Lists active injuries on your selected character.
===/advance stat:<ability-or-skill>===
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.
:Spends one pending ability or skill level-up. Choose the ability or skill from the single stat option, similar to /roll.


Examples:
:'''Examples:'''


/advance stat:Physique
/advance stat:Physique
/advance stat:Melee
/advance stat:Melee


Admin commands
==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"