CSSS Discord Bot (Wall-E)

Wall-E, named after the lovable character Wall-E, will hold all the scripts for the upcoming bot that will operate on the CSSS discord, located here. This bot is owned by the CSSS and will be maintained by the current CSSS appointed Discord representative and the current bot development team.

Table of Contents

• Current Commands
• Local Setup
• Current-Setup Info
• Part 1: Authentication
• Part 2: Running the bot

Current Commands

• .ping - returns pong!
• .echo <arg> - returns <arg>
• .newrole <arg> - creates role <arg>
• .iam <arg> - adds you to role <arg>
• .iamn <arg> - removes you from role <arg>
• .whois <arg> - returns everyone who has role <arg>
• .poll <arg> - starts a yes/no poll where <arg> is the question
• .poll <arg0> <arg1> <arg2> (up to 12 arguments) - starts a poll where <arg0> is the question and the remaining arguments are the options

Local Setup

Current-Setup Info

Server IP: 178.128.184.141
For access to the jenkins, notify someone on the following list:

• Winfield Chen (CSSS VP) - csss-vp@sfu.ca

Follow steps outlined in the README for machine setup steps to prepare the host machine to support CI/CD

Follow these steps to run the bot and do development on your local machine.

Part 1: Authentication

Pre-requisites: A Discord account.

1. Create your own Discord server for testing by clicking the + on the left side
2. Navigate to https://discordapp.com/developers/applications/me and login
3. Click New App
4. Name your app to whatever you wish then click Create App
5. Save the Client ID under the App Details
6. Scroll down, click Create a Bot User and confirm
7. Within the new Bot section of the dashboard, click click to reveal, and save the token
8. Naviate to https://discordapp.com/oauth2/authorize?&client_id=YOUR_CLIENT_ID_HERE&scope=bot&permissions=0 and replace YOUR_CLIENT_ID_HERE with the client ID of your bot
9. Select the server you created and click Authorize

Part 2: Running the Bot

Pre-requisites: git, python3, and pip3.

From a command line

1. Run git clone https://github.com/CSSS/wall_e.git
2. cd into wall_e directory
3. Run pip3 install -r requirements.txt
4. Run sudo apt-get install -y redis-server
5. Run sudo service redis-server start
6. Run export TOKEN=token with the token you obtained during the authentication step
7. Run python3 main.py