🛡️ 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.

🎮 How It Works

1. Player Connects → Immediately disconnected with a unique code
2. On Discord → Type /mclogin <code>
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

📋 Discord Commands

• /mclogin <code> - Authenticate with the code received in-game
• /mctest - Test bot ↔ plugin connection
• /status - Check your authentication status
• /unlink <discord_id> - Unlink an account (admin only)

⚙️ Admin Commands (in-game)

• /auth showips <player> - Display authorized IPs
• /auth addip <player> <ip> - Add an IP
• /auth removeip <player> <ip> - Remove an IP
• /auth resetip <player> - Reset IPs
• /auth setip <player> <ip> - Set main IP

---

📦 Installation

Prerequisites

• Minecraft Server 1.8 to 1.21+ (Spigot, Paper, Purpur)
• Java 8 minimum
• Discord Bot configured on Discord Developer Portal

Steps

1. Download the latest .jar from Releases
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"

1. Restart the server
2. 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

Minecraft Version	Status
1.8 - 1.12	✅ Compatible
1.13 - 1.16	✅ Compatible
1.17 - 1.19	✅ Compatible
1.20+	✅ Compatible

Supported Servers: Spigot, Paper, Purpur, Pufferfish

---

🐛 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

---

📞 Support

• Discord: Discord Server
• Issues: GitHub Issues

---