GrzybcioWhitelist

GrzybcioWhitelist is a lightweight Paper/Spigot plugin that connects your Minecraft server to Discord. Players can whitelist themselves by sending their username in a designated channel — no need to wait for staff.

Demo

Watch the plugin in action on YouTube:
▶ GrzybcioWhitelist Demo

Features

• Add players to the server whitelist via a Discord message
• Username validation (a–z, A–Z, 0–9, _, max. 16 characters)
• Discord bot replies (success, already whitelisted, error)
• Fully customizable messages in config.yml
• /grzybciowhitelist reload command to reload config and reconnect the bot
• Safe Discord disconnect on plugin disable

Requirements

• Paper or Spigot
• Minecraft 1.21.x – 26.1.2
• Java 21+
• Discord bot with Message Content intent enabled
• Server whitelist enabled (white-list=true in server.properties)

Setup

1. Create a bot in the Discord Developer Portal.
2. Enable Message Content Intent under the Bot tab.
3. Invite the bot to your Discord server.
4. In plugins/GrzybcioWhitelist/config.yml, set:
   • discord-token — your bot token
   • channel-id — the channel ID where players submit usernames
5. Start or reload the plugin: /grzybciowhitelist reload

How it works

A player sends their Minecraft username on the configured Discord channel (e.g. Steve). The bot adds them to the server whitelist and replies in the Discord channel.

Commands & permissions

Command	Description	Permission
/grzybciowhitelist reload	Reloads config and Discord connection	grzybciowhitelist.reload (default: OP)

Message placeholders

• {player} — player username

---

Author: Grzybcio