minemap-water-surface-and-refraction

Configure MineMap water surfaces with refraction and reflection controls.

3|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/ming1zhou88/minemap-skills --skill minemap-water-surface-and-refraction
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: minemap-water-surface-and-refraction
Source: https://github.com/ming1zhou88/minemap-skills/tree/main/skills/minemap-water-surface-and-refraction
Command: npx skills add https://github.com/ming1zhou88/minemap-skills --skill minemap-water-surface-and-refraction

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about minemap-water-surface-and-refraction

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure realistic water surfaces with refraction in MineMap?

Realistic water surfaces in MineMap require configuring WaterMaterial or fill-water layers alongside the global waterRenderingMode flag and per-object allowWaterRefract and allowWaterReflect settings to control refraction and reflection behavior.

Why does my MineMap water rendering look inconsistent across 3D models and 2D layers?

Inconsistent MineMap water rendering usually stems from misconfigured object-level interactions and global flags. You must validate map-level waterRenderingMode settings and per-object allowWaterRefract or allowWaterReflect flags to ensure unified behavior across 3D primitives, models, and 2D fill-water layers.

Can I use fill-water layers and WaterMaterial together in the same MineMap scene?

Yes, fill-water layers and WaterMaterial can be used together in MineMap scenes. Applying unified patterns and validating map-level waterRenderingMode ensures consistent refraction and reflection behavior across both primitive water and fill-layer workflows.

How do I balance performance and visual quality when rendering water in MineMap?

You balance performance and visual quality in MineMap by setting the global waterRenderingMode to normal or simplified. This flag controls rendering overhead across scene components, allowing you to prioritize visual fidelity or performance during scene design.

How do I control which specific objects participate in water reflection and refraction?

You control water reflection and refraction per object using the allowWaterRefract and allowWaterReflect flags. Setting these per-object properties allows you to finely tune which scene components, models, and layers participate in the water rendering effects.

What should I check when MineMap water refraction is not working?

When water refraction fails in MineMap, validate that the global waterRenderingMode is enabled and that the specific object or layer has the allowWaterRefract flag correctly defined. Checking scene organization for common misconfigurations resolves most rendering issues.