ContainerPipes 1.8.1
Paper plugin that connects containers with visible pipes and moves items (or cauldron liquids) between them automatically.
Pipes are face-independent: behaviour comes from whether a pipe is incoming or outgoing, and from Paper’s own slot rules — not from which side of the block you attach to.
Requirements
- Paper 26.2 (Java 25)
- No other plugins required
Playing
1. Shift-click a supported container with an empty hand (or the configured cost item) to pick the source side. 2. Shift-click the destination container the same way. 3. If a free route exists within range, a pipe appears and transfers start.
- Shift + shears on a pipe (or its endpoints) removes the connection. If a pipe cost is configured, one of that item drops at each 1×1×1 route block.
- Shift-click an item pipe segment to open its filter (up to five materials). Liquid pipes have no filter UI.
- Only liquid → liquid (cauldron family) and item → item connections are allowed; mixed endpoints cancel the selection.
- Pipe cost defaults to iron ingots (
pipe-cost-item: minecraft:iron_ingot). Each route block costs 1 item. Set the value empty/freefor no cost. Too few items? Smoke along the intended path and a chat message with how many you are short.
Admin command: /containerpipes <status|reload|refresh> (containerpipes.admin).
Supported endpoints
Item containers
| Type | Notes |
|---|---|
| Chests, trapped chests, copper chests, barrels | Full inventory |
| Hoppers, dispensers, droppers, shelves | Full inventory |
| Shulker boxes | Normal storage; cannot insert a shulker into a shulker |
| Furnaces, blast furnaces, smokers | Insert: smeltable then fuel (canSmelt / isFuel). Extract: result only |
| Crafters | Destination only; respects disabled slots |
| Brewing stands | Insert: ingredient → fuel → bottles (Paper/canPlaceItem). Extract: bottles only |
| Composters | Insert compostables (isCompostable / chance). Extract bone meal at full level |
| Chiseled bookshelves | Normal slots; books via Tag.ITEMS_BOOKSHELF_BOOKS |
| Decorated pots | Single stacked item type |
| Jukeboxes | Insert playable discs; extract when not playing |
Liquid containers (cauldron family only)
CAULDRON, WATER_CAULDRON, LAVA_CAULDRON, POWDER_SNOW_CAULDRON — one level per transfer tick. Water, lava, and powder snow do not mix. The endpoint is the block position, so filling or emptying the same cauldron does not break the pipe.
Not supported: ender chests, lecterns, minecarts, boats, redstone locking of hoppers.
Item legality uses Paper APIs and datapack tags (not hardcoded item lists), so datapack changes stay compatible.
Configuration
Defaults live in config.yml (copied to the plugin data folder on first run):
- Transfer interval and max connection range
- Optional pipe cost item (
pipe-cost-item, defaultminecraft:iron_ingot; empty/free= no cost) - Visual pipe material, scale, and particles
- Filter UI titles and player messages (Dutch + English)
- Performance: idle sleep, wake probes, display refresh
Connections are stored in connections.tsv under the plugin data folder.
Build
gradle clean jar
Output: build/libs/ContainerPipes-<version>.jar
Releases are tagged as X.Y.Z (optional v prefix). The GitLab pipeline validates the tag, bumps version files, builds the jar, and publishes a GitLab Release.
Technical overview
- Routing: A* through empty space between the clicked faces; path and endpoints are persisted.
- Item transfers: Source containers are grouped and scheduled. Idle groups sleep and wake on inventory/interact/chunk events (plus a slow probe). Furnaces, brewing stands, jukeboxes, and composters use live specialty rules; ordinary inventories use a short-lived slot cache.
- Liquid transfers: Separate lightweight network with fluid-type/level cache, sleep when empty/full/incompatible, wake on
CauldronLevelChangeEventand internal updates. - Visuals: Block displays for pipe segments; optional transfer particles (
DRIPPING_WATER/DRIPPING_LAVA/SNOWFLAKEfor liquids). - Code layout:
ContainerPipesPluginowns connections and player UX;OptimizedTransferPlannerruns item transfers;HopperStyleEndpoints/AdvancedEndpointsPatchcover specialty item blocks and crafter/liquid behaviour.