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,58 @@
|
|
|
1
|
+
# Cloud Code Reference
|
|
2
|
+
|
|
3
|
+
## Table of Contents
|
|
4
|
+
|
|
5
|
+
- [Four Execution Models](#four-execution-models)
|
|
6
|
+
- [Cloud Code Modules vs CloudBehaviours](#cloud-code-modules-vs-cloudbehaviours)
|
|
7
|
+
- [Where the details live](#where-the-details-live)
|
|
8
|
+
|
|
9
|
+
Accessed via `CloudCodeService.Instance` (`ICloudCodeService`, namespace `Unity.Services.CloudCode`). Assembly: `Unity.Services.CloudCode`.
|
|
10
|
+
|
|
11
|
+
Call `UnityServices.InitializeAsync()` from `com.unity.services.core` and sign in via `com.unity.services.authentication` before use.
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## Four Execution Models
|
|
16
|
+
|
|
17
|
+
| Model | Language | Client Method | Deployed as |
|
|
18
|
+
|---|---|---|---|
|
|
19
|
+
| **Scripts** | JavaScript | `CallEndpointAsync` | `.js` files via Deployment Window |
|
|
20
|
+
| **Legacy modules** | C# (.NET 8, up to .NET 10) | generated bindings, or `CallModuleEndpointAsync` | `.ccmr` references to a .NET solution built outside Unity |
|
|
21
|
+
| **Cloud Code modules** | C# (.NET 8; .NET 10 on Unity 6.7+) | generated bindings only | `.ccmu` assets, authored natively in the Editor |
|
|
22
|
+
| **CloudBehaviours** (experimental) | C# (.NET 8; .NET 10 on Unity 6.7+) | generated bindings — `await behaviour.Method(args)` | `.ccmu` assets, authored natively in the Editor |
|
|
23
|
+
|
|
24
|
+
**Recommendation:** Prefer **C#** over JavaScript scripts for production — type safety, generated client
|
|
25
|
+
bindings, and access to NuGet packages. Do not write new scripts; maintain and call existing ones. Prefer authoring
|
|
26
|
+
natively in the Editor (`.ccmu`) over a `.ccmr` reference for new work: the module lives in the project,
|
|
27
|
+
compiles with it, and needs no separate solution. Between Cloud Code modules and CloudBehaviours, see
|
|
28
|
+
the breakdown below.
|
|
29
|
+
|
|
30
|
+
### Cloud Code Modules vs CloudBehaviours
|
|
31
|
+
|
|
32
|
+
Both are C# modules, and both can hold state per scope with `[StateScope]`. They differ in how the client
|
|
33
|
+
reaches them and in whether that state reaches the client on its own:
|
|
34
|
+
|
|
35
|
+
| | Cloud Code modules | CloudBehaviours |
|
|
36
|
+
|---|---|---|
|
|
37
|
+
| **Endpoint naming** | one function per `[CloudCodeFunction]` | one generated `[CloudCodeFunction]` per public method you define, named `Behaviour__Method` |
|
|
38
|
+
| **Scoped state** | `[StateScope]` persists public fields per player or session | the same, and public fields also synchronize to clients |
|
|
39
|
+
| **Client updates** | request/response; subscribe by hand for push messages | synchronized fields and push events arrive on the generated bindings |
|
|
40
|
+
| **Client code** | you write the call and deserialize the result | the bindings partial is generated from the cloud class |
|
|
41
|
+
| **Requires** | `com.unity.services.cloudcode` `3.0.0`+, Unity 6000.5+ | `com.unity.services.cloudcode` `3.1.0-exp.1`+, Unity 6000.5+ |
|
|
42
|
+
|
|
43
|
+
**Use CloudBehaviours when clients need to see the state** — shared match state, an inventory the client
|
|
44
|
+
displays, per-player views of a shared secret, or a server-owned timer whose deadline the client shows.
|
|
45
|
+
The bindings, the synchronization and the push plumbing are generated, so it is less code and less
|
|
46
|
+
error-prone than a module plus hand-written calls and subscriptions.
|
|
47
|
+
|
|
48
|
+
**Use Cloud Code modules when the client only needs the result of a call** — validating a purchase, awarding a
|
|
49
|
+
reward, calling another service, running a trigger on a schedule. Scoped state still works; simpler than
|
|
50
|
+
using CloudBehaviours if there is no need for state synchronization.
|
|
51
|
+
|
|
52
|
+
## Where the details live
|
|
53
|
+
|
|
54
|
+
| Reference | Covers |
|
|
55
|
+
| :-- | :-- |
|
|
56
|
+
| `references/cloud-code-modules.md` | Cloud Code modules (`.ccmu`), legacy modules (`.ccmr`) and scripts — creating a `.ccmu`, the `.ccmu` asset and how the deployed module name is derived, `ICloudCodeService`, subscriptions, triggers, module scope, generated bindings, deployment, error handling |
|
|
57
|
+
| `references/cloud-code-cloudbehaviours.md` | CloudBehaviours — the authoring model, synchronized state, per-viewer projections, timers, access control |
|
|
58
|
+
|
|
@@ -93,7 +93,7 @@ Task<List<EntityData>> QueryAsync(Query query, QueryOptions options)
|
|
|
93
93
|
Read-only from the client. Write via Cloud Code modules or `IAdminClient.CloudSaveData` from the `com.unity.services.apis` package. All methods require a `customDataID` parameter -- the namespace configured in the Unity Dashboard.
|
|
94
94
|
|
|
95
95
|
> **To write Custom Data from the editor or a deploy command**, use `IAdminClient.CloudSaveData.SetCustomItem` /
|
|
96
|
-
> `SetCustomItemBatch`. See
|
|
96
|
+
> `SetCustomItemBatch`. See `references/apis.md` for setup and code templates. The client SDK has no write
|
|
97
97
|
> path for Custom Data.
|
|
98
98
|
|
|
99
99
|
```csharp
|
|
@@ -448,27 +448,17 @@ catch (CloudSaveException ex)
|
|
|
448
448
|
|
|
449
449
|
### `CloudSaveExceptionReason` Enum
|
|
450
450
|
|
|
451
|
-
| Reason | Value | Meaning |
|
|
452
|
-
|---|---|---|
|
|
453
|
-
| `Unknown` | 0 | Unknown error |
|
|
454
|
-
| `NoInternetConnection` | 1 | No network |
|
|
455
|
-
| `ProjectIdMissing` | 2 | Project ID not set |
|
|
456
|
-
| `PlayerIdMissing` | 3 | Player not signed in |
|
|
457
|
-
| `AccessTokenMissing` | 4 | No access token |
|
|
458
|
-
| `InvalidArgument` | 5 | Bad input |
|
|
459
|
-
| `Unauthorized` | 6 | Not authorized |
|
|
460
|
-
| `KeyLimitExceeded` | 7 | Too many keys stored |
|
|
461
|
-
| `NotFound` | 8 | Key not found |
|
|
462
|
-
| `TooManyRequests` | 9 | Rate limited |
|
|
463
|
-
| `ServiceUnavailable` | 10 | Service down |
|
|
464
|
-
| `Conflict` | 11 | Write-lock conflict |
|
|
465
|
-
|
|
466
|
-
---
|
|
467
|
-
|
|
468
|
-
## Asset Store Building Blocks
|
|
469
|
-
|
|
470
|
-
The following Building Blocks from the Unity Asset Store demonstrate Cloud Save patterns:
|
|
471
|
-
|
|
472
|
-
- **Achievements Building Block** — Reads/writes achievement records in Protected buckets via Cloud Code, with Access Control denying direct player writes. [Asset Store](https://assetstore.unity.com/packages/essentials/tutorial-projects/unity-building-block-achievements-341918)
|
|
473
|
-
- **Player Account Building Block** — Stores player profile data in Default and Public access classes with direct client writes for non-sensitive data. [Asset Store](https://assetstore.unity.com/packages/essentials/tutorial-projects/unity-building-block-player-account-341928)
|
|
474
|
-
- **Leaderboards Building Block** — Uses Cloud Save for player score data alongside Cloud Code modules. [Asset Store](https://assetstore.unity.com/packages/essentials/tutorial-projects/unity-building-block-leaderboards-341926)
|
|
451
|
+
| Reason | Value | Meaning | Fix |
|
|
452
|
+
|---|---|---| :-- |
|
|
453
|
+
| `Unknown` | 0 | Unknown error | Log `ex.Message`, retry once, then report it |
|
|
454
|
+
| `NoInternetConnection` | 1 | No network | Retry when connectivity returns |
|
|
455
|
+
| `ProjectIdMissing` | 2 | Project ID not set | Link the project in **Project Settings > Services** |
|
|
456
|
+
| `PlayerIdMissing` | 3 | Player not signed in | Sign in before calling Cloud Save |
|
|
457
|
+
| `AccessTokenMissing` | 4 | No access token | Sign in and check the token has not expired |
|
|
458
|
+
| `InvalidArgument` | 5 | Bad input | Correct the keys or values named in the validation details |
|
|
459
|
+
| `Unauthorized` | 6 | Not authorized | Check the access class and any Access Control policy denying the call |
|
|
460
|
+
| `KeyLimitExceeded` | 7 | Too many keys stored | Delete unused keys |
|
|
461
|
+
| `NotFound` | 8 | Key not found | Check the key and the access class used to read it |
|
|
462
|
+
| `TooManyRequests` | 9 | Rate limited | Back off and retry after `RetryAfter` |
|
|
463
|
+
| `ServiceUnavailable` | 10 | Service down | Retry with backoff |
|
|
464
|
+
| `Conflict` | 11 | Write-lock conflict | Reload the keys, merge your change and retry with the new write lock |
|
|
@@ -32,14 +32,16 @@ Each service package registers its own file types with the Deployment Window. In
|
|
|
32
32
|
| Service | Package | File Type(s) | Min Version |
|
|
33
33
|
|---|---|---|---|
|
|
34
34
|
| Cloud Code Scripts | `com.unity.services.cloudcode` | `.js` | 2.1.0 |
|
|
35
|
-
| Cloud Code C# Modules | `com.unity.services.cloudcode` | `.
|
|
35
|
+
| Cloud Code C# Modules (native) | `com.unity.services.cloudcode` | `.ccmu` | 3.0.0 |
|
|
36
|
+
| Cloud Code C# Modules (legacy) | `com.unity.services.cloudcode` | `.ccmr` | 2.5.0 |
|
|
36
37
|
| Remote Config | `com.unity.remote-config` | `.rc` | 3.2.0 |
|
|
37
|
-
| Economy | `com.unity.services.economy` | `.ecc`, `.eci`, `.ecv`, `.ecr` | 3.2.1 |
|
|
38
38
|
| Leaderboards | `com.unity.services.leaderboards` | `.lb` | 2.0.0 |
|
|
39
39
|
| Game Server Hosting | `com.unity.services.multiplayer` | `.gsh` | 1.1.0 |
|
|
40
40
|
| Matchmaker | `com.unity.services.multiplayer` | `.mmq` | 1.0 |
|
|
41
41
|
| Game Overrides | `com.unity.services.tooling` | `.ugo` | 1.3.0 |
|
|
42
42
|
| Access Control | `com.unity.services.tooling` | `.ac` | 1.0 |
|
|
43
|
+
| Triggers | `com.unity.services.tooling` | `.tr` | 1.4.2 |
|
|
44
|
+
| Scheduler | `com.unity.services.tooling` | `.sched` | 1.4.2 |
|
|
43
45
|
| Deployment Definitions | `com.unity.services.deployment` | `.ddef` | -- |
|
|
44
46
|
|
|
45
47
|
## Workflow
|
|
@@ -190,27 +192,40 @@ static void RegisterProvider()
|
|
|
190
192
|
> `com.unity.services.apis` package (`com.unity.services.apis`). Authenticate with a service
|
|
191
193
|
> account via `adminClient.SetServiceAccount(keyId, keySecret)`, then call the appropriate
|
|
192
194
|
> admin API (e.g. `adminClient.CloudSaveData.SetCustomItem` for Cloud Save game data).
|
|
193
|
-
> See
|
|
195
|
+
> See `references/apis.md` for the full `IAdminClient` interface and code templates.
|
|
194
196
|
|
|
195
197
|
### Code Template -- Trigger Deployment Programmatically
|
|
196
198
|
|
|
199
|
+
Run it with `unity command run_script --file AgentScripts/Deploy.cs --entry Deploy.Run --args '[["Assets/MyConfig.rc"]]'`
|
|
200
|
+
(needs the `com.unity.pipeline` and `com.unity.services.deployment.api` packages; keep the file outside `Assets/`). `DeploymentWindow` throws
|
|
201
|
+
*"Deployment Window must be opened for this operation."* until the window is open, so the script opens it
|
|
202
|
+
and waits.
|
|
203
|
+
|
|
197
204
|
```csharp
|
|
205
|
+
// AgentScripts/Deploy.cs — deploys to the active environment. Await; never .Wait(), which deadlocks the main thread.
|
|
206
|
+
using System.Linq;
|
|
207
|
+
using System.Threading.Tasks;
|
|
198
208
|
using Unity.Services.DeploymentApi.Editor;
|
|
209
|
+
using UnityEditor;
|
|
199
210
|
|
|
200
|
-
|
|
201
|
-
var allItems = Deployments.Instance.DeploymentWindow.GetAllDeploymentItems();
|
|
202
|
-
var result = await Deployments.Instance.DeploymentWindow.Deploy(allItems);
|
|
203
|
-
|
|
204
|
-
// Deploy by file paths
|
|
205
|
-
await Deployments.Instance.DeploymentWindow.Deploy(new[] { "Assets/MyConfig.rc" });
|
|
206
|
-
|
|
207
|
-
// Listen for deployment events
|
|
208
|
-
Deployments.Instance.DeploymentWindow.DeploymentStarting += items =>
|
|
209
|
-
{
|
|
210
|
-
Debug.Log($"Deploying {items.Count} items...");
|
|
211
|
-
};
|
|
212
|
-
Deployments.Instance.DeploymentWindow.DeploymentEnded += items =>
|
|
211
|
+
public static class Deploy
|
|
213
212
|
{
|
|
214
|
-
|
|
215
|
-
|
|
213
|
+
public static async Task<string> Run(string[] paths)
|
|
214
|
+
{
|
|
215
|
+
var deployments = Deployments.Instance;
|
|
216
|
+
if (!(deployments.DeploymentWindow is EditorWindow))
|
|
217
|
+
deployments.DeploymentWindow.OpenWindow();
|
|
218
|
+
for (var i = 0; i < 100 && !(deployments.DeploymentWindow is EditorWindow); i++)
|
|
219
|
+
await Task.Delay(100);
|
|
220
|
+
|
|
221
|
+
var items = deployments.DeploymentWindow.GetFromFiles(paths);
|
|
222
|
+
var found = items.Where(item => item != null).ToList();
|
|
223
|
+
// Deploy all items instead: await deployments.DeploymentWindow.Deploy(deployments.DeploymentWindow.GetAllDeploymentItems());
|
|
224
|
+
if (found.Count > 0)
|
|
225
|
+
await deployments.DeploymentWindow.Deploy(found);
|
|
226
|
+
return string.Join("\n", paths.Select((path, i) => items[i] == null
|
|
227
|
+
? $"{path}: not a deployable item"
|
|
228
|
+
: $"{path}: {items[i].Status.MessageSeverity} {items[i].Status.Message} {items[i].Status.MessageDetail}"));
|
|
229
|
+
}
|
|
230
|
+
}
|
|
216
231
|
```
|
|
@@ -31,7 +31,6 @@
|
|
|
31
31
|
- [PlayerAccountsException](#playeraccountsexception)
|
|
32
32
|
- [CloudSaveException](#cloudsaveexception)
|
|
33
33
|
- [Validation](#validation)
|
|
34
|
-
- [Asset Store Building Block](#asset-store-building-block)
|
|
35
34
|
|
|
36
35
|
---
|
|
37
36
|
|
|
@@ -124,9 +123,13 @@ Ensure the following packages are listed in `Packages/manifest.json`:
|
|
|
124
123
|
**Optional** — add `com.unity.services.cloudcode` if using Protected player data or Custom (shared) data:
|
|
125
124
|
|
|
126
125
|
```json
|
|
127
|
-
"com.unity.services.cloudcode": "
|
|
126
|
+
"com.unity.services.cloudcode": "3.0.0"
|
|
128
127
|
```
|
|
129
128
|
|
|
129
|
+
> `com.unity.services.cloudcode` **`3.0.0`** is the native-authoring line, which the `.ccmu` module
|
|
130
|
+
> below requires — see the Requirements section of `references/cloud-code-modules.md`. The `2.10.x` line
|
|
131
|
+
> deploys legacy `.ccmr` modules only; use it when maintaining one, not for new work.
|
|
132
|
+
|
|
130
133
|
---
|
|
131
134
|
|
|
132
135
|
## Sign-In: Anonymous
|
|
@@ -437,13 +440,24 @@ if (result.TryGetValue("player_level", out var item))
|
|
|
437
440
|
|
|
438
441
|
Writes to Protected and Custom buckets must go through a Cloud Code module. The module uses `IGameApiClient` with the service token to call Cloud Save server-side APIs.
|
|
439
442
|
|
|
440
|
-
|
|
443
|
+
Create it with the Editor rather than by hand: right-click a folder under `Assets/` →
|
|
444
|
+
**Create > Services > Cloud Code Module Script** and name it `PlayerAccountModule`. See
|
|
445
|
+
the Creating a Cloud Code Module section of `references/cloud-code-modules.md`.
|
|
446
|
+
The Editor generates the following — use the list to check what you got, not as files to type out. There is
|
|
447
|
+
no `.sln`, `.csproj`, `.pubxml` or test project.
|
|
448
|
+
|
|
449
|
+
- [ ] `Assets/CloudCode/PlayerAccountModule/PlayerAccountModule.ccmu` (holds the two asmdef GUIDs)
|
|
450
|
+
- [ ] `Cloud/PlayerAccountModule.asmdef` — Editor-only, `noEngineReferences`, `autoReferenced: false`
|
|
451
|
+
- [ ] `Cloud/PlayerAccountModule.cs` — rename/replace with the `[CloudCodeFunction]` endpoints
|
|
452
|
+
- [ ] `Client/PlayerAccountModuleClient.asmdef` — references the cloud assembly
|
|
453
|
+
- [ ] `Client/PlayerAccountModuleClient.cs` — `[CloudModuleClient(typeof(PlayerAccountModule))]` partial
|
|
454
|
+
|
|
455
|
+
One file the Editor does **not** generate, which this module needs because its endpoints inject
|
|
456
|
+
`IGameApiClient`:
|
|
441
457
|
|
|
442
|
-
- [ ]
|
|
443
|
-
|
|
444
|
-
|
|
445
|
-
- [ ] `Properties/PublishProfiles/FolderProfile.pubxml` — **without this file, deployment fails with "Failed to retrieve main project"**
|
|
446
|
-
- [ ] `Assets/CloudCode/<ModuleName>.ccmr` (points to the `.sln`)
|
|
458
|
+
- [ ] `Cloud/CloudSetup.cs` — an `ICloudCodeSetup` calling `config.AddGameApiClient()`
|
|
459
|
+
|
|
460
|
+
The deployed module name is the **cloud asmdef's name** (`PlayerAccountModule`), not the `.ccmu` filename.
|
|
447
461
|
|
|
448
462
|
---
|
|
449
463
|
|
|
@@ -741,11 +755,11 @@ catch (RequestFailedException ex)
|
|
|
741
755
|
|
|
742
756
|
Key error codes:
|
|
743
757
|
|
|
744
|
-
| Constant | Value | Meaning |
|
|
745
|
-
|---|---|---|
|
|
746
|
-
| `AccountAlreadyLinked` | 10003 | Username already exists (on sign-up) or external ID already linked |
|
|
747
|
-
| `InvalidParameters` | 10002 | Bad input parameters |
|
|
748
|
-
| `ClientInvalidUserState` | 10000 | Operation not valid in current state |
|
|
758
|
+
| Constant | Value | Meaning | Fix |
|
|
759
|
+
|---|---|---| :-- |
|
|
760
|
+
| `AccountAlreadyLinked` | 10003 | Username already exists (on sign-up) or external ID already linked | Sign in instead on sign-up, or link with `ForceLink` only after the player confirms |
|
|
761
|
+
| `InvalidParameters` | 10002 | Bad input parameters | Validate the input before the call |
|
|
762
|
+
| `ClientInvalidUserState` | 10000 | Operation not valid in current state | Check the player's sign-in state before the call |
|
|
749
763
|
|
|
750
764
|
### PlayerAccountsException
|
|
751
765
|
|
|
@@ -764,10 +778,10 @@ catch (PlayerAccountsException ex)
|
|
|
764
778
|
|
|
765
779
|
Key error codes (from `PlayerAccountsErrorCodes`):
|
|
766
780
|
|
|
767
|
-
| Constant | Value | Meaning |
|
|
768
|
-
|---|---|---|
|
|
769
|
-
| `InvalidState` | 10101 | Player is already signed in |
|
|
770
|
-
| `MissingClientId` | 10102 | Client ID not configured in Unity Dashboard |
|
|
781
|
+
| Constant | Value | Meaning | Fix |
|
|
782
|
+
|---|---|---| :-- |
|
|
783
|
+
| `InvalidState` | 10101 | Player is already signed in | Check `PlayerAccountService.Instance.IsSignedIn` before `StartSignInAsync` |
|
|
784
|
+
| `MissingClientId` | 10102 | Client ID not configured in Unity Dashboard | Configure the Unity identity provider's client ID in the Unity Dashboard |
|
|
771
785
|
|
|
772
786
|
### CloudSaveException
|
|
773
787
|
|
|
@@ -805,9 +819,3 @@ After implementing a player account feature, verify:
|
|
|
805
819
|
4. **SignedIn event wiring:** `PlayerAccountService.Instance.SignedIn` is subscribed **before** calling `StartSignInAsync()`. The `StartSignInAsync` Task completes when the browser opens, not when sign-in finishes.
|
|
806
820
|
5. **Access class matching:** Data saved with `PublicWriteAccessClassOptions` is loaded with `PublicReadAccessClassOptions`. Data saved with no options (Default) is loaded with `DefaultReadAccessClassOptions` or no options. Mismatched access classes return empty results without error.
|
|
807
821
|
6. **SignOut is synchronous:** `AuthenticationService.Instance.SignOut()` and `PlayerAccountService.Instance.SignOut()` are both `void` methods. Do not `await` them.
|
|
808
|
-
|
|
809
|
-
---
|
|
810
|
-
|
|
811
|
-
## Asset Store Building Block
|
|
812
|
-
|
|
813
|
-
- **Player Account Building Block:** Complete reference implementation with sign-in UI (anonymous, Unity browser, username/password), Cloud Save data management, and a Cloud Code module with generated client bindings. [Asset Store](https://assetstore.unity.com/packages/essentials/tutorial-projects/unity-building-block-player-account-341928)
|
|
@@ -45,7 +45,6 @@ Access Control policies permit or deny access to UGS services on a **URN basis**
|
|
|
45
45
|
|
|
46
46
|
Common use cases:
|
|
47
47
|
- Deny direct player writes to Cloud Save (force writes through Cloud Code)
|
|
48
|
-
- Deny player currency/inventory writes in Economy (only allow purchases)
|
|
49
48
|
- Restrict Cloud Code module/script invocation to specific endpoints
|
|
50
49
|
- Deny player account deletion or identity unlinking
|
|
51
50
|
|
|
@@ -114,17 +113,6 @@ urn:ugs:<service>:/<path>
|
|
|
114
113
|
| `urn:ugs:cloud-save:/**/players/public/query**` | Query Public player data |
|
|
115
114
|
| `urn:ugs:cloud-save:/**/custom/*/items**` | Read game-wide (Custom) data items |
|
|
116
115
|
|
|
117
|
-
#### Economy (`economy`)
|
|
118
|
-
|
|
119
|
-
| URN Pattern | Description |
|
|
120
|
-
|---|---|
|
|
121
|
-
| `urn:ugs:economy:/**/players/*/config**` | Read player economy configuration |
|
|
122
|
-
| `urn:ugs:economy:/**/currencies**` | Player currencies (Read/Write) |
|
|
123
|
-
| `urn:ugs:economy:/**/inventory**` | Player inventory (Read/Write) |
|
|
124
|
-
| `urn:ugs:economy:/**/purchases/virtual**` | Virtual purchases |
|
|
125
|
-
| `urn:ugs:economy:/**/purchases/googleplaystore**` | Google Play Store purchases |
|
|
126
|
-
| `urn:ugs:economy:/**/purchases/appleappstore**` | Apple App Store purchases |
|
|
127
|
-
|
|
128
116
|
#### Leaderboards (`leaderboards`)
|
|
129
117
|
|
|
130
118
|
| URN Pattern | Description |
|
|
@@ -196,48 +184,6 @@ Start with a blanket deny, then explicitly allow only what the player needs. Thi
|
|
|
196
184
|
"Principal": "Player",
|
|
197
185
|
"Resource": "urn:ugs:player-auth:/.well-known/**"
|
|
198
186
|
},
|
|
199
|
-
{
|
|
200
|
-
"Sid": "Allow-Read-Economy-Config",
|
|
201
|
-
"Effect": "Allow",
|
|
202
|
-
"Action": ["Read"],
|
|
203
|
-
"Principal": "Player",
|
|
204
|
-
"Resource": "urn:ugs:economy:/**/players/*/config**"
|
|
205
|
-
},
|
|
206
|
-
{
|
|
207
|
-
"Sid": "Allow-Read-Currencies",
|
|
208
|
-
"Effect": "Allow",
|
|
209
|
-
"Action": ["Read"],
|
|
210
|
-
"Principal": "Player",
|
|
211
|
-
"Resource": "urn:ugs:economy:/**/currencies**"
|
|
212
|
-
},
|
|
213
|
-
{
|
|
214
|
-
"Sid": "Allow-Read-Inventory",
|
|
215
|
-
"Effect": "Allow",
|
|
216
|
-
"Action": ["Read"],
|
|
217
|
-
"Principal": "Player",
|
|
218
|
-
"Resource": "urn:ugs:economy:/**/inventory**"
|
|
219
|
-
},
|
|
220
|
-
{
|
|
221
|
-
"Sid": "Allow-Virtual-Purchases",
|
|
222
|
-
"Effect": "Allow",
|
|
223
|
-
"Action": ["Write"],
|
|
224
|
-
"Principal": "Player",
|
|
225
|
-
"Resource": "urn:ugs:economy:/**/purchases/virtual**"
|
|
226
|
-
},
|
|
227
|
-
{
|
|
228
|
-
"Sid": "Allow-GooglePlay-Purchases",
|
|
229
|
-
"Effect": "Allow",
|
|
230
|
-
"Action": ["Write"],
|
|
231
|
-
"Principal": "Player",
|
|
232
|
-
"Resource": "urn:ugs:economy:/**/purchases/googleplaystore**"
|
|
233
|
-
},
|
|
234
|
-
{
|
|
235
|
-
"Sid": "Allow-AppStore-Purchases",
|
|
236
|
-
"Effect": "Allow",
|
|
237
|
-
"Action": ["Write"],
|
|
238
|
-
"Principal": "Player",
|
|
239
|
-
"Resource": "urn:ugs:economy:/**/purchases/appleappstore**"
|
|
240
|
-
},
|
|
241
187
|
{
|
|
242
188
|
"Sid": "Allow-Read-Leaderboards",
|
|
243
189
|
"Effect": "Allow",
|
|
@@ -330,8 +276,6 @@ This policy:
|
|
|
330
276
|
- **Denies** all UGS access by default
|
|
331
277
|
- **Allows** authentication (anonymous, external, session token sign-in; link external ID; read player info)
|
|
332
278
|
- **Denies** identity unlinking and player deletion (inherited from blanket deny)
|
|
333
|
-
- **Allows** economy reads (config, currencies, inventory) and purchases (virtual, Google Play, Apple App Store)
|
|
334
|
-
- **Denies** direct currency/inventory writes (inherited from blanket deny — use Cloud Code for server grants)
|
|
335
279
|
- **Allows** leaderboard reads
|
|
336
280
|
- **Allows** Cloud Save player data reads/writes for own data (Default items), public data reads, game-wide data reads
|
|
337
281
|
- **Denies** Cloud Save blanket writes (Protected data only writable via Cloud Code)
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
# UGS CLI Reference
|
|
2
|
+
|
|
3
|
+
## Table of Contents
|
|
4
|
+
|
|
5
|
+
- [Overview](#overview)
|
|
6
|
+
- [Install and Update](#install-and-update)
|
|
7
|
+
- [If the Unity CLI Itself Is Missing](#if-the-unity-cli-itself-is-missing)
|
|
8
|
+
- [Auth and Project Setup](#auth-and-project-setup)
|
|
9
|
+
- [Running Commands](#running-commands)
|
|
10
|
+
- [Headless Deploy by File Type](#headless-deploy-by-file-type)
|
|
11
|
+
- [Credentials and Environment](#credentials-and-environment)
|
|
12
|
+
|
|
13
|
+
## Overview
|
|
14
|
+
|
|
15
|
+
The [Unity Gaming Services CLI](https://github.com/Unity-Technologies/unity-gaming-services-cli/) manages UGS resources outside the Unity Editor: deploy and fetch cloud resource files, manage triggers and schedules, and reach admin functionality across all UGS services. Every command in this reference is invoked as `unity ugs <command>` — there is no standalone `ugs` form.
|
|
16
|
+
|
|
17
|
+
## Install and Update
|
|
18
|
+
|
|
19
|
+
**It ships as a Unity CLI plugin**, so install and update it through the Unity CLI rather than downloading it separately. Before running any `unity ugs` command, confirm the plugin is installed and install it if it's missing:
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
unity plugin list # every component, its state, and where it resolved from — check ugs is "resolved"
|
|
23
|
+
unity plugin install ugs # install the managed copy, if missing
|
|
24
|
+
unity plugin upgrade ugs # re-install when the pinned build changes
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
If `unity plugin list` shows `ugs` resolved from `path` rather than `managed`, a UGS CLI already on PATH is used instead of the plugin, and may be an older version without the features above (e.g. Hub sign-in needs 2.0.0+). Check `unity ugs --version`; remove the other install or upgrade it.
|
|
28
|
+
|
|
29
|
+
For the plugin system itself (what a managed tool is, `unity plugin remove` / `changelog`), see the **unity-cli** skill.
|
|
30
|
+
|
|
31
|
+
## If the Unity CLI Itself Is Missing
|
|
32
|
+
|
|
33
|
+
If `unity` is not on PATH at all, `unity plugin install ugs` can't run. Don't stop at a raw "command not found" — tell the user to install the Unity CLI first, following the **unity-cli** skill's own install instructions (its own `--help`/docs are the source of truth for the current install command).
|
|
34
|
+
|
|
35
|
+
## Auth and Project Setup
|
|
36
|
+
|
|
37
|
+
Before any `unity ugs` command that talks to the backend, the CLI needs credentials and a target project/environment:
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
unity ugs config set project-id <project-id>
|
|
41
|
+
unity ugs config set environment-name <environment-name>
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
**Developer sign-in — Unity Hub (requires UGS CLI 2.0.0+):** with Unity Hub running and signed in, either run `unity ugs login` with its Hub option (see `unity ugs login --help`) to persist Hub auth, or set `UGS_CLI_USE_HUB_AUTH=true` (also accepts `1`/`yes`/`y`/`t`) to use it for one invocation without logging in — it takes priority over any saved `unity ugs login` and the service-account env vars below for that call. Hub sign-in reads the currently-running Hub's session over its local IPC socket (`/tmp/Unity-hubIPCService.sock` on macOS/Linux, a named pipe on Windows), not a file or keychain, so Hub has to actually be running and signed in on the machine the CLI runs on. The CLI prints bare `ugs` in its messages; run the equivalent as `unity ugs logout` then `unity ugs login`. Hub sign-in failures:
|
|
45
|
+
|
|
46
|
+
| Error string | Cause | Fix |
|
|
47
|
+
| :-- | :-- | :-- |
|
|
48
|
+
| ``Unity Hub is not running. Start Hub or run `ugs logout` then `ugs login` to switch to service account authentication.`` | Hub is not running on this machine | Start Hub and sign in, or switch to a service account |
|
|
49
|
+
| ``Unity Hub user is not signed in. Sign in through Unity Hub or run `ugs logout` then `ugs login` to switch to service account authentication.`` | Hub is running but nobody is signed in | Sign in through Hub, or switch to a service account |
|
|
50
|
+
|
|
51
|
+
Run `unity ugs --version` first — v1.9.0 predates Hub auth; `unity plugin upgrade ugs` if it reports lower than 2.0.0. Note `unity ugs status` does **not** reflect `UGS_CLI_USE_HUB_AUTH` — it only detects a persisted Hub login, so it can still report "no credentials" while a command using the env var succeeds.
|
|
52
|
+
|
|
53
|
+
**Service account — CI / headless:**
|
|
54
|
+
|
|
55
|
+
```bash
|
|
56
|
+
unity ugs login --service-key-id <id> --secret-key-stdin # prompts for the secret key on stdin
|
|
57
|
+
# or set UGS_CLI_SERVICE_KEY_ID / UGS_CLI_SERVICE_SECRET_KEY instead of logging in
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
`unity ugs status` reports whether a service account is currently stored. Run `unity ugs login --help` / `unity ugs config --help` to confirm flags against the installed CLI version before relying on this from memory.
|
|
61
|
+
|
|
62
|
+
## Running Commands
|
|
63
|
+
|
|
64
|
+
Invoke it as `unity ugs <command>`:
|
|
65
|
+
|
|
66
|
+
```bash
|
|
67
|
+
unity ugs login # or UGS_CLI_SERVICE_KEY_ID / UGS_CLI_SERVICE_SECRET_KEY
|
|
68
|
+
unity ugs deploy . --dry-run
|
|
69
|
+
unity ugs fetch . -s remote-config -e production
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
## Headless Deploy by File Type
|
|
73
|
+
|
|
74
|
+
`unity ugs deploy` picks files up by extension and silently skips the rest. A skipped file does not show up in the result at all, so a dry run that lists nothing means nothing was recognised.
|
|
75
|
+
|
|
76
|
+
| Resource | Headless path |
|
|
77
|
+
|---|---|
|
|
78
|
+
| `.ccmu` (native C# module) | **Not the UGS CLI** — `unity ugs deploy` skips `.ccmu`. The Editor compiles the module and deploys it: the Deployment Window, or headlessly the `Deploy.cs` template in `references/deployment.md`. |
|
|
79
|
+
| `.ccmr` (legacy module) | `unity ugs deploy` skips the `.ccmr` itself — pass the `.sln` it points at: `unity ugs deploy Module~/Module.sln`. The CLI runs `dotnet publish` (needs a .NET SDK on PATH). The Deployment Window deploys the `.ccmr` directly. |
|
|
80
|
+
| `.ccm` (packaged module) | `unity ugs deploy <file>.ccm` |
|
|
81
|
+
| `.rc`, `.ac`, `.lb`, `.js`, `.tr`, `.sched` | `unity ugs deploy <paths>` and `unity ugs fetch <path>`, or the Deployment Window. `--dry-run` first; `--reconcile` deletes remote content not in the deploy. `unity ugs tr new-file <name>` / `unity ugs sched new-file <name>` generate a default trigger / schedule config. |
|
|
82
|
+
| `.ugo` (Game Overrides) | **Not the UGS CLI** — `unity ugs deploy` skips `.ugo`. Deploy through the Deployment Window, or headlessly the `Deploy.cs` template in `references/deployment.md`. |
|
|
83
|
+
|
|
84
|
+
## Credentials and Environment
|
|
85
|
+
|
|
86
|
+
`unity ugs deploy`/`fetch` authenticate using whichever CLI credential is active — a service account (`unity ugs login` or its env vars) or, from 2.0.0+, Unity Hub sign-in (see [Auth and Project Setup](#auth-and-project-setup)) — never as the signed-in Editor user, and take the environment as an argument (`-e <name>`). An Editor deploy uses the Editor's own credentials and the project's *active* environment — except that while the local Cloud Code server runs, a Cloud Code module deploy goes to that server instead. Stop the local server before deploying a module remotely.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
# Security notes: craft-game-floors
|
|
2
|
+
|
|
3
|
+
This skill has the agent run C# inside the user's open Unity Editor (applying the craft floors:
|
|
4
|
+
materials, lighting, UI, audio, captures) and, for the live floor, wire Unity Gaming Services
|
|
5
|
+
calls in the user's own project. Automated skill scanners flag these as powerful capabilities.
|
|
6
|
+
They are intentional, and limited by the safeguards below.
|
|
7
|
+
|
|
8
|
+
## Accepted risks
|
|
9
|
+
|
|
10
|
+
| Risk | Capability | Why it is accepted |
|
|
11
|
+
|---|---|---|
|
|
12
|
+
| `SEC_POWER_CAP` | Runs C# in the user's open Editor | It only reaches the Editor the user already has open, on their own machine, as that user, behind the Pipeline capability gate. No code fetched from a remote source is run — the agent runs C# written from this skill's own references, which also require a restore point before project changes. |
|
|
13
|
+
| `SEC_CLOUD` | Wires Cloud Save / Leaderboards / Remote Config client calls (the live floor) | Only against the project's own cloud id, only when a live identity probe succeeds, and declining any floor is one word. Provisioning that needs credentials or the Editor UI is named as a human step, never automated. |
|
|
14
|
+
|
|
15
|
+
## Mitigations
|
|
16
|
+
|
|
17
|
+
- **Restore point first.** The skill requires a rollback point (a clean commit, or one it creates)
|
|
18
|
+
before changing the project.
|
|
19
|
+
- **Floors are declinable.** Every floor reverses on a word; declines are recorded, not argued.
|
|
20
|
+
- **Only the user's own Editor and project.** Everything runs on this machine as this user.
|
|
21
|
+
- **No remote code.** All executed C# comes from this skill's references.
|
|
22
|
+
- **Mechanics route to their owners.** Mixer routing, UI construction, backend integration, and
|
|
23
|
+
import settings go to their dedicated skills rather than being improvised here.
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: craft-game-floors
|
|
3
|
+
description: "Makes a Unity game look and feel finished: art style, lighting, juice, sound, menus, saves and look scoring. Use when building a new game's first playable version, or when a game looks like programmer art, feels flat or silent, or needs polish."
|
|
4
|
+
allowed-tools:
|
|
5
|
+
- Bash
|
|
6
|
+
- Read
|
|
7
|
+
- Write
|
|
8
|
+
- Edit
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Craft Game Floors
|
|
12
|
+
|
|
13
|
+
A functional game that looks and feels like programmer art reads as a failure to the person who
|
|
14
|
+
asked for it. This skill is the craft layer: **floors** — disciplines where every game needs a
|
|
15
|
+
minimum and the engine's defaults are unacceptable — each carried by a reference below with
|
|
16
|
+
opinionated values, worked examples to imitate, and a verify step. The floors are the heart of the
|
|
17
|
+
**paved** path (Unity's default scaffolding for agent-built games: assumptions declared up front,
|
|
18
|
+
reversible on a word); in this skill, "paved" simply means these floors are always on unless the
|
|
19
|
+
user declines one.
|
|
20
|
+
|
|
21
|
+
**Before starting any floor or diagnosis, open and read the matching reference below and the Unity
|
|
22
|
+
docs pages it links** — your engine knowledge may be out of date, wrong, or for a different
|
|
23
|
+
version. Name the files and pages you read in your report. **Do only what's asked. Don't change
|
|
24
|
+
unrelated assets or files. Avoid long explanations.**
|
|
25
|
+
|
|
26
|
+
Two ways in, same floors:
|
|
27
|
+
|
|
28
|
+
- **During project creation** — the `new-unity-project` skill loads this one and carries the
|
|
29
|
+
floors through the build in the order below.
|
|
30
|
+
- **Mid-project, on any craft ask** ("fix the look", "add sound", "it feels flat", "make a title
|
|
31
|
+
screen", "score it") — jump straight to the matching reference, after the mid-flow check below.
|
|
32
|
+
|
|
33
|
+
**Scope by the ask**: a request that authorizes changes ("fix", "add", "polish") gets the floor
|
|
34
|
+
applied; an assessment-only ask ("score it", "what should I fix?") gets the scored board and
|
|
35
|
+
recommendations, with no project modifications until the user says go.
|
|
36
|
+
|
|
37
|
+
## Entering mid-flow
|
|
38
|
+
|
|
39
|
+
The references assume an **art bible** (style statement + fixed palette) and, where audio meets
|
|
40
|
+
UI, the **mixer handshake** (exposed params `MusicVol`/`SFXVol`). On an existing project, run
|
|
41
|
+
these in order before the asked-for floor:
|
|
42
|
+
|
|
43
|
+
1. **Restore point** — confirm a clean commit to roll back to, or create one, before any change.
|
|
44
|
+
2. **Render pipeline** — read `GraphicsSettings.currentRenderPipeline`: the look floors' verifies
|
|
45
|
+
are written for URP; on Built-in or HDRP, apply the opinions, name the pipeline gap, and skip
|
|
46
|
+
the URP-typed checks.
|
|
47
|
+
3. **Art bible** — look for a `Palette` type or an art-bible note (CLAUDE.md, docs); if none
|
|
48
|
+
exists, write the three-line bible from the game's current look first — retro-tinting later is
|
|
49
|
+
the expensive order.
|
|
50
|
+
4. **Identity (live floor only)** — verify player identity with a live probe (services
|
|
51
|
+
initialized and a PlayerId present), never by assuming an earlier setup step ran.
|
|
52
|
+
5. **Scope the done gate** to the surface you touched: a title-screen session scores the shell
|
|
53
|
+
and look axes, not the whole board.
|
|
54
|
+
|
|
55
|
+
**A floor fills an engine default, never a developer's choice.** If the project already has its
|
|
56
|
+
own controller, camera, shader, palette or style, keep it, apply only the floor's opinions that
|
|
57
|
+
don't conflict, and name the difference in the report. Write an art bible only from choices the
|
|
58
|
+
developer has made, and ask before adding one mid-project.
|
|
59
|
+
|
|
60
|
+
## The floors — numbered in build order, read each at its moment
|
|
61
|
+
|
|
62
|
+
1. [art-direction](references/art-direction.md) — before the first material, light, or UI element
|
|
63
|
+
2. [scene-lighting](references/scene-lighting.md) — with the visual baseline (3D)
|
|
64
|
+
3. [toon-shading](references/toon-shading.md) — when the art bible picks a cel/toon style (3D)
|
|
65
|
+
4. [camera-rigs](references/camera-rigs.md) — first gameplay camera (has a 2D section)
|
|
66
|
+
5. [placeholder-assets](references/placeholder-assets.md) — first missing asset
|
|
67
|
+
6. [character-motion](references/character-motion.md) — first moving character (3D-leaning)
|
|
68
|
+
7. *(the playable loop lands here — loop before content, one system per pass)*
|
|
69
|
+
8. [game-feel](references/game-feel.md) — the feel pass, after the loop
|
|
70
|
+
9. [vfx](references/vfx.md) — with the feel pass (has a 2D section)
|
|
71
|
+
10. [game-audio](references/game-audio.md) — before done
|
|
72
|
+
11. [game-shell](references/game-shell.md) — before done (2D backdrop delta). Before the first TextMeshPro text, import TMP Essentials (see the reference's failure table).
|
|
73
|
+
12. [live-floor](references/live-floor.md) — with the shell (services before gameplay code)
|
|
74
|
+
13. [visual-scorecard](references/visual-scorecard.md) — **the done gate, always last; run it once a playable loop exists.** During project creation, stop at the lit-baseline capture and skip the gate.
|
|
75
|
+
|
|
76
|
+
Mid-project asks enter at the matching number and pull earlier floors only as the mid-flow check
|
|
77
|
+
requires (the bible, the pipeline, the identity probe).
|
|
78
|
+
|
|
79
|
+
**Resolving `<VERSION>` in the references' doc links** — prefer WebFetch of the exact page over
|
|
80
|
+
WebSearch: for `docs.unity.com/en-us/engine/<VERSION>` manual and script-reference pages, use the
|
|
81
|
+
project's Editor stream (e.g. `6000.3`) from `ProjectSettings/ProjectVersion.txt`, and the same
|
|
82
|
+
stream for the remaining `docs.unity3d.com/<VERSION>/Documentation` pages; for
|
|
83
|
+
`docs.unity3d.com/Packages/<package>@<VERSION>` pages, use the installed package's major.minor
|
|
84
|
+
from `Packages/manifest.json` or the `Library/PackageCache` folder name; the
|
|
85
|
+
`docs.unity.com/en-us/<service>.md` services pages are unversioned.
|
|
86
|
+
|
|
87
|
+
Routing follows the game's 2D/3D nature; **the 2D look floor (sprite art direction, 2D lights,
|
|
88
|
+
sprite placeholders) is not yet covered** — on a 2D game, say so at those beats rather than
|
|
89
|
+
applying 3D instructions. The scorecard's 2D anchor set still applies.
|
|
90
|
+
|
|
91
|
+
## The boundary (what this skill is not)
|
|
92
|
+
|
|
93
|
+
This skill owns **opinionated creation and floors** — which values, in what order, to what bar.
|
|
94
|
+
Catalog neighbours own **mechanics on existing setups**: volume/post mechanics →
|
|
95
|
+
`urp-postprocessing` · routing sources into existing mixer groups → `audio-setup-mixers` · audio
|
|
96
|
+
import/memory → `optimize-audio` · UI framework choice and construction → `ui` · font assets →
|
|
97
|
+
`optimize-text-mesh-pro` · backend services → `build-live-game` · pixel-perfect 2D →
|
|
98
|
+
`2d-pixel-perfect`. When an ask is purely mechanical, route there; when it's "make it good," it's
|
|
99
|
+
this skill, which then delegates the mechanics. If this index wants to grow, the new thing is a
|
|
100
|
+
catalog skill routed by the prompt, not another floor — a floor must apply to *every* game.
|
|
101
|
+
|
|
102
|
+
## The done gate
|
|
103
|
+
|
|
104
|
+
A craft session ends with [visual-scorecard](references/visual-scorecard.md)'s board — scored
|
|
105
|
+
frames, not a green compile. In order:
|
|
106
|
+
|
|
107
|
+
1. **Score** all six axes per the scorecard. All six at 3 or better is the floor.
|
|
108
|
+
2. **Fix pass** — anything below 3 gets its fix before done (assessment-only asks: scores and
|
|
109
|
+
recommendations, no fixes). If a fix doesn't work, reread the relevant reference and its
|
|
110
|
+
linked documentation before trying variations.
|
|
111
|
+
3. **Console** — confirm zero console errors.
|
|
112
|
+
4. **Play check** — enter Play mode and check the touched behavior with `Debug.Log` lines you
|
|
113
|
+
added for the purpose. If the fix pass or this check fails, reread the relevant reference and
|
|
114
|
+
its linked documentation before trying variations.
|
|
115
|
+
|
|
116
|
+
## Final report
|
|
117
|
+
|
|
118
|
+
State: which floors ran and which references were read · the board (or the scoped axes) before and
|
|
119
|
+
after the fix pass · every incidental side effect — packages installed, files or settings edited,
|
|
120
|
+
assets imported — and any follow-up the user needs · any floor skipped or gap named (the 2D look
|
|
121
|
+
floor, a declined install, a missing neighbour skill), so the user knows what deeper guidance was
|
|
122
|
+
skipped.
|
|
123
|
+
|
|
124
|
+
## Common mistakes
|
|
125
|
+
|
|
126
|
+
- **Polishing without a bible** — fixing one object's look against no palette; write the
|
|
127
|
+
three-line bible first, even mid-project.
|
|
128
|
+
- **Replacing a developer's choice with a floor recipe** — an existing custom controller,
|
|
129
|
+
camera, shader or palette stays; the fix pass never swaps it for the floor's default.
|
|
130
|
+
- **Treating a floor as a feature** — floors are defaults; the user declines one with a word, and
|
|
131
|
+
the decline is recorded in the report, never argued.
|
|
132
|
+
- **Running the mechanics from memory** when a neighbour skill owns them — route and delegate.
|
|
133
|
+
- **Skipping the done gate** because the change was small — scope it down instead.
|
|
134
|
+
- **Applying 3D look instructions to a 2D game** — name the gap instead.
|