AstraLex Shaders — FAQ
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).