OptiGUI is a client-side GUI customization mod that enables players to apply custom textures to every in-game menu and container screen using resource packs, built for Fabric and Quilt mod loaders. Originally created by opekope2 and rewritten from scratch in Kotlin, it serves as the go-to Fabric alternative for OptiFine's custom GUI texture feature.
Minecraft's default GUI textures are functional but plain. Every chest, crafting table, and furnace shares the same vanilla look, and resource pack creators have long relied on OptiFine to customize these screens. The problem? OptiFine is exclusive to the vanilla launcher and incompatible with Fabric, leaving an entire modding ecosystem without custom GUI support. OptiGUI solves this gap directly. With over 17 million downloads on Modrinth, it has become the standard solution for Fabric and Quilt players who want full control over their GUI aesthetics. Whether you are a resource pack creator designing themed container textures or a player who simply wants matching visuals across your entire game, OptiGUI delivers that capability without requiring OptiFine.
Key Features of OptiGUI
- OptiFine Custom GUI Resource Pack Support — This is the headline feature and the reason most players install OptiGUI. Resource packs designed for OptiFine's custom GUI system work directly with OptiGUI, meaning you do not need to hunt for Fabric-specific packs. If you have been eyeing a texture pack that changes chest, villager, or brewing stand GUIs but it says "requires OptiFine," OptiGUI almost certainly has you covered.
- Full Kotlin Rewrite for Performance — OptiGUI has been rewritten from the ground up in Kotlin, resulting in cleaner architecture and faster texture loading compared to earlier versions. For players running large modpacks with dozens of resource packs layered together, this rewrite means GUI texture swaps happen efficiently without adding noticeable overhead to your game.
- Client-Side Only Operation — Because OptiGUI runs entirely on the client side, you can install it without any server-side changes. This makes it ideal for multiplayer — you can customize your own GUI experience on any server without the server owner needing to install anything or even knowing you are using it.
- Extensible API for Mod Developers — OptiGUI is not a closed system. Other mod developers can register their custom containers and define their own customization options through the OptiGUI API. This means mods that add new blocks with GUIs — like custom storage solutions or machines — can also support resource pack-based GUI customization, expanding the ecosystem well beyond vanilla containers.
- Broad Container Coverage — OptiGUI supports customization for virtually every GUI screen in the game: chests, double chests, ender chests, shulker boxes, furnaces, blast furnaces, smokers, brewing stands, dispensers, hoppers, villager trading screens, enchanting tables, anvils, beacons, and more. Resource pack creators can target each container type individually, enabling themed builds where every interactive block matches your aesthetic vision.
- Multi-Language Support — OptiGUI ships with community-contributed translations including English, Traditional Chinese, Simplified Chinese, German, and Spanish. This attention to localization makes the mod accessible to a global audience and demonstrates the active community surrounding the project.
- OptiGUI 3 JSON Resources (Experimental) — For advanced resource pack creators, OptiGUI introduces a new JSON-based resource format that offers more granular control over GUI customization than the legacy OptiFine properties format. This forward-looking feature gives creators additional flexibility while maintaining backward compatibility with existing packs.
Screenshots
How to Install OptiGUI
- Download and install Fabric Loader or Quilt Loader for your Minecraft version. OptiGUI supports Minecraft 1.18 through 1.21.11.
- Download the OptiGUI .jar file matching your Minecraft version from the official Modrinth or CurseForge page.
- Place the OptiGUI .jar file into your
.minecraft/modsfolder. If the folder does not exist, launch the game once with your Fabric or Quilt profile to generate it. - Download any required dependencies (such as Fabric Language Kotlin) and place them in the same mods folder.
- Download and enable a supported custom GUI resource pack — for example, the Chest Boat GUI pack by the same author — then launch Minecraft and verify the custom GUI textures appear when opening containers.
Requirements & Compatibility
| Requirement | Details |
|---|---|
| Mod Loader | Fabric or Quilt |
| Minecraft Versions | 1.18 – 1.21.11 |
| Side | Client-side only |
| Dependencies | Fabric Language Kotlin (bundled or separate) |
| License | LGPL-3.0-or-later (open source) |
| Known Conflicts | Fabric Language Kotlin 1.13.5+ with OptiGUI 2.3.x prior to beta 8 |
What's New
- Fixed the
chest.largeselector, resolving issues where double chest GUI textures were not applied correctly by resource packs. - This beta release (2.3.0-beta.9) is recommended for both everyday users and modpack inclusion.
- Continued stability improvements building on the full Kotlin rewrite.
- Updated documentation available at the official OptiGUI docs site for resource pack creators and mod developers.
Pros and Cons
Pros
- Brings OptiFine custom GUI support to Fabric and Quilt without needing OptiFine installed
- Client-side only — works on any server with no server-side setup
- Kotlin rewrite delivers clean code and efficient texture loading
- Extensible API lets other mods add custom GUI customization support
- Actively maintained with support for the latest Minecraft versions
- Open source under LGPL-3.0, with strong community contributions
Cons
- No Forge or NeoForge support — strictly limited to Fabric and Quilt loaders
- Some OptiFine GUI resource packs may not work identically and require bug reports
- Current stable branch (2.3.x) is still in beta, though recommended for general use
- Requires Fabric Language Kotlin as a dependency, adding an extra download step
Alternatives to OptiGUI
- OptiFine — The original mod that introduced custom GUI textures for Minecraft, but it only works on the vanilla launcher and is incompatible with Fabric. If you do not use Fabric mods, OptiFine handles GUI customization along with shaders and performance optimizations.
- Continuity — A Fabric mod focused on connected textures and emissive textures from OptiFine resource packs. While it does not handle GUI customization, it pairs well with OptiGUI to cover more of OptiFine's feature set on Fabric.
- Entity Texture Features — Another Fabric mod that brings OptiFine's random and emissive entity texture support to Fabric and Quilt. Combined with OptiGUI and Continuity, you can replicate the majority of OptiFine's visual customization features.
Download OptiGUI
| Minecraft Version | Fabric | Quilt |
|---|---|---|
| For Minecraft 1.21.11 | Download | Download |
| For Minecraft 1.21.10 | Download | Download |
| For Minecraft 1.21.9 | Download | Download |
| For Minecraft 1.21.8 | Download | Download |
| For Minecraft 1.21.7 | Download | Download |
| For Minecraft 1.21.6 | Download | Download |
| For Minecraft 1.21.5 | Download | Download |
| For Minecraft 1.21.4 | Download | Download |
| For Minecraft 1.21.3 | Download | Download |
| For Minecraft 1.21.2 | Download | Download |
| For Minecraft 1.21.1 | Download | Download |
| For Minecraft 1.21 | Download | Download |
Always download mods from official sources to stay safe.
Frequently Asked Questions
Does OptiGUI work with OptiFine resource packs?
Yes — OptiGUI supports most OptiFine custom GUI resource packs out of the box. The mod was specifically designed to read OptiFine's properties file format for GUI textures, so packs that customize chest, furnace, villager, and other container screens should work without modification. If you find a pack that behaves differently than it does with OptiFine, the developer encourages filing a bug report on GitHub.
Can I use OptiGUI on a multiplayer server?
Yes — OptiGUI is a client-side only mod, so it works on any server without requiring the server to have it installed. Your custom GUI textures are rendered locally on your machine, and other players or the server will not be affected. This makes it safe to use on public servers, Realms, and private servers alike.
Is OptiGUI compatible with Sodium and Iris?
Yes — OptiGUI operates on GUI rendering, which is separate from the chunk rendering and shader systems that Sodium and Iris modify. Players commonly run OptiGUI alongside Sodium for performance and Iris for shaders without conflicts. This combination effectively replaces OptiFine on Fabric with better modularity.
Does OptiGUI work with Forge or NeoForge?
No — OptiGUI is built exclusively for Fabric and Quilt mod loaders. There is no Forge or NeoForge version available. If you play on Forge, OptiFine remains your primary option for custom GUI textures. For Fabric and Quilt users, OptiGUI is the recommended solution.
Will OptiGUI affect my game performance?
OptiGUI appears to be lightweight and should not noticeably impact performance for most players. The Kotlin rewrite was specifically aimed at improving efficiency and code cleanliness. Since the mod only activates when GUI screens are open — which is a fraction of total gameplay time — its resource usage during normal exploration and building is negligible.
