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
 
(3 intermediate revisions by the same user not shown)
Line 12: Line 12:


==Character Commands==
==Character Commands==
__TOC__


===/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 <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===
===/character list===
Line 58: Line 60:
: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
Line 74: Line 76:
: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
Line 80: Line 82:
  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
Line 96: Line 98:


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>
:Ends your turn.


Adds a condition to your selected character.
:'''This command:'''


The time option is optional and defaults to 1 round.
Applies end-turn effects
/condition remove name:<condition>
Reduces timed condition durations by 1 round
Removes expired timed conditions
Resets AP to full
Resets movement to full


Removes a condition from your selected character.
==[[Conditions]]==
/condition list


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


==Injuries==
:Adds a [[condition]] to your selected character.
:The time option is optional and defaults to 1 round.


/injury add name:<injury>
===/condition remove name:<condition>===


Adds an injury to your selected character.
:Removes a condition from your selected character.


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


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


Any persistent conditions granted by that injury are also removed.
==[[Injuries]]==
/injury list


Lists active injuries on your selected character.
===/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==
==Level-up Commands==


/advance stat:<ability-or-skill>
===/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 /sheet after creating or changing a character.
Use /character list when you forget a character ID.
    Pin a sheet message if you want the bot to keep that sheet updated.
Use /sheet after creating or changing a character.
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"