跳到主要内容

安装与需求

服务器​

项目需求
核心Paper、Purpur、Folia（Spigot 不支持）
版本1.20 – 26.x（实测 1.21.10、1.21.11、26.1、26.2、26.3）
Java17 以上（26.x 用 Java 25）
网络服务器要能连到 openapi.alipay.com / api.mch.weixin.qq.com（不需要公网 IP）
数据库默认 SQLite；多个子服共用订单与累计充值时用 MySQL / MariaDB

收款资质​

云支付使用官方接口，你需要自己的商户：

  • 支付宝：开放平台应用 + 「当面付」能力，见 支付宝设定
  • 微信支付：商户号 + 「Native 支付」 + 绑定一个 AppID，见 微信支付设定

申请条件以平台审核为准，一般需要营业执照或个体工商户资格。两个可以只开一个。

可选联动​

插件作用
云界面 CloudUI 1.1.0 以上充值中心、扫码付款、累充奖励三个画面；二维码直接显示在付款画面上。CloudUI 更旧的版本仍有充值中心与累充画面，付款时改用手持二维码地图
PlayerPoints奖励里的点券（points）。也可以改用其他点券插件的指令，见 奖励设定
Vault + 经济插件奖励里的金币（money）
PlaceholderAPI%cloudpay_…% 变量，奖励指令里也能用变量
LuckPerms 等用指令发放权限组、VIP（写在奖励的 commands）

没装云界面、玩家没接受资源包或用基岩版连线时，自动改用箱子菜单与手持二维码地图，不需要另外设定。

安装​

  1. 关服，把 CloudPay-<版本>-简体授权版.jar 放进 plugins/
  2. 开服一次，产生 plugins/CloudPay/（config.yml、messages.yml、keys/、token.yml）
  3. 登录 资源中心 免费领取云支付，到会员中心「我的授权」复制授权码，填进 plugins/CloudPay/token.yml，重启（首次启动自动绑定本机）
  4. 把支付宝 / 微信的密钥文件放进 plugins/CloudPay/keys/，在 config.yml 填好 APPID / 商户号，把 enabled 改成 true
  5. 输入 /cpay reload，再输入 /cpay admin check 检测配置
没填授权码时

插件照常加载，可以设定与检测支付配置；玩家下单要填好授权码并重启后才会开启。已经付款的订单无论如何都会照常发放。

升级​

关服，替换 jar，开服。设定、订单与累计充值都保留；云界面画面文件没改过的会自动更新。

最后于 更新