Changelog

Changelog

All notable changes to Statfyr are documented here.

---

1.0.0-BETA

Initial public beta release.

Added

• REST API with full player statistics access
• GET /api/health — server health and version info
• GET /api/players — paginated player list with search and online filter
• GET /api/player/{player} — full stat access by UUID or name
• GET /api/player/{player}/summary — lightweight summary with combat, movement, and activity sections
• GET /api/leaderboard/{type} — ranked leaderboards for playtime, kills, deaths, mined, and crafted
• Bearer token API key authentication
• Per-IP rate limiting (default: 120 req / 60s)
• 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)
• In-memory response caching with configurable TTL and refresh interval
• Built-in interactive API docs at /api/docs
• Pagination, sorting, and filtering across all list endpoints
• Environment variable overrides for api-key and keystore-password
• /statfyr reload, /statfyr status, /statfyr version commands

Tested On

• Paper 1.16.5
• Paper 1.21.10

Notes

• This is a beta release — the API shape and config format may change before 1.0.0 stable
• Please report bugs and feedback in the Discord or via GitHub Issues

---

Versions will be added here as they are released.