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 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.
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 | ||||
| 22h ago | 1 |
## What's new
- Minecraft 26.3 support
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## What's new
- Minecraft 26.2 support
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## What's new
- Camel husk support
- Nautilus & zombie nautilus support
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## What's new
- Minecraft 26.1 support
- Camel husk support
- Nautilus & zombie nautilus support
## About this release
- Due to recent changes in Minecraft and Fabric, new bugs may have been introduced
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## What got fixed
chest.largeselector
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## What got fixed
chest.largeselector
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## What got fixed
chest.largeselector
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## What got fixed
chest.largeselector
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## What got fixed
chest.largeselector
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## What got fixed
chest.largeselector
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## What got fixed
chest.largeselector
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## What's new
- Copper chest support
## What got fixed
chest.largeselector
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## Fixes
- Fixed a crash when opening containers using Fabric Language Kotlin 1.13.5
- Lowered Fabric Loader version requirement
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## Fixes
- Fixed a crash when opening containers using Fabric Language Kotlin 1.13.5
- Lowered Fabric Loader version requirement
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## Fixes
- Fixed a crash when opening containers using Fabric Language Kotlin 1.13.5
- Lowered Fabric Loader version requirement
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## Fixes
- Fixed a crash when opening containers using Fabric Language Kotlin 1.13.5
- Lowered Fabric Loader version requirement
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## Fixes
- Fixed a crash when opening containers using Fabric Language Kotlin 1.13.5
- Lowered Fabric Loader version requirement
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## Fixes
- Fixed a crash when opening containers using Fabric Language Kotlin 1.13.5
- Lowered Fabric Loader version requirement
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## Fixes
- Fixed a crash when opening containers using Fabric Language Kotlin 1.13.5
- Lowered Fabric Loader version requirement
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## What's new
- Minecraft 1.21.9
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## Fixes
- Fixed a crash when opening containers using Fabric Language Kotlin 1.13.5
- Lowered Fabric Loader version requirement
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## What's new
- Minecraft 1.21.6
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
## What's new
- Minecraft 1.21.5
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
As per [#135 (comment)](https://github.com/opekope2/OptiGUI/issues/135#issuecomment-2683492837), Modrinth app is downloading the latest alpha version of OptiGUI, which is not recommended for everyday use.
This release is the same as OptiGUI 2.3.0-beta.6+1.21, only the version was bumped to make it the latest release.
As per [#135 (comment)](https://github.com/opekope2/OptiGUI/issues/135#issuecomment-2683492837), Modrinth app is downloading the latest alpha version of OptiGUI, which is not recommended for everyday use.
This release is the same as OptiGUI 2.3.0-beta.6+1.20, only the version was bumped to make it the latest release.
## ⚠️ IMPORTANT ⚠️
- This is an **alpha** release. **Not recommended** for everyday users. **Some features** may be **missing** or **broken**, or **may not work** on future versions of OptiGUI.
- OptiGUI INI** resources are **not yet supported** by OptiGUI 3
- OptiFine Properties** are **not yet supported** by OptiGUI 3
- OptiGUI 3 is licensed under the terms of GNU LGPL
## What's new
- OptiGUI JSON resources
- NBT support
- Multiple texture&sprite support on the same GUI screen
- Vanilla&modded
- OptiGUI Inspector (
F12) now generates a JSON resource instead of an INI resource - [Read the docs here](https://opekope2.dev/OptiGUI/JSON.html)
## Buf fixes & performance improvements
- Optimize filter evaluation
- Runs less frequently
- Smarter cache to reduce unnecessary computations
- Lunar Client should work (based on logs, tho they're the one doing Fabric entry points wrong)
## About this release
- Everyday users and modpacks should not update yet
- Recommended for resource pack creators to experiment with the new JSON resources ([feedback is appreciated on GitHub](https://github.com/opekope2/OptiGUI/issues/135))
- This is an alpha version; JSON resources created for a newer version of OptiGUI may fail to load on this version
## ⚠️ IMPORTANT ⚠️
- This is an **alpha** release. **Not recommended** for everyday users. **Some features** may be **missing** or **broken**, or **may not work** on future versions of OptiGUI.
- OptiGUI INI** resources are **not yet supported** by OptiGUI 3
- OptiFine Properties** are **not yet supported** by OptiGUI 3
- OptiGUI 3 is licensed under the terms of GNU LGPL
## What's new since 3.0.0-alpha.2
- Compatibility for modded item right-clicks (like Linked Storage)
## About this release
- Everyday users and modpacks should not update yet
- Recommended for resource pack creators to experiment with the new JSON resources ([feedback is appreciated on GitHub](https://github.com/opekope2/OptiGUI/issues/135))
- This is an alpha version; JSON resources created for a newer version of OptiGUI may fail to load on this version
## ⚠️ IMPORTANT ⚠️
- This is an **alpha** release. **Not recommended** for everyday users. **Some features** may be **missing** or **broken**, or **may not work** on future versions of OptiGUI.
- OptiGUI INI** resources are **not yet supported** by OptiGUI 3
- OptiFine Properties** are **not yet supported** by OptiGUI 3
- OptiGUI 3 is licensed under the terms of GNU LGPL
## What changed since 3.0.0-alpha.1
- Fixed a bug in OptiGUI JSON Resources
- When
ifwas omitted, the filter didn't load - When
matchwas omitted, the filter didn't change any textures
## About this release
- Everyday users and modpacks should not update yet
- Recommended for resource pack creators to experiment with the new JSON resources ([feedback is appreciated on GitHub](https://github.com/opekope2/OptiGUI/issues/135))
- This is an alpha version; JSON resources created for a newer version of OptiGUI may fail to load on this version
## ⚠️ IMPORTANT ⚠️
- This is an **alpha** release. **Not recommended** for everyday users. **Some features** may be **missing** or **broken**, or **may not work** on future versions of OptiGUI.
- OptiGUI INI** resources are **not yet supported** by OptiGUI 3
- OptiFine Properties** are **not yet supported** by OptiGUI 3
- OptiGUI 3 is licensed under the terms of GNU LGPL
## What's new
- OptiGUI JSON resources
- NBT support
- Multiple texture&sprite support on the same GUI screen
- Vanilla&modded
- OptiGUI Inspector (
F12) now generates a JSON resource instead of an INI resource - [Read the docs here](https://opekope2.dev/OptiGUI/JSON.html)
## Bug fixes & performance improvements
- Optimize filter evaluation
- Runs less frequently
- Smarter cache to reduce unnecessary computations
- Lunar Client *should* work (based on logs, tho they're the one doing Fabric entry points wrong)
## About this release
- Everyday users and modpacks should not update yet
- Recommended for resource pack creators to experiment with the new JSON resources ([feedback is appreciated on GitHub](https://github.com/opekope2/OptiGUI/issues/135))
- This is an alpha version; JSON resources created for a newer version of OptiGUI may fail to load on this version
## What's new
- Minecraft 1.21.4
## About this release
- Recommended for everyday users
- Recommended for modpacks
- [Check out the documentation](https://opekope2.dev/OptiGUI)!
