minemap-water-surface-and-refraction

What problem does it solve?

MineMap water rendering involves multiple modes and object-level interactions that are easy to misconfigure, leading to inconsistent visuals and debugging churn when combining WaterMaterial, fill-water layers, and global rendering flags.

Core Features & Use Cases

• Unified patterns for water surface using WaterMaterial and fill-water layers to ensure consistent behavior across primitives, models, tiles, and styles.
• Global control via waterRenderingMode to balance visual quality and performance (normal vs simplified) during scene design.
• Per-object participation controls (allowWaterRefract / allowWaterReflect) to finely tune refraction and reflection across scene components and layers.
• Guidance for scene organization and validation to avoid common misconfigurations.

Quick Start

Create a MineMap map with waterRenderingMode enabled and add a water surface using WaterMaterial or a fill-water layer to start.