IMPORTANT: Do not use items directly from the blueprint library

Due to problems with the new blueprint library introduced in v0.18.37, using blueprints, deconstruction planners, and upgrade planners directly from the blueprint library, including using toolbar shortcuts that point to items in the blueprint library, leads to a number of confusing bugs. Instead, copy items from the blueprint library to your character inventory, and use them from there, or create toolbar shortcuts that point to items in your character inventory.

Description

From the maker of Beltlayer, we bring you Pipelayer. Turn corners with your pipes and run them long distances, paying only as many pipes as you actually need.

How to use

1. This mod introduces a new item, the Underground pipe connector, which unlocks with Fluid handling.

   

2. Place down one next to each of your fluid producers, and another next to each of your fluid consumers.

3. Press CONTROL-P to enter the editor view. (All keybinds are configurable.) You will find in your inventory all the regular pipe and pipe-to-ground items from your character inventory. You will also see the underground ends of your connectors. They can be freely rotated, and if you have already connected them to fluids aboveground, they shown what fluid they hold in the editor as well.

   

4. Place pipes between the connectors. You can place and use regular pipe-to-ground to cross pipelines in the editor as usual. As you place pipes, you will see them fill.

   

   If you connect pipes with different fluids, all the pipes will empty to show that a conflict exists, and will not fill again until you fix the problem.

   

5. Return to the overworld by pressing CONTROL-P again.

   

6. Set the mode for each connector by pressing SHIFT-P.

   

   This is usually not necessary if you place the connectors directly next to buildings. When placed, connectors will attempt to determine whether they should act in input mode or output mode by looking at the connected building. This works for vanilla boilers/heat exchangers, steam engines/turbines, assemblers, oil refineries, pumps, etc. It does not work for buildings that can act as inputs or outputs, such as pipes, standard pipe-to-ground endpoints, storage tanks, etc.

   It does not currently work for modded buildings. This should be possible automatically in 0.17. I may also add support for popular mods on request, or add a remote API for mod authors to add support if there is interest in doing this.

7. You should soon see fluid move from the input connectors to the output connectors.

How it works

A set of connected underground pipes and connectors in the editor view is called a network.
Every network can handle one kind of fluid. If a network includes two or more connectors with different kinds of fluids in them, the network is in conflict, and won't move any fluids.

The pipes in the editor view are not active entities, move no fluid, and consume no UPS. They only show the fluid handled by each network for convenience. Instead, fluids are periodically moved directly from input connectors to output connectors on the same network by script.

Once every tick, each network searches its input connectors for one that has at least 2,500* fluid in it, and searches its output connectors for one that has room for at least 2,500* fluid. If it finds one of each, it will transfer as much fluid as it can from the input to the output. Each network will perform only one transfer each tick. If a network can't find an input connector and an ouput connector, it will go to sleep for 1* second to conserve UPS before checking again.

* Each of these parameters is adjustable via Mod settings.

Caveats

Input connectors that have less than the Transfer threshold will not send fluid. Similarly, output connectors that don't have enough room to meet the Transfer threshold will not receive fluid. This is particularly noticable with storage tanks.

For example, if Connector capacity is 10k and Transfer threshold is 2.5k (the defaults), a storage tank connected to an output connector will not fill beyond 75%, because the connector will equalize with the storage tank and thus never go below 7.5k. This is usually not a concern, but if it is important that a particular tank be entirely filled, use a pump between the output connector and the storage tank.

Performance Tuning

If you have a large network transferring a lot of fluid, you may need to adjust the settings to get maximum throughput while reducing UPS consumption. First consider increasing Connector capacity, which will increase the amount of buffered fluid in each network. You can then increase the Transfer threshold, which will reduce how often fluid is transferred, and allow the networks to go to sleep more often. Increasing Connector capacity will also let you increase the Update period, which lets each network go to sleep for longer.