[1.16-1.19] ServerTap - 通过API获取玩家信息和操作服务器

插件简介

ServerTap 是一个支持 Bukkit、Spigot 和 Paper 服务器的 REST API 插件。 它允许通过 HTTP、Webhooks 和 Websockets 与服务器进行交互。

@Cnzw
该插件很适合用于 QQ 机器人和各种状态监测网页。

安装要求

• Bukkit/Spigot/Paper 或其分支：1.16.5 或更高版本
• Java：16 或更高版本
• 无前置插件
  

如何使用

将本插件文件复制到服务器的 plugins 文件夹中即完成了安装。

然后可以使用 Curl 或 Postman 或任意浏览器来访问 API。

例如，查询有关服务器信息的 API：

1. 
   
2. $ curl http: //localhost:4567/v1/server
   
3. {
   
4.     "name": "Paper",
   
5.     "motd": "This is my MOTD",
   
6.     "version": "git-Paper-89 (MC: 1.15.2)",
   
7.     "bukkitVersion": "1.15.2-R0.1-SNAPSHOT",
   
8.     "health": {
   
9.         "cpus": 4,
   
10.         "uptime": 744,
    
11.         "totalMemory": 2010644480,
    
12.         "maxMemory": 2010644480,
    
13.         "freeMemory": 1332389360
    
14.     },
    
15.     "bannedIps": [],
    
16.     "bannedPlayers": [{
    
17.         "target": "phybros",
    
18.         "source": "Server"
    
19.     }]
    
20. }
    

复制代码

或查询在线玩家列表的 API：

1. 
   
2. $ curl http://localhost:4567/v1/players
   
3. [{
   
4.     "uuid": "55f584e4-f095-48e0-bb8a-eb5c87ffe494",
   
5.     "displayName": "phybros",
   
6.     "address": "localhost",
   
7.     "port": 58529,
   
8.     "exhaustion": 3.5640976,
   
9.     "exp": 0.45454547,
   
10.     "whitelisted": false,
    
11.     "banned": false,
    
12.     "op": true
    
13. }]
    

复制代码

API 文档

插件自带 API 文档。可以在 http://服务器IP:4567/swagger 查看完整的 API 文档并且直接调试。

@Cnzw
我直接导出了API接口，在这里查看 。

API 验证

在 plugins/ServerTap/config.yml 文件中进行配置：

1. 
   
2. useKeyAuth: true
   
3. key: some-long-super-random-string
   

复制代码

然后，在需要在请求头（Header）中包含 key 和对应的密钥。

WebHook

ServerTap 可以在服务器上发生事件时发送 WebHook 消息。

要使用 WebHook，需要配置 plugins/ServerTap/config.yml 文件：

1. 
   
2. webhooks:
   
3.   default:
   
4.     listener: "https://your-webhook-target.com/whatever"
   
5.     events:
   
6.     - PlayerJoin
   
7.     - PlayerQuit
   

复制代码

目前可用的事件有：

• PlayerJoin
• PlayerDeath
• PlayerChat
• PlayerKick
• PlayerQuit
  

WebHook 通过 POST 请求发送 JSON 数据：

1. 
   
2. {
   
3.   "player": {
   
4.     "uuid": "55f584e4-f095-48e0-bb8a-eb5c87ffe494",
   
5.     "displayName": "phybros",
   
6.     "address": "localhost",
   
7.     "port": 52809,
   
8.     "exhaustion": 0,
   
9.     "exp": 0.5714286,
   
10.     "whitelisted": true,
    
11.     "banned": false,
    
12.     "op": true
    
13.   },
    
14.   "joinMessage": "§ephybros joined the game",
    
15.   "eventType": "PlayerJoin"
    
16. }
    

复制代码

Websockets

ServerTap 支持正向 WebSocket ，能够实时接收服务器日志。

一旦连接，服务器上通过正常日志过滤器的任何服务器日志行都会以类似这样的 JSON 对象形式通过 WebSocket 发送：

1. 
   
2. {
   
3.   "message": "§6/version: §fGets the version of this server including any plugins in use",
   
4.   "timestampMillis": 1631834015918,
   
5.   "loggerName": "",
   
6.   "level": "INFO"
   
7. }
   

复制代码

WebSocket 地址是 ws://服务器IP:4567/v1/ws/console。

最后 1000 条服务器日志消息将缓存并在客户端连接时发送。您可以通过更改 config.yml 中的 websocketConsoleBuffer 来配置服务器日志缓冲区的大小。

使用统计

更多

本插件已加入 插件搬运计划，会定期同步外网资源的更新。

搬运催更 & 问题反馈：快速响应问卷 或在下方留下评论。