跳到主要内容

常见问题

安装问题​

插件未加载​

症状：服务器启动后 /plugins 看不到 IAGather

排查：

  1. 检查控制台是否有错误日志
  2. 确认 plugins/ 目录下有 IAGather-xxx.jar
  3. 确认服务端版本在 1.12 - 1.20 范围内

缺少依赖​

症状：控制台显示 缺少依赖 ItemsAdder/CustomCrops

解决：

  1. 确认已安装 ItemsAdder 和 CustomCrops
  2. 检查这两个插件是否正常加载
  3. 确认插件版本兼容

采集问题​

右键方块无反应​

排查步骤：

  1. 确认方块已配置

    检查 targets.yml 中是否有该方块的配置，key 必须与 ItemsAdder 方块 ID 完全一致。

  2. 确认工具在白名单

    检查 config.yml 中的 tools 列表是否包含你手持的工具。

  3. 确认等级足够

    如果 required-level 大于 0，玩家等级不足时会提示 采集等级不足。

  4. 确认使用主手

    如果 main-hand-only: true，必须用主手持工具右键。

读条中断​

可能原因：

原因说明
离开距离过远超过 max-distance 配置的距离
切换物品cancel-on-item-change: true 时生效
退出游戏自动取消
手动取消执行了 /iagather cancel

采集成功但没掉落物​

排查：

  1. 检查 on-success 动作配置是否正确
  2. 检查 drop-item 的 chance 是否小于 1
  3. 确认 item ID 对应的 ItemsAdder 物品存在

数据问题​

数据未保存​

SQLite 模式：

  • 检查 plugins/IAGather/ 目录是否可写
  • 检查 data.db 文件是否存在

MySQL 模式：

  • 检查数据库连接配置
  • 确认数据库用户有读写权限
  • 检查控制台是否有连接错误

切换数据库​

  1. 修改 config.yml 中的 database 配置
  2. 执行 /iagather reload
  3. 玩家重新进入服务器
警告

切换数据库不会迁移数据，玩家会从 0 级开始。

技能问题​

技能未生效​

排查：

  1. 确认 skills.yml 中技能 enabled: true
  2. 确认玩家等级满足 unlock.level.required
  3. 如果启用了权限解锁，确认玩家有对应权限

下一次采集技能无法激活​

使用方法：

  1. 手持采集工具
  2. 潜行（按住 Shift）
  3. 右键空气

成功标志：收到 已激活技能：下一次采集成功率提升 XX% 消息

性能问题​

服务器卡顿​

排查：

  1. 开启 debug: true 查看日志
  2. 检查是否有大量玩家同时采集
  3. 考虑增加读条时间减少服务器压力

获取帮助​

如果以上方案未能解决问题：

  1. 开启 debug: true 收集调试日志
  2. 记录完整的错误信息和复现步骤
  3. 联系插件作者