feat: add interactive HUD editor screen with drag-and-drop positioning

[dsnsgithub]

Summary

This PR introduces a new interactive HUD editor screen that allows users to visually arrange HUD elements instead of manually editing configuration values. The editor is opened with Right Shift (rebindable) or from Mod Menu, and provides real-time drag-and-drop positioning, scaling via scroll wheel, snapping to screen edges, center lines, and corner dock slots, and overlap prevention. The old placement settings (Orientation, the hidden Custom Position flag, and manual X/Y entry) are replaced by a single Position setting per element. Mod Menu is now an optional dependency.

Screenshots

Captured by the client gametest on Minecraft 26.2 (a real production client driven by simulated input).

The editor, opened with Right Shift or from Mod Menu — every enabled element outlined, the title and beveled Settings button in the center of the screen (where HUD elements are least likely to be placed), hints at the bottom:

Dragging the FPS element out of the top-left stack (cyan outline while dragging, element info at the bottom; Ping takes over the vacated slot):

Key Changes

• New HudEditorScreen class: A full-featured GUI screen implementing Lunar Client-style HUD editing with:

  • Live preview of all enabled HUD elements
  • Drag-and-drop positioning with visual feedback (outline colors change based on state)
  • Dropping an element near a corner docks it into that corner's stack (margin and stacking included, previewed live); edge and center-line snapping for free placement
  • Overlap prevention: a drag onto another element is rejected and the element stays where it last fit, and scroll-resizing cannot grow an element into a neighbour
  • Scroll wheel scaling (0.1× to 10.0×)
  • A centered, enlarged title and a beveled vanilla-style Settings button (classic button proportions) that opens the Cloth Config screen for the remaining options
  • Automatic config save on close (Escape key)

• Single Position setting replaces Orientation + Custom Position: each element has one Position value — top-left, top-right, bottom-left, bottom-right, or custom. It shows as a dropdown in the settings screen so an element can be reset to a corner; the raw Custom X/Y coordinates stay editor-managed and hidden. Old configs (both Orientation/Custom Position and the camelCase variants) migrate automatically, verified by a launch test with a planted legacy config.

• Mod Menu is now optional (depends → suggests): the editor is reachable via its keybinding and hosts the Settings button itself. The Cloth screen builder lives in SettingsScreenBuilder, separate from the ModMenu entrypoint class, so ModMenuApi is never classloaded unless Mod Menu is installed. Verified by launch-testing with Mod Menu removed from the runtime mods.

• Extracted HudLayout and HudRenderer utility classes: all positioning math and element drawing is shared between the in-game HUD and the editor, so the editor preview always matches the real HUD; BetterHUDGUI was refactored on top of them.

• Updated ModSettings/CustomText: placement is expressed by the single position value; Custom X/Y became doubles (0-100%) so dragging is smooth, and old integer config values still parse.

• Added keybinding: "Edit HUD Layout" (Right Shift) with proper category support across Minecraft versions.

• Added localization: language strings for the editor UI (title, hints, scale display, Settings button).

• Version-specific support: Added 1.21.9 variant to handle new MouseButtonEvent/KeyEvent input signatures while maintaining compatibility with earlier versions.

• Enhanced game tests: exerciseHudEditor() drives the real editor with simulated input — drags an element to a custom position, then drags it back into a corner to dock it — and asserts the config after each step.

Implementation Details

• The editor uses percentage-based positioning (0-100%) internally, which is resolution-independent and matches the config format
• Dock snapping targets each corner's anchor slot (the spot a docked element occupies, margin included); releasing there stores the corner as the element's Position
• The HUD skips rendering while the editor is open to avoid double-drawing elements
• When opened without a world behind it (from Mod Menu on the title screen), the editor uses a solid backdrop and shows placeholder text for elements with nothing to display
• All rendering code uses version-conditional compilation to support both GuiGraphics (pre-1.26) and GuiGraphicsExtractor (1.26+)

https://claude.ai/code/session_016M8Paub79s9he93GZUGemX

[github-actions]

The game launched and entered a survival singleplayer world with the HUD active, on every supported Minecraft version, for b939590. A ❌ means that version's launch test did not produce a screenshot — check its job. Title-screen screenshots and game logs are in the run artifacts.

1.21	1.21.1	1.21.2	1.21.3
1.21.4	1.21.5	1.21.6	1.21.7
1.21.8	1.21.9	1.21.10	1.21.11
26.1	26.1.1	26.1.2	26.2