MCLocalAuth v1.4.0

Type: Major Update - BungeeCord Discord Bot + Discord Admin Commands
Date: May 13, 2026
Status: STABLE ✅

---

✨ Major New Features

🤖 Discord Bot on BungeeCord

The Discord bot is now fully functional on BungeeCord.

• Complete Discord module added for the proxy
• Clean startup and shutdown with the BungeeCord plugin
• Automatic bot status verification after connection
• Displays bot name, ping, Discord server name, and member count

Example startup logs:

§1[§6MCLocalAuth§1]§r §a§l[OK] §aDiscord bot connected: MyBot#1234
§1[§6MCLocalAuth§1]§r §7Ping: §f42ms
§1[§6MCLocalAuth§1]§r §7Discord server: §fMy Server
§1[§6MCLocalAuth§1]§r §7Members: §f150

🛡️ New Discord /mcadmin Command

You can now manage player authorized IPs directly from Discord.

Subcommand	Description
/mcadmin showips <player>	Show authorized IPs
/mcadmin addip <player> <ip>	Add an IP
/mcadmin removeip <player> <ip>	Remove an IP
/mcadmin resetip <player>	Reset all IPs
/mcadmin setip <player> <ip>	Set the primary IP

Security:

• Restricted to the Discord ID set in admin.discord_id
• Unauthorized users receive an access denied message

📩 Discord Commands Available in DMs

Slash commands are now registered globally.

This means you can use them:

• On your Discord server
• In direct messages with the bot

🎨 Colored Console Output on Paper and BungeeCord

All important messages now use a colored prefix on both platforms:

§1[§6MCLocalAuth§1]§r

• Brackets in dark blue
• MCLocalAuth in orange
• Works on Paper/Spigot and BungeeCord consoles

🌐 /auth Command on BungeeCord

The BungeeCord proxy now has its own /auth admin command.

Available subcommands:

• /auth showips <player>
• /auth addip <player> <ip>
• /auth removeip <player> <ip>
• /auth resetip <player>
• /auth setip <player> <ip>

This allows managing authorized IPs from the proxy, across your entire network.

---

🐛 Important Fixes

⚠️ IP Commands Fixed

/auth setip <player> <ip>

• Before: Added the IP instead of replacing the primary one ❌
• After: Properly sets the primary IP and removes others ✅

/auth resetip <player>

• Before: Deleted ALL player data ❌
• After: Only clears the authorized IP list ✅

🔢 Guild ID Validation

The Discord bot now checks if guild_id is a valid numeric Discord snowflake.

• No more crash if guild_id contains an invalid value
• The plugin shows a clear error message instead of failing silently

🔍 Improved Player Lookup

Discord admin commands can now find a player:

• by name
• by full UUID

Player names are also saved with authentication entries for better lookups.

---

📊 Compatibility

Supported Versions

Platform	Versions
Paper	1.8.9 → 26.1.1 ✅
Spigot	1.8.9 → 1.21.x ✅
Purpur	1.8.9 → 1.21.x ✅
BungeeCord	Build 2068 ✅

Java: 8+
The plugin is compiled with Java 8 for maximum compatibility.

---

🔄 Migration from v1.3.x

1. Stop the server / proxy
2. Replace old JARs with the v1.4.0 versions
3. Configure discord.bot_token if needed
4. Add your admin Discord ID:

admin:
  discord_id: "YOUR_DISCORD_ID"

5. Restart

✅ Configuration compatible
✅ Player data preserved
✅ Existing Discord commands still work

---

📦 Technical Details

New Files

• BungeeDiscordBot.java
• BungeeDiscordCommandListener.java

Modified Files

• MCLocalAuthBungee.java
• DiscordBot.java
• DiscordCommandListener.java
• Storage.java
• BungeeStorage.java
• BungeePendingManager.java
• BungeeLoginListener.java
• AuthAdminCommand.java

Technical Improvements

• Added verifyBotStatus() to check actual bot state
• Added isOnline() to test if the bot is connected
• Added player lookup by name/UUID
• Global Discord command registration
• Improved console messages and error handling

---

💡 Discord Commands

Command	Description	Access
/mclogin <code>	Authenticate with code	Everyone
/mctest	Test bot/plugin connection	Everyone
/status	Check your status	Everyone
/unlink <discord_id>	Unlink an account	Admin
/mcadmin showips <player>	View authorized IPs	Admin
/mcadmin addip <player> <ip>	Add an IP	Admin
/mcadmin removeip <player> <ip>	Remove an IP	Admin
/mcadmin resetip <player>	Reset IPs	Admin
/mcadmin setip <player> <ip>	Set primary IP	Admin

---

⚙️ Minecraft Admin Commands

Command	Spigot/Paper	BungeeCord
/auth showips <player>	✅	✅
/auth addip <player> <ip>	✅	✅
/auth removeip <player> <ip>	✅	✅
/auth resetip <player>	✅ fixed	✅
/auth setip <player> <ip>	✅ fixed	✅

---

🚀 Installation

Spigot / Paper

1. Download MCLocalAuth-Spigot-v1.4.0.jar
2. Place in plugins/
3. Configure the Discord bot
4. Restart the server

BungeeCord

1. Download MCLocalAuth-Bungee-v1.4.0.jar
2. Place in plugins/
3. Configure the Discord bot
4. Restart the proxy

---

🐛 Known Issues

No known bugs at this time.

If you encounter a problem, check:

• Plugin version
• Discord token
• guild_id
• admin.discord_id value

---

Build: Maven 3.9.9 + Java 8
Status: STABLE ✅

Compatibility: Minecraft 1.8.9 → 26.1.1 (Paper & BungeeCord 2068)