MasuGUI
Server owners and mod developers know the pain of building menus that look good but break the moment a player joins without the right client mod. MasuGUI solves that problem elegantly. This data-driven, server-side GUI library for Forge lets you define a menu once and have it render as a fully custom screen for players who have the mod, while everyone else sees a clean vanilla container with the same interactive elements.
It is a single JAR with one API and two visual experiences, which makes it a genuinely practical tool rather than just a technical curiosity.
What MasuGUI Actually Does
MasuGUI is a library mod, meaning it adds no content on its own. Instead, it gives other mods a framework for building rich interfaces. The routing logic is the heart of the design:
- Client has MasuGUI installed: opens a custom rendered screen with gradients, animations, scrolling, and more.
- Client does not have MasuGUI: opens a vanilla container such as a chest, hopper, anvil, or merchant with the same interactive elements.
That fallback is not a stripped-down afterthought. The mod supports 18 vanilla fallback container types, container slot redirects for real drag-and-drop inventory interaction, and a cursor item system for enhanced mode.
Supported Versions and Loader
Minecraft 1.18.2 on Forge
MasuGUI targets Minecraft 1.18.2 and requires Forge 40.3.11 or newer, along with Java 17. Quark is optional and only used at compile time for the inventory transfer protection mixin. Because this is a personal-use release, there is no official issue tracker or support channel, so check your environment before you commit to it in a live project.
If you want to try it without wrestling with manual file placement, the foxygame.net launcher handles the whole setup in a couple of clicks, and its add-on catalog makes grabbing MasuGUI painless for quick testing.
Highlights for Builders
The feature list is dense for a library of this size. There are 14 element types available, including Panel, Label, Button, TextField, ItemGrid, ItemDisplay, Divider, ProgressBar, Image, ScrollPanel, Checkbox, Slider, TabBar, Dropdown, and PlayerHead. Layouts are JSON-driven, stored in config/<modId>/gui/<name>/Enhanced.json and Fallback.json.
Hot-reload is a lifesaver during development. Running /masugui reload [modId] refreshes templates without a restart. Animations are equally flexible, with six easing functions, eight animated properties, and three play modes, all definable in JSON. Remote textures are supported too, so any texture field can accept a URL that is downloaded asynchronously and cached to disk.
How to Install MasuGUI
Installation is straightforward for a Forge mod:
- Install Forge 1.18.2 (build 40.3.11 or newer) for Minecraft.
- Drop the JAR into your
mods/folder. - Install it on both the server and clients for the best experience.
- Launch the game and run
/masugui testto explore six demo GUIs covering shops, settings, profiles, scrolling, merchants, and confirmations.
Clients without the mod will still connect and function, but they will see chest-based fallback GUIs instead of the enhanced renderer. When you download MasuGUI, remember that redistribution, decompilation, and rehosting are not permitted, though use in modpacks and on servers is allowed.
Developer Tools and Commands
Two approaches exist for defining a GUI. The Java builder API lets you chain calls like MasuGui.builder("my_gui").size(300, 200).add(...).open(player). JSON templates offer layout files with variables, data providers, and named action handlers. An in-game visual editor is available via /masugui editor <modId> <guiName> for operators, alongside /masugui fallback to preview chest rendering and /masugui status to check client detection.
For anyone maintaining a pack with multiple mods, the foxygame.net launcher also keeps version compatibility in check and auto-updates add-ons like MasuGUI so your test environment never drifts out of sync.
Final Thoughts
MasuGUI for Minecraft is a smart, focused library that respects the reality of mixed-client servers. The dual-rendering approach means no player is locked out of a menu, and developers get a powerful JSON workflow with hot-reload, animations, and remote textures. If you build interfaces for Forge 1.18.2, this is worth a look, provided you accept the personal-use terms and lack of support.