SlurryPipeSystem v1.0.2.0

Covers all changes since version V1.0.1.9. Existing save games can continue to be used without any changes.
The full list can be found in the file RELEASE_NOTES_V1.0.2.0.md included with the mod.

New additions:
Pressure and vacuum: Vacuum tanks maintain their vacuum, which dictates the flow of liquid. This includes suction via high-capacity pump lines, backpressure during application, and drawing slurry from a pit using an open hose or pipe end.
Pressure gauges: Added to the Supercis 800 and Kaweco Profi 2 models.
Chemical mixing and cleaning: Concentrates are mixed with water within the sprayer; the concentration is maintained throughout the entire system (tanks, lines) all the way to application in the field. Also includes a multi-stage cleaning process for contaminated sprayers, as well as a placeable cleaning station.
New SPS-compatible vehicles: MKS 8 Dual Tank, 550 Water/Chem Bowser, Supercis 800, Kotte FRC 65, and Amazone UX5201 Super.
Water and suction strainers: When a hose or pipe end is submerged in a lake, river, pond, or watercourse, water can only be drawn in through an appropriate strainer (small strainers for water/milk, large ones for slurry). These strainers can be carried on the vehicle using a dedicated mount.
Leaks and spills from lines: Open hose or pipe ends left on the ground may leak, creating puddles.
Unified standards for reach and coupling radius across all connection points.
Settings menu: All SPS options are now consolidated in one central location. New guide: SPS_README_08_New_in_1.0.2.0.md.

Fixed issues
The spray jet on the washout device (washout boom) is now displayed correctly even when using "Soil & Fertilizer" chemicals.
"Soil & Fertilizer" IBC containers can once again be connected to water pipes and spray hoses.
It is now possible again to pick up a suction strainer or a stowed hose at the connection point of the MKS 8.
Couplings at tank openings can now also be used in "physical pipe mode."
The handle at the cleaning station now correctly follows the valve, even when no hose is connected.

**A realistic slurry pipe system for Farming Simulator 25.**

The **FS25 Slurry Pipe System (SPS)** replaces the game’s simplified vanilla mechanics—simply driving up to a trigger and filling up—with a fully interactive pipe system.

Physically connect filling arms or pipes, operate a PTO-driven pump, build up pressure, control the flow direction, and watch slurry being transported through a connected pipe network.

The slurry itself also behaves realistically: it becomes thicker over time, forms a crust if it is not stirred regularly, and can clog pipes or distributors if neglected.

---

## Features

### Pipes & Slurry Transfer

- Swivelling filling arms that can be extended from the slurry tanker using a joystick and inserted into open slurry pits, rubber sleeves, or other vehicles.
- Multi-segment pipe chains that can be laid between two couplings while on foot and automatically lock once both ends are correctly connected.
- Direct Bézier pipes for quick connections between two nearby couplings—ideal for pumping between vehicles and buildings.
- An inline pumping station (PTO-driven slurry pump) that connects two pipe chains and acts as a passive pumping station.
- Animated couplings and valves—clamping levers close automatically when connected, and valves visibly open and close.
- Individually colourable pipes. The selected colour of each pipe segment is stored in the savegame.
- Support for multiple fill types. Both **slurry** and **digestate** are automatically detected and transferred.

---

### Pumps & Pressure System

- Various pump types:
  - Vacuum pumps with stored positive and negative pressure, including a pressure gauge.
  - High-performance positive-displacement pumps (HVP).
  - Inline pumping stations.
  - Open containers such as storage tanks or nurse tanks.
- Realistic pressure simulation:
  - Vacuum tankers build up pressure, store it, and gradually lose it over time.
  - The available pressure determines pumping performance and application rate—rather than a simple on/off system.
- Optional PTO shear bolt:
  - Wears under load.
  - Can break when overloaded.
  - Must be repaired manually at the vehicle.

---

### Slurry Behaves Like Real Slurry

- Dry matter content affects slurry viscosity.
- The higher the solids content, the thicker the slurry becomes.
- Unstirred slurry stores develop a floating crust over the seasons.
- Crusted or lumpy slurry can clog pumps, macerators, or application distributors.
- Regular stirring eliminates the risk of blockages.
- Adding water dilutes thick slurry.
- Universal agitator system:
  - Works with any registered vehicle, regardless of a specific vehicle specialisation.
- Water can be drawn directly from lakes or ponds, provided the map includes SPS-enabled water surfaces.

---

## Application Equipment

### Trailing Hoses & Band Spreaders

- Blockages are simulated individually for each outlet.
- Realistic distributor macerator.
- Dedicated HUD for application equipment and blockages.

### Crop Sprayers

- Liquid fertiliser and herbicide can be loaded through the same coupling and pipe system.
- Operation is handled through a central pump control.
- Pressure simulation is deliberately omitted for crop sprayers—they use a constant flow rate.

---

## Support for Custom Mods

The recommended and fully multiplayer-compatible method is to integrate SPS directly into your own mod.

**Important:**  
Slurry Pipe System files must **not** be modified or extended. Adding custom files inside the SPS mod causes multiplayer incompatibilities.

### Embedded Integration (Recommended)

A single XML block is all you need.

| Content | XML Block | Location |
| --- | --- | --- |
| Slurry tankers, trailing hose applicators, nurse tanks, pump trailers | `<slurryPipeSystem>` | Inside `<vehicle>` |
| Crop sprayers | `<sprayerPipeSystem>` | Inside `<vehicle>` |
| Slurry pits, containers, lagoons | `<slurryPipeSystem>` | Inside `<placeable>` |
| Liquid fertiliser tanks | `<sprayerPipeSystem>` | Inside `<placeable>` |
| Water surfaces on maps | `SPS_waterNodes` | Inside `Map.i3d` |

Players with SPS installed automatically receive the integration. Without SPS, the mod continues to work normally.

---

## File Structure

The documentation is clearly organised and includes guides for:

- Integrating slurry tankers and trailing hose applicators
- Integrating crop sprayers
- Integrating slurry storage facilities and tanks
- Setting up water sources on maps
- A complete XML reference covering all supported attributes

---

## Key Concepts

### Embedded Configurations Take Priority

XML blocks inside a vehicle or placeable are always detected first.  
The system only falls back to the internal manifest file if no embedded SPS configuration is present.

This allows repaints or modified versions of the same vehicle to include their own SPS configuration without affecting other mods.

---

### Shared Animation Library

Coupling and valve animations come from a central library. IDs automatically assign the appropriate animations to the corresponding models.

---

### Multiple Fill Types

Pipes automatically transfer the fill type actually present.

For example, a tank containing **digestate** can be connected directly to a digestate storage facility—just as easily as with slurry.

---

## Compatibility

The Slurry Pipe System supports, among others:

- **Manual Attach**
  - Full compatibility through a dedicated API for connection hoses.
- **Real Autosave**
  - All SPS data is correctly stored in automatic savegames.
- **Multiplayer**
  - Server-side synchronisation of all pipe connections, valves, pumps, pressure values, and shear bolts.