Bloo is a sophisticated moderation and miscellaneous utilities Discord bot created for the r/Jailbreak Discord server. It features:
/canijailbreak
Bloo 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.
.env
file.env.example
to a file called .env
DB_HOST
variable:
DB_HOST
to localhost
instead. host.docker.internal
works on macOS and Windows, on Linux you can use 172.17.0.1
. DB_HOST
to mongo
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_HOST
andDB_PORT
.
This setup uses Docker for deployment. You will need the following:
docker-compose
docker-compose.yml
).Alternatively, you could set up the bot without Docker using PM2 but I won't provide instructions for that.
.env
. file. Keep in mind whether or not you want to use Mongo in Docker or not. docker-compose.yml
slightly. Open it and follow the comments.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 bloo
.
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:
CMD+Shift+P
or CTRL+Shift+P
) and run "Remote-Containers: Reopen In Container".env
file as shown here.bloo
command 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)python3 -m venv venv/
source venv/bin/activate
pip3 install -r requirements.txt
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:
.env
file as explained above.setup.py
and fill in ALL the values. The bot's permissions, and as a result the bot itself, will not work without them.setup.py
:
virtualenv
and then run python3 setup.py
. Then you can proceed with the rest of the setup instructions.docker exec -it <Bloo 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 running docker container ls
in the project folder. After it's setup, restart the container. Note: changes to setup.py
won't be transferred until you rebuild the container. So build the container AFTER setup.py
is set up how you want.python3 setup.py
in the integrated bash shell.If you want to inspect or change database values:
SlimShadyIAm |
stekc |
Ultra03 |
ja1dan |
donato-fiore |
m1stadev |
mass1ve-err0r |
sqlstatement |
beerpsi |
Special thanks to the following people for ideas, testing, or help:
/canijailbreak
, /deviceinfo
, /devices add
, /bypass
and more.