xiaofanbot - QQ机器人 & Minecraft客户端模组

一个功能丰富的QQ机器人系统，集成Minecraft服务器消息同步、AI对话、签到系统等功能。

📋 项目概述

本项目包含两个主要模块：

QQbot模块 - 基于NapCat的QQ机器人，提供多种群聊和私聊功能
Fabric客户端模组 - Minecraft 1.21.5客户端模组，提供服务器信息API和消息监听

🏗️ 项目结构

autosave/
├── QQbot/                    # QQ机器人模块
│   ├── src/main/java/com/xiaofan/qqbot/
│   │   ├── botmain.java              # 主程序入口
│   │   ├── QQBot.java                # 核心机器人类
│   │   ├── BanListManager.java       # 黑名单管理
│   │   ├── DatabaseManager.java      # 数据库管理（MySQL）
│   │   ├── CheckInHandler.java       # 签到处理器
│   │   ├── PointsQueryHandler.java   # 积分查询处理器
│   │   ├── TipSubmissionHandler.java # 投稿处理器
│   │   ├── TipHandler.java           # Tip查询处理器
│   │   ├── HelpHandler.java          # 帮助菜单处理器
│   │   ├── CatgirlAIService.java     # 猫娘AI服务（Cloudflare Workers AI）
│   │   ├── CatgirlHandler.java       # 猫娘AI消息处理器
│   │   ├── PlayerCountQueryHandler.java # 人数查询处理器
│   │   ├── ServerCommandHandler.java # 服务器命令转发
│   │   ├── ServerMessageMonitor.java # 服务器消息监控
│   │   └── LogConfig.java            # 日志配置
│   └── build.gradle
│
├── src/                      # Fabric客户端模组
│   ├── client/java/com/xiaofan/world/autosave/
│   │   ├── message/mes.java         # 服务器消息API（端口2000）
│   │   ├── ClientControlServer.java # 客户端控制（端口8083）
│   │   └── ...                       # 其他客户端功能
│   └── main/
│
└── SimpfunPassAPI/           # API服务模块

✨ 功能特性

🤖 QQ机器人功能

基础功能

触发词回复：oi → 回复 io
帮助菜单：发送 帮助 查看所有可用命令

服务器查询

人数查询：发送 人数查询 查询Minecraft服务器在线人数
服务器消息同步：自动将Minecraft服务器聊天消息同步到指定QQ群

签到系统

签到：发送 签到 每日签到获得积分（24小时冷却）
积分查询：发送 查询积分 查看当前积分
数据库：使用MySQL存储用户签到数据（qddata.userdata表）

游戏ID绑定

绑定：发送 绑定 绑定游戏ID到QQ号
流程：
1. 用户发送"绑定"触发绑定流程
2. 系统生成6位验证码
3. 用户在Minecraft服务器内发送 /c 绑定（验证码） 完成绑定
4. 验证码2分钟有效，超时需重新绑定
API：端口2001提供 /pass_code API接收验证码
限制：同时只能有一个用户进行绑定

消息屏蔽

屏蔽：发送 /mute 屏蔽自己的游戏消息
功能：将用户的游戏ID添加到屏蔽列表，服务器消息同步时自动过滤该玩家的消息
要求：必须先完成游戏ID绑定
文件：mute.txt（位于JAR包同目录）

投稿系统

投稿：发送 投稿（内容） 投稿内容到数据库
Tip查询：发送 tip 随机获取一条投稿内容
数据库：使用MySQL存储投稿数据（qddata.tipdata表）

AI对话（猫娘）

触发方式：
- 群聊：消息开头 @写了亿小时bug 或 @wans2024 + 问题
- 私聊：直接发送消息
AI服务：Cloudflare Workers AI（@cf/meta/llama-3.1-8b-instruct）
频率限制：每分钟10次，超过提示"调用过于频繁，请一分钟后再试。"
角色设定：猫娘角色，每句话结尾带"喵"

服务器命令转发

触发方式：在指定群组发送 /c （内容）
目标群组：可在代码中配置（默认支持多个群组）
功能：将消息转发到Minecraft服务器

安全功能

黑名单管理：支持黑名单用户，黑名单用户无法使用任何功能
黑名单文件：ban.txt（位于JAR包同目录）

🎮 Minecraft客户端模组功能

服务器信息API（端口2000）

/need_server_info：获取服务器在线人数
/get_server_last_message：获取最后一条玩家聊天消息（队列模式）
/send_message_to_server：发送命令到Minecraft服务器

客户端控制（端口8083）

Web界面控制客户端功能

🚀 快速开始

环境要求

Java 21+
MySQL 8.0+
NapCat QQ机器人框架
Minecraft 1.21.5 + Fabric Loader 0.17.3

配置步骤

1. 数据库配置

创建MySQL数据库和表：

-- 创建数据库
CREATE DATABASE qddata;

-- 创建用户数据表
CREATE TABLE userdata (
    id INT AUTO_INCREMENT PRIMARY KEY,
    qq_id BIGINT NOT NULL UNIQUE,
    username VARCHAR(255) NOT NULL,
    qd INT NOT NULL DEFAULT 1,
    qd_last_time DATETIME,
    reg_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
    game_id VARCHAR(255) DEFAULT NULL
);

-- 创建投稿数据表
CREATE TABLE tipdata (
    id INT AUTO_INCREMENT PRIMARY KEY,
    tip TEXT NOT NULL,
    reg_user VARCHAR(255) NOT NULL,
    reg_time DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
);

-- 创建用户并授权（请替换为你的实际密码）
CREATE USER 'qddata'@'%' IDENTIFIED BY 'your_password_here';
GRANT ALL PRIVILEGES ON qddata.* TO 'qddata'@'%';
FLUSH PRIVILEGES;

2. 配置文件设置

创建配置文件：

在QQbot模块的JAR包同目录（或项目根目录）创建 config.properties 文件：

# 从模板复制（推荐）
cp QQbot/src/main/resources/config.properties.template QQbot/config.properties

# 或从示例复制
cp QQbot/config.properties.example QQbot/config.properties

填写配置信息：

编辑 config.properties，填入实际值：

# NapCat配置
napcat.token=你的实际Token

# 数据库配置
db.url=jdbc:mysql://your_db_host:3306/qddata?useSSL=false&serverTimezone=Asia/Shanghai&useUnicode=true&characterEncoding=utf8&allowPublicKeyRetrieval=true
db.user=your_db_user
db.password=your_db_password

# Cloudflare AI配置
cloudflare.account.id=你的账户ID
cloudflare.api.key=你的API密钥（可选，优先使用环境变量）

环境变量配置（可选）：

Cloudflare API Key优先从环境变量读取：

# Windows PowerShell
$env:AI_API_KEY = "your_cloudflare_api_key"

# Linux/Mac
export AI_API_KEY="your_cloudflare_api_key"

📖 详细配置说明请参考：QQbot/CONFIG_GUIDE.md

3. NapCat配置

确保NapCat运行在以下端口：

API端口：3000
WebSocket端口：3001
Token：在 config.properties 中配置 napcat.token

4. 编译和运行

编译QQbot模块：

cd QQbot
./gradlew build

运行QQbot：

java -jar build/libs/qqbot-1.0-SNAPSHOT.jar

编译Fabric模组：

./gradlew build

📖 使用说明

QQ机器人命令列表

命令	功能	示例
`oi`	基础回复	`oi` → `io`
`人数查询`	查询服务器在线人数	`人数查询`
`签到`	每日签到	`签到`
`查询积分`	查询当前积分	`查询积分`
`绑定`	绑定游戏ID到QQ号	`绑定`
`/mute`	屏蔽自己的游戏消息	`/mute`
`投稿（内容）`	投稿内容	`投稿这是一个小贴士`
`tip`	随机获取投稿	`tip`
`@写了亿小时bug （问题）`	AI对话（群聊）	`@写了亿小时bug 你好吗？`
`@wans2024 （问题）`	AI对话（群聊）	`@wans2024 今天天气怎么样？`
私聊消息	AI对话（私聊）	直接发送消息
`/c （内容）`	转发到服务器	`/c 大家好`
`帮助`	显示帮助菜单	`帮助`

端口使用

端口	模块	功能
2000	Fabric客户端	服务器信息API
2001	QQbot模块	绑定验证码API
3000	NapCat	HTTP API
3001	NapCat	WebSocket
8083	Fabric客户端	客户端控制

🔧 配置说明

配置文件说明

所有敏感配置都通过 config.properties 文件管理：

配置文件位置：
- 生产环境：JAR包同目录的 config.properties
- 开发环境：src/main/resources/config.properties（不推荐，会被打包）
配置文件模板：config.properties.template（已提交到Git）
配置文件示例：config.properties.example（已提交到Git，包含示例值）
安全保护：config.properties 已在 .gitignore 中，不会被提交到GitHub

Cloudflare Workers AI配置

模型：@cf/meta/llama-3.1-8b-instruct
账户ID：从 config.properties 的 cloudflare.account.id 读取
API Key：优先从环境变量 AI_API_KEY 读取，其次从配置文件读取
API URL：自动构建为 https://api.cloudflare.com/client/v4/accounts/{account_id}/ai/run/{model}

数据库配置

数据库连接信息从 config.properties 读取：

URL：db.url
用户名：db.user
密码：db.password

黑名单配置

黑名单文件：ban.txt（位于JAR包同目录）

格式：

QQ号1;
QQ号2;

示例：

1234567890;
9876543210;

📁 文件说明

QQbot模块核心文件

botmain.java - 程序入口
QQBot.java - 核心机器人类，处理WebSocket消息
BanListManager.java - 黑名单管理
DatabaseManager.java - MySQL数据库操作
CatgirlAIService.java - Cloudflare Workers AI服务
CatgirlHandler.java - AI消息处理（@触发和私聊）
CheckInHandler.java - 签到功能
PointsQueryHandler.java - 积分查询
TipSubmissionHandler.java - 投稿功能
TipHandler.java - Tip查询
HelpHandler.java - 帮助菜单
PlayerCountQueryHandler.java - 人数查询
ServerCommandHandler.java - 服务器命令转发
ServerMessageMonitor.java - 服务器消息监控
LogConfig.java - 日志配置（输出到last.log）

Fabric客户端模组核心文件

mes.java - 服务器消息API（端口2000）
ClientControlServer.java - 客户端控制（端口8083）

🔒 安全注意事项

配置文件管理：
- ✅ 使用 config.properties 存储敏感信息
- ✅ 配置文件已在 .gitignore 中，不会被提交到GitHub
- ✅ 使用 config.properties.template 作为模板参考
- ❌ 不要将真实配置提交到Git
API密钥管理：优先使用环境变量存储 AI_API_KEY，其次使用配置文件
数据库安全：生产环境请修改数据库密码，不要使用默认密码
黑名单功能：定期检查和管理黑名单文件（ban.txt 也在 .gitignore 中）
频率限制：AI对话有频率限制，防止滥用

🐛 已知问题

AI功能在显示帮助菜单时可能误触发（已修复，使用严格模式检测@消息）
远程main分支无法删除（GitHub默认分支保护）

📝 更新日志

V1版本

基础触发词功能
签到系统
积分查询
投稿系统
Tip查询
帮助菜单
猫娘AI对话（Cloudflare Workers AI）
服务器消息同步
服务器命令转发
黑名单管理

📄 许可证

MIT License - 详见 LICENSE.txt

🤝 贡献

欢迎提交Issue和Pull Request！

📞 联系方式

GitHub: xiaofanforfabric/xiaofanbot

注意：本项目为特定服务器环境开发，使用前请根据实际情况修改配置。

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
.gradle		.gradle
.idea		.idea
KOOKBot		KOOKBot
QQbot		QQbot
build		build
gradle/wrapper		gradle/wrapper
run		run
src		src
.gitignore		.gitignore
LICENSE.txt		LICENSE.txt
README.md		README.md
build.gradle.kts		build.gradle.kts
gradle.properties		gradle.properties
settings.gradle.kts		settings.gradle.kts

License

xiaofanforfabric/xiaofanbot

Folders and files

Latest commit

History

Repository files navigation