GitHub release (latest by date including pre-releases) Modrinth Version CurseForge Download GitHub Repo stars GitHub top language Documentation Buy me a coffee

A client side mod to customize the texture of in-game GUIs 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

BisectHosting banner

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

Excluding vanilla resource packs (which don't container OptiFine or OptiGUI-specific files)

¹ 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.


Use in a modpack?


OptiFine GUI animations?

Only with Animatica.

OptiFine colors (colors.properties)?

No, use Colormatic.

Configuration GUI/file?

Nothing to configure.




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.

Supported loaders?

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