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,28 +1,249 @@
|
|
|
1
|
-
// Generated for you
|
|
1
|
+
// Generated for you. The car's livery and the circuit's surfaces. ThreeNative does not read this
|
|
2
2
|
// file, and nothing in `shapes.ts` names a colour — it only names these slots. Re-livery the car,
|
|
3
3
|
// or repaint the circuit, entirely from here.
|
|
4
|
-
|
|
4
|
+
//
|
|
5
|
+
// The look is a real circuit's: dark grey asphalt with a fine grain and a darker rubber band down
|
|
6
|
+
// the racing line, white edge lines, red and white kerbing, green grass with a slow variation, and
|
|
7
|
+
// one saturated colour for the things a driver is meant to react to. The asphalt and the grass are
|
|
8
|
+
// built from bytes rather than shipped as files, so they cost nothing to load and run the same in
|
|
9
|
+
// the browser and in the native host.
|
|
10
|
+
import {
|
|
11
|
+
type BufferGeometry,
|
|
12
|
+
DataTexture,
|
|
13
|
+
Float32BufferAttribute,
|
|
14
|
+
LinearMipmapLinearFilter,
|
|
15
|
+
MeshStandardMaterial,
|
|
16
|
+
RepeatWrapping,
|
|
17
|
+
SRGBColorSpace,
|
|
18
|
+
Vector2,
|
|
19
|
+
Vector3,
|
|
20
|
+
} from "three";
|
|
5
21
|
import { palette, toon } from "./palette.js";
|
|
6
22
|
|
|
23
|
+
/** Deterministic per-texel noise, so two captures of the same build look the same. */
|
|
24
|
+
function noise(x: number, y: number, seed: number): number {
|
|
25
|
+
let state = (x * 73856093) ^ (y * 19349663) ^ (seed * 83492791);
|
|
26
|
+
state = (state ^ (state >>> 13)) >>> 0;
|
|
27
|
+
state = (state * 1274126177) >>> 0;
|
|
28
|
+
return ((state ^ (state >>> 16)) >>> 0) / 4294967295;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** Smoothstep, so the rubber band has a soft edge instead of a stripe painted across the road. */
|
|
32
|
+
function falloff(value: number, edge: number): number {
|
|
33
|
+
const t = Math.min(Math.max((Math.abs(value) - edge) / 0.28, 0), 1);
|
|
34
|
+
return t * t * (3 - 2 * t);
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
function rgbaTexture(
|
|
38
|
+
size: number,
|
|
39
|
+
shade: (x: number, y: number) => [number, number, number],
|
|
40
|
+
): DataTexture {
|
|
41
|
+
const data = new Uint8Array(size * size * 4);
|
|
42
|
+
for (let y = 0; y < size; y += 1) {
|
|
43
|
+
for (let x = 0; x < size; x += 1) {
|
|
44
|
+
const [r, g, b] = shade(x / size, y / size);
|
|
45
|
+
const at = (y * size + x) * 4;
|
|
46
|
+
data[at] = r;
|
|
47
|
+
data[at + 1] = g;
|
|
48
|
+
data[at + 2] = b;
|
|
49
|
+
data[at + 3] = 255;
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
const texture = new DataTexture(data, size, size);
|
|
53
|
+
texture.colorSpace = SRGBColorSpace;
|
|
54
|
+
texture.wrapS = RepeatWrapping;
|
|
55
|
+
texture.wrapT = RepeatWrapping;
|
|
56
|
+
texture.generateMipmaps = true;
|
|
57
|
+
texture.minFilter = LinearMipmapLinearFilter;
|
|
58
|
+
texture.anisotropy = 16;
|
|
59
|
+
texture.needsUpdate = true;
|
|
60
|
+
return texture;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* Asphalt: mid-dark grey, a fine per-texel grain, and a darker band down the middle where every
|
|
65
|
+
* car lays rubber. The band is the thing that makes a road read as a **racing** surface rather
|
|
66
|
+
* than a grey plane — it also tells the player where the line is without a single word of UI.
|
|
67
|
+
*/
|
|
68
|
+
const asphalt = rgbaTexture(256, (u, v) => {
|
|
69
|
+
const grain = (noise(Math.floor(u * 256), Math.floor(v * 256), 11) - 0.5) * 26;
|
|
70
|
+
const rubber = 1 - 0.34 * falloff(u - 0.5, 0.16);
|
|
71
|
+
const shoulder = 1 + 0.1 * falloff(u - 0.5, 0.42);
|
|
72
|
+
// No term here may depend on `v` except through `grain`: the road tiles this image every 8 m of
|
|
73
|
+
// travel, and a v-dependent brightness curve (there used to be one, `sin(u*9.1+v*3.7)`) does not
|
|
74
|
+
// return to its own start at v=1, so every tile boundary was a visible seam — a hard band across
|
|
75
|
+
// the whole road width, every 8 m, the length of the circuit. `grain` is safe: it is per-texel
|
|
76
|
+
// hashed noise with no trend across the tile, so its wrap seam is invisible in the noise floor.
|
|
77
|
+
const base = 74 * rubber * shoulder + grain;
|
|
78
|
+
return [base, base * 1.01, base * 1.05];
|
|
79
|
+
});
|
|
80
|
+
|
|
81
|
+
/** The run-off: the same asphalt, laid down lighter and dustier, and coarser. */
|
|
82
|
+
const apron = rgbaTexture(128, (u, v) => {
|
|
83
|
+
const grain = (noise(Math.floor(u * 128), Math.floor(v * 128), 29) - 0.5) * 34;
|
|
84
|
+
const base = 116 + grain;
|
|
85
|
+
return [base, base * 0.99, base * 0.96];
|
|
86
|
+
});
|
|
87
|
+
|
|
88
|
+
/** Grass: two greens mottled over a slow noise, so a hillside is not one flat colour. */
|
|
89
|
+
const turf = rgbaTexture(128, (u, v) => {
|
|
90
|
+
const coarse = noise(Math.floor(u * 9), Math.floor(v * 9), 5);
|
|
91
|
+
const fine = (noise(Math.floor(u * 128), Math.floor(v * 128), 7) - 0.5) * 20;
|
|
92
|
+
const base = 0.7 + coarse * 0.5;
|
|
93
|
+
return [52 * base + fine, 92 * base + fine * 1.4, 46 * base + fine];
|
|
94
|
+
});
|
|
95
|
+
|
|
96
|
+
/** Red and white, one stripe per 1.2 m of kerb. Two texels wide, so it tiles in both axes. */
|
|
97
|
+
const kerbStripe = rgbaTexture(2, (u) => (u < 0.5 ? [216, 58, 48] : [242, 240, 230]));
|
|
98
|
+
|
|
99
|
+
/** Black and white, a 4x2 checker. The one transverse mark the road is meant to carry. */
|
|
100
|
+
const checker = rgbaTexture(8, (u, v) => {
|
|
101
|
+
const on = (Math.floor(u * 4) + Math.floor(v * 2)) % 2 === 0;
|
|
102
|
+
return on ? [235, 233, 224] : [18, 18, 20];
|
|
103
|
+
});
|
|
104
|
+
|
|
105
|
+
/** A faint cast-concrete grain as a tangent-space normal map, tiling every metre. */
|
|
106
|
+
function grainNormalTexture(size = 128): DataTexture {
|
|
107
|
+
const cells = [8, 32];
|
|
108
|
+
const lattice = cells.map((count) => {
|
|
109
|
+
const values = new Float32Array(count * count);
|
|
110
|
+
for (let index = 0; index < values.length; index += 1)
|
|
111
|
+
values[index] = noise(index, count, count);
|
|
112
|
+
return { count, values };
|
|
113
|
+
});
|
|
114
|
+
const height = (x: number, y: number): number => {
|
|
115
|
+
let total = 0;
|
|
116
|
+
for (const [octave, { count, values }] of lattice.entries()) {
|
|
117
|
+
const u = (x / size) * count;
|
|
118
|
+
const v = (y / size) * count;
|
|
119
|
+
const x0 = Math.floor(u);
|
|
120
|
+
const y0 = Math.floor(v);
|
|
121
|
+
const fx = u - x0;
|
|
122
|
+
const fy = v - y0;
|
|
123
|
+
const sx = fx * fx * (3 - 2 * fx);
|
|
124
|
+
const sy = fy * fy * (3 - 2 * fy);
|
|
125
|
+
const at = (i: number, j: number): number =>
|
|
126
|
+
values[(((j % count) + count) % count) * count + (((i % count) + count) % count)] ?? 0;
|
|
127
|
+
const top = at(x0, y0) + (at(x0 + 1, y0) - at(x0, y0)) * sx;
|
|
128
|
+
const bottom = at(x0, y0 + 1) + (at(x0 + 1, y0 + 1) - at(x0, y0 + 1)) * sx;
|
|
129
|
+
total += (top + (bottom - top) * sy) * (octave === 0 ? 1 : 0.5);
|
|
130
|
+
}
|
|
131
|
+
return total;
|
|
132
|
+
};
|
|
133
|
+
const data = new Uint8Array(size * size * 4);
|
|
134
|
+
const normal = new Vector3();
|
|
135
|
+
for (let y = 0; y < size; y += 1) {
|
|
136
|
+
for (let x = 0; x < size; x += 1) {
|
|
137
|
+
const dx = height(x + 1, y) - height(x - 1, y);
|
|
138
|
+
const dy = height(x, y + 1) - height(x, y - 1);
|
|
139
|
+
normal.set(-dx * 4, -dy * 4, 1).normalize();
|
|
140
|
+
const at = (y * size + x) * 4;
|
|
141
|
+
data[at] = Math.round((normal.x * 0.5 + 0.5) * 255);
|
|
142
|
+
data[at + 1] = Math.round((normal.y * 0.5 + 0.5) * 255);
|
|
143
|
+
data[at + 2] = Math.round((normal.z * 0.5 + 0.5) * 255);
|
|
144
|
+
data[at + 3] = 255;
|
|
145
|
+
}
|
|
146
|
+
}
|
|
147
|
+
const texture = new DataTexture(data, size, size);
|
|
148
|
+
texture.wrapS = RepeatWrapping;
|
|
149
|
+
texture.wrapT = RepeatWrapping;
|
|
150
|
+
texture.generateMipmaps = true;
|
|
151
|
+
texture.minFilter = LinearMipmapLinearFilter;
|
|
152
|
+
texture.needsUpdate = true;
|
|
153
|
+
return texture;
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
const grain = grainNormalTexture();
|
|
157
|
+
|
|
158
|
+
/**
|
|
159
|
+
* Rewrites a geometry's UVs as world metres, projected along each face's dominant axis.
|
|
160
|
+
* Call it after the geometry is translated into place (merged geometry included).
|
|
161
|
+
*/
|
|
162
|
+
export function worldGridUVs<T extends BufferGeometry>(geometry: T): T {
|
|
163
|
+
const position = geometry.getAttribute("position");
|
|
164
|
+
const normal = geometry.getAttribute("normal");
|
|
165
|
+
const uv = new Float32Array(position.count * 2);
|
|
166
|
+
const axis = new Vector3();
|
|
167
|
+
for (let index = 0; index < position.count; index += 1) {
|
|
168
|
+
axis.fromBufferAttribute(normal, index);
|
|
169
|
+
const x = position.getX(index);
|
|
170
|
+
const y = position.getY(index);
|
|
171
|
+
const z = position.getZ(index);
|
|
172
|
+
const ax = Math.abs(axis.x);
|
|
173
|
+
const ay = Math.abs(axis.y);
|
|
174
|
+
const az = Math.abs(axis.z);
|
|
175
|
+
const [u, v] = ay >= ax && ay >= az ? [x, z] : ax >= az ? [z, y] : [x, y];
|
|
176
|
+
uv[index * 2] = u;
|
|
177
|
+
uv[index * 2 + 1] = v;
|
|
178
|
+
}
|
|
179
|
+
geometry.setAttribute("uv", new Float32BufferAttribute(uv, 2));
|
|
180
|
+
return geometry;
|
|
181
|
+
}
|
|
182
|
+
|
|
7
183
|
export function createMaterials() {
|
|
8
184
|
return {
|
|
9
|
-
/** Boost chevrons and the
|
|
185
|
+
/** Boost chevrons and the start lights' housing. */
|
|
10
186
|
boost: toon(palette.accent, 0.4),
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
/**
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
187
|
+
/** Painted white: the edge lines, the pit-lane line, the grandstand seats. */
|
|
188
|
+
line: new MeshStandardMaterial({ color: 0xf1efe6, roughness: 0.7, metalness: 0 }),
|
|
189
|
+
/** The kerb's red stripe. */
|
|
190
|
+
kerbAlt: toon(0xd8453c, 0.5),
|
|
191
|
+
/** The kerb's white stripe, and the one place the tarmac is allowed to be bright. */
|
|
192
|
+
curb: toon(0xf2f0e6, 0.5),
|
|
193
|
+
/** The finish line and the grid-slot marks: the one transverse pattern the road carries. */
|
|
194
|
+
checker: new MeshStandardMaterial({ map: checker, roughness: 0.75, metalness: 0 }),
|
|
195
|
+
/** Red and white, striped by its own texture, so the whole circuit's kerbing is one draw. */
|
|
196
|
+
kerb: new MeshStandardMaterial({
|
|
197
|
+
map: kerbStripe,
|
|
198
|
+
normalMap: grain,
|
|
199
|
+
normalScale: new Vector2(0.1, 0.1),
|
|
200
|
+
roughness: 0.62,
|
|
201
|
+
metalness: 0.02,
|
|
202
|
+
}),
|
|
203
|
+
/** The infield and everything beyond the run-off. */
|
|
204
|
+
grass: new MeshStandardMaterial({
|
|
205
|
+
map: turf,
|
|
206
|
+
normalMap: grain,
|
|
207
|
+
normalScale: new Vector2(0.35, 0.35),
|
|
208
|
+
roughness: 0.95,
|
|
209
|
+
metalness: 0,
|
|
210
|
+
}),
|
|
211
|
+
/** The paved run-off past the white line, and the pit lane. */
|
|
212
|
+
runoff: new MeshStandardMaterial({
|
|
213
|
+
map: apron,
|
|
214
|
+
normalMap: grain,
|
|
215
|
+
normalScale: new Vector2(0.16, 0.16),
|
|
216
|
+
roughness: 0.88,
|
|
217
|
+
metalness: 0.03,
|
|
218
|
+
}),
|
|
219
|
+
/** Grandstands, hoardings, gantries, garages, marshal posts. */
|
|
220
|
+
structure: new MeshStandardMaterial({
|
|
221
|
+
map: apron,
|
|
222
|
+
normalMap: grain,
|
|
223
|
+
normalScale: new Vector2(0.18, 0.18),
|
|
224
|
+
color: 0x9aa0a6,
|
|
225
|
+
roughness: 0.72,
|
|
226
|
+
metalness: 0.05,
|
|
227
|
+
}),
|
|
228
|
+
/** Armco and the pit wall: galvanised steel, so they catch the sun and read as metal. */
|
|
229
|
+
armco: new MeshStandardMaterial({
|
|
230
|
+
color: 0xb4bcc4,
|
|
231
|
+
metalness: 0.72,
|
|
232
|
+
roughness: 0.42,
|
|
233
|
+
}),
|
|
234
|
+
road: new MeshStandardMaterial({
|
|
235
|
+
color: 0x4a4a4a,
|
|
236
|
+
roughness: 0.86,
|
|
237
|
+
metalness: 0.04,
|
|
238
|
+
}),
|
|
239
|
+
shadow: new MeshStandardMaterial({ color: 0x4a4f55, roughness: 1 }),
|
|
19
240
|
tire: new MeshStandardMaterial({ color: 0x1a1d22, roughness: 0.94 }),
|
|
20
241
|
|
|
21
242
|
/** The car. `body` is the one a game is most likely to change. */
|
|
22
243
|
body: new MeshStandardMaterial({ color: 0xd93a3a, metalness: 0.18, roughness: 0.3 }),
|
|
23
244
|
/** Kept as an alias so a game that already referred to the old slot still compiles. */
|
|
24
245
|
vehicle: new MeshStandardMaterial({ color: 0xd93a3a, metalness: 0.18, roughness: 0.3 }),
|
|
25
|
-
rivalBody: new MeshStandardMaterial({ color:
|
|
246
|
+
rivalBody: new MeshStandardMaterial({ color: palette.accent, metalness: 0.18, roughness: 0.3 }),
|
|
26
247
|
glass: new MeshStandardMaterial({
|
|
27
248
|
color: 0x3f5a70,
|
|
28
249
|
metalness: 0.55,
|
|
@@ -53,13 +274,12 @@ export function createMaterials() {
|
|
|
53
274
|
roughness: 0.34,
|
|
54
275
|
}),
|
|
55
276
|
|
|
56
|
-
/** Trackside furniture. */
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
canopy: toon(0x3f7a44, 0.92),
|
|
277
|
+
/** Trackside furniture that is instanced, so it takes a flat value rather than a mapped grid. */
|
|
278
|
+
crowd: toon(0x6f7681, 0.9),
|
|
279
|
+
trunk: toon(0x5b4a3c, 0.9),
|
|
280
|
+
canopy: toon(0x3f6a45, 0.92),
|
|
61
281
|
/** The hills past the treeline. */
|
|
62
|
-
distant: toon(
|
|
63
|
-
hoardingBoard: toon(
|
|
282
|
+
distant: toon(0x6d7a80, 0.98),
|
|
283
|
+
hoardingBoard: toon(palette.accent, 0.6),
|
|
64
284
|
};
|
|
65
285
|
}
|
|
@@ -1,31 +1,29 @@
|
|
|
1
1
|
// Generated for you: every colour the race uses, in one place. ThreeNative does not read this file.
|
|
2
2
|
//
|
|
3
|
-
//
|
|
4
|
-
//
|
|
5
|
-
//
|
|
6
|
-
//
|
|
7
|
-
//
|
|
3
|
+
// Six named roles, and only one of them is saturated. That is the whole rule: a track read at
|
|
4
|
+
// speed is a grey circuit, a grey sky and one colour that means *this is the thing you are here
|
|
5
|
+
// for* — the rival's nose, the boost chevrons, the finish banner. Every other surface is a value
|
|
6
|
+
// on the same neutral ramp, so the eye goes to the racing, not to the paint job.
|
|
7
|
+
//
|
|
8
|
+
// The two `sky*` roles are the loading screen's backdrop and progress track (`loading.ts` reads
|
|
9
|
+
// them by name); `horizon` is the photographed sky's own haze, which is what distance fades into.
|
|
8
10
|
import { BoxGeometry, Group, Mesh, MeshStandardMaterial } from "three";
|
|
9
11
|
|
|
10
12
|
export const palette = {
|
|
11
|
-
/**
|
|
12
|
-
|
|
13
|
-
/**
|
|
14
|
-
|
|
15
|
-
/**
|
|
16
|
-
|
|
17
|
-
/**
|
|
18
|
-
|
|
19
|
-
/**
|
|
20
|
-
|
|
21
|
-
/**
|
|
22
|
-
|
|
13
|
+
/** Loading screen backdrop. */
|
|
14
|
+
skyLow: 0xb8bcc2,
|
|
15
|
+
/** Loading screen progress track. */
|
|
16
|
+
skyHigh: 0x2f3640,
|
|
17
|
+
/** The sky photograph's own horizon: distance fades into this rather than into grey. */
|
|
18
|
+
horizon: 0xacb1c1,
|
|
19
|
+
/** Light grid: the run-off apron and the infield, so the ground reads as a measured surface. */
|
|
20
|
+
floor: 0xb4b1ae,
|
|
21
|
+
/** Dark grid: grandstands, hoardings, tyre walls, the treeline. */
|
|
22
|
+
structure: 0x747578,
|
|
23
|
+
/** The one saturated colour: the rival, the boost, the finish banner, a held touch control. */
|
|
24
|
+
accent: 0x2a6cf0,
|
|
23
25
|
} as const;
|
|
24
26
|
|
|
25
|
-
// The circuit's other surfaces are shades of the six roles above rather than roles of their own:
|
|
26
|
-
// the palette stays six named colours, and anything derived belongs beside the material that uses
|
|
27
|
-
// it. `materials.ts` owns them.
|
|
28
|
-
|
|
29
27
|
const materials = new Map<string, MeshStandardMaterial>();
|
|
30
28
|
|
|
31
29
|
export function toon(color: number, roughness = 0.72): MeshStandardMaterial {
|
|
@@ -22,13 +22,23 @@ export function setupPost(
|
|
|
22
22
|
environment: {
|
|
23
23
|
godraysLight?: DirectionalLight;
|
|
24
24
|
mobile?: boolean;
|
|
25
|
+
/** The renderer named a software adapter; this game's answer is its `low` tier. */
|
|
26
|
+
software?: boolean;
|
|
25
27
|
/** Forces a tier, ignoring `mobile`. An unknown name throws rather than falling back. */
|
|
26
28
|
tier?: QualityTier;
|
|
27
29
|
} = {},
|
|
28
30
|
): void {
|
|
29
|
-
const tier = resolveQualityTier({
|
|
31
|
+
const tier = resolveQualityTier({
|
|
32
|
+
mobile: environment.mobile,
|
|
33
|
+
software: environment.software,
|
|
34
|
+
tier: environment.tier,
|
|
35
|
+
});
|
|
30
36
|
const source = environment.tier === undefined ? "platform" : "override";
|
|
31
|
-
console.info(
|
|
37
|
+
console.info(
|
|
38
|
+
`TN_QUALITY_TIER ${tier} mobile=${environment.mobile === true} software=${
|
|
39
|
+
environment.software === true
|
|
40
|
+
} source=${source}`,
|
|
41
|
+
);
|
|
32
42
|
const world = new WorldEnvironment(qualityPreset(tier));
|
|
33
43
|
world.apply(renderer, scene, camera, { godraysLight: environment.godraysLight });
|
|
34
44
|
}
|
|
@@ -19,6 +19,15 @@
|
|
|
19
19
|
// probe on `scene.environment`, measured at **~6.3 ms of an 18-19 ms Pixel 8 frame**. It is set
|
|
20
20
|
// in `sky.ts`, not in this file.
|
|
21
21
|
//
|
|
22
|
+
// **This template runs no SSGI, SSR or sharpen at any tier, and that is a measurement rather than
|
|
23
|
+
// a taste.** A race is a moving camera over grey tarmac: nothing in the frame is glossy enough for
|
|
24
|
+
// a reflection to read as one, and a gather this large only pays off on surfaces that bounce light
|
|
25
|
+
// into each other — of which a circuit has none. What a track does need is occlusion (the dark
|
|
26
|
+
// line where a tyre meets tarmac is most of what says the car is *on* the road) and bloom for the
|
|
27
|
+
// sun and the tail lights. The bounded proof is `playtests/performance.playtest.json`: it holds the
|
|
28
|
+
// frame at 33 ms p95 and 30 fps, so if you turn a stage on, that scenario is what tells you it was
|
|
29
|
+
// worth it. Both are one line to turn back on.
|
|
30
|
+
|
|
22
31
|
import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
|
|
23
32
|
|
|
24
33
|
/**
|
|
@@ -49,7 +58,7 @@ function isQualityTier(value: string): value is QualityTier {
|
|
|
49
58
|
* turned out to have no effect.
|
|
50
59
|
*/
|
|
51
60
|
export function resolveQualityTier(
|
|
52
|
-
request: { readonly mobile?: boolean; readonly tier?: string } = {},
|
|
61
|
+
request: { readonly mobile?: boolean; readonly software?: boolean; readonly tier?: string } = {},
|
|
53
62
|
): QualityTier {
|
|
54
63
|
const requested = request.tier;
|
|
55
64
|
if (requested !== undefined) {
|
|
@@ -60,101 +69,53 @@ export function resolveQualityTier(
|
|
|
60
69
|
}
|
|
61
70
|
return requested;
|
|
62
71
|
}
|
|
72
|
+
// A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
|
|
73
|
+
// game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
|
|
74
|
+
// drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
|
|
75
|
+
// fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
|
|
76
|
+
// `tier` above still wins over it.
|
|
77
|
+
if (request.software === true) return "low";
|
|
63
78
|
return request.mobile === true ? "low" : "high";
|
|
64
79
|
}
|
|
65
80
|
|
|
66
81
|
/**
|
|
67
|
-
*
|
|
82
|
+
* The look every tier shares: a wide, faint glow on what is genuinely brighter than white — the sun
|
|
83
|
+
* disk, the visor — rather than a haze over the frame (a threshold under 1 blooms lit grey walls and
|
|
84
|
+
* flattens contrast), and a corner falloff. Antialiasing is on in every tier that installs a chain;
|
|
85
|
+
* see `screenSpaceAA` in `worldEnvironment.ts`.
|
|
68
86
|
*
|
|
69
|
-
*
|
|
70
|
-
*
|
|
87
|
+
* No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
|
|
88
|
+
* captured sky (`sky.ts`), and SSR on rough tarmac traced speckle into the road; RCAS then rang the
|
|
89
|
+
* smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
|
|
71
90
|
*/
|
|
72
|
-
const
|
|
73
|
-
//
|
|
74
|
-
// Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
|
|
75
|
-
// to be.
|
|
91
|
+
const shared: IWorldEnvironmentOptions = {
|
|
92
|
+
// Bloom: ~4.6 ms in the reference ablation — the second most expensive stage there.
|
|
76
93
|
bloomEnabled: true,
|
|
77
|
-
bloomRadius: 0.
|
|
78
|
-
bloomStrength: 0.
|
|
79
|
-
bloomThreshold:
|
|
80
|
-
exposure:
|
|
81
|
-
// The two full-resolution denoise passes over the AO and GI terms: ~1.9 ms. Only worth running
|
|
82
|
-
// when SSGI is on — its noise is what they clean up.
|
|
83
|
-
denoiseEnabled: true,
|
|
84
|
-
// SSGI, the screen-space indirect-light gather: ~7.3 ms alone, ~9.2 ms with the two denoise
|
|
85
|
-
// passes it feeds. The largest stage in the chain by a factor of two, of a 14.7 ms frame.
|
|
86
|
-
// Dropping this pair is what `medium` is.
|
|
87
|
-
ssgiEnabled: true,
|
|
88
|
-
ssgiRadius: 30,
|
|
89
|
-
ssgiQuality: "medium",
|
|
90
|
-
// Half the frame in each axis, so a quarter of the pixels. Full-res SSGI cost 14.4 ms
|
|
91
|
-
// of a 39.7 ms frame on an RTX 2080; this is the same gather over a quarter of the work,
|
|
92
|
-
// and it measured *sharper* because the scaler spends what it hands back on resolution.
|
|
93
|
-
// `worldEnvironment.ts` explains why it takes a wrapper instead of a property.
|
|
94
|
-
ssgiResolutionScale: 0.5,
|
|
95
|
-
// Screen-space reflections: ~4.1 ms.
|
|
96
|
-
ssrEnabled: true,
|
|
97
|
-
// `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
|
|
98
|
-
// are on and do nothing" — the ray dies a metre from where it started.
|
|
99
|
-
ssrMaxDistance: 75,
|
|
100
|
-
// A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
|
|
101
|
-
// the rays and is very hard to see in the result.
|
|
102
|
-
ssrResolutionScale: 0.5,
|
|
103
|
-
// RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
|
|
104
|
-
// denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
|
|
105
|
-
// that runs one of them.
|
|
106
|
-
sharpenEnabled: true,
|
|
107
|
-
// **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
|
|
108
|
-
sharpenStrength: 0.3,
|
|
94
|
+
bloomRadius: 0.55,
|
|
95
|
+
bloomStrength: 0.26,
|
|
96
|
+
bloomThreshold: 1,
|
|
97
|
+
exposure: 0.66,
|
|
109
98
|
tonemapMode: "aces",
|
|
99
|
+
vignetteAmount: 0.26,
|
|
110
100
|
};
|
|
111
101
|
|
|
112
102
|
/**
|
|
113
|
-
*
|
|
114
|
-
*
|
|
115
|
-
*
|
|
103
|
+
* What a desktop gets: contact occlusion on top — the dark line where a tyre meets the tarmac and a
|
|
104
|
+
* wing meets its own shadow, most of what separates "a car on a road" from "a car over a picture".
|
|
105
|
+
* Gathered at full resolution and denoised: at half, the upsample left a grain around every wheel.
|
|
116
106
|
*/
|
|
117
|
-
const
|
|
118
|
-
|
|
119
|
-
//
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
bloomRadius: 0.5,
|
|
123
|
-
bloomStrength: 0.35,
|
|
124
|
-
bloomThreshold: 0.2,
|
|
125
|
-
exposure: 1.18,
|
|
126
|
-
// Screen-space reflections: ~4.1 ms.
|
|
127
|
-
ssrEnabled: true,
|
|
128
|
-
// `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
|
|
129
|
-
// are on and do nothing" — the ray dies a metre from where it started.
|
|
130
|
-
ssrMaxDistance: 75,
|
|
131
|
-
// A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
|
|
132
|
-
// the rays and is very hard to see in the result.
|
|
133
|
-
ssrResolutionScale: 0.5,
|
|
134
|
-
// RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
|
|
135
|
-
// denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
|
|
136
|
-
// that runs one of them.
|
|
137
|
-
sharpenEnabled: true,
|
|
138
|
-
// **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
|
|
139
|
-
sharpenStrength: 0.3,
|
|
140
|
-
tonemapMode: "aces",
|
|
107
|
+
const high: IWorldEnvironmentOptions = {
|
|
108
|
+
...shared,
|
|
109
|
+
// GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
|
|
110
|
+
gtaoEnabled: true,
|
|
111
|
+
gtaoRadius: 0.35,
|
|
141
112
|
};
|
|
142
113
|
|
|
143
|
-
/**
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
*/
|
|
147
|
-
const low: IWorldEnvironmentOptions = {
|
|
148
|
-
// Strength, radius and threshold are a look decision already tuned to this scene's palette.
|
|
149
|
-
// Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
|
|
150
|
-
// to be.
|
|
151
|
-
bloomEnabled: true,
|
|
152
|
-
bloomRadius: 0.5,
|
|
153
|
-
bloomStrength: 0.35,
|
|
154
|
-
bloomThreshold: 0.2,
|
|
155
|
-
exposure: 1.18,
|
|
156
|
-
tonemapMode: "aces",
|
|
157
|
-
};
|
|
114
|
+
/** The rung in between: the same occlusion at half the directions. Saving unmeasured. */
|
|
115
|
+
const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8 };
|
|
116
|
+
|
|
117
|
+
/** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
|
|
118
|
+
const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
|
|
158
119
|
|
|
159
120
|
const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
|
|
160
121
|
|
|
@@ -388,7 +388,11 @@ export function vehicle(materials: Materials): Group {
|
|
|
388
388
|
}
|
|
389
389
|
|
|
390
390
|
// Running gear. Rear tyres are larger, which is both true of the class and the cheapest way to
|
|
391
|
-
// make the tail read as the driven end.
|
|
391
|
+
// make the tail read as the driven end. The four groups are **named and kept as direct children
|
|
392
|
+
// of the returned root**, because they are the suspension's only handle on the visual: a car's
|
|
393
|
+
// physics reads their own names to build `VehicleBody3D`'s wheel list (so the physics and the
|
|
394
|
+
// mesh can never disagree about which wheel is the steered one) and writes spin and steer back
|
|
395
|
+
// into them each frame.
|
|
392
396
|
for (const [x, radius] of [
|
|
393
397
|
[1.28, 0.33],
|
|
394
398
|
[-1.42, 0.37],
|
|
@@ -401,7 +405,13 @@ export function vehicle(materials: Materials): Group {
|
|
|
401
405
|
root.add(group);
|
|
402
406
|
}
|
|
403
407
|
}
|
|
404
|
-
shell
|
|
408
|
+
// The shell goes in a group of its own so the **body can lean on its suspension** while the
|
|
409
|
+
// wheels stay planted: rotating the whole root would tilt the contact patches off the road.
|
|
410
|
+
// `body.rotation` is the car's own roll and pitch; nothing else in the scene writes it.
|
|
411
|
+
const body = new Group();
|
|
412
|
+
body.name = "body";
|
|
413
|
+
shell.attachTo(body);
|
|
414
|
+
root.add(body);
|
|
405
415
|
return root;
|
|
406
416
|
}
|
|
407
417
|
|
|
@@ -485,8 +495,8 @@ export function hoardingGeometry(width = 5): {
|
|
|
485
495
|
} {
|
|
486
496
|
const frame: Mesh[] = [];
|
|
487
497
|
for (const side of [-1, 1]) {
|
|
488
|
-
const post = new Mesh(new CylinderGeometry(0.06, 0.06, 1.
|
|
489
|
-
post.position.set(0, 0.
|
|
498
|
+
const post = new Mesh(new CylinderGeometry(0.06, 0.06, 1.3, 5));
|
|
499
|
+
post.position.set(0, 0.65, (side * width) / 2.6);
|
|
490
500
|
frame.push(post);
|
|
491
501
|
}
|
|
492
502
|
const rail = new Mesh(new BoxGeometry(0.12, 0.08, width));
|
|
@@ -494,8 +504,12 @@ export function hoardingGeometry(width = 5): {
|
|
|
494
504
|
frame.push(rail);
|
|
495
505
|
// Upright, not raked. A tilt looked like a fallen board once the row was rotated to face the
|
|
496
506
|
// road, because the tilt is applied in the board's own frame and turns into a lean.
|
|
497
|
-
|
|
498
|
-
panel
|
|
507
|
+
//
|
|
508
|
+
// The panel reaches the **tarmac**. It used to float 580 mm above it, which read as a fence on
|
|
509
|
+
// legs and was worse than that: the board is the barrier's collider, so the gap underneath was a
|
|
510
|
+
// gap a car drove straight through and out of the circuit.
|
|
511
|
+
const panel = new Mesh(new BoxGeometry(0.08, 1.3, width));
|
|
512
|
+
panel.position.y = 0.65;
|
|
499
513
|
return { board: merged([panel]), frame: merged(frame) };
|
|
500
514
|
}
|
|
501
515
|
|