BlueGit

timfa containerpipes

update readme

timfa Tim Falken · pushed by timfa

Authored 2026-08-11 · 3 months ago

Hash
54eaf6ca2dd9b3da34666738decdb82ed6379ae2
Parent
b625649b
3 files changed +118 −56
.cursor/rules/release-tags.mdc +0 −2
@@ -11,8 +11,6 @@ alwaysApply: true
11 11 - Valid: `1.7.0`, `v1.7.0`, `1.7.10`, `1.8.0`
12 12 - Invalid: `1.7`, `v1.7.0-beta`, `release-1.7.0`, `1.07.0` (no leading zeros in a segment)
13 13
14 Prefer **no** `v` prefix in this repo (`1.7.0`), consistent with existing tags.
15
16 14 ## Creating a release
17 15
18 16 1. Ensure release-related changes are on `master` and pushed.
@@ -11,8 +11,6 @@ alwaysApply: true
11- Valid: `1.7.0`, `v1.7.0`, `1.7.10`, `1.8.0`
11- Valid: `1.7.0`, `v1.7.0`, `1.7.10`, `1.8.0`
12- Invalid: `1.7`, `v1.7.0-beta`, `release-1.7.0`, `1.07.0` (no leading zeros in a segment)
12- Invalid: `1.7`, `v1.7.0-beta`, `release-1.7.0`, `1.07.0` (no leading zeros in a segment)
13
13
14Prefer **no** `v` prefix in this repo (`1.7.0`), consistent with existing tags.
15
16## Creating a release
14## Creating a release
17
15
181. Ensure release-related changes are on `master` and pushed.
161. Ensure release-related changes are on `master` and pushed.
README.md +59 −27
@@ -1,44 +1,76 @@
1 # ContainerPipes 1.7.1
1 # ContainerPipes 1.7.2
2 2
3 Builds on 1.7.0 (Crafter destinations + liquid cauldron pipes).
3 Paper plugin that connects containers with visible pipes and moves items (or cauldron liquids) between them automatically.
4 4
5 ## Powder snow liquids
5 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.
6 6
7 `POWDER_SNOW_CAULDRON` is a third transferable liquid, with the same 3-level `Levelled` behaviour as water:
7 ## Requirements
8 8
9 - one cauldron level moves per transfer interval
10 - empty `CAULDRON` ↔ powder snow levels work like water
11 - water, lava and powder snow never mix (incompatible destination → no transfer)
9 - Paper **26.2** (Java **25**)
10 - No other plugins required
12 11
13 Particle: `SNOWFLAKE` (water/lava still use `DRIPPING_WATER` / `DRIPPING_LAVA`).
12 ## Playing
14 13
15 ## Cauldron endpoint identity
14 1. Shift-click a supported container with an empty hand to pick the **source** side.
15 2. Shift-click the **destination** container the same way.
16 3. If a free route exists within range, a pipe appears and transfers start.
16 17
17 A liquid endpoint is the **cauldron position**, not the current block material. The same pipe stays valid across:
18 - **Shift + shears** on a pipe (or its endpoints) removes the connection.
19 - **Shift-click** an *item* pipe segment to open its filter (up to five materials). Liquid pipes have no filter UI.
20 - Only **liquid → liquid** (cauldron family) and **item → item** connections are allowed; mixed endpoints cancel the selection.
18 21
19 `CAULDRON` ↔ `WATER_CAULDRON` ↔ `LAVA_CAULDRON` ↔ `POWDER_SNOW_CAULDRON`
22 Admin command: `/containerpipes <status|reload|refresh>` (`containerpipes.admin`).
20 23
21 ## Hopper-style containers (face-independent)
24 ## Supported endpoints
22 25
23 Pipes support the same container interactions hoppers do, but **slot choice does not depend on which face the pipe attaches to**. Incoming vs outgoing pipes plus Paper slot rules decide the behaviour.
26 **Item containers**
24 27
25 | Endpoint | Behaviour |
28 | Type | Notes |
26 29 |---|---|
27 | Chest / barrel / copper chest / hopper / dispenser / dropper / shelf / shulker | Normal storage (shulker-in-shulker blocked via `Tag.SHULKER_BOXES`) |
28 | Furnace / blast furnace / smoker | Insert: `canSmelt` then `isFuel`. Extract: result slot only |
29 | Crafter | Destination-only; live disabled slots |
30 | Brewing stand | Insert: ingredient → fuel (`Tag.ITEMS_BREWING_FUEL`) → bottles, each gated by Paper/NMS `canPlaceItem`. Extract: bottle slots only |
31 | Composter | Insert: `Material.isCompostable()` + `getCompostChance()`. Extract: bone meal at max level. Level cache only (no slot cache) |
32 | Chiseled bookshelf | Normal slot cache; insert gated by `Tag.ITEMS_BOOKSHELF_BOOKS` |
33 | Decorated pot | Single-item stack via `DecoratedPotInventory` |
34 | Jukebox | Insert if `DataComponentTypes.JUKEBOX_PLAYABLE`; extract when not playing |
30 | Chests, trapped chests, copper chests, barrels | Full inventory |
31 | Hoppers, dispensers, droppers, shelves | Full inventory |
32 | Shulker boxes | Normal storage; cannot insert a shulker into a shulker |
33 | Furnaces, blast furnaces, smokers | Insert: smeltable then fuel (`canSmelt` / `isFuel`). Extract: result only |
34 | Crafters | Destination only; respects disabled slots |
35 | Brewing stands | Insert: ingredient → fuel → bottles (Paper/`canPlaceItem`). Extract: bottles only |
36 | Composters | Insert compostables (`isCompostable` / chance). Extract bone meal at full level |
37 | Chiseled bookshelves | Normal slots; books via `Tag.ITEMS_BOOKSHELF_BOOKS` |
38 | Decorated pots | Single stacked item type |
39 | Jukeboxes | Insert playable discs; extract when not playing |
35 40
36 Not supported (hoppers cannot either): ender chest, lectern. Minecarts/entities and redstone locking are ignored.
41 **Liquid containers** (cauldron family only)
37 42
38 Item legality always comes from Paper APIs / datapack tags — not hardcoded item lists — so datapack changes stay compatible.
43 `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.
39 44
40 ## Still from 1.7.0
45 **Not supported:** ender chests, lecterns, minecarts, boats, redstone locking of hoppers.
41 46
42 Liquid pipes: liquid → liquid only; no filter UI; shift + shears removes. Wakeups via `CauldronLevelChangeEvent` + cache + emergency probe.
47 Item legality uses Paper APIs and datapack tags (not hardcoded item lists), so datapack changes stay compatible.
43 48
44 Existing `connections.tsv` and `config.yml` remain compatible.
49 ## Configuration
50
51 Defaults live in `config.yml` (copied to the plugin data folder on first run):
52
53 - Transfer interval and max connection range
54 - Visual pipe material, scale, and particles
55 - Filter UI titles and player messages (Dutch + English)
56 - Performance: idle sleep, wake probes, display refresh
57
58 Connections are stored in `connections.tsv` under the plugin data folder.
59
60 ## Build
61
62 ```bash
63 gradle clean jar
64 ```
65
66 Output: `build/libs/ContainerPipes-<version>.jar`
67
68 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.
69
70 ## Technical overview
71
72 - **Routing:** A* through empty space between the clicked faces; path and endpoints are persisted.
73 - **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.
74 - **Liquid transfers:** Separate lightweight network with fluid-type/level cache, sleep when empty/full/incompatible, wake on `CauldronLevelChangeEvent` and internal updates.
75 - **Visuals:** Block displays for pipe segments; optional transfer particles (`DRIPPING_WATER` / `DRIPPING_LAVA` / `SNOWFLAKE` for liquids).
76 - **Code layout:** `ContainerPipesPlugin` owns connections and player UX; `OptimizedTransferPlanner` runs item transfers; `HopperStyleEndpoints` / `AdvancedEndpointsPatch` cover specialty item blocks and crafter/liquid behaviour.
@@ -1,44 +1,76 @@
1# ContainerPipes 1.7.1
1# ContainerPipes 1.7.2
2
2
3Builds on 1.7.0 (Crafter destinations + liquid cauldron pipes).
3Paper plugin that connects containers with visible pipes and moves items (or cauldron liquids) between them automatically.
4
4
5## Powder snow liquids
5Pipes 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.
6
6
7`POWDER_SNOW_CAULDRON` is a third transferable liquid, with the same 3-level `Levelled` behaviour as water:
7## Requirements
8
8
9- one cauldron level moves per transfer interval
9- Paper **26.2** (Java **25**)
10- empty `CAULDRON` ↔ powder snow levels work like water
10- No other plugins required
11- water, lava and powder snow never mix (incompatible destination → no transfer)
12
11
13Particle: `SNOWFLAKE` (water/lava still use `DRIPPING_WATER` / `DRIPPING_LAVA`).
12## Playing
14
13
15## Cauldron endpoint identity
141. Shift-click a supported container with an empty hand to pick the **source** side.
152. Shift-click the **destination** container the same way.
163. If a free route exists within range, a pipe appears and transfers start.
16
17
17A liquid endpoint is the **cauldron position**, not the current block material. The same pipe stays valid across:
18- **Shift + shears** on a pipe (or its endpoints) removes the connection.
19- **Shift-click** an *item* pipe segment to open its filter (up to five materials). Liquid pipes have no filter UI.
20- Only **liquid → liquid** (cauldron family) and **item → item** connections are allowed; mixed endpoints cancel the selection.
18
21
19`CAULDRON` ↔ `WATER_CAULDRON` ↔ `LAVA_CAULDRON` ↔ `POWDER_SNOW_CAULDRON`
22Admin command: `/containerpipes <status|reload|refresh>` (`containerpipes.admin`).
20
23
21## Hopper-style containers (face-independent)
24## Supported endpoints
22
25
23Pipes support the same container interactions hoppers do, but **slot choice does not depend on which face the pipe attaches to**. Incoming vs outgoing pipes plus Paper slot rules decide the behaviour.
26**Item containers**
24
27
25| Endpoint | Behaviour |
28| Type | Notes |
26|---|---|
29|---|---|
27| Chest / barrel / copper chest / hopper / dispenser / dropper / shelf / shulker | Normal storage (shulker-in-shulker blocked via `Tag.SHULKER_BOXES`) |
30| Chests, trapped chests, copper chests, barrels | Full inventory |
28| Furnace / blast furnace / smoker | Insert: `canSmelt` then `isFuel`. Extract: result slot only |
31| Hoppers, dispensers, droppers, shelves | Full inventory |
29| Crafter | Destination-only; live disabled slots |
32| Shulker boxes | Normal storage; cannot insert a shulker into a shulker |
30| Brewing stand | Insert: ingredient → fuel (`Tag.ITEMS_BREWING_FUEL`) → bottles, each gated by Paper/NMS `canPlaceItem`. Extract: bottle slots only |
33| Furnaces, blast furnaces, smokers | Insert: smeltable then fuel (`canSmelt` / `isFuel`). Extract: result only |
31| Composter | Insert: `Material.isCompostable()` + `getCompostChance()`. Extract: bone meal at max level. Level cache only (no slot cache) |
34| Crafters | Destination only; respects disabled slots |
32| Chiseled bookshelf | Normal slot cache; insert gated by `Tag.ITEMS_BOOKSHELF_BOOKS` |
35| Brewing stands | Insert: ingredient → fuel → bottles (Paper/`canPlaceItem`). Extract: bottles only |
33| Decorated pot | Single-item stack via `DecoratedPotInventory` |
36| Composters | Insert compostables (`isCompostable` / chance). Extract bone meal at full level |
34| Jukebox | Insert if `DataComponentTypes.JUKEBOX_PLAYABLE`; extract when not playing |
37| Chiseled bookshelves | Normal slots; books via `Tag.ITEMS_BOOKSHELF_BOOKS` |
38| Decorated pots | Single stacked item type |
39| Jukeboxes | Insert playable discs; extract when not playing |
35
40
36Not supported (hoppers cannot either): ender chest, lectern. Minecarts/entities and redstone locking are ignored.
41**Liquid containers** (cauldron family only)
37
42
38Item legality always comes from Paper APIs / datapack tags — not hardcoded item lists — so datapack changes stay compatible.
43`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.
39
44
40## Still from 1.7.0
45**Not supported:** ender chests, lecterns, minecarts, boats, redstone locking of hoppers.
41
46
42Liquid pipes: liquid → liquid only; no filter UI; shift + shears removes. Wakeups via `CauldronLevelChangeEvent` + cache + emergency probe.
47Item legality uses Paper APIs and datapack tags (not hardcoded item lists), so datapack changes stay compatible.
43
48
44Existing `connections.tsv` and `config.yml` remain compatible.
49## Configuration
50
51Defaults live in `config.yml` (copied to the plugin data folder on first run):
52
53- Transfer interval and max connection range
54- Visual pipe material, scale, and particles
55- Filter UI titles and player messages (Dutch + English)
56- Performance: idle sleep, wake probes, display refresh
57
58Connections are stored in `connections.tsv` under the plugin data folder.
59
60## Build
61
62```bash
63gradle clean jar
64```
65
66Output: `build/libs/ContainerPipes-<version>.jar`
67
68Releases 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.
69
70## Technical overview
71
72- **Routing:** A* through empty space between the clicked faces; path and endpoints are persisted.
73- **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.
74- **Liquid transfers:** Separate lightweight network with fluid-type/level cache, sleep when empty/full/incompatible, wake on `CauldronLevelChangeEvent` and internal updates.
75- **Visuals:** Block displays for pipe segments; optional transfer particles (`DRIPPING_WATER` / `DRIPPING_LAVA` / `SNOWFLAKE` for liquids).
76- **Code layout:** `ContainerPipesPlugin` owns connections and player UX; `OptimizedTransferPlanner` runs item transfers; `HopperStyleEndpoints` / `AdvancedEndpointsPatch` cover specialty item blocks and crafter/liquid behaviour.
src/README-1.7.1.md +59 −27
@@ -1,44 +1,76 @@
1 # ContainerPipes 1.7.1
1 # ContainerPipes
2 2
3 Builds on 1.7.0 (Crafter destinations + liquid cauldron pipes).
3 Paper plugin that connects containers with visible pipes and moves items (or cauldron liquids) between them automatically.
4 4
5 ## Powder snow liquids
5 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.
6 6
7 `POWDER_SNOW_CAULDRON` is a third transferable liquid, with the same 3-level `Levelled` behaviour as water:
7 ## Requirements
8 8
9 - one cauldron level moves per transfer interval
10 - empty `CAULDRON` ↔ powder snow levels work like water
11 - water, lava and powder snow never mix (incompatible destination → no transfer)
9 - Paper **26.2** (Java **25**)
10 - No other plugins required
12 11
13 Particle: `SNOWFLAKE` (water/lava still use `DRIPPING_WATER` / `DRIPPING_LAVA`).
12 ## Playing
14 13
15 ## Cauldron endpoint identity
14 1. Shift-click a supported container with an empty hand to pick the **source** side.
15 2. Shift-click the **destination** container the same way.
16 3. If a free route exists within range, a pipe appears and transfers start.
16 17
17 A liquid endpoint is the **cauldron position**, not the current block material. The same pipe stays valid across:
18 - **Shift + shears** on a pipe (or its endpoints) removes the connection.
19 - **Shift-click** an *item* pipe segment to open its filter (up to five materials). Liquid pipes have no filter UI.
20 - Only **liquid → liquid** (cauldron family) and **item → item** connections are allowed; mixed endpoints cancel the selection.
18 21
19 `CAULDRON` ↔ `WATER_CAULDRON` ↔ `LAVA_CAULDRON` ↔ `POWDER_SNOW_CAULDRON`
22 Admin command: `/containerpipes <status|reload|refresh>` (`containerpipes.admin`).
20 23
21 ## Hopper-style containers (face-independent)
24 ## Supported endpoints
22 25
23 Pipes support the same container interactions hoppers do, but **slot choice does not depend on which face the pipe attaches to**. Incoming vs outgoing pipes plus Paper slot rules decide the behaviour.
26 **Item containers**
24 27
25 | Endpoint | Behaviour |
28 | Type | Notes |
26 29 |---|---|
27 | Chest / barrel / copper chest / hopper / dispenser / dropper / shelf / shulker | Normal storage (shulker-in-shulker blocked via `Tag.SHULKER_BOXES`) |
28 | Furnace / blast furnace / smoker | Insert: `canSmelt` then `isFuel`. Extract: result slot only |
29 | Crafter | Destination-only; live disabled slots |
30 | Brewing stand | Insert: ingredient → fuel (`Tag.ITEMS_BREWING_FUEL`) → bottles, each gated by Paper/NMS `canPlaceItem`. Extract: bottle slots only |
31 | Composter | Insert: `Material.isCompostable()` + `getCompostChance()`. Extract: bone meal at max level. Level cache only (no slot cache) |
32 | Chiseled bookshelf | Normal slot cache; insert gated by `Tag.ITEMS_BOOKSHELF_BOOKS` |
33 | Decorated pot | Single-item stack via `DecoratedPotInventory` |
34 | Jukebox | Insert if `DataComponentTypes.JUKEBOX_PLAYABLE`; extract when not playing |
30 | Chests, trapped chests, copper chests, barrels | Full inventory |
31 | Hoppers, dispensers, droppers, shelves | Full inventory |
32 | Shulker boxes | Normal storage; cannot insert a shulker into a shulker |
33 | Furnaces, blast furnaces, smokers | Insert: smeltable then fuel (`canSmelt` / `isFuel`). Extract: result only |
34 | Crafters | Destination only; respects disabled slots |
35 | Brewing stands | Insert: ingredient → fuel → bottles (Paper/`canPlaceItem`). Extract: bottles only |
36 | Composters | Insert compostables (`isCompostable` / chance). Extract bone meal at full level |
37 | Chiseled bookshelves | Normal slots; books via `Tag.ITEMS_BOOKSHELF_BOOKS` |
38 | Decorated pots | Single stacked item type |
39 | Jukeboxes | Insert playable discs; extract when not playing |
35 40
36 Not supported (hoppers cannot either): ender chest, lectern. Minecarts/entities and redstone locking are ignored.
41 **Liquid containers** (cauldron family only)
37 42
38 Item legality always comes from Paper APIs / datapack tags — not hardcoded item lists — so datapack changes stay compatible.
43 `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.
39 44
40 ## Still from 1.7.0
45 **Not supported:** ender chests, lecterns, minecarts, boats, redstone locking of hoppers.
41 46
42 Liquid pipes: liquid → liquid only; no filter UI; shift + shears removes. Wakeups via `CauldronLevelChangeEvent` + cache + emergency probe.
47 Item legality uses Paper APIs and datapack tags (not hardcoded item lists), so datapack changes stay compatible.
43 48
44 Existing `connections.tsv` and `config.yml` remain compatible.
49 ## Configuration
50
51 Defaults live in `config.yml` (copied to the plugin data folder on first run):
52
53 - Transfer interval and max connection range
54 - Visual pipe material, scale, and particles
55 - Filter UI titles and player messages (Dutch + English)
56 - Performance: idle sleep, wake probes, display refresh
57
58 Connections are stored in `connections.tsv` under the plugin data folder.
59
60 ## Build
61
62 ```bash
63 gradle clean jar
64 ```
65
66 Output: `build/libs/ContainerPipes-<version>.jar`
67
68 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.
69
70 ## Technical overview
71
72 - **Routing:** A* through empty space between the clicked faces; path and endpoints are persisted.
73 - **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.
74 - **Liquid transfers:** Separate lightweight network with fluid-type/level cache, sleep when empty/full/incompatible, wake on `CauldronLevelChangeEvent` and internal updates.
75 - **Visuals:** Block displays for pipe segments; optional transfer particles (`DRIPPING_WATER` / `DRIPPING_LAVA` / `SNOWFLAKE` for liquids).
76 - **Code layout:** `ContainerPipesPlugin` owns connections and player UX; `OptimizedTransferPlanner` runs item transfers; `HopperStyleEndpoints` / `AdvancedEndpointsPatch` cover specialty item blocks and crafter/liquid behaviour.
@@ -1,44 +1,76 @@
1# ContainerPipes 1.7.1
1# ContainerPipes
2
2
3Builds on 1.7.0 (Crafter destinations + liquid cauldron pipes).
3Paper plugin that connects containers with visible pipes and moves items (or cauldron liquids) between them automatically.
4
4
5## Powder snow liquids
5Pipes 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.
6
6
7`POWDER_SNOW_CAULDRON` is a third transferable liquid, with the same 3-level `Levelled` behaviour as water:
7## Requirements
8
8
9- one cauldron level moves per transfer interval
9- Paper **26.2** (Java **25**)
10- empty `CAULDRON` ↔ powder snow levels work like water
10- No other plugins required
11- water, lava and powder snow never mix (incompatible destination → no transfer)
12
11
13Particle: `SNOWFLAKE` (water/lava still use `DRIPPING_WATER` / `DRIPPING_LAVA`).
12## Playing
14
13
15## Cauldron endpoint identity
141. Shift-click a supported container with an empty hand to pick the **source** side.
152. Shift-click the **destination** container the same way.
163. If a free route exists within range, a pipe appears and transfers start.
16
17
17A liquid endpoint is the **cauldron position**, not the current block material. The same pipe stays valid across:
18- **Shift + shears** on a pipe (or its endpoints) removes the connection.
19- **Shift-click** an *item* pipe segment to open its filter (up to five materials). Liquid pipes have no filter UI.
20- Only **liquid → liquid** (cauldron family) and **item → item** connections are allowed; mixed endpoints cancel the selection.
18
21
19`CAULDRON` ↔ `WATER_CAULDRON` ↔ `LAVA_CAULDRON` ↔ `POWDER_SNOW_CAULDRON`
22Admin command: `/containerpipes <status|reload|refresh>` (`containerpipes.admin`).
20
23
21## Hopper-style containers (face-independent)
24## Supported endpoints
22
25
23Pipes support the same container interactions hoppers do, but **slot choice does not depend on which face the pipe attaches to**. Incoming vs outgoing pipes plus Paper slot rules decide the behaviour.
26**Item containers**
24
27
25| Endpoint | Behaviour |
28| Type | Notes |
26|---|---|
29|---|---|
27| Chest / barrel / copper chest / hopper / dispenser / dropper / shelf / shulker | Normal storage (shulker-in-shulker blocked via `Tag.SHULKER_BOXES`) |
30| Chests, trapped chests, copper chests, barrels | Full inventory |
28| Furnace / blast furnace / smoker | Insert: `canSmelt` then `isFuel`. Extract: result slot only |
31| Hoppers, dispensers, droppers, shelves | Full inventory |
29| Crafter | Destination-only; live disabled slots |
32| Shulker boxes | Normal storage; cannot insert a shulker into a shulker |
30| Brewing stand | Insert: ingredient → fuel (`Tag.ITEMS_BREWING_FUEL`) → bottles, each gated by Paper/NMS `canPlaceItem`. Extract: bottle slots only |
33| Furnaces, blast furnaces, smokers | Insert: smeltable then fuel (`canSmelt` / `isFuel`). Extract: result only |
31| Composter | Insert: `Material.isCompostable()` + `getCompostChance()`. Extract: bone meal at max level. Level cache only (no slot cache) |
34| Crafters | Destination only; respects disabled slots |
32| Chiseled bookshelf | Normal slot cache; insert gated by `Tag.ITEMS_BOOKSHELF_BOOKS` |
35| Brewing stands | Insert: ingredient → fuel → bottles (Paper/`canPlaceItem`). Extract: bottles only |
33| Decorated pot | Single-item stack via `DecoratedPotInventory` |
36| Composters | Insert compostables (`isCompostable` / chance). Extract bone meal at full level |
34| Jukebox | Insert if `DataComponentTypes.JUKEBOX_PLAYABLE`; extract when not playing |
37| Chiseled bookshelves | Normal slots; books via `Tag.ITEMS_BOOKSHELF_BOOKS` |
38| Decorated pots | Single stacked item type |
39| Jukeboxes | Insert playable discs; extract when not playing |
35
40
36Not supported (hoppers cannot either): ender chest, lectern. Minecarts/entities and redstone locking are ignored.
41**Liquid containers** (cauldron family only)
37
42
38Item legality always comes from Paper APIs / datapack tags — not hardcoded item lists — so datapack changes stay compatible.
43`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.
39
44
40## Still from 1.7.0
45**Not supported:** ender chests, lecterns, minecarts, boats, redstone locking of hoppers.
41
46
42Liquid pipes: liquid → liquid only; no filter UI; shift + shears removes. Wakeups via `CauldronLevelChangeEvent` + cache + emergency probe.
47Item legality uses Paper APIs and datapack tags (not hardcoded item lists), so datapack changes stay compatible.
43
48
44Existing `connections.tsv` and `config.yml` remain compatible.
49## Configuration
50
51Defaults live in `config.yml` (copied to the plugin data folder on first run):
52
53- Transfer interval and max connection range
54- Visual pipe material, scale, and particles
55- Filter UI titles and player messages (Dutch + English)
56- Performance: idle sleep, wake probes, display refresh
57
58Connections are stored in `connections.tsv` under the plugin data folder.
59
60## Build
61
62```bash
63gradle clean jar
64```
65
66Output: `build/libs/ContainerPipes-<version>.jar`
67
68Releases 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.
69
70## Technical overview
71
72- **Routing:** A* through empty space between the clicked faces; path and endpoints are persisted.
73- **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.
74- **Liquid transfers:** Separate lightweight network with fluid-type/level cache, sleep when empty/full/incompatible, wake on `CauldronLevelChangeEvent` and internal updates.
75- **Visuals:** Block displays for pipe segments; optional transfer particles (`DRIPPING_WATER` / `DRIPPING_LAVA` / `SNOWFLAKE` for liquids).
76- **Code layout:** `ContainerPipesPlugin` owns connections and player UX; `OptimizedTransferPlanner` runs item transfers; `HopperStyleEndpoints` / `AdvancedEndpointsPatch` cover specialty item blocks and crafter/liquid behaviour.