Back to mods
OptiGUI project artwork

CurseForge · Minecraft mod

OptiGUI

Blazing fast custom GUI textures on Fabric and Quilt with built-in OptiFine custom GUI resource pack support

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which OptiGUI release should I use?

Updated last month
Latest stable file OptiGUI 2.1.7
Game version 1.18.1, 1.19.3, 1.20.2
Loader Fabric, Quilt

OptiGUI 2.1.7 targets 1.18.1, 1.19.3, 1.20.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.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric, Quilt
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does OptiGUI 2.1.7 need?

OptiGUI 2.1.7. Change the file and its required mods may change too.

All 2 required mods have matching files

Install Fabric Language Kotlin, Fabric API first. We found matching files for this game-version and loader setup.

Animatica Optional for OptiGUI 2.1.7
optional
Matching file found Matched file: Animatica v0.6.1 for 1.20.4
Fabric Language Kotlin Needed by OptiGUI 2.1.7
required
Matching file found Matched file: Fabric Language Kotlin 1.13.13+kotlin.2.4.10
Fabric API Needed by OptiGUI 2.1.7
required
Matching file found Matched file: [1.20.1] Fabric API 0.92.11+1.20.1

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.1.7. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use OptiGUI 2.1.7. It targets 1.18.1, 1.19.3, 1.20.2 with Fabric, Quilt; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Fabric Language Kotlin, Fabric API first. We found matching files for this game-version and loader setup.

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

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside OptiGUI 2.1.7. It opens that exact file at the source.

About this project

What does OptiGUI add?

OptiGUI

GitHub Release
Modrinth Download
CurseForge Download
GitHub Repo stars
GitHub top language
Documentation
Buy me a coffee

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.

  1. Download and install Fabric loader or Quilt loader
  2. Download this mod to your mods folder
  3. Download the required dependencies to your mods folder as well
  4. Download and enable a supported resource pack (see below)

Supported languages

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)

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

62 available setups

Showing 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

50 of 50 releases match

Looking for an older file? The official CurseForge project page is in Resources.