# 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**

| 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-<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.
