Graphics and drivers

Shader Program Linking Failed (Sodium / Iris)

What the log looks like

java\.lang\.RuntimeException: Shader program linking failed, see log for details
Shader program linking failed, see log for details\s+at me\.jellysquid\.mods\.sodium\.client\.gl\.shader\.GlProgram\$Builder\.build

How to fix it

  1. Open your .minecraft/logs/latest.log file and check the lines immediately above 'Shader program linking failed' to read the exact OpenGL compiler error from your graphics driver.
  2. Download and install the latest graphics driver directly from NVIDIA, AMD, or Intel (use the Clean Installation option if available) rather than using Windows Update.
  3. If the crash happened after selecting a shader pack, open .minecraft/config/iris.properties in a text editor and change enableShaders=true to enableShaders=false, or test a lighter shader pack if you have an older GPU.
  4. Update Sodium, Iris, Indium, and Sodium Extra to their latest builds for your Minecraft version so you get recent driver-bug workarounds.
  5. On laptops or dual-GPU PCs, open Windows Settings > System > Display > Graphics and set your Java executable (javaw.exe) to High Performance so Minecraft uses your dedicated GPU.
LoadersFabric, Quilt, Neoforge, Forge
SeverityStops the game
CategoryGraphics and drivers

Check your own log

Related errors

Graphics and driversEXCEPTION_ACCESS_VIOLATION in a graphics driverThe .dll in the report names the vendor: nvoglv=NVIDIA, atio6axx=AMD, ig*icd=IntelGraphics and driversFlywheel GlException: mapBufferRange(ARRAY_BUFFER) Crash with CreateOpen your Minecraft instance folder, go into the `config` folder, and open `flywheel-client.toml` in a text edGraphics and driversGLFW error — the driver does not support the required OpenGL versionMinecraft 1.17+ needs OpenGL 3.3; older integrated chips cannot provide itGraphics and driversIris Crash: Close the existing render pass before performing additional commandsUpdate Iris Shaders (and Sodium) to the newest available build for your Minecraft version, as older 1.21.6–1.2Graphics and driversOpenGL Crash: GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENTIf OptiFine is installed, remove its `.jar` from the `mods` folder (or disable Video Settings -> Performance -Graphics and driversPixel format not acceleratedThe system is falling back to a software OpenGL driver