Compatibility
Minecraft: Java Edition
1.21–1.21.6
Platforms
Links
Creators
Details
Minecraft-Whitelist-Discord-Bot
Minecraft-Whitelist-Discord-Bot is a simple and efficient Discord bot for managing the Minecraft server whitelist. The bot integrates with optional MySQL database to securely store whitelist data and sync it with the Minecraft server.
Features
- Whitelist Management: Add, remove, and view players on the Minecraft server whitelist directly from Discord.
- MySQL Integration: Store and manage whitelist data in a MySQL database.
- Simple Commands:
/whitelist <MinecraftUsername>: Adds a player to the whitelist./unwhitelist <MinecraftUsername>: Removes a player from the whitelist./listwhitelist: Displays all players currently whitelisted.
Installation
- Download the latest version of the bot from the Releases page.
- Place the
.jarfile in your Minecraft server'spluginsdirectory. - Restart your server. (There will be an error! This is known! I am working to make it not show an error!)
- Configure the plugin by editing the
config.ymlfile in theplugins/Minecraft-Whitelist-Discord-Botfolder:- Enable/Add your MySQL database credentials. (Optional)
- Specify your bot token and allowed Discord roles.
- Reload the server to apply changes.
Usage
- Use
/whitelist <MinecraftUsername>in Discord to add a player to the Minecraft whitelist. - Use
/unwhitelist <MinecraftUsername>in Discord to remove a player from the whitelist. - Use
/listwhitelistin Discord to display all players currently whitelisted.
License
This project is licensed under the Apache 2.0 License. See the LICENSE file for details.
Acknowledgements
- Thanks to the Discord.js and PaperMC communities for their tools and support.
- Special thanks to all contributors for making this project possible.


