AstraLex Shaders (26.1.2, 1.20.1) – A Brand New Look for Your Minecraft Survival

Overview#

AstraLex Shaders is a comprehensive visual overhaul for Minecraft, built upon the foundation of BSL Shaders. It is designed to provide a 'brand new look' for survival gameplay by integrating high-end cinematic features usually reserved for film production. The pack focuses on vibrant lighting, deep customization, and atmospheric immersion.

Key enhancements include volumetric lighting, procedural clouds, realistic water physics, and a suite of post-processing effects such as motion blur and depth of field. Unlike standard shader packs, AstraLex includes unique 'Screen Effects' that react to gameplay events, such as blood overlays when taking damage or frost effects in cold biomes.

Visual Enhancements and Mechanics#

AstraLex Shaders does not add new blocks or items to the game's inventory; instead, it fundamentally changes the rendering mechanics of existing Minecraft elements.

Lighting and Shadows

Volumetric Lighting: Simulates light scattering through the atmosphere, creating 'God Rays' through trees and windows.
Dynamic Shadows: Real-time shadows that change length and direction based on the sun and moon's position.
Colored Light Sources: Emissive blocks like torches, glowstone, and lanterns cast light in their respective colors.
Emissive Ores: Ores glow in the dark, making them easier to spot during cave exploration.

Water and Liquids

Refraction and Reflection: Water surfaces realistically reflect the sky and surrounding terrain while distorting the view of objects underwater.
Wave Dynamics: Procedural waves that react to weather conditions.
Underwater Fog: A dense, color-tinted fog that limits visibility and adds depth to oceans.

Atmospheric Effects

Custom Skybox: Includes high-resolution stars, planets, and a customizable moon.
Auroras: Colorful northern lights that appear in cold biomes at night.
Weather Overhauls: Rain includes 'puddle' effects on flat surfaces and misty horizons.

Cinematic Post-Processing#

The 'AstraLex' identity is defined by its cinematic options, which can be toggled in the Shader Options menu.

Effect	Description
Depth of Field (DoF)	Blurs the background or foreground based on where the player is looking.
Motion Blur	Adds a blur effect to camera movements to simulate high-speed motion.
Bloom	Causes bright light sources to 'bleed' or glow into surrounding pixels.
Lens Flare	Simulates light scattering within a camera lens when looking toward the sun.
Chromatic Aberration	Adds a slight color-fringing effect to the edges of the screen.
Cel Shading	Adds black outlines to blocks and entities for a comic-book or 'Borderlands' aesthetic.
CRT/Retro Mode	Applies a scanline filter to mimic old-school monitors.

Special Screen Effects#

AstraLex features a unique 'Screen Effects' system that provides visual feedback for survival mechanics:

Damage Overlay: A blood-splatter effect appears on the screen edges when the player takes damage.
Low Health: The screen desaturates or pulses when health is critically low.
Environmental Effects: Frost appears on the screen in snowy biomes, and water droplets appear when exiting the water or during rain.
In-Game Logo: A subtle 'AstraLex' branding can be enabled to appear in the sky or on the HUD.

Configuration and Performance#

AstraLex is highly demanding but offers several profiles to balance quality and performance. These are accessed via Options > Video Settings > Shaders > Shader Options.

Performance Profiles

Low: Disables shadows and volumetric lighting; suitable for integrated graphics.
Medium: Enables basic shadows and water reflections.
High: Enables volumetric lighting, bloom, and high-quality shadows.
Ultra/Extreme: Enables all cinematic effects, high-resolution reflections, and maximum shadow distance.

Performance Tips

Render Quality: Keep at 1x. Increasing this significantly impacts FPS.
Shadow Quality: 1x is recommended for most users.
Fast Render: Should generally be turned OFF as it can cause flickering or broken effects in AstraLex.

Mod Compatibility and Fixes#

AstraLex Shaders may conflict with mods that modify sky rendering or block overlays. Below are known fixes for popular mods:

Mod	Required Configuration Change
Astral Sorcery	Add `0` to `weakSkyRenders` or `minecraft:overworld` to `skyRenderingConstellations`.
Botania	Set `fancySkybox.enable` and `shaders.enabled` to `false`.
Advanced Rocketry	Set `overworldSkyOverride` to `false`.
Better End	Set `customSky` and `useFogDensity` to `false` in `client.json`.
Dynamic Surroundings	Set `Auroras` to `false`.
Psi	Set `useShaders` to `false`.
Litematica	Set `Visuals > enableRendering` to `false` if ghost blocks flicker.
Rats	Turn off `Fast Render` in Video Settings.

Troubleshooting#

Common Issues

Pack does not appear in the menu: Ensure the file is not double-zipped. The correct path is .minecraft/shaderpacks/AstraLex_Version/shaders/. If using Safari, ensure 'open safe files' is disabled to prevent automatic unzipping.

Invalid Program Error: If you see an 'Invalid Program' message in chat, check your latest.log. This usually indicates an incompatible GPU driver or a conflict with another mod's rendering engine. Ensure you are using the official Mojang launcher.

OpenGL Errors: These are often non-critical. You can disable the notification via Video Settings > Other > Show GL Errors: OFF.

Sunlight Leaking into Caves: This is a known limitation of the shadow mapping technique. Ensure 'Chunk Loading' is set to Default and that you are not using 'Fast Render'.

Crash Diagnostics

Java Crashes: Check .minecraft/crash-reports/. If NoSuchFieldError appears on 1.12.2, update OptiFine.
Native Crashes: Check hs_err_pid.log. If atio6axx.dll is mentioned, update AMD drivers. If nv or ig are mentioned, update Nvidia or Intel drivers respectively.

AstraLex Shaders Wiki