Dicecord

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 need to have permission to invite users to the server you've selected, and for the bot to function properly, it would need to have permissions to read and write the messages in the channel you want it to reply at.

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

Commands

All the commands this bot responds to should be prefixed with the ! symbol. 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.
• !shuffle (!s) — shuffles a standard deck of 54 cards.
• !draw (!d) — draws the requested amount of cards from the deck.
• !drawshuffled (!drsh) — allows you to draw a number of cards from a freshly shuffled deck.
• !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.
• !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 information on versions.

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.

Versioning

SemVer versioning is used for this project.

Authors

• Andrey Larionov - Initial work - ShooterAndy

See also the list of contributors who participated in this project.

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