ExAPI

ExAPI – Secure HTTP Bridge for Minecraft Servers

ExAPI by ExStudios is a production-ready API bridge for Minecraft 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

GET /server
Authorization: Bearer YOUR_API_KEY

Response:

{
  "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!