Farmhand — 一键种植 / 连锁收获 / 自动锄地

Farmhand 是一个 Minecraft Fabric 实用模组，为原版 Farming 体验提供范围自动化操作——自动锄地、连锁种植、连锁收获+自动补种，所有功能仅在潜行时触发，非潜行完全保留原版行为。

🌱 种田加速器，不破坏原版平衡，不添加新方块/物品。

---

功能一览

功能	触发方式	作用范围	上限	说明
🧑‍🌾 自动锄地	潜行 + 右键（手持锄头）	9×9 矩形	无	将周围可耕方块统一变为耕地，消耗耐久
🌱 连锁种植	潜行 + 右键（手持种子）	3×3 BFS 扩散	80	沿空耕地连通域批量种植，种子自动从背包补充
🌾 连锁收获+补种	潜行 + 右键（对准成熟作物）	3×3 BFS 扩散	80（可配置）	沿同种成熟作物连通域收获并自动补种，标准作物掉落物自动进背包

---

详细用法

自动锄地

1. 手持任何锄头
2. 潜行 + 右键点击地面
3. 以点击位置为中心的 9×9 范围内的草方块、泥土、粗泥、土径、缠根泥土会被翻为耕地
4. 耐久不足时自动停止，避免锄头损坏

连锁种植

1. 手持种子/作物物品（小麦种子、胡萝卜、马铃薯、甜菜种子、下界疣、可可豆）
2. 潜行 + 右键点击空耕地
3. 从点击位置开始，以 3×3 逐层扩散（BFS） 方式沿连通空耕地批量种植
4. 当前手持种子用完后，自动从背包工具栏 → 背包依次搜索同种种子继续种植
5. 单次上限 80 格，达到上限后即使还有连通空耕地也会停止

连锁收获 + 自动补种

1. 潜行 + 右键点击成熟作物
2. 从点击位置开始，以 3×3 逐层扩散（BFS） 方式沿同种成熟作物连通域批量收获
3. 收获后自动从背包搜索种子进行补种（可可豆会在周围丛林原木上补种）
4. 标准作物（小麦、胡萝卜、马铃薯、甜菜根、下界疣）掉落物优先进入背包，背包满时掉落在地
5. 单次上限 80 格（可在 Mod 菜单中配置），达到上限后即使还有连通作物也会停止
6. 支持的特殊作物：
   • 标准作物：小麦、胡萝卜、马铃薯、甜菜根、下界疣 → 收获 + 补种 + 自动进背包
   • 可可豆 → 收获 + 在周围丛林原木自动补种
   • 甜浆果 → 收获浆果，植株保留为 age=1
   • 发光浆果 → 收获浆果，vines 保留
   • 西瓜 / 南瓜 → 破坏果实方块
   • 甘蔗 → 破坏第二格及以上，保留根部
   • 竹子 → 破坏第二格及以上，保留根部

---

支持作物列表

种子/物品	作物方块	种植	收获	补种
小麦种子	小麦	✅	✅	✅
胡萝卜	胡萝卜	✅	✅	✅
马铃薯	马铃薯	✅	✅	✅
甜菜种子	甜菜	✅	✅	✅
下界疣	下界疣	✅	✅	✅
可可豆	可可豆	✅	✅	✅（丛林原木）
—	甜浆果	❌	✅	—
—	发光浆果	❌	✅	—
—	西瓜/南瓜	❌	✅	—
—	甘蔗	❌	✅（保留根部）	—
—	竹子	❌	✅（保留根部）	—

---

安装

环境要求

• Minecraft: 26.1.2（对应 1.21.5+）
• Mod Loader: Fabric Loader ≥0.19.3
• Java: ≥25
• 必选依赖: Fabric API（任意兼容版本）
• 可选依赖:
  • Cloth Config API — 提供配置界面
  • Mod Menu — 在 Mod 列表中点击配置按钮

步骤

1. 安装 Fabric Loader
2. 下载 Fabric API 放入 .minecraft/mods/
3. 下载 Farmhand 的 JAR 文件放入 .minecraft/mods/
4. （可选）安装 Cloth Config API 和 Mod Menu 以获得可视化配置界面
5. 启动游戏

---

配置

安装 Mod Menu + Cloth Config API 后，可在游戏内 Mod 列表中找到 Farmhand，点击配置按钮打开设置界面：

选项	默认值	范围	说明
单次操作上限 (maxOperation)	80	1~500	单次连锁种植或收获的最大方块数

也可直接编辑 .minecraft/config/farmhand.json 文件。

---

构建

# Windows
gradlew build

# macOS / Linux
./gradlew build

构建产物位于 build/libs/ 目录。

CI/CD

本项目已配置 GitHub Actions：

• 构建：每次 push 或 pull_request 自动执行 ./gradlew build，产物上传至 Actions Artifacts
• 发布：推送 v*.*.* 格式的标签（如 v1.1.0）时，自动在 GitHub Releases 页面创建发行版，并附上 JAR 文件

工作流文件：.github/workflows/build.yml

发布流程：

# 确保版本号正确后，打标签并推送
git tag v1.1.0
git push origin v1.1.0

---

模组信息

• Mod ID: farmhand
• 开发框架: Fabric Loom
• 映射: Mojang 官方映射（Official mappings）
• 许可证: CC0-1.0

---

开发

本项目使用 Fabric Loom 构建，源码结构：

.opencode/
└── instructions.md                    # 项目规则（AI 提示词）
src/
├── main/
│   ├── java/com/farmhand/
│   │   ├── TemplateMod.java           # Mod 主入口（初始化配置）
│   │   ├── config/
│   │   │   └── FarmhandConfig.java    # 配置定义（Cloth Config）
│   │   └── handler/
│   │       └── FarmHandler.java       # 核心功能处理器
│   └── resources/
│       └── fabric.mod.json            # Mod 元数据
└── client/
    ├── java/com/farmhand/
    │   ├── client/
    │   │   └── TemplateModClient.java # 客户端入口
    │   └── config/
    │       └── ModMenuIntegration.java# ModMenu 集成入口
    └── resources/

核心逻辑全部集中在 FarmHandler.java 中，通过 Fabric API 的 UseBlockCallback 事件监听玩家交互。