OptifiNeoforge

### OptifiNeoforge — OptiFine on NeoForge

A client-side mod that brings **OptiFine** to **NeoForge**. Put OptifiNeoforge and **your own OptiFine jar** into `mods/` and it takes care of the rest: OptiFine's own patching is applied at startup and the patched game classes are fed into NeoForge's transformation pipeline — the same idea as OptiFabric on Fabric Loader.

#### What this project is not

Written plain, because these are the things a reviewer or a user needs to be able to check rather than take on trust:

* **Independent implementation.** The code is written for this project and released under **MPL-2.0**. It is **not** a re-upload, port or rebrand of OptiFabric: it targets a different mod loader (NeoForge, not Fabric Loader), is a different implementation, and supports different Minecraft versions. OptiFabric's *approach* — patching OptiFine into the game at runtime — is the same, and is credited in the README; no code is taken from it.
* **No OptiFine content.** Unzip the jar and check: there are **zero `net/optifine` entries** and **no file copied from OptiFine**. The anti-aliasing post-effect definitions shipped here are authored by this project; the shader stages they name come from the OptiFine jar *you* supply.
* **OptiFine is not bundled or redistributed.** It is copyright **sp614x** and has to be obtained by the user from the official site. This project contains nothing of it.
* **Not affiliated with or endorsed by** OptiFine or NeoForge.

#### Supported versions

One jar per Minecraft version — they are **not interchangeable**. The version is in the file name: `OptifiNeoforge-1.0.0+mc1.21.8.jar`.

The 1.20.x line (1.20.1 – 1.20.6, Java 17) and the 26.x line (26.1.2, Java 25) are separate branches with their own jars.

#### Installing

1. Install the **NeoForge** version matching your Minecraft version.
2. Put the matching **`OptifiNeoforge-1.0.0+mc.jar`** into `mods/`.
3. Put the matching **OptiFine jar** (downloaded by you) into `mods/` as well.
4. Launch with the Java version listed above.

There is no installer and nothing is written into your game files.

#### Known limitations

* **1.21.6 and 1.21.7: the shader pack does not load.** Shaders and FXAA are unavailable on those two versions (the available OptiFine builds for them fail inside OptiFine itself when a pack is enabled).
* **1.21 writes four `NoClassDefFoundError` lines to stderr on every launch.** OptiFine's Reflector swallows them; startup is not affected.
* **Multiplayer has not been tested.**
* FXAA has been verified at pixel level on 9 of the 15 supported versions (1.20.4, 1.20.6, 1.21.1, 1.21.3, 1.21.4, 1.21.8, 1.21.9, 1.21.10, 1.21.11). On the others it is not yet proven, and each release note says so.

#### Links

* **Downloads:** https://github.com/Kynarain/OptifiNeoforge/releases
* **Issues / source:** https://github.com/Kynarain/OptifiNeoforge
* **OptiFine (required, not included):** https://optifine.net/downloads