Bosley

Bosley is a multi-functional scheduling bot that enables users to set and share reminders for events, games, streams etc. Bosley can send notifications to specific channels and roles, users can opt-in (or out) of receiving notifications or Admins can enforce notifications.

Quick setup
Follow these simple steps to set the bot up!

• Invite the bot to your server.
• Run the command !setup to initiate the interactive setup. You will be asked for:
• A role that can create events in your server (recommended), or type in “everyone” if you want everyone to be event creators.
• A channel for the bot to send scheduled event messages.
• If you don’t want to specify a role that gets notification every time an event message is created, go ahead and type “none” to complete the setup.
• Done! You can run command !info to check if the bot is properly configured in your server.

Advanced setup
You are good to go after setting a role for event creator, and a channel for Boz to post event messages to. If you want users to subscribe for event creations, please follow the steps below, given that you have completed Step 1 and Step 2:

• Run the command !setup again.
• Enter next to skip Step 1 and Step 2.
• Step 3: Enter the role that gets the notification when a new event is created. If you receive an error in this step, make sure the bot’s role is above the role you entered.
• Step 4: Copy a message ID (from the message you want to make it as a place for new event subscription) and give it to complete step 4. You will need Discord’s Developer Mode enabled in order to get the message ID. How it works: It’s basically a react-for-role function: the user adds reaction to the message and gets the role (specified in Step 3), or removes the reaction to remove the role. When an event is created, the bot will ping that role so anyone with it receives the notification.

Create scheduled events
Once the bot is set up you can proceed to create scheduled events

• Run command !create to start the interactive creation process!
• The bot will ask you these information:
• A title for the event.
• Details for it.
• A number of users to “say yes” (through reactions). Tell your server friends to react if they’re interested and want the event to happen! --- You can also put down 0 yes's required. This allows an admin to enforce a notification being sent to any role ---
• Date and time when it happens. Enter as you like, the bot will try to figure out the date and time for you.
• You will receive a notification if the event is successfully created.

You can also use the !qcreate command to schedule an event (bypass the interactive event creator)

flags
-t, -title : Required : Name or Title of your event
-s, -start : Required : Time when your event starts
-d, -details : Optional : Details of your event
-r, -repeat : Optional : Time interval to repeat your event
-f, -force : Optional : Roles to force notification on
-c, -channel : Optional : Channel to post the event message
-y, -yes : Optional : Number of Y reactions required

example: !qcreate -t The name of my event -s 2020-03-01 01:20 GMT-8 -d a description of my event -f @everyone -c #event -y 0

Manage created event
!list – Lists all the events you have created in the server. !delete – Deletes events you created (except for successful ones).

All available commands
Server Manager Commands (has Manage Server permission)
!prefix – Changes the prefix of the bot.
!setup – Initiate the interactive setup process of the bot.
Event Creator Commands (has the role you specified in step 1 of the setup)
!create – Interactively creates a scheduled event.
!list – Shows all the events you created, along with their detailed information.
!delete – Deletes events you created (except for successful ones).
!guide – Shows how reactions in the event message are calculated.
Public Commands (anyone can use)
!info – Shows the bot’s information, along with the configuration status.
!help – Shows all available commands.

When the event’s start time comes...
The bot will automatically ping anyone who “says yes” to the event message through reaction so they can catch up with the event!