开源 聊天 ChatYunhu-专为 Minecraft 服务器云湖设计的双向聊天转发插件 正式版0.0.1

[MD]
# ChatYunhu

## 插件概述

**ChatYunhu** 是一个专为 Minecraft 服务器设计的**双向聊天转发插件**，它无缝连接游戏内聊天与外部群聊平台，实现服务器玩家与群成员之间的实时交流。由 **LiYang** 开发，当前版本 **v0.0.1**。

```mermaid
graph LR
A[Minecraft服务器] -->|玩家聊天/事件| B(ChatYunhu)
B -->|转发| C[群聊平台]
C -->|群成员消息| B
B -->|广播| A
```

### 服务器效果

[](https://github.com/LIyang-linux/yunhu-mc-plugins/blob/main/pictures/1.png?raw=true)

## 核心功能

### 1. 双向消息转发
- **服务器 → 群聊**
- 玩家聊天消息
- 玩家加入/退出通知
- 游戏事件提醒（可扩展）

- **群聊 → 服务器**
- 实时获取群消息（每3秒轮询）
- 自动格式化为游戏内消息
- 智能过滤机器人自身消息

### 2. 智能消息过滤系统
```yaml
# 配置示例
blocked-words:
- "脏话1"
- "脏话2"
block-commands: true # 过滤命令消息
```

- **屏蔽词过滤**：自定义敏感词库（不区分大小写）
- **命令过滤**：自动忽略以 `/` 开头的命令消息
- **消息类型过滤**：仅处理文本类消息（text/markdown）

### 3. 高可靠性设计
- **自动重试机制**：HTTP请求失败时自动重试（最多3次）
- **消息ID追踪**：记录最后处理的消息ID，避免重复
- **错误隔离**：单次请求失败不影响整体运行

### 4. 美观的消息格式
- **游戏内群聊消息**
`§9[群聊] §b用户名§f: §7消息内容`
- **服务器转发到群聊的消息**
`<玩家名> 聊天内容`
`玩家名 加入了服务器`

## 安装指南

### 环境要求
- **服务端**：Paper 1.20.4 或兼容衍生版
- **Java**：JDK 17+
- **网络**：可访问 `chat-go.jwzhd.com`

### 安装步骤
1. 下载插件：[chatyunhu-0.0.1.jar](https://github.com/LIyang-linux/yunhu-mc-plugins/releases/download/Bata/chatyunhu-0.0.1.jar)
2. 将 JAR 文件放入服务器的 `plugins` 目录
3. 重启服务器
4. 编辑生成的配置文件：
```bash
plugins/ChatYunhu/config.yml
```

## 配置说明

### 配置文件示例
```yaml
# 机器人token（必填）
bot-token: "your_bot_token_here"

# 接收消息的群组ID（必填）
group-id: "your_group_id"

# 机器人用户ID（必填，避免消息循环）
bot-user-id: "your_bot_user_id"

# 功能开关
enable-join-message: true # 玩家加入通知
enable-quit-message: true # 玩家退出通知
block-commands: true # 屏蔽命令消息

# 屏蔽词设置
blocked-words:
- "****"
- "shit"
- "攻击性词汇"

# 自动记录（无需手动修改）
last-message-id: ""
```

### 重要配置项说明
| 配置项 | 必填 | 说明 |
|--------|------|------|
| **bot-token** | 是 | 机器人API令牌 |
| **group-id** | 是 | 接收消息的群组ID |
| **bot-user-id** | 是 | 机器人自身用户ID（防消息循环） |
| **blocked-words** | 否 | 自定义屏蔽词列表 |
| **last-message-id** | 否 | 自动记录最后处理的消息ID |

## 技术支持

### 常见问题解决
1. **消息未转发**
检查 `bot-token` 和 `group-id` 是否正确
确认服务器能访问 `chat-go.jwzhd.com`

2. **消息循环**
确保正确设置 `bot-user-id`

3. **屏蔽词不生效**
检查配置文件格式（使用空格缩进）
确认重启服务器使配置生效

### 编译教
```bash
# 使用Maven编译
mvn clean package -DskipTests

# 构建成功后在target目录获取：
chatyunhu-0.0.1.jar
```

## 开源许可
本项目采用 **MIT 许可证**，允许自由使用、修改和分发，需保留原作者署名。

```license
MIT License
```
[/MD]