# CinematicVanilla V4

A cinematic-styled shader pack for Minecraft Java Edition, built on the
Iris/OptiFine shader API. Designed to keep a recognizably "vanilla" look
while adding atmosphere, soft lighting, volumetric clouds/fog, screen-space
reflections, and (as of V4) a working, animated night sky.

See `CHANGELOG.md` for what changed in V4, including a few pipeline bugs
that were fixed.

## Features
- Rayleigh/Mie-style atmospheric sky with cinematic horizon glow
- Twinkling, layered stars, optional Milky Way band, procedural shooting
  stars
- Volumetric double-layered clouds with parallax and rain-aware fading
- Screen-space reflections + ray-traced volumetric clouds/light shafts
- PBR material support (labPBR-compatible)
- Distant Horizons and Physics Mod (ocean) compatibility
- TAA/FXAA anti-aliasing, bloom, DOF, motion blur, lens flare, vignette,
  chromatic aberration
- Dynamic cinematic fog (distance + height based, biome/weather aware)
- Wet-surface rain response with puddle ripples
- Seasonal color-grade presets + a screenshot-oriented "Poster Mode"
- Six quality presets: `VERY_LOW`, `LOW`, `MEDIUM`, `HIGH`, `ULTRA`,
  `POSTER`

## Installation
1. Install [Iris](https://irisshaders.dev/) (or OptiFine) for your
   Minecraft version.
2. Copy the `CinematicVanillaV3` (package folder — rename to
   `CinematicVanillaV4` if you'd like the label to match, this doesn't
   affect function) folder into `.minecraft/shaderpacks/`.
3. In-game: **Options → Video Settings → Shaderpacks**, select the pack.
4. Open the shader's own settings screen to pick a quality preset
   (`VERY_LOW` through `ULTRA`, or `POSTER` for screenshots) and adjust
   individual toggles under Post Processing / Lighting / Atmospherics /
   Clouds / Water / Wind sections.

## Quality presets
| Preset    | Use case                                   |
|-----------|---------------------------------------------|
| VERY_LOW  | Low-end / integrated GPUs, older laptops     |
| LOW       | Budget dedicated GPUs                        |
| MEDIUM    | Mid-range GPUs, balanced look/performance    |
| HIGH      | Modern mid-to-high-end GPUs                  |
| ULTRA     | High-end GPUs, screenshots/recording         |
| POSTER    | Screenshot-only cinematic grade (heavier)    |

## Configuration
All user-facing toggles live in `shaders/lib/settings.glsl` and are also
exposed in the in-game shader settings menu once loaded. Quality presets
in `shaders/shaders.properties` override these defaults per-profile.

## Credits
- Built on top of a Super Duper Vanilla-derived base (originally by
  Eldeston, presented by FlameRender Studios) — file headers throughout
  the codebase retain that attribution. **Before distributing this pack
  publicly under the CinematicVanilla name, confirm the base project's
  license permits this kind of rebrand/redistribution** — this repo does
  not currently include a `LICENSE` file, and that's worth resolving on
  your end.
- CinematicVanilla-specific additions (Poster Mode, seasonal presets,
  V4 sky/star work, quality presets) are original to this project.

## Known limitations
See the "Known limitations" section at the bottom of `CHANGELOG.md`.
