SpyWebSocket

插件

· 作者 Spy-1345a

SpyWebSocket 是一个轻量级的 Paper 插件,它提供了一个安全的 WebSocket API,用于远程与 Minecraft 服务器进行交互。

0 本站下载 0 关注 更新于 9 个月前

最新 1.0-SNAPSHOT · 1.21.11 · Bukkit / Paper

一键开服(送7天)

? SpyWebSocket

SpyWebSocket 是一个轻量级的 Paper 插件,它提供了一个安全的 WebSocket API,用于远程与 Minecraft 服务器进行交互。

它允许外部程序(如 Python 脚本、机器人或自动化工具)通过结构化的 JSON 消息进行身份验证、执行控制台命令并实时获取玩家数据。

该插件专为本地或受信任的网络环境设计,注重简洁性、灵活性和线程安全。

✨ 功能特性

? 身份验证系统 客户端在访问任何功能前必须进行身份验证。

? 内置 WebSocket 服务器 无需代理或外部服务。

? 线程安全的命令执行 所有命令均在 Minecraft 主线程上分发执行。

? 实时玩家坐标 API 获取所有在线玩家的所在世界和位置数据。

⚙️ 完全可配置 主机、端口、用户名和密码均可通过 config.yml 进行配置。

? 基于 JSON 的协议 简单且易于人类阅读的消息格式,便于集成。

⚙️ 配置文件 (config.yml) websocket: host: 127.0.0.1 port: 8765 username: admin password: strongpassword

⚠️ 安全警告: 请将服务器绑定到 127.0.0.1 或使用防火墙进行保护。 此插件允许远程执行控制台命令。

? 身份验证

在使用任何其他操作之前,客户端必须先进行身份验证。

➤ 请求

{
  "type": "auth",
  "username": "admin",
  "password": "strongpassword"
}

➤ 成功响应

{
  "type": "auth_ok"
}

➤ 失败响应

{
  "type": "auth_fail"
}

? 执行控制台命令

以服务器控制台的身份执行命令。

➤ 请求

{
  "type": "command",
  "command": "say Hello from WebSocket"
}

命令将在服务器主线程上安全地执行。

? 获取在线玩家坐标

返回所有在线玩家的位置和世界数据。

➤ 请求

{
  "type": "get_players"
}

➤ 响应

{
  "type": "players",
  "players": {
    "Notch": {
      "x": 123.45,
      "y": 64.0,
      "z": -98.32,
      "world": "world"
    },
    "Steve": {
      "x": -20.0,
      "y": 70.0,
      "z": 45.1,
      "world": "world_nether"
    }
  }
}

❌ 错误响应

如果请求无效或未授权,服务器将响应:

{
  "type": "error",
  "reason": "not_authenticated"
}

常见错误原因:

invalid_json

missing_type

unknown_type

not_authenticated

? 使用场景

Python 控制的 Minecraft 自动化

管理面板或监控工具

Twitch / 聊天集成

实时覆盖层或外部 UI

自定义审核工具

?️ 安全须知

只有经过身份验证的客户端才能发出命令或访问数据

仅适用于受信任的环境

不建议在没有额外保护的情况下用于面向公众的服务器

? 兼容性

平台:Paper

Minecraft 版本:1.21+

Java 版本:21

依赖处理:Shaded(Shadow JAR)

⚠️ 免责声明

此插件允许远程执行服务器控制台命令。 请负责任地使用,并且仅在你信任的服务器上部署。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源