statfyr.

About

Statistics shouldn't be trapped in a stats.json

Statfyr is a plugin by PotenFYR Studios that embeds a REST API directly inside your Minecraft server. It exists because player data has always been awkward to reach: buried in world/stats/<uuid>.json files, or locked behind plugins that only write to databases you'd have to mirror.

Instead of asking you to export anything, statfyr serves your server's statistics over HTTP the moment the plugin loads: live for online players, parsed from the vanilla stat files for offline ones. Nine vanilla statistic categories, computed summaries, leaderboards, Bearer auth, rate limiting, and gzip compression are all in the box.

Project status

Statfyr is a public beta (v1.0.0-BETA). The API surface is stable enough to build on, but endpoints and config keys can still change before 1.0. A handful of config keys are read but not yet enforced; each is flagged in the configuration reference.

License

Apache-2.0 with the Commons Clause: free to use, modify, and embed in your own projects, including commercial ones; the only thing you cannot do is sell Statfyr itself. Read the plain-terms summary on the license page. The license text in the repository is authoritative.

The studio

PotenFYR Studios builds tools for Minecraft communities: servers, sites, and the plumbing in between. Statfyr is part of a growing set of projects; more at potenfyr.in.

Talk to us