ExAPI

ExAPI – Secure HTTP Bridge for Minecraft Servers

Paper by Paper is a production-ready API bridge for Paper servers running Paper 1.19+ (tested on 1.21.5).

It allows external apps like Discord bots, dashboards, and AI services to securely request real-time server data through configurable HTTP endpoints.

✦ Key Features

• Embedded HTTP server inside the plugin • Secure API key authentication (Bearer token) • Fully configurable endpoints in `config.yml` • Field-level data toggles per endpoint • Optional Vault economy support • Rate limiting per IP • Optional IP whitelist • Bind to localhost for extra security • Async-safe execution • Clean architecture & scalable codebase • JSON responses for easy integration

✦ Supported Endpoints

All endpoints can be enabled or disabled individually.

• `/server` – MOTD, version, players, max players • `/players` – Online player list • `/player/{uuid}` – Detailed player info • `/tps` – Server TPS • `/economy/{player}` – Balance (if Vault installed) • `/plugins` – Installed plugins • `/custom` – User-defined data

✦ Player Data Options

Each field can be toggled in config:

• Username • UUID • Health • Food • Location • World • Gamemode • Ping • Permissions

✦ Security

• API key required for all requests • Rate limiting • Optional IP whitelist • Localhost-only binding • No main-thread blocking

Designed for public dashboards and bot integrations without exposing your server.

✦ Example Use Cases

• Discord bot showing server stats • Web dashboard with live player info • AI admin assistant reading server data • Network monitoring tools • Mobile app server status

✦ Example Request

```bash GET /server Authorization: Bearer YOUR_API_KEY ```

Response:

```json { "motd": "Welcome", "version": "1.21.5", "onlinePlayers": 12, "maxPlayers": 100 } ```

✦ Requirements

• Java 17+ • Paper / Spigot 1.19+ • Optional: Vault for economy

✦ Why ExAPI?

Most plugins expose data through commands or unsafe sockets. ExAPI provides a clean, secure, configurable HTTP API designed for real integrations.

- Credits to serenestriker_ for giving the idea!