promotional bannermobile promotional banner

MasuGUI

Data-driven server-side GUI library with rich client rendering and automatic vanilla chest fallback for unmodded players.
Back to Files

masugui-1.1.0.jar

File namemasugui-1.1.0.jar
Uploader
MasuaryMasuary
Uploaded
Oct 6, 2026
Downloads
13
Size
493.7 KB
Mod Loaders
Forge
File ID
9080142
Type
R
Release
Supported game versions
  • 1.18.2

Curse Maven Snippet

Forge

implementation fg.deobf("curse.maven:masugui-1539733:9080142")

Learn more about Curse Maven

What's new

MasuGUI 1.1.0

A large update: new modern components, a much better vanilla chest version for players without the mod, and a rewritten in-game editor.

New components

  • Window with title, accent colour, header chips, back and close buttons. Sections inside a window become panes with dividers.
  • List rows with icons, status dots, switches and value columns. Lists keep their scroll position when the screen refreshes.
  • Sidebar for categories or pages with counts.
  • Card grid with icon, title, subtitle, badge, check mark, locked state and colour swatches.
  • Stepper (minus and plus, shift for bigger steps). Click the number to type a value.
  • Switch, Segmented choice, Key/value rows, Banner messages and a Status bar with key hints.
  • Modern button styles (primary, secondary, danger, accent, ghost), plus modern text fields and dropdowns.

Vanilla chest version (players without the mod)

  • The chest is sized to the content, with a title item at the top and back, page arrows and close along the bottom.
  • Every component turns into an item that explains itself on hover. Steppers, switches, choices and text input all work.
  • Long lists turn the page instead of cutting off, and clicks update the chest in place without moving the cursor.
  • Text input uses a real anvil without any level cost.

Older clients

  • Players on MasuGUI 1.0.x can still join and get the chest version of the new screens.
  • They also get one chat message per login with a link to update. Server owners can turn it off or change the text and link in config/masugui-common.toml.

JSON layouts and the in-game editor

  • Default layout files are tracked: unedited files follow mod updates automatically, and edited files are kept, with the new default saved next to them as .new-default. Old files are backed up instead of deleted.
  • Rewritten editor (/masugui editor <mod> <gui>): live preview with real server data, the chest version side by side, a problem list (unknown fields and actions, missing variables), undo/redo, and saving is blocked while there are errors.

Fixes

  • Screens larger than the game window shrink to fit, and clicks still land correctly.
  • Hidden or disabled buttons can no longer be clicked by a modified client.
  • Modded item names show correctly on clients without that mod's language files.
  • Lists no longer jump back to the top after a click.

For developers

  • New: JsonGui.retireGuis(modId, names...) moves the config folders of removed screens aside at server start.
  • New: Stepper.editValue / JSON submitAction, ListRow.withSwitch, Card.withSwatch.
  • Requires Forge 1.18.2 and Java 17.

This mod has no related projects