Waterfall: SomeLiquidSourceTransport

Do you think Vintage Story is too easy? Do you want to feel like an ancient Sumerian digging irrigation channels for his crops or a Roman creating aqueducts to route water from a lake at higher elevations?

Waterfall enforces that handheld liquid containers such as buckets can only place liquid source blocks inside flowing liquids of their own kind.

This simple change was designed to function as a middle-ground between vanilla's NoLiquidSourceTransport toggles.

The mod enforces rules explicitly implied via block attributes or WaterfallConfig.json: 

• Modders can add default source block placement rules with waterfallPass: [ "domain:code1", "domain:code2", etc... ] attribute to enforce which liquid blocks liquid blocks can be placed inside.
• Users can add custom block placement rules with the mod config. This includes allowing liquids to be placed inside "game:air" to ignore any placement rule defaults.
• Config overrides any passes from attributes or defaults.

 

Mod Compatibilities:

- Realistic Water

 

Known issues:

• If the world has NoLiquidSourceTransport set to True the mod doesn't work. You can set this at world creation or afterwards with: /worldconfig noLiquidSourceTransport False
• Waterfall's compatibility patches might fail if WaterfallConfig.json has been edited between versions. You can delete WaterfallConfig.json to make the mod fix itself the next time a world is loaded.
• Buckets are somewhat inconsistent when placing liquids because Vintage Story prioritizes liquids closest to the viewport to fill them. Because this is an issue with Vintage Story itself rather than the mod, and because this technically speaking doesn't fall into what this mod intends to change, I choose to let the developers fix this. The mod itself is functional.

Default WaterfallConfig.json syntax example:

<pre class="language-markup">{ "version": "1.2.3", "pass": { "game:water": [ "game:water", "game:rapidwater", "game:realisticwater" ], "game:saltwater": [ "game:saltwater" ] } }</pre>