create-threenative 0.2.3 → 0.2.5
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/README.md +53 -2
- package/agent-docs/references/assertion-reference.md +173 -6
- package/agent-docs/references/capability-reference.md +1303 -99
- package/agent-docs/references/capture-the-frame.md +7 -0
- package/agent-docs/references/creating-creatures.md +215 -0
- package/agent-docs/references/ctx-cookbook.md +69 -0
- package/agent-docs/references/debug-surface.md +8 -3
- package/agent-docs/references/dream-loop.md +150 -0
- package/agent-docs/references/finding-assets.md +70 -2
- package/agent-docs/references/sculpt-from-a-reference.md +3 -2
- package/agent-docs/references/trace-a-slow-frame.md +99 -0
- package/agent-docs/references/visual-baseline.md +41 -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 +1 -1
- 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 +1 -1
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -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/scripts/reference.mjs +705 -0
- package/agent-files/scripts/visual-loop.mjs +382 -0
- package/capabilities.json +1881 -131
- package/dist/index.d.ts +39 -6
- package/dist/index.js +297 -32
- package/dist/threenative.js +822 -105
- package/package.json +30 -5
- package/template-assets/loading.ts +12 -2
- package/template-assets/patches/three@0.185.1.patch +249 -14
- package/template-assets/worldEnvironment.ts +758 -0
- package/templates/action-rpg/.codex/config.toml +4 -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 +15 -3
- package/templates/action-rpg/.vscode/mcp.json +36 -0
- package/templates/action-rpg/.zed/settings.json +36 -0
- package/templates/action-rpg/AGENTS.md +69 -378
- package/templates/action-rpg/CLAUDE.md +69 -378
- package/templates/action-rpg/opencode.json +41 -0
- package/templates/action-rpg/package.json +7 -7
- package/templates/action-rpg/playtests/combat.playtest.json +9 -0
- package/templates/action-rpg/playtests/performance.playtest.json +24 -7
- 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/src/conventions.ts +35 -0
- package/templates/action-rpg/src/entities/Enemy.ts +2 -3
- package/templates/action-rpg/src/entities/Player.ts +20 -3
- package/templates/action-rpg/src/render/camera.ts +7 -2
- package/templates/action-rpg/src/render/lighting.ts +5 -3
- package/templates/action-rpg/src/render/loading.ts +12 -2
- 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 +21 -58
- 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 +208 -33
- package/templates/action-rpg/src/scenes/Play.ts +43 -6
- package/templates/action-rpg/src/style.css +20 -0
- package/templates/action-rpg/threenative.config.ts +7 -0
- package/templates/defense/.codex/config.toml +4 -0
- package/templates/defense/.cursor/mcp.json +32 -0
- package/templates/defense/.gemini/settings.json +32 -0
- package/templates/defense/.mcp.json +15 -3
- package/templates/defense/.vscode/mcp.json +36 -0
- package/templates/defense/.zed/settings.json +36 -0
- package/templates/defense/AGENTS.md +62 -385
- package/templates/defense/CLAUDE.md +62 -385
- package/templates/defense/opencode.json +41 -0
- package/templates/defense/package.json +7 -7
- package/templates/defense/playtests/performance.playtest.json +24 -7
- package/templates/defense/playtests/pointer-placement.playtest.json +87 -20
- package/templates/defense/playtests/scan.playtest.json +1 -1
- package/templates/defense/playtests/survive.playtest.json +14 -0
- package/templates/defense/src/attackers/Attacker.ts +4 -4
- 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 +2 -3
- 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/loading.ts +12 -2
- 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 +21 -58
- package/templates/defense/src/render/quality.ts +170 -0
- package/templates/defense/src/render/shapes.ts +142 -23
- package/templates/defense/src/render/sky.ts +2 -2
- package/templates/defense/src/render/worldEnvironment.ts +208 -33
- package/templates/defense/src/scenes/Boot.ts +2 -2
- package/templates/defense/src/scenes/Defense.ts +13 -6
- package/templates/defense/src/style.css +20 -0
- 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 +2 -2
- package/templates/defense/threenative.config.ts +7 -0
- package/templates/minimal/.codex/config.toml +4 -0
- package/templates/minimal/.cursor/mcp.json +32 -0
- package/templates/minimal/.gemini/settings.json +32 -0
- package/templates/minimal/.mcp.json +15 -3
- package/templates/minimal/.vscode/mcp.json +36 -0
- package/templates/minimal/.zed/settings.json +36 -0
- package/templates/minimal/AGENTS.md +76 -485
- package/templates/minimal/CLAUDE.md +76 -485
- package/templates/minimal/opencode.json +41 -0
- package/templates/minimal/package.json +6 -6
- package/templates/minimal/playtests/play.playtest.json +2 -1
- 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/main.ts +14 -4
- 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 +17 -56
- package/templates/minimal/src/render/quality.ts +162 -0
- package/templates/minimal/src/render/sky.ts +23 -9
- package/templates/minimal/src/render/touch-controls.ts +165 -0
- package/templates/minimal/src/render/worldEnvironment.ts +208 -33
- package/templates/minimal/src/scenes/Play.ts +47 -11
- package/templates/minimal/src/style.css +20 -0
- package/templates/minimal/threenative.config.ts +7 -0
- package/templates/platformer/.codex/config.toml +4 -0
- package/templates/platformer/.cursor/mcp.json +32 -0
- package/templates/platformer/.gemini/settings.json +32 -0
- package/templates/platformer/.mcp.json +15 -3
- package/templates/platformer/.vscode/mcp.json +36 -0
- package/templates/platformer/.zed/settings.json +36 -0
- package/templates/platformer/AGENTS.md +70 -430
- package/templates/platformer/CLAUDE.md +70 -430
- package/templates/platformer/opencode.json +41 -0
- package/templates/platformer/package.json +7 -7
- package/templates/platformer/playtests/oneway.playtest.json +29 -2
- package/templates/platformer/playtests/performance.playtest.json +2 -1
- package/templates/platformer/playtests/survives.playtest.json +31 -0
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +3 -0
- package/templates/platformer/playtests/touch-controls-web.playtest.json +15 -4
- package/templates/platformer/src/conventions.ts +18 -0
- package/templates/platformer/src/entities/Character.ts +63 -1
- package/templates/platformer/src/game.ts +3 -1
- package/templates/platformer/src/level/Platform.ts +13 -1
- package/templates/platformer/src/render/lighting.ts +7 -4
- package/templates/platformer/src/render/loading.ts +12 -2
- package/templates/platformer/src/render/palette.ts +4 -1
- package/templates/platformer/src/render/postprocessing.ts +32 -57
- package/templates/platformer/src/render/quality.ts +170 -0
- package/templates/platformer/src/render/worldEnvironment.ts +208 -33
- package/templates/platformer/src/scenes/Level.ts +52 -12
- package/templates/platformer/src/style.css +20 -0
- package/templates/platformer/threenative.config.ts +7 -0
- 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 +4 -0
- package/templates/racing/.cursor/mcp.json +32 -0
- package/templates/racing/.gemini/settings.json +32 -0
- package/templates/racing/.mcp.json +15 -3
- package/templates/racing/.vscode/mcp.json +36 -0
- package/templates/racing/.zed/settings.json +36 -0
- package/templates/racing/AGENTS.md +63 -379
- package/templates/racing/CLAUDE.md +63 -379
- package/templates/racing/native-playtests/survives.playtest.json +43 -0
- package/templates/racing/opencode.json +41 -0
- package/templates/racing/package.json +8 -7
- package/templates/racing/playtests/performance.playtest.json +24 -7
- 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/render/camera.ts +7 -4
- package/templates/racing/src/render/lighting.ts +22 -13
- package/templates/racing/src/render/loading.ts +12 -2
- 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 +21 -58
- 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 +208 -33
- package/templates/racing/src/scenes/Race.ts +17 -2
- package/templates/racing/src/style.css +20 -0
- package/templates/racing/src/track/Track.ts +270 -31
- package/templates/racing/threenative.config.ts +7 -0
- 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 +4 -0
- package/templates/sailing/.cursor/mcp.json +32 -0
- package/templates/sailing/.gemini/settings.json +32 -0
- package/templates/sailing/.mcp.json +15 -3
- package/templates/sailing/.vscode/mcp.json +36 -0
- package/templates/sailing/.zed/settings.json +36 -0
- package/templates/sailing/AGENTS.md +62 -355
- package/templates/sailing/CLAUDE.md +62 -355
- package/templates/sailing/README.md +12 -9
- package/templates/sailing/native-playtests/float.playtest.json +55 -0
- package/templates/sailing/native-playtests/survives.playtest.json +20 -3
- package/templates/sailing/opencode.json +41 -0
- package/templates/sailing/package.json +8 -8
- 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 +21 -6
- package/templates/sailing/playtests/survives.playtest.json +8 -0
- package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
- package/templates/sailing/src/conventions.ts +8 -0
- package/templates/sailing/src/entities/Ship.ts +150 -13
- package/templates/sailing/src/render/camera.ts +15 -8
- package/templates/sailing/src/render/lighting.ts +10 -5
- package/templates/sailing/src/render/loading.ts +12 -2
- package/templates/sailing/src/render/materials.ts +24 -8
- package/templates/sailing/src/render/ocean.ts +179 -0
- package/templates/sailing/src/render/palette.ts +14 -21
- package/templates/sailing/src/render/postprocessing.ts +23 -22
- package/templates/sailing/src/render/props.ts +584 -34
- package/templates/sailing/src/render/quality.ts +140 -0
- package/templates/sailing/src/render/sky.ts +8 -3
- package/templates/sailing/src/render/touch-controls.ts +142 -0
- package/templates/sailing/src/render/worldEnvironment.ts +206 -38
- package/templates/sailing/src/scenes/Sailing.ts +43 -16
- package/templates/sailing/src/style.css +20 -0
- package/templates/sailing/threenative.config.ts +7 -1
- package/templates/shooter/.codex/config.toml +4 -0
- package/templates/shooter/.cursor/mcp.json +32 -0
- package/templates/shooter/.gemini/settings.json +32 -0
- package/templates/shooter/.mcp.json +15 -3
- package/templates/shooter/.vscode/mcp.json +36 -0
- package/templates/shooter/.zed/settings.json +36 -0
- package/templates/shooter/AGENTS.md +76 -415
- package/templates/shooter/CLAUDE.md +76 -415
- package/templates/shooter/kit.json +2 -2
- package/templates/shooter/opencode.json +41 -0
- package/templates/shooter/package.json +7 -7
- package/templates/shooter/playtests/combat.playtest.json +48 -0
- package/templates/shooter/playtests/input-control.playtest.json +165 -35
- package/templates/shooter/playtests/per-item.playtest.json +3 -3
- package/templates/shooter/playtests/performance.playtest.json +24 -7
- package/templates/shooter/playtests/shooter.playtest.json +13 -7
- package/templates/shooter/playtests/survives.playtest.json +27 -0
- package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
- package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
- 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 +13 -4
- package/templates/shooter/src/render/camera.ts +49 -39
- package/templates/shooter/src/render/decals.ts +211 -0
- package/templates/shooter/src/render/lighting.ts +7 -3
- package/templates/shooter/src/render/loading.ts +12 -2
- 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 +21 -58
- 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 +343 -62
- 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 +85 -0
- 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 +208 -33
- package/templates/shooter/src/scenes/Play.ts +171 -56
- package/templates/shooter/src/state.ts +5 -0
- package/templates/shooter/src/style.css +20 -0
- package/templates/shooter/src/ui/Crosshair.tsx +25 -0
- package/templates/shooter/src/ui/GameUi.tsx +2 -0
- package/templates/shooter/src/ui/Hud.tsx +7 -1
- package/templates/shooter/src/weapons/Hitscan.ts +3 -4
- package/templates/shooter/src/weapons/Projectile.ts +8 -3
- package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
- package/templates/shooter/threenative.config.ts +7 -0
- package/templates/starter/.codex/config.toml +4 -0
- package/templates/starter/.cursor/mcp.json +32 -0
- package/templates/starter/.gemini/settings.json +32 -0
- package/templates/starter/.mcp.json +15 -3
- package/templates/starter/.vscode/mcp.json +36 -0
- package/templates/starter/.zed/settings.json +36 -0
- package/templates/starter/AGENTS.md +70 -527
- package/templates/starter/CLAUDE.md +70 -527
- package/templates/starter/native-playtests/render-chain.playtest.json +73 -4
- package/templates/starter/opencode.json +41 -0
- package/templates/starter/package.json +7 -7
- package/templates/starter/playtests/boot-failure.playtest.json +45 -0
- package/templates/starter/playtests/look.playtest.json +110 -6
- package/templates/starter/playtests/play.playtest.json +3 -2
- package/templates/starter/playtests/survives.playtest.json +21 -0
- package/templates/starter/playtests/touch-controls.playtest.json +42 -0
- package/templates/starter/src/conventions.ts +18 -0
- package/templates/starter/src/entities/Goal.ts +18 -3
- package/templates/starter/src/entities/Player.ts +72 -9
- package/templates/starter/src/game.ts +2 -0
- package/templates/starter/src/render/adaptiveQuality.ts +195 -0
- package/templates/starter/src/render/camera.ts +1 -1
- package/templates/starter/src/render/coast.ts +199 -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 +4 -4
- package/templates/starter/src/render/loading.ts +12 -2
- package/templates/starter/src/render/materials.ts +25 -6
- 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/postprocessing.ts +87 -36
- 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 +16 -59
- 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 +208 -33
- package/templates/starter/src/scenes/Play.ts +103 -16
- package/templates/starter/src/style.css +27 -7
- package/templates/starter/threenative.config.ts +7 -7
- package/agent-docs/asset-mcp-loop.md +0 -33
- package/agent-docs/ctx-surface.md +0 -69
- package/agent-docs/engine-capabilities.md +0 -4
- package/agent-docs/framework-blocks-you.md +0 -60
- package/agent-docs/look-at-it-and-budget-the-look.md +0 -27
- package/agent-docs/performance-default.md +0 -42
- package/agent-docs/pixel-budget.md +0 -20
- package/agent-docs/playtest-fail-closed.md +0 -23
- package/agent-docs/sculpt-loop.md +0 -16
- package/templates/action-rpg/src/physics.ts +0 -40
- package/templates/defense/public/icon.png +0 -0
- package/templates/minimal/public/icon.png +0 -0
- package/templates/platformer/public/icon.png +0 -0
- package/templates/racing/public/icon.png +0 -0
- package/templates/sailing/public/icon.png +0 -0
- package/templates/sailing/src/render/water-material.ts +0 -14
- package/templates/sailing/src/render/water-shaders.ts +0 -12
- package/templates/sailing/src/render/wave-nodes.ts +0 -10
- package/templates/shooter/public/icon.png +0 -0
- package/templates/shooter/src/physics.ts +0 -49
- package/templates/starter/public/icon.png +0 -0
- /package/{templates/action-rpg/public → template-assets}/icon.png +0 -0
|
@@ -0,0 +1,170 @@
|
|
|
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
|
+
import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* The three names this game's look comes in.
|
|
26
|
+
*
|
|
27
|
+
* `low` is what a phone gets and `high` what a desktop gets — those two are this template's
|
|
28
|
+
* shipped looks, unchanged. `medium` is the rung in between for a machine that is neither: a
|
|
29
|
+
* laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
|
|
30
|
+
* what any of them mean.
|
|
31
|
+
*/
|
|
32
|
+
export type QualityTier = "low" | "medium" | "high";
|
|
33
|
+
|
|
34
|
+
const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
|
|
35
|
+
|
|
36
|
+
/**
|
|
37
|
+
* Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
|
|
38
|
+
* `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
|
|
39
|
+
*/
|
|
40
|
+
function isQualityTier(value: string): value is QualityTier {
|
|
41
|
+
return (QUALITY_TIERS as readonly string[]).includes(value);
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
|
|
46
|
+
*
|
|
47
|
+
* Fails closed. An unrecognised tier name throws with the value it was handed rather than
|
|
48
|
+
* quietly rendering the default, because a silent fallback here looks exactly like a tier that
|
|
49
|
+
* turned out to have no effect.
|
|
50
|
+
*/
|
|
51
|
+
export function resolveQualityTier(
|
|
52
|
+
request: { readonly mobile?: boolean; readonly tier?: string } = {},
|
|
53
|
+
): QualityTier {
|
|
54
|
+
const requested = request.tier;
|
|
55
|
+
if (requested !== undefined) {
|
|
56
|
+
if (!isQualityTier(requested)) {
|
|
57
|
+
throw new Error(
|
|
58
|
+
`Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
59
|
+
);
|
|
60
|
+
}
|
|
61
|
+
return requested;
|
|
62
|
+
}
|
|
63
|
+
return request.mobile === true ? "low" : "high";
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* What a desktop gets: this template's shipped desktop look, unchanged.
|
|
68
|
+
*
|
|
69
|
+
* The whole chain measured 12.5 ms of a 14.7 ms GPU frame in the reference ablation, and SSGI
|
|
70
|
+
* with its denoiser is ~9.2 ms of that.
|
|
71
|
+
*/
|
|
72
|
+
const high: IWorldEnvironmentOptions = {
|
|
73
|
+
// Strength, radius and threshold are a look decision already tuned to this scene's palette.
|
|
74
|
+
// Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
|
|
75
|
+
// to be.
|
|
76
|
+
bloomEnabled: true,
|
|
77
|
+
bloomRadius: 0.5,
|
|
78
|
+
bloomStrength: 0.42,
|
|
79
|
+
bloomThreshold: 0.2,
|
|
80
|
+
exposure: 1.15,
|
|
81
|
+
// The two full-resolution denoise passes over the AO and GI terms: ~1.9 ms. Only worth running
|
|
82
|
+
// when SSGI is on — its noise is what they clean up.
|
|
83
|
+
denoiseEnabled: true,
|
|
84
|
+
// SSGI, the screen-space indirect-light gather: ~7.3 ms alone, ~9.2 ms with the two denoise
|
|
85
|
+
// passes it feeds. The largest stage in the chain by a factor of two, of a 14.7 ms frame.
|
|
86
|
+
// Dropping this pair is what `medium` is.
|
|
87
|
+
ssgiEnabled: true,
|
|
88
|
+
ssgiRadius: 18,
|
|
89
|
+
ssgiQuality: "medium",
|
|
90
|
+
// Half the frame in each axis, so a quarter of the pixels. Full-res SSGI cost 14.4 ms
|
|
91
|
+
// of a 39.7 ms frame on an RTX 2080; this is the same gather over a quarter of the work,
|
|
92
|
+
// and it measured *sharper* because the scaler spends what it hands back on resolution.
|
|
93
|
+
// `worldEnvironment.ts` explains why it takes a wrapper instead of a property.
|
|
94
|
+
ssgiResolutionScale: 0.5,
|
|
95
|
+
// Screen-space reflections: ~4.1 ms.
|
|
96
|
+
ssrEnabled: true,
|
|
97
|
+
// `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
|
|
98
|
+
// are on and do nothing" — the ray dies a metre from where it started.
|
|
99
|
+
ssrMaxDistance: 44,
|
|
100
|
+
// A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
|
|
101
|
+
// the rays and is very hard to see in the result.
|
|
102
|
+
ssrResolutionScale: 0.5,
|
|
103
|
+
// RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
|
|
104
|
+
// denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
|
|
105
|
+
// that runs one of them.
|
|
106
|
+
sharpenEnabled: true,
|
|
107
|
+
// **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
|
|
108
|
+
sharpenStrength: 0.3,
|
|
109
|
+
tonemapMode: "aces",
|
|
110
|
+
};
|
|
111
|
+
|
|
112
|
+
/**
|
|
113
|
+
* `high` minus the gather and its denoiser — the single change in this chain measured to give
|
|
114
|
+
* back most of the frame: **14.7 ms -> 5.5 ms of GPU** in the reference ablation. Reflections,
|
|
115
|
+
* bloom and the sharpener stay, so it is recognisably the same look.
|
|
116
|
+
*/
|
|
117
|
+
const medium: IWorldEnvironmentOptions = {
|
|
118
|
+
// Strength, radius and threshold are a look decision already tuned to this scene's palette.
|
|
119
|
+
// Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
|
|
120
|
+
// to be.
|
|
121
|
+
bloomEnabled: true,
|
|
122
|
+
bloomRadius: 0.5,
|
|
123
|
+
bloomStrength: 0.42,
|
|
124
|
+
bloomThreshold: 0.2,
|
|
125
|
+
exposure: 1.15,
|
|
126
|
+
// Screen-space reflections: ~4.1 ms.
|
|
127
|
+
ssrEnabled: true,
|
|
128
|
+
// `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
|
|
129
|
+
// are on and do nothing" — the ray dies a metre from where it started.
|
|
130
|
+
ssrMaxDistance: 44,
|
|
131
|
+
// A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
|
|
132
|
+
// the rays and is very hard to see in the result.
|
|
133
|
+
ssrResolutionScale: 0.5,
|
|
134
|
+
// RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
|
|
135
|
+
// denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
|
|
136
|
+
// that runs one of them.
|
|
137
|
+
sharpenEnabled: true,
|
|
138
|
+
// **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
|
|
139
|
+
sharpenStrength: 0.3,
|
|
140
|
+
tonemapMode: "aces",
|
|
141
|
+
};
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* What a phone gets: this template's shipped mobile look, unchanged. Bloom and the tone curve,
|
|
145
|
+
* nothing screen-space. The ablation's floor — every stage off — was 2.2 ms.
|
|
146
|
+
*/
|
|
147
|
+
const low: IWorldEnvironmentOptions = {
|
|
148
|
+
// Strength, radius and threshold are a look decision already tuned to this scene's palette.
|
|
149
|
+
// Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
|
|
150
|
+
// to be.
|
|
151
|
+
bloomEnabled: true,
|
|
152
|
+
bloomRadius: 0.5,
|
|
153
|
+
bloomStrength: 0.42,
|
|
154
|
+
bloomThreshold: 0.2,
|
|
155
|
+
exposure: 1.15,
|
|
156
|
+
tonemapMode: "aces",
|
|
157
|
+
};
|
|
158
|
+
|
|
159
|
+
const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
|
|
160
|
+
|
|
161
|
+
/** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
|
|
162
|
+
export function qualityPreset(tier: string): IWorldEnvironmentOptions {
|
|
163
|
+
const preset = QUALITY_PRESETS[tier as QualityTier];
|
|
164
|
+
if (preset === undefined) {
|
|
165
|
+
throw new Error(
|
|
166
|
+
`Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
167
|
+
);
|
|
168
|
+
}
|
|
169
|
+
return preset;
|
|
170
|
+
}
|
|
@@ -0,0 +1,134 @@
|
|
|
1
|
+
// Generated for you: ordinary Three.js. Every shape in this kit is built from box, cylinder,
|
|
2
|
+
// sphere and torus primitives, so the game ships with no downloaded asset and nothing to license.
|
|
3
|
+
// Replace any of these with a loaded model when you have one; nothing here is framework API.
|
|
4
|
+
import {
|
|
5
|
+
BoxGeometry,
|
|
6
|
+
CylinderGeometry,
|
|
7
|
+
Group,
|
|
8
|
+
Mesh,
|
|
9
|
+
type MeshStandardMaterial,
|
|
10
|
+
SphereGeometry,
|
|
11
|
+
TorusGeometry,
|
|
12
|
+
} from "three";
|
|
13
|
+
import { createMaterials } from "./materials.js";
|
|
14
|
+
|
|
15
|
+
export const CRATE_SIZE = 1.1;
|
|
16
|
+
export const BALL_RADIUS = 0.42;
|
|
17
|
+
export const GOAL_RADIUS = 1.15;
|
|
18
|
+
|
|
19
|
+
function solid(mesh: Mesh): Mesh {
|
|
20
|
+
mesh.castShadow = true;
|
|
21
|
+
mesh.receiveShadow = true;
|
|
22
|
+
return mesh;
|
|
23
|
+
}
|
|
24
|
+
|
|
25
|
+
/** The floor slab. Its collider comes from `buildStaticColliders`, not from a hand-written box. */
|
|
26
|
+
export function floorSlab(width: number, depth: number): Mesh {
|
|
27
|
+
const mesh = new Mesh(new BoxGeometry(width, 0.4, depth), createMaterials().floor);
|
|
28
|
+
mesh.position.y = -0.2;
|
|
29
|
+
mesh.receiveShadow = true;
|
|
30
|
+
mesh.name = "room-floor";
|
|
31
|
+
return mesh;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
export function wallSlab(width: number, height: number, depth: number): Mesh {
|
|
35
|
+
const mesh = solid(new Mesh(new BoxGeometry(width, height, depth), createMaterials().wall));
|
|
36
|
+
mesh.name = "room-wall";
|
|
37
|
+
return mesh;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/** The shallow rise the ball has to be helped over. Deliberately too steep to roll unaided. */
|
|
41
|
+
export function ramp(width: number, rise: number, run: number): Mesh {
|
|
42
|
+
const mesh = solid(new Mesh(new BoxGeometry(width, rise, run), createMaterials().wall));
|
|
43
|
+
mesh.name = "room-ramp";
|
|
44
|
+
return mesh;
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
export function crate(): Mesh {
|
|
48
|
+
const mesh = solid(
|
|
49
|
+
new Mesh(new BoxGeometry(CRATE_SIZE, CRATE_SIZE, CRATE_SIZE), createMaterials().crate),
|
|
50
|
+
);
|
|
51
|
+
mesh.name = "crate";
|
|
52
|
+
return mesh;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
export function ball(): Mesh {
|
|
56
|
+
const mesh = solid(new Mesh(new SphereGeometry(BALL_RADIUS, 20, 14), createMaterials().ball));
|
|
57
|
+
mesh.name = "ball";
|
|
58
|
+
return mesh;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/** The hinge frame: two posts and a beam. The bob hangs from the beam on a `Joint3D`. */
|
|
62
|
+
export function gantry(span: number, height: number): Group {
|
|
63
|
+
const materials = createMaterials();
|
|
64
|
+
const group = new Group();
|
|
65
|
+
group.name = "gantry";
|
|
66
|
+
for (const side of [-1, 1]) {
|
|
67
|
+
const post = solid(new Mesh(new CylinderGeometry(0.16, 0.2, height, 10), materials.steel));
|
|
68
|
+
post.position.set((side * span) / 2, height / 2, 0);
|
|
69
|
+
group.add(post);
|
|
70
|
+
}
|
|
71
|
+
const beam = solid(new Mesh(new BoxGeometry(span, 0.22, 0.32), materials.steel));
|
|
72
|
+
beam.position.y = height;
|
|
73
|
+
group.add(beam);
|
|
74
|
+
return group;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
export function weight(radius: number): Mesh {
|
|
78
|
+
const mesh = solid(new Mesh(new SphereGeometry(radius, 18, 12), createMaterials().steel));
|
|
79
|
+
mesh.name = "weight";
|
|
80
|
+
return mesh;
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
/** The goal ring, lying flat. Its `Area3D` is a separate, invisible volume in the scene. */
|
|
84
|
+
export function goalRing(): Group {
|
|
85
|
+
const materials = createMaterials();
|
|
86
|
+
const group = new Group();
|
|
87
|
+
group.name = "goal";
|
|
88
|
+
const ring = new Mesh(new TorusGeometry(GOAL_RADIUS, 0.09, 10, 28), materials.goal);
|
|
89
|
+
ring.rotation.x = Math.PI / 2;
|
|
90
|
+
ring.position.y = 0.09;
|
|
91
|
+
const pad = new Mesh(new CylinderGeometry(GOAL_RADIUS, GOAL_RADIUS, 0.04, 28), materials.goal);
|
|
92
|
+
pad.position.y = 0.02;
|
|
93
|
+
pad.receiveShadow = true;
|
|
94
|
+
group.add(ring, pad);
|
|
95
|
+
return group;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* The player: a hovering claw that carries one crate at a time.
|
|
100
|
+
*
|
|
101
|
+
* It wears the accent, and it is the only accent-coloured thing that is not a crate. The first
|
|
102
|
+
* version was steel on a dark floor and read as debris in the frame — a player who cannot find
|
|
103
|
+
* themselves in one glance has no game to play.
|
|
104
|
+
*/
|
|
105
|
+
export function gripper(): Group {
|
|
106
|
+
const materials = createMaterials();
|
|
107
|
+
const group = new Group();
|
|
108
|
+
const body = solid(new Mesh(new SphereGeometry(0.4, 18, 12), materials.crate));
|
|
109
|
+
body.position.y = 1.05;
|
|
110
|
+
body.scale.y = 0.72;
|
|
111
|
+
const mast = solid(new Mesh(new CylinderGeometry(0.07, 0.09, 0.75, 8), materials.steel));
|
|
112
|
+
mast.position.y = 0.62;
|
|
113
|
+
const foot = solid(new Mesh(new CylinderGeometry(0.34, 0.42, 0.12, 12), materials.steel));
|
|
114
|
+
foot.position.y = 0.06;
|
|
115
|
+
for (const side of [-1, 1]) {
|
|
116
|
+
const claw = solid(new Mesh(new BoxGeometry(0.12, 0.42, 0.12), materials.crate));
|
|
117
|
+
claw.position.set(side * 0.24, 0.34, 0);
|
|
118
|
+
claw.rotation.z = side * 0.3;
|
|
119
|
+
group.add(claw);
|
|
120
|
+
}
|
|
121
|
+
group.add(body, mast, foot);
|
|
122
|
+
return group;
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
/** One floor tile's geometry and material, handed to an `InstancedBatch` by the room builder. */
|
|
126
|
+
export function floorTile(size: number): {
|
|
127
|
+
geometry: BoxGeometry;
|
|
128
|
+
material: MeshStandardMaterial;
|
|
129
|
+
} {
|
|
130
|
+
// A floor pattern, not a chessboard. The first version used the wall grey against the darker
|
|
131
|
+
// floor and the contrast read louder than the crates, which are the thing the player is meant
|
|
132
|
+
// to look at. `tile` is a half-step above the slab it sits on.
|
|
133
|
+
return { geometry: new BoxGeometry(size, 0.06, size), material: createMaterials().tile };
|
|
134
|
+
}
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
import { Color, Fog, type Scene } from "three";
|
|
2
|
+
import { palette } from "./palette.js";
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* There is no sky. This is an interior.
|
|
6
|
+
*
|
|
7
|
+
* The kit shipped with a gradient sky dome inherited from an outdoor template, and above the
|
|
8
|
+
* walls it read as a hard-edged blue triangle — a hole in the room rather than a ceiling. What an
|
|
9
|
+
* interior wants instead is a dark ground colour and fog that swallows the far corners, so the
|
|
10
|
+
* eye stays on the lit floor where the puzzle is. Replace this with a dome, an HDR environment,
|
|
11
|
+
* or an actual ceiling; it is your file.
|
|
12
|
+
*/
|
|
13
|
+
export function setupSky(scene: Scene): void {
|
|
14
|
+
scene.background = new Color(palette.shadow);
|
|
15
|
+
scene.fog = new Fog(palette.shadow, 38, 96);
|
|
16
|
+
}
|
|
@@ -0,0 +1,185 @@
|
|
|
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 = 58;
|
|
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 swingPressed: boolean;
|
|
29
|
+
readonly grabPressed: boolean;
|
|
30
|
+
readonly move: Vector2;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
function overlayMaterial(color: ColorRepresentation, opacity: number): MeshBasicMaterial {
|
|
34
|
+
return new MeshBasicMaterial({
|
|
35
|
+
color,
|
|
36
|
+
depthTest: false,
|
|
37
|
+
depthWrite: false,
|
|
38
|
+
opacity,
|
|
39
|
+
transparent: true,
|
|
40
|
+
});
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
function ringMesh(radius: number, material: MeshBasicMaterial): Mesh {
|
|
44
|
+
return new Mesh(new RingGeometry(radius - 5, radius, 32), material);
|
|
45
|
+
}
|
|
46
|
+
|
|
47
|
+
function place(mesh: Mesh, point: Vector2): void {
|
|
48
|
+
mesh.position.set(point.x, point.y, 0);
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
function controlPoint(size: ITouchViewport, name: "grab" | "swing" | "move"): Vector2 {
|
|
52
|
+
if (name === "move") return new Vector2(MOVE_RADIUS + EDGE, size.height - MOVE_RADIUS - EDGE);
|
|
53
|
+
const yOffset = name === "swing" ? BUTTON_RADIUS * 2 + EDGE : 0;
|
|
54
|
+
return new Vector2(
|
|
55
|
+
size.width - BUTTON_RADIUS - EDGE,
|
|
56
|
+
size.height - BUTTON_RADIUS - EDGE - yOffset,
|
|
57
|
+
);
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
export class TouchControls {
|
|
61
|
+
readonly root = new Group();
|
|
62
|
+
readonly object = this.root;
|
|
63
|
+
#camera: PerspectiveCamera;
|
|
64
|
+
#input: { swingPressed: boolean; grabPressed: boolean; move: Vector2 } = {
|
|
65
|
+
swingPressed: false,
|
|
66
|
+
grabPressed: false,
|
|
67
|
+
move: new Vector2(),
|
|
68
|
+
};
|
|
69
|
+
#wasSwing = false;
|
|
70
|
+
#wasGrab = false;
|
|
71
|
+
#moveAnchor = new Vector2();
|
|
72
|
+
#resting = new Vector2();
|
|
73
|
+
#swingCenter = new Vector2();
|
|
74
|
+
#grabCenter = new Vector2();
|
|
75
|
+
#hasMoveAnchor = false;
|
|
76
|
+
#lastWidth = -1;
|
|
77
|
+
#lastHeight = -1;
|
|
78
|
+
#moveBase: Mesh;
|
|
79
|
+
#moveKnob: Mesh;
|
|
80
|
+
#swing: Mesh;
|
|
81
|
+
#grab: Mesh;
|
|
82
|
+
#idleMaterial: MeshBasicMaterial;
|
|
83
|
+
#activeMaterial: MeshBasicMaterial;
|
|
84
|
+
|
|
85
|
+
constructor(camera: PerspectiveCamera) {
|
|
86
|
+
this.#camera = camera;
|
|
87
|
+
this.#idleMaterial = overlayMaterial(palette.wall, 0.35);
|
|
88
|
+
this.#activeMaterial = overlayMaterial(palette.accent, 0.6);
|
|
89
|
+
this.#moveBase = ringMesh(MOVE_RADIUS, this.#idleMaterial);
|
|
90
|
+
this.#moveKnob = new Mesh(new CircleGeometry(28, 24), this.#activeMaterial);
|
|
91
|
+
this.#swing = ringMesh(BUTTON_RADIUS, this.#idleMaterial);
|
|
92
|
+
this.#grab = ringMesh(BUTTON_RADIUS, this.#idleMaterial);
|
|
93
|
+
this.root.add(this.#moveBase, this.#moveKnob, this.#swing, this.#grab);
|
|
94
|
+
this.root.renderOrder = 10_001;
|
|
95
|
+
camera.add(this.root);
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
update(pointers: ReadonlyMap<number, ITouchPointer>, size: ITouchViewport): ITouchInput {
|
|
99
|
+
this.#ensureLayout(size);
|
|
100
|
+
const grab = this.#at(pointers, this.#grabCenter, BUTTON_RADIUS);
|
|
101
|
+
const swing = this.#at(pointers, this.#swingCenter, BUTTON_RADIUS);
|
|
102
|
+
let movement: ITouchPointer | undefined;
|
|
103
|
+
for (const pointer of pointers.values()) {
|
|
104
|
+
if (pointer.position.x < size.width * 0.5) {
|
|
105
|
+
movement = pointer;
|
|
106
|
+
break;
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
if (movement === undefined) {
|
|
111
|
+
this.#hasMoveAnchor = false;
|
|
112
|
+
this.#input.move.set(0, 0);
|
|
113
|
+
} else {
|
|
114
|
+
if (!this.#hasMoveAnchor) {
|
|
115
|
+
this.#moveAnchor.copy(movement.position);
|
|
116
|
+
this.#hasMoveAnchor = true;
|
|
117
|
+
}
|
|
118
|
+
this.#input.move.set(
|
|
119
|
+
MathUtils.clamp((movement.position.x - this.#moveAnchor.x) / MOVE_RADIUS, -1, 1),
|
|
120
|
+
MathUtils.clamp((this.#moveAnchor.y - movement.position.y) / MOVE_RADIUS, -1, 1),
|
|
121
|
+
);
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
const center = this.#hasMoveAnchor ? this.#moveAnchor : this.#resting;
|
|
125
|
+
place(
|
|
126
|
+
this.#moveKnob,
|
|
127
|
+
new Vector2(
|
|
128
|
+
center.x + this.#input.move.x * MOVE_RADIUS,
|
|
129
|
+
center.y - this.#input.move.y * MOVE_RADIUS,
|
|
130
|
+
),
|
|
131
|
+
);
|
|
132
|
+
this.#swing.material = swing ? this.#activeMaterial : this.#idleMaterial;
|
|
133
|
+
this.#grab.material = grab ? this.#activeMaterial : this.#idleMaterial;
|
|
134
|
+
this.#input.swingPressed = swing && !this.#wasSwing;
|
|
135
|
+
this.#input.grabPressed = grab && !this.#wasGrab;
|
|
136
|
+
this.#wasSwing = swing;
|
|
137
|
+
this.#wasGrab = grab;
|
|
138
|
+
this.#layout(size);
|
|
139
|
+
return this.#input;
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
debug(): Record<string, unknown> {
|
|
143
|
+
return {
|
|
144
|
+
grab: this.#wasGrab,
|
|
145
|
+
swing: this.#wasSwing,
|
|
146
|
+
move: this.#input.move.toArray(),
|
|
147
|
+
};
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
dispose(): void {
|
|
151
|
+
this.root.removeFromParent();
|
|
152
|
+
for (const child of this.root.children) {
|
|
153
|
+
if (child instanceof Mesh) child.geometry.dispose();
|
|
154
|
+
}
|
|
155
|
+
this.#idleMaterial.dispose();
|
|
156
|
+
this.#activeMaterial.dispose();
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
#ensureLayout(size: ITouchViewport): void {
|
|
160
|
+
if (size.width === this.#lastWidth && size.height === this.#lastHeight) return;
|
|
161
|
+
this.#lastWidth = size.width;
|
|
162
|
+
this.#lastHeight = size.height;
|
|
163
|
+
this.#resting.copy(controlPoint(size, "move"));
|
|
164
|
+
this.#swingCenter.copy(controlPoint(size, "swing"));
|
|
165
|
+
this.#grabCenter.copy(controlPoint(size, "grab"));
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
#layout(size: ITouchViewport): void {
|
|
169
|
+
const worldHeight = 2 * Math.tan(MathUtils.degToRad(this.#camera.fov / 2));
|
|
170
|
+
const pixels = worldHeight / Math.max(1, size.height);
|
|
171
|
+
this.root.position.set(-(size.width * pixels) / 2, worldHeight / 2, -1);
|
|
172
|
+
this.root.scale.set(pixels, -pixels, 1);
|
|
173
|
+
place(this.#moveBase, this.#hasMoveAnchor ? this.#moveAnchor : this.#resting);
|
|
174
|
+
place(this.#swing, this.#swingCenter);
|
|
175
|
+
place(this.#grab, this.#grabCenter);
|
|
176
|
+
}
|
|
177
|
+
|
|
178
|
+
#at(pointers: ReadonlyMap<number, ITouchPointer>, center: Vector2, radius: number): boolean {
|
|
179
|
+
const radiusSquared = radius * radius;
|
|
180
|
+
for (const pointer of pointers.values()) {
|
|
181
|
+
if (pointer.position.distanceToSquared(center) <= radiusSquared) return true;
|
|
182
|
+
}
|
|
183
|
+
return false;
|
|
184
|
+
}
|
|
185
|
+
}
|