Turns water into a finite resource in Factorio 2.0+

Version 2.1.0 targets Factorio 2.1. Use version 2.0.4 for Factorio 2.0.

Offshore pumps now deplete the waterbodies they draw from. Waterbodies visually shrink as they're consumed, and water slowly regenerates over time. Research technologies to reduce water consumption, use waterfill to extend water sources, and manage your water supply strategically.

⚠️ Beta Release Notice

This mod is currently in beta. You may encounter debug messages, unexpected behavior, or errors during gameplay.

Contributions welcome! Help improve this mod by:
- Reporting bugs or error messages on the Mod Portal discussion page
- Opening issues on GitHub
- Submitting pull requests with bug fixes, code improvements, or new features
- Suggesting design changes, functionality additions/removals, or graphics/content enhancements

Core Mechanics

Finite Water System

• Waterbody Tracking: Connected water tiles form "waterbodies" with unique IDs, scanned asynchronously when pumps are placed
• Per-Pump Usage: Each pump depletes its lake according to the water it actually extracts.
• Water Tile Capacity: Startup settings default to 200 for normal water and
  2,000 for deep water. Extra-shallow and muddy water hold 50% and 25% of normal water capacity, respectively.

The assumed depths treat each tile as 1 m² and each fluid unit as one litre,
for this mod's capacity calculations.

Visual Depletion

• Water tiles "dry out" as the waterbody depletes (starting at 80% depletion, configurable)
• Depletion spreads from the edges toward the waterbody's center (centroid)
• Custom tile types are used for depleted areas to avoid conflicts with other mods.

Landfill and Depleted Beds

• Ordinary landfill can cover wet water tiles and depleted beds. Covered positions
  are removed from the lake's capacity and connectivity; a strip of landfill can split a lake.
• Landfill remains removable. Mining it exposes an empty bed, adding capacity
  but no water. Water lost when landfill was placed is not refunded by removing it.
• Mining landfill can merge lakes. Existing water is shared across the
  combined area, so some empty beds may become wet again without creating water.
• Keep landfill beneath buildings you want protected from reflooding. Unfilled
  beds, including beds exposed by mining landfill, can regenerate and flood again.
• Built-in waterfill cannot be placed directly on a depleted bed.

Regeneration

• Waterbodies slowly regenerate water over time
• Non-linear scaling for strategic resource management:
• Best regeneration at 75% depleted (150% of base rate)
• Reduced regeneration at 0% depleted (75% rate) and 100% depleted (50% rate)
• Configurable base regeneration rate
• The Regeneration enabled by size setting accepts seven 0/1 digits in this order:
  Puddle, Well, Pond, Lake, Great Lake, Sea, Ocean. Default 1111111 enables all;
  0000001 enables oceans only and 0000011 enables seas and oceans.
  Invalid strings fall back to 1111111 with a warning. While scanning, the
  currently calculated size applies; it may change as more tiles are discovered.

Pump Behavior

• Manage only Nauvis is a startup setting enabled by default. Disable it to manage supported
  water sources on other surfaces. Non-water fluids remain unmanaged.
• Enabling this restriction stops management of previously tracked off-Nauvis waterbodies and
  releases their pumps. Previously dried terrain remains unchanged.
• Pumps remain non-movable with Picker/Even Pickier Dollies. The blacklist uses
  prototype names, so it can also restrict that pump type on ignored surfaces.
• Burner and electric offshore pumps drawing from supported water tiles are supported,
  including those from Enhanced Offshore Pumps (offshore-burner).
• Non-water sources and custom water tiles without a drying/restoration mapping are left unmanaged.
• Ordinary pipeline pumps are not treated as waterbody extractors.
• Pumps automatically deactivate when their waterbody reaches 100% depletion
• Pumps reactivate when water returns above threshold (default: 99% depletion)
• Yield research reduces how much lake water each pump consumes.

Technology Tree

Yield Boost Research

Reduce water consumption through research. Each completed level reduces water
removed from lakes by 15% (multiplicative), while pumps output the same fluid.
Yield research - Maximum level is a startup setting, default 6, range 1–100.
Levels above the configured limit are unavailable. Enable infinite yield research
defaults off; enabling it allows genuine repeated improvements beyond level 6 and
ignores the finite maximum. The existing science requirements and costs are retained.

Changing either research setting updates your bonuses when the save loads with
the new settings. Lowering the cap
limits the applied bonus too; it does not refund science. Removed tiers may lose
their saved progress. Research already completed beyond level 6
starts applying its actual bonus if infinite research is enabled.

Waterfill Technology

• Prerequisites: Landfill, Explosives
• Recipe at default settings: 1 Explosives + 1,200 Water = 3 Waterfill
• Places extra-shallow water adjacent to existing water tiles (100 water per tile at default capacities)
• Cannot be placed on dried (depleted) tiles

Waterfill - Relocation efficiency (%) is a startup setting, default 25%,
with a range of 1–100%. The recipe's water cost is rounded up from the total
capacity its three resulting tiles add, divided by the efficiency. At default
capacities, three waterfill add 300 lake water, including when extending a partly
depleted lake: ceil(300 / 0.25) = 1,200 water consumed. Recipe productivity is
disabled. Custom capacity settings automatically change the recipe cost.

Balance warning: default settings—25% waterfill efficiency and a level-6 research cap—prevent infinite water generation through pumping and waterfill. At level 6, efficiency of 38% or higher can generate water. At level 9 or higher, even the default 25% can generate water.

Enable Waterfill is a startup setting in this mod's settings, enabled by default.
Disabling it removes the built-in waterfill technology, recipe, item and placer.
Existing waterfill items can be removed without conversion or refund.

CanalBuilderMAV is incompatible. Its terrain changes bypass finite-water
accounting. Disabling built-in waterfill does not make the combination compatible.

Waterbody Dynamics

Merging

When waterfill connects two separate waterbodies, they automatically merge into a single tracked body. Water amounts and statistics are combined.

Splitting

When landfill divides a waterbody, the mod detects this and creates separate tracked bodies for each disconnected region. Water is distributed proportionally.

Map & Notifications

Map Markers

• Display waterbody name, remaining water, and percentage remaining
• Shown per force at pump locations
• Can be disabled in settings

Depletion Alarms

Configurable notifications at various depletion levels:
- Low level alarms: 50%, 75%, 90%
- High level alarms: 95%, 97%, 98%, 99%

Performance Features

• Update Budget System: Configurable operations per second (default: 2000) helps limit lag spikes.
• Async Scanning: Initial waterbody scans spread over time (configurable tiles/second).
• Lazy Data Migration: Large data operations spread across multiple game ticks.

The update budget and scanning speed settings control how much work the mod does
over time. Lower values reduce the work per update but make lake scans and terrain
changes take longer to finish.

Multi-Surface & Multi-Force Support

• Waterbodies are tracked separately per surface
• Each force maintains separate technology progress and water usage multipliers
• Map markers are shown per force

Credits & Copyright

This mod was inspired by "Water As A Resource" by TreefrogGreaken under MIT License, found on the Factorio Mod Portal: https://mods.factorio.com/mod/WaterAsAResource

Water As A Resource noted that:
"This mod was inspired by finitewater by Luke Perkin, found on the Forums: https://forums.factorio.com/viewtopic.php?f=94&t=14506"
which also was published under MIT License.

From "Water As A Resource": updated, refactored, and extended for Factorio >= 2.0 versions by PiotrKaszuba.
Some of the original graphics are still used under the MIT License.

Waterfill icon is borrowed from Waterfill by untraceablesmurf under MIT License, found on Factorio Mod Portal: https://mods.factorio.com/mod/Waterfill_v17 or Github: https://github.com/un-smurf/waterfill.