WebConsoleServer
一款通过 WebSocket 连接暴露服务器控制台的 Minecraft 插件。专为 groupez.dev(付费插件的测试服务器生成器)构建。
功能特性
- 通过 WebSocket 实时流式传输控制台日志
- 密码保护的身份验证
- 日志历史记录持久化(客户端连接时加载之前的日志)
- 支持 Spigot/Paper 和 Velocity 平台
- 包含用于快速测试的测试网页
支持的平台
| 平台 | Minecraft 版本 | Java 版本 |
|---|---|---|
| Spigot/Paper | 1.8.8+ | Java 8+ |
| Velocity | 3.3.0+ | Java 21+ |
测试网页
web/ 文件夹中包含一个测试网页。在浏览器中打开 web/index.html 以连接到 WebSocket 服务器并实时查看控制台日志。
安装
- 从 Modrinth 下载适合你平台的 JAR 文件
- 将 JAR 文件放入服务器的
plugins文件夹 - 重启服务器
- 在
plugins/WebConsoleServer/config.properties(Velocity)或plugins/WebConsoleServer/config.yml(Spigot)中配置插件
配置
# WebSocket 服务器绑定的 IP 地址(使用 0.0.0.0 绑定所有接口)
websocket-host=0.0.0.0
# WebSocket 服务器的端口
websocket-port=8765
# WebSocket 身份验证的密码(留空表示不进行身份验证)
websocket-password=changeme
# 保留在历史记录中的最大日志行数
max-log-history=500
WebSocket 协议
身份验证流程
- 客户端连接到
ws://host:port - 服务器发送
{"type":"auth_required"} - 客户端发送
{"type":"auth","password":"your_password"} - 服务器响应
{"type":"auth_success"}或{"type":"auth_failed"} - 成功后,服务器发送日志历史记录,随后发送
{"type":"history_complete"}
消息类型
| 类型 | 方向 | 描述 |
|---|---|---|
auth_required |
服务器 → 客户端 | 需要身份验证 |
auth |
客户端 → 服务器 | 带有密码的身份验证请求 |
auth_success |
服务器 → 客户端 | 身份验证成功 |
auth_failed |
服务器 → 客户端 | 身份验证失败 |
log |
服务器 → 客户端 | 控制台日志消息 |
history_complete |
服务器 → 客户端 | 所有历史日志已发送完毕 |
日志消息格式
{"type":"log","message":"[12:34:56] [INFO] [ServerName]: Your log message here"}
从源代码构建
# 构建所有模块
./gradlew build
# 输出的 JAR 文件位于 target/ 目录下
# - WebConsoleServer-Spigot-1.0.jar
# - WebConsoleServer-Velocity-1.0.jar
在 Windows 上,请使用 gradlew.bat 代替 ./gradlew。
许可证
MIT License
链接
- groupez.dev - 付费插件的测试服务器生成器
- Github - 源代码
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
WorldEdit
me4502
一个在游戏内运行的 Minecraft 地图编辑器! 支持选区、蓝图、复制粘贴、笔刷和脚本。 可在创造模式中使用,也可在生存模式中临时使用。
前置管理
10
LobbyAPI
Zombie_Striker_Dev
创建用户友好的菜单以前往不同的世界
管理交通
9
tkChat
tkkr
专为 Velocity 打造的自制聊天插件,功能丰富——支持跨服群组/全局/私聊消息,并集成 LibertyBans 的禁言功能。
管理社交
9
评论 0
登录后参与评分
还没有评论,来抢沙发吧