Grzybcio whitelist

# 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: **(https://www.youtube.com/watch?v=upBEU2wF9uE)** ## 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 (https://discord.com/developers/applications). 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*