MCLocalAuth v1.4.1 — Velocity

Type: First Velocity Release - Metrics, Update Checker, MySQL Storage
Date: July 3, 2026
Status: ALPHA ⚠️
File: MCLocalAuth-Velocity-v1.4.1.jar

---

✨ New Features

🚀 Velocity Support

MCLocalAuth is now available on Velocity! Full standalone module.

• All features included (Discord bot, slash commands, IP authentication)
• Independent SnakeYAML configuration
• Compiled with Java 17 for Velocity 3.3.0+ compatibility

📊 bStats Metrics

bStats integration to track how many servers use the plugin.

• Anonymous and opt-out data collection
• 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)
• Console message with download link

🗄️ MySQL Storage (optional)

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 Velocity 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

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

---

📊 Compatibility

Platform	Versions
Velocity	3.3.0+ ✅

Java: 17+

---

🚀 Installation

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

---

🐛 Known Issues

No known bugs at this time.

---

Build: Maven 3.9.5 + Java 17
Status: ALPHA ⚠️