WhiteListe Bot
Running a Minecraft server often means juggling player access requests, and doing it manually through console commands or external tools can quickly become a chore. WhiteListe Bot for Minecraft changes that by embedding a full-featured Discord bot directly into your server plugin. It turns whitelist management into an interactive, automated process that your moderators can handle right from Discord, complete with buttons, embeds, and a private ticket system.
What Makes WhiteListe Bot Stand Out?
Unlike standalone Discord bots that need separate hosting, WhiteListe Bot lives inside your Paper, Spigot, or Purpur server. This tight integration means everything stays in sync, and you never have to worry about an external service going down. The plugin uses a modern Discord UI with slash commands, modals, and paginated lists, making it feel like a native part of your community.
Core Features
- Integrated Discord bot – no external applications or hosting required.
- Interactive embeds and buttons – approve, deny, or open tickets with a single click.
- Automatic NameMC verification – players link their Minecraft profile to prove ownership.
- SQLite database – all requests and Discord-to-Minecraft links stored locally.
- Ticket system – private channels for detailed discussions without cluttering public chat.
- Role-based permissions – only authorized Discord roles can manage requests.
- Anti-spam and duplicate protection – prevents multiple requests from the same user or username.
- Private message notifications – players get automatic DMs when their status changes.
How to Install WhiteListe Bot
Setting up WhiteListe Bot is straightforward, and it works on Paper, Spigot, and Purpur servers starting from Minecraft 1.20.1. It has been tested and confirmed compatible with 1.20.4, 1.20.6, and the latest 1.21.x releases. You will need Java 17 or higher, and at least 512MB of additional RAM for the Discord bot component.
Step 1: Download WhiteListe Bot
You can download WhiteListe Bot from the official GitHub releases page. Grab the latest JAR file, which bundles all dependencies into a single package around 50-60MB. If you prefer to compile from source, the repository includes a Maven setup that builds the plugin with a simple mvn clean package command.
For those who want an even smoother experience, the foxygame.net launcher includes WhiteListe Bot in its curated add-on catalog. With one click you can install the plugin and let the launcher handle version compatibility and automatic updates, so you never have to manually check for new releases.
Step 2: Server Setup
Place the downloaded JAR into your server's plugins/ folder. Start the server once to let WhiteListe Bot generate its default configuration files, then stop the server. You will find the main config at plugins/WhitelistBot/config.yml. Open it and fill in your Discord bot token, channel IDs, and authorized role IDs before restarting.
Step 3: Discord Bot Configuration
Create a new application on the Discord Developer Portal, turn it into a bot, and copy the token. Enable the required intents: Message Content, Guild Messages, and Guild Members. Invite the bot to your server with permissions to manage channels, send messages, embed links, and use slash commands. Finally, enter the token and the IDs of your request channel, admin channel, and ticket category into the config.yml.
Configuration and Customization
WhiteListe Bot gives you full control over how requests are handled. The allowed-roles list lets you restrict management commands to specific Discord roles like @Admin or @Moderator. You can customize every notification message—from the confirmation a player sees after submitting a request to the DM they receive upon approval or denial. The plugin also supports a debug mode for detailed SQL logging if you ever need to troubleshoot.
Commands and Permissions
Once installed, WhiteListe Bot registers slash commands in Discord. Players use a simple request command to submit their Minecraft username, while staff members get a suite of administrative tools. The /lookup command lets you search for linked accounts by Discord ID or Minecraft name. In-game permissions like whitelistbot.lookup and whitelistbot.admin can be assigned to operators or specific players, giving you fine-grained control over who can run administrative queries from the server console.
Why Server Admins Love WhiteListe Bot
Manual whitelisting often leads to mistakes, delayed approvals, and frustrated players. WhiteListe Bot eliminates those pain points by automating verification, keeping a searchable database of all requests, and providing a clean audit trail. The ticket system means sensitive conversations stay private, and the anti-spam measures keep your request channel tidy. Because everything runs inside the Minecraft server itself, there is no extra VPS or bot hosting to maintain.
Whether you run a small community server or a large network, WhiteListe Bot scales with you. The SQLite database remains lightweight even with thousands of entries, and the plugin's resource footprint is minimal. Regular backups of the whitelist.db file are all you need to safeguard your data.
If you are ready to modernize your whitelist workflow, download WhiteListe Bot today and give your staff and players the seamless experience they deserve. With its rich Discord integration, automatic verification, and flexible configuration, it is the last whitelist manager you will ever need.