csharpfritz/aspire-minecraft/water-connections

Context

Connecting separate water bodies in Minecraft requires careful multi-depth construction. A simple one-block opening creates a visible wall or step. Natural-looking water flow requires opening multiple blocks and filling water at all relevant depth levels.

Patterns

1. Multi-depth junction openings

When connecting a canal to a lake (or two water bodies at different depths), open at least 2 Z-blocks deep and fill water at both depth levels.

// Open the wall between canal and lake (2 blocks deep into lake)
await rcon.SendCommandAsync(
    $"fill {minX} {surfaceY-2} {lakeZ} {maxX} {surfaceY} {lakeZ+1} minecraft:air");
 
// Fill water at canal depth (shallow)
await rcon.SendCommandAsync(
    $"fill {minX} {surfaceY-1} {lakeZ} {maxX} {surfaceY-1} {lakeZ+1} minecraft:water");
 
// Fill water at lake depth (deep)
await rcon.SendCommandAsync(
    $"fill {minX} {surfaceY-2} {lakeZ} {maxX} {surfaceY-2} {lakeZ+1} minecraft:water");

2. Extend trunk canals into receiving bodies

Don't stop the trunk canal at the lake edge — extend it 2+ blocks into the lake interior for a clean visual connection.

// Trunk canal runs past lake boundary
int trunkEndZ = lakeZ + 2;  // 2 blocks into lake
await rcon.SendCommandAsync(
    $"fill {trunkX-1} {surfaceY-2} {trunkStartZ} {trunkX+1} {surfaceY} {trunkEndZ} minecraft:air");

3. Branch canal to trunk canal connections

Where a branch canal (E-W) meets the trunk canal (N-S), remove the wall between them and ensure water flows at the correct depth.

// Clear the wall between branch and trunk
await rcon.SendCommandAsync(
    $"fill {junctionX} {surfaceY-2} {branchZ-1} {junctionX} {surfaceY} {branchZ+1} minecraft:air");
// Fill water
await rcon.SendCommandAsync(
    $"fill {junctionX} {surfaceY-1} {branchZ-1} {junctionX} {surfaceY-1} {branchZ+1} minecraft:water");

4. Water depth conventions

Anti-Patterns

• Single-block openings — creates a visible wall between water bodies
• Mismatched water depths — canal at Y-1, lake at Y-2, with no water between them at the junction
• Stopping canals at the lake edge — creates an abrupt boundary instead of flowing water
• Forgetting to clear air above water — leftover blocks from terrain create dams