Syntax

Symbols and Expressions

• $ :

  • Usage: Represents the value of the statistic used in the dice formula.
  • Where? Used in dice types (/dbroll, /calc, critical formulas, etc.)
    Example

    • 1d6 > $: Compares the dice result to the selected statistic value.
    • 1d6 + $: Adds the statistic to the dice result.
    • 1d100 <=$: For systems like Call of Cthulhu, compares to the stat threshold.

• {exp} :

  • Usage: Allows inserting a dynamic expression into a dice formula, derived from a calculated part of the command.
  • Advanced Syntax: {exp||default} allows defining a default value if the expression is not provided.
    {exp||2} (default value = 2)
  • Where? Often used in templates or reusable formulas to inject a dynamic value at roll time.
    Example

    • 1d6 > {exp}: the value of exp will be replaced at roll time.
    • 1d6 > {exp||10}: if exp is not provided, the comparison is made to 10.

• {{...}} :

  • Usage: Delimits a complex mathematical expression evaluated by MathJS.
  • Where? In all commands supporting formulas (/calc, /dbroll, /dbd, etc.)
    Example

    • 1d6 + {{ceil($ / 2)}}: Adds the rounded half of the stat to the dice result.
    • 1d6 > {{ceil($ / 2)}}: The success threshold is half the stat, rounded.

• [comment] :

  • Usage: Adds a comment to a dice roll.
  • Where? In shared dice.
    1d20;&-2[HP Loss]: Applies -2 to the result of 1d20 and annotates the second line result.

• #comment :

  • Usage: Global comment for a dice roll. The # symbol can be omitted when used in direct messages.
  • Where? At the end of the dice roll, to annotate the action. Also allows creating a global comment in shared dice.
    Not used for dice via slash commands.
    Example

    • 1d20+5 # My dice roll
    • 1d20;&+5;&*2 # My shared dice roll

• &, ;&+x;, etc. :

  • Usage: Allows reusing the result of the same dice in multiple formulas (unique shared rolls).
    Example

    /roll 1d20;&+5;&*2

    Displays:

    ※ 1d20 ⟶ [14] =  14 
    ◈ [1d20]+5 ⟶ [14]+5 =  19 
    ◈ [1d20]×2 ⟶ [14]×2 =  28 

• () (parentheses in dice names) :

  • Usage: Specifies the statistic to use for custom criticals.
    Animal Instinct (Strength)

Example

• Dice type:
  • 1d6 > $ or 1d6 + $
  • 1d6 + {{ceil($/2)}}
• Saved dice:
  • 1d6 > Strength or 1d6 + Strength
  • 1d6 + {{ceil(Strength / 2)}}
• Custom critical:
  • Name: Animal Instinct (Strength)
  • Formula: >$ ($ will be replaced by the Strength value)
  • Result: 1d6>10 (if Strength = 10)

Commands syntax

• Mandatory fields are enclosed in square brackets: [fields].
• Optional fields are enclosed in brackets: (fields).
• Auto-complete fields are marked with a *: (*fields).
• Fields requiring a statement will be marked with @ (@fields). These fields work with names (role or user, depending on the command) or Discord IDs. If the entry doesn't appear immediately, start typing the beginning of the name for auto-completion.
• In a similar way, commands requesting a salon are preceded by # like #fields.
• True/false fields (true or false) are prefixed by ? (?fields).

Auto-complete commands

In several commands, it's possible to combine both a username and a character.

By default, the characters displayed in the list are those of the user who typed the command.

If you wish to display another player's characters, you must mention the player first.

Attention

Due to certain limitations of the Discord API, if you wish to change player, you must retype the entire command.

This function is extended to the /mj dbd command, as the dice listed will be based on the character, listed therefore from the player. In fact, by default, skills are listed from the player who made the command.