A Simple Event Manager bot for Discord!

Made for Discord Hack Week 2019.

• #1

Social: Why Social?

While this bot could be a little bit productive, maybe some management related stuff, the idea was to make a management system to engage a community. Thus, this bot is a social bot.

This bot has the following features:

• Event Creation and Management
• Event Reminders
• Points and Trophies Rank System

It is a simple bot, but it gets the job done and engages the community.

It is timezone-aware, and a guild can set a specific timezone to use.

Locate config/config.py and configure as needed.

• TOKEN : Your discord bot token
• PREFIX : Default prefix
• DESCRIPTION : No need to change this really
• MANAGE_ROLE : Default manager role to create on guild join
• ANNOUNCE_CHANNEL : Default announcement channel to create on guild join
• TIMEZONES : Please don't change :)

The bot needs the following permissions string: &permissions=1342565456&scope=bot

This includes the following permissions. Some may not be needed, but are added as a pre-caution.

• Manage Roles
• Manage Channels
• Manage Emojis
• Send Messages
• Manage Messages
• Embed Links
• Attach Files
• Read Message History
• Add Reactions
• Use External Emojis

The following external packages were used:

• discord.py
• sqlalchemy
• sqlalchemy_utils
• arrow
• tabulate

• register: Register a user to the bot
• stats: View user stats. Optional: Can mention a user
• leaderboard: View the top 15 users.
• trophy
  • add
  • remove
  • value
  • info : View the current server values for all trophies and rewards

For each add, remove and set, you can specify a trophy type: Gold, Silver, Bronze.

For value, you may also specify Participation.

For add/remove, mention one or more users to apply it too. For value, you can set the value of a trophy server-wide.

• event
  • make: Make an event with the following properties:
    • Title
    • Description
    • Channel to host the event
    • Max number of participants
    • Event Start Time (In Server's specified timezone, default to UTC)
  • info: View an event's info before it begins and be able to react again. Requires the event code (4 character code)
  • remove: Remove/Cancel an event early.
  • participants: Given event code, view all current participants.

When making an event, it will create an announcement message, from which you can react to it to join, leave, or get a ping reminder 15 minutes prior to event start.

• guild: Some manager and owner only commands

  • setTimezone: Given a list of timezones, select one as the server timezone. Can also give a GMT offset instead.
  • setAnnouncementChannel: Give a text channel to be SEM's new announcement channel for the server.
  • setManagerRole: Give a role to be the new manager role for the server which can create events.

• time: View current time information about the server

Basic commands (Not sub commands)

Timezone selection

Trophy info and statistics

Time Info

Sample event

And many more! Not all commands are shown as that would be a lot of screenshots. These are just some unique ones.

Pretty standard stuff.

Install the required packages: pip install -r requirements.txt

To Run: You can do this in a virtual env if you want to set that up, but to be quick and easy, configure config/config.py with your bot token and then just run bot.py.