SuperAPI AI 工具集

unity-cli

编程与开发

查看项目

更新于 10-16 02:29

技能介绍

用途:通过命令行管理 Unity 编辑器与项目,并在编辑器已打开时实时驱动它——创建和修改 GameObject、编辑场景与资源、检查层级、运行任意 C#,而不必手工编辑场景或资源文件。

主要能力:unity status 确认已连接的编辑器(看状态 ready);unity command 列出编辑器暴露的命令,如 unity command editor_play 进入 Play 模式;支持 eval 运行任意 C#,例如 unity command eval --caller plugin --skill unity-cli 'new UnityEngine.GameObject("Joe");'。还包含项目、编辑器、构建、测试等命令,可用 unity commands --grep <pattern> 搜索命令与插件。

使用方式:先检查 which unity && unity --version,未安装则 macOS/Linux 用 curl -fsSL https://unity.com/install.sh | bash,Windows PowerShell 用 irm https://unity.com/install.ps1 | iex,然后开新 shell 并用 unity --version 验证。每次 unity command 调用应带 --caller plugin --skill <name>;多个编辑器运行时用 --project-path <path> 指定目标。需要项目安装 com.unity.pipeline 包(Unity 6.0+),可用 unity pipeline install 添加。

限制:项目有 C# 编译错误时编辑器进入 Safe Mode,Pipeline 包不加载,命令无法连接,需修复编译错误并重启 Unity。沙盒环境可能隐藏正在运行的编辑器,不能据此判定其未运行。验证游戏是否真正运行不能仅靠进入 Play 模式或截图,需按 playmode-verification-loop.md 的流程。使用前还建议用 unity self-update --check --format json 检查版本。