Underground Pipes - a mod for Captain of Industry
Version 0.9.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 to see, at the cursor: the product flowing through it (big icon),
  how full it is (fill bar), and whether it's flowing or stuck; the whole buried
  run lights up while you hover.
- Optional "colour by product" mode for the x-ray overlay (mod settings).
- Configurable in the in-game mod settings: maximum burial depth, colour-by-product.
- 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.9.1
- Cheat++ compatibility: buried pipes stay protected from bulldozing by default, and this
  mod's "delete buried pipes" button now also flips Cheat++'s matching toggle - so one button
  frees both mods at once instead of the old "you must enable it in both" conflict. When
  Cheat++'s own burying is active, this mod yields the depth stepping to it to avoid a double
  step. The x-ray overlay and hover read-out keep working on top of whichever mod buried the pipes.

0.9.0
- The "delete buried pipes" toggle now always starts OFF when you load a game, so a
  toggle left on in a previous session can't accidentally bulldoze buried pipes.
- Hover read-out v2: the cursor panel now also shows a fill bar and a flowing/stuck
  indicator, and hovering lights up the whole buried run in the x-ray overlay.
- Configurable settings (config.json / in-game mod settings): maximum burial depth
  (1-8) and an optional "colour by product" overlay mode.
- Colour-by-product: option to tint the x-ray by the product in each pipe instead
  of by depth, so you can tell networks apart at a glance.

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).
