原创 付费 闭源 经济 【DubhePay】Minecraft 服务器自助充值插件 v3.3.1

DubhePay v3.3.1 — Minecraft 服务器自助充值插件​

对接标准易支付网关的充值插件。​

玩家在游戏里下单、扫码付款、点券（或礼包、道具）自动到账 —— 全程不需要服主盯着后台手动补。​

四个关键点：一单不丢 · 1.8~26.2 全版本 · 零运行期依赖 · 全异步不卡服​

---

​

一、为什么值得买​

市面上的免费易支付插件不少，问题也出奇一致：漏单、卡服、密钥进日志、多人同时下单互相顶掉订单。DubhePay 就是照这些问题逐个重写的。​

1. 双通道，真正的一单不丢​

内置回调 HTTP 服务（网关付款成功后主动通知）+ 全局定时对账（主动查询订单状态），两条路最终汇入同一个发货方法，按订单号加锁，保证同一笔订单无论被触发多少次，只发一次。​

2. 超时订单照样补发​

很多插件轮询 120 秒就放弃，玩家超时后付款 —— 钱进了你的账户，点券却不发，最后只能你手动补。本插件订单长期保留，只要收到已付款回调，不论隔了多久都自动补发。​

3. 商品商店：卖什么都行​

除"充钱换点券"外，还能让玩家直接挑东西买。玩家输入 /dubhepay shop 看货架，/dubhepay buy 商品ID 下单，价格由你定、玩家改不了。支付成功后执行你写的命令 —— 接任何第三方插件都只是写它的命令，本插件一行代码不用改。​

4. 一份 jar 通吃 1.8 ~ 26.2​

编译为 Java 8 字节码、只使用跨版本稳定的 Bukkit API，旧编号（1.8 ~ 1.21.11）与新编号（26.1 起）两条版本线共用同一个包，不用为不同服务端准备不同版本。​

5. 不卡服​

下单、查询、发货全部在异步线程执行，主线程只负责发消息；配合全局定时对账而不是"一单一任务"，玩家刷命令也不会堆积任务拖垮 TPS。​

6. 零依赖，装了就忘​

JSON 解析、HTTP 客户端、回调服务全部使用 JDK 自带能力，不打包任何第三方库。不会和其它插件抢类加载器，也不会因为你换了某个库的版本就崩掉。​

---

​

二、功能一览​

下面每一条都是配置里真实存在的开关。​

能力	说明
易支付对接	完整实现标准易支付协议（submit.php 收银台 + mapi.php 下单接口 + 异步通知 + 签名校验）。

市面绝大多数易支付系统都实现了这套协议，只要是标准易支付网关就能直接对接。​

默认支持支付宝 / 微信，玩家可用 /dubhepay pay 10 wxpay 指定支付方式，Tab 补全自动列出 |​

| 签名算法 | MD5 或 SHA256 可配（绝大多数网关用 MD5）。签名按参数名 ASCII 升序排序，中文商品名单独 URL 编码，不会出现签名失配 |​

| 商品商店 | 货架式售卖任意内容（礼包 / 道具 / 权限组 / 点券包……），商品命令可带 %player% %uuid% %money% %order% %item% 占位符。默认关闭，配好再上线 |​

| 货币名自定义 | 玩家看到的"点券"字样来自一个配置项，改成 金币 / 钻石 / 积分 / 元宝 全局生效，文案里用 %currency% 引用 |​

| 发货命令模板 | 发什么完全由你写的命令决定，逐条顺序执行。对接 PlayerPoints、EssentialsX 经济、LuckPerms 等只需改配置 |​

| 防刷单限流 | 同一玩家的未支付订单上限、两次下单冷却，均可配置。原版没有这层防护 |​

| 订单持久化 | 订单写入 orders.yml，重启不丢；终态订单 14 天后自动清理 |​

| 管理命令 | 查单、人工补发、立即对账、重载配置、一键补全新版配置项（升级后不用手动比对 config.yml） |​

| 权限分离 | dubhepay.use 默认所有玩家可用，dubhepay.admin 默认仅 OP。无权限时给中文提示，而不是服务端默认的英文拒绝 |​

| 文案全可配置 | 所有玩家可见文字集中在 messages 段，支持 & 颜色码 |​

| 配置容错 | 商品表可自由增删（删掉的不再被"补回来"）；config.yml 写错语法时，控制台直接给出中文出错行号，而不是只丢一条英文堆栈 |​

---

​

三、和 DubheTitles 一起用（如果你买了头衔插件）​

两个插件是两条独立的收款链路，分工建议如下：​

代码：

充钱（DubhePay） → 得点券 → /dtitle vip buy   买会员[/HEADING]
[HEADING=1]                          → /dtitle buy       买头衔[/HEADING]
[HEADING=1]

• DubhePay 管"真钱 → 点券"，以及卖"点券之外的别的东西"（礼包、道具、权限组）
• DubheTitles 管"点券 → 会员 / 头衔"

为什么这么分：同一件东西如果商店里能用真钱买、头衔插件那边又能用点券买，玩家必然走错 ——

点击展开...

"我明明充了点券，为什么买 VIP 还让我付款？" 统一成一条单向链路才清楚。​

所以 shop.items 里不建议再放"VIP / 头衔"商品，那等于开了第二个入口。
​

---

​

四、支持环境​

项目	说明
服务端	Spigot / Paper 及其衍生端（Purpur 等）
Minecraft 版本	1.8 ~ 1.21.11，以及新编号 26.1 起（当前 26.2）
Java 环境	Java 8 ~ Java 25
编译目标	Java 8 字节码（class 52），向下完全兼容
实测环境	Paper 26.2 (build 129) + Java 25 (Temurin 25.0.4.1) —— 加载、启停、命令、权限全流程零异常

如实说明

点击展开...

1.8 ~ 1.21.11 之间的各分支版本、以及 Paper 之外的衍生端，属于"编译层面的兼容保证"，未逐一实机跑过。建议上线前在你的目标版本上先跑一遍，我们提供问题支持。
​

---

​

五、一笔订单是怎么走完的​

两条通道互为备份，任一条通就不漏单。​

1. 玩家下单 —— 校验金额、冷却、未支付订单数，然后异步请求网关拿到收银台链接
2. 落盘 —— 订单写入本地文件，状态 PENDING，重启也不丢
3. 通道一 · 回调 —— 网关付款成功后主动通知，四道校验：验签 → 交易状态 → 订单存在 → 金额一致
4. 通道二 · 对账 —— 定时轮询订单状态兜底，适合回调不可达的内网环境
5. 发货 —— 两条通道汇入同一发货方法，按订单号加锁，幂等只发一次

安全细节

点击展开...

商户密钥绝不写入任何日志（原版会把签名原文打印到控制台，等于把伪造订单的钥匙公开）；发往网关的异常信息统一脱敏。签名按参数名 ASCII 升序排序，中文商品名单独做 URL 编码，不会出现签名失配。
​

---

​

六、上手三步​

第 1 步 · 放入插件目录​

把 jar 丢进服务端 plugins/，重启。首次启动自动生成 config.yml 与订单文件。​

第 2 步 · 填三项配置​

网关地址、商户 PID、商户密钥。填完执行重载，控制台出现"网关校验通过"即成功。​

第 3 步 · 配公网回调（推荐）​

插件自带回调服务，默认监听 8199 端口。有域名的话在 Nginx 上把回调路径反代过来，从此不漏单。不配也能用，轮询兜底。​

想卖东西？改一行​

在 shop 段写商品名、价格、发货命令，把 shop.enabled 改成 true，立刻可售。

不写代码，也能对接现有插件

点击展开...

卖第三方插件的东西，只需一行配置：​

commands: - "称号 给予 %player% 王公贵族"​

我们刻意不把"发头衔"这类业务写进自己的代码里 —— 玩法出问题不会牵连收款链路。
​

---

​

七、正版授权说明​

这是付费插件，需要正版授权密钥才能使用。​

项目	说明
授权方式	购买后获得专属许可证密钥，填入 config.yml 的 license 段，插件启动后联网激活并自动续期
离线宽限	网络临时中断不影响使用，有较长的宽限期，恢复后自动续期
校验失败会怎样	只关闭充值功能。插件不会删除或修改任何文件、不会改动服务器配置、不会关服、不会向外部上报机器信息

对你服务器的承诺

点击展开...

授权模块唯一的职责是控制本插件自身功能的开关。校验失败最严重的后果就是"充值功能暂时不可用"，你的存档与数据始终不受影响。
​

---

​

八、交付内容​

• 插件包 —— 经代码混淆处理，防止被随意二次分发
• 许可证密钥 —— 专属授权，一服一码
• 配置说明 —— 逐项注释的 config.yml，中文说明，照抄即可
• 部署协助 —— 安装、网关对接、回调配置不清楚的，随时问
• 问题支持 —— 使用中出现异常，协助定位到具体环节

已修复的原版缺陷（16 项）

点击展开...

包括：多人同时下单订单号互相覆盖、密钥明文进日志、无异步回调导致重启丢单、轮询超时后付款不补发、无并发限流、签名参数未排序、中文商品名编码失配、金额格式为 10.0 而非 10.00、在主线程发 HTTP 请求导致全服卡顿、商品删掉后重启又被"补回来"、config.yml 语法写错时只有英文堆栈看不出错在哪等。
​

---

​

九、价格与购买​

项目	内容
价格	15 元 / 月
授权形式	按月订阅 —— 一份授权对应一个服务器，到期前续费即可继续使用
联系方式	QQ：2454804303
付款方式	联系 QQ 获取付款方式，付款后即时发码

为什么按月：你不用一次性付一大笔来试一个插件。先用一个月，觉得值再续 —— 不合适就停，没有沉没成本。​

授权到期会怎样：只是充值功能暂停，插件不会删你任何文件、不会动服务器配置、不会关服。​

玩家已经拿到的点券和订单数据一律保留，续费后立刻恢复正常。​

购买前可以先要配置说明文档，确认功能是否满足你的需求再决定 ——​

我们更希望你买之前就想清楚，而不是买完发现不合适。​

关于售后：安装、网关对接、回调配置、报错排查都提供协助。你是第一次接触易支付也没关系，​

把控制台日志发过来我们一起看。​

---

​

DubhePay v3.3.1 ｜ 对接标准易支付网关的 Minecraft 服务端充值插件​

本文档中的功能描述均以插件实际配置项与源码实现为准。跨版本兼容性中未实机验证的部分已在正文明确标注。​