Grzybcio whitelist

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2

平台： paper spigot

标签： game-mechanics management social

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