gamedev-skills/awesome-gamedev-agent-skills / skills/disciplines/game-ui-ux
game-ui-ux
VerifiedEngine-neutral design rules for game HUDs and menus: anchors and containers, scaling, safe areas, gamepad focus, HUDs driven by events instead of polling, and accessibility minimums. Use for menus, health bars or inventory screens that break on ultrawide or phones. Pair with `godot-ui-control` or `roblox-ui`. Not for button juice (`game-feel`) or rebinding (`input-systems`).
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 asset
3. 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).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |