
OptiGUI | Custom GUI Textures With Resource Packs
OptiGUI is a client-side mod that gives chests, barrels, and shulker screens their own custom look, reading most GUI packs built for the legacy format.
If your resource pack folder is stuffed with packs that promise colored chests, dark-mode barrels, and animated neon containers, OptiGUI is the mod that actually makes those textures load. It is a client-side mod that customizes in-game GUI screen textures with resource packs, and it has been downloaded around 28 million times. The codebase was rewritten from scratch in Kotlin for cleaner code, better performance, and more features. Most importantly for pack hoarders, it reads the legacy custom GUI format that many popular packs were built around.
Custom GUI Textures With Resource Packs
OptiGUI lets resource packs replace the textures of in-game GUI screens. That covers container menus like chests, shulker boxes, villager screens, and droppers, depending on what each pack ships. The mod reads the legacy custom GUI pack format that texture authors have leaned on for years and converts those assets behind the scenes before applying them, so most packs built around it work as is.
The developer's compatibility list for the current 2.3.x line names Colourful Containers, its light and dark mode add-ons, Animated RGB GUI, NEON20 ANIMATED, Rybo's Enhanced GUI, Animated Fox Guis with a dark variant, and Recolourful Containers GUI + HUD. That list is explicitly not exhaustive. New Default+ sits in the partially supported column instead: its barrel skin doesn't apply, which the developer notes is also true when it runs on the mod those packs were originally written for, because the pack never declares barrel textures.
Animations take one companion, Animatica. With it installed, animated GUI textures run out of the box, no special pack syntax needed. Pack authors get extra room as well: a single pack can carry legacy assets and OptiGUI's own resources side by side, a hybrid pattern the official documentation recommends and popular packs already follow. If a pack misbehaves or renders differently than it did in the classic setup, the developer asks for a bug report so it can be fixed.
Performance Impact and Compatibility
The performance question has a short answer. The developer describes OptiGUI's impact as negligible, with the caveat that it varies a bit depending on which resource packs you use. Sodium players also get a plain yes on compatibility.
OptiGUI is strictly client-side: your game requires it, the server side is unsupported, and there is no server component to install. There is also no config screen and no settings file, because every scrap of behavior comes from the packs you enable. That quiet design is why the developer answers the modpack question with a plain yes.
Two things sit slightly outside OptiGUI's scope. The classic colors.properties color system is out of scope, so use Colormatic for custom colors. And reskinning the custom inventory textures a server can push is work in progress, which the developer tracks on GitHub. Compatibility layers and alternative clients get best-effort support, so an occasional rough edge is possible.
JSON Resources and the F12 Inspector
OptiGUI has iterated through three pack formats. Legacy-style properties came first, then the mod's own INI files, which arrived in an early 2.x beta and were deprecated later. JSON resources are the current frontier, and they arrived with the OptiGUI 3 alphas.
The JSON format is where the mod's flexibility shows. A resource declares its containers with one identifier or an array of identifiers, maps the original texture path to a replacement, and can optionally filter with if and match conditions that read NBT data. Because matching runs on identifiers and NBT, modded blocks, entities, and items work out of the box with no glue code.
OptiGUI 3 also ships an inspector. Open any GUI screen and press F12, the default binding, and the mod generates a starter JSON resource for that screen and copies it to your clipboard. The 2.3 line has a simpler version of that tool, and its recent beta dropped NBT dumps since NBT matching is an OptiGUI 3 feature. Unless you are actively experimenting with JSON resources, the developer's advice is to keep everyday play on the 2.3.x betas. Mod developers get a hook here too, since they can add support for custom containers and options, documented on the project's site.
How to Install OptiGUI
- Install Fabric Loader or Quilt Loader. Quilt works here because its loader runs Fabric mods. If loader setup is new to you, our Fabric install guide walks through the process step by step.
- Download OptiGUI from the official project page and move the jar file into your mods folder.
- Add the required dependencies listed on that page to the same folder. OptiGUI is written in Kotlin, so the Fabric Language Kotlin adapter belongs there too. One versioning gotcha: OptiGUI betas older than beta 8 conflict with recent Fabric Language Kotlin releases, so keep those versions aligned if the game refuses to start.
- Pick a supported resource pack from the lists earlier in this post and drop it into your resourcepacks folder. If a pack's page says it needs OptiFine for custom GUIs, OptiGUI usually covers those same assets.
- Enable the pack in the game's resource pack options, load into a world, and open a chest to confirm the skins are showing.
OptiGUI FAQ
Does OptiGUI need to be installed on the server?
No. OptiGUI is client-side only. The project marks the client side as required and the server side as unsupported, and because it only reskins screens your own game draws, other players don't need it.
Does OptiGUI affect performance?
Hardly at all. The developer calls the impact negligible, with a small variation depending on the packs you run. It also works with Sodium.
Is there a config file or settings menu for OptiGUI?
No. The developer's documented answer is "nothing to configure." Everything comes from the resource packs you enable.
Is OptiGUI still maintained?
Yes. The project is actively maintained, and the 2.3.x line was updated in November 2026 with a fix for a crash involving the Haul datapack. OptiGUI 3 continues in alpha for pack authors.
OptiGUI is the quiet kind of mod: it handles its one job while your resource packs take the credit. Start from our complete guide to installing Minecraft mods if the setup is new at all.
Compatibility & downloads

Showing 20 of 32 MC versions.
Discussion
No comments yet
Be the first to start the discussion.










