AppleBridge Paper

AppleBridge Paper is a lightweight plugin for Paper servers that exposes a secure HTTP API for remote server automation.

It is designed for external tools such as Discord bots, web panels, scripts, and private integrations that need to interact with a Minecraft server without adding heavy dependencies.

With AppleBridge, you can:

• execute Minecraft console commands remotely
• read recent server logs through HTTP
• connect your server to a Discord bot or other external service
• keep everything protected with a secret token

Features

• Built-in HTTP API
• Lightweight and simple setup
• POST /execute for remote command execution
• GET /logs for recent console log output
• Authorization header protection
• /applebridge reload
• /applebridge status

Security

All API requests require a secret token through the Authorization header.

If the token is invalid or missing, the request is rejected with 403 Forbidden.

Because this plugin can execute console commands, you should:

• use a strong random secret
• never share it publicly
• restrict access in your Discord bot or external tool
• avoid exposing the API unless necessary

Example Use Cases

• Discord bot command to send messages into Minecraft
• Remote admin command execution
• Reading recent server logs from an external tool
• Private web panel or automation integration

Compatibility

This project is available in separate builds for different Paper version ranges:

• 1.16.x-1.18.x
• 1.19.x-1.21.x

Tested on:

• 1.16.5
• 1.17.1
• 1.18.2
• 1.19.4
• 1.20.6
• 1.21.x

It should also work on Purpur for the same version ranges.

Notes

AppleBridge does not include Discord bot code by itself.

It only provides the HTTP bridge that external tools can use.