Troubleshooting¶

You may run into a problem when installing or using OptiFine. Below listed are the most common problems and solutions. This is a non-exhaustive list; it does not contain every conceivable issue.

To get general support after confirming your solution is not here, join the Discord.

Downloading¶

Did not get a .JAR file¶

This occurs because you did not click the correct link when following the instructions on Downloading. Ensure that you skip ads, or click the "(mirror)" link.

Installing¶

FileNotFoundException (Access Denied)¶

Go to the file location C:\Users\<your username here>\AppData\Roaming\.minecraft\libraries\optifine\OptiFine and delete the folder corresponding to the OptiFine version you are trying to install.

There are errors in the following switches¶

This occurs because you did not follow the instructions in Pre-requirements. Scroll to the Jarfix section and follow the directions.

Cannot find Minecraft version¶

This occurs because you did not follow the instructions in Install With Vanilla Launcher. In the Vanilla Launcher, create a new profile (installation) with the requested Vanilla version. Run it, and then close it. Re-run OptiFine.

ZipException: error in opening zip file¶

Copy the below code and paste it into a file ending in .bat. Run it.

<# :

@echo off
echo Select the OptiFine.jar file to install
setlocal

for /f "delims=" %%I in ('powershell -noprofile "iex (${%~f0} | out-string)"') do (
java -jar %%~I
)
goto :EOF

: #>

Add-Type -AssemblyName System.Windows.Forms
$f = new-object Windows.Forms.OpenFileDialog
$f.InitialDirectory = pwd
$f.Filter = "JAR File (*.jar)|*.jar"
$f.ShowHelp = $true
$f.Multiselect = $true
[void]$f.ShowDialog()
if ($f.Multiselect) { $f.FileNames } else { $f.FileName }

Or, download the script here.

Could not find the main class¶

You did not follow the instructions in Pre-requirements. You need to install a Java runtime.

Launching¶

modName:tomatoGuy¶

This occurs because you have an old version of Complementary shaders. Either delete the shaderpack or update it.

Could not create the Java Virtual Machine¶

This occurs because you did not follow the instructions in Pre-requirements. You need to install a Java runtime, as well as Jarfix.

Using¶

Purple and black checkerboard textures¶

This happens because a required texture did not load. Normally, two things cause this:

• Invalid path (check File naming rules).

• Missing file

Check your latest.log for more specifics on which textures are failing to load, and why.

Ensure all of your .properties files point to valid texture paths.

Warped shaders¶

This occurs because of a known bug. Enabling and disabling shaders with Forge requires a restart.

If running on Forge, do not swap shaders while in a world.