create-threenative 0.2.2 → 0.2.4
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/LICENSE +21 -0
- package/README.md +61 -2
- package/agent-docs/references/assertion-reference.md +819 -0
- package/agent-docs/references/capability-reference.md +4483 -0
- package/agent-docs/references/capture-the-frame.md +60 -0
- package/agent-docs/references/creating-creatures.md +215 -0
- package/agent-docs/references/ctx-cookbook.md +120 -0
- package/agent-docs/references/debug-surface.md +68 -0
- package/agent-docs/references/dream-loop.md +150 -0
- package/agent-docs/references/finding-assets.md +215 -0
- package/agent-docs/references/gameplay-recipes.md +54 -0
- package/agent-docs/references/menu-screens.md +69 -0
- package/agent-docs/references/mobile-memory-budget.md +87 -0
- package/agent-docs/references/sculpt-from-a-reference.md +40 -0
- package/agent-docs/references/trace-a-slow-frame.md +99 -0
- package/agent-docs/references/visual-baseline.md +174 -0
- package/agent-docs/references/webview-ui.md +113 -0
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
- package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
- package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
- package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
- package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
- package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
- package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
- package/agent-files/.claude/agents/threenative-builder.md +7 -0
- package/agent-files/.claude/agents/threenative-verifier.md +7 -0
- package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
- package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
- package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
- package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
- package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
- package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
- package/agent-files/.threenative/agents/builder.md +32 -0
- package/agent-files/.threenative/agents/verifier.md +31 -0
- package/agent-files/AGENT-ROLES.md +26 -0
- package/agent-files/scripts/reference.mjs +705 -0
- package/agent-files/scripts/visual-loop.mjs +382 -0
- package/capabilities.json +5292 -0
- package/dist/index.d.ts +224 -3
- package/dist/index.js +1972 -73
- package/dist/threenative.d.ts +9 -2
- package/dist/threenative.js +2570 -176
- package/package.json +55 -6
- package/template-assets/icon.png +0 -0
- package/template-assets/loading.ts +325 -0
- package/template-assets/patches/three@0.185.1.patch +522 -0
- package/template-assets/worldEnvironment.ts +758 -0
- package/templates/action-rpg/.codex/config.toml +19 -0
- package/templates/action-rpg/.cursor/mcp.json +32 -0
- package/templates/action-rpg/.gemini/settings.json +32 -0
- package/templates/action-rpg/.mcp.json +18 -2
- package/templates/action-rpg/.vscode/mcp.json +36 -0
- package/templates/action-rpg/.zed/settings.json +36 -0
- package/templates/action-rpg/AGENTS.md +84 -29
- package/templates/action-rpg/CLAUDE.md +84 -29
- package/templates/action-rpg/index.html +0 -1
- package/templates/action-rpg/opencode.json +41 -0
- package/templates/action-rpg/package.json +15 -11
- package/templates/action-rpg/playtests/combat.playtest.json +32 -9
- package/templates/action-rpg/playtests/fail.playtest.json +3 -3
- package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
- package/templates/action-rpg/playtests/performance.playtest.json +39 -0
- package/templates/action-rpg/playtests/progress.playtest.json +18 -13
- package/templates/action-rpg/playtests/survives.playtest.json +27 -0
- package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
- package/templates/action-rpg/playtests/win.playtest.json +10 -4
- package/templates/action-rpg/src/conventions.ts +35 -0
- package/templates/action-rpg/src/entities/Enemy.ts +16 -7
- package/templates/action-rpg/src/entities/Player.ts +20 -3
- package/templates/action-rpg/src/game.ts +21 -0
- package/templates/action-rpg/src/render/camera.ts +7 -2
- package/templates/action-rpg/src/render/lighting.ts +11 -4
- package/templates/action-rpg/src/render/loading.ts +278 -43
- package/templates/action-rpg/src/render/materials.ts +11 -0
- package/templates/action-rpg/src/render/palette.ts +10 -3
- package/templates/action-rpg/src/render/postprocessing.ts +32 -16
- package/templates/action-rpg/src/render/quality.ts +170 -0
- package/templates/action-rpg/src/render/shapes.ts +185 -26
- package/templates/action-rpg/src/render/touch-controls.ts +185 -0
- package/templates/action-rpg/src/render/vfx.ts +257 -0
- package/templates/action-rpg/src/render/worldEnvironment.ts +758 -0
- package/templates/action-rpg/src/scenes/Play.ts +91 -24
- package/templates/action-rpg/src/state.ts +4 -0
- package/templates/action-rpg/src/style.css +65 -1
- package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
- package/templates/action-rpg/src/ui/App.tsx +9 -8
- package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
- package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
- package/templates/action-rpg/src/ui/Hud.tsx +10 -8
- package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
- package/templates/action-rpg/src/ui/main.tsx +14 -0
- package/templates/action-rpg/threenative.config.ts +28 -8
- package/templates/action-rpg/vite.config.ts +32 -2
- package/templates/defense/.codex/config.toml +19 -0
- package/templates/defense/.cursor/mcp.json +32 -0
- package/templates/defense/.gemini/settings.json +32 -0
- package/templates/defense/.mcp.json +18 -2
- package/templates/defense/.vscode/mcp.json +36 -0
- package/templates/defense/.zed/settings.json +36 -0
- package/templates/defense/AGENTS.md +81 -41
- package/templates/defense/CLAUDE.md +81 -41
- package/templates/defense/README.md +2 -1
- package/templates/defense/index.html +0 -1
- package/templates/defense/opencode.json +41 -0
- package/templates/defense/package.json +16 -12
- package/templates/defense/playtests/leak.playtest.json +9 -4
- package/templates/defense/playtests/performance.playtest.json +39 -0
- package/templates/defense/playtests/placement.playtest.json +5 -5
- package/templates/defense/playtests/pointer-placement.playtest.json +156 -0
- package/templates/defense/playtests/scan.playtest.json +4 -4
- package/templates/defense/playtests/survive.playtest.json +25 -6
- package/templates/defense/src/attackers/Attacker.ts +32 -16
- package/templates/defense/src/board/Route.ts +22 -8
- package/templates/defense/src/conventions.ts +18 -0
- package/templates/defense/src/entities/Player.ts +11 -3
- package/templates/defense/src/game.ts +25 -4
- package/templates/defense/src/physics.ts +9 -39
- package/templates/defense/src/placement/Buildable.ts +4 -4
- package/templates/defense/src/render/camera.ts +9 -3
- package/templates/defense/src/render/lighting.ts +6 -1
- package/templates/defense/src/render/loading.ts +274 -38
- package/templates/defense/src/render/materials.ts +9 -0
- package/templates/defense/src/render/palette.ts +12 -5
- package/templates/defense/src/render/postprocessing.ts +32 -12
- package/templates/defense/src/render/quality.ts +170 -0
- package/templates/defense/src/render/shapes.ts +180 -23
- package/templates/defense/src/render/sky.ts +2 -2
- package/templates/defense/src/render/worldEnvironment.ts +758 -0
- package/templates/defense/src/scenes/Boot.ts +2 -2
- package/templates/defense/src/scenes/Defense.ts +122 -56
- package/templates/defense/src/state.ts +6 -0
- package/templates/defense/src/style.css +65 -1
- package/templates/defense/src/towers/Tower.ts +11 -12
- package/templates/defense/src/towers/targeting.ts +1 -1
- package/templates/defense/src/ui/App.tsx +11 -6
- package/templates/defense/src/ui/GameUi.tsx +20 -0
- package/templates/defense/src/ui/Hud.tsx +6 -5
- package/templates/defense/src/ui/main.tsx +14 -0
- package/templates/defense/threenative.config.ts +28 -8
- package/templates/defense/vite.config.ts +34 -1
- package/templates/minimal/.codex/config.toml +19 -0
- package/templates/minimal/.cursor/mcp.json +32 -0
- package/templates/minimal/.gemini/settings.json +32 -0
- package/templates/minimal/.mcp.json +18 -2
- package/templates/minimal/.vscode/mcp.json +36 -0
- package/templates/minimal/.zed/settings.json +36 -0
- package/templates/minimal/AGENTS.md +78 -382
- package/templates/minimal/CLAUDE.md +78 -382
- package/templates/minimal/index.html +0 -1
- package/templates/minimal/opencode.json +41 -0
- package/templates/minimal/package.json +14 -11
- package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
- package/templates/minimal/playtests/play.playtest.json +18 -5
- package/templates/minimal/playtests/survives.playtest.json +48 -4
- package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
- package/templates/minimal/src/conventions.ts +18 -0
- package/templates/minimal/src/entities/Player.ts +39 -6
- package/templates/minimal/src/game.ts +1 -0
- package/templates/minimal/src/main.ts +14 -4
- package/templates/minimal/src/render/camera.ts +1 -1
- package/templates/minimal/src/render/hud.ts +24 -8
- package/templates/minimal/src/render/lighting.ts +23 -2
- package/templates/minimal/src/render/loading.ts +23 -103
- package/templates/minimal/src/render/materials.ts +7 -0
- package/templates/minimal/src/render/palette.ts +3 -3
- package/templates/minimal/src/render/postprocessing.ts +55 -16
- package/templates/minimal/src/render/quality.ts +162 -0
- package/templates/minimal/src/render/sky.ts +51 -32
- package/templates/minimal/src/render/touch-controls.ts +165 -0
- package/templates/minimal/src/render/worldEnvironment.ts +758 -0
- package/templates/minimal/src/scenes/Play.ts +128 -14
- package/templates/minimal/src/state.ts +8 -1
- package/templates/minimal/src/style.css +20 -0
- package/templates/minimal/threenative.config.ts +22 -10
- package/templates/minimal/vite.config.ts +28 -1
- package/templates/platformer/.codex/config.toml +19 -0
- package/templates/platformer/.cursor/mcp.json +32 -0
- package/templates/platformer/.gemini/settings.json +32 -0
- package/templates/platformer/.mcp.json +18 -2
- package/templates/platformer/.vscode/mcp.json +36 -0
- package/templates/platformer/.zed/settings.json +36 -0
- package/templates/platformer/AGENTS.md +81 -186
- package/templates/platformer/CLAUDE.md +81 -186
- package/templates/platformer/index.html +0 -1
- package/templates/platformer/opencode.json +41 -0
- package/templates/platformer/package.json +17 -14
- package/templates/platformer/playtests/avoidance.playtest.json +6 -1
- package/templates/platformer/playtests/branding.playtest.json +29 -0
- package/templates/platformer/playtests/buffer.playtest.json +1 -1
- package/templates/platformer/playtests/collect.playtest.json +1 -1
- package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
- package/templates/platformer/playtests/coyote.playtest.json +42 -8
- package/templates/platformer/playtests/damage.playtest.json +4 -1
- package/templates/platformer/playtests/dash.playtest.json +2 -2
- package/templates/platformer/playtests/jump.playtest.json +2 -3
- package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
- package/templates/platformer/playtests/oneway.playtest.json +30 -3
- package/templates/platformer/playtests/performance.playtest.json +7 -5
- package/templates/platformer/playtests/respawn.playtest.json +2 -2
- package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
- package/templates/platformer/playtests/stomp.playtest.json +11 -3
- package/templates/platformer/playtests/survives.playtest.json +31 -0
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +16 -4
- package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
- package/templates/platformer/playtests/touch-controls-web.playtest.json +57 -0
- package/templates/platformer/src/conventions.ts +18 -0
- package/templates/platformer/src/entities/Character.ts +79 -11
- package/templates/platformer/src/entities/Patrol.ts +5 -0
- package/templates/platformer/src/game.ts +27 -2
- package/templates/platformer/src/level/Platform.ts +13 -1
- package/templates/platformer/src/render/lighting.ts +13 -5
- package/templates/platformer/src/render/loading.ts +281 -62
- package/templates/platformer/src/render/palette.ts +4 -1
- package/templates/platformer/src/render/postprocessing.ts +42 -14
- package/templates/platformer/src/render/quality.ts +170 -0
- package/templates/platformer/src/render/touch-controls.ts +54 -36
- package/templates/platformer/src/render/worldEnvironment.ts +758 -0
- package/templates/platformer/src/scenes/Level.ts +97 -32
- package/templates/platformer/src/state.ts +4 -0
- package/templates/platformer/src/style.css +65 -1
- package/templates/platformer/src/ui/App.tsx +9 -4
- package/templates/platformer/src/ui/GameUi.tsx +20 -0
- package/templates/platformer/src/ui/Hud.tsx +6 -5
- package/templates/platformer/src/ui/main.tsx +14 -0
- package/templates/platformer/threenative.config.ts +27 -10
- package/templates/platformer/vite.config.ts +34 -1
- package/templates/puzzle/.codex/config.toml +19 -0
- package/templates/puzzle/.cursor/mcp.json +32 -0
- package/templates/puzzle/.gemini/settings.json +32 -0
- package/templates/puzzle/.mcp.json +32 -0
- package/templates/puzzle/.vscode/mcp.json +36 -0
- package/templates/puzzle/.zed/settings.json +36 -0
- package/templates/puzzle/AGENTS.md +96 -0
- package/templates/puzzle/CLAUDE.md +98 -0
- package/templates/puzzle/README.md +43 -0
- package/templates/puzzle/index.html +12 -0
- package/templates/puzzle/kit.json +7 -0
- package/templates/puzzle/opencode.json +41 -0
- package/templates/puzzle/package.json +50 -0
- package/templates/puzzle/playtests/carry.playtest.json +71 -0
- package/templates/puzzle/playtests/performance.playtest.json +23 -0
- package/templates/puzzle/playtests/survives.playtest.json +51 -0
- package/templates/puzzle/playtests/swing.playtest.json +38 -0
- package/templates/puzzle/public/favicon.svg +5 -0
- package/templates/puzzle/src/conventions.ts +25 -0
- package/templates/puzzle/src/entities/Ball.ts +70 -0
- package/templates/puzzle/src/entities/Crate.ts +76 -0
- package/templates/puzzle/src/entities/Gripper.ts +69 -0
- package/templates/puzzle/src/entities/Pendulum.ts +89 -0
- package/templates/puzzle/src/game.ts +48 -0
- package/templates/puzzle/src/main.ts +15 -0
- package/templates/puzzle/src/physics.ts +19 -0
- package/templates/puzzle/src/render/camera.ts +37 -0
- package/templates/puzzle/src/render/lighting.ts +55 -0
- package/templates/puzzle/src/render/loading.ts +325 -0
- package/templates/puzzle/src/render/materials.ts +28 -0
- package/templates/puzzle/src/render/palette.ts +31 -0
- package/templates/puzzle/src/render/postprocessing.ts +34 -0
- package/templates/puzzle/src/render/quality.ts +170 -0
- package/templates/puzzle/src/render/shapes.ts +134 -0
- package/templates/puzzle/src/render/sky.ts +16 -0
- package/templates/puzzle/src/render/touch-controls.ts +185 -0
- package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
- package/templates/puzzle/src/room.ts +83 -0
- package/templates/puzzle/src/scenes/Boot.ts +12 -0
- package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
- package/templates/puzzle/src/state.ts +30 -0
- package/templates/puzzle/src/style.css +96 -0
- package/templates/puzzle/src/ui/App.tsx +22 -0
- package/templates/puzzle/src/ui/GameUi.tsx +20 -0
- package/templates/puzzle/src/ui/Hud.tsx +57 -0
- package/templates/puzzle/src/ui/Menu.tsx +7 -0
- package/templates/puzzle/src/ui/main.tsx +14 -0
- package/templates/puzzle/tailwind.config.ts +1 -0
- package/templates/puzzle/threenative.config.ts +49 -0
- package/templates/puzzle/tsconfig.json +17 -0
- package/templates/puzzle/vite.config.ts +38 -0
- package/templates/racing/.codex/config.toml +19 -0
- package/templates/racing/.cursor/mcp.json +32 -0
- package/templates/racing/.gemini/settings.json +32 -0
- package/templates/racing/.mcp.json +18 -2
- package/templates/racing/.vscode/mcp.json +36 -0
- package/templates/racing/.zed/settings.json +36 -0
- package/templates/racing/AGENTS.md +84 -36
- package/templates/racing/CLAUDE.md +84 -36
- package/templates/racing/index.html +0 -1
- package/templates/racing/native-playtests/survives.playtest.json +43 -0
- package/templates/racing/opencode.json +41 -0
- package/templates/racing/package.json +17 -12
- package/templates/racing/playtests/boost.playtest.json +5 -5
- package/templates/racing/playtests/outcome.playtest.json +14 -4
- package/templates/racing/playtests/performance.playtest.json +39 -0
- package/templates/racing/playtests/ranking.playtest.json +2 -2
- package/templates/racing/playtests/rescue.playtest.json +12 -6
- package/templates/racing/playtests/reverse.playtest.json +3 -3
- package/templates/racing/playtests/shortcut.playtest.json +3 -3
- package/templates/racing/playtests/survives.playtest.json +36 -4
- package/templates/racing/playtests/touch-controls.playtest.json +41 -0
- package/templates/racing/src/conventions.ts +6 -0
- package/templates/racing/src/entities/RacingCar.ts +16 -4
- package/templates/racing/src/entities/Rival.ts +5 -2
- package/templates/racing/src/game.ts +24 -1
- package/templates/racing/src/render/camera.ts +15 -8
- package/templates/racing/src/render/lighting.ts +28 -14
- package/templates/racing/src/render/loading.ts +302 -35
- package/templates/racing/src/render/materials.ts +54 -4
- package/templates/racing/src/render/palette.ts +23 -6
- package/templates/racing/src/render/postprocessing.ts +32 -12
- package/templates/racing/src/render/quality.ts +170 -0
- package/templates/racing/src/render/shapes.ts +537 -26
- package/templates/racing/src/render/sky.ts +5 -2
- package/templates/racing/src/render/touch-controls.ts +185 -0
- package/templates/racing/src/render/worldEnvironment.ts +758 -0
- package/templates/racing/src/scenes/Race.ts +84 -37
- package/templates/racing/src/state.ts +4 -0
- package/templates/racing/src/style.css +65 -1
- package/templates/racing/src/track/Lap.ts +20 -9
- package/templates/racing/src/track/Ranking.ts +53 -14
- package/templates/racing/src/track/Track.ts +284 -32
- package/templates/racing/src/track/TrackSector.ts +14 -4
- package/templates/racing/src/ui/App.tsx +9 -4
- package/templates/racing/src/ui/GameUi.tsx +20 -0
- package/templates/racing/src/ui/Hud.tsx +6 -5
- package/templates/racing/src/ui/main.tsx +14 -0
- package/templates/racing/threenative.config.ts +28 -8
- package/templates/racing/vite.config.ts +34 -1
- package/templates/runner/.codex/config.toml +19 -0
- package/templates/runner/.cursor/mcp.json +32 -0
- package/templates/runner/.gemini/settings.json +32 -0
- package/templates/runner/.mcp.json +32 -0
- package/templates/runner/.vscode/mcp.json +36 -0
- package/templates/runner/.zed/settings.json +36 -0
- package/templates/runner/AGENTS.md +96 -0
- package/templates/runner/CLAUDE.md +98 -0
- package/templates/runner/README.md +43 -0
- package/templates/runner/index.html +12 -0
- package/templates/runner/kit.json +7 -0
- package/templates/runner/opencode.json +41 -0
- package/templates/runner/package.json +50 -0
- package/templates/runner/playtests/performance.playtest.json +23 -0
- package/templates/runner/playtests/streams.playtest.json +38 -0
- package/templates/runner/playtests/survives.playtest.json +51 -0
- package/templates/runner/public/favicon.svg +5 -0
- package/templates/runner/src/conventions.ts +24 -0
- package/templates/runner/src/entities/Runner.ts +135 -0
- package/templates/runner/src/game.ts +50 -0
- package/templates/runner/src/main.ts +15 -0
- package/templates/runner/src/physics.ts +13 -0
- package/templates/runner/src/render/camera.ts +39 -0
- package/templates/runner/src/render/dust.ts +131 -0
- package/templates/runner/src/render/lighting.ts +57 -0
- package/templates/runner/src/render/loading.ts +325 -0
- package/templates/runner/src/render/materials.ts +27 -0
- package/templates/runner/src/render/palette.ts +30 -0
- package/templates/runner/src/render/postprocessing.ts +34 -0
- package/templates/runner/src/render/quality.ts +170 -0
- package/templates/runner/src/render/shapes.ts +68 -0
- package/templates/runner/src/render/sky.ts +51 -0
- package/templates/runner/src/render/touch-controls.ts +185 -0
- package/templates/runner/src/render/worldEnvironment.ts +758 -0
- package/templates/runner/src/scenes/Boot.ts +12 -0
- package/templates/runner/src/scenes/Run.ts +142 -0
- package/templates/runner/src/state.ts +29 -0
- package/templates/runner/src/style.css +96 -0
- package/templates/runner/src/track.ts +176 -0
- package/templates/runner/src/ui/App.tsx +22 -0
- package/templates/runner/src/ui/GameUi.tsx +20 -0
- package/templates/runner/src/ui/Hud.tsx +55 -0
- package/templates/runner/src/ui/Menu.tsx +7 -0
- package/templates/runner/src/ui/main.tsx +14 -0
- package/templates/runner/tailwind.config.ts +1 -0
- package/templates/runner/threenative.config.ts +49 -0
- package/templates/runner/tsconfig.json +17 -0
- package/templates/runner/vite.config.ts +38 -0
- package/templates/sailing/.codex/config.toml +19 -0
- package/templates/sailing/.cursor/mcp.json +32 -0
- package/templates/sailing/.gemini/settings.json +32 -0
- package/templates/sailing/.mcp.json +32 -0
- package/templates/sailing/.vscode/mcp.json +36 -0
- package/templates/sailing/.zed/settings.json +36 -0
- package/templates/sailing/AGENTS.md +95 -0
- package/templates/sailing/CLAUDE.md +97 -0
- package/templates/sailing/README.md +28 -0
- package/templates/sailing/index.html +12 -0
- package/templates/sailing/kit.json +7 -0
- package/templates/sailing/native-playtests/float.playtest.json +55 -0
- package/templates/sailing/native-playtests/survives.playtest.json +38 -0
- package/templates/sailing/opencode.json +41 -0
- package/templates/sailing/package.json +52 -0
- package/templates/sailing/playtests/fail.playtest.json +24 -0
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
- package/templates/sailing/playtests/float.playtest.json +59 -0
- package/templates/sailing/playtests/performance.playtest.json +36 -0
- package/templates/sailing/playtests/survives.playtest.json +46 -0
- package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
- package/templates/sailing/playtests/win.playtest.json +31 -0
- package/templates/sailing/public/favicon.svg +5 -0
- package/templates/sailing/src/conventions.ts +8 -0
- package/templates/sailing/src/entities/Ship.ts +233 -0
- package/templates/sailing/src/game.ts +40 -0
- package/templates/sailing/src/main.ts +15 -0
- package/templates/sailing/src/render/camera.ts +28 -0
- package/templates/sailing/src/render/lighting.ts +41 -0
- package/templates/sailing/src/render/loading.ts +325 -0
- package/templates/sailing/src/render/materials.ts +44 -0
- package/templates/sailing/src/render/ocean.ts +179 -0
- package/templates/sailing/src/render/palette.ts +17 -0
- package/templates/sailing/src/render/postprocessing.ts +34 -0
- package/templates/sailing/src/render/props.ts +602 -0
- package/templates/sailing/src/render/quality.ts +140 -0
- package/templates/sailing/src/render/sky.ts +37 -0
- package/templates/sailing/src/render/touch-controls.ts +142 -0
- package/templates/sailing/src/render/worldEnvironment.ts +758 -0
- package/templates/sailing/src/scenes/Boot.ts +12 -0
- package/templates/sailing/src/scenes/Sailing.ts +133 -0
- package/templates/sailing/src/state.ts +10 -0
- package/templates/sailing/src/style.css +81 -0
- package/templates/sailing/src/ui/App.tsx +15 -0
- package/templates/sailing/src/ui/GameUi.tsx +12 -0
- package/templates/sailing/src/ui/Hud.tsx +55 -0
- package/templates/sailing/src/ui/Menu.tsx +30 -0
- package/templates/sailing/src/ui/main.tsx +7 -0
- package/templates/sailing/tailwind.config.ts +2 -0
- package/templates/sailing/threenative.config.ts +40 -0
- package/templates/sailing/tsconfig.json +17 -0
- package/templates/sailing/vite.config.ts +34 -0
- package/templates/shooter/.codex/config.toml +19 -0
- package/templates/shooter/.cursor/mcp.json +32 -0
- package/templates/shooter/.gemini/settings.json +32 -0
- package/templates/shooter/.mcp.json +18 -2
- package/templates/shooter/.vscode/mcp.json +36 -0
- package/templates/shooter/.zed/settings.json +36 -0
- package/templates/shooter/AGENTS.md +81 -54
- package/templates/shooter/CLAUDE.md +81 -54
- package/templates/shooter/index.html +0 -1
- package/templates/shooter/kit.json +2 -2
- package/templates/shooter/opencode.json +41 -0
- package/templates/shooter/package.json +16 -11
- package/templates/shooter/playtests/combat.playtest.json +48 -0
- package/templates/shooter/playtests/fail.playtest.json +5 -4
- package/templates/shooter/playtests/input-control.playtest.json +261 -0
- package/templates/shooter/playtests/per-item.playtest.json +59 -0
- package/templates/shooter/playtests/performance.playtest.json +39 -0
- package/templates/shooter/playtests/shooter.playtest.json +31 -21
- package/templates/shooter/playtests/survives.playtest.json +28 -1
- package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
- package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
- package/templates/shooter/public/favicon.svg +1 -1
- package/templates/shooter/src/combat/damage.ts +1 -2
- package/templates/shooter/src/conventions.ts +51 -0
- package/templates/shooter/src/entities/Player.ts +235 -18
- package/templates/shooter/src/entities/Target.ts +2 -2
- package/templates/shooter/src/game.ts +35 -3
- package/templates/shooter/src/main.ts +3 -13
- package/templates/shooter/src/render/camera.ts +78 -18
- package/templates/shooter/src/render/decals.ts +211 -0
- package/templates/shooter/src/render/lighting.ts +13 -4
- package/templates/shooter/src/render/loading.ts +274 -35
- package/templates/shooter/src/render/materials.ts +56 -3
- package/templates/shooter/src/render/palette.ts +6 -3
- package/templates/shooter/src/render/postprocessing.ts +32 -17
- package/templates/shooter/src/render/quality.ts +170 -0
- package/templates/shooter/src/render/scale.ts +22 -0
- package/templates/shooter/src/render/shapes.ts +519 -60
- package/templates/shooter/src/render/sky.ts +5 -1
- package/templates/shooter/src/render/touch-controls.ts +305 -0
- package/templates/shooter/src/render/ui.css +119 -1
- package/templates/shooter/src/render/ui.ts +19 -3
- package/templates/shooter/src/render/vfx.ts +215 -0
- package/templates/shooter/src/render/worldEnvironment.ts +758 -0
- package/templates/shooter/src/scenes/Play.ts +385 -97
- package/templates/shooter/src/state.ts +18 -0
- package/templates/shooter/src/style.css +46 -0
- package/templates/shooter/src/ui/App.tsx +10 -12
- package/templates/shooter/src/ui/Crosshair.tsx +25 -0
- package/templates/shooter/src/ui/GameUi.tsx +22 -0
- package/templates/shooter/src/ui/Hud.tsx +14 -10
- package/templates/shooter/src/ui/Menu.tsx +24 -9
- package/templates/shooter/src/ui/main.tsx +15 -0
- package/templates/shooter/src/weapons/Hitscan.ts +3 -4
- package/templates/shooter/src/weapons/Projectile.ts +29 -13
- package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
- package/templates/shooter/threenative.config.ts +28 -8
- package/templates/shooter/vite.config.ts +32 -2
- package/templates/starter/.codex/config.toml +19 -0
- package/templates/starter/.cursor/mcp.json +32 -0
- package/templates/starter/.gemini/settings.json +32 -0
- package/templates/starter/.mcp.json +18 -2
- package/templates/starter/.vscode/mcp.json +36 -0
- package/templates/starter/.zed/settings.json +36 -0
- package/templates/starter/AGENTS.md +72 -426
- package/templates/starter/CLAUDE.md +72 -426
- package/templates/starter/assets/pickup.wav +0 -0
- package/templates/starter/gitignore +4 -0
- package/templates/starter/index.html +0 -1
- package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
- package/templates/starter/native-playtests/render-chain.playtest.json +81 -0
- package/templates/starter/opencode.json +41 -0
- package/templates/starter/package.json +16 -12
- package/templates/starter/playtests/assets.playtest.json +65 -0
- package/templates/starter/playtests/boot-failure.playtest.json +45 -0
- package/templates/starter/playtests/buffer.playtest.json +59 -9
- package/templates/starter/playtests/cloth.playtest.json +113 -0
- package/templates/starter/playtests/coyote.playtest.json +60 -8
- package/templates/starter/playtests/forward.playtest.json +29 -4
- package/templates/starter/playtests/gameover.playtest.json +66 -0
- package/templates/starter/playtests/goal.playtest.json +67 -0
- package/templates/starter/playtests/hot-reload.playtest.json +48 -8
- package/templates/starter/playtests/look.playtest.json +142 -10
- package/templates/starter/playtests/models-baseline.png +0 -0
- package/templates/starter/playtests/models.playtest.json +74 -0
- package/templates/starter/playtests/monitoring.playtest.json +38 -7
- package/templates/starter/playtests/odometer.playtest.json +54 -0
- package/templates/starter/playtests/pause.playtest.json +27 -4
- package/templates/starter/playtests/play.playtest.json +44 -7
- package/templates/starter/playtests/respawn.playtest.json +46 -6
- package/templates/starter/playtests/restart.playtest.json +65 -10
- package/templates/starter/playtests/seed.playtest.json +44 -8
- package/templates/starter/playtests/survives.playtest.json +48 -4
- package/templates/starter/playtests/textures-baseline.png +0 -0
- package/templates/starter/playtests/textures.playtest.json +74 -0
- package/templates/starter/playtests/touch-controls.playtest.json +42 -0
- package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
- package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
- package/templates/starter/src/conventions.ts +18 -0
- package/templates/starter/src/entities/Goal.ts +137 -0
- package/templates/starter/src/entities/Player.ts +111 -10
- package/templates/starter/src/game.ts +27 -0
- package/templates/starter/src/render/adaptiveQuality.ts +195 -0
- package/templates/starter/src/render/camera.ts +31 -5
- package/templates/starter/src/render/coast.ts +199 -0
- package/templates/starter/src/render/easing.ts +5 -0
- package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
- package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
- package/templates/starter/src/render/effects/sparkle.ts +49 -0
- package/templates/starter/src/render/hero.ts +88 -0
- package/templates/starter/src/render/implicitSurface.ts +199 -0
- package/templates/starter/src/render/kuwahara.ts +174 -0
- package/templates/starter/src/render/lighting.ts +10 -5
- package/templates/starter/src/render/loading.ts +325 -0
- package/templates/starter/src/render/materials.ts +39 -4
- package/templates/starter/src/render/outline.ts +141 -0
- package/templates/starter/src/render/painterly.ts +86 -0
- package/templates/starter/src/render/palette.ts +15 -6
- package/templates/starter/src/render/pennant.ts +54 -0
- package/templates/starter/src/render/postprocessing.ts +97 -15
- package/templates/starter/src/render/quality.ts +185 -0
- package/templates/starter/src/render/rockRidge.ts +198 -0
- package/templates/starter/src/render/rockRidge.worker.ts +77 -0
- package/templates/starter/src/render/scenery.ts +40 -0
- package/templates/starter/src/render/shapes.ts +9 -21
- package/templates/starter/src/render/textureLifetime.ts +53 -0
- package/templates/starter/src/render/touch-controls.ts +165 -0
- package/templates/starter/src/render/water.ts +38 -0
- package/templates/starter/src/render/watercolor.ts +85 -0
- package/templates/starter/src/render/worldEnvironment.ts +758 -0
- package/templates/starter/src/scenes/Play.ts +243 -46
- package/templates/starter/src/state.ts +12 -0
- package/templates/starter/src/style.css +72 -8
- package/templates/starter/src/ui/App.tsx +9 -6
- package/templates/starter/src/ui/GameUi.tsx +20 -0
- package/templates/starter/src/ui/Hud.tsx +52 -29
- package/templates/starter/src/ui/Menu.tsx +25 -23
- package/templates/starter/src/ui/main.tsx +14 -0
- package/templates/starter/threenative.config.ts +27 -9
- package/templates/starter/tools/look.mjs +109 -0
- package/templates/starter/vite.config.ts +32 -2
- package/templates/action-rpg/src/physics.ts +0 -40
- package/templates/minimal/assets/.gitkeep +0 -0
- package/templates/minimal/public/.gitkeep +0 -0
- package/templates/minimal/public/icon.png +0 -0
- package/templates/platformer/assets/.gitkeep +0 -0
- package/templates/platformer/public/.gitkeep +0 -0
- package/templates/platformer/public/icon.png +0 -0
- package/templates/shooter/src/physics.ts +0 -49
- package/templates/starter/assets/.gitkeep +0 -0
- package/templates/starter/public/.gitkeep +0 -0
- package/templates/starter/public/icon.png +0 -0
- package/templates/starter/public/pickup.ogg +0 -0
- /package/templates/starter/{public → assets}/native-proof.glb +0 -0
- /package/templates/starter/{public → assets}/native-proof.png +0 -0
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
{
|
|
2
|
+
"context_servers": {
|
|
3
|
+
"threenative-assets": {
|
|
4
|
+
"source": "custom",
|
|
5
|
+
"command": "node",
|
|
6
|
+
"args": [
|
|
7
|
+
"./node_modules/@threenative/core/mcp/assets.mjs"
|
|
8
|
+
],
|
|
9
|
+
"env": {
|
|
10
|
+
"ASSET_DOWNLOAD_DIR": "./public/assets",
|
|
11
|
+
"AUDIO_DOWNLOAD_DIR": "./public/audio"
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
"threenative-sculpt": {
|
|
15
|
+
"source": "custom",
|
|
16
|
+
"command": "node",
|
|
17
|
+
"args": [
|
|
18
|
+
"./node_modules/@threenative/core/mcp/sculpt.mjs"
|
|
19
|
+
]
|
|
20
|
+
},
|
|
21
|
+
"threenative-engine": {
|
|
22
|
+
"source": "custom",
|
|
23
|
+
"command": "node",
|
|
24
|
+
"args": [
|
|
25
|
+
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
26
|
+
]
|
|
27
|
+
},
|
|
28
|
+
"threenative-blender": {
|
|
29
|
+
"source": "custom",
|
|
30
|
+
"command": "node",
|
|
31
|
+
"args": [
|
|
32
|
+
"./node_modules/@threenative/core/mcp/blender.mjs"
|
|
33
|
+
]
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
# AGENTS.md — __PROJECT_NAME__ puzzle
|
|
2
|
+
|
|
3
|
+
Instructions for the AI agent in this game. `CLAUDE.md` mirrors this file; edit `AGENTS.md`.
|
|
4
|
+
|
|
5
|
+
## Ownership
|
|
6
|
+
|
|
7
|
+
ThreeNative owns bootstrap, renderer, fixed-step loop, input, loading, physics bindings, and the state bridge. This repository owns the room, the crates, the hinge, the ball, the goal, the HUD
|
|
8
|
+
and the look; `src/game.ts` is portable and React mounts only from `src/main.ts`.
|
|
9
|
+
|
|
10
|
+
## Start every change
|
|
11
|
+
|
|
12
|
+
1. **Critical planning gate:** invoke `threenative-capabilities` before `prd-creator`. Search
|
|
13
|
+
`engine_search_capabilities` for the full request and each concrete mechanic, inspect relevant
|
|
14
|
+
matches with `engine_capability_detail`, and record a capability or no-match for the plan.
|
|
15
|
+
2. Then invoke `prd-creator`. Draft the plan around those capabilities and binding constraints,
|
|
16
|
+
direct the user to review it, and wait for explicit approval plus an instruction to implement it.
|
|
17
|
+
3. Treat returned constraints as binding. This kit needs no navmesh and imports none, so it runs
|
|
18
|
+
on every target; adding `@threenative/physics/navigation` would make it web and desktop only.
|
|
19
|
+
4. If a build, import, device, or blank frame fails, run `npx threenative doctor` and
|
|
20
|
+
`npx @threenative/playtest doctor`; missing observations are not zero.
|
|
21
|
+
For *"a bullet passes through a wall"*, `RigidBody3D` defaults to continuous collision; `continuousCollision` is the named per-body override, and `body.continuousCollision` reports the effective setting on web/native.
|
|
22
|
+
|
|
23
|
+
## When the framework blocks you, write plain Three.js
|
|
24
|
+
|
|
25
|
+
When an `@threenative/*` API is broken, missing, or does not do what you need, replace only that
|
|
26
|
+
piece with portable Three.js/plain code. Keep the loop, scenes, input, registry, and playtest
|
|
27
|
+
bridge; avoid DOM globals, dynamic `import()`, and raw physics handles. **Report what blocked you**
|
|
28
|
+
(API, expectation, result, replacement); never stall the game.
|
|
29
|
+
|
|
30
|
+
## Workflow skills
|
|
31
|
+
|
|
32
|
+
- `.agents/skills/prd-creator/SKILL.md` / `.claude/skills/prd-creator/SKILL.md` — game plan and approval gate.
|
|
33
|
+
- `.agents/skills/threenative-capabilities/SKILL.md` / `.claude/skills/threenative-capabilities/SKILL.md` — capability search.
|
|
34
|
+
- `.agents/skills/threenative-playtest/SKILL.md` / `.claude/skills/threenative-playtest/SKILL.md` — diagnosis and proof.
|
|
35
|
+
- `.agents/skills/threenative-assets/SKILL.md` / `.claude/skills/threenative-assets/SKILL.md` — assets and sculpting.
|
|
36
|
+
- `.agents/skills/threenative-visuals/SKILL.md` / `.claude/skills/threenative-visuals/SKILL.md` — captures and look.
|
|
37
|
+
- `.agents/skills/threenative-performance/SKILL.md` / `.claude/skills/threenative-performance/SKILL.md` — measured budgets.
|
|
38
|
+
- `.agents/skills/threenative-ui/SKILL.md` / `.claude/skills/threenative-ui/SKILL.md` — native-safe UI.
|
|
39
|
+
- `.agents/skills/threenative-context/SKILL.md` / `.claude/skills/threenative-context/SKILL.md` — portable ctx APIs.
|
|
40
|
+
- Confirmed framework bugs: use `file-engine-bug` in `.agents/skills/` or `.claude/skills/` after a minimal repro.
|
|
41
|
+
|
|
42
|
+
## Commands and map
|
|
43
|
+
|
|
44
|
+
```sh
|
|
45
|
+
pnpm dev
|
|
46
|
+
pnpm build
|
|
47
|
+
pnpm build --target desktop
|
|
48
|
+
pnpm test
|
|
49
|
+
pnpm typecheck
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
`src/room.ts` builds the room's geometry and hands it to `buildStaticColliders`, so collision is
|
|
53
|
+
the geometry rather than a second hand-written list of boxes: move a wall and its collider moves.
|
|
54
|
+
The same file places the floor grid through one `InstancedBatch`, which is why 100+ tiles cost one
|
|
55
|
+
draw. `src/entities/Pendulum.ts` hangs a bob from a fixed beam with `Joint3D.hinge` — anchors are
|
|
56
|
+
in each body's **local** space. `src/entities/Ball.ts` owns the goal as an `Area3D` and listens for
|
|
57
|
+
`bodyEntered`; a distance check instead would fire on a ball that flew over the ring. A carried
|
|
58
|
+
crate is steered by velocity in `src/entities/Crate.ts` and never teleported, because snapping a
|
|
59
|
+
dynamic body each frame pushes it through walls. Register gameplay entities with `ctx.entities`;
|
|
60
|
+
the single React HUD reads `GameState`, never an entity. Keep `playtests/survives.playtest.json`
|
|
61
|
+
as smoke proof, and `carry` and `swing` honest when you change what they assert.
|
|
62
|
+
|
|
63
|
+
## Portable authoring contracts
|
|
64
|
+
|
|
65
|
+
Leave `assets` absent: the cook selects target-decodable passes, with `models.sharedImages: true` deduplicating images. `sharedImages: false` embeds duplicate copies; `models: "none"` / `textures: "none"` / `audio: "none"` skip those passes and report uncooked bytes. Android/iOS currently skip compression and model dedupe. `assets.exclude` defaults to `[]`; source-relative globs (for example `["unused/**"]`) omit matching files and report saved bytes. `assets.budget` accepts `{ uncooked?: number | "none", total?: number | "none" }`, default `{ uncooked: 64_000_000, total: "none" }`: only bytes left uncooked where cooking was possible count toward `uncooked`. A number sets that ceiling; `"none"` disables both gates. Either disabled gate still reports bytes. Automatic texture cooking retains unaligned source images unchanged and reports `block-size`; those bytes still count toward the uncooked budget. An explicit compression codec override must satisfy four-pixel block alignment; `codec: "none"` opts out. Cooking never silently resizes an image to fix alignment.
|
|
66
|
+
|
|
67
|
+
Relative look capture: a binding with `pointerRelative: true` captures the canvas on click by default; set `captureOnClick: false` and call `ctx.input.captureMouse()` from your own gesture to opt out. Desktop mode precedence is CLI (`--windowed`, `--maximized`, `--fullscreen`) over `display.fullscreen` over `window.maximized`; with both false, `window.width`/`height` size the normal window.
|
|
68
|
+
Scenes use `load`, `enter`, `update`, `exit`, `render`; physics nodes are Godot-named and disposable.
|
|
69
|
+
Generated conventions call `GroundSnap` for floor contact and `normaliseToMetres` for authored model scale.
|
|
70
|
+
The camera reads the claw **after** the step through `afterPhysics`; reading it in the frame function
|
|
71
|
+
is one step of lag, and on a swinging weight one step of lag is visible.
|
|
72
|
+
`input.vector("move").y` is +up, so forward uses one explicit `-move.y` conversion. Rigged assets: put a `.glb` in `assets/`, await `ctx.assets.model("hero.glb")` in `Scene.load()`, then drive
|
|
73
|
+
`AnimationPlayer` beside its entity. `ctx.goto(name)` rebuilds without resetting game state; from
|
|
74
|
+
a frame function `goto` and then `return`; `ctx.state.set({ /* copy this game's initial-state shape */ })`
|
|
75
|
+
is a partial patch. `game.goto("<scene-name>")` also rebuilds the scene, but it resets the game's
|
|
76
|
+
state. Seeded randomness is deterministic only when `defineGame({ seed })` is configured.
|
|
77
|
+
|
|
78
|
+
When an animation looks wrong, measure it before rewriting it. `clipPoseError` scores a
|
|
79
|
+
retargeted clip against its source per bone in degrees — whole quaternions relative to each rig's
|
|
80
|
+
own bind pose, so the two rigs' bind conventions cancel and a limb rolled about its own axis is
|
|
81
|
+
caught where a bone-direction check reads zero. `clipTrackBindings` names tracks that bind nothing
|
|
82
|
+
(the `<bone>.undefined` failure that plays the bind pose instead of the animation),
|
|
83
|
+
`clipBoneCoverage` names bones the clip does not drive and which therefore keep the previous
|
|
84
|
+
clip's pose, and `boneContact` reports in metres whether a named bone reaches the prop it is
|
|
85
|
+
supposed to be touching. Two loading conventions come from `@threenative/core`, not from your own loops: `loadAll(items, load)` fetches six at a time and returns results **in the input's order** (a pool that pushes returns completion order, so a positional pick lands a different asset every load), and `addInSlices(objects, (object) => ctx.add(object))` attaches 256 per presented frame so hundreds of objects never land in one long frame; override `concurrency`/`sliceSize`, pass `while: () => alive` to stop a torn-down scene without throwing, and `marker: false` silences `TN_LOAD_ALL`/`TN_ADD_SLICES` but never the measurement.
|
|
86
|
+
|
|
87
|
+
## Budget real time for the look — see `agent-docs/dream-loop.md`
|
|
88
|
+
|
|
89
|
+
Edit `src/render/` directly; `postprocessing.ts` reports stages but decides no game colour. Quality
|
|
90
|
+
tiers live in `src/render/quality.ts`: `low`, `medium`, `high`; `isMobile()` chooses `low`, otherwise
|
|
91
|
+
`high`; override with `setupPost(..., { tier: "low" })`. Unknown tiers throw and `TN_QUALITY_TIER`
|
|
92
|
+
reports the source. A scenario with no assertions or missing observations fails; open a real capture.
|
|
93
|
+
|
|
94
|
+
Recipes shipped in the project: `agent-docs/assertion-reference.md`, `agent-docs/capability-reference.md`, `agent-docs/capture-the-frame.md`, `agent-docs/creating-creatures.md`, `agent-docs/ctx-cookbook.md`, `agent-docs/debug-surface.md`, `agent-docs/finding-assets.md`, `agent-docs/gameplay-recipes.md`, `agent-docs/menu-screens.md`, `agent-docs/mobile-memory-budget.md`, `agent-docs/sculpt-from-a-reference.md`, `agent-docs/trace-a-slow-frame.md`, `agent-docs/visual-baseline.md`, and `agent-docs/webview-ui.md`.
|
|
95
|
+
## Optional multiplayer transport
|
|
96
|
+
For online play only, import `connect` from `@threenative/core/net` with an HTTPS URL and nonempty identity credential; configure `connectTimeoutMs`, `maxReliableMessageBytes`, `maxQueuedReliableBytes`, and `maxQueuedDatagrams` (10s/65,536/1 MiB/256), use `reliable-ordered` for ordered reliable messages and bounded `unreliable` datagrams that may drop, and keep serialization, replication, prediction, interpolation, snapshots and rejoin in this game's `src/` and server. There is no fallback: unsupported WebTransport/native rejects with `TN_NET_UNAVAILABLE`; reference Go server: `packages/runtime-native/examples/webtransport/server`.
|
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
<!-- Generated mirror of AGENTS.md. Do not edit; edit AGENTS.md. -->
|
|
2
|
+
|
|
3
|
+
# AGENTS.md — __PROJECT_NAME__ puzzle
|
|
4
|
+
|
|
5
|
+
Instructions for the AI agent in this game. `CLAUDE.md` mirrors this file; edit `AGENTS.md`.
|
|
6
|
+
|
|
7
|
+
## Ownership
|
|
8
|
+
|
|
9
|
+
ThreeNative owns bootstrap, renderer, fixed-step loop, input, loading, physics bindings, and the state bridge. This repository owns the room, the crates, the hinge, the ball, the goal, the HUD
|
|
10
|
+
and the look; `src/game.ts` is portable and React mounts only from `src/main.ts`.
|
|
11
|
+
|
|
12
|
+
## Start every change
|
|
13
|
+
|
|
14
|
+
1. **Critical planning gate:** invoke `threenative-capabilities` before `prd-creator`. Search
|
|
15
|
+
`engine_search_capabilities` for the full request and each concrete mechanic, inspect relevant
|
|
16
|
+
matches with `engine_capability_detail`, and record a capability or no-match for the plan.
|
|
17
|
+
2. Then invoke `prd-creator`. Draft the plan around those capabilities and binding constraints,
|
|
18
|
+
direct the user to review it, and wait for explicit approval plus an instruction to implement it.
|
|
19
|
+
3. Treat returned constraints as binding. This kit needs no navmesh and imports none, so it runs
|
|
20
|
+
on every target; adding `@threenative/physics/navigation` would make it web and desktop only.
|
|
21
|
+
4. If a build, import, device, or blank frame fails, run `npx threenative doctor` and
|
|
22
|
+
`npx @threenative/playtest doctor`; missing observations are not zero.
|
|
23
|
+
For *"a bullet passes through a wall"*, `RigidBody3D` defaults to continuous collision; `continuousCollision` is the named per-body override, and `body.continuousCollision` reports the effective setting on web/native.
|
|
24
|
+
|
|
25
|
+
## When the framework blocks you, write plain Three.js
|
|
26
|
+
|
|
27
|
+
When an `@threenative/*` API is broken, missing, or does not do what you need, replace only that
|
|
28
|
+
piece with portable Three.js/plain code. Keep the loop, scenes, input, registry, and playtest
|
|
29
|
+
bridge; avoid DOM globals, dynamic `import()`, and raw physics handles. **Report what blocked you**
|
|
30
|
+
(API, expectation, result, replacement); never stall the game.
|
|
31
|
+
|
|
32
|
+
## Workflow skills
|
|
33
|
+
|
|
34
|
+
- `.agents/skills/prd-creator/SKILL.md` / `.claude/skills/prd-creator/SKILL.md` — game plan and approval gate.
|
|
35
|
+
- `.agents/skills/threenative-capabilities/SKILL.md` / `.claude/skills/threenative-capabilities/SKILL.md` — capability search.
|
|
36
|
+
- `.agents/skills/threenative-playtest/SKILL.md` / `.claude/skills/threenative-playtest/SKILL.md` — diagnosis and proof.
|
|
37
|
+
- `.agents/skills/threenative-assets/SKILL.md` / `.claude/skills/threenative-assets/SKILL.md` — assets and sculpting.
|
|
38
|
+
- `.agents/skills/threenative-visuals/SKILL.md` / `.claude/skills/threenative-visuals/SKILL.md` — captures and look.
|
|
39
|
+
- `.agents/skills/threenative-performance/SKILL.md` / `.claude/skills/threenative-performance/SKILL.md` — measured budgets.
|
|
40
|
+
- `.agents/skills/threenative-ui/SKILL.md` / `.claude/skills/threenative-ui/SKILL.md` — native-safe UI.
|
|
41
|
+
- `.agents/skills/threenative-context/SKILL.md` / `.claude/skills/threenative-context/SKILL.md` — portable ctx APIs.
|
|
42
|
+
- Confirmed framework bugs: use `file-engine-bug` in `.agents/skills/` or `.claude/skills/` after a minimal repro.
|
|
43
|
+
|
|
44
|
+
## Commands and map
|
|
45
|
+
|
|
46
|
+
```sh
|
|
47
|
+
pnpm dev
|
|
48
|
+
pnpm build
|
|
49
|
+
pnpm build --target desktop
|
|
50
|
+
pnpm test
|
|
51
|
+
pnpm typecheck
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
`src/room.ts` builds the room's geometry and hands it to `buildStaticColliders`, so collision is
|
|
55
|
+
the geometry rather than a second hand-written list of boxes: move a wall and its collider moves.
|
|
56
|
+
The same file places the floor grid through one `InstancedBatch`, which is why 100+ tiles cost one
|
|
57
|
+
draw. `src/entities/Pendulum.ts` hangs a bob from a fixed beam with `Joint3D.hinge` — anchors are
|
|
58
|
+
in each body's **local** space. `src/entities/Ball.ts` owns the goal as an `Area3D` and listens for
|
|
59
|
+
`bodyEntered`; a distance check instead would fire on a ball that flew over the ring. A carried
|
|
60
|
+
crate is steered by velocity in `src/entities/Crate.ts` and never teleported, because snapping a
|
|
61
|
+
dynamic body each frame pushes it through walls. Register gameplay entities with `ctx.entities`;
|
|
62
|
+
the single React HUD reads `GameState`, never an entity. Keep `playtests/survives.playtest.json`
|
|
63
|
+
as smoke proof, and `carry` and `swing` honest when you change what they assert.
|
|
64
|
+
|
|
65
|
+
## Portable authoring contracts
|
|
66
|
+
|
|
67
|
+
Leave `assets` absent: the cook selects target-decodable passes, with `models.sharedImages: true` deduplicating images. `sharedImages: false` embeds duplicate copies; `models: "none"` / `textures: "none"` / `audio: "none"` skip those passes and report uncooked bytes. Android/iOS currently skip compression and model dedupe. `assets.exclude` defaults to `[]`; source-relative globs (for example `["unused/**"]`) omit matching files and report saved bytes. `assets.budget` accepts `{ uncooked?: number | "none", total?: number | "none" }`, default `{ uncooked: 64_000_000, total: "none" }`: only bytes left uncooked where cooking was possible count toward `uncooked`. A number sets that ceiling; `"none"` disables both gates. Either disabled gate still reports bytes. Automatic texture cooking retains unaligned source images unchanged and reports `block-size`; those bytes still count toward the uncooked budget. An explicit compression codec override must satisfy four-pixel block alignment; `codec: "none"` opts out. Cooking never silently resizes an image to fix alignment.
|
|
68
|
+
|
|
69
|
+
Relative look capture: a binding with `pointerRelative: true` captures the canvas on click by default; set `captureOnClick: false` and call `ctx.input.captureMouse()` from your own gesture to opt out. Desktop mode precedence is CLI (`--windowed`, `--maximized`, `--fullscreen`) over `display.fullscreen` over `window.maximized`; with both false, `window.width`/`height` size the normal window.
|
|
70
|
+
Scenes use `load`, `enter`, `update`, `exit`, `render`; physics nodes are Godot-named and disposable.
|
|
71
|
+
Generated conventions call `GroundSnap` for floor contact and `normaliseToMetres` for authored model scale.
|
|
72
|
+
The camera reads the claw **after** the step through `afterPhysics`; reading it in the frame function
|
|
73
|
+
is one step of lag, and on a swinging weight one step of lag is visible.
|
|
74
|
+
`input.vector("move").y` is +up, so forward uses one explicit `-move.y` conversion. Rigged assets: put a `.glb` in `assets/`, await `ctx.assets.model("hero.glb")` in `Scene.load()`, then drive
|
|
75
|
+
`AnimationPlayer` beside its entity. `ctx.goto(name)` rebuilds without resetting game state; from
|
|
76
|
+
a frame function `goto` and then `return`; `ctx.state.set({ /* copy this game's initial-state shape */ })`
|
|
77
|
+
is a partial patch. `game.goto("<scene-name>")` also rebuilds the scene, but it resets the game's
|
|
78
|
+
state. Seeded randomness is deterministic only when `defineGame({ seed })` is configured.
|
|
79
|
+
|
|
80
|
+
When an animation looks wrong, measure it before rewriting it. `clipPoseError` scores a
|
|
81
|
+
retargeted clip against its source per bone in degrees — whole quaternions relative to each rig's
|
|
82
|
+
own bind pose, so the two rigs' bind conventions cancel and a limb rolled about its own axis is
|
|
83
|
+
caught where a bone-direction check reads zero. `clipTrackBindings` names tracks that bind nothing
|
|
84
|
+
(the `<bone>.undefined` failure that plays the bind pose instead of the animation),
|
|
85
|
+
`clipBoneCoverage` names bones the clip does not drive and which therefore keep the previous
|
|
86
|
+
clip's pose, and `boneContact` reports in metres whether a named bone reaches the prop it is
|
|
87
|
+
supposed to be touching. Two loading conventions come from `@threenative/core`, not from your own loops: `loadAll(items, load)` fetches six at a time and returns results **in the input's order** (a pool that pushes returns completion order, so a positional pick lands a different asset every load), and `addInSlices(objects, (object) => ctx.add(object))` attaches 256 per presented frame so hundreds of objects never land in one long frame; override `concurrency`/`sliceSize`, pass `while: () => alive` to stop a torn-down scene without throwing, and `marker: false` silences `TN_LOAD_ALL`/`TN_ADD_SLICES` but never the measurement.
|
|
88
|
+
|
|
89
|
+
## Budget real time for the look — see `agent-docs/dream-loop.md`
|
|
90
|
+
|
|
91
|
+
Edit `src/render/` directly; `postprocessing.ts` reports stages but decides no game colour. Quality
|
|
92
|
+
tiers live in `src/render/quality.ts`: `low`, `medium`, `high`; `isMobile()` chooses `low`, otherwise
|
|
93
|
+
`high`; override with `setupPost(..., { tier: "low" })`. Unknown tiers throw and `TN_QUALITY_TIER`
|
|
94
|
+
reports the source. A scenario with no assertions or missing observations fails; open a real capture.
|
|
95
|
+
|
|
96
|
+
Recipes shipped in the project: `agent-docs/assertion-reference.md`, `agent-docs/capability-reference.md`, `agent-docs/capture-the-frame.md`, `agent-docs/creating-creatures.md`, `agent-docs/ctx-cookbook.md`, `agent-docs/debug-surface.md`, `agent-docs/finding-assets.md`, `agent-docs/gameplay-recipes.md`, `agent-docs/menu-screens.md`, `agent-docs/mobile-memory-budget.md`, `agent-docs/sculpt-from-a-reference.md`, `agent-docs/trace-a-slow-frame.md`, `agent-docs/visual-baseline.md`, and `agent-docs/webview-ui.md`.
|
|
97
|
+
## Optional multiplayer transport
|
|
98
|
+
For online play only, import `connect` from `@threenative/core/net` with an HTTPS URL and nonempty identity credential; configure `connectTimeoutMs`, `maxReliableMessageBytes`, `maxQueuedReliableBytes`, and `maxQueuedDatagrams` (10s/65,536/1 MiB/256), use `reliable-ordered` for ordered reliable messages and bounded `unreliable` datagrams that may drop, and keep serialization, replication, prediction, interpolation, snapshots and rejoin in this game's `src/` and server. There is no fallback: unsupported WebTransport/native rejects with `TN_NET_UNAVAILABLE`; reference Go server: `packages/runtime-native/examples/webtransport/server`.
|
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
# Puzzle starter kit
|
|
2
|
+
|
|
3
|
+
A contraption room. A ball has to reach a ring on the far side of a lip it cannot roll over, and
|
|
4
|
+
everything in the room is a way of getting it there: three crates you carry into a ramp, and a
|
|
5
|
+
90 kg weight hanging from a hinge that you can set swinging.
|
|
6
|
+
|
|
7
|
+
Nothing here is downloaded. Every shape is a box, cylinder, sphere or torus built in
|
|
8
|
+
`src/render/shapes.ts`, so the kit has no asset licence, no loading wait, and nothing to fetch.
|
|
9
|
+
|
|
10
|
+
```sh
|
|
11
|
+
pnpm dev # play it
|
|
12
|
+
pnpm test # the committed scenarios, in a real browser
|
|
13
|
+
pnpm build # web
|
|
14
|
+
pnpm build --target desktop
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
## Controls
|
|
18
|
+
|
|
19
|
+
| Input | Does |
|
|
20
|
+
| --- | --- |
|
|
21
|
+
| `W A S D` / arrows | move the claw |
|
|
22
|
+
| `E` or `Space`, or tap a crate | grab and drop the nearest crate |
|
|
23
|
+
| `F` | shove the hanging weight |
|
|
24
|
+
| `R` | reset the room |
|
|
25
|
+
|
|
26
|
+
On a touch device a left thumbstick and two buttons appear instead; the same code path runs.
|
|
27
|
+
|
|
28
|
+
## What each piece is
|
|
29
|
+
|
|
30
|
+
| File | Owns |
|
|
31
|
+
| --- | --- |
|
|
32
|
+
| `src/room.ts` | the room's geometry, its static colliders, and the instanced floor grid |
|
|
33
|
+
| `src/entities/Crate.ts` | a carried box — steered by velocity, never teleported |
|
|
34
|
+
| `src/entities/Pendulum.ts` | the beam, the bob, and the hinge between them |
|
|
35
|
+
| `src/entities/Ball.ts` | the ball and the goal volume that notices it |
|
|
36
|
+
| `src/entities/Gripper.ts` | the player |
|
|
37
|
+
| `src/render/` | everything that decides how it looks. Yours to rewrite. |
|
|
38
|
+
|
|
39
|
+
## Where to take it
|
|
40
|
+
|
|
41
|
+
The room is one `buildRoom()` call and three crate spawns. Move the lip, add a second ball, hang
|
|
42
|
+
two weights on one beam, or make the goal move. If you want a second room, add a scene beside
|
|
43
|
+
`Puzzle` and `goto` it — the state shape and HUD already carry a status.
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
<!doctype html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8" />
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
|
6
|
+
<title>__PROJECT_NAME__</title>
|
|
7
|
+
</head>
|
|
8
|
+
<body>
|
|
9
|
+
<div id="root"></div>
|
|
10
|
+
<script type="module" src="/src/main.ts"></script>
|
|
11
|
+
</body>
|
|
12
|
+
</html>
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "https://opencode.ai/config.json",
|
|
3
|
+
"mcp": {
|
|
4
|
+
"threenative-assets": {
|
|
5
|
+
"type": "local",
|
|
6
|
+
"command": [
|
|
7
|
+
"node",
|
|
8
|
+
"./node_modules/@threenative/core/mcp/assets.mjs"
|
|
9
|
+
],
|
|
10
|
+
"enabled": true,
|
|
11
|
+
"environment": {
|
|
12
|
+
"ASSET_DOWNLOAD_DIR": "./public/assets",
|
|
13
|
+
"AUDIO_DOWNLOAD_DIR": "./public/audio"
|
|
14
|
+
}
|
|
15
|
+
},
|
|
16
|
+
"threenative-sculpt": {
|
|
17
|
+
"type": "local",
|
|
18
|
+
"command": [
|
|
19
|
+
"node",
|
|
20
|
+
"./node_modules/@threenative/core/mcp/sculpt.mjs"
|
|
21
|
+
],
|
|
22
|
+
"enabled": true
|
|
23
|
+
},
|
|
24
|
+
"threenative-engine": {
|
|
25
|
+
"type": "local",
|
|
26
|
+
"command": [
|
|
27
|
+
"node",
|
|
28
|
+
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
29
|
+
],
|
|
30
|
+
"enabled": true
|
|
31
|
+
},
|
|
32
|
+
"threenative-blender": {
|
|
33
|
+
"type": "local",
|
|
34
|
+
"command": [
|
|
35
|
+
"node",
|
|
36
|
+
"./node_modules/@threenative/core/mcp/blender.mjs"
|
|
37
|
+
],
|
|
38
|
+
"enabled": true
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "__PROJECT_NAME__",
|
|
3
|
+
"private": true,
|
|
4
|
+
"license": "MIT",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"scripts": {
|
|
7
|
+
"dev": "vite",
|
|
8
|
+
"build": "threenative build",
|
|
9
|
+
"build:web": "threenative build --target web",
|
|
10
|
+
"build:desktop": "threenative build --target desktop",
|
|
11
|
+
"build:android": "threenative build --target android",
|
|
12
|
+
"build:ios": "threenative build --target ios",
|
|
13
|
+
"pretest": "playwright install chromium",
|
|
14
|
+
"test": "vite build && threenative-playtest --scenario \"playtests/*.playtest.json\" --browser-recipe webgpu --headed --server-command \"pnpm dev --host 127.0.0.1 --port $PORT --strictPort\"",
|
|
15
|
+
"typecheck": "tsc --noEmit -p tsconfig.json"
|
|
16
|
+
},
|
|
17
|
+
"dependencies": {
|
|
18
|
+
"@threenative/core": "0.3.1",
|
|
19
|
+
"@threenative/physics": "0.3.1",
|
|
20
|
+
"@threenative/ui": "0.3.1",
|
|
21
|
+
"react": "19.2.0",
|
|
22
|
+
"react-dom": "19.2.0",
|
|
23
|
+
"three": "0.185.1"
|
|
24
|
+
},
|
|
25
|
+
"devDependencies": {
|
|
26
|
+
"@gltf-transform/cli": "4.4.2",
|
|
27
|
+
"@tailwindcss/vite": "4.3.3",
|
|
28
|
+
"@threenative/assets": "0.3.1",
|
|
29
|
+
"@threenative/playtest": "0.3.1",
|
|
30
|
+
"@types/react": "19.2.0",
|
|
31
|
+
"@types/react-dom": "19.2.0",
|
|
32
|
+
"@types/three": "0.185.3",
|
|
33
|
+
"@vitejs/plugin-react": "6.0.5",
|
|
34
|
+
"create-threenative": "0.2.4",
|
|
35
|
+
"esbuild": "0.27.0",
|
|
36
|
+
"playwright": "1.62.1",
|
|
37
|
+
"tailwindcss": "4.3.3",
|
|
38
|
+
"typescript": "5.9.3",
|
|
39
|
+
"vite": "8.2.0"
|
|
40
|
+
},
|
|
41
|
+
"optionalDependencies": {
|
|
42
|
+
"@threenative/runtime-native": "0.3.1"
|
|
43
|
+
},
|
|
44
|
+
"pnpm": {
|
|
45
|
+
"onlyBuiltDependencies": ["@threenative/core", "@threenative/runtime-native"],
|
|
46
|
+
"patchedDependencies": {
|
|
47
|
+
"three@0.185.1": "patches/three@0.185.1.patch"
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "carry",
|
|
3
|
+
"target": "web",
|
|
4
|
+
"schemaVersion": 1,
|
|
5
|
+
"viewport": {
|
|
6
|
+
"width": 1280,
|
|
7
|
+
"height": 720
|
|
8
|
+
},
|
|
9
|
+
"warmupFrames": 40,
|
|
10
|
+
"subject": "player",
|
|
11
|
+
"steps": [
|
|
12
|
+
{
|
|
13
|
+
"kind": "input",
|
|
14
|
+
"label": "walk-to-crate",
|
|
15
|
+
"press": "ArrowUp",
|
|
16
|
+
"holdTicks": 30,
|
|
17
|
+
"release": true
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"kind": "input",
|
|
21
|
+
"label": "grab",
|
|
22
|
+
"press": "KeyE",
|
|
23
|
+
"holdTicks": 4,
|
|
24
|
+
"release": true
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"kind": "wait",
|
|
28
|
+
"label": "lift",
|
|
29
|
+
"waitTicks": 30,
|
|
30
|
+
"release": true
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
"kind": "input",
|
|
34
|
+
"label": "carry-back",
|
|
35
|
+
"press": "ArrowDown",
|
|
36
|
+
"holdTicks": 70,
|
|
37
|
+
"release": true
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"kind": "wait",
|
|
41
|
+
"label": "settle",
|
|
42
|
+
"waitTicks": 20,
|
|
43
|
+
"release": true
|
|
44
|
+
}
|
|
45
|
+
],
|
|
46
|
+
"assert": {
|
|
47
|
+
"diagnostics": {
|
|
48
|
+
"noConsoleErrors": true,
|
|
49
|
+
"noNetworkErrors": true,
|
|
50
|
+
"noRuntimeDiagnostics": true,
|
|
51
|
+
"runtimeReady": true
|
|
52
|
+
},
|
|
53
|
+
"components": [
|
|
54
|
+
{
|
|
55
|
+
"component": "held",
|
|
56
|
+
"entity": "crate.0",
|
|
57
|
+
"equals": true
|
|
58
|
+
},
|
|
59
|
+
{
|
|
60
|
+
"changed": true,
|
|
61
|
+
"component": "position",
|
|
62
|
+
"entity": "crate.0",
|
|
63
|
+
"path": "2"
|
|
64
|
+
}
|
|
65
|
+
],
|
|
66
|
+
"movement": {
|
|
67
|
+
"entity": "player",
|
|
68
|
+
"minDistance": 1.5
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
{
|
|
2
|
+
"acceptanceId": "puzzle-production-performance",
|
|
3
|
+
"artifacts": { "screenshots": "after" },
|
|
4
|
+
"assert": {
|
|
5
|
+
"performance": {
|
|
6
|
+
"maxDrawCalls": 145,
|
|
7
|
+
"maxFrameMsP95": 33,
|
|
8
|
+
"maxTriangles": 12000,
|
|
9
|
+
"minFps": 30
|
|
10
|
+
},
|
|
11
|
+
"renderChain": { "tier": "high" }
|
|
12
|
+
},
|
|
13
|
+
"name": "production-performance",
|
|
14
|
+
"schemaVersion": 1,
|
|
15
|
+
"steps": [
|
|
16
|
+
{ "kind": "input", "press": "ArrowRight", "holdTicks": 60, "release": true },
|
|
17
|
+
{ "kind": "wait", "waitTicks": 600, "release": true }
|
|
18
|
+
],
|
|
19
|
+
"subject": "player",
|
|
20
|
+
"target": "web",
|
|
21
|
+
"viewport": { "height": 1080, "width": 1920 },
|
|
22
|
+
"warmupFrames": 60
|
|
23
|
+
}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "survives",
|
|
3
|
+
"target": "web",
|
|
4
|
+
"schemaVersion": 1,
|
|
5
|
+
"viewport": { "width": 1280, "height": 720 },
|
|
6
|
+
"warmupFrames": 40,
|
|
7
|
+
"subject": "player",
|
|
8
|
+
"steps": [
|
|
9
|
+
{ "kind": "input", "label": "move", "press": "ArrowUp", "holdTicks": 60, "release": true },
|
|
10
|
+
{ "kind": "wait", "label": "settle", "waitTicks": 10, "release": true }
|
|
11
|
+
],
|
|
12
|
+
"assert": {
|
|
13
|
+
"diagnostics": {
|
|
14
|
+
"noConsoleErrors": true,
|
|
15
|
+
"noNetworkErrors": true,
|
|
16
|
+
"noRuntimeDiagnostics": true,
|
|
17
|
+
"runtimeReady": true
|
|
18
|
+
},
|
|
19
|
+
"components": [
|
|
20
|
+
{
|
|
21
|
+
"allowTrivial": "GroundSnap settles the claw before this movement observation; the finite near-zero clearance is the generated call-site proof.",
|
|
22
|
+
"component": "groundClearance",
|
|
23
|
+
"entity": "player",
|
|
24
|
+
"lte": 0.01
|
|
25
|
+
}
|
|
26
|
+
],
|
|
27
|
+
"movement": {
|
|
28
|
+
"entity": "player",
|
|
29
|
+
"minDistance": 0.5,
|
|
30
|
+
"minAxisDelta": { "axis": "-z", "min": 0.5 }
|
|
31
|
+
},
|
|
32
|
+
"visibility": [
|
|
33
|
+
{
|
|
34
|
+
"entity": "touch-controls",
|
|
35
|
+
"present": false,
|
|
36
|
+
"allowTrivial": "Desktop keyboard lanes intentionally omit touch controls while movement proves the scene is active."
|
|
37
|
+
}
|
|
38
|
+
],
|
|
39
|
+
"visual": [
|
|
40
|
+
{
|
|
41
|
+
"region": {
|
|
42
|
+
"x": 0,
|
|
43
|
+
"y": 0,
|
|
44
|
+
"width": 1280,
|
|
45
|
+
"height": 720,
|
|
46
|
+
"minNonblankPixelRatio": 0.01
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
]
|
|
50
|
+
}
|
|
51
|
+
}
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "swing",
|
|
3
|
+
"target": "web",
|
|
4
|
+
"schemaVersion": 1,
|
|
5
|
+
"viewport": { "width": 1280, "height": 720 },
|
|
6
|
+
"warmupFrames": 60,
|
|
7
|
+
"subject": "pendulum",
|
|
8
|
+
"steps": [
|
|
9
|
+
{ "kind": "wait", "label": "hang-still", "waitTicks": 60, "release": true },
|
|
10
|
+
{ "kind": "input", "label": "shove", "press": "KeyF", "holdTicks": 4, "release": true },
|
|
11
|
+
{ "kind": "wait", "label": "swing-out", "waitTicks": 40, "release": true }
|
|
12
|
+
],
|
|
13
|
+
"assert": {
|
|
14
|
+
"diagnostics": {
|
|
15
|
+
"noConsoleErrors": true,
|
|
16
|
+
"noNetworkErrors": true,
|
|
17
|
+
"noRuntimeDiagnostics": true,
|
|
18
|
+
"runtimeReady": true
|
|
19
|
+
},
|
|
20
|
+
"components": [
|
|
21
|
+
{
|
|
22
|
+
"component": "swings",
|
|
23
|
+
"entity": "pendulum",
|
|
24
|
+
"gte": 1
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"changed": true,
|
|
28
|
+
"component": "position",
|
|
29
|
+
"entity": "pendulum",
|
|
30
|
+
"path": "2"
|
|
31
|
+
}
|
|
32
|
+
],
|
|
33
|
+
"movement": {
|
|
34
|
+
"entity": "pendulum",
|
|
35
|
+
"minDistance": 0.3
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import { GroundSnap, normaliseToMetres } from "@threenative/core";
|
|
2
|
+
import type { Group } from "three";
|
|
3
|
+
|
|
4
|
+
export interface IPuzzleConventions {
|
|
5
|
+
readonly applyGrounding: (surfaceY: number, dt: number) => void;
|
|
6
|
+
readonly groundSnap: GroundSnap;
|
|
7
|
+
readonly normaliseFactor: number;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* One metre is one metre, and the claw's feet meet the floor.
|
|
12
|
+
*
|
|
13
|
+
* `normaliseToMetres` returns the factor it applied, and `GroundSnap` reports the clearance it
|
|
14
|
+
* settled on. Both are published through the gripper's `debug()`, so a scenario can prove the
|
|
15
|
+
* conventions ran rather than trusting that they did.
|
|
16
|
+
*/
|
|
17
|
+
export function prepareGripperConventions(model: Group): IPuzzleConventions {
|
|
18
|
+
const normaliseFactor = normaliseToMetres(model, { axis: "height", metres: 1.7 });
|
|
19
|
+
const groundSnap = new GroundSnap(model);
|
|
20
|
+
return {
|
|
21
|
+
applyGrounding: (surfaceY, dt) => groundSnap.apply(model, surfaceY, dt),
|
|
22
|
+
groundSnap,
|
|
23
|
+
normaliseFactor,
|
|
24
|
+
};
|
|
25
|
+
}
|