DownloadAstraLex ShadersGet the files on 9Minecraft
Contents (5)
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/. IfNoSuchFieldErrorappears on 1.12.2, update OptiFine. - Native Crashes: Check
hs_err_pid.log. Ifatio6axx.dllis mentioned, update AMD drivers. Ifnvorigare mentioned, update Nvidia or Intel drivers respectively.
Recommended Video Settings
- Brightness: Set to a standard level (50-100%). Extreme values via mods can break lighting.
- Anisotropic Filtering: OFF (can break voxellization).
- Custom Sky: OFF (AstraLex provides its own sky; OptiFine custom skies will conflict).
- Connected Textures: OFF if using Parallax Occlusion Mapping (POM).
- Sky: ON (Required for the shader sky to render).
