A client side drop-in replacement for OptiFine custom GUIs

Client DecorationUtility

Createda year ago
Updated4 days ago

External resources

Project members



Technical information

Client side
Server side
Project ID


OptiGUI 2.0.0-beta.3 is planned to be the last beta before the full release. Please join in with testing, and report any bugs if found on GitHub. Thanks in advance!

A client side drop-in replacement for OptiFine custom GUIs. 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.

How to use it

  1. Download and install Fabric loader or Quilt loader
  2. Download this mod from your favorite service
  3. Download the required dependencies as well
  4. Put this mod in your mods folder

Resource pack docs

This mod supports a superset of OptiFine features, see documentation link above. Some of them are not supported by OptiFine, and are marked as such.

Supported resource packs

¹ 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

¹ Color shulker boxes, Ender chests and Villager Professions do not work. The resource pack does not include OptiFine-specific assets, and these features are not supported by OptiGUI. (Some mods (Colourful Containers) include assets for these features and work with OptiGUI)

² Barrel does not work, neither does it work with OptiFine. The resource pack does not specify it according to the format.


Use in a modpack?


OptiFine GUI animations?

Only with Animatica.

OptiFine colors (colors.properties)?

No, use Colormatic.

Configuration GUI/file?

Nothing to configure.



Supported loaders?

Fabric & Quilt. Anything else is not supported, those may or may not work.