update readme
@@ -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: true11
- 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
14
Prefer **no** `v` prefix in this repo (`1.7.0`), consistent with existing tags.15
16
## Creating a release14
## Creating a release17
15
18
1. Ensure release-related changes are on `master` and pushed.16
1. Ensure release-related changes are on `master` and pushed.@@ -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.11
# ContainerPipes 1.7.22
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 liquids5
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
## Requirements8
8
9
- one cauldron level moves per transfer interval9
- Paper **26.2** (Java **25**)10
- empty `CAULDRON` ↔ powder snow levels work like water10
- No other plugins required11
- water, lava and powder snow never mix (incompatible destination → no transfer)12
11
13
Particle: `SNOWFLAKE` (water/lava still use `DRIPPING_WATER` / `DRIPPING_LAVA`).12
## Playing14
13
15
## Cauldron endpoint identity14
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 endpoints22
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`) |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
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.045
**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
## Configuration50
51
Defaults live in `config.yml` (copied to the plugin data folder on first run):52
53
- Transfer interval and max connection range54
- Visual pipe material, scale, and particles55
- Filter UI titles and player messages (Dutch + English)56
- Performance: idle sleep, wake probes, display refresh57
58
Connections are stored in `connections.tsv` under the plugin data folder.59
60
## Build61
62
```bash63
gradle clean jar64
```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 overview71
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
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.11
# ContainerPipes2
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 liquids5
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
## Requirements8
8
9
- one cauldron level moves per transfer interval9
- Paper **26.2** (Java **25**)10
- empty `CAULDRON` ↔ powder snow levels work like water10
- No other plugins required11
- water, lava and powder snow never mix (incompatible destination → no transfer)12
11
13
Particle: `SNOWFLAKE` (water/lava still use `DRIPPING_WATER` / `DRIPPING_LAVA`).12
## Playing14
13
15
## Cauldron endpoint identity14
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 endpoints22
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`) |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
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.045
**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
## Configuration50
51
Defaults live in `config.yml` (copied to the plugin data folder on first run):52
53
- Transfer interval and max connection range54
- Visual pipe material, scale, and particles55
- Filter UI titles and player messages (Dutch + English)56
- Performance: idle sleep, wake probes, display refresh57
58
Connections are stored in `connections.tsv` under the plugin data folder.59
60
## Build61
62
```bash63
gradle clean jar64
```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 overview71
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.