VIVID REALISM SHADERS — v1.0
Minecraft: Java Edition
==========================================================

WHAT THIS IS
------------
A GLSL shader pack for the OptiFine / Iris shader pipeline. It's not a
resource/texture pack — it changes how Minecraft's world is lit and
rendered. Features included:

  - Real-time directional shadow mapping (sun/moon) with soft PCF shadows
  - Dynamic sun/moon lighting with colored ambient + torchlight
  - Wind-animated grass, crops and leaves
  - Animated, reflective water with wave displacement
  - Screen-space ambient occlusion (SSAO) in corners/crevices
  - Height/distance-based volumetric fog, with a separate underwater fog
  - Bloom glow + crepuscular "god rays" toward the sun
  - Enhanced procedural sky gradient with sun glow
  - Cheap subsurface-scattering-style backlighting on foliage
  - Filmic (ACES) tone mapping, saturation control, and vignette

Every effect above can be tweaked or disabled from the in-game shader
options screen once the pack is loaded (Video Settings > Shaders >
Shader Options).

A NOTE ON "REALISTIC"
----------------------
This uses the same rasterized shading techniques (shadow maps, SSAO,
bloom, screen-space effects) that popular shader packs like BSL,
Complementary or Sildur's use to get a much more realistic look than
vanilla. It is NOT path-traced ray tracing (like SEUS PTGI or Continuum
RT) — true path tracing needs a much heavier, specialized pipeline.
This pack aims for the best realism achievable in a standard
rasterized shader, which is what "shaders" means for Minecraft Java
in practice.

REQUIREMENTS
------------
You need a shader-loading mod — vanilla Java Edition cannot load
shader packs on its own. Use ONE of:

  - Iris (recommended, best performance, works with Sodium): https://irisshaders.dev
  - OptiFine: https://optifine.net

INSTALLATION
------------
1. Install Iris or OptiFine for your Minecraft version.
2. Launch Minecraft once with that mod so the "shaderpacks" folder
   is created (Options > Video Settings > Shaders > Open Shader
   Folder, or find it directly at:
     .minecraft/shaderpacks/
3. Drop this ZIP file (VividRealismShaders.zip) into that
   shaderpacks folder — do NOT unzip it, OptiFine/Iris read the zip
   directly.
4. In-game: Options > Video Settings > Shaders > select
   "VividRealismShaders" from the list > Done.
5. Open "Shader Options" from that same screen to adjust shadow
   softness, wind speed, SSAO/bloom/fog strength, exposure, etc.

PERFORMANCE TIPS
-----------------
  - Lower shadowMapResolution or SHADOW_SOFTNESS if you get low FPS.
  - Turn off SSAO or BLOOM for a solid performance boost on weaker GPUs.
  - Reduce shadowDistance for better performance in large builds/cities.

FILE STRUCTURE
---------------
shaders/
  shaders.properties      - buffer formats, shadow settings, options menu
  block.properties         - assigns block IDs used for wind animation
  lib/noise.glsl            - shared noise functions
  lib/tonemap.glsl          - shared tone-mapping functions
  gbuffers_*.vsh/.fsh       - per-geometry-type rendering (terrain, water,
                              entities, sky, particles, etc.)
  shadow.vsh/.fsh           - shadow map generation
  composite.vsh/.fsh        - main deferred lighting, shadows, fog, sky
  composite1.vsh/.fsh       - bloom + god rays
  final.vsh/.fsh            - tone mapping, color grading, output

Enjoy!
