================================================================================
                    REALISTICVISION SHADER PACK (v2.0)
      Cinematic Realism + BSL Feature Suite for Minecraft Java Edition
================================================================================

1. WHAT'S NEW IN V2.0 (BUG FIXES & BSL FEATURE ADDITIONS)
--------------------------------------------------------------------------------
[BUG FIXES]
- Fixed OptiFine shader option parsing warnings by formatting all macro values
  on the exact declaration line (#define NAME VAL // [vals]).
- Fixed modern Minecraft 1.19 block mappings by eliminating legacy 'flowing_water'
  from block.properties.
- Eliminated OpenGL depth buffer feedback loop in translucent water pass by switching
  from active depthtex0 to copied solid depthtex1.
- Enabled RGBA16F high-dynamic-range (HDR) color buffers to prevent harsh white clipping
  and highlight crushing.

[BSL FEATURE SUITE]
- Screen-Space Ambient Occlusion (SSAO): Adds deep, realistic contact shadows in
  corners, stairs, block crevices, and beneath vegetation.
- BSL Stylized Volumetric Clouds: Fluffy procedural 2D/3D clouds floating at altitude
  with sunward illumination, wind animation, and golden sunset rims.
- True Water Refraction: Dynamic wobbly optical distortion of submerged blocks through
  animated wave normals.
- Rain Puddles & Wet Surfaces: Ground surfaces (stone, dirt, grass, wood) become
  glossy and reflect direct sunlight/moonlight and skylight during and after rain.
- Cel-Shading Outlines (BSL Iconic Style): Optional stylized comic edge outlines
  around blocks and entities.
- BSL-Style Auto-Exposure / Eye Adaptation: Smooth exposure transitions when walking
  between pitch-black caves and bright midday sunlight.
- Synchronized Foliage Waves: Leaves, grass, flowers, and crops sway naturally in wind
  with matched shadows in the shadow pass.

2. TARGET SPECIFICATIONS & COMPATIBILITY
--------------------------------------------------------------------------------
- Target Minecraft Version: Minecraft Java Edition 1.19.x (verified for 1.19)
- Target Shader Loader:      OptiFine HD U H9 (and newer 1.19 builds)
- Hardware Target:          NVIDIA Quadro K2200 (4 GB VRAM, Maxwell GM107)
                            Compatible with all modern NVIDIA, AMD, and Intel GPUs.
- OpenGL Profile:           OpenGL 3.2+ Core / GLSL 1.20 Compatibility

3. RECOMMENDED SETTINGS FOR NVIDIA QUADRO K2200 (4 GB VRAM)
--------------------------------------------------------------------------------
For a smooth 45-60 FPS gameplay experience at 1080p / 720p:

- Shader Preset:        BALANCED (Default)
- Shadow Quality:       Balanced PCF (4-Tap)
- Shadow Resolution:    1024
- Shadow Distance:      112 blocks
- Ambient Occlusion:    ON (SSAO enabled)
- BSL Clouds:           ON
- Water Refraction:     ON
- Rain Puddles:         ON
- Eye Adaptation:       ON
- Waving Foliage:       ON
- Volumetric Sun Rays:  ON
- Bloom:                ON
- Tone Mapper:          Filmic S-Curve (1)

4. HOW TO RELOAD / TEST IN MINECRAFT
--------------------------------------------------------------------------------
Because the ZIP was updated directly in your '.minecraft\shaderpacks\' folder:

1. Switch back to your Minecraft window.
2. In Minecraft, press F3 + R (or go to Options -> Video Settings -> Shaders and
   re-select 'RealisticVision_OptiFine_1_19').
3. OptiFine will instantly recompile the shader pack with all new BSL features
   and zero errors!
================================================================================
