CurseForge · Minecraft mod
OptiGUI
Blazing fast custom GUI textures on Fabric and Quilt with built-in OptiFine custom GUI resource pack support
Quick answer
Which OptiGUI release matches 26.1.1 Fabric?
OptiGUI 2.3.0-beta.10+26.1 targets 26.1, 26.1.1, 26.1.2 with Fabric, Quilt. The project page does not say whether it belongs on the client. The project page does not say whether it belongs on the dedicated server. All 2 required mods have matching files.
Where it goes
Is OptiGUI required on the client, server, or both?
The project page does not say whether it belongs on the client. The project page does not say whether it belongs on the dedicated server.
The source does not explicitly classify this release as client-only or server-only.
What else does OptiGUI 2.3.0-beta.10+26.1 need?
OptiGUI 2.3.0-beta.10+26.1 on 26.1.1 Fabric. Every mod below is checked against that same setup.
Install Fabric API, Fabric Language Kotlin first. We found matching files for this game-version and loader setup.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add OptiGUI without breaking your instance.
Built for OptiGUI 2.3.0-beta.10+26.1 on 26.1.1 Fabric. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use OptiGUI 2.3.0-beta.10+26.1. It targets 26.1, 26.1.1, 26.1.2 with Fabric, Quilt; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API, Fabric Language Kotlin first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
The project page does not say whether it belongs on the client. The project page does not say whether it belongs on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside OptiGUI 2.3.0-beta.10+26.1. It opens that exact file at the source.
About this project
What does OptiGUI add?
OptiGUI
OptiGUI is a client-side mod, which enables the customization of in-game GUI screen textures with resource packs. Now rewritten from scratch in Kotlin for cleaner code, better performance, more features, and extensibility. Other mods' developers can add their custom containers and customization options. See documentation link above.
Supports most OptiFine GUI resource packs. If a resource pack does not work or works differently than using OptiFine, please open an issue (select the Report a bug template).
Check out my new OptiGUI resource pack for Minecraft 1.19+: Chest Boat GUI
⚠️ OptiGUI 2.3.x prior to beta 8 is incompatible with Fabric Language Kotlin 1.13.5+. Please downgrade to Fabric Language Kotlin 1.13.4.

How to use it
⚠️ If you're not a resource pack creator experimenting with OptiGUI 3 JSON resources, then you should stick with OptiGUI 2.3.x betas.
- Download and install Fabric loader or Quilt loader
- Download this mod to your mods folder
- Download the required dependencies to your mods folder as well
- Download and enable a supported resource pack (see below)
Supported languages
- 🇺🇸 by opekope2
- 🇹🇼 by dirtTW, notlin4
- 🇨🇳 by dirtTW, notlin4
- 🇩🇪 by Lucanoria
- 🇪🇸 by LyriaWintona
- 🇮🇹 by RoberbufDx8105
- 🇲🇾 by NuruddinPlays
- 🇺🇦 by gorr0w7
Want to see your name here? Translate OptiGUI to your native language.
Compatibility
Cobblemon
If you play with Cobblemon 1.5.2 and earlier, you need Fabric Language Kotlin [1.10.11+kotlin.1.9.20](https://modrinth.com/mod/fabric-language-kotlin/version/1.10.11 kotlin.1.9.20) or earlier (which doesn't crash).
Supported loaders & clients
As of the latest OptiGUI 3 alpha release, only Fabric & Quilt loaders are supported.
⚠️ Quilt support is based on Quilt loader's support for loading Fabric mods.
⚠️ Support for using Fabric compatibility layers or alternative clients such as Sinytra Connector or Lunar client is done on a best-effort basis, but issues may arise, which is not necessarily OptiGUI's fault.
Resource pack docs
OptiGUI supports OptiFine custom GUI resource packs, and also supports OptiGUI resource packs. OptiGUI resource packs are more flexible than OptiFine resource packs. See documentation link above to get started.
Supported resource packs (OptiGUI 2.3.x)
Excluding vanilla resource packs (which don't container OptiFine or OptiGUI-specific files)
- Colourful Containers
- Colourful Containers Add-On
- Colourful Containers Dark Mode
- Animated RGB GUI ¹
- NEON20 ANIMATED
- Rybo's Enhanced GUI
- Animated Fox Guis ¹
- [DARK] Animated Fox Guis ¹
- Recolourful Containers GUI + HUD
¹ see FAQ for animation support
This list is not exhaustive. If you know a resource pack which works, and you'd like to see it here, or a resource pack, which does not work, but works with OptiFine, please open an issue.
Partially supported resource packs
Excluding vanilla resource packs (which don't container OptiFine or OptiGUI-specific files)
¹ Barrel does not work, neither does it work with OptiFine. The resource pack does not specify it according to the format.
FAQ
Use in a modpack?
Yes.
OptiFine GUI animations?
Only with Animatica.
OptiFine colors (colors.properties)?
No, use Colormatic.
Performance impact?
OptiGUI's performance impact is negligible (tho it varies a bit depending on which resource packs are used).
Configuration GUI/file?
Nothing to configure.
Sodium?
Yes.
OptiFine?
Actually, OptiGUI and OptiFine (with OptiFabric) can be loaded simultaneously. I have observed that OptiGUI mixins will be placed before OptiFine ones, so you can turn off custom GUIs in OptiFine to save performance.
However, I can't assist you with this.
Project description from CurseForge.
Pick your setup
OptiGUI by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.2
2 loader builds26.1.2
2 loader builds26.1.1
2 loader builds26.1
2 loader builds1.21.11
2 loader builds1.21.10
2 loader builds1.21.9
2 loader builds1.21.8
2 loader builds1.21.7
2 loader builds1.21.6
2 loader builds1.21.5
2 loader builds1.21.4
2 loader buildsShowing the newest 12 of 31 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
OptiGUI versions and loaders
OptiGUI 2.3.0-beta.10+26.1
optigui-2.3.0-beta.10+26.1.jar
1 Apr 2026
Looking for an older file? The official CurseForge project page is in Resources.