===============================================================================
  PSYCHEDELIC SHADERS - FREE EDITION
  by WetCardboardMC
===============================================================================

WHAT THIS IS
------------
A psychedelic visual simulation pack. It renders documented visual phenomena -
geometric form constants, drifting and breathing surfaces, colour shifting,
tracers, after-images, closed-eye geometry - scaled continuously by a strength
percentage.

The geometry is not invented. In the 1920s and 30s Heinrich Kluver catalogued
the recurring geometric forms reported in altered states and found they
collapse into four categories, now called the form constants. The same four
turn up under flicker stimulation, in migraine aura and in pressure
phosphenes, which is strong evidence they come from the structure of the
visual cortex rather than from anything specific. All four are implemented as
separate, adjustable layers:

  I    tunnels, funnels, cones     -> concentric rings in log-polar space
  II   spirals                     -> twisting arms from the same centre
  III  gratings, lattices,         -> three gratings at sixty degrees, giving
       honeycombs, chequerboards      a true hexagonal honeycomb network
  IV   cobwebs                     -> radial spokes crossed with rings

Tunnels and spirals are built in log-polar coordinates specifically because
that is what the retinocortical mapping predicts: a straight line across the
visual cortex maps to a spiral in the visual field, and evenly spaced cortical
stripes map to rings that crowd toward the centre. Building them that way is
what makes the spacing look right rather than merely circular.

MODES
-----
  Organic       slower, warmer, wavier. Heavier breathing and melting, softer
                pattern edges, an earthy amber and gold palette, shorter
                tracers.
  Crystalline   faster, cooler, more geometric. Crisper and thinner lattice
                lines, stronger recursive structure, more electric colour
                across the full spectrum, longer and cleaner tracers.

STRENGTH
--------
Both modes run on a saturating response curve, so the low end stays almost
imperceptible and the middle climbs steeply.

    0-15%    nothing to threshold
   15-30%    light. Brighter colours, gentle drifting
   30-55%    common. Clear warping and patterning
   55-75%    strong. Geometry across most surfaces

Effects have individual onset thresholds, so raising the dial recruits new
phenomena rather than just amplifying one. In order of appearance: acuity and
brightness lift, colour enhancement, drifting, breathing, tracers,
after-images, the form constants, spatial warping, colour shifting, symmetry
and recursion, then closed-eye visuals surging in dark areas.

WHAT THE FULL EDITION ADDS
--------------------------
  100% strength           instead of the 75% cap here.

  Hyperspace mode         a third mode with a live session system driven by a
                          key press, a real onset and comedown curve with
                          stacking come-ups, an exhale effect, procedurally
                          generated entities, and the breakthrough sequence.

  Escape-time fractals    real per-pixel iteration - Mandelbrot, Julia,
                          Burning Ship, cubic Julia and Newton basins - rather
                          than a procedural imitation. Which family runs, how
                          it is framed, how it zooms and how it is coloured are
                          all chosen by a session seed, so no two sessions
                          render the same structure.

  Labyrinth linework      nested Truchet weaves draped over shaded forms, so
                          the paths genuinely connect and wander rather than
                          being noise that merely looks busy.

  Saturation layers       additional structure stacked beyond 100% strength.

INSTALLING
----------
Drop the .zip into .minecraft/shaderpacks and select it in
Options > Video Settings > Shaders. Requires Iris or OptiFine.

Nothing changes until you turn it on. The pack ships at zero strength, which
compiles the entire effect out, so it renders and performs exactly like the
base pack until you raise a slider.

Settings live under Shader options > Psychedelics.

PERFORMANCE
-----------
Cost scales with strength, because effects below their onset threshold are
branched out entirely. At zero the cost is zero and the temporal buffers are
never written.

If you are photosensitive: everything here moves smoothly and there is no
full-screen strobing anywhere in the pack.

CREDITS
-------
Psychedelic Shaders by WetCardboardMC.
Built on BSL Shaders v10.1.3 by Capt Tatsu - https://capttatsu.com
Please respect the original pack's terms when sharing this edit.
