CurseForge · Minecraft mod
Iris & Oculus Flywheel Compat
Enable Flywheel's optimizations when use shaders.
Quick answer
Which Iris & Oculus Flywheel Compat release matches Fabric?
Iris & Oculus Flywheel Compat Fabric 1.21.1+2.0.5-release targets 1.21.1 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. All 2 required mods have matching files.
Where it goes
Is Iris & Oculus Flywheel Compat required on the client, server, or both?
The project page does not say whether this file belongs on the client, dedicated server, or both.
The source does not explicitly classify this release as client-only or server-only.
What else does Iris & Oculus Flywheel Compat Fabric 1.21.1+2.0.5-release need?
Fabric 1.21.1+2.0.5-release on Fabric. Every mod below is checked against that same setup.
Install Iris Shaders, Sodium first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.
1 extra mod was pulled in by another dependency. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add Iris & Oculus Flywheel Compat without breaking your instance.
Built for Iris & Oculus Flywheel Compat Fabric 1.21.1+2.0.5-release on Fabric. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use Fabric 1.21.1+2.0.5-release. It targets 1.21.1 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Iris Shaders, Sodium first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside Fabric 1.21.1+2.0.5-release. It opens that exact file at the source.
About this project
What does Iris & Oculus Flywheel Compat add?
Version Compatibility:
| Create Version | NeoForge/Forge | Fabric |
|---|---|---|
| 6.0.9 | 2.1.0 | ❌ |
| 6.0.0 - 6.0.9 | 2.0.5 | ❌ |
| 5.0 | 1.X | 1.X |
Features:
- Render Create's entities using Flywheel Instancing with shaderpack enabled.
- Supports most shaderpacks without patching.
- Supports PBR.
The version 2.0.3 now fully supports Create 6.0.

If you have any suggestions or issues, please raise them on the GitHub issue page.
undefined
What's this?
- Flywheel will disable its optimizations when you are using shaderpacks.
- This mod forces Flywheel’s optimizations to be enabled.
- For those using shaderpacks and mods that depend on Flywheel, this mod can significantly improve fps.
- If you don’t use shaderpacks, this mod has no effect because Flywheel’s optimizations are enabled by default.
undefined
Compatibility
The shaders that have been tested are:
- BSL
- Complementary
- Complementary Reimagined
- SEUS renewed
- Sildurs Vibrant Shaders
- AstraLex
- Kapa 5.1
- Nostalgia
- Rethinking Voxels
- SEUS PTGI HRR
There are some shaderpacks that are also supported, but not listed above, so you can test them yourself.
This mod only supports some specific versions of Iris !!!
| Create Version | NeoForge/Forge | Fabric |
|---|---|---|
| 6.0.9 | 2.1.0 | ❌ |
| 6.0.0 - 6.0.9 | 2.0.5 | ❌ |
| 5.0 | 1.X | 1.X |
| Iris or Oculus | This Mod |
|---|---|
| >= 1.8.1 | 2.0.0 |
| >= 1.6.13 | 0.2.2 |
| >= 1.6.5 | 0.2.1 |
| >= 1.6.2 | 0.2.0 |
| >= 1.5 and <= 1.6.1 | 0.1.9 |
| >= 1.4 and < 1.5 | 0.1.7~0.1.8 |
| <1.4 | 0.1.6 below |
CHANGELOG
2024/7/28
- Fix lighting issues of the moving contraption.
- The vertex light strength was incorrectly set to a fixed value, causing the moving contraption won't be affected by the light source.

- Use architecture to reorganize the project.
- Forge and Fabric forge are now merged into a single project, which is more convenient for future development.
- New version number format.
- Now the version number starts from 1.0.0. The first number represents the major version and will be increased when the mod has a significant update. The second number represents the Iris/Oculus compatibility and will be increased when the mod is no longer compatible with older versions of iris.
Principle
Flywheel uses a method called GPU Instancing to render entities. It is very efficient when rendering a large number of repeating entities (e.g., cogwheels in the Create mod).
However, when you use Iris and enable shaderpack, this optimization is disabled because Flywheel needs to use its own shaders to render these entities, and Flywheel’s shaders will no longer work when you enable shaderpack.
This mod will automatically merge Flywheel’s shaders with the shaders in the shaderpack when shaderpack is enabled, allowing entities to be rendered using Instancing.
When there is a large number of entities to render, there is a significant CPU bottleneck with the original rendering method. This means that the better your GPU is, the more substantial the FPS improvement from Flywheel will be. For example, on my RTX 4070ti at 4K resolution, the scene in the screenshot improved from 26fps to 65fps.
Comparison
Before
After

Before

After

Before

After

How to use it?
Install Flywheel(Create has embedded flywheel so you don't need to install it separately now) and Iris (Oculus if you use forge).
Install this mod.undefinedundefined
Project description from CurseForge.
Pick your setup
Iris & Oculus Flywheel Compat by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
1.21.1
2 loader builds1.20.6
2 loader builds1.20.5
2 loader builds1.20.4
2 loader builds1.20.3
2 loader builds1.20.2
2 loader builds1.20.1
2 loader builds1.20
1 loader build1.19.4
2 loader builds1.19.3
2 loader builds1.19.2
2 loader builds1.19.1
1 loader buildShowing the newest 12 of 14 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Iris & Oculus Flywheel Compat versions and loaders
Fabric 1.21.1+2.0.5-release
iris-flywheel-compat-Fabric-2.0.5.jar
7 Oct 2025
Fabric 1.21.1+2.0.4-beta
iris-flywheel-compat-Fabric-2.0.4.jar
7 Jul 2025
Fabric 1.21.1+2.0.3-beta
iris-flywheel-compat-Fabric-2.0.3.jar
21 Jun 2025
Fabric 1.20.1+1.1.4-beta
iris-flywheel-compat-fabric1.20.1+1.1.4.jar
6 Oct 2024
Fabric 1.19.2+1.0.3b-beta
iris-flywheel-compat-fabric1.19.2+1.0.3b.jar
6 Oct 2024
Fabric 1.20.1+1.1.3b-beta
iris-flywheel-compat-fabric1.20.1+1.1.3b.jar
6 Oct 2024
Fabric 1.19.2+1.0.3a-beta
iris-flywheel-compat-fabric1.19.2+1.0.3a.jar
17 Aug 2024
Fabric 1.20.1+1.1.3a-beta
iris-flywheel-compat-fabric1.20.1+1.1.3a.jar
17 Aug 2024
iris-flywheel-compat-fabric1.18.2+1.0.3.jar
17 Aug 2024
iris-flywheel-compat-fabric1.20.1+1.1.2.jar
7 Aug 2024
iris-flywheel-compat-fabric1.19.2+1.0.2.jar
7 Aug 2024
iris-flywheel-compat-fabric1.18.2+1.0.2.jar
7 Aug 2024
Looking for an older file? The official CurseForge project page is in Resources.
