simple-mc-api

Backend API for Simple MC.

Repo: https://github.com/bestzige/simple-mc-api
Plugin repo: https://github.com/bestzige/simple-mc-plugin

Relation

simple-mc-api stores player, wallet, and economy data.

simple-mc-plugin runs on the Minecraft server and calls this API.

Make sure these values match:

• API URL in the plugin: api.base-url
• API token in this repo: API_TOKEN
• Plugin token: api.token

Requirements

• Java 17+
• Docker or MariaDB

Setup

Copy-Item .env.example .env
docker compose up -d
.\mvnw.cmd spring-boot:run

Default API URL:

http://localhost:8080

Swagger:

http://localhost:8080/swagger-ui.html

Build

.\mvnw.cmd package

Main Endpoints

POST /api/players/sync
GET /api/players?uuid=<uuid>
GET /api/players?username=<username>
GET /api/wallets/{uuid}
POST /api/economy/transfer

Protected endpoints require:

Authorization: Bearer <API_TOKEN>