create-threenative 0.2.10 → 0.2.12
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/agent-docs/references/assertion-reference.md +109 -3
- package/agent-docs/references/auto-exposure.md +28 -45
- package/agent-docs/references/build-profiles.md +1 -1
- package/agent-docs/references/capability-reference.md +527 -44
- package/agent-docs/references/debug-surface.md +64 -0
- package/agent-docs/references/finding-assets.md +11 -12
- package/agent-docs/references/performance-basics.md +19 -0
- package/agent-docs/references/trace-a-slow-frame.md +21 -0
- package/agent-docs/references/visual-baseline.md +23 -4
- package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
- package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
- package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
- package/agent-files/scripts/reference.mjs +9 -4
- package/capabilities.json +739 -50
- package/dist/index.d.ts +40 -6
- package/dist/index.js +227 -34
- package/dist/quality.d.ts +12 -0
- package/dist/quality.js +166747 -0
- package/dist/threenative.js +60 -44
- package/dist/web-engine-gltf-loader.js +2 -0
- package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
- package/dist/web-engine-mesh-bvh.js +7 -0
- package/dist/web-engine-post-effects.js +645 -19
- package/dist/web-engine-runtime.js +3528 -343
- package/package.json +19 -9
- package/template-assets/assets/bay-PROVENANCE.md +21 -0
- package/template-assets/assets/bay-ground.webp +0 -0
- package/template-assets/assets/bay-metal.webp +0 -0
- package/template-assets/assets/bay-pavement-normal.webp +0 -0
- package/template-assets/assets/bay-pavement.webp +0 -0
- package/template-assets/assets/bay-plaster-normal.webp +0 -0
- package/template-assets/assets/bay-plaster.webp +0 -0
- package/template-assets/assets/bay-wood-normal.webp +0 -0
- package/template-assets/assets/bay-wood.webp +0 -0
- package/template-assets/assets/tex-PROVENANCE.md +25 -0
- package/template-assets/assets/tex-bark-normal.webp +0 -0
- package/template-assets/assets/tex-bark.webp +0 -0
- package/template-assets/assets/tex-birch-bark.webp +0 -0
- package/template-assets/assets/tex-grass.webp +0 -0
- package/template-assets/assets/tex-planks-normal.webp +0 -0
- package/template-assets/assets/tex-planks.webp +0 -0
- package/template-assets/assets/tex-rock-normal.webp +0 -0
- package/template-assets/assets/tex-rock.webp +0 -0
- package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
- package/template-assets/assets/tex-roof-tiles.webp +0 -0
- package/template-assets/assets/tex-sand-normal.webp +0 -0
- package/template-assets/assets/tex-sand.webp +0 -0
- package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
- package/template-assets/assets/tex-stone-wall.webp +0 -0
- package/template-assets/kitExposure.ts +20 -0
- package/template-assets/patches/three@0.185.1.patch +481 -272
- package/template-assets/quality/biome.json +7 -0
- package/template-assets/quality/eslint.config.js +3 -0
- package/template-assets/realistic-ocean/README.md +113 -0
- package/template-assets/realistic-ocean/install.mjs +56 -0
- package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
- package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
- package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
- package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
- package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
- package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
- package/templates/AGENTS.md +21 -0
- package/templates/CLAUDE.md +23 -0
- package/templates/action-rpg/.codex/config.toml +6 -2
- package/templates/action-rpg/.cursor/mcp.json +8 -2
- package/templates/action-rpg/.gemini/settings.json +8 -2
- package/templates/action-rpg/.mcp.json +8 -2
- package/templates/action-rpg/.vscode/mcp.json +9 -2
- package/templates/action-rpg/.zed/settings.json +9 -2
- package/templates/action-rpg/AGENTS.md +11 -11
- package/templates/action-rpg/CLAUDE.md +11 -11
- package/templates/action-rpg/opencode.json +10 -2
- package/templates/action-rpg/package.json +15 -10
- package/templates/action-rpg/playtests/combat.playtest.json +6 -0
- package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
- package/templates/action-rpg/playtests/performance.playtest.json +1 -1
- package/templates/action-rpg/playtests/roll.playtest.json +112 -0
- package/templates/action-rpg/playtests/swing.playtest.json +55 -0
- package/templates/action-rpg/playtests/win.playtest.json +4 -4
- package/templates/action-rpg/src/entities/Fighter.ts +44 -4
- package/templates/action-rpg/src/entities/Player.ts +64 -12
- package/templates/action-rpg/src/render/atmosphere.ts +444 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
- package/templates/action-rpg/src/render/clouds.ts +605 -0
- package/templates/action-rpg/src/render/dungeon.ts +8 -6
- package/templates/action-rpg/src/render/exposure.ts +11 -109
- package/templates/action-rpg/src/render/gpuSky.ts +752 -0
- package/templates/action-rpg/src/render/lighting.ts +27 -4
- package/templates/action-rpg/src/render/materialLighting.ts +2 -11
- package/templates/action-rpg/src/render/palette.ts +1 -0
- package/templates/action-rpg/src/render/postprocessing.ts +4 -4
- package/templates/action-rpg/src/render/props.ts +10 -8
- package/templates/action-rpg/src/render/quality.ts +56 -108
- package/templates/action-rpg/src/render/sky.ts +74 -1
- package/templates/action-rpg/src/scenes/Play.ts +16 -12
- package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
- package/templates/action-rpg/src/ui/Hud.tsx +5 -7
- package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
- package/templates/action-rpg/threenative.config.ts +3 -0
- package/templates/adventure/.codex/config.toml +23 -0
- package/templates/adventure/.cursor/mcp.json +38 -0
- package/templates/adventure/.gemini/settings.json +38 -0
- package/templates/adventure/.mcp.json +38 -0
- package/templates/adventure/.vscode/mcp.json +43 -0
- package/templates/adventure/.zed/settings.json +43 -0
- package/templates/adventure/AGENTS.md +60 -0
- package/templates/adventure/CLAUDE.md +62 -0
- package/templates/adventure/index.html +14 -0
- package/templates/adventure/kit.json +8 -0
- package/templates/adventure/native-playtests/survives.playtest.json +52 -0
- package/templates/adventure/opencode.json +49 -0
- package/templates/adventure/package.json +65 -0
- package/templates/adventure/playtests/boss.playtest.json +406 -0
- package/templates/adventure/playtests/combat.playtest.json +342 -0
- package/templates/adventure/playtests/controls.playtest.json +142 -0
- package/templates/adventure/playtests/explore.playtest.json +45 -0
- package/templates/adventure/playtests/flicker.playtest.json +206 -0
- package/templates/adventure/playtests/hearts.playtest.json +171 -0
- package/templates/adventure/playtests/lockon.playtest.json +256 -0
- package/templates/adventure/playtests/look.playtest.json +72 -0
- package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
- package/templates/adventure/playtests/move.playtest.json +84 -0
- package/templates/adventure/playtests/performance.playtest.json +55 -0
- package/templates/adventure/playtests/puzzle.playtest.json +250 -0
- package/templates/adventure/playtests/stride.playtest.json +67 -0
- package/templates/adventure/playtests/survives.playtest.json +171 -0
- package/templates/adventure/playtests/thornback.playtest.json +267 -0
- package/templates/adventure/public/favicon.svg +4 -0
- package/templates/adventure/src/entities/Block.ts +114 -0
- package/templates/adventure/src/entities/Chest.ts +69 -0
- package/templates/adventure/src/entities/Door.ts +81 -0
- package/templates/adventure/src/entities/Dummy.ts +69 -0
- package/templates/adventure/src/entities/Flicker.ts +239 -0
- package/templates/adventure/src/entities/Hero.ts +561 -0
- package/templates/adventure/src/entities/LockOn.ts +180 -0
- package/templates/adventure/src/entities/Mossling.ts +249 -0
- package/templates/adventure/src/entities/Switch.ts +49 -0
- package/templates/adventure/src/entities/Thornback.ts +238 -0
- package/templates/adventure/src/entities/Warden.ts +196 -0
- package/templates/adventure/src/game.ts +65 -0
- package/templates/adventure/src/interact.ts +63 -0
- package/templates/adventure/src/level/Hollow.ts +240 -0
- package/templates/adventure/src/level/Vale.ts +383 -0
- package/templates/adventure/src/main.ts +18 -0
- package/templates/adventure/src/render/camera.ts +416 -0
- package/templates/adventure/src/render/creatures.ts +405 -0
- package/templates/adventure/src/render/effects.ts +333 -0
- package/templates/adventure/src/render/foliage.ts +1072 -0
- package/templates/adventure/src/render/hero.ts +1447 -0
- package/templates/adventure/src/render/kitExposure.ts +20 -0
- package/templates/adventure/src/render/lighting.ts +74 -0
- package/templates/adventure/src/render/loading.ts +332 -0
- package/templates/adventure/src/render/materials.ts +179 -0
- package/templates/adventure/src/render/palette.ts +137 -0
- package/templates/adventure/src/render/postprocessing.ts +70 -0
- package/templates/adventure/src/render/props.ts +383 -0
- package/templates/adventure/src/render/quality.ts +46 -0
- package/templates/adventure/src/render/sky.ts +271 -0
- package/templates/adventure/src/render/surface.ts +259 -0
- package/templates/adventure/src/render/touch-controls.ts +137 -0
- package/templates/adventure/src/scenes/Play.ts +959 -0
- package/templates/adventure/src/state.ts +113 -0
- package/templates/adventure/src/style.css +98 -0
- package/templates/adventure/src/ui/App.tsx +22 -0
- package/templates/adventure/src/ui/GameUi.tsx +20 -0
- package/templates/adventure/src/ui/Hud.tsx +70 -0
- package/templates/adventure/src/ui/Menu.tsx +15 -0
- package/templates/adventure/src/ui/main.tsx +14 -0
- package/templates/adventure/tailwind.config.ts +2 -0
- package/templates/adventure/threenative.config.ts +62 -0
- package/templates/adventure/tsconfig.json +17 -0
- package/templates/adventure/vite.config.ts +49 -0
- package/templates/collectathon/.codex/config.toml +23 -0
- package/templates/collectathon/.cursor/mcp.json +38 -0
- package/templates/collectathon/.gemini/settings.json +38 -0
- package/templates/collectathon/.mcp.json +38 -0
- package/templates/collectathon/.vscode/mcp.json +43 -0
- package/templates/collectathon/.zed/settings.json +43 -0
- package/templates/collectathon/AGENTS.md +58 -0
- package/templates/collectathon/CLAUDE.md +60 -0
- package/templates/collectathon/index.html +14 -0
- package/templates/collectathon/kit.json +8 -0
- package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
- package/templates/collectathon/opencode.json +49 -0
- package/templates/collectathon/package.json +65 -0
- package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
- package/templates/collectathon/playtests/camera.playtest.json +80 -0
- package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
- package/templates/collectathon/playtests/collect.playtest.json +196 -0
- package/templates/collectathon/playtests/combat.playtest.json +246 -0
- package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
- package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
- package/templates/collectathon/playtests/effects.playtest.json +124 -0
- package/templates/collectathon/playtests/enemies.playtest.json +295 -0
- package/templates/collectathon/playtests/explore.playtest.json +45 -0
- package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
- package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
- package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
- package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
- package/templates/collectathon/playtests/ledge.playtest.json +100 -0
- package/templates/collectathon/playtests/look.playtest.json +64 -0
- package/templates/collectathon/playtests/performance.playtest.json +55 -0
- package/templates/collectathon/playtests/stride.playtest.json +111 -0
- package/templates/collectathon/playtests/survives.playtest.json +123 -0
- package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
- package/templates/collectathon/playtests/thornback.playtest.json +157 -0
- package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
- package/templates/collectathon/playtests/win.playtest.json +166 -0
- package/templates/collectathon/public/favicon.svg +4 -0
- package/templates/collectathon/src/entities/Hero.ts +915 -0
- package/templates/collectathon/src/entities/Pickup.ts +63 -0
- package/templates/collectathon/src/entities/Walker.ts +248 -0
- package/templates/collectathon/src/game.ts +51 -0
- package/templates/collectathon/src/level/Course.ts +590 -0
- package/templates/collectathon/src/level/terrain.ts +144 -0
- package/templates/collectathon/src/main.ts +14 -0
- package/templates/collectathon/src/playtest-events.ts +15 -0
- package/templates/collectathon/src/render/camera.ts +163 -0
- package/templates/collectathon/src/render/castle.ts +408 -0
- package/templates/collectathon/src/render/effects.ts +284 -0
- package/templates/collectathon/src/render/foliage.ts +744 -0
- package/templates/collectathon/src/render/ground.ts +139 -0
- package/templates/collectathon/src/render/hero.ts +452 -0
- package/templates/collectathon/src/render/kitExposure.ts +20 -0
- package/templates/collectathon/src/render/lighting.ts +65 -0
- package/templates/collectathon/src/render/loading.ts +332 -0
- package/templates/collectathon/src/render/materials.ts +196 -0
- package/templates/collectathon/src/render/palette.ts +82 -0
- package/templates/collectathon/src/render/postprocessing.ts +79 -0
- package/templates/collectathon/src/render/props.ts +218 -0
- package/templates/collectathon/src/render/quality.ts +54 -0
- package/templates/collectathon/src/render/sky.ts +262 -0
- package/templates/collectathon/src/render/surface.ts +269 -0
- package/templates/collectathon/src/render/touch-controls.ts +179 -0
- package/templates/collectathon/src/render/touch-layout.ts +48 -0
- package/templates/collectathon/src/render/water.ts +191 -0
- package/templates/collectathon/src/scenes/Play.ts +481 -0
- package/templates/collectathon/src/state.ts +38 -0
- package/templates/collectathon/src/style.css +106 -0
- package/templates/collectathon/src/ui/App.tsx +22 -0
- package/templates/collectathon/src/ui/GameUi.tsx +20 -0
- package/templates/collectathon/src/ui/Hud.tsx +77 -0
- package/templates/collectathon/src/ui/Menu.tsx +13 -0
- package/templates/collectathon/src/ui/main.tsx +14 -0
- package/templates/collectathon/tailwind.config.ts +2 -0
- package/templates/collectathon/threenative.config.ts +62 -0
- package/templates/collectathon/tsconfig.json +17 -0
- package/templates/collectathon/vite.config.ts +49 -0
- package/templates/kart/.codex/config.toml +23 -0
- package/templates/kart/.cursor/mcp.json +38 -0
- package/templates/kart/.gemini/settings.json +38 -0
- package/templates/kart/.mcp.json +38 -0
- package/templates/kart/.vscode/mcp.json +43 -0
- package/templates/kart/.zed/settings.json +43 -0
- package/templates/kart/AGENTS.md +58 -0
- package/templates/kart/CLAUDE.md +60 -0
- package/templates/kart/index.html +14 -0
- package/templates/kart/kit.json +8 -0
- package/templates/kart/native-playtests/survives.playtest.json +65 -0
- package/templates/kart/opencode.json +49 -0
- package/templates/kart/package.json +64 -0
- package/templates/kart/playtests/drift.playtest.json +226 -0
- package/templates/kart/playtests/explore.playtest.json +45 -0
- package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
- package/templates/kart/playtests/item-key.playtest.json +108 -0
- package/templates/kart/playtests/items.playtest.json +143 -0
- package/templates/kart/playtests/lap-times.playtest.json +138 -0
- package/templates/kart/playtests/laps.playtest.json +149 -0
- package/templates/kart/playtests/performance.playtest.json +57 -0
- package/templates/kart/playtests/race.playtest.json +294 -0
- package/templates/kart/playtests/restart.playtest.json +87 -0
- package/templates/kart/playtests/rocket-start.playtest.json +56 -0
- package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
- package/templates/kart/playtests/surfaces.playtest.json +113 -0
- package/templates/kart/playtests/survives.playtest.json +116 -0
- package/templates/kart/playtests/wall.playtest.json +118 -0
- package/templates/kart/public/favicon.svg +4 -0
- package/templates/kart/src/entities/Driver.ts +123 -0
- package/templates/kart/src/entities/Items.ts +194 -0
- package/templates/kart/src/entities/Kart.ts +517 -0
- package/templates/kart/src/game.ts +45 -0
- package/templates/kart/src/main.ts +14 -0
- package/templates/kart/src/playtest-events.ts +15 -0
- package/templates/kart/src/render/camera.ts +83 -0
- package/templates/kart/src/render/course.ts +579 -0
- package/templates/kart/src/render/effects.ts +266 -0
- package/templates/kart/src/render/items.ts +163 -0
- package/templates/kart/src/render/kart.ts +256 -0
- package/templates/kart/src/render/kitExposure.ts +20 -0
- package/templates/kart/src/render/lighting.ts +58 -0
- package/templates/kart/src/render/loading.ts +332 -0
- package/templates/kart/src/render/materials.ts +119 -0
- package/templates/kart/src/render/palette.ts +74 -0
- package/templates/kart/src/render/postprocessing.ts +79 -0
- package/templates/kart/src/render/quality.ts +54 -0
- package/templates/kart/src/render/skids.ts +86 -0
- package/templates/kart/src/render/sky.ts +105 -0
- package/templates/kart/src/render/touch-controls.ts +168 -0
- package/templates/kart/src/render/touch-layout.ts +48 -0
- package/templates/kart/src/scenes/Race.ts +850 -0
- package/templates/kart/src/state.ts +53 -0
- package/templates/kart/src/style.css +106 -0
- package/templates/kart/src/track/Course.ts +276 -0
- package/templates/kart/src/track/Race.ts +133 -0
- package/templates/kart/src/ui/App.tsx +21 -0
- package/templates/kart/src/ui/GameUi.tsx +20 -0
- package/templates/kart/src/ui/Hud.tsx +172 -0
- package/templates/kart/src/ui/Menu.tsx +13 -0
- package/templates/kart/src/ui/main.tsx +14 -0
- package/templates/kart/tailwind.config.ts +2 -0
- package/templates/kart/threenative.config.ts +62 -0
- package/templates/kart/tsconfig.json +17 -0
- package/templates/kart/vite.config.ts +49 -0
- package/templates/minimal/.codex/config.toml +6 -2
- package/templates/minimal/.cursor/mcp.json +8 -2
- package/templates/minimal/.gemini/settings.json +8 -2
- package/templates/minimal/.mcp.json +8 -2
- package/templates/minimal/.vscode/mcp.json +9 -2
- package/templates/minimal/.zed/settings.json +9 -2
- package/templates/minimal/AGENTS.md +11 -13
- package/templates/minimal/CLAUDE.md +11 -13
- package/templates/minimal/opencode.json +10 -2
- package/templates/minimal/package.json +14 -9
- package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
- package/templates/minimal/playtests/jump.playtest.json +45 -0
- package/templates/minimal/playtests/play.playtest.json +1 -1
- package/templates/minimal/src/game.ts +2 -0
- package/templates/minimal/src/render/atmosphere.ts +444 -0
- package/templates/minimal/src/render/backlightMaterial.ts +49 -18
- package/templates/minimal/src/render/camera.ts +35 -4
- package/templates/minimal/src/render/clouds.ts +605 -0
- package/templates/minimal/src/render/exposure.ts +7 -111
- package/templates/minimal/src/render/gpuSky.ts +752 -0
- package/templates/minimal/src/render/lighting.ts +26 -4
- package/templates/minimal/src/render/materialLighting.ts +2 -10
- package/templates/minimal/src/render/postprocessing.ts +4 -4
- package/templates/minimal/src/render/quality.ts +10 -116
- package/templates/minimal/src/render/sky.ts +73 -1
- package/templates/minimal/src/scenes/Play.ts +18 -7
- package/templates/platformer/.codex/config.toml +6 -2
- package/templates/platformer/.cursor/mcp.json +8 -2
- package/templates/platformer/.gemini/settings.json +8 -2
- package/templates/platformer/.mcp.json +8 -2
- package/templates/platformer/.vscode/mcp.json +9 -2
- package/templates/platformer/.zed/settings.json +9 -2
- package/templates/platformer/AGENTS.md +13 -9
- package/templates/platformer/CLAUDE.md +13 -9
- package/templates/platformer/opencode.json +10 -2
- package/templates/platformer/package.json +15 -10
- package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
- package/templates/platformer/playtests/finish.playtest.json +58 -0
- package/templates/platformer/playtests/idle.playtest.json +44 -0
- package/templates/platformer/playtests/performance.playtest.json +1 -1
- package/templates/platformer/src/entities/Fox.ts +19 -6
- package/templates/platformer/src/game.ts +1 -0
- package/templates/platformer/src/level/Stage.ts +4 -1
- package/templates/platformer/src/render/backlightMaterial.ts +49 -18
- package/templates/platformer/src/render/camera.ts +30 -1
- package/templates/platformer/src/render/exposure.ts +6 -111
- package/templates/platformer/src/render/fox.ts +5 -2
- package/templates/platformer/src/render/kitExposure.ts +20 -0
- package/templates/platformer/src/render/materialLighting.ts +2 -11
- package/templates/platformer/src/render/postprocessing.ts +4 -4
- package/templates/platformer/src/render/props.ts +1 -2
- package/templates/platformer/src/render/quality.ts +10 -118
- package/templates/platformer/src/scenes/Play.ts +31 -15
- package/templates/platformer/src/ui/Menu.tsx +1 -1
- package/templates/puzzle/.codex/config.toml +6 -2
- package/templates/puzzle/.cursor/mcp.json +8 -2
- package/templates/puzzle/.gemini/settings.json +8 -2
- package/templates/puzzle/.mcp.json +8 -2
- package/templates/puzzle/.vscode/mcp.json +9 -2
- package/templates/puzzle/.zed/settings.json +9 -2
- package/templates/puzzle/AGENTS.md +14 -17
- package/templates/puzzle/CLAUDE.md +14 -17
- package/templates/puzzle/opencode.json +10 -2
- package/templates/puzzle/package.json +15 -10
- package/templates/puzzle/playtests/performance.playtest.json +1 -1
- package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
- package/templates/puzzle/src/render/exposure.ts +11 -109
- package/templates/puzzle/src/render/lighting.ts +3 -3
- package/templates/puzzle/src/render/materialLighting.ts +2 -11
- package/templates/puzzle/src/render/palette.ts +1 -1
- package/templates/puzzle/src/render/postprocessing.ts +4 -4
- package/templates/puzzle/src/render/quality.ts +44 -153
- package/templates/puzzle/src/render/vault.ts +18 -6
- package/templates/puzzle/src/scenes/Play.ts +6 -1
- package/templates/puzzle/src/ui/Hud.tsx +8 -43
- package/templates/racing/.codex/config.toml +6 -2
- package/templates/racing/.cursor/mcp.json +8 -2
- package/templates/racing/.gemini/settings.json +8 -2
- package/templates/racing/.mcp.json +8 -2
- package/templates/racing/.vscode/mcp.json +9 -2
- package/templates/racing/.zed/settings.json +9 -2
- package/templates/racing/AGENTS.md +10 -12
- package/templates/racing/CLAUDE.md +10 -12
- package/templates/racing/opencode.json +10 -2
- package/templates/racing/package.json +15 -10
- package/templates/racing/playtests/brake.playtest.json +54 -0
- package/templates/racing/playtests/outcome.playtest.json +19 -0
- package/templates/racing/playtests/performance.playtest.json +1 -1
- package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
- package/templates/racing/src/entities/RacingCar.ts +12 -3
- package/templates/racing/src/entities/Rival.ts +11 -2
- package/templates/racing/src/render/atmosphere.ts +444 -0
- package/templates/racing/src/render/backlightMaterial.ts +49 -18
- package/templates/racing/src/render/clouds.ts +605 -0
- package/templates/racing/src/render/exposure.ts +6 -111
- package/templates/racing/src/render/gpuSky.ts +752 -0
- package/templates/racing/src/render/kitExposure.ts +20 -0
- package/templates/racing/src/render/lighting.ts +26 -4
- package/templates/racing/src/render/materialLighting.ts +2 -11
- package/templates/racing/src/render/materials.ts +2 -1
- package/templates/racing/src/render/postprocessing.ts +4 -4
- package/templates/racing/src/render/quality.ts +27 -115
- package/templates/racing/src/render/sky.ts +72 -1
- package/templates/racing/src/scenes/Race.ts +9 -7
- package/templates/racing/src/track/TrackSector.ts +5 -2
- package/templates/racing/src/ui/Hud.tsx +12 -7
- package/templates/rain/.codex/config.toml +6 -2
- package/templates/rain/.cursor/mcp.json +8 -2
- package/templates/rain/.gemini/settings.json +8 -2
- package/templates/rain/.mcp.json +8 -2
- package/templates/rain/.vscode/mcp.json +9 -2
- package/templates/rain/.zed/settings.json +9 -2
- package/templates/rain/AGENTS.md +12 -12
- package/templates/rain/CLAUDE.md +12 -12
- package/templates/rain/opencode.json +10 -2
- package/templates/rain/package.json +14 -9
- package/templates/rain/playtests/performance.playtest.json +1 -1
- package/templates/rain/src/game.ts +1 -1
- package/templates/rain/src/render/bloom-shader.ts +1 -1
- package/templates/rain/src/render/clouds-shader.ts +2 -2
- package/templates/rain/src/render/clouds.ts +2 -1
- package/templates/rain/src/render/exposure.ts +11 -109
- package/templates/rain/src/render/post-shader.ts +7 -11
- package/templates/rain/src/render/postprocessing.ts +8 -24
- package/templates/rain/src/render/quality.ts +44 -98
- package/templates/rain/src/render/world-shader.ts +281 -97
- package/templates/rain/src/render/world.ts +82 -2
- package/templates/rain/src/style.css +1 -1
- package/templates/rain/src/ui/GameUi.tsx +6 -2
- package/templates/rain/src/ui/Hud.tsx +1 -1
- package/templates/rain/tools/generate-shaders.mjs +2 -2
- package/templates/rain/tools/tempest-post.frag +4 -6
- package/templates/rain/tools/tempest-world.frag +80 -12
- package/templates/rts/.codex/config.toml +6 -2
- package/templates/rts/.cursor/mcp.json +8 -2
- package/templates/rts/.gemini/settings.json +8 -2
- package/templates/rts/.mcp.json +8 -2
- package/templates/rts/.vscode/mcp.json +9 -2
- package/templates/rts/.zed/settings.json +9 -2
- package/templates/rts/AGENTS.md +15 -16
- package/templates/rts/CLAUDE.md +15 -16
- package/templates/rts/opencode.json +10 -2
- package/templates/rts/package.json +14 -9
- package/templates/rts/playtests/performance.playtest.json +1 -1
- package/templates/rts/playtests/rts-attack.playtest.json +5 -0
- package/templates/rts/playtests/rts-build.playtest.json +20 -1
- package/templates/rts/playtests/rts-orders.playtest.json +1 -1
- package/templates/rts/playtests/rts-pause.playtest.json +112 -0
- package/templates/rts/playtests/rts-train.playtest.json +1 -1
- package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
- package/templates/rts/src/game.ts +29 -7
- package/templates/rts/src/render/army.ts +181 -49
- package/templates/rts/src/render/backlightMaterial.ts +49 -18
- package/templates/rts/src/render/environment.ts +276 -0
- package/templates/rts/src/render/exposure.ts +3 -65
- package/templates/rts/src/render/ground.ts +478 -0
- package/templates/rts/src/render/lighting.ts +62 -11
- package/templates/rts/src/render/materialLighting.ts +2 -11
- package/templates/rts/src/render/materials.ts +47 -118
- package/templates/rts/src/render/palette.ts +30 -13
- package/templates/rts/src/render/picking.ts +18 -0
- package/templates/rts/src/render/postprocessing.ts +4 -4
- package/templates/rts/src/render/quality.ts +64 -85
- package/templates/rts/src/render/resources.ts +21 -22
- package/templates/rts/src/render/sky.ts +9 -12
- package/templates/rts/src/render/terrain.ts +36 -11
- package/templates/rts/src/scenes/Play.ts +373 -38
- package/templates/rts/src/sim/ai.ts +0 -11
- package/templates/rts/src/state.ts +46 -0
- package/templates/rts/src/style.css +1543 -0
- package/templates/rts/src/ui/Commands.tsx +204 -107
- package/templates/rts/src/ui/GameUi.tsx +12 -5
- package/templates/rts/src/ui/Hud.tsx +611 -116
- package/templates/rts/src/ui/Minimap.tsx +103 -37
- package/templates/rts/src/ui/icons.tsx +116 -0
- package/templates/rts/src/ui/labels.ts +73 -0
- package/templates/rts/src/ui/minimapPoint.ts +30 -0
- package/templates/rts/threenative.config.ts +1 -1
- package/templates/runner/.codex/config.toml +6 -2
- package/templates/runner/.cursor/mcp.json +8 -2
- package/templates/runner/.gemini/settings.json +8 -2
- package/templates/runner/.mcp.json +8 -2
- package/templates/runner/.vscode/mcp.json +9 -2
- package/templates/runner/.zed/settings.json +9 -2
- package/templates/runner/AGENTS.md +12 -12
- package/templates/runner/CLAUDE.md +12 -12
- package/templates/runner/opencode.json +10 -2
- package/templates/runner/package.json +15 -10
- package/templates/runner/playtests/near-miss.playtest.json +48 -0
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/playtests/stride.playtest.json +27 -0
- package/templates/runner/playtests/survives.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +3 -1
- package/templates/runner/src/entities/Runner.ts +11 -5
- package/templates/runner/src/render/atmosphere.ts +444 -0
- package/templates/runner/src/render/backlightMaterial.ts +49 -18
- package/templates/runner/src/render/clouds.ts +605 -0
- package/templates/runner/src/render/exposure.ts +6 -111
- package/templates/runner/src/render/gpuSky.ts +752 -0
- package/templates/runner/src/render/kitExposure.ts +20 -0
- package/templates/runner/src/render/lighting.ts +26 -4
- package/templates/runner/src/render/materialLighting.ts +2 -11
- package/templates/runner/src/render/postprocessing.ts +4 -4
- package/templates/runner/src/render/quality.ts +26 -114
- package/templates/runner/src/render/sky.ts +73 -1
- package/templates/runner/src/scenes/Run.ts +19 -15
- package/templates/runner/src/track.ts +12 -3
- package/templates/sailing/.codex/config.toml +6 -2
- package/templates/sailing/.cursor/mcp.json +8 -2
- package/templates/sailing/.gemini/settings.json +8 -2
- package/templates/sailing/.mcp.json +8 -2
- package/templates/sailing/.vscode/mcp.json +9 -2
- package/templates/sailing/.zed/settings.json +9 -2
- package/templates/sailing/AGENTS.md +10 -11
- package/templates/sailing/CLAUDE.md +10 -11
- package/templates/sailing/opencode.json +10 -2
- package/templates/sailing/package.json +15 -10
- package/templates/sailing/playtests/fail.playtest.json +46 -5
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
- package/templates/sailing/playtests/performance.playtest.json +1 -1
- package/templates/sailing/src/game.ts +1 -0
- package/templates/sailing/src/render/backlightMaterial.ts +49 -18
- package/templates/sailing/src/render/exposure.ts +6 -111
- package/templates/sailing/src/render/kitExposure.ts +20 -0
- package/templates/sailing/src/render/materialLighting.ts +2 -11
- package/templates/sailing/src/render/ocean.ts +0 -1
- package/templates/sailing/src/render/postprocessing.ts +4 -4
- package/templates/sailing/src/render/quality.ts +31 -138
- package/templates/sailing/src/scenes/Sailing.ts +12 -4
- package/templates/sailing/src/ui/Hud.tsx +6 -2
- package/templates/sailing/src/ui/Menu.tsx +1 -1
- package/templates/shooter/.codex/config.toml +6 -2
- package/templates/shooter/.cursor/mcp.json +8 -2
- package/templates/shooter/.gemini/settings.json +8 -2
- package/templates/shooter/.mcp.json +8 -2
- package/templates/shooter/.vscode/mcp.json +9 -2
- package/templates/shooter/.zed/settings.json +9 -2
- package/templates/shooter/AGENTS.md +13 -12
- package/templates/shooter/CLAUDE.md +13 -12
- package/templates/shooter/index.html +1 -1
- package/templates/shooter/main.html +13 -0
- package/templates/shooter/opencode.json +10 -2
- package/templates/shooter/package.json +15 -10
- package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
- package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
- package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
- package/templates/shooter/playtests/performance.playtest.json +3 -3
- package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
- package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
- package/templates/shooter/src/entities/Breakables.ts +34 -10
- package/templates/shooter/src/entities/Enemy.ts +176 -54
- package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
- package/templates/shooter/src/entities/Rifle.ts +83 -9
- package/templates/shooter/src/entities/movement.ts +96 -0
- package/templates/shooter/src/render/atmosphere.ts +444 -0
- package/templates/shooter/src/render/backlightMaterial.ts +49 -18
- package/templates/shooter/src/render/camera.ts +3 -1
- package/templates/shooter/src/render/clouds.ts +605 -0
- package/templates/shooter/src/render/exposure.ts +10 -109
- package/templates/shooter/src/render/facade.ts +26 -68
- package/templates/shooter/src/render/gpuSky.ts +752 -0
- package/templates/shooter/src/render/lighting.ts +27 -4
- package/templates/shooter/src/render/materialAssignments.ts +9 -1
- package/templates/shooter/src/render/materialLighting.ts +2 -11
- package/templates/shooter/src/render/occlusion.ts +13 -4
- package/templates/shooter/src/render/palette.ts +1 -0
- package/templates/shooter/src/render/postprocessing.ts +4 -4
- package/templates/shooter/src/render/quality.ts +50 -108
- package/templates/shooter/src/render/scale.ts +0 -11
- package/templates/shooter/src/render/sky.ts +103 -2
- package/templates/shooter/src/render/surface.ts +140 -0
- package/templates/shooter/src/render/town.ts +3 -6
- package/templates/shooter/src/render/townMaterials.ts +95 -42
- package/templates/shooter/src/render/vehicles.ts +2 -0
- package/templates/shooter/src/scenes/Play.ts +83 -23
- package/templates/shooter/src/ui/Hud.tsx +268 -193
- package/templates/shooter/src/worker-page.ts +29 -0
- package/templates/shooter/src/worker.ts +5 -0
- package/templates/shooter/threenative.config.ts +3 -0
- package/templates/shooter/vite.config.ts +2 -0
- package/templates/snow/.codex/config.toml +6 -2
- package/templates/snow/.cursor/mcp.json +8 -2
- package/templates/snow/.gemini/settings.json +8 -2
- package/templates/snow/.mcp.json +8 -2
- package/templates/snow/.vscode/mcp.json +9 -2
- package/templates/snow/.zed/settings.json +9 -2
- package/templates/snow/AGENTS.md +12 -10
- package/templates/snow/CLAUDE.md +12 -10
- package/templates/snow/opencode.json +10 -2
- package/templates/snow/package.json +15 -10
- package/templates/snow/playtests/performance.playtest.json +1 -1
- package/templates/snow/src/render/backlightMaterial.ts +49 -18
- package/templates/snow/src/render/exposure.ts +17 -106
- package/templates/snow/src/render/materialLighting.ts +2 -11
- package/templates/snow/src/render/postprocessing.ts +11 -5
- package/templates/snow/src/render/quality.ts +46 -126
- package/templates/snow/src/render/snowSurface.ts +32 -15
- package/templates/snow/src/scenes/Snow.ts +2 -1
- package/templates/starter/.codex/config.toml +6 -2
- package/templates/starter/.cursor/mcp.json +8 -2
- package/templates/starter/.gemini/settings.json +8 -2
- package/templates/starter/.mcp.json +8 -2
- package/templates/starter/.vscode/mcp.json +9 -2
- package/templates/starter/.zed/settings.json +9 -2
- package/templates/starter/AGENTS.md +18 -14
- package/templates/starter/CLAUDE.md +18 -14
- package/templates/starter/index.html +1 -1
- package/templates/starter/main.html +12 -0
- package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
- package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
- package/templates/starter/opencode.json +10 -2
- package/templates/starter/package.json +15 -10
- package/templates/starter/playtests/play.playtest.json +22 -2
- package/templates/starter/playtests/production-readiness.playtest.json +14 -0
- package/templates/starter/src/entities/Crate.ts +19 -1
- package/templates/starter/src/render/arena.ts +2 -2
- package/templates/starter/src/render/atmosphere.ts +444 -0
- package/templates/starter/src/render/backlightMaterial.ts +49 -18
- package/templates/starter/src/render/camera.ts +28 -0
- package/templates/starter/src/render/clouds.ts +605 -0
- package/templates/starter/src/render/contactShadow.ts +50 -0
- package/templates/starter/src/render/exposure.ts +9 -111
- package/templates/starter/src/render/gpuSky.ts +752 -0
- package/templates/starter/src/render/grade.ts +1 -1
- package/templates/starter/src/render/lighting.ts +34 -6
- package/templates/starter/src/render/materialLighting.ts +2 -11
- package/templates/starter/src/render/postprocessing.ts +27 -14
- package/templates/starter/src/render/quality.ts +18 -147
- package/templates/starter/src/render/sky.ts +90 -40
- package/templates/starter/src/render/temporalAA.ts +1 -1
- package/templates/starter/src/render/temporalAAStage.ts +1 -1
- package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
- package/templates/starter/src/render/temporalDetailStage.ts +106 -0
- package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
- package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
- package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
- package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
- package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
- package/templates/starter/src/scenes/Play.ts +11 -8
- package/templates/starter/src/ui/Hud.tsx +1 -1
- package/templates/starter/src/worker-page.ts +29 -0
- package/templates/starter/src/worker.ts +5 -0
- package/templates/starter/vite.config.ts +2 -0
- package/templates/tower-defense/.codex/config.toml +6 -2
- package/templates/tower-defense/.cursor/mcp.json +8 -2
- package/templates/tower-defense/.gemini/settings.json +8 -2
- package/templates/tower-defense/.mcp.json +8 -2
- package/templates/tower-defense/.vscode/mcp.json +9 -2
- package/templates/tower-defense/.zed/settings.json +9 -2
- package/templates/tower-defense/AGENTS.md +10 -12
- package/templates/tower-defense/CLAUDE.md +10 -12
- package/templates/tower-defense/opencode.json +10 -2
- package/templates/tower-defense/package.json +15 -10
- package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
- package/templates/tower-defense/playtests/performance.playtest.json +1 -1
- package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
- package/templates/tower-defense/src/render/exposure.ts +11 -109
- package/templates/tower-defense/src/render/lighting.ts +4 -2
- package/templates/tower-defense/src/render/materialLighting.ts +2 -11
- package/templates/tower-defense/src/render/postprocessing.ts +4 -4
- package/templates/tower-defense/src/render/quality.ts +10 -116
- package/templates/tower-defense/src/render/sky.ts +2 -2
- package/templates/tower-defense/src/scenes/Battle.ts +4 -0
- package/template-assets/autoExposure.ts +0 -225
- package/template-assets/exposureGraph.ts +0 -178
- package/template-assets/exposureReadback.ts +0 -79
- package/template-assets/worldEnvironment.ts +0 -1212
- package/templates/action-rpg/src/render/autoExposure.ts +0 -225
- package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
- package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
- package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
- package/templates/minimal/src/render/autoExposure.ts +0 -225
- package/templates/minimal/src/render/exposureGraph.ts +0 -178
- package/templates/minimal/src/render/exposureReadback.ts +0 -79
- package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
- package/templates/platformer/src/render/autoExposure.ts +0 -225
- package/templates/platformer/src/render/exposureGraph.ts +0 -178
- package/templates/platformer/src/render/exposureReadback.ts +0 -79
- package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
- package/templates/puzzle/src/render/autoExposure.ts +0 -225
- package/templates/puzzle/src/render/exposureGraph.ts +0 -178
- package/templates/puzzle/src/render/exposureReadback.ts +0 -79
- package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
- package/templates/racing/src/render/autoExposure.ts +0 -225
- package/templates/racing/src/render/exposureGraph.ts +0 -178
- package/templates/racing/src/render/exposureReadback.ts +0 -79
- package/templates/racing/src/render/worldEnvironment.ts +0 -1212
- package/templates/rain/src/render/autoExposure.ts +0 -225
- package/templates/rain/src/render/exposureGraph.ts +0 -178
- package/templates/rain/src/render/exposureReadback.ts +0 -79
- package/templates/rain/src/render/worldEnvironment.ts +0 -1212
- package/templates/rts/src/render/autoExposure.ts +0 -225
- package/templates/rts/src/render/exposureGraph.ts +0 -178
- package/templates/rts/src/render/exposureReadback.ts +0 -79
- package/templates/rts/src/render/worldEnvironment.ts +0 -1212
- package/templates/runner/src/render/autoExposure.ts +0 -225
- package/templates/runner/src/render/exposureGraph.ts +0 -178
- package/templates/runner/src/render/exposureReadback.ts +0 -79
- package/templates/runner/src/render/worldEnvironment.ts +0 -1212
- package/templates/sailing/src/render/autoExposure.ts +0 -225
- package/templates/sailing/src/render/exposureGraph.ts +0 -178
- package/templates/sailing/src/render/exposureReadback.ts +0 -79
- package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
- package/templates/shooter/src/render/autoExposure.ts +0 -225
- package/templates/shooter/src/render/exposureGraph.ts +0 -178
- package/templates/shooter/src/render/exposureReadback.ts +0 -79
- package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
- package/templates/snow/src/render/autoExposure.ts +0 -225
- package/templates/snow/src/render/exposureGraph.ts +0 -178
- package/templates/snow/src/render/exposureReadback.ts +0 -79
- package/templates/snow/src/render/worldEnvironment.ts +0 -1212
- package/templates/starter/src/render/autoExposure.ts +0 -225
- package/templates/starter/src/render/exposureGraph.ts +0 -178
- package/templates/starter/src/render/exposureReadback.ts +0 -79
- package/templates/starter/src/render/worldEnvironment.ts +0 -1212
- package/templates/tower-defense/src/render/autoExposure.ts +0 -225
- package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
- package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
- package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
|
@@ -13,14 +13,13 @@ import {
|
|
|
13
13
|
type AnimationClip,
|
|
14
14
|
Box3,
|
|
15
15
|
BoxGeometry,
|
|
16
|
-
Color,
|
|
17
16
|
Group,
|
|
18
17
|
MathUtils,
|
|
18
|
+
Matrix4,
|
|
19
19
|
Mesh,
|
|
20
20
|
MeshBasicMaterial,
|
|
21
21
|
MeshStandardMaterial,
|
|
22
22
|
type Object3D,
|
|
23
|
-
Quaternion,
|
|
24
23
|
Vector3,
|
|
25
24
|
} from "three";
|
|
26
25
|
import { scale } from "../render/scale.js";
|
|
@@ -47,6 +46,8 @@ const WALK_SPEED = 2.4;
|
|
|
47
46
|
const CHASE_SPEED = 3.4;
|
|
48
47
|
const HEAR_RANGE = 26;
|
|
49
48
|
const VIEW_RANGE = 30;
|
|
49
|
+
/** The grip bound the rifle-grip playtest holds each hand to, metres; a wider cheap gap is re-measured exactly. */
|
|
50
|
+
const GRIP_GAP_EXACT_ABOVE = 0.05;
|
|
50
51
|
const VIEW_HALF_ANGLE = MathUtils.degToRad(46);
|
|
51
52
|
const ENGAGE_RANGE = 13;
|
|
52
53
|
const BURST_ROUNDS = 3;
|
|
@@ -240,9 +241,103 @@ const ROUTE_START = ROUTE[0] ?? new Vector3();
|
|
|
240
241
|
const GOAL_REPLAN_SECONDS = 0.15;
|
|
241
242
|
/** Blocked-cell bitmaps per collider set, so the squad pays for the nav grid once. */
|
|
242
243
|
const NAV_GRIDS = new WeakMap<object, Map<string, Uint8Array>>();
|
|
244
|
+
/** Side, in metres, of one bucket of the collider index `#occupied` searches. */
|
|
245
|
+
const OCCUPANCY_BUCKET = 4;
|
|
246
|
+
/** The widest padding `#occupied` is asked for; each box is filed under every bucket it reaches. */
|
|
247
|
+
const OCCUPANCY_PAD = AGENT_RADIUS + 0.16;
|
|
248
|
+
|
|
249
|
+
/** The town's walls bucketed on the ground plane: `[minX, maxX, minZ, maxZ]` per box, per bucket. */
|
|
250
|
+
export interface IOccupancyIndex {
|
|
251
|
+
readonly minX: number;
|
|
252
|
+
readonly minZ: number;
|
|
253
|
+
readonly columns: number;
|
|
254
|
+
readonly rows: number;
|
|
255
|
+
/** The widest padding this index files for; a wider query would silently miss a wall. */
|
|
256
|
+
readonly pad: number;
|
|
257
|
+
readonly buckets: readonly number[][];
|
|
258
|
+
}
|
|
259
|
+
const OCCUPANCY = new WeakMap<object, IOccupancyIndex>();
|
|
260
|
+
|
|
261
|
+
/**
|
|
262
|
+
* Index the colliders that block a walker once per collider set. The same two filters `#occupied`
|
|
263
|
+
* used to apply per box per query: the raised deck is overhead, not a wall, so a soldier routes
|
|
264
|
+
* through the open space under it; and a box under half a metre is a step, not an obstacle.
|
|
265
|
+
*
|
|
266
|
+
* Each wall is filed under every bucket its padded box reaches, so a query looks only at the walls
|
|
267
|
+
* its own bucket holds and still finds a wall whose face is up to `pad` away.
|
|
268
|
+
*/
|
|
269
|
+
export function occupancyIndex(colliders: readonly BoxCollider[]): IOccupancyIndex {
|
|
270
|
+
const cached = OCCUPANCY.get(colliders);
|
|
271
|
+
if (cached !== undefined) return cached;
|
|
272
|
+
const walls = colliders.filter(
|
|
273
|
+
(box) => box.min[1] <= scale.humanHeight + scale.ankleHeight * 6 && box.max[1] > 0.5,
|
|
274
|
+
);
|
|
275
|
+
const minX = Math.min(...walls.map((box) => box.min[0])) - OCCUPANCY_PAD;
|
|
276
|
+
const minZ = Math.min(...walls.map((box) => box.min[2])) - OCCUPANCY_PAD;
|
|
277
|
+
const maxX = Math.max(...walls.map((box) => box.max[0])) + OCCUPANCY_PAD;
|
|
278
|
+
const maxZ = Math.max(...walls.map((box) => box.max[2])) + OCCUPANCY_PAD;
|
|
279
|
+
const columns = walls.length === 0 ? 0 : Math.floor((maxX - minX) / OCCUPANCY_BUCKET) + 1;
|
|
280
|
+
const rows = walls.length === 0 ? 0 : Math.floor((maxZ - minZ) / OCCUPANCY_BUCKET) + 1;
|
|
281
|
+
const buckets = Array.from({ length: columns * rows }, (): number[] => []);
|
|
282
|
+
const cell = (value: number, origin: number): number =>
|
|
283
|
+
Math.floor((value - origin) / OCCUPANCY_BUCKET);
|
|
284
|
+
for (const box of walls) {
|
|
285
|
+
for (
|
|
286
|
+
let row = cell(box.min[2] - OCCUPANCY_PAD, minZ);
|
|
287
|
+
row <= cell(box.max[2] + OCCUPANCY_PAD, minZ);
|
|
288
|
+
row += 1
|
|
289
|
+
) {
|
|
290
|
+
for (
|
|
291
|
+
let column = cell(box.min[0] - OCCUPANCY_PAD, minX);
|
|
292
|
+
column <= cell(box.max[0] + OCCUPANCY_PAD, minX);
|
|
293
|
+
column += 1
|
|
294
|
+
) {
|
|
295
|
+
buckets[row * columns + column]?.push(box.min[0], box.max[0], box.min[2], box.max[2]);
|
|
296
|
+
}
|
|
297
|
+
}
|
|
298
|
+
}
|
|
299
|
+
const index = { minX, minZ, columns, rows, pad: OCCUPANCY_PAD, buckets };
|
|
300
|
+
OCCUPANCY.set(colliders, index);
|
|
301
|
+
return index;
|
|
302
|
+
}
|
|
303
|
+
|
|
304
|
+
/** True when a body `padding` wide at (x, z) overlaps one of the walls `index` holds near it. */
|
|
305
|
+
export function occupancyBlocked(
|
|
306
|
+
index: IOccupancyIndex,
|
|
307
|
+
x: number,
|
|
308
|
+
z: number,
|
|
309
|
+
padding: number,
|
|
310
|
+
): boolean {
|
|
311
|
+
if (padding > index.pad) {
|
|
312
|
+
throw new RangeError(
|
|
313
|
+
`Occupancy index files walls ${index.pad} m from a point, asked for ${padding} m.`,
|
|
314
|
+
);
|
|
315
|
+
}
|
|
316
|
+
const column = Math.floor((x - index.minX) / OCCUPANCY_BUCKET);
|
|
317
|
+
const row = Math.floor((z - index.minZ) / OCCUPANCY_BUCKET);
|
|
318
|
+
// Off the filed ground: no wall is within `pad` of a point outside every wall's own range.
|
|
319
|
+
if (column < 0 || column >= index.columns || row < 0 || row >= index.rows) return false;
|
|
320
|
+
const walls = index.buckets[row * index.columns + column];
|
|
321
|
+
if (walls === undefined) return false;
|
|
322
|
+
for (let at = 0; at < walls.length; at += 4) {
|
|
323
|
+
if (
|
|
324
|
+
x > (walls[at] as number) - padding &&
|
|
325
|
+
x < (walls[at + 1] as number) + padding &&
|
|
326
|
+
z > (walls[at + 2] as number) - padding &&
|
|
327
|
+
z < (walls[at + 3] as number) + padding
|
|
328
|
+
) {
|
|
329
|
+
return true;
|
|
330
|
+
}
|
|
331
|
+
}
|
|
332
|
+
return false;
|
|
333
|
+
}
|
|
243
334
|
|
|
244
335
|
// Scratch for the per-frame sight test; five soldiers × three vectors × 60 Hz is real garbage.
|
|
245
336
|
const scratchGoal = new Vector3();
|
|
337
|
+
/** The hand joint in the rifle's own frame, its clamp onto the rifle box, and the rifle's scale. */
|
|
338
|
+
const scratchGap = new Vector3();
|
|
339
|
+
const scratchScale = new Vector3();
|
|
340
|
+
const scratchHold = new Matrix4();
|
|
246
341
|
const scratchTo = new Vector3();
|
|
247
342
|
const scratchFacing = new Vector3();
|
|
248
343
|
const scratchFlat = new Vector3();
|
|
@@ -576,7 +671,8 @@ export class Enemy {
|
|
|
576
671
|
#leftKnee: Object3D | undefined;
|
|
577
672
|
#rightKnee: Object3D | undefined;
|
|
578
673
|
#colliders: readonly BoxCollider[];
|
|
579
|
-
#
|
|
674
|
+
#occupancy: IOccupancyIndex;
|
|
675
|
+
#bodyMeshes: Mesh[] = [];
|
|
580
676
|
#poseBones: Object3D[] = [];
|
|
581
677
|
#bodyProxy: Object3D | undefined;
|
|
582
678
|
#body: CharacterBody3D | undefined;
|
|
@@ -587,6 +683,12 @@ export class Enemy {
|
|
|
587
683
|
#weaponVelocity = new Vector3();
|
|
588
684
|
#rifleLocalMinZ = -scale.rifleLength * 0.35;
|
|
589
685
|
#rifleLocalMaxZ = scale.rifleLength * 0.65;
|
|
686
|
+
/** The rifle's bounds in its own frame, measured once at equip: it is rigid, so they never change. */
|
|
687
|
+
#rifleLocalBox: Box3 | null = null;
|
|
688
|
+
/** `hand_r`'s gap to the rifle box, kept until the hold or the parent changes. */
|
|
689
|
+
#rightGripGap: number | null = null;
|
|
690
|
+
/** The rifle's world scale, read with `#rightGripGap`, so a left-hand sample needs no walk for it. */
|
|
691
|
+
#rifleWorldScale = 1;
|
|
590
692
|
#rightHand: Object3D | undefined;
|
|
591
693
|
#leftHand: Object3D | undefined;
|
|
592
694
|
#weaponNodes: string[] = [];
|
|
@@ -621,6 +723,7 @@ export class Enemy {
|
|
|
621
723
|
options: EnemyOptions = {},
|
|
622
724
|
) {
|
|
623
725
|
this.#colliders = colliders;
|
|
726
|
+
this.#occupancy = occupancyIndex(colliders);
|
|
624
727
|
this.#route = options.route ?? ROUTE;
|
|
625
728
|
this.#navMin = options.navBounds?.min ?? NAV_MIN;
|
|
626
729
|
this.#navMax = options.navBounds?.max ?? NAV_MAX;
|
|
@@ -675,11 +778,7 @@ export class Enemy {
|
|
|
675
778
|
this.group.add(figure);
|
|
676
779
|
this.#ground = new GroundSnap(figure, { enabled: false, meshes: this.#bodyMeshes });
|
|
677
780
|
this.#equip(figure);
|
|
678
|
-
//
|
|
679
|
-
// only ever runs off the death timer, so a soldier that has never died would otherwise reach
|
|
680
|
-
// his own death still carrying the blend state the asset shipped with — which is both a
|
|
681
|
-
// mid-fight pipeline compile and, once `#setOpacity` stopped flipping the flag, a fade that
|
|
682
|
-
// does not render at all because opacity is ignored on an opaque material.
|
|
781
|
+
// Precompile the dither fade before the first death.
|
|
683
782
|
this.#fixBlendState();
|
|
684
783
|
this.group.name = "enemy";
|
|
685
784
|
this.group.position.copy(this.#route[0] ?? ROUTE_START);
|
|
@@ -799,8 +898,12 @@ export class Enemy {
|
|
|
799
898
|
return this.group.position.y;
|
|
800
899
|
}
|
|
801
900
|
|
|
901
|
+
/**
|
|
902
|
+
* The crown height measured once when the model bound, not re-read per call: `chest` asks for it
|
|
903
|
+
* on every sight test, and each live `modelHeight` read is a bone-chain walk into the engine.
|
|
904
|
+
*/
|
|
802
905
|
get bodyHeight(): number {
|
|
803
|
-
return this
|
|
906
|
+
return this.#modelHeightMeasured;
|
|
804
907
|
}
|
|
805
908
|
|
|
806
909
|
get headZoneMinY(): number {
|
|
@@ -838,6 +941,7 @@ export class Enemy {
|
|
|
838
941
|
const bounds = new Box3().setFromObject(rifle);
|
|
839
942
|
this.#rifleLocalMinZ = bounds.min.z;
|
|
840
943
|
this.#rifleLocalMaxZ = bounds.max.z;
|
|
944
|
+
this.#rifleLocalBox = bounds;
|
|
841
945
|
|
|
842
946
|
if (hand === undefined) {
|
|
843
947
|
// No hand bone: hang it beside the hip rather than dropping it. A soldier without a
|
|
@@ -890,6 +994,7 @@ export class Enemy {
|
|
|
890
994
|
const holder = this.#weapon;
|
|
891
995
|
if (holder === undefined || this.#rightHand === undefined) return;
|
|
892
996
|
this.#rightHand.add(holder);
|
|
997
|
+
this.#rightGripGap = null;
|
|
893
998
|
this.#weaponDetached = false;
|
|
894
999
|
this.#weaponSettled = false;
|
|
895
1000
|
this.#weaponVelocity.set(0, 0, 0);
|
|
@@ -913,25 +1018,7 @@ export class Enemy {
|
|
|
913
1018
|
body.teleport(proxy.position);
|
|
914
1019
|
}
|
|
915
1020
|
|
|
916
|
-
/**
|
|
917
|
-
* Fade a soldier in or out without changing his pipeline.
|
|
918
|
-
*
|
|
919
|
-
* `transparent` and `depthWrite` are blend and depth state, not shader uniforms, so flipping
|
|
920
|
-
* either one makes WebGPU compile a *new* render pipeline for every material it touches — and a
|
|
921
|
-
* soldier is a skinned mesh with several. This used to set `transparent = alpha < 0.999` and
|
|
922
|
-
* `depthWrite = alpha > 0.5`, which meant the first death in a round compiled a fresh pipeline
|
|
923
|
-
* per material on the frame the corpse started fading. Measured as a single ~180 ms frame,
|
|
924
|
-
* mid-round, entirely outside game logic: `outsideGame` peaked at 177-186 ms with a firefight in
|
|
925
|
-
* the scenario and 28.6 ms without one, on identical movement.
|
|
926
|
-
*
|
|
927
|
-
* So the state is fixed at construction and never moves. Only `opacity` changes, which is a
|
|
928
|
-
* uniform the existing pipeline already reads. `needsUpdate` is deliberately not set: it forces
|
|
929
|
-
* the material to be re-evaluated, and there is nothing left to re-evaluate.
|
|
930
|
-
*
|
|
931
|
-
* Keeping `depthWrite` on for a fading corpse is the deliberate half of this. It costs a little
|
|
932
|
-
* correctness on a half-faded body seen through another one, and it buys never compiling
|
|
933
|
-
* mid-fight — and a corpse fading on the ground is not what anyone is looking at.
|
|
934
|
-
*/
|
|
1021
|
+
/** Change only opacity: switching pipeline state mid-death previously cost ~180 ms. */
|
|
935
1022
|
#setOpacity(alpha: number): void {
|
|
936
1023
|
const objects = [
|
|
937
1024
|
...this.#bodyMeshes,
|
|
@@ -951,12 +1038,7 @@ export class Enemy {
|
|
|
951
1038
|
if (alpha < this.#opacityFloor) this.#opacityFloor = alpha;
|
|
952
1039
|
}
|
|
953
1040
|
|
|
954
|
-
/**
|
|
955
|
-
* Put every material into its final blend state once, before the soldier is ever drawn.
|
|
956
|
-
*
|
|
957
|
-
* Called at construction so the transparent pipeline is compiled during loading, where a long
|
|
958
|
-
* frame is part of the loading screen, rather than on the frame someone dies.
|
|
959
|
-
*/
|
|
1041
|
+
/** Dither fades keep solid soldiers in the opaque depth/normal passes. */
|
|
960
1042
|
#fixBlendState(): void {
|
|
961
1043
|
const objects = [
|
|
962
1044
|
...this.#bodyMeshes,
|
|
@@ -968,7 +1050,8 @@ export class Enemy {
|
|
|
968
1050
|
if (mesh.isMesh !== true) return;
|
|
969
1051
|
const materials = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
|
|
970
1052
|
for (const material of materials) {
|
|
971
|
-
material.transparent =
|
|
1053
|
+
material.transparent = false;
|
|
1054
|
+
material.alphaHash = true;
|
|
972
1055
|
material.depthWrite = true;
|
|
973
1056
|
material.needsUpdate = true;
|
|
974
1057
|
}
|
|
@@ -1004,6 +1087,7 @@ export class Enemy {
|
|
|
1004
1087
|
|
|
1005
1088
|
#holdRifle(clip: string): void {
|
|
1006
1089
|
const hold = RIFLE_HOLD[clip];
|
|
1090
|
+
this.#rightGripGap = null;
|
|
1007
1091
|
if (hold !== undefined) {
|
|
1008
1092
|
this.#weaponModel?.rotation.set(
|
|
1009
1093
|
...(hold.map(MathUtils.degToRad) as [number, number, number]),
|
|
@@ -1028,7 +1112,7 @@ export class Enemy {
|
|
|
1028
1112
|
crouched: boolean,
|
|
1029
1113
|
dt: number,
|
|
1030
1114
|
poseLocked = false,
|
|
1031
|
-
|
|
1115
|
+
_armed = false,
|
|
1032
1116
|
): void {
|
|
1033
1117
|
// Ground speed is measured from where the body actually got to this frame, not from the
|
|
1034
1118
|
// speed constant it was asked for: a blocked step, a corner, or a slow turn all cut it.
|
|
@@ -1119,10 +1203,46 @@ export class Enemy {
|
|
|
1119
1203
|
this.#clipFrames.set(current, frames);
|
|
1120
1204
|
// Not the first frames: a clip that has only just started is still a crossfade from the last.
|
|
1121
1205
|
if (frames < 12 || frames % 4 !== 0 || this.#weaponDetached) return;
|
|
1122
|
-
|
|
1206
|
+
// The rifle's own box sits inside the world box `boneContact` clamps to, so the cheap gap is
|
|
1207
|
+
// never smaller than the honest one: under the 5 cm grip bound it already proves the grip,
|
|
1208
|
+
// and only a wider gap pays for the exact vertex walk.
|
|
1209
|
+
const cheap = Math.max(this.#handGap("hand_r") ?? 0, this.#handGap("hand_l") ?? 0);
|
|
1210
|
+
const worst =
|
|
1211
|
+
cheap <= GRIP_GAP_EXACT_ABOVE
|
|
1212
|
+
? cheap
|
|
1213
|
+
: Math.max(this.#contact("hand_r") ?? 0, this.#contact("hand_l") ?? 0);
|
|
1123
1214
|
this.#contactPeak.set(current, Math.max(this.#contactPeak.get(current) ?? 0, worst));
|
|
1124
1215
|
}
|
|
1125
1216
|
|
|
1217
|
+
/**
|
|
1218
|
+
* Metres from a hand joint to the rifle's own bounds, sampled without touching its vertices.
|
|
1219
|
+
*
|
|
1220
|
+
* `boneContact` measures a world-space box over every rifle vertex, which is the honest number
|
|
1221
|
+
* for a playtest and far too much work to repeat while playing. The rifle is rigid, so its
|
|
1222
|
+
* bounds in its own frame never change: transform the joint into that frame, clamp, and scale
|
|
1223
|
+
* the local gap back to metres. One matrix invert and one clamp, no walk.
|
|
1224
|
+
*
|
|
1225
|
+
* The rifle is a child of `hand_r`, so that joint sits where the rifle's own hold puts it: its
|
|
1226
|
+
* gap follows from the rifle's local transform alone and is measured once per hold. Only the
|
|
1227
|
+
* left hand, on another branch of the skeleton, needs the posed world matrices per sample.
|
|
1228
|
+
*/
|
|
1229
|
+
#handGap(bone: "hand_r" | "hand_l"): number | null {
|
|
1230
|
+
const weapon = this.#weaponModel;
|
|
1231
|
+
const bounds = this.#rifleLocalBox;
|
|
1232
|
+
const joint = bone === "hand_r" ? this.#rightHand : this.#leftHand;
|
|
1233
|
+
if (weapon === undefined || bounds === null || joint === undefined) return null;
|
|
1234
|
+
if (this.#rightGripGap === null) {
|
|
1235
|
+
weapon.updateWorldMatrix(true, false);
|
|
1236
|
+
this.#rifleWorldScale = weapon.getWorldScale(scratchScale).x;
|
|
1237
|
+
scratchGap.setFromMatrixPosition(scratchHold.copy(weapon.matrix).invert());
|
|
1238
|
+
this.#rightGripGap = bounds.distanceToPoint(scratchGap) * this.#rifleWorldScale;
|
|
1239
|
+
}
|
|
1240
|
+
if (bone === "hand_r") return this.#rightGripGap;
|
|
1241
|
+
weapon.updateWorldMatrix(true, false);
|
|
1242
|
+
weapon.worldToLocal(joint.getWorldPosition(scratchGap));
|
|
1243
|
+
return bounds.distanceToPoint(scratchGap) * this.#rifleWorldScale;
|
|
1244
|
+
}
|
|
1245
|
+
|
|
1126
1246
|
/**
|
|
1127
1247
|
* Fire `hooks.onFootstep` each time the locomotion action crosses a half-cycle
|
|
1128
1248
|
* boundary — one planted foot per half-cycle, so a re-timed walk keeps its steps
|
|
@@ -1158,22 +1278,19 @@ export class Enemy {
|
|
|
1158
1278
|
return "Death01";
|
|
1159
1279
|
}
|
|
1160
1280
|
|
|
1281
|
+
/**
|
|
1282
|
+
* True when a body `padding` wide at (x, z) overlaps a wall or leaves the map. A path check asks
|
|
1283
|
+
* this for every sample along a segment, so it searches only the walls filed in (x, z)'s bucket
|
|
1284
|
+
* (`occupancyIndex`) instead of the whole town; the answer is the same box test.
|
|
1285
|
+
*/
|
|
1161
1286
|
#occupied(x: number, z: number, padding: number): boolean {
|
|
1162
|
-
|
|
1163
|
-
|
|
1164
|
-
|
|
1165
|
-
|
|
1166
|
-
|
|
1167
|
-
|
|
1168
|
-
|
|
1169
|
-
z > box.min[2] - padding &&
|
|
1170
|
-
z < box.max[2] + padding &&
|
|
1171
|
-
box.max[1] > 0.5
|
|
1172
|
-
) {
|
|
1173
|
-
return true;
|
|
1174
|
-
}
|
|
1175
|
-
}
|
|
1176
|
-
return x < this.#navMin || x > this.#navMax || z < this.#navMin || z > this.#navMax;
|
|
1287
|
+
return (
|
|
1288
|
+
occupancyBlocked(this.#occupancy, x, z, padding) ||
|
|
1289
|
+
x < this.#navMin ||
|
|
1290
|
+
x > this.#navMax ||
|
|
1291
|
+
z < this.#navMin ||
|
|
1292
|
+
z > this.#navMax
|
|
1293
|
+
);
|
|
1177
1294
|
}
|
|
1178
1295
|
|
|
1179
1296
|
/** True when the soldier stands in any raised deck's footprint — routing beneath it. */
|
|
@@ -1603,8 +1720,7 @@ export class Enemy {
|
|
|
1603
1720
|
this.#reattachWeapon();
|
|
1604
1721
|
this.#bodyClearance = null;
|
|
1605
1722
|
this.#footClearance = null;
|
|
1606
|
-
//
|
|
1607
|
-
// soldier and never again. The fade below is a uniform on the pipeline this just built.
|
|
1723
|
+
// Restore the precompiled fade state before changing its opacity uniform.
|
|
1608
1724
|
this.#fixBlendState();
|
|
1609
1725
|
this.#setOpacity(0);
|
|
1610
1726
|
this.#reaction = 0;
|
|
@@ -1905,6 +2021,7 @@ export class Enemy {
|
|
|
1905
2021
|
* all five at once.
|
|
1906
2022
|
*/
|
|
1907
2023
|
materialOpacity: number;
|
|
2024
|
+
bodyUsesOpaqueFade: boolean;
|
|
1908
2025
|
/** Lowest `materialOpacity` this soldier has ever reported. See `#opacityFloor`. */
|
|
1909
2026
|
materialOpacityFloor: number;
|
|
1910
2027
|
reaction: number;
|
|
@@ -1984,6 +2101,11 @@ export class Enemy {
|
|
|
1984
2101
|
deadFor: this.#deadFor,
|
|
1985
2102
|
armed: this.#weapon !== undefined,
|
|
1986
2103
|
materialOpacity: this.#fade,
|
|
2104
|
+
bodyUsesOpaqueFade: this.#bodyMeshes.every((mesh) =>
|
|
2105
|
+
(Array.isArray(mesh.material) ? mesh.material : [mesh.material]).every(
|
|
2106
|
+
(material) => !material.transparent && material.alphaHash && material.depthWrite,
|
|
2107
|
+
),
|
|
2108
|
+
),
|
|
1987
2109
|
materialOpacityFloor: this.#opacityFloor,
|
|
1988
2110
|
reaction: this.#reaction,
|
|
1989
2111
|
bodyClearance: this.#bodyClearance,
|
|
@@ -17,12 +17,13 @@ import {
|
|
|
17
17
|
import { scale } from "../render/scale.js";
|
|
18
18
|
import type { GameState } from "../state.js";
|
|
19
19
|
import type { TouchFrame } from "./TouchControls.js";
|
|
20
|
+
import { type IStairView, groundMove, stairView } from "./movement.js";
|
|
20
21
|
|
|
21
22
|
type GameCtx = ICtx<GameState, IPhysicsContext>;
|
|
22
23
|
|
|
23
24
|
export const EYE_HEIGHT = scale.eyeHeight;
|
|
24
|
-
const WALK_SPEED = 5.6;
|
|
25
|
-
const SPRINT_SPEED = 8.2;
|
|
25
|
+
export const WALK_SPEED = 5.6;
|
|
26
|
+
export const SPRINT_SPEED = 8.2;
|
|
26
27
|
/** Crouched movement, and how far the eye drops. A crouch that only slows you reads as a bug. */
|
|
27
28
|
const CROUCH_SPEED = 2.6;
|
|
28
29
|
const CROUCH_EYE_DROP = scale.eyeHeight * 0.34;
|
|
@@ -76,6 +77,8 @@ export class FpsPlayer {
|
|
|
76
77
|
distanceMoved = 0;
|
|
77
78
|
aiming = false;
|
|
78
79
|
crouching = false;
|
|
80
|
+
/** Shift, or a thumb on the stick rim, and neither aiming nor crouching. Read by the rifle. */
|
|
81
|
+
sprinting = false;
|
|
79
82
|
/** This tick's thumb input, set by the scene before `update`. Undefined on desktop. */
|
|
80
83
|
touch: TouchFrame | undefined;
|
|
81
84
|
/**
|
|
@@ -86,8 +89,18 @@ export class FpsPlayer {
|
|
|
86
89
|
* scenario that samples every few hundred frames still catches a single bad step.
|
|
87
90
|
*/
|
|
88
91
|
cameraLagPeak = 0;
|
|
92
|
+
/**
|
|
93
|
+
* Fastest climb of the eye in one tick while on the ground, in metres. The body steps up a stair
|
|
94
|
+
* in a few ticks and then stops; an eye welded to it climbs in jolts. A peak, like the lag above.
|
|
95
|
+
*/
|
|
96
|
+
viewRisePeak = 0;
|
|
89
97
|
/** 0 standing, 1 fully folded; eased so the eye slides rather than teleports. */
|
|
90
98
|
#crouch = 0;
|
|
99
|
+
/** The body height the eye shows, smoothed over stair steps; undefined until the first sync. */
|
|
100
|
+
#view: IStairView | undefined;
|
|
101
|
+
/** The smoothed height minus the body's, when the camera was last placed. */
|
|
102
|
+
#viewOffset = 0;
|
|
103
|
+
#tickDt = 0;
|
|
91
104
|
/** Set by the scene: fired each time a stride completes, so footsteps keep pace with speed. */
|
|
92
105
|
onFootstep: ((sprinting: boolean) => void) | undefined;
|
|
93
106
|
#camera: PerspectiveCamera;
|
|
@@ -132,12 +145,17 @@ export class FpsPlayer {
|
|
|
132
145
|
};
|
|
133
146
|
}
|
|
134
147
|
|
|
135
|
-
/**
|
|
148
|
+
/**
|
|
149
|
+
* The camera basis is the single source of aim truth, including hit shake. The camera hangs off
|
|
150
|
+
* the scene root, so its own placement is its world pose: reading the position and rotation
|
|
151
|
+
* `syncCamera` wrote is the same answer as `getWorldPosition`/`getWorldDirection` without the
|
|
152
|
+
* walk those two make up the camera and back down the viewmodel, once every frame, for a pose
|
|
153
|
+
* this class had just written itself.
|
|
154
|
+
*/
|
|
136
155
|
aimRay(): { origin: Vector3; direction: Vector3 } {
|
|
137
|
-
this.#camera.updateMatrixWorld(true);
|
|
138
156
|
return {
|
|
139
|
-
origin: this.#camera.
|
|
140
|
-
direction:
|
|
157
|
+
origin: this.#camera.position.clone(),
|
|
158
|
+
direction: new Vector3(0, 0, -1).applyQuaternion(this.#camera.quaternion),
|
|
141
159
|
};
|
|
142
160
|
}
|
|
143
161
|
|
|
@@ -150,8 +168,16 @@ export class FpsPlayer {
|
|
|
150
168
|
|
|
151
169
|
syncCamera(): void {
|
|
152
170
|
const eye = this.eye;
|
|
171
|
+
const bodyY = this.mesh.position.y;
|
|
172
|
+
const before = this.#view?.y;
|
|
173
|
+
this.#view = stairView(this.#view, bodyY, this.body.grounded, this.#tickDt);
|
|
174
|
+
if (before !== undefined && this.body.grounded) {
|
|
175
|
+
this.viewRisePeak = Math.max(this.viewRisePeak, Math.abs(this.#view.y - before));
|
|
176
|
+
}
|
|
177
|
+
this.#viewOffset = this.#view.y - bodyY;
|
|
153
178
|
applyFirstPerson(this.#camera, {
|
|
154
179
|
...eye,
|
|
180
|
+
y: eye.y + this.#viewOffset,
|
|
155
181
|
yaw: this.look.yaw,
|
|
156
182
|
pitch: this.look.pitch,
|
|
157
183
|
shake: this.#shake,
|
|
@@ -160,7 +186,9 @@ export class FpsPlayer {
|
|
|
160
186
|
}
|
|
161
187
|
|
|
162
188
|
update(ctx: GameCtx, dt: number, canAim: boolean): void {
|
|
163
|
-
|
|
189
|
+
this.#tickDt = dt;
|
|
190
|
+
// The stair offset is deliberate; what is left is the body moving after the camera was placed.
|
|
191
|
+
const renderedLag = Math.abs(this.#camera.position.y - this.eye.y - this.#viewOffset);
|
|
164
192
|
if (renderedLag > this.cameraLagPeak) this.cameraLagPeak = renderedLag;
|
|
165
193
|
const touch = this.touch;
|
|
166
194
|
this.aiming = canAim && (ctx.input.pressed("aim") || touch?.aim === true);
|
|
@@ -182,6 +210,7 @@ export class FpsPlayer {
|
|
|
182
210
|
// same two vetoes below apply to a thumb and to Shift alike.
|
|
183
211
|
const sprintAsked = ctx.input.pressed("sprint") || touch?.sprint === true;
|
|
184
212
|
const sprinting = sprintAsked && !this.aiming && !this.crouching;
|
|
213
|
+
this.sprinting = sprinting;
|
|
185
214
|
// Crouch wins over sprint: holding both should not sprint at a crouch-walk's silhouette.
|
|
186
215
|
const speed = this.crouching ? CROUCH_SPEED : sprinting ? SPRINT_SPEED : WALK_SPEED;
|
|
187
216
|
// `vector().y` is +up; forward on this ground plane is -z.
|
|
@@ -189,15 +218,15 @@ export class FpsPlayer {
|
|
|
189
218
|
const forwardZ = -Math.cos(this.look.yaw);
|
|
190
219
|
const rightX = Math.cos(this.look.yaw);
|
|
191
220
|
const rightZ = -Math.sin(this.look.yaw);
|
|
192
|
-
let
|
|
193
|
-
let
|
|
194
|
-
const length = Math.hypot(
|
|
221
|
+
let wishX = forwardX * move.y + rightX * move.x;
|
|
222
|
+
let wishZ = forwardZ * move.y + rightZ * move.x;
|
|
223
|
+
const length = Math.hypot(wishX, wishZ);
|
|
195
224
|
if (length > 1e-4) {
|
|
196
|
-
|
|
197
|
-
|
|
225
|
+
wishX /= length;
|
|
226
|
+
wishZ /= length;
|
|
198
227
|
} else {
|
|
199
|
-
|
|
200
|
-
|
|
228
|
+
wishX = 0;
|
|
229
|
+
wishZ = 0;
|
|
201
230
|
}
|
|
202
231
|
// The backend writes the solved transform after the step, so measuring the
|
|
203
232
|
// mesh either side of `moveAndSlide` in one frame always reads zero. Compare
|
|
@@ -215,8 +244,9 @@ export class FpsPlayer {
|
|
|
215
244
|
}
|
|
216
245
|
this.#lastX = this.mesh.position.x;
|
|
217
246
|
this.#lastZ = this.mesh.position.z;
|
|
218
|
-
|
|
219
|
-
|
|
247
|
+
// Friction, then acceleration toward the wished speed (see `movement.ts`): the body takes a
|
|
248
|
+
// tenth of a second to reach speed and about a third to stop, instead of one tick for both.
|
|
249
|
+
groundMove(this.body.velocity, wishX, wishZ, length > 1e-4 ? speed : 0, dt);
|
|
220
250
|
this.body.moveAndSlide(dt);
|
|
221
251
|
|
|
222
252
|
this.#shake = Math.max(0, this.#shake - dt * 3.2);
|
|
@@ -243,8 +273,15 @@ export class FpsPlayer {
|
|
|
243
273
|
this.#shakePeak = Math.max(this.#shakePeak, this.#shake);
|
|
244
274
|
}
|
|
245
275
|
|
|
276
|
+
/** Horizontal speed in m/s, the one the rifle's bob and clip follow. */
|
|
277
|
+
get speed(): number {
|
|
278
|
+
return Math.hypot(this.body.velocity.x, this.body.velocity.z);
|
|
279
|
+
}
|
|
280
|
+
|
|
246
281
|
debug(): {
|
|
247
282
|
cameraLagPeak: number;
|
|
283
|
+
viewRisePeak: number;
|
|
284
|
+
speed: number;
|
|
248
285
|
crouching: number;
|
|
249
286
|
health: number;
|
|
250
287
|
position: number[];
|
|
@@ -259,6 +296,8 @@ export class FpsPlayer {
|
|
|
259
296
|
const cameraDirection = this.#lastFiringCameraDirection;
|
|
260
297
|
return {
|
|
261
298
|
cameraLagPeak: this.cameraLagPeak,
|
|
299
|
+
viewRisePeak: this.viewRisePeak,
|
|
300
|
+
speed: this.speed,
|
|
262
301
|
crouching: this.crouching ? 1 : 0,
|
|
263
302
|
health: this.health,
|
|
264
303
|
position: this.mesh.position.toArray(),
|
|
@@ -28,6 +28,7 @@ import { FIRST_PERSON } from "../render/camera.js";
|
|
|
28
28
|
import { PooledBillboards } from "../render/pooled-billboards.js";
|
|
29
29
|
import { scale } from "../render/scale.js";
|
|
30
30
|
import type { GameState } from "../state.js";
|
|
31
|
+
import { SPRINT_SPEED, WALK_SPEED } from "./FpsPlayer.js";
|
|
31
32
|
|
|
32
33
|
type GameCtx = ICtx<GameState, IPhysicsContext>;
|
|
33
34
|
|
|
@@ -54,6 +55,36 @@ const AIM_Z = -0.16;
|
|
|
54
55
|
const ZERO_DISTANCE = 25;
|
|
55
56
|
const MAX_CONVERGENCE_DEGREES = 8;
|
|
56
57
|
const UP = new Vector3(0, 1, 0);
|
|
58
|
+
/** Below this share of a gait's speed the clip stops slowing: a crawl still reads as a walk. */
|
|
59
|
+
const MIN_LOCOMOTION_RATE = 0.6;
|
|
60
|
+
|
|
61
|
+
export type LocomotionClip = "Idle" | "Walk" | "Run";
|
|
62
|
+
|
|
63
|
+
export interface ILocomotion {
|
|
64
|
+
readonly clip: LocomotionClip;
|
|
65
|
+
/** Playback rate: the authored rate at full gait speed, slower below it, never faster. */
|
|
66
|
+
readonly timeScale: number;
|
|
67
|
+
/** Fraction of the procedural sway and bob that survives beside the clip. */
|
|
68
|
+
readonly bobScale: number;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* The clip, rate and procedural-bob weight for a body speed.
|
|
73
|
+
*
|
|
74
|
+
* Walking plays Walk and only a sprint plays Run, each at its authored rate (about 1.2 and 1.5
|
|
75
|
+
* cycles a second) at full gait speed and slower while the body eases in. Never faster: the
|
|
76
|
+
* hands are the closest thing on screen, and a sped-up cycle reads as a seizure, not as speed.
|
|
77
|
+
* While a locomotion clip plays it owns the motion, so the procedural bob is off; two unrelated
|
|
78
|
+
* oscillations on the same hands beat against each other.
|
|
79
|
+
*/
|
|
80
|
+
export function locomotion(speed: number, sprinting: boolean): ILocomotion {
|
|
81
|
+
if (speed <= WALK_SPEED * 0.05) return { bobScale: 1, clip: "Idle", timeScale: 1 };
|
|
82
|
+
// Run only once the body is actually past walking pace; the key alone at a standstill is not a gait.
|
|
83
|
+
const run = sprinting && speed >= WALK_SPEED;
|
|
84
|
+
const gaitSpeed = run ? SPRINT_SPEED : WALK_SPEED;
|
|
85
|
+
const timeScale = MathUtils.clamp(speed / gaitSpeed, MIN_LOCOMOTION_RATE, 1);
|
|
86
|
+
return { bobScale: 0, clip: run ? "Run" : "Walk", timeScale };
|
|
87
|
+
}
|
|
57
88
|
|
|
58
89
|
export type AimRay = { origin: Vector3; direction: Vector3 };
|
|
59
90
|
|
|
@@ -81,6 +112,10 @@ export class Rifle {
|
|
|
81
112
|
#lowered = 0;
|
|
82
113
|
|
|
83
114
|
#animation: AnimationPlayer | undefined;
|
|
115
|
+
/** Clip seconds the playing clip advanced, and the game seconds that took, since it started. */
|
|
116
|
+
#handsClip: string | undefined;
|
|
117
|
+
#handsClipSeconds = 0;
|
|
118
|
+
#handsSeconds = 0;
|
|
84
119
|
#clips: ReadonlySet<string>;
|
|
85
120
|
#shootFor = 0;
|
|
86
121
|
#camera: PerspectiveCamera;
|
|
@@ -398,28 +433,36 @@ export class Rifle {
|
|
|
398
433
|
return (this.#flash.material as MeshBasicMaterial).opacity;
|
|
399
434
|
}
|
|
400
435
|
|
|
401
|
-
update(dt: number, aiming: boolean,
|
|
436
|
+
update(dt: number, aiming: boolean, speed: number, sprinting: boolean): void {
|
|
402
437
|
this.#shootFor = Math.max(0, this.#shootFor - dt);
|
|
438
|
+
const gait = locomotion(speed, sprinting);
|
|
403
439
|
if (this.reloading) this.#play("Reload");
|
|
404
440
|
else if (this.#shootFor > 0) this.#play("Shoot", 0.02);
|
|
405
|
-
else
|
|
406
|
-
|
|
407
|
-
|
|
408
|
-
this.#animation?.update(dt);
|
|
441
|
+
else this.#play(gait.clip);
|
|
442
|
+
this.#syncPlayback(gait);
|
|
443
|
+
this.#advance(dt);
|
|
409
444
|
this.decay(dt);
|
|
410
445
|
// The sights drop while the magazine is out and come back up after.
|
|
411
446
|
const wantLowered = this.reloading ? 1 : 0;
|
|
412
447
|
this.#lowered += (wantLowered - this.#lowered) * Math.min(1, dt * 9);
|
|
413
448
|
this.#blend += ((aiming && !this.reloading ? 1 : 0) - this.#blend) * Math.min(1, dt * 12);
|
|
449
|
+
const moving = Math.min(1, speed / WALK_SPEED);
|
|
414
450
|
this.#sway += dt * (2.6 + moving * 4.4);
|
|
415
|
-
this.#apply(moving,
|
|
451
|
+
this.#apply(moving, gait.bobScale);
|
|
416
452
|
}
|
|
417
453
|
|
|
418
|
-
#
|
|
454
|
+
#syncPlayback(gait: ILocomotion): void {
|
|
455
|
+
if (this.#animation === undefined || !this.#clips.has(gait.clip)) return;
|
|
456
|
+
this.#animation.mixer
|
|
457
|
+
.clipAction(this.#animation.clip(gait.clip))
|
|
458
|
+
.setEffectiveTimeScale(gait.timeScale);
|
|
459
|
+
}
|
|
460
|
+
|
|
461
|
+
#apply(moving: number, bobScale: number): void {
|
|
419
462
|
const t = this.#blend;
|
|
420
463
|
const hipMotion = 1 - t;
|
|
421
|
-
const bob = Math.sin(this.#sway) * 0.008 * (0.35 + moving) * hipMotion;
|
|
422
|
-
const bobY = Math.abs(Math.cos(this.#sway)) * 0.01 * (0.25 + moving) * hipMotion;
|
|
464
|
+
const bob = Math.sin(this.#sway) * 0.008 * (0.35 + moving) * hipMotion * bobScale;
|
|
465
|
+
const bobY = Math.abs(Math.cos(this.#sway)) * 0.01 * (0.25 + moving) * hipMotion * bobScale;
|
|
423
466
|
const kick = this.#kick * this.#kick;
|
|
424
467
|
this.group.position.set(
|
|
425
468
|
HIP.x + (-this.#opticLocal.x - HIP.x) * t + bob,
|
|
@@ -449,8 +492,35 @@ export class Rifle {
|
|
|
449
492
|
this.group.quaternion.premultiply(correction);
|
|
450
493
|
}
|
|
451
494
|
|
|
495
|
+
/** Advance the hands and measure how fast the playing clip actually ran, wraps included. */
|
|
496
|
+
#advance(dt: number): void {
|
|
497
|
+
const animation = this.#animation;
|
|
498
|
+
if (animation === undefined) return;
|
|
499
|
+
const name = animation.current;
|
|
500
|
+
const action =
|
|
501
|
+
name === undefined ? undefined : animation.mixer.clipAction(animation.clip(name));
|
|
502
|
+
const before = action?.time ?? 0;
|
|
503
|
+
animation.update(dt);
|
|
504
|
+
if (action === undefined || dt <= 0) return;
|
|
505
|
+
if (name !== this.#handsClip) {
|
|
506
|
+
this.#handsClip = name;
|
|
507
|
+
this.#handsClipSeconds = 0;
|
|
508
|
+
this.#handsSeconds = 0;
|
|
509
|
+
}
|
|
510
|
+
const duration = action.getClip().duration;
|
|
511
|
+
let advanced = action.time - before;
|
|
512
|
+
if (advanced < 0 && duration > 0) advanced += duration;
|
|
513
|
+
this.#handsClipSeconds += advanced;
|
|
514
|
+
this.#handsSeconds += dt;
|
|
515
|
+
}
|
|
516
|
+
|
|
517
|
+
#handsRate(): number {
|
|
518
|
+
return this.#handsSeconds > 0 ? this.#handsClipSeconds / this.#handsSeconds : 1;
|
|
519
|
+
}
|
|
520
|
+
|
|
452
521
|
debug(): {
|
|
453
522
|
barrelAxisErrorDeg: number;
|
|
523
|
+
handsRate: number;
|
|
454
524
|
flashOpacity: number;
|
|
455
525
|
muzzleLocal: number[];
|
|
456
526
|
tipGapToGeometry: number;
|
|
@@ -469,6 +539,10 @@ export class Rifle {
|
|
|
469
539
|
tipGapToGeometry: this.#flash.position.distanceTo(this.#geometryTipLocal),
|
|
470
540
|
opticScreen: { x: (optic.x + 1) / 2, y: (1 - optic.y) / 2 },
|
|
471
541
|
viewmodelLength: this.#viewmodelLength,
|
|
542
|
+
// Clip seconds per game second the playing clip actually ran since it started. Above 1 is
|
|
543
|
+
// the hands sped past their authored cycle: stride sync once read the camera carrying them
|
|
544
|
+
// as walking and played them at up to 3x.
|
|
545
|
+
handsRate: this.#handsRate(),
|
|
472
546
|
};
|
|
473
547
|
}
|
|
474
548
|
|