跳到主要内容

常见问题

安装问题​

插件无法加载​

症状：服务器启动时控制台显示插件加载失败。

排查步骤：

  1. 检查 Java 版本

    java -version

    需要 Java 8 或更高版本。

  2. 检查 Minecraft 版本 AIOShop 支持 1.12.2 - 1.21。

  3. 检查控制台错误日志 查找 [AIOShop] 相关的错误信息。

Vault 货币不工作​

症状：购买时提示货币不足，但玩家确实有钱。

排查步骤：

  1. 确认 Vault 已安装

    /plugins

    列表中应有 Vault。

  2. 确认已安装经济插件 需要 EssentialsX、CMI 等经济插件配合 Vault 使用。

  3. 测试 Vault 是否正常

    /balance

    应显示玩家余额。

商店问题​

商店无法打开​

症状：执行 /shop open <ID> 无反应或报错。

排查步骤：

  1. 检查商店 ID

    /shop list

    确认商店存在。

  2. 检查权限 确认玩家有 aioshop.use 权限。

  3. 检查配置文件语法 使用 YAML 验证工具检查配置文件。

商品不显示​

症状：商店打开后是空的。

排查步骤：

  1. 检查商品 enabled: true

  2. 检查 item-slots 配置 确认模板中定义了足够的展示槽位。

  3. 重载配置

    /shop reload

交易问题​

购买后没有收到物品​

症状：货币扣除但物品未入包。

排查步骤：

  1. 检查背包空间 背包满时无法购买。

  2. 检查 buy-rewards 配置 确保配置了正确的奖励。

  3. 检查物品 ID item-id 必须是有效的 Minecraft 物品或 items.yml 中定义的物品。

无法出售物品​

症状：右键点击商品无反应。

排查步骤：

  1. 检查是否配置了 sell-item-matcher

  2. 检查物品匹配条件 确保背包中的物品符合匹配条件。

  3. 检查出售限购 可能已达到出售限制。

随机商店问题​

商店不刷新​

症状：每天打开商店，商品都一样。

排查步骤：

  1. 确认 random-generation.enabled: true

  2. 检查刷新周期配置

  3. 手动强制刷新测试

    /shop refreshshop <商店ID>

刷新点数不扣除​

症状：点击刷新按钮后商店刷新但点数没有减少。

排查步骤：

  1. 检查数据库连接

  2. 检查刷新点数管理器配置

性能问题​

打开商店卡顿​

可能原因：

  • 商品数量过多
  • 随机商店生成计算
  • 数据库查询慢

解决方案：

  1. 减少单个商店的商品数量
  2. 使用 MySQL 替代 SQLite（大型服务器）
  3. 定期清理过期的限购数据