beautiful-3d-world

Assign one Layer 0 hex tile per axial grid cell using pointy-top axial-to-world conversion with HEX_W 1.82 and HEX_H 1.575 spacing, all at y=0. Then add Layer 1 environment props and Layer 2 occupants validated against each cell's tileType via the validOn property in registry.json.

Chain river tile variants (hex_river_A through L) so adjacent tiles have matching edge-flow bitmasks, with exactly one source and one termination. Then build a single merged water surface mesh of hexagonal caps at y=-0.002 spanning all river tiles to hide baked-texture seams.

Only water-dependent buildings such as watermills, docks, or fisheries may occupy a river tile, and the tile remains tileType river so flow continuity is preserved. Pure water tiles (hex_water) allow no occupants, no environment props, and no crossings at all.

Each KayKit river GLTF has a self-contained baked water texture that stops at tile boundaries. Override them with one merged BufferGeometry of hexagonal caps sharing edge vertices, rendered as a single semi-transparent mesh above the tile surfaces.

Clouds are Layer 1 props valid only on grass tiles, floating 1.5 to 4.0 units above ground with uniform scale 0.3 to 0.6. They must not cast or receive shadows, cannot coexist with a Layer 2 occupant, and should cluster following the 70/30 density rule.

The system forbids elevation changes: no sloped tiles, no bottom tiles, and no coast transition tiles, so all terrain sits at y=0. Larger water bodies must be built as platform-level geometry beneath the hex grid rather than as individual coast tiles.