MCLocalAuth v1.3.1 - Changelog

Type: Compatibility Update
Date: January 2, 2026
Status: STABLE ✅

---

✨ New Features

🎮 Extended Compatibility: 1.8.9 → 1.21.11

The plugin now officially supports all Minecraft versions from 1.8.9 to 1.21.11!

Main improvements:

• Added VersionUtil utility class to automatically detect server version
• Intelligent Minecraft version detection at startup
• Enhanced log messages with detected version

At plugin startup, you'll now see:

[MCLocalAuth] ================================
[MCLocalAuth] MCLocalAuth v1.3.1 - Starting...
[MCLocalAuth] Detected Minecraft version: v1_20_R3
[MCLocalAuth] Compatibility: 1.8.9 - 1.21.11
[MCLocalAuth] ================================

---

🐛 Bug Fixes

🏃 PlayerMoveEvent Fix (Multi-version compatibility)

Problem solved: NPE (NullPointerException) on some versions when blocking movement

Before:

if (e.getFrom().getX() != e.getTo().getX() || ...)
    e.setTo(e.getFrom());

❌ Crashes if getTo() returns null on certain versions

After:

Location to = e.getTo();
Location from = e.getFrom();

if (to != null && (from.getX() != to.getX() || ...))
    e.setTo(from);

✅ Null check added to ensure compatibility

Impact: Unauthenticated players won't be able to move, without crash risk on any version

---

📊 Compatibility

Tested and Supported Versions

Minecraft Version	Status
1.8.9 - 1.12.2	✅ Compatible
1.13 - 1.16.5	✅ Compatible
1.17 - 1.19.4	✅ Compatible
1.20 - 1.21.11	✅ Compatible

Supported Servers: Spigot, Paper, Purpur, Pufferfish

Latest tested version: 1.21.11
Note: The plugin automatically detects your Minecraft version at startup

---

📦 Technical Changes

Modified Files

Java:

• MCLocalAuthPlugin.java - Enhanced startup logs with version detection
• RestrictListener.java - NPE fix on PlayerMoveEvent with null check
• VersionUtil.java - NEW - Version detection utility class

Configuration:

• plugin.yml - Version 1.3.1 + Updated description
• pom.xml - Version 1.3.1 + Updated description

Documentation:

• README.md - Updated badges and compatibility range
• CHANGELOG.md - Complete documentation of changes

---

🔄 Migration from v1.3.0

Simple and risk-free!

1. Stop the server
2. Replace the JAR with MCLocalAuth-Spigot-v1.3.1.jar
3. Restart the server

No configuration changes required!

✅ Existing configuration remains 100% compatible
✅ Player data is preserved
✅ No action required on Discord side

---

🎯 Why Update?

If you're using an old version (1.8.9 - 1.12.2)

✅ Recommended - Important compatibility fix to avoid crashes

If you're using a recent version (1.20+)

✅ Recommended - Better version detection and clearer logs

If you're on v1.3.0

⚠️ Optional but recommended - Improves stability on all versions

---

🛡️ Core Features (Unchanged)

All v1.3.0 features are preserved:

• ✅ Integrated Discord bot
• ✅ Authentication via /mclogin <code>
• ✅ IP protection per account
• ✅ Discord commands: /mclogin, /mctest, /status, /unlink (admin)
• ✅ Admin commands: authorized IP management
• ✅ Restrictions for unauthenticated players
• ✅ IPv4 & IPv6 support

---

🔍 VersionUtil Class Details

The new utility class provides:

VersionUtil.getVersion()      // Ex: "v1_20_R3"
VersionUtil.getMajorVersion() // Ex: 1
VersionUtil.getMinorVersion() // Ex: 20
VersionUtil.isVersion(1, 13)  // true if >= 1.13
VersionUtil.is1_8()           // true if 1.8.x
VersionUtil.is1_13Plus()      // true if >= 1.13
VersionUtil.is1_20Plus()      // true if >= 1.20
VersionUtil.is1_21Plus()      // true if >= 1.21

Purpose: Allows future code adaptations based on server version

---

🐛 Known Issues

No known bugs at this time.

If you encounter a problem:

1. Verify you're using v1.3.1
2. Check server logs (Minecraft version detected is displayed at startup)
3. Open an issue on GitHub with:
   • Plugin version
   • Minecraft version detected in logs
   • Problem description

---

💡 Discord Commands (Unchanged)

Command	Description	Access
/mclogin <code>	Authenticate with code	Everyone
/mctest	Test bot/plugin connection	Everyone
/status	Check your status	Everyone
/unlink <discord_id>	Unlink account	Admin only

---

🚀 Installation

1. Download MCLocalAuth-Spigot-v1.3.1.jar
2. Place in plugins/ folder
3. Restart server
4. Check logs: detected Minecraft version should be displayed
5. Test functionality with /mctest on Discord

---

File: MCLocalAuth-Spigot-v1.3.1.jar
Size: 11.20 MB
Build: Maven 3.9.9 + Java 8
Status: STABLE ✅

Compatibility: Minecraft 1.8.9 → 1.21.11