CooPay 常见问题（FAQ）

更新: 7/11/2026 字数: 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: 修改 message.yml，然后执行 /cp reload 使配置生效。

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

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

Q: 支持哪些支付方式？

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