LLOneBot 框架使用教程：第二步 - 下载 QQNT

步骤 1：访问 QQNT 官方下载页

步骤 2：定位并下载 QQNT 安装包

1. 页面会自动适配你的操作系统（Windows），找到标注 “QQ NT 版” 的下载入口（通常在页面核心区域，带有 “下载” 按钮标识）；
2. 点击 “下载” 按钮，系统将自动开始下载最新版本的 QQNT 安装包；
3. 等待下载完成（文件大小约数百 MB，速度取决于网络环境）。

 

LLOneBot 框架使用教程：第三步 - 登录QQNT并配置LLoneBot

1. 以管理员身份运行llbot.exe

随后点击启动，后登录qqnt 登录成功后即可看到如下界面

点击Bot配置 开启WebUi 开启WebSocket 随后保存

LLOneBot 框架使用教程：第四步 - 配置服务器内插件

步骤 1：下载并解压资源包

1. 点击下方链接下载插件资源包：

点击下载👉

 

步骤 2：修改核心插件配置文件

（1）配置 xinxinbotapi 插件

1. 打开「xinxinbotapi」文件夹，找到并双击打开 config.yml；
2. 找到文件中指定的两处配置项（参考教程中的配置图），务必准确填写对应端口（端口需与之前服务器配置一致，否则无法连接）；
3. 保存文件并关闭编辑器。

（2）配置 xinxinbotcommand 插件

1. 进入「xinxinbotcommand」文件夹，打开其下的 config.yml；
2. 找到「admin 管理员账号」配置项，填写你的管理员 QQ 号（需确保该账号已加入对应机器人管理群）；
3. 保存修改并关闭文件。

（3）配置 xinxinchatsync 插件

1. 打开「xinxinchatsync」文件夹中的 config.yml；
2. 重点配置 3 项内容：
   • 群号配置：填写需要同步的 QQ 群号（多个群号用英文逗号分隔）；
   • 玩家进服通知：开启 / 关闭通知功能，并自定义通知文案（可选）；
   • 玩家退出服务器通知：同理配置通知开关及文案；
   • 群服消息同步：确认同步方向（群→服 / 服→群 / 双向同步）；
3. 保存文件即可。

 

#启用的群
groups:
  - "641652530"
#自定义玩家进服,退出服务器向Q群发送的信息
#不启用请设置为空
join_msg: "%player_name% 加入了服务器！"
quit_msg: "%player_name% 退出了服务器！"
#玩家游戏聊天时向Q群发送的信息
#支持Papi变量 {MSG}为信息
#不启用请设置为空
group_chat_msg: "%player_name% ：{MSG}"
#Q群聊天时向游戏发送的信息
#{QQ}:QQ号码, {NICK}:群名片, {PLAYER}:QQ绑定的玩家(未绑定则显示群名片)
#不启用请设置为空
game_chat_msg: "&7Q群消息 {PLAYER}: {MSG}"
debug: false

 

（4）配置 xinxincustommessage 插件

1. 进入「xinxincustommessage」文件夹，打开 config.yml；
2. 根据自身需求修改自定义消息相关参数（如欢迎语、关键词回复等，无特殊需求可保留默认配置）；
3. 保存并关闭文件。

（5）开启白名单功能（可选）

1. 定位到「XinxinWhiteList」配置文件夹；
2. 打开对应的配置文件，按文件内注释说明开启功能；
3. 保存修改后，重启插件即可生效。

 

LLOneBot 框架使用教程：第五步 - 最终调试

步骤 1：部署插件并重启服务器

1. 找到之前解压完成的插件文件夹，将「插件配置文件」和「插件主体文件」全部选中；
2. 打开你的服务器目录，定位到「plugins」文件夹（该文件夹是服务器加载插件的核心目录，位置通常在服务器根目录下）；
3. 将选中的插件文件直接拖入「plugins」文件夹中（无需修改文件夹结构，保持原层级即可）；
4. 重启服务器（必须重启才能让插件生效，重启方式：关闭服务器进程后重新启动，或通过服务器面板点击 “重启” 按钮）。

步骤 2：通过控制台验证状态

1. 服务器重启完成后，打开服务器控制台（命令行界面或面板自带控制台）；
2. 在控制台输入以下指令之一，查看插件连接状态：

   xbot reload（重新加载插件，适用于修改配置后快速生效）
   xbot connect（手动触发插件与框架连接，验证通信是否正常）；

3. 若控制台输出「连接成功」「插件加载完成」等提示，说明插件部署无误；若出现报错，需检查插件文件是否完整、配置文件中的端口 / 群号是否填写正确。

步骤 3：在 QQ 群测试功能指令

1. 确保你的管理员账号已加入配置中指定的 QQ 群；
2. 在群内发送预设的测试指令（常见测试指令如 #查询刷神#玩家列表，具体指令可参考插件说明文档）；
3. 观察机器人是否及时响应：若能正常返回帮助信息、服务器状态等内容，说明功能完全正常；若无响应，需检查群号配置是否正确、机器人是否已加入该群。