nccgs 2.1.1 → 3.0.0-rc.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +76 -235
- package/LICENSE +1 -1
- package/README.md +87 -206
- package/THIRD_PARTY_NOTICES.md +6 -34
- package/bin/nccgs.mjs +96 -0
- package/cli/doctor.mjs +82 -0
- package/cli/feedback.mjs +13 -0
- package/cli/install.mjs +111 -0
- package/cli/release.mjs +59 -0
- package/cli/run.mjs +35 -0
- package/cli/spawn.mjs +20 -0
- package/cli/uninstall.mjs +43 -0
- package/cli/update-check.mjs +66 -0
- package/docs/EVIDENCE-VERIFICATION.md +22 -0
- package/package.json +23 -30
- package/runtime/core/diag.mjs +43 -0
- package/runtime/core/feedback-policy.mjs +54 -0
- package/runtime/core/fs.mjs +80 -0
- package/runtime/core/job-object.mjs +73 -0
- package/runtime/core/modes.mjs +87 -0
- package/runtime/core/process-tree.mjs +109 -0
- package/runtime/core/project.mjs +113 -0
- package/runtime/core/snapshot.mjs +114 -0
- package/runtime/hooks/common.mjs +22 -0
- package/runtime/hooks/done-guard.mjs +15 -0
- package/runtime/hooks/guard-mcp.mjs +8 -0
- package/runtime/hooks/guard-shell.mjs +16 -0
- package/runtime/hooks/guard-write.mjs +25 -0
- package/runtime/hooks/session-log.mjs +7 -0
- package/runtime/hooks/session-start.mjs +40 -0
- package/runtime/hooks/unity-transport.mjs +12 -0
- package/runtime/modes.json +39 -0
- package/runtime/task/cost.mjs +103 -0
- package/runtime/task/criteria.mjs +128 -0
- package/runtime/task/feedback.mjs +136 -0
- package/runtime/task/ledger.mjs +109 -0
- package/runtime/task/plan.mjs +69 -0
- package/runtime/task/project.mjs +79 -0
- package/runtime/task/report.mjs +252 -0
- package/runtime/task/task.mjs +238 -0
- package/runtime/unity/assets.mjs +51 -0
- package/runtime/unity/playtest.mjs +145 -0
- package/runtime/unity/unity.mjs +350 -0
- package/scripts/check-job-object.mjs +18 -0
- package/scripts/sync-unity-skills.mjs +35 -119
- package/template/CLAUDE.md +39 -0
- package/template/agents/fast-fix.md +9 -0
- package/template/agents/implementer.md +19 -0
- package/template/agents/playtester.md +15 -0
- package/template/agents/reviewer.md +19 -0
- package/template/agents/scout.md +9 -0
- package/template/ponytail/README.md +8 -0
- package/{.claude/nccgs/packages → template}/ponytail/engineering.md +10 -0
- package/template/protocols/evidence.md +52 -0
- package/template/protocols/playtest.md +45 -0
- package/template/protocols/review.md +34 -0
- package/template/protocols/unity-cli-notes.md +56 -0
- package/template/settings.fragment.json +33 -0
- package/template/skills/art-bible/SKILL.md +19 -0
- package/template/skills/asset-spec/SKILL.md +19 -0
- package/template/skills/brainstorm/SKILL.md +17 -0
- package/template/skills/feedback/SKILL.md +16 -0
- package/template/skills/map-systems/SKILL.md +25 -0
- package/template/skills/playtest/SKILL.md +17 -0
- package/template/skills/status/SKILL.md +18 -0
- package/template/skills/test/SKILL.md +34 -0
- package/template/skills/unity-foundation/SKILL.md +17 -0
- package/template/skills/vertical-slice/SKILL.md +17 -0
- package/template/skills/work/SKILL.md +65 -0
- package/tools/feedback-worker/README.md +12 -0
- package/tools/feedback-worker/worker.js +39 -0
- package/tools/feedback-worker/wrangler.toml +12 -0
- package/unity-skills/2d-pixel-perfect/SKILL.md +208 -0
- package/unity-skills/2d-pixel-perfect/references/api-reference.md +81 -0
- package/unity-skills/2d-pixel-perfect/references/camera-setup-builtin.cs +40 -0
- package/unity-skills/2d-pixel-perfect/references/camera-setup-urp.cs +49 -0
- package/unity-skills/2d-pixel-perfect/references/pipeline-detection.cs +50 -0
- package/unity-skills/2d-pixel-perfect/references/sprite-settings.cs +37 -0
- package/unity-skills/asset-transformer-toolkit/SECURITY.md +15 -0
- package/unity-skills/asset-transformer-toolkit/SKILL.md +39 -0
- package/unity-skills/asset-transformer-toolkit/references/create-importer.md +121 -0
- package/unity-skills/asset-transformer-toolkit/references/lods.md +61 -0
- package/unity-skills/asset-transformer-toolkit/references/rule-api.md +154 -0
- package/unity-skills/asset-transformer-toolkit/references/ruleblock-api.md +37 -0
- package/unity-skills/asset-transformer-toolkit/references/ruleset-api.md +138 -0
- package/unity-skills/asset-transformer-toolkit/references/rulesets-and-actions.md +227 -0
- package/unity-skills/audio-setup-mixers/SECURITY.md +16 -0
- package/unity-skills/audio-setup-mixers/SKILL.md +127 -0
- package/unity-skills/audio-setup-mixers/references/api.md +162 -0
- package/unity-skills/build-gtk/SKILL.md +242 -0
- package/unity-skills/build-gtk/references/graph-api.md +324 -0
- package/unity-skills/build-gtk/references/pitfalls.md +86 -0
- package/unity-skills/build-gtk/references/runtime-and-visualization.md +196 -0
- package/unity-skills/build-gtk/references/state-machine-api.md +286 -0
- package/unity-skills/build-live-game/SKILL.md +255 -0
- package/{.claude/skills → unity-skills}/build-live-game/references/achievements.md +132 -154
- package/{.claude/skills → unity-skills}/build-live-game/references/apis.md +10 -19
- package/{.claude/skills → unity-skills}/build-live-game/references/authentication.md +14 -20
- package/{.claude/skills → unity-skills}/build-live-game/references/battlepass.md +269 -225
- package/unity-skills/build-live-game/references/blueprints-and-samples.md +75 -0
- package/unity-skills/build-live-game/references/cloud-code-cloudbehaviours.md +1111 -0
- package/unity-skills/build-live-game/references/cloud-code-modules.md +1276 -0
- package/unity-skills/build-live-game/references/cloud-code.md +58 -0
- package/{.claude/skills → unity-skills}/build-live-game/references/cloud-save.md +15 -25
- package/{.claude/skills → unity-skills}/build-live-game/references/deployment.md +33 -18
- package/{.claude/skills → unity-skills}/build-live-game/references/player-account.md +31 -23
- package/{.claude/skills → unity-skills}/build-live-game/references/tooling.md +0 -56
- package/unity-skills/build-live-game/references/ugs-cli.md +86 -0
- package/unity-skills/craft-game-floors/SECURITY.md +23 -0
- package/unity-skills/craft-game-floors/SKILL.md +134 -0
- package/unity-skills/craft-game-floors/references/art-direction.md +85 -0
- package/unity-skills/craft-game-floors/references/camera-rigs.md +51 -0
- package/unity-skills/craft-game-floors/references/character-motion.md +35 -0
- package/unity-skills/craft-game-floors/references/game-audio.md +47 -0
- package/unity-skills/craft-game-floors/references/game-feel.md +68 -0
- package/unity-skills/craft-game-floors/references/game-shell.md +45 -0
- package/unity-skills/craft-game-floors/references/live-floor.md +35 -0
- package/unity-skills/craft-game-floors/references/placeholder-assets.md +35 -0
- package/unity-skills/craft-game-floors/references/scene-lighting.md +52 -0
- package/unity-skills/craft-game-floors/references/toon-shading.md +34 -0
- package/unity-skills/craft-game-floors/references/vfx.md +40 -0
- package/unity-skills/craft-game-floors/references/visual-scorecard.md +43 -0
- package/unity-skills/create-2d-physics/SECURITY.md +16 -0
- package/unity-skills/create-2d-physics/SKILL.md +128 -0
- package/unity-skills/create-2d-physics/references/2d-physics-core.md +155 -0
- package/unity-skills/create-2d-physics/references/legacy-2d-physics.md +45 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/SKILL.md +12 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/references/hexagonalruletile.md +71 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/references/palette-create.md +38 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/references/ruletile-createempty.md +35 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/references/ruletile-createfromsegment.md +212 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/references/ruletile.md +90 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/scripts/CreatePaletteTemplate.cs +148 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/scripts/ManualWorkflowExample.cs +63 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/scripts/RuleTileGenerator.cs +61 -0
- package/unity-skills/create-tile-palette-or-rule-tiles/scripts/TilemapRuleTileCreateFromSegment.cs +225 -0
- package/unity-skills/generate-editor-search-query/SECURITY.md +17 -0
- package/unity-skills/generate-editor-search-query/SKILL.md +117 -0
- package/unity-skills/generate-editor-search-query/references/open-search-window.md +70 -0
- package/unity-skills/generate-editor-search-query/references/query-patterns.md +124 -0
- package/{.claude/skills → unity-skills}/implement-in-app-purchases/SKILL.md +1 -2
- package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/api-notes.md +25 -28
- package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-convert-native-google-billing.md +1 -1
- package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-implement-iap-d2c.md +40 -5
- package/{.claude/skills → unity-skills}/initialize-ai-navigation/SKILL.md +4 -4
- package/{.claude/skills → unity-skills}/initialize-ai-navigation/references/navigation-system.md +3 -3
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/CHANGELOG.md +12 -0
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/README.md +9 -5
- package/unity-skills/levelplay-unity-integration/SKILL.md +442 -0
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/banner-api.md +15 -8
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/best-practices.md +604 -536
- package/unity-skills/levelplay-unity-integration/references/dependency-resolution.md +94 -0
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/ilrd-api.md +2 -2
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/initialization-api.md +221 -0
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/interstitial-api.md +11 -3
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/ios-setup.md +6 -34
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/migration-sdk-9.md +1 -1
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/privacy-settings.md +14 -29
- package/{.claude/skills → unity-skills}/levelplay-unity-integration/references/rewarded-api.md +20 -4
- package/unity-skills/levelplay-unity-integration/references/testing-and-validation.md +222 -0
- package/unity-skills/levelplay-unity-integration/references/troubleshooting.md +99 -0
- package/unity-skills/localization/SKILL.md +347 -0
- package/{.claude/skills → unity-skills}/localization/references/api-notes.md +4 -0
- package/unity-skills/localization/resources/L10nBatchProcessor.cs +191 -0
- package/unity-skills/manage-sprite-atlas/SKILL.md +351 -0
- package/unity-skills/manage-sprite-atlas/references/addressables-delivery.md +58 -0
- package/unity-skills/manage-sprite-atlas/references/api.md +382 -0
- package/unity-skills/manage-sprite-atlas/references/best-practices.md +183 -0
- package/unity-skills/manage-sprite-atlas/references/common-errors.md +123 -0
- package/unity-skills/manage-sprite-atlas/references/custom-packing.md +147 -0
- package/unity-skills/manage-sprite-atlas/references/manual-authoring.md +39 -0
- package/unity-skills/manage-sprite-atlas/resources/authoringvsruntime.cs +176 -0
- package/unity-skills/manage-sprite-atlas/resources/buildaddressablespostprocess.cs +59 -0
- package/unity-skills/manage-sprite-atlas/resources/cacheloadedatlases.cs +145 -0
- package/unity-skills/manage-sprite-atlas/resources/cleanupbatchoperations.cs +119 -0
- package/unity-skills/manage-sprite-atlas/resources/createandconfiguremasteratlas.cs +57 -0
- package/unity-skills/manage-sprite-atlas/resources/custompackersetup.cs +88 -0
- package/unity-skills/manage-sprite-atlas/resources/deprecatedmethods.cs +142 -0
- package/unity-skills/manage-sprite-atlas/resources/dontmodifywithoutsaving.cs +120 -0
- package/unity-skills/manage-sprite-atlas/resources/dontpackinruntimebuilds.cs +190 -0
- package/unity-skills/manage-sprite-atlas/resources/dontscriptspriteatlasineditor.cs +114 -0
- package/unity-skills/manage-sprite-atlas/resources/editorconfiguration.cs +95 -0
- package/unity-skills/manage-sprite-atlas/resources/enablespritepacking.cs +172 -0
- package/unity-skills/manage-sprite-atlas/resources/gridspritepacker.cs +50 -0
- package/unity-skills/manage-sprite-atlas/resources/handlelatebinding.cs +147 -0
- package/unity-skills/manage-sprite-atlas/resources/handlenullcases.cs +141 -0
- package/unity-skills/manage-sprite-atlas/resources/migratev1tov2.cs +335 -0
- package/unity-skills/manage-sprite-atlas/resources/multipagepacker.cs +80 -0
- package/unity-skills/manage-sprite-atlas/resources/optimizetexturesettings.cs +191 -0
- package/unity-skills/manage-sprite-atlas/resources/packerdebugging.cs +158 -0
- package/unity-skills/manage-sprite-atlas/resources/packtransform.cs +51 -0
- package/unity-skills/manage-sprite-atlas/resources/platformnames.cs +127 -0
- package/unity-skills/manage-sprite-atlas/resources/queryspritesefficiently.cs +222 -0
- package/unity-skills/manage-sprite-atlas/resources/registercallbacks.cs +152 -0
- package/unity-skills/manage-sprite-atlas/resources/runtimeatlasloader.cs +15 -0
- package/unity-skills/manage-sprite-atlas/resources/runtimespriteaccess.cs +19 -0
- package/unity-skills/manage-sprite-atlas/resources/savespriteatlasasset.cs +107 -0
- package/unity-skills/manage-sprite-atlas/resources/scriptablepacker.cs +81 -0
- package/unity-skills/manage-sprite-atlas/resources/setincludeinbuild.cs +164 -0
- package/unity-skills/manage-sprite-atlas/resources/sizeoptimizedpacker.cs +88 -0
- package/unity-skills/manage-sprite-atlas/resources/spriteatlaslatebinding.cs +123 -0
- package/unity-skills/manage-sprite-atlas/resources/spriteatlasprebuildgenerator.cs +219 -0
- package/unity-skills/manage-sprite-atlas/resources/spritedata.cs +35 -0
- package/unity-skills/manage-sprite-atlas/resources/spritepack.cs +39 -0
- package/unity-skills/manage-sprite-atlas/resources/texturedata.cs +15 -0
- package/unity-skills/manage-sprite-atlas/resources/updatebuildscripts.cs +357 -0
- package/unity-skills/manage-sprite-atlas/resources/updatesettingsconfiguration.cs +135 -0
- package/unity-skills/manage-sprite-atlas/resources/usevariantswisely.cs +179 -0
- package/unity-skills/manage-sprite-atlas/resources/variantatlas.cs +39 -0
- package/unity-skills/manifest.json +1155 -0
- package/unity-skills/migrate-birp-to-urp/SECURITY.md +16 -0
- package/unity-skills/migrate-birp-to-urp/SKILL.md +543 -0
- package/unity-skills/migrate-birp-to-urp/references/capturing-the-editor.md +66 -0
- package/unity-skills/migrate-birp-to-urp/references/complex-shader-situations.md +272 -0
- package/unity-skills/migrate-birp-to-urp/references/custom-shader-triage.md +123 -0
- package/unity-skills/migrate-birp-to-urp/references/implementation-patterns.md +529 -0
- package/unity-skills/migrate-birp-to-urp/references/migration-workflow.md +265 -0
- package/unity-skills/migrate-birp-to-urp/references/quality-settings-map.md +69 -0
- package/unity-skills/new-unity-project/SECURITY.md +26 -0
- package/unity-skills/new-unity-project/SKILL.md +386 -0
- package/unity-skills/new-unity-project/references/skill-setup.md +66 -0
- package/unity-skills/optimize-audio/SECURITY.md +16 -0
- package/{.claude/skills → unity-skills}/optimize-audio/SKILL.md +17 -17
- package/{.claude/skills → unity-skills}/optimize-audio/resources/audio-import-api.md +8 -5
- package/{.claude/skills → unity-skills}/optimize-text-mesh-pro/SKILL.md +1 -11
- package/unity-skills/optimize-web/SECURITY.md +16 -0
- package/{.claude/skills → unity-skills}/optimize-web/SKILL.md +164 -27
- package/unity-skills/optimize-web/scripts/WebOptimizer.cs +46 -0
- package/unity-skills/optimize-web/scripts/toktx-examples.sh +11 -0
- package/{.claude/skills → unity-skills}/physics-3d-collision/SKILL.md +2 -2
- package/unity-skills/physics-3d-collision/references/troubleshooting.md +8 -0
- package/unity-skills/project-auditor-fixes/SKILL.md +64 -0
- package/{.claude/skills → unity-skills}/setup-multiplayer-services/SKILL.md +1 -4
- package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/SKILL.md +1 -1
- package/{.claude/skills → unity-skills}/shader-graph-create-custom-node/SKILL.md +1 -1
- package/unity-skills/sprite-editor/SECURITY.md +16 -0
- package/{.claude/skills → unity-skills}/sprite-editor/SKILL.md +9 -9
- package/{.claude/skills → unity-skills}/sprite-editor/references/templates.md +1 -1
- package/unity-skills/sprite-segment-3x3grid/SKILL.md +136 -0
- package/unity-skills/sprite-segment-3x3grid/scripts/SpriteGridAnalysis.cs +119 -0
- package/{.claude/skills → unity-skills}/ui/SKILL.md +1 -1
- package/{.claude/skills → unity-skills}/ui-imgui/SKILL.md +1 -7
- package/{.claude/skills → unity-skills}/ui-ugui/SKILL.md +3 -9
- package/{.claude/skills → unity-skills}/ui-uitk/SKILL.md +8 -14
- package/{.claude/skills → unity-skills}/ui-uitk/references/custom-elements.md +1 -1
- package/unity-skills/unity-cli/CHANGELOG.md +515 -0
- package/unity-skills/unity-cli/SECURITY.md +68 -0
- package/unity-skills/unity-cli/SKILL.md +723 -0
- package/unity-skills/unity-cli/references/auth-license-cloud.md +318 -0
- package/unity-skills/unity-cli/references/build-run-test.md +555 -0
- package/unity-skills/unity-cli/references/cloud-automation.md +736 -0
- package/{.claude/skills → unity-skills}/unity-cli/references/collaboration.md +166 -105
- package/unity-skills/unity-cli/references/config-hub.md +239 -0
- package/unity-skills/unity-cli/references/diagnostics-maintenance.md +720 -0
- package/unity-skills/unity-cli/references/docs-workflow.md +179 -0
- package/unity-skills/unity-cli/references/editors-install.md +476 -0
- package/unity-skills/unity-cli/references/integration-advanced.md +1130 -0
- package/unity-skills/unity-cli/references/playmode-verification-loop.md +279 -0
- package/unity-skills/unity-cli/references/projects-templates.md +996 -0
- package/unity-skills/unity-cli/references/version-control.md +612 -0
- package/{.claude/skills → unity-skills}/unity-package-management/SKILL.md +60 -12
- package/{.claude/skills → unity-skills}/unity-package-management/references/select-packages.md +39 -21
- package/unity-skills/unity-pipeline/SECURITY.md +17 -0
- package/unity-skills/unity-pipeline/SKILL.md +335 -0
- package/unity-skills/urp-postprocessing/SECURITY.md +16 -0
- package/{.claude/skills → unity-skills}/urp-postprocessing/SKILL.md +12 -12
- package/{.claude/skills → unity-skills}/urp-postprocessing/references/code-templates.md +39 -8
- package/{.claude/skills → unity-skills}/validate-urp-render-graph-renderer-feature/SKILL.md +1 -1
- package/.claude/agents/nccgs-adversarial-reviewer.md +0 -43
- package/.claude/agents/nccgs-engine-programmer.md +0 -27
- package/.claude/agents/nccgs-fast-implementer.md +0 -30
- package/.claude/agents/nccgs-game-designer.md +0 -26
- package/.claude/agents/nccgs-gameplay-programmer.md +0 -26
- package/.claude/agents/nccgs-qa-engineer.md +0 -27
- package/.claude/agents/nccgs-task-scout.md +0 -24
- package/.claude/agents/nccgs-ui-programmer.md +0 -27
- package/.claude/agents/nccgs-unity-build-specialist.md +0 -27
- package/.claude/agents/nccgs-unity-implementer.md +0 -28
- package/.claude/agents/nccgs-unity-systems-specialist.md +0 -27
- package/.claude/agents/nccgs-unity-ui-specialist.md +0 -27
- package/.claude/agents/nccgs-verification-engineer.md +0 -27
- package/.claude/nccgs/MEMORY.md +0 -66
- package/.claude/nccgs/THIRD_PARTY_NOTICES.md +0 -29
- package/.claude/nccgs/VERSION +0 -1
- package/.claude/nccgs/agent-library/nccgs-accessibility-specialist.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-adversarial-reviewer.md +0 -41
- package/.claude/nccgs/agent-library/nccgs-ai-programmer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-analytics-engineer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-art-direction-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-audio-direction-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-creative-director.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-documentation-manager.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-economy-designer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-engine-programmer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-fast-implementer.md +0 -28
- package/.claude/nccgs/agent-library/nccgs-game-design-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-game-designer.md +0 -24
- package/.claude/nccgs/agent-library/nccgs-gameplay-programmer.md +0 -24
- package/.claude/nccgs/agent-library/nccgs-level-designer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-live-ops-designer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-localization-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-narrative-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-network-programmer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-performance-analyst.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-producer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-production-coordinator.md +0 -22
- package/.claude/nccgs/agent-library/nccgs-programming-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-prototyper.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-qa-engineer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-qa-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-release-engineer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-release-lead.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-security-engineer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-sound-designer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-systems-designer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-task-scout.md +0 -22
- package/.claude/nccgs/agent-library/nccgs-technical-architect.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-technical-artist.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-technical-director.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-tools-programmer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-ui-programmer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-unity-build-specialist.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-unity-content-specialist.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-unity-implementer.md +0 -26
- package/.claude/nccgs/agent-library/nccgs-unity-rendering-specialist.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-unity-systems-specialist.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-unity-ui-specialist.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-ux-designer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-verification-engineer.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-world-builder.md +0 -25
- package/.claude/nccgs/agent-library/nccgs-writer.md +0 -25
- package/.claude/nccgs/constitution.md +0 -187
- package/.claude/nccgs/hooks/agent-audit.mjs +0 -16
- package/.claude/nccgs/hooks/closure-guard.mjs +0 -59
- package/.claude/nccgs/hooks/common.mjs +0 -42
- package/.claude/nccgs/hooks/post-compact.mjs +0 -1
- package/.claude/nccgs/hooks/pre-compact.mjs +0 -8
- package/.claude/nccgs/hooks/protect-git.mjs +0 -22
- package/.claude/nccgs/hooks/protect-write.mjs +0 -17
- package/.claude/nccgs/hooks/runtime-observation.mjs +0 -11
- package/.claude/nccgs/hooks/session-start.mjs +0 -29
- package/.claude/nccgs/hooks/session-stop.mjs +0 -7
- package/.claude/nccgs/hooks/unity-transport-guard.mjs +0 -11
- package/.claude/nccgs/packages/ponytail/README.md +0 -46
- package/.claude/nccgs/packages/ponytail/manifest.json +0 -24
- package/.claude/nccgs/pipeline.json +0 -260
- package/.claude/nccgs/protocols/agent-contract.md +0 -101
- package/.claude/nccgs/protocols/astra-claude.md +0 -111
- package/.claude/nccgs/protocols/bounded-repair.md +0 -246
- package/.claude/nccgs/protocols/context-packets.md +0 -23
- package/.claude/nccgs/protocols/delivery-acceptance.md +0 -105
- package/.claude/nccgs/protocols/design-lifecycle.md +0 -139
- package/.claude/nccgs/protocols/editor-session-evidence.md +0 -52
- package/.claude/nccgs/protocols/evidence.md +0 -31
- package/.claude/nccgs/protocols/model-routing.md +0 -46
- package/.claude/nccgs/protocols/orchestration.md +0 -74
- package/.claude/nccgs/protocols/review-handoff.md +0 -101
- package/.claude/nccgs/protocols/shared-workflow-context.md +0 -33
- package/.claude/nccgs/protocols/standalone-gates.md +0 -329
- package/.claude/nccgs/protocols/standalone-pilot.md +0 -144
- package/.claude/nccgs/protocols/standalone.md +0 -207
- package/.claude/nccgs/protocols/task-autonomy.md +0 -55
- package/.claude/nccgs/protocols/task-gates.md +0 -144
- package/.claude/nccgs/protocols/task-slices.md +0 -106
- package/.claude/nccgs/protocols/unity-boundary.md +0 -31
- package/.claude/nccgs/routing.generated.md +0 -49
- package/.claude/nccgs/settings.fragment.json +0 -213
- package/.claude/nccgs/studio.json +0 -472
- package/.claude/nccgs/tools/approve-overrides.mjs +0 -81
- package/.claude/nccgs/tools/autonomy.mjs +0 -40
- package/.claude/nccgs/tools/command-process.mjs +0 -50
- package/.claude/nccgs/tools/command-tokens.mjs +0 -22
- package/.claude/nccgs/tools/compile-policy.mjs +0 -121
- package/.claude/nccgs/tools/configure-models.mjs +0 -96
- package/.claude/nccgs/tools/criteria.mjs +0 -121
- package/.claude/nccgs/tools/delivery-budget.mjs +0 -52
- package/.claude/nccgs/tools/design-readiness.mjs +0 -158
- package/.claude/nccgs/tools/editor-session-evidence.mjs +0 -66
- package/.claude/nccgs/tools/evidence.mjs +0 -153
- package/.claude/nccgs/tools/gates.mjs +0 -297
- package/.claude/nccgs/tools/handoff.mjs +0 -51
- package/.claude/nccgs/tools/hook-transport.mjs +0 -34
- package/.claude/nccgs/tools/inputs.mjs +0 -108
- package/.claude/nccgs/tools/installation-guard.mjs +0 -55
- package/.claude/nccgs/tools/integrity.mjs +0 -69
- package/.claude/nccgs/tools/lifecycle.mjs +0 -542
- package/.claude/nccgs/tools/native-completion.mjs +0 -30
- package/.claude/nccgs/tools/orchestration.mjs +0 -680
- package/.claude/nccgs/tools/paths.mjs +0 -60
- package/.claude/nccgs/tools/policy.mjs +0 -107
- package/.claude/nccgs/tools/process-lock.mjs +0 -74
- package/.claude/nccgs/tools/repair-packet.mjs +0 -106
- package/.claude/nccgs/tools/returned-handoff.mjs +0 -47
- package/.claude/nccgs/tools/review-budget.mjs +0 -171
- package/.claude/nccgs/tools/review-handoff.mjs +0 -66
- package/.claude/nccgs/tools/runtime.mjs +0 -71
- package/.claude/nccgs/tools/session-budget.mjs +0 -67
- package/.claude/nccgs/tools/shared-context-guard.mjs +0 -60
- package/.claude/nccgs/tools/shared-context.mjs +0 -25
- package/.claude/nccgs/tools/task-slices.mjs +0 -147
- package/.claude/nccgs/tools/task.mjs +0 -145
- package/.claude/nccgs/tools/tool-guard.mjs +0 -120
- package/.claude/nccgs/tools/unity-repair.mjs +0 -128
- package/.claude/nccgs/tools/unity-transport.mjs +0 -170
- package/.claude/nccgs/tools/verification-jobs.mjs +0 -171
- package/.claude/nccgs/tools/verification-worker.mjs +0 -71
- package/.claude/nccgs/tools/windows-compiler-server.cs +0 -163
- package/.claude/nccgs/tools/windows-job.cs +0 -103
- package/.claude/nccgs/unity-skills-manifest.json +0 -727
- package/.claude/nccgs/workflow-catalog.json +0 -654
- package/.claude/rules/nccgs-canonical-docs.md +0 -19
- package/.claude/rules/nccgs-editor-tools.md +0 -12
- package/.claude/rules/nccgs-localization.md +0 -12
- package/.claude/rules/nccgs-networking.md +0 -13
- package/.claude/rules/nccgs-performance.md +0 -14
- package/.claude/rules/nccgs-rendering.md +0 -16
- package/.claude/rules/nccgs-security.md +0 -13
- package/.claude/rules/nccgs-tests.md +0 -18
- package/.claude/rules/nccgs-ui.md +0 -14
- package/.claude/rules/nccgs-unity-assets.md +0 -21
- package/.claude/rules/nccgs-unity-code.md +0 -22
- package/.claude/skills/accessibility-review/SKILL.md +0 -22
- package/.claude/skills/accessibility-review/references/astra.md +0 -17
- package/.claude/skills/accessibility-review/references/legacy.md +0 -7
- package/.claude/skills/architecture-decision/SKILL.md +0 -22
- package/.claude/skills/architecture-decision/references/astra.md +0 -12
- package/.claude/skills/architecture-decision/references/legacy.md +0 -7
- package/.claude/skills/asset-audit/SKILL.md +0 -22
- package/.claude/skills/asset-audit/references/astra.md +0 -17
- package/.claude/skills/asset-audit/references/legacy.md +0 -7
- package/.claude/skills/audit/SKILL.md +0 -22
- package/.claude/skills/audit/references/astra.md +0 -17
- package/.claude/skills/audit/references/dimensions.md +0 -46
- package/.claude/skills/audit/references/legacy.md +0 -9
- package/.claude/skills/balance-review/SKILL.md +0 -22
- package/.claude/skills/balance-review/references/astra.md +0 -17
- package/.claude/skills/balance-review/references/legacy.md +0 -7
- package/.claude/skills/bug-triage/SKILL.md +0 -22
- package/.claude/skills/bug-triage/references/astra.md +0 -27
- package/.claude/skills/bug-triage/references/legacy.md +0 -7
- package/.claude/skills/build-live-game/SKILL.md +0 -317
- package/.claude/skills/build-live-game/references/cloud-code.md +0 -563
- package/.claude/skills/closure/SKILL.md +0 -22
- package/.claude/skills/closure/references/astra.md +0 -15
- package/.claude/skills/closure/references/legacy.md +0 -7
- package/.claude/skills/compatibility-review/SKILL.md +0 -22
- package/.claude/skills/compatibility-review/references/astra.md +0 -17
- package/.claude/skills/compatibility-review/references/legacy.md +0 -7
- package/.claude/skills/context-pack/SKILL.md +0 -22
- package/.claude/skills/context-pack/references/astra.md +0 -12
- package/.claude/skills/context-pack/references/legacy.md +0 -7
- package/.claude/skills/dependency-review/SKILL.md +0 -22
- package/.claude/skills/dependency-review/references/astra.md +0 -17
- package/.claude/skills/dependency-review/references/legacy.md +0 -7
- package/.claude/skills/design/SKILL.md +0 -24
- package/.claude/skills/design/references/astra.md +0 -12
- package/.claude/skills/design/references/legacy.md +0 -13
- package/.claude/skills/design-review/SKILL.md +0 -24
- package/.claude/skills/design-review/references/astra.md +0 -17
- package/.claude/skills/design-review/references/legacy.md +0 -7
- package/.claude/skills/evidence-review/SKILL.md +0 -22
- package/.claude/skills/evidence-review/references/astra.md +0 -17
- package/.claude/skills/evidence-review/references/legacy.md +0 -7
- package/.claude/skills/hotfix/SKILL.md +0 -22
- package/.claude/skills/hotfix/references/astra.md +0 -30
- package/.claude/skills/hotfix/references/legacy.md +0 -7
- package/.claude/skills/incident-recovery/SKILL.md +0 -22
- package/.claude/skills/incident-recovery/references/astra.md +0 -27
- package/.claude/skills/incident-recovery/references/legacy.md +0 -7
- package/.claude/skills/levelplay-unity-integration/SKILL.md +0 -1126
- package/.claude/skills/localization/SKILL.md +0 -135
- package/.claude/skills/localization/resources/L10nBatchProcessor.cs +0 -69
- package/.claude/skills/localize-game/SKILL.md +0 -22
- package/.claude/skills/localize-game/references/astra.md +0 -27
- package/.claude/skills/localize-game/references/legacy.md +0 -7
- package/.claude/skills/migrate-project/SKILL.md +0 -22
- package/.claude/skills/migrate-project/references/astra.md +0 -30
- package/.claude/skills/migrate-project/references/legacy.md +0 -19
- package/.claude/skills/migrate-project/references/procedure.md +0 -96
- package/.claude/skills/milestone-review/SKILL.md +0 -22
- package/.claude/skills/milestone-review/references/astra.md +0 -12
- package/.claude/skills/milestone-review/references/legacy.md +0 -7
- package/.claude/skills/nccgs-code-review/SKILL.md +0 -22
- package/.claude/skills/nccgs-code-review/references/astra.md +0 -21
- package/.claude/skills/nccgs-code-review/references/legacy.md +0 -7
- package/.claude/skills/new-unity-project/SKILL.md +0 -179
- package/.claude/skills/performance-audit/SKILL.md +0 -22
- package/.claude/skills/performance-audit/references/astra.md +0 -17
- package/.claude/skills/performance-audit/references/legacy.md +0 -7
- package/.claude/skills/physics-3d-collision/references/troubleshooting.md +0 -41
- package/.claude/skills/plan-feature/SKILL.md +0 -22
- package/.claude/skills/plan-feature/references/astra.md +0 -12
- package/.claude/skills/plan-feature/references/legacy.md +0 -7
- package/.claude/skills/playtest/SKILL.md +0 -22
- package/.claude/skills/playtest/references/astra.md +0 -31
- package/.claude/skills/playtest/references/legacy.md +0 -7
- package/.claude/skills/project-stage/SKILL.md +0 -22
- package/.claude/skills/project-stage/references/astra.md +0 -12
- package/.claude/skills/project-stage/references/legacy.md +0 -7
- package/.claude/skills/prototype-feature/SKILL.md +0 -22
- package/.claude/skills/prototype-feature/references/astra.md +0 -31
- package/.claude/skills/prototype-feature/references/legacy.md +0 -7
- package/.claude/skills/qa-plan/SKILL.md +0 -22
- package/.claude/skills/qa-plan/references/astra.md +0 -12
- package/.claude/skills/qa-plan/references/legacy.md +0 -7
- package/.claude/skills/release/SKILL.md +0 -22
- package/.claude/skills/release/references/astra.md +0 -30
- package/.claude/skills/release/references/legacy.md +0 -11
- package/.claude/skills/release-readiness/SKILL.md +0 -22
- package/.claude/skills/release-readiness/references/astra.md +0 -17
- package/.claude/skills/release-readiness/references/legacy.md +0 -7
- package/.claude/skills/retrospective/SKILL.md +0 -22
- package/.claude/skills/retrospective/references/astra.md +0 -12
- package/.claude/skills/retrospective/references/legacy.md +0 -7
- package/.claude/skills/review/SKILL.md +0 -22
- package/.claude/skills/review/references/astra.md +0 -21
- package/.claude/skills/review/references/legacy.md +0 -9
- package/.claude/skills/security-audit/SKILL.md +0 -22
- package/.claude/skills/security-audit/references/astra.md +0 -17
- package/.claude/skills/security-audit/references/legacy.md +0 -7
- package/.claude/skills/sprint-plan/SKILL.md +0 -22
- package/.claude/skills/sprint-plan/references/astra.md +0 -12
- package/.claude/skills/sprint-plan/references/legacy.md +0 -7
- package/.claude/skills/status/SKILL.md +0 -22
- package/.claude/skills/status/references/astra.md +0 -19
- package/.claude/skills/status/references/legacy.md +0 -9
- package/.claude/skills/story-readiness/SKILL.md +0 -24
- package/.claude/skills/story-readiness/references/astra.md +0 -17
- package/.claude/skills/story-readiness/references/legacy.md +0 -7
- package/.claude/skills/test/SKILL.md +0 -22
- package/.claude/skills/test/references/astra.md +0 -27
- package/.claude/skills/test/references/legacy.md +0 -9
- package/.claude/skills/ui-review/SKILL.md +0 -22
- package/.claude/skills/ui-review/references/astra.md +0 -17
- package/.claude/skills/ui-review/references/legacy.md +0 -7
- package/.claude/skills/unity-cli/CHANGELOG.md +0 -233
- package/.claude/skills/unity-cli/SECURITY.md +0 -22
- package/.claude/skills/unity-cli/SKILL.md +0 -414
- package/.claude/skills/unity-cli/references/auth-license-cloud.md +0 -146
- package/.claude/skills/unity-cli/references/build-run-test.md +0 -349
- package/.claude/skills/unity-cli/references/config-hub.md +0 -103
- package/.claude/skills/unity-cli/references/diagnostics-maintenance.md +0 -326
- package/.claude/skills/unity-cli/references/editors-install.md +0 -327
- package/.claude/skills/unity-cli/references/integration-advanced.md +0 -472
- package/.claude/skills/unity-cli/references/projects-templates.md +0 -574
- package/.claude/skills/work/SKILL.md +0 -22
- package/.claude/skills/work/references/astra.md +0 -32
- package/.claude/skills/work/references/classification.md +0 -41
- package/.claude/skills/work/references/closure.md +0 -60
- package/.claude/skills/work/references/feature-contracts.md +0 -36
- package/.claude/skills/work/references/legacy.md +0 -29
- package/.claude/skills/work/references/verification.md +0 -26
- package/CLAUDE.md +0 -10
- package/MEMORY.md +0 -109
- package/UPGRADING.md +0 -130
- package/VERSION +0 -1
- package/docs/ARCHITECTURE.md +0 -131
- package/docs/ASSET-PRODUCTION-GRAPHIFY-PLAN.md +0 -230
- package/docs/BOUNDED-REPAIR.md +0 -80
- package/docs/EDITOR-SESSION-EVIDENCE.md +0 -52
- package/docs/HANDOFF-AUTOMATION.md +0 -144
- package/docs/HUONG-DAN-MIGRATE-VA-SU-DUNG.md +0 -117
- package/docs/MIGRATION-MATRIX.md +0 -23
- package/docs/NCCGS-1.3.md +0 -13
- package/docs/NCCGS-1.4.1.md +0 -149
- package/docs/NCCGS-1.4.md +0 -184
- package/docs/NCCGS-1.5-IMPLEMENTATION-PLAN.md +0 -378
- package/docs/NCCGS-1.5-PILOT.md +0 -130
- package/docs/NCCGS-1.5.md +0 -237
- package/docs/PHASE-1-OPERATIONS.md +0 -278
- package/docs/PHASE-2-OPERATIONS.md +0 -183
- package/docs/PROJECT-POLICY.md +0 -94
- package/docs/RELEASE-STATUS.md +0 -150
- package/docs/TASK-SLICING.md +0 -57
- package/docs/UNINSTALL.md +0 -134
- package/docs/UPGRADE-QUALIFICATION.md +0 -45
- package/docs/WFK17-HOOK-REPAIR.md +0 -71
- package/docs/WORKFLOWS.md +0 -85
- package/package-assets/nccgs-project.gitignore +0 -2
- package/package-assets/setup-vivox-voice-chat-evals.gitignore +0 -7
- package/scaffold/.nccgs/autonomy.json +0 -4
- package/scaffold/.nccgs/bugs/.gitkeep +0 -1
- package/scaffold/.nccgs/closures/.gitkeep +0 -1
- package/scaffold/.nccgs/context/.gitkeep +0 -1
- package/scaffold/.nccgs/decisions/.gitkeep +0 -1
- package/scaffold/.nccgs/evidence/.gitkeep +0 -1
- package/scaffold/.nccgs/execution.json +0 -10
- package/scaffold/.nccgs/features/.gitkeep +0 -1
- package/scaffold/.nccgs/gates.json +0 -7
- package/scaffold/.nccgs/inputs.json +0 -6
- package/scaffold/.nccgs/migrations/.gitkeep +0 -1
- package/scaffold/.nccgs/playtests/.gitkeep +0 -1
- package/scaffold/.nccgs/project.yaml +0 -109
- package/scaffold/.nccgs/requirements.yaml +0 -10
- package/scaffold/.nccgs/reviews/.gitkeep +0 -1
- package/scaffold/.nccgs/state.md +0 -40
- package/scaffold/.nccgs/templates/agent-handoff.md +0 -37
- package/scaffold/.nccgs/templates/architecture-decision.md +0 -27
- package/scaffold/.nccgs/templates/closure-record.md +0 -62
- package/scaffold/.nccgs/templates/context-packet.yaml +0 -17
- package/scaffold/.nccgs/templates/design-contract.json +0 -34
- package/scaffold/.nccgs/templates/evidence-record.md +0 -23
- package/scaffold/.nccgs/templates/feature-contract.md +0 -60
- package/scaffold/.nccgs/templates/implementation-report.md +0 -52
- package/scaffold/.nccgs/templates/migration-plan.md +0 -40
- package/scaffold/.nccgs/templates/repair-packet.json +0 -14
- package/scaffold/.nccgs/templates/repair-unity-code.json +0 -18
- package/scaffold/.nccgs/templates/repair-unity-editor.json +0 -21
- package/scaffold/.nccgs/templates/task-slices.json +0 -28
- package/scaffold/.nccgs/templates/waiver.md +0 -11
- package/scripts/benchmark-snapshot.mjs +0 -205
- package/scripts/benchmark-v15.mjs +0 -173
- package/scripts/cli.mjs +0 -205
- package/scripts/doctor.mjs +0 -261
- package/scripts/install.mjs +0 -530
- package/scripts/recover-session.mjs +0 -89
- package/scripts/run.mjs +0 -86
- package/scripts/supervise.mjs +0 -152
- package/scripts/uninstall.mjs +0 -292
- package/scripts/validate.mjs +0 -285
- package/scripts/work-handoff.mjs +0 -38
- package/tests/autonomy.test.mjs +0 -126
- package/tests/benchmark-v15.test.mjs +0 -65
- package/tests/design-readiness.test.mjs +0 -200
- package/tests/editor-session-evidence.test.mjs +0 -45
- package/tests/evidence.test.mjs +0 -186
- package/tests/fixtures/compiler-shutdown.cs +0 -67
- package/tests/fixtures/native-provider.mjs +0 -61
- package/tests/framework.test.mjs +0 -740
- package/tests/gates.test.mjs +0 -479
- package/tests/hook-repair.test.mjs +0 -106
- package/tests/lifecycle-v15.test.mjs +0 -346
- package/tests/native-completion-notices.test.mjs +0 -181
- package/tests/orchestration-v15.test.mjs +0 -596
- package/tests/phase1.test.mjs +0 -427
- package/tests/phase2.test.mjs +0 -250
- package/tests/policy-v15.test.mjs +0 -234
- package/tests/ponytail-package.test.mjs +0 -75
- package/tests/returned-handoff-notices.test.mjs +0 -170
- package/tests/review-budget.test.mjs +0 -177
- package/tests/runtime-v15.test.mjs +0 -1198
- package/tests/session-budget.test.mjs +0 -34
- package/tests/task-slices.test.mjs +0 -285
- package/tests/uninstall.test.mjs +0 -477
- package/tests/unity-generated.test.mjs +0 -140
- package/tests/unity-transport.test.mjs +0 -348
- /package/{.claude/nccgs/packages → template}/ponytail/LICENSE +0 -0
- /package/{.claude/nccgs/packages → template}/ponytail/NOTICE.md +0 -0
- /package/{.claude/nccgs/packages → template}/ponytail/complexity-review.md +0 -0
- /package/{.claude/skills → unity-skills}/build-live-game/references/remote-config.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/README.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/codeless-catalog.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-adapty.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-essentialkit.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-revenuecat.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/convert-unipay.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/migration-v4-to-v5.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-add-iap-to-new-project.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/path-convert-native-storekit.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/platform-notes.md +0 -0
- /package/{.claude/skills → unity-skills}/implement-in-app-purchases/references/pre-check.md +0 -0
- /package/{.claude/skills → unity-skills}/localization/resources/LocalizedFontAsset.cs +0 -0
- /package/{.claude/skills → unity-skills}/optimize-audio/resources/platform-settings.md +0 -0
- /package/{.claude/skills → unity-skills}/optimize-web/resources/WebOptimizer.cs +0 -0
- /package/{.claude/skills → unity-skills}/optimize-web/resources/toktx-examples.sh +0 -0
- /package/{.claude/skills → unity-skills}/physics-3d-collision/resources/CollisionDebugger.cs +0 -0
- /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/dgs-entrypoint.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/entrypoints.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/examples.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/implementation-fit.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/underlying-services.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-multiplayer-services/references/workflows-prerequisites.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/.env.example +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/README.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/promptfooconfig.yaml +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/tests/init-and-login.yaml +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/tests/text-chat.yaml +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/evals/tests/voice-channels.yaml +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/events-and-participants.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/init-and-login.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/text-chat.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/troubleshooting.md +0 -0
- /package/{.claude/skills → unity-skills}/setup-vivox-voice-chat/references/voice-channels.md +0 -0
- /package/{.claude/skills → unity-skills}/shader-graph-create-custom-node/resources/all_hints.hlsl +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/references/api_reference.md +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/references/background.md +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/AutomaticSliceTexture.cs +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GenerateNewSpriteRects.cs +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GetTextureSourceImageSize.cs +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GetTextureToSlice.cs +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/GridSliceTexture.cs +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/IsometricSliceTexture.cs +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/README.md +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/SetPivotExample.cs +0 -0
- /package/{.claude/skills → unity-skills}/sprite-editor/scripts/SpriteToPng.cs +0 -0
- /package/{.claude/skills → unity-skills}/ui-imgui/references/gui-elements.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-imgui/references/templates.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-ugui/references/scrollview-setup.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-uitk/references/common-issues.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-uitk/references/painter2d.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-uitk/references/pointermanipulator-guide.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-uitk/references/svg-icons.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-uitk/references/ui-runtime-binding.md +0 -0
- /package/{.claude/skills → unity-skills}/ui-uitk/references/uss-guide.md +0 -0
- /package/{.claude/skills → unity-skills}/urp-postprocessing/references/effect-reference.md +0 -0
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
# Docs workflow: find, cite and match Unity documentation
|
|
2
|
+
|
|
3
|
+
Part of the **`unity-cli`** skill. See that skill's `SKILL.md` for CLI install, global flags, environment
|
|
4
|
+
variables and exit codes. The full flag list for `unity docs` and `unity docs toc` is in
|
|
5
|
+
[diagnostics-maintenance.md](diagnostics-maintenance.md#docs--version-matched-unity-documentation); this file
|
|
6
|
+
is the order an agent follows, with 2D examples.
|
|
7
|
+
|
|
8
|
+
**Why use it:** the pages `unity docs` resolves match the Editor version of the project you are in. An API
|
|
9
|
+
remembered from another Unity version is a common source of wrong code, 2D physics and Tilemap included.
|
|
10
|
+
|
|
11
|
+
Relative links in this file resolve to the skill directory's `references/` folder, so `../SKILL.md` is the skill's main page.
|
|
12
|
+
|
|
13
|
+
## Contents
|
|
14
|
+
|
|
15
|
+
- The flow
|
|
16
|
+
- Version flags
|
|
17
|
+
- The page index cache
|
|
18
|
+
- Rules for agents
|
|
19
|
+
|
|
20
|
+
## The flow
|
|
21
|
+
|
|
22
|
+
1. **Find the page with `docs toc`.** It lists real pages, so you never guess a name.
|
|
23
|
+
2. **Resolve the address with `docs --url`.** It prints the docs.unity.com address and opens nothing.
|
|
24
|
+
3. **Cite or read it.** Put the address in your answer or review comment, or print the page's Markdown with
|
|
25
|
+
`docs --content`. Without `--url` or `--content`, `unity docs` opens the page in the default browser
|
|
26
|
+
(only useful when a person is watching).
|
|
27
|
+
4. **Cache the docs with `docs cache add`** before working offline, or when you will read many pages.
|
|
28
|
+
5. **Pin the version** whenever the project is not the one you are standing in (see Version flags).
|
|
29
|
+
|
|
30
|
+
For a package's manual (`com.unity.*`), use `docs --package` instead of steps 1 and 2.
|
|
31
|
+
|
|
32
|
+
### 1. Find a page: `docs toc`
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
unity docs toc --format json # scripting API reference, this project's version
|
|
36
|
+
unity docs toc --manual --format json # the manual
|
|
37
|
+
unity docs toc --editor-version 6000.0 --format ndjson # one page per line, for a version branch
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
Each entry has a `path` (`unityengine/rigidbody2d/addforce`) and an absolute `url`. Under `--format json`,
|
|
41
|
+
`data` is `{version, requestedVersion, section, entries}`. `--format ndjson` writes one entry per line. The
|
|
42
|
+
default human and `--format tsv` output show the path and URL as two columns. The index carries no page
|
|
43
|
+
titles, only paths, so search the entries for the class or member name you want.
|
|
44
|
+
|
|
45
|
+
Only the Engine scripting API and the manual have an index. `--cli`, `--hub` and `--cloud` publish none, so
|
|
46
|
+
`toc` doesn't take them.
|
|
47
|
+
|
|
48
|
+
### 2. Resolve the address: `docs --url`
|
|
49
|
+
|
|
50
|
+
```bash
|
|
51
|
+
unity docs --url Rigidbody2D # the class page
|
|
52
|
+
unity docs --url Rigidbody2D.AddForce # a member page
|
|
53
|
+
unity docs --url Tilemap.SetTile # another 2D member
|
|
54
|
+
unity docs --url UnityEngine.SpriteRenderer # a qualified name matches exactly
|
|
55
|
+
unity docs --url --manual "2D physics" # the manual is a search, so this returns a search address
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
A bare class name or `Class.member` matches the page whose path ends with it (preferring `UnityEngine`, then
|
|
59
|
+
`UnityEditor`). A name two pages tie on goes to search rather than a guess. The lookup never fails the
|
|
60
|
+
command: offline, a qualified name is built directly when a version is known (a project or
|
|
61
|
+
`--editor-version`), and anything else goes to search.
|
|
62
|
+
|
|
63
|
+
Add `--format json` to see how the address was found:
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
unity docs --url Rigidbody2D.AddForce --format json
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
`data` carries `url`, `opened` (false under `--url`), `version` (the docs version in the URL, `null` for a search or a home page),
|
|
70
|
+
`requestedVersion` (the one you asked for) and `resolvedBy`: `index` (an exact page from the index),
|
|
71
|
+
`direct` (built without the index) or `search` (a search page). When `resolvedBy` is `search`, the address is
|
|
72
|
+
a list of results, not the page. For a scripting API page, run `docs toc` and pick a path. The manual has
|
|
73
|
+
no name lookup, so `docs --url --manual` always returns search results: for a manual page, cite the `url` of
|
|
74
|
+
the `docs toc --manual` entry you picked.
|
|
75
|
+
|
|
76
|
+
### 3. Read a page: `docs --content`
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
unity docs --content Rigidbody2D.AddForce # the page's Markdown on stdout
|
|
80
|
+
unity docs --content Rigidbody2D.AddForce --format json # wrapped with url, version and source
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
The scripting API resolves by name as `--url` does. The manual has no name lookup, so `--content --manual`
|
|
84
|
+
fails; read a cached manual page from its file instead (below).
|
|
85
|
+
|
|
86
|
+
### Package manuals: `docs --package`
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
unity docs --package com.unity.2d.sprite --url # the manual for the version the project uses
|
|
90
|
+
unity docs --package com.unity.inputsystem --url --format json # adds package, packageVersion and resolvedBy
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Package manuals live on docs.unity3d.com, not docs.unity.com. The version is the one in the project's
|
|
94
|
+
`Packages/packages-lock.json`, a package built into the Editor uses its one manual version, and anything else
|
|
95
|
+
(outside a project too) uses the newest release on the Unity registry. A name the registry doesn't list fails
|
|
96
|
+
with `DOCS_PACKAGE_UNKNOWN`, and a registry that can't be reached with `NETWORK_UNREACHABLE`. `--package`
|
|
97
|
+
takes no topic and can't be combined with another documentation set, `--search` or `--editor-version`.
|
|
98
|
+
|
|
99
|
+
Without `--url`, a project that has the package's own `Documentation~` page opens that local Markdown
|
|
100
|
+
first, offline, with no registry call; `--online` skips it. JSON then says `resolvedBy: local`,
|
|
101
|
+
`source: local` and gives the file's `path`. `--url` always prints the online manual, so use it for links.
|
|
102
|
+
|
|
103
|
+
### 4. Work offline: `docs cache`
|
|
104
|
+
|
|
105
|
+
```bash
|
|
106
|
+
unity docs cache add # the manual, this project's version
|
|
107
|
+
unity docs cache add --api --editor-version 6000.0 # the scripting API too (about 96,000 pages)
|
|
108
|
+
unity docs cache --format json # what is cached, per version
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
`add` prints the folder it fills: one Markdown file per page, `<section>/<path>.md` under the version, with
|
|
112
|
+
the section's listing in `<section>.txt` beside it. After that:
|
|
113
|
+
|
|
114
|
+
- `docs --content` reads a cached page without a request (`source: cache` in json), and caches every page it
|
|
115
|
+
fetches online too.
|
|
116
|
+
- `docs toc` and the name lookup behind `docs --url` and `--content` use the cached listing when
|
|
117
|
+
docs.unity.com can't be reached.
|
|
118
|
+
- Manual pages are read from their files: `docs toc --manual` path `get-started/first-time-user/2dor3d` is
|
|
119
|
+
`manual/get-started/first-time-user/2dor3d.md` under the version's folder.
|
|
120
|
+
|
|
121
|
+
A failed `add` (`DOCS_CACHE_INCOMPLETE`) resumes where it stopped when run again. Cached pages don't
|
|
122
|
+
expire: run `add` again to refresh them, `docs cache clear --yes` to delete them. `unity cache clean`
|
|
123
|
+
deletes them with the other downloads.
|
|
124
|
+
|
|
125
|
+
### Other documentation sets
|
|
126
|
+
|
|
127
|
+
`--cli`, `--hub` and `--cloud` look a topic up in the Unity CLI, Unity Hub or Unity Cloud documentation. Topic
|
|
128
|
+
names are lowercase and hyphenated (`use-unity-cli`, `project-create`, `developer-data/collection-settings`).
|
|
129
|
+
These sets are not versioned by Editor, so `--editor-version` with one of them is a usage failure, and so is
|
|
130
|
+
passing two sets at once.
|
|
131
|
+
|
|
132
|
+
```bash
|
|
133
|
+
unity docs --url --cli use-unity-cli
|
|
134
|
+
unity docs --url --hub project-create
|
|
135
|
+
```
|
|
136
|
+
|
|
137
|
+
## Version flags
|
|
138
|
+
|
|
139
|
+
The documentation version is, in order:
|
|
140
|
+
|
|
141
|
+
1. `--editor-version <version>`: a full version (`6000.0.26f1`) or a version branch (`6000.0`). An
|
|
142
|
+
unparseable value is a usage failure, not a silent fallback.
|
|
143
|
+
2. The current project's `ProjectSettings/ProjectVersion.txt`. No Editor has to be installed.
|
|
144
|
+
3. The newest version docs.unity.com hosts.
|
|
145
|
+
|
|
146
|
+
A version the site doesn't host resolves to the nearest hosted version below it (or the oldest hosted one),
|
|
147
|
+
with a one-line notice on stderr. Read `version` against `requestedVersion` in the JSON when the difference
|
|
148
|
+
matters.
|
|
149
|
+
|
|
150
|
+
Pin the version in two cases: you are not inside the project (a new 2D project you have yet to create, or a
|
|
151
|
+
question about another Editor), or the project upgrades soon and you are checking an API against the target
|
|
152
|
+
version.
|
|
153
|
+
|
|
154
|
+
```bash
|
|
155
|
+
unity docs --url Rigidbody2D.AddForce --editor-version 6000.0
|
|
156
|
+
unity docs toc --editor-version 2022.3 --format ndjson
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
## The page index cache
|
|
160
|
+
|
|
161
|
+
`docs toc` and the index lookup behind `docs --url` download the page index once a day and read it from a
|
|
162
|
+
local cache after that, so repeat calls in a session are fast. With no connection and no fresh cache:
|
|
163
|
+
|
|
164
|
+
- `docs toc` fails with `NETWORK_UNREACHABLE` (exit 7). A server error is `DOCS_TOC_FETCH_FAILED` and an
|
|
165
|
+
index that can't be read is `DOCS_TOC_INVALID`.
|
|
166
|
+
- `docs --url` does not fail. It builds a qualified name directly when a version is known (a project or
|
|
167
|
+
`--editor-version`) and sends anything else to search.
|
|
168
|
+
|
|
169
|
+
This daily cache holds the page index only. For page content offline, and an index that never expires, use
|
|
170
|
+
`docs cache add` (step 4): with a cached version, `docs toc` lists it offline instead of failing.
|
|
171
|
+
|
|
172
|
+
## Rules for agents
|
|
173
|
+
|
|
174
|
+
- Resolve the address first and cite it. Don't quote an API from memory when a page for the project's
|
|
175
|
+
version exists.
|
|
176
|
+
- Prefer `--format json` and read `resolvedBy`, so you can tell a real page from a search.
|
|
177
|
+
- Don't open a browser from an unattended run: use `--url`.
|
|
178
|
+
- Only use documentation addresses the CLI printed: `docs.unity.com` for the Engine, CLI, Hub and Cloud
|
|
179
|
+
docs, and `docs.unity3d.com/Packages/` for package manuals from `docs --package`.
|
|
@@ -0,0 +1,476 @@
|
|
|
1
|
+
# Editors, install & modules — unity-cli command reference
|
|
2
|
+
|
|
3
|
+
Part of the **`unity-cli`** skill. See that skill's `SKILL.md` for CLI install, global flags,
|
|
4
|
+
environment variables, exit codes, and common workflows. All global flags (`--format json`,
|
|
5
|
+
`--non-interactive`, `--yes`, `--proxy`, …) apply to every command below.
|
|
6
|
+
|
|
7
|
+
### Contents
|
|
8
|
+
|
|
9
|
+
- Editors — list, install, uninstall
|
|
10
|
+
- Software Terms — `unity terms`
|
|
11
|
+
- Install
|
|
12
|
+
- Uninstall
|
|
13
|
+
- Modules — add/list per editor
|
|
14
|
+
- install-modules
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
### Editors — list, install, uninstall
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
# List all editors (installed + available releases)
|
|
22
|
+
# Short alias: unity e. The bare `unity editors` is shorthand for the explicit `unity editors` (matches projects/templates/modules)
|
|
23
|
+
unity editors --format json
|
|
24
|
+
|
|
25
|
+
# List only installed editors
|
|
26
|
+
# As of 0.1.0-beta.8 the --installed table includes an "Upgrade to" column flagging editors with a newer patch in their line
|
|
27
|
+
unity editors --installed --format json
|
|
28
|
+
|
|
29
|
+
# List only available releases
|
|
30
|
+
unity editors --releases --format json
|
|
31
|
+
|
|
32
|
+
# Filter by architecture
|
|
33
|
+
unity editors --installed --architecture arm64 --format json
|
|
34
|
+
|
|
35
|
+
# Show detailed module info
|
|
36
|
+
unity editors --long
|
|
37
|
+
|
|
38
|
+
# Watch mode — live-updates as editors are installed or removed
|
|
39
|
+
unity editors --watch
|
|
40
|
+
unity editors --installed --watch
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
`unity editors` honors `--format tsv` and `--format ndjson` for its default listing. Identifier columns keep their natural width even if the table exceeds the terminal — they are no longer silently truncated.
|
|
44
|
+
|
|
45
|
+
In the `--json` and `--format ndjson` rows of an installed Editor, read `moduleNames`, an array of the installed platforms (with `--long`, the full module names). The `modules` string joins the same names with `, ` and is deprecated: a module name can itself contain a comma.
|
|
46
|
+
|
|
47
|
+
#### editors running
|
|
48
|
+
|
|
49
|
+
List the Unity Editor instances currently running and the project each has open, with the editor version and process id per instance:
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
unity editors running
|
|
53
|
+
unity editors running --format json
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
Detection is cross-platform (process table plus each project's Pipeline lockfile), and the version falls back to a project's `ProjectSettings/ProjectVersion.txt` for editors without the Pipeline package. An empty list is a normal result (exit 0). Honors the global `--format human|json|tsv|ndjson` (and `--json`). In JSON each row of `data.instances` carries `pid`, `projectPath`, `projectName`, `editorVersion` (`null` when unknown), `port`, `hasPipeline` and `reachable`. Read `editorVersion`: `unityVersion` holds the same value and is deprecated.
|
|
57
|
+
|
|
58
|
+
#### editors add
|
|
59
|
+
|
|
60
|
+
Register one or more existing editor installations by path:
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
unity editors add /path/to/Unity/Editor
|
|
64
|
+
|
|
65
|
+
# Register multiple at once
|
|
66
|
+
unity editors add /path/one /path/two
|
|
67
|
+
|
|
68
|
+
# Skip macOS code-signature check (useful for unsigned or side-loaded builds)
|
|
69
|
+
unity editors add /path/to/Unity/Editor --skip-signature-check
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
#### editors default
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
# Show current default editor
|
|
76
|
+
unity editors default --format json
|
|
77
|
+
|
|
78
|
+
# Set default by version, alias, or keyword
|
|
79
|
+
unity editors default 6000.0.47f1
|
|
80
|
+
unity editors default latest
|
|
81
|
+
unity editors default lts
|
|
82
|
+
|
|
83
|
+
# Clear the default
|
|
84
|
+
unity editors default --unset
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
On a TTY with no arguments, shows an interactive selection prompt.
|
|
88
|
+
|
|
89
|
+
#### editors path
|
|
90
|
+
|
|
91
|
+
```bash
|
|
92
|
+
# Print the install directory of an installed editor (local, offline — no release-feed fetch)
|
|
93
|
+
unity editors path 6000.0.47f1
|
|
94
|
+
unity editors path 6000.0.47f1 --architecture arm64 --json
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
Honors `--architecture` and `--format` / `--json`, and reports ambiguous matches so you can narrow by version or architecture.
|
|
98
|
+
|
|
99
|
+
#### editors install-path
|
|
100
|
+
|
|
101
|
+
```bash
|
|
102
|
+
# Show the directory where editors are installed
|
|
103
|
+
unity editors install-path
|
|
104
|
+
|
|
105
|
+
# Set a new install path
|
|
106
|
+
unity editors install-path --set /path/to/editors
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
Also available as the top-level `unity install-path` (with an additional `--get` flag). Distinct from `editors path`: `install-path` gets/sets the *root* install directory; `editors path` prints the install directory of *one* editor version.
|
|
110
|
+
|
|
111
|
+
#### editors info
|
|
112
|
+
|
|
113
|
+
```bash
|
|
114
|
+
# Show release details for a specific version
|
|
115
|
+
unity editors info 6000.0.47f1 --format json
|
|
116
|
+
# Details for a specific architecture's build (default: this machine's)
|
|
117
|
+
unity editors info 6000.0.47f1 --architecture x86_64 --format json
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
`downloadUrl` and `modules` describe the build for this machine's architecture. When the release has no build for it, the default falls back to the platform's first download instead: on Linux arm64 that is the x86_64 installer, which runs only under FEX-Emu (see [Linux arm64](#linux-arm64-experimental-x86_64-editor-under-fex-emu)). `--architecture arm64|x86_64` selects a build explicitly, with no fallback; when the release has no build for it, `downloadUrl` is null.
|
|
121
|
+
|
|
122
|
+
#### editors upgrade
|
|
123
|
+
|
|
124
|
+
New in `0.1.0-beta.8`. Upgrade an installed editor to the newest official (f-channel) patch in the same `major.minor` line (e.g. `2022.3.10f1` → `2022.3.62f1`), carrying the installed modules over (except the IDE modules, Visual Studio Code and Visual Studio, which update themselves; add `-m visualstudiocode` to install it anyway). The `[editor]` argument accepts an exact version, a `major.minor` line, or the `latest` / `lts` / `default` aliases. Editors install side by side — the old version is kept unless `--replace` (alias `--remove-old`) is passed.
|
|
125
|
+
|
|
126
|
+
```bash
|
|
127
|
+
# Upgrade a specific editor (or the default / lts / latest) to the newest patch in its line
|
|
128
|
+
unity editors upgrade 2022.3.10f1
|
|
129
|
+
unity editors upgrade lts
|
|
130
|
+
|
|
131
|
+
# Upgrade every installed editor that has a newer patch
|
|
132
|
+
unity editors upgrade --all --yes --accept-eula
|
|
133
|
+
|
|
134
|
+
# Report current → target without installing (--check is an alias for --dry-run)
|
|
135
|
+
unity editors upgrade --all --dry-run --format json
|
|
136
|
+
|
|
137
|
+
# Remove the old editor after a successful upgrade; skip carrying modules; add extra modules
|
|
138
|
+
unity editors upgrade 2022.3.10f1 --replace --yes
|
|
139
|
+
unity editors upgrade 2022.3.10f1 --no-modules
|
|
140
|
+
unity editors upgrade 2022.3.10f1 --module android --module ios
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
#### editors prune
|
|
144
|
+
|
|
145
|
+
Finds installed editors that **no registered project uses** and, optionally, uninstalls them. Report-only by default — it never deletes anything unless you pass `--remove`.
|
|
146
|
+
|
|
147
|
+
```bash
|
|
148
|
+
# Report only: which editors are unused, and how much they'd reclaim
|
|
149
|
+
unity editors prune
|
|
150
|
+
|
|
151
|
+
# Uninstall the unused editors (prompts to confirm)
|
|
152
|
+
unity editors prune --remove
|
|
153
|
+
|
|
154
|
+
# Non-interactive: --yes is REQUIRED alongside --remove in a script or CI
|
|
155
|
+
unity editors prune --remove --yes
|
|
156
|
+
|
|
157
|
+
# Machine output
|
|
158
|
+
unity editors prune --format json
|
|
159
|
+
```
|
|
160
|
+
|
|
161
|
+
The report lists version, architecture, path, size, and status, then the total reclaimable size. With `--remove` in a non-interactive shell and no `-y, --yes`, it refuses rather than deleting unprompted. "Unused" is judged against the **project registry** (`unity projects`), so an editor used only by a project you never registered counts as unused — register it first, or verify with `unity editors prune` before adding `--remove`.
|
|
162
|
+
|
|
163
|
+
When an Editor folder holds files this user can't delete (installed with `sudo` or by a package), `prune --remove`, `uninstall` and `editors upgrade --replace` remove it through an administrator password dialog, and only on a terminal: one line says why first. With no terminal on stdin, under `--non-interactive`, in CI, or with `--format json`/`ndjson`/`tsv`, they stop before anything is removed with exit 2 and code `UNINSTALL_ELEVATION_NEEDS_TERMINAL`. Run the command from a terminal or as root; `UNITY_NO_ELEVATE=1` skips the dialog but refuses the removal too.
|
|
164
|
+
|
|
165
|
+
**`--remove-missing` is a separate, safer candidate class:** editors registered with `unity editors add` (typically internal branch builds) whose recorded install path no longer resolves on disk at all.
|
|
166
|
+
|
|
167
|
+
```bash
|
|
168
|
+
# Also report editors whose install path is already gone
|
|
169
|
+
unity editors prune --remove-missing
|
|
170
|
+
|
|
171
|
+
# Drop those entries from the editor list (prompts to confirm)
|
|
172
|
+
unity editors prune --remove-missing --yes
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
Unlike `--remove`, this never touches the filesystem — the folder is already gone, so there is nothing to delete, and confirming only updates the registry. It doesn't require the running-editor check to succeed, since nothing can be running out of a folder that no longer exists. The two flags are independent and neither implies the other; `--format json`/`ndjson` carry the missing-path rows under `data.missing`.
|
|
176
|
+
|
|
177
|
+
#### editors verify
|
|
178
|
+
|
|
179
|
+
Structurally verifies an installed editor: checks that its files and modules are actually present on disk. It's the command to reach for when an editor launches oddly, a module seems half-installed, or a download was interrupted.
|
|
180
|
+
|
|
181
|
+
```bash
|
|
182
|
+
# Verify an installed editor
|
|
183
|
+
unity editors verify 6000.1.0f1
|
|
184
|
+
|
|
185
|
+
# Disambiguate when the same version is installed for two architectures
|
|
186
|
+
unity editors verify 6000.1.0f1 --architecture arm64
|
|
187
|
+
|
|
188
|
+
# Machine output
|
|
189
|
+
unity editors verify 6000.1.0f1 --json
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
Reports each component as `ok`, `missing`, or `skipped`, and names the exact `unity install-modules` command to repair anything missing. A clean editor exits 0; missing or empty files fail the check. This is a **structural** check — it confirms files exist, not that they are uncorrupted or correctly signed. `--architecture` is inherited from the `editors` parent, so `unity editors --architecture arm64 verify <version>` works too.
|
|
193
|
+
|
|
194
|
+
#### editors module / editor module
|
|
195
|
+
|
|
196
|
+
Module management is exposed under **both** `editors module` and the `editor` (singular) command group. Both share the same subcommands:
|
|
197
|
+
|
|
198
|
+
```bash
|
|
199
|
+
# List modules for an installed editor
|
|
200
|
+
unity editors modules 6000.0.47f1 --format json
|
|
201
|
+
unity editor modules 6000.0.47f1 --architecture arm64 --format json
|
|
202
|
+
|
|
203
|
+
# Add modules to an installed editor
|
|
204
|
+
unity editors module add 6000.0.47f1 --module android --module ios
|
|
205
|
+
unity editors module add 6000.0.47f1 --all # Install every available module
|
|
206
|
+
unity editors module add 6000.0.47f1 --module android --child-modules # Include child modules
|
|
207
|
+
unity editors module add 6000.0.47f1 --module android --accept-eula # Accept EULAs automatically
|
|
208
|
+
|
|
209
|
+
# Remove installed modules from an editor by id (-m/--module, repeatable)
|
|
210
|
+
unity editors module remove 6000.0.47f1 --module android --module ios
|
|
211
|
+
unity editor module remove 6000.0.47f1 -m android -a arm64 # disambiguate side-by-side installs
|
|
212
|
+
unity editors module remove 6000.0.47f1 -m android --yes # skip the confirm prompt (required non-interactively)
|
|
213
|
+
|
|
214
|
+
# Refresh module list for a manually located editor
|
|
215
|
+
unity editors module refresh 6000.0.47f1
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
`module remove` prompts to confirm before deleting the module files; `-y` / `--yes` skips the prompt and is required in non-interactive mode. Supports `-a` / `--architecture` to disambiguate side-by-side installs and the global `--format human|json|tsv|ndjson`.
|
|
219
|
+
|
|
220
|
+
#### editor add (single path, with module-fetch control)
|
|
221
|
+
|
|
222
|
+
The `editor add` subcommand is similar to `editors add` but targets a single path and supports skipping the module-fetch step:
|
|
223
|
+
|
|
224
|
+
```bash
|
|
225
|
+
unity editor add /path/to/Unity/Editor
|
|
226
|
+
|
|
227
|
+
# Skip fetching module metadata (faster, but modules won't be listed until refreshed)
|
|
228
|
+
unity editor add /path/to/Unity/Editor --no-fetch-modules
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
---
|
|
232
|
+
|
|
233
|
+
### Software Terms — `unity terms`
|
|
234
|
+
|
|
235
|
+
Each Unity Editor stops at its "Unity Editor Software Terms" dialog (Accept and Continue / Decline) the first time it opens windowed, until the terms are accepted for that Editor. Current Editors ignore `-acceptSoftwareTermsForThisRunOnly`, so no launch flag prevents the dialog. `unity terms accept <version>` records the user's acceptance the way the dialog's Accept button does, so a container image or a provisioning script can prepare an Editor before it first opens.
|
|
236
|
+
|
|
237
|
+
<!-- unity-example: skip (Rust-only) -->
|
|
238
|
+
```bash
|
|
239
|
+
# Show the terms link and the copy installed with the Editor, then ask (default No)
|
|
240
|
+
unity terms accept 6000.3.10f1
|
|
241
|
+
|
|
242
|
+
# Accept without asking (unattended setup, after the user has read and agreed to the terms)
|
|
243
|
+
unity terms accept 6000.3.10f1 --yes
|
|
244
|
+
unity terms accept latest --architecture arm64 --yes
|
|
245
|
+
|
|
246
|
+
# Whether the terms are accepted, for every installed Editor or one
|
|
247
|
+
unity terms status
|
|
248
|
+
unity terms status 6000.3.10f1 --json
|
|
249
|
+
```
|
|
250
|
+
|
|
251
|
+
- **Accepting is the user's decision.** On a terminal `accept` prints the terms link (https://unity.com/legal/editor-terms-of-service/software) and the path of the terms file the Editor ships, then asks. Without a terminal (`--non-interactive`, `UNITY_NON_INTERACTIVE`, `--json` or another machine format, redirected input or output) it refuses with exit `2` and `TERMS_ACCEPT_NEEDS_CONFIRMATION` unless `--yes` is passed. Never pass `--yes` for the user unasked: show them the link and let them decide, or let them run the command.
|
|
252
|
+
- `<version>` resolves like `unity editors path`: an installed version, `latest` or `lts`, and `-a` / `--architecture` when a version is installed for both. An Editor that is not installed fails with `TERMS_EDITOR_NOT_INSTALLED`, an ambiguous version with `TERMS_EDITOR_AMBIGUOUS`, and an Editor that ships no terms file with `TERMS_FILE_MISSING`.
|
|
253
|
+
- The acceptance belongs to the exact terms file: its key is `Terms-` and the file's MD5, so Editors that ship the same terms share one answer, and an Editor with new terms asks again. An answer that is already recorded is reported (`alreadyAccepted: true`) and nothing is written.
|
|
254
|
+
- It writes only the Editor's own preference, for the current user: `HKCU\Software\Unity Technologies\Unity Editor 5.x` on Windows, the `com.unity3d.UnityEditor5.x` defaults domain on macOS, `~/.local/share/unity3d/prefs` (or `$XDG_DATA_HOME/unity3d/prefs`) on Linux. Close every open Unity Editor first: on macOS and Linux a running Editor can overwrite the answer when it saves its own preferences.
|
|
255
|
+
- `terms status` lists each installed Editor as `accepted`, `not-accepted` or `no-terms-file`, in every `--format`; `--json` carries `key`, `termsFile` and the `store` location for each.
|
|
256
|
+
|
|
257
|
+
---
|
|
258
|
+
|
|
259
|
+
### Install
|
|
260
|
+
|
|
261
|
+
```bash
|
|
262
|
+
# Install an editor (interactive version selection if omitted)
|
|
263
|
+
unity install 6000.0.47f1
|
|
264
|
+
|
|
265
|
+
# Install with specific modules
|
|
266
|
+
unity install 6000.0.47f1 --module windows-mono --module android
|
|
267
|
+
|
|
268
|
+
# Install a specific changeset by hash (a changeset that is not that version's build exits 11, RELEASE_NOT_FOUND)
|
|
269
|
+
unity install 6000.0.47f1 --changeset abc123def456
|
|
270
|
+
|
|
271
|
+
# Include child modules
|
|
272
|
+
unity install 6000.0.47f1 --child-modules
|
|
273
|
+
|
|
274
|
+
# Exclude child modules
|
|
275
|
+
unity install 6000.0.47f1 --no-child-modules
|
|
276
|
+
|
|
277
|
+
# Install and accept EULAs automatically (CI)
|
|
278
|
+
unity install 6000.0.47f1 --yes --accept-eula
|
|
279
|
+
|
|
280
|
+
# Force reinstall even if already present
|
|
281
|
+
unity install 6000.0.47f1 --force
|
|
282
|
+
|
|
283
|
+
# Install the latest release and make it the default editor, in one command
|
|
284
|
+
unity install latest --set-default
|
|
285
|
+
|
|
286
|
+
# Resume an interrupted download — editor installer or module — (also recovers orphaned partials left by a crash or kill)
|
|
287
|
+
unity install 6000.0.47f1 --resume
|
|
288
|
+
|
|
289
|
+
# Dry-run: show what would be installed without doing it
|
|
290
|
+
unity install 6000.0.47f1 --dry-run --format json
|
|
291
|
+
|
|
292
|
+
# List the editor's available modules and exit without installing
|
|
293
|
+
# (a drop-in alias for `unity modules <version>`)
|
|
294
|
+
unity install 6000.0.47f1 --list-modules --format json
|
|
295
|
+
|
|
296
|
+
# Space-separated module values after a single -m are equivalent to repeating -m
|
|
297
|
+
unity install 6000.0.47f1 -m android ios # space-separated
|
|
298
|
+
unity install 6000.0.47f1 -m android -m ios # repeated flag (same effect)
|
|
299
|
+
|
|
300
|
+
# Windows: keep the install service unelevated. The Editor's NSIS installer is manifested
|
|
301
|
+
# `highestAvailable`, so it runs unelevated for a STANDARD user (the supported unprivileged
|
|
302
|
+
# install — it reports any dependencies an admin must finish) but still asks for elevation on
|
|
303
|
+
# demand under an administrator account. In CI, where a prompt can't be answered, run the
|
|
304
|
+
# agent elevated instead. Also via UNITY_NO_ELEVATE=1.
|
|
305
|
+
unity install 6000.0.47f1 --no-elevate --yes --accept-eula
|
|
306
|
+
```
|
|
307
|
+
|
|
308
|
+
A transient editor or module download failure (a dropped connection, a truncated transfer) is retried with the same bounded policy `install-modules` already uses (two attempts by default; `UNITY_INSTALL_RETRIES` sets the count for both commands, and the `--retries` flag exists on `install-modules` only — `unity install` has no such flag) before the install fails. When installing an editor with several modules, a failed module no longer aborts the whole batch — `unity install` (and `unity install-modules`) continue with the remaining items and exit non-zero if any failed. Each editor and module is listed as installed (✓), failed (✗), or pending (·); the NDJSON `result` frame carries the same breakdown as an `items` array (each entry has `uid`, `name`, `kind`, `status`), so scripts can tell exactly which modules succeeded even on a non-zero exit.
|
|
309
|
+
|
|
310
|
+
**NDJSON progress frames** for `unity install` and `unity install-modules` include a `phase: 'download' | 'install'` field so scripts can switch to an indeterminate spinner during the install phase (which is genuinely indeterminate — NSIS on Windows only reports success/failure). During the install phase, `pct` is locked at 50 and only jumps to 100 on completion. Module download/install progress is nested under the parent editor via `parentItemUid`, so consumers see one editor group with its modules rather than one group per module.
|
|
311
|
+
|
|
312
|
+
On an interactive terminal, `unity install` also reports progress to the terminal application itself via the `OSC 9;4` escape sequence — on Windows Terminal the taskbar icon fills with download/install progress and spinners show as indeterminate, so you don't need to keep the window focused. It's emitted only on a TTY (never in piped or machine-consumed output), always cleared on exit, and ignored by terminals that don't support it.
|
|
313
|
+
|
|
314
|
+
Module installers honor the per-module install command from the release manifest (e.g. Visual Studio on Windows uses `--passive`, not `/S`); the resolved command is surfaced in `unity modules --json`. In the `--json` and `--format ndjson` rows of `unity modules`, `unity editors modules` and `unity install-modules --list`, read `downloadBytes`, `installedBytes` (integers) and `isInstalled` (boolean): `status`, `download` and `installed` are display text, and `status` is translated. `unity install` self-heals a corrupted partial download by discarding the bad partial and re-downloading; a cross-process install lock prevents two concurrent installs of the same version from corrupting the unpack.
|
|
315
|
+
|
|
316
|
+
**Waiting on another install.** The Hub and the CLI share one install lock, so while the Hub (or another CLI) is installing, `unity install`, `unity install-modules` and `unity projects require` print `Waiting for another install to finish before continuing…` on stderr and carry on once it finishes. That wait has no limit by default. In a script or CI job, bound it:
|
|
317
|
+
|
|
318
|
+
```bash
|
|
319
|
+
# Fail at once if another install is already running, before this item is downloaded
|
|
320
|
+
unity install 6000.0.47f1 --yes --no-wait
|
|
321
|
+
|
|
322
|
+
# Wait up to 10 minutes in total, then fail the same way
|
|
323
|
+
unity install-modules --editor-version 6000.0.47f1 -m android --timeout 600
|
|
324
|
+
```
|
|
325
|
+
|
|
326
|
+
`--timeout <seconds>` takes a whole number of seconds greater than 0 (digits only: `5m` and `1.5` are rejected) and is one budget for the whole command, not per module; `--no-wait` wins if both are given. When the wait runs out, or `--no-wait` finds the lock held, the command exits **9** with error code `INSTALL_LOCK_BUSY` (in the json envelope's `errors[].code`, and in the ndjson `result` frame), distinct from a failed install's exit 6, so a script can retry later. The error says another install is in progress and to run the command again once it finishes; the "Waiting for another install" line on stderr only appears while a wait is running, the default one or a bounded one, and never under `--no-wait`.
|
|
327
|
+
|
|
328
|
+
The lock is taken per item, so exit 9 does not mean nothing changed. `--no-wait` refuses an item before its download only when the lock is already held; if the Hub takes it while the item downloads, the item fails after the download. And `unity install <version> -m android --no-wait` can install the editor, then stop at the module: check `data.completedUids` in the ndjson `result` frame, and finish with `unity install-modules --editor-version <version> -m android` rather than re-running `unity install`, which now fails because the editor is already installed. A second `unity install` of the **same** version fails at once with exit 6 ("Another install of … is already in progress") before it reaches this lock, whatever the flags.
|
|
329
|
+
|
|
330
|
+
#### Make the installed Editor the default (`--set-default`)
|
|
331
|
+
|
|
332
|
+
`--set-default` stores the installed version as the default Editor, as `unity editors default <version>` does, once the install succeeds. It works with a version, `latest` or `lts`, and is one command on every shell, Windows PowerShell 5.1 included.
|
|
333
|
+
|
|
334
|
+
- Nothing is stored when the install fails. That includes an Editor that's already installed (exit 6, which `unity install` refuses without `--force`; run `unity editors default <version>` instead) and a `--no-wait` or `--timeout` that gives up on another install (exit 9). `--dry-run` stores nothing either.
|
|
335
|
+
- The json envelope and the ndjson `result` frame carry the stored version as `data.defaultVersion`. A human run ends with "Default editor version set to …".
|
|
336
|
+
- If the install succeeds but the default can't be stored, the command fails with exit 6 and `SET_DEFAULT_FAILED`. The Editor stays installed (`data.completedUids` lists it), and the message names `unity editors default <version>` to try again.
|
|
337
|
+
- It can't be combined with `--resume` or `--download-directory` (a usage error, exit 2), since neither installs one Editor the Hub finds by its version.
|
|
338
|
+
- Under `sudo` it is refused up front (exit 2), before anything downloads, because the setting would be written as root and the Hub couldn't change the default afterwards. Run the install without `sudo`, or leave `--set-default` out and run `unity editors default <version>` as yourself afterwards.
|
|
339
|
+
|
|
340
|
+
#### Another operating system's Editor (`--operating-system`)
|
|
341
|
+
|
|
342
|
+
`unity releases` and `unity install --dry-run` look up the host's OS by default. `--operating-system <windows|macos|linux>` looks up another one, so you can check what a Windows build machine would download from a Mac. It has no short flag.
|
|
343
|
+
|
|
344
|
+
```bash
|
|
345
|
+
# Windows releases, from any host
|
|
346
|
+
unity releases --operating-system windows --limit 5 --format json
|
|
347
|
+
|
|
348
|
+
# What a Windows install of this version and its modules would download (il2cpp resolves to windows-il2cpp)
|
|
349
|
+
unity install 6000.0.47f1 --dry-run --operating-system windows -m il2cpp --format json
|
|
350
|
+
```
|
|
351
|
+
|
|
352
|
+
Another OS's listing asks for the builds that OS ships and prefers its usual one: arm64 on macOS, x86_64 on Windows and Linux. Pass `--architecture arm64` to `install` for a Windows arm64 build. Its `installed` column is always false, because this machine can't hold another OS's Editor. The dry run's `data.editor` gains `"operatingSystem": "windows"` and `alreadyInstalled` is always false; the human plan adds an `Operating system: Windows` line. Naming the host's own OS changes nothing.
|
|
353
|
+
|
|
354
|
+
The CLI never runs another OS's installer. Without `--dry-run` or `--download-only`, or with `--changeset` or `--resume`, it stops with exit 2 and `CROSS_OS_INSTALL_UNSUPPORTED`, naming the download, the dry run and `unity releases`. To fetch another OS's Editor without installing it, see `--download-only` below. An unknown value is exit 2 with `INVALID_OPERATING_SYSTEM`. `--list-modules` lists an installed Editor's modules, so it can't be combined with `--operating-system` (exit 2); `unity modules` and `unity editors --releases` stay on the host's OS.
|
|
355
|
+
|
|
356
|
+
#### Download without installing (`--download-only`)
|
|
357
|
+
|
|
358
|
+
`unity install <version> --download-only` fetches the Editor and its modules into the Hub's download folder (`<app data>/downloads`, or the Hub's secondary download location when one is set) and stops. Nothing is installed or registered, no installer runs, and no install destination is needed. It takes the same download-file claims as an install, so it never reuses or resumes a payload another install or the Hub is writing. It works for the host's OS and, with `--operating-system <windows|macos|linux>`, for another one, so a build machine's payloads can be staged from any host.
|
|
359
|
+
|
|
360
|
+
```bash
|
|
361
|
+
# Stage the Windows Editor and its il2cpp module from a Mac
|
|
362
|
+
unity install 6000.0.47f1 --download-only --operating-system windows -m il2cpp --accept-eula
|
|
363
|
+
```
|
|
364
|
+
|
|
365
|
+
Each payload is checked against its published size and checksum before the run reports success, and a payload that fails is removed. Only the modules you name with `-m` are fetched, and the license gate is unchanged: a non-interactive run needs `--accept-eula`. The envelope's items end as `downloaded` (listed in `data.completedUids`) and `data.path` is the download folder; the human summary says where the files are and that nothing was installed. `-d/--download-directory` still means a portable install and cannot be combined with it, nor can `--resume`, `--set-default` or `--list-modules` (exit 2). `--changeset` with another OS's `--operating-system` is still refused.
|
|
366
|
+
|
|
367
|
+
#### Linux arm64: experimental x86_64 Editor under FEX-Emu
|
|
368
|
+
|
|
369
|
+
Unity ships no Linux arm64 Editor. On a Linux arm64 host you can opt in to running the x86_64 Editor under [FEX-Emu](https://github.com/FEX-Emu/FEX) by setting `UNITY_EXPERIMENTAL_FEX_EMU=1`. The opt-in takes effect only when a FEX-Emu entry point (`FEX`, or the older `FEXLoader`) is on PATH and an x86_64 RootFS resolves (`FEX_ROOTFS`, or the `RootFS` in FEX-Emu's own `Config.json`); `unity doctor` reports both as its `fex-emu` row. While it is active, `unity install` defaults to `x86_64`, and every Editor launch (`open`, `projects open`, `run`, `test`, `build`, `projects create`) runs as `FEX <editor> <args>` with no `binfmt_misc` needed.
|
|
370
|
+
|
|
371
|
+
This is **experimental and unsupported**: C# script compilation is known to crash under FEX-Emu ([FEX-Emu/FEX#5766](https://github.com/FEX-Emu/FEX/issues/5766)), so don't use it for real development. Every command it affects says so: a warning on stderr for human and tsv output, and a `FEX_EMU_EXPERIMENTAL` entry in the envelope's `notifications` for json and ndjson. Without the opt-in nothing changes.
|
|
372
|
+
|
|
373
|
+
#### Portable install into a folder (`--download-directory`)
|
|
374
|
+
|
|
375
|
+
`-d, --download-directory <dir>` installs a self-contained Editor into a folder you name, for an ephemeral CI workspace or a side-by-side copy. The Editor lands in `<dir>/<version>` (or `<dir>/<version>-<arch>` when that slot is taken), with its own `modules.json` and `metadata.hub.json`. Nothing else changes: the global install path (`unity install-path`), the Hub's Editor list and the Linux desktop entry are left alone, so `unity editors` doesn't list it. A folder outside the Hub's install folder doesn't touch the shared install-state database either. A relative path resolves against the working directory.
|
|
376
|
+
|
|
377
|
+
```bash
|
|
378
|
+
# CI: install into the workspace, no prompts, machine-readable result
|
|
379
|
+
unity install 6000.0.47f1 -d ./.unity -m android --non-interactive --yes --accept-eula --format json
|
|
380
|
+
|
|
381
|
+
# See where it would go first
|
|
382
|
+
unity install 6000.0.47f1 -d ./.unity --dry-run --format json
|
|
383
|
+
|
|
384
|
+
# Add a module later: point install-modules at the same folder
|
|
385
|
+
unity install-modules --editor-version 6000.0.47f1 -d ./.unity -m ios --yes
|
|
386
|
+
|
|
387
|
+
# Register it with the Hub afterwards, if you want it listed (Linux path shown;
|
|
388
|
+
# a human install run prints the exact command for your platform)
|
|
389
|
+
unity editors add ./.unity/6000.0.47f1/Editor/Unity
|
|
390
|
+
```
|
|
391
|
+
|
|
392
|
+
- The json/ndjson result carries the Editor folder as `data.path` (the dry run too). A human run prints the folder and the `unity editors add` command that registers it.
|
|
393
|
+
- Only the target folder is checked for an existing copy: a second install there fails with exit 6 unless you pass `--force`.
|
|
394
|
+
- Installs into different folders run at once: each folder has its own lock, and none of them waits on the Hub's install lock. Two installs of one version into the **same** folder still refuse each other.
|
|
395
|
+
- A `-d` that names the Hub's own install folder (or any folder, when the install-path config can't be read) locks like a normal install: it waits on the Hub's install lock and uses the shared install-state database.
|
|
396
|
+
- `--resume` can't be combined with it (exit 2): there is no per-folder download state to resume. Re-run the install instead.
|
|
397
|
+
- `--list-modules` can't be combined with it either (a usage error, exit 2).
|
|
398
|
+
|
|
399
|
+
### Uninstall
|
|
400
|
+
|
|
401
|
+
```bash
|
|
402
|
+
# Uninstall an editor version
|
|
403
|
+
unity uninstall 6000.0.47f1 --yes
|
|
404
|
+
|
|
405
|
+
# Uninstall a specific architecture
|
|
406
|
+
unity uninstall 6000.0.47f1 --architecture arm64 --yes
|
|
407
|
+
```
|
|
408
|
+
|
|
409
|
+
- The json result (and the one ndjson result frame) carries the removed Editor as `data.version` and `data.architecture`. Under `--format tsv` it is a `key<TAB>value` table of the same two members. A human run prints the completion line.
|
|
410
|
+
- With no version, the stored default Editor is used and announced on stderr (`Using default editor version: ...`), so stdout stays the result alone under every format.
|
|
411
|
+
|
|
412
|
+
---
|
|
413
|
+
|
|
414
|
+
### Modules — add/list per editor
|
|
415
|
+
|
|
416
|
+
```bash
|
|
417
|
+
# List modules for an installed editor
|
|
418
|
+
unity modules 6000.0.47f1 --format json
|
|
419
|
+
|
|
420
|
+
# Filter by architecture
|
|
421
|
+
unity modules 6000.0.47f1 --architecture arm64 --format json
|
|
422
|
+
```
|
|
423
|
+
|
|
424
|
+
`unity modules` honors `--format ndjson` (empty results emit a clean, empty NDJSON stream). The last column is `Aliases` — the alternate module names `-m`/`--module` accepts for that row; under `--format json` it's the `aliases` field (renamed from the old `downloaderName`).
|
|
425
|
+
|
|
426
|
+
### install-modules
|
|
427
|
+
|
|
428
|
+
```bash
|
|
429
|
+
# List available modules without installing
|
|
430
|
+
unity install-modules --editor-version 6000.0.47f1 --list
|
|
431
|
+
|
|
432
|
+
# Install specific modules
|
|
433
|
+
unity install-modules --editor-version 6000.0.47f1 --module android --module ios
|
|
434
|
+
|
|
435
|
+
# Install all available modules
|
|
436
|
+
unity install-modules --editor-version 6000.0.47f1 --all --yes
|
|
437
|
+
|
|
438
|
+
# Include child modules (default behaviour)
|
|
439
|
+
unity install-modules --editor-version 6000.0.47f1 --module android --child-modules
|
|
440
|
+
|
|
441
|
+
# Exclude child modules
|
|
442
|
+
unity install-modules --editor-version 6000.0.47f1 --module android --no-child-modules
|
|
443
|
+
|
|
444
|
+
# Accept EULAs and dry-run
|
|
445
|
+
unity install-modules --editor-version 6000.0.47f1 --all --accept-eula --dry-run
|
|
446
|
+
|
|
447
|
+
# Reinstall modules that are already installed (a repair)
|
|
448
|
+
unity install-modules --editor-version 6000.0.47f1 --module android --reinstall
|
|
449
|
+
|
|
450
|
+
# -f/--force implies --reinstall, auto-includes child modules, and skips confirmation prompts
|
|
451
|
+
unity install-modules --editor-version 6000.0.47f1 --module android --force
|
|
452
|
+
|
|
453
|
+
# Tune the automatic retry for modules whose download/validation fails intermittently
|
|
454
|
+
# (default retries twice with backoff; 0 disables). Also via UNITY_INSTALL_RETRIES.
|
|
455
|
+
unity install-modules --editor-version 6000.0.47f1 --module android --retries 3
|
|
456
|
+
unity install-modules --editor-version 6000.0.47f1 --module android --retries 0
|
|
457
|
+
|
|
458
|
+
# Windows: skip the elevated (UAC) install helper (also via UNITY_NO_ELEVATE=1)
|
|
459
|
+
unity install-modules --editor-version 6000.0.47f1 --module android --no-elevate
|
|
460
|
+
|
|
461
|
+
# An Editor installed with `unity install --download-directory`: look it up in that folder
|
|
462
|
+
unity install-modules --editor-version 6000.0.47f1 --download-directory ./.unity --module android
|
|
463
|
+
```
|
|
464
|
+
|
|
465
|
+
`--list` and `--all` are mutually exclusive. `--list` is also mutually exclusive with `--module`.
|
|
466
|
+
|
|
467
|
+
A module whose download or validation fails intermittently — common for large modules such as Android SDK/NDK and OpenJDK — is retried automatically (up to twice with exponential backoff by default) instead of failing the whole run; already-installed modules are never re-downloaded, and retry attempts surface in both human and `--format ndjson` output.
|
|
468
|
+
|
|
469
|
+
`--module android ios` (space-separated values after a single `--module`) and `--module android --module ios` (repeated flag) are equivalent — both install all listed modules.
|
|
470
|
+
|
|
471
|
+
`--child-modules` / `--no-child-modules` is the primary spelling on both `install` and `install-modules`, matching `unity editors module add`; the old `--cm` / `--no-cm` shorts keep working as hidden aliases.
|
|
472
|
+
|
|
473
|
+
Module discovery works for editors registered via `unity editors add <path>` (located editors), not just editors installed by the Hub.
|
|
474
|
+
|
|
475
|
+
---
|
|
476
|
+
|