🌐 基于 EasyBot 的 QQ 群机器人：实现 Minecraft 与 QQ 群双向互通#

✅ 1. 系统要求#

💡 提示：Paper 支持 Minecraft 1.8 ~ 最新版（如 1.21），请根据目标版本选择对应 Java。

🔧 2. 安装 Java#

1
sudo apt update
2
sudo apt install openjdk-17-jre-headless -y
3
java -version

📥 3. 下载 Paper 服务端#

1. 打开官方构建页 👉 https://papermc.io/downloads
2. 选择目标 Minecraft 版本（如 1.20.4、1.21）
3. 下载最新 .jar 文件（例如 paper-1.21-123.jar）
4. 存放至专用目录，如：

   1
   ~/mc-server/
   

⚙️ 4. 首次启动 & 接受 EULA#

进入目录并启动：

1
cd ~/mc-server
2
java -jar paper-1.21-123.jar

⚠️ 首次运行会失败，并生成 eula.txt。

编辑 eula.txt：

1
eula=false
2
eula=true

再次启动：

1
java -jar paper-1.21-123.jar

此时将生成完整目录结构（world/, plugins/, server.properties 等）。
按 Ctrl + C 停止服务。

🛠️ 5. 基础配置（server.properties）#

💡 建议：配置完成后重启服务器生效。

🔄 6. 启动脚本（推荐使用）#

1
#!/bin/bash
2
java -Xms2G -Xmx4G -XX:+UseG1GC -jar paper-1.21-123.jar nogui

1
chmod +x start.sh

1
@echo off
2
java -Xms2G -Xmx4G -XX:+UseG1GC -jar paper-1.21-123.jar nogui
3
pause

🧩 7. 插件安装（后续用于集成 EasyBot）#

1. 停止服务器
2. 将 .jar 插件放入 plugins/ 目录
3. 重启服务器，插件自动加载并生成配置

⚠️ 注意：确保插件与 Minecraft 版本兼容！

📚 附录：官方资源#

• Paper 官网：https://papermc.io
• 插件平台：Hangar｜SpigotMC
• Minecraft Wiki：https://minecraft.wiki

✅ 至此，Minecraft 服务器已准备就绪！

📦 第一步：安装运行环境#

⚠️ 注意
EasyBot 依赖 .NET 8 运行时环境。若未正确安装所需组件，程序将无法启动。

🔧 手动安装步骤#

⚠️ 兼容性补充说明#

🚀 第二步：安装 EasyBot 程序#

✅ 请确认运行环境已安装完毕后再进行此步骤。

📥 Windows 下载
📦 所有版本（含 Linux）：https://files.inectar.cn/easybot/dev

🧩 第三步：安装 Bukkit 插件（用于 Minecraft 服务器集成）#

适用于 CatServer 1.12.2 环境
支持 Minecraft ≥1.9 版本。

❓ 常见问题#

📌 提示：建议始终使用最新稳定版以获得最佳体验。开发版仅用于测试新功能。

✅ 下一步：配置 NapCat 对接 EasyBot，实现 QQ ↔ MC 双向消息同步。

📌 什么是 NapCat？#

NapCat 是基于 Shamrock 的 OneBot v11 实现，可在 PC 上运行 QQ 客户端并通过 WebSocket/HTTP 提供机器人接口。
常用于配合 NoneBot、Koishi 等框架。

⚠️ 重要提醒：
NapCat 需扫码登录真实 QQ 账号，可能违反腾讯《QQ 软件许可协议》，存在封号风险。
仅限个人学习使用，禁止商业或群控行为。

🐳 使用 Docker 部署 NapCat（Linux 环境）#

1
mkdir napcat && cd napcat

1
version: "3"
2
services:
3
  napcat:
4
    environment:
5
      - NAPCAT_UID=${NAPCAT_UID}
6
      - NAPCAT_GID=${NAPCAT_GID}
7
    ports:
8
      - "3000:3000"   # HTTP API
9
      - "3001:3001"   # WebSocket
10
      - "6099:6099"   # WebUI
11
    container_name: napcat
12
    network_mode: bridge
13
    restart: always
14
    image: mlikiowa/napcat-docker:latest

🔗 参考资源#

• NapCat GitHub（非官方）：https://github.com/NapNeko/NapCat
• 社区 Docker 镜像示例：chenzhenyu1998/napcat-docker
• OneBot v11 标准：https://github.com/botuniverse/onebot-11

1️⃣ 在 NapCat 侧边栏配置 WebSocket 服务器#

1. 打开 NapCat 客户端。
2. 左侧点击 “网络配置”。
3. 点击 “新建 WebSocket 服务器”。

✅ 此时 NapCat 已开始在指定端口监听 WebSocket 连接。

2️⃣ 在 EasyBot 中连接 NapCat#

通过 EasyBot Web UI 进行设置：

⚠️ 跨主机连接提示：
如果 EasyBot 与 NapCat 不在同一台机器，请确保宿主机防火墙允许对应端口通信。

3️⃣ 启用群聊功能#

EasyBot 默认全群关闭，需手动启用特定群聊：

📚 进阶参考#

• NapCat 官方文档
• EasyBot 官方文档

✅ 恭喜！你已完成 Minecraft 与 QQ 群的双向互通搭建！
现在玩家在游戏中的聊天将同步到 QQ 群，QQ 群消息也将广播至 Minecraft 服务器。