跳到主要内容

游戏插件

游戏插件运行在服务端进程内,是面板读取玩家、聊天与游戏状态的唯一通道。没有插件时,面板仍可管理进程、文件与备份,但无法获取游戏内数据。

安装​

通过面板安装​

  1. 打开实例详情页。
  2. 在「插件」卡片点击「安装插件」。
  3. 面板会从内置资源写入 JIILScWebMangerPlugin.dll,并同步监听端口与访问令牌。
  4. 重启实例使插件生效。

安装后无需手动编辑服务端配置。

手动安装​

将发布包中的 JIILScWebMangerPlugin.dll 复制到服务端插件目录,通常为:

<服务端目录>/Plugins/JIILScWebMangerPlugin.dll

启动服务端后,从日志中确认插件已加载:

[ScWebManger] plugin loaded
[ScWebManger] HTTP server started on 127.0.0.1:18235

工作方式​

  • 插件只监听本机回环地址,不接受外部直接访问。
  • 面板通过守护进程获取实例端口,再使用共享令牌调用插件接口。
  • 插件重启或实例重启后,面板会自动重新连接,最长等待约 30 秒。

能力​

能力说明
玩家列表在线玩家、离线存档、基础属性
玩家操作踢出、击杀、治疗、血量、模式、背包、传送等
聊天记录实时聊天与系统消息
世界状态TPS、在线时长、天气与时间
控制台执行服务端命令并回传输出

端口冲突​

插件默认使用 18235。端口被占用时,会在 18235–18245 范围内自动选择空闲端口,并更新实例配置。面板会自动读取新端口,无需手动处理。

卸载​

  1. 停止实例。
  2. 删除服务端插件目录中的 JIILScWebMangerPlugin.dll。
  3. 启动实例。

卸载插件后,面板将无法显示该实例的游戏内数据,但进程与文件管理不受影响。

版本说明​

插件版本与面板版本独立。升级面板后,若「插件」卡片提示版本不一致,请重新点击「安装插件」并重启实例。