roll 1.0.1

an Abbot package for Discord by Snails & Smallclothes

Provides some common dice rolling functions.

Abbot is a programmable bot that turns your team chat into a shared command center. We handle all the boilerplate of building and running these conmmands so that you can focus on making tools that help you ship faster.

We built Abbot because we saw the power of this style of work (called ChatOps), when we worked at GitHub. ChatOps made it possible for GitHub to work productively without meetings, while globally distributed. We think it's a pretty great way to work, so we made it easy to use in Slack, Discord, and Microsoft Teams.

You can read more about Abbot here, check out our blog, or take a look at some of the other cool packages available as a one-click install from Abbot's Package Directory.

module.exports.Roll = (async () => {

  function roll(die, qty = 1, mod = 0) {
    let rolls = []
    let total = Number(mod)
    
    for (let i = 0; i < qty; i++) {
      let result = Math.floor(Math.random() * die) + 1
      total += result
      rolls.push(result)
    }
    
    return { total, rolls }
  }
  
  function buildMessage(total, rolls) {
    return `rolled a ${total} (${rolls.join(', ')})`
  }

  let matcher = /(\d+)?d(\d+)([\+\-]\d+)?/i
  let matches = bot.arguments.match(matcher)
  
  if (matches == null) {
    bot.reply('Hmm...I\'m not sure that\'s how you roll. Try something like `d8` or `3d6-1`. 🎲')
    return
  }

  try {
    let [ , qty, die, mod ] = matches

    if (qty > 50) {
      bot.reply('Sorry: I can\'t roll that many dice at once. Here\'s the first 50, though: 😅')
      qty = 50
    }

    let result = roll(die, qty, mod)
    bot.reply(buildMessage(result.total, result.rolls))
  } catch(ex) {
    bot.reply('Egads! Something unexpected happened. 😖')
  }

})();

Version	Created	Author	Release Notes	Installs
1.0.1	2/11/2021	Kelzyr	Thanks to some of our chaotic evil users, we've added guard rails to make sure rolls don't get out of hand. Oh, and we fixed negative modifiers, so rolls like `1d4-2` work correctly now! Happy rolling!	11
1.0.0	2/11/2021	Kelzyr	This is the first version of the `roll` package! We're still getting things ready for everyone's use, but we'd love for you to try it out!	0

Sign in to add this to Discord You need an account to install this package with Abbot. Signing in with Discord will create an account if you don't have one already.

Not using Discord? No worries! Abbot works in Slack, Discord, and Microsoft Teams.

It's free to get started!

Details

Last updated: Thursday, 11 February 2021 17:28
Installs: 11 total installs
Language: JavaScript
License: MIT License

?	Display shortcuts
Cmd+K	Display shortcuts when a form input has focus.
t	Jump to skill
ctrl+t	Jump to skill when a form input has focus.
Esc	Dismiss modal. Also used to remove focus from a text input to enable keyboard shortcut.
g m	Go to the My Bot page
g s	Go to the skills list
g p	Go to the package directory
g a	Go to the About page
g d	Go to the Docs site
g l	Go to Activity Log

About Abbot

README

Usage

Code

Version History

Details

Keyboard Shortcuts

Jump to Skill