## 本教程是群服互联的安装以及使用 


## <span style="font-family:楷体">本教程推荐使用go-cqhttp，如需使用Mirai，请前往[Mirai文档](https://docs.mirai.mamoe.net/UserManual.html "Mirai文档")，并安装[onebot-mirai插件](https://github.com/cnlimiter/onebot-mirai/releases/tag/0.1.5)(这是我写的插件，来点星星吧):yum:</span>

## 1. 下载go-cqhttp  
首先前往[官方下载](https://github.com/Mrs4s/go-cqhttp/releases "官方下载")地址下载对应的机器人前置版本这里推荐下载最新版本  

然后根据自己的操作系统下载对应版本  

Windows用户推荐下载： go-cqhttp_windows_amd64.exe  

点此处直接下载 [`v1.0.0-beta8-fix2`](https://pan.toho.cloud/s/o8mSW)  
![](https://pan.evolvefield.cn/wiki/version.png)
## 2. 配置go-cqhttp  
下载完成后双击启动将会提示以下内容  
输入12(代表http和正向ws)然后回车  
![](https://pan.evolvefield.cn/wiki/select.png)  
`启动目录则会出现一个config.yml文件`

![](https://i.loli.net/2021/10/05/nSVHRforw4yg7hT.png)  
`打开刚生成的config.yml文件，并填写自己的qq小号，然后重启机器人软件`

![](https://i.loli.net/2021/10/05/KN1M2ni9YRzjHT5.png)  
1. 启动后扫描二维码提示登录成功后则机器人启动成功,然后机器人就丢后台不用管了  
2. 段落引用模组已经默认配置成go-cqhttp的websocket正向服务地址，如果需要自定义，请看下面的教程~  

## 3. 配置Bot-Connect模组   
将对应版本模组拖入服务器mods文件夹，启动服务器。
### 1.准备工作  
1. `命令:mcbot addGroup <GroupId> 添加群号`  
2. `命令:mcbot setBot <BotId> 设置机器人QQ`  
![](https://pan.evolvefield.cn/wiki/group.png)  
3. `命令:mcbot setFrame  <cqhttp/mirai> 框架选择`  
![](https://pan.evolvefield.cn/wiki/frame.png)  
`命令:mcbot setVerifyKey <VerifyKey> 当选择mirai时，如果开启开启认证流程则设置`  
![](https://pan.evolvefield.cn/wiki/key.png)  

### 2.连接WebSocket(前提是机器人框架已经配置完) 
1. `命令:mcbot connect <cqhttp/mirai> <地址:端口>`   
 
- **默认是mcbot connect mirai 127.0.0.1:8080**  
- ***使用 mcbot connect cqhttp会默认用配置连接Go-Cqhttp***  
- ***使用 mcbot connect mirai会默认用配置连接Mirai***  

![](https://pan.evolvefield.cn/wiki/connect2.png)  
![](https://pan.evolvefield.cn/wiki/connect.png)  
**出现启用框架成功!代表WebSocket已连接！**  

## 4. 使用Bot-Connect模组   

### 1.配置消息从游戏发送到QQ群的功能开关
1. `命令:mcbot send all [true|false]     全局发送消息`  
![](https://pan.evolvefield.cn/wiki/sendall.png)  
2. `命令:mcbot send join [true|false]    发送玩家加入消息` 
![](https://pan.evolvefield.cn/wiki/join.png)  
3. `命令:mcbot send leave [true|false]   发送玩家离开消息`  
![](https://pan.evolvefield.cn/wiki/leave.png)  
4. `命令:mcbot send death [true|false]   发送玩家死亡消息`  
![](https://pan.evolvefield.cn/wiki/death.png)    
5. `命令:mcbot send achievements [true|false] 发送玩家成就消息`  
![](https://pan.evolvefield.cn/wiki/achievements.png)  

### 2.配置游戏接受QQ群消息的功能开关
1. `命令:mcbot receive all [true|false]   全局接受消息`  
![](https://pan.evolvefield.cn/wiki/rall.png)
2. `命令:mcbot receive chat [true|false]  接收QQ群聊天消息` 
![](https://pan.evolvefield.cn/wiki/chat.png)  
3. `命令:mcbot receive cmd [true|false]   接收QQ群命令消息`  
![](https://pan.evolvefield.cn/wiki/cmd.png)  

### 3.查看状态  
1. `命令:mcbot status`  
![](https://pan.evolvefield.cn/wiki/status.png)  

### 4.查看帮助  
1. `命令:mcbot help`  
![](https://pan.evolvefield.cn/wiki/help.png)  

### 5.命令系统  
模组采用了自定义命令的形式安装完模组，会在游戏目录的`config`文件夹下自动生成如下文件  
![](https://pan.evolvefield.cn/wiki/file_list.png)  
#### 下面以say.json为例子  
![](https://pan.evolvefield.cn/wiki/cmd_main.png)  
（1）**命令具体内容**  
使用`%`即代表变量，如`say %`，在q群中可以使用的命令即是`!say [文本内容]`  
（2）**权限**  
大于等于`1`即是管理员权限  
（3）**注意**  
*一个json对应一个自定义命令，不支持多个命令在一个文件内*
### 6.群服互通  
![](https://pan.evolvefield.cn/wiki/achi.png)  

### 7.白名单使用  
请自行添加自定义命令  

### 8.配置自动重载  
![](https://pan.evolvefield.cn/wiki/reload.png)  

### 9.游戏内聊天栏图片同步  
请先安装模组[聊天栏图片](https://www.mcmod.cn/class/9111.html)  
这是一个双端模组，安装完即可支持  
![](https://pan.evolvefield.cn/wiki/image_on.png)  


---
**有什么bug可以在去[Github](https://github.com/Nova-Committee/Bot-Connect/issues/new "Github")提交哦，现在，尽情的享受群服互联吧~**

群服互联的安装以及使用