自动补种

自动补种

一个Minecraft Fabric模组,在收获作物时自动重新种植,省去破坏作物后手动重新播种的繁琐操作。

食物

自动补种

一个 Minecraft Fabric 模组,在收割作物时自动补种,免去破坏作物后手动重新播种的繁琐操作。

演示

自动补种展示

特性

  • 自动补种作物:作物被破坏时会立即以 0 生长阶段重新种植
  • 双重工具验证系统:可选择基于标签或基于具体物品的工具要求
  • 可配置的工具要求:选择是否需要特定工具才能自动补种
  • 智能工具损耗:工具会消耗耐久度,完全支持附魔(如耐久)
  • 潜行模式控制:可配置自动补种始终生效、仅在潜行时生效或仅在站立时生效
  • 高度可配置:丰富的配置选项可自定义行为
  • 模组兼容性:适用于任何继承 Minecraft CropBlock 的模组作物
  • 配套附魔:提供可选配套附魔,可将自动补种作为附魔添加

安装

  1. 安装 Fabric Loader
  2. 下载模组 jar 文件
  3. 将 jar 文件放入你的 mods 文件夹
  4. 启动游戏

配置

模组首次运行时会创建配置文件 config/autoreplanter.json。你可以编辑此文件来自定义模组行为。

配置选项

{
  "validToolTags": ["minecraft:hoes", "farmersdelight:tools/knives"],
  "validTools": ["minecraft:diamond_hoe", "farmersdelight:flint_knife"],
  "enableAutoReplanting": true,
  "damageTools": true,
  "requireTool": true,
  "useValidToolTags": true,
  "useValidTools": false,
  "onlyDamageOnMatureCrop": true,
  "sneakMode": "ALWAYS",
  "customBlockReplacements": [
    {
      "target": "farmersdelight:brown_mushroom_colony",
      "replacement": "minecraft:brown_mushroom",
      "damageTool": true
    },
    {
      "target": "farmersdelight:red_mushroom_colony",
      "replacement": "minecraft:red_mushroom",
      "damageTool": true
    }
  ],
  "useCustomBlockReplacements": true
}
选项 类型 默认值 描述
validToolTags 数组 ["minecraft:hoes", "farmersdelight:tools/knives"] 被视为自动补种有效工具的物品标签列表。仅在 useValidToolTags 为 true 时生效
validTools 数组 ["minecraft:diamond_hoe", "farmersdelight:flint_knife"] 被视为自动补种有效工具的具体物品 ID 列表。仅在 useValidTools 为 true 时生效
enableAutoReplanting 布尔值 true 启用/禁用模组的总开关
damageTools 布尔值 true 工具使用时是否应消耗耐久度
requireTool 布尔值 true 是否必须使用有效工具才能触发自动补种
useValidToolTags 布尔值 true 是否使用基于标签的工具验证。为 false 时,validToolTags 列表将被忽略
useValidTools 布尔值 false 是否使用基于具体物品的工具验证。为 false 时,validTools 列表将被忽略
onlyDamageOnMatureCrop 布尔值 true 工具是否仅在收割成熟作物时消耗耐久度
sneakMode 字符串 "ALWAYS" 根据潜行状态控制自动补种的触发时机。选项:"ALWAYS"、"ONLY_SNEAKING"、"ONLY_STANDING"
customBlockReplacements 数组 见下文 非作物方块的自定义方块替换规则列表
useCustomBlockReplacements 布尔值 true 是否启用自定义方块替换功能

自定义方块替换

模组支持自定义方块替换规则,允许你在破坏非作物方块时自动将其替换为其他方块。这对于蘑菇群落等破坏后应重新种植蘑菇的方块非常有用。

每个自定义方块替换规则具有以下结构:

{
  "target": "farmersdelight:brown_mushroom_colony",
  "replacement": "minecraft:brown_mushroom", 
  "damageTool": true
}
属性 类型 描述
target 字符串 要被替换的方块 ID(你正在破坏的方块)
replacement 字符串 破坏后要放置的方块 ID
damageTool 布尔值 破坏此特定方块是否应消耗工具耐久度

配置示例:

"customBlockReplacements": [
  {
    "target": "farmersdelight:brown_mushroom_colony",
    "replacement": "minecraft:brown_mushroom",
    "damageTool": true
  },
  {
    "target": "farmersdelight:red_mushroom_colony", 
    "replacement": "minecraft:red_mushroom",
    "damageTool": false
  }
]

工作原理:

  • 当你用有效工具破坏 farmersdelight:brown_mushroom_colony 时,它会自动在其位置放置一个 minecraft:brown_mushroom
  • 原方块的掉落物会生成,但会减少一个替换物品(以模拟将其用于补种)
  • 工具损耗根据每条规则的 damageTool 设置应用
  • 所有其他配置选项(工具要求、潜行模式等)仍然适用

注意事项:

  • 自定义方块替换独立于作物方块工作
  • 此功能必须将 useCustomBlockReplacements 设置为 true 才能生效
  • 方块 ID 必须有效且存在于你的游戏中(包括模组方块)
  • 如果替换方块 ID 无效,该规则将被忽略

自动补种附魔支持

有一个额外的可选数据包用于添加附魔支持。如果工具带有自动补种附魔(无论其类型如何,也无论它是否匹配你配置的标签或物品列表),它将始终被视为自动补种的有效工具。这意味着你可以为任何工具附上自动补种附魔,即使它未列在 validToolTags 或 validTools 中,它也能与模组配合使用。可附魔的工具在自动补种附魔数据包中定义。

如果启用了此数据包,模组将自动检测它,无需任何配置。要强制使用附魔并忽略上述配置设置所定义的有效工具,只需在配置中将 useValidToolTags 和 useValidTools 设置为 false。

自动补种附魔数据包可在 Modrinth 上获取

注意:

其他配置设置——如 requireTool、sneakMode 和工具耐久度——仍然适用。

  • 如果 requireTool 设置为 false,任何工具(甚至不使用工具)都能生效,无论是否有附魔。

  • 如果 requireTool 为 true,带有自动补种附魔的工具将始终有效,即使它不匹配你的标签或物品列表。

  • 潜行模式和工具损耗设置仍然被遵循。

这提供了更大的灵活性:你可以将附魔给予自定义工具、模组工具,甚至是你配置中通常不允许的原版工具,它们都能与自动补种无缝配合。

使用示例

默认行为

  • 使用锄头(来自 minecraft:hoes 标签)或刀(来自 farmersdelight:tools/knives 标签)
  • 无论是否潜行都能生效
  • 成熟作物掉落物品(减少一个种子)
  • 作物自动补种
  • 工具消耗 1 点耐久度

仅潜行模式

设置 "sneakMode": "ONLY_SNEAKING" 以仅在潜行时自动补种。这让你能精确控制作物补种的时机,防止在农场中走动时意外补种。

非潜行模式

设置 "sneakMode": "ONLY_STANDING" 以仅在非潜行时自动补种。这允许你通过按住潜行来禁用自动补种,适用于你想手动破坏作物而不补种的情况(例如,搬迁农场时)。

仅基于标签的工具

设置 "useValidTools": false 以仅使用基于标签的验证。validTools 列表将被忽略。

仅特定工具

设置 "useValidToolTags": false 以仅使用特定物品验证。validToolTags 列表将被忽略。

无需工具

设置 "requireTool": false 以启用自动补种,无论使用什么工具(或完全不使用工具)。禁用此项时,两个验证系统都将被绕过。

保留工具耐久度

设置 "damageTools": false 以防止工具消耗任何耐久度。

仅在收割时损耗

设置 "onlyDamageOnMatureCrop": true(默认值)以仅在真正收割成熟作物时损耗工具,而不是在补种未成熟作物时损耗。这样可以在意外破坏未完全生长的作物并被自动补种时,避免不必要的工具耐久度损失。

自定义方块收割

使用自定义方块替换来自动补种蘑菇群落等模组方块:

"customBlockReplacements": [
  {
    "target": "farmersdelight:brown_mushroom_colony",
    "replacement": "minecraft:brown_mushroom",
    "damageTool": true
  }
]

使用默认值,当你破坏 Farmer's Delight 的棕色蘑菇群落时(已满足触发自动补种的有效条件),它会自动放置一个棕色蘑菇并掉落群落的正常战利品(减少一个用于补种的棕色蘑菇)。

支持的作物

模组适用于:

  • 所有原版 Minecraft 作物(小麦、胡萝卜、马铃薯、甜菜根等)
  • 任何继承 Minecraft CropBlock 类的模组作物
  • 这包括来自热门模组如 Farmer's Delight 的作物(已测试且正常工作),并且应该适用于 Croptopia 等其他模组,尽管这些尚未测试。

兼容性

  • Minecraft 版本:1.21.1
  • 模组加载器:Fabric
  • 依赖项:Fabric API
  • 兼容于:大多数农业和耕种模组,特别是那些继承 Minecraft CropBlock 类的模组。

技术细节

  • 使用 Fabric 的 PlayerBlockBreakEvents.BEFORE 拦截作物破坏
  • 遵循耐久等附魔
  • 仅服务端逻辑(在单人游戏和多人游戏中均有效)
  • 自动生成和验证配置
  • 双重工具验证系统支持基于标签和基于具体物品的匹配

常见问题

问:这在服务器上有效吗?

答:是的!模组在单人游戏和多人服务器上均有效。

问:我可以在不重启的情况下更改配置吗?

答:不可以,你需要重启 Minecraft(或服务器)才能使配置更改生效。

问:这与模组作物兼容吗?

答:是的,只要模组作物继承 Minecraft 的 CropBlock 类,就应该有效。

问:带有耐久附魔的工具会更耐用吗?

答:是的!模组使用 Minecraft 内置的耐久度系统,因此所有附魔都能正常生效。

问:我添加了物品到 validTools 但它们不起作用。为什么?

答:确保配置中的 useValidTools 设置为 true。如果为 false,validTools 列表将被忽略。

问:我可以同时使用基于标签和具体物品的验证吗?

答:是的!将 useValidToolTags 和 useValidTools 都设置为 true。只要工具匹配任一系统,就会被视为有效。

问:如何禁用其中一个验证系统?

答:将 useValidToolTags 或 useValidTools 设置为 false 即可禁用相应的验证系统。对应的列表(validToolTags 或 validTools)随后将被忽略。

问:各潜行模式之间有什么区别?

答:"ALWAYS" 无论是否潜行都生效,"ONLY_SNEAKING" 仅在潜行时生效(用于精确控制),"ONLY_STANDING" 仅在非潜行时生效(因此你可以通过潜行来禁用它)。

问:我可以设置无效的潜行模式吗?

答:如果你在配置中设置了无效的潜行模式,模组将回退到 "ALWAYS" 行为。

问:我可以将自定义方块替换用于任何模组方块吗?

答:可以,只要为目标和替换方块指定有效的方块 ID。方块必须存在于你的游戏中,替换才能生效。

问:自定义方块替换与作物兼容吗?

答:自定义方块替换是为非作物方块设计的。常规作物由模组内置的作物补种系统处理。如果作物方块同时定义在自定义方块替换配置中,作物破坏逻辑将优先。

问:我可以为特定自定义方块禁用工具损耗吗?

答:可以!在自定义方块替换规则中设置 "damageTool": false 以防止该特定方块消耗工具耐久度。请注意,作物方块优先于自定义方块,因此如果作物方块定义在自定义方块中,其 damageTool 值将被忽略,以作物方块逻辑为准。

许可证

本项目基于 Creative Commons 许可证授权——详见 LICENCE 文件。

贡献

欢迎贡献!请随时在 GitHub 上提交 Pull Request。

支持

如果你遇到任何问题或有建议,请:

  1. 检查配置文件是否正确设置
  2. 确保正确的验证布尔值(useValidToolTags 和 useValidTools)已启用
  3. 验证你的 sneakMode 设置是有效选项之一
  4. 在 GitHub Issues 页面报告错误

作者:jackclarke95
版本:1.3.1 Minecraft:1.21.1 模组加载器:Fabric