Before you continue

Because OptiFine is an old, closed-source project, it has evolved to cause many mod incompatibilities, and doesn't do as good of a job as some the alternatives out there.

Also, if you're using the Fabric mod loader, there's no native support for it, and the current workaround is known to be buggy and quite unstable, due to the very nature of OptiFine and OptiFabric.

Therefore, you should consider the use of OptiFine alternatives whenever possible. See the wiki page about it.

Installing OptiFine

Make sure you know how to download mods before attempting to install OptiFine.

Go to and find your respective Minecraft version (eg. 1.18.2).

Once found, click mirror. Now click the download button to download your OptiFine jar file.

Remember where you have kept your .jar file, and continue to the PolyMC launcher. Follow the steps from the download mods page, and choose either Forge or Fabric(!warning).


Forge does not require any extra steps besides adding the .jar for OptiFine into PolyMC.

NOTE: Some versions of OptiFine don't work on Forge!


Note: If you're playing on Minecraft versions older than 1.16, you might need to also install the Fabric API mod.

Fabric, unlike Forge, does not natively support OptiFine, and will require the installation of OptiFabric.

Go into the Mods tab on the left side and then in the right menu select Download mods, then select CurseForge and search OptiFabric. Once found, click Select mod for download, and then press OK. You may now procede with adding the .jar file for OptiFine into PolyMC.

If there were results shown in the search, your Minecraft version may not be compatible with OptiFabric. In this case, you can either try the Forge method, or choose to wait until support for your Minecraft version is added.


There's no way of running OptiFine on Quilt at the time of writing.

Adding the .jar file into PolyMC

Go into the Mods tab on the left side of the Edit Instance menu, and then click on the Add .jar option to the right of the window.

Now, find and select the .jar file you downloaded earlier, and it should now be added to your instance. Enjoy!

Pages in Getting Started: