MCLocalAuth v1.4.1 — Spigot / Paper / BungeeCord

Type: Update - Metrics, Update Checker, MySQL Storage
Date: July 3, 2026
Status: STABLE ✅
File: MCLocalAuth-v1.4.1.jar

---

✨ New Features

📊 bStats Metrics

bStats integration to track how many servers use the plugin.

• Anonymous and opt-out data collection
• Integrated on Bukkit/Spigot/Paper and BungeeCord
• View statistics: bstats.org

🔔 Update Checker

The plugin automatically checks at startup if a newer version is available on Modrinth.

• Async check (no startup impact)
• Smart version comparison (only notifies if the Modrinth version is higher)
• Colored console message with download link

🗄️ MySQL Storage (optional)

New option to store player data (IPs, names, logins) in a MySQL database instead of data.yml.

Configuration:

storage:
  type: "yaml"       # yaml or mysql
  mysql:
    host: "localhost"
    port: 3306
    database: "mclocalauth"
    username: "root"
    password: ""

Auto-created tables:

• mclocalauth_players — UUID, name, last IP, last login
• mclocalauth_ips — UUID + authorized IPs (unique key)

Benefits:

• Ideal for multi-server networks
• Shared data across all servers connected to the same database
• Automatic fallback to YAML if database is not configured

🎮 Geyser/Bedrock Support

• Automatic Bedrock player detection (name prefix + Floodgate UUID)
• Adapted kick message without color codes for Bedrock clients
• Configurable via geyser.enabled and geyser.prefix

🔗 Configurable Discord Link

• New discord.invite_link field in config.yml
• %discord_link% placeholder in kick messages

---

🔄 Automatic Migration

Existing configuration is automatically updated at startup:

• Adds storage: section if missing
• Adds discord.invite_link if missing
• Adds geyser: section if missing
• Adds Bedrock messages if missing

No manual action required for existing users.

---

📊 Compatibility

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

Java: 8+

---

🚀 Installation

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

---

🐛 Known Issues

No known bugs at this time.

---

Build: Maven 3.9.5 + Java 8
Status: STABLE ✅