Dicecord

IMPORTANT NOTICE

Due to Heroku suspending services to Russian users after April 12th, Dicecord might be unavailable for an extended period of time. I will try to bring it back as soon as possible and maintain it in the meantime, but I can not guarantee that it will work. Sorry for the inconvenience.

---

Dicecord is a bot for the Discord instant messenger that is made to help dealing with various things that require randomization, such as dice rolls, card draws, etc.

Getting Started

Getting this bot on your Discord server is very easy: all you need to do in a normal situation is open this link and allow the bot to join a server you'll select in the page that you'll see there.

Prerequisites

Just remember that to do this, you would need to have the permission to invite users to the server you've selected, and for the bot to function properly, it would need to have the permission to read and write messages in the channel you want it to be at.

If you're not the owner or an administrator of the server you want Dicecord to join, you should ask the owner or an administrator to either invite it themselves, or to give you (and the bot) the required permissions.

Commands

All the commands this bot will respond to should be prefixed with the ! symbol (can be changed). The currently available commands are:

• !help — provides information about this bot. Add a command name to learn more about it, like !help roll.
• !roll (!r) — rolls dice, supports multiple types of dice rolls, multiple rolls, etc.
• !order (!o) — randomly re-orders a comma-separated list.
• !pick (!p) — picks a random item from a comma-separated list.
• !listDeckTypes (!ldt) — lists all existing deck types.
• !examineDeck (!ed) — shows a brief description of the requested type of deck (optionally can show the list of cards).
• !shuffle (!s) — shuffles a deck of cards of a specific type and saves it.
• !draw (!d) — draws the requested amount of cards from the saved deck.
• !deal — deals the requested amount of cards from the saved deck.
• !drawShuffled (!drsh) — draws the requested amount of cards from a fresh deck.
• !drawPrivate (!drpr) — draws the requested amount of cards from the saved deck and DMs them to you.
• !bbcode — returns the last message sent by this bot in BB-code (to be used for forums).
• !markdown (!md) — returns the last message sent by this bot in markdown code.
• !saveRoll (!sr) — saves a roll command for later use.
• !getSaved (!gs) — returns the text of a saved roll command.
• !rollSaved (!rs) — rolls a saved roll command.
• !setPrefix — sets the command prefix (! by default) this bot will use in this Guild, administrator-only!

Settings

See the settings page for details.

Changelog

See CHANGELOG.md for the information on specific version changes.

Built With

• discord.js — Discord API;
• discordbots API — API for posting to discordbots.org;
• auto-changelog — used to generate the changelog;
• underscore.js — helps managing objects and arrays;
• random — helps with randomization;
• Heroku PostGres — stores decks and prefixes.
• pg-promise — allows for much simpler and more convenient code for PostGres quieries.

Versioning

SemVer versioning is used for this project.

Authors

• Andrey Larionov - Initial work - ShooterAndy

Contributors

• Harry Pollard - Bug-fixing — meharryp

The full, up-to-date list of contributors.

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

• This very helpful article
• DiscordBotsList support server users
• Heroku for hosting this bot