蓝钦的文档

深浅模式

CooPay 插件命令参考 ​

更新: 2026/8/14 字数: 0 字 时长: 0 分钟

主命令 ​

以下主命令可以互换使用：

text
/coopay [子命令]
/cp [子命令]
/coo [子命令]

命令总览 ​

命令功能执行者权限
/cp查看帮助玩家或控制台无；当前版本未检查已声明的 coopay.help
/cp trade <支付方式> <金额>发起自定义金额订单玩家coopay.trade.wx 或 coopay.trade.zfb
/cp buy <礼包ID> <支付方式>购买指定礼包玩家coopay.buy，以及礼包配置的额外权限
/cp cancel取消当前订单玩家coopay.cancel
/cp info <订单号>查询订单状态玩家或控制台coopay.info
/cp infolist [页码]查看当前玩家创建的订单号玩家；控制台可执行但没有订单数据coopay.list
/cp claim [奖励ID|all]领取已达到的累充档位奖励玩家coopay.claim
/cp reload重载配置和数据库连接玩家或控制台CooPay.admin.reload
/cp recovery <玩家名>按累计充值补发奖励玩家或控制台CooPay.admin
/cp totalpay <add|remove|set> <玩家名> <金额>调整玩家累计充值金额玩家或控制台coopay.admin.totalpay
/cp performance [reset]查看或重置性能统计玩家或控制台CooPay.admin.performance

支付命令 ​

发起自定义金额订单 ​

text
/cp trade <支付方式> <金额>
  • 支付方式：wx（微信）或 zfb（支付宝）。
  • 金额：必须大于 0。当默认礼包设置 integer_only: true 时，只能输入整数。
  • 不同支付方式分别检查 coopay.trade.wx 和 coopay.trade.zfb。
  • config.yml 中的 trade_cooldown 控制玩家创建订单的冷却时间。

购买礼包 ​

text
/cp buy <礼包ID> <支付方式>
  • 礼包必须存在于 rewards.yml，且不能是 default: true 的默认礼包。
  • 玩家必须拥有 coopay.buy；如果礼包配置了 permission，还必须拥有该权限。
  • 创建订单前会检查个人累计限购、全服累计限购和玩家个人冷却。
  • limit 与 global_limit 不会在 refresh_time 到期后重置。

订单命令 ​

text
/cp cancel
/cp info <订单号>
/cp infolist [页码]

info 查询指定订单的支付状态；infolist 每页显示当前玩家自己的 10 个订单号，页码从 1 开始。控制台当前不会读取全服订单列表。

累充奖励命令 ​

text
/cp claim
/cp claim <奖励ID>
/cp claim all
  • 仅在 rewards.yml 的 total_pay_rewards.grant_mode 设为 claim 时需要手动领取。
  • 不带参数或使用 all 会领取当前所有已达成且未领取的档位；指定奖励 ID 时只领取该档位。
  • 奖励 ID 匹配忽略大小写，命令会自动补全已启用的档位 ID。
  • 每个档位对每名玩家只能领取一次，领取记录保存在数据库中。

管理命令 ​

重载配置 ​

text
/cp reload

重载 config.yml、message.yml 和 rewards.yml，随后重新初始化数据库连接。

补发累计充值奖励 ​

text
/cp recovery <在线玩家名>

该命令会先清空玩家的累计充值金额，再按清空前的金额触发默认礼包奖励。奖励命令执行失败时累计金额不会自动恢复，执行前应确认 rewards.yml 配置正确。

与累充档位奖励不同

recovery 使用的是 kits 下的默认礼包，只能对在线玩家执行。它不会重置 total_pay_rewards 的档位领取记录。

调整累计充值金额 ​

text
/cp totalpay add <玩家名> <金额>
/cp totalpay remove <玩家名> <金额>
/cp totalpay set <玩家名> <金额>
  • add 和 remove 的金额必须大于 0；set 可以设为 0，但不能设为负数。
  • 目标可以是在线玩家，也可以是曾经进入过服务器的离线玩家。
  • add 或向上调整的 set 会立即检查累充档位奖励；remove 或向下调整不会撤销已经领取的档位。
  • 操作会持久化到当前使用的 SQLite 或 MySQL 数据库。

性能统计 ​

text
/cp performance
/cp performance reset

第一条查看统计信息，第二条清空当前性能统计计数。