- 版权类型
- 原创
- 版权链接
- #
[MD]
# MinecraftBot
一个提供HTTP API的Minecraft模组。
## 功能特性
- 🌐 **HTTP API服务器** - 内置轻量级HTTP服务器
- 👥 **在线玩家信息** - 获取当前在线玩家列表、在线时长和详细信息
- ⏱️ **玩家在线时长** - 实时显示每个玩家的在线时长
- ⚡ **TPS监控** - 实时获取服务器TPS
- 💾 **内存监控** - 详细的内存使用情况
- 📊 **服务器状态** - 综合的服务器状态信息
## 支持的平台
- **模组加载器**: Forge
- **Minecraft版本**: 1.20.1
## 安装
1. 下载最新的 `MinecraftBot-x.x.x.jar`
2. 将jar文件放入服务器的 `mods` 文件夹
3. 启动服务器
## 配置
配置文件位于 `config/minecraftbot.properties`，首次启动会自动创建。
```properties
# HTTP服务器配置
http.host=0.0.0.0
http.port=8080
http.cors.enabled=true
# 安全配置
security.apiKey=
security.ipWhitelist=
security.rateLimit=100
# 缓存配置
cache.duration=1000
# 日志配置
logging.enabled=true
```
## API接口
### 基础响应格式
```json
{
"code": 0,
"msg": "success",
"data": { ... }
}
```
### 接口列表
| 接口 | 方法 | 描述 |
|------|------|------|
| `/` | GET | API信息和端点列表 |
| `/online` | GET | 在线玩家信息 |
| `/online?details=true` | GET | 在线玩家详细信息 |
| `/tps` | GET | 服务器TPS信息 |
| `/memory` | GET | 内存使用信息 |
| `/status` | GET | 服务器状态信息 |
| `/status?players=true` | GET | 服务器状态（含玩家列表） |
[/MD]
