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
|
@@ -63,11 +63,21 @@
|
|
|
63
63
|
"assert": {
|
|
64
64
|
"diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
|
|
65
65
|
"resources": [
|
|
66
|
-
{ "id": "
|
|
67
|
-
{ "id": "GameState", "path": "place", "gte": 2, "allowTrivial": true },
|
|
68
|
-
{ "id": "GameState", "path": "rescues", "equals": 0, "allowTrivial": true },
|
|
66
|
+
{ "id": "state", "path": "completedLaps", "gte": 3, "changed": true },
|
|
69
67
|
{
|
|
70
|
-
"id": "
|
|
68
|
+
"id": "state",
|
|
69
|
+
"path": "place",
|
|
70
|
+
"gte": 2,
|
|
71
|
+
"allowTrivial": "The outcome fixture starts with a qualifying place; this row records the held ranking bound while the finish transition proves the race."
|
|
72
|
+
},
|
|
73
|
+
{
|
|
74
|
+
"id": "state",
|
|
75
|
+
"path": "rescues",
|
|
76
|
+
"equals": 0,
|
|
77
|
+
"allowTrivial": "The outcome path uses no rescue action; zero rescues is the intentional held invariant while laps and finish prove the result."
|
|
78
|
+
},
|
|
79
|
+
{
|
|
80
|
+
"id": "state",
|
|
71
81
|
"path": "raceStatus",
|
|
72
82
|
"equals": "DNF",
|
|
73
83
|
"changed": true,
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
{
|
|
2
|
+
"acceptanceId": "prd-194-performance-racing",
|
|
3
|
+
"artifacts": {
|
|
4
|
+
"screenshots": "after"
|
|
5
|
+
},
|
|
6
|
+
"assert": {
|
|
7
|
+
"performance": {
|
|
8
|
+
"maxDrawCalls": 330,
|
|
9
|
+
"maxFrameMsP95": 33,
|
|
10
|
+
"maxTriangles": 105000,
|
|
11
|
+
"minFps": 30
|
|
12
|
+
},
|
|
13
|
+
"renderChain": {
|
|
14
|
+
"tier": "high"
|
|
15
|
+
}
|
|
16
|
+
},
|
|
17
|
+
"name": "production-performance",
|
|
18
|
+
"schemaVersion": 1,
|
|
19
|
+
"steps": [
|
|
20
|
+
{
|
|
21
|
+
"kind": "input",
|
|
22
|
+
"press": "ArrowUp",
|
|
23
|
+
"holdTicks": 60,
|
|
24
|
+
"release": true
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"kind": "wait",
|
|
28
|
+
"waitTicks": 600,
|
|
29
|
+
"release": true
|
|
30
|
+
}
|
|
31
|
+
],
|
|
32
|
+
"subject": "player",
|
|
33
|
+
"target": "web",
|
|
34
|
+
"viewport": {
|
|
35
|
+
"height": 1080,
|
|
36
|
+
"width": 1920
|
|
37
|
+
},
|
|
38
|
+
"warmupFrames": 60
|
|
39
|
+
}
|
|
@@ -24,14 +24,14 @@
|
|
|
24
24
|
"diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
|
|
25
25
|
"resources": [
|
|
26
26
|
{
|
|
27
|
-
"id": "
|
|
27
|
+
"id": "state",
|
|
28
28
|
"path": "sameDistanceRanking",
|
|
29
29
|
"atSteps": [
|
|
30
30
|
{ "label": "lap-aware-baseline", "equals": "lap-ahead" },
|
|
31
31
|
{ "label": "advance-on-route", "equals": "lap-ahead" }
|
|
32
32
|
]
|
|
33
33
|
},
|
|
34
|
-
{ "id": "
|
|
34
|
+
{ "id": "state", "path": "trackProgress", "gte": 142, "changed": true }
|
|
35
35
|
]
|
|
36
36
|
}
|
|
37
37
|
}
|
|
@@ -17,12 +17,18 @@
|
|
|
17
17
|
"assert": {
|
|
18
18
|
"diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
|
|
19
19
|
"resources": [
|
|
20
|
-
{ "id": "
|
|
21
|
-
{ "id": "
|
|
22
|
-
{ "id": "
|
|
23
|
-
{ "id": "
|
|
24
|
-
{ "id": "
|
|
20
|
+
{ "id": "state", "path": "rescues", "gte": 1, "changed": true },
|
|
21
|
+
{ "id": "state", "path": "lastOnRoad", "changed": true },
|
|
22
|
+
{ "id": "state", "path": "rescueHeading", "changed": true },
|
|
23
|
+
{ "id": "state", "path": "rescuePositionError", "equals": 0, "changed": true },
|
|
24
|
+
{ "id": "state", "path": "rescueHeadingError", "equals": 0, "changed": true }
|
|
25
25
|
],
|
|
26
|
-
"visibility": [
|
|
26
|
+
"visibility": [
|
|
27
|
+
{
|
|
28
|
+
"allowTrivial": "The racing scene begins with the player visible and in frame; this held visibility row accompanies the rescue assertion.",
|
|
29
|
+
"entity": "player",
|
|
30
|
+
"minProjectedPixels": 20
|
|
31
|
+
}
|
|
32
|
+
]
|
|
27
33
|
}
|
|
28
34
|
}
|
|
@@ -26,12 +26,12 @@
|
|
|
26
26
|
"diagnostics": { "noConsoleErrors": true, "runtimeReady": true },
|
|
27
27
|
"resources": [
|
|
28
28
|
{
|
|
29
|
-
"id": "
|
|
29
|
+
"id": "state",
|
|
30
30
|
"path": "completedLaps",
|
|
31
31
|
"equals": 0,
|
|
32
|
-
"allowTrivial":
|
|
32
|
+
"allowTrivial": "Reverse steering tests rejection before a lap completes; zero completed laps is the intentional held race-start invariant."
|
|
33
33
|
},
|
|
34
|
-
{ "id": "
|
|
34
|
+
{ "id": "state", "path": "reverseRejects", "gte": 1, "changed": true }
|
|
35
35
|
]
|
|
36
36
|
}
|
|
37
37
|
}
|
|
@@ -33,12 +33,12 @@
|
|
|
33
33
|
],
|
|
34
34
|
"resources": [
|
|
35
35
|
{
|
|
36
|
-
"id": "
|
|
36
|
+
"id": "state",
|
|
37
37
|
"path": "completedLaps",
|
|
38
38
|
"equals": 0,
|
|
39
|
-
"allowTrivial":
|
|
39
|
+
"allowTrivial": "The shortcut rejection occurs before a lap completes; zero completed laps is the intentional held race-start invariant."
|
|
40
40
|
},
|
|
41
|
-
{ "id": "
|
|
41
|
+
{ "id": "state", "path": "shortcutRejects", "gte": 1, "changed": true }
|
|
42
42
|
]
|
|
43
43
|
}
|
|
44
44
|
}
|
|
@@ -2,12 +2,26 @@
|
|
|
2
2
|
"name": "survives",
|
|
3
3
|
"target": "web",
|
|
4
4
|
"schemaVersion": 1,
|
|
5
|
-
"viewport": {
|
|
5
|
+
"viewport": {
|
|
6
|
+
"width": 1280,
|
|
7
|
+
"height": 720
|
|
8
|
+
},
|
|
6
9
|
"warmupFrames": 10,
|
|
7
10
|
"subject": "player",
|
|
8
11
|
"steps": [
|
|
9
|
-
{
|
|
10
|
-
|
|
12
|
+
{
|
|
13
|
+
"kind": "input",
|
|
14
|
+
"label": "move",
|
|
15
|
+
"press": "ArrowUp",
|
|
16
|
+
"holdTicks": 60,
|
|
17
|
+
"release": true
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"kind": "wait",
|
|
21
|
+
"label": "settle",
|
|
22
|
+
"waitTicks": 10,
|
|
23
|
+
"release": true
|
|
24
|
+
}
|
|
11
25
|
],
|
|
12
26
|
"assert": {
|
|
13
27
|
"diagnostics": {
|
|
@@ -16,7 +30,25 @@
|
|
|
16
30
|
"noRuntimeDiagnostics": true,
|
|
17
31
|
"runtimeReady": true
|
|
18
32
|
},
|
|
19
|
-
"
|
|
33
|
+
"components": [
|
|
34
|
+
{
|
|
35
|
+
"allowTrivial": "The vehicle is authored at its real 4.4 m length and normalised down to the conventional 3 m, so the retained factor is below one; either side of one proves normaliseToMetres ran in the generated car.",
|
|
36
|
+
"component": "normaliseFactor",
|
|
37
|
+
"entity": "player",
|
|
38
|
+
"lte": 0.99
|
|
39
|
+
}
|
|
40
|
+
],
|
|
41
|
+
"movement": {
|
|
42
|
+
"entity": "player",
|
|
43
|
+
"minDistance": 0.5
|
|
44
|
+
},
|
|
45
|
+
"visibility": [
|
|
46
|
+
{
|
|
47
|
+
"entity": "touch-controls",
|
|
48
|
+
"present": false,
|
|
49
|
+
"allowTrivial": "Desktop keyboard lanes intentionally omit touch controls while movement proves the scene is active."
|
|
50
|
+
}
|
|
51
|
+
],
|
|
20
52
|
"visual": [
|
|
21
53
|
{
|
|
22
54
|
"region": {
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "racing-touch-controls",
|
|
3
|
+
"schemaVersion": 1,
|
|
4
|
+
"target": "web",
|
|
5
|
+
"viewport": { "width": 1280, "height": 720 },
|
|
6
|
+
"warmupFrames": 10,
|
|
7
|
+
"subject": "player",
|
|
8
|
+
"steps": [
|
|
9
|
+
{
|
|
10
|
+
"kind": "input",
|
|
11
|
+
"label": "throttle-anchor",
|
|
12
|
+
"pointers": [{ "id": 7, "x": 0.18, "y": 0.75 }],
|
|
13
|
+
"holdTicks": 2,
|
|
14
|
+
"release": false
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"kind": "input",
|
|
18
|
+
"label": "throttle-forward",
|
|
19
|
+
"pointers": [{ "id": 7, "x": 0.18, "y": 0.55 }],
|
|
20
|
+
"holdTicks": 90,
|
|
21
|
+
"release": true
|
|
22
|
+
},
|
|
23
|
+
{ "kind": "wait", "label": "settled", "waitTicks": 10, "release": true }
|
|
24
|
+
],
|
|
25
|
+
"assert": {
|
|
26
|
+
"diagnostics": {
|
|
27
|
+
"noConsoleErrors": true,
|
|
28
|
+
"noNetworkErrors": true,
|
|
29
|
+
"noRuntimeDiagnostics": true,
|
|
30
|
+
"runtimeReady": true
|
|
31
|
+
},
|
|
32
|
+
"resources": [{ "id": "state", "path": "speed", "gte": 0.1, "changed": true }],
|
|
33
|
+
"visibility": [
|
|
34
|
+
{
|
|
35
|
+
"entity": "touch-controls",
|
|
36
|
+
"present": true,
|
|
37
|
+
"allowTrivial": "Touch-primary lanes keep the authored controls visible while state assertions prove they are live."
|
|
38
|
+
}
|
|
39
|
+
]
|
|
40
|
+
}
|
|
41
|
+
}
|
|
@@ -1,9 +1,11 @@
|
|
|
1
1
|
import type { ICtx } from "@threenative/core";
|
|
2
2
|
import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
|
|
3
3
|
import { Group, Vector3 } from "three";
|
|
4
|
+
import { prepareVehicleConventions } from "../conventions.js";
|
|
4
5
|
import { Boost } from "../kart/boost.js";
|
|
5
6
|
import { createMaterials } from "../render/materials.js";
|
|
6
7
|
import { vehicle } from "../render/shapes.js";
|
|
8
|
+
import type { ITouchInput } from "../render/touch-controls.js";
|
|
7
9
|
import type { GameState } from "../state.js";
|
|
8
10
|
|
|
9
11
|
type GameCtx = ICtx<GameState, IPhysicsContext>;
|
|
@@ -26,12 +28,15 @@ export class RacingCar {
|
|
|
26
28
|
readonly boost = new Boost();
|
|
27
29
|
#speed = 0;
|
|
28
30
|
#heading = 0;
|
|
31
|
+
#normaliseFactor: number;
|
|
29
32
|
#topSpeed = 0;
|
|
30
33
|
|
|
31
34
|
constructor(ctx: GameCtx, spawn: Vector3) {
|
|
32
35
|
this.mesh.position.copy(spawn);
|
|
33
36
|
this.mesh.castShadow = true;
|
|
34
|
-
|
|
37
|
+
const visual = vehicle(createMaterials());
|
|
38
|
+
this.#normaliseFactor = prepareVehicleConventions(visual);
|
|
39
|
+
this.mesh.add(visual);
|
|
35
40
|
ctx.add(this.mesh);
|
|
36
41
|
this.body = new CharacterBody3D({
|
|
37
42
|
autostep: { maxHeight: 0.25, minWidth: 0.2 },
|
|
@@ -46,17 +51,23 @@ export class RacingCar {
|
|
|
46
51
|
});
|
|
47
52
|
}
|
|
48
53
|
|
|
49
|
-
update(ctx: GameCtx, dt: number): void {
|
|
54
|
+
update(ctx: GameCtx, dt: number, touch?: ITouchInput): void {
|
|
50
55
|
this.boost.update(dt);
|
|
51
|
-
if (ctx.input.justPressed("boost")) this.boost.activate();
|
|
56
|
+
if (ctx.input.justPressed("boost") || touch?.boostPressed === true) this.boost.activate();
|
|
52
57
|
const move = ctx.input.vector("move");
|
|
58
|
+
if (touch !== undefined) {
|
|
59
|
+
move.x += touch.move.x;
|
|
60
|
+
move.y += touch.move.y;
|
|
61
|
+
move.clampLength(0, 1);
|
|
62
|
+
}
|
|
53
63
|
const throttle = move.y;
|
|
54
64
|
const target =
|
|
55
65
|
throttle * RACING_FEEL.maxSpeed * (this.boost.active ? this.boost.multiplier : 1);
|
|
56
66
|
const rate =
|
|
57
67
|
Math.abs(target) > Math.abs(this.#speed) ? RACING_FEEL.acceleration : RACING_FEEL.drag;
|
|
58
68
|
this.#speed = approach(this.#speed, target, rate * dt);
|
|
59
|
-
if (ctx.input.pressed("brake")
|
|
69
|
+
if (ctx.input.pressed("brake") || touch?.brakePressed === true)
|
|
70
|
+
this.#speed = approach(this.#speed, 0, RACING_FEEL.brake * dt);
|
|
60
71
|
const steering =
|
|
61
72
|
move.x * (Math.min(1, Math.abs(this.#speed) / RACING_FEEL.maxSpeed) * 0.65 + 0.35);
|
|
62
73
|
this.#heading += steering * RACING_FEEL.turnRate * dt * (this.#speed < 0 ? -1 : 1);
|
|
@@ -95,6 +106,7 @@ export class RacingCar {
|
|
|
95
106
|
return {
|
|
96
107
|
boostActive: this.boost.active,
|
|
97
108
|
heading: this.#heading,
|
|
109
|
+
normaliseFactor: this.#normaliseFactor,
|
|
98
110
|
position: this.mesh.position.toArray(),
|
|
99
111
|
speed: this.speed,
|
|
100
112
|
topSpeed: this.#topSpeed,
|
|
@@ -14,8 +14,11 @@ export class Rival {
|
|
|
14
14
|
startDistance: number,
|
|
15
15
|
) {
|
|
16
16
|
this.#distance = startDistance;
|
|
17
|
-
|
|
18
|
-
|
|
17
|
+
// Same sculpt, different livery. The rival was indistinguishable from the player in the first
|
|
18
|
+
// frame because both cars asked for the same material set.
|
|
19
|
+
const materials = createMaterials();
|
|
20
|
+
const visual = vehicle({ ...materials, body: materials.rivalBody });
|
|
21
|
+
visual.scale.setScalar(0.96);
|
|
19
22
|
this.mesh.add(visual);
|
|
20
23
|
}
|
|
21
24
|
|
|
@@ -7,7 +7,7 @@ import { Boot } from "./scenes/Boot.js";
|
|
|
7
7
|
import { Race } from "./scenes/Race.js";
|
|
8
8
|
import type { GameState } from "./state.js";
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
const game = defineGame<GameState, IPhysicsContext>({
|
|
11
11
|
input: {
|
|
12
12
|
// The four directions of `input.vector("move")`. Declared rather than inherited from the
|
|
13
13
|
// default binding, so the axis every scene reads is visible where the game is defined.
|
|
@@ -22,8 +22,31 @@ export default defineGame<GameState, IPhysicsContext>({
|
|
|
22
22
|
restart: { keys: ["KeyR"] },
|
|
23
23
|
},
|
|
24
24
|
plugins: [rapier({ gravity: { x: 0, y: -24, z: 0 } }), playtest({ events })],
|
|
25
|
+
display: config.display,
|
|
25
26
|
render: config.renderer,
|
|
26
27
|
scenes: { boot: Boot, race: Race },
|
|
27
28
|
seed: 90210,
|
|
28
29
|
start: "boot",
|
|
29
30
|
});
|
|
31
|
+
|
|
32
|
+
export default game;
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* What the UI can ask the game to do.
|
|
36
|
+
*
|
|
37
|
+
* Intents are one-way and named by the game: the UI sends `restart`, `pause` or `resume` and the
|
|
38
|
+
* game decides what each means. Nothing comes back this way — the UI reads the game's published
|
|
39
|
+
* state instead, which keeps one source of truth on the side that owns the simulation.
|
|
40
|
+
*/
|
|
41
|
+
game.ui.onIntent((intent) => {
|
|
42
|
+
if (intent === "restart") void game.goto("race");
|
|
43
|
+
if (intent === "pause") game.pause();
|
|
44
|
+
if (intent === "resume") game.resume();
|
|
45
|
+
game.state.set({
|
|
46
|
+
// `game.ui.connected` is true only once the UI announced itself, which is what tells an
|
|
47
|
+
// overlay that never came up apart from a game whose HUD is simply empty.
|
|
48
|
+
uiReady: game.ui.connected,
|
|
49
|
+
...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
|
|
50
|
+
});
|
|
51
|
+
game.state.flush();
|
|
52
|
+
});
|
|
@@ -1,28 +1,35 @@
|
|
|
1
1
|
import { MathUtils, type PerspectiveCamera, Vector3 } from "three";
|
|
2
2
|
|
|
3
|
+
// Chase height and distance. At 5.8 up and 8.5 back the camera looked down on the roof, which is
|
|
4
|
+
// the one angle from which every car in the world reads as a rectangle; 3.3 and 7.4 put the eye
|
|
5
|
+
// near the rear wing where the wedge, the arches and the flank are all in view.
|
|
6
|
+
const SCRATCH_UP = new Vector3(0, 3.0, 0);
|
|
7
|
+
|
|
3
8
|
export function setupCamera(camera: PerspectiveCamera): void {
|
|
4
9
|
camera.fov = 56;
|
|
5
10
|
camera.near = 0.1;
|
|
6
|
-
camera.far =
|
|
11
|
+
camera.far = 340;
|
|
7
12
|
camera.updateProjectionMatrix();
|
|
8
13
|
}
|
|
9
14
|
|
|
15
|
+
// Reused across frames — the starter camera shows the same pattern. This runs per frame for
|
|
16
|
+
// every racing game built from this template; three Vector clones a frame was pure garbage.
|
|
17
|
+
const behind = new Vector3();
|
|
18
|
+
const desired = new Vector3();
|
|
19
|
+
|
|
10
20
|
export function chaseCamera(
|
|
11
21
|
camera: PerspectiveCamera,
|
|
12
22
|
target: Vector3,
|
|
13
23
|
heading: Vector3,
|
|
14
24
|
dt: number,
|
|
15
25
|
): void {
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
.clone()
|
|
19
|
-
.add(behind)
|
|
20
|
-
.add(new Vector3(0, 5.8, 0));
|
|
26
|
+
behind.copy(heading).setY(0).normalize().multiplyScalar(-6.6);
|
|
27
|
+
desired.copy(target).add(behind).add(SCRATCH_UP);
|
|
21
28
|
if (dt >= 1) camera.position.copy(desired);
|
|
22
29
|
else camera.position.lerp(desired, 1 - Math.exp(-dt / 0.2));
|
|
23
|
-
camera.lookAt(target.x, target.y +
|
|
30
|
+
camera.lookAt(target.x, target.y + 1.15, target.z);
|
|
24
31
|
}
|
|
25
32
|
|
|
26
33
|
export function cameraRoll(camera: PerspectiveCamera, heading: Vector3): void {
|
|
27
|
-
camera.
|
|
34
|
+
camera.rotateZ(MathUtils.clamp(-heading.x * 0.018, -0.035, 0.035));
|
|
28
35
|
}
|
|
@@ -9,24 +9,38 @@ import { palette } from "./palette.js";
|
|
|
9
9
|
|
|
10
10
|
type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
// Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow map, so
|
|
13
|
+
// the scene hands the sun to `setupPost` and a shadowless light is refused by name instead of
|
|
14
|
+
// rendering a black pass.
|
|
15
|
+
//
|
|
16
|
+
// The sun is **near-white**, not the accent colour. Tinting the key light yellow was how the first
|
|
17
|
+
// version of this file made a green infield go olive and a grey road go brown: a strongly coloured
|
|
18
|
+
// key contaminates every surface at once, and no per-material tweak can undo it. Colour belongs in
|
|
19
|
+
// the materials; the sun's job is direction and contrast.
|
|
20
|
+
export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
|
|
13
21
|
renderer.shadowMap.enabled = true;
|
|
14
22
|
renderer.shadowMap.type = PCFSoftShadowMap;
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
key
|
|
23
|
+
// Sky above, grass bounce below. The ground term is what stops undersides going to slate.
|
|
24
|
+
scene.add(new HemisphereLight(palette.skyLow, palette.field, 1.1));
|
|
25
|
+
const key = new DirectionalLight(0xfff4e2, 2.9);
|
|
26
|
+
key.position.set(-16, 26, -12);
|
|
18
27
|
key.castShadow = true;
|
|
19
|
-
key.shadow.mapSize.set(
|
|
28
|
+
key.shadow.mapSize.set(2048, 2048);
|
|
20
29
|
key.shadow.camera.near = 0.5;
|
|
21
|
-
key.shadow.camera.far =
|
|
22
|
-
key.shadow.camera.left = -
|
|
23
|
-
key.shadow.camera.right =
|
|
24
|
-
key.shadow.camera.top =
|
|
25
|
-
key.shadow.camera.bottom = -
|
|
26
|
-
key.shadow.
|
|
30
|
+
key.shadow.camera.far = 120;
|
|
31
|
+
key.shadow.camera.left = -55;
|
|
32
|
+
key.shadow.camera.right = 55;
|
|
33
|
+
key.shadow.camera.top = 55;
|
|
34
|
+
key.shadow.camera.bottom = -55;
|
|
35
|
+
key.shadow.bias = -0.0004;
|
|
36
|
+
key.shadow.normalBias = 0.03;
|
|
27
37
|
scene.add(key);
|
|
28
|
-
|
|
29
|
-
|
|
38
|
+
// A cool fill from the opposite side, so shadow faces separate from each other rather than all
|
|
39
|
+
// collapsing to one flat tone.
|
|
40
|
+
const rim = new DirectionalLight(palette.skyLow, 0.85);
|
|
41
|
+
rim.position.set(18, 9, 22);
|
|
30
42
|
scene.add(rim);
|
|
31
|
-
scene.add(new AmbientLight(palette.shadow, 0.
|
|
43
|
+
scene.add(new AmbientLight(palette.shadow, 0.55));
|
|
44
|
+
|
|
45
|
+
return key;
|
|
32
46
|
}
|