Discord-Ban-Utils-Bot

July 4, 2025 ยท View on GitHub

Discord Ban Utilities for Mutual Servers!

Invite the bot!

Join my server

This bot project was inspired by the dbans-cli

Bot Permissions

Bot Permissions

Firebase integration

With v2.4, the bot now comes with logging feature with firebase integration & custom events. So to setup logging follow these steps:

  1. Create a Firebase project.
  2. Go to project settings
  3. In Firebase Admin SDK section, click on Node.js & finally on Generate new private key.
  4. Copy this private key (i.e. the json file which gets downloaded) into ./firebase-service-acc/

For more info check here

Hosting

DISCORD_TOKEN = insert bot token

You can also copy sample.env file and rename it to .env.

  • Install dependencies by using npm install.
  • Use npm start to run the bot code.

See discord.js guides on setting up a bot application & creating a bot

Or Use Docker to start:

docker compose up -d --build ban-utils-bot

In case there is no way to upload firebase service account key:

# Put respective details from the firebase service account file here if firebase key cannot be uploaded
FIREBASE_CLIENT_EMAIL=
FIREBASE_PRIVATE_KEY=
FIREBASE_PROJECT_ID=

Or use base64 encoder using

npm run firekeybase64

And then use the generated value below:

# Put base64 encoded version of the firebase service account file here if above method doesn't work
FIREBASE_SERVICE_ACCOUNT_BASE64=

License

MIT

Feel free to make your own improved version of the bot!