create-threenative 0.2.2 → 0.2.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +61 -2
- package/agent-docs/references/assertion-reference.md +819 -0
- package/agent-docs/references/capability-reference.md +4483 -0
- package/agent-docs/references/capture-the-frame.md +60 -0
- package/agent-docs/references/creating-creatures.md +215 -0
- package/agent-docs/references/ctx-cookbook.md +120 -0
- package/agent-docs/references/debug-surface.md +68 -0
- package/agent-docs/references/dream-loop.md +150 -0
- package/agent-docs/references/finding-assets.md +215 -0
- package/agent-docs/references/gameplay-recipes.md +54 -0
- package/agent-docs/references/menu-screens.md +69 -0
- package/agent-docs/references/mobile-memory-budget.md +87 -0
- package/agent-docs/references/sculpt-from-a-reference.md +40 -0
- package/agent-docs/references/trace-a-slow-frame.md +99 -0
- package/agent-docs/references/visual-baseline.md +174 -0
- package/agent-docs/references/webview-ui.md +113 -0
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
- package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
- package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
- package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
- package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
- package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
- package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
- package/agent-files/.claude/agents/threenative-builder.md +7 -0
- package/agent-files/.claude/agents/threenative-verifier.md +7 -0
- package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
- package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
- package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
- package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
- package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
- package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
- package/agent-files/.threenative/agents/builder.md +32 -0
- package/agent-files/.threenative/agents/verifier.md +31 -0
- package/agent-files/AGENT-ROLES.md +26 -0
- package/agent-files/scripts/reference.mjs +705 -0
- package/agent-files/scripts/visual-loop.mjs +382 -0
- package/capabilities.json +5292 -0
- package/dist/index.d.ts +224 -3
- package/dist/index.js +1972 -73
- package/dist/threenative.d.ts +9 -2
- package/dist/threenative.js +2570 -176
- package/package.json +55 -6
- package/template-assets/icon.png +0 -0
- package/template-assets/loading.ts +325 -0
- package/template-assets/patches/three@0.185.1.patch +522 -0
- package/template-assets/worldEnvironment.ts +758 -0
- package/templates/action-rpg/.codex/config.toml +19 -0
- package/templates/action-rpg/.cursor/mcp.json +32 -0
- package/templates/action-rpg/.gemini/settings.json +32 -0
- package/templates/action-rpg/.mcp.json +18 -2
- package/templates/action-rpg/.vscode/mcp.json +36 -0
- package/templates/action-rpg/.zed/settings.json +36 -0
- package/templates/action-rpg/AGENTS.md +84 -29
- package/templates/action-rpg/CLAUDE.md +84 -29
- package/templates/action-rpg/index.html +0 -1
- package/templates/action-rpg/opencode.json +41 -0
- package/templates/action-rpg/package.json +15 -11
- package/templates/action-rpg/playtests/combat.playtest.json +32 -9
- package/templates/action-rpg/playtests/fail.playtest.json +3 -3
- package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
- package/templates/action-rpg/playtests/performance.playtest.json +39 -0
- package/templates/action-rpg/playtests/progress.playtest.json +18 -13
- package/templates/action-rpg/playtests/survives.playtest.json +27 -0
- package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
- package/templates/action-rpg/playtests/win.playtest.json +10 -4
- package/templates/action-rpg/src/conventions.ts +35 -0
- package/templates/action-rpg/src/entities/Enemy.ts +16 -7
- package/templates/action-rpg/src/entities/Player.ts +20 -3
- package/templates/action-rpg/src/game.ts +21 -0
- package/templates/action-rpg/src/render/camera.ts +7 -2
- package/templates/action-rpg/src/render/lighting.ts +11 -4
- package/templates/action-rpg/src/render/loading.ts +278 -43
- package/templates/action-rpg/src/render/materials.ts +11 -0
- package/templates/action-rpg/src/render/palette.ts +10 -3
- package/templates/action-rpg/src/render/postprocessing.ts +32 -16
- package/templates/action-rpg/src/render/quality.ts +170 -0
- package/templates/action-rpg/src/render/shapes.ts +185 -26
- package/templates/action-rpg/src/render/touch-controls.ts +185 -0
- package/templates/action-rpg/src/render/vfx.ts +257 -0
- package/templates/action-rpg/src/render/worldEnvironment.ts +758 -0
- package/templates/action-rpg/src/scenes/Play.ts +91 -24
- package/templates/action-rpg/src/state.ts +4 -0
- package/templates/action-rpg/src/style.css +65 -1
- package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
- package/templates/action-rpg/src/ui/App.tsx +9 -8
- package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
- package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
- package/templates/action-rpg/src/ui/Hud.tsx +10 -8
- package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
- package/templates/action-rpg/src/ui/main.tsx +14 -0
- package/templates/action-rpg/threenative.config.ts +28 -8
- package/templates/action-rpg/vite.config.ts +32 -2
- package/templates/defense/.codex/config.toml +19 -0
- package/templates/defense/.cursor/mcp.json +32 -0
- package/templates/defense/.gemini/settings.json +32 -0
- package/templates/defense/.mcp.json +18 -2
- package/templates/defense/.vscode/mcp.json +36 -0
- package/templates/defense/.zed/settings.json +36 -0
- package/templates/defense/AGENTS.md +81 -41
- package/templates/defense/CLAUDE.md +81 -41
- package/templates/defense/README.md +2 -1
- package/templates/defense/index.html +0 -1
- package/templates/defense/opencode.json +41 -0
- package/templates/defense/package.json +16 -12
- package/templates/defense/playtests/leak.playtest.json +9 -4
- package/templates/defense/playtests/performance.playtest.json +39 -0
- package/templates/defense/playtests/placement.playtest.json +5 -5
- package/templates/defense/playtests/pointer-placement.playtest.json +156 -0
- package/templates/defense/playtests/scan.playtest.json +4 -4
- package/templates/defense/playtests/survive.playtest.json +25 -6
- package/templates/defense/src/attackers/Attacker.ts +32 -16
- package/templates/defense/src/board/Route.ts +22 -8
- package/templates/defense/src/conventions.ts +18 -0
- package/templates/defense/src/entities/Player.ts +11 -3
- package/templates/defense/src/game.ts +25 -4
- package/templates/defense/src/physics.ts +9 -39
- package/templates/defense/src/placement/Buildable.ts +4 -4
- package/templates/defense/src/render/camera.ts +9 -3
- package/templates/defense/src/render/lighting.ts +6 -1
- package/templates/defense/src/render/loading.ts +274 -38
- package/templates/defense/src/render/materials.ts +9 -0
- package/templates/defense/src/render/palette.ts +12 -5
- package/templates/defense/src/render/postprocessing.ts +32 -12
- package/templates/defense/src/render/quality.ts +170 -0
- package/templates/defense/src/render/shapes.ts +180 -23
- package/templates/defense/src/render/sky.ts +2 -2
- package/templates/defense/src/render/worldEnvironment.ts +758 -0
- package/templates/defense/src/scenes/Boot.ts +2 -2
- package/templates/defense/src/scenes/Defense.ts +122 -56
- package/templates/defense/src/state.ts +6 -0
- package/templates/defense/src/style.css +65 -1
- package/templates/defense/src/towers/Tower.ts +11 -12
- package/templates/defense/src/towers/targeting.ts +1 -1
- package/templates/defense/src/ui/App.tsx +11 -6
- package/templates/defense/src/ui/GameUi.tsx +20 -0
- package/templates/defense/src/ui/Hud.tsx +6 -5
- package/templates/defense/src/ui/main.tsx +14 -0
- package/templates/defense/threenative.config.ts +28 -8
- package/templates/defense/vite.config.ts +34 -1
- package/templates/minimal/.codex/config.toml +19 -0
- package/templates/minimal/.cursor/mcp.json +32 -0
- package/templates/minimal/.gemini/settings.json +32 -0
- package/templates/minimal/.mcp.json +18 -2
- package/templates/minimal/.vscode/mcp.json +36 -0
- package/templates/minimal/.zed/settings.json +36 -0
- package/templates/minimal/AGENTS.md +78 -382
- package/templates/minimal/CLAUDE.md +78 -382
- package/templates/minimal/index.html +0 -1
- package/templates/minimal/opencode.json +41 -0
- package/templates/minimal/package.json +14 -11
- package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
- package/templates/minimal/playtests/play.playtest.json +18 -5
- package/templates/minimal/playtests/survives.playtest.json +48 -4
- package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
- package/templates/minimal/src/conventions.ts +18 -0
- package/templates/minimal/src/entities/Player.ts +39 -6
- package/templates/minimal/src/game.ts +1 -0
- package/templates/minimal/src/main.ts +14 -4
- package/templates/minimal/src/render/camera.ts +1 -1
- package/templates/minimal/src/render/hud.ts +24 -8
- package/templates/minimal/src/render/lighting.ts +23 -2
- package/templates/minimal/src/render/loading.ts +23 -103
- package/templates/minimal/src/render/materials.ts +7 -0
- package/templates/minimal/src/render/palette.ts +3 -3
- package/templates/minimal/src/render/postprocessing.ts +55 -16
- package/templates/minimal/src/render/quality.ts +162 -0
- package/templates/minimal/src/render/sky.ts +51 -32
- package/templates/minimal/src/render/touch-controls.ts +165 -0
- package/templates/minimal/src/render/worldEnvironment.ts +758 -0
- package/templates/minimal/src/scenes/Play.ts +128 -14
- package/templates/minimal/src/state.ts +8 -1
- package/templates/minimal/src/style.css +20 -0
- package/templates/minimal/threenative.config.ts +22 -10
- package/templates/minimal/vite.config.ts +28 -1
- package/templates/platformer/.codex/config.toml +19 -0
- package/templates/platformer/.cursor/mcp.json +32 -0
- package/templates/platformer/.gemini/settings.json +32 -0
- package/templates/platformer/.mcp.json +18 -2
- package/templates/platformer/.vscode/mcp.json +36 -0
- package/templates/platformer/.zed/settings.json +36 -0
- package/templates/platformer/AGENTS.md +81 -186
- package/templates/platformer/CLAUDE.md +81 -186
- package/templates/platformer/index.html +0 -1
- package/templates/platformer/opencode.json +41 -0
- package/templates/platformer/package.json +17 -14
- package/templates/platformer/playtests/avoidance.playtest.json +6 -1
- package/templates/platformer/playtests/branding.playtest.json +29 -0
- package/templates/platformer/playtests/buffer.playtest.json +1 -1
- package/templates/platformer/playtests/collect.playtest.json +1 -1
- package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
- package/templates/platformer/playtests/coyote.playtest.json +42 -8
- package/templates/platformer/playtests/damage.playtest.json +4 -1
- package/templates/platformer/playtests/dash.playtest.json +2 -2
- package/templates/platformer/playtests/jump.playtest.json +2 -3
- package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
- package/templates/platformer/playtests/oneway.playtest.json +30 -3
- package/templates/platformer/playtests/performance.playtest.json +7 -5
- package/templates/platformer/playtests/respawn.playtest.json +2 -2
- package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
- package/templates/platformer/playtests/stomp.playtest.json +11 -3
- package/templates/platformer/playtests/survives.playtest.json +31 -0
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +16 -4
- package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
- package/templates/platformer/playtests/touch-controls-web.playtest.json +57 -0
- package/templates/platformer/src/conventions.ts +18 -0
- package/templates/platformer/src/entities/Character.ts +79 -11
- package/templates/platformer/src/entities/Patrol.ts +5 -0
- package/templates/platformer/src/game.ts +27 -2
- package/templates/platformer/src/level/Platform.ts +13 -1
- package/templates/platformer/src/render/lighting.ts +13 -5
- package/templates/platformer/src/render/loading.ts +281 -62
- package/templates/platformer/src/render/palette.ts +4 -1
- package/templates/platformer/src/render/postprocessing.ts +42 -14
- package/templates/platformer/src/render/quality.ts +170 -0
- package/templates/platformer/src/render/touch-controls.ts +54 -36
- package/templates/platformer/src/render/worldEnvironment.ts +758 -0
- package/templates/platformer/src/scenes/Level.ts +97 -32
- package/templates/platformer/src/state.ts +4 -0
- package/templates/platformer/src/style.css +65 -1
- package/templates/platformer/src/ui/App.tsx +9 -4
- package/templates/platformer/src/ui/GameUi.tsx +20 -0
- package/templates/platformer/src/ui/Hud.tsx +6 -5
- package/templates/platformer/src/ui/main.tsx +14 -0
- package/templates/platformer/threenative.config.ts +27 -10
- package/templates/platformer/vite.config.ts +34 -1
- package/templates/puzzle/.codex/config.toml +19 -0
- package/templates/puzzle/.cursor/mcp.json +32 -0
- package/templates/puzzle/.gemini/settings.json +32 -0
- package/templates/puzzle/.mcp.json +32 -0
- package/templates/puzzle/.vscode/mcp.json +36 -0
- package/templates/puzzle/.zed/settings.json +36 -0
- package/templates/puzzle/AGENTS.md +96 -0
- package/templates/puzzle/CLAUDE.md +98 -0
- package/templates/puzzle/README.md +43 -0
- package/templates/puzzle/index.html +12 -0
- package/templates/puzzle/kit.json +7 -0
- package/templates/puzzle/opencode.json +41 -0
- package/templates/puzzle/package.json +50 -0
- package/templates/puzzle/playtests/carry.playtest.json +71 -0
- package/templates/puzzle/playtests/performance.playtest.json +23 -0
- package/templates/puzzle/playtests/survives.playtest.json +51 -0
- package/templates/puzzle/playtests/swing.playtest.json +38 -0
- package/templates/puzzle/public/favicon.svg +5 -0
- package/templates/puzzle/src/conventions.ts +25 -0
- package/templates/puzzle/src/entities/Ball.ts +70 -0
- package/templates/puzzle/src/entities/Crate.ts +76 -0
- package/templates/puzzle/src/entities/Gripper.ts +69 -0
- package/templates/puzzle/src/entities/Pendulum.ts +89 -0
- package/templates/puzzle/src/game.ts +48 -0
- package/templates/puzzle/src/main.ts +15 -0
- package/templates/puzzle/src/physics.ts +19 -0
- package/templates/puzzle/src/render/camera.ts +37 -0
- package/templates/puzzle/src/render/lighting.ts +55 -0
- package/templates/puzzle/src/render/loading.ts +325 -0
- package/templates/puzzle/src/render/materials.ts +28 -0
- package/templates/puzzle/src/render/palette.ts +31 -0
- package/templates/puzzle/src/render/postprocessing.ts +34 -0
- package/templates/puzzle/src/render/quality.ts +170 -0
- package/templates/puzzle/src/render/shapes.ts +134 -0
- package/templates/puzzle/src/render/sky.ts +16 -0
- package/templates/puzzle/src/render/touch-controls.ts +185 -0
- package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
- package/templates/puzzle/src/room.ts +83 -0
- package/templates/puzzle/src/scenes/Boot.ts +12 -0
- package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
- package/templates/puzzle/src/state.ts +30 -0
- package/templates/puzzle/src/style.css +96 -0
- package/templates/puzzle/src/ui/App.tsx +22 -0
- package/templates/puzzle/src/ui/GameUi.tsx +20 -0
- package/templates/puzzle/src/ui/Hud.tsx +57 -0
- package/templates/puzzle/src/ui/Menu.tsx +7 -0
- package/templates/puzzle/src/ui/main.tsx +14 -0
- package/templates/puzzle/tailwind.config.ts +1 -0
- package/templates/puzzle/threenative.config.ts +49 -0
- package/templates/puzzle/tsconfig.json +17 -0
- package/templates/puzzle/vite.config.ts +38 -0
- package/templates/racing/.codex/config.toml +19 -0
- package/templates/racing/.cursor/mcp.json +32 -0
- package/templates/racing/.gemini/settings.json +32 -0
- package/templates/racing/.mcp.json +18 -2
- package/templates/racing/.vscode/mcp.json +36 -0
- package/templates/racing/.zed/settings.json +36 -0
- package/templates/racing/AGENTS.md +84 -36
- package/templates/racing/CLAUDE.md +84 -36
- package/templates/racing/index.html +0 -1
- package/templates/racing/native-playtests/survives.playtest.json +43 -0
- package/templates/racing/opencode.json +41 -0
- package/templates/racing/package.json +17 -12
- package/templates/racing/playtests/boost.playtest.json +5 -5
- package/templates/racing/playtests/outcome.playtest.json +14 -4
- package/templates/racing/playtests/performance.playtest.json +39 -0
- package/templates/racing/playtests/ranking.playtest.json +2 -2
- package/templates/racing/playtests/rescue.playtest.json +12 -6
- package/templates/racing/playtests/reverse.playtest.json +3 -3
- package/templates/racing/playtests/shortcut.playtest.json +3 -3
- package/templates/racing/playtests/survives.playtest.json +36 -4
- package/templates/racing/playtests/touch-controls.playtest.json +41 -0
- package/templates/racing/src/conventions.ts +6 -0
- package/templates/racing/src/entities/RacingCar.ts +16 -4
- package/templates/racing/src/entities/Rival.ts +5 -2
- package/templates/racing/src/game.ts +24 -1
- package/templates/racing/src/render/camera.ts +15 -8
- package/templates/racing/src/render/lighting.ts +28 -14
- package/templates/racing/src/render/loading.ts +302 -35
- package/templates/racing/src/render/materials.ts +54 -4
- package/templates/racing/src/render/palette.ts +23 -6
- package/templates/racing/src/render/postprocessing.ts +32 -12
- package/templates/racing/src/render/quality.ts +170 -0
- package/templates/racing/src/render/shapes.ts +537 -26
- package/templates/racing/src/render/sky.ts +5 -2
- package/templates/racing/src/render/touch-controls.ts +185 -0
- package/templates/racing/src/render/worldEnvironment.ts +758 -0
- package/templates/racing/src/scenes/Race.ts +84 -37
- package/templates/racing/src/state.ts +4 -0
- package/templates/racing/src/style.css +65 -1
- package/templates/racing/src/track/Lap.ts +20 -9
- package/templates/racing/src/track/Ranking.ts +53 -14
- package/templates/racing/src/track/Track.ts +284 -32
- package/templates/racing/src/track/TrackSector.ts +14 -4
- package/templates/racing/src/ui/App.tsx +9 -4
- package/templates/racing/src/ui/GameUi.tsx +20 -0
- package/templates/racing/src/ui/Hud.tsx +6 -5
- package/templates/racing/src/ui/main.tsx +14 -0
- package/templates/racing/threenative.config.ts +28 -8
- package/templates/racing/vite.config.ts +34 -1
- package/templates/runner/.codex/config.toml +19 -0
- package/templates/runner/.cursor/mcp.json +32 -0
- package/templates/runner/.gemini/settings.json +32 -0
- package/templates/runner/.mcp.json +32 -0
- package/templates/runner/.vscode/mcp.json +36 -0
- package/templates/runner/.zed/settings.json +36 -0
- package/templates/runner/AGENTS.md +96 -0
- package/templates/runner/CLAUDE.md +98 -0
- package/templates/runner/README.md +43 -0
- package/templates/runner/index.html +12 -0
- package/templates/runner/kit.json +7 -0
- package/templates/runner/opencode.json +41 -0
- package/templates/runner/package.json +50 -0
- package/templates/runner/playtests/performance.playtest.json +23 -0
- package/templates/runner/playtests/streams.playtest.json +38 -0
- package/templates/runner/playtests/survives.playtest.json +51 -0
- package/templates/runner/public/favicon.svg +5 -0
- package/templates/runner/src/conventions.ts +24 -0
- package/templates/runner/src/entities/Runner.ts +135 -0
- package/templates/runner/src/game.ts +50 -0
- package/templates/runner/src/main.ts +15 -0
- package/templates/runner/src/physics.ts +13 -0
- package/templates/runner/src/render/camera.ts +39 -0
- package/templates/runner/src/render/dust.ts +131 -0
- package/templates/runner/src/render/lighting.ts +57 -0
- package/templates/runner/src/render/loading.ts +325 -0
- package/templates/runner/src/render/materials.ts +27 -0
- package/templates/runner/src/render/palette.ts +30 -0
- package/templates/runner/src/render/postprocessing.ts +34 -0
- package/templates/runner/src/render/quality.ts +170 -0
- package/templates/runner/src/render/shapes.ts +68 -0
- package/templates/runner/src/render/sky.ts +51 -0
- package/templates/runner/src/render/touch-controls.ts +185 -0
- package/templates/runner/src/render/worldEnvironment.ts +758 -0
- package/templates/runner/src/scenes/Boot.ts +12 -0
- package/templates/runner/src/scenes/Run.ts +142 -0
- package/templates/runner/src/state.ts +29 -0
- package/templates/runner/src/style.css +96 -0
- package/templates/runner/src/track.ts +176 -0
- package/templates/runner/src/ui/App.tsx +22 -0
- package/templates/runner/src/ui/GameUi.tsx +20 -0
- package/templates/runner/src/ui/Hud.tsx +55 -0
- package/templates/runner/src/ui/Menu.tsx +7 -0
- package/templates/runner/src/ui/main.tsx +14 -0
- package/templates/runner/tailwind.config.ts +1 -0
- package/templates/runner/threenative.config.ts +49 -0
- package/templates/runner/tsconfig.json +17 -0
- package/templates/runner/vite.config.ts +38 -0
- package/templates/sailing/.codex/config.toml +19 -0
- package/templates/sailing/.cursor/mcp.json +32 -0
- package/templates/sailing/.gemini/settings.json +32 -0
- package/templates/sailing/.mcp.json +32 -0
- package/templates/sailing/.vscode/mcp.json +36 -0
- package/templates/sailing/.zed/settings.json +36 -0
- package/templates/sailing/AGENTS.md +95 -0
- package/templates/sailing/CLAUDE.md +97 -0
- package/templates/sailing/README.md +28 -0
- package/templates/sailing/index.html +12 -0
- package/templates/sailing/kit.json +7 -0
- package/templates/sailing/native-playtests/float.playtest.json +55 -0
- package/templates/sailing/native-playtests/survives.playtest.json +38 -0
- package/templates/sailing/opencode.json +41 -0
- package/templates/sailing/package.json +52 -0
- package/templates/sailing/playtests/fail.playtest.json +24 -0
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
- package/templates/sailing/playtests/float.playtest.json +59 -0
- package/templates/sailing/playtests/performance.playtest.json +36 -0
- package/templates/sailing/playtests/survives.playtest.json +46 -0
- package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
- package/templates/sailing/playtests/win.playtest.json +31 -0
- package/templates/sailing/public/favicon.svg +5 -0
- package/templates/sailing/src/conventions.ts +8 -0
- package/templates/sailing/src/entities/Ship.ts +233 -0
- package/templates/sailing/src/game.ts +40 -0
- package/templates/sailing/src/main.ts +15 -0
- package/templates/sailing/src/render/camera.ts +28 -0
- package/templates/sailing/src/render/lighting.ts +41 -0
- package/templates/sailing/src/render/loading.ts +325 -0
- package/templates/sailing/src/render/materials.ts +44 -0
- package/templates/sailing/src/render/ocean.ts +179 -0
- package/templates/sailing/src/render/palette.ts +17 -0
- package/templates/sailing/src/render/postprocessing.ts +34 -0
- package/templates/sailing/src/render/props.ts +602 -0
- package/templates/sailing/src/render/quality.ts +140 -0
- package/templates/sailing/src/render/sky.ts +37 -0
- package/templates/sailing/src/render/touch-controls.ts +142 -0
- package/templates/sailing/src/render/worldEnvironment.ts +758 -0
- package/templates/sailing/src/scenes/Boot.ts +12 -0
- package/templates/sailing/src/scenes/Sailing.ts +133 -0
- package/templates/sailing/src/state.ts +10 -0
- package/templates/sailing/src/style.css +81 -0
- package/templates/sailing/src/ui/App.tsx +15 -0
- package/templates/sailing/src/ui/GameUi.tsx +12 -0
- package/templates/sailing/src/ui/Hud.tsx +55 -0
- package/templates/sailing/src/ui/Menu.tsx +30 -0
- package/templates/sailing/src/ui/main.tsx +7 -0
- package/templates/sailing/tailwind.config.ts +2 -0
- package/templates/sailing/threenative.config.ts +40 -0
- package/templates/sailing/tsconfig.json +17 -0
- package/templates/sailing/vite.config.ts +34 -0
- package/templates/shooter/.codex/config.toml +19 -0
- package/templates/shooter/.cursor/mcp.json +32 -0
- package/templates/shooter/.gemini/settings.json +32 -0
- package/templates/shooter/.mcp.json +18 -2
- package/templates/shooter/.vscode/mcp.json +36 -0
- package/templates/shooter/.zed/settings.json +36 -0
- package/templates/shooter/AGENTS.md +81 -54
- package/templates/shooter/CLAUDE.md +81 -54
- package/templates/shooter/index.html +0 -1
- package/templates/shooter/kit.json +2 -2
- package/templates/shooter/opencode.json +41 -0
- package/templates/shooter/package.json +16 -11
- package/templates/shooter/playtests/combat.playtest.json +48 -0
- package/templates/shooter/playtests/fail.playtest.json +5 -4
- package/templates/shooter/playtests/input-control.playtest.json +261 -0
- package/templates/shooter/playtests/per-item.playtest.json +59 -0
- package/templates/shooter/playtests/performance.playtest.json +39 -0
- package/templates/shooter/playtests/shooter.playtest.json +31 -21
- package/templates/shooter/playtests/survives.playtest.json +28 -1
- package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
- package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
- package/templates/shooter/public/favicon.svg +1 -1
- package/templates/shooter/src/combat/damage.ts +1 -2
- package/templates/shooter/src/conventions.ts +51 -0
- package/templates/shooter/src/entities/Player.ts +235 -18
- package/templates/shooter/src/entities/Target.ts +2 -2
- package/templates/shooter/src/game.ts +35 -3
- package/templates/shooter/src/main.ts +3 -13
- package/templates/shooter/src/render/camera.ts +78 -18
- package/templates/shooter/src/render/decals.ts +211 -0
- package/templates/shooter/src/render/lighting.ts +13 -4
- package/templates/shooter/src/render/loading.ts +274 -35
- package/templates/shooter/src/render/materials.ts +56 -3
- package/templates/shooter/src/render/palette.ts +6 -3
- package/templates/shooter/src/render/postprocessing.ts +32 -17
- package/templates/shooter/src/render/quality.ts +170 -0
- package/templates/shooter/src/render/scale.ts +22 -0
- package/templates/shooter/src/render/shapes.ts +519 -60
- package/templates/shooter/src/render/sky.ts +5 -1
- package/templates/shooter/src/render/touch-controls.ts +305 -0
- package/templates/shooter/src/render/ui.css +119 -1
- package/templates/shooter/src/render/ui.ts +19 -3
- package/templates/shooter/src/render/vfx.ts +215 -0
- package/templates/shooter/src/render/worldEnvironment.ts +758 -0
- package/templates/shooter/src/scenes/Play.ts +385 -97
- package/templates/shooter/src/state.ts +18 -0
- package/templates/shooter/src/style.css +46 -0
- package/templates/shooter/src/ui/App.tsx +10 -12
- package/templates/shooter/src/ui/Crosshair.tsx +25 -0
- package/templates/shooter/src/ui/GameUi.tsx +22 -0
- package/templates/shooter/src/ui/Hud.tsx +14 -10
- package/templates/shooter/src/ui/Menu.tsx +24 -9
- package/templates/shooter/src/ui/main.tsx +15 -0
- package/templates/shooter/src/weapons/Hitscan.ts +3 -4
- package/templates/shooter/src/weapons/Projectile.ts +29 -13
- package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
- package/templates/shooter/threenative.config.ts +28 -8
- package/templates/shooter/vite.config.ts +32 -2
- package/templates/starter/.codex/config.toml +19 -0
- package/templates/starter/.cursor/mcp.json +32 -0
- package/templates/starter/.gemini/settings.json +32 -0
- package/templates/starter/.mcp.json +18 -2
- package/templates/starter/.vscode/mcp.json +36 -0
- package/templates/starter/.zed/settings.json +36 -0
- package/templates/starter/AGENTS.md +72 -426
- package/templates/starter/CLAUDE.md +72 -426
- package/templates/starter/assets/pickup.wav +0 -0
- package/templates/starter/gitignore +4 -0
- package/templates/starter/index.html +0 -1
- package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
- package/templates/starter/native-playtests/render-chain.playtest.json +81 -0
- package/templates/starter/opencode.json +41 -0
- package/templates/starter/package.json +16 -12
- package/templates/starter/playtests/assets.playtest.json +65 -0
- package/templates/starter/playtests/boot-failure.playtest.json +45 -0
- package/templates/starter/playtests/buffer.playtest.json +59 -9
- package/templates/starter/playtests/cloth.playtest.json +113 -0
- package/templates/starter/playtests/coyote.playtest.json +60 -8
- package/templates/starter/playtests/forward.playtest.json +29 -4
- package/templates/starter/playtests/gameover.playtest.json +66 -0
- package/templates/starter/playtests/goal.playtest.json +67 -0
- package/templates/starter/playtests/hot-reload.playtest.json +48 -8
- package/templates/starter/playtests/look.playtest.json +142 -10
- package/templates/starter/playtests/models-baseline.png +0 -0
- package/templates/starter/playtests/models.playtest.json +74 -0
- package/templates/starter/playtests/monitoring.playtest.json +38 -7
- package/templates/starter/playtests/odometer.playtest.json +54 -0
- package/templates/starter/playtests/pause.playtest.json +27 -4
- package/templates/starter/playtests/play.playtest.json +44 -7
- package/templates/starter/playtests/respawn.playtest.json +46 -6
- package/templates/starter/playtests/restart.playtest.json +65 -10
- package/templates/starter/playtests/seed.playtest.json +44 -8
- package/templates/starter/playtests/survives.playtest.json +48 -4
- package/templates/starter/playtests/textures-baseline.png +0 -0
- package/templates/starter/playtests/textures.playtest.json +74 -0
- package/templates/starter/playtests/touch-controls.playtest.json +42 -0
- package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
- package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
- package/templates/starter/src/conventions.ts +18 -0
- package/templates/starter/src/entities/Goal.ts +137 -0
- package/templates/starter/src/entities/Player.ts +111 -10
- package/templates/starter/src/game.ts +27 -0
- package/templates/starter/src/render/adaptiveQuality.ts +195 -0
- package/templates/starter/src/render/camera.ts +31 -5
- package/templates/starter/src/render/coast.ts +199 -0
- package/templates/starter/src/render/easing.ts +5 -0
- package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
- package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
- package/templates/starter/src/render/effects/sparkle.ts +49 -0
- package/templates/starter/src/render/hero.ts +88 -0
- package/templates/starter/src/render/implicitSurface.ts +199 -0
- package/templates/starter/src/render/kuwahara.ts +174 -0
- package/templates/starter/src/render/lighting.ts +10 -5
- package/templates/starter/src/render/loading.ts +325 -0
- package/templates/starter/src/render/materials.ts +39 -4
- package/templates/starter/src/render/outline.ts +141 -0
- package/templates/starter/src/render/painterly.ts +86 -0
- package/templates/starter/src/render/palette.ts +15 -6
- package/templates/starter/src/render/pennant.ts +54 -0
- package/templates/starter/src/render/postprocessing.ts +97 -15
- package/templates/starter/src/render/quality.ts +185 -0
- package/templates/starter/src/render/rockRidge.ts +198 -0
- package/templates/starter/src/render/rockRidge.worker.ts +77 -0
- package/templates/starter/src/render/scenery.ts +40 -0
- package/templates/starter/src/render/shapes.ts +9 -21
- package/templates/starter/src/render/textureLifetime.ts +53 -0
- package/templates/starter/src/render/touch-controls.ts +165 -0
- package/templates/starter/src/render/water.ts +38 -0
- package/templates/starter/src/render/watercolor.ts +85 -0
- package/templates/starter/src/render/worldEnvironment.ts +758 -0
- package/templates/starter/src/scenes/Play.ts +243 -46
- package/templates/starter/src/state.ts +12 -0
- package/templates/starter/src/style.css +72 -8
- package/templates/starter/src/ui/App.tsx +9 -6
- package/templates/starter/src/ui/GameUi.tsx +20 -0
- package/templates/starter/src/ui/Hud.tsx +52 -29
- package/templates/starter/src/ui/Menu.tsx +25 -23
- package/templates/starter/src/ui/main.tsx +14 -0
- package/templates/starter/threenative.config.ts +27 -9
- package/templates/starter/tools/look.mjs +109 -0
- package/templates/starter/vite.config.ts +32 -2
- package/templates/action-rpg/src/physics.ts +0 -40
- package/templates/minimal/assets/.gitkeep +0 -0
- package/templates/minimal/public/.gitkeep +0 -0
- package/templates/minimal/public/icon.png +0 -0
- package/templates/platformer/assets/.gitkeep +0 -0
- package/templates/platformer/public/.gitkeep +0 -0
- package/templates/platformer/public/icon.png +0 -0
- package/templates/shooter/src/physics.ts +0 -49
- package/templates/starter/assets/.gitkeep +0 -0
- package/templates/starter/public/.gitkeep +0 -0
- package/templates/starter/public/icon.png +0 -0
- package/templates/starter/public/pickup.ogg +0 -0
- /package/templates/starter/{public → assets}/native-proof.glb +0 -0
- /package/templates/starter/{public → assets}/native-proof.png +0 -0
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
// Generated for you: ordinary Three.js; ThreeNative does not read this file. Delete or rewrite
|
|
2
|
+
// it freely — the tiers below are a starting point, not a framework look.
|
|
3
|
+
//
|
|
4
|
+
// This is the one place this game decides how expensive it looks. `postprocessing.ts` reads
|
|
5
|
+
// `qualityPreset(resolveQualityTier(...))` and nothing else, so "make it run on a phone" is one
|
|
6
|
+
// file to edit rather than a hunt through anonymous literals.
|
|
7
|
+
//
|
|
8
|
+
// **Where the numbers come from.** Every millisecond below is GPU time from the per-stage
|
|
9
|
+
// ablation recorded in the engine repository's `docs/verification/runtime-perf-state.md`: Chrome
|
|
10
|
+
// on an RTX 2080, 1600x900, static build, `gpuMs` read from three's `timestamp-query`. In that
|
|
11
|
+
// scene the whole five-stage chain costs **12.5 ms of a 14.7 ms GPU frame**, and the same frame
|
|
12
|
+
// with every stage off costs **2.2 ms**. The per-stage figures oversum — removing SSGI also
|
|
13
|
+
// removes the denoise passes the later stages sample — so read each as *what turning this one off
|
|
14
|
+
// gave back*, not as a share of a partition. A stage nobody has ablated on its own says
|
|
15
|
+
// `unmeasured` rather than guessing, and your scene is not that scene: read `TN_FRAME_BUDGET`
|
|
16
|
+
// back after you change a tier.
|
|
17
|
+
//
|
|
18
|
+
// One cost that is **not** a stage here and outweighs most of them: the prefiltered reflection
|
|
19
|
+
// probe on `scene.environment`, measured at **~6.3 ms of an 18-19 ms Pixel 8 frame**. It is set
|
|
20
|
+
// in `sky.ts`, not in this file.
|
|
21
|
+
//
|
|
22
|
+
// **This template runs no SSGI at any tier, and that is a measurement rather than a taste.** Its
|
|
23
|
+
// sky, sun colour and depth haze are a volumetric `Atmosphere`, which already owns most of the
|
|
24
|
+
// frame. With the gather on, `playtests/play.playtest.json` measured **34.2 ms p95 against the
|
|
25
|
+
// 33 ms ceiling**; without it the same scenario passes. Turn it on when you replace the
|
|
26
|
+
// atmosphere with a flat sky, and read the p95 back out of `TN_FRAME_BUDGET`.
|
|
27
|
+
import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
|
|
28
|
+
|
|
29
|
+
/**
|
|
30
|
+
* The three names this game's look comes in.
|
|
31
|
+
*
|
|
32
|
+
* `low` is what a phone gets and `high` what a desktop gets — those two are this template's
|
|
33
|
+
* shipped looks, unchanged. `medium` is the rung in between for a machine that is neither: a
|
|
34
|
+
* laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
|
|
35
|
+
* what any of them mean.
|
|
36
|
+
*/
|
|
37
|
+
export type QualityTier = "low" | "medium" | "high";
|
|
38
|
+
|
|
39
|
+
const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
|
|
43
|
+
* `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
|
|
44
|
+
*/
|
|
45
|
+
function isQualityTier(value: string): value is QualityTier {
|
|
46
|
+
return (QUALITY_TIERS as readonly string[]).includes(value);
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/**
|
|
50
|
+
* Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
|
|
51
|
+
*
|
|
52
|
+
* Fails closed. An unrecognised tier name throws with the value it was handed rather than
|
|
53
|
+
* quietly rendering the default, because a silent fallback here looks exactly like a tier that
|
|
54
|
+
* turned out to have no effect.
|
|
55
|
+
*/
|
|
56
|
+
export function resolveQualityTier(
|
|
57
|
+
request: { readonly mobile?: boolean; readonly tier?: string } = {},
|
|
58
|
+
): QualityTier {
|
|
59
|
+
const requested = request.tier;
|
|
60
|
+
if (requested !== undefined) {
|
|
61
|
+
if (!isQualityTier(requested)) {
|
|
62
|
+
throw new Error(
|
|
63
|
+
`Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
64
|
+
);
|
|
65
|
+
}
|
|
66
|
+
return requested;
|
|
67
|
+
}
|
|
68
|
+
return request.mobile === true ? "low" : "high";
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* What a desktop gets: this template's shipped desktop look, unchanged.
|
|
73
|
+
*
|
|
74
|
+
* The whole chain measured 12.5 ms of a 14.7 ms GPU frame in the reference ablation, and SSGI
|
|
75
|
+
* with its denoiser is ~9.2 ms of that.
|
|
76
|
+
*/
|
|
77
|
+
const high: IWorldEnvironmentOptions = {
|
|
78
|
+
// Strength, radius and threshold are a look decision already tuned to this scene's palette.
|
|
79
|
+
// Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
|
|
80
|
+
// to be.
|
|
81
|
+
bloomEnabled: true,
|
|
82
|
+
bloomRadius: 0.5,
|
|
83
|
+
bloomStrength: 0.5,
|
|
84
|
+
bloomThreshold: 0.2,
|
|
85
|
+
exposure: 1.15,
|
|
86
|
+
// Screen-space reflections: ~4.1 ms.
|
|
87
|
+
ssrEnabled: true,
|
|
88
|
+
// `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
|
|
89
|
+
// are on and do nothing" — the ray dies a metre from where it started.
|
|
90
|
+
ssrMaxDistance: 20,
|
|
91
|
+
// A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
|
|
92
|
+
// the rays and is very hard to see in the result.
|
|
93
|
+
ssrResolutionScale: 0.5,
|
|
94
|
+
// RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
|
|
95
|
+
// denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
|
|
96
|
+
// that runs one of them.
|
|
97
|
+
sharpenEnabled: true,
|
|
98
|
+
// **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
|
|
99
|
+
sharpenStrength: 0.3,
|
|
100
|
+
tonemapMode: "aces",
|
|
101
|
+
};
|
|
102
|
+
|
|
103
|
+
/**
|
|
104
|
+
* The rung in between. With no SSGI to drop, the reflection is the only stage large enough to be
|
|
105
|
+
* worth halving, so `medium` traces it at a quarter resolution instead of a half — a quarter of
|
|
106
|
+
* the rays. The saving is **unmeasured**: the ablation measured SSR on and off, not SSR at two
|
|
107
|
+
* scales.
|
|
108
|
+
*/
|
|
109
|
+
const medium: IWorldEnvironmentOptions = {
|
|
110
|
+
// Strength, radius and threshold are a look decision already tuned to this scene's palette.
|
|
111
|
+
// Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
|
|
112
|
+
// to be.
|
|
113
|
+
bloomEnabled: true,
|
|
114
|
+
bloomRadius: 0.5,
|
|
115
|
+
bloomStrength: 0.5,
|
|
116
|
+
bloomThreshold: 0.2,
|
|
117
|
+
exposure: 1.15,
|
|
118
|
+
// Screen-space reflections: ~4.1 ms.
|
|
119
|
+
ssrEnabled: true,
|
|
120
|
+
// `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
|
|
121
|
+
// are on and do nothing" — the ray dies a metre from where it started.
|
|
122
|
+
ssrMaxDistance: 20,
|
|
123
|
+
// A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
|
|
124
|
+
// the rays and is very hard to see in the result.
|
|
125
|
+
ssrResolutionScale: 0.25,
|
|
126
|
+
// RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
|
|
127
|
+
// denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
|
|
128
|
+
// that runs one of them.
|
|
129
|
+
sharpenEnabled: true,
|
|
130
|
+
// **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
|
|
131
|
+
sharpenStrength: 0.3,
|
|
132
|
+
tonemapMode: "aces",
|
|
133
|
+
};
|
|
134
|
+
|
|
135
|
+
/**
|
|
136
|
+
* What a phone gets: this template's shipped mobile look, unchanged. Bloom and the tone curve,
|
|
137
|
+
* nothing screen-space. The ablation's floor — every stage off — was 2.2 ms.
|
|
138
|
+
*/
|
|
139
|
+
const low: IWorldEnvironmentOptions = {
|
|
140
|
+
// Strength, radius and threshold are a look decision already tuned to this scene's palette.
|
|
141
|
+
// Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
|
|
142
|
+
// to be.
|
|
143
|
+
bloomEnabled: true,
|
|
144
|
+
bloomRadius: 0.5,
|
|
145
|
+
bloomStrength: 0.5,
|
|
146
|
+
bloomThreshold: 0.2,
|
|
147
|
+
exposure: 1.15,
|
|
148
|
+
tonemapMode: "aces",
|
|
149
|
+
};
|
|
150
|
+
|
|
151
|
+
const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
|
|
152
|
+
|
|
153
|
+
/** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
|
|
154
|
+
export function qualityPreset(tier: string): IWorldEnvironmentOptions {
|
|
155
|
+
const preset = QUALITY_PRESETS[tier as QualityTier];
|
|
156
|
+
if (preset === undefined) {
|
|
157
|
+
throw new Error(
|
|
158
|
+
`Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
159
|
+
);
|
|
160
|
+
}
|
|
161
|
+
return preset;
|
|
162
|
+
}
|
|
@@ -1,41 +1,60 @@
|
|
|
1
|
-
// Generated for you.
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
MathUtils,
|
|
8
|
-
Mesh,
|
|
9
|
-
MeshBasicMaterial,
|
|
10
|
-
type Scene,
|
|
11
|
-
SphereGeometry,
|
|
12
|
-
} from "three";
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
// The atmosphere object is mechanism; this file owns the mesh, material, and exposure.
|
|
3
|
+
import { BackSide, Color, Mesh, type Scene, SphereGeometry } from "three";
|
|
4
|
+
import { cameraPosition, normalize, positionWorld } from "three/tsl";
|
|
5
|
+
import { MeshBasicNodeMaterial } from "three/webgpu";
|
|
6
|
+
import type { Node } from "three/webgpu";
|
|
13
7
|
import { palette } from "./palette.js";
|
|
14
8
|
|
|
15
|
-
|
|
9
|
+
type AtmosphereLike = {
|
|
10
|
+
radiance(direction: unknown): unknown;
|
|
11
|
+
};
|
|
12
|
+
|
|
13
|
+
export function setupSky(scene: Scene, atmosphere?: AtmosphereLike): void {
|
|
16
14
|
const top = new Color(palette.skyHigh);
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
const colors = new Float32Array(positions.count * 3);
|
|
22
|
-
const color = new Color();
|
|
23
|
-
for (let index = 0; index < positions.count; index += 1) {
|
|
24
|
-
const height = MathUtils.clamp((positions.getY(index) / radius + 0.2) / 0.65, 0, 1);
|
|
25
|
-
color.copy(bottom).lerp(top, height);
|
|
26
|
-
colors.set([color.r, color.g, color.b], index * 3);
|
|
15
|
+
if (atmosphere === undefined) {
|
|
16
|
+
scene.background = top;
|
|
17
|
+
scene.fog = null;
|
|
18
|
+
return;
|
|
27
19
|
}
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
// The
|
|
34
|
-
//
|
|
20
|
+
|
|
21
|
+
// Outside the deliberately kilometre-scale atmosphere probe in Play.ts, and **inside** the
|
|
22
|
+
// camera's far plane. The view-space depth remains metres, so the package can apply its
|
|
23
|
+
// supplied 1/km coefficients.
|
|
24
|
+
//
|
|
25
|
+
// The radius was 20 000 against `camera.far = 20_000`, which leaves the `BackSide` hemisphere
|
|
26
|
+
// sitting exactly on the far plane. Pulled in to 16 000 it has room; measured, this was not
|
|
27
|
+
// what was making the sky black — see the multiplier below — but a dome flush with the far
|
|
28
|
+
// plane is one renderer tolerance away from being clipped, so it stays pulled in.
|
|
29
|
+
const geometry = new SphereGeometry(16_000, 24, 12);
|
|
30
|
+
const material = new MeshBasicNodeMaterial({
|
|
31
|
+
fog: false,
|
|
32
|
+
side: BackSide,
|
|
33
|
+
toneMapped: false,
|
|
34
|
+
});
|
|
35
|
+
const viewDirection = normalize(positionWorld.sub(cameraPosition));
|
|
36
|
+
// Exposure for the dome alone.
|
|
37
|
+
//
|
|
38
|
+
// 24 was authored when this template had no post chain, so the dome's radiance landed straight
|
|
39
|
+
// in the frame; the chain now exposes the pass at 1.15 and tone-maps it with ACES. A previous
|
|
40
|
+
// pass measured 203 of 255 at 24 and 25 at 1.5, and chose 1.5 because it matched "this
|
|
41
|
+
// template's last good baseline" of 22. That baseline was the problem: **22 of 255 is not a
|
|
42
|
+
// sky**, it is a black rectangle above the horizon, and it is what the smallest template showed
|
|
43
|
+
// a new project on its first frame with a sun fifty degrees up and a correctly-scattering
|
|
44
|
+
// atmosphere behind it.
|
|
45
|
+
//
|
|
46
|
+
// 8 lands the daytime sky around a hundred, which is a sky. Raising it further starts to blow
|
|
47
|
+
// the horizon out under ACES. This multiplier scales the dome and nothing else — the
|
|
48
|
+
// in-scattering `aerialPerspective` receives in postprocessing.ts comes from its own call and
|
|
49
|
+
// is unaffected, so this cannot double-count the way the old note feared.
|
|
50
|
+
material.colorNode = (atmosphere.radiance(viewDirection) as Node<"vec3">).mul(8);
|
|
51
|
+
const dome = new Mesh(geometry, material);
|
|
52
|
+
// The dome is authored at the origin and never moves; freeze only this known-static render
|
|
53
|
+
// object, leaving gameplay transforms under user control.
|
|
35
54
|
dome.updateMatrix();
|
|
36
55
|
dome.matrixAutoUpdate = false;
|
|
37
56
|
dome.frustumCulled = false;
|
|
38
|
-
scene.background =
|
|
39
|
-
scene.fog =
|
|
57
|
+
scene.background = null;
|
|
58
|
+
scene.fog = null;
|
|
40
59
|
scene.add(dome);
|
|
41
60
|
}
|
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
import {
|
|
2
|
+
CircleGeometry,
|
|
3
|
+
type ColorRepresentation,
|
|
4
|
+
Group,
|
|
5
|
+
MathUtils,
|
|
6
|
+
Mesh,
|
|
7
|
+
MeshBasicMaterial,
|
|
8
|
+
type PerspectiveCamera,
|
|
9
|
+
RingGeometry,
|
|
10
|
+
Vector2,
|
|
11
|
+
} from "three";
|
|
12
|
+
import { palette } from "./palette.js";
|
|
13
|
+
|
|
14
|
+
const MOVE_RADIUS = 72;
|
|
15
|
+
const BUTTON_RADIUS = 62;
|
|
16
|
+
const EDGE = 36;
|
|
17
|
+
|
|
18
|
+
export interface ITouchPointer {
|
|
19
|
+
readonly position: Vector2;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export interface ITouchViewport {
|
|
23
|
+
readonly height: number;
|
|
24
|
+
readonly width: number;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export interface ITouchInput {
|
|
28
|
+
readonly jumpPressed: boolean;
|
|
29
|
+
readonly move: Vector2;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
function overlayMaterial(color: ColorRepresentation, opacity: number): MeshBasicMaterial {
|
|
33
|
+
return new MeshBasicMaterial({
|
|
34
|
+
color,
|
|
35
|
+
depthTest: false,
|
|
36
|
+
depthWrite: false,
|
|
37
|
+
opacity,
|
|
38
|
+
transparent: true,
|
|
39
|
+
});
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
function ringMesh(radius: number, material: MeshBasicMaterial): Mesh {
|
|
43
|
+
return new Mesh(new RingGeometry(radius - 5, radius, 32), material);
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
function place(mesh: Mesh, point: Vector2): void {
|
|
47
|
+
mesh.position.set(point.x, point.y, 0);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
function controlPoint(size: ITouchViewport, name: "jump" | "move"): Vector2 {
|
|
51
|
+
if (name === "move") return new Vector2(MOVE_RADIUS + EDGE, size.height - MOVE_RADIUS - EDGE);
|
|
52
|
+
return new Vector2(size.width - BUTTON_RADIUS - EDGE, size.height - BUTTON_RADIUS - EDGE);
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
export class TouchControls {
|
|
56
|
+
readonly root = new Group();
|
|
57
|
+
readonly object = this.root;
|
|
58
|
+
#camera: PerspectiveCamera;
|
|
59
|
+
#input: { jumpPressed: boolean; move: Vector2 } = {
|
|
60
|
+
jumpPressed: false,
|
|
61
|
+
move: new Vector2(),
|
|
62
|
+
};
|
|
63
|
+
#wasJump = false;
|
|
64
|
+
#moveAnchor = new Vector2();
|
|
65
|
+
#resting = new Vector2();
|
|
66
|
+
#jumpCenter = new Vector2();
|
|
67
|
+
#hasMoveAnchor = false;
|
|
68
|
+
#lastWidth = -1;
|
|
69
|
+
#lastHeight = -1;
|
|
70
|
+
#moveBase: Mesh;
|
|
71
|
+
#moveKnob: Mesh;
|
|
72
|
+
#jump: Mesh;
|
|
73
|
+
#idleMaterial: MeshBasicMaterial;
|
|
74
|
+
#activeMaterial: MeshBasicMaterial;
|
|
75
|
+
|
|
76
|
+
constructor(camera: PerspectiveCamera) {
|
|
77
|
+
this.#camera = camera;
|
|
78
|
+
this.#idleMaterial = overlayMaterial(palette.shadow, 0.34);
|
|
79
|
+
this.#activeMaterial = overlayMaterial(palette.accent, 0.6);
|
|
80
|
+
this.#moveBase = ringMesh(MOVE_RADIUS, this.#idleMaterial);
|
|
81
|
+
this.#moveKnob = new Mesh(new CircleGeometry(28, 24), this.#activeMaterial);
|
|
82
|
+
this.#jump = ringMesh(BUTTON_RADIUS, this.#idleMaterial);
|
|
83
|
+
this.root.add(this.#moveBase, this.#moveKnob, this.#jump);
|
|
84
|
+
this.root.renderOrder = 10_001;
|
|
85
|
+
camera.add(this.root);
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
update(pointers: ReadonlyMap<number, ITouchPointer>, size: ITouchViewport): ITouchInput {
|
|
89
|
+
this.#ensureLayout(size);
|
|
90
|
+
const jump = this.#at(pointers, this.#jumpCenter, BUTTON_RADIUS);
|
|
91
|
+
let movement: ITouchPointer | undefined;
|
|
92
|
+
for (const pointer of pointers.values()) {
|
|
93
|
+
if (pointer.position.x < size.width * 0.5) {
|
|
94
|
+
movement = pointer;
|
|
95
|
+
break;
|
|
96
|
+
}
|
|
97
|
+
}
|
|
98
|
+
|
|
99
|
+
if (movement === undefined) {
|
|
100
|
+
this.#hasMoveAnchor = false;
|
|
101
|
+
this.#input.move.set(0, 0);
|
|
102
|
+
} else {
|
|
103
|
+
if (!this.#hasMoveAnchor) {
|
|
104
|
+
this.#moveAnchor.copy(movement.position);
|
|
105
|
+
this.#hasMoveAnchor = true;
|
|
106
|
+
}
|
|
107
|
+
this.#input.move.set(
|
|
108
|
+
MathUtils.clamp((movement.position.x - this.#moveAnchor.x) / MOVE_RADIUS, -1, 1),
|
|
109
|
+
MathUtils.clamp((this.#moveAnchor.y - movement.position.y) / MOVE_RADIUS, -1, 1),
|
|
110
|
+
);
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
const center = this.#hasMoveAnchor ? this.#moveAnchor : this.#resting;
|
|
114
|
+
place(
|
|
115
|
+
this.#moveKnob,
|
|
116
|
+
new Vector2(
|
|
117
|
+
center.x + this.#input.move.x * MOVE_RADIUS,
|
|
118
|
+
center.y - this.#input.move.y * MOVE_RADIUS,
|
|
119
|
+
),
|
|
120
|
+
);
|
|
121
|
+
this.#jump.material = jump ? this.#activeMaterial : this.#idleMaterial;
|
|
122
|
+
this.#input.jumpPressed = jump && !this.#wasJump;
|
|
123
|
+
this.#wasJump = jump;
|
|
124
|
+
this.#layout(size);
|
|
125
|
+
return this.#input;
|
|
126
|
+
}
|
|
127
|
+
|
|
128
|
+
debug(): Record<string, unknown> {
|
|
129
|
+
return { jump: this.#wasJump, move: this.#input.move.toArray() };
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
dispose(): void {
|
|
133
|
+
this.root.removeFromParent();
|
|
134
|
+
for (const child of this.root.children) {
|
|
135
|
+
if (child instanceof Mesh) child.geometry.dispose();
|
|
136
|
+
}
|
|
137
|
+
this.#idleMaterial.dispose();
|
|
138
|
+
this.#activeMaterial.dispose();
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
#ensureLayout(size: ITouchViewport): void {
|
|
142
|
+
if (size.width === this.#lastWidth && size.height === this.#lastHeight) return;
|
|
143
|
+
this.#lastWidth = size.width;
|
|
144
|
+
this.#lastHeight = size.height;
|
|
145
|
+
this.#resting.copy(controlPoint(size, "move"));
|
|
146
|
+
this.#jumpCenter.copy(controlPoint(size, "jump"));
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
#layout(size: ITouchViewport): void {
|
|
150
|
+
const worldHeight = 2 * Math.tan(MathUtils.degToRad(this.#camera.fov / 2));
|
|
151
|
+
const pixels = worldHeight / Math.max(1, size.height);
|
|
152
|
+
this.root.position.set(-(size.width * pixels) / 2, worldHeight / 2, -1);
|
|
153
|
+
this.root.scale.set(pixels, -pixels, 1);
|
|
154
|
+
place(this.#moveBase, this.#hasMoveAnchor ? this.#moveAnchor : this.#resting);
|
|
155
|
+
place(this.#jump, this.#jumpCenter);
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
#at(pointers: ReadonlyMap<number, ITouchPointer>, center: Vector2, radius: number): boolean {
|
|
159
|
+
const radiusSquared = radius * radius;
|
|
160
|
+
for (const pointer of pointers.values()) {
|
|
161
|
+
if (pointer.position.distanceToSquared(center) <= radiusSquared) return true;
|
|
162
|
+
}
|
|
163
|
+
return false;
|
|
164
|
+
}
|
|
165
|
+
}
|