RedPacket - Minecraft Lucky Red Packet Plugin
A lucky red packet plugin for Paper 1.20.x - 1.21.x servers, built on the Vault economy system.

One plugin version supports all compatible servers!

Supported Server Versions

• ✅ Paper 1.20.1 (API 1.20+)
• ✅ Paper 1.20.4 (API 1.20+)
• ✅ Paper 1.20.6 (API 1.20+)
• ✅ Paper 1.21 (API 1.20+)
• ✅ Paper 1.21.1 (API 1.20+)
• ✅ Paper 1.21.11 (API 1.20+)

Features

1. Red Packet Creation
   
   • Players can create red packets via commands
   • Customizable quantity, total amount, and duration (max 10 minutes)
   • Automatic balance verification and deduction
2. Red Packet Grabbing
   
   • Random amount allocation (lucky grab style)
   • Anti-duplicate grabbing mechanism
   • Real-time balance credit to player's account
3. Red Packet Management
   
   • Only one active red packet at a time
   • Automatic expiration handling (auto-settle when expired)
   • Unclaimed amounts automatically returned to creator
4. Status Query
   
   • View current red packet status
   • Display remaining quantity, amount, and time
5. Data Persistence
   
   • Auto-restore unsettled red packets after server restart
   • Complete logging
6. Admin Commands
   
   • Force end and settle current red packet
   • Language switching (Simplified Chinese/English)
   • Detailed statistics and logging
7. Multi-language Support
   
   • Supports Simplified Chinese and English
   • Switchable via config file or commands
   • Graceful fallback for missing translations
8. Multi-version Compatibility
   
   • Compiled with Paper API 1.20
   • Single plugin version supports all 1.20.x - 1.21.x versions
   • No need to compile different plugins for different versions

Commands
Command Description
Permissions
Permission Description Default
redpacket.use Use red packet features All players
redpacket.admin Administrator permissions OP
Language Codes
Code Language
zh_CN 简体中文
en_US English
Requirements

• Paper 1.20.1 or higher (API 1.20+)
• Vault plugin
• Any Vault-compatible economy plugin (e.g., EssentialsX, CMI)

Build
Build with Maven:

The compiled jar will be in the target/ directory.

Configuration
Config files will be generated in plugins/RedPacket/ after plugin startup:

Multi-version Compatibility
This plugin is compiled with Paper API 1.20, leveraging Paper's backward compatibility:

1. API Version Declaration: Declare api-version: 1.20 in plugin.yml
2. Backward Compatibility: Paper servers automatically compatible with plugins compiled with lower API versions
3. Common API Usage: Plugin only uses common APIs supported by all versions, no version-specific features

This means the same plugin jar can run on:

• Paper 1.20.x series servers
• Paper 1.21.x series servers
• Any future Paper version compatible with API 1.20+

License
This project is licensed under the MIT License.

RedPacket - Minecraft 拼手气红包插件
适用于 Paper 1.20.x - 1.21.x 的拼手气红包插件，基于 Vault 经济系统实现。

一个插件版本即可支持所有兼容服务器！

支持的服务器版本

• ✅ Paper 1.20.1 (API 1.20+)
• ✅ Paper 1.20.4 (API 1.20+)
• ✅ Paper 1.20.6 (API 1.20+)
• ✅ Paper 1.21 (API 1.20+)
• ✅ Paper 1.21.1 (API 1.20+)
• ✅ Paper 1.21.11 (API 1.20+)

功能特性

1. 红包创建
   
   • 玩家可通过指令创建红包
   • 支持自定义份数、总金额和持续时间（最长10分钟）
   • 自动验证余额并扣除
2. 红包抢夺
   
   • 拼手气随机分配金额
   • 防重复抢夺机制
   • 抢到的金额实时存入玩家账户
3. 红包管理
   
   • 同一时间只能存在一个进行中的红包
   • 自动过期处理（到期自动结算）
   • 未领取金额自动返还给创建者
4. 状态查询
   
   • 查看当前红包状态
   • 显示剩余份数、金额和时间
5. 数据持久化
   
   • 服务器重启后自动恢复未结算的红包
   • 完整的日志记录
6. 管理员命令
   
   • 可强制结束并结算当前红包
   • 支持语言切换（简体中文/英文）
   • 详细的统计信息和日志记录
7. 多语言支持
   
   • 支持简体中文和英文
   • 可通过配置文件或命令切换语言
   • 缺失文本自动降级处理
8. 多版本兼容
   
   • 基于 Paper API 1.20 编译
   • 单个插件版本支持所有 1.20.x - 1.21.x 版本
   • 无需为不同版本编译不同插件

指令
指令 描述
权限
权限 描述 默认
语言代码
代码 语言
zh_CN 简体中文
en_US English
依赖

• Paper 1.20.1 或更高版本（API 1.20+）
• Vault 插件
• 任何 Vault 兼容的经济插件（如 EssentialsX、CMI）

编译
使用 Maven 编译：

编译后的 jar 文件位于 target/ 目录中。

配置
插件启动后会在 plugins/RedPacket/ 目录下生成配置文件：

多版本兼容原理
本插件基于 Paper API 1.20 进行编译，利用 Paper 的向后兼容性特性：

1. API 版本声明：plugin.yml 中声明 api-version: 1.20
2. 向后兼容设计：Paper 服务器会自动兼容使用较低 API 版本编译的插件
3. 通用 API 使用：插件只使用所有版本都支持的通用 API，不依赖特定版本的新功能

这意味着同一个插件 jar 文件可以在：

• Paper 1.20.x 系列服务器
• Paper 1.21.x 系列服务器
• 任何未来兼容 API 1.20+ 的 Paper 版本

许可证
本项目采用 MIT 许可证。