# WuHenBot

**Repository Path**: yiwuhen/wu-hen-bot

## Basic Information

- **Project Name**: WuHenBot
- **Description**: 
WuHenBot 是 基于腾讯qq机器人基于webhook连接进行开发的机器人。功能根据天启幻境功能进行调整。

- **Primary Language**: Java
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: https://www.wuhen.ltd/
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-08-18
- **Last Updated**: 2025-09-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Bot

## README

# WuHenBot

## 介绍

WuHenBot 是一个基于腾讯 [QQ机器人](https://q.qq.com/qqbot/) 平台开发的机器人程序，通过 Webhook 进行连接。其功能参考了 [天启幻境](https://d.tapdrd.cn/)，并基于 Java 语言实现。

## 软件架构

- **基础环境**：本程序基于 Java 17 开发，需要配置 JDK 17 的运行环境。
- **数据库**：使用 MySQL 数据库存储数据。
- **开发架构**：采用 Spring MVC 框架进行开发，结合 MyBatis 实现数据库操作。

## 功能模块

- **角色与战斗系统**：支持角色创建、战斗逻辑（如双人对战）等功能。
- **用户系统**：支持用户注册、签到、积分管理、昵称修改等操作。
- **钓鱼系统**：包含钓鱼用户管理、钓鱼配置、钓鱼装备、钓鱼积分等功能。
- **命令解析系统**：支持通过消息内容触发特定功能，实现灵活的命令映射机制。
- **QQ 机器人交互**：支持私聊、群聊、频道消息的接收与发送，以及文件发送功能。
- **安全验证**：支持 Webhook 请求的签名验证，确保请求来源合法。

## 安装教程

### 环境要求

- JDK 17
- MySQL 5.7+
- Maven 3.x

### 安装步骤

1. 克隆仓库：
   ```bash
   git clone https://gitee.com/yiwuhen/wu-hen-bot.git
   ```

2. 配置数据库：
   - 创建 MySQL 数据库，并导入项目所需的表结构（参考 `src/main/java/yi/wuhenbot/entity` 中的实体类）。
   - 修改 `application.yml` 或 `application-prod.yml` 中的数据库连接信息。

3. 构建项目：
   ```bash
   mvn clean package
   ```

4. 运行项目：
   ```bash
   java -jar target/wu-hen-bot.jar
   ```

5. 配置 QQ 机器人 Webhook：
   - 在 QQ 机器人开放平台配置 Webhook 地址，指向你的服务器地址（如 `http://yourdomain.com/webhook`）。
   - 配置签名验证逻辑（参考 `BotController` 类）。

## 使用说明

- **Webhook 接口**：机器人通过 `/webhook` 接口接收 QQ 消息事件，支持私聊、群聊、频道消息等。
- **用户功能**：
  - 用户可通过特定指令进行签到、注册、修改昵称等操作。
- **钓鱼功能**：
  - 用户可进行钓鱼操作，系统会根据配置的概率和装备判断是否钓到物品。
- **战斗功能**：
  - 支持简单的角色对战逻辑（如 `twoPersonFight` 方法）。

## 参与贡献

1. Fork 本仓库。
2. 新建 Feat_xxx 分支。
3. 提交代码。
4. 新建 Pull Request。

## 许可证

本项目采用 MIT 许可证。详情请查看项目中的 `LICENSE` 文件。