# RedPacket3

**Repository Path**: itwxb/red-packet2.1

## Basic Information

- **Project Name**: RedPacket3
- **Description**: RedPacket3
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-27
- **Last Updated**: 2026-01-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RedPacket 3.0 —— 现代化 Minecraft 红包插件

RedPacket 3.0 是一款为 Minecraft 服务器设计的现代化红包插件，支持 **1.20.5 - 1.21.x** 版本。它提供了普通红包、拼手气红包、口令红包以及趣味的成语接龙红包，并完美支持 HEX 颜色代码。

---

## 🚀 快速开始

### 1. 环境准备
在安装插件前，请确保您的服务器满足以下条件：
*   **服务端版本**：Minecraft 1.12.2 或 1.20.5 - 1.21.x (推荐)。
*   **前置插件**：必须安装 [Vault](https://www.spigotmc.org/resources/vault.343/) 及其对应的经济插件（如 EssentialsX, CMI 等）。
*   **Java 版本**：Java 17 或更高版本（对于 1.21.x 服务端）。
*   **已测试 Java 版本**：已测试 Java openjdk version "21.0.9" 2025-10-21 LTS 版本。
*   **已测试服务端版本**：已测试 1.21.10 版本，其他版本理论上也兼容。

### 2. 安装步骤
1.  下载或编译生成的 `RedPacket-3.0.0.jar`。
2.  将其放入服务器根目录下的 `plugins` 文件夹中。
3.  重启服务器以生成默认配置文件。
4.  根据需要修改 `plugins/RedPacket/config.yml`（详见下方配置说明）。
5.  在游戏内输入 `/rp reload` 重载配置即可生效。

---

## 🛠️ 编译步骤 (开发者)

如果您想从源码自行编译插件，请按照以下步骤操作：

1.  **克隆/下载源码**：确保您已获取本项目的完整代码。
2.  **安装 Maven**：确保您的电脑已安装并配置好 Maven 环境。
3.  **执行编译指令**：
    在项目根目录下打开终端，运行：
    ```bash
    mvn clean package
    ```
4.  **获取产物**：编译成功后，您可以在 `target/` 目录下找到生成的 `RedPacket-3.0.0.jar`。

---

## ⚙️ 配置文件说明 (`config.yml`)

```yaml
# 数据库配置
Database:
  Type: sqlite        # 数据库类型，可选 mysql 或 sqlite
  FileName: database.db # 如果使用 sqlite，数据库的文件名
  # 以下为 MySQL 配置（仅在 Type 为 mysql 时生效）
  IP: ""
  Port: ""
  UserName: ""
  Password: ""
  DatabaseName: ""
  TableName: redpacket

# 红包基础设置
RedPacket:
  MaxAmount: 10000    # 单个红包最大份数
  MaxMoney: 10000     # 单个红包最大金额
  MinMoney: 1         # 单个红包最小金额
  Expired: false      # 红包是否会过期
  ExpiredTime: 4800000 # 过期时间（单位：毫秒）
```

---

## 🎮 指令与权限

### 玩家指令
*   `/redpacket new` (别名: `/rp`, `/fhb`) - 开启可视化 GUI 创建红包。
*   `/redpacket get <UUID>` - 领取指定红包（通常直接点击聊天框中的公告即可）。
*   `/redpacket help` - 查看插件帮助信息。

### 管理员指令
*   `/redpacket reload` - 重载插件配置文件。

### 核心权限
*   `redpacket.user` - 玩家基础权限（默认所有玩家拥有）。
*   `redpacket.admin` - 管理员权限（默认 OP 拥有）。
*   `redpacket.color` - 允许在红包中使用彩色代码和 HEX 颜色。

---

## ✨ 核心特性
*   🎨 **彩色支持**：支持 `&a` 及 `#66ccff` HEX 颜色。
*   🐲 **成语接龙**：内置成语库，支持自动首尾判定。
*   🛡️ **现代化兼容**：针对 1.21.x JSON 规范深度优化，点击绝不报错。
*   ⚡ **异步性能**：所有数据库与消息操作均在异步线程完成，不影响主线程 TPS。

---

## 📜 项目信息与致谢

*   **开发者**：[sandtechnology](https://github.com/sandtechnology)
*   **代码来源**：本项目的部分成语接龙逻辑参考/引用了 [SeraphJACK/JieLong](https://github.com/SeraphJACK/JieLong) 的开源实现 
*   **插件来源**：[RedPacket](https://github.com/sandtechnology/RedPacket) 本项目在此基础上进行了完善与优化。
*   **开发调试**：
    *   `mvn clean package -P dev`：使用开发配置进行打包（如果配置了相关的 Profile）。
    *   `mvn clean package`：标准生产环境打包。