CooPay 常见问题（FAQ）

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

故障排除

Q: 插件无法启动？

A: 检查依赖插件、Java 版本、配置文件语法，并查看控制台错误日志。

Q: 需要哪些依赖插件？

A: 必须安装 ProtocolLib 插件；推荐安装 PlaceholderAPI 插件，用于 PAPI 变量支持。

Q: 服务器校验失败

A: config.yml 中的 key 密钥错误

Q: 奖励执行错误？

A: 检查命令语法、权限设置、玩家状态、变量替换。

Q: 如何设置奖励内容？

A: 在 rewards.yml 中配置。推荐使用 [console]、[op] 和 [player] 前缀指定命令执行身份；旧的 commands.console、commands.op 和 commands.player 结构仍然兼容。

Q: PlayerPoints 点券怎么发放？

A: 在 rewards.yml 的默认礼包命令列表中添加 "[console]points give {player_name} {money_scaled_int}"。

Q: refresh_time 到期后为什么仍然提示达到限购？

A: refresh_time 只表示玩家个人购买冷却；limit 和 global_limit 是累计购买上限，不会随冷却到期重置。需要周期性重复购买时，将对应限购设为 -1，再单独配置 refresh_time。

Q: 礼包 Placeholder 首次解析为什么是空字符串？

A: 礼包购买数据使用异步缓存加载，首次解析可能短暂为空；数据载入后再次解析即可得到实际值。

Q: 如何启用补偿功能？

A: 使用 /cp recovery <玩家名> 命令为指定玩家执行补偿。

Q: 如何配置累充档位奖励？

A: 在 rewards.yml 的 total_pay_rewards 下配置档位。amount 是所需累计充值金额，commands 是达到档位后执行的命令，enabled: false 可临时关闭档位。每个档位对每名玩家永久只发放一次。

Q: 累充奖励如何改为玩家手动领取？

A: 将 total_pay_rewards.grant_mode 设为 claim，然后让玩家使用 /cp claim 领取全部可领档位，或使用 /cp claim <奖励ID> 领取指定档位。默认的 auto 会在支付成功、管理员调高累充金额或玩家进服时自动检查并发放。

Q: 修改累充奖励 ID 会怎样？

A: 领取记录按档位 ID 保存。上线后修改 ID 会被视为一个新档位，可能使玩家再次获得奖励，因此已投入使用的档位不要随意改名或复用。

Q: 如何自定义插件消息？

A: 修改 message.yml，然后执行 /cp reload 使配置生效。

Q: 支付成功但没有奖励？

A: 检查 rewards.yml 的命令前缀、命令语法和玩家在线状态，并查看控制台错误日志。

Q: 支持哪些支付方式？

A: 支持微信支付 (wx) 和支付宝 (zfb) 两种支付方式。