# 🛡️ MCLocalAuth **Minecraft Authentication Plugin with Integrated Discord Bot** [![License](https://img.shields.io/badge/License-Proprietary-red.svg)](LICENSE) [![Minecraft](https://img.shields.io/badge/Minecraft-1.8.9--26.1.1-green.svg)]() [![Java](https://img.shields.io/badge/Java-8+-blue.svg)]() [![Version](https://img.shields.io/badge/Version-1.4.0-blue.svg)](CHANGELOG.md) --- ## 🎯 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

` (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

| Command | Description | Access |
|---------|-------------|--------|
| `/mclogin ` | Authenticate with the code received in-game | Everyone |
| `/mctest` | Test bot ↔ plugin connection | Everyone |
| `/status` | Check your authentication status | Everyone |
| `/unlink ` | Unlink an account | Admin |
| `/mcadmin showips ` | View authorized IPs | Admin |
| `/mcadmin addip  ` | Add an authorized IP | Admin |
| `/mcadmin removeip  ` | Remove an authorized IP | Admin |
| `/mcadmin resetip ` | Reset all IPs | Admin |
| `/mcadmin setip  ` | Set primary IP | Admin |

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

### ⚙️ Admin Commands (in-game)

| Command | Spigot/Paper | BungeeCord |
|---------|--------------|------------|
| `/auth showips ` | ✅ | ✅ |
| `/auth addip  ` | ✅ | ✅ |
| `/auth removeip  ` | ✅ | ✅ |
| `/auth resetip ` | ✅ | ✅ |
| `/auth setip  ` | ✅ | ✅ |

---

## 📦 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](https://discord.com/developers/applications)

### 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`:

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

admin:
  discord_id: "YOUR_DISCORD_ID"
```

5. **Restart** the server
6. **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](https://discord.com/developers/applications)
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

| Platform | Versions |
|----------|----------|
| **Paper** | 1.8.9 → 26.1.1 ✅ |
| **Spigot** | 1.8.9 → 1.21.x ✅ |
| **Purpur** | 1.8.9 → 1.21.x ✅ |
| **Pufferfish** | 1.8.9 → 1.21.x ✅ |
| **BungeeCord** | Build 2068 ✅ |

**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](https://github.com/UNGEUR/MCLocalAuth/issues)
3. If the problem persists, [open a new issue](https://github.com/UNGEUR/MCLocalAuth/issues) with:
   - Plugin version
   - Minecraft version
   - Server logs
   - Detailed problem description

---

## 💡 Suggest a Feature

Have an idea? [Open an issue](https://github.com/UNGEUR/MCLocalAuth/issues) with the `enhancement` tag!

---

## 📜 License

This project is under **proprietary license**. See the [LICENSE](https://github.com/UNGEUR/MCLocalAuth/blob/main/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](https://github.com/discord-jda/JDA) - Java Discord API
- [Spigot API](https://www.spigotmc.org/) - Minecraft Server API
- [BungeeCord API](https://www.spigotmc.org/wiki/bungeecord/) - Proxy API

---

## 📞 Support

- **Discord:** [Discord Server](https://discord.gg/hPUhadNQXn)
- **Issues:** [GitHub Issues](https://github.com/UNGEUR/MCLocalAuth/issues)

---



**⭐ If this plugin is useful to you, don't hesitate to star it!**

Made with ❤️ for the Minecraft community

UNGEUR

MCLocalAuth

Информация