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,164 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "weapon-cycle",
|
|
3
|
+
"target": "web",
|
|
4
|
+
"schemaVersion": 1,
|
|
5
|
+
"viewport": {
|
|
6
|
+
"width": 1280,
|
|
7
|
+
"height": 720
|
|
8
|
+
},
|
|
9
|
+
"warmupFrames": 30,
|
|
10
|
+
"subject": "player",
|
|
11
|
+
"steps": [
|
|
12
|
+
{
|
|
13
|
+
"kind": "wait",
|
|
14
|
+
"label": "loaded",
|
|
15
|
+
"waitTicks": 4,
|
|
16
|
+
"release": true
|
|
17
|
+
},
|
|
18
|
+
{
|
|
19
|
+
"kind": "input",
|
|
20
|
+
"label": "hold-trigger",
|
|
21
|
+
"press": "KeyF",
|
|
22
|
+
"holdTicks": 61,
|
|
23
|
+
"release": true
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"kind": "wait",
|
|
27
|
+
"label": "burst-settled",
|
|
28
|
+
"waitTicks": 6,
|
|
29
|
+
"release": true,
|
|
30
|
+
"screenshot": "hip-fire"
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
"kind": "input",
|
|
34
|
+
"label": "reload",
|
|
35
|
+
"press": "KeyR",
|
|
36
|
+
"holdTicks": 2,
|
|
37
|
+
"release": true
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"kind": "wait",
|
|
41
|
+
"label": "reloading",
|
|
42
|
+
"waitTicks": 20,
|
|
43
|
+
"release": true
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
"kind": "wait",
|
|
47
|
+
"label": "reloaded",
|
|
48
|
+
"waitTicks": 60,
|
|
49
|
+
"release": true
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"kind": "input",
|
|
53
|
+
"label": "aim",
|
|
54
|
+
"press": "KeyQ",
|
|
55
|
+
"holdTicks": 40,
|
|
56
|
+
"release": false
|
|
57
|
+
},
|
|
58
|
+
{
|
|
59
|
+
"kind": "wait",
|
|
60
|
+
"label": "aimed",
|
|
61
|
+
"waitTicks": 12,
|
|
62
|
+
"release": true
|
|
63
|
+
}
|
|
64
|
+
],
|
|
65
|
+
"assert": {
|
|
66
|
+
"diagnostics": {
|
|
67
|
+
"noNetworkErrors": true,
|
|
68
|
+
"noRuntimeDiagnostics": false,
|
|
69
|
+
"runtimeDiagnosticsOptOutReason": "Headless Linux Chromium emits the known WebGPU buffer diagnostic; the weapon-state assertions remain authoritative.",
|
|
70
|
+
"runtimeReady": true
|
|
71
|
+
},
|
|
72
|
+
"resources": [
|
|
73
|
+
{
|
|
74
|
+
"id": "state",
|
|
75
|
+
"path": "ammo",
|
|
76
|
+
"atSteps": [
|
|
77
|
+
{
|
|
78
|
+
"label": "reloaded",
|
|
79
|
+
"equals": 30
|
|
80
|
+
}
|
|
81
|
+
]
|
|
82
|
+
},
|
|
83
|
+
{
|
|
84
|
+
"id": "state",
|
|
85
|
+
"path": "reserve",
|
|
86
|
+
"lte": 115,
|
|
87
|
+
"changed": true
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
"id": "state",
|
|
91
|
+
"path": "reloading",
|
|
92
|
+
"atSteps": [
|
|
93
|
+
{
|
|
94
|
+
"label": "reloading",
|
|
95
|
+
"equals": 1
|
|
96
|
+
},
|
|
97
|
+
{
|
|
98
|
+
"label": "reloaded",
|
|
99
|
+
"equals": 0
|
|
100
|
+
}
|
|
101
|
+
]
|
|
102
|
+
},
|
|
103
|
+
{
|
|
104
|
+
"id": "state",
|
|
105
|
+
"path": "aiming",
|
|
106
|
+
"atSteps": [
|
|
107
|
+
{
|
|
108
|
+
"label": "aimed",
|
|
109
|
+
"equals": 1
|
|
110
|
+
}
|
|
111
|
+
]
|
|
112
|
+
}
|
|
113
|
+
],
|
|
114
|
+
"components": [
|
|
115
|
+
{
|
|
116
|
+
"entity": "player",
|
|
117
|
+
"component": "aiming",
|
|
118
|
+
"atSteps": [
|
|
119
|
+
{
|
|
120
|
+
"label": "aimed",
|
|
121
|
+
"equals": 1
|
|
122
|
+
}
|
|
123
|
+
]
|
|
124
|
+
},
|
|
125
|
+
{
|
|
126
|
+
"entity": "player",
|
|
127
|
+
"component": "fov",
|
|
128
|
+
"lte": 45,
|
|
129
|
+
"changed": true
|
|
130
|
+
},
|
|
131
|
+
{
|
|
132
|
+
"entity": "decals",
|
|
133
|
+
"component": "placed",
|
|
134
|
+
"gte": 1,
|
|
135
|
+
"changed": true
|
|
136
|
+
},
|
|
137
|
+
{
|
|
138
|
+
"entity": "viewmodel",
|
|
139
|
+
"component": "flashOpacity",
|
|
140
|
+
"lte": 0.01,
|
|
141
|
+
"allowTrivial": "The cone is dark before the first round and dark again once it retires; this row exists to catch the flash that never retires, and the fired signals prove rounds were sent."
|
|
142
|
+
}
|
|
143
|
+
],
|
|
144
|
+
"signals": [
|
|
145
|
+
{
|
|
146
|
+
"name": "fired",
|
|
147
|
+
"entity": "player",
|
|
148
|
+
"minCount": 5,
|
|
149
|
+
"atStep": "hold-trigger"
|
|
150
|
+
},
|
|
151
|
+
{
|
|
152
|
+
"name": "reload-started",
|
|
153
|
+
"entity": "player",
|
|
154
|
+
"minCount": 1,
|
|
155
|
+
"atStep": "reload"
|
|
156
|
+
},
|
|
157
|
+
{
|
|
158
|
+
"name": "reloaded",
|
|
159
|
+
"entity": "player",
|
|
160
|
+
"minCount": 1
|
|
161
|
+
}
|
|
162
|
+
]
|
|
163
|
+
}
|
|
164
|
+
}
|
|
@@ -3,7 +3,6 @@ import { CollisionShape3D } from "@threenative/physics";
|
|
|
3
3
|
import type { Vector3 } from "three";
|
|
4
4
|
import { HOSTILE_LAYER } from "../entities/Player.js";
|
|
5
5
|
import type { Target } from "../entities/Target.js";
|
|
6
|
-
import { directSpaceState } from "../physics.js";
|
|
7
6
|
|
|
8
7
|
export function applyDirectDamage(
|
|
9
8
|
targets: ReadonlyMap<number, Target>,
|
|
@@ -21,7 +20,7 @@ export function applyRadiusDamage(
|
|
|
21
20
|
amount: number,
|
|
22
21
|
targets: ReadonlyMap<number, Target>,
|
|
23
22
|
): Set<number> {
|
|
24
|
-
const hits =
|
|
23
|
+
const hits = physics.directSpaceState.intersectShape({
|
|
25
24
|
collisionMask: HOSTILE_LAYER,
|
|
26
25
|
maxResults: 16,
|
|
27
26
|
position: centre,
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import { GroundSnap, attachToBone, normaliseToMetres, skeletonBones } from "@threenative/core";
|
|
2
|
+
import { Bone, type Group } from "three";
|
|
3
|
+
import { scale } from "./render/scale.js";
|
|
4
|
+
|
|
5
|
+
export interface IShooterConventions {
|
|
6
|
+
readonly applyGrounding: (surfaceY: number, dt: number) => void;
|
|
7
|
+
readonly attachedBone: string;
|
|
8
|
+
readonly boneNames: readonly string[];
|
|
9
|
+
readonly groundSnap: GroundSnap;
|
|
10
|
+
readonly normaliseFactor: number;
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* The three conventions this kit turns on, in one place.
|
|
15
|
+
*
|
|
16
|
+
* - `normaliseToMetres` sizes the carbine. The viewmodel is authored at whatever size was
|
|
17
|
+
* convenient to lay out; the metre table in `render/scale.ts` decides what it actually is, so a
|
|
18
|
+
* replacement model dropped in from an asset site lands at the same size without a magic number
|
|
19
|
+
* beside it.
|
|
20
|
+
* - `attachToBone` puts the weapon in the hand that holds it. The hand is a real `Bone`, so
|
|
21
|
+
* swapping the procedural arms for a rigged pair keeps the same call.
|
|
22
|
+
* - `GroundSnap` keeps the boots on the floor. In first person you only see them when you look
|
|
23
|
+
* down, which is exactly when a hovering foot is obvious.
|
|
24
|
+
*
|
|
25
|
+
* Every one of them reports honestly when overridden: `groundSnap.enabled = false` keeps measuring
|
|
26
|
+
* and keeps `clearance` truthful.
|
|
27
|
+
*/
|
|
28
|
+
export function preparePlayerConventions(viewmodel: Group, legs: Group): IShooterConventions {
|
|
29
|
+
const weapon = viewmodel.getObjectByName("held-rifle");
|
|
30
|
+
if (weapon === undefined) throw new Error("Shooter viewmodel is missing its held rifle.");
|
|
31
|
+
|
|
32
|
+
const normaliseFactor = normaliseToMetres(weapon, { axis: "longest", metres: scale.rifleLength });
|
|
33
|
+
const hand = new Bone();
|
|
34
|
+
hand.name = "RightHand";
|
|
35
|
+
hand.position.copy(weapon.position);
|
|
36
|
+
hand.rotation.copy(weapon.rotation);
|
|
37
|
+
viewmodel.add(hand);
|
|
38
|
+
weapon.position.set(0, 0, 0);
|
|
39
|
+
weapon.rotation.set(0, 0, 0);
|
|
40
|
+
|
|
41
|
+
const boneNames = skeletonBones(viewmodel);
|
|
42
|
+
attachToBone(viewmodel, "RightHand", weapon);
|
|
43
|
+
const groundSnap = new GroundSnap(legs);
|
|
44
|
+
return {
|
|
45
|
+
applyGrounding: (surfaceY, dt) => groundSnap.apply(legs, surfaceY, dt),
|
|
46
|
+
attachedBone: weapon.parent?.name ?? "",
|
|
47
|
+
boneNames,
|
|
48
|
+
groundSnap,
|
|
49
|
+
normaliseFactor,
|
|
50
|
+
};
|
|
51
|
+
}
|
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
import type { ICtx } from "@threenative/core";
|
|
2
2
|
import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
|
|
3
|
-
import { type
|
|
4
|
-
import {
|
|
3
|
+
import { Group, MathUtils, type PerspectiveCamera, Vector3 } from "three";
|
|
4
|
+
import { type IShooterConventions, preparePlayerConventions } from "../conventions.js";
|
|
5
|
+
import { scale } from "../render/scale.js";
|
|
6
|
+
import { createLegsVisual, createViewmodelVisual } from "../render/shapes.js";
|
|
7
|
+
import type { ITouchInput } from "../render/touch-controls.js";
|
|
5
8
|
import type { GameState } from "../state.js";
|
|
6
9
|
|
|
7
10
|
export const WORLD_LAYER = 1;
|
|
@@ -12,46 +15,249 @@ export const PROJECTILE_LAYER = 16;
|
|
|
12
15
|
|
|
13
16
|
type GameCtx = ICtx<GameState, IPhysicsContext>;
|
|
14
17
|
|
|
15
|
-
const
|
|
16
|
-
const
|
|
18
|
+
const BODY_Y = scale.humanHeight / 2;
|
|
19
|
+
const SPAWN = new Vector3(0, BODY_Y, 5);
|
|
20
|
+
const WALK_SPEED = 4.2;
|
|
21
|
+
const SPRINT_SPEED = 6.6;
|
|
22
|
+
/** Crouched movement. A crouch that only lowers the eye is a camera trick, not a stance. */
|
|
23
|
+
const CROUCH_SPEED = 2.2;
|
|
24
|
+
/** How fast the stance folds and unfolds. Fast enough to peek with, slow enough to see. */
|
|
25
|
+
const CROUCH_RATE = 11;
|
|
26
|
+
const FOV_HIP = 72;
|
|
27
|
+
const FOV_AIM = 34;
|
|
28
|
+
const PITCH_MIN = MathUtils.degToRad(-72);
|
|
29
|
+
const PITCH_MAX = MathUtils.degToRad(72);
|
|
30
|
+
/** Relative pointer pixels to radians. The delta is already per-frame, so nothing scales by dt. */
|
|
31
|
+
const LOOK_RADIANS_PER_PIXEL = 0.005;
|
|
32
|
+
/** Down the sights the same hand movement should cover less angle. */
|
|
33
|
+
const AIM_SENSITIVITY = 0.5;
|
|
34
|
+
const CAPSULE_RADIUS = scale.shoulderWidth / 2;
|
|
35
|
+
const CAPSULE_HALF = (scale.humanHeight - CAPSULE_RADIUS * 2) / 2;
|
|
36
|
+
/** Metres of stride between planted feet, walking. Sprint covers it sooner, so it sounds faster. */
|
|
37
|
+
const STRIDE_METRES = 0.82;
|
|
17
38
|
|
|
39
|
+
/**
|
|
40
|
+
* Yaw and pitch, integrated from the `look` action.
|
|
41
|
+
*
|
|
42
|
+
* `look` is bound `pointerRelative`, so `ctx.input.vector("look")` is the pointer delta for this
|
|
43
|
+
* tick in canvas pixels. The framework owns the pointer lock and the native equivalent, so nothing
|
|
44
|
+
* in this game reads `movementX` or touches the DOM.
|
|
45
|
+
*/
|
|
46
|
+
class Look {
|
|
47
|
+
yaw = 0;
|
|
48
|
+
pitch = 0;
|
|
49
|
+
|
|
50
|
+
/** Applied by both paths: mouse deltas and the right thumb, which has no lock to earn. */
|
|
51
|
+
applyDelta(dx: number, dy: number, sensitivity: number): void {
|
|
52
|
+
if (dx === 0 && dy === 0) return;
|
|
53
|
+
this.yaw -= dx * LOOK_RADIANS_PER_PIXEL * sensitivity;
|
|
54
|
+
this.pitch = MathUtils.clamp(
|
|
55
|
+
this.pitch - dy * LOOK_RADIANS_PER_PIXEL * sensitivity,
|
|
56
|
+
PITCH_MIN,
|
|
57
|
+
PITCH_MAX,
|
|
58
|
+
);
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* The player, seen from behind their own eyes.
|
|
64
|
+
*
|
|
65
|
+
* The body is a capsule the physics solver owns; the camera is placed from it once the solver has
|
|
66
|
+
* written the step (see `syncCamera` and the `afterPhysics` call in `scenes/Play.ts`). The
|
|
67
|
+
* viewmodel hangs off the camera, so the weapon is always in frame no matter how the body is
|
|
68
|
+
* being shoved around.
|
|
69
|
+
*/
|
|
18
70
|
export class Player {
|
|
19
71
|
readonly mesh: Group;
|
|
72
|
+
/** The weapon and hands, parented to the camera. */
|
|
73
|
+
readonly visual: Group;
|
|
74
|
+
/** The part of the player their own eyes can see, parented to the body. */
|
|
75
|
+
readonly legs: Group;
|
|
20
76
|
readonly body: CharacterBody3D;
|
|
77
|
+
readonly look = new Look();
|
|
21
78
|
readonly maxHealth = 100;
|
|
22
79
|
health = 100;
|
|
23
80
|
dead = false;
|
|
81
|
+
aiming = false;
|
|
82
|
+
crouching = false;
|
|
83
|
+
sprinting = false;
|
|
84
|
+
/** Metres walked. The scene does not read it; a scenario can, through `debug()`. */
|
|
85
|
+
distanceMoved = 0;
|
|
86
|
+
/** Fired each time a stride completes, so footsteps keep pace with speed rather than time. */
|
|
87
|
+
onFootstep: ((sprinting: boolean) => void) | undefined;
|
|
24
88
|
#onDamage: (amount: number) => void;
|
|
25
89
|
#onDeath: () => void;
|
|
90
|
+
#conventions: IShooterConventions;
|
|
91
|
+
#camera: PerspectiveCamera;
|
|
92
|
+
/** 0 standing, 1 fully folded. Eased, so the eye slides rather than teleports. */
|
|
93
|
+
#crouch = 0;
|
|
94
|
+
#fov = FOV_HIP;
|
|
95
|
+
#lastX = SPAWN.x;
|
|
96
|
+
#lastZ = SPAWN.z;
|
|
97
|
+
#strideAccumulated = 0;
|
|
98
|
+
#moving = 0;
|
|
26
99
|
|
|
27
100
|
constructor(
|
|
28
101
|
ctx: GameCtx,
|
|
29
|
-
|
|
102
|
+
camera: PerspectiveCamera,
|
|
103
|
+
materials: Parameters<typeof createViewmodelVisual>[0],
|
|
30
104
|
spawn: Vector3 = SPAWN,
|
|
31
105
|
onDamage: (amount: number) => void = () => undefined,
|
|
32
106
|
onDeath: () => void = () => undefined,
|
|
33
107
|
) {
|
|
108
|
+
this.#camera = camera;
|
|
34
109
|
this.#onDamage = onDamage;
|
|
35
110
|
this.#onDeath = onDeath;
|
|
36
|
-
this.mesh =
|
|
111
|
+
this.mesh = new Group();
|
|
112
|
+
this.mesh.name = "player";
|
|
37
113
|
this.mesh.position.copy(spawn);
|
|
38
114
|
ctx.add(this.mesh);
|
|
115
|
+
// Two visuals, in two spaces. The viewmodel hangs off the camera so the weapon is always in
|
|
116
|
+
// frame; the legs hang off the body so looking down shows a person standing on the floor
|
|
117
|
+
// rather than a floating gun.
|
|
118
|
+
this.visual = createViewmodelVisual(materials);
|
|
119
|
+
camera.add(this.visual);
|
|
120
|
+
this.legs = createLegsVisual(materials);
|
|
121
|
+
this.mesh.add(this.legs);
|
|
122
|
+
this.#conventions = preparePlayerConventions(this.visual, this.legs);
|
|
39
123
|
this.body = new CharacterBody3D({
|
|
40
124
|
collisionLayer: PLAYER_LAYER,
|
|
41
125
|
collisionMask: WORLD_LAYER | HOSTILE_LAYER,
|
|
42
|
-
autostep: { maxHeight: 0.
|
|
126
|
+
autostep: { maxHeight: 0.35, minWidth: 0.18 },
|
|
43
127
|
object: this.mesh,
|
|
44
128
|
physics: ctx.physics,
|
|
45
|
-
shape: CollisionShape3D.capsule(
|
|
129
|
+
shape: CollisionShape3D.capsule(CAPSULE_RADIUS, CAPSULE_HALF),
|
|
46
130
|
});
|
|
131
|
+
camera.fov = FOV_HIP;
|
|
132
|
+
camera.near = 0.02;
|
|
133
|
+
camera.far = 120;
|
|
134
|
+
camera.updateProjectionMatrix();
|
|
135
|
+
this.syncCamera();
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
/** Where the eye is right now, crouch included. */
|
|
139
|
+
get eyeHeight(): number {
|
|
140
|
+
return scale.eyeHeight - BODY_Y - this.#crouch * scale.crouchDrop;
|
|
141
|
+
}
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* Heading, in degrees turned to the right of the spawn facing.
|
|
145
|
+
*
|
|
146
|
+
* Reported rather than `look.yaw` itself because the two have opposite signs: Three turns left
|
|
147
|
+
* for a positive rotation about +y, and a player who moved the mouse right expects a positive
|
|
148
|
+
* number back. The HUD and the scenarios read this one.
|
|
149
|
+
*/
|
|
150
|
+
get yawDegrees(): number {
|
|
151
|
+
return -MathUtils.radToDeg(this.look.yaw);
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
/** Elevation, in degrees above the horizon. Positive is up, matching the same expectation. */
|
|
155
|
+
get pitchDegrees(): number {
|
|
156
|
+
return MathUtils.radToDeg(this.look.pitch);
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/** How hard the player is moving, 0 to 1. The viewmodel reads this for its bob. */
|
|
160
|
+
get moving(): number {
|
|
161
|
+
return this.#moving;
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
/**
|
|
165
|
+
* The camera basis is the single source of aim truth.
|
|
166
|
+
*
|
|
167
|
+
* Every shot starts here rather than from a muzzle offset, because the crosshair is drawn at the
|
|
168
|
+
* centre of this basis: a round that starts anywhere else lands somewhere the player did not aim.
|
|
169
|
+
* The viewmodel's barrel is then converged onto this ray, not the other way round.
|
|
170
|
+
*/
|
|
171
|
+
aimRay(): { origin: Vector3; direction: Vector3 } {
|
|
172
|
+
this.#camera.updateMatrixWorld(true);
|
|
173
|
+
return {
|
|
174
|
+
origin: this.#camera.getWorldPosition(new Vector3()),
|
|
175
|
+
direction: this.#camera.getWorldDirection(new Vector3()).normalize(),
|
|
176
|
+
};
|
|
47
177
|
}
|
|
48
178
|
|
|
49
|
-
|
|
179
|
+
/**
|
|
180
|
+
* Place the camera at the eye.
|
|
181
|
+
*
|
|
182
|
+
* Called from `afterPhysics`, never from `update`: `moveAndSlide` only queues the motion, and the
|
|
183
|
+
* rapier plugin writes the solved transform after the frame callback returns. Reading
|
|
184
|
+
* `mesh.position` inside `update` places the eye one physics step behind the body — invisible on
|
|
185
|
+
* flat ground and a third of a metre low on a step, which is how a shot aimed at a target ends
|
|
186
|
+
* up in the floor underfoot.
|
|
187
|
+
*/
|
|
188
|
+
syncCamera(): void {
|
|
189
|
+
this.#camera.position.set(
|
|
190
|
+
this.mesh.position.x,
|
|
191
|
+
this.mesh.position.y + this.eyeHeight,
|
|
192
|
+
this.mesh.position.z,
|
|
193
|
+
);
|
|
194
|
+
this.#camera.rotation.set(this.look.pitch, this.look.yaw, 0, "YXZ");
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
update(ctx: GameCtx, dt: number, touch?: ITouchInput): void {
|
|
50
198
|
if (this.dead) return;
|
|
51
|
-
|
|
52
|
-
this.
|
|
53
|
-
this
|
|
199
|
+
this.aiming = ctx.input.pressed("aim") || touch?.aimPressed === true;
|
|
200
|
+
this.crouching = ctx.input.pressed("crouch") || touch?.crouchPressed === true;
|
|
201
|
+
this.#crouch = MathUtils.damp(this.#crouch, this.crouching ? 1 : 0, CROUCH_RATE, dt);
|
|
202
|
+
|
|
203
|
+
const sensitivity = this.aiming ? AIM_SENSITIVITY : 1;
|
|
204
|
+
const look = ctx.input.vector("look");
|
|
205
|
+
this.look.applyDelta(look.x, look.y, sensitivity);
|
|
206
|
+
if (touch !== undefined) this.look.applyDelta(touch.aim.x * 12, touch.aim.y * 12, sensitivity);
|
|
207
|
+
|
|
208
|
+
const keyboard = ctx.input.vector("move");
|
|
209
|
+
const moveX = MathUtils.clamp(keyboard.x + (touch?.move.x ?? 0), -1, 1);
|
|
210
|
+
const moveY = MathUtils.clamp(keyboard.y + (touch?.move.y ?? 0), -1, 1);
|
|
211
|
+
// Sprint arrives as its own flag rather than as a longer move vector, so the two vetoes below
|
|
212
|
+
// apply to a thumb and to Shift alike. Crouch wins: holding both should not sprint at a
|
|
213
|
+
// crouch-walk's silhouette.
|
|
214
|
+
const sprintAsked = ctx.input.pressed("sprint") || touch?.sprintPressed === true;
|
|
215
|
+
this.sprinting = sprintAsked && !this.aiming && !this.crouching;
|
|
216
|
+
const speed = this.crouching ? CROUCH_SPEED : this.sprinting ? SPRINT_SPEED : WALK_SPEED;
|
|
217
|
+
|
|
218
|
+
// `vector().y` is +up on the stick; forward on this ground plane is -z at yaw 0.
|
|
219
|
+
const forwardX = -Math.sin(this.look.yaw);
|
|
220
|
+
const forwardZ = -Math.cos(this.look.yaw);
|
|
221
|
+
const rightX = Math.cos(this.look.yaw);
|
|
222
|
+
const rightZ = -Math.sin(this.look.yaw);
|
|
223
|
+
let vx = forwardX * moveY + rightX * moveX;
|
|
224
|
+
let vz = forwardZ * moveY + rightZ * moveX;
|
|
225
|
+
const length = Math.hypot(vx, vz);
|
|
226
|
+
if (length > 1e-4) {
|
|
227
|
+
vx = (vx / length) * speed;
|
|
228
|
+
vz = (vz / length) * speed;
|
|
229
|
+
} else {
|
|
230
|
+
vx = 0;
|
|
231
|
+
vz = 0;
|
|
232
|
+
}
|
|
233
|
+
this.#moving = length > 1e-4 ? speed / SPRINT_SPEED : 0;
|
|
234
|
+
|
|
235
|
+
// The backend writes the solved transform after the step, so measuring the mesh either side of
|
|
236
|
+
// `moveAndSlide` in one frame always reads zero. Compare against the previous frame instead.
|
|
237
|
+
const stride = Math.hypot(
|
|
238
|
+
this.mesh.position.x - this.#lastX,
|
|
239
|
+
this.mesh.position.z - this.#lastZ,
|
|
240
|
+
);
|
|
241
|
+
this.distanceMoved += stride;
|
|
242
|
+
this.#strideAccumulated += stride;
|
|
243
|
+
if (length > 1e-4 && this.#strideAccumulated >= STRIDE_METRES) {
|
|
244
|
+
this.#strideAccumulated = 0;
|
|
245
|
+
this.onFootstep?.(this.sprinting);
|
|
246
|
+
}
|
|
247
|
+
this.#lastX = this.mesh.position.x;
|
|
248
|
+
this.#lastZ = this.mesh.position.z;
|
|
249
|
+
|
|
250
|
+
this.body.velocity.x = vx;
|
|
251
|
+
this.body.velocity.z = vz;
|
|
54
252
|
this.body.moveAndSlide(dt);
|
|
253
|
+
this.#conventions.applyGrounding(0, dt);
|
|
254
|
+
|
|
255
|
+
const wanted = this.aiming ? FOV_AIM : FOV_HIP;
|
|
256
|
+
this.#fov = MathUtils.damp(this.#fov, wanted, 14, dt);
|
|
257
|
+
if (Math.abs(this.#camera.fov - this.#fov) > 0.01) {
|
|
258
|
+
this.#camera.fov = this.#fov;
|
|
259
|
+
this.#camera.updateProjectionMatrix();
|
|
260
|
+
}
|
|
55
261
|
}
|
|
56
262
|
|
|
57
263
|
takeDamage(amount: number): void {
|
|
@@ -60,7 +266,8 @@ export class Player {
|
|
|
60
266
|
this.#onDamage(amount);
|
|
61
267
|
if (this.health > 0) return;
|
|
62
268
|
this.dead = true;
|
|
63
|
-
this.
|
|
269
|
+
this.visual.visible = false;
|
|
270
|
+
this.legs.visible = false;
|
|
64
271
|
this.body.velocity.set(0, 0, 0);
|
|
65
272
|
this.#onDeath();
|
|
66
273
|
}
|
|
@@ -69,23 +276,33 @@ export class Player {
|
|
|
69
276
|
this.body.teleport(spawn);
|
|
70
277
|
this.health = 40;
|
|
71
278
|
this.dead = false;
|
|
72
|
-
this.
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
aimOrigin(): Vector3 {
|
|
76
|
-
return this.mesh.position.clone().add(new Vector3(0, 0.72, -0.72));
|
|
279
|
+
this.visual.visible = true;
|
|
280
|
+
this.legs.visible = true;
|
|
281
|
+
this.syncCamera();
|
|
77
282
|
}
|
|
78
283
|
|
|
79
284
|
debug(): Record<string, unknown> {
|
|
80
285
|
return {
|
|
286
|
+
aiming: this.aiming ? 1 : 0,
|
|
287
|
+
crouching: this.crouching ? 1 : 0,
|
|
81
288
|
dead: this.dead,
|
|
289
|
+
distanceMoved: this.distanceMoved,
|
|
290
|
+
fov: this.#camera.fov,
|
|
291
|
+
groundClearance: this.#conventions.groundSnap.clearance,
|
|
82
292
|
health: this.health,
|
|
293
|
+
normaliseFactor: this.#conventions.normaliseFactor,
|
|
294
|
+
pitchDegrees: this.pitchDegrees,
|
|
83
295
|
position: this.mesh.position.toArray(),
|
|
296
|
+
skeletonBones: this.#conventions.boneNames,
|
|
297
|
+
weaponBone: this.#conventions.attachedBone,
|
|
298
|
+
yawDegrees: this.yawDegrees,
|
|
84
299
|
};
|
|
85
300
|
}
|
|
86
301
|
|
|
87
302
|
dispose(): void {
|
|
88
303
|
this.body.dispose();
|
|
304
|
+
this.visual.removeFromParent();
|
|
305
|
+
this.legs.removeFromParent();
|
|
89
306
|
this.mesh.removeFromParent();
|
|
90
307
|
}
|
|
91
308
|
}
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { ICtx, ScheduleHandle } from "@threenative/core";
|
|
2
2
|
import { CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
|
|
3
3
|
import { type Group, Vector3 } from "three";
|
|
4
|
-
|
|
4
|
+
|
|
5
5
|
import { createTargetVisual } from "../render/shapes.js";
|
|
6
6
|
import type { GameState } from "../state.js";
|
|
7
7
|
import { HOSTILE_LAYER, PLAYER_LAYER, WORLD_LAYER } from "./Player.js";
|
|
@@ -54,7 +54,7 @@ export class Target {
|
|
|
54
54
|
const scan = (): void => {
|
|
55
55
|
if (!this.alive) return;
|
|
56
56
|
this.scanCount += 1;
|
|
57
|
-
const hits =
|
|
57
|
+
const hits = ctx.physics.directSpaceState.intersectShape({
|
|
58
58
|
collisionMask: PLAYER_LAYER,
|
|
59
59
|
maxResults: 4,
|
|
60
60
|
position: this.mesh.position,
|
|
@@ -18,15 +18,24 @@ const game = defineGame<GameState, IPhysicsContext>({
|
|
|
18
18
|
right: ["ArrowRight", "KeyD"],
|
|
19
19
|
up: ["ArrowUp", "KeyW"],
|
|
20
20
|
},
|
|
21
|
-
|
|
21
|
+
// Down the sights. The right mouse button is the mouse binding every shooter uses; KeyQ is
|
|
22
|
+
// here so a scenario — and a keyboard-only player — can hold it without a pointer.
|
|
23
|
+
aim: { keys: ["KeyQ"], mouseButtons: [2] },
|
|
22
24
|
blast: { keys: ["KeyE"], buttons: [2] },
|
|
25
|
+
// Ctrl is the conventional crouch and is routinely eaten by the window manager, so KeyC is a
|
|
26
|
+
// second binding rather than a replacement.
|
|
27
|
+
crouch: { keys: ["ControlLeft", "ControlRight", "KeyC"] },
|
|
23
28
|
damage: { keys: ["KeyH"] },
|
|
24
|
-
fire: { buttons: [0], keys: ["KeyF"], mouseButtons: [0] },
|
|
29
|
+
fire: { buttons: [0], keys: ["KeyF", "Space"], mouseButtons: [0] },
|
|
25
30
|
look: { pointerRelative: true },
|
|
26
31
|
lethal: { keys: ["KeyX"] },
|
|
27
|
-
probe: { keys: ["
|
|
32
|
+
probe: { keys: ["KeyV"] },
|
|
28
33
|
projectile: { buttons: [1], keys: ["KeyG"] },
|
|
29
|
-
|
|
34
|
+
reload: { buttons: [3], keys: ["KeyR"] },
|
|
35
|
+
// Enter, not KeyR: R is the reload key in every shooter, and a player who taps it to top up
|
|
36
|
+
// a magazine should not lose the round.
|
|
37
|
+
restart: { keys: ["Enter", "NumpadEnter"] },
|
|
38
|
+
sprint: { keys: ["ShiftLeft", "ShiftRight"] },
|
|
30
39
|
},
|
|
31
40
|
plugins: [rapier(), replay(), playtest({ events: drainPlaytestEvents })],
|
|
32
41
|
display: config.display,
|