HyRESTAPI

HyRESTAPI

HyRESTAPI 是一个 Hytale 服务器模组，它通过 HTTP 端点提供 REST API，用于管理玩家、执行服务器命令和监控服务器状态。

实用

HyRESTAPI 是一款 Hytale 服务器模组，提供 REST API，用于通过 HTTP 端点管理玩家、执行服务器命令以及监控服务器状态。

HyRESTAPI 安装

  1. 将 HyRESTAPI-x.x.x.jar 放置在服务器的 mods 文件夹中。
  2. 启动服务器以生成默认配置文件。
  3. 在 http://localhost:8080/api/health 测试 API 是否就绪。

端点

  • GET /api/health - 检查 API 状态
  • GET /api/server/status - 获取服务器信息
  • GET /api/players - 列出所有在线玩家
  • GET /api/players/{name} - 获取特定玩家信息
  • POST /api/players/{name}/give - 给予玩家物品
  • POST /api/players/{name}/kick - 踢出玩家
  • POST /api/players/{name}/ban - 封禁玩家
  • POST /api/players/{name}/unban - 解封玩家
  • POST /api/broadcast - 向所有玩家发送消息
  • POST /api/command - 执行服务器命令

使用示例

给予物品 (向玩家给予烈焰长剑)

请将 <name> 替换为您的用户名。

curl -X POST http://localhost:8080/api/players/<name>/give \
  -H "X-API-Key: changeme" \
  -H "Content-Type: application/json" \
  -d '{"item": "Weapon_Longsword_Flame", "amount": 1}'

广播服务器消息

curl -X POST http://localhost:8080/api/broadcast \
  -H "X-API-Key: changeme" \
  -H "Content-Type: application/json" \
  -d '{"message": "hello world"}'