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
|
@@ -3,15 +3,20 @@
|
|
|
3
3
|
"target": "web",
|
|
4
4
|
"schemaVersion": 1,
|
|
5
5
|
"viewport": {
|
|
6
|
-
"width":
|
|
7
|
-
"height":
|
|
6
|
+
"width": 1920,
|
|
7
|
+
"height": 1080
|
|
8
8
|
},
|
|
9
|
-
"warmupFrames":
|
|
9
|
+
"warmupFrames": 60,
|
|
10
10
|
"steps": [
|
|
11
11
|
{
|
|
12
12
|
"kind": "input",
|
|
13
13
|
"press": "ArrowRight",
|
|
14
|
-
"
|
|
14
|
+
"holdTicks": 60,
|
|
15
|
+
"release": true
|
|
16
|
+
},
|
|
17
|
+
{
|
|
18
|
+
"kind": "wait",
|
|
19
|
+
"waitTicks": 600,
|
|
15
20
|
"release": true
|
|
16
21
|
}
|
|
17
22
|
],
|
|
@@ -27,6 +32,14 @@
|
|
|
27
32
|
"entity": "hud"
|
|
28
33
|
}
|
|
29
34
|
],
|
|
30
|
-
"performance": {
|
|
35
|
+
"performance": {
|
|
36
|
+
"maxDrawCalls": 48,
|
|
37
|
+
"maxFrameMsP95": 33,
|
|
38
|
+
"maxTriangles": 6200,
|
|
39
|
+
"minFps": 30
|
|
40
|
+
},
|
|
41
|
+
"renderChain": {
|
|
42
|
+
"tier": "high"
|
|
43
|
+
}
|
|
31
44
|
}
|
|
32
45
|
}
|
|
@@ -2,12 +2,26 @@
|
|
|
2
2
|
"name": "survives",
|
|
3
3
|
"target": "web",
|
|
4
4
|
"schemaVersion": 1,
|
|
5
|
-
"viewport": {
|
|
5
|
+
"viewport": {
|
|
6
|
+
"width": 1280,
|
|
7
|
+
"height": 720
|
|
8
|
+
},
|
|
6
9
|
"warmupFrames": 10,
|
|
7
10
|
"subject": "player",
|
|
8
11
|
"steps": [
|
|
9
|
-
{
|
|
10
|
-
|
|
12
|
+
{
|
|
13
|
+
"kind": "input",
|
|
14
|
+
"label": "move",
|
|
15
|
+
"press": "ArrowUp",
|
|
16
|
+
"holdTicks": 60,
|
|
17
|
+
"release": true
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"kind": "wait",
|
|
21
|
+
"label": "settle",
|
|
22
|
+
"waitTicks": 10,
|
|
23
|
+
"release": true
|
|
24
|
+
}
|
|
11
25
|
],
|
|
12
26
|
"assert": {
|
|
13
27
|
"diagnostics": {
|
|
@@ -16,7 +30,37 @@
|
|
|
16
30
|
"noRuntimeDiagnostics": true,
|
|
17
31
|
"runtimeReady": true
|
|
18
32
|
},
|
|
19
|
-
"
|
|
33
|
+
"components": [
|
|
34
|
+
{
|
|
35
|
+
"entity": "player",
|
|
36
|
+
"component": "groundCorrectionEnabled",
|
|
37
|
+
"equals": false,
|
|
38
|
+
"allowTrivial": "The disabled correction is intentional while its measurement remains live."
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
"entity": "player",
|
|
42
|
+
"component": "groundClearance",
|
|
43
|
+
"lte": 0,
|
|
44
|
+
"allowTrivial": "The authored pose is intentionally below the floor so clearance stays observable."
|
|
45
|
+
},
|
|
46
|
+
{
|
|
47
|
+
"entity": "player",
|
|
48
|
+
"component": "normaliseFactor",
|
|
49
|
+
"allowTrivial": "The figure is authored taller than the template's 1.1 m convention and normalised down, so the retained factor is below one; either side of one proves normaliseToMetres ran in generated source.",
|
|
50
|
+
"lte": 0.99
|
|
51
|
+
}
|
|
52
|
+
],
|
|
53
|
+
"movement": {
|
|
54
|
+
"entity": "player",
|
|
55
|
+
"minDistance": 0.5
|
|
56
|
+
},
|
|
57
|
+
"visibility": [
|
|
58
|
+
{
|
|
59
|
+
"entity": "touch-controls",
|
|
60
|
+
"present": false,
|
|
61
|
+
"allowTrivial": "Desktop keyboard lanes intentionally omit touch controls while movement proves the scene is active."
|
|
62
|
+
}
|
|
63
|
+
],
|
|
20
64
|
"visual": [
|
|
21
65
|
{
|
|
22
66
|
"region": {
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "minimal-touch-controls",
|
|
3
|
+
"schemaVersion": 1,
|
|
4
|
+
"target": "web",
|
|
5
|
+
"viewport": { "width": 1280, "height": 720 },
|
|
6
|
+
"warmupFrames": 10,
|
|
7
|
+
"subject": "player",
|
|
8
|
+
"steps": [
|
|
9
|
+
{
|
|
10
|
+
"kind": "input",
|
|
11
|
+
"label": "movement-anchor",
|
|
12
|
+
"pointers": [{ "id": 7, "x": 0.18, "y": 0.75 }],
|
|
13
|
+
"holdTicks": 2,
|
|
14
|
+
"release": false
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"kind": "input",
|
|
18
|
+
"label": "move-right",
|
|
19
|
+
"pointers": [{ "id": 7, "x": 0.38, "y": 0.75 }],
|
|
20
|
+
"holdTicks": 45,
|
|
21
|
+
"release": true
|
|
22
|
+
},
|
|
23
|
+
{ "kind": "wait", "label": "settled", "waitTicks": 10, "release": true }
|
|
24
|
+
],
|
|
25
|
+
"assert": {
|
|
26
|
+
"diagnostics": {
|
|
27
|
+
"noConsoleErrors": true,
|
|
28
|
+
"noNetworkErrors": true,
|
|
29
|
+
"noRuntimeDiagnostics": true,
|
|
30
|
+
"runtimeReady": true
|
|
31
|
+
},
|
|
32
|
+
"movement": { "entity": "player", "minDistance": 0.1 },
|
|
33
|
+
"resources": [{ "id": "state", "path": "playerX", "changed": true }],
|
|
34
|
+
"visibility": [
|
|
35
|
+
{
|
|
36
|
+
"entity": "touch-controls",
|
|
37
|
+
"present": true,
|
|
38
|
+
"allowTrivial": "Touch-primary lanes keep the authored controls visible while state assertions prove they are live."
|
|
39
|
+
}
|
|
40
|
+
]
|
|
41
|
+
}
|
|
42
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { GroundSnap, normaliseToMetres } from "@threenative/core";
|
|
2
|
+
import type { Mesh } from "three";
|
|
3
|
+
|
|
4
|
+
export interface IMinimalConventions {
|
|
5
|
+
readonly applyGrounding: (surfaceY: number, dt: number) => void;
|
|
6
|
+
readonly groundSnap: GroundSnap;
|
|
7
|
+
readonly normaliseFactor: number;
|
|
8
|
+
}
|
|
9
|
+
|
|
10
|
+
export function preparePlayerConventions(model: Mesh): IMinimalConventions {
|
|
11
|
+
const normaliseFactor = normaliseToMetres(model, { axis: "height", metres: 1.1 });
|
|
12
|
+
const groundSnap = new GroundSnap(model, { enabled: false });
|
|
13
|
+
return {
|
|
14
|
+
applyGrounding: (surfaceY, dt) => groundSnap.apply(model, surfaceY, dt),
|
|
15
|
+
groundSnap,
|
|
16
|
+
normaliseFactor,
|
|
17
|
+
};
|
|
18
|
+
}
|
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
import type { ICtx } from "@threenative/core";
|
|
2
2
|
import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
|
|
3
|
-
import { BoxGeometry, Mesh } from "three";
|
|
4
|
-
import {
|
|
3
|
+
import { BoxGeometry, Group, Mesh } from "three";
|
|
4
|
+
import { type IMinimalConventions, preparePlayerConventions } from "../conventions.js";
|
|
5
|
+
import { accentMaterial, defaultMaterial } from "../render/materials.js";
|
|
6
|
+
import type { ITouchInput } from "../render/touch-controls.js";
|
|
5
7
|
import type { GameState } from "../state.js";
|
|
6
8
|
|
|
7
9
|
type GameCtx = ICtx<GameState, IPhysicsContext>;
|
|
@@ -13,16 +15,37 @@ const MOVE_SPEED = 2;
|
|
|
13
15
|
const SPAWN = { x: -2, y: 0.5, z: 0 } as const;
|
|
14
16
|
|
|
15
17
|
export class Player {
|
|
16
|
-
readonly mesh
|
|
18
|
+
readonly mesh: Group;
|
|
19
|
+
readonly visual: Mesh;
|
|
17
20
|
readonly body: CharacterBody3D;
|
|
21
|
+
#conventions: IMinimalConventions;
|
|
18
22
|
#coyoteTime = 0;
|
|
19
23
|
#jumpBuffer = 0;
|
|
20
24
|
#jumps = 0;
|
|
21
25
|
#coyoteJumps = 0;
|
|
22
26
|
|
|
23
27
|
constructor(ctx: GameCtx) {
|
|
28
|
+
this.mesh = new Group();
|
|
29
|
+
// A figure, not a cube. Three boxes is still minimal, and it gives the player a front — which
|
|
30
|
+
// is the whole difference between "a character" and "the scene's placeholder".
|
|
31
|
+
this.visual = new Mesh(new BoxGeometry(0.46, 0.56, 0.34), defaultMaterial);
|
|
32
|
+
this.visual.castShadow = true;
|
|
33
|
+
const head = new Mesh(new BoxGeometry(0.34, 0.3, 0.3), defaultMaterial);
|
|
34
|
+
head.position.y = 0.42;
|
|
35
|
+
head.castShadow = true;
|
|
36
|
+
this.visual.add(head);
|
|
37
|
+
const visor = new Mesh(new BoxGeometry(0.26, 0.08, 0.04), accentMaterial);
|
|
38
|
+
visor.position.set(0, 0.44, -0.16);
|
|
39
|
+
this.visual.add(visor);
|
|
40
|
+
for (const side of [-1, 1]) {
|
|
41
|
+
const leg = new Mesh(new BoxGeometry(0.15, 0.34, 0.2), accentMaterial);
|
|
42
|
+
leg.position.set(side * 0.12, -0.44, 0);
|
|
43
|
+
leg.castShadow = true;
|
|
44
|
+
this.visual.add(leg);
|
|
45
|
+
}
|
|
46
|
+
this.mesh.add(this.visual);
|
|
24
47
|
this.mesh.position.set(SPAWN.x, SPAWN.y, SPAWN.z);
|
|
25
|
-
this
|
|
48
|
+
this.#conventions = preparePlayerConventions(this.visual);
|
|
26
49
|
ctx.add(this.mesh);
|
|
27
50
|
this.body = new CharacterBody3D({
|
|
28
51
|
autostep: { maxHeight: 0.4, minWidth: 0.2 },
|
|
@@ -32,11 +55,12 @@ export class Player {
|
|
|
32
55
|
});
|
|
33
56
|
}
|
|
34
57
|
|
|
35
|
-
update(ctx: GameCtx, dt: number): void {
|
|
58
|
+
update(ctx: GameCtx, dt: number, touch?: ITouchInput): void {
|
|
36
59
|
this.#coyoteTime = Math.max(0, this.#coyoteTime - dt);
|
|
37
60
|
this.#jumpBuffer = Math.max(0, this.#jumpBuffer - dt);
|
|
38
61
|
if (this.body.grounded) this.#coyoteTime = COYOTE_TIME;
|
|
39
|
-
if (ctx.input.justPressed("jump")
|
|
62
|
+
if (ctx.input.justPressed("jump") || touch?.jumpPressed === true)
|
|
63
|
+
this.#jumpBuffer = JUMP_BUFFER;
|
|
40
64
|
if (this.#jumpBuffer > 0 && this.#coyoteTime > 0) {
|
|
41
65
|
this.body.velocity.y = JUMP_SPEED;
|
|
42
66
|
this.#jumpBuffer = 0;
|
|
@@ -45,16 +69,25 @@ export class Player {
|
|
|
45
69
|
this.#coyoteJumps += 1;
|
|
46
70
|
}
|
|
47
71
|
const move = ctx.input.vector("move");
|
|
72
|
+
if (touch !== undefined) {
|
|
73
|
+
move.x += touch.move.x;
|
|
74
|
+
move.y += touch.move.y;
|
|
75
|
+
move.clampLength(0, 1);
|
|
76
|
+
}
|
|
48
77
|
this.body.velocity.x = move.x * MOVE_SPEED;
|
|
49
78
|
this.body.velocity.z = -move.y * MOVE_SPEED;
|
|
50
79
|
this.body.moveAndSlide(dt);
|
|
80
|
+
this.#conventions.applyGrounding(0, dt);
|
|
51
81
|
}
|
|
52
82
|
|
|
53
83
|
debug(): Record<string, unknown> {
|
|
54
84
|
return {
|
|
55
85
|
coyoteJumps: this.#coyoteJumps,
|
|
56
86
|
grounded: this.body.grounded,
|
|
87
|
+
groundClearance: this.#conventions.groundSnap.clearance,
|
|
88
|
+
groundCorrectionEnabled: this.#conventions.groundSnap.enabled,
|
|
57
89
|
jumps: this.#jumps,
|
|
90
|
+
normaliseFactor: this.#conventions.normaliseFactor,
|
|
58
91
|
position: this.mesh.position.toArray(),
|
|
59
92
|
};
|
|
60
93
|
}
|
|
@@ -20,6 +20,7 @@ const game = defineGame<GameState, IPhysicsContext>({
|
|
|
20
20
|
// `playtest()` installs the bridge a scenario needs to observe entities and state. Without
|
|
21
21
|
// it, semantic assertions fail closed with TN_PLAYTEST_BRIDGE_MISSING rather than passing.
|
|
22
22
|
plugins: [rapier(), playtest()],
|
|
23
|
+
display: config.display,
|
|
23
24
|
render: config.renderer,
|
|
24
25
|
scenes: { play: Play },
|
|
25
26
|
start: "play",
|
|
@@ -11,7 +11,17 @@ if (app === null) throw new Error("Missing #app element.");
|
|
|
11
11
|
|
|
12
12
|
import.meta.hot?.accept();
|
|
13
13
|
acceptHotUpdate(game, import.meta.hot);
|
|
14
|
-
void game
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
14
|
+
void game
|
|
15
|
+
.start()
|
|
16
|
+
.then(() => {
|
|
17
|
+
const canvas = game.ctx?.renderer.domElement;
|
|
18
|
+
if (canvas !== undefined) app.prepend(canvas);
|
|
19
|
+
})
|
|
20
|
+
.catch((error: unknown) => {
|
|
21
|
+
const failure = document.createElement("div");
|
|
22
|
+
failure.id = "threenative-canvas-error";
|
|
23
|
+
failure.dataset.threenativeCanvasError = "true";
|
|
24
|
+
failure.setAttribute("role", "alert");
|
|
25
|
+
failure.textContent = error instanceof Error ? error.message : String(error);
|
|
26
|
+
app.replaceChildren(failure);
|
|
27
|
+
});
|
|
@@ -4,7 +4,7 @@ import type { PerspectiveCamera } from "three";
|
|
|
4
4
|
export function setupCamera(camera: PerspectiveCamera): void {
|
|
5
5
|
camera.fov = 54;
|
|
6
6
|
camera.near = 0.1;
|
|
7
|
-
camera.far =
|
|
7
|
+
camera.far = 20_000;
|
|
8
8
|
camera.position.set(0, 3, 9);
|
|
9
9
|
camera.lookAt(0, 1, 0);
|
|
10
10
|
camera.updateProjectionMatrix();
|
|
@@ -8,7 +8,19 @@ const GLYPHS =
|
|
|
8
8
|
.split(" ")
|
|
9
9
|
.map((hex) => BigInt(`0x${hex}`));
|
|
10
10
|
|
|
11
|
-
|
|
11
|
+
type HudValues = { counter?: number; primary: number; seconds: number };
|
|
12
|
+
|
|
13
|
+
function formatHudText(primaryLabel: string, counterLabel: string | undefined, values: HudValues) {
|
|
14
|
+
const minutes = String(Math.floor(values.seconds / 60)).padStart(2, "0");
|
|
15
|
+
const seconds = String(Math.floor(values.seconds % 60)).padStart(2, "0");
|
|
16
|
+
const lines = [`${primaryLabel} ${Math.max(0, Math.round(values.primary))}`];
|
|
17
|
+
if (counterLabel !== undefined && values.counter !== undefined)
|
|
18
|
+
lines.push(`${counterLabel} ${Math.max(0, Math.round(values.counter))}`);
|
|
19
|
+
lines.push(`TIME ${minutes}:${seconds}`);
|
|
20
|
+
return lines.join("\n");
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export function createHud(camera: PerspectiveCamera, primaryLabel: string, counterLabel?: string) {
|
|
12
24
|
const material = new MeshBasicMaterial({
|
|
13
25
|
color: palette.player,
|
|
14
26
|
depthTest: false,
|
|
@@ -21,10 +33,16 @@ export function createHud(camera: PerspectiveCamera, primaryLabel: string, count
|
|
|
21
33
|
camera.add(root);
|
|
22
34
|
return {
|
|
23
35
|
glyphs: 0,
|
|
24
|
-
update(values:
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
36
|
+
update(values: HudValues): void {
|
|
37
|
+
// The HUD changes at most once a second, but update runs per frame — skip the glyph
|
|
38
|
+
// rebuild and the instance upload when the text is unchanged. Placement still recomputes:
|
|
39
|
+
// a resize moves the anchor even when the text has not changed.
|
|
40
|
+
const text = formatHudText(primaryLabel, counterLabel, values);
|
|
41
|
+
const height = 2 * Math.tan(MathUtils.degToRad(camera.fov / 2));
|
|
42
|
+
root.position.set(-height * camera.aspect * 0.46, height * 0.42, -1);
|
|
43
|
+
root.scale.setScalar(height / 160);
|
|
44
|
+
if (text === this.lastText) return;
|
|
45
|
+
this.lastText = text;
|
|
28
46
|
let instance = 0;
|
|
29
47
|
for (const [y, line] of text.split("\n").entries()) {
|
|
30
48
|
for (let x = 0; x < line.length; x += 1) {
|
|
@@ -40,10 +58,8 @@ export function createHud(camera: PerspectiveCamera, primaryLabel: string, count
|
|
|
40
58
|
}
|
|
41
59
|
root.count = this.glyphs = instance;
|
|
42
60
|
root.instanceMatrix.needsUpdate = true;
|
|
43
|
-
const height = 2 * Math.tan(MathUtils.degToRad(camera.fov / 2));
|
|
44
|
-
root.position.set(-height * camera.aspect * 0.46, height * 0.42, -1);
|
|
45
|
-
root.scale.setScalar(height / 160);
|
|
46
61
|
},
|
|
62
|
+
lastText: "",
|
|
47
63
|
dispose(): void {
|
|
48
64
|
root.removeFromParent();
|
|
49
65
|
root.geometry.dispose();
|
|
@@ -5,23 +5,40 @@
|
|
|
5
5
|
// back light, silhouettes read as flat cut-outs against the background.
|
|
6
6
|
import {
|
|
7
7
|
AmbientLight,
|
|
8
|
+
Color,
|
|
8
9
|
DirectionalLight,
|
|
9
10
|
HemisphereLight,
|
|
10
11
|
PCFSoftShadowMap,
|
|
11
12
|
type Scene,
|
|
13
|
+
Vector3,
|
|
12
14
|
} from "three";
|
|
13
15
|
import { palette } from "./palette.js";
|
|
14
16
|
|
|
15
17
|
type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
|
|
18
|
+
type AtmosphereLike = {
|
|
19
|
+
getSunDirection(target?: Vector3): Vector3;
|
|
20
|
+
sunTransmittance(direction: Vector3): unknown;
|
|
21
|
+
};
|
|
16
22
|
|
|
17
|
-
export function setupLighting(
|
|
23
|
+
export function setupLighting(
|
|
24
|
+
scene: Scene,
|
|
25
|
+
renderer: ShadowRenderer,
|
|
26
|
+
atmosphere?: AtmosphereLike,
|
|
27
|
+
): { key: DirectionalLight; updateSun(direction: Vector3): void } {
|
|
18
28
|
renderer.shadowMap.enabled = true;
|
|
19
29
|
renderer.shadowMap.type = PCFSoftShadowMap;
|
|
20
30
|
|
|
21
31
|
scene.add(new HemisphereLight(palette.skyHigh, palette.shadow, 1.6));
|
|
22
32
|
|
|
23
33
|
const key = new DirectionalLight(palette.accent, 3);
|
|
24
|
-
|
|
34
|
+
const updateSun = (direction: Vector3): void => {
|
|
35
|
+
key.position.copy(direction).multiplyScalar(7);
|
|
36
|
+
const transmittance = atmosphere?.sunTransmittance(direction);
|
|
37
|
+
if (transmittance instanceof Vector3) {
|
|
38
|
+
key.color.copy(new Color().setRGB(transmittance.x, transmittance.y, transmittance.z));
|
|
39
|
+
}
|
|
40
|
+
};
|
|
41
|
+
updateSun(atmosphere?.getSunDirection() ?? new Vector3(4, 7, 3).normalize());
|
|
25
42
|
key.castShadow = true;
|
|
26
43
|
// 1024² keeps the default shadow pass at one quarter of a 2048² map's
|
|
27
44
|
// texel storage and fill work. The small generated scene fits this 12-unit
|
|
@@ -43,4 +60,8 @@ export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
|
|
|
43
60
|
scene.add(rim);
|
|
44
61
|
|
|
45
62
|
scene.add(new AmbientLight(palette.shadow, 0.28));
|
|
63
|
+
// The key light travels with the sun updater: `WorldEnvironment`'s godrays stage raymarches
|
|
64
|
+
// against its shadow map, so `setupPost` needs the light itself and refuses a shadowless one
|
|
65
|
+
// by name instead of rendering a black pass.
|
|
66
|
+
return { key, updateSun };
|
|
46
67
|
}
|
|
@@ -1,113 +1,33 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
*/
|
|
15
|
-
export interface LoadingHost {
|
|
1
|
+
import type { Camera, OrthographicCamera, Scene } from "three";
|
|
2
|
+
|
|
3
|
+
/** Minimal deliberately opts out; changing this one source value enables a full authored cover. */
|
|
4
|
+
export const loading = {
|
|
5
|
+
backgroundImage: undefined as string | undefined,
|
|
6
|
+
enabled: false,
|
|
7
|
+
fillImage: undefined as string | undefined,
|
|
8
|
+
logoImage: undefined as string | undefined,
|
|
9
|
+
progressColor: 0xffd27a,
|
|
10
|
+
trackColor: 0x14516e,
|
|
11
|
+
} as const;
|
|
12
|
+
|
|
13
|
+
interface LoadingHost {
|
|
16
14
|
readonly camera: Camera;
|
|
17
|
-
readonly scene: Scene;
|
|
18
15
|
readonly canvasLayer: {
|
|
19
16
|
readonly camera: OrthographicCamera;
|
|
20
17
|
readonly scene: Scene;
|
|
21
18
|
opaque: boolean;
|
|
22
19
|
};
|
|
23
|
-
readonly
|
|
24
|
-
|
|
20
|
+
readonly viewport?: {
|
|
21
|
+
readonly safeArea: {
|
|
22
|
+
readonly height: number;
|
|
23
|
+
readonly width: number;
|
|
24
|
+
readonly x: number;
|
|
25
|
+
readonly y: number;
|
|
26
|
+
};
|
|
27
|
+
};
|
|
25
28
|
}
|
|
26
29
|
|
|
27
|
-
/**
|
|
28
|
-
* Draws the loading screen in the framework's pixel-sized canvas layer. Colours, layout, and the
|
|
29
|
-
* shape of the bar live here in generated source, so they remain the game's to change or delete.
|
|
30
|
-
*/
|
|
31
30
|
export function createLoadingScreen(host: LoadingHost) {
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
const cover = (color: number, renderOrder: number) => {
|
|
35
|
-
const mesh = new Mesh(
|
|
36
|
-
new PlaneGeometry(1, 1),
|
|
37
|
-
new MeshBasicMaterial({ color, depthTest: false, depthWrite: false }),
|
|
38
|
-
);
|
|
39
|
-
mesh.frustumCulled = false;
|
|
40
|
-
mesh.renderOrder = renderOrder;
|
|
41
|
-
layer.scene.add(mesh);
|
|
42
|
-
return mesh;
|
|
43
|
-
};
|
|
44
|
-
const backdrop = cover(palette.skyLow, 0);
|
|
45
|
-
const track = cover(palette.skyHigh, 1);
|
|
46
|
-
const fill = cover(palette.accent, 2);
|
|
47
|
-
const parts = [backdrop, track, fill];
|
|
48
|
-
layer.opaque = true;
|
|
49
|
-
|
|
50
|
-
let width = 0;
|
|
51
|
-
let height = 0;
|
|
52
|
-
let lastProgress = 0;
|
|
53
|
-
|
|
54
|
-
const layout = (): void => {
|
|
55
|
-
const nextWidth = camera.right - camera.left;
|
|
56
|
-
const nextHeight = camera.top - camera.bottom;
|
|
57
|
-
width = Number.isFinite(nextWidth) && nextWidth > 0 ? nextWidth : 1;
|
|
58
|
-
height = Number.isFinite(nextHeight) && nextHeight > 0 ? nextHeight : 1;
|
|
59
|
-
backdrop.scale.set(width, height, 1);
|
|
60
|
-
track.scale.set(width * 0.5, height * 0.012, 1);
|
|
61
|
-
track.position.set(0, -height * 0.05, 0);
|
|
62
|
-
fill.position.set(0, -height * 0.05, 0);
|
|
63
|
-
};
|
|
64
|
-
|
|
65
|
-
const setProgress = (progress: number): void => {
|
|
66
|
-
// `Math.max(0, Math.min(1, NaN))` is NaN, so non-finite progress means no progress.
|
|
67
|
-
lastProgress = Number.isFinite(progress) ? Math.max(0, Math.min(1, progress)) : 0;
|
|
68
|
-
const full = width * 0.5;
|
|
69
|
-
const barWidth = Math.max(full * 0.002, full * lastProgress);
|
|
70
|
-
fill.scale.set(barWidth, height * 0.012, 1);
|
|
71
|
-
fill.position.x = -full / 2 + barWidth / 2;
|
|
72
|
-
};
|
|
73
|
-
|
|
74
|
-
let laidOutWidth = camera.right - camera.left;
|
|
75
|
-
let laidOutHeight = camera.top - camera.bottom;
|
|
76
|
-
layout();
|
|
77
|
-
setProgress(0);
|
|
78
|
-
|
|
79
|
-
let done = false;
|
|
80
|
-
const finish = (): void => {
|
|
81
|
-
if (done) return;
|
|
82
|
-
done = true;
|
|
83
|
-
for (const mesh of parts) {
|
|
84
|
-
mesh.removeFromParent();
|
|
85
|
-
mesh.geometry.dispose();
|
|
86
|
-
mesh.material.dispose();
|
|
87
|
-
}
|
|
88
|
-
layer.opaque = false;
|
|
89
|
-
};
|
|
90
|
-
|
|
91
|
-
void (async () => {
|
|
92
|
-
await host.startup.whenReady();
|
|
93
|
-
// Compile the collapsed world's pipelines while the opaque canvas layer still covers it.
|
|
94
|
-
await host.renderer.compileAsync(host.scene, host.camera).catch(() => undefined);
|
|
95
|
-
finish();
|
|
96
|
-
})();
|
|
97
|
-
|
|
98
|
-
return {
|
|
99
|
-
update(): void {
|
|
100
|
-
if (done) return;
|
|
101
|
-
const nextWidth = camera.right - camera.left;
|
|
102
|
-
const nextHeight = camera.top - camera.bottom;
|
|
103
|
-
if (nextWidth !== laidOutWidth || nextHeight !== laidOutHeight) {
|
|
104
|
-
laidOutWidth = nextWidth;
|
|
105
|
-
laidOutHeight = nextHeight;
|
|
106
|
-
layout();
|
|
107
|
-
setProgress(lastProgress);
|
|
108
|
-
}
|
|
109
|
-
setProgress(host.startup.progress);
|
|
110
|
-
},
|
|
111
|
-
finish,
|
|
112
|
-
};
|
|
31
|
+
host.canvasLayer.opaque = false;
|
|
32
|
+
return { finish: () => undefined, update: () => undefined };
|
|
113
33
|
}
|
|
@@ -9,6 +9,13 @@ export const floorMaterial = new MeshStandardMaterial({
|
|
|
9
9
|
metalness: 0.12,
|
|
10
10
|
});
|
|
11
11
|
|
|
12
|
+
/** The player's visor and boots: the one warm note against a cool morning. */
|
|
13
|
+
export const accentMaterial = new MeshStandardMaterial({
|
|
14
|
+
color: palette.accent,
|
|
15
|
+
roughness: 0.6,
|
|
16
|
+
metalness: 0.05,
|
|
17
|
+
});
|
|
18
|
+
|
|
12
19
|
export const defaultMaterial = new MeshStandardMaterial({
|
|
13
20
|
color: palette.player,
|
|
14
21
|
roughness: 0.52,
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
// Generated for you. Keep these six roles coherent when you change the look.
|
|
2
2
|
export const palette = {
|
|
3
3
|
skyHigh: 0x14516e,
|
|
4
|
-
skyLow:
|
|
5
|
-
floor:
|
|
4
|
+
skyLow: 0x1b3a4e,
|
|
5
|
+
floor: 0x27566b,
|
|
6
6
|
player: 0x6fe8ff,
|
|
7
7
|
accent: 0xffd27a,
|
|
8
|
-
shadow:
|
|
8
|
+
shadow: 0x24414f,
|
|
9
9
|
} as const;
|
|
@@ -1,20 +1,59 @@
|
|
|
1
|
-
// Generated for you
|
|
2
|
-
//
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
1
|
+
// Generated for you: ordinary Three.js; ThreeNative does not read this file.
|
|
2
|
+
//
|
|
3
|
+
// This file wires two things together and decides nothing itself. `quality.ts`, in this folder,
|
|
4
|
+
// owns which stages run at which tier and records what each one measured. `WorldEnvironment`,
|
|
5
|
+
// also in this folder, builds them and prints `TN_WORLD_ENVIRONMENT` naming every stage as
|
|
6
|
+
// applied or refused **with a reason**, so a stage that silently no-op'd is never mistaken for
|
|
7
|
+
// one you turned off.
|
|
8
|
+
//
|
|
9
|
+
// To make the game cheaper or prettier everywhere, edit `quality.ts`. To force one tier for one
|
|
10
|
+
// run — a desktop that is dropping frames, a capture you want to compare — pass it:
|
|
11
|
+
// `setupPost(renderer, scene, camera, { tier: "low" })`. Overriding does not silence the report:
|
|
12
|
+
// `TN_QUALITY_TIER` names the tier that ran either way.
|
|
13
|
+
import type { Camera, DirectionalLight, Scene } from "three";
|
|
14
|
+
import { vec3 } from "three/tsl";
|
|
15
|
+
import type { Node } from "three/webgpu";
|
|
16
|
+
import { type QualityTier, qualityPreset, resolveQualityTier } from "./quality.js";
|
|
17
|
+
import type { OutputRenderer } from "./worldEnvironment.js";
|
|
18
|
+
import { WorldEnvironment } from "./worldEnvironment.js";
|
|
6
19
|
|
|
7
|
-
type
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
setOutputNode(node: unknown): void;
|
|
20
|
+
type AtmosphereLike = {
|
|
21
|
+
aerialPerspective(scenePass: unknown, depth: unknown, inScatteredRadiance?: unknown): unknown;
|
|
22
|
+
radiance(direction: unknown): unknown;
|
|
11
23
|
};
|
|
12
24
|
|
|
13
|
-
export function setupPost(
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
25
|
+
export function setupPost(
|
|
26
|
+
renderer: OutputRenderer,
|
|
27
|
+
scene: Scene,
|
|
28
|
+
camera: Camera,
|
|
29
|
+
environment: {
|
|
30
|
+
atmosphere?: AtmosphereLike;
|
|
31
|
+
godraysLight?: DirectionalLight;
|
|
32
|
+
mobile?: boolean;
|
|
33
|
+
/** Forces a tier, ignoring `mobile`. An unknown name throws rather than falling back. */
|
|
34
|
+
tier?: QualityTier;
|
|
35
|
+
} = {},
|
|
36
|
+
): void {
|
|
37
|
+
const tier = resolveQualityTier({ mobile: environment.mobile, tier: environment.tier });
|
|
38
|
+
const source = environment.tier === undefined ? "platform" : "override";
|
|
39
|
+
console.info(`TN_QUALITY_TIER ${tier} mobile=${environment.mobile === true} source=${source}`);
|
|
40
|
+
const world = new WorldEnvironment(qualityPreset(tier));
|
|
41
|
+
const atmosphere = environment.atmosphere;
|
|
42
|
+
world.apply(renderer, scene, camera, {
|
|
43
|
+
// The chain builds the scene pass, so aerial perspective — which needs that pass and its
|
|
44
|
+
// view-Z — is composed here, first, before exposure and before any stage. Delete this
|
|
45
|
+
// property to drop aerial perspective while keeping the sky and the rest of the chain.
|
|
46
|
+
baseColour:
|
|
47
|
+
atmosphere === undefined
|
|
48
|
+
? undefined
|
|
49
|
+
: (scenePass) =>
|
|
50
|
+
atmosphere.aerialPerspective(
|
|
51
|
+
scenePass,
|
|
52
|
+
scenePass.getViewZNode(),
|
|
53
|
+
// Same scale as the dome in sky.ts, and for the same reason: this radiance is
|
|
54
|
+
// mixed into every pixel by the haze term, so at 24 it lifted the whole frame.
|
|
55
|
+
(atmosphere.radiance(vec3(0, 0, 1)) as Node<"vec3">).mul(1.5),
|
|
56
|
+
) as Node<"vec4">,
|
|
57
|
+
godraysLight: environment.godraysLight,
|
|
58
|
+
});
|
|
20
59
|
}
|