Backend API for Minecraft player data (skins, capes, profiles), Java/Bedrock server status and previews, with Redis caching and S3-compatible storage. Optional MaxMind GeoIP.
Use the API at mc.fascinated.cc/api.
- Java 25
- Redis
- S3-compatible storage (e.g. MinIO)
Optional: MaxMind license.
On first run without application.yml in the working directory, the app copies the default config and exits. Edit it (Redis, S3, public-url, and optionally MaxMind, metrics-token) and run again.
Local: mvn package then java -jar target/Minecraft-Utilities.jar (with application.yml in the current directory).
Docker: docker build -t mcutils-backend . then run the image; mount or override config as needed (e.g. bind-mount application.yml).
API documentation is available here or at /swagger-ui.html when running locally.
See LICENSE.