create-threenative 0.2.5 → 0.2.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +25 -3
- package/agent-docs/references/assertion-reference.md +40 -1
- package/agent-docs/references/build-profiles.md +126 -0
- package/agent-docs/references/capability-reference.md +1382 -65
- package/agent-docs/references/finding-assets.md +8 -1
- package/agent-docs/references/performance-basics.md +117 -0
- package/agent-docs/references/rigging-characters.md +51 -0
- package/agent-docs/references/sculpt-from-a-reference.md +1 -1
- package/agent-docs/references/trace-a-slow-frame.md +1 -1
- package/agent-docs/references/visual-baseline.md +8 -4
- package/agent-docs/references/webview-ui.md +3 -2
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
- package/agent-files/.agents/skills/ponytail/SKILL.md +68 -0
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +12 -4
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-context/SKILL.md +9 -1
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +26 -10
- package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
- package/agent-files/.claude/hooks/ponytail-context.mjs +51 -0
- package/agent-files/.claude/settings.json +38 -0
- package/agent-files/.codex/hooks.json +40 -0
- package/capabilities.json +1891 -101
- package/dist/index.d.ts +39 -1
- package/dist/index.js +480 -56
- package/dist/threenative.js +1247 -177
- package/package.json +6 -6
- package/template-assets/assets/mannequin-combat.glb +0 -0
- package/template-assets/assets/mannequin.glb +0 -0
- package/template-assets/assets/player-viewmodel.glb +0 -0
- package/template-assets/assets/sky.jpg +0 -0
- package/template-assets/clearwater/README.md +141 -0
- package/template-assets/clearwater/install.mjs +50 -0
- package/template-assets/clearwater/src/clearwater.ts +180 -0
- package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
- package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
- package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
- package/template-assets/clearwater/src/render/clearwater.ts +278 -0
- package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
- package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
- package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
- package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
- package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
- package/template-assets/patches/three@0.185.1.patch +2228 -105
- package/template-assets/worldEnvironment.ts +52 -1
- package/templates/action-rpg/AGENTS.md +43 -43
- package/templates/action-rpg/CLAUDE.md +43 -43
- package/templates/action-rpg/kit.json +1 -1
- package/templates/action-rpg/package.json +14 -8
- package/templates/action-rpg/playtests/combat.playtest.json +162 -23
- package/templates/action-rpg/playtests/performance.playtest.json +4 -3
- package/templates/action-rpg/playtests/survives.playtest.json +25 -8
- package/templates/action-rpg/src/conventions.ts +24 -18
- package/templates/action-rpg/src/entities/Enemy.ts +74 -24
- package/templates/action-rpg/src/entities/Fighter.ts +127 -0
- package/templates/action-rpg/src/entities/Player.ts +102 -32
- package/templates/action-rpg/src/game.ts +3 -3
- package/templates/action-rpg/src/render/camera.ts +18 -16
- package/templates/action-rpg/src/render/dungeon.ts +192 -0
- package/templates/action-rpg/src/render/lighting.ts +45 -28
- package/templates/action-rpg/src/render/loading.ts +4 -4
- package/templates/action-rpg/src/render/materials.ts +191 -47
- package/templates/action-rpg/src/render/palette.ts +14 -13
- package/templates/action-rpg/src/render/postprocessing.ts +12 -2
- package/templates/action-rpg/src/render/props.ts +117 -0
- package/templates/action-rpg/src/render/quality.ts +40 -82
- package/templates/action-rpg/src/render/sky.ts +36 -13
- package/templates/action-rpg/src/render/touch-controls.ts +1 -1
- package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
- package/templates/action-rpg/src/scenes/Play.ts +61 -39
- package/templates/action-rpg/src/style.css +9 -7
- package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
- package/templates/action-rpg/src/ui/Hud.tsx +3 -3
- package/templates/action-rpg/threenative.config.ts +14 -1
- package/templates/action-rpg/vite.config.ts +4 -1
- package/templates/minimal/AGENTS.md +12 -12
- package/templates/minimal/CLAUDE.md +12 -12
- package/templates/minimal/package.json +13 -7
- package/templates/minimal/playtests/play.playtest.json +6 -5
- package/templates/minimal/playtests/sky.playtest.json +27 -0
- package/templates/minimal/src/conventions.ts +6 -3
- package/templates/minimal/src/entities/Player.ts +73 -27
- package/templates/minimal/src/main.ts +2 -3
- package/templates/minimal/src/render/camera.ts +22 -4
- package/templates/minimal/src/render/lighting.ts +24 -48
- package/templates/minimal/src/render/materials.ts +158 -13
- package/templates/minimal/src/render/palette.ts +10 -7
- package/templates/minimal/src/render/postprocessing.ts +12 -25
- package/templates/minimal/src/render/quality.ts +35 -69
- package/templates/minimal/src/render/sky.ts +35 -54
- package/templates/minimal/src/render/touch-controls.ts +1 -1
- package/templates/minimal/src/render/worldEnvironment.ts +52 -1
- package/templates/minimal/src/scenes/Play.ts +121 -111
- package/templates/minimal/src/state.ts +0 -4
- package/templates/minimal/src/style.css +0 -10
- package/templates/minimal/threenative.config.ts +15 -1
- package/templates/minimal/vite.config.ts +4 -1
- package/templates/platformer/AGENTS.md +18 -56
- package/templates/platformer/CLAUDE.md +18 -56
- package/templates/platformer/kit.json +2 -2
- package/templates/platformer/package.json +14 -10
- package/templates/platformer/playtests/buffer.playtest.json +15 -5
- package/templates/platformer/playtests/collect.playtest.json +8 -34
- package/templates/platformer/playtests/coyote.playtest.json +12 -34
- package/templates/platformer/playtests/damage.playtest.json +40 -15
- package/templates/platformer/playtests/hud.playtest.json +34 -0
- package/templates/platformer/playtests/move.playtest.json +24 -0
- package/templates/platformer/playtests/performance.playtest.json +24 -7
- package/templates/platformer/playtests/respawn.playtest.json +46 -11
- package/templates/platformer/playtests/stomp.playtest.json +49 -12
- package/templates/platformer/playtests/survives.playtest.json +3 -19
- package/templates/platformer/playtests/world.playtest.json +26 -0
- package/templates/platformer/src/entities/Fox.ts +273 -0
- package/templates/platformer/src/entities/Pickup.ts +43 -60
- package/templates/platformer/src/entities/Walker.ts +88 -0
- package/templates/platformer/src/game.ts +11 -8
- package/templates/platformer/src/level/Checkpoints.ts +29 -16
- package/templates/platformer/src/level/Stage.ts +469 -0
- package/templates/platformer/src/render/blocks.ts +94 -0
- package/templates/platformer/src/render/camera.ts +28 -3
- package/templates/platformer/src/render/fox.ts +196 -0
- package/templates/platformer/src/render/lighting.ts +42 -33
- package/templates/platformer/src/render/materials.ts +115 -5
- package/templates/platformer/src/render/palette.ts +68 -53
- package/templates/platformer/src/render/pickups.ts +142 -0
- package/templates/platformer/src/render/postprocessing.ts +12 -2
- package/templates/platformer/src/render/props.ts +147 -0
- package/templates/platformer/src/render/quality.ts +47 -99
- package/templates/platformer/src/render/scenery.ts +172 -0
- package/templates/platformer/src/render/sky.ts +120 -31
- package/templates/platformer/src/render/touch-controls.ts +5 -2
- package/templates/platformer/src/render/walkers.ts +96 -0
- package/templates/platformer/src/render/waterfall.ts +85 -0
- package/templates/platformer/src/render/worldEnvironment.ts +52 -1
- package/templates/platformer/src/scenes/Boot.ts +3 -4
- package/templates/platformer/src/scenes/Play.ts +362 -0
- package/templates/platformer/src/state.ts +16 -14
- package/templates/platformer/src/style.css +9 -8
- package/templates/platformer/src/ui/Hud.tsx +62 -29
- package/templates/platformer/src/ui/Menu.tsx +2 -2
- package/templates/platformer/threenative.config.ts +14 -1
- package/templates/platformer/vite.config.ts +4 -1
- package/templates/puzzle/AGENTS.md +21 -22
- package/templates/puzzle/CLAUDE.md +21 -22
- package/templates/puzzle/assets/native-proof.glb +0 -0
- package/templates/puzzle/assets/native-proof.png +0 -0
- package/templates/puzzle/kit.json +1 -1
- package/templates/puzzle/package.json +14 -8
- package/templates/puzzle/playtests/axis.playtest.json +20 -0
- package/templates/puzzle/playtests/blocked.playtest.json +73 -0
- package/templates/puzzle/playtests/caused.playtest.json +65 -0
- package/templates/puzzle/playtests/lit.playtest.json +74 -0
- package/templates/puzzle/playtests/performance.playtest.json +24 -7
- package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
- package/templates/puzzle/playtests/replay.playtest.json +81 -0
- package/templates/puzzle/playtests/restart.playtest.json +108 -0
- package/templates/puzzle/playtests/seal.playtest.json +98 -0
- package/templates/puzzle/playtests/settle.playtest.json +100 -0
- package/templates/puzzle/playtests/survives.playtest.json +6 -29
- package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
- package/templates/puzzle/src/entities/Crate.ts +99 -42
- package/templates/puzzle/src/entities/Seal.ts +69 -0
- package/templates/puzzle/src/entities/Warden.ts +135 -0
- package/templates/puzzle/src/game.ts +15 -11
- package/templates/puzzle/src/render/camera.ts +66 -31
- package/templates/puzzle/src/render/crateShape.ts +70 -0
- package/templates/puzzle/src/render/lighting.ts +41 -41
- package/templates/puzzle/src/render/loading.ts +4 -4
- package/templates/puzzle/src/render/materials.ts +131 -27
- package/templates/puzzle/src/render/palette.ts +19 -29
- package/templates/puzzle/src/render/postprocessing.ts +15 -3
- package/templates/puzzle/src/render/quality.ts +71 -80
- package/templates/puzzle/src/render/shapes.ts +109 -108
- package/templates/puzzle/src/render/sky.ts +18 -10
- package/templates/puzzle/src/render/touch-controls.ts +8 -51
- package/templates/puzzle/src/render/vault.ts +315 -0
- package/templates/puzzle/src/render/warden.ts +46 -0
- package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
- package/templates/puzzle/src/scenes/Play.ts +793 -0
- package/templates/puzzle/src/state.ts +55 -24
- package/templates/puzzle/src/style.css +7 -8
- package/templates/puzzle/src/ui/App.tsx +2 -2
- package/templates/puzzle/src/ui/Hud.tsx +92 -40
- package/templates/puzzle/src/ui/Menu.tsx +40 -2
- package/templates/puzzle/threenative.config.ts +14 -1
- package/templates/puzzle/vite.config.ts +4 -1
- package/templates/racing/AGENTS.md +20 -21
- package/templates/racing/CLAUDE.md +20 -21
- package/templates/racing/package.json +14 -8
- package/templates/racing/playtests/boost.playtest.json +33 -12
- package/templates/racing/playtests/outcome.playtest.json +32 -50
- package/templates/racing/playtests/performance.playtest.json +2 -1
- package/templates/racing/playtests/ranking.playtest.json +5 -14
- package/templates/racing/playtests/rescue.playtest.json +2 -2
- package/templates/racing/playtests/reverse.playtest.json +30 -8
- package/templates/racing/playtests/shortcut.playtest.json +54 -9
- package/templates/racing/playtests/touch-controls.playtest.json +32 -5
- package/templates/racing/src/entities/CarBody.ts +327 -0
- package/templates/racing/src/entities/LineDriver.ts +220 -0
- package/templates/racing/src/entities/RacingCar.ts +150 -89
- package/templates/racing/src/entities/Rival.ts +61 -24
- package/templates/racing/src/game.ts +5 -0
- package/templates/racing/src/render/camera.ts +49 -7
- package/templates/racing/src/render/lighting.ts +36 -37
- package/templates/racing/src/render/materials.ts +239 -19
- package/templates/racing/src/render/palette.ts +19 -21
- package/templates/racing/src/render/postprocessing.ts +12 -2
- package/templates/racing/src/render/quality.ts +43 -82
- package/templates/racing/src/render/shapes.ts +20 -6
- package/templates/racing/src/render/sky.ts +47 -39
- package/templates/racing/src/render/touch-controls.ts +1 -1
- package/templates/racing/src/render/worldEnvironment.ts +52 -1
- package/templates/racing/src/scenes/Race.ts +107 -54
- package/templates/racing/src/state.ts +2 -0
- package/templates/racing/src/track/Checkline.ts +22 -7
- package/templates/racing/src/track/Lap.ts +64 -36
- package/templates/racing/src/track/Ranking.ts +20 -11
- package/templates/racing/src/track/Track.ts +809 -361
- package/templates/racing/src/track/TrackSector.ts +40 -11
- package/templates/racing/src/track/circuit.ts +477 -0
- package/templates/racing/src/track/rescue.ts +16 -4
- package/templates/racing/threenative.config.ts +14 -1
- package/templates/racing/vite.config.ts +4 -1
- package/templates/rts/AGENTS.md +96 -0
- package/templates/rts/CLAUDE.md +98 -0
- package/templates/rts/kit.json +7 -0
- package/templates/{defense → rts}/package.json +14 -8
- package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
- package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
- package/templates/rts/playtests/rts-attack.playtest.json +75 -0
- package/templates/rts/playtests/rts-build.playtest.json +68 -0
- package/templates/rts/playtests/rts-orders.playtest.json +150 -0
- package/templates/rts/playtests/rts-train.playtest.json +62 -0
- package/templates/rts/playtests/survives.playtest.json +58 -0
- package/templates/rts/public/favicon.svg +4 -0
- package/templates/rts/src/game.ts +64 -0
- package/templates/rts/src/orders.ts +22 -0
- package/templates/rts/src/render/army.ts +346 -0
- package/templates/rts/src/render/camera.ts +123 -0
- package/templates/rts/src/render/lighting.ts +61 -0
- package/templates/rts/src/render/loading.ts +33 -0
- package/templates/rts/src/render/materials.ts +152 -0
- package/templates/rts/src/render/models.ts +705 -0
- package/templates/rts/src/render/palette.ts +17 -0
- package/templates/rts/src/render/picking.ts +93 -0
- package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
- package/templates/rts/src/render/quality.ts +128 -0
- package/templates/rts/src/render/resources.ts +141 -0
- package/templates/rts/src/render/sky.ts +44 -0
- package/templates/rts/src/render/terrain.ts +116 -0
- package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
- package/templates/rts/src/scenes/Play.ts +650 -0
- package/templates/rts/src/sim/ai.ts +1140 -0
- package/templates/rts/src/sim/combat.ts +416 -0
- package/templates/rts/src/sim/construction.ts +374 -0
- package/templates/rts/src/sim/economy.ts +167 -0
- package/templates/rts/src/sim/game.ts +1082 -0
- package/templates/rts/src/sim/movement.ts +371 -0
- package/templates/rts/src/sim/nav.ts +276 -0
- package/templates/rts/src/sim/production.ts +180 -0
- package/templates/rts/src/sim/terrain.ts +170 -0
- package/templates/rts/src/sim/types.ts +647 -0
- package/templates/rts/src/sim/vision.ts +46 -0
- package/templates/rts/src/state.ts +100 -0
- package/templates/{defense → rts}/src/style.css +21 -8
- package/templates/rts/src/ui/App.tsx +21 -0
- package/templates/rts/src/ui/Commands.tsx +129 -0
- package/templates/rts/src/ui/GameUi.tsx +22 -0
- package/templates/rts/src/ui/Hud.tsx +165 -0
- package/templates/rts/src/ui/Minimap.tsx +84 -0
- package/templates/rts/tailwind.config.ts +2 -0
- package/templates/rts/threenative.config.ts +56 -0
- package/templates/rts/tsconfig.json +17 -0
- package/templates/{defense → rts}/vite.config.ts +4 -1
- package/templates/runner/AGENTS.md +8 -12
- package/templates/runner/CLAUDE.md +8 -12
- package/templates/runner/README.md +3 -3
- package/templates/runner/package.json +14 -8
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +4 -3
- package/templates/runner/src/entities/Runner.ts +54 -7
- package/templates/runner/src/game.ts +2 -0
- package/templates/runner/src/render/camera.ts +4 -2
- package/templates/runner/src/render/dust.ts +5 -2
- package/templates/runner/src/render/lighting.ts +41 -45
- package/templates/runner/src/render/loading.ts +2 -2
- package/templates/runner/src/render/materials.ts +165 -25
- package/templates/runner/src/render/palette.ts +17 -28
- package/templates/runner/src/render/postprocessing.ts +12 -2
- package/templates/runner/src/render/quality.ts +42 -96
- package/templates/runner/src/render/shapes.ts +59 -37
- package/templates/runner/src/render/sky.ts +32 -41
- package/templates/runner/src/render/touch-controls.ts +1 -1
- package/templates/runner/src/render/worldEnvironment.ts +52 -1
- package/templates/runner/src/scenes/Run.ts +26 -6
- package/templates/runner/src/track.ts +6 -1
- package/templates/runner/threenative.config.ts +14 -1
- package/templates/runner/vite.config.ts +4 -1
- package/templates/sailing/AGENTS.md +14 -14
- package/templates/sailing/CLAUDE.md +14 -14
- package/templates/sailing/assets/ship.glb +0 -0
- package/templates/sailing/package.json +14 -8
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
- package/templates/sailing/playtests/sails.playtest.json +33 -0
- package/templates/sailing/playtests/win.playtest.json +156 -8
- package/templates/sailing/src/conventions.ts +29 -2
- package/templates/sailing/src/entities/Ship.ts +381 -57
- package/templates/sailing/src/game.ts +14 -0
- package/templates/sailing/src/render/camera.ts +63 -9
- package/templates/sailing/src/render/lighting.ts +49 -27
- package/templates/sailing/src/render/materials.ts +50 -15
- package/templates/sailing/src/render/ocean.ts +647 -60
- package/templates/sailing/src/render/palette.ts +16 -12
- package/templates/sailing/src/render/postprocessing.ts +12 -2
- package/templates/sailing/src/render/props.ts +316 -442
- package/templates/sailing/src/render/quality.ts +14 -4
- package/templates/sailing/src/render/sky.ts +116 -23
- package/templates/sailing/src/render/worldEnvironment.ts +52 -1
- package/templates/sailing/src/scenes/Boot.ts +21 -0
- package/templates/sailing/src/scenes/Sailing.ts +173 -39
- package/templates/sailing/src/state.ts +6 -0
- package/templates/sailing/src/ui/Hud.tsx +41 -9
- package/templates/sailing/threenative.config.ts +14 -1
- package/templates/sailing/vite.config.ts +4 -1
- package/templates/shooter/AGENTS.md +29 -44
- package/templates/shooter/CLAUDE.md +29 -44
- package/templates/shooter/index.html +1 -0
- package/templates/shooter/package.json +14 -8
- package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
- package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
- package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
- package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
- package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
- package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
- package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
- package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
- package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
- package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
- package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
- package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
- package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
- package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
- package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
- package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
- package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
- package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
- package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
- package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
- package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
- package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
- package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
- package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
- package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
- package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
- package/templates/shooter/playtests/input-control.playtest.json +43 -98
- package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
- package/templates/shooter/playtests/performance.playtest.json +62 -26
- package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
- package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
- package/templates/shooter/playtests/survives.playtest.json +36 -30
- package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
- package/templates/shooter/src/entities/Breakables.ts +412 -0
- package/templates/shooter/src/entities/Enemy.ts +2095 -0
- package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
- package/templates/shooter/src/entities/Rifle.ts +442 -0
- package/templates/shooter/src/entities/Target.ts +199 -83
- package/templates/shooter/src/entities/TouchControls.ts +276 -0
- package/templates/shooter/src/game.ts +75 -41
- package/templates/shooter/src/main.ts +0 -1
- package/templates/shooter/src/postPhysics.ts +36 -0
- package/templates/shooter/src/render/camera.ts +78 -74
- package/templates/shooter/src/render/decals.ts +142 -82
- package/templates/shooter/src/render/facade.ts +1373 -0
- package/templates/shooter/src/render/gunfx.ts +704 -0
- package/templates/shooter/src/render/lighting.ts +52 -38
- package/templates/shooter/src/render/loading.ts +2 -2
- package/templates/shooter/src/render/materials.ts +100 -88
- package/templates/shooter/src/render/occlusion.ts +108 -0
- package/templates/shooter/src/render/palette.ts +10 -10
- package/templates/shooter/src/render/palm.ts +455 -0
- package/templates/shooter/src/render/pooled-billboards.ts +144 -0
- package/templates/shooter/src/render/postprocessing.ts +15 -3
- package/templates/shooter/src/render/quality.ts +40 -82
- package/templates/shooter/src/render/scale.ts +148 -15
- package/templates/shooter/src/render/shapes.ts +138 -613
- package/templates/shooter/src/render/sky.ts +35 -35
- package/templates/shooter/src/render/town-schematic.ts +120 -0
- package/templates/shooter/src/render/town.ts +986 -0
- package/templates/shooter/src/render/townMaterials.ts +160 -0
- package/templates/shooter/src/render/vehicles.ts +741 -0
- package/templates/shooter/src/render/worldEnvironment.ts +52 -1
- package/templates/shooter/src/scenes/Play.ts +727 -650
- package/templates/shooter/src/state.ts +26 -41
- package/templates/shooter/src/style.css +207 -11
- package/templates/shooter/src/surfaces.ts +131 -0
- package/templates/shooter/src/ui/App.tsx +9 -10
- package/templates/shooter/src/ui/Crosshair.tsx +25 -18
- package/templates/shooter/src/ui/GameUi.tsx +6 -9
- package/templates/shooter/src/ui/Hud.tsx +428 -39
- package/templates/shooter/src/ui/Minimap.tsx +164 -0
- package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
- package/templates/shooter/src/ui/main.tsx +2 -3
- package/templates/shooter/threenative.config.ts +14 -1
- package/templates/shooter/vite.config.ts +4 -1
- package/templates/starter/AGENTS.md +20 -20
- package/templates/starter/CLAUDE.md +20 -20
- package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
- package/templates/starter/package.json +15 -9
- package/templates/starter/playtests/play.playtest.json +2 -1
- package/templates/starter/playtests/{restart.playtest.json → production-readiness.playtest.json} +17 -12
- package/templates/starter/playtests/survives.playtest.json +1 -1
- package/templates/starter/src/conventions.ts +6 -3
- package/templates/starter/src/entities/Goal.ts +35 -42
- package/templates/starter/src/entities/Player.ts +99 -16
- package/templates/starter/src/render/arena.ts +131 -0
- package/templates/starter/src/render/lighting.ts +27 -44
- package/templates/starter/src/render/materials.ts +164 -35
- package/templates/starter/src/render/palette.ts +16 -16
- package/templates/starter/src/render/postprocessing.ts +6 -7
- package/templates/starter/src/render/quality.ts +43 -101
- package/templates/starter/src/render/shapes.ts +1 -1
- package/templates/starter/src/render/sky.ts +39 -45
- package/templates/starter/src/render/touch-controls.ts +3 -1
- package/templates/starter/src/render/worldEnvironment.ts +52 -1
- package/templates/starter/src/scenes/Play.ts +82 -81
- package/templates/starter/src/ui/Hud.tsx +2 -2
- package/templates/starter/src/ui/Menu.tsx +5 -1
- package/templates/starter/threenative.config.ts +14 -1
- package/templates/starter/vite.config.ts +4 -1
- package/templates/tower-defense/.codex/config.toml +19 -0
- package/templates/tower-defense/.cursor/mcp.json +32 -0
- package/templates/tower-defense/.gemini/settings.json +32 -0
- package/templates/tower-defense/.mcp.json +32 -0
- package/templates/tower-defense/.vscode/mcp.json +36 -0
- package/templates/tower-defense/.zed/settings.json +36 -0
- package/templates/{defense → tower-defense}/AGENTS.md +16 -14
- package/templates/{defense → tower-defense}/CLAUDE.md +16 -14
- package/templates/tower-defense/README.md +16 -0
- package/templates/tower-defense/index.html +12 -0
- package/templates/tower-defense/kit.json +7 -0
- package/templates/tower-defense/opencode.json +41 -0
- package/templates/tower-defense/package.json +56 -0
- package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
- package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
- package/templates/tower-defense/playtests/look.playtest.json +130 -0
- package/templates/tower-defense/playtests/performance.playtest.json +77 -0
- package/templates/tower-defense/playtests/placement.playtest.json +115 -0
- package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
- package/templates/tower-defense/playtests/strike.playtest.json +98 -0
- package/templates/tower-defense/playtests/survives.playtest.json +85 -0
- package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
- package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
- package/templates/tower-defense/playtests/victory.playtest.json +810 -0
- package/templates/tower-defense/src/balance.ts +187 -0
- package/templates/tower-defense/src/board/Board.ts +100 -0
- package/templates/tower-defense/src/board/Route.ts +84 -0
- package/templates/tower-defense/src/camera-rig.ts +62 -0
- package/templates/tower-defense/src/economy.ts +64 -0
- package/templates/tower-defense/src/effects/Effects.ts +284 -0
- package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
- package/templates/tower-defense/src/game.ts +72 -0
- package/templates/tower-defense/src/intents.ts +21 -0
- package/templates/tower-defense/src/main.ts +15 -0
- package/templates/tower-defense/src/physics.ts +6 -0
- package/templates/tower-defense/src/render/camera.ts +38 -0
- package/templates/tower-defense/src/render/lighting.ts +42 -0
- package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
- package/templates/tower-defense/src/render/materials.ts +103 -0
- package/templates/tower-defense/src/render/palette.ts +58 -0
- package/templates/tower-defense/src/render/postprocessing.ts +46 -0
- package/templates/tower-defense/src/render/quality.ts +128 -0
- package/templates/tower-defense/src/render/shapes.ts +550 -0
- package/templates/tower-defense/src/render/sky.ts +27 -0
- package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
- package/templates/tower-defense/src/scenes/Battle.ts +539 -0
- package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
- package/templates/tower-defense/src/state.ts +88 -0
- package/templates/tower-defense/src/style.css +137 -0
- package/templates/tower-defense/src/towers/Tower.ts +230 -0
- package/templates/tower-defense/src/towers/targeting.ts +97 -0
- package/templates/tower-defense/src/ui/Hud.tsx +270 -0
- package/templates/tower-defense/src/ui/Menu.tsx +134 -0
- package/templates/tower-defense/src/ui/icons.tsx +54 -0
- package/templates/tower-defense/src/ui/main.tsx +14 -0
- package/templates/tower-defense/src/waves.ts +90 -0
- package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
- package/templates/tower-defense/vite.config.ts +41 -0
- package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
- package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -45
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
- package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -57
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -42
- package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
- package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
- package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
- package/agent-files/AGENT-ROLES.md +0 -26
- package/templates/action-rpg/src/render/shapes.ts +0 -269
- package/templates/action-rpg/src/render/types.ts +0 -3
- package/templates/action-rpg/src/scenes/Boot.ts +0 -12
- package/templates/defense/README.md +0 -10
- package/templates/defense/kit.json +0 -7
- package/templates/defense/playtests/leak.playtest.json +0 -23
- package/templates/defense/playtests/placement.playtest.json +0 -40
- package/templates/defense/playtests/scan.playtest.json +0 -20
- package/templates/defense/playtests/survive.playtest.json +0 -45
- package/templates/defense/playtests/survives.playtest.json +0 -36
- package/templates/defense/src/attackers/Attacker.ts +0 -120
- package/templates/defense/src/board/Route.ts +0 -94
- package/templates/defense/src/conventions.ts +0 -18
- package/templates/defense/src/economy.ts +0 -36
- package/templates/defense/src/entities/Player.ts +0 -52
- package/templates/defense/src/game.ts +0 -51
- package/templates/defense/src/physics.ts +0 -13
- package/templates/defense/src/placement/Buildable.ts +0 -49
- package/templates/defense/src/render/camera.ts +0 -16
- package/templates/defense/src/render/lighting.ts +0 -37
- package/templates/defense/src/render/materials.ts +0 -22
- package/templates/defense/src/render/palette.ts +0 -28
- package/templates/defense/src/render/quality.ts +0 -170
- package/templates/defense/src/render/shapes.ts +0 -246
- package/templates/defense/src/render/sky.ts +0 -45
- package/templates/defense/src/scenes/Boot.ts +0 -12
- package/templates/defense/src/scenes/Defense.ts +0 -231
- package/templates/defense/src/state.ts +0 -56
- package/templates/defense/src/towers/Tower.ts +0 -95
- package/templates/defense/src/towers/targeting.ts +0 -53
- package/templates/defense/src/ui/Hud.tsx +0 -62
- package/templates/defense/src/ui/Menu.tsx +0 -7
- package/templates/defense/src/waves.ts +0 -40
- package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
- package/templates/minimal/src/render/hud.ts +0 -69
- package/templates/platformer/playtests/avoidance.playtest.json +0 -28
- package/templates/platformer/playtests/chase.playtest.json +0 -21
- package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
- package/templates/platformer/playtests/oneway.playtest.json +0 -44
- package/templates/platformer/playtests/patrol.playtest.json +0 -13
- package/templates/platformer/playtests/physics.playtest.json +0 -14
- package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
- package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
- package/templates/platformer/src/conventions.ts +0 -18
- package/templates/platformer/src/entities/Character.ts +0 -286
- package/templates/platformer/src/entities/Chaser.ts +0 -118
- package/templates/platformer/src/entities/Patrol.ts +0 -93
- package/templates/platformer/src/level/Platform.ts +0 -46
- package/templates/platformer/src/render/rig.ts +0 -60
- package/templates/platformer/src/render/terrain.ts +0 -31
- package/templates/platformer/src/scenes/Level.ts +0 -241
- package/templates/puzzle/README.md +0 -43
- package/templates/puzzle/playtests/carry.playtest.json +0 -71
- package/templates/puzzle/playtests/swing.playtest.json +0 -38
- package/templates/puzzle/src/conventions.ts +0 -25
- package/templates/puzzle/src/entities/Ball.ts +0 -70
- package/templates/puzzle/src/entities/Gripper.ts +0 -69
- package/templates/puzzle/src/entities/Pendulum.ts +0 -89
- package/templates/puzzle/src/physics.ts +0 -19
- package/templates/puzzle/src/room.ts +0 -83
- package/templates/puzzle/src/scenes/Boot.ts +0 -12
- package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
- package/templates/shooter/playtests/combat.playtest.json +0 -48
- package/templates/shooter/playtests/fail.playtest.json +0 -31
- package/templates/shooter/playtests/per-item.playtest.json +0 -59
- package/templates/shooter/playtests/shooter.playtest.json +0 -99
- package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
- package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
- package/templates/shooter/src/combat/damage.ts +0 -40
- package/templates/shooter/src/conventions.ts +0 -51
- package/templates/shooter/src/entities/Pickup.ts +0 -70
- package/templates/shooter/src/entities/Player.ts +0 -310
- package/templates/shooter/src/level/SpawnPoints.ts +0 -28
- package/templates/shooter/src/playtest-events.ts +0 -15
- package/templates/shooter/src/render/touch-controls.ts +0 -305
- package/templates/shooter/src/render/types.ts +0 -3
- package/templates/shooter/src/render/ui.css +0 -330
- package/templates/shooter/src/render/ui.ts +0 -75
- package/templates/shooter/src/render/vfx.ts +0 -215
- package/templates/shooter/src/ui/Menu.tsx +0 -41
- package/templates/shooter/src/waves.ts +0 -50
- package/templates/shooter/src/weapons/Hitscan.ts +0 -42
- package/templates/shooter/src/weapons/Projectile.ts +0 -92
- package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
- package/templates/starter/playtests/assets.playtest.json +0 -65
- package/templates/starter/playtests/buffer.playtest.json +0 -79
- package/templates/starter/playtests/cloth.playtest.json +0 -113
- package/templates/starter/playtests/coyote.playtest.json +0 -87
- package/templates/starter/playtests/gameover.playtest.json +0 -66
- package/templates/starter/playtests/goal.playtest.json +0 -67
- package/templates/starter/playtests/look.playtest.json +0 -175
- package/templates/starter/playtests/models-baseline.png +0 -0
- package/templates/starter/playtests/models.playtest.json +0 -74
- package/templates/starter/playtests/monitoring.playtest.json +0 -72
- package/templates/starter/playtests/odometer.playtest.json +0 -54
- package/templates/starter/playtests/seed.playtest.json +0 -54
- package/templates/starter/playtests/textures-baseline.png +0 -0
- package/templates/starter/playtests/textures.playtest.json +0 -74
- package/templates/starter/playtests/touch-controls.playtest.json +0 -42
- package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
- package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
- package/templates/starter/src/render/coast.ts +0 -199
- package/templates/starter/src/render/hero.ts +0 -88
- package/templates/starter/src/render/implicitSurface.ts +0 -199
- package/templates/starter/src/render/kuwahara.ts +0 -174
- package/templates/starter/src/render/outline.ts +0 -141
- package/templates/starter/src/render/painterly.ts +0 -86
- package/templates/starter/src/render/rockRidge.ts +0 -198
- package/templates/starter/src/render/rockRidge.worker.ts +0 -77
- package/templates/starter/src/render/scenery.ts +0 -40
- package/templates/starter/src/render/textureLifetime.ts +0 -53
- package/templates/starter/src/render/water.ts +0 -38
- package/templates/starter/src/render/watercolor.ts +0 -85
- /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
- /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
- /package/templates/{defense → rts}/.codex/config.toml +0 -0
- /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
- /package/templates/{defense → rts}/.gemini/settings.json +0 -0
- /package/templates/{defense → rts}/.mcp.json +0 -0
- /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
- /package/templates/{defense → rts}/.zed/settings.json +0 -0
- /package/templates/{defense → rts}/index.html +0 -0
- /package/templates/{defense → rts}/opencode.json +0 -0
- /package/templates/{defense → rts}/src/main.ts +0 -0
- /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
- /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
- /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
- /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
- /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
- /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
- /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
|
@@ -0,0 +1,327 @@
|
|
|
1
|
+
import type { ICtx } from "@threenative/core";
|
|
2
|
+
import {
|
|
3
|
+
CollisionShape3D,
|
|
4
|
+
type IPhysicsContext,
|
|
5
|
+
type IVehicleWheel3D,
|
|
6
|
+
VehicleBody3D,
|
|
7
|
+
} from "@threenative/physics";
|
|
8
|
+
import { Box3, Group, MathUtils, type Object3D, Vector3 } from "three";
|
|
9
|
+
import { prepareVehicleConventions } from "../conventions.js";
|
|
10
|
+
import { vehicle } from "../render/shapes.js";
|
|
11
|
+
import type { GameState } from "../state.js";
|
|
12
|
+
|
|
13
|
+
export type CarCtx = ICtx<GameState, IPhysicsContext>;
|
|
14
|
+
export type CarMaterials = Parameters<typeof vehicle>[0];
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* The chassis geometry, in metres, in the chassis's own frame. `VehicleBody3D` reads Godot's
|
|
18
|
+
* `VehicleWheel3D` names; these are its values.
|
|
19
|
+
*
|
|
20
|
+
* The numbers are measured, not guessed. `packages/physics`'s AGENTS.md records the three Rapier
|
|
21
|
+
* facts this file depends on, and the tuning was done against them on the real backend:
|
|
22
|
+
*
|
|
23
|
+
* - `suspensionStiffness` is **mass-normalised** — a frequency squared, so the strut sags about
|
|
24
|
+
* `gravity / (4 * stiffness)` and Godot's default of 20 bottoms the suspension out. At this
|
|
25
|
+
* world's `-24 m/s²` and 220 that is 27 mm of the 240 mm strut.
|
|
26
|
+
* - A wheel ray must not hit the chassis it hangs from, or the car rides its own collider.
|
|
27
|
+
* - `speed` is the seam's own signed forward speed, not Rapier's `currentVehicleSpeed()`.
|
|
28
|
+
*
|
|
29
|
+
* Measured on this geometry (620 kg, 17 m/s top speed): 0 → 15.04 m/s in 3.33 s and a settled
|
|
30
|
+
* 17.00 m/s terminal; 15.04 → 0 in 0.65 s over 4.75 m; a full-lock input at 15 m/s settles into a
|
|
31
|
+
* 7.6 m radius corner without spinning; 0 → 11.1 m/s in 2.5 s from rest on full lock, which is the
|
|
32
|
+
* "turns on the spot without spinning" case; an 80 mm kerb lifts the car 8 mm and costs no speed,
|
|
33
|
+
* and a car at 17 m/s stops at a wall without passing through it.
|
|
34
|
+
*/
|
|
35
|
+
export const CAR = {
|
|
36
|
+
/** Godot's `collision_layer`: another car, the road, the field, the barriers. */
|
|
37
|
+
collisionLayer: 1,
|
|
38
|
+
/** Godot's `collision_mask` — what the chassis and its wheel rays scan. */
|
|
39
|
+
collisionMask: 1 | 2 | 4 | 8,
|
|
40
|
+
/** Godot's `mass`. 620 kg for a 3 m car. */
|
|
41
|
+
mass: 620,
|
|
42
|
+
/** The chassis collider: the car's waist, clear of the road and low enough to ride a kerb. */
|
|
43
|
+
shape: { height: 0.24, length: 2.5, width: 1.05 },
|
|
44
|
+
/**
|
|
45
|
+
* Godot's `suspensionRestLength`. The chassis origin rides one strut above the tarmac, so this is
|
|
46
|
+
* also the car's ride height before sag.
|
|
47
|
+
*/
|
|
48
|
+
suspensionRestLength: 0.24,
|
|
49
|
+
/** Mass-normalised, so this is a frequency squared and not newtons per metre. */
|
|
50
|
+
suspensionStiffness: 220,
|
|
51
|
+
dampingCompression: 2.3,
|
|
52
|
+
dampingRelaxation: 4.4,
|
|
53
|
+
maxSuspensionTravel: 0.12,
|
|
54
|
+
/** Above 10 the tyres hold a 7.6 m radius at 15 m/s instead of washing wide. */
|
|
55
|
+
wheelFrictionSlip: 14,
|
|
56
|
+
/** Godot's `up_direction` is implicit: the suspension ray points down the chassis's own -y. */
|
|
57
|
+
gravity: 24,
|
|
58
|
+
} as const;
|
|
59
|
+
|
|
60
|
+
/**
|
|
61
|
+
* The feel. Every number is measured on the physics rather than chosen, and they are shared by
|
|
62
|
+
* both cars on the circuit: the rival drives the same chassis with the same tyres, so it is a
|
|
63
|
+
* driver, not a faster class of car.
|
|
64
|
+
*
|
|
65
|
+
* `topSpeed` is **reached, not clamped**. The engine force falls linearly to zero there, which is
|
|
66
|
+
* a torque curve rather than a speed limit: the tyres, the suspension and the barriers all still
|
|
67
|
+
* decide what happens, and a car that hits a wall at 17 m/s stops at the wall.
|
|
68
|
+
*/
|
|
69
|
+
export const FEEL = {
|
|
70
|
+
/** Newton's per driven wheel at zero speed. Two rear wheels, so this is half the push. */
|
|
71
|
+
engineForce: 3400,
|
|
72
|
+
/** Godot's `brake`: a braking impulse on every wheel, not a force. */
|
|
73
|
+
brake: 60,
|
|
74
|
+
/** Where the torque curve reaches zero, in m/s. */
|
|
75
|
+
topSpeed: 17,
|
|
76
|
+
/** The boost lifts the curve's zero point, so a boost genuinely raises the top speed. */
|
|
77
|
+
boostTopSpeed: 23,
|
|
78
|
+
/** And lifts the force behind it, so it arrives sooner as well as going further. */
|
|
79
|
+
boostForce: 1.9,
|
|
80
|
+
/** Holding back above this brakes; at or below it, reverse engages. */
|
|
81
|
+
reverseEnterSpeed: 0.5,
|
|
82
|
+
/** Reverse's own top speed, so it cannot run away down the straight. */
|
|
83
|
+
reverseTopSpeed: 8,
|
|
84
|
+
/** Godot's `steering` in radians at full lock, on the spot. */
|
|
85
|
+
maxSteer: 0.5,
|
|
86
|
+
/**
|
|
87
|
+
* The lateral acceleration the steering curve aims for, in m/s². Lock falls as `1 / speed²`
|
|
88
|
+
* because that is what holds a constant radius, so the tyres set the limit instead of the input:
|
|
89
|
+
* 30 gives a 7.6 m corner at 15 m/s, and this circuit's corners are 7 m of road.
|
|
90
|
+
*/
|
|
91
|
+
lateral: 30,
|
|
92
|
+
/** Degrees the visible body leans at the lateral limit, and dives under braking. */
|
|
93
|
+
leanRoll: 5,
|
|
94
|
+
leanPitch: 3,
|
|
95
|
+
} as const;
|
|
96
|
+
|
|
97
|
+
/** The chassis wheelbase in metres, read off the same sculpt the wheels come from. */
|
|
98
|
+
export const WHEELBASE = 1.835;
|
|
99
|
+
|
|
100
|
+
/** Where the four wheels are named in `shapes.ts`. The order is the physics wheel order. */
|
|
101
|
+
export const WHEEL_NAMES = [
|
|
102
|
+
"wheel-front-left",
|
|
103
|
+
"wheel-front-right",
|
|
104
|
+
"wheel-rear-left",
|
|
105
|
+
"wheel-rear-right",
|
|
106
|
+
] as const;
|
|
107
|
+
|
|
108
|
+
/** Strut sag for this world: `gravity / (4 * stiffness)`, which is what mass-normalised means. */
|
|
109
|
+
export const SAG = CAR.gravity / (4 * CAR.suspensionStiffness);
|
|
110
|
+
|
|
111
|
+
/**
|
|
112
|
+
* The visual's own origin sits on its authored ground line, and the physics puts the wheel
|
|
113
|
+
* contacts one strut *below* the chassis origin. Offsetting the body by the settled strut is what
|
|
114
|
+
* stops the car from being drawn a full strut height in the air (or under the road).
|
|
115
|
+
*/
|
|
116
|
+
export const RIDE = CAR.suspensionRestLength - SAG;
|
|
117
|
+
|
|
118
|
+
/**
|
|
119
|
+
* The one place the two yaw conventions meet.
|
|
120
|
+
*
|
|
121
|
+
* A heading here is always measured the way a map is: `atan2(z, x)` of the direction the car's
|
|
122
|
+
* nose points. three's `rotation.y` turns **+x toward -z**, and Rapier's `teleport` yaw is that same
|
|
123
|
+
* +y rotation, so a heading has to be negated on the way in. Getting this wrong points the car 2θ
|
|
124
|
+
* away from where the caller asked — which reads as "the rival spawns facing the wrong way and the
|
|
125
|
+
* pursuit controller steers it into the tyre wall".
|
|
126
|
+
*/
|
|
127
|
+
export function noseRotation(yaw: number): number {
|
|
128
|
+
return -yaw;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
const DEG = Math.PI / 180;
|
|
132
|
+
const _box = new Box3();
|
|
133
|
+
const _size = new Vector3();
|
|
134
|
+
const _point = new Vector3();
|
|
135
|
+
|
|
136
|
+
function requireNamed(visual: Group, name: string): Object3D {
|
|
137
|
+
const found = visual.getObjectByName(name);
|
|
138
|
+
if (found === undefined) throw new Error(`CarBody: the car sculpt has no '${name}' group.`);
|
|
139
|
+
return found;
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
/**
|
|
143
|
+
* One wheel's physics description, read off its own mesh.
|
|
144
|
+
*
|
|
145
|
+
* The position comes from the mesh rather than a second copy of the numbers, and the radius is
|
|
146
|
+
* measured from the mesh's own bounds — so reshaping the car in `shapes.ts` moves the suspension
|
|
147
|
+
* with it, and the physics can never end up describing a wheel the scene does not draw.
|
|
148
|
+
*/
|
|
149
|
+
function describeWheel(
|
|
150
|
+
visual: Group,
|
|
151
|
+
name: string,
|
|
152
|
+
scale: number,
|
|
153
|
+
): { readonly position: { x: number; y: number; z: number }; readonly wheelRadius: number } {
|
|
154
|
+
const mesh = requireNamed(visual, name);
|
|
155
|
+
visual.updateWorldMatrix(true, true);
|
|
156
|
+
_box.setFromObject(mesh, true);
|
|
157
|
+
if (_box.isEmpty()) throw new Error(`CarBody: '${name}' has no geometry to measure.`);
|
|
158
|
+
// `worldToLocal` divides out the visual's uniform scale; the chassis frame is that times it.
|
|
159
|
+
const local = visual.worldToLocal(_box.getCenter(_point)).multiplyScalar(scale);
|
|
160
|
+
// The lathe runs about the wheel's z axis, so half the y extent of its world bounds is its
|
|
161
|
+
// radius, already in chassis metres.
|
|
162
|
+
return {
|
|
163
|
+
position: { x: local.x, y: local.y, z: local.z },
|
|
164
|
+
wheelRadius: _box.getSize(_size).y / 2,
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
/**
|
|
169
|
+
* A `VehicleBody3D` and the sculpted car it carries.
|
|
170
|
+
*
|
|
171
|
+
* Both cars on this circuit are one of these, so the player's and the rival's handling are the
|
|
172
|
+
* same code: there is no second, worse car hiding in `Rival.ts`.
|
|
173
|
+
*/
|
|
174
|
+
export class CarBody {
|
|
175
|
+
/** The chassis `VehicleBody3D` drives. Its transform is written back every physics step. */
|
|
176
|
+
readonly body: VehicleBody3D;
|
|
177
|
+
/** The chassis root: the object the physics writes its solved transform onto. */
|
|
178
|
+
readonly mesh: Group;
|
|
179
|
+
/** The sculpted car inside it, scaled to metres and offset by `RIDE`. */
|
|
180
|
+
readonly chassis: Group;
|
|
181
|
+
/** The leanable shell inside `chassis`, named `body` by `shapes.ts`. */
|
|
182
|
+
readonly lean: Object3D;
|
|
183
|
+
/** The four wheel groups, in the same order as `body.wheels`. */
|
|
184
|
+
readonly wheels: readonly Object3D[];
|
|
185
|
+
/** The retained `normaliseToMetres` factor, which the playtest asserts is below one. */
|
|
186
|
+
readonly normaliseFactor: number;
|
|
187
|
+
/** The chassis nose in world space: what the car is *pointing* at, off its own quaternion. */
|
|
188
|
+
readonly forward = new Vector3(1, 0, 0);
|
|
189
|
+
/** Where it is actually *going*, measured from its velocity. `Lap` reads this, not `forward`. */
|
|
190
|
+
readonly travelDirection = new Vector3(1, 0, 0);
|
|
191
|
+
/** Lateral acceleration in m/s², positive to the driver's right. */
|
|
192
|
+
lateralLoad = 0;
|
|
193
|
+
/** Forward acceleration in m/s²: positive under power, negative under braking. */
|
|
194
|
+
longLoad = 0;
|
|
195
|
+
#velocity = new Vector3();
|
|
196
|
+
#last = new Vector3();
|
|
197
|
+
#right = new Vector3();
|
|
198
|
+
#delta = new Vector3();
|
|
199
|
+
|
|
200
|
+
constructor(
|
|
201
|
+
ctx: CarCtx,
|
|
202
|
+
options: { readonly materials: CarMaterials; readonly spawn: Vector3; readonly yaw: number },
|
|
203
|
+
) {
|
|
204
|
+
this.mesh = new Group();
|
|
205
|
+
this.mesh.position.set(options.spawn.x, options.spawn.y, options.spawn.z);
|
|
206
|
+
// `yaw` is a heading (`atan2(z, x)` of where the nose points); `noseRotation` converts it to the
|
|
207
|
+
// +y rotation three and Rapier both use.
|
|
208
|
+
this.mesh.rotation.y = noseRotation(options.yaw);
|
|
209
|
+
this.mesh.castShadow = true;
|
|
210
|
+
const chassis = vehicle(options.materials);
|
|
211
|
+
this.normaliseFactor = prepareVehicleConventions(chassis);
|
|
212
|
+
chassis.position.y = -RIDE;
|
|
213
|
+
this.mesh.add(chassis);
|
|
214
|
+
ctx.add(this.mesh);
|
|
215
|
+
this.chassis = chassis;
|
|
216
|
+
this.wheels = WHEEL_NAMES.map((name) => requireNamed(chassis, name));
|
|
217
|
+
this.lean = requireNamed(chassis, "body");
|
|
218
|
+
this.body = new VehicleBody3D({
|
|
219
|
+
collisionLayer: CAR.collisionLayer,
|
|
220
|
+
collisionMask: CAR.collisionMask,
|
|
221
|
+
// The car's nose is its local +x, which is the direction `shapes.ts` lofted the hull along.
|
|
222
|
+
forwardAxis: "x",
|
|
223
|
+
mass: CAR.mass,
|
|
224
|
+
object: this.mesh,
|
|
225
|
+
physics: ctx.physics,
|
|
226
|
+
shape: CollisionShape3D.box(CAR.shape.length, CAR.shape.height, CAR.shape.width),
|
|
227
|
+
wheels: this.wheels.map((wheel, index): IVehicleWheel3D => {
|
|
228
|
+
const measured = describeWheel(chassis, WHEEL_NAMES[index] as string, this.normaliseFactor);
|
|
229
|
+
return {
|
|
230
|
+
dampingCompression: CAR.dampingCompression,
|
|
231
|
+
dampingRelaxation: CAR.dampingRelaxation,
|
|
232
|
+
maxSuspensionTravel: CAR.maxSuspensionTravel,
|
|
233
|
+
position: measured.position,
|
|
234
|
+
suspensionRestLength: CAR.suspensionRestLength,
|
|
235
|
+
suspensionStiffness: CAR.suspensionStiffness,
|
|
236
|
+
useAsSteering: index < 2,
|
|
237
|
+
useAsTraction: index >= 2,
|
|
238
|
+
wheelFrictionSlip: CAR.wheelFrictionSlip,
|
|
239
|
+
wheelRadius: measured.wheelRadius,
|
|
240
|
+
};
|
|
241
|
+
}),
|
|
242
|
+
});
|
|
243
|
+
}
|
|
244
|
+
|
|
245
|
+
/** Godot's signed forward speed: positive while accelerating forward. */
|
|
246
|
+
get speed(): number {
|
|
247
|
+
return this.body.speed;
|
|
248
|
+
}
|
|
249
|
+
|
|
250
|
+
get speedMagnitude(): number {
|
|
251
|
+
return Math.abs(this.body.speed);
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
get position(): Vector3 {
|
|
255
|
+
return this.mesh.position;
|
|
256
|
+
}
|
|
257
|
+
|
|
258
|
+
/** The steering angle in radians this car last wrote, which is what the front wheels draw. */
|
|
259
|
+
get steerAngle(): number {
|
|
260
|
+
return this.body.steering;
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
/**
|
|
264
|
+
* The steering lock at a speed: full lock on the spot, falling as `1 / speed²` because that is
|
|
265
|
+
* the angle which holds a radius. A fixed lock asks for 8 g at 17 m/s and the car washes
|
|
266
|
+
* straight on. This is the input curve; the tyres still set the limit.
|
|
267
|
+
*/
|
|
268
|
+
lockAt(speed: number): number {
|
|
269
|
+
const fast = Math.max(Math.abs(speed), 3);
|
|
270
|
+
return Math.min(FEEL.maxSteer, (FEEL.lateral * WHEELBASE) / (fast * fast));
|
|
271
|
+
}
|
|
272
|
+
|
|
273
|
+
/**
|
|
274
|
+
* Reads the solved chassis: the nose off its own quaternion, the travel direction and the load
|
|
275
|
+
* off its own velocity, divided by the frame it was measured over.
|
|
276
|
+
*/
|
|
277
|
+
measure(dt: number): void {
|
|
278
|
+
this.forward.set(1, 0, 0).applyQuaternion(this.mesh.quaternion);
|
|
279
|
+
this.#right.set(0, 0, 1).applyQuaternion(this.mesh.quaternion);
|
|
280
|
+
const velocity = this.body.linearVelocity;
|
|
281
|
+
this.#velocity.set(velocity.x, 0, velocity.z);
|
|
282
|
+
// The measured direction of travel. Below half a metre per second a velocity has no direction
|
|
283
|
+
// worth trusting, and a gate crossing in that state is a stationary car, not a reversal.
|
|
284
|
+
if (this.#velocity.lengthSq() > 0.25) this.travelDirection.copy(this.#velocity).normalize();
|
|
285
|
+
else this.travelDirection.copy(this.forward);
|
|
286
|
+
this.#delta.copy(this.#velocity).sub(this.#last);
|
|
287
|
+
this.#last.copy(this.#velocity);
|
|
288
|
+
const perSecond = dt > 0 ? 1 / dt : 60;
|
|
289
|
+
this.lateralLoad = this.#delta.dot(this.#right) * perSecond;
|
|
290
|
+
this.longLoad = this.#delta.dot(this.forward) * perSecond;
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
/**
|
|
294
|
+
* The suspension's own state, after the step: the wheels spin and steer, and the body leans on
|
|
295
|
+
* the load the tyres are carrying.
|
|
296
|
+
*
|
|
297
|
+
* The lean is drawn from a **measurement** — the change in the chassis' own velocity this frame —
|
|
298
|
+
* because Rapier's ray-cast vehicle applies its suspension and friction impulses without a
|
|
299
|
+
* moment about the roll axis, so the solved chassis stays level at 1.2 g (measured: 0.8° of roll
|
|
300
|
+
* across the struts at 1.2 g lateral) and there is no real body roll to read. Roll and dive are
|
|
301
|
+
* functions of lateral and forward load; this is that function, with the car's own load as input.
|
|
302
|
+
*/
|
|
303
|
+
settleVisuals(): void {
|
|
304
|
+
for (const [index, wheel] of this.wheels.entries()) {
|
|
305
|
+
// Rolling forward turns the wheel about its own -z and Rapier's rotation runs the other way,
|
|
306
|
+
// so the sign is inverted here; the front pair also takes the steer angle it was given.
|
|
307
|
+
wheel.rotation.z = -this.body.wheelRotation(index);
|
|
308
|
+
if (index < 2) wheel.rotation.y = this.body.steering;
|
|
309
|
+
}
|
|
310
|
+
this.lean.rotation.z =
|
|
311
|
+
MathUtils.clamp(this.lateralLoad / FEEL.lateral, -1, 1) * FEEL.leanRoll * DEG;
|
|
312
|
+
this.lean.rotation.x =
|
|
313
|
+
MathUtils.clamp(this.longLoad / FEEL.lateral, -1, 1) * FEEL.leanPitch * DEG;
|
|
314
|
+
}
|
|
315
|
+
|
|
316
|
+
/** Godot's `VehicleBody3D.teleport`: move the chassis and face the heading `yaw`. */
|
|
317
|
+
teleport(position: Pick<Vector3, "x" | "y" | "z">, yaw: number): void {
|
|
318
|
+
this.body.teleport(position, noseRotation(yaw));
|
|
319
|
+
this.#last.set(0, 0, 0);
|
|
320
|
+
this.measure(1 / 60);
|
|
321
|
+
}
|
|
322
|
+
|
|
323
|
+
dispose(): void {
|
|
324
|
+
this.body.dispose();
|
|
325
|
+
this.mesh.removeFromParent();
|
|
326
|
+
}
|
|
327
|
+
}
|
|
@@ -0,0 +1,220 @@
|
|
|
1
|
+
import { MathUtils, Vector3 } from "three";
|
|
2
|
+
import { CIRCUIT, type CircuitLine } from "../track/circuit.js";
|
|
3
|
+
import type { CarBody } from "./CarBody.js";
|
|
4
|
+
import { FEEL } from "./CarBody.js";
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* The closed-loop driver: aim at a point ahead on the circuit, brake for what is coming.
|
|
8
|
+
*
|
|
9
|
+
* It is the **only** thing in this template that turns "where the car is" into "what the driver
|
|
10
|
+
* does", and both cars on the circuit use it — the rival, and the autopilot the playtest presses.
|
|
11
|
+
* That is deliberate: a scenario that wants a car to lap the circuit cannot do it with recorded key
|
|
12
|
+
* timings, because a chassis with suspension and weight transfer answers a fixed key script
|
|
13
|
+
* differently on every corner. It can do it by pressing the same button the rival's controller
|
|
14
|
+
* obeys, and the result is a lap that is a **consequence** of the physics rather than a timing
|
|
15
|
+
* that happens to be near the road.
|
|
16
|
+
*
|
|
17
|
+
* The sign in {@link headingError} is the whole mechanic, so it is exported and pinned: positive
|
|
18
|
+
* is to the driver's right, and a positive Rapier steering angle is to its left.
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
export function headingError(yaw: number, target: Vector3, from: Vector3): number {
|
|
22
|
+
const wanted = Math.atan2(target.z - from.z, target.x - from.x);
|
|
23
|
+
return Math.atan2(Math.sin(wanted - yaw), Math.cos(wanted - yaw));
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/** How far ahead of itself the driver aims, in metres, plus its own speed. */
|
|
27
|
+
const LOOKAHEAD_BASE = 3.5;
|
|
28
|
+
const LOOKAHEAD_PER_MPS = 0.3;
|
|
29
|
+
|
|
30
|
+
/** How close to the edge of the road the driver lets the car get before it starts recovering. */
|
|
31
|
+
const SAFE_HALF = 3.1;
|
|
32
|
+
|
|
33
|
+
/**
|
|
34
|
+
* The demo driver's get-out-of-trouble rule.
|
|
35
|
+
*
|
|
36
|
+
* Below {@link BEACHED_SPEED} for {@link BEACHED_SECONDS} the car is beached: this chassis can end
|
|
37
|
+
* up nose-down with its driven wheels in the air and its rear on the tarmac, and no amount of
|
|
38
|
+
* throttle or reverse moves it. The driver then puts the car back on the racing line, six metres
|
|
39
|
+
* further along than the last place it was actually driving, facing the right way.
|
|
40
|
+
*
|
|
41
|
+
* This is a **demo** driver — the attract-mode lap a player watches, and the follower a playtest
|
|
42
|
+
* presses. Its contract is "follow the circuit", and rejoining the line is how it keeps that
|
|
43
|
+
* contract after a mistake. It is not the game's rescue: `RacingCar` does not know it happened, the
|
|
44
|
+
* `rescues` counter does not move, and the player is never affected.
|
|
45
|
+
*/
|
|
46
|
+
const BEACHED_SPEED = 1.6;
|
|
47
|
+
const BEACHED_SECONDS = 1.1;
|
|
48
|
+
const REJOIN_AHEAD = 6;
|
|
49
|
+
|
|
50
|
+
/** Steering gain: the fraction of the heading error it takes as steering input. */
|
|
51
|
+
const STEER_GAIN = 2.2;
|
|
52
|
+
|
|
53
|
+
/** How far ahead it looks for a corner to slow for, and how often it samples. */
|
|
54
|
+
const BRAKE_SCAN = 46;
|
|
55
|
+
const BRAKE_STEP = 4;
|
|
56
|
+
|
|
57
|
+
/** The fraction of the tyres' lateral limit a corner is actually taken at. */
|
|
58
|
+
const CORNER_MARGIN = 0.62;
|
|
59
|
+
|
|
60
|
+
export interface ILineDriverOptions {
|
|
61
|
+
/** The pace held where the road is straight, in m/s. */
|
|
62
|
+
readonly pace: number;
|
|
63
|
+
/** How hard the brakes bite, in m/s². Used only to decide *when* to start braking. */
|
|
64
|
+
readonly deceleration?: number;
|
|
65
|
+
/**
|
|
66
|
+
* Lateral offset of the driven line from the centreline, in metres. Positive is to the right.
|
|
67
|
+
*
|
|
68
|
+
* Two cars on the same line fight: they are the same chassis, the same width and the same pace,
|
|
69
|
+
* so they touch on the first corner and lock. Giving each driver its own offset is what lets the
|
|
70
|
+
* player's demo lap and the rival run the same circuit at the same time without a collision.
|
|
71
|
+
*/
|
|
72
|
+
readonly offset?: number;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
export class LineDriver {
|
|
76
|
+
readonly line: CircuitLine;
|
|
77
|
+
/** Monotonic progress around the lap, in metres. It keeps counting past the line. */
|
|
78
|
+
#progress = 0;
|
|
79
|
+
#lastProjected = 0;
|
|
80
|
+
#started = false;
|
|
81
|
+
#beached = 0;
|
|
82
|
+
#driven = 0;
|
|
83
|
+
#steering = 0;
|
|
84
|
+
#pace: number;
|
|
85
|
+
#deceleration: number;
|
|
86
|
+
#offset: number;
|
|
87
|
+
|
|
88
|
+
constructor(options: ILineDriverOptions, line: CircuitLine = CIRCUIT) {
|
|
89
|
+
if (!(options.pace > 0)) throw new Error("LineDriver pace must be positive.");
|
|
90
|
+
this.line = line;
|
|
91
|
+
this.#pace = options.pace;
|
|
92
|
+
this.#deceleration = options.deceleration ?? FEEL.brake * 0.55;
|
|
93
|
+
this.#offset = options.offset ?? 0;
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
set pace(value: number) {
|
|
97
|
+
if (!(value > 0)) throw new Error("LineDriver pace must be positive.");
|
|
98
|
+
this.#pace = value;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
get progress(): number {
|
|
102
|
+
return this.#progress;
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
/** Puts the driver on the circuit at `distance`, as a car placed on the grid is. */
|
|
106
|
+
reset(distance: number): void {
|
|
107
|
+
this.#progress = distance;
|
|
108
|
+
this.#lastProjected =
|
|
109
|
+
((distance % this.line.totalLength) + this.line.totalLength) % this.line.totalLength;
|
|
110
|
+
this.#started = true;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/**
|
|
114
|
+
* One frame. Writes `steering`, `engineForce` and `brake` on the car's chassis, and nothing else:
|
|
115
|
+
* grip, weight transfer and understeer stay where they belong, in the physics.
|
|
116
|
+
*/
|
|
117
|
+
update(car: CarBody, dt: number): void {
|
|
118
|
+
const speed = car.speedMagnitude;
|
|
119
|
+
const projection = this.line.project(car.position, this.#projection);
|
|
120
|
+
const beached = speed < BEACHED_SPEED;
|
|
121
|
+
if (beached) this.#beached += dt;
|
|
122
|
+
else {
|
|
123
|
+
this.#beached = 0;
|
|
124
|
+
this.#driven = this.#progress;
|
|
125
|
+
}
|
|
126
|
+
if (beached && this.#beached > BEACHED_SECONDS) {
|
|
127
|
+
this.#beached = 0;
|
|
128
|
+
const back = this.line.at(this.#driven + REJOIN_AHEAD, this.#rejoin);
|
|
129
|
+
car.teleport(
|
|
130
|
+
{ x: back.point.x, y: back.point.y + 0.24, z: back.point.z },
|
|
131
|
+
Math.atan2(back.tangent.z, back.tangent.x),
|
|
132
|
+
);
|
|
133
|
+
this.reset(this.#driven + REJOIN_AHEAD);
|
|
134
|
+
}
|
|
135
|
+
this.drive(car, dt, projection);
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
private drive(
|
|
139
|
+
car: CarBody,
|
|
140
|
+
dt: number,
|
|
141
|
+
projection: { readonly distance: number; readonly lateral: number },
|
|
142
|
+
): void {
|
|
143
|
+
const body = car.body;
|
|
144
|
+
const speed = car.speedMagnitude;
|
|
145
|
+
if (!this.#started) {
|
|
146
|
+
this.reset(projection.distance);
|
|
147
|
+
this.#driven = projection.distance;
|
|
148
|
+
} else {
|
|
149
|
+
const half = this.line.totalLength / 2;
|
|
150
|
+
const full = half * 2;
|
|
151
|
+
this.#progress +=
|
|
152
|
+
((((projection.distance - this.#lastProjected + half) % full) + full) % full) - half;
|
|
153
|
+
this.#lastProjected = projection.distance;
|
|
154
|
+
}
|
|
155
|
+
const ahead = this.line.at(
|
|
156
|
+
this.#progress + LOOKAHEAD_BASE + speed * LOOKAHEAD_PER_MPS,
|
|
157
|
+
this.#ahead,
|
|
158
|
+
);
|
|
159
|
+
// The line is not the centreline: the driver moves to the **inside** of the corner it is going
|
|
160
|
+
// fast through, which is the difference between a car following a groove and a car racing. The
|
|
161
|
+
// sign of the curvature is the side the corner turns toward, so that is the side to move to.
|
|
162
|
+
let aimOffset =
|
|
163
|
+
this.#offset +
|
|
164
|
+
Math.sign(ahead.curvature) * Math.min(1.8, 1 / Math.max(Math.abs(ahead.curvature), 1 / 90));
|
|
165
|
+
// A racing line is a preference, not a rail. Past {@link SAFE_HALF} the aim comes back toward
|
|
166
|
+
// the centreline in proportion to how far out the car is, because a driver does not drive off
|
|
167
|
+
// the road to hold a line: measured, the pure line put the car 4.8 m out on a 4.5 m road at
|
|
168
|
+
// the hairpin and stopped it on the inside kerb.
|
|
169
|
+
const off = Math.abs(projection.lateral);
|
|
170
|
+
if (off > SAFE_HALF)
|
|
171
|
+
aimOffset -= Math.sign(projection.lateral) * Math.min(3, (off - SAFE_HALF) * 0.9);
|
|
172
|
+
const aim = this.#aim.copy(ahead.point).addScaledVector(ahead.right, aimOffset);
|
|
173
|
+
const yaw = Math.atan2(car.forward.z, car.forward.x);
|
|
174
|
+
const error = headingError(yaw, aim, car.position);
|
|
175
|
+
this.#steering = -MathUtils.clamp(error * STEER_GAIN, -1, 1) * car.lockAt(speed);
|
|
176
|
+
body.steering = this.#steering;
|
|
177
|
+
const target = this.targetSpeed(this.#progress);
|
|
178
|
+
if (speed < target) {
|
|
179
|
+
const want = MathUtils.clamp((target - speed) / 2.5, 0, 1);
|
|
180
|
+
body.engineForce = FEEL.engineForce * want * Math.max(0, 1 - speed / target);
|
|
181
|
+
body.brake = 0;
|
|
182
|
+
} else {
|
|
183
|
+
body.engineForce = 0;
|
|
184
|
+
body.brake = FEEL.brake * MathUtils.clamp((speed - target) / 1.5, 0.15, 1);
|
|
185
|
+
}
|
|
186
|
+
car.measure(dt);
|
|
187
|
+
}
|
|
188
|
+
|
|
189
|
+
/**
|
|
190
|
+
* The speed the tyres can hold here, minus what is coming.
|
|
191
|
+
*
|
|
192
|
+
* The forward scan is what makes the car brake *before* the hairpin instead of arriving at it
|
|
193
|
+
* already sideways: for every point in the next {@link BRAKE_SCAN} metres it asks what speed
|
|
194
|
+
* that corner allows, and whether it could still be down to it in the distance available.
|
|
195
|
+
*/
|
|
196
|
+
private targetSpeed(progress: number): number {
|
|
197
|
+
let limit = this.#pace;
|
|
198
|
+
for (let look = 0; look <= BRAKE_SCAN; look += BRAKE_STEP) {
|
|
199
|
+
const sample = this.line.at(progress + look, this.#scan);
|
|
200
|
+
const corner = Math.sqrt(
|
|
201
|
+
FEEL.lateral * CORNER_MARGIN * (Number.isFinite(sample.radius) ? sample.radius : 1e6),
|
|
202
|
+
);
|
|
203
|
+
const reachable = Math.sqrt(corner * corner + 2 * this.#deceleration * look);
|
|
204
|
+
if (reachable < limit) limit = reachable;
|
|
205
|
+
}
|
|
206
|
+
return Math.max(6, limit);
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
readonly #projection = {
|
|
210
|
+
curvature: 0,
|
|
211
|
+
distance: 0,
|
|
212
|
+
lateral: 0,
|
|
213
|
+
point: new Vector3(),
|
|
214
|
+
tangent: new Vector3(),
|
|
215
|
+
};
|
|
216
|
+
readonly #aim = new Vector3();
|
|
217
|
+
readonly #rejoin = CIRCUIT.createSample();
|
|
218
|
+
readonly #ahead = CIRCUIT.createSample();
|
|
219
|
+
readonly #scan = CIRCUIT.createSample();
|
|
220
|
+
}
|