[MD]
**支持核心：Nukkit / NukkitX / PNX / Nukkit-MOT**
---
## 📌 插件简介
nkqqbot 是一款 **轻量级、全开源** 的聊天桥插件，利用 **OneBot v11** 正向 WebSocket 将
- **玩家聊天、进服、退服事件** 实时推送至 QQ 群
- **群消息** 实时转发回服务器聊天栏
---
## 🎯 主要特性
| 功能 | 说明 |
|---|---|
| ✅ **双向转发** | 玩家 ↔ QQ 群文字消息实时同步 |
| ✅ **事件推送** | 进服 / 退服 / 死亡 / 聊天格式可自定义 |
| ✅ **富文本兼容** | 支持 QQ 的 @、表情、回复等复杂消息 |
| ✅ **一键配置** | 仅需修改 `config.yml` 即可上线 |
| ✅ **跨核心** | 已在 Nukkit-MOT 1.20.40 实测通过 |
| ✅ **多群支持** | 支持将消息转发至多个 QQ 群 |
| ✅ **断线重连** | 网络异常时自动重连，确保消息不丢失 |
---
## 📦 下载地址
- **MineBBS 本帖附件**（持续更新）
---
## 🛠️ 安装步骤
1. 下载 `nkqqbot-1.1.0.jar` 并放入服务端 `plugins/` 目录。
2. 安装 NapCatQQ（或 go-cqhttp）并开启 **正向 WebSocket**：
```json
{
"ws": {
"enable": true,
"port": 3001
}
}
```
3. 启动服务器，插件会自动生成 `plugins/nkqqbot/config.yml`。
4. 按需修改配置文件：
```yaml
wsUrl: "ws://127.0.0.1:3001"
groups:
- 123456789
- 987654321
chatFormat: "[MC] %player%: %message%"
joinFormat: "玩家 %player% 加入了服务器"
quitFormat: "玩家 %player% 离开了服务器"
reconnectInterval: 10
```
5. 重启服务器，完成！
---
## ⚙️ 命令 & 权限
| 命令 | 描述 | 权限 | 备注 |
|---|---|---|---|
| 无 | 纯事件驱动 | 无需权限 | 自动运行 |
---
## ❓ 常见问题
Q1：群消息包含图片怎么办？
→ 插件会自动将图片替换为 `[图片]`，确保消息能完整转发。
Q2：可以对接多个群吗？
→ 已支持多群转发，可在 `config.yml` 中配置多个群号。
---
## 🆘 技术支持
- **MineBBS 本帖留言**
---
> **如果觉得好用，别忘了点“推荐”+“收藏”！**
> **转载请注明出处，禁止二次打包销售。**
[/MD]
