OptiFine installs directly through CurseForge's launcher, not through the website

OptiFine is a performance mod for Minecraft that improves frame rates and adds graphics settings. CurseForge's launcher handles the installation automatically — you do not read OptiFine separately or place files in folders yourself. The launcher finds the mod, downloads it, and puts it in the right place for your Minecraft version.

This process takes about five minutes and works the same way whether you are on Windows, Mac, or Linux. You will need CurseForge already installed and a Minecraft account that owns the Java Edition.

Key Takeaways

  • Open CurseForge, create or log into your account, and select Minecraft from the left menu to start a new instance.
  • Choose your Minecraft version and mod loader (Forge is the most common), then create the instance and wait for it to finish.
  • Search for OptiFine inside your instance, select the version that matches your Minecraft version, and click Install.
  • Launch the game through CurseForge to load OptiFine — it will appear as a new graphics settings menu in the pause screen.
  • OptiFine settings are found under Options > Video Settings once you are in a world or creative mode.

Creating a new Minecraft instance in CurseForge

Open CurseForge and log in with your account. Click Minecraft on the left sidebar. At the top right, click Create Custom Profile or Create Instance (the button name varies by CurseForge version).

A window will open asking you to choose a Minecraft version. Select the version you want to play — for example, 1.20.1 or 1.19.2. Below that, choose a mod loader. Forge is the most common and works with OptiFine. Click Create and wait while CurseForge downloads the necessary files. This can take one to three minutes depending on your internet speed.

Once the instance finishes creating, it will appear in your Minecraft list. You can rename it by right-clicking the instance name if you want to call it something like "OptiFine Instance" to keep track of it.

Finding and installing OptiFine

Right-click your new instance and select Open Folder or Manage (depending on your CurseForge version). Look for a button or menu option that says Add Mods or Browse Mods. Click it to open the mod search.

Type OptiFine into the search box. The official OptiFine mod will appear at the top of the results — it shows a green and white icon. Click on it to open the mod page. You will see a list of OptiFine versions. Find the one that matches your Minecraft version — for example, if you chose Minecraft 1.20.1, look for OptiFine 1.20.1.

Click the version you need, then click Install. CurseForge will read OptiFine and place it in your instance automatically. You will see a confirmation message when it finishes. Do not close CurseForge during this process.

Launching Minecraft with OptiFine

Return to your Minecraft instances list in CurseForge. Find your instance and click Play. CurseForge will launch Minecraft with OptiFine loaded. The first launch may take longer than usual because Minecraft is setting up the mod for the first time.

Once you are in the main menu, click Options, then Video Settings. You will see new options that OptiFine adds — these include render distance, chunk loading, and graphics quality adjustments. OptiFine also adds a Shaders button in the Video Settings menu if you want to install shader packs later.

Adjusting OptiFine settings for better performance

OptiFine's most useful settings for frame rate improvement are in the Video Settings menu. Render Distance controls how far you can see — lowering it from 12 to 8 or 10 chunks improves frame rate significantly. Graphics should be set to Fast if you want maximum performance, or Fancy if your computer can handle it.

Smooth FPS and Fast Math are usually safe to turn on and provide small frame rate gains. Mipmaps improves how distant textures look without hurting performance much. If you are still getting low frame rates, lower Render Distance further or reduce the Max Framerate setting to match your monitor's refresh rate — this prevents your graphics card from working harder than necessary.

You can change these settings at any time without reinstalling OptiFine. Close the game, adjust a setting, and launch again to test the change.

Removing OptiFine if you need to

If OptiFine causes problems or you want to remove it, right-click your instance in CurseForge and select Manage or Open Folder. Find the mods folder inside your instance. Look for the OptiFine file — it will be named something like OptiFine_1.20.1_HD_U_I1.jar. Delete this file and restart Minecraft. The mod will no longer load.

You can also create a separate instance without OptiFine if you want to keep both versions. This is useful if some mods conflict with OptiFine or if you want to play vanilla Minecraft without performance tweaks.

Troubleshooting OptiFine installation problems

If OptiFine does not appear in the Video Settings menu after launching, the mod did not load correctly. Check that you selected the right Minecraft version when creating your instance — OptiFine 1.20.1 will not work with Minecraft 1.19.2. Delete the OptiFine file from your mods folder and install the correct version.

If CurseForge crashes when you try to install OptiFine, restart CurseForge and try again. If the problem continues, make sure you have at least 2 GB of free disk space and that your internet connection is stable. Some antivirus software can interfere with CurseForge downloads — if you have trouble, temporarily disable your antivirus and try the installation again.

If Minecraft crashes when you launch it with OptiFine, you may not have enough RAM allocated to Minecraft. In CurseForge, right-click your instance and look for Settings or Memory. Increase the allocated RAM to at least 4 GB if your computer has it available.

Frequently Asked Questions

Can I use OptiFine with other mods?

OptiFine works with most mods, but some conflict with it. If your game crashes after adding OptiFine alongside other mods, try removing OptiFine to see if that fixes it. You can also search online for your specific mods plus OptiFine to see if others have reported problems.

Does OptiFine work with shader packs?

Yes. Once OptiFine is installed, you can add shader packs through the Shaders button in Video Settings. Shader packs change how light and shadows look and will reduce your frame rate, so start with OptiFine's performance settings optimized first.

What if I want to uninstall CurseForge but keep OptiFine?

You can export your instance from CurseForge before uninstalling. Right-click the instance and select Export. This creates a file you can import into another launcher. However, most players straightforward reinstall through CurseForge if they need to use it again.

Do I need Forge to use OptiFine?

Yes, OptiFine requires a mod loader. Forge is the most common choice and works reliably with OptiFine. Fabric is another option, but OptiFine support on Fabric is less stable than on Forge.