MCLocalAuth

🛡️ MCLocalAuth

Minecraft Authentication Plugin with Integrated Discord Bot

🎯 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.

Works on Spigot/Paper and BungeeCord — the Discord bot runs on both platforms with all features.

🎮 How It Works

1. Player Connects → Immediately disconnected with a unique code
2. On Discord → Type /mclogin <code> (on server or in DMs with the bot)
3. Bot Verifies → Is the player a Discord member?
4. If Yes → IP registered, reconnection authorized ✅
5. If No → Blocked ❌

✨ Features

🔐 Triple Layer Security

• ✅ Discord Required: Only members of your Discord can play
• ✅ Temporary Code: Each connection generates a unique code that expires
• ✅ IP Protection: One username = One IP → Impossible to steal identities

🤖 Integrated Discord Bot

• Starts automatically with the server
• No external bot to host
• No network ports to open
• Native Discord slash commands
• Works on Spigot/Paper and BungeeCord
• Commands available in DMs (globally registered)
• Automatic bot status verification at startup

📋 Discord Commands

Admin commands are restricted to the Discord ID set in admin.discord_id in config.yml.

⚙️ Admin Commands (in-game)

📦 Installation

Prerequisites

• Minecraft Server 1.8.9 to 26.1.1 (Spigot, Paper, Purpur) or BungeeCord (Build 2068)
• Java 8 minimum
• Discord Bot configured on Discord Developer Portal

Spigot / Paper

1. Download MCLocalAuth-Spigot-v1.4.0.jar
2. Place the file in your server's plugins/ folder
3. Start the server to generate configuration
4. Configure the Discord bot in plugins/MCLocalAuth/config.yml:

discord:
  enabled: true
  bot_token: "YOUR_DISCORD_BOT_TOKEN"
  guild_id: "YOUR_DISCORD_SERVER_ID"

admin:
  discord_id: "YOUR_DISCORD_ID"

1. Restart the server
2. Test with /mctest on Discord

BungeeCord

1. Download MCLocalAuth-Bungee-v1.4.0.jar
2. Place the file in your proxy's plugins/ folder
3. Start the proxy to generate configuration
4. Configure config.yml (same options as Spigot)
5. Restart the proxy
6. Test with /mctest on Discord

🔧 Configuration

Discord Bot Setup

1. Go to Discord Developer Portal
2. Create a new application
3. Bot tab → Create a bot
4. Copy the token (never share it!)
5. Enable these Privileged Gateway Intents:
   • ✅ Server Members Intent
   • ✅ Message Content Intent (optional)
6. OAuth2 → URL Generator tab:
   • Check bot and applications.commands
   • Permissions: Administrator (or custom)
7. Invite the bot to your server with the generated URL

Get Discord Server ID

1. Enable Developer Mode in Discord:
   • Settings → Advanced → Developer Mode
2. Right-click on your server → Copy Server ID
3. Paste in guild_id in config.yml

📊 Compatibility

Java: 8+ (compiled with Java 8 for maximum compatibility)
Note: The plugin automatically detects your Minecraft version at startup.

🐛 Report a Bug

If you encounter a problem:

1. Verify you're using the latest version
2. Check existing Issues
3. If the problem persists, open a new issue with:
   • Plugin version
   • Minecraft version
   • Server logs
   • Detailed problem description

💡 Suggest a Feature

Have an idea? Open an issue with the enhancement tag!

📜 License

This project is under proprietary license. See the LICENSE file for more details.

TL;DR:

• ✅ Free use on Minecraft servers
• ✅ View code to learn
• ❌ No modification/redistribution
• ❌ No commercial use

🙏 Credits

Developer: UNGEUR

Libraries used:

• JDA - Java Discord API
• Spigot API - Minecraft Server API
• BungeeCord API - Proxy API

📞 Support

• Discord: Discord Server
• Issues: GitHub Issues