G5 Bot

A Discord bot to manage CS:GO PUGs. Connects to G5API.

Setup

1. First you must have a bot instance to run this script on. Follow Discord's tutorial here on how to set one up.

   • The required permissions is 1360325712.
   • Enable the "server members intent" for your bot, as shown here.

2. Install libpq-dev (Linux only?). This is needed to install the psycopg2 Python package.

   • Linux command is sudo apt-get install libpq-dev.

3. Run pip3 install -r requirements.txt in the repository's root directory to get the necessary libraries.

4. Install PostgreSQL 9.5 or higher.

   • Linux command is sudo apt-get install postgresql.
   • Windows users can download here.

5. Run the psql tool with sudo -u postgres psql and create a database by running the following commands:

   CREATE ROLE "g5" WITH LOGIN PASSWORD 'yourpassword';
   CREATE DATABASE "g5" OWNER g5;

   Be sure to replace 'yourpassword' with your own desired password.

   Quit psql with \q

6. Create an environment file named .env with in the repository's root directory. Fill this template with the requisite information you've gathered...

   DISCORD_BOT_TOKEN= # Bot token from the Discord developer portal
   DISCORD_BOT_LANGUAGE=en # Bot language (key from translations.json)
   DISCORD_BOT_PREFIXES=q! Q! # Bot commands prefixes
   
   G5API_URL= # Make sure this is API url, not the front-end
   G5V_URL= # Front-end url
   
   POSTGRESQL_USER=g5 # PostgreSQL user name
   POSTGRESQL_PASSWORD= # PostgreSQL password
   POSTGRESQL_DB=g5 # PostgreSQL Database
   POSTGRESQL_HOST=localhost # PostgreSQL host
   POSTGRESQL_PORT=5432

7. Apply the database migrations by running python3 migrate.py up.

8. Run the launcher Python script by running, python3 launcher.py.

Thanks To

Cameron Shinn for his initial implementation of csgo-league-bot.