安装配置

config.yml 完整配置

settings:
  debug: false
  # 锁定同一方块只能被一个人采集
  lock-same-block: true
  # 只处理主手交互
  main-hand-only: true

# 数据库配置
database:
  enable: false         # true=MySQL, false=SQLite
  host: localhost
  port: 3306
  user: root
  password: root
  database: minecraft
  table: iagather

gather:
  # 读条期间允许离目标方块的最大距离
  max-distance: 4.5
  # 读条过程中切换物品则取消
  cancel-on-item-change: true
  # 读条完成后是否移除目标 IA 方块
  remove-target-block: true

# 采集工具白名单
tools:
  # ia:: 或 vanilla:
  - "ia:example:collect_tool"
  - "vanilla:DIAMOND_PICKAXE"

# 占位符映射(注入到 CustomCrops actions)
placeholders:
  skill-level: "{skill-level}"
  skill-passive-bonus: "{skill-passive-bonus}"
  skill-next-bonus: "{skill-next-bonus}"
  gather-success: "{gather-success}"
  gather-target: "{gather-target}"
  gather-tool: "{gather-tool}"
  iagather-flag: "{iagather}"

配置项说明

settings 基础设置

debug 开启调试日志,用于排查问题
lock-same-block 防止多人同时对同一方块采集(防刷机制)
main-hand-only 只响应主手交互,避免主副手重复触发

database 数据库

enable true 使用 MySQL,false 使用 SQLite(本地文件)
host/port/user/password MySQL 连接信息

SQLite 数据文件位于 plugins/IAGather/data.db

gather 采集行为

max-distance 读条期间玩家与方块的最大距离,超过则取消采集
cancel-on-item-change 读条中切换手持物品是否取消采集
remove-target-block 采集完成后是否移除 IA 方块

tools 采集工具

支持两种格式:

  • ia:<namespace>:<id> - ItemsAdder 自定义物品
  • vanilla:<MATERIAL> - 原版物品(使用 Bukkit Material 名)

文件结构

plugins/IAGather/
├── config.yml      # 主配置
├── targets.yml     # 采集目标定义
├── level.yml       # 等级经验表
├── skills.yml      # 技能配置
├── lang/
│   └── zh_CN.yml   # 中文语言文件
└── data.db         # SQLite 数据(如使用)

热重载

修改配置后,无需重启服务器:

/iagather reload

将重新加载所有配置文件和语言文件。需要 iagather.admin 权限。