Game UI/UX
Make every HUD and menu work on a phone, an ultrawide monitor and a TV, with a mouse or only a gamepad. This skill decides layout, scaling, focus, screen flow and how UI listens to game state; the engine UI skill supplies nodes, components and styling.
When to use
- Building a HUD, a menu, an inventory or shop screen, or any overlay.
- Fixing UI that breaks at other resolutions, ignores safe areas, strands a gamepad user, or polls game state every frame.
- Structuring screen flow (title, game, pause, settings, confirm) as a stack.
Not this skill: widget APIs and themes (godot-ui-control, roblox-ui, Unity UGUI or UI
Toolkit through the Unity skills), visual juice (game-feel), conversation flow and choice
logic (dialogue-systems), rebinding screens' input logic (input-systems), UI art and icons
(create-game-assets).
Workflow
- Inspect the project's UI first: stretch or CanvasScaler settings, existing theme, fonts, the screen-switching code, and which input devices the game targets.
- Lay out with anchors and containers. Anchor to edges, corners or centre; let rows,
columns and grids place children. A hard-coded
(x, y)is correct at one resolution only. - Set one scaling policy for the whole UI: a reference resolution (usually 1920x1080) that
scales to fit, plus an aspect rule:
expandand anchor HUD corners outward (default), or letterbox when the design truly needs a fixed frame. - Inset critical UI to the safe area (health, timers, prompts); decorative art may bleed. Reapply on resize and orientation change.
- Make every screen gamepad-navigable: one control focused on open, neighbours fixed where the engine guesses wrong, a focus style distinct from hover, focus trapped inside modals.
- Model screens as a stack. Push for overlays, pop for back; only the top screen takes input, and the screen below gets its focus back.
- Drive the HUD from events. Subscribe to
health_changed,score_changed; set the initial value once on connect, because signals do not replay. - Verify with a runnable check, then on screens.
- Headless focus check: a script that opens each screen in turn and fails if
get_viewport().gui_get_focus_owner()(Godot) orEventSystem.current.currentSelectedGameObject(Unity) is null. - Size sweep: launch at 1280x720, 2560x1080 and 1080x2340 (Godot:
--resolution WxH; needs a display orxvfb-run, because the headless renderer draws nothing) and save a viewport screenshot at each. Inspect them for clipped or overlapping elements. - Ask the user to unplug the mouse, play through every menu with a gamepad and report any screen where nothing is selected or focus escapes.
- Headless focus check: a script that opens each screen in turn and fails if
Patterns
1. Anchors and containers
# Godot 4.7. Anchor the score to a corner; an HBoxContainer spaces the hearts.
func _ready() -> void:
$Score.set_anchors_preset(Control.PRESET_TOP_LEFT)
for i in lives:
$Hearts.add_child(make_heart())Unity UGUI: anchor the RectTransform to the corner and use a HorizontalLayoutGroup; set the
pivot to the same corner, or the element grows in every direction when its size changes.
2. Scaling settings
Godot 4.7 project.godot [display]:
window/stretch/mode="canvas_items" window/stretch/aspect="expand"
window/size/viewport_width=1920 window/size/viewport_height=1080
Unity 6.3 CanvasScaler: Scale With Screen Size, Reference Resolution 1920x1080,
Match Width Or Height = 0.5 (1.0 if the layout must never clip vertically)
Unity 6.3 UI Toolkit: the same three settings live on the PanelSettings asset3. Safe-area inset
# Godot 4.7. Only Android and iOS report a real safe area; elsewhere the margins come out ~0.
func _apply_safe_area() -> void:
var safe := Rect2(DisplayServer.get_display_safe_area()) # screen pixels
var win := Rect2(Rect2i(DisplayServer.window_get_position(), DisplayServer.window_get_size()))
var inner := safe.intersection(win)
var to_ui := get_viewport_rect().size / win.size # window pixels -> UI units under stretch
$Margin.add_theme_constant_override("margin_left", int((inner.position.x - win.position.x) * to_ui.x))
$Margin.add_theme_constant_override("margin_top", int((inner.position.y - win.position.y) * to_ui.y))
$Margin.add_theme_constant_override("margin_right", int((win.end.x - inner.end.x) * to_ui.x))
$Margin.add_theme_constant_override("margin_bottom", int((win.end.y - inner.end.y) * to_ui.y))Unity: read Screen.safeArea and set a panel's anchorMin/anchorMax to its corners divided
by Screen.width/Screen.height; recompute when the rect changes, not every frame.
4. Focus on open
# Godot 4.7. Focus something on open; fix neighbours only where the automatic guess is wrong.
func _on_screen_shown() -> void:
$PlayButton.grab_focus()
$PlayButton.focus_neighbor_bottom = $SettingsButton.get_path()
$SettingsButton.focus_neighbor_top = $PlayButton.get_path()Unity UGUI: EventSystem.current.SetSelectedGameObject(playButton) in OnEnable, with
Navigation set to Automatic or Explicit. UI Toolkit: call Focus() on the first element.
5. Event-driven HUD
# RIGHT: HUD reacts to a signal; it updates only when health actually changes.
func _ready() -> void:
player.health_changed.connect(_on_health_changed) # emitted by gameplay
_on_health_changed(player.hp, player.max_hp) # signals do not replay initial state
func _on_health_changed(current: int, max_health: int) -> void:
# ratio maps 0..1 to the bar's configured range (default value range is 0..100).
$HealthBar.ratio = clampf(float(current) / max_health, 0.0, 1.0) if max_health > 0 else 0.0
# WRONG: func _process(dt): $HealthBar.value = player.hp / player.max_hp # polls every frame,
# couples UI to the player's internals, and runs work even when nothing changed.Gotchas
- Nothing focused on open leaves a gamepad player stuck on the first menu. Every screen focuses one control when shown, and again when a screen above it closes.
- Focus escapes a modal. Showing a dialog and focusing its button does not stop neighbour
search from reaching buttons behind it. Disable focus and mouse on the screen below (Godot
4.5+:
focus_behavior_recursiveandmouse_behavior_recursive). set_process_input(false)does not disable a Godot menu: buttons receive GUI input, not_input. Use the recursive focus and mouse behaviours above.- Unity UGUI ignores the gamepad, or throws on start, after switching Active Input Handling to
the Input System: the scene still has a
StandaloneInputModule. Replace it withInputSystemUIInputModule. UI Toolkit reads the project-wide UI actions and needs no module. - Pixel-art UI at a fractional scale shimmers and blurs. Godot: set
window/stretch/scale_mode="integer"; Unity: pick a reference resolution that divides the target displays evenly and use a pixel-perfect canvas. - Text too small on a TV. Default text should be at least 26 px at 1080p on console and TV and 18 px at 1080p on PC, scalable to 200 % without losing content.
- Colour as the only signal (red equals danger) fails for colour-blind players. Add an icon, shape or label. Text that carries gameplay information needs at least 4.5:1 contrast.
- Hard-coded English sized to fit overflows in German (often about 30 % longer). Use string
tables (
tr(), Unity Localization) and containers that size to content. - Menu flow as booleans (
is_paused,in_settings,confirm_open) breaks on the third overlay. Use the screen stack. - Pause freezes the pause menu. Godot:
get_tree().paused = trueand the overlay'sprocess_mode = PROCESS_MODE_ALWAYS; Unity: menu animation must use unscaled time when pausing byTime.timeScale = 0. - Mouse movement clears gamepad focus. Let the mouse move the selection, but never leave the screen with nothing selected after the mouse stops.
References
references/layout-and-flow.md: read for per-engine stretch and scale settings, safe-area maths, the full focus-trap and screen-stack code, diegetic vs world-space UI, accessibility details and localization-ready layout.
Related skills
godot-ui-control,roblox-ui: engine widgets, themes and styling; load alongside this one.game-feel: button pops, transitions and HUD juice on top of this layout.dialogue-systems: conversation and choice logic inside this UI shell.input-systems: device switching and rebinding screens.
Version notes
Last verified: 2026-11-11.
- Text size: Xbox Accessibility Guideline 101 sets 26 px at 1080p (52 px at 4K) for console, 18 px at 1080p (36 px at 4K) for PC, and scaling to 200 % (https://learn.microsoft.com/en-us/xbox/accessibility/xbox-accessibility-guidelines/101).
- Contrast: Xbox Accessibility Guideline 102, 4.5:1 for text, 3:1 for large text and key visuals (https://learn.microsoft.com/en-us/xbox/accessibility/xbox-accessibility-guidelines/102).
- Godot 4.7:
Control.focus_behavior_recursive/mouse_behavior_recursive(added in 4.5),DisplayServer.get_display_safe_area(); stretch settings per https://docs.godotengine.org/en/4.7/tutorials/rendering/multiple_resolutions.html. - Unity 6.3 LTS with the Input System package (1.20.1 is the latest release, October 2026):
InputSystemUIInputModulereplacesStandaloneInputModule(https://docs.unity3d.com/Packages/com.unity.inputsystem@1.19/manual/UISupport.html; https://packages.unity.com/com.unity.inputsystem).