RPG Schedule

A discord bot for posting game announcements for RPGs. Features include:

• Web interface for posting and editing game announcements
• Automated or manual sign ups and automated waitlisting
• Automated rescheduling (daily, weekly, biweekly, or monthly)
• Automated reminders
• RSS Feed

Note: Games are automatically pruned 48 - 72 hours after the scheduled time. Or you can delete them manually.

Screenshots

Inviting the discord bot

You can invite the discord bot to your server with the following link:

https://www.rpg-schedule.com/

Command List

Command	Default	Description
General Commands
!schedule		Displays the help menu
!schedule help		Displays the help menu
General Configuration
!schedule configuration		Get the bot configuration
!schedule role role name	All Roles	Assign a role as a prerequisite for posting games
!schedule manager-role role name	Server Admins	Assign a role to allow managing all server games
!schedule password password	disabled	Configure a password for posting games
!schedule password		Remove the password
!schedule lang en	en (English)	Set the bot's language.
Bot Configuration
!schedule embeds on/off	on	Use discord embeds for announcements
!schedule embed-color color	#2196f3	Set a discord embed color. Can be a color name like red or a hexadecimal color like #2196f3
!schedule embed-user-tags on/off	off	Include user tags in announcement embeds (Can occasionally glitch)
!schedule embed-user-tags-above on/off	on	Add mentions above the embed. Unlike user tags inside the embed, user tags outside the embed will trigger a notification and highlight the post.
!schedule emoji-sign-up ➕	➕	Set the emoji used for automated sign up
!schedule emoji-drop-out ➖	➖	Set the emoji used for automated sign up
!schedule toggle-drop-out	Off	Enable/disable the ability for players to drop out
!schedule prefix-char ?	!	Set the prefix character for sending bot commands
Game Configuration
!schedule add-channel #channel-name	first text channel	Add a channel where games are posted (recommended)
!schedule remove-channel #channel-name		Remove a channel where games are posted
!schedule pruning on/off	off	Automatically delete old game announcements. As noted above, games over 48 hours past their scheduled date are automatically pruned from the database. However, by default the announcements are not.
!schedule private-reminders	Off	Toggle whether the game reminders are sent to private messages.
!schedule reschedule-mode	repost	Available modes: repost - Creates a new announcement post update - Updates the original announcement post
Usage
!schedule link		Retrieve the link for posting games

Rescheduling

Here's how rescheduling works:

You enter: 3/20 (Fri) 9am, Reschedule: Weekly, Friday

• First announcement says 3/20 (Fri) 9am
• Next announcement says 3/27 (Fri) 9am
• Next announcement says 4/3 (Fri) 9am

You enter 3/25 (Wed) 9am, Reschedule: Weekly, Friday

• First announcement says 3/25 (Wed) 9am
• Next announcement says 3/27 (Fri) 9am
• Next announcement says 4/3 (Fri) 9am

The first announcement is always on the date you entered. Any following announcements will be based on the day of the week selected.

Each next announcement will be posted X hours after the date/time of the current announcement, where X is the duration of the game. If no duration is entered, it defaults to 0 hours.

How to Develop the Bot/API Layer

• install git, node, heroku-cli, and mongodb server
• Run npm install
• Set up a discord bot application with permissions and a token
  • permissions:
    • send messages
    • manage messages
    • embed links
    • read message history
    • add reactions
  • OAuth2 redirect
    • http://localhost:5000/login
      • guilds
      • identify
• Copy .env template to .devenv and fill out the values
• Create a file called dev (no extension) with the following content:

  require('dotenv').config({ path: './.devenv' });
  require('./app/index.js');

• Start mongodb
• Run npm run dev

How to Develop the UI Layer

Visit the UI Repository for more information.

About the bot

The discord bot is deployed with Heroku as a Node.js and discord.js application and MongoDB for data storage. When an update is pushed to this repository, the update is automatically deployed to Heroku.

Discord Server Discord Change Log

Donate: Patreon | PayPal | Cash App | My Website