Dicebag is a Discord bot for rolling dice using dice notation, with few additional commands useful for role-playing groups. Please see the GreenImp/rpg-dice-roller readme for more information about supported notation.
Dicebag requires Node.js and npm.
Clone this repository or copy the dicebag directory to your machine.
Open a terminal in the dicebag directory and run the following command:
npm installCreate a file named config.json containing the following.
Replace your-token-goes-here with your own Discord bot's token.
{
"prefix": "$",
"token": "your-token-goes-here"
}Create an SQLite3 database file named database.sqlite3.
Use the database.sql file to create the two nessecary tables.
If you are unfamiliar with SQLite3, I highly recommend DB Browser for SQLite.
Open a terminal in the dicebag directory and run the following command.
Closing the terminal window or killing the process will cause the bot to stop running.
node login.jsOpen a terminal in the dicebag directory and run the following command.
This will cause the bot to logout, even if it's running from another machine.
nodejs logout.jsIn the /etc/init.d directory, create a file called dicebag-login containing the following:
#!/bin/sh
nohup nodejs ~/dicebag/login.js 2>/dev/null &Run the following command:
sudo chmod 755 /etc/init.d/dicebag-loginDicebag's timezone-related functions expect full timezone names (example: America/New_York). A list of timezone names can be found here.
Be sure to include the prefix directly before the command (default: $).
| Command | Description |
|---|---|
| help | Sends the user a private message listing all available commands. |
| help command-name | Sends the user a private message with info about a specific command. |
| roll dice-notation | Performs the requested dice rolls, and returns the results. |
| server_timezone timezone-1 timezone-2... | Server owner only. Configure the current server's timezones. |
| timezone timezone-name | Configure your local timezone. |
| time local-time | Convert a local time to each of the server's configured timezones. |
The Dicebag bot's avatar was created by Ahkâm (freeiconspng.com).