原创 工具 经济 [1,7-1.21.X]FoxPay —— 高性能低费率的码支付充值插件 | [Folia支持] 3.0

[MD] # FoxPay 3.0｜1.7.10-26.2 个人码支付插件 高性能低费率的码支付充值插件 ## ✨ 功能 - 一个插件 JAR 支持 `1.7.10-26.2` - 支持 Spigot、Paper、Folia、CatServer、Mohist 等服务端 - ProtocolLib MAP 数据包显示收款码；1.7.10 使用分列像素包并阻止原版地图覆盖，1.8+ 自动适配当前服务端包结构 - 支付中输入 `/fp quit` 可主动退出，并自动收回二维码地图 - 支付期间可以正常打开箱子和插件 GUI；客户端仅隐藏玩家自己的背包槽位并保留付款地图 - 遮罩不会删除服务端真实物品；支付结束或退出后自动恢复 - 查单已切换到 FoxPay 官方单订单接口，旧 `trade.foxpay.top` 地址会自动迁移 - 1.8 及以上优先 Title 提示，1.7.10 自动回退聊天提示 - 支持支付宝、微信和自定义充值金额 - 支持礼包菜单、分页、权限和每名玩家自定义限购次数；礼包图标显示配置 Lore、售价与限购 - 礼包使用 `kits/*.yml` 一礼包一文件，旧 `Kits.yml` 会自动迁移并保留备份 - 管理员 GUI 可新建礼包，并分行预览、修改名称、描述、价格、材质、权限、限购次数和奖励命令 - `/foxpay add <玩家> <金额>` 可手工增加累计充值，不生成支付订单或奖励 - SQLite 单服存储，MySQL 群组服共享数据 - 中文、英文命令消息与 PlaceholderAPI 累充变量 ## 📦 安装 1. 安装与自己服务端版本匹配的 ProtocolLib。 2. 把 `FoxPay-3.0.jar` 放进 `plugins`。 3. 启动服务器，等待依赖下载完成。 4. 打开 `plugins/FoxPay/config.yml`，填写商户 ID 和商户密钥。 5. 输入 `/foxpay test` 完成一次 1 元测试。 ProtocolLib 是必装插件。需要不同版本的 ProtocolLib：1.7.10 可使用 3.6.5 等旧版；1.21.11 请使用明确支持该协议的当前开发构建，并按发布说明为 Paper、Spigot 或混合端选择对应构建。 FoxPay 已在 Thermos 1.7.10、CatServer 1.16.5、Leaf 1.21.11(Paper)1.21.11 和 Folia(分支) 26.2 完成启动与重载测试。 HikariCP、数据库驱动和二维码库会由 LibaryLoader 下载到 FoxPay 数据目录，不会塞进插件 JAR。首次启动请保持服务器能访问 Maven Central。 ## 🎮 命令 - `/foxpay help` 查看帮助 - `/foxpay pay <金额> [alipay|wxpay]` 发起充值 - `/fp quit` 退出当前支付并收回二维码地图 - `/foxpay menu` 打开礼包菜单 - `/foxpay menu admin` 打开礼包管理 GUI - `/foxpay buy <礼包> [alipay|wxpay]` 购买礼包 - `/foxpay add <玩家> <金额>` 增加玩家累计充值 - `/foxpay reload` 热重载配置、语言、礼包和菜单 - `/foxpay test` 发起 1 元测试订单 管理员权限：`foxpay.admin.reload`、`foxpay.admin.test`、`foxpay.admin.add`、`foxpay.admin.kits`。玩家权限：`foxpay.use`、`foxpay.pay`、`foxpay.quit`、`foxpay.menu`、`foxpay.buy`。 ## ❓ 排查 - 依赖下载失败：检查网络和 `plugins/FoxPay/libraries` 目录。 - MySQL 连接失败：检查地址、账号和 `FOXPAY_DB_PASSWORD` 环境变量。 - 支付成功却没有奖励：查看控制台订单号与数据库日志，并把日志反馈到群内。 作者：MoutainSeaL QQ：3643203568 QQ群：974437499 [/MD]