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,12 @@
|
|
|
1
|
+
import { Scene } from "@threenative/core";
|
|
2
|
+
import type { RunnerPhysics } from "../physics.js";
|
|
3
|
+
import type { GameState } from "../state.js";
|
|
4
|
+
import { type GameCtx, Run } from "./Run.js";
|
|
5
|
+
|
|
6
|
+
export class Boot extends Scene<GameState, RunnerPhysics> {
|
|
7
|
+
static override readonly initialState = Run.initialState;
|
|
8
|
+
|
|
9
|
+
override enter(ctx: GameCtx): void {
|
|
10
|
+
void ctx.goto("run");
|
|
11
|
+
}
|
|
12
|
+
}
|
|
@@ -0,0 +1,142 @@
|
|
|
1
|
+
import {
|
|
2
|
+
CameraShake,
|
|
3
|
+
GPUParticles3D,
|
|
4
|
+
type ICtx,
|
|
5
|
+
Scene,
|
|
6
|
+
type SceneFrame,
|
|
7
|
+
afterPhysics,
|
|
8
|
+
isMobile,
|
|
9
|
+
isTouchscreenAvailable,
|
|
10
|
+
} from "@threenative/core";
|
|
11
|
+
import { type PerspectiveCamera, Vector3 } from "three";
|
|
12
|
+
import { Runner } from "../entities/Runner.js";
|
|
13
|
+
import type { RunnerPhysics } from "../physics.js";
|
|
14
|
+
import { chaseRunner, setupCamera } from "../render/camera.js";
|
|
15
|
+
import { createDustTrail } from "../render/dust.js";
|
|
16
|
+
import { setupLighting } from "../render/lighting.js";
|
|
17
|
+
import { createLoadingScreen } from "../render/loading.js";
|
|
18
|
+
import { setupPost } from "../render/postprocessing.js";
|
|
19
|
+
import { setupSky } from "../render/sky.js";
|
|
20
|
+
import { TouchControls } from "../render/touch-controls.js";
|
|
21
|
+
import { type GameState, INITIAL_STATE } from "../state.js";
|
|
22
|
+
import { CHUNK_LENGTH, LANE_X, Track } from "../track.js";
|
|
23
|
+
|
|
24
|
+
export type GameCtx = ICtx<GameState, RunnerPhysics>;
|
|
25
|
+
|
|
26
|
+
const START_SPEED = 11;
|
|
27
|
+
const TOP_SPEED = 26;
|
|
28
|
+
/** Metres per second gained per second run. Reach top speed at about a minute. */
|
|
29
|
+
const ACCELERATION = 0.25;
|
|
30
|
+
|
|
31
|
+
export class Run extends Scene<GameState, RunnerPhysics> {
|
|
32
|
+
static override readonly initialState = INITIAL_STATE;
|
|
33
|
+
|
|
34
|
+
override enter(ctx: GameCtx): SceneFrame<GameState, RunnerPhysics> {
|
|
35
|
+
setupSky(ctx.scene);
|
|
36
|
+
const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
|
|
37
|
+
// isMobile() arrives as an argument because src/render/ imports no framework package: the
|
|
38
|
+
// platform decision is made here, in portable game code.
|
|
39
|
+
setupPost(ctx.renderer, ctx.scene, ctx.camera, { godraysLight: sun, mobile: isMobile() });
|
|
40
|
+
const camera = ctx.camera as PerspectiveCamera;
|
|
41
|
+
setupCamera(camera);
|
|
42
|
+
ctx.add(camera);
|
|
43
|
+
const loading = createLoadingScreen(ctx);
|
|
44
|
+
|
|
45
|
+
const showTouchControls = isMobile() && isTouchscreenAvailable();
|
|
46
|
+
const touchControls = showTouchControls
|
|
47
|
+
? ctx.entities.add("touch-controls", new TouchControls(camera))
|
|
48
|
+
: undefined;
|
|
49
|
+
|
|
50
|
+
// `ctx.random` is the seeded source `defineGame({ seed })` installed, so the same seed builds
|
|
51
|
+
// the same track — which is what makes a runner's scenario reproducible at all.
|
|
52
|
+
const chunkContext = {
|
|
53
|
+
add: (object: Parameters<typeof ctx.add>[0]) => ctx.add(object),
|
|
54
|
+
physics: ctx.physics,
|
|
55
|
+
random: () => ctx.random(),
|
|
56
|
+
};
|
|
57
|
+
const track = new Track(chunkContext);
|
|
58
|
+
const runner = new Runner(ctx);
|
|
59
|
+
ctx.entities.add("player", runner);
|
|
60
|
+
|
|
61
|
+
const dust = ctx.add(new GPUParticles3D(createDustTrail()));
|
|
62
|
+
const shake = new CameraShake({
|
|
63
|
+
amplitude: new Vector3(0.16, 0.1, 0),
|
|
64
|
+
curve: (radians) => Math.sin(radians) * Math.sin(radians * 0.37),
|
|
65
|
+
decay: 6.5,
|
|
66
|
+
frequency: 17,
|
|
67
|
+
rotationAmplitude: new Vector3(0, 0, 0.02),
|
|
68
|
+
});
|
|
69
|
+
|
|
70
|
+
let distance = 0;
|
|
71
|
+
let speed = START_SPEED;
|
|
72
|
+
let status = INITIAL_STATE.status;
|
|
73
|
+
let nearMisses = 0;
|
|
74
|
+
const scored = new Set<string>();
|
|
75
|
+
|
|
76
|
+
// The camera reads the runner after the step, so a lane change and its shake land in the same
|
|
77
|
+
// frame. Reading it in the frame function is one step of lag at 26 m/s, which is 0.4 m.
|
|
78
|
+
afterPhysics(ctx, (dt) => {
|
|
79
|
+
const offset = shake.update(dt);
|
|
80
|
+
chaseRunner(camera, runner.mesh.position, dt, offset.position);
|
|
81
|
+
dust.position.set(runner.mesh.position.x, 0.15, runner.mesh.position.z + 0.6);
|
|
82
|
+
});
|
|
83
|
+
|
|
84
|
+
return (frameCtx, dt) => {
|
|
85
|
+
loading.update();
|
|
86
|
+
if (frameCtx.input.justPressed("restart")) {
|
|
87
|
+
frameCtx.state.set(INITIAL_STATE);
|
|
88
|
+
frameCtx.state.flush();
|
|
89
|
+
void frameCtx.goto("run");
|
|
90
|
+
return;
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
const touch = touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size);
|
|
94
|
+
if (status === "RUNNING") {
|
|
95
|
+
speed = Math.min(TOP_SPEED, speed + ACCELERATION * dt);
|
|
96
|
+
distance += speed * dt;
|
|
97
|
+
runner.update(frameCtx, dt, distance, touch);
|
|
98
|
+
track.advance(chunkContext, distance);
|
|
99
|
+
if (runner.crashed) {
|
|
100
|
+
status = "CRASHED";
|
|
101
|
+
shake.trigger();
|
|
102
|
+
} else {
|
|
103
|
+
// A near miss is an obstacle this chunk passed beside rather than through. Counting it
|
|
104
|
+
// once per obstacle is what stops a single block shaking the camera for a whole second.
|
|
105
|
+
for (const chunk of track.chunks) {
|
|
106
|
+
const passed = distance - chunk.start;
|
|
107
|
+
if (passed < 0 || passed > CHUNK_LENGTH) continue;
|
|
108
|
+
for (const lane of LANE_X) {
|
|
109
|
+
const key = `${chunk.start}:${lane}`;
|
|
110
|
+
if (scored.has(key) || !runner.isNearMiss(lane)) continue;
|
|
111
|
+
scored.add(key);
|
|
112
|
+
runner.recordNearMiss();
|
|
113
|
+
nearMisses = runner.nearMisses;
|
|
114
|
+
shake.trigger();
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
}
|
|
119
|
+
dust.visible = status === "RUNNING";
|
|
120
|
+
|
|
121
|
+
const previous = frameCtx.state.getState();
|
|
122
|
+
const next: GameState = {
|
|
123
|
+
chunks: track.built,
|
|
124
|
+
distance,
|
|
125
|
+
lane: runner.lane,
|
|
126
|
+
nearMisses,
|
|
127
|
+
paused: previous.paused,
|
|
128
|
+
speed,
|
|
129
|
+
status,
|
|
130
|
+
uiReady: previous.uiReady,
|
|
131
|
+
};
|
|
132
|
+
if (
|
|
133
|
+
next.chunks !== previous.chunks ||
|
|
134
|
+
next.lane !== previous.lane ||
|
|
135
|
+
next.nearMisses !== previous.nearMisses ||
|
|
136
|
+
next.status !== previous.status ||
|
|
137
|
+
Math.floor(next.distance) !== Math.floor(previous.distance)
|
|
138
|
+
)
|
|
139
|
+
frameCtx.state.set(next);
|
|
140
|
+
};
|
|
141
|
+
}
|
|
142
|
+
}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
export type RunStatus = "RUNNING" | "CRASHED";
|
|
2
|
+
|
|
3
|
+
export type GameState = {
|
|
4
|
+
/** Set from the UI's pause and resume intents, and read back by the menu. */
|
|
5
|
+
paused: boolean;
|
|
6
|
+
/** True once the UI layer has rendered and published its interactive rectangles. */
|
|
7
|
+
uiReady: boolean;
|
|
8
|
+
/** Metres travelled down the track. The score. */
|
|
9
|
+
distance: number;
|
|
10
|
+
/** Chunks built so far. Proof the track is streaming rather than one long mesh. */
|
|
11
|
+
chunks: number;
|
|
12
|
+
/** Obstacles cleared by less than a lane width. Each one shakes the camera. */
|
|
13
|
+
nearMisses: number;
|
|
14
|
+
/** Which of the three lanes the runner is in: 0, 1, 2. */
|
|
15
|
+
lane: number;
|
|
16
|
+
speed: number;
|
|
17
|
+
status: RunStatus;
|
|
18
|
+
};
|
|
19
|
+
|
|
20
|
+
export const INITIAL_STATE: GameState = {
|
|
21
|
+
paused: false,
|
|
22
|
+
uiReady: false,
|
|
23
|
+
distance: 0,
|
|
24
|
+
chunks: 0,
|
|
25
|
+
nearMisses: 0,
|
|
26
|
+
lane: 1,
|
|
27
|
+
speed: 0,
|
|
28
|
+
status: "RUNNING",
|
|
29
|
+
};
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
@import "tailwindcss";
|
|
2
|
+
|
|
3
|
+
@source "../index.html";
|
|
4
|
+
@source "./";
|
|
5
|
+
|
|
6
|
+
@theme {
|
|
7
|
+
--color-ink: #07131d;
|
|
8
|
+
--color-panel: #0d2430;
|
|
9
|
+
--color-line: #1d4a58;
|
|
10
|
+
--color-lume: #f5c451;
|
|
11
|
+
--color-win: #79e0b2;
|
|
12
|
+
--color-danger: #ff7182;
|
|
13
|
+
--color-text: #c1dce2;
|
|
14
|
+
--color-muted: #6c9aa5;
|
|
15
|
+
--font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
html,
|
|
19
|
+
body,
|
|
20
|
+
#root {
|
|
21
|
+
width: 100%;
|
|
22
|
+
height: 100%;
|
|
23
|
+
margin: 0;
|
|
24
|
+
overflow: hidden;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
body {
|
|
28
|
+
color: var(--color-text);
|
|
29
|
+
font-family: var(--font-mono);
|
|
30
|
+
-webkit-font-smoothing: antialiased;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/*
|
|
34
|
+
* The page's backdrop belongs to the web document's own mount point, never to `body`.
|
|
35
|
+
* `src/ui/main.tsx` imports this same stylesheet, and on native that file is what the platform's
|
|
36
|
+
* transparent web view loads over the game: a `body` background there paints an opaque sheet over
|
|
37
|
+
* the frame the game just rendered, and the HUD appears to float on nothing. `#root` exists only
|
|
38
|
+
* in the web page, so the backdrop stays where it belongs and the UI layer stays see-through.
|
|
39
|
+
*/
|
|
40
|
+
|
|
41
|
+
#root {
|
|
42
|
+
background: var(--color-ink);
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/* Boot failures are a page state, so the generated game owns their presentation. */
|
|
46
|
+
[data-threenative-canvas-error="true"] {
|
|
47
|
+
position: fixed;
|
|
48
|
+
inset: 0;
|
|
49
|
+
z-index: 1000;
|
|
50
|
+
display: grid;
|
|
51
|
+
place-items: center;
|
|
52
|
+
box-sizing: border-box;
|
|
53
|
+
padding: clamp(1.5rem, 8vw, 6rem);
|
|
54
|
+
overflow: auto;
|
|
55
|
+
background: #fff7ed;
|
|
56
|
+
color: var(--color-ink);
|
|
57
|
+
font-family: inherit;
|
|
58
|
+
font-size: clamp(1rem, 2vw, 1.5rem);
|
|
59
|
+
line-height: 1.5;
|
|
60
|
+
text-align: center;
|
|
61
|
+
white-space: pre-wrap;
|
|
62
|
+
overflow-wrap: anywhere;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/* The debug surface is framework plumbing; its default presentation is yours to change. */
|
|
66
|
+
[data-threenative-debug-overlay="true"] {
|
|
67
|
+
position: fixed;
|
|
68
|
+
top: 1rem;
|
|
69
|
+
right: 1rem;
|
|
70
|
+
z-index: 50;
|
|
71
|
+
max-width: 24rem;
|
|
72
|
+
padding: 0.75rem;
|
|
73
|
+
pointer-events: none;
|
|
74
|
+
background: rgb(2 6 23 / 90%);
|
|
75
|
+
box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
|
|
76
|
+
color: #cffafe;
|
|
77
|
+
font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
|
|
78
|
+
font-size: 12px;
|
|
79
|
+
line-height: 1.5;
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
[data-threenative-debug-overlay="true"] table {
|
|
83
|
+
width: 100%;
|
|
84
|
+
table-layout: fixed;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
[data-threenative-debug-overlay="true"] th,
|
|
88
|
+
[data-threenative-debug-overlay="true"] td {
|
|
89
|
+
padding-right: 1rem;
|
|
90
|
+
text-align: left;
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
[data-threenative-debug-overlay="true"] td:last-child {
|
|
94
|
+
overflow-wrap: anywhere;
|
|
95
|
+
word-break: break-all;
|
|
96
|
+
}
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
import { InstancedBatch } from "@threenative/core";
|
|
2
|
+
import { CollisionShape3D, RigidBody3D } from "@threenative/physics";
|
|
3
|
+
import {
|
|
4
|
+
type BufferGeometry,
|
|
5
|
+
Group,
|
|
6
|
+
Matrix4,
|
|
7
|
+
type MeshStandardMaterial,
|
|
8
|
+
type Object3D,
|
|
9
|
+
} from "three";
|
|
10
|
+
import { OBSTACLE_LAYER, type RunnerPhysics } from "./physics.js";
|
|
11
|
+
import {
|
|
12
|
+
LANE_WIDTH,
|
|
13
|
+
OBSTACLE_SIZE,
|
|
14
|
+
obstacleShape,
|
|
15
|
+
trackRails,
|
|
16
|
+
trackSlab,
|
|
17
|
+
} from "./render/shapes.js";
|
|
18
|
+
|
|
19
|
+
export const CHUNK_LENGTH = 24;
|
|
20
|
+
/** How many chunks exist at once. The track is infinite; this many meshes are not. */
|
|
21
|
+
export const RESIDENT_CHUNKS = 6;
|
|
22
|
+
/** Slots per chunk. Fixed, because an `InstancedMesh` cannot grow after it is built. */
|
|
23
|
+
export const MAX_OBSTACLES = 4;
|
|
24
|
+
export const LANE_X = [-LANE_WIDTH, 0, LANE_WIDTH] as const;
|
|
25
|
+
/** No obstacles this close to the start, so the first seconds teach the controls. */
|
|
26
|
+
const GRACE_METRES = 34;
|
|
27
|
+
/** Where an unused slot goes: far under the floor, scaled to nothing. */
|
|
28
|
+
const PARKED = new Matrix4().makeScale(0, 0, 0).setPosition(0, -1000, 0);
|
|
29
|
+
|
|
30
|
+
export interface IChunkContext {
|
|
31
|
+
readonly physics: RunnerPhysics;
|
|
32
|
+
add(object: Object3D): Object3D;
|
|
33
|
+
random(): number;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* One recycled slice of track.
|
|
38
|
+
*
|
|
39
|
+
* The road, the rails, the obstacle geometry and the obstacle material are built once and then
|
|
40
|
+
* moved. `InstancedBatch` places `MAX_OBSTACLES` slots at construction and `build()` hands back
|
|
41
|
+
* the `InstancedMesh`; a recycle rewrites that mesh's matrices and parks the slots it does not
|
|
42
|
+
* need. An earlier version built a fresh batch per recycle and only `remove()`d the old mesh,
|
|
43
|
+
* which in Three.js frees no GPU memory at all — every obstacle-bearing recycle leaked a
|
|
44
|
+
* geometry, a material and an instance buffer, forever, on exactly the ten-minute run the
|
|
45
|
+
* comment used to boast about.
|
|
46
|
+
*
|
|
47
|
+
* **The obstacle bodies are the exception, and are not recycled.** `RigidBody3D` has no
|
|
48
|
+
* reposition API for a fixed body, so each recycle disposes the chunk's bodies and creates new
|
|
49
|
+
* ones. They are disposed, so nothing leaks — but the claim is "the render side allocates
|
|
50
|
+
* nothing", not "nothing allocates".
|
|
51
|
+
*/
|
|
52
|
+
export class Chunk {
|
|
53
|
+
readonly group = new Group();
|
|
54
|
+
readonly #bodies: RigidBody3D[] = [];
|
|
55
|
+
readonly #obstacles: ReturnType<InstancedBatch["build"]>;
|
|
56
|
+
readonly #matrix = new Matrix4();
|
|
57
|
+
#start = 0;
|
|
58
|
+
|
|
59
|
+
constructor(
|
|
60
|
+
ctx: IChunkContext,
|
|
61
|
+
index: number,
|
|
62
|
+
geometry: BufferGeometry,
|
|
63
|
+
material: MeshStandardMaterial,
|
|
64
|
+
) {
|
|
65
|
+
this.group.name = `chunk-${index}`;
|
|
66
|
+
this.group.add(trackSlab(CHUNK_LENGTH), trackRails(CHUNK_LENGTH));
|
|
67
|
+
const batch = new InstancedBatch({ geometry, material });
|
|
68
|
+
for (let slot = 0; slot < MAX_OBSTACLES; slot += 1) batch.place({ position: [0, -1000, 0] });
|
|
69
|
+
this.#obstacles = batch.build({ castShadow: true, name: "obstacles", parent: this.group });
|
|
70
|
+
ctx.add(this.group);
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
get start(): number {
|
|
74
|
+
return this.#start;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/** Places the chunk at `start` metres and rewrites its obstacles for that stretch of track. */
|
|
78
|
+
build(ctx: IChunkContext, start: number): void {
|
|
79
|
+
this.#start = start;
|
|
80
|
+
this.group.position.z = -(start + CHUNK_LENGTH / 2);
|
|
81
|
+
for (const body of this.#bodies) body.dispose();
|
|
82
|
+
this.#bodies.length = 0;
|
|
83
|
+
|
|
84
|
+
let placed = 0;
|
|
85
|
+
if (start >= GRACE_METRES) {
|
|
86
|
+
for (let slot = 0; slot < MAX_OBSTACLES; slot += 1) {
|
|
87
|
+
// Never all three lanes: a run that cannot be survived is a bug, not a difficulty curve.
|
|
88
|
+
const blocked = Math.floor(ctx.random() * 3);
|
|
89
|
+
if (ctx.random() < 0.35) continue;
|
|
90
|
+
const laneX = LANE_X[blocked] ?? 0;
|
|
91
|
+
const localZ = (slot + 0.5) * (CHUNK_LENGTH / MAX_OBSTACLES) - CHUNK_LENGTH / 2;
|
|
92
|
+
this.#obstacles?.setMatrixAt(
|
|
93
|
+
placed,
|
|
94
|
+
this.#matrix.identity().setPosition(laneX, OBSTACLE_SIZE.height / 2, localZ),
|
|
95
|
+
);
|
|
96
|
+
placed += 1;
|
|
97
|
+
this.#bodies.push(
|
|
98
|
+
new RigidBody3D({
|
|
99
|
+
collisionLayer: OBSTACLE_LAYER,
|
|
100
|
+
collisionMask: 0,
|
|
101
|
+
entity: `obstacle.${this.group.name}.${slot}`,
|
|
102
|
+
physics: ctx.physics,
|
|
103
|
+
position: {
|
|
104
|
+
x: laneX,
|
|
105
|
+
y: OBSTACLE_SIZE.height / 2,
|
|
106
|
+
z: this.group.position.z + localZ,
|
|
107
|
+
},
|
|
108
|
+
shape: CollisionShape3D.box(
|
|
109
|
+
OBSTACLE_SIZE.width,
|
|
110
|
+
OBSTACLE_SIZE.height,
|
|
111
|
+
OBSTACLE_SIZE.depth,
|
|
112
|
+
),
|
|
113
|
+
type: "fixed",
|
|
114
|
+
}),
|
|
115
|
+
);
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
for (let slot = placed; slot < MAX_OBSTACLES; slot += 1) {
|
|
119
|
+
this.#obstacles?.setMatrixAt(slot, PARKED);
|
|
120
|
+
}
|
|
121
|
+
if (this.#obstacles !== undefined) this.#obstacles.instanceMatrix.needsUpdate = true;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
dispose(): void {
|
|
125
|
+
for (const body of this.#bodies) body.dispose();
|
|
126
|
+
this.#bodies.length = 0;
|
|
127
|
+
this.group.removeFromParent();
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/**
|
|
132
|
+
* The track, as a ring of chunks.
|
|
133
|
+
*
|
|
134
|
+
* `advance` moves the chunk that has fallen behind the runner to the front of the queue and
|
|
135
|
+
* rewrites it. The obstacle geometry and material are created here, once, and shared by every
|
|
136
|
+
* chunk: they are the same box and the same surface every time, and building them per chunk was
|
|
137
|
+
* both an allocation and — with no `dispose` — a leak.
|
|
138
|
+
*/
|
|
139
|
+
export class Track {
|
|
140
|
+
readonly chunks: Chunk[] = [];
|
|
141
|
+
readonly #geometry: BufferGeometry;
|
|
142
|
+
readonly #material: MeshStandardMaterial;
|
|
143
|
+
#built = 0;
|
|
144
|
+
|
|
145
|
+
constructor(ctx: IChunkContext) {
|
|
146
|
+
const shape = obstacleShape();
|
|
147
|
+
this.#geometry = shape.geometry;
|
|
148
|
+
this.#material = shape.material;
|
|
149
|
+
for (let index = 0; index < RESIDENT_CHUNKS; index += 1) {
|
|
150
|
+
const chunk = new Chunk(ctx, index, this.#geometry, this.#material);
|
|
151
|
+
chunk.build(ctx, index * CHUNK_LENGTH);
|
|
152
|
+
this.chunks.push(chunk);
|
|
153
|
+
this.#built += 1;
|
|
154
|
+
}
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
get built(): number {
|
|
158
|
+
return this.#built;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
advance(ctx: IChunkContext, distance: number): void {
|
|
162
|
+
for (const chunk of this.chunks) {
|
|
163
|
+
if (chunk.start + CHUNK_LENGTH > distance - CHUNK_LENGTH) continue;
|
|
164
|
+
const furthest = Math.max(...this.chunks.map((other) => other.start));
|
|
165
|
+
chunk.build(ctx, furthest + CHUNK_LENGTH);
|
|
166
|
+
this.#built += 1;
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
dispose(): void {
|
|
171
|
+
for (const chunk of this.chunks) chunk.dispose();
|
|
172
|
+
this.chunks.length = 0;
|
|
173
|
+
this.#geometry.dispose();
|
|
174
|
+
this.#material.dispose();
|
|
175
|
+
}
|
|
176
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import type { IGame } from "@threenative/core";
|
|
2
|
+
import { DebugOverlay, GameCanvas } from "@threenative/ui";
|
|
3
|
+
import type { RunnerPhysics } from "../physics.js";
|
|
4
|
+
import type { GameState } from "../state.js";
|
|
5
|
+
import { GameUi } from "./GameUi.js";
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* The web target's page: the canvas, then the same UI every other target renders.
|
|
9
|
+
*
|
|
10
|
+
* `GameCanvas` hosts the renderer and everything after it paints on top; keep the canvas first.
|
|
11
|
+
* The UI itself comes from `GameUi`, unchanged — this file exists only because the web build also
|
|
12
|
+
* has to put a canvas on the page.
|
|
13
|
+
*/
|
|
14
|
+
export function App({ game }: { game: IGame<GameState, RunnerPhysics> }) {
|
|
15
|
+
return (
|
|
16
|
+
<main className="relative h-screen w-screen overflow-hidden bg-ink">
|
|
17
|
+
<GameCanvas className="absolute inset-0" game={game} />
|
|
18
|
+
<GameUi />
|
|
19
|
+
<DebugOverlay />
|
|
20
|
+
</main>
|
|
21
|
+
);
|
|
22
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { UiLayer } from "@threenative/ui";
|
|
2
|
+
import { Hud } from "./Hud.js";
|
|
3
|
+
import { Menu } from "./Menu.js";
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Everything the player sees that is not the scene.
|
|
7
|
+
*
|
|
8
|
+
* One component, mounted twice by two entries that differ only in what else is on the page:
|
|
9
|
+
* `src/main.ts` puts it beside the canvas on the web target, and `src/ui/main.tsx` is the whole
|
|
10
|
+
* page the native web view loads. Keeping both entries pointed at this file is what makes "the
|
|
11
|
+
* same UI on every target" a fact rather than an intention.
|
|
12
|
+
*/
|
|
13
|
+
export function GameUi() {
|
|
14
|
+
return (
|
|
15
|
+
<UiLayer>
|
|
16
|
+
<Hud />
|
|
17
|
+
<Menu />
|
|
18
|
+
</UiLayer>
|
|
19
|
+
);
|
|
20
|
+
}
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
import { useUiState } from "@threenative/ui";
|
|
2
|
+
import type { GameState } from "../state.js";
|
|
3
|
+
|
|
4
|
+
export function Hud() {
|
|
5
|
+
const state = useUiState<GameState>();
|
|
6
|
+
// Nothing to draw until the game publishes its first snapshot, a few milliseconds in.
|
|
7
|
+
// Rendering zeroes instead would put wrong numbers on screen and then correct them.
|
|
8
|
+
if (state === undefined) return null;
|
|
9
|
+
const crashed = state.status === "CRASHED";
|
|
10
|
+
return (
|
|
11
|
+
<div className="pointer-events-none absolute inset-0 p-6 text-[11px] uppercase tracking-[0.16em] text-text">
|
|
12
|
+
<div className="flex items-start justify-between">
|
|
13
|
+
<div>
|
|
14
|
+
<div className="text-[10px] text-muted">distance</div>
|
|
15
|
+
<div className="mt-1 text-[34px] leading-none text-white" id="distance">
|
|
16
|
+
{Math.floor(state.distance)}
|
|
17
|
+
<span className="ml-1 text-[14px] text-muted">m</span>
|
|
18
|
+
</div>
|
|
19
|
+
</div>
|
|
20
|
+
<div className="text-right">
|
|
21
|
+
<div className="text-[10px] text-muted">near misses</div>
|
|
22
|
+
<div className="mt-1 text-[22px] text-white" id="near-misses">
|
|
23
|
+
{state.nearMisses}
|
|
24
|
+
</div>
|
|
25
|
+
</div>
|
|
26
|
+
</div>
|
|
27
|
+
<div className="absolute bottom-6 left-6 flex items-end gap-8">
|
|
28
|
+
<div>
|
|
29
|
+
<div className="text-[10px] text-muted">speed</div>
|
|
30
|
+
<div className="mt-1 text-[18px] leading-none text-white" id="speed">
|
|
31
|
+
{state.speed.toFixed(1)} m/s
|
|
32
|
+
</div>
|
|
33
|
+
</div>
|
|
34
|
+
<div>
|
|
35
|
+
<div className="text-[10px] text-muted">chunks built</div>
|
|
36
|
+
<div className="mt-1 text-[18px] leading-none text-white" id="chunks">
|
|
37
|
+
{state.chunks}
|
|
38
|
+
</div>
|
|
39
|
+
</div>
|
|
40
|
+
<div className="text-[10px] leading-relaxed text-muted">
|
|
41
|
+
<div>a / d change lane · space jump</div>
|
|
42
|
+
<div>the track never ends</div>
|
|
43
|
+
</div>
|
|
44
|
+
</div>
|
|
45
|
+
{crashed && (
|
|
46
|
+
<div className="absolute left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 border border-danger/70 bg-danger/10 px-8 py-5 text-center">
|
|
47
|
+
<div className="text-[28px] tracking-[0.28em] text-danger">CRASHED</div>
|
|
48
|
+
<div className="mt-2 text-[10px] text-muted">
|
|
49
|
+
{Math.floor(state.distance)} m · press R to run again
|
|
50
|
+
</div>
|
|
51
|
+
</div>
|
|
52
|
+
)}
|
|
53
|
+
</div>
|
|
54
|
+
);
|
|
55
|
+
}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export function Menu() {
|
|
2
|
+
return (
|
|
3
|
+
<div className="pointer-events-none absolute bottom-6 right-6 border border-line bg-panel/80 px-4 py-3 text-[10px] uppercase tracking-[0.12em] text-muted">
|
|
4
|
+
lane buttons or thumbstick · flick up to jump · R restart
|
|
5
|
+
</div>
|
|
6
|
+
);
|
|
7
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { createRoot } from "react-dom/client";
|
|
2
|
+
import { GameUi } from "./GameUi.js";
|
|
3
|
+
import "../style.css";
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* The UI entry the native web view loads.
|
|
7
|
+
*
|
|
8
|
+
* It mounts the UI and nothing else — no scene, no simulation, no renderer. The game runs beside
|
|
9
|
+
* it in the native runtime and reaches it only through published state and intents, which is why
|
|
10
|
+
* this file imports no game code at all.
|
|
11
|
+
*/
|
|
12
|
+
const root = document.getElementById("tn-ui");
|
|
13
|
+
if (root === null) throw new Error("Missing #tn-ui element.");
|
|
14
|
+
createRoot(root).render(<GameUi />);
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export default {};
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
import type { IThreeNativeConfig } from "@threenative/core";
|
|
2
|
+
|
|
3
|
+
const config: IThreeNativeConfig = {
|
|
4
|
+
app: {
|
|
5
|
+
id: "com.threenative.__PROJECT_ID__",
|
|
6
|
+
name: "__PROJECT_NAME__",
|
|
7
|
+
version: "1.0.0",
|
|
8
|
+
build: 1,
|
|
9
|
+
icon: "public/icon.png",
|
|
10
|
+
icons: { web: { favicon: "public/favicon.svg" } },
|
|
11
|
+
},
|
|
12
|
+
display: {
|
|
13
|
+
orientation: "landscape",
|
|
14
|
+
fullscreen: true,
|
|
15
|
+
keepScreenOn: true,
|
|
16
|
+
maxFps: 60,
|
|
17
|
+
},
|
|
18
|
+
window: {
|
|
19
|
+
title: "__PROJECT_NAME__",
|
|
20
|
+
width: 1280,
|
|
21
|
+
height: 720,
|
|
22
|
+
maximized: false,
|
|
23
|
+
resizable: true,
|
|
24
|
+
},
|
|
25
|
+
bootSplash: {
|
|
26
|
+
backgroundColor: "#07131d",
|
|
27
|
+
},
|
|
28
|
+
nativeEntry: "src/game.ts",
|
|
29
|
+
renderer: {
|
|
30
|
+
preferWebGPU: true, // Use WebGPU when the host exposes it.
|
|
31
|
+
// The engine holds the `display.maxFps` budget by scaling the 3D drawing buffer, and reports
|
|
32
|
+
// the scale it settled on in every `TN_FRAME_BUDGET` window. Replace with a number in (0, 1]
|
|
33
|
+
// to pin it — the loop stops and the reporting does not. CSS, UI and camera framing never move.
|
|
34
|
+
resolutionScale: "auto",
|
|
35
|
+
// Multisampling resolves triangle edges. A cutout silhouette — foliage, a fence, hair — is
|
|
36
|
+
// carved inside the triangle by an alpha test, so it resolves through the coverage mask or
|
|
37
|
+
// not at all, which is what this spends the samples above on. It costs no target and no
|
|
38
|
+
// extra pass; set it false for a deliberately hard-edged look. `TN_ALPHA_ANTIALIASING`
|
|
39
|
+
// reports what it did, and says so when a single-sampled surface leaves it nothing to do.
|
|
40
|
+
alphaAntialiasing: true,
|
|
41
|
+
},
|
|
42
|
+
// One UI on every target: src/ui/ renders through the platform's own browser-class renderer,
|
|
43
|
+
// so the same React, Tailwind, CSS and SVG run on web, desktop, Android and iOS alike.
|
|
44
|
+
// Switch to "native" for a UI drawn as part of the rendered frame, with no web view and no
|
|
45
|
+
// extra process — and own the appearance difference that comes with it.
|
|
46
|
+
ui: { renderer: "web" },
|
|
47
|
+
};
|
|
48
|
+
|
|
49
|
+
export default config;
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"compilerOptions": {
|
|
3
|
+
"target": "ES2022",
|
|
4
|
+
"lib": ["ES2022", "DOM", "DOM.Iterable"],
|
|
5
|
+
"module": "ESNext",
|
|
6
|
+
"moduleResolution": "bundler",
|
|
7
|
+
"jsx": "react-jsx",
|
|
8
|
+
"types": ["vite/client"],
|
|
9
|
+
"strict": true,
|
|
10
|
+
"noUncheckedIndexedAccess": true,
|
|
11
|
+
"noEmit": true,
|
|
12
|
+
"skipLibCheck": true,
|
|
13
|
+
"verbatimModuleSyntax": true,
|
|
14
|
+
"isolatedModules": true
|
|
15
|
+
},
|
|
16
|
+
"include": ["src/**/*.ts", "src/**/*.tsx", "*.ts"]
|
|
17
|
+
}
|