Fluid Hopper 插件
欢迎使用 Fluid Hopper 插件!本插件为 Minecraft 引入了新的机制,允许玩家通过漏斗(Hopper)传输液体(熔岩和水),从而创造出自动化可能性,例如能够自动为熔炉提供燃料的滴水石熔岩发电机。
功能特性
- 自定义流体漏斗: 一种专门处理液体的特殊漏斗。它充当液体的管道系统。
- 流体专属: 流体漏斗将严格拒绝普通物品(如泥土或圆石),并且只会移动由插件生成的“流体物品”。
- 滴水石与桶集成: 当流体漏斗正上方有装满的熔岩或水桶时,它会自动从中提取液体。
- 熔炉自动供能: 装有熔岩的流体漏斗可以直接指向熔炉、高炉或烟熏炉,当燃料不足时自动为其补充燃烧时间。
- 原版机制兼容: 漏斗内的流体以虚拟物品形式表示(
1000mB Lava / 1000mB Water),这使得原版漏斗机制可以将这些流体推入或拉出,实现长距离管道传输!
合成方法
你可以使用与原版的漏斗完全相同的形状来合成流体漏斗,但需要将箱子替换为一个空桶。

安装步骤
- 从发布页面下载最新的
fluid-hopper-1.0-SNAPSHOT.jar 文件(或者从源代码自行构建)。
- 停止你的 Minecraft 服务器。
- 将该
.jar 文件放入服务器的 plugins 文件夹中。
- 启动服务器。插件将自动生成一个数据文件夹,用于追踪你放置的流体漏斗。
支持版本: Paper 1.21.1 和 26.1.2(以及兼容的现代版本)。
使用方法(示例:熔岩发电机)
本插件最流行的用途是利用滴水石创建全自动、无限的熔炉阵列!
- 在滴水石上方放置一个熔岩桶,并在滴水石上方放置一个熔岩源块。等待滴水石慢慢填满桶。
- 在桶的正下方放置一个流体漏斗。
- 一旦桶被填满,流体漏斗就会将其中的熔岩“吸”出,并在自身内部存储一个
1000mB Lava 物品。
- 将流体漏斗指向一个熔炉。
- 当熔炉开始缺乏燃料时,流体漏斗会消耗掉熔岩,并为熔炉提供大量的
20,000 刻燃烧时间(相当于一个熔岩桶),且不会留下任何空桶!
注意:你可以将多个流体漏斗串联起来,以实现长距离的流体传输!
命令与权限
/fluidhopper give - 向执行命令的玩家直接发放一个流体漏斗到其背包中。
注意:普通玩家无法从漏斗 GUI 中提取“虚拟”流体物品。只有拥有 fluidhopper.admin 权限的管理员才能直接与流体物品进行交互。
从源代码构建
如果你希望自行编译该插件:
- 确保已安装 Java 21+(或 Java 25)。
- 克隆此仓库。
- 运行 Gradle 构建包装器:
./gradlew build
- 编译好的插件将位于
build/libs/fluid-hopper-1.0-SNAPSHOT.jar 中。
Fluid Hopper Plugin
Welcome to the Fluid Hopper plugin! This plugin introduces a new mechanic to Minecraft allowing players to transfer liquids (Lava and Water) through hoppers, creating automation possibilities such as Dripstone Lava Generators that automatically fuel Furnaces.
Features
- Custom Fluid Hopper: A specialized hopper that handles fluids exclusively. It acts as a pipe system for liquids.
- Fluid Exclusivity: Fluid Hoppers will strictly reject regular items (like dirt or cobblestone) and will only move "Fluid Items" generated by the plugin.
- Dripstone & Cauldron Integration: Fluid Hoppers will automatically extract liquid from full Lava or Water Cauldrons directly above them.
- Furnace Auto-Fueling: Fluid Hoppers containing Lava can be pointed directly into a Furnace, Blast Furnace, or Smoker to automatically refill their burn time when they run low.
- Vanilla Mechanics: Fluids inside the hoppers are represented as dummy items (
1000mB Lava / 1000mB Water), allowing vanilla hopper mechanics to push and pull these fluids through long pipe systems!
How to Craft
You can craft a Fluid Hopper using the exact same shape as a vanilla hopper, but replace the Chest with an Empty Bucket.

Installation
- Download the latest
fluid-hopper-1.0-SNAPSHOT.jar file from the releases (or build it from source).
- Stop your Minecraft server.
- Place the
.jar file into your server's plugins folder.
- Start your server. The plugin will automatically generate a data folder to keep track of your placed Fluid Hoppers.
Supported Versions: Paper 1.21.1 and 26.1.2 (and compatible modern versions).
How to Use (Example: Lava Generator)
The most popular use case for this plugin is creating a fully automated, infinite furnace array using Dripstone!
- Place a Lava Cauldron with Pointed Dripstone above it, and a Lava Source block above the dripstone. Wait for the dripstone to slowly fill the cauldron.
- Place a Fluid Hopper directly underneath the Cauldron.
- Once the Cauldron is full, the Fluid Hopper will "suck" the lava out of it, storing a
1000mB Lava item inside itself.
- Point the Fluid Hopper into a Furnace.
- When the Furnace starts running out of fuel, the Fluid Hopper will consume the lava and grant the furnace a massive
20,000 ticks of burn time (equivalent to a Lava Bucket) without leaving any empty buckets behind!
Note: You can chain multiple Fluid Hoppers together to move fluid over long distances!
Commands & Permissions
/fluidhopper give - Gives the executing player a Fluid Hopper directly into their inventory.
- Permission:
fluidhopper.admin
Note: Normal players cannot extract the "dummy" fluid items from the hopper GUI. Only administrators with the fluidhopper.admin permission can interact with the fluid items directly.
Building from Source
If you wish to compile the plugin yourself:
- Ensure you have Java 21+ (or Java 25) installed.
- Clone this repository.
- Run the Gradle build wrapper:
./gradlew build
- The compiled plugin will be located in
build/libs/fluid-hopper-1.0-SNAPSHOT.jar.
评论 0
登录后参与评分
还没有评论,来抢沙发吧