智能分配器

智能分配器

实用的原版增强型发射器自动化：种植作物、锄头收割并补种、工具加工、装瓶水、制造泥巴和挤奶。

红石

🇬🇧 English

Smart Dispensers

Smart Dispensers 将原版 Minecraft 发射器升级为直观、模块化的微型自动化和农业引擎，无需复杂的科技机械或外部能源系统。

本模组不注册任何新物品、方块或实体——它完全通过原版方块、物品、发射器行为和 Data Components 运作。它是 100% 服务端的：玩家无需安装任何客户端模组即可连接到你的服务器！

✨ 特性

  • 自动化农业： 在合适的土壤上种植作物、种子、树苗、蘑菇、下界疣、可可豆和甜浆果。
  • 锄头智能收割： 收割成熟作物，掉落产物，自动以 age 0 重新种植，并消耗 1 点锄头耐久，而不会在未成熟植物上浪费使用次数。
  • 方块工具处理： 用斧头去皮原木、刮除铜的氧化层/蜡，用锹平整土径，用锹熄灭营火，用锄头耕地。
  • 流体与瓶子： 从水源填充空玻璃瓶；用水瓶将泥土变成泥。
  • 动物照料： 用桶挤牛奶和山羊奶，用碗从哞菇收集蘑菇煲，并用食物触发繁殖模式。
  • 运行时配置： 实时 /dispenser gamerule 命令可即时应用并保存配置更改，支持 Brigadier 自动补全。
  • 跨平台支持： 为 Minecraft 1.19.2、1.21.1、1.21.4、1.21.8 和 1.21.11 提供 Fabric、Forge 和 NeoForge 的原生构建。

🌱 农业与种子种植

发射器可识别所有原版作物，并自动将它们种植在前方有效的土壤上：

种子 / 物品 目标土壤方块 结果作物
小麦、甜菜、南瓜、西瓜种子 耕地 种在耕地上的作物
胡萝卜、马铃薯 耕地 种植的胡萝卜 / 马铃薯作物
火把花种子、瓶子草荚果 耕地 种植的远古作物
下界疣 灵魂沙 下界疣作物
可可豆 丛林原木 / 原木 悬挂的可可果
树苗与蘑菇 泥土、草方块、灰化土、菌丝体 种植的树苗或蘑菇
甜浆果 草方块、泥土、灰化土 甜浆果丛

未成熟的作物或不兼容的表面不会白白消耗种子。

🌾 锄头智能收割（自动补种）

将任意木制、石制、铁制、金制、钻石或下界合金锄放入面对成熟作物的发射器中，即可启用 智能收割：

  1. 成熟度检查： 发射器验证作物（小麦、胡萝卜、马铃薯、下界疣或可可）是否已达到最终生长阶段（MAX_AGE）。
  2. 产物掉落： 成熟作物被收割，其完整收获物掉落到世界中（或进入收集漏斗）。
  3. 自动补种： 作物立即以生长阶段 0 重新种植，无需手动放入种子。
  4. 耐久： 精确消耗锄头的 1 点耐久。
  5. 无浪费： 如果植物尚未完全成熟，锄头动作不会触发，从而保留耐久。

🪓 工具处理：斧、锹和锄

使用标准生存工具改变世界中的方块：

  • 斧：
    • 去除木材和原木的树皮（log → stripped_log）。
    • 刮除涂蜡铜方块上的蜡。
    • 刮除铜方块的氧化风化阶段。
    • 每次操作消耗 1 点耐久。
  • 锹：
    • 将草方块、泥土和砂土压平为土径（dirt_path）。
    • 安全熄灭燃烧的营火和灵魂营火。
    • 每次操作消耗 1 点耐久。
  • 锄：
    • 将泥土、草方块和土径耕为耕地（farmland）。
    • 将缠根泥土清理为普通泥土，并掉落垂根。
    • 每次操作消耗 1 点耐久。

🧪 流体、瓶子、泥与畜牧业

  • 装水瓶： 发射空玻璃瓶面对水源方块，会将其填充为 水瓶（Water Bottle）（解决了原版长期以来的限制）。
  • 制造泥： 发射水瓶面对 泥土 方块，会将其转换为 泥，并将空玻璃瓶返还到发射器中（如果已满则掉落）。
  • 挤牛奶与羊奶： 发射空桶面对牛或山羊，会将桶填充为奶（奶桶）。原版水和岩浆桶逻辑 100% 保留。
  • 哞菇挤奶： 发射木碗面对哞菇，会产出蘑菇煲（蘑菇煲）。
  • 动物繁殖： 发射合适的繁殖食物（牛/羊用小麦、猪/兔用胡萝卜、鸡用种子）面对可繁殖动物，会触发它们的求爱模式（setInLove）。

⚙️ 配置

配置文件：config/dispensermechanics.json（首次运行时自动创建）：

{
  "enablePlanting": true,
  "enableHarvesting": true,
  "enableToolAxe": true,
  "enableToolShovel": true,
  "enableToolHoe": true,
  "enableWaterBottling": true,
  "enableMudCreation": true,
  "enableMilking": true,
  "enableBreeding": true
}

每个参数都可以在运行时独立切换。

⌨️ 游戏内命令

需要权限等级 2（OP）或游戏管理员权限：

/dispenser help
/dispenser reload
/dispenser gamerule <parameter>
/dispenser gamerule <parameter> <value>

示例：

/dispenser gamerule enableHarvesting true
/dispenser gamerule enableWaterBottling false
/dispenser reload

通过 /dispenser gamerule 所做的更改会立即在内存中应用，并写入磁盘，无需重启服务器。

🧩 兼容性与技术说明

  • 仅服务端： 安装在专用服务器或单人世界中。客户端无需安装该模组。
  • 原版兼容性： 不会改变原版发射器战利品表，也不会破坏原版红石电路。
  • 可用加载器： Fabric（需要 Fabric API）、Forge 和 NeoForge，适用于 Minecraft 1.19.2、1.21.1、1.21.4、1.21.8 和 1.21.11。

🇷🇺 Русский

Smart Dispensers

Smart Dispensers 将普通的 Minecraft 原版发射器转变为完整的微型自动化和农业工具，无需建造笨重的科技机械或使用外部能源。

该模组不注册新物品、方块或实体——所有工作都通过原版物品、发射器和 Data Components 完成。该模组 完全为服务端：玩家无需安装客户端模组即可进入服务器！

✨ 主要功能

  • 作物自动种植： 在合适的土壤上播种种子、树苗、胡萝卜、马铃薯、蘑菇、下界疣、可可豆和浆果。
  • 锄头智能收割（Auto-Replant）： 仅收割已成熟植物，掉出产物，自动补种（age 0），并精确消耗 1 点锄头耐久。
  • 工具方块处理： 用斧头去皮原木并清理铜，用锹创建土径并熄灭营火，用锄头耕地。
  • 流体与瓶子： 从水源填充空玻璃瓶，用水瓶将泥土变成泥。
  • 动物照料： 用桶挤牛奶和山羊奶，用碗从哞菇收集蘑菇煲，用食物让动物进入繁殖模式。
  • 即时动态配置： 通过 /dispenser gamerule 命令更改参数，支持 Brigadier 自动补全并保存到磁盘。
  • 跨平台： 支持 Fabric、Forge 和 NeoForge，适用于 Minecraft 1.19.2、1.21.1、1.21.4、1.21.8 和 1.21.11。

🌱 农业与作物种植

发射器会识别前方的正确土壤并种下种子或果实：

种子 / 物品 种植所需方块 结果
小麦、甜菜、南瓜、西瓜种子 耕地（Farmland） 已种植的幼苗
胡萝卜、马铃薯 耕地（Farmland） 已种植的根茎作物
火把花种子、瓶子草荚果 耕地（Farmland） 远古作物
下界疣 灵魂沙（Soul Sand） 生长的下界疣
可可豆 丛林树木材 树干上的可可果
树苗与蘑菇 泥土、草方块、灰化土、菌丝体 已种植的树苗 / 蘑菇
甜浆果 泥土、草方块、灰化土 甜浆果丛

如果土壤方块不合适，或发射器前方已经长着作物——种子不会白白消耗。

🌾 锄头智能收割（Auto-Replant）

如果将任意锄（木、石、铁、金、钻石或下界合金）放入面对成熟植物的发射器中：

  1. 成熟度检查： 发射器判断作物（小麦、胡萝卜、马铃薯、下界疣、可可）是否达到最大生长阶段（MAX_AGE）。
  2. 收割： 成熟作物将种子和果实掉落到世界中（或掉入耕地下方的收集漏斗）。
  3. 自动补种： 在同一方块上立即种下阶段 0 的新植物（无需额外消耗种子）。
  4. 耐久： 锄头精确消耗 1 点耐久。
  5. 安全： 如果植物尚未成熟，锄头不会触发，也不会消耗耐久。

🪓 方块工具处理：斧、锹、锄

可自动执行建筑和地形改造操作：

  • 斧：
    • 去皮木材和原木（log → stripped_log）。
    • 刮除涂蜡铜方块上的蜡。
    • 去除铜方块的氧化阶段（铜绿）。
    • 每次操作消耗 1 点耐久。
  • 锹：
    • 将草方块、泥土和砂土变成土径（dirt_path）。
    • 安全熄灭燃烧的营火和灵魂营火。
    • 每次操作消耗 1 点耐久。
  • 锄：
    • 将泥土、草方块和土径耕为耕地（farmland）。
    • 清理缠根泥土，并掉落垂根。
    • 每次操作消耗 1 点耐久。

🧪 流体、瓶子、泥与畜牧业

  • 装瓶： 空玻璃瓶发射到水源方块前，会变成 水瓶（Water Bottle）。
  • 制造泥： 水瓶作用于 泥土（Dirt）方块时，会将其变成 泥（Mud），并将空瓶返还到发射器物品栏。
  • 挤牛奶与羊奶： 空桶作用于牛或山羊时，会装填奶（Milk Bucket）。原版水和岩浆桶机制未被破坏。
  • 从哞菇收集汤： 碗作用于哞菇时，会装填蘑菇煲（Mushroom Stew）。
  • 动物繁殖： 装有合适食物的发射器（牛和羊用小麦、猪用胡萝卜、鸡用种子）会将前方动物置于求爱模式（setInLove）。

⚙️ 配置

配置文件：config/dispensermechanics.json（首次启动时自动创建）：

{
  "enablePlanting": true,
  "enableHarvesting": true,
  "enableToolAxe": true,
  "enableToolShovel": true,
  "enableToolHoe": true,
  "enableWaterBottling": true,
  "enableMudCreation": true,
  "enableMilking": true,
  "enableBreeding": true
}

每项机制都可以单独开启或关闭。

⌨️ 游戏内命令

需要管理员权限等级（OP 2）或游戏管理员权限：

/dispenser help
/dispenser reload
/dispenser gamerule <параметр>
/dispenser gamerule <параметр> <значение>

示例：

/dispenser gamerule enableHarvesting true
/dispenser gamerule enableWaterBottling false
/dispenser reload

/dispenser gamerule 命令会即时更改服务器逻辑并重写 JSON 文件，无需重启服务器。

🧩 兼容性与技术说明

  • 仅服务端： 安装在服务器或单人世界中。客户端不需要该模组。
  • 原版兼容性： 不会破坏标准原版红石电路和发射器战利品表。
  • 支持的加载器： Fabric（需要 Fabric API）、Forge 和 NeoForge，适用于 Minecraft 1.19.2、1.21.1、1.21.4、1.21.8 和 1.21.11。