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,196 @@
|
|
|
1
|
+
# From authored graph to runtime, and back
|
|
2
|
+
|
|
3
|
+
Graph Toolkit has no runtime. The pattern used by every official sample is: a `ScriptedImporter`
|
|
4
|
+
registered on the graph's extension compiles the authored graph into a plain runtime asset at import
|
|
5
|
+
time, the game loads that asset, and, optionally, editor-only code mirrors execution back into the
|
|
6
|
+
open graph window through the GraphVisualization API.
|
|
7
|
+
|
|
8
|
+
## Contents
|
|
9
|
+
|
|
10
|
+
1. Assembly layout
|
|
11
|
+
2. The importer
|
|
12
|
+
3. Walking nodes and ports
|
|
13
|
+
4. Runtime data model
|
|
14
|
+
5. GraphVisualization: live debug view (6.6+)
|
|
15
|
+
6. Building graphs from code
|
|
16
|
+
|
|
17
|
+
## 1. Assembly layout
|
|
18
|
+
|
|
19
|
+
- `Editor/` (or an Editor-only asmdef): graph, nodes, importer, toolbar, views. Graph Toolkit is an
|
|
20
|
+
Editor module, so its assemblies are available to editor code like `UnityEditor` itself: neither a
|
|
21
|
+
plain `Editor` folder nor an Editor-only asmdef needs a reference entry for it. The official
|
|
22
|
+
samples' editor asmdefs use `IPort` and `PortCapacity` with an empty `references` list.
|
|
23
|
+
- `Runtime/` asmdef: the runtime data model and executor. Must not reference
|
|
24
|
+
`Unity.GraphToolkit.Editor`. Visualization calls live here under `#if UNITY_EDITOR`, because they
|
|
25
|
+
need the editor to be running the game.
|
|
26
|
+
- If the runtime asset type is referenced from the importer, the Editor asmdef references the Runtime
|
|
27
|
+
asmdef, never the reverse.
|
|
28
|
+
|
|
29
|
+
## 2. The importer
|
|
30
|
+
|
|
31
|
+
```csharp
|
|
32
|
+
using Unity.GraphToolkit.Editor;
|
|
33
|
+
using UnityEditor.AssetImporters;
|
|
34
|
+
|
|
35
|
+
[ScriptedImporter(1, DialogueGraph.AssetExtension)] // bump the version to force reimport
|
|
36
|
+
class DialogueGraphImporter : ScriptedImporter
|
|
37
|
+
{
|
|
38
|
+
public override void OnImportAsset(AssetImportContext ctx)
|
|
39
|
+
{
|
|
40
|
+
var graph = GraphDatabase.LoadGraphForImporter<DialogueGraph>(ctx.assetPath);
|
|
41
|
+
if (graph == null)
|
|
42
|
+
{
|
|
43
|
+
Debug.LogError($"Failed to load dialogue graph: {ctx.assetPath}");
|
|
44
|
+
return;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
var runtime = ScriptableObject.CreateInstance<DialogueRuntimeGraph>();
|
|
48
|
+
runtime.GraphId = graph.ID;
|
|
49
|
+
Build(graph, runtime);
|
|
50
|
+
|
|
51
|
+
ctx.AddObjectToAsset("Runtime", runtime);
|
|
52
|
+
ctx.SetMainObject(runtime); // the .ext file now behaves as a DialogueRuntimeGraph in inspectors
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
- Use `LoadGraphForImporter`, not `LoadGraph`, inside importers. The state machine equivalent is
|
|
58
|
+
`StateMachineDatabase.LoadStateMachineForImporter<T>`.
|
|
59
|
+
- A null graph means the path, type or file is wrong; log and return.
|
|
60
|
+
- Validation errors belong in `OnGraphChanged`, which already shows markers; the importer only needs
|
|
61
|
+
to bail out quietly when the graph is invalid.
|
|
62
|
+
- Re-import happens on save. Sub-assets the game needs (textures, meshes) are added with further
|
|
63
|
+
`AddObjectToAsset` calls.
|
|
64
|
+
|
|
65
|
+
## 3. Walking nodes and ports
|
|
66
|
+
|
|
67
|
+
```csharp
|
|
68
|
+
static INode Next(INode node, string outputPortName)
|
|
69
|
+
{
|
|
70
|
+
var port = node.GetOutputPortByName(outputPortName);
|
|
71
|
+
return port?.FirstConnectedPort?.GetNode(); // null when unconnected
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
static T ValueOf<T>(INode node, string inputPortName)
|
|
75
|
+
{
|
|
76
|
+
var port = node.GetInputPortByName(inputPortName);
|
|
77
|
+
if (port.IsConnected)
|
|
78
|
+
{
|
|
79
|
+
var source = port.FirstConnectedPort.GetNode(); // resolve upstream: constant node, variable node, or your node
|
|
80
|
+
if (source is IConstantNode constant && constant.TryGetValue<T>(out var c)) return c;
|
|
81
|
+
if (source is IVariableNode variable && variable.Variable.TryGetDefaultValue<T>(out var d)) return d;
|
|
82
|
+
}
|
|
83
|
+
port.TryGetValue<T>(out var embedded); // the value typed on the node
|
|
84
|
+
return embedded;
|
|
85
|
+
}
|
|
86
|
+
```
|
|
87
|
+
|
|
88
|
+
- Start from a dedicated entry node type: `graph.GetNodes().OfType<StartNode>().FirstOrDefault()`.
|
|
89
|
+
- Ports with `PortCapacity.Multi` need `GetConnectedPorts(list)` rather than `FirstConnectedPort`.
|
|
90
|
+
- Record `node.ID`, `port.ID` and wire endpoints (`outputPort.ID`, `inputPort.ID`) in the runtime
|
|
91
|
+
asset when a debug view is planned; the visualization API is keyed by these `Hash128` values.
|
|
92
|
+
- Block nodes: iterate `contextNode.BlockNodes`; a block's `Index` is its order.
|
|
93
|
+
- Subgraph nodes: `((ISubgraphNode)node).GetSubgraph()` returns the nested `Graph`; recurse.
|
|
94
|
+
|
|
95
|
+
## 4. Runtime data model
|
|
96
|
+
|
|
97
|
+
Keep it minimal and Unity-serializable: a `ScriptableObject` with a list of `[Serializable]` node
|
|
98
|
+
records or `[SerializeReference]` polymorphic nodes, referencing each other by index or `Hash128`.
|
|
99
|
+
Store only what execution needs; positions, titles and colors stay in the authoring asset. The
|
|
100
|
+
Visual Novel Director sample is the reference layout: `Runtime/` asmdef with the data model and a
|
|
101
|
+
`MonoBehaviour` executor that walks the records.
|
|
102
|
+
|
|
103
|
+
## 5. GraphVisualization: live debug view (6.6+)
|
|
104
|
+
|
|
105
|
+
Namespace `Unity.GraphToolkit.Editor.GraphVisualization`, editor-only.
|
|
106
|
+
|
|
107
|
+
```csharp
|
|
108
|
+
#if UNITY_EDITOR
|
|
109
|
+
using Unity.GraphToolkit.Editor.GraphVisualization;
|
|
110
|
+
#endif
|
|
111
|
+
|
|
112
|
+
class DialogueRunner : MonoBehaviour
|
|
113
|
+
{
|
|
114
|
+
#if UNITY_EDITOR
|
|
115
|
+
Context m_Debug;
|
|
116
|
+
#endif
|
|
117
|
+
|
|
118
|
+
void OnEnable()
|
|
119
|
+
{
|
|
120
|
+
#if UNITY_EDITOR
|
|
121
|
+
m_Debug = Registry.CreateVisualizationContext(runtimeGraph.GraphId); // the authored Graph.ID
|
|
122
|
+
#endif
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
void OnDisable()
|
|
126
|
+
{
|
|
127
|
+
#if UNITY_EDITOR
|
|
128
|
+
m_Debug?.Dispose();
|
|
129
|
+
#endif
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
void Enter(DialogueRuntimeNode node)
|
|
133
|
+
{
|
|
134
|
+
#if UNITY_EDITOR
|
|
135
|
+
if (m_Debug is { IsValid: true, IsGraphLoaded: true })
|
|
136
|
+
{
|
|
137
|
+
var nodeRef = m_Debug.GetNodeReference(node.Id);
|
|
138
|
+
m_Debug.Motion.Play(nodeRef, 1f); // animate the accent bar
|
|
139
|
+
m_Debug.GetPortReference(node.TextPortId).SetPreview(node.Text);
|
|
140
|
+
var wire = m_Debug.GetWireReference(node.OutPortId, node.NextInPortId);
|
|
141
|
+
wire.WidthOverride = 6f;
|
|
142
|
+
m_Debug.Motion.Play(wire, 1f);
|
|
143
|
+
}
|
|
144
|
+
#endif
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
```
|
|
148
|
+
|
|
149
|
+
`Registry`: `Context CreateVisualizationContext(Hash128 graphID)`, `Context GetActiveContext(Hash128 graphID)`.
|
|
150
|
+
|
|
151
|
+
`Context` (`IDisposable`): `IsValid`, `IsGraphLoaded`, `GraphMotion Motion`,
|
|
152
|
+
`GetNodeReference(Hash128)`, `GetPortReference(Hash128)`, `GetWireReference(Hash128 outputPortID, Hash128 inputPortID)`,
|
|
153
|
+
`GetStateReference(Hash128)` (6.7), `GetTransitionReference(Hash128)` (6.7), `GetConditionReference(Hash128)` (6.7),
|
|
154
|
+
toggles `NodeCustomizationEnabled`, `PortPreviewEnabled`, `WireCustomizationEnabled`,
|
|
155
|
+
`StateCustomizationEnabled`, `TransitionCustomizationEnabled`, `ConditionCustomizationEnabled`,
|
|
156
|
+
and `ClearAllVisualization()`.
|
|
157
|
+
|
|
158
|
+
- `NodeReference`: `FillAmount`, `ClearCustomization()`.
|
|
159
|
+
- `PortReference`: `SetPreview(string)`, `TryGetPreview(out string)`, `ClearPreview()`.
|
|
160
|
+
- `WireReference`: `IsDashed`, `WidthOverride`, `Opacity`, `ClearCustomization()`.
|
|
161
|
+
- `GraphMotion`: `Play(ref, float speed = 1f)`, `Stop(ref)`, `Pause(ref)` for node, wire, state and
|
|
162
|
+
transition references.
|
|
163
|
+
|
|
164
|
+
Rules of thumb from the samples: create one context per run and dispose it when the run ends; clear
|
|
165
|
+
previews when the flow moves on so they do not pile up; leave traversed wires thicker but stopped to
|
|
166
|
+
show the path taken; add a `[GraphToolbarElement]` toggle that flips the `*Enabled` properties so the
|
|
167
|
+
debug view can be switched off.
|
|
168
|
+
|
|
169
|
+
## 6. Building graphs from code
|
|
170
|
+
|
|
171
|
+
Generators, migrations and tests build assets without the UI:
|
|
172
|
+
|
|
173
|
+
```csharp
|
|
174
|
+
var graph = GraphDatabase.LoadGraph<DungeonGraph>(path) ?? GraphDatabase.CreateGraph<DungeonGraph>(path);
|
|
175
|
+
graph.UndoBeginRecordGraph("Generate dungeon");
|
|
176
|
+
|
|
177
|
+
var start = new StartNode { Position = new Vector2(0, 0) };
|
|
178
|
+
graph.AddNode(start);
|
|
179
|
+
start.GetInputPortByName("Prefab").TrySetValue(startRoomPrefab);
|
|
180
|
+
|
|
181
|
+
var room = new EncounterNode { Position = new Vector2(300, 0) };
|
|
182
|
+
graph.AddNode(room);
|
|
183
|
+
graph.Connect(start.GetOutputPortByName("Output"), room.GetInputPortByName("Input"));
|
|
184
|
+
|
|
185
|
+
var enemies = graph.CreateVariable<GameObject>("Enemy");
|
|
186
|
+
var enemyNode = graph.AddVariableNode(enemies, new Vector2(300, 150));
|
|
187
|
+
graph.Connect(enemyNode.GetOutputPort(0), room.GetInputPortByName("Enemy"));
|
|
188
|
+
|
|
189
|
+
GraphDatabase.SaveGraph(graph);
|
|
190
|
+
graph.UndoEndRecordGraph();
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
Ports exist as soon as the node is added to the graph, because adding triggers `OnDefinePorts`.
|
|
194
|
+
Set `Position` before or after adding; both work. State machines follow the same shape with
|
|
195
|
+
`AddState`, `Connect(fromState, toState)`, `SaveStateMachine` and the `UndoBeginRecordStateMachine`
|
|
196
|
+
pair.
|
|
@@ -0,0 +1,286 @@
|
|
|
1
|
+
# State Machine API reference (Unity 6.7 and newer)
|
|
2
|
+
|
|
3
|
+
All types live in `Unity.GraphToolkit.Editor`. None of this exists on Unity 6000.6 or older: the
|
|
4
|
+
public Script Reference for these types starts at
|
|
5
|
+
`https://docs.unity3d.com/<VERSION>/Documentation/ScriptReference/Unity.GraphToolkit.Editor.StateMachine.html`
|
|
6
|
+
with `<VERSION>` at least `6000.7`.
|
|
7
|
+
There is no manual walkthrough page yet; the Script Reference is the authoritative source and this file is the map of it.
|
|
8
|
+
|
|
9
|
+
## Contents
|
|
10
|
+
|
|
11
|
+
1. Concepts
|
|
12
|
+
2. StateMachine class and asset lifecycle
|
|
13
|
+
3. States
|
|
14
|
+
4. Transitions and rules
|
|
15
|
+
5. Conditions
|
|
16
|
+
6. Custom self transitions
|
|
17
|
+
7. Variables
|
|
18
|
+
8. Validation with OnStateMachineChanged
|
|
19
|
+
9. Context menus
|
|
20
|
+
10. Custom UI for states and conditions
|
|
21
|
+
11. Subgraph states
|
|
22
|
+
12. Reading a state machine for a runtime
|
|
23
|
+
|
|
24
|
+
## 1. Concepts
|
|
25
|
+
|
|
26
|
+
- A `StateMachine` is a graph whose nodes are `State`s and whose wires are transitions. The state
|
|
27
|
+
machine owns transitions; states have no ports to define.
|
|
28
|
+
- A transition connects a `FromState` to a `ToState`. A **self transition** has the same state on both
|
|
29
|
+
ends and is anchored on it.
|
|
30
|
+
- A transition carries one or more **rules** (`ITransitionRule`). The transition is taken when the
|
|
31
|
+
conditions of any enabled rule hold. Each rule has a `RootCondition`, an `IGroupCondition` combining
|
|
32
|
+
child conditions with And/Or.
|
|
33
|
+
- Conditions are either built in (group, variable comparison) or user types derived from
|
|
34
|
+
`Condition<T>` / `Condition`.
|
|
35
|
+
- Everything about which state is active, when transitions fire, and what a condition means at
|
|
36
|
+
runtime is the user's code. Graph Toolkit stores the authoring data only.
|
|
37
|
+
|
|
38
|
+
## 2. StateMachine class and asset lifecycle
|
|
39
|
+
|
|
40
|
+
```csharp
|
|
41
|
+
[StateMachine(AssetExtension)] // optional second arg: StateMachineOptions flags
|
|
42
|
+
[Serializable]
|
|
43
|
+
class EnemyBrain : StateMachine
|
|
44
|
+
{
|
|
45
|
+
public const string AssetExtension = "enemybrain";
|
|
46
|
+
|
|
47
|
+
[MenuItem("Assets/Create/AI/Enemy Brain")]
|
|
48
|
+
static void Create() => StateMachineDatabase.PromptInProjectBrowserToCreateNewAsset<EnemyBrain>();
|
|
49
|
+
}
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
`StateMachineOptions` flags: `SupportsSubgraphs`,
|
|
53
|
+
`DisableAutoInclusionOfStatesFromStateMachineAssembly`. `Default` and `None` are 0. The flag applies
|
|
54
|
+
to states, conditions and self transitions alike.
|
|
55
|
+
|
|
56
|
+
`StateMachineDatabase` (static): `PromptInProjectBrowserToCreateNewAsset<T>(string defaultName = "New State Machine")`,
|
|
57
|
+
`CreateStateMachine<T>(path)`, `LoadStateMachine<T>(path)`, `LoadStateMachineForImporter<T>(path)`,
|
|
58
|
+
`SaveStateMachine(StateMachine)`, `GetStateMachineAssetGUID`, `GetStateMachineAssetPath`.
|
|
59
|
+
|
|
60
|
+
`StateMachine` members:
|
|
61
|
+
|
|
62
|
+
- `Name`, `StateCount`, `VariableCount`, `Hash128 ID`, `GUID AssetGuid`, `AvailableVariableTypes`
|
|
63
|
+
- `GetStates()`, `GetState(int)`, `AddState(State)`, `RemoveState(IState)`
|
|
64
|
+
- `ITransition Connect(IState from, IState to)`: creates the transition with one rule, or returns the
|
|
65
|
+
existing transition after adding a rule to it. `Connect(s, s)` creates or extends a self transition.
|
|
66
|
+
- `bool Disconnect(IState from, IState to)`, `IEnumerable<ITransition> GetTransitions(IState from, IState to)`
|
|
67
|
+
- `CreateVariable<T>(...)`, `GetVariables()`, `GetVariable(int)`, `RemoveVariable(...)`
|
|
68
|
+
- `virtual OnEnable()`, `OnDisable()`, `OnStateMachineChanged(StateMachineLogger)`
|
|
69
|
+
- `UndoBeginRecordStateMachine(string actionName[, params Condition[] conditionsToRecord])`,
|
|
70
|
+
`UndoEndRecordStateMachine()`
|
|
71
|
+
- `protected virtual IEnumerable<Type> BuildAvailableVariableTypes()`
|
|
72
|
+
|
|
73
|
+
Mutating in `OnEnable`, `OnDisable` or `OnStateMachineChanged` throws `InvalidOperationException`.
|
|
74
|
+
|
|
75
|
+
## 3. States
|
|
76
|
+
|
|
77
|
+
```csharp
|
|
78
|
+
[Serializable]
|
|
79
|
+
[State("Movement", "Icons/Patrol.png", "Patrol")] // args after the first are optional
|
|
80
|
+
class PatrolState : State
|
|
81
|
+
{
|
|
82
|
+
protected override void OnDefineOptions(IOptionDefinitionContext context)
|
|
83
|
+
{
|
|
84
|
+
context.AddOption<float>("Speed").WithDefaultValue(2f).WithTooltip("Units per second");
|
|
85
|
+
context.AddOption<string>("Notes").AsTextArea();
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
`StateAttribute(categoryPath[, iconPath[, title[, stylesheet]]])` mirrors `NodeAttribute`.
|
|
91
|
+
|
|
92
|
+
State options appear only in the Graph Inspector, never on the state itself.
|
|
93
|
+
`State.IOptionDefinitionContext`: `AddOption<T>(name)`, `AddOption(name, Type)`. Builder
|
|
94
|
+
`IStateOptionBuilder`: `WithDisplayName`, `WithTooltip`, `WithDefaultValue`, `Delayed`, `AsTextArea`,
|
|
95
|
+
`Build()`. Read back with `GetOptionByName(name).TryGetValue<T>(out v)`; `IStateOption` also has
|
|
96
|
+
`DataType`, `Name`, `DisplayName`, `Tooltip`, `TrySetValue<T>`.
|
|
97
|
+
|
|
98
|
+
`State` / `IState` members: `StateMachine`, `Hash128 ID`, `Title`, `Subtitle`, `Tooltip`,
|
|
99
|
+
`Color DefaultColor`, `float FillAmount`, `Vector2 Position`, `bool IsConnected`,
|
|
100
|
+
`GetIncomingTransitions()`, `GetOutgoingTransitions()`, `Options`, `OptionCount`, `GetOption(int)`,
|
|
101
|
+
`GetOptionByName(string)`, `RemoveFromStateMachine()`, `OnEnable()`, `OnDisable()`.
|
|
102
|
+
|
|
103
|
+
Discovery: states in the state machine's assembly are listed automatically; elsewhere use
|
|
104
|
+
`[UseWithStateMachine(typeof(EnemyBrain))]`. `[UseWithGraph]` is ignored by state machines.
|
|
105
|
+
|
|
106
|
+
## 4. Transitions and rules
|
|
107
|
+
|
|
108
|
+
Users create transitions by dragging from a state's edge (Shift + left mouse also starts one). In
|
|
109
|
+
code use `stateMachine.Connect(from, to)`.
|
|
110
|
+
|
|
111
|
+
`ITransition`: `Hash128 ID`, `IState FromState`, `IState ToState`, `GetRules()`, `int RuleCount`,
|
|
112
|
+
`GetRule(int)`, `ITransitionRule AddRule()`, `AddRule(ITransitionRule)`, `RemoveRule(ITransitionRule)`,
|
|
113
|
+
`Texture2D Icon`, `Color FillColor` (arrow head), `Color LineColor` (line and arrow border),
|
|
114
|
+
`float WidthOverride`, `float Opacity`, `bool IsDashed`.
|
|
115
|
+
A transition always keeps at least one rule; removing the last one is refused.
|
|
116
|
+
|
|
117
|
+
`ITransitionRule`: `Hash128 ID`, `string Title`, `bool Enabled`, `IGroupCondition RootCondition`,
|
|
118
|
+
`ITransition Transition`, `Texture2D Icon`.
|
|
119
|
+
|
|
120
|
+
`IGroupCondition : ICondition`: `GroupConditionOperation Operation` (`And`, `Or`), `Count`, `Get()`,
|
|
121
|
+
`Get(int)`, `Add(ICondition)`, `Insert(int, ICondition)`, `Remove(ICondition)`, `Clear()`.
|
|
122
|
+
|
|
123
|
+
## 5. Conditions
|
|
124
|
+
|
|
125
|
+
```csharp
|
|
126
|
+
[Serializable]
|
|
127
|
+
[Condition("Distance to player")] // title in the Add menu of a rule
|
|
128
|
+
class DistanceCondition : Condition<float>
|
|
129
|
+
{
|
|
130
|
+
public override string Tooltip => "Compared against the distance to the player.";
|
|
131
|
+
protected override bool DisplayComparisonDropdown => true;
|
|
132
|
+
protected override IReadOnlyList<ConditionComparison> SupportedComparisons =>
|
|
133
|
+
new[] { ConditionComparison.Less, ConditionComparison.Greater };
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
[Serializable]
|
|
137
|
+
[Condition("Took damage")]
|
|
138
|
+
class TookDamageCondition : Condition { } // valueless trigger, label-only row
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
- `Condition<T>`: `T Value` (serialized), `ConditionComparison Comparison`,
|
|
142
|
+
`virtual bool DisplayComparisonDropdown` (default false), `virtual IReadOnlyList<ConditionComparison> SupportedComparisons`.
|
|
143
|
+
- `Condition`: `Hash128 ID`, `ITransitionRule Rule`, `StateMachine`, `Texture2D Icon`,
|
|
144
|
+
`virtual string Title`, `virtual string Tooltip`.
|
|
145
|
+
- `ConditionComparison`: `Equal`, `NotEqual`, `Less`, `LessOrEqual`, `Greater`, `GreaterOrEqual`.
|
|
146
|
+
- Built-in conditions, created in code with `Condition.CreateGroupCondition()` and
|
|
147
|
+
`Condition.CreateVariableCondition(IVariable variable, object value, ConditionComparison comparison)`.
|
|
148
|
+
Read them through `IGroupCondition` and `IVariableCondition` (`Variable`, `Comparison`, `Value`).
|
|
149
|
+
- Without a `[Condition]` attribute the type name is used as the title. Abstract and open generic
|
|
150
|
+
condition classes are not listed.
|
|
151
|
+
- Same discovery rules as states: same assembly, or `[UseWithStateMachine(...)]`.
|
|
152
|
+
|
|
153
|
+
Editing a condition value from code: `UndoBeginRecordStateMachine("Set distance", condition)`,
|
|
154
|
+
assign `condition.Value`, `UndoEndRecordStateMachine()`, then `SaveStateMachine`.
|
|
155
|
+
|
|
156
|
+
## 6. Custom self transitions
|
|
157
|
+
|
|
158
|
+
```csharp
|
|
159
|
+
[Serializable]
|
|
160
|
+
[UseWithStateMachine(typeof(EnemyBrain))]
|
|
161
|
+
[Transition("", "Icons/Loop.png", "Repeat")] // (categoryPath[, iconPath[, title]])
|
|
162
|
+
class RepeatTransition : SelfTransition
|
|
163
|
+
{
|
|
164
|
+
public override void OnEnable()
|
|
165
|
+
{
|
|
166
|
+
base.OnEnable();
|
|
167
|
+
LineColor = Color.cyan;
|
|
168
|
+
Tooltip = "Loops the state while its conditions hold.";
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
Custom self transitions appear in a state's Create Transition menu. `SelfTransition` exposes the
|
|
174
|
+
`ITransition` members plus `Tooltip`, `OnEnable`, `OnDisable`. Regular state-to-state transitions are
|
|
175
|
+
not subclassed; style them through `ITransition` properties.
|
|
176
|
+
|
|
177
|
+
## 7. Variables
|
|
178
|
+
|
|
179
|
+
`stateMachine.CreateVariable<int>("Health", 100)` declares a Blackboard variable that the built-in
|
|
180
|
+
variable condition can compare against. `IVariable.StateMachine` gives the owner. Variable kinds and
|
|
181
|
+
members are the same as in the Graph API.
|
|
182
|
+
|
|
183
|
+
## 8. Validation with OnStateMachineChanged
|
|
184
|
+
|
|
185
|
+
```csharp
|
|
186
|
+
public override void OnStateMachineChanged(StateMachineLogger logger)
|
|
187
|
+
{
|
|
188
|
+
foreach (var state in GetStates())
|
|
189
|
+
if (!state.GetOutgoingTransitions().Any() && state is not EndState)
|
|
190
|
+
logger.LogWarning("Dead end: add a transition out of this state.", state);
|
|
191
|
+
|
|
192
|
+
foreach (var change in logger.StateMachineChanges.ChangedTransitions)
|
|
193
|
+
if ((change.ChangeKinds & ChangeKind.Added) != 0) { /* new transition */ }
|
|
194
|
+
}
|
|
195
|
+
```
|
|
196
|
+
|
|
197
|
+
`StateMachineLogger`: `LogError`, `LogWarning`, `Log`, each as `(object message, object context = null)`
|
|
198
|
+
or `(message, context, StateMachineLogAction)`. Context may be a state, a transition, or null for
|
|
199
|
+
the whole state machine.
|
|
200
|
+
`StateMachineLogAction(string description, Action<object> action)`.
|
|
201
|
+
`StateMachineChanges`: `ChangedStates`, `ChangedTransitions`, `ChangedVariables`,
|
|
202
|
+
`ChangedSubgraphStates`. Element properties: `ChangedState.State`, `ChangedTransition.Transition`,
|
|
203
|
+
`ChangedVariable.Variable`, `ChangedSubgraphState.SubgraphState`; each also has `Hash128 ID` and
|
|
204
|
+
`ChangeKind ChangeKinds`.
|
|
205
|
+
|
|
206
|
+
## 9. Context menus
|
|
207
|
+
|
|
208
|
+
```csharp
|
|
209
|
+
[StateMachineMenu(typeof(EnemyBrain))]
|
|
210
|
+
static void AddEntries(StateMachineMenuContext context)
|
|
211
|
+
{
|
|
212
|
+
switch (context.ClickedObject)
|
|
213
|
+
{
|
|
214
|
+
case IState state: context.AppendAction("Log state", () => Debug.Log(state.Title)); break;
|
|
215
|
+
case ITransition transition: context.AppendAction("Log rules", () => Debug.Log(transition.RuleCount)); break;
|
|
216
|
+
default: context.AppendAction("Canvas action", () => { }); break;
|
|
217
|
+
}
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
[ConditionMenu(typeof(EnemyBrain))]
|
|
221
|
+
static void AddConditionEntries(ConditionMenuContext context) // context.StateMachine, .Transition, .Rule
|
|
222
|
+
{
|
|
223
|
+
}
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
## 10. Custom UI for states and conditions
|
|
227
|
+
|
|
228
|
+
- `class PatrolView : StateView<PatrolState>`: `State`, `View.Root`, `OnViewBuilt()`,
|
|
229
|
+
`OnViewAttached()`, `OnViewDetached()`, `OnViewLODChanged(float)`, `OnCullingChanged(bool)`.
|
|
230
|
+
Allocate elements in `OnViewBuilt` and re-add them in `OnCullingChanged(false)`; never allocate in
|
|
231
|
+
`OnViewAttached`.
|
|
232
|
+
- `class DistanceView : ConditionView<DistanceCondition>`: `Condition`, `View.Root`, `OnViewBuilt()`,
|
|
233
|
+
`OnViewAttached()`, `OnViewDetached()`, `OnConditionChanged()`, and the toggles
|
|
234
|
+
`protected virtual bool DisplayValueField`, `DisplayTitleLabel`. Add to `Root`; do not remove or
|
|
235
|
+
reparent the built-in row elements. View instances are never serialized.
|
|
236
|
+
- Exceptions thrown by a view are logged and the built-in UI still renders.
|
|
237
|
+
|
|
238
|
+
## 11. Subgraph states
|
|
239
|
+
|
|
240
|
+
With `StateMachineOptions.SupportsSubgraphs`, a state can hold a nested state machine.
|
|
241
|
+
`ISubgraphState : IState` marks such states; `StateMachineChanges.ChangedSubgraphStates` reports them.
|
|
242
|
+
|
|
243
|
+
## 12. Reading a state machine for a runtime
|
|
244
|
+
|
|
245
|
+
```csharp
|
|
246
|
+
[ScriptedImporter(1, EnemyBrain.AssetExtension)]
|
|
247
|
+
class EnemyBrainImporter : ScriptedImporter
|
|
248
|
+
{
|
|
249
|
+
public override void OnImportAsset(AssetImportContext ctx)
|
|
250
|
+
{
|
|
251
|
+
var sm = StateMachineDatabase.LoadStateMachineForImporter<EnemyBrain>(ctx.assetPath);
|
|
252
|
+
if (sm == null) { Debug.LogError($"Failed to load {ctx.assetPath}"); return; }
|
|
253
|
+
|
|
254
|
+
var runtime = ScriptableObject.CreateInstance<RuntimeBrain>();
|
|
255
|
+
foreach (var state in sm.GetStates())
|
|
256
|
+
{
|
|
257
|
+
var rs = new RuntimeState { Id = state.ID, Name = state.Title };
|
|
258
|
+
state.GetOptionByName("Speed")?.TryGetValue<float>(out rs.Speed);
|
|
259
|
+
foreach (var transition in state.GetOutgoingTransitions())
|
|
260
|
+
foreach (var rule in transition.GetRules())
|
|
261
|
+
if (rule.Enabled)
|
|
262
|
+
rs.Transitions.Add(new RuntimeTransition
|
|
263
|
+
{
|
|
264
|
+
Target = transition.ToState.ID,
|
|
265
|
+
Predicate = Compile(rule.RootCondition)
|
|
266
|
+
});
|
|
267
|
+
runtime.States.Add(rs);
|
|
268
|
+
}
|
|
269
|
+
ctx.AddObjectToAsset("Runtime", runtime);
|
|
270
|
+
ctx.SetMainObject(runtime);
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
static RuntimePredicate Compile(ICondition condition) => condition switch
|
|
274
|
+
{
|
|
275
|
+
IGroupCondition g => RuntimePredicate.Group(g.Operation, g.Get().Select(Compile)),
|
|
276
|
+
IVariableCondition v => RuntimePredicate.Variable(v.Variable.Name, v.Comparison, v.Value),
|
|
277
|
+
DistanceCondition d => RuntimePredicate.Distance(d.Comparison, d.Value),
|
|
278
|
+
TookDamageCondition => RuntimePredicate.Trigger("TookDamage"),
|
|
279
|
+
_ => RuntimePredicate.Never
|
|
280
|
+
};
|
|
281
|
+
}
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
Identify the entry state by a dedicated `State` subclass or a state machine option; the API has no
|
|
285
|
+
built-in "default state". Keep `Hash128` IDs in the runtime asset if the GraphVisualization API will
|
|
286
|
+
highlight states later.
|