create-threenative 0.2.6 → 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 +2 -2
- package/agent-docs/references/build-profiles.md +126 -0
- package/agent-docs/references/capability-reference.md +431 -20
- package/agent-docs/references/performance-basics.md +8 -5
- 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-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
- 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/capabilities.json +555 -21
- package/dist/index.d.ts +30 -1
- package/dist/index.js +294 -55
- package/dist/threenative.js +714 -154
- 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 +2101 -138
- package/template-assets/worldEnvironment.ts +52 -1
- package/templates/action-rpg/AGENTS.md +42 -42
- package/templates/action-rpg/CLAUDE.md +42 -42
- package/templates/action-rpg/kit.json +1 -1
- package/templates/action-rpg/package.json +13 -7
- 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 +10 -10
- package/templates/minimal/CLAUDE.md +10 -10
- package/templates/minimal/package.json +12 -6
- 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 +14 -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 +13 -9
- 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 +19 -20
- package/templates/puzzle/CLAUDE.md +19 -20
- 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 +13 -7
- 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 +19 -20
- package/templates/racing/CLAUDE.md +19 -20
- package/templates/racing/package.json +13 -7
- 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 +13 -7
- 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 +6 -10
- package/templates/runner/CLAUDE.md +6 -10
- package/templates/runner/README.md +3 -3
- package/templates/runner/package.json +13 -7
- 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 +12 -12
- package/templates/sailing/CLAUDE.md +12 -12
- package/templates/sailing/assets/ship.glb +0 -0
- package/templates/sailing/package.json +13 -7
- 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 +27 -42
- package/templates/shooter/CLAUDE.md +27 -42
- package/templates/shooter/index.html +1 -0
- package/templates/shooter/package.json +13 -7
- 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 +17 -17
- package/templates/starter/CLAUDE.md +17 -17
- package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
- package/templates/starter/package.json +13 -7
- package/templates/starter/playtests/play.playtest.json +2 -1
- 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/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 +14 -12
- package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
- 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/ponytail/SKILL.md +0 -68
- package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
- package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
- 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/restart.playtest.json +0 -91
- 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
|
@@ -1,48 +1,56 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
// ThreeNative does not read this file.
|
|
3
|
+
//
|
|
4
|
+
// The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
|
|
5
|
+
// by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
|
|
6
|
+
// The same image is the background, the environment light every surface reflects and is filled by,
|
|
7
|
+
// and — through `SUN_DIRECTION` — the direction the sun's shadows fall. Swap the file for any
|
|
8
|
+
// equirectangular sky and re-aim `SUN_DIRECTION` at its sun.
|
|
1
9
|
import {
|
|
2
|
-
BackSide,
|
|
3
|
-
BufferAttribute,
|
|
4
10
|
Color,
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
MeshBasicMaterial,
|
|
11
|
+
EquirectangularReflectionMapping,
|
|
12
|
+
FogExp2,
|
|
13
|
+
SRGBColorSpace,
|
|
9
14
|
type Scene,
|
|
10
|
-
|
|
15
|
+
type Texture,
|
|
16
|
+
Vector3,
|
|
11
17
|
} from "three";
|
|
12
18
|
import { palette } from "./palette.js";
|
|
13
19
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
// instead of a place with things in it.
|
|
21
|
-
scene.fog = new Fog(bottom, 70, 230);
|
|
20
|
+
/**
|
|
21
|
+
* How the JPEG was made from the 4k HDR: linear radiance × 0.4, clipped, sRGB-encoded — so white
|
|
22
|
+
* in the file is 2.5 in the sky. Multiplying back restores the HDR brightness of the clouds; the sun
|
|
23
|
+
* disk itself is clipped, which is why the sun is a light (`lighting.ts`) and not a texel.
|
|
24
|
+
*/
|
|
25
|
+
const SKY_RANGE = 2.5;
|
|
22
26
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
// different heights.
|
|
26
|
-
// Sky is most of the frame, so a flat one costs more than anything else here. Edit or delete
|
|
27
|
-
// this — it is your file.
|
|
28
|
-
const radius = 260;
|
|
29
|
-
const geometry = new SphereGeometry(radius, 24, 12);
|
|
30
|
-
const positions = geometry.getAttribute("position");
|
|
31
|
-
const colors = new Float32Array(positions.count * 3);
|
|
32
|
-
const color = new Color();
|
|
33
|
-
for (let index = 0; index < positions.count; index += 1) {
|
|
34
|
-
const height = MathUtils.clamp((positions.getY(index) / radius + 0.2) / 0.65, 0, 1);
|
|
35
|
-
color.copy(bottom).lerp(top, height);
|
|
36
|
-
colors.set([color.r, color.g, color.b], index * 3);
|
|
37
|
-
}
|
|
38
|
-
geometry.setAttribute("color", new BufferAttribute(colors, 3));
|
|
27
|
+
/** Unit vector toward the photographed sun: 47.9° up, measured from the source HDR. */
|
|
28
|
+
export const SUN_DIRECTION = new Vector3(0.555, 0.742, 0.38).normalize();
|
|
39
29
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
30
|
+
/**
|
|
31
|
+
* Puts the sky on the scene, or a plain gradient if the photograph has not decoded yet.
|
|
32
|
+
*
|
|
33
|
+
* The second argument is optional because `Race.load()` does not wait for the JPEG: the scene has
|
|
34
|
+
* to enter on the first frame or the playtest bridge describes nothing. Passing `undefined` here is
|
|
35
|
+
* the fallback the scene starts in, and calling it again with the texture is the swap.
|
|
36
|
+
*/
|
|
37
|
+
export function setupSky(scene: Scene, sky?: Texture): void {
|
|
38
|
+
if (sky === undefined) {
|
|
39
|
+
scene.background = new Color(palette.skyHigh);
|
|
40
|
+
scene.environment = null;
|
|
41
|
+
scene.environmentIntensity = 0;
|
|
42
|
+
} else {
|
|
43
|
+
sky.mapping = EquirectangularReflectionMapping;
|
|
44
|
+
sky.colorSpace = SRGBColorSpace;
|
|
45
|
+
scene.background = sky;
|
|
46
|
+
scene.backgroundIntensity = SKY_RANGE;
|
|
47
|
+
// three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
|
|
48
|
+
// It is what makes a standard material read as a material: sky-blue fill on faces the sun
|
|
49
|
+
// misses, and a sky to reflect, sharper as roughness drops.
|
|
50
|
+
scene.environment = sky;
|
|
51
|
+
scene.environmentIntensity = SKY_RANGE;
|
|
52
|
+
}
|
|
53
|
+
// Nothing inside the circuit (2.4% at 40 m), and the ground gone into the horizon by a kilometre
|
|
54
|
+
// — so the treeline meets the sky instead of ending at a line.
|
|
55
|
+
scene.fog = new FogExp2(palette.horizon, 0.0024);
|
|
48
56
|
}
|
|
@@ -84,7 +84,7 @@ export class TouchControls {
|
|
|
84
84
|
|
|
85
85
|
constructor(camera: PerspectiveCamera) {
|
|
86
86
|
this.#camera = camera;
|
|
87
|
-
this.#idleMaterial = overlayMaterial(palette.
|
|
87
|
+
this.#idleMaterial = overlayMaterial(palette.structure, 0.35);
|
|
88
88
|
this.#activeMaterial = overlayMaterial(palette.accent, 0.62);
|
|
89
89
|
this.#moveBase = ringMesh(MOVE_RADIUS, this.#idleMaterial);
|
|
90
90
|
this.#moveKnob = new Mesh(new CircleGeometry(28, 24), this.#activeMaterial);
|
|
@@ -24,8 +24,10 @@ import {
|
|
|
24
24
|
} from "three";
|
|
25
25
|
import { bloom } from "three/addons/tsl/display/BloomNode.js";
|
|
26
26
|
import { denoise } from "three/addons/tsl/display/DenoiseNode.js";
|
|
27
|
+
import { fxaa } from "three/addons/tsl/display/FXAANode.js";
|
|
27
28
|
import { ao } from "three/addons/tsl/display/GTAONode.js";
|
|
28
29
|
import { godrays } from "three/addons/tsl/display/GodraysNode.js";
|
|
30
|
+
import { smaa } from "three/addons/tsl/display/SMAANode.js";
|
|
29
31
|
import { ssgi } from "three/addons/tsl/display/SSGINode.js";
|
|
30
32
|
import { ssr } from "three/addons/tsl/display/SSRNode.js";
|
|
31
33
|
import { sharpen } from "three/addons/tsl/display/SharpenNode.js";
|
|
@@ -33,6 +35,7 @@ import {
|
|
|
33
35
|
color,
|
|
34
36
|
convertToTexture,
|
|
35
37
|
float,
|
|
38
|
+
max,
|
|
36
39
|
metalness,
|
|
37
40
|
mrt,
|
|
38
41
|
normalView,
|
|
@@ -45,6 +48,9 @@ import {
|
|
|
45
48
|
} from "three/tsl";
|
|
46
49
|
import type { Node } from "three/webgpu";
|
|
47
50
|
|
|
51
|
+
/** Godot's `Viewport.screen_space_aa`: which post-process antialiasing smooths the frame's edges. */
|
|
52
|
+
export type ScreenSpaceAA = "smaa" | "fxaa" | "disabled";
|
|
53
|
+
|
|
48
54
|
/** Godot's `Environment.tonemap_mode`, with the modes Three.js actually ships. */
|
|
49
55
|
export type TonemapMode = "aces" | "agx" | "neutral";
|
|
50
56
|
|
|
@@ -184,6 +190,16 @@ export interface IWorldEnvironmentOptions {
|
|
|
184
190
|
readonly sharpenStrength?: number;
|
|
185
191
|
/** Corner darkening, as a fraction removed at the extreme corner. Zero disables it. */
|
|
186
192
|
readonly vignetteAmount?: number;
|
|
193
|
+
/**
|
|
194
|
+
* Post-process antialiasing, run last. Godot's `Viewport.screen_space_aa`. Default `"smaa"`.
|
|
195
|
+
*
|
|
196
|
+
* Not optional in practice: the chain renders `pass(scene, camera)` single-sampled, so the moment
|
|
197
|
+
* any stage runs, the renderer's own multisampling no longer reaches the frame and every edge
|
|
198
|
+
* stairsteps — the single loudest "this is a prototype" signal in a frame. It is requested only
|
|
199
|
+
* when some other stage (or a `baseColour`) installs a chain; with nothing installed the renderer
|
|
200
|
+
* draws straight to the canvas with its own MSAA and this would be paying twice.
|
|
201
|
+
*/
|
|
202
|
+
readonly screenSpaceAA?: ScreenSpaceAA;
|
|
187
203
|
/** Godot's `glow_enabled`. */
|
|
188
204
|
readonly bloomEnabled?: boolean;
|
|
189
205
|
readonly bloomStrength?: number;
|
|
@@ -391,6 +407,7 @@ export class WorldEnvironment {
|
|
|
391
407
|
sharpenEnabled: options.sharpenEnabled ?? false,
|
|
392
408
|
sharpenStrength: options.sharpenStrength ?? 0.2,
|
|
393
409
|
vignetteAmount: options.vignetteAmount ?? 0,
|
|
410
|
+
screenSpaceAA: options.screenSpaceAA ?? "smaa",
|
|
394
411
|
bloomEnabled: options.bloomEnabled ?? true,
|
|
395
412
|
bloomStrength: options.bloomStrength ?? 0.7,
|
|
396
413
|
bloomRadius: options.bloomRadius ?? 0.5,
|
|
@@ -432,6 +449,11 @@ export class WorldEnvironment {
|
|
|
432
449
|
(name === "vignette" && options.vignetteAmount > 0),
|
|
433
450
|
);
|
|
434
451
|
requested.push(...options.authoredStageNames);
|
|
452
|
+
if (
|
|
453
|
+
options.screenSpaceAA !== "disabled" &&
|
|
454
|
+
(requested.length > 0 || target.baseColour !== undefined)
|
|
455
|
+
)
|
|
456
|
+
requested.push("antialias");
|
|
435
457
|
|
|
436
458
|
// With no stage running there is no node graph to install — the renderer's own
|
|
437
459
|
// tone-mapping path renders the frame, and the exposure scalar is live there (measured:
|
|
@@ -542,7 +564,14 @@ export class WorldEnvironment {
|
|
|
542
564
|
// Applied before SSGI by the chain's canonical order; composing it after the GI
|
|
543
565
|
// combine instead darkens crevices the gather re-lit — that is a look choice, and
|
|
544
566
|
// this file is where you make it.
|
|
545
|
-
|
|
567
|
+
//
|
|
568
|
+
// Denoised with the same depth-aware filter as the GI gather: GTAO's interleaved
|
|
569
|
+
// sampling otherwise reads as a speckled halo around every contact — around feet on a
|
|
570
|
+
// plain floor most of all — which is exactly the "not smooth" a player notices first.
|
|
571
|
+
const occlusion = options.denoiseEnabled
|
|
572
|
+
? denoised(denoise(contact.getTextureNode(), depth(), normal(), view))
|
|
573
|
+
: contact;
|
|
574
|
+
return input.mul(occlusion.r);
|
|
546
575
|
},
|
|
547
576
|
}),
|
|
548
577
|
stage({
|
|
@@ -668,6 +697,26 @@ export class WorldEnvironment {
|
|
|
668
697
|
return input.mul(fall.oneMinus());
|
|
669
698
|
},
|
|
670
699
|
}),
|
|
700
|
+
{
|
|
701
|
+
// Last, after every built-in: antialiasing is defined on the finished picture, and any
|
|
702
|
+
// stage after it would put the stairsteps back.
|
|
703
|
+
name: "antialias",
|
|
704
|
+
after: "gradualBackground",
|
|
705
|
+
build: (input) => {
|
|
706
|
+
const colour = input as ChainNode;
|
|
707
|
+
// SMAA and FXAA find edges by local contrast and expect display-range colour, but this is
|
|
708
|
+
// the linear HDR frame before the tone curve — a sun-lit edge at 20 against sky at 3
|
|
709
|
+
// would blend into a bright halo. The reversible Karis weighting squeezes it into [0, 1)
|
|
710
|
+
// for the filter and expands it back afterwards, so edges resolve without the halo.
|
|
711
|
+
const peak = max(colour.r, max(colour.g, colour.b));
|
|
712
|
+
const squeezed = colour.div(peak.add(1));
|
|
713
|
+
const filtered = (options.screenSpaceAA === "fxaa"
|
|
714
|
+
? fxaa(squeezed)
|
|
715
|
+
: smaa(squeezed)) as unknown as ChainNode;
|
|
716
|
+
const back = max(filtered.r, max(filtered.g, filtered.b));
|
|
717
|
+
return filtered.div(float(1).sub(back).max(1e-4));
|
|
718
|
+
},
|
|
719
|
+
},
|
|
671
720
|
];
|
|
672
721
|
|
|
673
722
|
// The kit's own stages, composed after the built-ins. The factory is called with the two
|
|
@@ -723,6 +772,7 @@ export class WorldEnvironment {
|
|
|
723
772
|
const options = this.#options;
|
|
724
773
|
const off: Record<string, string> = {
|
|
725
774
|
ambientOcclusion: "gtaoEnabled is false",
|
|
775
|
+
antialias: 'screenSpaceAA is "disabled", or no other stage installed a chain',
|
|
726
776
|
bloom: "bloomEnabled is false",
|
|
727
777
|
godRays: "godraysEnabled is false",
|
|
728
778
|
sharpen: "sharpenEnabled is false",
|
|
@@ -745,6 +795,7 @@ export class WorldEnvironment {
|
|
|
745
795
|
denoise: options.denoiseEnabled,
|
|
746
796
|
exposure: options.exposure,
|
|
747
797
|
marker: "TN_WORLD_ENVIRONMENT",
|
|
798
|
+
screenSpaceAA: options.screenSpaceAA,
|
|
748
799
|
ssgiQuality: options.ssgiQuality,
|
|
749
800
|
stages,
|
|
750
801
|
tonemapMode: options.tonemapMode,
|
|
@@ -2,32 +2,46 @@ import {
|
|
|
2
2
|
type ICtx,
|
|
3
3
|
Scene,
|
|
4
4
|
type SceneFrame,
|
|
5
|
+
afterPhysics,
|
|
5
6
|
isMobile,
|
|
6
7
|
isTouchscreenAvailable,
|
|
7
8
|
} from "@threenative/core";
|
|
8
9
|
import type { IPhysicsContext } from "@threenative/physics";
|
|
9
|
-
import { type PerspectiveCamera, Vector3 } from "three";
|
|
10
|
-
import {
|
|
10
|
+
import { type PerspectiveCamera, type Texture, Vector3 } from "three";
|
|
11
|
+
import { type CarCtx, FEEL } from "../entities/CarBody.js";
|
|
12
|
+
import { RacingCar } from "../entities/RacingCar.js";
|
|
11
13
|
import { Rival } from "../entities/Rival.js";
|
|
12
14
|
import { emitPlaytestEvent } from "../playtest-events.js";
|
|
13
|
-
import {
|
|
15
|
+
import { cameraBank, chaseCamera, setupCamera } from "../render/camera.js";
|
|
14
16
|
import { setupLighting } from "../render/lighting.js";
|
|
15
17
|
import { createLoadingScreen } from "../render/loading.js";
|
|
16
|
-
import { createMaterials } from "../render/materials.js";
|
|
17
18
|
import { setupPost } from "../render/postprocessing.js";
|
|
18
|
-
import {
|
|
19
|
-
import { setupSky } from "../render/sky.js";
|
|
19
|
+
import { SUN_DIRECTION, setupSky } from "../render/sky.js";
|
|
20
20
|
import { TouchControls } from "../render/touch-controls.js";
|
|
21
21
|
import { type GameState, type RaceStatus, resolveRaceStatus } from "../state.js";
|
|
22
22
|
import { Lap } from "../track/Lap.js";
|
|
23
23
|
import { type IRankedRacer, type IRankedRacerScratch, rankRacers } from "../track/Ranking.js";
|
|
24
|
-
import {
|
|
24
|
+
import {
|
|
25
|
+
TOTAL_LAPS,
|
|
26
|
+
buildTrack,
|
|
27
|
+
gridHeading,
|
|
28
|
+
gridPosition,
|
|
29
|
+
intersectRay,
|
|
30
|
+
roadRayProbe,
|
|
31
|
+
} from "../track/Track.js";
|
|
25
32
|
import { TrackSector } from "../track/TrackSector.js";
|
|
33
|
+
import { CIRCUIT, GRID_DISTANCE } from "../track/circuit.js";
|
|
26
34
|
|
|
27
|
-
export type GameCtx =
|
|
35
|
+
export type GameCtx = CarCtx;
|
|
28
36
|
|
|
29
|
-
|
|
30
|
-
const
|
|
37
|
+
/** The player starts on the second grid slot, one ride height above the tarmac. */
|
|
38
|
+
const SPAWN = gridPosition("player", new Vector3());
|
|
39
|
+
SPAWN.y = CIRCUIT.at(GRID_DISTANCE.player, CIRCUIT.createSample()).point.y + 0.22;
|
|
40
|
+
/**
|
|
41
|
+
* The race is three laps of 55-60 s, so a time limit under four minutes is a limit nobody reaches
|
|
42
|
+
* and one that only fires on a car that has already been rescued four times.
|
|
43
|
+
*/
|
|
44
|
+
const TIME_LIMIT = 260;
|
|
31
45
|
|
|
32
46
|
function playerRanking(ranked: readonly IRankedRacer[]): IRankedRacer | undefined {
|
|
33
47
|
for (let index = 0; index < ranked.length; index += 1) {
|
|
@@ -45,6 +59,7 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
45
59
|
static override readonly initialState: GameState = {
|
|
46
60
|
paused: false,
|
|
47
61
|
uiReady: false,
|
|
62
|
+
autopilot: false,
|
|
48
63
|
boostActive: false,
|
|
49
64
|
boostPeakSpeed: 0,
|
|
50
65
|
boostUses: 0,
|
|
@@ -55,8 +70,11 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
55
70
|
position: "P1",
|
|
56
71
|
raceStatus: "RACING",
|
|
57
72
|
rescueHeading: 0,
|
|
58
|
-
|
|
59
|
-
|
|
73
|
+
// Before any rescue, both errors are the worst they could be: the car is facing the wrong way
|
|
74
|
+
// and it is a whole lap from where it belongs. A sentinel of -1 satisfies an "at most 0.05 rad"
|
|
75
|
+
// assertion before the game has done anything, which is how a bound stops being a bound.
|
|
76
|
+
rescueHeadingError: Math.PI,
|
|
77
|
+
rescuePositionError: Math.PI,
|
|
60
78
|
rescues: 0,
|
|
61
79
|
shortcutRejects: 0,
|
|
62
80
|
speed: 0,
|
|
@@ -68,12 +86,40 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
68
86
|
reverseRejects: 0,
|
|
69
87
|
};
|
|
70
88
|
|
|
89
|
+
#sky: Texture | undefined;
|
|
90
|
+
|
|
91
|
+
/**
|
|
92
|
+
* The sky photograph, fetched but **not awaited**.
|
|
93
|
+
*
|
|
94
|
+
* `await`ing it here held the scene's first frame for the length of a texture decode, and the
|
|
95
|
+
* playtest bridge describes the scene before the runtime enters it: `survives` failed
|
|
96
|
+
* `TN_PLAYTEST_CAPABILITY_MISSING` on `runtime.components` because there was no `player` entity
|
|
97
|
+
* yet to describe. The scene now enters on the fallback colour and the photograph is swapped in
|
|
98
|
+
* the moment it decodes, which is also what a player sees — a sky that arrives rather than a
|
|
99
|
+
* black screen that waits.
|
|
100
|
+
*/
|
|
101
|
+
override load(ctx: GameCtx): void {
|
|
102
|
+
void ctx.assets.texture("sky.jpg").then((texture) => {
|
|
103
|
+
this.#sky = texture;
|
|
104
|
+
const scene = ctx.scene;
|
|
105
|
+
if (scene !== undefined) setupSky(scene, texture);
|
|
106
|
+
});
|
|
107
|
+
}
|
|
108
|
+
|
|
71
109
|
override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
|
|
72
|
-
setupSky(ctx.scene);
|
|
73
|
-
const
|
|
110
|
+
if (this.#sky === undefined) setupSky(ctx.scene, undefined);
|
|
111
|
+
const lighting = setupLighting(
|
|
112
|
+
ctx.scene,
|
|
113
|
+
ctx.renderer.raw as Parameters<typeof setupLighting>[1],
|
|
114
|
+
isMobile(),
|
|
115
|
+
);
|
|
74
116
|
// isMobile() arrives as an argument because src/render/ imports no framework package: the
|
|
75
117
|
// platform decision is made here, in portable game code, exactly like createRandom.
|
|
76
|
-
setupPost(ctx.renderer, ctx.scene, ctx.camera, {
|
|
118
|
+
setupPost(ctx.renderer, ctx.scene, ctx.camera, {
|
|
119
|
+
godraysLight: lighting.key,
|
|
120
|
+
mobile: isMobile(),
|
|
121
|
+
software: ctx.renderer.softwareAdapter !== undefined,
|
|
122
|
+
});
|
|
77
123
|
const loading = createLoadingScreen(ctx);
|
|
78
124
|
const camera = ctx.camera as PerspectiveCamera;
|
|
79
125
|
setupCamera(camera);
|
|
@@ -83,46 +129,43 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
83
129
|
? ctx.entities.add("touch-controls", new TouchControls(camera))
|
|
84
130
|
: undefined;
|
|
85
131
|
const track = buildTrack(ctx);
|
|
86
|
-
const car = new RacingCar(ctx, SPAWN);
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
rival.
|
|
91
|
-
ctx.
|
|
132
|
+
const car = new RacingCar(ctx, SPAWN, gridHeading("player"));
|
|
133
|
+
// The rival's own grid slot, projected onto the circuit it drives: on pole, four metres up the
|
|
134
|
+
// road and 4.4 m to the other side, facing the same way. It used to be placed a whole lap
|
|
135
|
+
// ahead and then copied onto the player's position, so the two cars were the same point in
|
|
136
|
+
// space and the player drove through a rival that had no body.
|
|
137
|
+
const rival = new Rival(ctx, GRID_DISTANCE.rival);
|
|
92
138
|
ctx.entities.add("player", car);
|
|
93
139
|
ctx.entities.add("rival", rival);
|
|
94
|
-
const flagMaterial = createMaterials().boost;
|
|
95
|
-
for (const point of [new Vector3(14, 0, -18), new Vector3(-14, 0, 18)]) {
|
|
96
|
-
const marker = flag(flagMaterial);
|
|
97
|
-
marker.position.copy(point);
|
|
98
|
-
ctx.add(marker);
|
|
99
|
-
}
|
|
100
140
|
|
|
141
|
+
// `travelDirection` is the car's **measured** velocity, not the heading it was asked for: a
|
|
142
|
+
// car that is sliding through a corner is travelling somewhere other than where it points, and
|
|
143
|
+
// a lap counted on the intent is a lap counted on a wish.
|
|
101
144
|
const lap = new Lap(
|
|
102
|
-
{ body: car.body, forward: car.travelDirection },
|
|
145
|
+
{ body: car.body.body, forward: car.travelDirection },
|
|
103
146
|
track.gates,
|
|
104
147
|
TOTAL_LAPS,
|
|
105
148
|
(completed) => emitPlaytestEvent({ entity: "player", lap: completed, name: "lap-completed" }),
|
|
106
149
|
);
|
|
107
|
-
const playerRankingInput = { id: "player", lap: lap.completed, position: car.
|
|
150
|
+
const playerRankingInput = { id: "player", lap: lap.completed, position: car.body.position };
|
|
108
151
|
const rivalRankingInput = { id: "rival", lap: rival.lap, position: rival.mesh.position };
|
|
109
152
|
const rankingInputs = [playerRankingInput, rivalRankingInput];
|
|
110
153
|
const rankingBuffer: IRankedRacerScratch[] = [];
|
|
111
154
|
const rankRace = () => {
|
|
112
155
|
playerRankingInput.lap = lap.completed;
|
|
113
156
|
rivalRankingInput.lap = rival.lap;
|
|
114
|
-
return rankRacers(
|
|
157
|
+
return rankRacers(CIRCUIT, rankingInputs, undefined, rankingBuffer);
|
|
115
158
|
};
|
|
116
159
|
const initialRanked = rankRace();
|
|
117
160
|
const initialPlayer = playerRanking(initialRanked);
|
|
118
161
|
if (initialPlayer === undefined) throw new Error("Race ranking lost the player at spawn.");
|
|
119
162
|
const fallbackProbe = roadRayProbe(track.roadMeshes);
|
|
120
163
|
const sector = new TrackSector({
|
|
121
|
-
route:
|
|
164
|
+
route: CIRCUIT,
|
|
122
165
|
intersectRay: intersectRay(ctx.physics, fallbackProbe),
|
|
123
166
|
});
|
|
124
167
|
track.boostArea.on("bodyEntered", (body) => {
|
|
125
|
-
if (body === car.body) {
|
|
168
|
+
if (body === car.body.body) {
|
|
126
169
|
car.boost.activate();
|
|
127
170
|
emitPlaytestEvent({ entity: "player", name: "boost-applied" });
|
|
128
171
|
}
|
|
@@ -131,33 +174,34 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
131
174
|
let elapsed = 0;
|
|
132
175
|
let status: RaceStatus = "RACING";
|
|
133
176
|
let rescues = 0;
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
let
|
|
177
|
+
// Before any rescue, both are the worst they can be: a car facing the wrong way, a whole lap
|
|
178
|
+
// from where it belongs. A sentinel of -1 satisfies an "at most 0.05 rad" bound before the game
|
|
179
|
+
// has done anything, which is how a bound stops being a bound.
|
|
180
|
+
let rescueHeadingError = Math.PI;
|
|
181
|
+
let rescuePositionError = Math.PI;
|
|
138
182
|
let sameDistanceRanking = initialRanked[0]?.id === "rival" ? "lap-ahead" : "lap-behind";
|
|
139
183
|
let place = initialPlayer.place;
|
|
140
184
|
let positionLabel = `P${place}`;
|
|
141
185
|
const lastOnRoad: [number, number, number] = [SPAWN.x, SPAWN.y, SPAWN.z];
|
|
142
186
|
const observedPosition = SPAWN.clone();
|
|
143
|
-
sector.update(SPAWN, car.forward, 0);
|
|
144
|
-
chaseCamera(camera, car.
|
|
187
|
+
sector.update(SPAWN, car.forward, 0, 0);
|
|
188
|
+
chaseCamera(camera, car.body.position, car.forward, 1, undefined);
|
|
145
189
|
|
|
146
190
|
const advanceRace = (frameCtx: GameCtx, dt: number): void => {
|
|
147
191
|
if (status !== "RACING") return;
|
|
148
|
-
lap.observe(observedPosition, car.
|
|
149
|
-
observedPosition.copy(car.
|
|
192
|
+
lap.observe(observedPosition, car.body.position);
|
|
193
|
+
observedPosition.copy(car.body.position);
|
|
150
194
|
car.update(
|
|
151
195
|
frameCtx,
|
|
152
196
|
dt,
|
|
153
197
|
touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size),
|
|
154
198
|
);
|
|
155
199
|
rival.update(dt);
|
|
156
|
-
sector.update(car.
|
|
200
|
+
sector.update(car.body.position, car.forward, dt, car.speed);
|
|
157
201
|
if (sector.rescue(car)) {
|
|
158
202
|
rescues += 1;
|
|
159
203
|
rescuePositionError = quantize(
|
|
160
|
-
car.
|
|
204
|
+
car.body.position.distanceTo(sector.lastOnRoadPosition),
|
|
161
205
|
10_000,
|
|
162
206
|
);
|
|
163
207
|
rescueHeadingError = quantize(car.forward.angleTo(sector.lastOnRoadHeading), 10_000);
|
|
@@ -168,6 +212,23 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
168
212
|
|
|
169
213
|
const statePatch: Partial<GameState> = {};
|
|
170
214
|
|
|
215
|
+
// The suspension and the camera both read the **solved** chassis, so they run in the
|
|
216
|
+
// afterPhysics phase rather than in the scene frame: a wheel's spin angle and a car's velocity
|
|
217
|
+
// are last step's numbers until the step after this one.
|
|
218
|
+
//
|
|
219
|
+
// The sun's shadow camera follows the car. It used to be a fixed 30 m box around the origin,
|
|
220
|
+
// which on an 830 m circuit put every shadow on the grass and left the car's own shadow — the
|
|
221
|
+
// speed cue a driver actually reads — somewhere else entirely.
|
|
222
|
+
afterPhysics(ctx, (dt) => {
|
|
223
|
+
car.body.settleVisuals();
|
|
224
|
+
rival.car.settleVisuals();
|
|
225
|
+
lighting.key.target.position.copy(car.body.position);
|
|
226
|
+
lighting.key.position.copy(car.body.position).addScaledVector(SUN_DIRECTION, 90);
|
|
227
|
+
const solved = car.body.body.linearVelocity;
|
|
228
|
+
chaseCamera(camera, car.body.position, car.travelDirection, dt, solved);
|
|
229
|
+
camera.rotateZ(cameraBank(car.lateralLoad, FEEL.lateral));
|
|
230
|
+
});
|
|
231
|
+
|
|
171
232
|
return (frameCtx, dt) => {
|
|
172
233
|
loading.update();
|
|
173
234
|
if (frameCtx.input.justPressed("restart")) {
|
|
@@ -178,13 +239,6 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
178
239
|
}
|
|
179
240
|
elapsed += dt;
|
|
180
241
|
advanceRace(frameCtx, dt);
|
|
181
|
-
if (!car.boost.active && car.boost.uses > 0 && !boostSettled) {
|
|
182
|
-
const settledSpeed = car.speedAfterBoost();
|
|
183
|
-
if (Math.abs(settledSpeed - RACING_FEEL.maxSpeed) < 0.001) {
|
|
184
|
-
speedAfterBoost = settledSpeed;
|
|
185
|
-
boostSettled = true;
|
|
186
|
-
}
|
|
187
|
-
}
|
|
188
242
|
const ranked = rankRace();
|
|
189
243
|
const player = playerRanking(ranked);
|
|
190
244
|
if (player === undefined) throw new Error("Race ranking lost the player.");
|
|
@@ -195,11 +249,12 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
195
249
|
positionLabel = `P${place}`;
|
|
196
250
|
}
|
|
197
251
|
const previous = frameCtx.state.getState();
|
|
198
|
-
const boostPeakSpeed = Math.max(previous.boostPeakSpeed, car.
|
|
252
|
+
const boostPeakSpeed = Math.max(previous.boostPeakSpeed, car.boosting ? car.speed : 0);
|
|
199
253
|
lastOnRoad[0] = sector.lastOnRoadPosition.x;
|
|
200
254
|
lastOnRoad[1] = sector.lastOnRoadPosition.y;
|
|
201
255
|
lastOnRoad[2] = sector.lastOnRoadPosition.z;
|
|
202
|
-
statePatch.
|
|
256
|
+
statePatch.autopilot = car.autopilotEngaged;
|
|
257
|
+
statePatch.boostActive = car.boosting;
|
|
203
258
|
statePatch.boostPeakSpeed = boostPeakSpeed;
|
|
204
259
|
statePatch.boostUses = car.boost.uses;
|
|
205
260
|
statePatch.completedLaps = lap.completed;
|
|
@@ -214,14 +269,12 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
214
269
|
statePatch.rescues = rescues;
|
|
215
270
|
statePatch.shortcutRejects = lap.shortcutRejects;
|
|
216
271
|
statePatch.speed = car.speed;
|
|
217
|
-
statePatch.speedAfterBoost = speedAfterBoost;
|
|
272
|
+
statePatch.speedAfterBoost = car.speedAfterBoost();
|
|
218
273
|
statePatch.sameDistanceRanking = sameDistanceRanking;
|
|
219
274
|
statePatch.topSpeed = Math.max(previous.topSpeed, car.topSpeed);
|
|
220
275
|
statePatch.trackProgress = player.routeProgress;
|
|
221
276
|
statePatch.reverseRejects = lap.reverseRejects;
|
|
222
277
|
frameCtx.state.set(statePatch);
|
|
223
|
-
chaseCamera(camera, car.mesh.position, car.forward, dt);
|
|
224
|
-
cameraRoll(camera, car.forward);
|
|
225
278
|
};
|
|
226
279
|
}
|
|
227
280
|
}
|
|
@@ -11,6 +11,8 @@ export function resolveRaceStatus(
|
|
|
11
11
|
}
|
|
12
12
|
|
|
13
13
|
export type GameState = {
|
|
14
|
+
/** True while the closed-loop demo driver has the wheel. A scenario asserts it drove. */
|
|
15
|
+
autopilot: boolean;
|
|
14
16
|
/** Set from the UI\'s pause and resume intents, and read back by the menu. */
|
|
15
17
|
paused: boolean;
|
|
16
18
|
/** True once the UI layer has rendered and published its interactive rectangles. */
|
|
@@ -1,19 +1,34 @@
|
|
|
1
|
-
import
|
|
2
|
-
import type { Vector3 } from "three";
|
|
1
|
+
import { Vector3 } from "three";
|
|
3
2
|
|
|
4
|
-
export type ChecklineId = "finish" | "
|
|
3
|
+
export type ChecklineId = "finish" | "sector-1" | "sector-2";
|
|
5
4
|
|
|
6
|
-
/**
|
|
5
|
+
/**
|
|
6
|
+
* A line drawn across the road, and where the car crossed it.
|
|
7
|
+
*
|
|
8
|
+
* `at` and `forward` describe the line; `across` and `halfWidth` are what stop it being an infinite
|
|
9
|
+
* plane. The sector-2 gate's plane is `x = 117`, and the main straight runs along `x` from 25 to
|
|
10
|
+
* 195, so an unbounded test rejects the main straight for crossing a gate that is three hundred
|
|
11
|
+
* metres away up the circuit. Measured: that one false crossing was the reverse rejection the
|
|
12
|
+
* `reverse` playtest used to read on a car driving forwards.
|
|
13
|
+
*
|
|
14
|
+
* There is no sensor here. `Lap` counts a crossing by sweeping the car's transform between frames,
|
|
15
|
+
* which sees every crossing exactly once, and an `Area3D` reports the same crossing a second time
|
|
16
|
+
* as the car's collider touches the gate's box — most of a metre before the plane. Two mechanisms
|
|
17
|
+
* counting one event is how a clean lap raised a `shortcutReject` at every gate.
|
|
18
|
+
*/
|
|
7
19
|
export class Checkline {
|
|
8
20
|
readonly at: Vector3;
|
|
9
|
-
readonly area: Area3D;
|
|
10
21
|
readonly forward: Vector3;
|
|
22
|
+
/** The direction across the road, so a crossing is only a crossing where the line is drawn. */
|
|
23
|
+
readonly across: Vector3;
|
|
24
|
+
readonly halfWidth: number;
|
|
11
25
|
readonly id: ChecklineId;
|
|
12
26
|
|
|
13
|
-
constructor(id: ChecklineId, at: Vector3, forward: Vector3,
|
|
27
|
+
constructor(id: ChecklineId, at: Vector3, forward: Vector3, halfWidth: number) {
|
|
14
28
|
this.id = id;
|
|
15
29
|
this.at = at.clone();
|
|
16
30
|
this.forward = forward.clone().setY(0).normalize();
|
|
17
|
-
this.
|
|
31
|
+
this.across = new Vector3(-this.forward.z, 0, this.forward.x);
|
|
32
|
+
this.halfWidth = halfWidth;
|
|
18
33
|
}
|
|
19
34
|
}
|