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
- Drop the jar in your server's
mods/folder (alongside Fabric API). - Start the server once — it generates
config/mcstats.json. - 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.
