y3-ui-pipeline

Generate Y3 UI JSON files and simplified Lua query node trees.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/WindXRan/y3td --skill y3-ui-pipeline-windxran
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: y3-ui-pipeline
Source: https://github.com/WindXRan/y3td/tree/main/maps/EntryMap/.y3maker/skills/y3-ui-pipeline
Command: npx skills add https://github.com/WindXRan/y3td --skill y3-ui-pipeline-windxran

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When users request new Y3 interfaces (HUD, panels, menus, dialogs), producing correct UI layout files and an easy-to-query node structure is tedious and error-prone, especially because Lua needs a simplified, path-friendly node tree.

Core Features & Use Cases

  • Mandatory UI workflow enforcement: Ensures UI generation follows the required pipeline instead of calling sub-skills directly when UI creation is requested.
  • Two-stage output for Lua usability:
    • Generates UI JSON via y3-ui-generator, writing files under maps/EntryMap/ui/{PanelName}.json.
    • Builds UI node trees via gen_ui_tree.py, writing simplified ui_tree/{PanelName}_Tree.json for fast Lua queries (name/uid/type and hierarchy).
  • Use cases: building or updating hero selection screens, shops, skill bars, backpacks, settings screens, popups/dialogs, and general HUD panels—then writing Lua to locate nodes by dot-separated paths.

Quick Start

Ask your AI to generate a Hero selection UI panel, and then provide the Lua UI interaction paths based on the generated node tree.

Frequently Asked Questions about y3-ui-pipeline

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate Y3 UI JSON files and node trees for Lua integration?

To generate Y3 UI JSON files and node trees, you must run y3-ui-generator to output maps/EntryMap/ui/{PanelName}.json, then execute gen_ui_tree.py to produce ui_tree/{PanelName}_Tree.json for deterministic Lua lookups.

What is the best way to automate Y3 UI creation for HUD and panels?

Automating Y3 UI creation requires enforcing a mandatory two-stage pipeline that builds the UI layout JSON and a simplified path-friendly node tree, preventing manual file errors and enabling fast Lua queries by name, uid, or type.

Can I query Y3 UI nodes by name and type hierarchy in Lua?

You can query Y3 UI nodes by name, uid, and type hierarchy in Lua using the simplified node tree file generated by gen_ui_tree.py, which provides deterministic dot-separated paths for fast interface interactions.

Does the Y3 UI generation pipeline support different interface types like dialogs and shops?

The Y3 UI generation pipeline applies to all interface types including HUD panels, hero selection screens, shops, backpacks, settings, and dialogs, generating the required JSON layout and corresponding node trees for each.

Why do I need a simplified node tree for Y3 UI instead of just the JSON file?

You need a simplified node tree because Lua requires a path-friendly structure to perform deterministic UI lookups by name and uid, whereas the raw UI JSON file only defines the layout for the Y3 engine.

Do I need any dependencies to run the Y3 UI generator pipeline?

No external dependencies are required to run the Y3 UI generator pipeline; it executes the required y3-ui-generator and gen_ui_tree.py scripts directly to output the necessary JSON layout and tree files.