Skip to content

Windows部署教程

第一步:安装机器人框架

确保您已经安装部署了机器人框架,如 LLOneBot 等。

第二步:下载 SakBot

通过 下载列表 获取对应版本。如果下载速度缓慢,可添加 QQ交流群 获取。

Windows 版本

  • SakBot_Windows — 精简版
  • SakBot_Windows_Complete — 完整版

第三步:下载并解压

下载对应版本后,将压缩包解压到任意目录(建议路径不含中文和空格)。

启动 SakBot

双击 SakBot.exe 即可启动,首次启动会自动:

  • 创建 Data/ 目录,生成数据库文件

访问管理面板

启动成功后,浏览器访问 http://localhost:5100 进入 Web 管理面板。

第四步:配置机器人框架连接

进入管理面板后,前往"设置 → 机器人配置"页面,配置机器人框架的 WebSocket 正向连接。支持自动重连,直到左侧显示"已连接"即代表连接成功。

机器人配置

第五步:安装并配置 Minecraft 插件

前往 SakBot-Minecraft 插件下载 下载对应版本的 Minecraft 插件,并放入服务器 plugins 目录内。

首次运行后会在 plugins 目录创建一个名为 SakBot 的文件夹,在文件夹内编辑 config.yml

yaml
# SakBot Minecraft 插件配置文件
# 支持 1.9 - 最新所有版本服务器核心

# 是否启用白名单验证(进服时校验玩家是否在白名单中且已授权)
whitelist-check: true

# SakBot 后端 WebSocket 地址
# 格式: ws://IP:端口
url: "ws://192.168.2.5:5100" # 一定要是 SakBot 的地址!!!

# 从后台"服务器管理"页面获取的 Token 密钥(必填!)
token: ""

第六步:服务器创建

打开 SakBot 管理面板,在"服务器管理"页面点击创建按钮:

创建服务器

输入服务器名后自动生成 Token,将 Token 复制到 config.yml 文件中对应的位置:

yaml
# 从后台"服务器管理"页面获取的 Token 密钥(必填!)
token: "这里粘贴生成的Token"

配置完成后重启 Minecraft 服务器,查看服务器控制台是否连接上 SakBot。如果显示如下日志则代表连接成功:

[16:22:14 INFO]: [SakBot] [SakBot] WebSocket 已连接到 SakBot 服务器
[16:22:14 INFO]: [SakBot] 已成功连接到 SakBot!
[16:22:14 INFO]: [SakBot] [SakBot] 当前 chatFormat 状态: 『{server}』{title}{name}: {message}
[16:22:14 INFO]: [SakBot] 已接收密码登录配置: 已启用
[16:22:14 INFO]: [SakBot] 已接收跨服聊天格式模板: 『{server}』{title}{name}: {message}
[16:22:14 INFO]: [SakBot] 已接收玩家称号数据: 106 条
[16:22:14 INFO]: [SakBot] [SakBot][TAB] 已启用跨服TAB,组: TAB组,组内服务器数: 2
[16:22:14 INFO]: [SakBot] 已接收自定义加入/退出消息配置: 已启用
[16:22:14 INFO]: [SakBot] 已成功向 SakBot 注册!

第七步:开启群聊监听

前往 SakBot 管理面板的"群聊管理"页面,开启对应群聊的命令监听。

群聊管理

第八步:测试白名单绑定

确认已开启白名单配置内的绑定功能后,在 QQ 群内发送 #绑定 玩家名。如果触发成功并且可以正常进入服务器,则代表部署成功!

白名单配置