{"id":65869,"date":"2026-06-03T21:49:21","date_gmt":"2026-06-03T18:49:21","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/even-better-whitelist\/"},"modified":"2026-06-03T21:49:21","modified_gmt":"2026-06-03T18:49:21","slug":"even-better-whitelist","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/even-better-whitelist\/","title":{"rendered":"Even Better Whitelist"},"content":{"rendered":"

# EvenBetterWhitelist – Plugin<\/p>\n

![Modrinth](https:\/\/modrinth.com\/plugin\/even-better-whitelist)
\n![Minecraft](https:\/\/papermc.io\/)
\n![Discord](https:\/\/img.shields.io\/badge\/Discord-Integration-5865F2?style=flat-square&logo=discord)<\/p>\n

A modern whitelist system for Minecraft Paper 1.21.x with Discord integration. When a player attempts to join and is not whitelisted, a structured request is posted to your Discord channel. Admins can accept, deny, or ban directly from Discord using buttons.<\/p>\n

![Minecraft](https:\/\/img.shields.io\/badge\/Minecraft-1.21.x-green?style=flat-square&logo=minecraft)
\n![Paper](https:\/\/img.shields.io\/badge\/Paper-API-blue?style=flat-square)
\n![Discord](https:\/\/img.shields.io\/badge\/Discord-Integration-5865F2?style=flat-square&logo=discord)
\n![Java](https:\/\/img.shields.io\/badge\/Java-21-orange?style=flat-square&logo=openjdk)<\/p>\n

### Installation Steps<\/p>\n

1. Place `WhitelistPluginButBetter-1.0.0.jar` in your server’s `plugins\/` folder
\n2. Start\/restart your server
\n3. Edit `plugins\/WhitelistPluginButBetter\/config.yml`
\n4. Download GeoLite2-City.mmdb and place it in the plugin folder
\n5. Reload with `\/wlp reload` or restart the server<\/p>\n

## \ud83e\udd16 Discord Bot Setup<\/p>\n

### 1. Create a Discord Application<\/p>\n

1. Go to Discord Developer Portal
\n2. Click “New Application” and give it a name
\n3. Go to “Bot” section and click “Add Bot”
\n4. Copy the **Bot Token** (keep this secret!)
\n5. Enable these **Privileged Gateway Intents**:
\n – Message Content Intent<\/p>\n

### 2. Invite the Bot<\/p>\n

1. Go to “OAuth2” \u2192 “URL Generator”
\n2. Select scopes: `bot`, `applications.commands`
\n3. Select permissions: `Send Messages`, `Embed Links`, `Read Message History`
\n4. Copy the generated URL and open it to invite the bot<\/p>\n

### 3. Get Your IDs<\/p>\n

Enable Developer Mode in Discord (Settings \u2192 Advanced \u2192 Developer Mode)<\/p>\n

– **Server ID**: Right-click your server \u2192 Copy Server ID
\n– **Channel ID**: Right-click the channel \u2192 Copy Channel ID
\n– **Admin User ID**: Right-click yourself \u2192 Copy User ID<\/p>\n

### 4. (Optional) Create a Webhook<\/p>\n

1. Right-click your channel \u2192 Edit Channel
\n2. Go to Integrations \u2192 Webhooks
\n3. Create a webhook and copy the URL<\/p>\n

## \u2699\ufe0f Configuration<\/p>\n

“`yaml
\ndiscord:
\n bot-token: “YOUR_BOT_TOKEN_HERE”
\n webhook-url: “YOUR_WEBHOOK_URL_HERE”
\n server-id: “YOUR_SERVER_ID_HERE”
\n channel-id: “YOUR_CHANNEL_ID_HERE”
\n admin-user-ids: “USER_ID_1,USER_ID_2”
\n ping-admins: true<\/p>\n

cooldowns:
\n deny-cooldown: 60 # Minutes before denied player can try again
\n pending-cooldown: 5 # Minutes between join attempts while pending
\n ip-cooldown: 10 # Minutes before same IP can make new request<\/p>\n

geoip:
\n enabled: true
\n database-path: “plugins\/WhitelistPluginButBetter\/GeoLite2-City.mmdb”
\n“`<\/p>\n

See the full [config.yml](src\/main\/resources\/config.yml) for all options!<\/p>\n

## \ud83d\udcdd Commands<\/p>\n

| Command | Description |
\n|———|————-|
\n| `\/wlp accept ` | Accept a pending whitelist request |
\n| `\/wlp deny ` | Deny a pending whitelist request |
\n| `\/wlp pending` | View all pending requests |
\n| `\/wlp list [page]` | View whitelisted players |
\n| `\/wlp add ` | Manually add a player to whitelist |
\n| `\/wlp remove ` | Remove a player from whitelist |
\n| `\/wlp info ` | View detailed player info |
\n| `\/wlp status` | View plugin status |
\n| `\/wlp reload` | Reload configuration |<\/p>\n

## \ud83d\udd10 Permissions<\/p>\n

| Permission | Description | Default |
\n|————|————-|———|
\n| `whitelistplugin.admin` | Access to all commands | OP |
\n| `whitelistplugin.bypass` | Bypass whitelist check | OP |<\/p>\n

## Discord Embed Preview<\/p>\n

When a player tries to join, admins receive an embed like this:<\/p>\n

“`
\n\u250c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
\n\u2502 New Whitelist Request \u2502
\n\u251c\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524
\n\u2502 Player: Steve \u2502
\n\u2502 UUID: 069a79f4-… \u2502
\n\u2502 IP: ||192.168.1.1|| \u2502
\n\u2502 Location: New York, United States \u2502
\n\u2502 Client: fabric \u2502
\n\u2502 Language: en_US \u2502
\n\u2502 Requested: 2024-01-15 14:30 UTC \u2502
\n\u2502 \u2502
\n\u2502 Same IP as: Alex (1 other request) \u2502
\n\u2502 \u2502
\n\u2502 [Accept] [Deny] [Ban] \u2502
\n\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518
\n“`<\/p>\n

## \ud83d\uddc2\ufe0f File Structure<\/p>\n

“`
\nplugins\/WhitelistPluginButBetter\/
\n\u251c\u2500\u2500 config.yml # Main configuration
\n\u251c\u2500\u2500 whitelist.json # Whitelisted players
\n\u251c\u2500\u2500 pending-requests.json # Pending requests
\n\u251c\u2500\u2500 denied-players.json # Denied players (for cooldowns)
\n\u251c\u2500\u2500 requests.log # Action log
\n\u2514\u2500\u2500 GeoLite2-City.mmdb # GeoIP database (you provide this)
\n“`<\/p>\n

## Troubleshooting<\/p>\n

### Bot not responding to buttons?
\n– Make sure the bot token is correct
\n– Ensure the bot has permissions in the channel
\n– Check console for connection errors<\/p>\n

### GeoIP not working?
\n– Download GeoLite2-City.mmdb from MaxMind
\n– Place it in the plugin folder
\n– Check the path in config.yml<\/p>\n

### Players not being kicked?
\n– Make sure the plugin is loaded (`\/plugins`)
\n– Check if player has `whitelistplugin.bypass` permission
\n– Look for errors in console<\/p>\n

### Seeing Private IP (10.x.x.x, 192.168.x.x)?
\nThis happens when using a **reverse proxy** (BungeeCord, Velocity, TCPShield, etc.)<\/p>\n

**For BungeeCord:**
\n1. Set `bungeecord: true` in `spigot.yml`
\n2. Restart the server<\/p>\n

**For Velocity:**
\n1. Edit `config\/paper-global.yml`
\n2. Set `proxies.velocity.enabled: true`
\n3. Set the `secret` to match Velocity’s forwarding secret
\n4. Restart the server<\/p>\n

**For TCPShield\/Other:**
\nFollow your proxy’s documentation for IP forwarding.<\/p>\n

### Client\/Language shows “N\/A (Pre-login)”?
\nThis is expected! The plugin intercepts players **before** they fully connect, so client brand and locale data isn’t available yet. This is a Minecraft limitation, not a bug.<\/p>\n

The data we DO capture (IP, UUID, GeoIP location) is still very useful for identifying players and alts!<\/p>\n

## \ud83d\udcdc License<\/p>\n

All Rights Reserved.Any modifications without informing is illegal.<\/p>\n

Made for the Minecraft community!<\/p>\n","protected":false},"excerpt":{"rendered":"

A professional whitelist workflow with Discord actions, dual VPN\/Proxy detection, GeoIP, optional captcha, Discord account linking, and statistics. Built for production servers.<\/p>\n","protected":false},"featured_media":65870,"template":"","meta":{"_minecraft_slug":"even-better-whitelist","_minecraft_project_id":"89beS55w","_minecraft_author":"zeusdagoat","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":32,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"even-better-whitelist.zip","_minecraft_size_bytes":35576950,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T21:58:07.030307Z","_minecraft_date_created":"2026-02-07T06:52:33.685200Z","_minecraft_date_modified":"2026-02-22T10:01:38.838360Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/even-better-whitelist","_minecraft_icon_attachment_id":65870,"_minecraft_imported_at":"2026-06-03T18:49:21+00:00","_minecraft_import_hash":"b875262754ede4770b2fc4d196e4bd15","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,90,127,128,867,129,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-65869","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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":"\nEven Better Whitelist - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/even-better-whitelist\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Even Better Whitelist - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A professional whitelist workflow with Discord actions, dual VPN\/Proxy detection, GeoIP, optional captcha, Discord account linking, and statistics. Built for production servers.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/even-better-whitelist\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/even-better-whitelist\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/even-better-whitelist\\\/\",\"name\":\"Even Better Whitelist - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/even-better-whitelist\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/even-better-whitelist\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/even-better-whitelist-icon-0879355b02d775b63f0c967e0f5fc8c10d05a19d_96.webp\",\"datePublished\":\"2026-06-03T18:49:21+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/even-better-whitelist\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/even-better-whitelist\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/even-better-whitelist\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/even-better-whitelist-icon-0879355b02d775b63f0c967e0f5fc8c10d05a19d_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/even-better-whitelist-icon-0879355b02d775b63f0c967e0f5fc8c10d05a19d_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/even-better-whitelist\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Even Better Whitelist\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Even Better Whitelist - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/even-better-whitelist\/","og_locale":"en_US","og_type":"article","og_title":"Even Better Whitelist - Minecraft","og_description":"A professional whitelist workflow with Discord actions, dual VPN\/Proxy detection, GeoIP, optional captcha, Discord account linking, and statistics. Built for production servers.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/even-better-whitelist\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/even-better-whitelist\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/even-better-whitelist\/","name":"Even Better Whitelist - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/even-better-whitelist\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/even-better-whitelist\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/even-better-whitelist-icon-0879355b02d775b63f0c967e0f5fc8c10d05a19d_96.webp","datePublished":"2026-06-03T18:49:21+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/even-better-whitelist\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/even-better-whitelist\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/even-better-whitelist\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/even-better-whitelist-icon-0879355b02d775b63f0c967e0f5fc8c10d05a19d_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/even-better-whitelist-icon-0879355b02d775b63f0c967e0f5fc8c10d05a19d_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/even-better-whitelist\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"Even Better Whitelist"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/65869","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/65870"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=65869"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=65869"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=65869"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=65869"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}