Unity UI

Unity UI Skills

BATCH-FIRST: Use ui_create_batch when creating 2+ UI elements.

Guardrails

Mode: Full-Auto required

DO NOT (common hallucinations):

• ui_create_canvas is the correct name — NOT ui_add_canvas
• ui_create_label does not exist → use ui_create_text
• ui_create_checkbox does not exist → use ui_create_toggle
• ui_set_color does not exist → use component_set_property on Image/Text component
• Do not confuse UGUI (this module) with UI Toolkit (uitoolkit module)

Routing:

• For UI Toolkit (UXML/USS) → use uitoolkit module
• For XR-compatible UI → use xr module's xr_setup_ui_canvas to convert Canvas to World Space
• For text updates → ui_set_text (this module)
• For layout arrangement → ui_layout_children, ui_align_selected, ui_distribute_selected

Skills Overview

Query/Utility Skills:

• ui_set_text - Update text content
• ui_find_all - Find UI elements
• ui_set_rect - Set RectTransform size/position
• ui_set_anchor - Set anchor preset
• ui_layout_children - Arrange children in layout
• ui_align_selected - Align selected elements
• ui_distribute_selected - Distribute selected elements
• ui_set_image - Set Image properties (type/fill/sprite)
• ui_add_layout_element - Add/configure LayoutElement
• ui_add_canvas_group - Add/configure CanvasGroup
• ui_add_mask - Add Mask or RectMask2D
• ui_add_outline - Add Shadow/Outline effect
• ui_configure_selectable - Configure Selectable colors/transition/navigation

Single-Object Skills

ui_create_canvas

Create a UI Canvas container.

ui_create_panel

Create a Panel container.

ui_create_button

Create a Button.

ui_create_text

Create a Text element.

ui_create_image

Create an Image element.

ui_create_inputfield

Create an InputField.

ui_create_slider

Create a Slider.

ui_create_toggle

Create a Toggle/Checkbox.

ui_set_text

Update text content.

ui_find_all

Find UI elements in scene.

ui_set_rect

Set RectTransform size, position, and padding.

ui_set_anchor

Set anchor preset for a UI element.

Presets: TopLeft, TopCenter, TopRight, MiddleLeft, MiddleCenter, MiddleRight, BottomLeft, BottomCenter, BottomRight, StretchHorizontal, StretchVertical, StretchAll

ui_layout_children

Arrange child UI elements in a layout.

Layout types: Vertical, Horizontal, Grid

ui_align_selected

Align selected UI elements.

Alignments: Left, Center, Right, Top, Middle, Bottom

ui_distribute_selected

Distribute selected UI elements evenly.

Batch Skill

ui_create_batch

Create multiple UI elements in one call.

Item properties: type (required), name, parent, text, width, height, x, y, r, g, b, a, etc.

Supported types: Button, Text, Image, Panel, Slider, Toggle, InputField, Dropdown, ScrollView, RawImage, Scrollbar

Returns: {success, totalItems, successCount, failCount, results: [{success, name, type, instanceId}]}

unity_skills.call_skill("ui_create_batch", items=[
    {"type": "Button", "name": "StartBtn", "parent": "MenuPanel", "text": "Start", "y": 60},
    {"type": "Button", "name": "OptionsBtn", "parent": "MenuPanel", "text": "Options", "y": 0},
    {"type": "Button", "name": "QuitBtn", "parent": "MenuPanel", "text": "Quit", "y": -60}
])

Example: Efficient Menu Creation

import unity_skills

# BAD: 5 API calls
unity_skills.call_skill("ui_create_canvas", name="MainMenu")
unity_skills.call_skill("ui_create_panel", name="MenuPanel", parent="MainMenu")
unity_skills.call_skill("ui_create_button", name="StartBtn", parent="MenuPanel", text="Start", y=60)
unity_skills.call_skill("ui_create_button", name="OptionsBtn", parent="MenuPanel", text="Options", y=0)
unity_skills.call_skill("ui_create_button", name="QuitBtn", parent="MenuPanel", text="Quit", y=-60)

# GOOD: 2 API calls
unity_skills.call_skill("ui_create_canvas", name="MainMenu")
unity_skills.call_skill("ui_create_batch", items=[
    {"type": "Panel", "name": "MenuPanel", "parent": "MainMenu", "width": 300, "height": 200},
    {"type": "Button", "name": "StartBtn", "parent": "MenuPanel", "text": "Start", "y": 60},
    {"type": "Button", "name": "OptionsBtn", "parent": "MenuPanel", "text": "Options", "y": 0},
    {"type": "Button", "name": "QuitBtn", "parent": "MenuPanel", "text": "Quit", "y": -60}
])

TextMeshPro Support

UI Skills auto-detect TextMeshPro:

• With TMP: Uses TextMeshProUGUI
• Without TMP: Falls back to legacy UnityEngine.UI.Text

Response includes usingTMP field to indicate which was used.

New Element Creation Skills

ui_create_dropdown

Create a Dropdown with options list and full Template/ScrollRect hierarchy.

ui_create_scrollview

Create a ScrollRect with Viewport, RectMask2D, and Content.

ui_create_rawimage

Create a RawImage element (for Texture2D/RenderTexture).

ui_create_scrollbar

Create a standalone Scrollbar.

Property Configuration Skills

ui_set_image

Set Image advanced properties (type, fill, sprite).

ui_add_layout_element

Add/configure LayoutElement constraints.

ui_add_canvas_group

Add/configure CanvasGroup (alpha, interactable, blocksRaycasts).

ui_add_mask

Add Mask (stencil-based) or RectMask2D (rect clipping).

ui_add_outline

Add Shadow or Outline visual effect.

ui_configure_selectable

Configure Selectable properties on Button/Toggle/Slider/etc.

Best Practices

1. Always create Canvas first
2. Use Panels to organize related elements
3. Use meaningful names for scripting access
4. Set parent for proper hierarchy
5. WorldSpace canvas for 3D UI (health bars, etc.)