EasyBot wiki

Appearance

EasyBot 旧版本迁移教程 ​

此教程适用场景

  • 1.1.0以下版本升级
  • 1.9.0以下插件升级

注意事项

  • 升级后会影响数据库，届时将无法使用旧版主程序
  • 本次升级建议使用手动更新包

更新日志 ​

请先看视频

建议您先观看教程，以了大概的步骤与版本的更新内容。

为何要更新？ ​

兼容性问题

插件因为兼容性问题非常难搞，1.8.0 以前的版本使用了一些与开发插件不太友好的库，导致与大多旧版或改版服务端冲突。

性能问题

旧版本插件使用GRPC协议进行通信，这种协议速度慢且占内存，并且经常掉线，十分不稳定。

新版本解决了吗? ​

新版本不仅解决了兼容性问题，还解决了性能问题，并且使用WebSocket协议进行通信，速度更快，占用更少内存。

1.9 以下的服务端兼容性问题

新版插件通过 RCON 调用命令执行功能
众所周知: RCON 是在 1.9 被引入的，所以插件的命令执行功能不再支持 1.9 以下的服务端。 除了命令执行功能，其他功能都兼容 1.9 以下服务端。

升级软件 ​

1.替换主程序 ​

下载1.2.0 版本的主程序手动更新包，注意别下错了奥~

下载

下载后将更新包内的所有文件解压缩替换到EasyBot主程序目录下。

下载

2.迁移主程序配置文件 ​

注意

如果你没有动过配置文件，则可以直接删除根目录下的appsettings.json文件，程序会创建默认配置。

  1. 拷贝 EasyBot 根目录下的appsettings.json文件，保存到其他地方。
  2. 拷贝后删除 EasyBot 根目录下的appsettings.json文件。
  3. 删除后重启 EasyBot 主程序，等待主程序创建默认配置文件。

新版本配置变化

json
{
  ...
  "AllowedHosts": "*"，
  "ServerOptions": {
    "Host": "127.0.0.1"，                //WebSocket服务器地址
    "Port": 26990，                      //WebSocket服务器端口
    "HeartbeatInterval": "0.00:02:00"   //服务器心跳，格式: 天.小时:分:秒
  }，
  "Kestrel": {
    "Endpoints": {
      "web_app": {
        "Url": "http://localhost:5000"， //面板地址
        "Protocols": "Http1"            //别改就完事了
      }
    }
  }
  ...
}

GRPC 配置已删除，因为新版本不再使用 GRPC 协议。

之后你可以根据旧版本的配置文件，将配置迁移到新版本的配置文件。

至此主程序迁移完毕。

升级插件 ​

1.备份旧版配置文件 ​

将旧版插件替换为新版后，备份旧版的配置文件。

IMG

2.升级配置 ​

IMG

URL如何设置?

IMG

OK ​

首次设置 Token 后需要重启服务器，之后的任何情况都可使用/easybot reload命令进行重载!