常见问题

排查步骤：

1. 检查工具是否在白名单

   tools:
     - "ia:your_namespace:your_tool"

2. 检查方块是否在 targets.yml

   键名必须与 ItemsAdder 的 namespaced ID 完全一致

3. 开启 debug 模式

   settings:
     debug: true

   查看控制台日志，定位具体原因

4. 确认 ItemsAdder 已加载完成

   等待 /iazip 完成后再测试

1. 确认玩家数据已加载

   使用 /iagather info 查看当前等级

2. 检查数据库连接

   如使用 MySQL，确认连接正常

3. 重载配置

   /iagather reload

1. 检查 on-success 配置

   on-success:
     action_drop:
       type: drop-item
       chance: "1.0"  # 确保概率大于 0
       value:
         item: "example:drop_1"
         min: 1
         max: 1

2. 确认物品 ID 正确

   item 必须是有效的 ItemsAdder 物品 ID

3. 检查 chance 表达式

   表达式结果必须 > 0 才会掉落

1. 确认技能已启用

   skills:
     passive_success_1:
       enabled: true  # 不能是 false

2. 检查解锁条件

   满足等级要求或拥有权限节点

3. 确认 success-expression 使用了占位符

   success-expression: "0.6 + {skill-passive-bonus}"

   必须在公式中引用技能占位符才会生效

IAGather 需要以下前置插件：

• ItemsAdder - 必须
• CustomCrops - 必须

检查方法：

1. 确认两个插件都已安装且成功加载
2. 检查服务端版本是否为 1.20.4+
3. 检查 Java 版本是否为 17+

1. 检查 MySQL 配置

   database:
     enable: true
     host: localhost
     port: 3306
     user: root
     password: your_password
     database: minecraft

2. 确认数据库已创建

   CREATE DATABASE minecraft;

3. 回退到 SQLite

   设置 enable: false 使用本地 SQLite 数据库