Statfyr

StatFYR 1.0.0-BETA

Initial public beta release. 🎉

Added

• REST API with endpoints for player stats, summaries, and leaderboards
• /api/health — server health and version info
• /api/players — paginated player list with search and online filter
• /api/player/{player} — full stat access by UUID or name
• /api/player/{player}/summary — lightweight summary (playtime, combat, movement, activity)
• /api/leaderboard/{type} — ranked leaderboards for playtime, kills, deaths, mined, and crafted
• Bearer token API key authentication
• Per-IP rate limiting (default: 120 req/min)
• CORS support with configurable allowed origins
• IP whitelist support
• Optional HTTPS/TLS via Java keystore
• gzip response compression
• Async stat loading (zero main-thread impact)
• Response caching with configurable TTL
• Built-in interactive API docs at /api/docs
• Pagination, sorting, and filtering across all list endpoints

Tested On

• Paper 1.16.5
• Paper 1.21.10

Notes

• This is a beta release — bugs and breaking changes may occur before 1.0.0 stable
• For issues or feedback, join our Discord server