AppleBridge Paper
AppleBridge Paper 是一款面向 Paper 服务器的轻量级插件,提供安全的 HTTP API 以实现远程服务器自动化。
它专为需要与 Minecraft 服务器交互的外部工具而设计,例如 Discord 机器人、网页面板、脚本和私有集成方案,且无需引入繁重的依赖项。
使用 AppleBridge,你可以:
- 远程执行 Minecraft 控制台命令
- 通过 HTTP 读取最近的服务器日志
- 将你的服务器连接到 Discord 机器人或其他外部服务
- 通过密钥令牌保护一切安全
功能特性
- 内置 HTTP API
- 轻量级且设置简单
POST /execute 用于远程命令执行
GET /logs 用于获取最近的控制台日志输出
Authorization 标头认证保护
/applebridge reload
/applebridge status
安全性
所有 API 请求均需通过 Authorization 标头提供密钥令牌。
如果令牌无效或缺失,请求将被拒绝并返回 403 Forbidden(禁止访问)。
由于此插件可以执行控制台命令,你应当:
- 使用强随机密钥
- 切勿公开分享该密钥
- 在 Discord 机器人或外部工具中限制访问权限
- 除非必要,否则避免暴露该 API
示例用例
- 通过 Discord 机器人命令向 Minecraft 发送消息
- 远程管理员命令执行
- 从外部工具读取最近的服务器日志
- 私有网页面板或自动化集成
兼容性
本项目针对不同 Paper 版本范围提供独立的构建版本:
1.16.x-1.18.x
1.19.x-1.21.x
已在以下版本测试:
1.16.5
1.17.1
1.18.2
1.19.4
1.20.6
1.21.x
它也应能在相同版本范围内的 Purpur 服务器上正常运行。
备注
AppleBridge 本身不包含 Discord 机器人的代码。
它仅提供供外部工具使用的 HTTP 桥接接口。
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧