ScreenSpec

screenspec is a NeoForge library that turns a JSON screen definition into a working Minecraft Screen — no codegen, no hand-laid-out widgets.

Design your mod’s UI visually in the MC Screen Designer, export a ScreenSpec JSON, drop it in your mod’s resources, and open it in three lines of code:

ScreenSpec spec = ScreenSpecLoader.fromResource(rm, "your_modid", "settings_screen");
SpecScreen screen = new SpecScreen(Component.literal("Settings"), spec);
Minecraft.getInstance().setScreen(screen);

Wire up behavior with a fluent listener API — no subclassing required:

screen.on("save_btn",   (id, s, v) -> save())
      .on("volume",     (id, s, v) -> setVolume((Double) v))
      .on("hardcore",   (id, s, v) -> setHardcore((Boolean) v));

Features

• Buttons, toggle buttons (with radio groups), sliders, text inputs, labels, panels, and icons
• Live data bindings — push game state into widget text, enabled state, and visibility every frame
• Declarative action ids for reusable cross-screen event handling
• Custom widget types, panel textures, and icon resolvers via simple overrides

Targets: Minecraft 1.21.5 / NeoForge 21.5.x / Java 21