AgentSkillsCN

uloop-launch

通过uloop CLI启动与编辑器版本相匹配的Unity项目。适用于以下场景:(1) 以正确的编辑器版本打开Unity项目;(2) 重启Unity以应用更改;(3) 在启动时切换构建目标。

SKILL.md
--- frontmatter
name: uloop-launch
description: "Launch Unity project with matching Editor version via uloop CLI. Use when you need to: (1) Open a Unity project with the correct Editor version, (2) Restart Unity to apply changes, (3) Switch build target when launching."

uloop launch

Launch Unity Editor with the correct version for a project.

Usage

bash
uloop launch [project-path] [options]

Parameters

ParameterTypeDescription
project-pathstringPath to Unity project (optional, searches current directory if omitted)
-r, --restartbooleanKill running Unity and restart
-p, --platform <P>stringBuild target (e.g., StandaloneOSX, Android, iOS)
--max-depth <N>numberSearch depth when project-path is omitted (default: 3, -1 for unlimited)
-a, --add-unity-hubbooleanAdd to Unity Hub only (does not launch)
-f, --favoritebooleanAdd to Unity Hub as favorite (does not launch)

Examples

bash
# Search for Unity project in current directory and launch
uloop launch

# Launch specific project
uloop launch /path/to/project

# Restart Unity (kill existing and relaunch)
uloop launch -r

# Launch with build target
uloop launch -p Android

# Add project to Unity Hub without launching
uloop launch -a

Output

  • Prints detected Unity version
  • Prints project path
  • If Unity is already running, focuses the existing window
  • If launching, opens Unity in background