Bogsy's Dice Bot: Shortcuts - ProfSamScott/bogsys-dice-bot GitHub Wiki

Shortcuts

WAIT!!! Read up on quickrolls and modifiers first. Getting to know those two topics will help put the power and limitations of shortcuts in context

Shortcut Basics (/shortcut, /roll)

attack == d20+str >= 5, 2d6+5 creates a new shortcut alias called attack. This alias belongs to the user who created it.

The double equal sign == makes this a shortcut command instead of a quickroll or modifier.

The Power of Shortcuts

A shortcut can store any roll, including multirolls, rolls with roll tags, success rolls, and so on.

The Limitations of Shortcuts

A shortcut can only be used on its own (for example, you can't say attack + 3 or attack.adv).

Note on Multiroll Shortcuts

Use the semicolon ; instead of a comma , for creating multiroll shortcuts.

  • For example, multi==d6;d8+1;d10 defines multi as a shortcut to a multiroll.
  • On the other hand, multi==d6,d8+1,d10 is a multiroll consisting of multi==d6, d8+1, and d10.

Shortcuts with Placeholders (/shortcut, /roll)

attack == d20+str >= %, 2d6+5 creates a shortcut with a placeholder % to be filled in Later. You can specify what goes in the '%' spot when you use the shortcut.

  • For example, attack %12 will run the attack shortcut with '12' filled in for the placeholder.

You can put any number of placeholders in a shortcut.

  • For example, attack == d20+str+% >= % contains two placeholders. Use it like this: attack %d4 %15

If you don't specify a value for a placeholder when using a shortcut, it will be filled with nothing.

  • For example attack == d20+str % can be used as attack, attack +5, attack -d4, etc.

Managing Shortcuts (/list, /group, /delete)

Use list to list shortcuts in the current group and server.

Use list ___ to search the list for something.

Use group ___ to switch to a new group.

Delete a shortcut by assigning nothing like this: attack==

Modify a shortcut by reassigning like this: attack == d20+3.adv

Note that a shortcut cannot have the same name as a quickroll, table, or modifier.

Next Topic

Tables

All Topics

basics, terminology, tags, modifiers, quickrolls, success, multirolls, shortcuts, tables, embeddings, groups, buttons, favorites, weird, 5e, fate, pbta, ars magica, blades in the dark, hack, bling, server, other, slash, contact