# \ud83d\udee1\ufe0f WhitelistBot<\/p>\n
**Automatically whitelist players from a Discord channel \u2014 no commands, no hassle.**<\/p>\n
WhitelistBot bridges your Discord server and Minecraft server. Set up a dedicated channel, and when a player sends their Minecraft username, the bot instantly whitelists them and replies with a colour-coded embed. One username per Discord account, always.<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– \ud83d\udce8 **Discord \u2192 Minecraft whitelisting** \u2014 players send their username in a channel, bot does the rest
\n– \ud83d\udd12 **One username per Discord user** \u2014 enforced via SQLite database, no duplicates
\n– \u2705 **Smart validation** \u2014 checks for invalid characters, already-whitelisted players, and taken usernames
\n– \ud83c\udf10 **Web dashboard** \u2014 add and remove entries from a browser with a searchable table
\n– \ud83d\udd11 **Auto-generated password** \u2014 random login saved to `webpage.yml` on first launch
\n– \ud83d\udd04 **In-game reload** \u2014 `\/wlbot reload` reloads config and restarts the bot without restarting the server
\n– \ud83c\udfa8 **Colour-coded embeds** \u2014 green for success, red for errors, brown for invalid input, orange for already registered<\/p>\n
—<\/p>\n
## \ud83d\udccb Embed Responses<\/p>\n
| Situation | Colour | Message |
\n|—|—|—|
\n| Valid new username | \ud83d\udfe2 Green | \u2705 Successfully Whitelisted |
\n| Invalid username format | \ud83d\udfeb Brown | \u26a0\ufe0f Invalid Characters |
\n| Discord user already registered | \ud83d\udfe0 Orange | \u26a0\ufe0f Already Registered |
\n| Username taken by another user | \ud83d\udd34 Red | \u274c Username Taken |
\n| Already on whitelist | \ud83d\udd34 Red | \u274c Already Whitelisted |<\/p>\n
—<\/p>\n
## \u2699\ufe0f Setup<\/p>\n
### 1. Create a Discord Bot
\n1. Go to discord.com\/developers\/applications \u2192 **New Application**
\n2. Navigate to **Bot** \u2192 copy your token
\n3. Enable **Message Content Intent** under Privileged Gateway Intents
\n4. Under **OAuth2 \u2192 URL Generator**, select `bot` scope with **Read Messages** + **Send Messages** permissions and invite it to your server<\/p>\n
### 2. Get Your IDs
\nEnable **Developer Mode** in Discord Settings \u2192 Advanced, then:
\n– Right-click your server \u2192 **Copy Server ID**
\n– Right-click your whitelist channel \u2192 **Copy Channel ID**<\/p>\n
### 3. Configure the Plugin
\nEdit `plugins\/WhitelistBot\/config.yml`:
\n“`yaml
\ndiscord:
\n bot-token: “YOUR_BOT_TOKEN_HERE”
\n guild-id: “YOUR_GUILD_ID_HERE”
\n channel-id: “YOUR_CHANNEL_ID_HERE”
\n“`<\/p>\n
### 4. Web Dashboard
\nOn first launch, `plugins\/WhitelistBot\/webpage.yml` is created with a randomly generated password:
\n“`yaml
\nweb:
\n password: “a3f9c2d1e8b04f7a”
\n port: 8080
\n“`
\nOpen `http:\/\/your-server-ip:8080` in your browser to access the dashboard.<\/p>\n
—<\/p>\n
## \ud83c\udf10 Web Dashboard<\/p>\n
The built-in dashboard lets you manage whitelist entries without touching the server console.<\/p>\n
– **Add entries** \u2014 enter a Discord ID + Minecraft username to add and whitelist instantly
\n– **Remove entries** \u2014 remove by Discord ID, automatically runs `\/whitelist remove`
\n– **Search** \u2014 filter the table by Discord ID or Minecraft username
\n– **Secure login** \u2014 session-based auth with your `webpage.yml` password<\/p>\n
To change the password or port, edit `webpage.yml` and run `\/wlbot reload`.<\/p>\n
—<\/p>\n
## \ud83d\udd27 Commands & Permissions<\/p>\n
| Command | Description | Permission |
\n|—|—|—|
\n| `\/wlbot reload` | Reloads config and restarts the bot | `whitelistbot.reload` (default: op) |<\/p>\n
—<\/p>\n
## \ud83d\uddc4\ufe0f Database<\/p>\n
All entries are stored in `plugins\/WhitelistBot\/whitelist.db` (SQLite). You can open it with DB Browser for SQLite to view or manage entries manually.<\/p>\n
The database stores:
\n– Discord ID
\n– Minecraft username
\n– Timestamp of when they were whitelisted<\/p>\n
—<\/p>\n
## \ud83d\udda5\ufe0f Compatibility<\/p>\n
| Minecraft Version | Supported |
\n|—|—|
\n| 1.18.x | \u2705 |
\n| 1.19.x | \u2705 |
\n| 1.20.x | \u2705 |
\n| 1.21.x | \u2705 |<\/p>\n
Requires **Paper** or **Spigot**. Java 17+ required for 1.18\u20131.19, Java 21+ for 1.20+.<\/p>\n
—<\/p>\n","protected":false},"excerpt":{"rendered":"
Its an auto whitelist bot that does the whitelisting for u with a in built web server if u got any problems dm me : bl0ckbust3.3_<\/p>\n","protected":false},"featured_media":54736,"template":"","meta":{"_minecraft_slug":"dcwc","_minecraft_project_id":"XQ9DKI5x","_minecraft_author":"BlockBust_Owner","_minecraft_license":"MIT","_minecraft_downloads":9,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"dcwc.zip","_minecraft_size_bytes":27184252,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T23:12:34.720448Z","_minecraft_date_created":"2026-05-08T19:21:33.636807Z","_minecraft_date_modified":"2026-05-06T13:15:21.768660Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/dcwc","_minecraft_icon_attachment_id":54736,"_minecraft_imported_at":"2026-06-03T01:11:01+00:00","_minecraft_import_hash":"bc4201f48cb75251343dd42696c1707f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,90,127,128,867,129,123],"mod_loader":[130,131,132,133,134],"minecraft_version":[51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-54735","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-technology","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n