> For the complete documentation index, see [llms.txt](https://kermitcloud.gitbook.io/kermitcloud-hosting-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kermitcloud.gitbook.io/kermitcloud-hosting-wiki/minecraft-plugins/plugins/ban-announcer.md).

# Ban Announcer

#### What does the plugin do?[​](https://docs.bloom.host/plugins/banannouncer#what-does-the-plugin-do) <a href="#what-does-the-plugin-do" id="what-does-the-plugin-do"></a>

This plugin allows you to send a message (like the one below) to a channel in your discord through a discord bot, when somebody receives a punishment. (Muted, Warned, Banned, Unbanned, etc)

![image](https://i.imgur.com/QuK1heu.png)

important

You must have Spicord, a Discord account, and a **Compatible** moderation plugin such as [AdvancedBan](https://www.spigotmc.org/resources/advancedban.8695/)

#### Installation[​](https://docs.bloom.host/plugins/banannouncer#installation) <a href="#installation" id="installation"></a>

Once you download Spicord, BanAnnouncer, and the Moderation plugin of your choice, upload them to your servers `plugins` folder, and restart your server. After you have restarted, head over to the Discord [Developer Portal](https://discord.com/developers/applications), make a new application, and give it a name. Next, you'll want to head to the `Bot` tab on the left hand side, and add a bot. Here you can customize your bot, by giving it a name, Changing it's Avatar, and a lot of other cool features.

#### Setting up your bot[​](https://docs.bloom.host/plugins/banannouncer#setting-up-your-bot) <a href="#setting-up-your-bot" id="setting-up-your-bot"></a>

After you've created your Discord Bot, you can find your token in the `Bots` Tab. You'll have to click `Reset Token` and enter your 2fa code if you have it enabled, you will then be able to copy the token.

warning

DO NOT SHARE YOUR BOT TOKEN.

Once you copy your token, scroll down to the bottom of the page, under **Privileged Gateway Intents**, and enable all three settings.

![image](https://i.imgur.com/GKh1zhU.png)

For the sake of this guide, We're going to use the Administrator permission to guarantee it works correctly. Ideally, you would want to set the **proper permissions** for the channel.

After you enable the options above, You can head over to the `OAuth2` tab, and select `URL Generator`. Under `Scopes` select `bot` and under `Bot Permissions` select `Administrator`. This will generate a URL at the bottom. Use this invite to add your bot, to your guilds.

#### Configuration[​](https://docs.bloom.host/plugins/banannouncer#configuration) <a href="#configuration" id="configuration"></a>

**Ban Announcer**[**​**](https://docs.bloom.host/plugins/banannouncer#ban-announcer)

Head over to BanAnnouncer's config `/plugins/banannouncer/config.yml`, and paste the Channel ID of the channel you want to use, in `channels-to-announce`.

note

If you don't know how to get the Channel ID, see [This](https://support.discord.com/hc/en-us/articles/206346498-Where-can-I-find-my-User-Server-Message-ID) guide.

**Spicord**[**​**](https://docs.bloom.host/plugins/banannouncer#spicord)

In your Spicord config `/plugins/Spicord/config.toml`, under the `[[bots]]` section, add your token where it says `"YOUR BOT TOKEN HERE"`. After you add your token, find the `addons` section, and add `"ban_announcer"` on the next line. **Make sure you put a comma after the last option already there**

![image](https://i.imgur.com/9itDSVi.png)

As long as you set everything up correctly, your next punishment should show up in discord!

### Links[​](https://docs.bloom.host/plugins/banannouncer#links) <a href="#links" id="links"></a>

[Bloom.host Discord](https://discord.gg/bloom)

[Ban Announcer - SpigotMC](https://spigotmc.org/resources/64976/)

[Spicord - SpigotMC](https://spigotmc.org/resources/64918)