Skip to content

Repository files navigation

image OptiRefine — Runtime Alpha Test

Status: Runtime Alpha Test. You can download and try it out, but it is not recommended for important worlds or servers; crashes or rendering issues may still occur. Issues are accepted — bug reports about crashes or errors caused by OptiRefine are welcome. Note: rendering anomalies while shaders are active are expected — don't worry, it is normal.


OptiRefine is a mod that utilizes Mixin to patch Optifine, keeping optifine compatible with cleanroom and reducing its destructiveness.

Let's enjoy the great optifine with the shaders. Go and get Mellow which i like

2026-08-09_03 36 39

Build

The project targets Java 25

./gradlew build

Note: mixins are written against the vanilla MCP classes on the compile classpath; OptiFine-only members are accessed via @AccessibleOperation

Test Environment

  • Cleanroom 0.6.9-alpha + OptiFine_1.12.2_HD_U_G5.jar (or you like OptiFine_1.12.2_HD_U_G6_pre1.jar )
  • Deployment: copy build/libs/optirefine-0.0.1-indev.jar into the instance mods/ folder
  • Bug reports: attach logs/latest.log / crash-reports/crash-*.txt

Feats

Cleanroom removed Realms

Configuration Image Note
with Fugue image
with OptiRefine image OptiRefine does not perform any special repairs, which may prove to be universal.

OptiFine Great Again

For a decade, OptiFine was the reason Minecraft didn't just run — it looked. Shaders, smooth lighting, zoom, dynamic skies: the game you remember is the game OptiFine drew. Then the ecosystem moved on. Cleanroom replaced the old Forge, and OptiFine's blunt bytecode surgery no longer fit in the house it used to own.

OptiRefine is the rebuild — not a patch on a patch, but a faithful re-implementation: 125 mixins restore OptiFine's behavior on Cleanroom the way it should have been done from day one, with the destructive class transformer switched off for good.

The features are back. The compatibility is back. The look is back.

Make OptiFine great again.

Fixed Issue under Cleanroommc/Cleanroom

Issues
  • Cleanroom #600Crashes when used with OptiFine
  • Cleanroom #513Optifine make the game crash in full screen
  • Cleanroom #359Instant crash on nearly vanilla setup (0.3.4)
  • Fugue #123Optifine breaks "Remove Realms Button" patches when Fugue is installed
  • Fugue #113[Optifine] Fullscreen Mode doesn't move.

About

OptiRefine is a mod that utilizes Mixin to patch Optifine, keeping optifine compatible with cleanroom and reducing its destructiveness.

Topics

Resources

Stars

25 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages