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,135 @@
|
|
|
1
|
+
import type { ICtx } from "@threenative/core";
|
|
2
|
+
import { Area3D, CollisionShape3D } from "@threenative/physics";
|
|
3
|
+
import { type Group, MathUtils } from "three";
|
|
4
|
+
import { type IRunnerConventions, prepareRunnerConventions } from "../conventions.js";
|
|
5
|
+
import { OBSTACLE_LAYER, type RunnerPhysics } from "../physics.js";
|
|
6
|
+
import { runner as runnerMesh } from "../render/shapes.js";
|
|
7
|
+
import type { ITouchInput } from "../render/touch-controls.js";
|
|
8
|
+
import type { GameState } from "../state.js";
|
|
9
|
+
import { LANE_X } from "../track.js";
|
|
10
|
+
|
|
11
|
+
type GameCtx = ICtx<GameState, RunnerPhysics>;
|
|
12
|
+
|
|
13
|
+
const LANE_BLEND = 12;
|
|
14
|
+
const JUMP_SPEED = 7.2;
|
|
15
|
+
const GRAVITY = -19;
|
|
16
|
+
/** Within this many metres of an obstacle's centre and still alive: a near miss. */
|
|
17
|
+
const NEAR_MISS = 1.5;
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* The player.
|
|
21
|
+
*
|
|
22
|
+
* Not a rigid body: a runner's feel is a lane snap and a fixed jump arc, and handing either to a
|
|
23
|
+
* solver makes both worse. What *is* physics is the collision — the runner carries an `Area3D`
|
|
24
|
+
* that scans the obstacle layer, so a hit is an overlap the engine reports rather than a distance
|
|
25
|
+
* check this file would have to keep in sync with the obstacle geometry.
|
|
26
|
+
*/
|
|
27
|
+
export class Runner {
|
|
28
|
+
readonly mesh: Group;
|
|
29
|
+
readonly tags = ["player", "runner"];
|
|
30
|
+
readonly hitbox: Area3D;
|
|
31
|
+
#conventions: IRunnerConventions;
|
|
32
|
+
#lane = 1;
|
|
33
|
+
#height = 0;
|
|
34
|
+
#vertical = 0;
|
|
35
|
+
#crashed = false;
|
|
36
|
+
#nearMisses = 0;
|
|
37
|
+
|
|
38
|
+
constructor(ctx: GameCtx) {
|
|
39
|
+
this.mesh = runnerMesh();
|
|
40
|
+
this.mesh.name = "player";
|
|
41
|
+
this.#conventions = prepareRunnerConventions(this.mesh);
|
|
42
|
+
ctx.add(this.mesh);
|
|
43
|
+
this.hitbox = new Area3D({
|
|
44
|
+
collisionLayer: 0,
|
|
45
|
+
collisionMask: OBSTACLE_LAYER,
|
|
46
|
+
entity: "runner-hitbox",
|
|
47
|
+
physics: ctx.physics,
|
|
48
|
+
position: { x: 0, y: 0.7, z: 0 },
|
|
49
|
+
shape: CollisionShape3D.box(0.7, 1.3, 0.7),
|
|
50
|
+
});
|
|
51
|
+
this.hitbox.on("bodyEntered", () => {
|
|
52
|
+
this.#crashed = true;
|
|
53
|
+
});
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
get lane(): number {
|
|
57
|
+
return this.#lane;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
get crashed(): boolean {
|
|
61
|
+
return this.#crashed;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
get airborne(): boolean {
|
|
65
|
+
return this.#height > 0.01;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
get nearMisses(): number {
|
|
69
|
+
return this.#nearMisses;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** Counts one near miss. The scene owns *what* counts as near; this owns the tally. */
|
|
73
|
+
recordNearMiss(): void {
|
|
74
|
+
this.#nearMisses += 1;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
update(ctx: GameCtx, dt: number, distance: number, touch?: ITouchInput): void {
|
|
78
|
+
if (this.#crashed) return;
|
|
79
|
+
const move = ctx.input.vector("move");
|
|
80
|
+
// The stick is a lane *change*, not an axis: holding right must move one lane, not slide
|
|
81
|
+
// continuously across three. `#steering` is that edge, and it is why a held thumb behaves
|
|
82
|
+
// like a tapped key.
|
|
83
|
+
const steer = move.x + (touch?.move.x ?? 0);
|
|
84
|
+
if (touch?.leftPressed === true) this.#lane -= 1;
|
|
85
|
+
if (touch?.rightPressed === true) this.#lane += 1;
|
|
86
|
+
if (Math.abs(steer) > 0.6 && !this.#steering) {
|
|
87
|
+
this.#lane += steer > 0 ? 1 : -1;
|
|
88
|
+
this.#steering = true;
|
|
89
|
+
}
|
|
90
|
+
if (Math.abs(steer) <= 0.4) this.#steering = false;
|
|
91
|
+
this.#lane = MathUtils.clamp(this.#lane, 0, LANE_X.length - 1);
|
|
92
|
+
|
|
93
|
+
const stickJump = (touch?.move.y ?? 0) > 0.65;
|
|
94
|
+
if ((ctx.input.justPressed("jump") || stickJump) && !this.airborne) this.#vertical = JUMP_SPEED;
|
|
95
|
+
this.#height = Math.max(0, this.#height + this.#vertical * dt);
|
|
96
|
+
this.#vertical = this.#height > 0 ? this.#vertical + GRAVITY * dt : 0;
|
|
97
|
+
|
|
98
|
+
const targetX = LANE_X[this.#lane] ?? 0;
|
|
99
|
+
const blend = Math.min(1, Math.max(0, dt) * LANE_BLEND);
|
|
100
|
+
this.mesh.position.x += (targetX - this.mesh.position.x) * blend;
|
|
101
|
+
this.mesh.position.z = -distance;
|
|
102
|
+
this.mesh.rotation.z = (targetX - this.mesh.position.x) * 0.35;
|
|
103
|
+
this.#conventions.applyGrounding(this.#height, dt);
|
|
104
|
+
this.hitbox.setPosition({
|
|
105
|
+
x: this.mesh.position.x,
|
|
106
|
+
y: this.#height + 0.7,
|
|
107
|
+
z: this.mesh.position.z,
|
|
108
|
+
});
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/** True when the runner is beside, rather than on top of, an obstacle at `x` on this stretch. */
|
|
112
|
+
isNearMiss(obstacleX: number): boolean {
|
|
113
|
+
const gap = Math.abs(obstacleX - this.mesh.position.x);
|
|
114
|
+
return gap > 0.85 && gap < NEAR_MISS;
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
debug(): Record<string, unknown> {
|
|
118
|
+
return {
|
|
119
|
+
airborne: this.airborne,
|
|
120
|
+
crashed: this.#crashed,
|
|
121
|
+
groundClearance: this.#conventions.groundSnap.clearance,
|
|
122
|
+
lane: this.#lane,
|
|
123
|
+
nearMisses: this.#nearMisses,
|
|
124
|
+
normaliseFactor: this.#conventions.normaliseFactor,
|
|
125
|
+
position: this.mesh.position.toArray(),
|
|
126
|
+
};
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
dispose(): void {
|
|
130
|
+
this.hitbox.dispose();
|
|
131
|
+
this.mesh.removeFromParent();
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
#steering = false;
|
|
135
|
+
}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import { defineGame } from "@threenative/core";
|
|
2
|
+
import { playtest } from "@threenative/core/playtest";
|
|
3
|
+
import { rapier } from "@threenative/physics";
|
|
4
|
+
import config from "../threenative.config.js";
|
|
5
|
+
import type { RunnerPhysics } from "./physics.js";
|
|
6
|
+
import { Boot } from "./scenes/Boot.js";
|
|
7
|
+
import { Run } from "./scenes/Run.js";
|
|
8
|
+
import type { GameState } from "./state.js";
|
|
9
|
+
|
|
10
|
+
const game = defineGame<GameState, RunnerPhysics>({
|
|
11
|
+
input: {
|
|
12
|
+
move: {
|
|
13
|
+
down: ["ArrowDown", "KeyS"],
|
|
14
|
+
left: ["ArrowLeft", "KeyA"],
|
|
15
|
+
right: ["ArrowRight", "KeyD"],
|
|
16
|
+
up: ["ArrowUp", "KeyW"],
|
|
17
|
+
},
|
|
18
|
+
jump: { keys: ["Space"] },
|
|
19
|
+
restart: { keys: ["KeyR"] },
|
|
20
|
+
},
|
|
21
|
+
// Gravity is zero on purpose: nothing in this game falls. The jump is an authored arc in
|
|
22
|
+
// `Runner`, and the only physics the runner needs is the overlap query its `Area3D` performs.
|
|
23
|
+
plugins: [rapier({ gravity: { x: 0, y: 0, z: 0 } }), playtest()],
|
|
24
|
+
display: config.display,
|
|
25
|
+
render: config.renderer,
|
|
26
|
+
scenes: { boot: Boot, run: Run },
|
|
27
|
+
// The track is built from `ctx.random`, so this seed is the level. Change it for a new one.
|
|
28
|
+
seed: 77_412,
|
|
29
|
+
start: "boot",
|
|
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("run");
|
|
43
|
+
if (intent === "pause") game.pause();
|
|
44
|
+
if (intent === "resume") game.resume();
|
|
45
|
+
game.state.set({
|
|
46
|
+
uiReady: game.ui.connected,
|
|
47
|
+
...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
|
|
48
|
+
});
|
|
49
|
+
game.state.flush();
|
|
50
|
+
});
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
import { acceptHotUpdate } from "@threenative/core/hot";
|
|
2
|
+
import { createElement } from "react";
|
|
3
|
+
import { createRoot } from "react-dom/client";
|
|
4
|
+
import game from "./game.js";
|
|
5
|
+
import { App } from "./ui/App.js";
|
|
6
|
+
import "./style.css";
|
|
7
|
+
|
|
8
|
+
import.meta.hot?.accept();
|
|
9
|
+
acceptHotUpdate(game, import.meta.hot);
|
|
10
|
+
const root = document.getElementById("root");
|
|
11
|
+
if (root === null) throw new Error("Missing #root element.");
|
|
12
|
+
const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
|
|
13
|
+
const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
|
|
14
|
+
appRoot.__threenativeRoot = reactRoot;
|
|
15
|
+
reactRoot.render(createElement(App, { game }));
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import type { IPhysicsContext } from "@threenative/physics";
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* One bit per thing that can touch another thing.
|
|
5
|
+
*
|
|
6
|
+
* The runner itself is not a body — it is a transform the game moves, carrying an `Area3D` that
|
|
7
|
+
* scans for obstacles. Obstacles are fixed bodies that collide with nothing and are only ever
|
|
8
|
+
* *detected*, which is why they cost a layer and no solver work.
|
|
9
|
+
*/
|
|
10
|
+
export const TRACK_LAYER = 1;
|
|
11
|
+
export const OBSTACLE_LAYER = 2;
|
|
12
|
+
|
|
13
|
+
export type RunnerPhysics = IPhysicsContext;
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import type { PerspectiveCamera, Vector3 } from "three";
|
|
2
|
+
|
|
3
|
+
const HEIGHT = 3;
|
|
4
|
+
const BACK = 6.4;
|
|
5
|
+
const LOOK_AHEAD = 22;
|
|
6
|
+
/** How high up the track the rig aims. Lower means more road and less sky in the frame. */
|
|
7
|
+
const LOOK_HEIGHT = -0.2;
|
|
8
|
+
|
|
9
|
+
export function setupCamera(camera: PerspectiveCamera): void {
|
|
10
|
+
camera.fov = 62;
|
|
11
|
+
camera.near = 0.1;
|
|
12
|
+
camera.far = 220;
|
|
13
|
+
camera.position.set(0, HEIGHT, BACK);
|
|
14
|
+
camera.lookAt(0, LOOK_HEIGHT, -LOOK_AHEAD);
|
|
15
|
+
camera.updateProjectionMatrix();
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* A chase rig that leads the runner rather than tracking it exactly.
|
|
20
|
+
*
|
|
21
|
+
* The lateral lag is deliberate: a camera locked to the lane makes a lane change invisible,
|
|
22
|
+
* because the runner never moves on screen. Lagging it is what turns the change into motion.
|
|
23
|
+
*
|
|
24
|
+
* `offset` is the shake, supplied by the scene from `CameraShake.update`. It is added here and
|
|
25
|
+
* nowhere else, so the rig has one place that decides where the camera is.
|
|
26
|
+
*/
|
|
27
|
+
export function chaseRunner(
|
|
28
|
+
camera: PerspectiveCamera,
|
|
29
|
+
target: Vector3,
|
|
30
|
+
dt: number,
|
|
31
|
+
offset: { readonly x: number; readonly y: number; readonly z: number },
|
|
32
|
+
): void {
|
|
33
|
+
const blend = Math.min(1, Math.max(0, dt) * 6);
|
|
34
|
+
camera.position.x += (target.x * 0.55 - camera.position.x) * blend;
|
|
35
|
+
camera.position.y = HEIGHT + offset.y;
|
|
36
|
+
camera.position.z = target.z + BACK;
|
|
37
|
+
camera.position.x += offset.x;
|
|
38
|
+
camera.lookAt(target.x * 0.35, LOOK_HEIGHT, target.z - LOOK_AHEAD);
|
|
39
|
+
}
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
// Generated for you: ordinary Three.js TSL. `GPUParticles3D` owns the pooling, the dispatch and
|
|
2
|
+
// the lifetime; every appearance choice below — the count, the spawn shape, the launch, the
|
|
3
|
+
// colour ramp, the sprite mask — is this file's, and this file is yours.
|
|
4
|
+
import {
|
|
5
|
+
Fn,
|
|
6
|
+
float,
|
|
7
|
+
fract,
|
|
8
|
+
hash,
|
|
9
|
+
instanceIndex,
|
|
10
|
+
mix,
|
|
11
|
+
smoothstep,
|
|
12
|
+
time,
|
|
13
|
+
uv,
|
|
14
|
+
varying,
|
|
15
|
+
vec2,
|
|
16
|
+
vec3,
|
|
17
|
+
vec4,
|
|
18
|
+
} from "three/tsl";
|
|
19
|
+
import {
|
|
20
|
+
AdditiveBlending,
|
|
21
|
+
type ComputeNode,
|
|
22
|
+
SpriteNodeMaterial,
|
|
23
|
+
type StorageBufferNode,
|
|
24
|
+
} from "three/webgpu";
|
|
25
|
+
import { palette } from "./palette.js";
|
|
26
|
+
|
|
27
|
+
export interface IDustBuffers {
|
|
28
|
+
readonly positions: StorageBufferNode<"vec3">;
|
|
29
|
+
readonly velocities: StorageBufferNode<"vec3">;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
export interface IDustOptions {
|
|
33
|
+
readonly amount: number;
|
|
34
|
+
readonly material: SpriteNodeMaterial;
|
|
35
|
+
readonly start: (buffers: IDustBuffers) => ComputeNode;
|
|
36
|
+
readonly process: (buffers: IDustBuffers) => ComputeNode;
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
const AMOUNT = 220;
|
|
40
|
+
const LIFETIME = 0.9;
|
|
41
|
+
/** Metres per second the trail drifts backwards. It is the track that moves, so this is small. */
|
|
42
|
+
const DRIFT = 2.6;
|
|
43
|
+
const SPREAD = 0.55;
|
|
44
|
+
|
|
45
|
+
function noise(salt: number) {
|
|
46
|
+
return hash(instanceIndex.add(salt));
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** Each particle owns a phase offset, so the emitter is continuous rather than a pulsing burst. */
|
|
50
|
+
function phase() {
|
|
51
|
+
return fract(time.div(LIFETIME).add(noise(19)));
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
function spawn() {
|
|
55
|
+
return vec3(
|
|
56
|
+
noise(3).sub(0.5).mul(SPREAD),
|
|
57
|
+
noise(7).mul(0.14),
|
|
58
|
+
noise(11)
|
|
59
|
+
.sub(0.5)
|
|
60
|
+
.mul(SPREAD * 0.5),
|
|
61
|
+
);
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
function launch() {
|
|
65
|
+
return vec3(
|
|
66
|
+
noise(23).sub(0.5).mul(1.1),
|
|
67
|
+
noise(29).mul(1.4).add(0.2),
|
|
68
|
+
noise(31)
|
|
69
|
+
.mul(DRIFT)
|
|
70
|
+
.add(DRIFT * 0.4),
|
|
71
|
+
);
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/** A soft round puff: no texture, no download, and it fades at both ends of its life. */
|
|
75
|
+
function puff() {
|
|
76
|
+
return float(1).sub(smoothstep(0.06, 0.5, uv().sub(0.5).length()));
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* The dust the runner throws up.
|
|
81
|
+
*
|
|
82
|
+
* Two colours: the track's own grey at birth and the warm horizon at death, so the trail reads as
|
|
83
|
+
* lit by the same sky the track is. Change the numbers above and the whole feel changes; change
|
|
84
|
+
* `puff` and the grain does.
|
|
85
|
+
*/
|
|
86
|
+
export function createDustTrail(): IDustOptions {
|
|
87
|
+
const material = new SpriteNodeMaterial({
|
|
88
|
+
blending: AdditiveBlending,
|
|
89
|
+
depthWrite: false,
|
|
90
|
+
toneMapped: false,
|
|
91
|
+
transparent: true,
|
|
92
|
+
});
|
|
93
|
+
const life = varying(phase());
|
|
94
|
+
material.scaleNode = vec2(0.42).mul(mix(0.5, 1.5, life));
|
|
95
|
+
const birth = new Array(3)
|
|
96
|
+
.fill(0)
|
|
97
|
+
.map((_, index) => ((palette.rail >> (16 - index * 8)) & 255) / 255);
|
|
98
|
+
const death = new Array(3)
|
|
99
|
+
.fill(0)
|
|
100
|
+
.map((_, index) => ((palette.skyLow >> (16 - index * 8)) & 255) / 255);
|
|
101
|
+
material.colorNode = vec4(
|
|
102
|
+
mix(
|
|
103
|
+
vec3(birth[0] ?? 0, birth[1] ?? 0, birth[2] ?? 0),
|
|
104
|
+
vec3(death[0] ?? 0, death[1] ?? 0, death[2] ?? 0),
|
|
105
|
+
life,
|
|
106
|
+
),
|
|
107
|
+
puff()
|
|
108
|
+
.mul(float(1).sub(smoothstep(0.55, 1, life)))
|
|
109
|
+
.mul(0.55),
|
|
110
|
+
);
|
|
111
|
+
|
|
112
|
+
const start = ({ positions, velocities }: IDustBuffers): ComputeNode =>
|
|
113
|
+
Fn(() => {
|
|
114
|
+
positions.element(instanceIndex).assign(spawn());
|
|
115
|
+
velocities.element(instanceIndex).assign(launch());
|
|
116
|
+
})().compute(AMOUNT);
|
|
117
|
+
|
|
118
|
+
const process = ({ positions, velocities }: IDustBuffers): ComputeNode =>
|
|
119
|
+
Fn(() => {
|
|
120
|
+
const velocity = launch();
|
|
121
|
+
const elapsed = phase().mul(LIFETIME);
|
|
122
|
+
positions.element(instanceIndex).assign(
|
|
123
|
+
spawn()
|
|
124
|
+
.add(velocity.mul(elapsed))
|
|
125
|
+
.add(vec3(0, -1.6, 0).mul(elapsed.mul(elapsed))),
|
|
126
|
+
);
|
|
127
|
+
velocities.element(instanceIndex).assign(velocity);
|
|
128
|
+
})().compute(AMOUNT);
|
|
129
|
+
|
|
130
|
+
return { amount: AMOUNT, material, process, start };
|
|
131
|
+
}
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import {
|
|
2
|
+
AmbientLight,
|
|
3
|
+
DirectionalLight,
|
|
4
|
+
HemisphereLight,
|
|
5
|
+
PCFSoftShadowMap,
|
|
6
|
+
type Scene,
|
|
7
|
+
} from "three";
|
|
8
|
+
import { palette } from "./palette.js";
|
|
9
|
+
|
|
10
|
+
type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* Key, fill, rim, ambient — named, so each one can be changed on its own.
|
|
14
|
+
*
|
|
15
|
+
* A runner is lit from ahead. The key sits low and down-track so it rakes across the obstacles
|
|
16
|
+
* and gives each one a long shadow reaching back toward the player: at speed that shadow arrives
|
|
17
|
+
* before the block does, and it is the only warning the player gets in time to use.
|
|
18
|
+
*
|
|
19
|
+
* Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow map, so
|
|
20
|
+
* the scene hands the sun to `setupPost` and a shadowless light is refused by name instead of
|
|
21
|
+
* rendering a black pass.
|
|
22
|
+
*/
|
|
23
|
+
export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
|
|
24
|
+
renderer.shadowMap.enabled = true;
|
|
25
|
+
renderer.shadowMap.type = PCFSoftShadowMap;
|
|
26
|
+
// The sky half is the *rail* grey, not the horizon orange. Taking the horizon colour flooded
|
|
27
|
+
// the road with it and the track stopped being cool at all.
|
|
28
|
+
scene.add(new HemisphereLight(palette.rail, palette.track, 1.2));
|
|
29
|
+
|
|
30
|
+
const key = new DirectionalLight(0xffcf9e, 3.4);
|
|
31
|
+
key.position.set(3, 9, -22);
|
|
32
|
+
key.castShadow = true;
|
|
33
|
+
key.shadow.mapSize.set(1024, 1024);
|
|
34
|
+
key.shadow.camera.near = 0.5;
|
|
35
|
+
key.shadow.camera.far = 90;
|
|
36
|
+
key.shadow.camera.left = -14;
|
|
37
|
+
key.shadow.camera.right = 14;
|
|
38
|
+
key.shadow.camera.top = 14;
|
|
39
|
+
key.shadow.camera.bottom = -14;
|
|
40
|
+
key.shadow.normalBias = 0.03;
|
|
41
|
+
scene.add(key);
|
|
42
|
+
|
|
43
|
+
// A fill from behind the camera, and it is the light the first two captures were missing. With
|
|
44
|
+
// only a key from down-track, everything the player looks at is backlit: the runner came back a
|
|
45
|
+
// dark silhouette against the obstacle it was about to hit, which is the one comparison the
|
|
46
|
+
// game asks the player to make.
|
|
47
|
+
const fill = new DirectionalLight(0xbfd4ff, 1.5);
|
|
48
|
+
fill.position.set(-2, 7, 16);
|
|
49
|
+
scene.add(fill);
|
|
50
|
+
|
|
51
|
+
const rim = new DirectionalLight(palette.accent, 0.7);
|
|
52
|
+
rim.position.set(-8, 4, 6);
|
|
53
|
+
scene.add(rim);
|
|
54
|
+
scene.add(new AmbientLight(palette.skyHigh, 0.6));
|
|
55
|
+
|
|
56
|
+
return key;
|
|
57
|
+
}
|