mcstats

MC Stats Mod

A server-side Fabric mod that tracks player statistics and pushes them to an external database. Works with vanilla clients — players don’t install anything.

What it tracks

• All vanilla stats: blocks broken/placed, items used/crafted, kills, deaths, damage, movement, time played, etc.
• Natural-mined blocks: distinguishes blocks broken from world generation vs. blocks placed by players. Quest systems can’t be cheesed by placing and re-mining cobblestone.
• Custom stats: deaths by cause, enchantments performed, unique biomes visited, totem uses, sleep count, highest single hit.

Where it sends data

Pick one in the config:

| Backend | Use for |
|———|———|
| logging | Testing — prints to server console |
| sqlite | Single-server setup, zero config |
| mysql | Sharing data across multiple services |
| webhook | Custom dashboards, Discord bots, analytics — POSTs JSON to any URL |

Setup

1. Drop the jar in your server’s mods/ folder (alongside Fabric API).
2. Start the server once — it generates config/mcstats.json.
3. Edit the config, restart.

That’s it. Default config logs to console so you can verify it’s working before wiring up a database.

Why use this instead of a Discord-stats mod?

Most stat mods are coupled to one output (a specific Discord bot, a specific overlay). This one is a neutral push — your endpoint receives JSON, you decide what to do with it. Build a leaderboard site, a Grafana dashboard, a quest plugin, an MMO economy tracker — the mod
doesn’t care.

Links

• Full documentation, config reference, troubleshooting: GitHub
• Issues / feature requests: GitHub Issues
• License: CC0 1.0 — public domain.