SyExtract
一款适用于 Minecraft Paper/Purpur 1.21 的红包插件,支持 Vault 经济系统。
功能特性
- 创建红包(可设置名称、金额、数量)
- 每个红包拥有从 1 开始的唯一数字 ID(例如:1, 2, 3)
- 用于查看和领取红包的 GUI 界面
- GUI 中新增“创建红包”按钮——点击后在聊天栏输入名称、金额和数量
- 创建红包后,屏幕顶部显示 BossBar 进度条,实时展示剩余未领取数量
- 当有人领取红包时,自动向发送者发送通知(包含领取者名称、红包名称、金额及货币名称)
- 可配置免税阈值:总金额低于 10000 的红包免收手续费;总金额达到或超过 10000 的收取 2% 手续费
- 若红包在创建 1 分钟后仍未被完全领取,系统将向尚未领取的在线玩家发送可点击的提醒消息
- 广播和提醒消息中的领取按钮现已真正可点击
- 多语言支持(简体中文/English)
- 支持 Vault 经济系统
- 可配置的费用系统
- 玩家封禁系统(限制发送/领取红包)
- 红包过期设置
- 红包过期时,未领取的金额将自动退还
- 服务器重启后,红包数据完全保留(包括金额分配和领取记录)
- 高度可配置
依赖要求
- Minecraft 服务器:Paper/Purpur 1.21
- Java:17 或更高版本
- 依赖项:Vault + 任意经济插件(例如 EssentialsX)
命令
| 命令 | 权限 | 描述 |
|---|---|---|
/sye create <name> <amount> <count> |
syextract.create | 创建一个红包 |
/sye open |
syextract.open | 打开红包 GUI |
/sye broadcast <id> |
syextract.broadcast | 向所有玩家广播一个红包 |
/sye claim <id> |
syextract.claim | 通过 ID 领取指定的红包 |
/sye ban <player> <time> |
syextract.ban | 封禁一名玩家 |
/sye unban <player> |
syextract.unban | 解除封禁一名玩家 |
/sye reload |
syextract.reload | 重载配置文件 |
命令别名
create→copen→obroadcast→brclaim→clban→bunban→ureload→r
时间格式
封禁时长支持以下格式:
1h- 1 小时1d- 1 天1w- 1 周30d- 30 天
权限
| 权限 | 默认值 | 描述 |
|---|---|---|
| syextract.use | true | 基本使用权限 |
| syextract.create | true | 创建红包权限 |
| syextract.open | true | 打开 GUI 权限 |
| syextract.claim | true | 领取红包权限 |
| syextract.broadcast | true | 广播红包权限 |
| syextract.ban | op | 封禁玩家权限 |
| syextract.unban | op | 解除封禁玩家权限 |
| syextract.reload | op | 重载配置权限 |
| syextract.admin | op | 所有管理员权限 |
配置
config.yml
# 语言设置
# 可用值:zh (简体中文), en (English)
language: zh
# 红包设置
red-envelope:
# 默认领取持续时间(小时)
default-expire-hours: 24
# 红包最小金额
min-amount: 1.0
# 红包最小份数
min-count: 1
# 红包最大份数
max-count: 100
# 费用设置(创建时收取)
fee:
enabled: true
percentage: 0.05
min-fee: 1.0
# 税收设置(领取时收取)
tax:
# 免税阈值:总金额低于此值的红包免收税费
threshold: 10000
# 税率:当总金额达到或超过阈值时应用
percentage: 0.02
# 经济设置
economy:
# 货币名称(当 Vault 不提供时使用)
currency-name: "Coins"
# 提醒设置
reminder:
# 创建后多少秒发送未领取提醒(默认:60)
delay-seconds: 60
# GUI 设置
gui:
item-material: "SUNFLOWER"
# 广播消息设置
broadcast:
envelope-completed: "&6&l? 红包 &e{name} &7已被完全领取..."
语言文件
插件通过在 plugins/SyExtract/lang/ 目录下的语言文件支持多语言:
zh.yml- 简体中文 (默认)en.yml- English
您可以自定义这些文件中的所有消息。要切换语言,请更改 config.yml 中的 language 选项。
数据存储
插件会在 plugins/SyExtract/ 目录下生成以下数据文件:
envelopes.yml- 红包数据(包括金额分配和领取记录)bans.yml- 封禁数据lang/- 语言文件(自动生成)
使用示例
-
通过命令创建红包
/sye create HappyNewYear 1000 10创建一个名为 "HappyNewYear" 的红包,总金额为 1000 金币,分为 10 份。 创建成功后系统将显示红包 ID。
-
通过 GUI 创建红包
/sye open打开 GUI 并点击底部的“创建红包”按钮(下界之星图标)。然后在聊天栏依次输入名称、金额和份数。
-
打开 GUI 领取红包
/sye open即使没有可用的红包,也可以打开 GUI。
-
广播红包
/sye broadcast 1向所有在线玩家广播 ID 为 "1" 的红包。 玩家可以在聊天栏点击「[立即领取]」按钮来领取。
-
领取指定红包
/sye claim 1直接领取 ID 为 "1" 的红包。
-
封禁玩家
/sye ban PlayerName 7d封禁某玩家 7 天,禁止其发送和领取红包。
注意事项
- 创建红包会扣除红包金额 + 手续费
- 红包采用“二倍均值”随机分配算法——每人获得任意金额的概率均等,因此先到先得并无优势
- 过期未领取的红包将自动退款给发放者
- 每位玩家只能领取同一个红包一次
- 每个红包拥有唯一的数字 ID,便于分享和领取
- 当红包总金额达到免税阈值(默认 10000)时,已领取的金额需缴税
- 服务器重启后,红包数据完整保留,包括单个金额和领取记录
- 如果红包在创建 1 分钟后未被领完,系统会自动提醒尚未领取的在线玩家
更新日志
v1.5.0
- 修复了红包金额分配算法:切换至“二倍均值”方法,确保每个人获得任意金额的概率均等——不再出现先领取者获得最大金额的情况
- 修复了服务器重启后红包金额重新生成导致分配错误的 bug(现在金额会被正确保存和加载)
- 在 GUI 中添加了「创建红包」按钮——点击它并在聊天框中输入名称、金额和数量即可创建
- 创建红包后,屏幕顶部显示 BossBar 进度条,实时显示剩余数量
- 有人领取红包时,自动通知发放者(包含领取者名称、红包名称、金额和货币名称)
- 添加税收系统:在 config.yml 中可配置免税阈值(默认 10000)和税率(默认 2%)
- 添加 1 分钟未领取提醒:向尚未领取该红包的在线玩家发送可点击的提醒消息
- 广播和提醒消息中的领取按钮现在真正可以点击
- 修复了多个玩家同时打开 GUI 时 GUI 槽位映射冲突的 bug
- 修复了领取最后一个红包时发放者名称显示为“未知”的 bug
- 添加了过期红包的定期清理任务
- 货币名称现在自动从 Vault 获取,并在 config.yml 中配置了回退选项
v1.4.0
- 添加了多语言支持(简体中文/English)
- 语言文件现在存储在
lang/文件夹中 - 所有消息均可通过语言文件自定义
- 在 config.yml 中添加了
language选项
v1.3.0
- 添加了红包被领完时的通知
- 显示运气最好的玩家(手气最佳),即获得最高金额的玩家
- 添加了
broadcast.envelope-completed消息配置
v1.2.0
- 修复了广播消息找不到的问题 (success.broadcast)
- 修复了广播消息中可点击的领取按钮
- 将红包 ID 从随机的 6 个字符改为从 1 开始的顺序数字 ID
v1.1.0
- 为每个红包添加了唯一 ID
- 添加了过期未领取红包的自动退款功能
- 添加了
/sye broadcast命令用于广播红包 - 添加了
/sye claim命令用于按 ID 领取 - 即使没有可用红包,GUI 也可以打开
- 更新至兼容 Java 17
v1.0.0
- 初始版本发布
作者
- 作者: Shiyuan
- GitHub: Shiyuan-318
- 年份: 2026
SyExtract
一款适用于 Minecraft Paper/Purpur 1.21 的红包插件,支持 Vault 经济系统。
功能特性
- 创建红包(设置名称、金额、数量)
- 每个红包拥有从 1 开始的唯一数字 ID(如 1、2、3)
- GUI 界面查看和领取红包
- GUI 中新增「创建红包」按钮,点击后在聊天框依次输入名称、金额、个数即可创建
- 创建红包后在屏幕上方显示 BossBar 进度条,实时显示剩余个数
- 有人领取红包时,自动通知红包发放者(包含领取者名称、红包名称、金额、货币名称)
- 可配置免税界限:红包总额小于 10000 免税,大于等于 10000 收 2% 税
- 红包创建 1 分钟后若未领完,自动给未领取的在线玩家发送可点击的提醒消息
- 广播消息和提醒消息中的领取按钮可点击直接领取
- 多语言支持(简体中文/English)
- Vault 经济系统支持
- 可配置的手续费系统
- 玩家封禁系统(限制发放/领取红包)
- 红包过期设置
- 过期未领取的红包金额自动退还给发放者
- 服务器重启后红包数据完整保留(包括金额分配和领取记录)
- 高度可配置
运行要求
- Minecraft 服务端:Paper/Purpur 1.21
- Java:17 或更高版本
- 依赖:Vault + 任意经济插件(如 EssentialsX)
命令
| 命令 | 权限 | 说明 |
|---|---|---|
/sye create <名称> <金额> <数量> |
syextract.create | 创建红包 |
/sye open |
syextract.open | 打开红包 GUI |
/sye broadcast <红包ID> |
syextract.broadcast | 广播红包给所有在线玩家 |
/sye claim <红包ID> |
syextract.claim | 领取指定 ID 的红包 |
/sye ban <玩家> <时间> |
syextract.ban | 封禁玩家 |
/sye unban <玩家> |
syextract.unban | 解封玩家 |
/sye reload |
syextract.reload | 重载配置 |
命令别名
create→copen→obroadcast→brclaim→clban→bunban→ureload→r
时间格式
封禁时长支持以下格式:
1h- 1 小时1d- 1 天1w- 1 周30d- 30 天
权限
| 权限 | 默认 | 说明 |
|---|---|---|
| syextract.use | true | 基本使用权限 |
| syextract.create | true | 创建红包权限 |
| syextract.open | true | 打开 GUI 权限 |
| syextract.claim | true | 领取红包权限 |
| syextract.broadcast | true | 广播红包权限 |
| syextract.ban | op | 封禁玩家权限 |
| syextract.unban | op | 解封玩家权限 |
| syextract.reload | op | 重载配置权限 |
| syextract.admin | op | 所有管理权限 |
配置文件
config.yml
# 语言设置
# 可选值: zh (简体中文), en (English)
language: zh
# 红包设置
red-envelope:
# 红包默认可领取时间(小时)
default-expire-hours: 24
# 最小红包金额
min-amount: 1.0
# 最小红包数量
min-count: 1
# 最大红包数量
max-count: 100
# 手续费设置(创建红包时收取)
fee:
enabled: true
percentage: 0.05
min-fee: 1.0
# 税收设置(领取红包时收取)
tax:
# 免税界限:红包总额小于此值则免税
threshold: 10000
# 税率:红包总额大于等于免税界限时按此比例收税
percentage: 0.02
# 经济设置
economy:
# 货币名称(当Vault未提供时使用)
currency-name: "金币"
# 提醒设置
reminder:
# 红包创建后多少秒发送未领取提醒(默认60秒)
delay-seconds: 60
# GUI设置
gui:
item-material: "SUNFLOWER"
# 广播消息设置
broadcast:
envelope-completed: "&6&l? 红包通知 &r&7标题为 &e{name} &7的红包被领完了..."
语言文件
插件支持多语言,语言文件位于 plugins/SyExtract/lang/ 目录:
zh.yml- 简体中文(默认)en.yml- English
你可以在这些文件中自定义所有消息。切换语言请修改 config.yml 中的 language 选项。
数据存储
插件在 plugins/SyExtract/ 目录下生成以下数据文件:
envelopes.yml- 红包数据(包含金额分配和领取记录)bans.yml- 封禁数据lang/- 语言文件(自动生成)
使用示例
-
通过命令创建红包
/sye create 新年红包 1000 10创建一个名为"新年红包"的红包,总金额1000,分为10份。创建成功后会显示红包ID。
-
通过GUI创建红包
/sye open打开GUI后,点击下方的"创建红包"按钮(下界之星图标),然后在聊天框依次输入名称、金额、个数。
-
打开GUI领取红包
/sye open即使当前没有可领取的红包也可以打开GUI。
-
广播红包
/sye broadcast 1将ID为"1"的红包广播给所有在线玩家,玩家可以点击聊天中的"[立即领取]"按钮领取。
-
领取指定红包
/sye claim 1直接领取ID为"1"的红包。
-
封禁玩家
/sye ban 玩家名 7d封禁玩家7天,期间无法发放和领取红包。
注意事项
- 创建红包会扣除红包金额 + 手续费
- 红包采用"切线法"随机分配算法,每个人获得金额的概率完全相同,不存在先领多后领少的问题
- 过期未领取的红包金额会自动退还给发放者
- 每个玩家只能领取同一个红包一次
- 每个红包拥有唯一的数字ID,方便分享和领取
- 红包总额达到免税界限(默认10000)时,领取金额会被收取税费
- 服务器重启后红包数据完整保留,包括各份金额和领取记录
- 红包创建1分钟后若未领完,系统会自动提醒未领取的在线玩家
更新日志
v1.5.0
- 修复红包金额分配算法:改用"切线法"确保每个人获得金额的概率完全相同,不再出现第一个领取者金额最大的问题
- 修复服务器重启后红包金额重新生成导致分配错乱的bug(现在会保存和加载金额列表)
- GUI新增"创建红包"按钮,点击后在聊天框依次输入名称、金额、个数即可创建
- 创建红包后在屏幕上方显示BossBar进度条,实时显示剩余个数
- 有人领取红包时自动通知发放者(含领取者名称、红包名称、金额、货币名称)
- 新增税收系统:可在config.yml中设置免税界限(默认10000)和税率(默认2%)
- 红包创建1分钟后若未领完,自动给未领取的在线玩家发送可点击的提醒消息
- 广播消息和提醒消息中的领取按钮现在可以真正点击领取
- 修复GUI多玩家同时打开时槽位映射冲突的bug
- 修复领取最后一个红包时发送者名称显示为"Unknown"的bug
- 新增定期清理过期红包的自动任务
- 货币名称现在从Vault自动获取,支持在config.yml中配置备用名称
v1.4.0
- 新增多语言支持(简体中文/English)
- 语言文件存放在
lang/目录 - 所有消息均可通过语言文件自定义
- config.yml新增
language选项
v1.3.0
- 新增红包领完通知
- 显示手气王(获得最高金额的玩家)
- 新增
broadcast.envelope-completed消息配置
v1.2.0
- 修复广播消息找不到的问题(success.broadcast)
- 修复广播消息中领取按钮不可点击的问题
- 红包ID从随机6字符改为从1开始的顺序数字ID
v1.1.0
- 为每个红包添加唯一ID
- 过期未领取的红包自动退款
- 新增
/sye broadcast命令广播红包 - 新增
/sye claim命令按ID领取 - 即使没有红包也可以打开GUI
- 更新至Java 17兼容
v1.0.0
- 初始版本
作者
- 作者:Shiyuan
- GitHub:Shiyuan-318
- 年份:2026
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧