
ProVouchers 添加了物理兑换券物品、可兑换代码以及一个 /stash 菜单,用于存放玩家稍后可领取的奖励。你可以决定奖励的内容、使用者以及领取频率。
可用于每日奖励、投票激励、新手礼包、活动奖品、临时权限组或一次性赠品代码。兑换券和代码均在 YAML 文件中定义,无需重启服务器即可重新加载。
玩家如何获得奖励
- 兑换券物品: 玩家右键点击物品即可兑换。可设置其材质、名称、描述、发光效果、自定义模型或头颅。兼容来自 ItemsAdder、Oraxen、Nexo 和 Head Database 的自定义物品。
- 可兑换代码: 玩家输入
/voucher redeem <code>进行兑换。代码可以限制使用次数、针对每个玩家单独限制,或设置过期时间。 - 储物箱 (Stash): 为排队虚拟兑换券,包括那些已加入过服务器但当前离线的玩家。他们可以通过
/stash单独领取或使用 全部领取 功能领取奖励。储物箱条目可以设置过期时间,并在玩家上线时发送通知。
储物箱还可以捕获无法放入背包的兑换券物品。设置 stash.overflow: stash 以启用此功能。默认行为是将溢出物品掉落至地面。
奖励与条件
一个兑换券或代码可以触发多项奖励:物品、经验值、Vault 货币、LuckPerms 权限组或权限、控制台命令、玩家命令、消息、广播、标题、动作栏、音效以及 Discord Webhook。加权随机奖励池可与必得奖励并行运行。命名随机抽取允许你在奖励及其公告中复用相同的数值。
条件功能允许你通过权限、权限组、世界、WorldGuard 区域、游戏模式、余额、经验等级、在线时长、背包内容、已完成的进度、玩家统计数据或 PlaceholderAPI 比较来限制兑换。所有配置的条件都必须满足。
基于玩家的冷却时间、基于权限组的冷却层级以及全局或基于玩家的使用限制均会持久化存储。共享的 MySQL、MariaDB 或 PostgreSQL 数据库允许多个服务器执行相同的限制策略。你还可以设置开始日期、过期日期以及可选的确认提示。
物理兑换券支持仅限所有者兑换,并支持可配置的灵魂绑定限制。不可堆叠的兑换券可以获得一个唯一的、持久的印章,以检测重复或已使用的副本。可堆叠的兑换券不使用单独的重复追踪机制。
YAML 中的兑换券示例
创建 plugins/ProVouchers/vouchers/daily.yml:
display-name: "<gold>每日奖励"
item:
material: SUNFLOWER
glow: true
lore:
- "<gray>右键点击以兑换"
cooldown: 86400
rewards:
- "item: DIAMOND 1"
- "message: <green>明天再来吧!"
运行 /voucher reload 以加载该文件。玩家在 24 小时后可以再次兑换该兑换券,即使经过服务器重启也依然有效。
服务器管理人员工具
/voucher fromhand 将你手中持有的物品保存为新的兑换券。还有用于发放兑换券、预览奖励、重新加载单个文件、通过 /voucher doctor 检查插件状态以及重置使用记录的命令。
从 CrazyVouchers 迁移?/voucher import crazyvouchers 读取当前的和旧版的兑换券及代码布局。它会生成 ProVouchers 文件而不会覆盖你的原始文件,并报告需要手动审查的设置。
ProVouchers 包含英语、德语、法语、西班牙语、波兰语、丹麦语和荷兰语。消息可以跟随每位玩家客户端的语言,英语作为后备语言。开发者也可以使用公共 API 和兑换事件。
要求
- 服务端: Paper、Purpur 或 Folia
- Minecraft: 26.1 或更高版本(已测试至 26.3)
- Java: 25
- 存储: 默认使用 SQLite;支持 MySQL、MariaDB 和 PostgreSQL
Vault、LuckPerms、WorldGuard、PlaceholderAPI、MiniPlaceholders 和自定义物品插件为可选组件。仅安装配置所需的集成项。
有关设置说明和配置示例,请参阅 文档。如有 Bug,请使用 GitHub Issues。如有疑问和支持需求,请加入 Discord。

ProVouchers adds physical voucher items, redeemable codes, and a /stash menu for rewards players can claim later. You decide what a reward contains, who can use it, and how often it can be claimed.
Use it for daily rewards, vote incentives, starter kits, event prizes, temporary ranks, or one-time giveaway codes. Vouchers and codes are defined in YAML and can be reloaded without a server restart.
Documentation | Source code | Discord
How players receive rewards
- Voucher items: Players right-click an item to redeem it. Set its material, name, lore, glow, custom model, or head. Compatible custom items can come from ItemsAdder, Oraxen, Nexo, and Head Database.
- Redeemable codes: Players enter
/voucher redeem <code>. Codes can be limited to a certain number of uses, restricted per player, or set to expire. - The Stash: Queue virtual vouchers for players, including players who are offline but have joined before. They can claim their rewards through
/stash, individually or with Claim all. Stash entries can expire and can notify players when they join.
The Stash can also catch voucher items that will not fit in an inventory. Set stash.overflow: stash to enable this. The default behavior is to drop overflow items.
Rewards and conditions
A voucher or code can run multiple rewards: items, XP, Vault currency, LuckPerms groups or permissions, console and player commands, messages, broadcasts, titles, action bars, sounds, and Discord webhooks. Weighted random reward pools can run alongside guaranteed rewards. Named random rolls let you reuse the same number in a reward and its announcement.
Conditions let you restrict redemption by permission, rank, world, WorldGuard region, game mode, balance, XP level, playtime, inventory contents, completed advancements, player statistics, or a PlaceholderAPI comparison. All configured conditions must pass.
Per-player cooldowns, permission-based cooldown tiers, and global or per-player usage limits are stored persistently. A shared MySQL, MariaDB, or PostgreSQL database lets multiple servers enforce the same limits. You can also set start dates, expiry dates, and optional confirmation prompts.
Physical vouchers support owner-only redemption and configurable soulbound restrictions. Non-stackable vouchers can receive a unique, persistent stamp to detect duplicate or already-used copies. Stackable vouchers do not use individual duplicate tracking.
A voucher in YAML
Create plugins/ProVouchers/vouchers/daily.yml:
display-name: "<gold>Daily Reward"
item:
material: SUNFLOWER
glow: true
lore:
- "<gray>Right-click to redeem"
cooldown: 86400
rewards:
- "item: DIAMOND 1"
- "message: <green>Come back tomorrow!"
Run /voucher reload to load it. The player can redeem the voucher again after 24 hours, including across restarts.
Tools for server staff
/voucher fromhand saves the item you're holding as a new voucher. There are commands to give vouchers, preview rewards, reload an individual file, inspect plugin status with /voucher doctor, and reset usage records.
Moving from CrazyVouchers? /voucher import crazyvouchers reads both current and legacy voucher and code layouts. It creates ProVouchers files without overwriting your originals, and reports settings that need manual review.
ProVouchers includes English, German, French, Spanish, Polish, Danish, and Dutch. Messages can follow each player's client language, with English as a fallback. Developers can also use the public API and redemption events.
Requirements
- Server: Paper, Purpur, or Folia
- Minecraft: 26.1 or newer (tested through 26.3)
- Java: 25
- Storage: SQLite by default; MySQL, MariaDB, and PostgreSQL are supported
Vault, LuckPerms, WorldGuard, PlaceholderAPI, MiniPlaceholders, and custom item plugins are optional. Install only the integrations needed for your configuration.
For setup instructions and configuration examples, see the documentation. For bugs, use GitHub Issues. For questions and support, join Discord.
下载 ProVouchers
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ProVouchers
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ProVouchers
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ProVouchers
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ProVouchers
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ProVouchers
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ProVouchers
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ProVouchers
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ProVouchers
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ProVouchers
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
已更改
- 更新了数据库驱动:SQLite 3.53.4.0、MySQL 26.10.0、MariaDB 3.5.11 和 PostgreSQL 42.7.14。Paper 会在启动时下载这些驱动,因此升级会替换它们。
- 将 FastStats 更新至 0.31.0。其错误追踪功能能更准确地将错误归因于本插件,从而减少其他插件向 ProVouchers 提交误报的情况。
已修复
/voucher reload命令在无法读取config.yml时不再丢弃当前生效的设置。之前缺失或格式错误的配置文件会使所有运行时设置恢复为默认值,可能导致重复项移除功能重新开启,并使 Stash(储物箱)溢出时重新掉落物品,但命令仍报告成功。现在重载时会保留活跃设置并报告文件错误;控制台会指出具体是哪一行出错。/voucher doctor命令会报告服务器实际运行的、需要重启才能生效的设置。此前它从保存的文件中读取metrics.enabled和locale设置,因此在修改其中任意一项后,它会显示与实际使用情况相反的信息(例如告知管理员统计功能已关闭,而 bStats 和 FastStats 仍在持续提交数据)。现在,等待重启的保存更改会明确标记为此状态。- 在玩家兑换优惠券或代码时重置其使用计数,不再在 MySQL、MariaDB 或 PostgreSQL 上失败。数据库会通过回滚其中一个写入者来打破死锁,现在该写入操作会被重试而非报告为错误。
/voucher reload命令现在会应用防重复兑换设置、兑换设置,以及储物箱菜单的标题和高度。这些设置此前仅在启动时读取一次,因此即使重载命令报告成功,修改它们也无效,直到服务器重启。
新增
- 可选支持 ComfiConf:可通过 ComfiConf 网页编辑器编辑
config.yml中的设置。需要 ComfiConf 桥接插件 0.1.0 或更高版本。
新增
config.yml中的command-aliases用于设置/voucher的额外别名(默认为vouchers)。设置为[]表示不注册任何别名;/voucher本身始终可用。
更改
/voucher不再注册/pv,因为该命令已被 PlayerVaults 使用。如需保留此别名,请将其添加到command-aliases中。/voucher和/stash的别名会被去除首尾空格并转为小写;空白条目、包含空格的条目以及重复项将被忽略。- 活动指标(兑换次数、拦截的重复项、条件拒绝、Stash 活动)现在报告的是自上次报告以来的计数,而非会话累计总数,因此它们不再随服务器运行时间增加而增长。
- 在
/voucher reload时检查effects.sound键:如果某个键不是有效的声音键,将导致其所属的凭证或代码文件验证失败,而不是在兑换时才失败;同时,大写字母开头的键现在可以正常播放。 - Storage 仅在架构升级完成后才接受查询。打开 Storage 会在约 15 秒内重试几次,以确保共享数据库且同时启动的服务器都能正常上线。如果仍然失败,所有依赖 Storage 的功能将保持不可用状态,直到问题修复,而不是在半升级的数据库上运行。
- 适用于 Minecraft 26.2 和 26.3。该插件仍兼容 26.1 或更高版本。
/voucher doctor现在报告实际运行的指标情况:哪些提供者已启动、FastStats SDK 版本、是否提交指标以及是否发送错误报告。之前仅显示metrics.enabled开关,无法反映提供者启动失败或服务器选择不加入 FastStats 的情况。- API 文档现说明
VoucherPreRedeemEvent和VoucherRedeemEvent也会在领取 Stash 物品时触发,此时物品 ID 为null;取消预兑换事件会将已领取的条目退回至 Stash。 - 更新 FastStats 至 0.30.2,该版本会在错误报告中匿名化 Discord Webhook URL。
修复
- 损坏的第三方插件不再阻止 ProVouchers 启用。由于集成检查会遍历服务器上的所有插件,一个未能启用且 JAR 文件已关闭的插件会导致检查抛出异常。现在,此类集成被视为缺失(并记录命名类的警告),无法构建的提供者也会被以相同方式跳过。
- Stash:领取卡片后,不再删除在菜单打开后送达的凭证。每次送达都单独存储,菜单将匹配的条目合并为一张卡片,因此领取操作仅针对该卡片上的确切送达内容。
- Stash:同一凭证的并发送达不再导致后续送达数量翻倍。
- Stash:因注销中断的领取操作会恢复其奖励,包括在领取操作仍在连接 Storage 时注销的情况;“全部领取”操作不再恢复已被其他领取操作取走的奖励。
- Soulbound(灵魂绑定)和工作台保护现在也阻止数字键交换、副手交换以及将 Bundle(收纳袋)放入容器和工作台。
- 冷却时间不再能通过刚加入服务器或切换至共享数据库的其他服务器后立即兑换来绕过,因为此时玩家存储的冷却时间尚未加载。在冷却时间加载完成前,带有冷却时间的凭证会回复无法验证并重试加载;当 Storage 不可用时,这些凭证将保持不可用状态,而不是忽略已存储的冷却时间。
- 凭证和代码的使用限制(
max-uses和uses-per-player)在授予任何奖励前先在 Storage 中预留额度,因此同时兑换的玩家(无论在同一服务器还是多个共享数据库的服务器上)不再能超出限制,同时使用的次数也不再被少计。 - 在凭证或代码验证过程中注销,不再在未获得奖励的情况下消耗该凭证。物品类凭证会保留在背包中,直到奖励交付;无法交付的兑换操作会返还使用次数,并且不会将已盖章的凭证标记为已兑换。
- 快速连续兑换多个副本的凭证,不再在其冷却时间或使用限制生效前发放额外奖励:当一个凭证的兑换正在验证时,对该凭证的进一步点击将被忽略。
- 当 Storage 在撤销未完成的兑换操作期间发生故障时,已盖章的凭证不再作为重复项被移除。撤销操作会重试,在成功之前,凭证会回复无法验证。
- 发送给玩家但其在物品到达前注销的凭证,会排队存入其 Stash,或在 Stash 禁用时记录日志,而不是丢失。因玩家注销而无法交付的玩家命令和
item: @name奖励也会记录日志。 - 失败的兑换效果(例如无法播放的声音)不再阻止批量开启或 Stash 领取的其余部分继续发放。
- 使用玩家头颅作为图标或奖励的凭证,当其皮肤查找立即失败(例如玩家名称未知)时,不再因内部错误而失败。
- 服务器停止时仍在进行中的兑换、Stash 领取和发放操作,会在 Storage 关闭前结算:使用次数和防重复领取的额度会被返还,Stash 条目会被放回,未交付的发放物品会排队存入 Stash。
迁移
- 使用限制现在由新建的
provouchers_use_totals表统计,该表在首次启动时创建并根据记录的用量填充。 - 更新所有同时共享数据库的服务器。旧版本与当前版本并存时,不会在新表中统计用量,可能导致全局限制被突破;此外,由于本版本将每次送达存储为独立行,旧版本可能导致 Stash 送达数量翻倍。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧