Cashback

插件

· 作者 RYLONE

Vault 商店购买奖励,支持 Paper — EconomyShopGUI 和 UltimateShop。[1.20.6-26.3]

0 本站下载 0 关注 更新于 2 天前

最新 1.3.3 · 26.3 · Paper / Purpur

一键开服(送7天)

现金返还

适用于 Paper 1.20.6–26.3 和 Purpur 1.21.11 / 26.3 的金库(Vault)现金返还周期 · Java 21+

玩家在你的商店消费以填充进度条。当进度条满时,现金返还将处于激活状态,系统会通过 Vault 自动退还他们下一次购买金额的一定比例。当配额耗尽后,周期重置并重新开始填充。

周期工作原理

  1. FILL(填充) — 消费为进度条增加数值。这些消费不会触发现金返还。
  2. ACTIVATE(激活) — 达到 100% 时,进度条解锁现金返还配额。
  3. PAYOUT(支付) — 在激活状态下进行的每次购买都会按配置的比例(默认为 30%)进行返还。
  4. RESET(重置) — 当配额降至零时,周期重新开始。

功能特性

  • 无需优惠券、等级或手动发放奖励即可重复激励消费。
  • 防崩溃支付 — 每次支付都在数据库中标记为已领取,然后再执行 Vault 存款,从而防止崩溃后出现重复支付。使用 /cb admin recover 结算遗留款项。可能已经支付的款项将被阻止,直到你使用 force 确认它们。
  • 无重复计数 — 一次购买对应一次支付,即使商店插件触发了多个事件也是如此。
  • 大额消费全额计入 — 价值超过多个周期的购买会被精确计算,不会被截断。
  • 通过权限节点实现按等级的目标和现金返还率,支持 LuckPerms。
  • 可选的结转功能 — 超出阶段限制的数值可以延续到下一阶段,而不是被丢弃。
  • 管理员诊断 — /cb admin health 显示金库提供商、商店适配器、待处理支付、周期设置、等级、存储以及服务器/Java 信息;/cb admin history <player> 列出最近 10 笔交易及其商店来源。
  • 重置保留终身累计 — /cb admin reset 仅清除当前周期。

要求

平台支持: 这是一个 Paper 插件。由于它使用 Paper API 和 plugin.yml 库加载器,因此不能在 Spigot 或 CraftBukkit 上运行。不支持 Folia。

安装

  1. 将 Cashback.jar 放入服务器的 /plugins 文件夹并重启服务器。
  2. 确保已安装 Vault 和一个经济插件。
  3. 如果需要更改目标值或返还率,请编辑 plugins/Cashback/config.yml。
  4. 运行 /cb admin health,它将一次性检查金库、商店适配器、待处理支付、周期和存储的状态。
  5. 在你的商店购买一些物品,然后检查 /cb status。

命令

命令 描述
/cb 显示你的现金返还进度条。
/cb status 显示带有配额详情的进度条。
/cb history 显示你最近的 5 次支付记录。
/cb version 显示插件版本、服务器、Java 版本、适配器和存储信息。
/cb admin health 显示商店适配器的状态。
/cb admin inspect <player> 检查玩家的周期状态和等级。
/cb admin reset <player> 重置玩家的周期。
/cb admin recover [force] 结算因崩溃而挂起的支付。
/cb admin reload 重新加载配置文件和语言文件。
/cb admin history <player> 查看最近交易,包括商店来源

权限

权限 默认值 描述
cashback.use true 使用 /cb、/cb status 和 /cb history。
cashback.admin op 访问所有管理员命令。
cashback.admin.help — 访问 /cb help。
cashback.admin.version — 访问 /cb version。
cashback.admin.reload — 访问 /cb admin reload。
cashback.admin.history — 访问 /cb admin history <player>。
cashback.admin.health — 访问 /cb admin health。
cashback.admin.inspect — 访问 /cb admin inspect <player>。
cashback.admin.reset — 访问 /cb admin reset <player>。
cashback.admin.recover — 访问 /cb admin recover [force]。
cashback.rank.<name> — 设置特定等级的目标和现金返还率。在 ranks.groups 下配置等级。

商店集成

  • EconomyShopGUI — 支持免费版和高级版。
  • UltimateShop — 版本 3.6.3 或更高。只有价格中的 Vault 部分会计入现金返还。
  • 使用物品、经验值、PlayerPoints 或其他经济方式支付的消费不会产生现金返还。
  • 如果检测到未知的商店插件,Cashback 将保持空闲状态,而不是猜测其行为。

配置示例

config.yml
config-version: 5

language:
  default: en
  fallback: en
  directory: lang

cycle:
  fill-target: 500000.0      # 达到 100% 所需的商店消费金额
  cashback-target: 500000.0  # 在 ACTIVE 状态下赚取现金返还所需的消费金额
  cashback-rate: 30.0        # 返还百分比 (0-100)
  carry-over: false          # true: 超出阶段限制的数值将延续到下一阶段

ranks:
  enabled: false
  groups:
    vip:
      permission: cashback.rank.vip
      priority: 10
      cashback-rate: 35.0
    mvp:
      permission: cashback.rank.mvp
      priority: 20
      cashback-rate: 40.0
      fill-target: 400000.0
      cashback-target: 600000.0

notifications:
  activated:
    action-bar: true
    chat: true
    sound:
      enabled: true
      name: "minecraft:block.beacon.activate"
      volume: 1.0
      pitch: 1.2
  deactivated:
    action-bar: true
    chat: true
    sound:
      enabled: true
      name: "minecraft:block.beacon.deactivate"
      volume: 1.0
      pitch: 1.0
  earned:
    chat: true

integrations:          # 修改这些配置需要重启服务器
  economyshopgui:
    enabled: true
  ultimateshop:
    enabled: true

history:
  retention-days: 365  # 超过此天数的已完成条目会每天被删除;0 = 永久保留

metrics:
  enabled: true

故障排除

常见问题

“No Vault economy provider registered yet”(尚未注册任何 Vault 经济提供商)

已安装 Vault,但没有经济插件注册提供商。请安装一个经济插件,例如 EssentialsX 或 CMI,或者检查它是否在 Cashback 之前加载。

未支付返利

运行 /cb admin health 查看适配器名称。如果显示 none,可能是商店插件缺失或其 API 类未被找到。同时确认购买是使用 Vault 货币支付的,而不是物品或经验值。

崩溃后出现重复或缺失的支付记录

运行 /cb admin recover 并将其结果与经济日志进行对比。可能已经支付的行会被报告为已阻止(blocked)。仅在检查经济日志后使用 /cb admin recover force。

玩家进度持续但收到无支付

这是设计上的 FILLING(积累)阶段。只有在周期处于 ACTIVE(活跃)状态时才会支付返利。

在旧版 EconomyShopGUI 上更新至 1.3.3 后返利停止

不暴露经济类型的旧版本不再自动支付。如果所有商店价格都使用 Vault,请设置 integrations.economyshopgui.allow-legacy-pricing: true,然后运行 /cb admin reload。

/cb admin health 提示 ATTENTION(注意)

阅读其下方的内容:没有 Vault 经济提供商、没有商店适配器,或有待处理的支付记录。每一行都指出了需要修复的部分。

语言

包含英文和印尼语。语言文件位于 plugins/Cashback/lang,且永远不会被覆盖。当插件更新时,会自动添加新的键。

支持

请在讨论区发帖并提供以下信息:

  • 服务器软件及版本
  • 通过 /cb version 获取的 Cashback 版本
  • 商店插件及版本
  • 相关的控制台输出

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源