# 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 ` (`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`, 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 ```bash gradle clean jar ``` Output: `build/libs/ContainerPipes-.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.