{"id":99503,"date":"2026-06-05T20:13:11","date_gmt":"2026-06-05T17:13:11","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/mclocalauth\/"},"modified":"2026-06-05T20:13:11","modified_gmt":"2026-06-05T17:13:11","slug":"mclocalauth","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/mclocalauth\/","title":{"rendered":"MCLocalAuth"},"content":{"rendered":"<p># \ud83d\udee1\ufe0f MCLocalAuth<\/p>\n<p>**Minecraft Authentication Plugin with Integrated Discord Bot**<\/p>\n<p>![License](LICENSE)<br \/>\n![Minecraft]()<br \/>\n![Java]()<br \/>\n![Version](CHANGELOG.md)<\/p>\n<p>&#8212;<\/p>\n<p>## \ud83c\udfaf Description<\/p>\n<p>MCLocalAuth is a security plugin for Minecraft servers that uses Discord as an authentication system. Protect your server by limiting access to only members of your Discord community.<\/p>\n<p>Works on **Spigot\/Paper** and **BungeeCord** \u2014 the Discord bot runs on both platforms with all features.<\/p>\n<p>### \ud83c\udfae How It Works<\/p>\n<p>1. **Player Connects** \u2192 Immediately disconnected with a unique code<br \/>\n2. **On Discord** \u2192 Type `\/mclogin <code>` (on server or in DMs with the bot)<br \/>\n3. **Bot Verifies** \u2192 Is the player a Discord member?<br \/>\n4. **If Yes** \u2192 IP registered, reconnection authorized \u2705<br \/>\n5. **If No** \u2192 Blocked \u274c<\/p>\n<p>---<\/p>\n<p>## \u2728 Features<\/p>\n<p>### \ud83d\udd10 Triple Layer Security<\/p>\n<p>- \u2705 **Discord Required**: Only members of your Discord can play<br \/>\n- \u2705 **Temporary Code**: Each connection generates a unique code that expires<br \/>\n- \u2705 **IP Protection**: One username = One IP \u2192 Impossible to steal identities<\/p>\n<p>### \ud83e\udd16 Integrated Discord Bot<\/p>\n<p>- Starts automatically with the server<br \/>\n- No external bot to host<br \/>\n- No network ports to open<br \/>\n- Native Discord slash commands<br \/>\n- **Works on Spigot\/Paper and BungeeCord**<br \/>\n- **Commands available in DMs** (globally registered)<br \/>\n- Automatic bot status verification at startup<\/p>\n<p>### \ud83d\udccb Discord Commands<\/p>\n<p>| Command | Description | Access |<br \/>\n|---------|-------------|--------|<br \/>\n| `\/mclogin <code>` | Authenticate with the code received in-game | Everyone |<br \/>\n| `\/mctest` | Test bot \u2194 plugin connection | Everyone |<br \/>\n| `\/status` | Check your authentication status | Everyone |<br \/>\n| `\/unlink <discord_id>` | Unlink an account | Admin |<br \/>\n| `\/mcadmin showips <player>` | View authorized IPs | Admin |<br \/>\n| `\/mcadmin addip <player> <ip>` | Add an authorized IP | Admin |<br \/>\n| `\/mcadmin removeip <player> <ip>` | Remove an authorized IP | Admin |<br \/>\n| `\/mcadmin resetip <player>` | Reset all IPs | Admin |<br \/>\n| `\/mcadmin setip <player> <ip>` | Set primary IP | Admin |<\/p>\n<p>> Admin commands are restricted to the Discord ID set in `admin.discord_id` in `config.yml`.<\/p>\n<p>### \u2699\ufe0f Admin Commands (in-game)<\/p>\n<p>| Command | Spigot\/Paper | BungeeCord |<br \/>\n|---------|--------------|------------|<br \/>\n| `\/auth showips <player>` | \u2705 | \u2705 |<br \/>\n| `\/auth addip <player> <ip>` | \u2705 | \u2705 |<br \/>\n| `\/auth removeip <player> <ip>` | \u2705 | \u2705 |<br \/>\n| `\/auth resetip <player>` | \u2705 | \u2705 |<br \/>\n| `\/auth setip <player> <ip>` | \u2705 | \u2705 |<\/p>\n<p>---<\/p>\n<p>## \ud83d\udce6 Installation<\/p>\n<p>### Prerequisites<\/p>\n<p>- Minecraft Server **1.8.9 to 26.1.1** (Spigot, Paper, Purpur) or **BungeeCord** (Build 2068)<br \/>\n- Java **8** minimum<br \/>\n- Discord Bot configured on Discord Developer Portal<\/p>\n<p>### Spigot \/ Paper<\/p>\n<p>1. **Download** `MCLocalAuth-Spigot-v1.4.0.jar`<br \/>\n2. **Place** the file in your server's `plugins\/` folder<br \/>\n3. **Start** the server to generate configuration<br \/>\n4. **Configure** the Discord bot in `plugins\/MCLocalAuth\/config.yml`:<\/p>\n<p>```yaml<br \/>\ndiscord:<br \/>\n  enabled: true<br \/>\n  bot_token: \"YOUR_DISCORD_BOT_TOKEN\"<br \/>\n  guild_id: \"YOUR_DISCORD_SERVER_ID\"<\/p>\n<p>admin:<br \/>\n  discord_id: \"YOUR_DISCORD_ID\"<br \/>\n```<\/p>\n<p>5. **Restart** the server<br \/>\n6. **Test** with `\/mctest` on Discord<\/p>\n<p>### BungeeCord<\/p>\n<p>1. **Download** `MCLocalAuth-Bungee-v1.4.0.jar`<br \/>\n2. **Place** the file in your proxy's `plugins\/` folder<br \/>\n3. **Start** the proxy to generate configuration<br \/>\n4. **Configure** `config.yml` (same options as Spigot)<br \/>\n5. **Restart** the proxy<br \/>\n6. **Test** with `\/mctest` on Discord<\/p>\n<p>---<\/p>\n<p>## \ud83d\udd27 Configuration<\/p>\n<p>### Discord Bot Setup<\/p>\n<p>1. Go to Discord Developer Portal<br \/>\n2. Create a new application<br \/>\n3. **Bot** tab \u2192 Create a bot<br \/>\n4. **Copy the token** (never share it!)<br \/>\n5. Enable these **Privileged Gateway Intents**:<br \/>\n   - \u2705 Server Members Intent<br \/>\n   - \u2705 Message Content Intent (optional)<br \/>\n6. **OAuth2 \u2192 URL Generator** tab:<br \/>\n   - Check `bot` and `applications.commands`<br \/>\n   - Permissions: `Administrator` (or custom)<br \/>\n7. **Invite** the bot to your server with the generated URL<\/p>\n<p>### Get Discord Server ID<\/p>\n<p>1. Enable **Developer Mode** in Discord:<br \/>\n   - Settings \u2192 Advanced \u2192 Developer Mode<br \/>\n2. Right-click on your server \u2192 **Copy Server ID**<br \/>\n3. Paste in `guild_id` in `config.yml`<\/p>\n<p>---<\/p>\n<p>## \ud83d\udcca Compatibility<\/p>\n<p>| Platform | Versions |<br \/>\n|----------|----------|<br \/>\n| **Paper** | 1.8.9 \u2192 26.1.1 \u2705 |<br \/>\n| **Spigot** | 1.8.9 \u2192 1.21.x \u2705 |<br \/>\n| **Purpur** | 1.8.9 \u2192 1.21.x \u2705 |<br \/>\n| **Pufferfish** | 1.8.9 \u2192 1.21.x \u2705 |<br \/>\n| **BungeeCord** | Build 2068 \u2705 |<\/p>\n<p>**Java:** 8+ (compiled with Java 8 for maximum compatibility)<br \/>\n**Note:** The plugin automatically detects your Minecraft version at startup.<\/p>\n<p>---<\/p>\n<p>## \ud83d\udc1b Report a Bug<\/p>\n<p>If you encounter a problem:<\/p>\n<p>1. Verify you're using the latest version<br \/>\n2. Check existing Issues<br \/>\n3. If the problem persists, open a new issue with:<br \/>\n   - Plugin version<br \/>\n   - Minecraft version<br \/>\n   - Server logs<br \/>\n   - Detailed problem description<\/p>\n<p>---<\/p>\n<p>## \ud83d\udca1 Suggest a Feature<\/p>\n<p>Have an idea? Open an issue with the `enhancement` tag!<\/p>\n<p>---<\/p>\n<p>## \ud83d\udcdc License<\/p>\n<p>This project is under **proprietary license**. See the LICENSE file for more details.<\/p>\n<p>**TL;DR:**<br \/>\n- \u2705 Free use on Minecraft servers<br \/>\n- \u2705 View code to learn<br \/>\n- \u274c No modification\/redistribution<br \/>\n- \u274c No commercial use<\/p>\n<p>---<\/p>\n<p>## \ud83d\ude4f Credits<\/p>\n<p>**Developer:** UNGEUR<\/p>\n<p>**Libraries used:**<br \/>\n- JDA - Java Discord API<br \/>\n- Spigot API - Minecraft Server API<br \/>\n- BungeeCord API - Proxy API<\/p>\n<p>---<\/p>\n<p>## \ud83d\udcde Support<\/p>\n<p>- **Discord:** Discord Server<br \/>\n- **Issues:** GitHub Issues<\/p>\n<p>---<\/p>\n<div align=\"center\">\n<p>**\u2b50 If this plugin is useful to you, don't hesitate to star it!**<\/p>\n<p>Made with \u2764\ufe0f for the Minecraft community<\/p>\n<\/div>\n","protected":false},"excerpt":{"rendered":"<p>MCLocalAuth is a security plugin for Minecraft servers that uses Discord as an authentication system. Protect your server by limiting access to only members of your Discord community.<\/p>\n","protected":false},"featured_media":99504,"template":"","meta":{"_minecraft_slug":"mclocalauth","_minecraft_project_id":"znkt8N7X","_minecraft_author":"UNGEUR","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":81,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mclocalauth.zip","_minecraft_size_bytes":54718731,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T20:08:49.492583Z","_minecraft_date_created":"2025-10-27T06:17:48.586546Z","_minecraft_date_modified":"2026-05-13T17:03:53.244365Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mclocalauth","_minecraft_icon_attachment_id":99504,"_minecraft_imported_at":"2026-06-05T17:13:11+00:00","_minecraft_import_hash":"4612d53442b4122a43f04862bbcdd49a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[894,90,127,128,129,92],"mod_loader":[895,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,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,31,860,861,862,863,864,83,167,163],"class_list":["post-99503","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bungeecord","mod_category-optimization","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bungeecord","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","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","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>MCLocalAuth - 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\/mclocalauth\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"MCLocalAuth - Minecraft\" \/>\n<meta property=\"og:description\" content=\"MCLocalAuth is a security plugin for Minecraft servers that uses Discord as an authentication system. Protect your server by limiting access to only members of your Discord community.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/mclocalauth\/\" \/>\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=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclocalauth\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclocalauth\\\/\",\"name\":\"MCLocalAuth - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclocalauth\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclocalauth\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/mclocalauth-icon-08f11da492bd142c13d96e6a2b8c7b2883616121_96.webp\",\"datePublished\":\"2026-06-05T17:13:11+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclocalauth\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclocalauth\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclocalauth\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/mclocalauth-icon-08f11da492bd142c13d96e6a2b8c7b2883616121_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/mclocalauth-icon-08f11da492bd142c13d96e6a2b8c7b2883616121_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/mclocalauth\\\/#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\":\"MCLocalAuth\"}]},{\"@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":"MCLocalAuth - 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\/mclocalauth\/","og_locale":"en_US","og_type":"article","og_title":"MCLocalAuth - Minecraft","og_description":"MCLocalAuth is a security plugin for Minecraft servers that uses Discord as an authentication system. Protect your server by limiting access to only members of your Discord community.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/mclocalauth\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/mclocalauth\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/mclocalauth\/","name":"MCLocalAuth - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/mclocalauth\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/mclocalauth\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/mclocalauth-icon-08f11da492bd142c13d96e6a2b8c7b2883616121_96.webp","datePublished":"2026-06-05T17:13:11+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/mclocalauth\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/mclocalauth\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/mclocalauth\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/mclocalauth-icon-08f11da492bd142c13d96e6a2b8c7b2883616121_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/mclocalauth-icon-08f11da492bd142c13d96e6a2b8c7b2883616121_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/mclocalauth\/#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":"MCLocalAuth"}]},{"@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\/99503","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\/99504"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=99503"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=99503"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=99503"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=99503"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}