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
|
@@ -1,4 +1,10 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import {
|
|
2
|
+
type ICtx,
|
|
3
|
+
Scene,
|
|
4
|
+
type SceneFrame,
|
|
5
|
+
isMobile,
|
|
6
|
+
isTouchscreenAvailable,
|
|
7
|
+
} from "@threenative/core";
|
|
2
8
|
import type { IPhysicsContext } from "@threenative/physics";
|
|
3
9
|
import { type PerspectiveCamera, Vector3 } from "three";
|
|
4
10
|
import { RACING_FEEL, RacingCar } from "../entities/RacingCar.js";
|
|
@@ -11,9 +17,10 @@ import { createMaterials } from "../render/materials.js";
|
|
|
11
17
|
import { setupPost } from "../render/postprocessing.js";
|
|
12
18
|
import { flag } from "../render/shapes.js";
|
|
13
19
|
import { setupSky } from "../render/sky.js";
|
|
20
|
+
import { TouchControls } from "../render/touch-controls.js";
|
|
14
21
|
import { type GameState, type RaceStatus, resolveRaceStatus } from "../state.js";
|
|
15
22
|
import { Lap } from "../track/Lap.js";
|
|
16
|
-
import { rankRacers } from "../track/Ranking.js";
|
|
23
|
+
import { type IRankedRacer, type IRankedRacerScratch, rankRacers } from "../track/Ranking.js";
|
|
17
24
|
import { TOTAL_LAPS, buildTrack, intersectRay, roadRayProbe } from "../track/Track.js";
|
|
18
25
|
import { TrackSector } from "../track/TrackSector.js";
|
|
19
26
|
|
|
@@ -22,8 +29,22 @@ export type GameCtx = ICtx<GameState, IPhysicsContext>;
|
|
|
22
29
|
const SPAWN = new Vector3(2, 0.55, -18);
|
|
23
30
|
const TIME_LIMIT = 90;
|
|
24
31
|
|
|
32
|
+
function playerRanking(ranked: readonly IRankedRacer[]): IRankedRacer | undefined {
|
|
33
|
+
for (let index = 0; index < ranked.length; index += 1) {
|
|
34
|
+
const racer = ranked[index];
|
|
35
|
+
if (racer?.id === "player") return racer;
|
|
36
|
+
}
|
|
37
|
+
return undefined;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
function quantize(value: number, scale: number): number {
|
|
41
|
+
return Math.round(value * scale) / scale;
|
|
42
|
+
}
|
|
43
|
+
|
|
25
44
|
export class Race extends Scene<GameState, IPhysicsContext> {
|
|
26
45
|
static override readonly initialState: GameState = {
|
|
46
|
+
paused: false,
|
|
47
|
+
uiReady: false,
|
|
27
48
|
boostActive: false,
|
|
28
49
|
boostPeakSpeed: 0,
|
|
29
50
|
boostUses: 0,
|
|
@@ -49,12 +70,18 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
49
70
|
|
|
50
71
|
override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
|
|
51
72
|
setupSky(ctx.scene);
|
|
52
|
-
setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
|
|
53
|
-
|
|
73
|
+
const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
|
|
74
|
+
// isMobile() arrives as an argument because src/render/ imports no framework package: the
|
|
75
|
+
// platform decision is made here, in portable game code, exactly like createRandom.
|
|
76
|
+
setupPost(ctx.renderer, ctx.scene, ctx.camera, { godraysLight: sun, mobile: isMobile() });
|
|
54
77
|
const loading = createLoadingScreen(ctx);
|
|
55
78
|
const camera = ctx.camera as PerspectiveCamera;
|
|
56
79
|
setupCamera(camera);
|
|
57
80
|
ctx.add(camera);
|
|
81
|
+
const showTouchControls = isMobile() && isTouchscreenAvailable();
|
|
82
|
+
const touchControls = showTouchControls
|
|
83
|
+
? ctx.entities.add("touch-controls", new TouchControls(camera))
|
|
84
|
+
: undefined;
|
|
58
85
|
const track = buildTrack(ctx);
|
|
59
86
|
const car = new RacingCar(ctx, SPAWN);
|
|
60
87
|
const spawnDistance = track.route.project(SPAWN).distanceFromStart % track.route.totalLength;
|
|
@@ -77,13 +104,17 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
77
104
|
TOTAL_LAPS,
|
|
78
105
|
(completed) => emitPlaytestEvent({ entity: "player", lap: completed, name: "lap-completed" }),
|
|
79
106
|
);
|
|
80
|
-
const
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
107
|
+
const playerRankingInput = { id: "player", lap: lap.completed, position: car.mesh.position };
|
|
108
|
+
const rivalRankingInput = { id: "rival", lap: rival.lap, position: rival.mesh.position };
|
|
109
|
+
const rankingInputs = [playerRankingInput, rivalRankingInput];
|
|
110
|
+
const rankingBuffer: IRankedRacerScratch[] = [];
|
|
111
|
+
const rankRace = () => {
|
|
112
|
+
playerRankingInput.lap = lap.completed;
|
|
113
|
+
rivalRankingInput.lap = rival.lap;
|
|
114
|
+
return rankRacers(track.route, rankingInputs, undefined, rankingBuffer);
|
|
115
|
+
};
|
|
85
116
|
const initialRanked = rankRace();
|
|
86
|
-
const initialPlayer = initialRanked
|
|
117
|
+
const initialPlayer = playerRanking(initialRanked);
|
|
87
118
|
if (initialPlayer === undefined) throw new Error("Race ranking lost the player at spawn.");
|
|
88
119
|
const fallbackProbe = roadRayProbe(track.roadMeshes);
|
|
89
120
|
const sector = new TrackSector({
|
|
@@ -105,6 +136,9 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
105
136
|
let speedAfterBoost = 0;
|
|
106
137
|
let boostSettled = false;
|
|
107
138
|
let sameDistanceRanking = initialRanked[0]?.id === "rival" ? "lap-ahead" : "lap-behind";
|
|
139
|
+
let place = initialPlayer.place;
|
|
140
|
+
let positionLabel = `P${place}`;
|
|
141
|
+
const lastOnRoad: [number, number, number] = [SPAWN.x, SPAWN.y, SPAWN.z];
|
|
108
142
|
const observedPosition = SPAWN.clone();
|
|
109
143
|
sector.update(SPAWN, car.forward, 0);
|
|
110
144
|
chaseCamera(camera, car.mesh.position, car.forward, 1);
|
|
@@ -113,20 +147,27 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
113
147
|
if (status !== "RACING") return;
|
|
114
148
|
lap.observe(observedPosition, car.mesh.position);
|
|
115
149
|
observedPosition.copy(car.mesh.position);
|
|
116
|
-
car.update(
|
|
150
|
+
car.update(
|
|
151
|
+
frameCtx,
|
|
152
|
+
dt,
|
|
153
|
+
touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size),
|
|
154
|
+
);
|
|
117
155
|
rival.update(dt);
|
|
118
156
|
sector.update(car.mesh.position, car.forward, dt);
|
|
119
157
|
if (sector.rescue(car)) {
|
|
120
158
|
rescues += 1;
|
|
121
|
-
rescuePositionError =
|
|
122
|
-
car.mesh.position.distanceTo(sector.lastOnRoadPosition)
|
|
159
|
+
rescuePositionError = quantize(
|
|
160
|
+
car.mesh.position.distanceTo(sector.lastOnRoadPosition),
|
|
161
|
+
10_000,
|
|
123
162
|
);
|
|
124
|
-
rescueHeadingError =
|
|
163
|
+
rescueHeadingError = quantize(car.forward.angleTo(sector.lastOnRoadHeading), 10_000);
|
|
125
164
|
emitPlaytestEvent({ entity: "player", name: "rescued" });
|
|
126
165
|
}
|
|
127
166
|
if (elapsed >= TIME_LIMIT || rescues >= 4) status = "DNF";
|
|
128
167
|
};
|
|
129
168
|
|
|
169
|
+
const statePatch: Partial<GameState> = {};
|
|
170
|
+
|
|
130
171
|
return (frameCtx, dt) => {
|
|
131
172
|
loading.update();
|
|
132
173
|
if (frameCtx.input.justPressed("restart")) {
|
|
@@ -145,34 +186,40 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
145
186
|
}
|
|
146
187
|
}
|
|
147
188
|
const ranked = rankRace();
|
|
148
|
-
const player = ranked
|
|
189
|
+
const player = playerRanking(ranked);
|
|
149
190
|
if (player === undefined) throw new Error("Race ranking lost the player.");
|
|
150
191
|
sameDistanceRanking = ranked[0]?.id === "rival" ? "lap-ahead" : "lap-behind";
|
|
151
192
|
status = resolveRaceStatus(status, lap.completed, TOTAL_LAPS, player.place);
|
|
193
|
+
if (player.place !== place) {
|
|
194
|
+
place = player.place;
|
|
195
|
+
positionLabel = `P${place}`;
|
|
196
|
+
}
|
|
152
197
|
const previous = frameCtx.state.getState();
|
|
153
198
|
const boostPeakSpeed = Math.max(previous.boostPeakSpeed, car.boost.active ? car.speed : 0);
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
169
|
-
|
|
170
|
-
|
|
171
|
-
|
|
172
|
-
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
199
|
+
lastOnRoad[0] = sector.lastOnRoadPosition.x;
|
|
200
|
+
lastOnRoad[1] = sector.lastOnRoadPosition.y;
|
|
201
|
+
lastOnRoad[2] = sector.lastOnRoadPosition.z;
|
|
202
|
+
statePatch.boostActive = car.boost.active;
|
|
203
|
+
statePatch.boostPeakSpeed = boostPeakSpeed;
|
|
204
|
+
statePatch.boostUses = car.boost.uses;
|
|
205
|
+
statePatch.completedLaps = lap.completed;
|
|
206
|
+
statePatch.elapsed = elapsed;
|
|
207
|
+
statePatch.lastOnRoad = lastOnRoad;
|
|
208
|
+
statePatch.place = player.place;
|
|
209
|
+
statePatch.position = positionLabel;
|
|
210
|
+
statePatch.raceStatus = status;
|
|
211
|
+
statePatch.rescueHeading = Math.atan2(sector.lastOnRoadHeading.z, sector.lastOnRoadHeading.x);
|
|
212
|
+
statePatch.rescueHeadingError = rescueHeadingError;
|
|
213
|
+
statePatch.rescuePositionError = rescuePositionError;
|
|
214
|
+
statePatch.rescues = rescues;
|
|
215
|
+
statePatch.shortcutRejects = lap.shortcutRejects;
|
|
216
|
+
statePatch.speed = car.speed;
|
|
217
|
+
statePatch.speedAfterBoost = speedAfterBoost;
|
|
218
|
+
statePatch.sameDistanceRanking = sameDistanceRanking;
|
|
219
|
+
statePatch.topSpeed = Math.max(previous.topSpeed, car.topSpeed);
|
|
220
|
+
statePatch.trackProgress = player.routeProgress;
|
|
221
|
+
statePatch.reverseRejects = lap.reverseRejects;
|
|
222
|
+
frameCtx.state.set(statePatch);
|
|
176
223
|
chaseCamera(camera, car.mesh.position, car.forward, dt);
|
|
177
224
|
cameraRoll(camera, car.forward);
|
|
178
225
|
};
|
|
@@ -11,6 +11,10 @@ export function resolveRaceStatus(
|
|
|
11
11
|
}
|
|
12
12
|
|
|
13
13
|
export type GameState = {
|
|
14
|
+
/** Set from the UI\'s pause and resume intents, and read back by the menu. */
|
|
15
|
+
paused: boolean;
|
|
16
|
+
/** True once the UI layer has rendered and published its interactive rectangles. */
|
|
17
|
+
uiReady: boolean;
|
|
14
18
|
boostActive: boolean;
|
|
15
19
|
boostPeakSpeed: number;
|
|
16
20
|
speedAfterBoost: number;
|
|
@@ -25,8 +25,72 @@ body,
|
|
|
25
25
|
}
|
|
26
26
|
|
|
27
27
|
body {
|
|
28
|
-
background: var(--color-ink);
|
|
29
28
|
color: var(--color-text);
|
|
30
29
|
font-family: var(--font-mono);
|
|
31
30
|
-webkit-font-smoothing: antialiased;
|
|
32
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
|
+
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { PhysicsBody3D } from "@threenative/physics";
|
|
2
|
-
import
|
|
2
|
+
import { Vector3 } from "three";
|
|
3
3
|
import type { Checkline } from "./Checkline.js";
|
|
4
4
|
|
|
5
5
|
export interface ILapTarget {
|
|
@@ -15,8 +15,13 @@ export class Lap {
|
|
|
15
15
|
reverseRejects = 0;
|
|
16
16
|
#target: ILapTarget;
|
|
17
17
|
#gates: readonly Checkline[];
|
|
18
|
+
#gateNormals: Vector3[] = [];
|
|
18
19
|
#onLap: (lap: number) => void;
|
|
19
20
|
#unsubscribe: (() => void)[] = [];
|
|
21
|
+
#targetDirection = new Vector3();
|
|
22
|
+
#gateDirection = new Vector3();
|
|
23
|
+
#before = new Vector3();
|
|
24
|
+
#after = new Vector3();
|
|
20
25
|
|
|
21
26
|
constructor(
|
|
22
27
|
target: ILapTarget,
|
|
@@ -31,8 +36,11 @@ export class Lap {
|
|
|
31
36
|
this.#gates = gates;
|
|
32
37
|
this.totalLaps = totalLaps;
|
|
33
38
|
this.#onLap = onLap;
|
|
34
|
-
for (
|
|
39
|
+
for (let index = 0; index < gates.length; index += 1) {
|
|
40
|
+
const gate = gates[index];
|
|
41
|
+
if (gate === undefined) throw new Error("Lap gate is missing.");
|
|
35
42
|
const expected = gate.forward.clone().setY(0).normalize();
|
|
43
|
+
this.#gateNormals.push(expected);
|
|
36
44
|
this.#unsubscribe.push(
|
|
37
45
|
gate.area.on("bodyEntered", (body) => {
|
|
38
46
|
if (body !== this.#target.body || this.completed >= this.totalLaps) return;
|
|
@@ -49,11 +57,11 @@ export class Lap {
|
|
|
49
57
|
return false;
|
|
50
58
|
}
|
|
51
59
|
const direction = gateForward ?? gate.forward;
|
|
52
|
-
const travel = this.#
|
|
53
|
-
.
|
|
60
|
+
const travel = this.#targetDirection
|
|
61
|
+
.copy(this.#target.forward)
|
|
54
62
|
.setY(0)
|
|
55
63
|
.normalize()
|
|
56
|
-
.dot(
|
|
64
|
+
.dot(this.#gateDirection.copy(direction).setY(0).normalize());
|
|
57
65
|
if (travel <= 0.2) {
|
|
58
66
|
this.reverseRejects += 1;
|
|
59
67
|
return false;
|
|
@@ -72,10 +80,13 @@ export class Lap {
|
|
|
72
80
|
|
|
73
81
|
/** Sweeps a car transform between frames so a fast body cannot skip a thin sensor. */
|
|
74
82
|
observe(previous: Vector3, current: Vector3): void {
|
|
75
|
-
for (
|
|
76
|
-
const
|
|
77
|
-
|
|
78
|
-
const
|
|
83
|
+
for (let index = 0; index < this.#gates.length; index += 1) {
|
|
84
|
+
const gate = this.#gates[index];
|
|
85
|
+
if (gate === undefined) throw new Error("Lap gate is missing.");
|
|
86
|
+
const normal = this.#gateNormals[index];
|
|
87
|
+
if (normal === undefined) throw new Error("Lap gate normal is missing.");
|
|
88
|
+
const before = this.#before.copy(previous).sub(gate.at).dot(normal);
|
|
89
|
+
const after = this.#after.copy(current).sub(gate.at).dot(normal);
|
|
79
90
|
const crossedForward = before < 0 && after >= 0;
|
|
80
91
|
const crossedReverse = before >= 0 && after < 0;
|
|
81
92
|
if (crossedForward || crossedReverse) this.cross(index);
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import type { PathFollow3D } from "@threenative/core";
|
|
2
|
-
import
|
|
1
|
+
import type { IPathFollow3DProjection, PathFollow3D } from "@threenative/core";
|
|
2
|
+
import { Vector3 } from "three";
|
|
3
3
|
|
|
4
4
|
export interface IRacerProgress {
|
|
5
5
|
readonly id: string;
|
|
@@ -12,24 +12,63 @@ export interface IRankedRacer extends IRacerProgress {
|
|
|
12
12
|
readonly routeProgress: number;
|
|
13
13
|
}
|
|
14
14
|
|
|
15
|
-
export
|
|
15
|
+
export interface IRankedRacerScratch {
|
|
16
|
+
id: string;
|
|
17
|
+
lap: number;
|
|
18
|
+
position: Vector3;
|
|
19
|
+
place: number;
|
|
20
|
+
routeProgress: number;
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
const projectionScratch: IPathFollow3DProjection = {
|
|
24
|
+
distanceFromStart: 0,
|
|
25
|
+
lateralDistance: 0,
|
|
26
|
+
point: new Vector3(0, 0, 0),
|
|
27
|
+
segment: 0,
|
|
28
|
+
tangent: new Vector3(0, 0, 1),
|
|
29
|
+
};
|
|
30
|
+
|
|
31
|
+
function compareRankedRacers(left: IRankedRacerScratch, right: IRankedRacerScratch): number {
|
|
32
|
+
return right.routeProgress - left.routeProgress || left.id.localeCompare(right.id);
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
export function routeProgress(
|
|
36
|
+
route: PathFollow3D,
|
|
37
|
+
position: Vector3,
|
|
38
|
+
lap: number,
|
|
39
|
+
target: IPathFollow3DProjection = projectionScratch,
|
|
40
|
+
): number {
|
|
16
41
|
if (!Number.isInteger(lap) || lap < 0)
|
|
17
42
|
throw new Error("Racing route lap must be a non-negative integer.");
|
|
18
|
-
return lap * route.totalLength + route.project(position).distanceFromStart;
|
|
43
|
+
return lap * route.totalLength + route.project(position, target).distanceFromStart;
|
|
19
44
|
}
|
|
20
45
|
|
|
21
46
|
export function rankRacers(
|
|
22
47
|
route: PathFollow3D,
|
|
23
48
|
racers: readonly IRacerProgress[],
|
|
49
|
+
target: IPathFollow3DProjection = projectionScratch,
|
|
50
|
+
buffer: IRankedRacerScratch[] = [],
|
|
24
51
|
): readonly IRankedRacer[] {
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
.
|
|
32
|
-
|
|
33
|
-
);
|
|
34
|
-
|
|
52
|
+
if (buffer.length > racers.length) buffer.length = racers.length;
|
|
53
|
+
for (let index = buffer.length; index < racers.length; index += 1) {
|
|
54
|
+
buffer.push({ id: "", lap: 0, position: projectionScratch.point, place: 0, routeProgress: 0 });
|
|
55
|
+
}
|
|
56
|
+
for (let index = 0; index < racers.length; index += 1) {
|
|
57
|
+
const racer = racers[index];
|
|
58
|
+
if (racer === undefined) throw new Error("Racing racer input is missing.");
|
|
59
|
+
const ranked = buffer[index];
|
|
60
|
+
if (ranked === undefined) throw new Error("Racing ranking buffer slot is missing.");
|
|
61
|
+
ranked.id = racer.id;
|
|
62
|
+
ranked.lap = racer.lap;
|
|
63
|
+
ranked.position = racer.position;
|
|
64
|
+
ranked.routeProgress = routeProgress(route, racer.position, racer.lap, target);
|
|
65
|
+
ranked.place = 0;
|
|
66
|
+
}
|
|
67
|
+
buffer.sort(compareRankedRacers);
|
|
68
|
+
for (let index = 0; index < buffer.length; index += 1) {
|
|
69
|
+
const racer = buffer[index];
|
|
70
|
+
if (racer === undefined) throw new Error("Racing ranked racer is missing.");
|
|
71
|
+
racer.place = index + 1;
|
|
72
|
+
}
|
|
73
|
+
return buffer;
|
|
35
74
|
}
|