- 版权类型
- 二次开发
- 插件中文名称
- 红包3
- 插件英文名称
- RedPacket3
- 支持的核心（服务端）
- Spigot
- Paper
- 语言支持
- 中文（简体）
- 前置组件
- Vault
- 适配版本（Java）
- 1.21
[MD]
# [原创/经济] RedPacket —— 现代化红包系统 | 1.21.x 完美兼容 | HEX 颜色 | 拼手气 | 口令 | 接龙
## 🌟 插件简介
RedPacket 是一款为现代化 Minecraft 服务器设计的红包插件。它不仅支持传统的**拼手气**和**普通红包**，还引入了**口令红包**和**成语接龙红包**等趣味玩法。
本插件经过深度重构，完美兼容 **1.20.5 - 1.21.x** 版本的 JSON 消息规范，彻底告别“非法字符”报错，并全面支持 **HEX 颜色代码**，让你的服务器红包更加绚丽夺目！
QQ 交流群：616223380
---
## ✨ 核心特性
* **多样化红包类型**：
* 🧧 **普通红包**：最基础的红包，先到先得。
* ⌨️ **口令红包**：发布者设置口令，玩家输入正确文字（或点击填充）即可领取。
* 🐲 **成语接龙**：趣味接龙玩法，自动判定首尾音节，增加互动性。
* **双重分配模式**：
* 🍀 **拼手气**：随机金额，看谁是手气王！
* ⚖️ **固定金额**：每人领到的钱都一样。
* **多端交互体验**：
* 🎮 **GUI 菜单**：通过 `/rp new` 开启可视化配置界面，简单直观。
* 💬 **聊天会话**：通过 `/rp add` 开启聊天引导式创建，适合习惯快捷指令的玩家。
* **现代化技术支持**：
* 🎨 **颜色支持**：完美支持 `&a` 传统代码及 `#66ccff` HEX 颜色代码，红包祝福语更出彩。
* 🛡️ **1.21.x 深度兼容**：针对 1.20.5+ 的 JSON 规范进行了底层修复，自动剥离点击事件中的非法颜色代码，彻底告别客户端崩溃。
* ⚡ **极致性能**：采用异步数据库操作（SQLite/MySQL）及 Folia 兼容的异步调度器，不影响服务器主线程。
* 🚀 **Folia 兼容**：底层支持 Folia/Paper 异步调度逻辑。
---
## 🎮 玩家指令
* `/redpacket new` (别名: `/rp`, `/fhb`) - 开启红包创建 GUI。
* `/redpacket add` - 在聊天框中开启红包创建会话。
* `/redpacket get <UUID>` - 领取指定红包（通常点击聊天框即可触发）。
* `/redpacket help` - 查看插件帮助。
## 🛠️ 管理员指令
* `/redpacket reload` - 重载插件配置文件及数据库连接。
---
## 🔑 权限节点
| 权限节点 | 描述 | 默认拥有 |
| :--- | :--- | :--- |
| `redpacket.admin` | 管理员权限（重载、管理） | OP |
| `redpacket.color` | 允许在红包祝福语中使用彩色代码及 HEX 颜色 | OP |
| `redpacket.user` | 普通玩家基础权限（创建、领取所有类型红包） | 所有玩家 |
| `redpacket.set.passwordredpacket` | 允许发送口令红包（已包含在 user 权限中） | 所有玩家 |
| `redpacket.set.jielongredpacket` | 允许发送接龙红包（已包含在 user 权限中） | 所有玩家 |
---
## 📝 配置文件预览
```yaml
# 数据库配置
Database:
Type: sqlite # 支持 mysql 或 sqlite
FileName: database.db # Sqlite 数据库文件名
TableName: redpacket # 数据库表名
# MySQL 详细配置（仅在 Type 为 mysql 时生效）
IP: 127.0.0.1
Port: 3306
UserName: root
Password: ''
DatabaseName: minecraft
MySQLArgument: '?useUnicode=true&characterEncoding=gbk'
# 红包基础设置
RedPacket:
MinMoney: 1.0 # 最低发红包金额
MaxMoney: 10000.0 # 最高发红包金额
MaxAmount: 10000 # 红包最大份数
Expired: false # 红包是否会自动过期并退还
ExpiredTime: 4800000 # 过期时间 (单位: 毫秒，默认 80 分钟)
```
---
## 📥 安装说明
1. 将 `RedPacket.jar` 放入服务器 `plugins` 文件夹。
2. 确保服务器已安装经济插件（如 Vault）。
3. 重启服务器或使用 `/rp reload`。
## 📸 插件截图
[ATTACH type="full" size="2560x1408"]125234[/ATTACH]
---
### **💡 开发者寄语**
本插件在原版基础上进行了大量现代化重构，特别针对 1.21+ 版本做了深度优化。如果你在寻找一款稳定、好看且功能丰富的红包插件，RedPacket 将是你的不二之选！
[/MD]
