游戏插件
游戏插件运行在服务端进程内,是面板读取玩家、聊天与游戏状态的唯一通道。没有插件时,面板仍可管理进程、文件与备份,但无法获取游戏内数据。
安装
通过面板安装
- 打开实例详情页。
- 在「插件」卡片点击「安装插件」。
- 面板会从内置资源写入
JIILScWebMangerPlugin.dll,并同步监听端口与访问令牌。 - 重启实例使插件生效。
安装后无需手动编辑服务端配置。
手动安装
将发布包中的 JIILScWebMangerPlugin.dll 复制到服务端插件目录,通常为:
<服务端目录>/Plugins/JIILScWebMangerPlugin.dll
启动服务端后,从日志中确认插件已加载:
[ScWebManger] plugin loaded
[ScWebManger] HTTP server started on 127.0.0.1:18235
工作方式
- 插件只监听本机回环地址,不接受外部直接访问。
- 面板通过守护进程获取实例端口,再使用共享令牌调用插件接口。
- 插件重启或实例重启后,面板会自动重新连接,最长等待约 30 秒。
能力
| 能力 | 说明 |
|---|---|
| 玩家列表 | 在线玩家、离线存档、基础属性 |
| 玩家操作 | 踢出、击杀、治疗、血量、模式、背包、传送等 |
| 聊天记录 | 实时聊天与系统消息 |
| 世界状态 | TPS、在线时长、天气与时间 |
| 控制台 | 执行服务端命令并回传输出 |
端口冲突
插件默认使用 18235。端口被占用时,会在 18235–18245 范围内自动选择空闲端口,并更新实例配置。面板会自动读取新端口,无需手动处理。
卸载
- 停止实例。
- 删除服务端插件目录中的
JIILScWebMangerPlugin.dll。 - 启动实例。
卸载插件后,面板将无法显示该实例的游戏内数据,但进程与文件管理不受影响。
版本说明
插件版本与面板版本独立。升级面板后,若「插件」卡片提示版本不一致,请重新点击「安装插件」并重启实例。