Skip to content

Mirasaki/discord-onlybans

Repository files navigation

discord-onlybans

This is a Discord application that combats spam-bot posting in the simplest way possible, post in a channel - get banned. This is effective because the spam bot accounts post their ads in all channels that are available to them.

Showcase

Showcase

Discord_lxEkppJI6N

Discord_J6iTJISmHe

Discord_FKZL9JopLq

Configuration

  • /only-bans: Manage your (channel) ban list settings
  • /settings: Manage global settings, like requiring multiple channels to be banned and confirmation settings

🛠️ Installation

Please note, a Discord Application is required for both installation methods.

Also note, the Message Content and Guild Members intents are required! (under the Bot section)

📦 Run as a Docker container (preferred)

The quickest, and easiest, way to host/use this bot is by deploying it inside of a Docker container. We recommend Docker Desktop.

  1. Download the latest release or git clone git@github.com:mirasaki/discord-onlybans.git the repo
  2. Rename /config.example.json to config.json and provide your configuration
  3. Start the application: docker compose up

🖥️ Run as a plain NodeJS app

  • Install the additional pre-requisites:
  • Download the latest release or git clone git@github.com:mirasaki/discord-onlybans.git the repo
  • Run npm install in the project root folder
  • Rename /config.example.json to config.json and provide your configuration
  • Build the application: npm run build
  • Start the application: npm run start