uloop-launch
uloop launch
Launch Unity Editor with the correct version for a project.
Usage
uloop launch [project-path] [options]
Parameters
| Parameter | Type | Description |
|---|---|---|
project-path |
string | Optional. Use only when the target Unity project is not in the current directory. |
-r, --restart |
boolean | Kill running Unity and restart |
-p, --platform <P> |
string | Build target (e.g., StandaloneOSX, Android, iOS) |
--max-depth <N> |
number | Search depth when project-path is omitted (default: 3, -1 for unlimited) |
-a, --add-unity-hub |
boolean | Add to Unity Hub only (does not launch) |
-f, --favorite |
boolean | Add to Unity Hub as favorite (does not launch) |
Examples
# 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
More from hatayama/unity-cli-loop
uloop-control-play-mode
Control Unity Editor play mode (play/stop/pause). Use when you need to: (1) Start play mode to test game behavior, (2) Stop play mode to return to edit mode, (3) Pause play mode for frame-by-frame inspection.
3uloop-record-input
Record keyboard and mouse input during PlayMode into a JSON file. Use when you need to: (1) Capture human gameplay input for later replay, (2) Record input sequences for E2E testing, (3) Save input for bug reproduction.
2uloop-hello-world
Sample hello world tool via uloop CLI. Use when you need to test the MCP tool system or see an example of custom tool implementation.
2find-orphaned-meta
Find and clean up orphaned .meta files in a Unity project. Use when you need to: (1) Find .meta files whose corresponding file or folder no longer exists, (2) Clean up Unity warnings about missing assets caused by stale .meta files, (3) Audit .meta hygiene after git operations like branch switches, merges, or file deletions. Also use proactively after deleting files or folders in a Unity project.
2simulate-mouse-demo
Run the SimulateMouse demo scenario on SimulateMouseDemoScene. Clicks buttons, long-presses, drags boxes, split-drags through waypoints, and operates the virtual pad. Use when the user asks to run the simulate-mouse demo, test mouse simulation, or exercise the demo scene.
2uloop-get-hierarchy
Get Unity scene hierarchy as a structured tree. Use when you need to: (1) Inspect scene structure and parent-child relationships, (2) Explore GameObjects and their components, (3) Get hierarchy from a specific root path or selected objects. Returns the scene's GameObject tree.
2