This is our original submission (with super slight modification) for Discord Hack Week 2019. The latest version can be found here.

Libereus

Libereus is a Discord bot written in Python 3.6 as a submission to participate in the Moderation category of Discord Hack Week 2019.

Update:

The judgement phase is over, and we got second place! Full results can be see here. A big thank you to everyone who supported the bot and we look forward in making Libereus better as time goes on! 🤗

It has the ability to:

✅ Prune inactive members via their last message's date
✅ Disable or re-enable messaging permissions on a given channel for normal members (channel lockdown)
✅ Detects bad word and give strike to the sender
✅ Remove a prefix from members' nicknames (i.e. usage of ! to hoist to the top of the member list)
✅ 💣 GENERATE A COOL SPOILER-MINESWEEPER GAME 💣
...and much more!

Team Members

Tansc#8171 Proladon#7525 NRockhouse#4157 RedBerrie#3324 翠梦#8926

Requirements

🐍 Python 3.4 or above (Python 3.6 recommended)

Installation

Registering an access token for your bot

1. Navigate to Discord Developer Portal (Applications).
2. Click on "New Application".
   
3. Fill in a name for your bot (or just "Libereus"), and click on Create.
4. Click on "Bot" at the left navigation panel, and then "Add Bot".
5. Next, click on "Click to Reveal Token" in the "Build-A-Bot" section and write down the token somewhere, it is required for the installation later. (DO NOT SHARE YOUR TOKEN WITH ANY OTHER PEOPLE, NOT EVEN ANIMALS!)
6. Now click on "OAuth2" on the left navigation panel, scroll down to "Scopes" and then tick on "bot".
7. Scroll further down to find "Bot Permissions" and check on "Administrator".
8. You can now proceed to copy the generated link in the "Scopes" section and open the link in your web browser.
9. Add the bot into your server through the page.

Windows

1. Make sure you have Python 3 installed (We recommend python 3.6). (Download it via python.org)
2. Download and extract or clone this repository into your computer.
3. Create a copy of "settings_example.json" and rename it into "settings.json"
4. Open the file through your favourite text editor (Notepad may work too).
5. These are the settings for you to tweak. Scroll to the bottom and replace "your bot token here" with the bot token you just obtained from the previous step.
6. Save it. (Ctrl+S for most cases)
7. Now open up the Command Prompt by pressing Win+R, type in cmd, and then press the "OK" button.
8. In the black Command Prompt window, type in the following command. (Make sure you use cd <your bot folder directory> to navigate to your folder beforehand).
   pip3 install -r requirements.txt
9. To run the bot, double click "bot.py" or do the following command in the bot's directory. py -3 bot.py

🍏 Mac

Unfortunately, this bot requires Python 3 but Mac OS X / macOS ships with Python 2.7 out of the box, thus you need to install Python 3 seperately to run this bot.

1. Open the "Terminal" application.
2. Install Homebrew via the following command.
   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
3. Install Python 3 by entering the command.
   brew install python3
4. Clone this repository's master branch.
   git clone https://github.com/Tansc161/Libereus.git --branch master
5. Make a copy of settings.json from the example given.
   cp settings_example.json settings.json
6. Use your favourite text editor to edit settings.json or use nano in the Terminal.
   nano settings.json
7. Replace "your bot token here" with the bot token that you obtained from Step 5 in "Registering an access token for your bot" above. (Please note that you need to enclose your bot token with "quotation marks".)
8. Save the file. (For nano users, press Ctrl+X, and then hit Y, and then hit Enter.)
9. Now run this command to install the Python libraries required for the bot.
   pip3 install -r requirements.txt
10. Run the bot with the following command.
    python3 bot.py

🐧 Linux

Follow the installation steps for "Mac" above, starting from Step 4.

Usage

Run /help in Discord to see a list of available commands. All command usage information are in standard function signature syntax, which states <> as a required argument and [] as an optional argument.

Commands Showcase

🔥 Prunemembers (Lack of messages / inactive)

If your server has hundreds or thousands of members, it may take a very long time to search.

📅 Calculate Date

💣 Minesweeper