YuPay 命令手册
YuPay 有三个独立玩家入口和一个综合入口。日常建议把 /yp 作为主入口写进公告或菜单，独立命令可按服务器习惯保留或改名。
主命令与别名
| 入口 | 别名 | 用途 |
|---|---|---|
/yupaypay <金额> | /ypay | 独立赞助命令 |
/yupaytop | /yptop | 独立排行榜命令 |
/yupaytotal [玩家名] | /yptotal | 独立总额查询命令 |
/yupay <子命令> | /yp | 综合管理与玩家自助入口 |
综合入口 /yp 内部注册了 pay、top、total、history、orders、order、cancel、retry、code、refund、audit、health 等子命令。
玩家命令
| 命令 | 权限 | 说明 | 示例 |
|---|---|---|---|
/yp pay <金额> [支付方式] [输出模式] [-n] | yupay.command.pay | 发起赞助。支付方式通常为 wechat 或 alipay；输出模式可用 text、link、map；-n 表示无偿赞助，不触发奖励。 | /yp pay 30 wechat map |
/yp top | yupay.command.top | 查看赞助排行榜前 10。 | /yp top |
/yp total [玩家/all] | yupay.command.total | 查询自己、指定玩家或全服累计赞助额。 | /yp total |
/yp history [页数] | yupay.command.history | 查看自己的赞助历史；管理员可追加玩家名查看他人历史。 | /yp history 2 |
/yp orders [页数] | yupay.command.orders | 查看自己的订单列表。 | /yp orders |
/yp order <订单号> | yupay.command.orders | 查看自己的订单详情；待支付订单会提示取消，奖励异常订单会提示重试。 | /yp order YP202606010001 |
/yp cancel [订单号] | yupay.command.cancel | 取消自己的待支付订单；不填订单号时通常处理最近待支付订单。 | /yp cancel |
/yp retry [订单号] | yupay.command.retry | 自助重试补发奖励，适合支付成功但奖励卡住的订单。 | /yp retry YP202606010001 |
/yp code redeem <卡密> | yupay.command.code + yupay.code.redeem | 核销卡密。插件会先展示确认信息，再进入确认/取消流程。 | /yp code redeem FREEGIFT |
/yp refund request <订单号> [金额] | yupay.command.refund + yupay.refund.request | 创建退款申请；不填金额时按插件逻辑处理可退金额。 | /yp refund request YP202606010001 6.66 |
管理命令
| 命令 | 权限 | 说明 |
|---|---|---|
/yp reload | yupay.reload | 重载配置、语言和运行时缓存。 |
/yp set <选项> <值> | yupay.admin | 修改插件配置项。 |
/yp config | yupay.admin | 查看当前配置或配置辅助信息。 |
/yp ban <玩家/all> [原因] | yupay.ban | 禁止玩家发起赞助。 |
/yp unban <玩家/all> | yupay.ban | 解除赞助禁止。 |
/yp convert <玩家> <来源类型> <目标类型> <数量> | yupay.convert | 货币转换，常用于 Vault 与 PlayerPoints 场景。 |
/yp audit | yupay.audit | 查看事件监听审计信息。 |
/yp audit security [lines] | yupay.audit | 查看安全审计日志最近记录。 |
/yp health [summary/full] | yupay.health | 运行健康检查，排查支付渠道、数据库、依赖和回调状态。 |
/yp crossserver [status/queue] | yupay.crossserver | 查看跨服发奖状态和队列统计。 |
卡密命令
卡密入口统一为 /yp code ...，普通玩家只需要 redeem；后台运营再按需分配创建、修改、删除、列表和日志权限。
| 命令 | 权限 | 说明 |
|---|---|---|
/yp code create --code <卡密> [选项] | yupay.code.create | 创建卡密。 |
/yp code remove <卡密> | yupay.code.remove | 数据库层面删除卡密，核销日志保留。 |
/yp code disable <卡密> | yupay.code.disable | 软停用卡密。 |
/yp code enable <卡密> | yupay.code.enable | 恢复启用卡密。 |
/yp code modify <卡密> <字段> <值> | yupay.code.modify | 修改卡密字段。 |
/yp code info <卡密> | yupay.code.info | 查看卡密详情。 |
/yp code list [页数] | yupay.code.list | 查看卡密列表。 |
/yp code logs [卡密] [页数] | yupay.code.logs | 查看核销记录。 |
/yp code redeem <卡密> | yupay.code.redeem | 玩家核销卡密。 |
/yp code redeem-confirm <卡密> | yupay.code.redeem | 确认核销。 |
/yp code redeem-cancel [卡密] | yupay.code.redeem | 取消核销。 |
创建卡密的常用选项：
| 选项 | 示例 | 说明 |
|---|---|---|
--code | --code FREEGIFT | 卡密字符串。 |
--amount | --amount 9.9 | 卡密关联的支付金额。 |
--economy | --economy playerpoints | 经济奖励类型：none、vault、playerpoints、pp。 |
--eco-amount | --eco-amount 100 | 经济奖励数量。 |
--max-uses | --max-uses 50 | 最大核销次数；-1 表示不限次数。 |
--expire | --expire 7d | 过期时间；-1 表示永不过期。 |
--commands | --commands "give {player} diamond 1" | 核销后执行的命令。 |
--remark | --remark "全服礼包" | 备注。 |
bash
/yp code create --code FREEGIFT --amount 0 --economy playerpoints --eco-amount 100 --max-uses 50 --expire 7d --remark "新服礼包"
/yp code modify FREEGIFT max-uses 100
/yp code logs FREEGIFT 1退款命令
退款入口统一为 /yp refund ...。普通玩家只开放 request 即可；直接退款、审核、查询和重试建议只给财务或核心管理员。
| 命令 | 权限 | 说明 |
|---|---|---|
/yp refund request <订单号> [金额] | yupay.refund.request | 玩家创建退款申请。 |
/yp refund approve <请求ID> | yupay.refund.approve | 通过退款申请。 |
/yp refund reject <请求ID> | yupay.refund.reject | 拒绝退款申请。 |
/yp refund pending [页数] | yupay.refund.pending | 查看待审核申请。 |
/yp refund list [页数] | yupay.refund.list | 查看退款日志列表。 |
/yp refund list <pending/processing/accepted/success/failed/closed/unknown> [页] | yupay.refund.list | 按状态查看退款流水。 |
/yp refund info <退款单号> | yupay.refund.list | 查看退款流水详情。 |
/yp refund query <退款单号> | yupay.refund.list | 向平台查询退款状态并刷新本地记录。 |
/yp refund retry <退款单号> | yupay.refund.direct | 重试失败或未知状态退款。 |
/yp refund confirm <退款单号> | yupay.refund.direct | 手动确认退款成功。 |
/yp refund <订单号> [金额] [原因] | yupay.refund.direct | 管理员直接退款。 |
订单运维命令
| 命令 | 权限 | 说明 |
|---|---|---|
/yp order info <订单号> | yupay.order 或玩家自己的 yupay.command.orders | 查看订单详情。 |
/yp order abnormal [页] | yupay.order | 查看异常订单中心。 |
/yp order risk [页] | yupay.order | 查看风险订单。 |
/yp order list <abnormal/pending/cancelled/risk/reward_failed/refund_failed/success> [页] | yupay.order | 按类型列出订单。 |
/yp order player <玩家名/UUID> [页] | yupay.order | 查看某玩家订单。 |
/yp order steps <订单号> | yupay.order | 查看发奖步骤流水。 |
/yp order callbacks <订单号/recent/failed/duplicate> [页] | yupay.order | 查看回调流水。 |
/yp order refunds <订单号> [页] | yupay.order | 查看订单退款流水。 |
/yp order resolve <订单号> <reward/refund/ignore/hold> | yupay.order | 处理取消后到账、金额不符等风险订单。 |
/yp order mark-reviewed <订单号> [备注] | yupay.order | 标记订单已人工复核。 |
/yp order retry-reward <订单号> | yupay.order | 管理员重试发奖。 |
/yp order expire | yupay.order | 立即执行待支付订单过期清理。 |