Little-Maid-Harvest-Helper

# 东方小女仆浆果收获兼容

由 **niumadadi520** 制作的 **东方小女仆** 轻量级农业附属模组。可通过游戏内菜单配置女仆收获作物的方式，也可随整合包分发共享的 YAML 规则。

## 按你的方式收获

– **右键收获**：适用于通过交互产出农产品的作物。
– **破坏但不补种**：适用于应当被移除的可收获方块。
– **破坏并可选补种**：先收获并收集掉落物，然后使用女仆背包中匹配的物品进行补种。刚收获的种子同样可用。若没有可用种子，则留空该位置并继续收获。
– **自定义工具**：选择背包中的物品，或指定物品 ID 或标签，然后选择左键或右键操作。女仆会使用背包中的真实工具。
– **成熟样本**：注册一个你已知可收获的作物，而无需手动输入生长数值。也提供高级属性编辑功能。

## 开始使用

1. 安装本附属模组和东方小女仆。将女仆分配至农业任务，并确保作物位于她的工作范围内且可到达。
2. 在工作台的一列中，用任意羊毛方块放在两根木棍上方，合成一个作物绑定器。
3. 手持绑定器，指向一个成熟作物，在附近有女仆的情况下按下 **Shift + 鼠标中键**。默认附近女仆半径为 16 格。
4. 选择收获操作。打开 **自定义** 进行工具设置，如需补种则选择种植材料。
5. 将规则保存至服务器。**Shift + 右键** 打开共享规则管理。

直接配置在生存和创造模式下均可使用，且无需进行收获演示。

## 整合包共享规则

规则存储于：

“`text
config/tlm_berry_harvest_compat/custom_crops.yaml
“`

整合包作者无需进入游戏即可编辑此文件，并随整合包分发。规则在服务器启动时加载；管理员可在编辑后运行 `/tlmharvest reload`。使用 `/tlmharvest inspect` 可检查作物及女仆的工作条件。

玩家无需管理员权限即可添加和更新规则。删除规则需要管理员权限。在多人游戏中，以服务器的配置为准。

## 需求与兼容性

– **Minecraft Java 版 1.20.1 — 仅限 Forge。**
– **Minecraft 1.20.1 需 Forge 47.4.22 或更高版本。**
– **同一游戏版本需东方小女仆 1.5.3-forge+mc1.20.1 或更高版本。** 已使用 1.5.3 和 Forge 47.4.22 测试。
– 在 **客户端和服务端** 上安装相同版本的附属模组。
– Jade 11+ 为可选。作物模组为可选，并非必需依赖。

内置规则和兼容性回归测试包括 14 Vital Herbs 6.1.1 的草药、部分 Flavor Immersed Daily 2026.7.16 的果树和作物，以及 Kaleidoscope Tavern 1.2.0 的葡萄作物。其他作物可通过菜单或 YAML 进行配置。复杂的 NBT 驱动机制、机器库存和多步骤交互可能仍需专用适配器。南瓜、西瓜及其茎仍由女仆的原有功能处理。