GIR is a sophisticated moderation and miscellaneous utilities Discord bot created for the r/Jailbreak Discord server. It features:
- Completely based on Discord's Slash Commands, written in the Discord.py library
- Standard moderation commands such as warn, mute, kick, ban, ...
- XP and role-based permissions system
- An advanced filter and anti-raid system
- A logging and message mirroring system
- Self-assignable roles
- Miscellaneous utilities like
/canijailbreak - And much more!
GIR is custom made for the r/Jailbreak server and therefore there is no publicly running bot you can invite to your own server. However, you can self-host it as is or fork the code and modify it to your own requirements!
These instructions should work on macOS, Windows and Linux.
- Copy the
.env.exampleto a file called.env - Start filling in the values as you want it set up. Follow the comments for hints.
- For the
DB_HOSTvariable:- If running the bot without Docker (not recommended), you can change
DB_HOSTtolocalhostinstead. - If running Mongo without Docker,
host.docker.internalworks on macOS and Windows, on Linux you can use172.17.0.1. - If running Mongo in Docker, set
DB_HOSTtomongo
- If running the bot without Docker (not recommended), you can change
NOT RECOMMENDED FOR PRODUCTION DUE TO POOR PERFORMANCE Optionally, you can use MongoDB Atlas instead of a local Mongo server, or you can ask SlimShadyIAm on Discord for access to the shared test database. In that case, you use:
DB_CONNECTION_STRING=mongodb+srv://.....instead ofDB_HOSTandDB_PORT.
This setup uses Docker for deployment. You will need the following:
- Docker
docker-compose- Mongo installation (optional, but recommended because it makes the setup easier. Advanced uses can also run Mongo in Docker, follow the instructions in
docker-compose.yml).
Alternatively, you could set up the bot without Docker using PM2 but I won't provide instructions for that.
- Set up the
.env. file. Keep in mind whether or not you want to use Mongo in Docker or not. - Set up the database.
- Skip this step if running Mongo without Docker. If you want to run Mongo in Docker, you will need to edit
docker-compose.ymlslightly. Open it and follow the comments. - Run the bot using
docker-compose up -d --build.
If everything is successful, the bot should be online in a few seconds. Otherwise, check the container's logs: docker-compose logs gir.
IMPORTANT: slash commands are not synced automatically. Instead, the bot owner can DM the bot
!syncto sync slash commands with Discord. This only needs to be done once when the bot is set up, or when you change any of the command data (such adding a new command, changing a command's name or description, etc.)
The bot can be updated in the future by running: git pull && docker-compose up -d --build --force-recreate
You will need the following installed:
- Docker
- Visual Studio Code to run the development container
- MongoDB running on the host machine or MongoDB Atlas.
- Clone the repository and open the folder in Visual Studio Code
- Install the Microsoft Remote Development plugin
- Make sure that Docker is running
- Open the Command Palette (
CMD+Shift+PorCTRL+Shift+P) and run "Remote-Containers: Reopen In Container" - VSCode should build the Docker image and open it automatically; this may take a couple of minutes as it has to install some extensions as well.
- Set up the
.envfile as shown here. - Make sure the database is set up (see below).
- Open the integrated terminal in VSCode and run the
gircommand to start the bot with hot reload!
Note that if you make changes to the
Dockerfile,.devcontainer.json, or need to install a new requirement, you need to rebuild the Docker image. You can do this through the Command Palette again, run "Remote-Containers: Rebuild Container".
You will need the following installed:
python3.9+venv(Python's virtualenv module)- MongoDB running on the host machine or MongoDB Atlas.
- Inside the root folder of the project, run
python3 -m venv venv/ source venv/bin/activatepip3 install -r requirements.txt- Set up the .env file as shown here.
- Make sure the database is set up (see below).
python3 main.py
If you have an existing dump of the database, make sure Mongo is running, then you can run mongorestore <dump foldername>. This can also be done if running Mongo in Docker by first copying the dump to the Mongo container with docker cp.
If setting up the database from scratch, follow these instructions:
- Make sure you filled out the right values for the
.envfile as explained above. - Open up
setup.pyand fill in ALL the values. The bot's permissions, and as a result the bot itself, will not work without them. - Run
setup.py:- If running the bot without Docker, follow the first few setup instructions until you need to set up the database, activate the
virtualenvand then runpython3 setup.py. Then you can proceed with the rest of the setup instructions. - If running the bot with Docker in production, start the container then run:
docker exec -it <GIR container name> python3 setup.py(if you get an error about the container restarting, restart the container and try to run the command again immediately). You can find the container name by runningdocker container lsin the project folder. After it's setup, restart the container. Note: changes tosetup.pywon't be transferred until you rebuild the container. So build the container AFTERsetup.pyis set up how you want. - If running the bot with Docker in development, you can just run
python3 setup.pyin the integrated bash shell.
- If running the bot without Docker, follow the first few setup instructions until you need to set up the database, activate the
If you want to inspect or change database values:
- If running MongoDB locally, you can install Robo3T.
- If running MongoDB in Docker, you can use the web GUI at http://127.0.0.1:8081
 SlimShadyIAm |
 stkc |
 Ultra03 |
 ja1dan |
 donato-fiore |
 m1stadev |
 mass1ve-err0r |
 sqlstatement |
 beerpsi |
Special thanks to the following people for ideas, testing, or help:
- Jack LaFond --- creator of tunes.ninja, the bot that the Songs cog is inspired by
- Cameren from r/jb, who has given a lot of ideas and helped with testing on many occasions
- Lillie --- creator of the fake jailbreak and iCloud bypass list used by GIR's filter
- Emma and the https://ios.cfw.guide team --- their API is used for miscellaneous commands such as
/canijailbreak,/deviceinfo,/devices add,/bypassand more.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent