Biscuit is a Discord bot written in Java I made to help me perform certain tasks on my personal Discord server. It can be run standalone or as a plugin on Spigot. For the most part I have used it to log chat, allow users to toggle certain roles for notifications, automatically remove messages with swear words, and more.

Recently, however, I have also added a captcha system to it. Not too long ago, another Minecraft Network started sending a large number of selfbots to my Discord to DM members advertisements for their server. This was very frustrating, so I added captcha to Biscuit. Biscuit is being worked on partially to help communities fend off these types of hostile advertisers, as they have become more common in the Minecraft multiplayer community in recent months.

When a user joins the Discord, they are assigned a temporary role. You can also set a time limit for how long a user is allowed to have this role before they are kicked from the Discord. The user can DM the Biscuit bot to receive a captcha image. If they respond with the correct text in the image, Biscuit removes the temporary role and grants them a permanent role. I have used this, along with a proper role permissions setup, to prevent the advertising selfbots from staying in my discord server for too long. It was also designed to be a quick and easy process, so it isn't a huge hassle for new members.

Biscuit now also has a music player. It can play song from YouTube if they are available in the region your bot is hosted in. See the wiki for a list of config options and commands for the music player.


Biscuit can either be run as a standalone Java application or as a Spigot plugin. If you want to run it on your Spigot server, you just need to put it in your plugins folder like you would any other plugin. For full instructions on setting up Biscuit, check out this page on the wiki.

If running as a Spigot plugin, if you want to run any of the command-line commands in-game, you will need the permission biscuit.admin.

If you are able to, I highly recommend running it standalone, so that the bot can still be active while the Minecraft server is down or restarting. To run the bot standalone, put it in a folder by itself, and with your terminal or command prompt, run java -jar <name-of-the-file>.

For those of you having trouble starting the bot with the newer releases, make sure you enable the Server Members intent as shown. Also double check that you have the bot-token added to config.properties. You can enable/disable the public bot setting as you wish.


For full documentation on Biscuit's setup, config, and commands check out the wiki. If you want to see the bot in action, report bugs, or suggest changes/features for the bot, join my Discord using the link below. I am very open to suggestions and am looking to continue to expand on the functionality of Biscuit, and maybe even make better use of its Spigot compatibility.

Important links:

VISIT BISCUIT WIKI
BISCUIT RELEASES PAGE
SUPPORT DISCORD