EDDYVEIL 5.2.0 WILDLIGHT
Private cinematic fantasy shader pack for Iris + Sodium

EDITION
macOS / Apple Silicon edition

TARGET
- Minecraft Java Edition 26.1.2
- Iris 1.11.2+ and Sodium 0.9.1+
- 12-16 chunk render distance recommended
- Fancy graphics recommended for complete transparent leaf geometry

INSTALL
1. Keep Eddyveil-5.2.0-macOS.zip zipped.
2. Put it in ~/Library/Application Support/minecraft/shaderpacks
3. Select Eddyveil 5.2.0 Wildlight in Iris.

Ultra High uses a 4096 shadow map and 26 god-ray samples to stay within Apple Silicon driver limits.

DEFAULTS
- Quality profile: Low
- Brightness: Bright, now lowered for a moodier fantasy image
- Leaves: transparent Stable mode with atlas-safe distant coverage repair
- Shadow Strength: Dramatic
- Fantasy Fog: Fantasy
- Cloud Coverage: Cloudy
- Cloud Visibility: Visible
- God Rays: Cinematic
- Reflections: Glassy
- Wind: Fantasy Gusts
- Contact Shadows: Balanced
- Colored Light Bounce: Low
- Leaf Translucency: Balanced
- Weather Variation: Dynamic
- Water Foam: Subtle
- Fantasy Color Grade: Fantasy

QUALITY PROFILES
- Potato: 512 shadows, light fog/clouds, minimum samples, stable fast leaves
- Low: 1536 shadows plus the full new fantasy look at the previous performance class
- Medium: 2048 shadows, richer layered fog, smoother rays, water, clouds, and foliage
- High: 3072 shadows, dense filtering, bold clouds, atmosphere, reflections, and bloom
- Ultra High: platform-specific maximum shadow maps, samples, fog layers, and detail

BRIGHTNESS
- Dim: darker, closer to Minecraft's original lighting
- Bright: the lowered cinematic default
- BLINDING: intentionally extreme

ADVANCED SETTINGS
Every displayed control changes render code. Shadows, god rays, reflections,
atmosphere, fog, clouds, weather, bloom, contact shadows, colored light,
wetness, water foam, foliage, post processing, color, lens effects, and End
detail all have independent working controls.

5.2.0 WILDLIGHT
- Replaced atlas-neighbor leaf taps with exact-coordinate LOD reconstruction
- Added distance-stable alpha coverage without filling real transparent holes
- Added leaf translucency, variable-penumbra shadows, and contact shadows
- Added depth-aware colored light bounce and wet-surface controls
- Added a fourth cloud layer, evolving weather, stronger night clouds, and
  shorter fantasy visibility
- Added post quality, edge smoothing, sharpening, fantasy color grading, and
  controllable lens effects
- Added customizable procedural wave foam
- Expanded all five quality profiles so the new effects scale with them
- Kept the dedicated Mac and Windows quality ceilings

5.1.0 FEEDBACK V2
- Rebuilt transparent leaves around derivative-aware mipmap coverage repair
- Kept real leaf holes instead of turning foliage into opaque cubes
- Forced leaves onto the mipmapped cutout path
- Added slow canopy motion plus close-range flutter that calms at distance
- Animated leaf shadows with the exact same wind math
- Added much thicker customizable fantasy fog and layered valley mist
- Made procedural clouds noticeably denser and clearer during day and night
- Strengthened cloud shadows, mapped shadows, sun/moon god rays, rain sheen,
  water reflections, cloud reflections, celestial sparkle, and bloom
- Lowered Bright exposure while preserving separate Dim and BLINDING modes
- Rewired every displayed control to real compile-time shader behavior
- Preserved the 5.0.1 End Portal, End Gateway, exit portal, and dragon-light fixes

LEAF NOTE
Use Fancy graphics for the complete see-through leaf model. Fast graphics makes
Minecraft remove interior leaf faces before the shader receives them; no shader
can recreate geometry the game never sends. Eddyveil keeps all atlas taps on the
leaf's own coordinate and repairs distant coverage on every quality profile.

DEBUGGING
In the Iris shader screen, enable debugging and send the first compiler error
if a specific Iris build reports one.
