Statsly is a comprehensive statistics tracking plugin for Minecraft servers that automatically collects and reports server data to your Statsly dashboard.
- 📊 Automatic Statistics Collection - Tracks player counts, joins, leaves, and more
- 🎮 Version Detection - Detects player Minecraft versions using ViaVersion
- 🚀 Launcher Detection - Identifies Lunar Client, Badlion, LabyMod, and more
- 🔧 Mod Loader Detection - Detects Fabric, Forge, Quilt, and OptiFine
- 🔒 Secure Authentication - HMAC-SHA256 signature for all API requests
- ⚡ Lightweight - Minimal performance impact on your server
- 🔄 Auto-Sync - Automatically sends statistics every 30 minutes
- ✅ Spigot - All versions 1.21+
- ✅ Paper - All versions 1.21+
- ✅ PurpurMC - All versions 1.21+
- ✅ CraftBukkit - All versions 1.21+
Note: For Folia/CanvasMC servers, use Statsly-Folia instead.
- Minecraft Server: 1.21 or higher
- Java: 21 or higher
- Download the latest
Statsly-1.0.jarfrom https://statsly.org/versions - Place the JAR file in your server's
plugins/folder - Start your server
- Run
/statsly setup <code>with your setup code from the dashboard - Confirm the connection in your Statsly dashboard
/statsly setup <code>
Replace <code> with the setup code from your Statsly dashboard.
/statsly- Main command/stx- Short alias
The plugin automatically creates a config.yml file in the plugins/Statsly/ directory:
serverUuid: "" # Automatically set during setup- Current player count
- Player joins/leaves since last report
- Minecraft version distribution (with ViaVersion)
- Client launcher distribution
- Mod loader distribution
- Server software type
- Server uptime
The plugin communicates with the Statsly backend API:
POST /api/servers/validate-code- Validates setup codeGET /api/servers/code/:code- Checks connection statusPOST /api/servers/get-secret- Retrieves API secretPOST /api/servers/stats- Sends statistics (every 30 minutes)
All requests are authenticated using HMAC-SHA256 signatures.
./gradlew buildThe compiled JAR will be in build/libs/.
- Spigot API 1.21-R0.1-SNAPSHOT
- ViaVersion (optional, for multi-version support)
- Verify the server is connected: Check if
serverUuidis set inconfig.yml - Check API connection: Ensure the Statsly backend is running on
https://api.statsly.org - Verify IP/Port: Make sure your server IP and port match the registered values (Open Support Ticket for that)
- Check logs: Look for error messages in
logs/latest.log
- The server IP doesn't match the registered IP
- Verify your server's IP and port in the dashboard
- Re-run
/statsly setup <code>if needed
This project is proprietary software. All rights reserved.
If you encounter any bugs or issues with the plugin, please:
- Open a ticket on statsly.org (recommended)
- Or contact us on our Discord server
Note: I'm relatively new to plugin development, so your patience and detailed bug reports are greatly appreciated!
We welcome contributions! We're especially looking for help with:
- Plugin Updates: Keeping plugins compatible with newer Minecraft/server versions
- Legacy Support: Creating plugin versions for older Minecraft versions
If you'd like to help, please:
- Open a ticket on statsly.org describing what you'd like to contribute
- We'll discuss the details and coordinate the work
Your contributions help make Statsly better for everyone!
Made with ❤️ by the Statsly Team