DAP SHADERS
===========
by DAPTIME                              linktr.ee/DAPTIME


THIS ZIP IS THE SHADERPACK.
Drop it straight into your Minecraft "shaderpacks" folder and pick it in
Video Settings > Shaders. Nothing else is required.

    Windows:  %appdata%\.minecraft\shaderpacks
    macOS:    ~/Library/Application Support/minecraft/shaderpacks


WHICH BUILD DO I NEED?
  Minecraft 1.20 or newer  ->  "DAP Shaders <version> 1.20-26.2.zip"
  Minecraft 1.16 - 1.19    ->  "DAP Shaders <version> 1.16-1.19.zip"
  Minecraft 1.15 or older  ->  not supported, sorry.

  Pick the wrong one and the screen fills with moving warning stripes rather
  than rendering something subtly broken:
      ORANGE stripes  ->  your game is newer than this build. Get the 1.20-26.2
                          build.
      PURPLE stripes  ->  your game is older than this build. Get the 1.16-1.19
                          build - or, if you are on 1.15 or below, DAP does not
                          support your version.

WILL IT RUN ON MY SETUP?
  See COMPATIBILITY.txt. Short version: Iris or OptiFine on any GPU vendor, and
  it is written to render correctly on the OpenGL-on-Vulkan stacks too (Zink,
  ANGLE, Apple Silicon). It does NOT work with VulkanMod - that mod loads no
  shaderpacks at all, from anyone.


Everything below is OPTIONAL extra, bundled in for convenience. Minecraft
ignores it - it does not affect the shaders at all.


OPTIONAL - DARK UI RESOURCE PACK
  "DAP Shaders Dark UI.zip"  ->  your "resourcepacks" folder,
  then enable it under Options > Resource Packs.

  It darkens the container screens (inventory, chests, furnaces, and so on).
  That is all it does - it is cosmetic and independent of the shaders.


OPTIONAL - ALWAYS DAY / ALWAYS NIGHT
  In the "presets" folder:
      DAP Always Day.txt
      DAP Always Night.txt

  These lock the sky, sun or moon position and the lighting to permanent midday
  or permanent midnight on YOUR screen. The server's time does not change, mobs
  spawn on their normal schedule, and other players see the normal sky.

  These are shader settings files, not resource packs, because a resource pack
  cannot change the time of day - it can only swap textures. The shader is what
  draws the sky, so the shader is what can pin it.

  To use one: select DAP Shaders in game once so it writes its settings file,
  quit Minecraft, then copy the preset into your shaderpacks folder and rename
  it to match the shaderpack zip with .txt instead of .zip. Each file has the
  full instructions at the top.

  You can also just switch it on in game: Time & Weather Override > Fixed Time
  of Day.


OPTIONAL - INSTALLER
  If you would rather not move files by hand, extract this zip and run one of:

      Run DAP Shaders Installer.cmd    (Windows - RECOMMENDED)
      DAP Shaders Installer.exe        (Windows - the small window version)
      DAP Shaders Installer.command    (macOS / Linux)

  All three do the same job: copy the shaderpack into every Minecraft they find,
  copy the Dark UI pack into each one's resourcepacks folder, and leave a spare
  copy of the shaderpack in your Downloads folder. They download nothing, need no
  admin rights, and the only thing they ever delete is an OLDER "DAP Shaders" pack
  - and only after the new one has been written successfully, so a failed copy
  leaves you with the pack you already had.

  Keep every extracted file together. The installer looks for the shaderpack zip
  sitting next to itself.


  WHY WINDOWS WARNS ABOUT THE .EXE, AND WHAT TO DO
  The .exe is not code-signed, so Windows shows "Windows protected your PC" or
  "unknown publisher", and some antivirus heuristics dislike any unsigned program
  that copies files into several folders. That warning is about the ABSENCE OF A
  SIGNATURE, not about anything the program does - Windows cannot tell who wrote
  an unsigned file, so it warns on principle.

  There is no way to make an unsigned .exe stop triggering that. The only real
  fixes are a code-signing certificate (a paid thing, and it takes weeks of
  downloads before SmartScreen trusts a new one) or not shipping an .exe at all.

  So there is a second Windows installer that avoids the problem entirely:
  "Run DAP Shaders Installer.cmd" plus "DAP Shaders Installer.ps1". Those are
  plain text. You can open them in Notepad and read exactly what they do before
  running anything - which is a better answer than being asked to trust a binary.
  Prefer them. The .exe is kept only because some people like the little window.


  IF IT SAYS "ACCESS DENIED":
    Almost always this means Minecraft or your launcher is still RUNNING and
    is holding the file open - resource packs stay locked while the game is
    open. Fully quit Minecraft and the launcher (CurseForge / Modrinth /
    Prism), then run the installer again.

    Only if EVERY copy failed is it Windows ransomware protection: Windows
    Security > Virus & threat protection > Ransomware protection > "Allow an
    app through Controlled folder access". If some copies worked, that is
    not the cause.

    Re-running is safe: files that are already correct are left untouched.

  WHAT THE INSTALLERS CONTAIN
  Nothing in any of them downloads, phones home, touches the registry, creates a
  service or scheduled task, or launches another program. The .ps1 and .command
  versions are plain text, so you can confirm that yourself rather than take the
  claim on faith - which is the point of shipping them.


IN-GAME SETTINGS
  Quality   -  Potato / Low / Medium / High / Ultra / MAX   (start at Medium)
               Sets how much work the shader does. MAX puts every graphics
               option at its ceiling, including 20 chunks of shadow distance.
               It is not a sensible default; it is "I have the GPU, show me
               everything".
  Preset    -  Custom / Vanilla / Skyblock / Bedwars / Hoplite /
               Minemen / Cinematic
               Sets how the game LOOKS for a use case. Each one changes real
               settings, so you will see other menu values move when you pick
               one. Custom leaves everything alone.

  Both cycle on left AND right click.

  Plus full menus for Lighting (including Light Levels and Auto Exposure),
  Sky & Weather, Water, Materials & PBR, Colour & Style, Nether & End,
  Movement & Animation, Camera & Anti-aliasing, and Time & Weather Override.


ABOUT RENDER DISTANCE
  A shaderpack cannot change Minecraft's own render distance slider - no
  shaderpack can. What DAP controls is how far its shadows, shading and
  volumetric fog reach into the terrain the game has already drawn. That is the
  "Shadow Distance" setting, up to 320 blocks (20 chunks) on MAX.

  So for the longest shader draw distance, raise BOTH: Minecraft's render
  distance in Video Settings, and Shadow Distance in the shader's Shadows menu.
  Shadow Distance beyond your vanilla render distance does nothing useful.


ABOUT "80% WHITE"
  With Light Levels on, blocks are lit in 16 discrete steps like vanilla light
  levels, and the brightest step is capped so a sunlit block keeps its texture
  instead of blowing out to flat white. "Brightest Level 0.80" means the top step
  displays at 80% white, measured at the default Exposure and Brightness - change
  those and the number shifts with them.

  In a dark cave, auto exposure deliberately brightens the scene, so the
  brightest surface there sits a few percent above the ceiling. That is intended:
  it is what makes caves readable without a torch in hand.

   - DAPTIME
