Description

Flume
Lightweight conduits for NeoForge: many networks in one block.
Flume moves items, fluids and energy through slim iron pipes called strands. One conduit block holds up to four strands, so an item line, a fluid line and two power lines can share the same block without touching. Idle networks cost the server next to nothing, and when something isn't moving, Flume tells you why.
Minecraft: 1.21.1
Loader: NeoForge 21.1.x
Side: Client and server (both need the mod)
Optional: JEI, Curios
Features
- Four strands per block. Item, fluid and energy strands share one block, each in its own lane.
16 channels per type. Lines of the same type on different channels never mix, even when they run side by side.
- Readable at a glance. Each type has a color and a stripe pattern: dashed = items, solid = fluid, line with ticks = energy. Channels use different shades. You can tell lines apart even if you are colorblind.
- Connectors you control. Every arm that touches a machine is a connector: Receive (default), Extract, Both or Off, with a priority. Extract shows a thick flange, Both two thin ones, Off goes gray.
- Filters. Allow or block lists per connector: 9 item slots; fluid slots grow with the network's upgrade (1 to 5). Both connectors have two lists, one for what they extract and one for what they receive. With JEI you can drag items and fluids straight into filter slots.
- No endless loops. Two Both connectors only pass something between them if it can never come back, for example one chest that extracts ore and receives coal, and another that does the opposite. If you really want a loop, you can allow it per connector (with a warning), and `/flume warnings` lists every place where you did.
- No fluid mixing. A fluid network carries one fluid at a time and lets go when it's done, so the wrong fluid never ends up in the wrong tank. Upgraded networks can carry several fluids at once.
- Network upgrades. Upgrade cards I to IV raise a whole network's speed. The network screen shows how many cards you need, and keeps spare cards for when the network grows. Cards can be taken back out.
- "Why isn't it moving?" The connector screen and `/flume why` explain stuck connectors in plain words (nothing to extract, target full, filtered out, wrong fluid, switched off, ...).
- Server friendly. Conduit blocks never tick. Networks run on a shared scheduler with a time budget, sleep when idle and wake up when a neighboring chest, tank or machine changes. See Performance below.
- Works with other mods. Anything that offers NeoForge item, fluid or energy capabilities can connect.
Getting started
Place an Item, Fluid or Energy Conduit. Place more next to it and they join into a line. Strands connect to any machine, chest or tank they touch.
Pick a source. By default every connector only receives. Use the Flume Wrench on the arm that touches your source and set it to Extract. Items, fluid or energy now flow to every receiving connector on that network. Both pulls and receives. It gives to Receive connectors, and to other Both connectors only when their Extract and Receive filters make a loop impossible.
Use the wrench for everything else:
click a connector arm: connector screen (mode, priority, filters, status)
sneak + click a connector arm: cycle its mode
click a tube: network screen (size, speed, upgrades, channel)
with Curios, wear the wrench in your charm slot and Ctrl + click instead of holding it
Add more lines in the same block. Place a different conduit into an existing conduit block; it takes a free lane. Placing against a strand continues that strand's line and channel.
Remove a strand by breaking it (only the strand you look at comes off) or with sneak + empty-hand click to pick it up. Items a connector was holding drop with it; fluid it was holding goes back into the tank it touches.
Speeds
Per extracting connector. Items and fluids move every 10 ticks (twice a second); energy every tick. The whole network runs at the speed of its lowest upgraded node.
No upgrade: 16 items/s, 200 mB/s fluid, 400 FE/t energy
Upgrade I: 32 items/s, 1,000 mB/s fluid, 2,000 FE/t energy
Upgrade II: 128 items/s, 8,000 mB/s fluid, 10,000 FE/t energy
Upgrade III: 512 items/s, 24,000 mB/s fluid, 50,000 FE/t energy
Upgrade IV: 2,048 items/s, 64,000 mB/s fluid, 250,000 FE/t energy
Several strands extracting from the same face add up. That's intended: it is a way to go past the top tier.
Performance
Measured 2026-11-08 with Flume 0.0.29 to 0.0.31 on Minecraft 1.21.1 / NeoForge 21.1.265, on a dedicated test server with no players online. Server cost is the change in milliseconds per tick against an empty baseline.
1,000 idle networks: about 0.01 ms per tick (below the measurement noise)
1,000 busy networks (2 chests and 3 conduits each, 16 items/s each): about 1.1 to 1.3 ms per tick, mostly vanilla chest work
One connector at Upgrade IV: 2,045 items/s, about 38 ns of Flume time per item
Soak: 556 networks for 46 min with chunk reloads, block breaking, `/clone` and a restart: nothing lost or duplicated, no errors, no slowdown over time
`/flume profile` shows what Flume costs in your own world.
Recipes
Item Conduit (makes 16): 6 iron ingots, 2 copper ingots, 1 hopper
Fluid Conduit (makes 16): 6 iron ingots, 2 copper ingots, 1 bucket
Energy Conduit (makes 16): 6 iron ingots, 2 copper ingots, 1 block of redstone
Flume Wrench (makes 1): 3 iron ingots, 1 copper ingot
Upgrade I (makes 16): 4 iron ingots, 4 redstone, 1 copper ingot
Upgrade II (makes 16): 8 Upgrade I around 1 block of gold
Upgrade III (makes 16): 8 Upgrade II around 1 diamond
Upgrade IV (makes 16): 8 Upgrade III around 1 netherite ingot
JEI shows the exact shapes. Every conduit in a network needs its own card, so cards come in sixteens.
Commands
All need operator permission (level 2). Look at a conduit first where noted.
`/flume network`: Networks in the conduit you look at, with their connectors and cost
`/flume why`: Why the connector you look at isn't moving anything
`/flume stats`: Number of networks and what they delivered since the world loaded
`/flume warnings`: Everything that needs attention in all loaded areas: connectors with loops allowed, networks switched off by an error, connectors stuck holding items or fluid. Click a line for a teleport command
`/flume profile [top]`: The most expensive networks and scheduler totals; `reset` clears the counters
Configuration
Server config: `config/flume-server.toml` (created on first start). The defaults are fine for most servers.
`tickBudgetMs` (default 4.0): Time all Flume networks in one world may use per tick
`basicItemsPerRun` (default 8): Items per run, no upgrade
`itemIntervalTicks` (default 10): Ticks between runs of a busy item network
`basicFluidPerRun` (default 100): mB per run, no upgrade
`fluidIntervalTicks` (default 10): Ticks between runs of a busy fluid network
`basicEnergyPerTick` (default 400): FE per tick, no upgrade
`fluidLockReleaseTicks` (default 20): Idle ticks before a fluid network lets go of its fluid
`fluidMaxLockTicks` (default 1200): Longest a fluid network keeps one fluid while others wait
`maxSlotsScannedPerOp` (default 64): Slots of an inventory one connector checks per transfer
`idleSafetyPollTicks` (default 100): How often a sleeping item or fluid network checks anyway
`energyIdleMaxSleepTicks` (default 20): Same for energy networks
`wakeOnNeighborChange` (default true): Wake networks when a neighboring block changes
Known limits
Fluid held by a connector goes back into the tank it touches when the strand is removed; if that tank is full or gone, the rest is lost (fluid can't drop as an item).
Mekanism chemicals and heat are planned, not in yet.
Minecraft 1.21.1 only for now; newer versions come later.
License and credits
Code: MIT. Art: CC BY 4.0.
Block and item textures are drawn by scripts. The logo, icon and banner background were made with AI assistance (Z-Image Turbo, Apache-2.0 model) and edited by hand.
Part of the Ebb & Flow mod family.
AI assistance
Flume was planned and written with the help of an AI assistant (code, tests, texts), reviewed and play-tested by the author. Block and item textures are drawn by scripts. The logo, icon and banner background were made with AI image tools (Z-Image Turbo) and edited by hand.




