A Discord bot that specializes in rolling dice and calculating math.
Go to file
Ean Milligan e01097b1e3 improve loop log message 2025-08-06 14:45:07 -04:00
.bruno add api for getting statistics 2025-07-22 16:48:51 -04:00
.github/ISSUE_TEMPLATE messin with sonar setup 2022-05-20 04:00:34 -04:00
.vscode Add -yvariables decorator to allow repeat roll button to work consistently 2025-07-22 23:31:47 -04:00
db V4.1.0 - Add unrestricted repeat roll system. 2025-08-05 15:46:11 -04:00
docs V4.1.0 - Add unrestricted repeat roll system. 2025-08-05 15:46:11 -04:00
emojis Auto stash before merge of "master" and "origin/master" 2021-01-07 13:59:12 -05:00
src improve loop log message 2025-08-06 14:45:07 -04:00
www Add Roll Web View 2025-07-17 02:32:14 -04:00
.gitignore Add heatmap.png generator 2022-06-26 22:53:25 -04:00
.sonarcloud.properties remove exclusions for nonexistant files 2025-07-08 02:44:15 -04:00
CONTRIBUTING.md [untested] - start reorganizing the solver folder (renamed to artigen here), organize imports better since deno has support for it now 2025-05-01 17:56:06 -04:00
LICENSE Minor bug fixes and documentation completed 2021-01-08 01:02:38 -05:00
PRIVACY.md V4.1.0 - Add unrestricted repeat roll system. 2025-08-05 15:46:11 -04:00
README.md V4.1.1 ver bump 2025-08-05 16:53:02 -04:00
TERMS.md Documentation Update 2021-05-18 10:46:37 -04:00
artificer.rc remove mod.d.ts since all types have been relocated now 2025-05-03 20:53:17 -04:00
artificer.service remove mod.d.ts since all types have been relocated now 2025-05-03 20:53:17 -04:00
config.example.ts V4.1.1 ver bump 2025-08-05 16:53:02 -04:00
deno.json Implement slash commands for most things, some bugfixes and god knows what else 2025-07-22 01:19:20 -04:00
deno.lock Add Roll Web View 2025-07-17 02:32:14 -04:00
flags.ts [untested] whoops wasn't supposed to add that... 2025-05-01 18:01:54 -04:00
mod.ts remove command prompt, its never been used and its just legacy code that never got cleaned up 2025-07-08 02:36:59 -04:00
start.command remove mod.d.ts since all types have been relocated now 2025-05-03 20:53:17 -04:00
tsconfig.json Trying advice from colin@sonar 2022-05-20 11:29:09 -04:00

README.md

The Artificer - A Dice Rolling Discord Bot | V4.1.1 - 2025/08/05

SonarCloud
Maintainability Rating Security Rating Quality Gate Status Bugs Duplicated Lines (%) Lines of Code

The Artificer is a Discord bot that specializes in rolling dice. The bot utilizes the compact Roll20 formatting for ease of use and will correctly perform any needed math on the roll (limited to basic algebra).

This bot was developed to replace the Sidekick discord bot after it went offline many times for extended periods, and is now dead according to their GitHub. This was also developed to fix some annoyances that were found with Sidekick, specifically its vague error messages (such as "Tarantallegra!", what is that supposed to mean) and its inability to handle implicit multiplication (such as 4(12 + 20)).

Using The Artificer

I am hosting this bot for public use and you may find its invite link below. If you would like to host this bot yourself, details of how to do so are located here, but I do not recommend this unless you are experienced with running Discord bots.

After inviting the bot, if you would like it to remove the message requesting the popcat emoji, you will need to give the The Artificer role the Manage Messages permission. All other permissions needed are handled by the invite link.

Bot Invite Link

Support Server Invite Link


Problems? Feature requests?

If you run into any errors or problems with the bot, or think you have a good idea to add to the bot, please submit a new GitHub issue detailing it. If you don't have a GitHub account, a report command (detailed above) is provided for use in Discord.


Available Commands

Available commands are listed here.

API Details

API details are listed here.


Privacy Policy and Terms of Service

The Artificer has a Privacy Policy and Terms of Service to detail expectations of what user data is stored and how users should use The Artificer. The following Privacy Policy and Terms of Service only apply to the officially hosted version of The Artificer (The Artificer#8166, Discord ID: 789045930011656223).

Privacy Policy TL;DR:

  • If you use the report command, the text submitted will be stored for a short period of time.
  • If you use the Roll Alias System, any data submitted to it will be stored until you delete it.
  • If you use the API, submitted Discord Ids will be stored linked to your email.
  • If you use the Inline Roll System, Discord Guild Ids will be stored.
  • If you use the Opt Out System, Discord User Ids will be stored.

For more detailed information, please check out the full PRIVACY POLICY.

Terms of Service TL;DR: Don't abuse or attempt to hack/damage The Artificer or its API. If you do, you may be banned from use. For more detailed information, please check out the full TERMS OF SERVICE.


Built in memory of my Grandmother, Babka

With much love, Ean

December 21, 2020