MySimpleDiscordWhitelist

MySimpleDiscordWhitelist

MySimpleDiscordWhitelist lets you manage your Minecraft server's whitelist directly from Discord. Admins whitelist players with a single slash command and can link a Discord account at the same time — linked members automatically receive a configurable Discord role, which is removed again the moment they're taken off the whitelist (and they're kicked immediately if still online).

Players who were whitelisted by Minecraft name only can self-link their account afterwards: requesting a one-time code with /link in Discord and redeeming it in-game with /linkcode <code>.

On top of whitelist management, the plugin keeps an auto-updating server status embed in a channel of your choice (online/offline, player count, player list, MOTD), posts join/leave notifications, and shows the live player count in the bot's Discord presence.

Features

• /whitelist add <minecraft-name> [discord-user] — whitelist a player, optionally linking + role-granting a Discord account in one step
• /whitelist remove <player> — remove by Minecraft name or Discord ID; role, link, and (if online) the player session are cleaned up automatically
• /whitelist list — view the whitelist with linked Discord users
• /link + in-game /linkcode <code> — self-service account linking
• /unlink <player> — admin override to remove a link
• /status — on-demand server status
• Auto-updating status embed, join/leave notifications, player-count bot presence
• 11 bundled languages (de, en, es, es_MX, fr, ru, pt_BR, it, nl, pl, tr), fully configurable per server

Requirements

• Purpur or Paper 1.21.x, Java 21
• A Discord bot application (free, created via the Discord Developer Portal) with the Server Members Intent enabled and Manage Roles permission in your server

This plugin manages the server's regular vanilla whitelist (whitelist.json) — white-list=true must stay enabled in server.properties.

Setup

1. Create a Discord bot and invite it to your server (scopes bot + applications.commands).
2. Drop the plugin jar into your plugins folder and start the server once to generate config.yml.
3. Fill in your bot token, guild ID, whitelist role ID, and the channels you want to use.
4. Restart the server — the bot connects automatically and registers its slash commands.

Full setup instructions, including all configuration options, are in the project's README.

Data & Privacy