跳到主要内容

故障排查

症状：插件未启用 / 启动报错​

排查清单：

  1. 确认服务端版本（建议 Paper 1.20.4）与 Java 17
  2. 查看控制台是否出现 数据库连接失败
    • sqlite：检查 plugins/AIOShop/ 是否可写、磁盘是否只读
    • mysql：检查 config.yml 的 host/port/账号密码/库名，确保 MySQL 可连接
  3. 如果你配置了 VAULT / PLAYER_POINTS / PAPI_COMMAND 货币但未安装依赖插件，相关交易会失败

建议做法：

  • 先用默认配置跑通（sqlite + VAULT）
  • 确保 plugins/AIOShop/ 下文件能生成，再逐步启用高级配置

症状：/as list 没有商店 / 商店打不开​

  1. 检查 plugins/AIOShop/shops/ 是否存在 *.yml
  2. 商店 ID = 文件名（例如 general-store.yml 的商店 ID 是 general-store）
  3. 执行 /as reload 重载配置
  4. 检查权限：玩家需要 aioshop.use

症状：随机商店无法刷新​

可能原因：

  • 商店不是随机商店：random-generation.enabled 不是 true
  • 禁用了手动刷新：random-generation.manual-refresh-enabled: false
  • 刷新点数不足：默认大多为 0

解决：

  • 管理员发放/设置点数：/as refreshpoints <玩家名> <商店ID> 10
  • 或强制刷新（不消耗点数）：/as refresh <玩家名> <商店ID>

症状：PAPI 命令货币不可用 / 显示“未知的PAPI货币”​

排查：

  1. 确认安装并启用了 PlaceholderAPI
  2. 检查 plugins/AIOShop/papi-currencies.yml：
    • currencies.<id>.placeholder 不要包含 %
    • add-command / take-command 必须包含 {player} 与 {amount}
  3. 商品价格中的 papi-currency-id 必须与 currencies 下的键一致
  4. 执行 /as reload（会重载 PAPI 货币定义）

症状：卖出失败 / “商品不可出售”​

卖出需要同时满足：

  1. 商品配置了 sell-item-matcher
  2. 玩家背包里存在符合匹配规则的物品

建议：

  • 先从最简单的 material: "DIAMOND" 开始，确认流程 OK 再叠加 name/lore/nbt 条件
  • 如果你配置了 sell-item-matcher 但 sell-rewards 为空，玩家会交物品但得不到奖励（请确认这是你想要的行为）

症状：物品模板（items.yml）损坏 / 报 Base64 相关错误​

说明：

  • items.yml 中的 base64 不建议手动编辑

解决：

  • 用命令重建物品模板：/asitem add <物品ID>
  • 或删除坏条目后 /asitem reload 再重新添加