BlueGit

timfa containerpipes

Files

README.md

ContainerPipes 1.8.4

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/free for 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

TypeNotes
Chests, trapped chests, copper chests, barrelsFull inventory
Hoppers, dispensers, droppers, shelvesFull inventory
Shulker boxesNormal storage; cannot insert a shulker into a shulker
Furnaces, blast furnaces, smokersInsert: smeltable then fuel (canSmelt / isFuel). Extract: result only
CraftersDestination only; respects disabled slots
Brewing standsInsert: ingredient → fuel → bottles (Paper/canPlaceItem). Extract: bottles only
CompostersInsert compostables (isCompostable / chance). Extract bone meal at full level
Chiseled bookshelvesNormal slots; books via Tag.ITEMS_BOOKSHELF_BOOKS
Decorated potsSingle stacked item type
JukeboxesInsert 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, default minecraft: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 CauldronLevelChangeEvent and internal updates.
  • Visuals: Block displays for pipe segments; optional transfer particles (DRIPPING_WATER / DRIPPING_LAVA / SNOWFLAKE for liquids).
  • Code layout: ContainerPipesPlugin owns connections and player UX; OptimizedTransferPlanner runs item transfers; HopperStyleEndpoints / AdvancedEndpointsPatch cover specialty item blocks and crafter/liquid behaviour.