Loading...
Loading...
Use when an agent drives Unity 6.3 (6000.3) on a Mac for any task: batch mode and -executeMethod jobs, a running editor (the user's GUI editor or a headless one), the Unity CLI and com.unity.pipeline, MCP servers, the Test Framework, command-line builds; when a batch run fails silently, 'Scripts have compiler errors', a capture comes back black or pink, or a result must be proven with numbers and a frame; or when a Unity brief must go to the right scenario-unity-* specialist.
npx skill4agent add scenario-labs/skills scenario-unity-expertscripts/npx skills add scenario-labs/skills --skill <name>tests/code/unity-expert/run_all.sh --live --buildsarchive/tests/unity-expert/live_results.jsonlut_live.unity.prefab.assetAGENT_RESULTcom.unity.pipelineut_review.image_checks-buildTarget-activeBuildProfileeval-runTests-quitAnimatorControllerTerrainData| Channel | Use for | Cost (measured here) | Rules |
|---|---|---|---|
Batch job | anything when no editor holds the project | 6 to 13 s per job (editor boot included) | |
Resident headless editor + AgentKit bridge | many calls in a row | boot 5 to 20 s once, then 0.1 to 0.5 s per call | holds the project and a license seat; |
User's GUI editor + AgentKit bridge | the user has the project open | same code path as headless (not run: no GUI windows during tests) | the user may need to focus Unity once so it compiles AgentKit; never re-open the user's scene without asking; save what you change |
Unity CLI + | fastest live channel: 151 commands, Roslyn | eval 0.03 to 0.15 s after a 0.5 to 1.1 s first call | CLI 1.0.0-beta.11 (portable copy), package 0.7.0-exp.1 installed before the editor opens; blocked by Safe Mode, possibly by a sandbox |
| MCP | only | Unity's AI Assistant MCP server is deprecated ("Use the Unity CLI instead") | |
Test Framework | EditMode and PlayMode verdicts, content validation | about 14 s per platform | NUnit XML parsed; exit 2 when a test failed (observed) |
ut_live.channel(P)batchbridgepipelineblockedut_env.preflight(P)AgentJob.EchoEchookAgentAudit.AuditSceneAuditAssetsAgentCapture.SaveBookmarkreferences/writing-jobs.mdAgentProfile.PlayModeTimingsut_stat.budget_checkut_review.review_captureut_review.compareut_stat.compare_framesreferences/toolkit-map.md[verify]| Value | Relative to | Source |
|---|---|---|
| 16.67 / 33.33 ms | frame budget at 60 / 30 fps | profiling e-book |
| x 0.65 | mobile sustained budget (10.8 ms at 60, 21.7 at 30) | profiling and mobile e-books |
| 6 to 13 s | one batch job on this project, editor boot included | observed |
| about 14 s | one | observed |
| 60 s (12 s incremental), 114.7 MB | macOS Mono player build of the demo scene (universal) | observed |
| 259 s (25 s incremental), 12.2 MB | Web build (IL2CPP, Brotli) of the same scene | observed |
| 0.1 to 0.5 s / 0.03 to 0.15 s | live call through the AgentKit bridge / Pipeline | observed |
| 30 days | Personal license offline window ( | observed + Unity support FAQ |
| 10 s / 120 s | grace before | toolkit default |
okcompile_errors == []counts.error == 0failed == 0total > 0budget_checkgc_checkbuild_summaryimage_checksall_whiteall_blackuniformmagentareferences/routing-handoffs.mdbuild_targetLogAssert.Expect| Mistake | What it looks like | Fix |
|---|---|---|
| batch job on a project the GUI editor holds | refused, or a corrupted Library | |
| no XML, no verdict | |
captures or bakes with | empty frames, "no graphics device", no lightmaps | |
| switching platform or defines inside a job, or pinning the target only on the build | old target or defines; textures re-imported per stage | |
| nothing added, | explicit |
| the defaults never apply (empty list, not null) | |
sizing a build from BuildReport | gigabytes: IL2CPP's do-not-ship folder counted | |
| trusting "Access token is unavailable" as a license failure | false alarm | the refusal line is "No valid Unity Editor license found" |
| hand-editing scene YAML while an editor is open | change invisible or lost | live job, then |
| killing Unity by name | other agents' editors die | stop by PID only ( |
references/routing-handoffs.mdreferences/unity-6.3-traps.md_CLUSTER_LIGHT_LOOP_FORWARD_PLUSFindObjectsByType<T>(FindObjectsSortMode.None)Rigidbody.linearVelocitylinearDamping[SerializeField]Lightmapping.TryGetLightingSettingsSubsystemRegistrationExitingPlayMode-createProjectObject.DestroyOnDisableOnDisableOnDestroyIPreprocessBuildWithContext...WithReportEditorUserBuildSettingsLibrary/Client.Add/Applications/Unity/Hub/Editor/6000.3.21f1/Unity.app/Contents/MacOS/Unity.../6000.3.21f1/PlaybackEngines/ut_env.license_ok()references/live-channels.md<Product>_BurstDebugInformation_DoNotShipscripts/references/toolkit-map.mdimport sys; sys.path.insert(0, "<scenario-unity-expert>/scripts")ut_envbase_projectinstall_agentkitpreflightut_runrun_method(project, method, args=None, timeout=1800, graphics=False, quit=True, build_target=None, grace=None, result_grace=None)run_testsbuildscan_logut_liveevalut_reviewimage_checkscomparecontact_sheetreview_captureut_statbudget_checksummarize_csvcompare_framesbuild_summaryscripts/AgentKit/AgentJobListDictTryListListOrNullAgentCaptureAgentAuditAgentBuildAgentProfileAgentBridgeAgentJsonreferences/toolkit-map.mdreferences/writing-jobs.mdreferences/live-channels.mdcom.unity.pipelinereferences/unity-6.3-traps.mdreferences/routing-handoffs.mdreferences/procedures.mdreferences/gui-paths.mdreferences/sources.md