create-threenative 0.2.3 → 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/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
|
@@ -1,8 +1,46 @@
|
|
|
1
1
|
import { BoxGeometry, CylinderGeometry, Group, type Material, Mesh, SphereGeometry } from "three";
|
|
2
|
+
import { mergeGeometries } from "three/addons/utils/BufferGeometryUtils.js";
|
|
2
3
|
import type { ReturnTypeOfMaterials } from "./types.js";
|
|
3
4
|
|
|
4
5
|
export type RpgMaterials = ReturnTypeOfMaterials;
|
|
5
6
|
|
|
7
|
+
/**
|
|
8
|
+
* Bake rigid pieces down to one mesh per material.
|
|
9
|
+
*
|
|
10
|
+
* Flagstones, wall caps, torch brackets and the bedrock outside the room are a hundred-odd meshes
|
|
11
|
+
* that never move relative to the dungeon; authored one at a time they are a hundred-odd draw
|
|
12
|
+
* calls, and with the shadow pass that doubles. Everything a playtest looks up by name — the
|
|
13
|
+
* floor, the walls, the pillars, the line-of-sight wall — stays its own object.
|
|
14
|
+
*/
|
|
15
|
+
function bake(parts: readonly Mesh[], root: Group): void {
|
|
16
|
+
const byMaterial = new Map<Material, Mesh[]>();
|
|
17
|
+
for (const mesh of parts) {
|
|
18
|
+
const bucket = byMaterial.get(mesh.material as Material);
|
|
19
|
+
if (bucket === undefined) byMaterial.set(mesh.material as Material, [mesh]);
|
|
20
|
+
else bucket.push(mesh);
|
|
21
|
+
}
|
|
22
|
+
for (const [material, meshes] of byMaterial) {
|
|
23
|
+
const geometry = mergeGeometries(
|
|
24
|
+
meshes.map((mesh) => {
|
|
25
|
+
mesh.updateMatrix();
|
|
26
|
+
const placed = mesh.geometry.clone().applyMatrix4(mesh.matrix);
|
|
27
|
+
const cloned = placed.index === null ? placed : placed.toNonIndexed();
|
|
28
|
+
for (const name of Object.keys(cloned.attributes)) {
|
|
29
|
+
if (name !== "position") cloned.deleteAttribute(name);
|
|
30
|
+
}
|
|
31
|
+
return cloned;
|
|
32
|
+
}),
|
|
33
|
+
false,
|
|
34
|
+
);
|
|
35
|
+
if (geometry === null) throw new Error("mergeGeometries returned null baking the dungeon.");
|
|
36
|
+
geometry.computeVertexNormals();
|
|
37
|
+
const merged = new Mesh(geometry, material);
|
|
38
|
+
merged.castShadow = meshes[0]?.castShadow ?? true;
|
|
39
|
+
merged.receiveShadow = true;
|
|
40
|
+
root.add(merged);
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
|
|
6
44
|
function block(
|
|
7
45
|
width: number,
|
|
8
46
|
height: number,
|
|
@@ -19,24 +57,73 @@ function block(
|
|
|
19
57
|
export function createDungeon(materials: RpgMaterials) {
|
|
20
58
|
const group = new Group();
|
|
21
59
|
group.name = "three-room-dungeon";
|
|
60
|
+
const dressing: Mesh[] = [];
|
|
22
61
|
const floor = block(36, 0.3, 12, materials.stone, false);
|
|
23
62
|
floor.name = "dungeon-floor";
|
|
24
63
|
floor.position.set(6, -0.15, 0);
|
|
25
64
|
group.add(floor);
|
|
26
65
|
|
|
66
|
+
// Floor courses: alternating flagstones, so the deck is masonry rather than one flat value.
|
|
67
|
+
for (let index = 0; index < 12; index += 1) {
|
|
68
|
+
const slab = block(2.8, 0.06, 11.4, materials.stoneDark, false);
|
|
69
|
+
slab.position.set(-10.6 + index * 3, 0.02, 0);
|
|
70
|
+
dressing.push(slab);
|
|
71
|
+
}
|
|
72
|
+
|
|
73
|
+
// Walls tall enough to close the shot. At 2.8 the camera — 8.4 up — looked clean over them into
|
|
74
|
+
// the empty sky, and the frame was half black void; a dungeon should be bounded by its walls.
|
|
75
|
+
//
|
|
76
|
+
// The **south** wall is the exception, and stays low. The camera sits behind it, so at full
|
|
77
|
+
// height its inner face filled the bottom-left of every frame and the room was behind it. A
|
|
78
|
+
// near wall you can see over is the oldest trick in an isometric dungeon and it costs one row
|
|
79
|
+
// of this table.
|
|
27
80
|
const walls = [
|
|
28
|
-
{ name: "north-wall", size: [36, 2
|
|
29
|
-
{ name: "south-wall", size: [36, 2.
|
|
30
|
-
{ name: "west-wall", size: [0.
|
|
31
|
-
{ name: "east-wall", size: [0.
|
|
81
|
+
{ name: "north-wall", size: [36, 5.2, 0.5] as const, position: [6, 2.6, -6] as const },
|
|
82
|
+
{ name: "south-wall", size: [36, 2.2, 0.5] as const, position: [6, 1.1, 6] as const },
|
|
83
|
+
{ name: "west-wall", size: [0.5, 5.2, 12] as const, position: [-12, 2.6, 0] as const },
|
|
84
|
+
{ name: "east-wall", size: [0.5, 5.2, 12] as const, position: [24, 2.6, 0] as const },
|
|
32
85
|
].map(({ name, position, size }) => {
|
|
33
86
|
const wall = block(size[0], size[1], size[2], materials.stone);
|
|
34
87
|
wall.name = name;
|
|
35
88
|
wall.position.set(position[0], position[1], position[2]);
|
|
36
89
|
group.add(wall);
|
|
90
|
+
// A darker cap course along the top of every wall: one line that turns a slab into masonry.
|
|
91
|
+
const cap = block(size[0] + 0.24, 0.34, size[2] + 0.24, materials.stoneDark);
|
|
92
|
+
cap.position.set(position[0], position[1] + size[1] / 2 + 0.1, position[2]);
|
|
93
|
+
dressing.push(cap);
|
|
37
94
|
return wall;
|
|
38
95
|
});
|
|
39
96
|
|
|
97
|
+
// Bedrock: a thick mass outside every wall, level with its cap. A dungeon is *cut into* rock,
|
|
98
|
+
// and without this the frame showed black void wherever the follow camera drifted close enough
|
|
99
|
+
// to a wall to see past it — which is most of the level, since the hero starts beside one.
|
|
100
|
+
for (const [width, depth, x, z] of [
|
|
101
|
+
[52, 9, 6, -11.2],
|
|
102
|
+
[52, 9, 6, 11.6],
|
|
103
|
+
[9, 34, -17, 0],
|
|
104
|
+
[9, 34, 29, 0],
|
|
105
|
+
] as const) {
|
|
106
|
+
const mass = block(width, 6.4, depth, materials.stoneDark);
|
|
107
|
+
mass.position.set(x, 2.9, z);
|
|
108
|
+
dressing.push(mass);
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
// Torches down both long walls. The one warm light source a dungeon needs to be a dungeon, and
|
|
112
|
+
// on one wall only the near half of every room sat in the dark.
|
|
113
|
+
for (const side of [-1, 1] as const) {
|
|
114
|
+
for (const x of [-8, -2, 4, 10, 16, 22]) {
|
|
115
|
+
const bracket = new Mesh(new CylinderGeometry(0.06, 0.08, 0.5, 5), materials.stoneDark);
|
|
116
|
+
bracket.position.set(x, 2.2, side * 5.6);
|
|
117
|
+
bracket.rotation.x = side * -0.4;
|
|
118
|
+
bracket.castShadow = true;
|
|
119
|
+
dressing.push(bracket);
|
|
120
|
+
const flame = new Mesh(new SphereGeometry(0.2, 7, 5), materials.flame);
|
|
121
|
+
flame.scale.y = 1.5;
|
|
122
|
+
flame.position.set(x, 2.6, side * 5.35);
|
|
123
|
+
dressing.push(flame);
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
|
|
40
127
|
const roomPillars: Mesh[] = [];
|
|
41
128
|
for (const x of [0, 12]) {
|
|
42
129
|
for (const z of [-4.5, 4.5]) {
|
|
@@ -54,56 +141,128 @@ export function createDungeon(materials: RpgMaterials) {
|
|
|
54
141
|
for (const x of [-6, 6, 18]) {
|
|
55
142
|
const rune = block(3.2, 0.04, 0.08, materials.trim, false);
|
|
56
143
|
rune.position.set(x, 0.025, 0);
|
|
57
|
-
|
|
144
|
+
dressing.push(rune);
|
|
58
145
|
}
|
|
146
|
+
bake(dressing, group);
|
|
59
147
|
return { floor, group, lineOfSightWall, roomPillars, walls };
|
|
60
148
|
}
|
|
61
149
|
|
|
150
|
+
/**
|
|
151
|
+
* The hero: a cloaked figure with a helm, a shield arm and a sword that has a hilt.
|
|
152
|
+
*
|
|
153
|
+
* A 0.72-cube torso with a sphere on top and a thin box beside it is what shipped, and from the
|
|
154
|
+
* dungeon camera it read as a teal box with a stick. The blade keeps the name `held-blade`
|
|
155
|
+
* because the equip playtest looks it up.
|
|
156
|
+
*/
|
|
62
157
|
export function createPlayerVisual(materials: RpgMaterials): Group {
|
|
63
158
|
const group = new Group();
|
|
64
159
|
group.name = "hero-visual";
|
|
65
|
-
const
|
|
66
|
-
|
|
67
|
-
group.add(
|
|
68
|
-
const
|
|
69
|
-
|
|
160
|
+
const torso = block(0.6, 0.7, 0.44, materials.player);
|
|
161
|
+
torso.position.y = 0.92;
|
|
162
|
+
group.add(torso);
|
|
163
|
+
const cloak = block(0.7, 0.9, 0.18, materials.stoneDark);
|
|
164
|
+
cloak.position.set(0, 0.86, 0.24);
|
|
165
|
+
group.add(cloak);
|
|
166
|
+
const belt = block(0.64, 0.12, 0.48, materials.accent);
|
|
167
|
+
belt.position.y = 0.6;
|
|
168
|
+
group.add(belt);
|
|
169
|
+
const head = new Mesh(new SphereGeometry(0.26, 8, 6), materials.player);
|
|
170
|
+
head.position.y = 1.44;
|
|
70
171
|
head.castShadow = true;
|
|
71
172
|
group.add(head);
|
|
72
|
-
const
|
|
73
|
-
|
|
74
|
-
|
|
173
|
+
const helm = block(0.34, 0.18, 0.36, materials.accent);
|
|
174
|
+
helm.position.y = 1.6;
|
|
175
|
+
group.add(helm);
|
|
176
|
+
for (const side of [-1, 1]) {
|
|
177
|
+
const leg = block(0.2, 0.56, 0.24, materials.stoneDark);
|
|
178
|
+
leg.position.set(side * 0.16, 0.28, 0);
|
|
179
|
+
group.add(leg);
|
|
180
|
+
const arm = block(0.16, 0.5, 0.2, materials.player);
|
|
181
|
+
arm.position.set(side * 0.38, 0.94, 0);
|
|
182
|
+
group.add(arm);
|
|
183
|
+
}
|
|
184
|
+
const shield = block(0.1, 0.6, 0.46, materials.accent);
|
|
185
|
+
shield.position.set(-0.48, 0.9, 0.04);
|
|
186
|
+
shield.rotation.z = 0.12;
|
|
187
|
+
group.add(shield);
|
|
188
|
+
|
|
189
|
+
const blade = new Mesh(new BoxGeometry(0.07, 0.86, 0.16), materials.accent);
|
|
190
|
+
blade.name = "held-blade";
|
|
191
|
+
blade.position.set(0.52, 1.06, -0.12);
|
|
192
|
+
blade.rotation.z = -0.28;
|
|
75
193
|
blade.castShadow = true;
|
|
76
194
|
group.add(blade);
|
|
195
|
+
const hilt = block(0.06, 0.14, 0.3, materials.stoneDark);
|
|
196
|
+
hilt.position.set(0.45, 0.68, -0.06);
|
|
197
|
+
hilt.rotation.z = -0.28;
|
|
198
|
+
group.add(hilt);
|
|
77
199
|
return group;
|
|
78
200
|
}
|
|
79
201
|
|
|
202
|
+
/** The hostiles: a hunched brute, and a taller crowned one for the boss. */
|
|
80
203
|
export function createEnemyVisual(materials: RpgMaterials, boss: boolean): Group {
|
|
81
204
|
const group = new Group();
|
|
82
205
|
group.name = boss ? "boss-visual" : "enemy-visual";
|
|
83
|
-
const
|
|
84
|
-
const
|
|
85
|
-
|
|
86
|
-
group.add(
|
|
87
|
-
const
|
|
88
|
-
|
|
206
|
+
const scale = boss ? 1.4 : 1;
|
|
207
|
+
const chest = block(0.86 * scale, 0.66 * scale, 0.6 * scale, materials.enemy);
|
|
208
|
+
chest.position.y = 0.94 * scale;
|
|
209
|
+
group.add(chest);
|
|
210
|
+
const hips = block(0.6 * scale, 0.4 * scale, 0.48 * scale, materials.stoneDark);
|
|
211
|
+
hips.position.y = 0.48 * scale;
|
|
212
|
+
group.add(hips);
|
|
213
|
+
const head = block(0.44 * scale, 0.34 * scale, 0.42 * scale, materials.enemy);
|
|
214
|
+
head.position.set(0, 1.36 * scale, -0.1 * scale);
|
|
215
|
+
group.add(head);
|
|
216
|
+
const eye = new Mesh(new SphereGeometry(0.11 * scale, 6, 4), materials.trim);
|
|
217
|
+
eye.position.set(0, 1.36 * scale, -0.34 * scale);
|
|
89
218
|
eye.castShadow = true;
|
|
90
219
|
group.add(eye);
|
|
220
|
+
for (const side of [-1, 1]) {
|
|
221
|
+
// Horns: the cheapest read that separates a hostile from a crate at dungeon-camera distance.
|
|
222
|
+
const horn = new Mesh(
|
|
223
|
+
new CylinderGeometry(0.02 * scale, 0.09 * scale, 0.4 * scale, 5),
|
|
224
|
+
materials.stoneDark,
|
|
225
|
+
);
|
|
226
|
+
horn.position.set(side * 0.2 * scale, 1.6 * scale, -0.06 * scale);
|
|
227
|
+
horn.rotation.z = side * 0.5;
|
|
228
|
+
horn.castShadow = true;
|
|
229
|
+
group.add(horn);
|
|
230
|
+
const arm = block(0.2 * scale, 0.62 * scale, 0.22 * scale, materials.enemy);
|
|
231
|
+
arm.position.set(side * 0.56 * scale, 0.9 * scale, 0);
|
|
232
|
+
arm.rotation.z = side * -0.16;
|
|
233
|
+
group.add(arm);
|
|
234
|
+
const leg = block(0.24 * scale, 0.44 * scale, 0.28 * scale, materials.stoneDark);
|
|
235
|
+
leg.position.set(side * 0.18 * scale, 0.22 * scale, 0);
|
|
236
|
+
group.add(leg);
|
|
237
|
+
}
|
|
91
238
|
if (boss) {
|
|
92
|
-
const crown = new Mesh(new CylinderGeometry(0.
|
|
93
|
-
crown.position.y = 2.
|
|
239
|
+
const crown = new Mesh(new CylinderGeometry(0.52, 0.3, 0.36, 6), materials.accent);
|
|
240
|
+
crown.position.y = 2.02;
|
|
94
241
|
crown.castShadow = true;
|
|
95
242
|
group.add(crown);
|
|
243
|
+
const mantle = block(1.3, 0.16, 0.9, materials.accent);
|
|
244
|
+
mantle.position.y = 1.78;
|
|
245
|
+
group.add(mantle);
|
|
96
246
|
}
|
|
97
247
|
return group;
|
|
98
248
|
}
|
|
99
249
|
|
|
250
|
+
/** Loot: a banded chest with a lit gem in its lid. A plinth with a marble on it read as neither. */
|
|
100
251
|
export function createLootVisual(materials: RpgMaterials): Group {
|
|
101
252
|
const group = new Group();
|
|
102
|
-
const
|
|
103
|
-
|
|
104
|
-
group.add(
|
|
105
|
-
const
|
|
106
|
-
|
|
253
|
+
const body = block(0.66, 0.36, 0.46, materials.stoneDark);
|
|
254
|
+
body.position.y = 0.18;
|
|
255
|
+
group.add(body);
|
|
256
|
+
const lid = block(0.7, 0.16, 0.5, materials.accent);
|
|
257
|
+
lid.position.y = 0.44;
|
|
258
|
+
group.add(lid);
|
|
259
|
+
for (const x of [-0.22, 0.22]) {
|
|
260
|
+
const band = block(0.07, 0.5, 0.52, materials.accent);
|
|
261
|
+
band.position.set(x, 0.24, 0);
|
|
262
|
+
group.add(band);
|
|
263
|
+
}
|
|
264
|
+
const gem = new Mesh(new SphereGeometry(0.13, 7, 5), materials.player);
|
|
265
|
+
gem.position.y = 0.58;
|
|
107
266
|
gem.castShadow = true;
|
|
108
267
|
group.add(gem);
|
|
109
268
|
return group;
|
|
@@ -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 abilityPressed: boolean;
|
|
29
|
+
readonly attackPressed: 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: "ability" | "attack" | "move"): Vector2 {
|
|
52
|
+
if (name === "move") return new Vector2(MOVE_RADIUS + EDGE, size.height - MOVE_RADIUS - EDGE);
|
|
53
|
+
const yOffset = name === "ability" ? 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: { abilityPressed: boolean; attackPressed: boolean; move: Vector2 } = {
|
|
65
|
+
abilityPressed: false,
|
|
66
|
+
attackPressed: false,
|
|
67
|
+
move: new Vector2(),
|
|
68
|
+
};
|
|
69
|
+
#wasAbility = false;
|
|
70
|
+
#wasAttack = false;
|
|
71
|
+
#moveAnchor = new Vector2();
|
|
72
|
+
#resting = new Vector2();
|
|
73
|
+
#abilityCenter = new Vector2();
|
|
74
|
+
#attackCenter = new Vector2();
|
|
75
|
+
#hasMoveAnchor = false;
|
|
76
|
+
#lastWidth = -1;
|
|
77
|
+
#lastHeight = -1;
|
|
78
|
+
#moveBase: Mesh;
|
|
79
|
+
#moveKnob: Mesh;
|
|
80
|
+
#ability: Mesh;
|
|
81
|
+
#attack: Mesh;
|
|
82
|
+
#idleMaterial: MeshBasicMaterial;
|
|
83
|
+
#activeMaterial: MeshBasicMaterial;
|
|
84
|
+
|
|
85
|
+
constructor(camera: PerspectiveCamera) {
|
|
86
|
+
this.#camera = camera;
|
|
87
|
+
this.#idleMaterial = overlayMaterial(palette.stone, 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.#ability = ringMesh(BUTTON_RADIUS, this.#idleMaterial);
|
|
92
|
+
this.#attack = ringMesh(BUTTON_RADIUS, this.#idleMaterial);
|
|
93
|
+
this.root.add(this.#moveBase, this.#moveKnob, this.#ability, this.#attack);
|
|
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 attack = this.#at(pointers, this.#attackCenter, BUTTON_RADIUS);
|
|
101
|
+
const ability = this.#at(pointers, this.#abilityCenter, 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.#ability.material = ability ? this.#activeMaterial : this.#idleMaterial;
|
|
133
|
+
this.#attack.material = attack ? this.#activeMaterial : this.#idleMaterial;
|
|
134
|
+
this.#input.abilityPressed = ability && !this.#wasAbility;
|
|
135
|
+
this.#input.attackPressed = attack && !this.#wasAttack;
|
|
136
|
+
this.#wasAbility = ability;
|
|
137
|
+
this.#wasAttack = attack;
|
|
138
|
+
this.#layout(size);
|
|
139
|
+
return this.#input;
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
debug(): Record<string, unknown> {
|
|
143
|
+
return {
|
|
144
|
+
ability: this.#wasAbility,
|
|
145
|
+
attack: this.#wasAttack,
|
|
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.#abilityCenter.copy(controlPoint(size, "ability"));
|
|
165
|
+
this.#attackCenter.copy(controlPoint(size, "attack"));
|
|
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.#ability, this.#abilityCenter);
|
|
175
|
+
place(this.#attack, this.#attackCenter);
|
|
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
|
+
}
|