YuPay

插件

· 作者 vicuna

YuPay 是一款现代、功能丰富的支付与捐赠插件,专为 Minecraft 服务器设计(兼容 1.8.x-1.26.x)。它无缝集成了微信支付和支付宝

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

最新 1.5.1.1 · 26.2 · Bukkit / Folia

一键开服(送7天)

? YuPay —— 让赞助管理成为一种享受

Minecraft 服务器的赞助体验从未如此优雅。

原生集成微信支付与支付宝、兑换码系统、退款审核、多语言支持、全生命周期事件监听——你所需要的一切,YuPay 一次性提供。免费,无中间商,无套路。100% 的收益直接打入你的账户。唯一的费用是支付宝和微信收取的手续费。


? 它是什么

YuPay 是一款专为 Minecraft 服务器设计的免费现代化支付插件。它将“赞助管理”的繁琐流程简化为四个步骤:发起 → 支付 → 收款 → 记录。每一步都自动化,每一步都可追溯。

服务器运营者用它来收取赞助费,玩家只需扫码即可完成支付。双方都能享受无忧的体验。支持微信支付和支付宝的直接 API 集成——无需第三方中转,资金安全掌握在你自己手中。

⚠️ 本插件适用于“玩家自愿赞助服务器运营”的场景。请确保使用符合当地法律法规及支付平台规定。


✨ 亮点一览

类别 功能特性
? 支付 微信 + 支付宝双渠道,Native QR 扫码支付,自动降级 fallback
? 经济 支持 Vault + PlayerPoints 双引擎,一键切换
? 奖励 基础奖励、单笔里程碑、累计成就、限时冲刺——四层触发机制
? 兑换码 创建/兑换/查询/修改,支持付费激活码,日志完整
? 退款 玩家申请退款,管理员审批/拒绝,强制退款,部分退款
? 数据 排行榜、订单历史、页面浏览、一键复制订单号
? 多语言 默认中文 + 英文,服务器所有者可自定义任意语言,不同玩家显示不同语言
? PAPI 40+ 占位符,可用于记分板/标题/物品描述
?️ 安全 签名验证、IP 白名单、24 小时事件监控、防重复发放
⚡ 性能 全异步处理,HikariCP 连接池,启动速度提升 600%
? 扩展性 提供全生命周期事件 API,供开发者深度集成
? Wiki / DOC WIKI

? 完整的赞助流程是怎样的

  1. 玩家执行命令,例如 /donate 50 wechat
  2. 系统异步创建订单,写入数据库
  3. 调用微信/支付宝 API 生成支付二维码
  4. 根据你的配置,在聊天中发送可点击链接、文本艺术二维码或背包中的地图二维码
  5. 玩家扫码并完成支付
  6. 支付平台回调通知你的服务器
  7. 插件验证签名,确认收款,发放奖励(经济货币 + 命令)
  8. 排行榜和占位符实时更新
  9. 所有日志写入,随时可追溯

完全自动化。你只需配置奖励,其余交给 YuPay 处理。


? 四种奖励层,自由组合

YuPay 的奖励系统就像一个乐高盒——四种触发模式你可以自由组合。

层级 触发条件 示例
基础奖励 每次成功支付 give {player} diamond 1
单笔里程碑 单笔支付达到阈值 50 元 → 5 个金块
累计成就 历史累计达到新高度 500 元 → SVIP 权限组
限时冲刺 指定时间段内累计 24 小时内 200 元 → 附魔金苹果

每一层的命令均可完全自定义,支持 {player}、{amount}、{points} 等变量,并可整合 LuckPerms、CMI 等权限/经济插件。

? 添加 -n(例如 /donate 10 -n)将使其成为无奖励赞助——纯粹支持服务器,不触发任何奖励。


? 兑换码系统:不止于优惠券

YuPay 的兑换码模块远超普通的“礼品码”:

  • 免费码:玩家输入即可领取——非常适合活动赠送
  • 付费激活码:玩家必须扫描并支付指定金额后才能兑换——适用于出售物品权益、兑换其他平台的码等
  • 经济奖励:兑换时自动发放 Vault 货币或 PlayerPoints
  • 自定义命令:每个码可以绑定一组在兑换时执行的命令
  • 使用限制与过期时间:每个码独立控制
  • 兑换码 PAPI:占位符可直接读取任意码的状态、金额、剩余使用次数

通过一条命令创建付费激活码:

/yp code create --code VIP2026 --amount 50 --economy vault --eco-amount 5000 --commands "lp user {player} parent set vip" --max-uses 100 --expire 30d

? 退款系统:坏账终结者

退款不再是一场噩梦。YuPay 的退款流程完整且令人安心:

  • 玩家申请退款:提交申请并说明理由
  • 管理员审核:有序地批准/拒绝
  • 强制退款:紧急情况下的直接操作,无需等待审核
  • 部分退款:灵活处理,精确到分
  • 兑换码退款:退还资金并回滚使用次数,状态自动恢复
  • 退款回调:对接微信/支付宝官方退款 API,资金原路返回
  • 完整日志:谁退了、退了多少、何时、为何——一目了然

? 千人千语——告别语言冲突

国际服运营者的救星。

  • 自带简体中文和英文完整翻译
  • 服务器所有者可以在 language.mappings 中添加任意语言文件
  • 玩家通过 /yp lang <language> 切换偏好,存储在数据库中,跨会话持久保存
  • 新玩家自动检测客户端语言并匹配最佳翻译
  • 同一服务器上的不同玩家看到不同的语言提示——真正实现个性化本地化

? 完整的 PAPI 占位符列表

YuPay 提供了 40+ 个内置的 PlaceholderAPI 占位符,涵盖个人、服务器、排行榜和兑换码四个维度。所有金额均保留两位小数。完整列表如下:


1. 个人维度(需要玩家上下文)

占位符 描述 示例返回值
%yupay_is_banned% 玩家是否被禁止赞助 true / false
%yupay_total% 玩家的终身总赞助额(元) 158.00
%yupay_total_orders% 玩家的订单总数(包括失败的) 7
%yupay_success_orders% 玩家的成功订单数 5
%yupay_rank% 玩家的赞助排名(未排名时显示语言文件中的文本) 3 或 Not ranked
%yupay_has_paid_in_<time>% 玩家在过去 <time> 毫秒内是否有过赞助行为 true / false
%yupay_recent_amount_gt_<time>_<amount>% 过去 <time> 毫秒内的赞助金额是否超过 <amount> 元 true / false
%yupay_orders_in_<time>% 过去 <time> 毫秒内的订单数量(包括失败的) 2
%yupay_success_orders_in_<time>% 过去 <time> 毫秒内的成功订单数 2
%yupay_amount_in_<time>% 过去 <time> 毫秒内的总赞助金额(元) 75.50
%yupay_is_limited% 今日赞助是否已达到每日上限 true / false
%yupay_daily_remaining% 今日剩余的赞助额度(元) 450.00
%yupay_lang% 玩家当前的语言标识符 zh_cn
%yupay_pay_methods_count% 当前可用的支付渠道数量 2
%yupay_pay_methods_list% 可用支付渠道名称列表(逗号分隔) wechat, alipay

? 动态参数:<time> 单位为毫秒(例如 86400000 = 24小时),<amount> 为金额阈值(元)。所有金额占位符均保留两位小数。


2. 服务器维度(无需玩家)

占位符 描述 示例返回值
%yupay_server_total% 服务器的终身总赞助额(元) 12850.75
%yupay_server_total_orders% 服务器的订单总数(包括失败的) 312
%yupay_server_success_orders% 服务器的成功订单数 289
%yupay_server_orders_in_<time>% 过去 <time> 毫秒内的服务器订单数 45
%yupay_server_success_orders_in_<time>% 过去 <time> 毫秒内的服务器成功订单数 42
%yupay_server_amount_in_<time>% 过去 <time> 毫秒内的服务器总赞助额(元) 3200.00

3. 排行榜维度(无需玩家)

支持两种格式(推荐第一种):

占位符 描述 示例返回值
%yupay_top_<rank>_name% 排名第 N 位的玩家名称 Steve
%yupay_top_<rank>_amount% 排名第 N 位的总赞助额(元) 2000.00
%yupay_top<rank>_name% (旧版格式)同上 Alex
%yupay_top<rank>_amount% (旧版格式)同上 1500.00

<rank> 范围为 1 ~ 10。如果该排名不存在,名称将返回语言文件中的备用文本(默认为 "None"),金额返回 0.00。


4. 兑换码维度

包含全局统计(无需玩家)和特定代码属性(其中 redeemed 和 can_redeem 需要玩家上下文)。

全局统计

占位符 描述 示例返回值
%yupay_code_total% 兑换码总数 25
%yupay_code_active% 有效兑换码数量(状态为 ACTIVE) 18

特定代码属性 — 将 <code> 替换为实际的代码字符串(自动转为大写)

占位符 描述 示例 (code = VIP2026)
%yupay_code_<code>_status% 当前代码状态 ACTIVE
%yupay_code_<code>_amount% 所需支付金额(元) 50.00
%yupay_code_<code>_economy_type% 经济奖励类型 vault
%yupay_code_<code>_economy_amount% 经济奖励金额 5000.00
%yupay_code_<code>_used% 已兑换次数 23
%yupay_code_<code>_max_uses% 最大兑换次数(-1 表示无限) 100
%yupay_code_<code>_expire% 过期时间戳(毫秒),-1 表示永不过期 1798675199999
%yupay_code_<code>_expire_formatted% 格式化后的过期时间 2026-12-31 23:59
%yupay_code_<code>_remark% 代码备注 "VIP activation code"
%yupay_code_<code>_locked% 是否被某笔支付锁定(有人正在支付) true / false
%yupay_code_<code>_redeemed% 当前玩家是否已兑换此代码 true / false
%yupay_code_<code>_can_redeem% 当前玩家现在是否可以兑换(综合检查) true / false

? _can_redeem 检查逻辑:代码状态正常、未过期、剩余使用次数大于 0、未被他人锁定,且当前玩家尚未兑换。


使用说明

  • 所有金额占位符单位均为 yuan(元),保留两位小数,例如 99.50。整数金额也会显示 .00。
  • 动态时间参数 <time> 始终使用毫秒——24小时 = 86400000,7天 = 604800000。
  • 占位符中的代码字符串会自动转为大写;输入小写同样有效。
  • 服务器和排行榜占位符不需要玩家上下文;个人维度和部分代码占位符需要玩家,否则返回空值或默认值。
  • 占位符可在任何支持 PlaceholderAPI 的插件中使用(如记分板、BossBar、DeluxeTags、聊天前缀、物品描述等)。

? 给开发者的礼物

如果你能编写插件,以下事件会让你的二次开发体验如虎添翼:

事件 触发时机 可修改参数
PrePaymentEvent 支付前 金额、支付方式、订单 ID、取消标志
PaymentOrderCreatedEvent 订单创建成功 只读(含二维码 URL)
PaymentCompletedEvent 支付成功 + 奖励发放 只读(完整数据)
PaymentFailedEvent 支付失败/取消 只读
RefundCompletedEvent 退款完成 只读
RedeemCodeRedeemedEvent 兑换码已使用 只读
RedeemCodeLifetimeEvent 兑换码状态变更 只读(旧状态 → 新状态)
PlayerPointsChangedEvent 经济系统变化 只读

所有事件均支持同步拦截。你可以在订单创建前进行拦截,在支付后联动其他系统,或在退款时同步数据——赞助生命周期的每一个细节均可观测。


?️ 安全不止于空谈

  • 签名验证:微信/支付宝回调均经过完整的签名验证,防止伪造
  • 防重复发放:通过订单状态检查 + 幂等处理机制保障
  • IP 白名单:回调接口可限制仅允许官方支付平台 IP 访问
  • TLS/HTTPS:支持证书加密通信
  • 事件监控:执行 /yp audit 一键审计,24小时监控哪些插件正在监听 YuPay 的资金事件
  • 地图虚拟锁:当支付二维码放置在物品栏时,玩家会被锁定位置,无法丢弃或切换物品,完成支付后解锁

⚡ 极速启动

重写后的依赖加载系统意味着 YuPay 不再需要繁琐的 JVM 启动参数。所有依赖自动管理,验证速度提升 600%,开箱即用。将其放入 plugins 文件夹,启动服务器,即可直接使用。


? 数据触手可及

/yp history 是你使用频率最高的命令之一。订单历史记录支持分页浏览,点击订单 ID 即可一键复制——对账效率翻倍。

/yp top 让你随时了解谁在为服务器做出贡献——排行榜数据与占位符实时同步。

/yp total 查看个人统计,/yp total all 查看全服统计——一切尽在掌握。


? 两分钟快速上手指南

  1. 将 YuPay.jar 放入 plugins/ 文件夹
  2. 启动服务器,等待生成 config.yml 和 messages.yml
  3. 打开 config.yml,填写你的微信/支付宝参数
  4. 确保服务器防火墙和安全组中开放了回调端口(默认 8080)
  5. 在游戏中输入 /donate 0.01 测试小额支付
  6. 确认回调正常且奖励到账——正式营业 ?

? 为什么服务器所有者选择 YuPay

  • ✅ 稳定:经生产环境验证,兼容 Spigot/Paper 1.8 至最新版本
  • ✅ 可靠:直连官方 API,无中间商,资金直接进入你的账户
  • ✅ 无忧:从支付到奖励全自动运行,只需简单配置
  • ✅ 灵活:奖励逻辑完全可编程,命令别名自由定义
  • ✅ 安全:签名验证 + 防重复 + IP 白名单 + 事件监控
  • ✅ 透明:每笔订单、每次退款、每个兑换码均有日志记录
  • ✅ 持续演进:积极维护,不断迭代,由社区驱动

? 插件 QQ 讨论群:1080918424

遇到问题、提出功能建议,或者只是聊聊天——欢迎加入。YuPay 的每一次改进都源于服务器所有者的反馈。

? 爱发电赞助作者:

如果 YuPay 帮助了你的服务器,请考虑给作者买杯奶茶 ~ 你的支持是插件持续演化的最大动力。

别再为赞助管理头疼。把专业的事交给 YuPay,专注于运营好你的服务器。


? YuPay 操作手册

1. 环境要求

项目 要求
服务端 Spigot / Paper / 兼容分支 / 兼容混合服务端,1.8 – 1.26+
Java JDK 8 或更高版本
可选依赖 Vault (经济), PlayerPoints (点数), PlaceholderAPI (占位符), ProtocolLib (地图锁)

? 好消息:你不再需要为 Java 9+ 手动添加 JVM 启动参数。YuPay 最新版本内置智能依赖管理——开箱即用。

2. 安装与启动

  1. 下载 YuPay.jar,放置在服务端的 plugins/ 目录中
  2. 启动服务器,插件将自动生成 config.yml、messages.yml 以及 SQLite 数据库文件
  3. 编辑 plugins/YuPay/config.yml,填写支付渠道配置参数
  4. 根据你的支付方式,在支付平台后台配置回调地址:
    • 微信:http(s)://your-domain-or-ip:port/pay/wechat/notify
    • 支付宝:http(s)://your-domain-or-ip:port/pay/alipay/notify
  5. 确保防火墙和安全组中开放了回调端口(默认 8080)
  6. 执行 /yupay reload 或在控制台输入 reload 以应用配置
  7. 在游戏中输入 /donate 0.01 测试小额支付

3. 配置快速参考

3.1 核心支付参数

路径 描述 示例
pay.default-method 默认支付方式 wechat / alipay
pay.min-amount 单笔订单最低金额(元) 0.01
pay.max-amount 单笔订单最高金额(-1 = 无限制) 500
pay.max-daily-amount 每日累计限额(-1 = 无限制) 1000
pay.order-subject 订单标题模板 Sponsorship-{player}-{amount}yuan

3.2 微信支付参数

路径 说明
wechat.enabled 启用(true/false)
wechat.mchid 商户号
wechat.appid 公众号 / 小程序 AppID
wechat.serial-no API 证书序列号
wechat.private-key-path 商户私钥(相对于 pems/ 目录的路径)
wechat.public-key-path 平台公钥(相对于 pems/ 目录的路径)
wechat.public-key-id 平台公钥 ID
wechat.api-v3-key API v3 密钥(32 个字符)
wechat.notify-url 完整的回调通知 URL

3.3 支付宝参数

路径 说明
alipay.enabled 启用
alipay.mode public_key 或 cert
alipay.app-id 应用 ID
alipay.merchant-private-key 商户私钥(PKCS8 格式,不含头尾标识)
alipay.alipay-public-key 支付宝公钥(public_key 模式下必需)
alipay.app-cert-path 应用公钥证书(cert 模式下使用)
alipay.alipay-cert-path 支付宝公钥证书(cert 模式下使用)
alipay.alipay-root-cert-path 支付宝根证书(cert 模式下使用)
alipay.notify-url 异步通知 URL
alipay.return-url 同步返回 URL

3.4 经济系统

路径 说明
economy.enabled 启用经济奖励
economy.type vault 或 playerpoints
economy.rate 1 元 = 多少游戏内货币/积分

3.5 二维码显示

路径 说明
qrcode.default-output-mode link / text / map
qrcode.text-qr-size 文本模式下的 QR 码边长(字符数,默认 12)
qrcode.text-black-char 黑色像素字符(默认 ██)
qrcode.api-url 链接模式下的图片生成 API

3.6 回调服务器

路径 说明
callback.port 监听端口
callback.host 绑定地址(0.0.0.0 = 所有接口)
callback.io-threads IO 线程数量
callback.worker-threads 工作线程数量
callback.allowed-ips IP 白名单(CIDR 格式,为空则允许所有)
callback.access-log 启用访问日志

3.7 数据库

路径 说明
database.type sqlite(单机版)或 mysql(多服同步)
database.mysql.* MySQL 连接参数
database.connection-pool.* HikariCP 连接池参数
database.table-names.prefix 表前缀,用于避免冲突
database.table-names.* 各业务表的名称(可自定义)

4. 完整奖励配置指南

4.1 基础奖励 (on-success)

每次成功支付时执行——适用于“每次赞助均给予基础奖励”的场景。

commands:
  on-success:
    - "give {player} diamond 1"
    - "effect give {player} minecraft:speed 30 1"

可用变量:{player}(玩家名称)、{amount}(金额)、{points}(获得的经济点数)

4.2 单次里程碑 (on-single-achieved)

当单笔支付达到设定金额时触发。请将金额从低到高排序,支持多个层级。

commands:
  on-single-achieved:
    - amount: 50
      commands:
        - "say {player} 在单次赞助中达到了 50 元!"
        - "give {player} minecraft:gold_block 5"
    - amount: 100
      commands:
        - "give {player} minecraft:diamond_block 3"
        - "lp user {player} parent set vip"

4.3 累计成就 (on-total-achieved)

当历史累计总额达到新高度时触发。每个层级仅触发一次——内置防重复机制。

commands:
  on-total-achieved:
    - total: 100
      commands:
        - "lp user {player} parent set vip"
    - total: 1000
      commands:
        - "lp user {player} parent set ultimate"
        - "give {player} minecraft:beacon 1"

4.4 限时冲刺奖励 (on-recent-achieved)

当指定时间段(毫秒)内的累计金额达到目标时触发。非常适合节假日活动、周末排行榜冲刺等场景。

commands:
  on-recent-achieved:
    - time: 86400000    # 24 小时
      total: 200
      commands:
        - "give {player} minecraft:enchanted_golden_apple 5"
    - time: 604800000   # 7 天
      total: 500
      commands:
        - "give {player} minecraft:elytra 1"

4.5 退款触发命令 (on-refund)

退款成功后执行——可用于通知管理员、记录事件等。

commands:
  on-refund:
    - "say {player} 的订单 {order} 已退款 {amount} 元"

5. 命令系统

5.1 玩家命令

命令 功能 默认别名
/donate <amount> [payment] [output] [-n] 发起赞助 /pay, /zanzhu
/ytop 赞助排行榜 Top10 /paytop, /yt
/ytotal [player|all] 查询总赞助额 /paytotal, /ytt
/yp history [page] 我的赞助历史 /yupay history
/yp lang [language] 切换个人语言偏好
/yp code redeem <code> 兑换代码
/yp cancel 取消当前地图支付

? -n 标志表示“无奖励赞助”——纯服务器支持,不触发任何奖励命令或经济物品。

5.2 管理员命令

命令 功能
/yp reload 热重载配置
/yp set <option> <value> 在线更改配置
/yp config 查看当前核心配置
/yp ban <player|all> [reason] 禁止赞助(all = 全局封禁)
/yp unban <player|all> 解除封禁
/yp convert <player> <from> <to> <amount> 货币转换(vault/points)
/yp audit 审计所有监听 YuPay 事件的插件
/yp history <player> [page] 查看任意玩家的订单历史
/yp code create ... 创建兑换码
/yp code list [page] 列出兑换码
/yp code info <code> 查看兑换码详情
/yp code modify <code> <field> <newvalue> 修改兑换码参数
/yp code delete <code> 禁用兑换码(软删除)
/yp code logs [code] [page] 查看兑换日志
/yp refund <order-id> [amount] 直接退款
/yp refund list [page] 退款日志
/yp refund request <order-id> [amount] 提交退款审核请求
/yp refund pending [page] 查看待处理的退款请求
/yp refund approve <request-id> 批准请求
/yp refund reject <request-id> 拒绝请求

5.3 关键权限节点

权限节点 操作
yupay.command.pay 发起赞助
yupay.command.top 查看排行榜
yupay.command.total 查询总赞助额
yupay.command.history 查看订单历史
yupay.reload 重载配置
yupay.ban 管理黑名单
yupay.convert 货币转换
yupay.audit 事件监听器审计
yupay.admin 包含上述所有管理员权限

6. 兑换码系统深入解析

6.1 创建兑换码命令详解

创建兑换码使用 --param value 格式的名称参数,可自由组合:

# 免费福利码(无限次数,永不过期)
/yp code create --code FREEGIFT --max-uses -1 --economy vault --eco-amount 100 --remark "新玩家礼物"

# 付费激活码(支付 50 元兑换,100 次使用机会,30 天后过期)
/yp code create --code PREMIUM --amount 50 --economy vault --eco-amount 5000 --max-uses 100 --expire 30d --commands "lp user {player} parent set vip"

# 仅执行命令的兑换码(无经济系统,无需付款)
/yp code create --code WELCOME --commands "give {player} diamond 5; say {player} Welcome back!"

参数快速参考:

参数 描述 示例
--code 兑换码字符串(自动转大写) VIP2026
--amount 所需支付金额(0 = 免费) 50
--economy 经济系统类型(vault / playerpoints / none) vault
--eco-amount 经济系统奖励金额 5000
--max-uses 最大兑换次数(-1 = 无限) 100
--expire 过期时间(30d / 24h / 2026-12-31 / never) 30d
--commands 兑换时执行的命令(分号分隔) "cmd1; cmd2"
--remark 备注说明 "VIP 激活码"

6.2 兑换码状态说明

状态 含义
ACTIVE 可用
DEPLETED 使用次数已耗尽(自动)
EXPIRED 已过期(自动)
DISABLED 由管理员手动禁用

6.3 兑换码 PAPI 占位符

以兑换码 VIP2026 为例:

占位符 返回示例
%yupay_code_total% 兑换码总数
%yupay_code_active% 活跃兑换码数量
%yupay_code_VIP2026_status% ACTIVE
%yupay_code_VIP2026_amount% 50.00
%yupay_code_VIP2026_used% 23
%yupay_code_VIP2026_max_uses% 100
%yupay_code_VIP2026_expire_formatted% 2026-12-31 23:59
%yupay_code_VIP2026_can_redeem% true / false
%yupay_code_VIP2026_locked% true / false
%yupay_code_VIP2026_redeemed% 当前玩家是否已兑换

7. 退款系统深入解析

7.1 退款方式对比

方式 命令示例 使用场景
直接退款 /yp refund ORDER001 50 确认需要退款,快速处理
强制退款 /yp refund ORDER001 50 -f 跳过金额检查,直接退款
部分退款 /yp refund ORDER001 30 退还部分金额
审批流程 /yp refund request ORDER001 → 等待批准 需要审批的场景
兑换码退款 /yp refund -r <redemption-log-id> 退还兑换码费用并恢复使用次数

7.2 退款审批流程

  1. 玩家或管理员提交退款请求:/yp refund request <order-id> [amount]
  2. 管理员查看待处理列表:/yp refund pending
  3. 批准或拒绝:/yp refund approve <request-id> / reject
  4. 批准后,实际退款自动执行;拒绝后,通知申请人

7.3 退款后的处理

  • 支付平台(微信/支付宝)接收退款请求,资金退回原支付方式
  • 插件更新订单退款状态(FULL_REFUND / PARTIAL_REFUND)
  • 如果是兑换码退款:兑换码使用次数 -1,状态恢复为 ACTIVE
  • 执行 commands.on-refund 中配置的命令
  • 触发 RefundCompletedEvent 供其他插件响应
  • 完整的退款日志写入数据库

8. 多语言系统

8.1 添加语言

在 config.yml 的 language.mappings 节点下添加:

language:
  mappings:
    zh_cn:
      file: "messages.yml"
      aliases: [zh, cn, chinese]
      client-locales: ["zh_cn", "zh_*"]
    en:
      file: "messages_en.yml"
      aliases: [english, eng]
      client-locales: ["en_*"]
    ja:
      file: "messages_ja.yml"
      aliases: [japanese, jp]
      client-locales: ["ja_*"]

然后创建 plugins/YuPay/messages_ja.yml,基于 messages.yml 进行翻译。插件将自动填充缺失的键值。

8.2 切换语言

  • 玩家手动切换语言:/yp lang en(支持别名,例如 english)
  • 首次加入时自动检测客户端语言并匹配最佳翻译
  • 语言偏好保存在数据库中,跨会话记忆

9. 数据库选型指南

服务器规模 推荐类型 原因
单个小型服务器 SQLite 零配置,开箱即用
多服网络 MySQL 数据统一,跨服同步
大型网络 MySQL + 连接池 支持高并发,复用连接

10. 常见问题排查

回调服务器启动失败

  • 检查端口是否被占用
  • 确认防火墙/安全组已开放该端口
  • 查看控制台错误日志

支付成功但未收到奖励

  • 检查数据库中订单的 status 字段——应为 SUCCESS
  • 确认 economy.enabled 和 commands.enabled 均为 true
  • 检查控制台中是否有经济插件加载错误的报错

地图二维码未显示

  • 确认已安装与服务器版本匹配的 ProtocolLib
  • 检查 qrcode.default-output-mode 是否设置为 map
  • 若缺少 ProtocolLib,模式将自动回退为 link

微信支付提示找不到公钥文件

  • 检查 plugins/YuPay/pems/ 目录是否存在
  • 确认 wechat.public-key-path 路径正确
  • 前往微信商户平台 → API 安全 → API 证书 → 下载平台证书

插件升级后配置文件丢失

  • YuPay 内置智能配置升级器——会自动备份旧文件(添加 .bak 后缀)并合并新键值
  • 升级前手动备份可更安心

11. 数据库表结构

表名 存储内容
yu_payments 所有支付订单,含退款状态
yu_total_levels 累计奖励档位记录
yu_banned_players 赞助黑名单
yu_player_lang 玩家语言偏好
yu_redeem_codes 兑换码主表
yu_redeem_logs 兑换记录
yu_refund_logs 退款操作日志
yu_refund_requests 退款审核请求

12. 卸载步骤

  1. 执行 /yp reload(确保内存中的配置已刷新)
  2. 停止服务器
  3. 删除 plugins/YuPay.jar
  4. 如需彻底移除,请删除 plugins/YuPay 文件夹(包括数据库)

? 插件交流群:1080918424 不要独自挣扎——带上你的日志和配置文件截图进群,作者和热心服主都在。

? 在爱发电支持作者:

如果 YuPay 帮助了你的服务器,不妨请作者喝杯奶茶 ~ 你的支持是插件持续进化的最大动力。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源