OptiFine CurseForge searches usually come from players who manage their mods through the CurseForge app and expect to find OptiFine in its catalogue. OptiFine is not distributed through CurseForge, because its developer publishes builds on the official OptiFine website, but you can still add it to a CurseForge profile with a few manual steps.
This guide explains why OptiFine is not listed, how to add it to a custom or existing CurseForge profile, what to watch for with modpacks and how to keep everything working after updates.
Why OptiFine Is Not on CurseForge
CurseForge hosts files that creators upload to the platform themselves. The OptiFine developer distributes the mod only through the official OptiFine website, so it does not appear in CurseForge search results. Listings that claim to be OptiFine on other sites are not official.
This does not stop you from using OptiFine with CurseForge. The CurseForge app manages Forge-based profiles, and Forge can load OptiFine from the mods folder like any other mod.
Before You Start
A little preparation makes the process smooth and protects existing profiles:
- Decide which Minecraft version and Forge release the profile uses.
- Download the OptiFine build for that exact Minecraft version from the official site.
- Back up the profile or create a copy before adding OptiFine to a large modpack.
- Check the modpack page to see whether its creator recommends against OptiFine.
Adding OptiFine to a Custom CurseForge Profile
A custom profile is the cleanest place to start, because you control every mod in it. It is also the best way to test OptiFine before adding it to bigger packs.
Create the Profile
In the CurseForge app, open the Minecraft section and choose to create a custom profile. Select your Minecraft version and choose Forge as the mod loader, picking a Forge release that matches the OptiFine download notes when possible.
Place OptiFine in the Mods Folder
Open the profile's settings menu and choose the option to open its folder. Inside you will find a mods folder. Copy the OptiFine .jar into it, then launch the profile from CurseForge and check that the OptiFine menus appear in Video Settings.
Adding OptiFine to an Existing Modpack
Many players want OptiFine in a modpack they already enjoy. The process is the same as with a custom profile, but larger packs are more likely to include mods that clash with OptiFine.
Before adding it, create a copy of the profile so your original stays untouched. Then add the OptiFine jar to the copy's mods folder and test thoroughly in a new world.
Some modpacks already include alternative rendering mods. Adding OptiFine on top can cause crashes or visual glitches, so read the pack description first.
Which CurseForge Profiles Work with OptiFine?
The mod loader of the profile decides whether OptiFine can load. Use the table below as a quick reference.
| Profile type | OptiFine support | Notes |
|---|---|---|
| Forge profile | Works | Place the jar in the mods folder; match versions |
| Fabric profile | Not native | Requires a third-party bridge on supported versions |
| Vanilla profile | Not through CurseForge | Use the OptiFine installer with the Minecraft Launcher instead |
For Fabric details, see the OptiFine Fabric guide, and for Forge specifics, read the OptiFine Forge guide.
Keeping OptiFine Updated in CurseForge
CurseForge updates the mods it hosts automatically, but it cannot update OptiFine because the file comes from outside its catalogue. When you change the profile's Minecraft version or update a modpack, you need to replace the OptiFine jar yourself.
- Remove the old OptiFine jar from the mods folder.
- Download the build for the new Minecraft version from the official site.
- Place the new jar in the mods folder and test the profile.
Troubleshooting OptiFine in CurseForge
If the profile crashes after adding OptiFine, remove it to confirm it is the cause. Then compare the Minecraft and Forge versions with the OptiFine download notes. A mismatch is the most common reason for failed launches.
If the game runs but OptiFine settings are missing, make sure the jar is in the correct profile's mods folder and not in another instance. The installation guide lists more fixes.
Using Shaders in a CurseForge Profile
Once OptiFine loads in your CurseForge profile, you can add shader packs in the same way as a normal install. Open Video Settings, click Shaders and use the Shaders Folder button, which opens the shaderpacks folder inside that specific profile.
Because each CurseForge profile has its own folder, shader packs added to one profile do not appear in others. Copy the pack's .zip file into each profile where you want to use it.
- Choose lighter shader packs for modpacks that already push your hardware.
- Lower shadow quality and render distance if frame rates drop.
- Switch shaders off before reporting a crash to rule them out.
OptiFine CurseForge FAQs
Can I search for OptiFine inside the CurseForge app?
No. OptiFine is not hosted on CurseForge, so it will not appear in search. Download it from the official OptiFine website and add it manually.
Will CurseForge delete OptiFine when updating a modpack?
Modpack updates can replace or reset the mods folder. Check after every update and add the correct OptiFine jar again if needed.
Does OptiFine work with every CurseForge modpack?
No. Packs with other rendering mods may conflict with it. Test OptiFine in a copied profile before relying on it.
Can I share a CurseForge profile that includes OptiFine?
Exported CurseForge profiles only include mods hosted on CurseForge, so OptiFine is not packaged automatically. Anyone using your exported profile will need to download OptiFine from the official site and add it to their own mods folder by hand.
Conclusion
OptiFine CurseForge setups work well once you understand that the mod has to be added manually. Create or copy a Forge profile, place the matching OptiFine jar in its mods folder and test the result before playing important worlds. Remember to replace the jar yourself whenever the profile's Minecraft version changes.
With that routine in place, you can enjoy CurseForge's mod management together with OptiFine's graphics options. Check which build you need in our download section before you begin.