Back to mods
Flume project artwork

CurseForge · Minecraft mod

Flume

Lightweight, server-friendly conduits for items, fluids and energy: up to four networks in one block.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Flume release should I use?

Updated 3 days ago
Latest stable file flume-1.21.1-1.0.0.jar
Game version 1.21.1
Loader NeoForge

flume-1.21.1-1.0.0.jar targets 1.21.1 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. No extra mods listed for this file.

Where it goes

Is Flume required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does flume-1.21.1-1.0.0.jar need?

flume-1.21.1-1.0.0.jar. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Flume without breaking your instance.

Built for flume-1.21.1-1.0.0.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use flume-1.21.1-1.0.0.jar. It targets 1.21.1 with NeoForge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside flume-1.21.1-1.0.0.jar. It opens that exact file at the source.

About this project

What does Flume add?

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.

Project description from CurseForge.

Pick your setup

Flume by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Flume versions and loaders

1 of 1 releases match

Looking for an older file? The official CurseForge project page is in Resources.