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,517 @@
|
|
|
1
|
+
import { type ICourse, SURFACE_DRAG, type Surface } from "../track/Course.js";
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* The kart's feel: every number the reference decides, in metres, seconds and its own 60 Hz ticks.
|
|
5
|
+
* MK64 has no metre, so the kit keeps its ratios and times and sets one scale, `topSpeed`; every
|
|
6
|
+
* other speed is a ratio of it. Change a value here and the whole field changes with it, the CPUs
|
|
7
|
+
* included, because they drive this same model.
|
|
8
|
+
*/
|
|
9
|
+
export const KART_FEEL = {
|
|
10
|
+
/** Terminal road speed at full throttle in each class, m/s. Terminal speed is ∝ throttle², and
|
|
11
|
+
* the throttle tops out at 290 / 310 / 320 (`mk64: src/data/kart_attributes.c:65-75`). */
|
|
12
|
+
topSpeed: { "50cc": 24 * (290 / 320) ** 2, "100cc": 24 * (310 / 320) ** 2, "150cc": 24 },
|
|
13
|
+
/** The throttle's top in each class; the throttle is the pedal, not the speed. */
|
|
14
|
+
throttleTop: { "50cc": 290, "100cc": 310, "150cc": 320 },
|
|
15
|
+
/** Throttle gained per tick in each tenth of its top (medium weight, `kart_attributes.c:248`). */
|
|
16
|
+
accel: [2.0, 2.0, 2.0, 1.6, 1.4, 1.2, 1.0, 0.8, 0.6, 0.4],
|
|
17
|
+
/** Throttle lost per tick off the pedal, and braking (`player_controller.c:4688`, `:3563`). */
|
|
18
|
+
coast: 1,
|
|
19
|
+
brake: 3,
|
|
20
|
+
/** Speed follows its target with this lag, in ticks: 6000 / (0.12 · 5800) (`player_controller.c:2413`). */
|
|
21
|
+
lagTicks: 8.62,
|
|
22
|
+
/** Reverse speed with the brake held from a stop, m/s. Kit value. */
|
|
23
|
+
reverse: 4,
|
|
24
|
+
/** Yaw at full lock: `K·s·|s| / (8 + throttle/50)` deg/s, so 94 °/s at the 150cc top
|
|
25
|
+
* (`player_controller.c:4137-4173`), ×1.12 past 85% lock (handling +0.15 on 1.25). */
|
|
26
|
+
steerK: 94 * (8 + 320 / 50),
|
|
27
|
+
steerHardLock: 0.85,
|
|
28
|
+
steerHardGain: 1.12,
|
|
29
|
+
/** Below this speed the steering fades out, so a parked kart does not spin on the spot. Kit guard. */
|
|
30
|
+
steerFadeSpeed: 3,
|
|
31
|
+
/** The velocity's heading follows the kart's at 1/12 per tick, at most 40° behind (`:1300`, `:1348`). */
|
|
32
|
+
slipFollow: 1 / 12,
|
|
33
|
+
slipMax: (40 * Math.PI) / 180,
|
|
34
|
+
/** Drag per degree of slip, drifting and turning (`player_controller.c:2990-3106`), and how fast
|
|
35
|
+
* any drag eases in (5% per tick). */
|
|
36
|
+
driftDrag: 0.004,
|
|
37
|
+
turnDrag: 0.01,
|
|
38
|
+
dragEase: 0.05,
|
|
39
|
+
/** The hop: up 0.35 m in 8 ticks (`kart_attributes.c:401`, `player_controller.c:1192-1241`). */
|
|
40
|
+
hopSpeed: 5.4,
|
|
41
|
+
hopGravity: 41.5,
|
|
42
|
+
/** Gravity off a ramp, m/s². Kit value: an arcade arc, not 9.8. */
|
|
43
|
+
gravity: 30,
|
|
44
|
+
/** A drift starts only above 28% of top speed (20 of 70.7 display km/h, `player_controller.c:4327`). */
|
|
45
|
+
driftMinFraction: 0.28,
|
|
46
|
+
/** Drift yaw, deg/s: stick neutral, extra at full inside, less at full outside (`:4197-4228`). */
|
|
47
|
+
driftYaw: 36,
|
|
48
|
+
driftYawInside: 54,
|
|
49
|
+
driftYawOutside: 21,
|
|
50
|
+
/** Stick past 10/53 against the drift charges the mini-turbo (`player_controller.c:1145-1190`). */
|
|
51
|
+
chargeStick: 10 / 53,
|
|
52
|
+
/** Ticks held against the drift for one stage, the counter kept after a stage, and the stall. */
|
|
53
|
+
chargeTicks: 18,
|
|
54
|
+
chargeKeep: 10,
|
|
55
|
+
chargeStall: 100,
|
|
56
|
+
/** The mini-turbo: 31 ticks at +580/4096 force, eased in at 20% a tick and bled at 1% a tick
|
|
57
|
+
* (`player_controller.c:1123-1140`, `:3094`). */
|
|
58
|
+
miniTurboTicks: 31,
|
|
59
|
+
miniTurbo: 580 / 4096,
|
|
60
|
+
/** The nitro can and the boost pad: 80 ticks at +400/4096, eased in at 50% a tick, then −10% a
|
|
61
|
+
* tick (`effects.c:547`, `player_controller.c:1120`, `:3117`). */
|
|
62
|
+
boostTicks: 80,
|
|
63
|
+
boost: 400 / 4096,
|
|
64
|
+
/** A CPU behind the leader's pace gets +380/4096 force (`player_controller.c:3085`). */
|
|
65
|
+
catchUp: 380 / 4096,
|
|
66
|
+
/** A wall: speed into it reflected ×0.5, throttle −18 a contact tick (`player_controller.c:1952`). */
|
|
67
|
+
wallBounce: 0.5,
|
|
68
|
+
wallThrottle: 18,
|
|
69
|
+
/** Half the kart's width, for the wall line. */
|
|
70
|
+
halfWidth: 0.85,
|
|
71
|
+
/** A burr spin and an acorn tumble, in ticks (`effects.c:375-394`, `:197-224`). */
|
|
72
|
+
spinTicks: 90,
|
|
73
|
+
tumbleTicks: 103,
|
|
74
|
+
} as const;
|
|
75
|
+
|
|
76
|
+
export type EngineClass = keyof typeof KART_FEEL.topSpeed;
|
|
77
|
+
|
|
78
|
+
/** What a kart is told each tick: the player's keys or a CPU's `Driver`. */
|
|
79
|
+
export interface IKartInput {
|
|
80
|
+
throttle: boolean;
|
|
81
|
+
brake: boolean;
|
|
82
|
+
/** −1 full left … +1 full right. */
|
|
83
|
+
steer: number;
|
|
84
|
+
/** The hop and drift button, held. */
|
|
85
|
+
drift: boolean;
|
|
86
|
+
/** Pressed this tick: use the held item. */
|
|
87
|
+
item: boolean;
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
export const idleInput = (): IKartInput => ({
|
|
91
|
+
brake: false,
|
|
92
|
+
drift: false,
|
|
93
|
+
item: false,
|
|
94
|
+
steer: 0,
|
|
95
|
+
throttle: false,
|
|
96
|
+
});
|
|
97
|
+
|
|
98
|
+
const DEG = Math.PI / 180;
|
|
99
|
+
|
|
100
|
+
function wrapAngle(angle: number): number {
|
|
101
|
+
return Math.atan2(Math.sin(angle), Math.cos(angle));
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
/**
|
|
105
|
+
* One kart: the throttle, the speed that chases it, the heading and the slip, the hop and the
|
|
106
|
+
* power-slide, the boosts and the hits. Position is world x/z plus a place on the course
|
|
107
|
+
* (`index`, `lateral`), which gives the ground, the surface and the wall. It draws nothing:
|
|
108
|
+
* `render/kart.ts` follows it.
|
|
109
|
+
*/
|
|
110
|
+
export class Kart {
|
|
111
|
+
readonly feel = KART_FEEL;
|
|
112
|
+
x = 0;
|
|
113
|
+
y = 0;
|
|
114
|
+
z = 0;
|
|
115
|
+
/** Facing: 0 looks down −z, positive turns left (three's Y rotation). */
|
|
116
|
+
yaw = 0;
|
|
117
|
+
/** Where the velocity points; `yaw − velocityYaw` is the slip. */
|
|
118
|
+
velocityYaw = 0;
|
|
119
|
+
/** Signed speed along `velocityYaw`, m/s. */
|
|
120
|
+
speed = 0;
|
|
121
|
+
/** The pedal, 0 to the class's throttle top. */
|
|
122
|
+
throttle = 0;
|
|
123
|
+
vy = 0;
|
|
124
|
+
airborne = false;
|
|
125
|
+
/** Seconds in the air on the current flight. */
|
|
126
|
+
airTime = 0;
|
|
127
|
+
/** Longest flight so far, seconds. */
|
|
128
|
+
longestAir = 0;
|
|
129
|
+
#gravity: number = KART_FEEL.gravity;
|
|
130
|
+
/** The road's own vertical speed under the kart last tick: a lip that drops away faster launches it. */
|
|
131
|
+
#roadVy = 0;
|
|
132
|
+
index = 0;
|
|
133
|
+
lateral = 0;
|
|
134
|
+
surface: Surface = "road";
|
|
135
|
+
drag = 0;
|
|
136
|
+
/** Drift: 0 none, −1 left, +1 right. */
|
|
137
|
+
driftSide = 0;
|
|
138
|
+
/** Mini-turbo stage, 0..3: spark colour white, yellow, orange (`code_80057C60.c:2865`). */
|
|
139
|
+
driftStage = 0;
|
|
140
|
+
#driftCounter = 0;
|
|
141
|
+
#hopHeld = false;
|
|
142
|
+
#hopping = false;
|
|
143
|
+
miniTurboTicks = 0;
|
|
144
|
+
miniTurbo = 0;
|
|
145
|
+
/** Fastest speed during the last mini-turbo, and the speed the last drift began at. */
|
|
146
|
+
turboPeak = 0;
|
|
147
|
+
driftEntrySpeed = 0;
|
|
148
|
+
/** Seconds the last boost lasted, and the fastest speed during it. */
|
|
149
|
+
boostSeconds = 0;
|
|
150
|
+
boostPeak = 0;
|
|
151
|
+
boostTicks = 0;
|
|
152
|
+
boost = 0;
|
|
153
|
+
catchUp = 0;
|
|
154
|
+
/** A CPU behind the pace sets this each tick. */
|
|
155
|
+
catchingUp = false;
|
|
156
|
+
spinTicks = 0;
|
|
157
|
+
tumbleTicks = 0;
|
|
158
|
+
/** Seconds the last burr spin or acorn tumble lasted. */
|
|
159
|
+
hitSeconds = 0;
|
|
160
|
+
/** Visual spin angle while hit, radians. */
|
|
161
|
+
spinAngle = 0;
|
|
162
|
+
/** Speed after 1 s of full throttle, wheel straight, on one surface: the settled top there. */
|
|
163
|
+
readonly settled: Record<Surface, number> = { grass: 0, road: 0, water: 0 };
|
|
164
|
+
#settling = 0;
|
|
165
|
+
/** Widest the kart has been from the centre line, metres. */
|
|
166
|
+
maxLateral = 0;
|
|
167
|
+
wallHits = 0;
|
|
168
|
+
/** The last wall contact: speed into the wall before and after it (m/s along the wall's
|
|
169
|
+
* normal; after is negative, away from it) and the throttle it cost. */
|
|
170
|
+
wallInto = 0;
|
|
171
|
+
wallAfter = 0;
|
|
172
|
+
wallThrottleDrop = 0;
|
|
173
|
+
/** Ticks this kart has been touching a wall this tick (0 or 1), for the effects. */
|
|
174
|
+
onWall = false;
|
|
175
|
+
readonly counts = { drifts: 0, hops: 0, miniTurbos: 0, boosts: 0, spins: 0, tumbles: 0 };
|
|
176
|
+
/** The stage each drift reached when it ended, newest last (kept short). */
|
|
177
|
+
readonly driftStages: number[] = [];
|
|
178
|
+
#topSpeed: number;
|
|
179
|
+
#throttleTop: number;
|
|
180
|
+
|
|
181
|
+
constructor(
|
|
182
|
+
readonly course: ICourse,
|
|
183
|
+
readonly engine: EngineClass = "150cc",
|
|
184
|
+
) {
|
|
185
|
+
this.#topSpeed = KART_FEEL.topSpeed[engine];
|
|
186
|
+
this.#throttleTop = KART_FEEL.throttleTop[engine];
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
get topSpeed(): number {
|
|
190
|
+
return this.#topSpeed;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
get grounded(): boolean {
|
|
194
|
+
return !this.airborne;
|
|
195
|
+
}
|
|
196
|
+
|
|
197
|
+
get drifting(): boolean {
|
|
198
|
+
return this.driftSide !== 0;
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
get hit(): boolean {
|
|
202
|
+
return this.spinTicks > 0 || this.tumbleTicks > 0;
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
/** Slip angle in radians: where the nose points against where the kart goes. */
|
|
206
|
+
get slip(): number {
|
|
207
|
+
return wrapAngle(this.yaw - this.velocityYaw);
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
/** Puts the kart on the course at sample `index`, `lateral` metres off the line, facing along it. */
|
|
211
|
+
place(index: number, lateral: number): void {
|
|
212
|
+
const course = this.course;
|
|
213
|
+
const at = { x: 0, y: 0, z: 0 };
|
|
214
|
+
const i = course.wrap(index);
|
|
215
|
+
course.pointAt(i, lateral, at);
|
|
216
|
+
this.x = at.x;
|
|
217
|
+
this.y = at.y;
|
|
218
|
+
this.z = at.z;
|
|
219
|
+
this.index = i;
|
|
220
|
+
this.lateral = lateral;
|
|
221
|
+
this.yaw = Math.atan2(-(course.tx[i] ?? 0), -(course.tz[i] ?? 0));
|
|
222
|
+
this.velocityYaw = this.yaw;
|
|
223
|
+
this.speed = 0;
|
|
224
|
+
this.throttle = 0;
|
|
225
|
+
this.vy = 0;
|
|
226
|
+
this.airborne = false;
|
|
227
|
+
this.#roadVy = 0;
|
|
228
|
+
}
|
|
229
|
+
|
|
230
|
+
/** The nitro can, a boost pad or a rocket start: throttle pinned to top for 80 ticks. */
|
|
231
|
+
startBoost(): void {
|
|
232
|
+
this.boostTicks = KART_FEEL.boostTicks;
|
|
233
|
+
this.counts.boosts += 1;
|
|
234
|
+
this.boostSeconds = 0;
|
|
235
|
+
this.boostPeak = this.speed;
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
/** A burr: a 1.5 s spin. Ends any drift and boost. */
|
|
239
|
+
spinOut(): void {
|
|
240
|
+
if (this.hit) return;
|
|
241
|
+
this.spinTicks = KART_FEEL.spinTicks;
|
|
242
|
+
this.counts.spins += 1;
|
|
243
|
+
this.hitSeconds = 0;
|
|
244
|
+
this.#endDrift(false);
|
|
245
|
+
this.boostTicks = 0;
|
|
246
|
+
this.miniTurboTicks = 0;
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
/** An acorn: a 1.7 s tumble that brings the kart to a stop. */
|
|
250
|
+
tumble(): void {
|
|
251
|
+
if (this.hit) return;
|
|
252
|
+
this.tumbleTicks = KART_FEEL.tumbleTicks;
|
|
253
|
+
this.counts.tumbles += 1;
|
|
254
|
+
this.hitSeconds = 0;
|
|
255
|
+
this.#endDrift(false);
|
|
256
|
+
this.boostTicks = 0;
|
|
257
|
+
this.miniTurboTicks = 0;
|
|
258
|
+
if (!this.airborne) {
|
|
259
|
+
this.vy = 4.5;
|
|
260
|
+
this.airborne = true;
|
|
261
|
+
this.#gravity = KART_FEEL.gravity;
|
|
262
|
+
}
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
step(input: IKartInput, dt: number): void {
|
|
266
|
+
const f = KART_FEEL;
|
|
267
|
+
const ticks = dt * 60;
|
|
268
|
+
const top = this.#throttleTop;
|
|
269
|
+
this.onWall = false;
|
|
270
|
+
|
|
271
|
+
// Hits: no control, the throttle drains, the kart turns round its own axis.
|
|
272
|
+
let throttle = input.throttle;
|
|
273
|
+
let brake = input.brake;
|
|
274
|
+
let steer = Math.max(-1, Math.min(1, input.steer));
|
|
275
|
+
if (this.hit) this.hitSeconds += dt;
|
|
276
|
+
if (this.spinTicks > 0) {
|
|
277
|
+
this.spinTicks = Math.max(0, this.spinTicks - ticks);
|
|
278
|
+
// 360° at 12°/tick, then 360° at 6°/tick.
|
|
279
|
+
this.spinAngle += (this.spinTicks > 60 ? 12 : 6) * DEG * ticks;
|
|
280
|
+
this.throttle = Math.max(0, this.throttle - f.coast * ticks);
|
|
281
|
+
throttle = false;
|
|
282
|
+
brake = false;
|
|
283
|
+
steer = 0;
|
|
284
|
+
} else if (this.tumbleTicks > 0) {
|
|
285
|
+
this.tumbleTicks = Math.max(0, this.tumbleTicks - ticks);
|
|
286
|
+
this.spinAngle += 7 * DEG * ticks;
|
|
287
|
+
this.throttle = Math.max(0, this.throttle - 5 * ticks);
|
|
288
|
+
throttle = false;
|
|
289
|
+
brake = false;
|
|
290
|
+
steer = 0;
|
|
291
|
+
} else this.spinAngle = 0;
|
|
292
|
+
|
|
293
|
+
// The pedal. A boost pins it to the top.
|
|
294
|
+
if (this.boostTicks > 0) this.throttle = top;
|
|
295
|
+
else if (throttle && this.grounded) {
|
|
296
|
+
const tenth = Math.min(9, Math.floor((this.throttle / top) * 10));
|
|
297
|
+
this.throttle = Math.min(top, this.throttle + (f.accel[tenth] ?? 0.4) * ticks);
|
|
298
|
+
} else if (brake) this.throttle = Math.max(0, this.throttle - f.brake * ticks);
|
|
299
|
+
else if (!throttle) this.throttle = Math.max(0, this.throttle - f.coast * ticks);
|
|
300
|
+
|
|
301
|
+
// Drag: the surface plus slip, eased in at 5% a tick.
|
|
302
|
+
const slipDeg = Math.abs(this.slip) / DEG;
|
|
303
|
+
let dragTarget = this.grounded ? SURFACE_DRAG[this.surface] : 0;
|
|
304
|
+
if (Math.abs(this.speed) > this.#topSpeed * 0.11)
|
|
305
|
+
dragTarget += slipDeg * (this.drifting ? f.driftDrag : f.turnDrag);
|
|
306
|
+
this.drag += (dragTarget - this.drag) * (1 - (1 - f.dragEase) ** ticks);
|
|
307
|
+
|
|
308
|
+
// Boost forces, each eased toward its level and bled off after.
|
|
309
|
+
if (this.boostTicks > 0) {
|
|
310
|
+
this.boostTicks = Math.max(0, this.boostTicks - ticks);
|
|
311
|
+
this.boost += (f.boost - this.boost) * (1 - 0.5 ** ticks);
|
|
312
|
+
} else this.boost *= 0.9 ** ticks;
|
|
313
|
+
if (this.miniTurboTicks > 0) {
|
|
314
|
+
this.miniTurboTicks = Math.max(0, this.miniTurboTicks - ticks);
|
|
315
|
+
this.miniTurbo += (f.miniTurbo - this.miniTurbo) * (1 - 0.8 ** ticks);
|
|
316
|
+
} else this.miniTurbo *= 0.99 ** ticks;
|
|
317
|
+
if (this.catchingUp) this.catchUp += (f.catchUp - this.catchUp) * (1 - 0.5 ** ticks);
|
|
318
|
+
else this.catchUp *= 0.9 ** ticks;
|
|
319
|
+
|
|
320
|
+
// Speed chases the throttle's terminal speed: ∝ throttle², less drag, plus the boosts. The
|
|
321
|
+
// nitro can skips the drag (`player_controller.c:3117`). In the air the speed holds.
|
|
322
|
+
if (this.grounded) {
|
|
323
|
+
const resist = this.boostTicks > 0 ? 0 : this.drag;
|
|
324
|
+
let target =
|
|
325
|
+
this.#topSpeed *
|
|
326
|
+
(this.throttle / top) ** 2 *
|
|
327
|
+
Math.max(0, 1 - resist) *
|
|
328
|
+
(1 + this.boost + this.miniTurbo + this.catchUp);
|
|
329
|
+
if (brake && this.throttle === 0 && this.speed < 0.5) target = -f.reverse;
|
|
330
|
+
this.speed += (target - this.speed) * (1 - Math.exp(-ticks / f.lagTicks));
|
|
331
|
+
}
|
|
332
|
+
|
|
333
|
+
// Hop and drift. A press while grounded hops; with the stick held and enough speed the hop
|
|
334
|
+
// locks a power-slide to that side, which lasts while the button is held.
|
|
335
|
+
const hopPressed = input.drift && !this.#hopHeld;
|
|
336
|
+
this.#hopHeld = input.drift;
|
|
337
|
+
if (hopPressed && this.grounded && !this.hit) {
|
|
338
|
+
this.vy = f.hopSpeed;
|
|
339
|
+
this.airborne = true;
|
|
340
|
+
this.#hopping = true;
|
|
341
|
+
this.#gravity = f.hopGravity;
|
|
342
|
+
this.counts.hops += 1;
|
|
343
|
+
}
|
|
344
|
+
const fastEnough = this.speed > this.#topSpeed * f.driftMinFraction;
|
|
345
|
+
if (
|
|
346
|
+
this.#hopping &&
|
|
347
|
+
this.driftSide === 0 &&
|
|
348
|
+
input.drift &&
|
|
349
|
+
Math.abs(steer) > 0.2 &&
|
|
350
|
+
fastEnough
|
|
351
|
+
) {
|
|
352
|
+
this.driftSide = Math.sign(steer);
|
|
353
|
+
this.driftStage = 0;
|
|
354
|
+
this.#driftCounter = 0;
|
|
355
|
+
this.counts.drifts += 1;
|
|
356
|
+
this.driftEntrySpeed = this.speed;
|
|
357
|
+
}
|
|
358
|
+
if (this.drifting) {
|
|
359
|
+
if (!input.drift) this.#endDrift(true);
|
|
360
|
+
else if (!fastEnough && this.grounded) this.#endDrift(false);
|
|
361
|
+
}
|
|
362
|
+
if (this.drifting) this.#charge(steer * this.driftSide, ticks);
|
|
363
|
+
|
|
364
|
+
// Steering.
|
|
365
|
+
let yawRate: number;
|
|
366
|
+
if (this.drifting) {
|
|
367
|
+
const inside = steer * this.driftSide;
|
|
368
|
+
yawRate =
|
|
369
|
+
this.driftSide *
|
|
370
|
+
(f.driftYaw +
|
|
371
|
+
f.driftYawInside * Math.max(0, inside) -
|
|
372
|
+
f.driftYawOutside * Math.max(0, -inside));
|
|
373
|
+
} else {
|
|
374
|
+
const hard = Math.abs(steer) >= f.steerHardLock ? f.steerHardGain : 1;
|
|
375
|
+
yawRate = ((f.steerK * steer * Math.abs(steer)) / (8 + this.throttle / 50)) * hard;
|
|
376
|
+
yawRate *= Math.min(1, Math.abs(this.speed) / f.steerFadeSpeed) * Math.sign(this.speed || 1);
|
|
377
|
+
}
|
|
378
|
+
if (this.airborne && !this.#hopping) yawRate *= 0.5;
|
|
379
|
+
// Positive steer is right; three's positive yaw turns left.
|
|
380
|
+
this.yaw = wrapAngle(this.yaw - yawRate * DEG * dt);
|
|
381
|
+
|
|
382
|
+
// The velocity's heading follows the nose at 1/12 a tick, at most 40° behind it.
|
|
383
|
+
const lag = wrapAngle(this.yaw - this.velocityYaw);
|
|
384
|
+
let next = this.velocityYaw + lag * (1 - (1 - f.slipFollow) ** ticks);
|
|
385
|
+
const behind = wrapAngle(this.yaw - next);
|
|
386
|
+
if (Math.abs(behind) > f.slipMax) next = this.yaw - Math.sign(behind) * f.slipMax;
|
|
387
|
+
this.velocityYaw = wrapAngle(next);
|
|
388
|
+
|
|
389
|
+
// Move on the ground plane.
|
|
390
|
+
if (this.miniTurboTicks > 0) this.turboPeak = Math.max(this.turboPeak, this.speed);
|
|
391
|
+
if (this.boostTicks > 0) {
|
|
392
|
+
this.boostSeconds += dt;
|
|
393
|
+
this.boostPeak = Math.max(this.boostPeak, this.speed);
|
|
394
|
+
}
|
|
395
|
+
this.x += -Math.sin(this.velocityYaw) * this.speed * dt;
|
|
396
|
+
this.z += -Math.cos(this.velocityYaw) * this.speed * dt;
|
|
397
|
+
const surface = this.surface;
|
|
398
|
+
this.#follow(dt);
|
|
399
|
+
this.maxLateral = Math.max(this.maxLateral, Math.abs(this.lateral));
|
|
400
|
+
const steady = this.grounded && this.throttle >= top && Math.abs(steer) < 0.1 && !this.drifting;
|
|
401
|
+
this.#settling = steady && surface === this.surface ? this.#settling + dt : 0;
|
|
402
|
+
if (this.#settling >= 1) this.settled[this.surface] = this.speed;
|
|
403
|
+
}
|
|
404
|
+
|
|
405
|
+
/** The track-space half of the step: where on the course, what surface, the wall and the ground. */
|
|
406
|
+
#follow(dt: number): void {
|
|
407
|
+
const f = KART_FEEL;
|
|
408
|
+
const course = this.course;
|
|
409
|
+
const point = course.track(this.index, this.x, this.z);
|
|
410
|
+
this.index = point.index;
|
|
411
|
+
this.lateral = point.lateral;
|
|
412
|
+
// The wall: push the kart back inside, reflect the speed into it ×0.5, cut the throttle.
|
|
413
|
+
const limit = (course.wall[this.index] ?? 0) - f.halfWidth;
|
|
414
|
+
if (Math.abs(this.lateral) > limit) {
|
|
415
|
+
const side = Math.sign(this.lateral);
|
|
416
|
+
const over = Math.abs(this.lateral) - limit;
|
|
417
|
+
// Right of travel is (−tz, tx).
|
|
418
|
+
const nx = -(course.tz[this.index] ?? 0) * side;
|
|
419
|
+
const nz = (course.tx[this.index] ?? 0) * side;
|
|
420
|
+
this.x -= nx * over;
|
|
421
|
+
this.z -= nz * over;
|
|
422
|
+
this.lateral = side * limit;
|
|
423
|
+
const vx = -Math.sin(this.velocityYaw) * this.speed;
|
|
424
|
+
const vz = -Math.cos(this.velocityYaw) * this.speed;
|
|
425
|
+
const into = vx * nx + vz * nz;
|
|
426
|
+
if (into > 0) {
|
|
427
|
+
const rx = vx - (1 + f.wallBounce) * into * nx;
|
|
428
|
+
const rz = vz - (1 + f.wallBounce) * into * nz;
|
|
429
|
+
this.speed = Math.hypot(rx, rz);
|
|
430
|
+
this.velocityYaw = Math.atan2(-rx, -rz);
|
|
431
|
+
this.wallInto = into;
|
|
432
|
+
this.wallAfter = rx * nx + rz * nz;
|
|
433
|
+
this.wallThrottleDrop = Math.min(this.throttle, f.wallThrottle);
|
|
434
|
+
this.throttle = Math.max(0, this.throttle - f.wallThrottle);
|
|
435
|
+
this.wallHits += 1;
|
|
436
|
+
}
|
|
437
|
+
// A nose into the wall turns to scrape along it, so the kart glances off instead of
|
|
438
|
+
// grinding to a stop against it (kit guard; MK64's own response is the reflection above).
|
|
439
|
+
const fx = -Math.sin(this.yaw);
|
|
440
|
+
const fz = -Math.cos(this.yaw);
|
|
441
|
+
const nose = fx * nx + fz * nz;
|
|
442
|
+
if (nose > 0 && Math.hypot(fx - nose * nx, fz - nose * nz) > 0.1) {
|
|
443
|
+
this.yaw = Math.atan2(-(fx - nose * nx), -(fz - nose * nz));
|
|
444
|
+
}
|
|
445
|
+
this.onWall = true;
|
|
446
|
+
this.#endDrift(false);
|
|
447
|
+
this.boostTicks = 0;
|
|
448
|
+
}
|
|
449
|
+
this.surface = course.surface(point);
|
|
450
|
+
|
|
451
|
+
// Ground: follow the road while it holds the kart; leave it at a lip that drops away faster
|
|
452
|
+
// than gravity would.
|
|
453
|
+
const ground = course.heightAt(this.index, this.x, this.z);
|
|
454
|
+
if (this.airborne) {
|
|
455
|
+
this.vy -= this.#gravity * dt;
|
|
456
|
+
this.y += this.vy * dt;
|
|
457
|
+
this.airTime += dt;
|
|
458
|
+
if (this.y <= ground) {
|
|
459
|
+
this.y = ground;
|
|
460
|
+
this.vy = 0;
|
|
461
|
+
this.airborne = false;
|
|
462
|
+
this.#hopping = false;
|
|
463
|
+
this.#gravity = f.gravity;
|
|
464
|
+
this.#roadVy = 0;
|
|
465
|
+
this.longestAir = Math.max(this.longestAir, this.airTime);
|
|
466
|
+
this.airTime = 0;
|
|
467
|
+
}
|
|
468
|
+
return;
|
|
469
|
+
}
|
|
470
|
+
const ballistic = this.y + this.#roadVy * dt - 0.5 * f.gravity * dt * dt;
|
|
471
|
+
if (ground < ballistic - 0.03 && this.#roadVy > 0.5) {
|
|
472
|
+
this.airborne = true;
|
|
473
|
+
this.#gravity = f.gravity;
|
|
474
|
+
this.vy = this.#roadVy - f.gravity * dt;
|
|
475
|
+
this.y = ballistic;
|
|
476
|
+
this.airTime = 0;
|
|
477
|
+
return;
|
|
478
|
+
}
|
|
479
|
+
this.#roadVy = (ground - this.y) / Math.max(dt, 1e-4);
|
|
480
|
+
this.y = ground;
|
|
481
|
+
}
|
|
482
|
+
|
|
483
|
+
/** The mini-turbo charge: hold the stick against the drift, then let it back. */
|
|
484
|
+
#charge(inside: number, ticks: number): void {
|
|
485
|
+
const f = KART_FEEL;
|
|
486
|
+
if (inside <= -f.chargeStick) {
|
|
487
|
+
this.#driftCounter = Math.min(f.chargeStall + 1, this.#driftCounter + ticks);
|
|
488
|
+
// Held too long: the slide stalls and bleeds 4 throttle a tick (`player_controller.c:1148`).
|
|
489
|
+
if (this.#driftCounter >= f.chargeStall)
|
|
490
|
+
this.throttle = Math.max(0, this.throttle - 4 * ticks);
|
|
491
|
+
return;
|
|
492
|
+
}
|
|
493
|
+
if (this.#driftCounter >= f.chargeTicks && this.#driftCounter < f.chargeStall)
|
|
494
|
+
this.driftStage = Math.min(3, this.driftStage + 1);
|
|
495
|
+
if (this.#driftCounter >= f.chargeKeep && this.#driftCounter < f.chargeStall)
|
|
496
|
+
this.#driftCounter = f.chargeKeep;
|
|
497
|
+
else {
|
|
498
|
+
this.#driftCounter = 0;
|
|
499
|
+
this.driftStage = 0;
|
|
500
|
+
}
|
|
501
|
+
}
|
|
502
|
+
|
|
503
|
+
/** Ends a drift; a release at stage 2 or more fires the mini-turbo. */
|
|
504
|
+
#endDrift(release: boolean): void {
|
|
505
|
+
if (!this.drifting) return;
|
|
506
|
+
if (release && this.driftStage >= 2) {
|
|
507
|
+
this.miniTurboTicks = KART_FEEL.miniTurboTicks;
|
|
508
|
+
this.counts.miniTurbos += 1;
|
|
509
|
+
this.turboPeak = this.speed;
|
|
510
|
+
}
|
|
511
|
+
this.driftStages.push(this.driftStage);
|
|
512
|
+
if (this.driftStages.length > 8) this.driftStages.shift();
|
|
513
|
+
this.driftSide = 0;
|
|
514
|
+
this.driftStage = 0;
|
|
515
|
+
this.#driftCounter = 0;
|
|
516
|
+
}
|
|
517
|
+
}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
import { defineGame } from "@threenative/core";
|
|
2
|
+
import { playtest } from "@threenative/core/playtest";
|
|
3
|
+
import config from "../threenative.config.js";
|
|
4
|
+
import { drainPlaytestEvents as events } from "./playtest-events.js";
|
|
5
|
+
import { Race } from "./scenes/Race.js";
|
|
6
|
+
import type { GameState } from "./state.js";
|
|
7
|
+
|
|
8
|
+
const game = defineGame<GameState>({
|
|
9
|
+
input: {
|
|
10
|
+
// Steering is the x of `input.vector("move")`: the arrows, A/D or the left stick. No keys on
|
|
11
|
+
// up or down: a vector is normalised, so W held with D would steer at only 0.71.
|
|
12
|
+
move: { up: [], down: [], left: ["ArrowLeft", "KeyA"], right: ["ArrowRight", "KeyD"] },
|
|
13
|
+
accel: { buttons: [0], keys: ["ArrowUp", "KeyW"] },
|
|
14
|
+
brake: { buttons: [1], keys: ["ArrowDown", "KeyS"] },
|
|
15
|
+
// Hop; hold it through a turn to power-slide, wiggle against the slide to charge a mini-turbo.
|
|
16
|
+
drift: { buttons: [5, 7], keys: ["Space", "ShiftLeft", "ShiftRight"] },
|
|
17
|
+
item: { buttons: [4, 6], keys: ["KeyE", "KeyX"] },
|
|
18
|
+
// The player's kart drives itself while this is on (the scenarios use it for whole laps).
|
|
19
|
+
autopilot: { keys: ["KeyP"] },
|
|
20
|
+
restart: { keys: ["KeyR"] },
|
|
21
|
+
},
|
|
22
|
+
plugins: [playtest({ events })],
|
|
23
|
+
display: config.display,
|
|
24
|
+
render: config.renderer,
|
|
25
|
+
scenes: { race: Race },
|
|
26
|
+
seed: 734,
|
|
27
|
+
start: "race",
|
|
28
|
+
});
|
|
29
|
+
|
|
30
|
+
export default game;
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* What the UI can ask the game to do. Intents are one-way: the UI sends `restart`, `pause` or
|
|
34
|
+
* `resume`, and reads the game's published state back instead of getting an answer.
|
|
35
|
+
*/
|
|
36
|
+
game.ui.onIntent((intent) => {
|
|
37
|
+
if (intent === "restart") void game.goto("race");
|
|
38
|
+
if (intent === "pause") game.pause();
|
|
39
|
+
if (intent === "resume") game.resume();
|
|
40
|
+
game.state.set({
|
|
41
|
+
uiReady: game.ui.connected,
|
|
42
|
+
...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
|
|
43
|
+
});
|
|
44
|
+
game.state.flush();
|
|
45
|
+
});
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { acceptHotUpdate } from "@threenative/core/hot";
|
|
2
|
+
import { createElement } from "react";
|
|
3
|
+
import { createRoot } from "react-dom/client";
|
|
4
|
+
import game from "./game.js";
|
|
5
|
+
import { App } from "./ui/App.js";
|
|
6
|
+
import "./style.css";
|
|
7
|
+
import.meta.hot?.accept();
|
|
8
|
+
acceptHotUpdate(game, import.meta.hot);
|
|
9
|
+
const root = document.getElementById("root");
|
|
10
|
+
if (root === null) throw new Error("Missing #root element.");
|
|
11
|
+
const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
|
|
12
|
+
const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
|
|
13
|
+
appRoot.__threenativeRoot = reactRoot;
|
|
14
|
+
reactRoot.render(createElement(App, { game }));
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
type PlaytestEvent = {
|
|
2
|
+
readonly [key: string]: string;
|
|
3
|
+
readonly entity: string;
|
|
4
|
+
readonly name: string;
|
|
5
|
+
};
|
|
6
|
+
|
|
7
|
+
const pendingEvents: PlaytestEvent[] = [];
|
|
8
|
+
|
|
9
|
+
export function emitPlaytestEvent(event: PlaytestEvent): void {
|
|
10
|
+
pendingEvents.push(event);
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
export function drainPlaytestEvents(): PlaytestEvent[] {
|
|
14
|
+
return pendingEvents.splice(0);
|
|
15
|
+
}
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
// ThreeNative does not read this file.
|
|
3
|
+
//
|
|
4
|
+
// The chase camera, after MK64's: low behind the kart, looking a little ahead of it, the kart at
|
|
5
|
+
// the bottom middle of the frame. Its ground position eases toward its goal at 40% a tick and its
|
|
6
|
+
// height at 15% (`mk64: src/camera.c:22`, `:614-621`), so a hop or a ramp lifts the kart in the frame
|
|
7
|
+
// before the camera follows. It chases the direction of travel, not the nose, so in a slide the
|
|
8
|
+
// kart shows its angle: a camera that turned with the nose would hide the drift.
|
|
9
|
+
import { MathUtils, type PerspectiveCamera, Vector3 } from "three";
|
|
10
|
+
import type { Kart } from "../entities/Kart.js";
|
|
11
|
+
|
|
12
|
+
export const CHASE = {
|
|
13
|
+
/** Metres behind and above the kart, and how far ahead of it the camera looks. */
|
|
14
|
+
behind: 6.2,
|
|
15
|
+
height: 2.3,
|
|
16
|
+
ahead: 5,
|
|
17
|
+
lookHeight: 0.9,
|
|
18
|
+
fov: 62,
|
|
19
|
+
/** Share of the gap closed per 60 Hz tick: ground position, height, heading. */
|
|
20
|
+
follow: 0.4,
|
|
21
|
+
lift: 0.15,
|
|
22
|
+
turn: 0.12,
|
|
23
|
+
/** A boost pulls the camera back and widens the lens a little. */
|
|
24
|
+
boostFov: 8,
|
|
25
|
+
} as const;
|
|
26
|
+
|
|
27
|
+
export interface IChaseCamera {
|
|
28
|
+
update(kart: Kart, dt: number): void;
|
|
29
|
+
snap(kart: Kart): void;
|
|
30
|
+
debug(): Record<string, unknown>;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
export function createChaseCamera(camera: PerspectiveCamera): IChaseCamera {
|
|
34
|
+
camera.fov = CHASE.fov;
|
|
35
|
+
camera.near = 0.2;
|
|
36
|
+
camera.far = 1200;
|
|
37
|
+
camera.updateProjectionMatrix();
|
|
38
|
+
let heading = 0;
|
|
39
|
+
let fov: number = CHASE.fov;
|
|
40
|
+
const goal = new Vector3();
|
|
41
|
+
const look = new Vector3();
|
|
42
|
+
const place = (kart: Kart, rate: (share: number) => number): void => {
|
|
43
|
+
// Chase the velocity's heading: in a slide the nose points in, the kart travels out.
|
|
44
|
+
const target = kart.velocityYaw;
|
|
45
|
+
heading +=
|
|
46
|
+
(MathUtils.euclideanModulo(target - heading + Math.PI, Math.PI * 2) - Math.PI) *
|
|
47
|
+
rate(CHASE.turn);
|
|
48
|
+
const bx = Math.sin(heading);
|
|
49
|
+
const bz = Math.cos(heading);
|
|
50
|
+
goal.set(kart.x + bx * CHASE.behind, kart.y + CHASE.height, kart.z + bz * CHASE.behind);
|
|
51
|
+
const k = rate(CHASE.follow);
|
|
52
|
+
camera.position.x += (goal.x - camera.position.x) * k;
|
|
53
|
+
camera.position.z += (goal.z - camera.position.z) * k;
|
|
54
|
+
camera.position.y += (goal.y - camera.position.y) * rate(CHASE.lift);
|
|
55
|
+
// Never under the road the kart is on.
|
|
56
|
+
camera.position.y = Math.max(camera.position.y, (kart.course.y[kart.index] ?? 0) + 1.2);
|
|
57
|
+
look.set(kart.x - bx * CHASE.ahead, kart.y + CHASE.lookHeight, kart.z - bz * CHASE.ahead);
|
|
58
|
+
camera.lookAt(look);
|
|
59
|
+
const boosting = kart.boostTicks > 0 || kart.miniTurboTicks > 0;
|
|
60
|
+
const wantFov = CHASE.fov + (boosting ? CHASE.boostFov : 0);
|
|
61
|
+
fov += (wantFov - fov) * rate(0.08);
|
|
62
|
+
if (Math.abs(camera.fov - fov) > 0.01) {
|
|
63
|
+
camera.fov = fov;
|
|
64
|
+
camera.updateProjectionMatrix();
|
|
65
|
+
}
|
|
66
|
+
};
|
|
67
|
+
return {
|
|
68
|
+
debug: () => ({ fov: camera.fov, heading, position: camera.position.toArray() }),
|
|
69
|
+
snap(kart) {
|
|
70
|
+
heading = kart.velocityYaw;
|
|
71
|
+
camera.position.set(
|
|
72
|
+
kart.x + Math.sin(heading) * CHASE.behind,
|
|
73
|
+
kart.y + CHASE.height,
|
|
74
|
+
kart.z + Math.cos(heading) * CHASE.behind,
|
|
75
|
+
);
|
|
76
|
+
place(kart, () => 1);
|
|
77
|
+
},
|
|
78
|
+
update(kart, dt) {
|
|
79
|
+
const ticks = dt * 60;
|
|
80
|
+
place(kart, (share) => 1 - (1 - share) ** ticks);
|
|
81
|
+
},
|
|
82
|
+
};
|
|
83
|
+
}
|