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.