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
|
@@ -0,0 +1,915 @@
|
|
|
1
|
+
import { AnimationPlayer, type ICtx } from "@threenative/core";
|
|
2
|
+
import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
|
|
3
|
+
import { Group, MathUtils, Vector3 } from "three";
|
|
4
|
+
import { type IHero, createHero } from "../render/hero.js";
|
|
5
|
+
import type { ITouchInput } from "../render/touch-layout.js";
|
|
6
|
+
import type { GameState } from "../state.js";
|
|
7
|
+
|
|
8
|
+
export type GameCtx = ICtx<GameState, IPhysicsContext>;
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* The capsule, and so how far the rig's feet sit below the body origin. A `CollisionShape3D`
|
|
12
|
+
* capsule is centred on the body's origin — the hero's waist — so the rig is pushed down by
|
|
13
|
+
* `halfHeight + radius` or the hero floats a body-length above everything it lands on.
|
|
14
|
+
*/
|
|
15
|
+
const CAPSULE = { halfHeight: 0.45, radius: 0.35 } as const;
|
|
16
|
+
export const FOOT_OFFSET = CAPSULE.halfHeight + CAPSULE.radius;
|
|
17
|
+
/** The physics layer of the static world. Probes scan only it, so they never hit the hero. */
|
|
18
|
+
export const WORLD_LAYER = 1;
|
|
19
|
+
const HERO_LAYER = 2;
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* The whole feel, in metres and seconds, from the 30 Hz reference (1 unit = 1 cm: units/frame
|
|
23
|
+
* × 0.3 = m/s, units/frame² × 9 = m/s²). The course is laid out from this table, never the other
|
|
24
|
+
* way round: change a number here and the gaps in `level/Course.ts` change their meaning.
|
|
25
|
+
*/
|
|
26
|
+
export const HERO_FEEL = {
|
|
27
|
+
/** Target ground speed at full stick, and the speed nothing but a long jump or dive exceeds. */
|
|
28
|
+
runCap: 9.6,
|
|
29
|
+
hardCap: 14.4,
|
|
30
|
+
/** Ground acceleration toward the stick target: `runAccel - runDrag · speed` m/s². */
|
|
31
|
+
runAccel: 9.9,
|
|
32
|
+
runDrag: 0.7,
|
|
33
|
+
/** Slowing down to a lower target. */
|
|
34
|
+
overspeedDecel: 9,
|
|
35
|
+
/** Stopping with the stick released (kit value: the reference's coast is longer). */
|
|
36
|
+
stopDecel: 18,
|
|
37
|
+
/** Face yaw approaches the stick yaw at this rate, rad/s (337.5 °/s). */
|
|
38
|
+
turnRate: (337.5 * Math.PI) / 180,
|
|
39
|
+
/** A stick this far from the facing, at speed, is a turn-around skid. */
|
|
40
|
+
skidAngle: (100 * Math.PI) / 180,
|
|
41
|
+
skidMinSpeed: 4.8,
|
|
42
|
+
skidDecel: 36,
|
|
43
|
+
gravity: 36,
|
|
44
|
+
terminalFall: 22.5,
|
|
45
|
+
/** Letting go of jump while still rising faster than this cuts the rise to a quarter. */
|
|
46
|
+
jumpCutSpeed: 6,
|
|
47
|
+
jumpCutFactor: 0.25,
|
|
48
|
+
jumpSpeed: 12.6,
|
|
49
|
+
/** Each running jump adds this share of forward speed to its rise, and keeps 0.8 of it. */
|
|
50
|
+
jumpForwardLift: 0.25,
|
|
51
|
+
jumpForwardKeep: 0.8,
|
|
52
|
+
doubleJumpSpeed: 15.6,
|
|
53
|
+
tripleJumpSpeed: 20.7,
|
|
54
|
+
tripleMinSpeed: 6,
|
|
55
|
+
/**
|
|
56
|
+
* A landing from a single jump, a fall or a side flip opens a double jump, and a landing from a
|
|
57
|
+
* double opens a triple, for this long: the classic's 4 landing frames plus its 5-frame
|
|
58
|
+
* double-jump timer at 30 Hz (sm64 decomp, mario_actions_moving.c:26-52 and :1767,
|
|
59
|
+
* mario.c:1030-1065 and :1411).
|
|
60
|
+
*/
|
|
61
|
+
chainWindow: 0.3,
|
|
62
|
+
/**
|
|
63
|
+
* A jump pressed this long before touchdown counts as pressed on landing, so a double tap that
|
|
64
|
+
* comes a little early still chains. The classic has no such buffer: a press before touchdown
|
|
65
|
+
* was simply lost, which is the miss players remember.
|
|
66
|
+
*/
|
|
67
|
+
jumpBuffer: 0.12,
|
|
68
|
+
/**
|
|
69
|
+
* The air double jump, the owner's addition to the classic chain (2026-10-24): a second press
|
|
70
|
+
* this long after take-off, from a single jump, a walk-off fall or a wall kick, rises again at
|
|
71
|
+
* `jumpSpeed`. One per flight, back on a landing, a wall kick or a ledge grab. A press the
|
|
72
|
+
* buffer would carry to touchdown stays the chain's.
|
|
73
|
+
*/
|
|
74
|
+
airJumpGuard: 0.1,
|
|
75
|
+
backflipSpeed: 18.6,
|
|
76
|
+
backflipBack: 4.8,
|
|
77
|
+
sideflipSpeed: 18.6,
|
|
78
|
+
sideflipForward: 2.4,
|
|
79
|
+
/** Crouch at speed starts a slide; jump inside the window at speed is a long jump. */
|
|
80
|
+
crouchSlideMinSpeed: 3,
|
|
81
|
+
crouchSlideDecel: 6,
|
|
82
|
+
longJumpWindow: 0.5,
|
|
83
|
+
longJumpSpeed: 9,
|
|
84
|
+
longJumpScale: 1.5,
|
|
85
|
+
longJumpGravity: 18,
|
|
86
|
+
/** A wall hit above this speed bounces the hero off and opens the wall-kick window. */
|
|
87
|
+
wallBonkSpeed: 4.8,
|
|
88
|
+
wallKickWindow: 0.167,
|
|
89
|
+
wallKickSpeed: 18.6,
|
|
90
|
+
wallKickForward: 7.2,
|
|
91
|
+
diveBoost: 4.5,
|
|
92
|
+
diveMinSpeed: 4.8,
|
|
93
|
+
diveHop: 4.5,
|
|
94
|
+
diveSlideDecel: 9,
|
|
95
|
+
poundHang: 0.25,
|
|
96
|
+
poundSpeed: 15,
|
|
97
|
+
poundRecover: 0.3,
|
|
98
|
+
/** Air steering acceleration; the hero cannot steer past `runCap` in the air. */
|
|
99
|
+
airAccel: 13.5,
|
|
100
|
+
/** The ledge probe: 0.6 m past the wall, from 1.6 m above the feet down to 1.0 m above them. */
|
|
101
|
+
ledgeAhead: 0.6,
|
|
102
|
+
ledgeTop: 1.6,
|
|
103
|
+
ledgeBottom: 1.0,
|
|
104
|
+
/** Hang time before a forward press climbs, so the grab reads before the climb. */
|
|
105
|
+
ledgeHangMin: 0.25,
|
|
106
|
+
ledgeClimbTime: 0.3,
|
|
107
|
+
/** Below this the hero has fallen into the sea and the checkpoint takes over. */
|
|
108
|
+
killPlane: -6,
|
|
109
|
+
} as const;
|
|
110
|
+
|
|
111
|
+
export type HeroAction =
|
|
112
|
+
| "idle"
|
|
113
|
+
| "run"
|
|
114
|
+
| "skid"
|
|
115
|
+
| "crouch"
|
|
116
|
+
| "crouchSlide"
|
|
117
|
+
| "diveSlide"
|
|
118
|
+
| "poundLand"
|
|
119
|
+
| "single"
|
|
120
|
+
| "double"
|
|
121
|
+
| "triple"
|
|
122
|
+
| "backflip"
|
|
123
|
+
| "sideflip"
|
|
124
|
+
| "longJump"
|
|
125
|
+
| "wallKick"
|
|
126
|
+
| "dive"
|
|
127
|
+
| "groundPound"
|
|
128
|
+
| "fall"
|
|
129
|
+
| "ledgeHang"
|
|
130
|
+
| "ledgeClimb";
|
|
131
|
+
|
|
132
|
+
const GROUND: ReadonlySet<HeroAction> = new Set([
|
|
133
|
+
"idle",
|
|
134
|
+
"run",
|
|
135
|
+
"skid",
|
|
136
|
+
"crouch",
|
|
137
|
+
"crouchSlide",
|
|
138
|
+
"diveSlide",
|
|
139
|
+
"poundLand",
|
|
140
|
+
]);
|
|
141
|
+
/** Airborne actions a wall can stop and a ledge can catch. */
|
|
142
|
+
const WALL_AIR: ReadonlySet<HeroAction> = new Set([
|
|
143
|
+
"single",
|
|
144
|
+
"double",
|
|
145
|
+
"triple",
|
|
146
|
+
"backflip",
|
|
147
|
+
"sideflip",
|
|
148
|
+
"longJump",
|
|
149
|
+
"wallKick",
|
|
150
|
+
"fall",
|
|
151
|
+
]);
|
|
152
|
+
/** Airborne actions a second press turns into the air double jump. */
|
|
153
|
+
const AIR_JUMP: ReadonlySet<HeroAction> = new Set(["single", "fall", "wallKick"]);
|
|
154
|
+
/** Dev builds log every jump press and its touchdown as `TN_HERO_INPUT`. */
|
|
155
|
+
const DEV = (import.meta as unknown as { env?: { DEV?: boolean } }).env?.DEV === true;
|
|
156
|
+
/** Jumps whose rise the jump button controls. */
|
|
157
|
+
const VARIABLE: ReadonlySet<HeroAction> = new Set(["single", "double"]);
|
|
158
|
+
/** Jumps a scenario measures: apex above take-off and ground distance along the take-off facing. */
|
|
159
|
+
const MEASURED = ["single", "double", "triple", "backflip", "sideflip", "longJump", "wallKick"];
|
|
160
|
+
|
|
161
|
+
export interface IWallHit {
|
|
162
|
+
readonly x: number;
|
|
163
|
+
readonly y: number;
|
|
164
|
+
readonly z: number;
|
|
165
|
+
readonly nx: number;
|
|
166
|
+
readonly nz: number;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
/** A ray against the static world: the hit point and normal, or undefined. */
|
|
170
|
+
export type WorldRay = (
|
|
171
|
+
from: Vector3,
|
|
172
|
+
to: Vector3,
|
|
173
|
+
) => { position: Vector3; normal: Vector3 } | undefined;
|
|
174
|
+
|
|
175
|
+
const _from = new Vector3();
|
|
176
|
+
const _to = new Vector3();
|
|
177
|
+
|
|
178
|
+
/** The nearest wall one probe height found, its unit normal flattened to the ground. */
|
|
179
|
+
interface IWallProbe {
|
|
180
|
+
found: boolean;
|
|
181
|
+
x: number;
|
|
182
|
+
y: number;
|
|
183
|
+
z: number;
|
|
184
|
+
nx: number;
|
|
185
|
+
nz: number;
|
|
186
|
+
}
|
|
187
|
+
const _lower: IWallProbe = { found: false, nx: 0, nz: 0, x: 0, y: 0, z: 0 };
|
|
188
|
+
const _upper: IWallProbe = { found: false, nx: 0, nz: 0, x: 0, y: 0, z: 0 };
|
|
189
|
+
/** The wall probe's rays: along the travel and 45° to either side of it. */
|
|
190
|
+
const WALL_FAN = [0, Math.PI / 4, -Math.PI / 4] as const;
|
|
191
|
+
|
|
192
|
+
function forwardOf(yaw: number, target: Vector3): Vector3 {
|
|
193
|
+
return target.set(-Math.sin(yaw), 0, -Math.cos(yaw));
|
|
194
|
+
}
|
|
195
|
+
|
|
196
|
+
function angleTo(from: number, to: number): number {
|
|
197
|
+
return MathUtils.euclideanModulo(to - from + Math.PI, Math.PI * 2) - Math.PI;
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/**
|
|
201
|
+
* Pip, the hero: one action state machine on a `CharacterBody3D`, driven by a camera-relative
|
|
202
|
+
* stick and three buttons (jump, crouch, attack). Ground motion is a speed along the facing, as in
|
|
203
|
+
* the reference; air motion is a horizontal velocity the stick nudges. The wall and ledge are found
|
|
204
|
+
* with rays against the static world, because `moveAndSlide` reports the floor and not the wall.
|
|
205
|
+
*/
|
|
206
|
+
export class Hero {
|
|
207
|
+
/** The body object. Its origin is the hero's waist, because that is what a capsule is centred on. */
|
|
208
|
+
readonly mesh: Group;
|
|
209
|
+
readonly body: CharacterBody3D;
|
|
210
|
+
readonly rig: IHero;
|
|
211
|
+
readonly tags = ["player"];
|
|
212
|
+
action: HeroAction = "idle";
|
|
213
|
+
yaw = 0;
|
|
214
|
+
landings = 0;
|
|
215
|
+
wallHits = 0;
|
|
216
|
+
/** Ground speed along `yaw`. */
|
|
217
|
+
#speed = 0;
|
|
218
|
+
readonly #air = new Vector3();
|
|
219
|
+
#actionTime = 0;
|
|
220
|
+
#chainStage = 0;
|
|
221
|
+
#chainTimer = 0;
|
|
222
|
+
#jumpBuffer = 0;
|
|
223
|
+
#airJumpReady = true;
|
|
224
|
+
/** Seconds off the ground, and when in this flight jump was last pressed (-1: not yet). */
|
|
225
|
+
#airTime = 0;
|
|
226
|
+
#pressedAt = -1;
|
|
227
|
+
#wallTimer = 0;
|
|
228
|
+
#wallKickRise = 0;
|
|
229
|
+
#wallKickFrom = 0;
|
|
230
|
+
readonly #wall: { nx: number; nz: number } = { nx: 0, nz: 0 };
|
|
231
|
+
readonly #ledge = new Vector3();
|
|
232
|
+
#cut = false;
|
|
233
|
+
#groundY = 0;
|
|
234
|
+
readonly #takeoff = new Vector3();
|
|
235
|
+
#takeoffYaw = 0;
|
|
236
|
+
#takeoffSpeed = 0;
|
|
237
|
+
#peak = 0;
|
|
238
|
+
#airKind: HeroAction = "fall";
|
|
239
|
+
#stickYaw = 0;
|
|
240
|
+
readonly #counts: Record<string, number> = {};
|
|
241
|
+
readonly #apex: Record<string, number> = {};
|
|
242
|
+
readonly #distance: Record<string, number> = {};
|
|
243
|
+
readonly #takeoffSpeeds: Record<string, number> = {};
|
|
244
|
+
#sideflipFacingError = 0;
|
|
245
|
+
#wallKicks = 0;
|
|
246
|
+
#ledgeGrabs = 0;
|
|
247
|
+
#pounds = 0;
|
|
248
|
+
readonly #ray: WorldRay;
|
|
249
|
+
readonly #intended = new Vector3();
|
|
250
|
+
readonly #scratch = new Vector3();
|
|
251
|
+
readonly #anim: AnimationPlayer;
|
|
252
|
+
/** Metres the planted sole slid over the ground while running, and the seconds it was planted. */
|
|
253
|
+
#slid = 0;
|
|
254
|
+
#plantedTime = 0;
|
|
255
|
+
#planted = -1;
|
|
256
|
+
readonly #sole = new Vector3();
|
|
257
|
+
/** Seconds the hero is still invulnerable after a hit. */
|
|
258
|
+
hurtTimer = 0;
|
|
259
|
+
|
|
260
|
+
constructor(ctx: GameCtx, spawn: Vector3, ray: WorldRay) {
|
|
261
|
+
this.#ray = ray;
|
|
262
|
+
this.rig = createHero();
|
|
263
|
+
this.mesh = new Group();
|
|
264
|
+
this.mesh.add(this.rig.group);
|
|
265
|
+
this.rig.group.position.y = -FOOT_OFFSET;
|
|
266
|
+
this.mesh.position.copy(spawn);
|
|
267
|
+
this.#groundY = spawn.y - FOOT_OFFSET;
|
|
268
|
+
ctx.add(this.mesh);
|
|
269
|
+
// `strideRoot` is the body: the walk and run play at the rate the ground it covers asks for.
|
|
270
|
+
this.#anim = new AnimationPlayer({
|
|
271
|
+
clips: this.rig.clips,
|
|
272
|
+
root: this.rig.group,
|
|
273
|
+
strideRoot: this.mesh,
|
|
274
|
+
});
|
|
275
|
+
this.body = new CharacterBody3D({
|
|
276
|
+
autostep: { maxHeight: 0.3, minWidth: 0.2 },
|
|
277
|
+
collisionLayer: HERO_LAYER,
|
|
278
|
+
collisionMask: 0xffff,
|
|
279
|
+
entity: "player",
|
|
280
|
+
gravity: -HERO_FEEL.gravity,
|
|
281
|
+
maxFallSpeed: HERO_FEEL.terminalFall,
|
|
282
|
+
object: this.mesh,
|
|
283
|
+
physics: ctx.physics,
|
|
284
|
+
shape: CollisionShape3D.capsule(CAPSULE.halfHeight, CAPSULE.radius),
|
|
285
|
+
snapToGround: 0.3,
|
|
286
|
+
});
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
get grounded(): boolean {
|
|
290
|
+
return GROUND.has(this.action);
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
/** The height of the last surface the hero stood on, at its feet. */
|
|
294
|
+
get groundY(): number {
|
|
295
|
+
return this.#groundY;
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
get speed(): number {
|
|
299
|
+
return this.grounded ? Math.abs(this.#speed) : Math.hypot(this.#air.x, this.#air.z);
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
/** Puts the hero at `position` facing `yaw`, standing still. */
|
|
303
|
+
teleport(position: Vector3, yaw: number): void {
|
|
304
|
+
this.body.teleport(position);
|
|
305
|
+
this.mesh.quaternion.identity();
|
|
306
|
+
this.yaw = yaw;
|
|
307
|
+
this.#speed = 0;
|
|
308
|
+
this.#air.set(0, 0, 0);
|
|
309
|
+
this.#groundY = position.y - FOOT_OFFSET;
|
|
310
|
+
this.#enter("fall");
|
|
311
|
+
}
|
|
312
|
+
|
|
313
|
+
/** A stomp's rebound: a fresh single-jump rise with no chain. */
|
|
314
|
+
bounce(): void {
|
|
315
|
+
this.#launch("single", HERO_FEEL.jumpSpeed, this.speed);
|
|
316
|
+
this.#cut = true;
|
|
317
|
+
}
|
|
318
|
+
|
|
319
|
+
/** A walker hit: knocked back off `from`, and briefly unhittable. */
|
|
320
|
+
knockBack(from: Vector3): void {
|
|
321
|
+
const away = this.#scratch.subVectors(this.mesh.position, from).setY(0);
|
|
322
|
+
if (away.lengthSq() < 1e-6) forwardOf(this.yaw, away).negate();
|
|
323
|
+
away.normalize().multiplyScalar(6);
|
|
324
|
+
this.#launch("fall", 7, 0);
|
|
325
|
+
this.#air.set(away.x, 0, away.z);
|
|
326
|
+
this.hurtTimer = 1.5;
|
|
327
|
+
}
|
|
328
|
+
|
|
329
|
+
update(ctx: GameCtx, dt: number, cameraYaw: number, touch?: ITouchInput): void {
|
|
330
|
+
const input = ctx.input;
|
|
331
|
+
const move = input.vector("move");
|
|
332
|
+
let stickX = move.x;
|
|
333
|
+
let stickY = move.y;
|
|
334
|
+
if (touch !== undefined) {
|
|
335
|
+
stickX += touch.move.x;
|
|
336
|
+
stickY += touch.move.y;
|
|
337
|
+
}
|
|
338
|
+
// Camera-relative: up on the stick is the direction the camera looks along the ground.
|
|
339
|
+
const forward = forwardOf(cameraYaw, this.#scratch);
|
|
340
|
+
this.#intended.set(
|
|
341
|
+
forward.x * stickY - forward.z * stickX,
|
|
342
|
+
0,
|
|
343
|
+
forward.z * stickY + forward.x * stickX,
|
|
344
|
+
);
|
|
345
|
+
const magnitude = Math.min(1, this.#intended.length());
|
|
346
|
+
if (magnitude > 0.05) this.#stickYaw = Math.atan2(-this.#intended.x, -this.#intended.z);
|
|
347
|
+
const jumpPressed = input.justPressed("jump") || touch?.jumpPressed === true;
|
|
348
|
+
this.#jumpBuffer = jumpPressed ? HERO_FEEL.jumpBuffer : Math.max(0, this.#jumpBuffer - dt);
|
|
349
|
+
const jumpHeld = input.pressed("jump") || touch?.jumpHeld === true;
|
|
350
|
+
const crouchPressed = input.justPressed("crouch") || touch?.crouchPressed === true;
|
|
351
|
+
const crouchHeld = input.pressed("crouch") || touch?.crouchHeld === true;
|
|
352
|
+
const attackPressed = input.justPressed("attack") || touch?.attackPressed === true;
|
|
353
|
+
|
|
354
|
+
this.#actionTime += dt;
|
|
355
|
+
this.#chainTimer = Math.max(0, this.#chainTimer - dt);
|
|
356
|
+
this.#wallTimer = Math.max(0, this.#wallTimer - dt);
|
|
357
|
+
this.hurtTimer = Math.max(0, this.hurtTimer - dt);
|
|
358
|
+
const grounded = this.body.grounded;
|
|
359
|
+
const was = this.action;
|
|
360
|
+
this.#airTime = GROUND.has(was) ? 0 : this.#airTime + dt;
|
|
361
|
+
|
|
362
|
+
if (this.action === "ledgeHang" || this.action === "ledgeClimb") {
|
|
363
|
+
this.#ledgeStep(magnitude, jumpPressed, crouchPressed);
|
|
364
|
+
} else if (GROUND.has(this.action)) {
|
|
365
|
+
if (!grounded) this.#leaveGround();
|
|
366
|
+
else {
|
|
367
|
+
// A press buffered in the air fires on the first grounded step.
|
|
368
|
+
const jump = jumpPressed || this.#jumpBuffer > 0;
|
|
369
|
+
this.#groundStep(dt, magnitude, jump, crouchPressed, crouchHeld, attackPressed);
|
|
370
|
+
}
|
|
371
|
+
} else {
|
|
372
|
+
if (grounded && this.body.velocity.y <= 0) {
|
|
373
|
+
if (DEV && this.#pressedAt >= 0)
|
|
374
|
+
console.info(
|
|
375
|
+
`TN_HERO_INPUT land airborne=${this.#airTime.toFixed(2)} sincePress=${(this.#airTime - this.#pressedAt).toFixed(2)}`,
|
|
376
|
+
);
|
|
377
|
+
this.#land();
|
|
378
|
+
} else this.#airStep(dt, magnitude, jumpPressed, jumpHeld, crouchPressed, attackPressed);
|
|
379
|
+
}
|
|
380
|
+
if (jumpPressed) {
|
|
381
|
+
this.#pressedAt = GROUND.has(was) ? -1 : this.#airTime;
|
|
382
|
+
if (DEV)
|
|
383
|
+
console.info(
|
|
384
|
+
`TN_HERO_INPUT press airborne=${this.#airTime.toFixed(2)} from=${was} to=${this.action} buffered=${this.#jumpBuffer > 0}`,
|
|
385
|
+
);
|
|
386
|
+
}
|
|
387
|
+
|
|
388
|
+
if (GROUND.has(this.action)) {
|
|
389
|
+
forwardOf(this.yaw, this.#scratch);
|
|
390
|
+
this.body.velocity.x = this.#scratch.x * this.#speed;
|
|
391
|
+
this.body.velocity.z = this.#scratch.z * this.#speed;
|
|
392
|
+
this.#groundY = this.mesh.position.y - FOOT_OFFSET;
|
|
393
|
+
} else if (this.action !== "ledgeHang" && this.action !== "ledgeClimb") {
|
|
394
|
+
this.body.velocity.x = this.#air.x;
|
|
395
|
+
this.body.velocity.z = this.#air.z;
|
|
396
|
+
this.#peak = Math.max(this.#peak, this.mesh.position.y);
|
|
397
|
+
}
|
|
398
|
+
this.body.moveAndSlide(dt);
|
|
399
|
+
this.rig.group.rotation.y = MathUtils.damp(
|
|
400
|
+
this.rig.group.rotation.y,
|
|
401
|
+
this.rig.group.rotation.y + angleTo(this.rig.group.rotation.y, this.yaw),
|
|
402
|
+
20,
|
|
403
|
+
dt,
|
|
404
|
+
);
|
|
405
|
+
this.#animate(dt);
|
|
406
|
+
this.rig.update({
|
|
407
|
+
action: this.action,
|
|
408
|
+
actionTime: this.#actionTime,
|
|
409
|
+
drop: this.grounded ? 0 : Math.max(0, this.mesh.position.y - FOOT_OFFSET - this.#groundY),
|
|
410
|
+
dt,
|
|
411
|
+
speed: this.speed,
|
|
412
|
+
vy: this.body.velocity.y,
|
|
413
|
+
});
|
|
414
|
+
this.#measureSkate(dt);
|
|
415
|
+
}
|
|
416
|
+
|
|
417
|
+
/**
|
|
418
|
+
* A sole within 10 cm of the feet line is planted; the ground it covers over consecutive planted
|
|
419
|
+
* frames is how far it slid. Zero means the run cycle matches the ground the body covers.
|
|
420
|
+
*/
|
|
421
|
+
#measureSkate(dt: number): void {
|
|
422
|
+
const feet = this.mesh.position.y - FOOT_OFFSET;
|
|
423
|
+
let planted = -1;
|
|
424
|
+
this.rig.soles.forEach((sole, i) => {
|
|
425
|
+
if (planted < 0 && sole.getWorldPosition(_to).y - feet < 0.1) planted = i;
|
|
426
|
+
});
|
|
427
|
+
if (this.action !== "run" || this.#speed < 5.5 || planted < 0 || dt <= 0) {
|
|
428
|
+
this.#planted = -1;
|
|
429
|
+
return;
|
|
430
|
+
}
|
|
431
|
+
if (planted === this.#planted) {
|
|
432
|
+
this.#slid += Math.hypot(_to.x - this.#sole.x, _to.z - this.#sole.z);
|
|
433
|
+
this.#plantedTime += dt;
|
|
434
|
+
}
|
|
435
|
+
this.#planted = planted;
|
|
436
|
+
this.#sole.copy(_to);
|
|
437
|
+
}
|
|
438
|
+
|
|
439
|
+
/** The chain jump a press would fire now: 1 a double, 2 a triple, 0 none. */
|
|
440
|
+
get chain(): number {
|
|
441
|
+
return this.#chainTimer > 0 ? this.#chainStage : 0;
|
|
442
|
+
}
|
|
443
|
+
|
|
444
|
+
debug(): Record<string, unknown> {
|
|
445
|
+
return {
|
|
446
|
+
action: this.action,
|
|
447
|
+
chain: this.chain,
|
|
448
|
+
apex: { ...this.#apex },
|
|
449
|
+
counts: { ...this.#counts },
|
|
450
|
+
distance: { ...this.#distance },
|
|
451
|
+
groundY: this.#groundY,
|
|
452
|
+
grounded: this.grounded,
|
|
453
|
+
landings: this.landings,
|
|
454
|
+
ledgeGrabs: this.#ledgeGrabs,
|
|
455
|
+
pounds: this.#pounds,
|
|
456
|
+
position: this.mesh.position.toArray(),
|
|
457
|
+
sideflipFacingError: this.#sideflipFacingError,
|
|
458
|
+
speed: this.speed,
|
|
459
|
+
stride: this.#strideReport(),
|
|
460
|
+
takeoffSpeed: { ...this.#takeoffSpeeds },
|
|
461
|
+
velocity: this.body.velocity.toArray(),
|
|
462
|
+
wallHits: this.wallHits,
|
|
463
|
+
wallKickRise: this.#wallKickRise,
|
|
464
|
+
wallKicks: this.#wallKicks,
|
|
465
|
+
yaw: this.yaw,
|
|
466
|
+
};
|
|
467
|
+
}
|
|
468
|
+
|
|
469
|
+
dispose(): void {
|
|
470
|
+
this.#anim.dispose();
|
|
471
|
+
this.body.dispose();
|
|
472
|
+
this.mesh.removeFromParent();
|
|
473
|
+
}
|
|
474
|
+
|
|
475
|
+
/**
|
|
476
|
+
* Standing and running blend idle, walk and run by ground speed; every other action holds the
|
|
477
|
+
* neutral "air" pose that `render/hero.ts` bends procedurally.
|
|
478
|
+
*/
|
|
479
|
+
#animate(dt: number): void {
|
|
480
|
+
if (this.action === "idle" || this.action === "run") {
|
|
481
|
+
const speed = Math.abs(this.#speed);
|
|
482
|
+
const moving = MathUtils.smoothstep(speed, 0.2, 1);
|
|
483
|
+
// A walk plants each foot for half its cycle and a run for 15%, so a blend of the two drags
|
|
484
|
+
// the planted foot: the hand-over is kept short, done by 4 m/s.
|
|
485
|
+
const running = MathUtils.smoothstep(speed, 1.5, 4);
|
|
486
|
+
this.#anim.playWeighted(
|
|
487
|
+
[
|
|
488
|
+
{ clip: "idle", weight: 1 - moving },
|
|
489
|
+
{ clip: "walk", weight: moving * (1 - running) },
|
|
490
|
+
{ clip: "run", weight: moving * running },
|
|
491
|
+
],
|
|
492
|
+
{ transition: 0.15 },
|
|
493
|
+
);
|
|
494
|
+
} else this.#anim.playWeighted([{ clip: "air", weight: 1 }], { transition: 0.08 });
|
|
495
|
+
this.#anim.update(dt);
|
|
496
|
+
}
|
|
497
|
+
|
|
498
|
+
/** The stride report, and the foot speed it implies over the ground speed: 1 is no skating. */
|
|
499
|
+
#strideReport(): Record<string, unknown> {
|
|
500
|
+
const stride = this.#anim.stride;
|
|
501
|
+
const feet = stride.clipGroundSpeed * stride.rate;
|
|
502
|
+
const footRatio = stride.groundSpeed > 0.5 ? feet / stride.groundSpeed : 1;
|
|
503
|
+
return {
|
|
504
|
+
...stride,
|
|
505
|
+
clip: this.#anim.current ?? "none",
|
|
506
|
+
footRatio,
|
|
507
|
+
skate: this.#plantedTime > 0 ? this.#slid / this.#plantedTime : 0,
|
|
508
|
+
plantedTime: this.#plantedTime,
|
|
509
|
+
inBand: Math.abs(footRatio - 1) <= 0.1,
|
|
510
|
+
};
|
|
511
|
+
}
|
|
512
|
+
|
|
513
|
+
#enter(action: HeroAction): void {
|
|
514
|
+
this.action = action;
|
|
515
|
+
this.#actionTime = 0;
|
|
516
|
+
this.body.gravity = -(action === "longJump" ? HERO_FEEL.longJumpGravity : HERO_FEEL.gravity);
|
|
517
|
+
}
|
|
518
|
+
|
|
519
|
+
/**
|
|
520
|
+
* Leaves the ground as `action` with vertical speed `vy` and `forward` m/s along the facing,
|
|
521
|
+
* counted under `count`.
|
|
522
|
+
*/
|
|
523
|
+
#launch(action: HeroAction, vy: number, forward: number, count: string = action): void {
|
|
524
|
+
this.#enter(action);
|
|
525
|
+
forwardOf(this.yaw, this.#air).multiplyScalar(forward);
|
|
526
|
+
this.body.velocity.y = vy;
|
|
527
|
+
this.#cut = false;
|
|
528
|
+
// An air double jump ends the wall kick's flight before any landing records its rise.
|
|
529
|
+
if (this.#airKind === "wallKick") this.#wallKickRise = this.#peak - this.#wallKickFrom;
|
|
530
|
+
this.#airKind = action;
|
|
531
|
+
this.#takeoff.copy(this.mesh.position);
|
|
532
|
+
this.#takeoffYaw = this.yaw;
|
|
533
|
+
this.#takeoffSpeed = this.speed;
|
|
534
|
+
this.#peak = this.mesh.position.y;
|
|
535
|
+
this.#counts[count] = (this.#counts[count] ?? 0) + 1;
|
|
536
|
+
}
|
|
537
|
+
|
|
538
|
+
#groundStep(
|
|
539
|
+
dt: number,
|
|
540
|
+
magnitude: number,
|
|
541
|
+
jumpPressed: boolean,
|
|
542
|
+
crouchPressed: boolean,
|
|
543
|
+
crouchHeld: boolean,
|
|
544
|
+
attackPressed: boolean,
|
|
545
|
+
): void {
|
|
546
|
+
const feel = HERO_FEEL;
|
|
547
|
+
if (this.action === "poundLand") {
|
|
548
|
+
this.#speed = 0;
|
|
549
|
+
if (this.#actionTime >= feel.poundRecover) this.#enter("idle");
|
|
550
|
+
return;
|
|
551
|
+
}
|
|
552
|
+
if (jumpPressed && this.action !== "diveSlide") {
|
|
553
|
+
this.#jumpFromGround(magnitude);
|
|
554
|
+
return;
|
|
555
|
+
}
|
|
556
|
+
if (attackPressed && this.#speed >= feel.diveMinSpeed) {
|
|
557
|
+
this.#launch("dive", feel.diveHop, Math.min(feel.hardCap, this.#speed + feel.diveBoost));
|
|
558
|
+
return;
|
|
559
|
+
}
|
|
560
|
+
switch (this.action) {
|
|
561
|
+
case "diveSlide":
|
|
562
|
+
this.#speed = Math.max(0, this.#speed - feel.diveSlideDecel * dt);
|
|
563
|
+
if (this.#speed === 0) this.#enter("idle");
|
|
564
|
+
return;
|
|
565
|
+
case "crouchSlide":
|
|
566
|
+
this.#speed = Math.max(0, this.#speed - feel.crouchSlideDecel * dt);
|
|
567
|
+
if (this.#speed === 0 || !crouchHeld) this.#enter(crouchHeld ? "crouch" : "idle");
|
|
568
|
+
return;
|
|
569
|
+
case "crouch":
|
|
570
|
+
this.#speed = Math.max(0, this.#speed - feel.stopDecel * dt);
|
|
571
|
+
if (!crouchHeld) this.#enter("idle");
|
|
572
|
+
return;
|
|
573
|
+
case "skid":
|
|
574
|
+
this.#speed = Math.max(0, this.#speed - feel.skidDecel * dt);
|
|
575
|
+
if (this.#speed === 0) {
|
|
576
|
+
this.yaw = this.#stickYaw;
|
|
577
|
+
this.#enter("run");
|
|
578
|
+
}
|
|
579
|
+
return;
|
|
580
|
+
default:
|
|
581
|
+
break;
|
|
582
|
+
}
|
|
583
|
+
if (crouchPressed || crouchHeld) {
|
|
584
|
+
this.#enter(this.#speed >= feel.crouchSlideMinSpeed ? "crouchSlide" : "crouch");
|
|
585
|
+
return;
|
|
586
|
+
}
|
|
587
|
+
if (magnitude > 0.05) {
|
|
588
|
+
const turn = angleTo(this.yaw, this.#stickYaw);
|
|
589
|
+
if (this.#speed < 0.5) this.yaw = this.#stickYaw;
|
|
590
|
+
else if (Math.abs(turn) > feel.skidAngle && this.#speed >= feel.skidMinSpeed) {
|
|
591
|
+
this.#enter("skid");
|
|
592
|
+
return;
|
|
593
|
+
} else this.yaw += MathUtils.clamp(turn, -feel.turnRate * dt, feel.turnRate * dt);
|
|
594
|
+
const target = magnitude * feel.runCap;
|
|
595
|
+
if (this.#speed <= target)
|
|
596
|
+
this.#speed = Math.min(
|
|
597
|
+
target,
|
|
598
|
+
this.#speed + (feel.runAccel - feel.runDrag * this.#speed) * dt,
|
|
599
|
+
);
|
|
600
|
+
else this.#speed = Math.max(target, this.#speed - feel.overspeedDecel * dt);
|
|
601
|
+
if (this.action !== "run") this.#enter("run");
|
|
602
|
+
} else {
|
|
603
|
+
this.#speed = Math.max(0, this.#speed - feel.stopDecel * dt);
|
|
604
|
+
if (this.#speed === 0 && this.action !== "idle") this.#enter("idle");
|
|
605
|
+
}
|
|
606
|
+
}
|
|
607
|
+
|
|
608
|
+
#jumpFromGround(magnitude: number): void {
|
|
609
|
+
const feel = HERO_FEEL;
|
|
610
|
+
const speed = this.#speed;
|
|
611
|
+
if (this.action === "skid") {
|
|
612
|
+
this.yaw = this.#stickYaw;
|
|
613
|
+
this.#launch("sideflip", feel.sideflipSpeed, feel.sideflipForward);
|
|
614
|
+
return;
|
|
615
|
+
}
|
|
616
|
+
if (this.action === "crouchSlide") {
|
|
617
|
+
if (this.#actionTime <= feel.longJumpWindow && speed >= feel.crouchSlideMinSpeed) {
|
|
618
|
+
this.#launch(
|
|
619
|
+
"longJump",
|
|
620
|
+
feel.longJumpSpeed,
|
|
621
|
+
Math.min(feel.hardCap, speed * feel.longJumpScale),
|
|
622
|
+
);
|
|
623
|
+
return;
|
|
624
|
+
}
|
|
625
|
+
} else if (this.action === "crouch") {
|
|
626
|
+
this.#launch("backflip", feel.backflipSpeed, -feel.backflipBack);
|
|
627
|
+
return;
|
|
628
|
+
}
|
|
629
|
+
if (magnitude > 0.05 && speed < 0.5) this.yaw = this.#stickYaw;
|
|
630
|
+
const chained = this.#chainTimer > 0;
|
|
631
|
+
const lift = feel.jumpForwardLift * speed;
|
|
632
|
+
const forward = speed * feel.jumpForwardKeep;
|
|
633
|
+
if (chained && this.#chainStage === 2 && speed > feel.tripleMinSpeed)
|
|
634
|
+
this.#launch("triple", feel.tripleJumpSpeed, forward);
|
|
635
|
+
else if (chained && this.#chainStage === 1)
|
|
636
|
+
this.#launch("double", feel.doubleJumpSpeed + lift, forward);
|
|
637
|
+
else this.#launch("single", feel.jumpSpeed + lift, forward);
|
|
638
|
+
this.#chainTimer = 0;
|
|
639
|
+
this.#jumpBuffer = 0;
|
|
640
|
+
}
|
|
641
|
+
|
|
642
|
+
#leaveGround(): void {
|
|
643
|
+
// Walked off an edge: a fall that keeps the ground speed as air speed.
|
|
644
|
+
forwardOf(this.yaw, this.#air).multiplyScalar(this.#speed);
|
|
645
|
+
this.#enter("fall");
|
|
646
|
+
this.#airKind = "fall";
|
|
647
|
+
this.#peak = this.mesh.position.y;
|
|
648
|
+
}
|
|
649
|
+
|
|
650
|
+
#airStep(
|
|
651
|
+
dt: number,
|
|
652
|
+
magnitude: number,
|
|
653
|
+
jumpPressed: boolean,
|
|
654
|
+
jumpHeld: boolean,
|
|
655
|
+
crouchPressed: boolean,
|
|
656
|
+
attackPressed: boolean,
|
|
657
|
+
): void {
|
|
658
|
+
const feel = HERO_FEEL;
|
|
659
|
+
const vy = this.body.velocity.y;
|
|
660
|
+
if (VARIABLE.has(this.action) && !this.#cut && !jumpHeld && vy > feel.jumpCutSpeed) {
|
|
661
|
+
this.body.velocity.y = vy * feel.jumpCutFactor;
|
|
662
|
+
this.#cut = true;
|
|
663
|
+
}
|
|
664
|
+
if (this.action === "groundPound") {
|
|
665
|
+
this.#air.set(0, 0, 0);
|
|
666
|
+
this.body.gravity = 0;
|
|
667
|
+
this.body.velocity.y = this.#actionTime < feel.poundHang ? 0 : -feel.poundSpeed;
|
|
668
|
+
return;
|
|
669
|
+
}
|
|
670
|
+
// A press at the wall is a kick, always: one made just before the contact waits in the buffer
|
|
671
|
+
// for the window, and the air double yields to it while a wall is in reach.
|
|
672
|
+
if ((jumpPressed || this.#jumpBuffer > 0) && this.#wallTimer > 0) {
|
|
673
|
+
this.#jumpBuffer = 0;
|
|
674
|
+
this.#wallKick();
|
|
675
|
+
return;
|
|
676
|
+
}
|
|
677
|
+
if (
|
|
678
|
+
jumpPressed &&
|
|
679
|
+
this.#airJumpReady &&
|
|
680
|
+
AIR_JUMP.has(this.action) &&
|
|
681
|
+
this.#actionTime >= feel.airJumpGuard &&
|
|
682
|
+
!this.#landingSoon() &&
|
|
683
|
+
!this.#wallAhead()
|
|
684
|
+
) {
|
|
685
|
+
// The air double keeps the air speed: `#launch` would aim it along the facing.
|
|
686
|
+
const { x, z } = this.#air;
|
|
687
|
+
this.#launch("double", feel.jumpSpeed, 0, "airDouble");
|
|
688
|
+
this.#air.set(x, 0, z);
|
|
689
|
+
this.#airJumpReady = false;
|
|
690
|
+
this.#jumpBuffer = 0;
|
|
691
|
+
return;
|
|
692
|
+
}
|
|
693
|
+
if (crouchPressed && this.action !== "dive") {
|
|
694
|
+
this.#enter("groundPound");
|
|
695
|
+
this.#airKind = "groundPound";
|
|
696
|
+
this.#air.set(0, 0, 0);
|
|
697
|
+
return;
|
|
698
|
+
}
|
|
699
|
+
if (attackPressed && this.action !== "dive" && this.speed >= feel.diveMinSpeed * 0.5) {
|
|
700
|
+
const speed = Math.min(feel.hardCap, this.speed + feel.diveBoost);
|
|
701
|
+
this.#enter("dive");
|
|
702
|
+
this.#airKind = "dive";
|
|
703
|
+
this.#counts.dive = (this.#counts.dive ?? 0) + 1;
|
|
704
|
+
forwardOf(this.yaw, this.#air).multiplyScalar(speed);
|
|
705
|
+
return;
|
|
706
|
+
}
|
|
707
|
+
// Air steering: the stick nudges the horizontal velocity, never past the run cap.
|
|
708
|
+
if (magnitude > 0.05 && this.#wallTimer === 0) {
|
|
709
|
+
const before = Math.hypot(this.#air.x, this.#air.z);
|
|
710
|
+
this.#air.addScaledVector(this.#intended, (feel.airAccel * dt) / Math.max(1, magnitude));
|
|
711
|
+
const after = Math.hypot(this.#air.x, this.#air.z);
|
|
712
|
+
const cap = Math.max(before, feel.runCap);
|
|
713
|
+
if (after > cap) this.#air.multiplyScalar(cap / after);
|
|
714
|
+
}
|
|
715
|
+
if (WALL_AIR.has(this.action)) this.#probeWall();
|
|
716
|
+
}
|
|
717
|
+
|
|
718
|
+
/**
|
|
719
|
+
* Falling onto ground within the drop the jump buffer covers: a press now lands as the chain's
|
|
720
|
+
* buffered jump, not as the air double jump.
|
|
721
|
+
*/
|
|
722
|
+
#landingSoon(): boolean {
|
|
723
|
+
const vy = this.body.velocity.y;
|
|
724
|
+
if (vy >= 0) return false;
|
|
725
|
+
const t = HERO_FEEL.jumpBuffer;
|
|
726
|
+
const drop = -vy * t + 0.5 * HERO_FEEL.gravity * t * t;
|
|
727
|
+
const feet = this.mesh.position.y - FOOT_OFFSET;
|
|
728
|
+
_from.set(this.mesh.position.x, feet + 0.05, this.mesh.position.z);
|
|
729
|
+
_to.set(_from.x, feet - drop, _from.z);
|
|
730
|
+
const ground = this.#ray(_from, _to);
|
|
731
|
+
return ground !== undefined && ground.normal.y > 0.7;
|
|
732
|
+
}
|
|
733
|
+
|
|
734
|
+
/**
|
|
735
|
+
* A wall the hero will bonk within the jump buffer: met at the upper check inside the distance
|
|
736
|
+
* the buffer covers, fast enough into it to open the kick window.
|
|
737
|
+
*/
|
|
738
|
+
#wallAhead(): boolean {
|
|
739
|
+
const reach = Math.hypot(this.#air.x, this.#air.z) * HERO_FEEL.jumpBuffer;
|
|
740
|
+
if (!this.#wallAt(1.5, _upper, CAPSULE.radius + 0.2 + reach)) return false;
|
|
741
|
+
return -(this.#air.x * _upper.nx + this.#air.z * _upper.nz) >= HERO_FEEL.wallBonkSpeed;
|
|
742
|
+
}
|
|
743
|
+
|
|
744
|
+
/**
|
|
745
|
+
* The nearest wall `height` above the feet, on a fan of three rays (the travel and 45° either
|
|
746
|
+
* side), into `out`. The fan stands in for the reference's round wall check, so a wall met at an
|
|
747
|
+
* angle is found too; one ray along the travel missed it.
|
|
748
|
+
*/
|
|
749
|
+
#wallAt(height: number, out: IWallProbe, reach = CAPSULE.radius + 0.2): boolean {
|
|
750
|
+
const speed = Math.hypot(this.#air.x, this.#air.z);
|
|
751
|
+
const direction = this.#scratch;
|
|
752
|
+
if (speed > 0.3) direction.set(this.#air.x / speed, 0, this.#air.z / speed);
|
|
753
|
+
else forwardOf(this.yaw, direction);
|
|
754
|
+
const centre = this.mesh.position;
|
|
755
|
+
let best = Number.POSITIVE_INFINITY;
|
|
756
|
+
out.found = false;
|
|
757
|
+
for (const turn of WALL_FAN) {
|
|
758
|
+
const c = Math.cos(turn);
|
|
759
|
+
const s = Math.sin(turn);
|
|
760
|
+
_from.set(centre.x, centre.y - FOOT_OFFSET + height, centre.z);
|
|
761
|
+
_to.set(direction.x * c - direction.z * s, 0, direction.x * s + direction.z * c);
|
|
762
|
+
_to.multiplyScalar(reach).add(_from);
|
|
763
|
+
const hit = this.#ray(_from, _to);
|
|
764
|
+
if (hit === undefined || Math.abs(hit.normal.y) > 0.3) continue;
|
|
765
|
+
const distance = hit.position.distanceToSquared(_from);
|
|
766
|
+
if (distance >= best) continue;
|
|
767
|
+
best = distance;
|
|
768
|
+
const n = Math.hypot(hit.normal.x, hit.normal.z);
|
|
769
|
+
Object.assign(out, {
|
|
770
|
+
found: true,
|
|
771
|
+
nx: hit.normal.x / n,
|
|
772
|
+
nz: hit.normal.z / n,
|
|
773
|
+
x: hit.position.x,
|
|
774
|
+
y: hit.position.y,
|
|
775
|
+
z: hit.position.z,
|
|
776
|
+
});
|
|
777
|
+
}
|
|
778
|
+
return out.found;
|
|
779
|
+
}
|
|
780
|
+
|
|
781
|
+
/**
|
|
782
|
+
* The reference's two wall checks, 0.3 m and 1.5 m above the feet (sm64 mario_step.c:401-402).
|
|
783
|
+
* A wall at the low one only is a ledge's face: it never bonks (mario_step.c:471-480), and
|
|
784
|
+
* falling into it the hero grabs a floor 1.0-1.6 m above the feet (mario_step.c:348-374).
|
|
785
|
+
*/
|
|
786
|
+
#probeWall(): void {
|
|
787
|
+
const feel = HERO_FEEL;
|
|
788
|
+
const lower = this.#wallAt(0.3, _lower);
|
|
789
|
+
const upper = this.#wallAt(1.5, _upper);
|
|
790
|
+
if (lower && !upper) {
|
|
791
|
+
// Falling, and moving or pushing into the wall: the reference grabs only when the wall
|
|
792
|
+
// stopped it (mario_step.c:354-365).
|
|
793
|
+
const into =
|
|
794
|
+
-(this.#air.x * _lower.nx + this.#air.z * _lower.nz) -
|
|
795
|
+
(this.#intended.x * _lower.nx + this.#intended.z * _lower.nz);
|
|
796
|
+
if (this.body.velocity.y > 0 || into <= 0.1) return;
|
|
797
|
+
const feet = this.mesh.position.y - FOOT_OFFSET;
|
|
798
|
+
_from.set(
|
|
799
|
+
_lower.x - _lower.nx * feel.ledgeAhead,
|
|
800
|
+
feet + feel.ledgeTop,
|
|
801
|
+
_lower.z - _lower.nz * feel.ledgeAhead,
|
|
802
|
+
);
|
|
803
|
+
_to.set(_from.x, feet + feel.ledgeBottom, _from.z);
|
|
804
|
+
const ledge = this.#ray(_from, _to);
|
|
805
|
+
if (ledge !== undefined && ledge.normal.y > 0.7)
|
|
806
|
+
this.#grabLedge(_lower, _lower.nx, _lower.nz, ledge.position);
|
|
807
|
+
return;
|
|
808
|
+
}
|
|
809
|
+
if (!upper) return;
|
|
810
|
+
const wallX = _upper.nx;
|
|
811
|
+
const wallZ = _upper.nz;
|
|
812
|
+
// Only the speed into the wall counts: a glancing contact slides along it. `#air` is this
|
|
813
|
+
// file's own vector, so the part pushing into the wall is removed here, or the stick would
|
|
814
|
+
// keep adding to it while the body stands still against the wall.
|
|
815
|
+
const into = -(this.#air.x * wallX + this.#air.z * wallZ);
|
|
816
|
+
if (into < feel.wallBonkSpeed || this.#wallTimer > 0) {
|
|
817
|
+
if (into > 0) this.#air.addScaledVector(_from.set(wallX, 0, wallZ), into);
|
|
818
|
+
return;
|
|
819
|
+
}
|
|
820
|
+
// A fast hit: bounce off a little, and open the wall-kick window.
|
|
821
|
+
this.wallHits += 1;
|
|
822
|
+
this.#wallTimer = feel.wallKickWindow;
|
|
823
|
+
this.#wall.nx = wallX;
|
|
824
|
+
this.#wall.nz = wallZ;
|
|
825
|
+
this.#air.set(wallX * 1.2, 0, wallZ * 1.2);
|
|
826
|
+
if (this.body.velocity.y > 0) this.body.velocity.y = 0;
|
|
827
|
+
this.#enter("fall");
|
|
828
|
+
}
|
|
829
|
+
|
|
830
|
+
#wallKick(): void {
|
|
831
|
+
const feel = HERO_FEEL;
|
|
832
|
+
// Face away from the wall: the facing becomes the wall's normal.
|
|
833
|
+
this.yaw = Math.atan2(-this.#wall.nx, -this.#wall.nz);
|
|
834
|
+
this.#wallTimer = 0;
|
|
835
|
+
this.#airJumpReady = true;
|
|
836
|
+
this.#wallKicks += 1;
|
|
837
|
+
this.#wallKickFrom = this.mesh.position.y;
|
|
838
|
+
this.#launch("wallKick", feel.wallKickSpeed, feel.wallKickForward);
|
|
839
|
+
}
|
|
840
|
+
|
|
841
|
+
#grabLedge(wall: { x: number; z: number }, nx: number, nz: number, top: Vector3): void {
|
|
842
|
+
this.#enter("ledgeHang");
|
|
843
|
+
this.#ledgeGrabs += 1;
|
|
844
|
+
this.#airJumpReady = true;
|
|
845
|
+
this.#ledge.copy(top);
|
|
846
|
+
this.yaw = Math.atan2(nx, nz);
|
|
847
|
+
this.#air.set(0, 0, 0);
|
|
848
|
+
this.body.gravity = 0;
|
|
849
|
+
this.body.velocity.set(0, 0, 0);
|
|
850
|
+
this.body.teleport(
|
|
851
|
+
_to.set(
|
|
852
|
+
wall.x + nx * (CAPSULE.radius + 0.02),
|
|
853
|
+
top.y - 1.3 + FOOT_OFFSET,
|
|
854
|
+
wall.z + nz * (CAPSULE.radius + 0.02),
|
|
855
|
+
),
|
|
856
|
+
);
|
|
857
|
+
}
|
|
858
|
+
|
|
859
|
+
#ledgeStep(magnitude: number, jumpPressed: boolean, crouchPressed: boolean): void {
|
|
860
|
+
const feel = HERO_FEEL;
|
|
861
|
+
this.body.velocity.set(0, 0, 0);
|
|
862
|
+
if (this.action === "ledgeClimb") {
|
|
863
|
+
if (this.#actionTime < feel.ledgeClimbTime) return;
|
|
864
|
+
// Stand on the ledge, one step past its lip.
|
|
865
|
+
this.body.teleport(_to.set(this.#ledge.x, this.#ledge.y + FOOT_OFFSET + 0.05, this.#ledge.z));
|
|
866
|
+
this.#speed = 0;
|
|
867
|
+
this.#groundY = this.#ledge.y;
|
|
868
|
+
this.#enter("idle");
|
|
869
|
+
this.landings += 1;
|
|
870
|
+
return;
|
|
871
|
+
}
|
|
872
|
+
if (crouchPressed) {
|
|
873
|
+
this.#enter("fall");
|
|
874
|
+
this.#airKind = "fall";
|
|
875
|
+
return;
|
|
876
|
+
}
|
|
877
|
+
if (this.#actionTime < feel.ledgeHangMin) return;
|
|
878
|
+
const towardWall = Math.abs(angleTo(this.yaw, this.#stickYaw)) < Math.PI / 2;
|
|
879
|
+
if (jumpPressed || (magnitude > 0.5 && towardWall)) this.#enter("ledgeClimb");
|
|
880
|
+
}
|
|
881
|
+
|
|
882
|
+
#land(): void {
|
|
883
|
+
const feel = HERO_FEEL;
|
|
884
|
+
const kind = this.#airKind;
|
|
885
|
+
this.landings += 1;
|
|
886
|
+
this.#airJumpReady = true;
|
|
887
|
+
this.#pressedAt = -1;
|
|
888
|
+
if (MEASURED.includes(kind)) {
|
|
889
|
+
this.#apex[kind] = this.#peak - this.#takeoff.y;
|
|
890
|
+
const travelled = this.#scratch.subVectors(this.mesh.position, this.#takeoff).setY(0);
|
|
891
|
+
forwardOf(this.#takeoffYaw, _from);
|
|
892
|
+
this.#distance[kind] = travelled.dot(_from);
|
|
893
|
+
this.#takeoffSpeeds[kind] = this.#takeoffSpeed;
|
|
894
|
+
if (kind === "sideflip")
|
|
895
|
+
this.#sideflipFacingError = Math.abs(angleTo(this.yaw, this.#stickYaw));
|
|
896
|
+
if (kind === "wallKick") this.#wallKickRise = this.#peak - this.#wallKickFrom;
|
|
897
|
+
}
|
|
898
|
+
forwardOf(this.yaw, _from);
|
|
899
|
+
this.#speed = Math.max(0, this.#air.x * _from.x + this.#air.z * _from.z);
|
|
900
|
+
this.#chainStage =
|
|
901
|
+
kind === "single" || kind === "fall" || kind === "sideflip" ? 1 : kind === "double" ? 2 : 0;
|
|
902
|
+
this.#chainTimer = this.#chainStage > 0 ? feel.chainWindow : 0;
|
|
903
|
+
this.#air.set(0, 0, 0);
|
|
904
|
+
if (kind === "groundPound") {
|
|
905
|
+
this.#pounds += 1;
|
|
906
|
+
this.#speed = 0;
|
|
907
|
+
this.#enter("poundLand");
|
|
908
|
+
} else if (kind === "dive") this.#enter("diveSlide");
|
|
909
|
+
else if (kind === "backflip") {
|
|
910
|
+
this.#speed = 0;
|
|
911
|
+
this.#enter("idle");
|
|
912
|
+
} else this.#enter(this.#speed > 0 ? "run" : "idle");
|
|
913
|
+
this.#airKind = "fall";
|
|
914
|
+
}
|
|
915
|
+
}
|