RedPacket

插件

· 作者 Marrshalll

适用于 Paper 1.20.x - 1.21.x 服务器的幸运红包插件,基于 Vault 经济系统构建。

0 本站下载 0 关注 更新于 6 个月前

最新 1.0.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

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 版本
    • 无需为不同版本分别编译不同的插件

命令

命令 描述
/redpacket create <数量> <金额> <持续时间(分钟)> 创建红包
/redpacket grab 抢红包
/redpacket status 查看红包状态
/redpacket end 强制结束当前红包(管理员)
/redpacket lang <语言代码> 切换语言(管理员)
/redpacket help 显示帮助信息

别名:/rp, /redpack

权限

权限 描述 默认值
redpacket.use 使用红包功能 所有玩家
redpacket.admin 管理员权限 OP

语言代码

代码 语言
zh_CN 简体中文
en_US English

依赖

  • Paper 1.20.1 或更高版本(API 1.20+)
  • Vault 插件
  • 任意兼容 Vault 的经济插件(例如 EssentialsX、CMI)

构建

使用 Maven 进行构建:

mvn clean package

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

配置

配置文件将在插件启动后生成于 plugins/RedPacket/ 目录下:

# config.yml
language: en_US         # 默认语言:zh_CN 或 en_US
max_duration_minutes: 10 # 红包最大持续时间(分钟)

多版本兼容

本插件基于 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 许可证。

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 版本
    • 无需为不同版本编译不同插件

指令

指令 描述
/redpacket create <份数> <总金额> <持续时间(分钟)> 创建红包
/redpacket grab 抢红包
/redpacket status 查看红包状态
/redpacket end 强制结束当前红包(管理员)
/redpacket lang <语言代码> 切换语言(管理员)
/redpacket help 显示帮助信息

别名:/rp, /redpack

权限

权限 描述 默认
redpacket.use 使用红包功能 所有玩家
redpacket.admin 管理员权限 OP

语言代码

代码 语言
zh_CN 简体中文
en_US English

依赖

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

编译

使用 Maven 编译:

mvn clean package

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

配置

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

# config.yml
language: zh_CN          # 默认语言:zh_CN 或 en_US
max_duration_minutes: 10 # 红包最长持续时间(分钟)

多版本兼容原理

本插件基于 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 许可证。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源