Underground Pipes - a mod for Captain of Industry
Version 0.8.1  |  Verified on game 0.8.5

WHAT IT DOES
- Route the game's normal fluid pipes below the terrain and connect them back to
  surface pipes. No new buildings or assets.
- Earned depth: the basic pipe can go 1 level down; upgraded pipe tiers (T2+,
  unlocked through research) earn a 2nd, deeper level. Deeper routing is a reward
  for progression, not a free cheat.
- While digging, the route preview is colour-coded by validity:
  green = OK, amber = at the depth limit, red = invalid (e.g. below sea level).
- Buried pipes are shown as a translucent, depth-colour-coded x-ray overlay
  (cyan for level 1, orange for level 2), visible across the whole network.
- The current depth level is shown at the cursor while you dig.
- Hover any pipe (buried or on the surface) to see what is flowing through it
  as a big product icon (+ count) at the cursor, without digging or opening it.
- Buried pipes are protected from being deleted together with surface structures.

HOW TO USE
- Pick a pipe in the build menu as usual.
- Press the "lower" (down) button to dig the pipe below the surface, "raise" (up)
  to bring it back up. The level number is shown at the cursor.
- Depth depends on the pipe's TIER:
      Tier 1 pipe  -> 1 level underground
      Tier 2+ pipe -> 2 levels underground
  (Pipe tiers are unlocked through research, so deeper burial is earned.)
- Eye toolbar button: show / hide the underground x-ray overlay (and the hover read-out).
- Hover any pipe to see its current contents as a product icon at the cursor.
- Trash toolbar button (in the delete tool): allow deleting buried pipes on purpose.
  While it is OFF, removing surface structures will NOT delete the buried pipes under them.

INSTALL
- Extract the "UndergroundPipes" folder into:
      %APPDATA%\Captain of Industry\Mods\
- 0Harmony.dll is included and required.

NOTES
- Burial depth is limited by the ground height: a pipe cannot go below the world
  floor (sea level), and the transport path-finder only reaches a limited vertical
  band, so the deeper levels need high enough terrain.

CHANGELOG
0.8.1
- Fix: building/connecting a buried pipe could throw "Set changed while enumerating"
  in the overlay and abort the toolbar input update, which could break the connection
  being made. The overlay now iterates a safe snapshot.
- Fix: hover read-out no longer spams an assert when the cursor is over off-map tiles.

0.8.0
- Tier-based depth: Tier 1 pipe digs 1 level down, Tier 2+ pipes dig 2 levels.
  Deeper burial is now earned through pipe-tier research instead of being free.
- Placement preview is colour-coded by validity (green / amber / red).
- Hover read-out: point at any pipe (buried or surface) to see what is flowing
  through it as a big product icon + count at the cursor.
- Toolbar buttons line up flush with the rest of the bar; stability fixes.

0.5.0
- Route vanilla fluid pipes underground with a depth-colour-coded x-ray overlay,
  a show/hide button, and protection from accidental deletion.

CREDITS
- Built with Harmony (0Harmony.dll, MIT license - see licenses/0Harmony-LICENSE.txt).
