Gromp Bot is a specialized Discord bot designed to deliver League of Legends Esports replays directly to coaches and players. Leveraging the Bayes Esports API, the bot offers a user-friendly interface to search, filter, and download match replays right in discord.
With esports data being moved onto GRID and the author joining a team, this project will no longer receive updates.
- Search Replays: Filter by game type, team name, and tags.
- Download Replays: Direct download links for replays.
- User-Friendly: Designed for coaches and players to use with minimal setup.
- Highly Configurable: Limit bot to specific Discord guilds.
- Python 3.10 or higher
- Docker (Optional for deployment)
git clone https://github.com/Allan-Cao/Gromp-Bot.git
-
Linux/MacOS
python3 -m venv bot-env source bot-env/bin/activate
-
Windows
py -m venv bot-env bot-env\Scripts\activate
pip install -r requirements.txt
You'll need to set the environment variables. You can do this by renaming .env.example to a file called .env in the root directory of the project and modifying the variables in the file or if you are deploying with docker, consider passing in env variables with the --env-file
option.
GUILDS_ALLOWED
specifies which servers the bot is allowed to take commands from which should be a string that has comma-seperated server-IDs.
Note: To find your server ID, follow this guide.
python bot.py
- Install Docker: Official Website
- Clone Repository:
git clone https://github.com/Allan-Cao/Gromp-Bot.git
- Navigate to Directory:
cd Gromp-Bot
- Build Image:
docker build -t gromp-bot .
- Run Container:
docker run -d gromp-bot
- Verify Container:
docker ps
Stop Container: docker stop <container-id>
- Search Matches:
/match
- Download Replay:
/download <game_id>
This project is licensed under the MIT License. See the LICENSE file for more information.