Shaders change how Minecraft looks more than almost any other mod, and OptiFine is the easiest way to get them running on Java Edition. This guide covers the full process: installing OptiFine, finding the shaderpacks folder, and dropping in your first shader pack.
What You Need Before You Start
- Minecraft Java Edition — OptiFine shaders do not work on Bedrock Edition at all
- Java installed on your PC — needed to run the OptiFine installer (Java 8 or newer)
- The correct OptiFine version — OptiFine 1.20.1 will not work with Minecraft 1.20.4; the version numbers must match exactly. You can grab OptiFine from our OptiFine download page
- A shader pack — downloaded as a .zip file. Do not unzip it; the file goes in as-is
You do not need Forge or Fabric to run OptiFine on its own. OptiFine installs as a standalone profile in the vanilla launcher. If you want to use it alongside Forge mods, see the Forge installation guide — there are extra steps to make them coexist.
How to Install OptiFine
- Download the OptiFine .jar file for your Minecraft version.
- Open the Minecraft Launcher and launch the plain vanilla version at least once. This creates the game folders OptiFine needs.
- Close Minecraft, then double-click the OptiFine .jar file. The OptiFine installer window opens.
- Click Install. You will see a message saying it installed successfully.
- Back in the Minecraft Launcher, open the profile selector (bottom-left drop-down) and choose the new OptiFine profile.
- Click Play. Minecraft loads with OptiFine active — you can confirm this on the title screen where it shows the version string with “OptiFine” in it.
How to Add a Shader Pack
- Launch Minecraft using the OptiFine profile.
- From the main menu, go to Options > Video Settings > Shaders.
- Click the Shaders Folder button in the bottom-left corner. This opens the shaderpacks folder in your file browser.
- Copy your shader pack .zip file into that folder. Do not extract it — the .zip goes in whole.
- Switch back to Minecraft. The shader pack name appears in the list. Click it to select it, then click Done.
- The shader loads. Expect your frame rate to drop — that is normal, especially on heavier packs.
Finding the Shaderpacks Folder Manually
If you need to locate it yourself rather than using the in-game button:
- Windows: Press Win+R, type
%appdata%\.minecraft\shaderpacks, press Enter - macOS: Open Finder, press Cmd+Shift+G, paste
~/Library/Application Support/minecraft/shaderpacks - Linux: Navigate to
~/.minecraft/shaderpacks
If the shaderpacks folder does not exist yet, create it manually inside the .minecraft folder.
Common Mistakes and Troubleshooting
No “Shaders” Option in Video Settings
This means OptiFine is not actually running. Open the Minecraft Launcher and make sure you selected the OptiFine profile before clicking Play. If you only see one profile, the install may have failed — try running the OptiFine installer again.
Wrong OptiFine Version
OptiFine versions are tied to specific Minecraft releases. If you downloaded OptiFine 1.20.1 but are playing 1.20.4, it will not work. Check your Minecraft version in the launcher and download the matching OptiFine build.
You Extracted the Shader Zip
Put the .zip file into the shaderpacks folder as a .zip. Do not unzip it. Minecraft reads the archive directly. If you see a folder in your shaderpacks directory instead of a .zip, that is the problem.
Minecraft Crashes When Loading Shaders
A few things to check: your graphics drivers may be outdated (update them), or you may have other mods conflicting with OptiFine. Try removing other mods first and testing with just OptiFine. Also check that your .minecraft/logs/latest.log for error details — it usually names the cause.
OptiFine and Forge Mods Together
OptiFine can run alongside Forge, but you need specific compatible versions of both. Not every OptiFine release works with every Forge build. Check the OptiFine changelog for which Forge versions are supported. See the Forge mod installation guide for more detail on setting up that combination.
Shaders Load but Look Wrong
Older shader packs sometimes do not render correctly in newer versions of OptiFine. If a pack that used to work now looks broken, try a different version of the shader pack or swap to a different pack entirely.
Which Versions and Editions This Covers
OptiFine works with Minecraft Java Edition from 1.7.10 through current versions. New OptiFine releases usually come out a few weeks after Minecraft updates, so if you just updated to the latest Minecraft snapshot or release, you may need to wait.
Bedrock Edition does not support OptiFine. Bedrock has its own separate shader system that works differently and is not covered here.
For Minecraft 1.20 and newer, some players prefer Fabric with the Iris Shaders mod instead of OptiFine, since Iris tends to update faster. The shader packs themselves are usually compatible with both. But if you are already using OptiFine, there is no reason to switch unless you are running into update delays.