create-threenative 0.2.9 → 0.2.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agent-docs/references/assertion-reference.md +109 -3
- package/agent-docs/references/auto-exposure.md +28 -45
- package/agent-docs/references/build-profiles.md +1 -1
- package/agent-docs/references/capability-reference.md +527 -44
- package/agent-docs/references/debug-surface.md +64 -0
- package/agent-docs/references/finding-assets.md +11 -12
- package/agent-docs/references/performance-basics.md +19 -0
- package/agent-docs/references/trace-a-slow-frame.md +21 -0
- package/agent-docs/references/visual-baseline.md +23 -4
- package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
- package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
- package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
- package/agent-files/scripts/reference.mjs +9 -4
- package/capabilities.json +739 -50
- package/dist/index.d.ts +40 -6
- package/dist/index.js +229 -36
- package/dist/quality.d.ts +12 -0
- package/dist/quality.js +166747 -0
- package/dist/threenative.js +60 -44
- package/dist/web-engine-gltf-loader.js +2 -0
- package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
- package/dist/web-engine-mesh-bvh.js +7 -0
- package/dist/web-engine-post-effects.js +645 -19
- package/dist/web-engine-runtime.js +3528 -343
- package/package.json +19 -9
- package/template-assets/assets/bay-PROVENANCE.md +21 -0
- package/template-assets/assets/bay-ground.webp +0 -0
- package/template-assets/assets/bay-metal.webp +0 -0
- package/template-assets/assets/bay-pavement-normal.webp +0 -0
- package/template-assets/assets/bay-pavement.webp +0 -0
- package/template-assets/assets/bay-plaster-normal.webp +0 -0
- package/template-assets/assets/bay-plaster.webp +0 -0
- package/template-assets/assets/bay-wood-normal.webp +0 -0
- package/template-assets/assets/bay-wood.webp +0 -0
- package/template-assets/assets/tex-PROVENANCE.md +25 -0
- package/template-assets/assets/tex-bark-normal.webp +0 -0
- package/template-assets/assets/tex-bark.webp +0 -0
- package/template-assets/assets/tex-birch-bark.webp +0 -0
- package/template-assets/assets/tex-grass.webp +0 -0
- package/template-assets/assets/tex-planks-normal.webp +0 -0
- package/template-assets/assets/tex-planks.webp +0 -0
- package/template-assets/assets/tex-rock-normal.webp +0 -0
- package/template-assets/assets/tex-rock.webp +0 -0
- package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
- package/template-assets/assets/tex-roof-tiles.webp +0 -0
- package/template-assets/assets/tex-sand-normal.webp +0 -0
- package/template-assets/assets/tex-sand.webp +0 -0
- package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
- package/template-assets/assets/tex-stone-wall.webp +0 -0
- package/template-assets/kitExposure.ts +20 -0
- package/template-assets/patches/three@0.185.1.patch +481 -272
- package/template-assets/quality/biome.json +7 -0
- package/template-assets/quality/eslint.config.js +3 -0
- package/template-assets/realistic-ocean/README.md +113 -0
- package/template-assets/realistic-ocean/install.mjs +56 -0
- package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
- package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
- package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
- package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
- package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
- package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
- package/templates/AGENTS.md +21 -0
- package/templates/CLAUDE.md +23 -0
- package/templates/action-rpg/.codex/config.toml +6 -2
- package/templates/action-rpg/.cursor/mcp.json +8 -2
- package/templates/action-rpg/.gemini/settings.json +8 -2
- package/templates/action-rpg/.mcp.json +8 -2
- package/templates/action-rpg/.vscode/mcp.json +9 -2
- package/templates/action-rpg/.zed/settings.json +9 -2
- package/templates/action-rpg/AGENTS.md +11 -11
- package/templates/action-rpg/CLAUDE.md +11 -11
- package/templates/action-rpg/opencode.json +10 -2
- package/templates/action-rpg/package.json +17 -11
- package/templates/action-rpg/playtests/combat.playtest.json +6 -0
- package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
- package/templates/action-rpg/playtests/performance.playtest.json +1 -1
- package/templates/action-rpg/playtests/roll.playtest.json +112 -0
- package/templates/action-rpg/playtests/swing.playtest.json +55 -0
- package/templates/action-rpg/playtests/win.playtest.json +4 -4
- package/templates/action-rpg/src/entities/Fighter.ts +44 -4
- package/templates/action-rpg/src/entities/Player.ts +64 -12
- package/templates/action-rpg/src/render/atmosphere.ts +444 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
- package/templates/action-rpg/src/render/clouds.ts +605 -0
- package/templates/action-rpg/src/render/dungeon.ts +8 -6
- package/templates/action-rpg/src/render/exposure.ts +11 -109
- package/templates/action-rpg/src/render/gpuSky.ts +752 -0
- package/templates/action-rpg/src/render/lighting.ts +27 -4
- package/templates/action-rpg/src/render/materialLighting.ts +2 -11
- package/templates/action-rpg/src/render/palette.ts +1 -0
- package/templates/action-rpg/src/render/postprocessing.ts +4 -4
- package/templates/action-rpg/src/render/props.ts +10 -8
- package/templates/action-rpg/src/render/quality.ts +56 -108
- package/templates/action-rpg/src/render/sky.ts +74 -1
- package/templates/action-rpg/src/scenes/Play.ts +16 -12
- package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
- package/templates/action-rpg/src/ui/Hud.tsx +5 -7
- package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
- package/templates/action-rpg/threenative.config.ts +3 -0
- package/templates/adventure/.codex/config.toml +23 -0
- package/templates/adventure/.cursor/mcp.json +38 -0
- package/templates/adventure/.gemini/settings.json +38 -0
- package/templates/adventure/.mcp.json +38 -0
- package/templates/adventure/.vscode/mcp.json +43 -0
- package/templates/adventure/.zed/settings.json +43 -0
- package/templates/adventure/AGENTS.md +60 -0
- package/templates/adventure/CLAUDE.md +62 -0
- package/templates/adventure/index.html +14 -0
- package/templates/adventure/kit.json +8 -0
- package/templates/adventure/native-playtests/survives.playtest.json +52 -0
- package/templates/adventure/opencode.json +49 -0
- package/templates/adventure/package.json +65 -0
- package/templates/adventure/playtests/boss.playtest.json +406 -0
- package/templates/adventure/playtests/combat.playtest.json +342 -0
- package/templates/adventure/playtests/controls.playtest.json +142 -0
- package/templates/adventure/playtests/explore.playtest.json +45 -0
- package/templates/adventure/playtests/flicker.playtest.json +206 -0
- package/templates/adventure/playtests/hearts.playtest.json +171 -0
- package/templates/adventure/playtests/lockon.playtest.json +256 -0
- package/templates/adventure/playtests/look.playtest.json +72 -0
- package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
- package/templates/adventure/playtests/move.playtest.json +84 -0
- package/templates/adventure/playtests/performance.playtest.json +55 -0
- package/templates/adventure/playtests/puzzle.playtest.json +250 -0
- package/templates/adventure/playtests/stride.playtest.json +67 -0
- package/templates/adventure/playtests/survives.playtest.json +171 -0
- package/templates/adventure/playtests/thornback.playtest.json +267 -0
- package/templates/adventure/public/favicon.svg +4 -0
- package/templates/adventure/src/entities/Block.ts +114 -0
- package/templates/adventure/src/entities/Chest.ts +69 -0
- package/templates/adventure/src/entities/Door.ts +81 -0
- package/templates/adventure/src/entities/Dummy.ts +69 -0
- package/templates/adventure/src/entities/Flicker.ts +239 -0
- package/templates/adventure/src/entities/Hero.ts +561 -0
- package/templates/adventure/src/entities/LockOn.ts +180 -0
- package/templates/adventure/src/entities/Mossling.ts +249 -0
- package/templates/adventure/src/entities/Switch.ts +49 -0
- package/templates/adventure/src/entities/Thornback.ts +238 -0
- package/templates/adventure/src/entities/Warden.ts +196 -0
- package/templates/adventure/src/game.ts +65 -0
- package/templates/adventure/src/interact.ts +63 -0
- package/templates/adventure/src/level/Hollow.ts +240 -0
- package/templates/adventure/src/level/Vale.ts +383 -0
- package/templates/adventure/src/main.ts +18 -0
- package/templates/adventure/src/render/camera.ts +416 -0
- package/templates/adventure/src/render/creatures.ts +405 -0
- package/templates/adventure/src/render/effects.ts +333 -0
- package/templates/adventure/src/render/foliage.ts +1072 -0
- package/templates/adventure/src/render/hero.ts +1447 -0
- package/templates/adventure/src/render/kitExposure.ts +20 -0
- package/templates/adventure/src/render/lighting.ts +74 -0
- package/templates/adventure/src/render/loading.ts +332 -0
- package/templates/adventure/src/render/materials.ts +179 -0
- package/templates/adventure/src/render/palette.ts +137 -0
- package/templates/adventure/src/render/postprocessing.ts +70 -0
- package/templates/adventure/src/render/props.ts +383 -0
- package/templates/adventure/src/render/quality.ts +46 -0
- package/templates/adventure/src/render/sky.ts +271 -0
- package/templates/adventure/src/render/surface.ts +259 -0
- package/templates/adventure/src/render/touch-controls.ts +137 -0
- package/templates/adventure/src/scenes/Play.ts +959 -0
- package/templates/adventure/src/state.ts +113 -0
- package/templates/adventure/src/style.css +98 -0
- package/templates/adventure/src/ui/App.tsx +22 -0
- package/templates/adventure/src/ui/GameUi.tsx +20 -0
- package/templates/adventure/src/ui/Hud.tsx +70 -0
- package/templates/adventure/src/ui/Menu.tsx +15 -0
- package/templates/adventure/src/ui/main.tsx +14 -0
- package/templates/adventure/tailwind.config.ts +2 -0
- package/templates/adventure/threenative.config.ts +62 -0
- package/templates/adventure/tsconfig.json +17 -0
- package/templates/adventure/vite.config.ts +49 -0
- package/templates/collectathon/.codex/config.toml +23 -0
- package/templates/collectathon/.cursor/mcp.json +38 -0
- package/templates/collectathon/.gemini/settings.json +38 -0
- package/templates/collectathon/.mcp.json +38 -0
- package/templates/collectathon/.vscode/mcp.json +43 -0
- package/templates/collectathon/.zed/settings.json +43 -0
- package/templates/collectathon/AGENTS.md +58 -0
- package/templates/collectathon/CLAUDE.md +60 -0
- package/templates/collectathon/index.html +14 -0
- package/templates/collectathon/kit.json +8 -0
- package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
- package/templates/collectathon/opencode.json +49 -0
- package/templates/collectathon/package.json +65 -0
- package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
- package/templates/collectathon/playtests/camera.playtest.json +80 -0
- package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
- package/templates/collectathon/playtests/collect.playtest.json +196 -0
- package/templates/collectathon/playtests/combat.playtest.json +246 -0
- package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
- package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
- package/templates/collectathon/playtests/effects.playtest.json +124 -0
- package/templates/collectathon/playtests/enemies.playtest.json +295 -0
- package/templates/collectathon/playtests/explore.playtest.json +45 -0
- package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
- package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
- package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
- package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
- package/templates/collectathon/playtests/ledge.playtest.json +100 -0
- package/templates/collectathon/playtests/look.playtest.json +64 -0
- package/templates/collectathon/playtests/performance.playtest.json +55 -0
- package/templates/collectathon/playtests/stride.playtest.json +111 -0
- package/templates/collectathon/playtests/survives.playtest.json +123 -0
- package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
- package/templates/collectathon/playtests/thornback.playtest.json +157 -0
- package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
- package/templates/collectathon/playtests/win.playtest.json +166 -0
- package/templates/collectathon/public/favicon.svg +4 -0
- package/templates/collectathon/src/entities/Hero.ts +915 -0
- package/templates/collectathon/src/entities/Pickup.ts +63 -0
- package/templates/collectathon/src/entities/Walker.ts +248 -0
- package/templates/collectathon/src/game.ts +51 -0
- package/templates/collectathon/src/level/Course.ts +590 -0
- package/templates/collectathon/src/level/terrain.ts +144 -0
- package/templates/collectathon/src/main.ts +14 -0
- package/templates/collectathon/src/playtest-events.ts +15 -0
- package/templates/collectathon/src/render/camera.ts +163 -0
- package/templates/collectathon/src/render/castle.ts +408 -0
- package/templates/collectathon/src/render/effects.ts +284 -0
- package/templates/collectathon/src/render/foliage.ts +744 -0
- package/templates/collectathon/src/render/ground.ts +139 -0
- package/templates/collectathon/src/render/hero.ts +452 -0
- package/templates/collectathon/src/render/kitExposure.ts +20 -0
- package/templates/collectathon/src/render/lighting.ts +65 -0
- package/templates/collectathon/src/render/loading.ts +332 -0
- package/templates/collectathon/src/render/materials.ts +196 -0
- package/templates/collectathon/src/render/palette.ts +82 -0
- package/templates/collectathon/src/render/postprocessing.ts +79 -0
- package/templates/collectathon/src/render/props.ts +218 -0
- package/templates/collectathon/src/render/quality.ts +54 -0
- package/templates/collectathon/src/render/sky.ts +262 -0
- package/templates/collectathon/src/render/surface.ts +269 -0
- package/templates/collectathon/src/render/touch-controls.ts +179 -0
- package/templates/collectathon/src/render/touch-layout.ts +48 -0
- package/templates/collectathon/src/render/water.ts +191 -0
- package/templates/collectathon/src/scenes/Play.ts +481 -0
- package/templates/collectathon/src/state.ts +38 -0
- package/templates/collectathon/src/style.css +106 -0
- package/templates/collectathon/src/ui/App.tsx +22 -0
- package/templates/collectathon/src/ui/GameUi.tsx +20 -0
- package/templates/collectathon/src/ui/Hud.tsx +77 -0
- package/templates/collectathon/src/ui/Menu.tsx +13 -0
- package/templates/collectathon/src/ui/main.tsx +14 -0
- package/templates/collectathon/tailwind.config.ts +2 -0
- package/templates/collectathon/threenative.config.ts +62 -0
- package/templates/collectathon/tsconfig.json +17 -0
- package/templates/collectathon/vite.config.ts +49 -0
- package/templates/kart/.codex/config.toml +23 -0
- package/templates/kart/.cursor/mcp.json +38 -0
- package/templates/kart/.gemini/settings.json +38 -0
- package/templates/kart/.mcp.json +38 -0
- package/templates/kart/.vscode/mcp.json +43 -0
- package/templates/kart/.zed/settings.json +43 -0
- package/templates/kart/AGENTS.md +58 -0
- package/templates/kart/CLAUDE.md +60 -0
- package/templates/kart/index.html +14 -0
- package/templates/kart/kit.json +8 -0
- package/templates/kart/native-playtests/survives.playtest.json +65 -0
- package/templates/kart/opencode.json +49 -0
- package/templates/kart/package.json +64 -0
- package/templates/kart/playtests/drift.playtest.json +226 -0
- package/templates/kart/playtests/explore.playtest.json +45 -0
- package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
- package/templates/kart/playtests/item-key.playtest.json +108 -0
- package/templates/kart/playtests/items.playtest.json +143 -0
- package/templates/kart/playtests/lap-times.playtest.json +138 -0
- package/templates/kart/playtests/laps.playtest.json +149 -0
- package/templates/kart/playtests/performance.playtest.json +57 -0
- package/templates/kart/playtests/race.playtest.json +294 -0
- package/templates/kart/playtests/restart.playtest.json +87 -0
- package/templates/kart/playtests/rocket-start.playtest.json +56 -0
- package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
- package/templates/kart/playtests/surfaces.playtest.json +113 -0
- package/templates/kart/playtests/survives.playtest.json +116 -0
- package/templates/kart/playtests/wall.playtest.json +118 -0
- package/templates/kart/public/favicon.svg +4 -0
- package/templates/kart/src/entities/Driver.ts +123 -0
- package/templates/kart/src/entities/Items.ts +194 -0
- package/templates/kart/src/entities/Kart.ts +517 -0
- package/templates/kart/src/game.ts +45 -0
- package/templates/kart/src/main.ts +14 -0
- package/templates/kart/src/playtest-events.ts +15 -0
- package/templates/kart/src/render/camera.ts +83 -0
- package/templates/kart/src/render/course.ts +579 -0
- package/templates/kart/src/render/effects.ts +266 -0
- package/templates/kart/src/render/items.ts +163 -0
- package/templates/kart/src/render/kart.ts +256 -0
- package/templates/kart/src/render/kitExposure.ts +20 -0
- package/templates/kart/src/render/lighting.ts +58 -0
- package/templates/kart/src/render/loading.ts +332 -0
- package/templates/kart/src/render/materials.ts +119 -0
- package/templates/kart/src/render/palette.ts +74 -0
- package/templates/kart/src/render/postprocessing.ts +79 -0
- package/templates/kart/src/render/quality.ts +54 -0
- package/templates/kart/src/render/skids.ts +86 -0
- package/templates/kart/src/render/sky.ts +105 -0
- package/templates/kart/src/render/touch-controls.ts +168 -0
- package/templates/kart/src/render/touch-layout.ts +48 -0
- package/templates/kart/src/scenes/Race.ts +850 -0
- package/templates/kart/src/state.ts +53 -0
- package/templates/kart/src/style.css +106 -0
- package/templates/kart/src/track/Course.ts +276 -0
- package/templates/kart/src/track/Race.ts +133 -0
- package/templates/kart/src/ui/App.tsx +21 -0
- package/templates/kart/src/ui/GameUi.tsx +20 -0
- package/templates/kart/src/ui/Hud.tsx +172 -0
- package/templates/kart/src/ui/Menu.tsx +13 -0
- package/templates/kart/src/ui/main.tsx +14 -0
- package/templates/kart/tailwind.config.ts +2 -0
- package/templates/kart/threenative.config.ts +62 -0
- package/templates/kart/tsconfig.json +17 -0
- package/templates/kart/vite.config.ts +49 -0
- package/templates/minimal/.codex/config.toml +6 -2
- package/templates/minimal/.cursor/mcp.json +8 -2
- package/templates/minimal/.gemini/settings.json +8 -2
- package/templates/minimal/.mcp.json +8 -2
- package/templates/minimal/.vscode/mcp.json +9 -2
- package/templates/minimal/.zed/settings.json +9 -2
- package/templates/minimal/AGENTS.md +11 -13
- package/templates/minimal/CLAUDE.md +11 -13
- package/templates/minimal/opencode.json +10 -2
- package/templates/minimal/package.json +16 -10
- package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
- package/templates/minimal/playtests/jump.playtest.json +45 -0
- package/templates/minimal/playtests/play.playtest.json +1 -1
- package/templates/minimal/src/game.ts +2 -0
- package/templates/minimal/src/render/atmosphere.ts +444 -0
- package/templates/minimal/src/render/backlightMaterial.ts +49 -18
- package/templates/minimal/src/render/camera.ts +35 -4
- package/templates/minimal/src/render/clouds.ts +605 -0
- package/templates/minimal/src/render/exposure.ts +7 -111
- package/templates/minimal/src/render/gpuSky.ts +752 -0
- package/templates/minimal/src/render/lighting.ts +26 -4
- package/templates/minimal/src/render/materialLighting.ts +2 -10
- package/templates/minimal/src/render/postprocessing.ts +4 -4
- package/templates/minimal/src/render/quality.ts +10 -116
- package/templates/minimal/src/render/sky.ts +73 -1
- package/templates/minimal/src/scenes/Play.ts +18 -7
- package/templates/platformer/.codex/config.toml +6 -2
- package/templates/platformer/.cursor/mcp.json +8 -2
- package/templates/platformer/.gemini/settings.json +8 -2
- package/templates/platformer/.mcp.json +8 -2
- package/templates/platformer/.vscode/mcp.json +9 -2
- package/templates/platformer/.zed/settings.json +9 -2
- package/templates/platformer/AGENTS.md +13 -9
- package/templates/platformer/CLAUDE.md +13 -9
- package/templates/platformer/opencode.json +10 -2
- package/templates/platformer/package.json +17 -11
- package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
- package/templates/platformer/playtests/finish.playtest.json +58 -0
- package/templates/platformer/playtests/idle.playtest.json +44 -0
- package/templates/platformer/playtests/performance.playtest.json +1 -1
- package/templates/platformer/src/entities/Fox.ts +19 -6
- package/templates/platformer/src/game.ts +1 -0
- package/templates/platformer/src/level/Stage.ts +4 -1
- package/templates/platformer/src/render/backlightMaterial.ts +49 -18
- package/templates/platformer/src/render/camera.ts +30 -1
- package/templates/platformer/src/render/exposure.ts +6 -111
- package/templates/platformer/src/render/fox.ts +5 -2
- package/templates/platformer/src/render/kitExposure.ts +20 -0
- package/templates/platformer/src/render/materialLighting.ts +2 -11
- package/templates/platformer/src/render/postprocessing.ts +4 -4
- package/templates/platformer/src/render/props.ts +1 -2
- package/templates/platformer/src/render/quality.ts +10 -118
- package/templates/platformer/src/scenes/Play.ts +31 -15
- package/templates/platformer/src/ui/Menu.tsx +1 -1
- package/templates/puzzle/.codex/config.toml +6 -2
- package/templates/puzzle/.cursor/mcp.json +8 -2
- package/templates/puzzle/.gemini/settings.json +8 -2
- package/templates/puzzle/.mcp.json +8 -2
- package/templates/puzzle/.vscode/mcp.json +9 -2
- package/templates/puzzle/.zed/settings.json +9 -2
- package/templates/puzzle/AGENTS.md +14 -17
- package/templates/puzzle/CLAUDE.md +14 -17
- package/templates/puzzle/opencode.json +10 -2
- package/templates/puzzle/package.json +17 -11
- package/templates/puzzle/playtests/performance.playtest.json +1 -1
- package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
- package/templates/puzzle/src/render/exposure.ts +11 -109
- package/templates/puzzle/src/render/lighting.ts +3 -3
- package/templates/puzzle/src/render/materialLighting.ts +2 -11
- package/templates/puzzle/src/render/palette.ts +1 -1
- package/templates/puzzle/src/render/postprocessing.ts +4 -4
- package/templates/puzzle/src/render/quality.ts +44 -153
- package/templates/puzzle/src/render/vault.ts +18 -6
- package/templates/puzzle/src/scenes/Play.ts +6 -1
- package/templates/puzzle/src/ui/Hud.tsx +8 -43
- package/templates/racing/.codex/config.toml +6 -2
- package/templates/racing/.cursor/mcp.json +8 -2
- package/templates/racing/.gemini/settings.json +8 -2
- package/templates/racing/.mcp.json +8 -2
- package/templates/racing/.vscode/mcp.json +9 -2
- package/templates/racing/.zed/settings.json +9 -2
- package/templates/racing/AGENTS.md +10 -12
- package/templates/racing/CLAUDE.md +10 -12
- package/templates/racing/opencode.json +10 -2
- package/templates/racing/package.json +17 -11
- package/templates/racing/playtests/brake.playtest.json +54 -0
- package/templates/racing/playtests/outcome.playtest.json +19 -0
- package/templates/racing/playtests/performance.playtest.json +1 -1
- package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
- package/templates/racing/src/entities/RacingCar.ts +12 -3
- package/templates/racing/src/entities/Rival.ts +11 -2
- package/templates/racing/src/render/atmosphere.ts +444 -0
- package/templates/racing/src/render/backlightMaterial.ts +49 -18
- package/templates/racing/src/render/clouds.ts +605 -0
- package/templates/racing/src/render/exposure.ts +6 -111
- package/templates/racing/src/render/gpuSky.ts +752 -0
- package/templates/racing/src/render/kitExposure.ts +20 -0
- package/templates/racing/src/render/lighting.ts +26 -4
- package/templates/racing/src/render/materialLighting.ts +2 -11
- package/templates/racing/src/render/materials.ts +2 -1
- package/templates/racing/src/render/postprocessing.ts +4 -4
- package/templates/racing/src/render/quality.ts +27 -115
- package/templates/racing/src/render/sky.ts +76 -5
- package/templates/racing/src/scenes/Race.ts +53 -42
- package/templates/racing/src/track/TrackSector.ts +5 -2
- package/templates/racing/src/ui/Hud.tsx +12 -7
- package/templates/rain/.codex/config.toml +6 -2
- package/templates/rain/.cursor/mcp.json +8 -2
- package/templates/rain/.gemini/settings.json +8 -2
- package/templates/rain/.mcp.json +8 -2
- package/templates/rain/.vscode/mcp.json +9 -2
- package/templates/rain/.zed/settings.json +9 -2
- package/templates/rain/AGENTS.md +12 -12
- package/templates/rain/CLAUDE.md +12 -12
- package/templates/rain/opencode.json +10 -2
- package/templates/rain/package.json +16 -10
- package/templates/rain/playtests/performance.playtest.json +1 -1
- package/templates/rain/src/game.ts +1 -1
- package/templates/rain/src/render/bloom-shader.ts +1 -1
- package/templates/rain/src/render/clouds-shader.ts +2 -2
- package/templates/rain/src/render/clouds.ts +2 -1
- package/templates/rain/src/render/exposure.ts +11 -109
- package/templates/rain/src/render/post-shader.ts +7 -11
- package/templates/rain/src/render/postprocessing.ts +8 -24
- package/templates/rain/src/render/quality.ts +44 -98
- package/templates/rain/src/render/world-shader.ts +281 -97
- package/templates/rain/src/render/world.ts +82 -2
- package/templates/rain/src/style.css +1 -1
- package/templates/rain/src/ui/GameUi.tsx +6 -2
- package/templates/rain/src/ui/Hud.tsx +1 -1
- package/templates/rain/tools/generate-shaders.mjs +2 -2
- package/templates/rain/tools/tempest-post.frag +4 -6
- package/templates/rain/tools/tempest-world.frag +80 -12
- package/templates/rts/.codex/config.toml +6 -2
- package/templates/rts/.cursor/mcp.json +8 -2
- package/templates/rts/.gemini/settings.json +8 -2
- package/templates/rts/.mcp.json +8 -2
- package/templates/rts/.vscode/mcp.json +9 -2
- package/templates/rts/.zed/settings.json +9 -2
- package/templates/rts/AGENTS.md +15 -16
- package/templates/rts/CLAUDE.md +15 -16
- package/templates/rts/opencode.json +10 -2
- package/templates/rts/package.json +16 -10
- package/templates/rts/playtests/performance.playtest.json +1 -1
- package/templates/rts/playtests/rts-attack.playtest.json +5 -0
- package/templates/rts/playtests/rts-build.playtest.json +20 -1
- package/templates/rts/playtests/rts-orders.playtest.json +1 -1
- package/templates/rts/playtests/rts-pause.playtest.json +112 -0
- package/templates/rts/playtests/rts-train.playtest.json +1 -1
- package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
- package/templates/rts/src/game.ts +29 -7
- package/templates/rts/src/render/army.ts +181 -49
- package/templates/rts/src/render/backlightMaterial.ts +49 -18
- package/templates/rts/src/render/environment.ts +276 -0
- package/templates/rts/src/render/exposure.ts +3 -65
- package/templates/rts/src/render/ground.ts +478 -0
- package/templates/rts/src/render/lighting.ts +62 -11
- package/templates/rts/src/render/materialLighting.ts +2 -11
- package/templates/rts/src/render/materials.ts +47 -118
- package/templates/rts/src/render/palette.ts +30 -13
- package/templates/rts/src/render/picking.ts +18 -0
- package/templates/rts/src/render/postprocessing.ts +4 -4
- package/templates/rts/src/render/quality.ts +64 -85
- package/templates/rts/src/render/resources.ts +21 -22
- package/templates/rts/src/render/sky.ts +9 -12
- package/templates/rts/src/render/terrain.ts +36 -11
- package/templates/rts/src/scenes/Play.ts +373 -38
- package/templates/rts/src/sim/ai.ts +0 -11
- package/templates/rts/src/state.ts +46 -0
- package/templates/rts/src/style.css +1543 -0
- package/templates/rts/src/ui/Commands.tsx +204 -107
- package/templates/rts/src/ui/GameUi.tsx +12 -5
- package/templates/rts/src/ui/Hud.tsx +611 -116
- package/templates/rts/src/ui/Minimap.tsx +103 -37
- package/templates/rts/src/ui/icons.tsx +116 -0
- package/templates/rts/src/ui/labels.ts +73 -0
- package/templates/rts/src/ui/minimapPoint.ts +30 -0
- package/templates/rts/threenative.config.ts +1 -1
- package/templates/runner/.codex/config.toml +6 -2
- package/templates/runner/.cursor/mcp.json +8 -2
- package/templates/runner/.gemini/settings.json +8 -2
- package/templates/runner/.mcp.json +8 -2
- package/templates/runner/.vscode/mcp.json +9 -2
- package/templates/runner/.zed/settings.json +9 -2
- package/templates/runner/AGENTS.md +12 -12
- package/templates/runner/CLAUDE.md +12 -12
- package/templates/runner/opencode.json +10 -2
- package/templates/runner/package.json +17 -11
- package/templates/runner/playtests/near-miss.playtest.json +48 -0
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/playtests/stride.playtest.json +27 -0
- package/templates/runner/playtests/survives.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +3 -1
- package/templates/runner/src/entities/Runner.ts +11 -5
- package/templates/runner/src/render/atmosphere.ts +444 -0
- package/templates/runner/src/render/backlightMaterial.ts +49 -18
- package/templates/runner/src/render/clouds.ts +605 -0
- package/templates/runner/src/render/exposure.ts +6 -111
- package/templates/runner/src/render/gpuSky.ts +752 -0
- package/templates/runner/src/render/kitExposure.ts +20 -0
- package/templates/runner/src/render/lighting.ts +26 -4
- package/templates/runner/src/render/materialLighting.ts +2 -11
- package/templates/runner/src/render/postprocessing.ts +4 -4
- package/templates/runner/src/render/quality.ts +26 -114
- package/templates/runner/src/render/sky.ts +73 -1
- package/templates/runner/src/scenes/Run.ts +19 -15
- package/templates/runner/src/track.ts +12 -3
- package/templates/sailing/.codex/config.toml +6 -2
- package/templates/sailing/.cursor/mcp.json +8 -2
- package/templates/sailing/.gemini/settings.json +8 -2
- package/templates/sailing/.mcp.json +8 -2
- package/templates/sailing/.vscode/mcp.json +9 -2
- package/templates/sailing/.zed/settings.json +9 -2
- package/templates/sailing/AGENTS.md +10 -11
- package/templates/sailing/CLAUDE.md +10 -11
- package/templates/sailing/opencode.json +10 -2
- package/templates/sailing/package.json +17 -11
- package/templates/sailing/playtests/fail.playtest.json +46 -5
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
- package/templates/sailing/playtests/performance.playtest.json +1 -1
- package/templates/sailing/src/game.ts +1 -0
- package/templates/sailing/src/render/backlightMaterial.ts +49 -18
- package/templates/sailing/src/render/exposure.ts +6 -111
- package/templates/sailing/src/render/kitExposure.ts +20 -0
- package/templates/sailing/src/render/materialLighting.ts +2 -11
- package/templates/sailing/src/render/ocean.ts +0 -1
- package/templates/sailing/src/render/postprocessing.ts +4 -4
- package/templates/sailing/src/render/quality.ts +31 -138
- package/templates/sailing/src/scenes/Sailing.ts +12 -4
- package/templates/sailing/src/ui/Hud.tsx +6 -2
- package/templates/sailing/src/ui/Menu.tsx +1 -1
- package/templates/shooter/.codex/config.toml +6 -2
- package/templates/shooter/.cursor/mcp.json +8 -2
- package/templates/shooter/.gemini/settings.json +8 -2
- package/templates/shooter/.mcp.json +8 -2
- package/templates/shooter/.vscode/mcp.json +9 -2
- package/templates/shooter/.zed/settings.json +9 -2
- package/templates/shooter/AGENTS.md +13 -12
- package/templates/shooter/CLAUDE.md +13 -12
- package/templates/shooter/index.html +1 -1
- package/templates/shooter/main.html +13 -0
- package/templates/shooter/opencode.json +10 -2
- package/templates/shooter/package.json +17 -11
- package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
- package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
- package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
- package/templates/shooter/playtests/performance.playtest.json +3 -3
- package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
- package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
- package/templates/shooter/src/entities/Breakables.ts +34 -10
- package/templates/shooter/src/entities/Enemy.ts +176 -54
- package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
- package/templates/shooter/src/entities/Rifle.ts +83 -9
- package/templates/shooter/src/entities/movement.ts +96 -0
- package/templates/shooter/src/render/atmosphere.ts +444 -0
- package/templates/shooter/src/render/backlightMaterial.ts +49 -18
- package/templates/shooter/src/render/camera.ts +3 -1
- package/templates/shooter/src/render/clouds.ts +605 -0
- package/templates/shooter/src/render/exposure.ts +10 -109
- package/templates/shooter/src/render/facade.ts +26 -68
- package/templates/shooter/src/render/gpuSky.ts +752 -0
- package/templates/shooter/src/render/lighting.ts +27 -4
- package/templates/shooter/src/render/materialAssignments.ts +9 -1
- package/templates/shooter/src/render/materialLighting.ts +2 -11
- package/templates/shooter/src/render/occlusion.ts +13 -4
- package/templates/shooter/src/render/palette.ts +1 -0
- package/templates/shooter/src/render/postprocessing.ts +4 -4
- package/templates/shooter/src/render/quality.ts +50 -108
- package/templates/shooter/src/render/scale.ts +0 -11
- package/templates/shooter/src/render/sky.ts +103 -2
- package/templates/shooter/src/render/surface.ts +140 -0
- package/templates/shooter/src/render/town.ts +3 -6
- package/templates/shooter/src/render/townMaterials.ts +95 -42
- package/templates/shooter/src/render/vehicles.ts +2 -0
- package/templates/shooter/src/scenes/Play.ts +83 -23
- package/templates/shooter/src/ui/Hud.tsx +268 -193
- package/templates/shooter/src/worker-page.ts +29 -0
- package/templates/shooter/src/worker.ts +5 -0
- package/templates/shooter/threenative.config.ts +3 -0
- package/templates/shooter/vite.config.ts +2 -0
- package/templates/snow/.codex/config.toml +6 -2
- package/templates/snow/.cursor/mcp.json +8 -2
- package/templates/snow/.gemini/settings.json +8 -2
- package/templates/snow/.mcp.json +8 -2
- package/templates/snow/.vscode/mcp.json +9 -2
- package/templates/snow/.zed/settings.json +9 -2
- package/templates/snow/AGENTS.md +12 -10
- package/templates/snow/CLAUDE.md +12 -10
- package/templates/snow/opencode.json +10 -2
- package/templates/snow/package.json +17 -11
- package/templates/snow/playtests/performance.playtest.json +1 -1
- package/templates/snow/src/render/backlightMaterial.ts +49 -18
- package/templates/snow/src/render/exposure.ts +17 -106
- package/templates/snow/src/render/materialLighting.ts +2 -11
- package/templates/snow/src/render/postprocessing.ts +11 -5
- package/templates/snow/src/render/quality.ts +46 -126
- package/templates/snow/src/render/snowSurface.ts +32 -15
- package/templates/snow/src/scenes/Snow.ts +2 -1
- package/templates/starter/.codex/config.toml +6 -2
- package/templates/starter/.cursor/mcp.json +8 -2
- package/templates/starter/.gemini/settings.json +8 -2
- package/templates/starter/.mcp.json +8 -2
- package/templates/starter/.vscode/mcp.json +9 -2
- package/templates/starter/.zed/settings.json +9 -2
- package/templates/starter/AGENTS.md +18 -14
- package/templates/starter/CLAUDE.md +18 -14
- package/templates/starter/index.html +1 -1
- package/templates/starter/main.html +12 -0
- package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
- package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
- package/templates/starter/opencode.json +10 -2
- package/templates/starter/package.json +17 -11
- package/templates/starter/playtests/play.playtest.json +22 -2
- package/templates/starter/playtests/production-readiness.playtest.json +56 -0
- package/templates/starter/src/entities/Crate.ts +19 -1
- package/templates/starter/src/render/arena.ts +2 -2
- package/templates/starter/src/render/atmosphere.ts +444 -0
- package/templates/starter/src/render/backlightMaterial.ts +49 -18
- package/templates/starter/src/render/camera.ts +28 -0
- package/templates/starter/src/render/clouds.ts +605 -0
- package/templates/starter/src/render/contactShadow.ts +50 -0
- package/templates/starter/src/render/exposure.ts +9 -111
- package/templates/starter/src/render/gpuSky.ts +752 -0
- package/templates/starter/src/render/grade.ts +1 -1
- package/templates/starter/src/render/lighting.ts +34 -6
- package/templates/starter/src/render/materialLighting.ts +2 -11
- package/templates/starter/src/render/postprocessing.ts +53 -34
- package/templates/starter/src/render/quality.ts +18 -147
- package/templates/starter/src/render/sky.ts +90 -40
- package/templates/starter/src/render/temporalAA.ts +1 -1
- package/templates/starter/src/render/temporalAAStage.ts +1 -1
- package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
- package/templates/starter/src/render/temporalDetailStage.ts +106 -0
- package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
- package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
- package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
- package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
- package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
- package/templates/starter/src/scenes/Play.ts +11 -8
- package/templates/starter/src/ui/Hud.tsx +1 -1
- package/templates/starter/src/worker-page.ts +29 -0
- package/templates/starter/src/worker.ts +5 -0
- package/templates/starter/vite.config.ts +2 -0
- package/templates/tower-defense/.codex/config.toml +6 -2
- package/templates/tower-defense/.cursor/mcp.json +8 -2
- package/templates/tower-defense/.gemini/settings.json +8 -2
- package/templates/tower-defense/.mcp.json +8 -2
- package/templates/tower-defense/.vscode/mcp.json +9 -2
- package/templates/tower-defense/.zed/settings.json +9 -2
- package/templates/tower-defense/AGENTS.md +10 -12
- package/templates/tower-defense/CLAUDE.md +10 -12
- package/templates/tower-defense/opencode.json +10 -2
- package/templates/tower-defense/package.json +17 -11
- package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
- package/templates/tower-defense/playtests/performance.playtest.json +1 -1
- package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
- package/templates/tower-defense/src/render/exposure.ts +11 -109
- package/templates/tower-defense/src/render/lighting.ts +4 -2
- package/templates/tower-defense/src/render/materialLighting.ts +2 -11
- package/templates/tower-defense/src/render/postprocessing.ts +4 -4
- package/templates/tower-defense/src/render/quality.ts +10 -116
- package/templates/tower-defense/src/render/sky.ts +2 -2
- package/templates/tower-defense/src/scenes/Battle.ts +4 -0
- package/template-assets/autoExposure.ts +0 -225
- package/template-assets/exposureGraph.ts +0 -178
- package/template-assets/exposureReadback.ts +0 -79
- package/template-assets/worldEnvironment.ts +0 -1212
- package/templates/action-rpg/src/render/autoExposure.ts +0 -225
- package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
- package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
- package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
- package/templates/minimal/src/render/autoExposure.ts +0 -225
- package/templates/minimal/src/render/exposureGraph.ts +0 -178
- package/templates/minimal/src/render/exposureReadback.ts +0 -79
- package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
- package/templates/platformer/src/render/autoExposure.ts +0 -225
- package/templates/platformer/src/render/exposureGraph.ts +0 -178
- package/templates/platformer/src/render/exposureReadback.ts +0 -79
- package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
- package/templates/puzzle/src/render/autoExposure.ts +0 -225
- package/templates/puzzle/src/render/exposureGraph.ts +0 -178
- package/templates/puzzle/src/render/exposureReadback.ts +0 -79
- package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
- package/templates/racing/src/render/autoExposure.ts +0 -225
- package/templates/racing/src/render/exposureGraph.ts +0 -178
- package/templates/racing/src/render/exposureReadback.ts +0 -79
- package/templates/racing/src/render/worldEnvironment.ts +0 -1212
- package/templates/rain/src/render/autoExposure.ts +0 -225
- package/templates/rain/src/render/exposureGraph.ts +0 -178
- package/templates/rain/src/render/exposureReadback.ts +0 -79
- package/templates/rain/src/render/worldEnvironment.ts +0 -1212
- package/templates/rts/src/render/autoExposure.ts +0 -225
- package/templates/rts/src/render/exposureGraph.ts +0 -178
- package/templates/rts/src/render/exposureReadback.ts +0 -79
- package/templates/rts/src/render/worldEnvironment.ts +0 -1212
- package/templates/runner/src/render/autoExposure.ts +0 -225
- package/templates/runner/src/render/exposureGraph.ts +0 -178
- package/templates/runner/src/render/exposureReadback.ts +0 -79
- package/templates/runner/src/render/worldEnvironment.ts +0 -1212
- package/templates/sailing/src/render/autoExposure.ts +0 -225
- package/templates/sailing/src/render/exposureGraph.ts +0 -178
- package/templates/sailing/src/render/exposureReadback.ts +0 -79
- package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
- package/templates/shooter/src/render/autoExposure.ts +0 -225
- package/templates/shooter/src/render/exposureGraph.ts +0 -178
- package/templates/shooter/src/render/exposureReadback.ts +0 -79
- package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
- package/templates/snow/src/render/autoExposure.ts +0 -225
- package/templates/snow/src/render/exposureGraph.ts +0 -178
- package/templates/snow/src/render/exposureReadback.ts +0 -79
- package/templates/snow/src/render/worldEnvironment.ts +0 -1212
- package/templates/starter/src/render/autoExposure.ts +0 -225
- package/templates/starter/src/render/exposureGraph.ts +0 -178
- package/templates/starter/src/render/exposureReadback.ts +0 -79
- package/templates/starter/src/render/worldEnvironment.ts +0 -1212
- package/templates/tower-defense/src/render/autoExposure.ts +0 -225
- package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
- package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
- package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
// Generated for you. The starter kits share this meter; `pnpm stamp:template-render` copies it into
|
|
2
|
+
// each kit that ships it. Override it for one game in `exposure.ts`, not here.
|
|
3
|
+
//
|
|
4
|
+
// Core's meter is stock Unreal 5.8.3, exposure compensation +1 EV (key 0.36,
|
|
5
|
+
// r.DefaultFeature.AutoExposure.Bias 1.0, UE 5.8.3: Engine/Source/Runtime/Engine/Private/SceneView.cpp:196-199).
|
|
6
|
+
// The kits use 0 EV (key 0.18) instead. Their bright stylised scenes read pastel and veiled at
|
|
7
|
+
// +1 EV. At 0 EV a fresh Opus judge read IMPROVEMENT on 9 of 9 kits (PRD-747, 2026-10-26).
|
|
8
|
+
// The range keeps Unreal's -10..+20 EV100 window around the new key.
|
|
9
|
+
import {
|
|
10
|
+
type IExposureSettings,
|
|
11
|
+
exposureSettings as coreExposureSettings,
|
|
12
|
+
} from "@threenative/core";
|
|
13
|
+
|
|
14
|
+
const KEY = 0.18;
|
|
15
|
+
export const kitExposureSettings: Readonly<IExposureSettings> = {
|
|
16
|
+
...coreExposureSettings,
|
|
17
|
+
key: KEY,
|
|
18
|
+
minStops: Math.log2(KEY) - 20,
|
|
19
|
+
maxStops: Math.log2(KEY) + 10,
|
|
20
|
+
};
|
|
@@ -1,10 +1,32 @@
|
|
|
1
1
|
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
2
|
// ThreeNative does not read this file.
|
|
3
3
|
//
|
|
4
|
-
// One sun. The sky
|
|
4
|
+
// One sun. The sky in `sky.ts` is the fill light — its environment reaches every face the
|
|
5
5
|
// sun misses — so there is no hemisphere or ambient light stacked on top to flatten the frame.
|
|
6
6
|
import { Color, DirectionalLight, PCFSoftShadowMap, type Scene, Vector3 } from "three";
|
|
7
|
-
import {
|
|
7
|
+
import {
|
|
8
|
+
SUN_ILLUMINANCE,
|
|
9
|
+
SUN_KELVIN,
|
|
10
|
+
sunLight,
|
|
11
|
+
sunLightTransmittance,
|
|
12
|
+
temperatureColour,
|
|
13
|
+
} from "./atmosphere.js";
|
|
14
|
+
import { SKY_OPTIONS, SUN_DIRECTION } from "./sky.js";
|
|
15
|
+
|
|
16
|
+
/** The sun as Unreal's default level has it: 6 lux at 6500 K, tinted by the air it crosses. */
|
|
17
|
+
function atmosphereSun(): DirectionalLight {
|
|
18
|
+
const tint = temperatureColour(SUN_KELVIN);
|
|
19
|
+
const through = sunLightTransmittance(Math.asin(Math.min(1, Math.max(-1, SUN_DIRECTION.y))));
|
|
20
|
+
const colour = new Color().setRGB(
|
|
21
|
+
tint[0] * through[0],
|
|
22
|
+
tint[1] * through[1],
|
|
23
|
+
tint[2] * through[2],
|
|
24
|
+
);
|
|
25
|
+
const key = new DirectionalLight(colour, SUN_ILLUMINANCE);
|
|
26
|
+
// `gpuSky.ts` re-tints it when the sun moves.
|
|
27
|
+
sunLight.current = key;
|
|
28
|
+
return key;
|
|
29
|
+
}
|
|
8
30
|
|
|
9
31
|
type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
|
|
10
32
|
|
|
@@ -16,8 +38,8 @@ export function setupLighting(
|
|
|
16
38
|
renderer.shadowMap.enabled = true;
|
|
17
39
|
renderer.shadowMap.type = PCFSoftShadowMap;
|
|
18
40
|
|
|
19
|
-
//
|
|
20
|
-
const key = new DirectionalLight(0xfff1e0, 4.5);
|
|
41
|
+
// The photo sky keeps the warm white matched by eye to its photographed midday sun.
|
|
42
|
+
const key = SKY_OPTIONS.sky === "photo" ? new DirectionalLight(0xfff1e0, 4.5) : atmosphereSun();
|
|
21
43
|
key.position.copy(SUN_DIRECTION).multiplyScalar(40);
|
|
22
44
|
key.castShadow = true;
|
|
23
45
|
// One map fitted to the whole circuit rather than a cascade that follows the car: the racing line
|
|
@@ -1,15 +1,6 @@
|
|
|
1
1
|
// Generated for you. Scene-owned material assignments; no engine appearance hooks.
|
|
2
|
-
import {
|
|
3
|
-
|
|
4
|
-
type DirectionalLight,
|
|
5
|
-
Material,
|
|
6
|
-
Mesh,
|
|
7
|
-
MeshStandardMaterial,
|
|
8
|
-
type Object3D,
|
|
9
|
-
type Scene,
|
|
10
|
-
type Texture,
|
|
11
|
-
} from "three";
|
|
12
|
-
import { type IBacklightControls, backlightMaterial } from "./backlightMaterial.js";
|
|
2
|
+
import type { Camera, DirectionalLight, Object3D, Scene, Texture } from "three";
|
|
3
|
+
import type { IBacklightControls } from "./backlightMaterial.js";
|
|
13
4
|
import {
|
|
14
5
|
type IEnvironmentMeasurement,
|
|
15
6
|
measureEnvironment,
|
|
@@ -65,7 +65,8 @@ function rgbaTexture(
|
|
|
65
65
|
* car lays rubber. The band is the thing that makes a road read as a **racing** surface rather
|
|
66
66
|
* than a grey plane — it also tells the player where the line is without a single word of UI.
|
|
67
67
|
*/
|
|
68
|
-
|
|
68
|
+
// Not applied to the road yet, so it is prefixed rather than deleted: wiring it in changes the look.
|
|
69
|
+
const _asphalt = rgbaTexture(256, (u, v) => {
|
|
69
70
|
const grain = (noise(Math.floor(u * 256), Math.floor(v * 256), 11) - 0.5) * 26;
|
|
70
71
|
const rubber = 1 - 0.34 * falloff(u - 0.5, 0.16);
|
|
71
72
|
const shoulder = 1 + 0.1 * falloff(u - 0.5, 0.42);
|
|
@@ -1,8 +1,10 @@
|
|
|
1
|
+
import type { OutputRenderer } from "@threenative/core";
|
|
2
|
+
import { WorldEnvironment } from "@threenative/core";
|
|
1
3
|
// Generated for you: ordinary Three.js; ThreeNative does not read this file.
|
|
2
4
|
//
|
|
3
5
|
// This file wires two things together and decides nothing itself. `quality.ts`, in this folder,
|
|
4
|
-
// owns which stages run at which tier and records what each one measured. `WorldEnvironment
|
|
5
|
-
//
|
|
6
|
+
// owns which stages run at which tier and records what each one measured. `WorldEnvironment` from
|
|
7
|
+
// the core package builds them and prints `TN_WORLD_ENVIRONMENT` naming every stage as
|
|
6
8
|
// applied or refused **with a reason**, so a stage that silently no-op'd is never mistaken for
|
|
7
9
|
// one you turned off.
|
|
8
10
|
//
|
|
@@ -12,8 +14,6 @@
|
|
|
12
14
|
// `TN_QUALITY_TIER` names the tier that ran either way.
|
|
13
15
|
import type { Camera, DirectionalLight, Scene } from "three";
|
|
14
16
|
import { type QualityTier, qualityPreset, resolveQualityTier } from "./quality.js";
|
|
15
|
-
import type { OutputRenderer } from "./worldEnvironment.js";
|
|
16
|
-
import { WorldEnvironment } from "./worldEnvironment.js";
|
|
17
17
|
|
|
18
18
|
export function setupPost(
|
|
19
19
|
renderer: OutputRenderer,
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { exposureSettings } from "./exposure.js";
|
|
1
2
|
// Generated for you: ordinary Three.js; ThreeNative does not read this file. Delete or rewrite
|
|
2
3
|
// it freely — the tiers below are a starting point, not a framework look.
|
|
3
4
|
//
|
|
@@ -28,7 +29,13 @@
|
|
|
28
29
|
// frame at 33 ms p95 and 30 fps, so if you turn a stage on, that scenario is what tells you it was
|
|
29
30
|
// worth it. Both are one line to turn back on.
|
|
30
31
|
|
|
31
|
-
import
|
|
32
|
+
import {
|
|
33
|
+
type IWorldEnvironmentOptions,
|
|
34
|
+
qualityPreset as coreQualityPreset,
|
|
35
|
+
qualityTiers,
|
|
36
|
+
} from "@threenative/core";
|
|
37
|
+
export type { QualityTier } from "@threenative/core";
|
|
38
|
+
import type { QualityTier } from "@threenative/core";
|
|
32
39
|
|
|
33
40
|
/**
|
|
34
41
|
* The three names this game's look comes in.
|
|
@@ -38,122 +45,27 @@ import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
|
|
|
38
45
|
* laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
|
|
39
46
|
* what any of them mean.
|
|
40
47
|
*/
|
|
41
|
-
export
|
|
48
|
+
export const resolveQualityTier = qualityTiers.resolve;
|
|
42
49
|
|
|
43
|
-
const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
|
|
44
|
-
|
|
45
|
-
/**
|
|
46
|
-
* Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
|
|
47
|
-
* `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
|
|
48
|
-
*/
|
|
49
|
-
function isQualityTier(value: string): value is QualityTier {
|
|
50
|
-
return (QUALITY_TIERS as readonly string[]).includes(value);
|
|
51
|
-
}
|
|
52
|
-
|
|
53
|
-
/**
|
|
54
|
-
* Where each GPU family starts, from `ctx.renderer.gpuClass`.
|
|
55
|
-
*
|
|
56
|
-
* A start, not a ceiling: the measured frame-budget windows move the look from here, and an
|
|
57
|
-
* explicit `tier` above still wins. A class absent from this table — `unknown`, an adapter no
|
|
58
|
-
* family rule matched — falls back to the `mobile` flag, exactly as before families existed.
|
|
59
|
-
* Edit the right-hand side to change what a family looks like; nothing outside this file reads it.
|
|
60
|
-
*/
|
|
61
|
-
const START_TIER_BY_GPU_CLASS: Readonly<Record<string, QualityTier | undefined>> = {
|
|
62
|
-
software: "low",
|
|
63
|
-
"mobile-low": "low",
|
|
64
|
-
"mobile-mid": "low",
|
|
65
|
-
"mobile-high": "medium",
|
|
66
|
-
integrated: "medium",
|
|
67
|
-
discrete: "high",
|
|
68
|
-
};
|
|
69
|
-
|
|
70
|
-
/**
|
|
71
|
-
* Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
|
|
72
|
-
*
|
|
73
|
-
* Fails closed. An unrecognised tier name throws with the value it was handed rather than
|
|
74
|
-
* quietly rendering the default, because a silent fallback here looks exactly like a tier that
|
|
75
|
-
* turned out to have no effect.
|
|
76
|
-
*/
|
|
77
|
-
export function resolveQualityTier(
|
|
78
|
-
request: {
|
|
79
|
-
readonly gpuClass?: string;
|
|
80
|
-
readonly mobile?: boolean;
|
|
81
|
-
readonly software?: boolean;
|
|
82
|
-
readonly tier?: string;
|
|
83
|
-
} = {},
|
|
84
|
-
): QualityTier {
|
|
85
|
-
const requested = request.tier;
|
|
86
|
-
if (requested !== undefined) {
|
|
87
|
-
if (!isQualityTier(requested)) {
|
|
88
|
-
throw new Error(
|
|
89
|
-
`Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
90
|
-
);
|
|
91
|
-
}
|
|
92
|
-
return requested;
|
|
93
|
-
}
|
|
94
|
-
// A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
|
|
95
|
-
// game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
|
|
96
|
-
// drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
|
|
97
|
-
// fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
|
|
98
|
-
// `tier` above still wins over it.
|
|
99
|
-
if (request.software === true) return "low";
|
|
100
|
-
const family =
|
|
101
|
-
request.gpuClass === undefined ? undefined : START_TIER_BY_GPU_CLASS[request.gpuClass];
|
|
102
|
-
if (family !== undefined) return family;
|
|
103
|
-
return request.mobile === true ? "low" : "high";
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
/**
|
|
107
|
-
* The look every tier shares: a wide, faint glow on what is genuinely brighter than white — the sun
|
|
108
|
-
* disk, the visor — rather than a haze over the frame (a threshold under 1 blooms lit grey walls and
|
|
109
|
-
* flattens contrast), and a corner falloff. Antialiasing is on in every tier that installs a chain;
|
|
110
|
-
* see `screenSpaceAA` in `worldEnvironment.ts`.
|
|
111
|
-
*
|
|
112
|
-
* No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
|
|
113
|
-
* captured sky (`sky.ts`), and SSR on rough tarmac traced speckle into the road; RCAS then rang the
|
|
114
|
-
* smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
|
|
115
|
-
*/
|
|
116
|
-
const shared: IWorldEnvironmentOptions = {
|
|
117
|
-
// Bloom: ~4.6 ms in the reference ablation — the second most expensive stage there.
|
|
118
|
-
bloomEnabled: true,
|
|
119
|
-
bloomRadius: 0.55,
|
|
120
|
-
bloomStrength: 0.26,
|
|
121
|
-
bloomThreshold: 1,
|
|
122
|
-
autoExposureEnabled: false,
|
|
123
|
-
exposure: 0.66,
|
|
124
|
-
tonemapMode: "aces",
|
|
125
|
-
vignetteAmount: 0.26,
|
|
126
|
-
};
|
|
127
|
-
|
|
128
|
-
/**
|
|
129
|
-
* What a desktop gets: contact occlusion on top — the dark line where a tyre meets the tarmac and a
|
|
130
|
-
* wing meets its own shadow, most of what separates "a car on a road" from "a car over a picture".
|
|
131
|
-
* Gathered at full resolution and denoised: at half, the upsample left a grain around every wheel.
|
|
132
|
-
*/
|
|
133
|
-
const high: IWorldEnvironmentOptions = {
|
|
134
|
-
...shared,
|
|
135
|
-
// GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
|
|
136
|
-
gtaoEnabled: true,
|
|
137
|
-
gtaoRadius: 0.35,
|
|
138
|
-
};
|
|
139
|
-
|
|
140
|
-
/** The rung in between: the same occlusion at half the directions. Saving unmeasured. */
|
|
141
|
-
const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8, renderChainTier: "medium" };
|
|
142
|
-
|
|
143
|
-
/** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
|
|
144
|
-
const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
|
|
145
|
-
|
|
146
|
-
const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
|
|
147
|
-
|
|
148
|
-
/** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
|
|
149
50
|
export function qualityPreset(tier: string): IWorldEnvironmentOptions {
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
51
|
+
console.info(
|
|
52
|
+
`TN_RENDER_CHAIN_COST_OVERRIDE ${JSON.stringify({
|
|
53
|
+
reason:
|
|
54
|
+
"Racing: rough-tarmac SSR speckle and RCAS sky bands; PRD-194 performance scenario holds 33 ms p95 and 30 fps; isolated stage costs remain unmeasured",
|
|
55
|
+
finalGatherMethod: "none",
|
|
56
|
+
ssgiEnabled: false,
|
|
57
|
+
ssrEnabled: false,
|
|
58
|
+
sharpenEnabled: false,
|
|
59
|
+
})}`,
|
|
60
|
+
);
|
|
61
|
+
return {
|
|
62
|
+
...coreQualityPreset(tier),
|
|
63
|
+
exposurePolicy: exposureSettings,
|
|
64
|
+
finalGatherMethod: "none",
|
|
65
|
+
ssgiEnabled: false,
|
|
66
|
+
ssrEnabled: false,
|
|
67
|
+
sharpenEnabled: false,
|
|
68
|
+
};
|
|
157
69
|
}
|
|
158
70
|
|
|
159
71
|
/** First admitted material lane: high desktop hardware WebGPU in the browser only. */
|
|
@@ -1,6 +1,12 @@
|
|
|
1
1
|
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
2
|
// ThreeNative does not read this file.
|
|
3
3
|
//
|
|
4
|
+
// The default sky is Unreal 5.8.3's default level: a Sky Atmosphere with its volumetric cloud layer, a
|
|
5
|
+
// sky light that captures it, a sun tinted by the air it crosses, and an exponential height fog that
|
|
6
|
+
// takes its colour from the sky (`atmosphere.ts`, `clouds.ts`, `gpuSky.ts`). Sun, sky and fog read one
|
|
7
|
+
// illuminance, so moving `SUN_DIRECTION` recolours all three together. `SKY_OPTIONS.sky = "photo"`
|
|
8
|
+
// keeps the photograph below; `clouds: false` keeps a clear sky.
|
|
9
|
+
//
|
|
4
10
|
// The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
|
|
5
11
|
// by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
|
|
6
12
|
// The same image is the background, the environment light every surface reflects and is filled by,
|
|
@@ -15,6 +21,7 @@ import {
|
|
|
15
21
|
type Texture,
|
|
16
22
|
Vector3,
|
|
17
23
|
} from "three";
|
|
24
|
+
import { createGpuSky } from "./gpuSky.js";
|
|
18
25
|
import { HEIGHT_FOG, type HeightFogParams, heightFogDepth, heightFogNode } from "./heightFog.js";
|
|
19
26
|
import { palette } from "./palette.js";
|
|
20
27
|
|
|
@@ -45,13 +52,13 @@ function distanceDensity(p: HeightFogParams = HEIGHT_FOG): number {
|
|
|
45
52
|
}
|
|
46
53
|
|
|
47
54
|
/**
|
|
48
|
-
* Puts the sky on the scene, or a plain gradient if
|
|
55
|
+
* Puts the sky on the scene, or a plain gradient if no photograph is given.
|
|
49
56
|
*
|
|
50
|
-
*
|
|
51
|
-
*
|
|
52
|
-
*
|
|
57
|
+
* `Race.load()` waits for the JPEG, so the scene enters with the photograph already applied. The
|
|
58
|
+
* fallback stays for a scene that has no sky asset, and a swap after the first frame is not safe on
|
|
59
|
+
* `engine: "threejs"` (see `Race.load`).
|
|
53
60
|
*/
|
|
54
|
-
|
|
61
|
+
function setupPhotoSky(scene: Scene, sky?: Texture): void {
|
|
55
62
|
if (sky === undefined) {
|
|
56
63
|
scene.background = new Color(palette.skyHigh);
|
|
57
64
|
scene.environment = null;
|
|
@@ -74,3 +81,67 @@ export function setupSky(scene: Scene, sky?: Texture): void {
|
|
|
74
81
|
scene.fog = distanceFog;
|
|
75
82
|
scene.fogNode = heightFogNode(distanceFog, HEIGHT_FOG, SUN_DIRECTION);
|
|
76
83
|
}
|
|
84
|
+
|
|
85
|
+
export const SKY_OPTIONS: { sky: "atmosphere" | "photo"; clouds: boolean; ground: boolean } = {
|
|
86
|
+
sky: "atmosphere",
|
|
87
|
+
clouds: true,
|
|
88
|
+
// The sunlit ground below the horizon stands in for Unreal's Lumen floor bounce: it lifts shadow
|
|
89
|
+
// sides and a mirror reflects it. Set false when the game adds its own global illumination.
|
|
90
|
+
ground: true,
|
|
91
|
+
};
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* Unreal's default level fog in metres: density and falloff are per 1000 cm (x0.1 per metre), and its
|
|
95
|
+
* line integral carries ln2 against the exact integral `heightFog.ts` evaluates. `fogHeight` sits
|
|
96
|
+
* 68.5 m below the floor, where the default level puts the fog actor. Inscattering is black and the
|
|
97
|
+
* start distance 0, as in Unreal: the colour comes from the sky.
|
|
98
|
+
*/
|
|
99
|
+
const ATMOSPHERE_FOG = {
|
|
100
|
+
...HEIGHT_FOG,
|
|
101
|
+
density: 0.00436 * Math.LN2,
|
|
102
|
+
heightFalloff: 0.02,
|
|
103
|
+
fogHeight: -68.5,
|
|
104
|
+
startDistance: 0,
|
|
105
|
+
};
|
|
106
|
+
|
|
107
|
+
/** White in the 8-bit environment is this much scene radiance (`createGpuSky`). */
|
|
108
|
+
const ENVIRONMENT_RANGE = 4;
|
|
109
|
+
|
|
110
|
+
/**
|
|
111
|
+
* `photo` is only read when `SKY_OPTIONS.sky` is "photo". `fogged` false leaves the sky unfogged;
|
|
112
|
+
* `clouds` false draws the clear atmosphere. A software adapter draws the 64 x 32 bake as the
|
|
113
|
+
* background, with no LUT or cloud passes.
|
|
114
|
+
*/
|
|
115
|
+
export function setupSky(
|
|
116
|
+
scene: Scene,
|
|
117
|
+
photo?: Texture,
|
|
118
|
+
software = false,
|
|
119
|
+
fogged = true,
|
|
120
|
+
clouds = SKY_OPTIONS.clouds,
|
|
121
|
+
): void {
|
|
122
|
+
if (SKY_OPTIONS.sky === "photo") {
|
|
123
|
+
setupPhotoSky(scene, photo);
|
|
124
|
+
return;
|
|
125
|
+
}
|
|
126
|
+
// Height fog only; FogExp2 holds the colour `heightFogNode` reads, at zero density. `createGpuSky`
|
|
127
|
+
// sets that colour from the sky and again whenever the sun moves.
|
|
128
|
+
const fog = new FogExp2(0xffffff, 0);
|
|
129
|
+
scene.fog = fog;
|
|
130
|
+
scene.fogNode = heightFogNode(fog, { ...ATMOSPHERE_FOG }, SUN_DIRECTION);
|
|
131
|
+
const { node, environment } = createGpuSky(
|
|
132
|
+
scene,
|
|
133
|
+
SUN_DIRECTION,
|
|
134
|
+
fogged,
|
|
135
|
+
clouds,
|
|
136
|
+
ATMOSPHERE_FOG,
|
|
137
|
+
SKY_OPTIONS.ground,
|
|
138
|
+
);
|
|
139
|
+
environment.mapping = EquirectangularReflectionMapping;
|
|
140
|
+
environment.colorSpace = SRGBColorSpace;
|
|
141
|
+
scene.background = environment;
|
|
142
|
+
scene.backgroundNode = software ? null : node.backgroundNode;
|
|
143
|
+
scene.backgroundIntensity = software ? ENVIRONMENT_RANGE : 1;
|
|
144
|
+
// Unreal's sky light: the same sky, so the fill on every shaded face is the sky's colour.
|
|
145
|
+
scene.environment = environment;
|
|
146
|
+
scene.environmentIntensity = ENVIRONMENT_RANGE;
|
|
147
|
+
}
|
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
import {
|
|
2
|
-
type ICtx,
|
|
3
2
|
Scene,
|
|
4
3
|
type SceneFrame,
|
|
5
4
|
afterPhysics,
|
|
@@ -24,7 +23,7 @@ import {
|
|
|
24
23
|
isWebGLFallbackRenderer,
|
|
25
24
|
materialLightingEnabled,
|
|
26
25
|
} from "../render/quality.js";
|
|
27
|
-
import { SUN_DIRECTION, setupSky } from "../render/sky.js";
|
|
26
|
+
import { SKY_OPTIONS, SUN_DIRECTION, setupSky } from "../render/sky.js";
|
|
28
27
|
import { TouchControls } from "../render/touch-controls.js";
|
|
29
28
|
import { type GameState, type RaceStatus, resolveRaceStatus } from "../state.js";
|
|
30
29
|
import { Lap } from "../track/Lap.js";
|
|
@@ -97,56 +96,67 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
97
96
|
#sky: Texture | undefined;
|
|
98
97
|
|
|
99
98
|
/**
|
|
100
|
-
* The sky photograph,
|
|
99
|
+
* The sky photograph, **awaited** before the scene enters.
|
|
101
100
|
*
|
|
102
|
-
*
|
|
103
|
-
*
|
|
104
|
-
*
|
|
105
|
-
*
|
|
106
|
-
* the
|
|
107
|
-
*
|
|
101
|
+
* It used to be fetched without waiting and swapped in when it decoded. On `engine: "threejs"`
|
|
102
|
+
* that swap lands in the middle of a frame (WebGPU rendering yields between its awaits), next to
|
|
103
|
+
* the shadow pass, which clears `scene.background` and puts it back. A swap after the first frame
|
|
104
|
+
* was never drawn: the sky stayed the fallback colour on a fast GPU, and the engine-parity guard
|
|
105
|
+
* scored the template 0.823 against the correct `threenative` frame, passing only when a slow
|
|
106
|
+
* adapter let the photograph land before the first render. Applied before the first frame the
|
|
107
|
+
* same texture draws, and parity scores 0.001.
|
|
108
108
|
*/
|
|
109
109
|
#post: ReturnType<typeof setupPost> | undefined;
|
|
110
110
|
#environmentSample: IEnvironmentSample | undefined;
|
|
111
111
|
#materialLighting: ReturnType<typeof createMaterialLighting> | undefined;
|
|
112
112
|
#lightingGeneration = 0;
|
|
113
113
|
|
|
114
|
-
override load(ctx: GameCtx): void {
|
|
114
|
+
override async load(ctx: GameCtx): Promise<void> {
|
|
115
115
|
const generation = ++this.#lightingGeneration;
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
currentController.setEnvironmentMeasurement(
|
|
140
|
-
sample.measurement,
|
|
141
|
-
sample.source,
|
|
142
|
-
sample.intensity,
|
|
143
|
-
sample,
|
|
144
|
-
);
|
|
116
|
+
// Only the photo-sky override reads the photograph; the atmosphere sky is computed.
|
|
117
|
+
const texture = SKY_OPTIONS.sky === "photo" ? await ctx.assets.texture("sky.jpg") : undefined;
|
|
118
|
+
if (generation !== this.#lightingGeneration) return;
|
|
119
|
+
this.#sky = texture;
|
|
120
|
+
const scene = ctx.scene;
|
|
121
|
+
if (scene === undefined) return;
|
|
122
|
+
setupSky(scene, texture, ctx.renderer.softwareAdapter !== undefined);
|
|
123
|
+
// The measurement is not awaited: it reads the GPU back and must not hold the first frame.
|
|
124
|
+
void this.#sampleSky(ctx, scene, generation);
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
async #sampleSky(
|
|
128
|
+
ctx: GameCtx,
|
|
129
|
+
scene: NonNullable<GameCtx["scene"]>,
|
|
130
|
+
generation: number,
|
|
131
|
+
): Promise<void> {
|
|
132
|
+
const controller = this.#materialLighting;
|
|
133
|
+
const sample = await sampleEnvironment(ctx.renderer.raw, scene, {
|
|
134
|
+
web: getPlatform().runtime === "web",
|
|
135
|
+
rendererKind: ctx.renderer.kind,
|
|
136
|
+
webglFallback: isWebGLFallbackRenderer(ctx.renderer.raw),
|
|
137
|
+
mobile: isMobile(),
|
|
138
|
+
software: ctx.renderer.softwareAdapter !== undefined,
|
|
145
139
|
});
|
|
140
|
+
if (generation !== this.#lightingGeneration || ctx.scene !== scene) return;
|
|
141
|
+
this.#environmentSample = sample;
|
|
142
|
+
// A cached sky may start sampling before enter creates the receiver controller.
|
|
143
|
+
// A controller that already existed when sampling began must still be the same one.
|
|
144
|
+
const currentController = this.#materialLighting;
|
|
145
|
+
if (
|
|
146
|
+
currentController !== undefined &&
|
|
147
|
+
(controller === undefined || controller === currentController)
|
|
148
|
+
)
|
|
149
|
+
currentController.setEnvironmentMeasurement(
|
|
150
|
+
sample.measurement,
|
|
151
|
+
sample.source,
|
|
152
|
+
sample.intensity,
|
|
153
|
+
sample,
|
|
154
|
+
);
|
|
146
155
|
}
|
|
147
156
|
|
|
148
157
|
override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
|
|
149
|
-
if (this.#sky === undefined
|
|
158
|
+
if (this.#sky === undefined && SKY_OPTIONS.sky === "photo")
|
|
159
|
+
setupSky(ctx.scene, undefined, ctx.renderer.softwareAdapter !== undefined);
|
|
150
160
|
const lighting = setupLighting(
|
|
151
161
|
ctx.scene,
|
|
152
162
|
ctx.renderer.raw as Parameters<typeof setupLighting>[1],
|
|
@@ -257,7 +267,7 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
257
267
|
touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size),
|
|
258
268
|
);
|
|
259
269
|
rival.update(dt);
|
|
260
|
-
sector.update(car.body.position, car.forward, dt, car.speed);
|
|
270
|
+
sector.update(car.body.position, car.forward, dt, car.speed, car.driving);
|
|
261
271
|
if (sector.rescue(car)) {
|
|
262
272
|
rescues += 1;
|
|
263
273
|
rescuePositionError = quantize(
|
|
@@ -315,7 +325,8 @@ export class Race extends Scene<GameState, IPhysicsContext> {
|
|
|
315
325
|
void frameCtx.goto("race");
|
|
316
326
|
return;
|
|
317
327
|
}
|
|
318
|
-
|
|
328
|
+
// The race clock stops with the race, so the outcome panel reads the finishing time.
|
|
329
|
+
if (status === "RACING") elapsed += dt;
|
|
319
330
|
advanceRace(frameCtx, dt);
|
|
320
331
|
const ranked = rankRace();
|
|
321
332
|
const player = playerRanking(ranked);
|
|
@@ -67,14 +67,17 @@ export class TrackSector {
|
|
|
67
67
|
* `speed` is the car's measured speed in m/s. It is what makes a **beached** car recoverable: a
|
|
68
68
|
* ray-cast chassis that has nosed into a barrier is still standing on the road, so the off-road
|
|
69
69
|
* ray keeps hitting and a car pinned against a hoarding would sit there for the rest of the race.
|
|
70
|
+
* `driving` says the engine is pushing: only a car that is driven and still not moving is beached.
|
|
71
|
+
* A car the player brought to a stop is parked, and four rescues of a parked car end the race.
|
|
70
72
|
*/
|
|
71
|
-
update(position: Vector3, heading: Vector3, dt: number, speed = 0): boolean {
|
|
73
|
+
update(position: Vector3, heading: Vector3, dt: number, speed = 0, driving = true): boolean {
|
|
72
74
|
if (!Number.isFinite(dt) || dt < 0)
|
|
73
75
|
throw new Error("TrackSector.update requires a finite non-negative dt.");
|
|
74
76
|
if (Math.abs(speed) >= this.#stallSpeed) {
|
|
75
77
|
this.#stalledTime = 0;
|
|
76
78
|
this.#hasMoved = true;
|
|
77
|
-
} else if (
|
|
79
|
+
} else if (!driving) this.#stalledTime = 0;
|
|
80
|
+
else if (this.#hasMoved) this.#stalledTime += dt;
|
|
78
81
|
const origin = this.#origin.copy(position);
|
|
79
82
|
origin.y += this.#rayHeight;
|
|
80
83
|
const hit = this.#intersectRay(origin, this.#direction, this.#rayHeight + 2);
|
|
@@ -19,7 +19,7 @@ export function Hud() {
|
|
|
19
19
|
return (
|
|
20
20
|
<div className="pointer-events-none absolute inset-0 p-6 text-[11px] uppercase tracking-[0.16em] text-text">
|
|
21
21
|
<div className="flex items-start justify-between">
|
|
22
|
-
<div>
|
|
22
|
+
<div className="-m-3 bg-panel p-3">
|
|
23
23
|
<div className="text-[10px] text-muted">circuit / northern loop</div>
|
|
24
24
|
<div className="mt-2 flex items-baseline gap-5 text-[18px] text-white">
|
|
25
25
|
<span>
|
|
@@ -31,18 +31,18 @@ export function Hud() {
|
|
|
31
31
|
</span>
|
|
32
32
|
</div>
|
|
33
33
|
</div>
|
|
34
|
-
<div className="text-right">
|
|
34
|
+
<div className="-m-3 bg-panel p-3 text-right">
|
|
35
35
|
<div className="text-[10px] text-muted">position</div>
|
|
36
36
|
<div className="mt-2 text-[22px] text-white" id="position">
|
|
37
37
|
P{state.place}
|
|
38
38
|
</div>
|
|
39
39
|
</div>
|
|
40
40
|
</div>
|
|
41
|
-
<div className="absolute bottom-6 left-6 flex items-end gap-8">
|
|
41
|
+
<div className="absolute bottom-6 left-6 -m-3 flex items-end gap-8 bg-panel p-3">
|
|
42
42
|
<div>
|
|
43
43
|
<div className="text-[10px] text-muted">speed</div>
|
|
44
44
|
<div className="mt-1 text-[26px] leading-none text-white">
|
|
45
|
-
<span id="speed">{Math.round(state.speed *
|
|
45
|
+
<span id="speed">{Math.round(state.speed * 3.6)}</span>
|
|
46
46
|
<span className="text-[11px] text-muted"> km/h</span>
|
|
47
47
|
</div>
|
|
48
48
|
</div>
|
|
@@ -55,15 +55,20 @@ export function Hud() {
|
|
|
55
55
|
<div className={state.boostActive ? "text-accent" : "text-muted"}>
|
|
56
56
|
<div className="text-[10px]">boost</div>
|
|
57
57
|
<div className="mt-1 text-[18px] leading-none" id="boost">
|
|
58
|
-
{state.boostActive ? "ACTIVE" :
|
|
58
|
+
{state.boostActive ? "ACTIVE" : "READY"}
|
|
59
59
|
</div>
|
|
60
60
|
</div>
|
|
61
61
|
</div>
|
|
62
62
|
{state.raceStatus !== "RACING" && (
|
|
63
63
|
<div
|
|
64
|
-
className={`absolute left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 border px-8 py-5 text-center ${state.raceStatus === "WON" ? "border-win/70 bg-
|
|
64
|
+
className={`absolute left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 border px-8 py-5 text-center ${state.raceStatus === "WON" ? "border-win/70 bg-panel" : "border-danger/70 bg-panel"}`}
|
|
65
65
|
>
|
|
66
|
-
<div className={`text-[28px] tracking-[0.28em] ${statusClass}`}>
|
|
66
|
+
<div className={`text-[28px] tracking-[0.28em] ${statusClass}`} id="outcome">
|
|
67
|
+
{/* Every lap done behind the rival is a loss, but not a "did not finish": name the place. */}
|
|
68
|
+
{state.raceStatus === "DNF" && state.completedLaps >= state.totalLaps
|
|
69
|
+
? `P${state.place}`
|
|
70
|
+
: state.raceStatus}
|
|
71
|
+
</div>
|
|
67
72
|
<div className="mt-2 text-[10px] text-muted">press R to restart</div>
|
|
68
73
|
</div>
|
|
69
74
|
)}
|
|
@@ -14,6 +14,10 @@ args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
|
|
|
14
14
|
command = "node"
|
|
15
15
|
args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
|
|
16
16
|
|
|
17
|
-
[mcp_servers.threenative-
|
|
17
|
+
[mcp_servers.threenative-animation]
|
|
18
18
|
command = "node"
|
|
19
|
-
args = ["./node_modules/@threenative/core/mcp/
|
|
19
|
+
args = ["./node_modules/@threenative/core/mcp/animation.mjs"]
|
|
20
|
+
|
|
21
|
+
[mcp_servers.threenative-devtools]
|
|
22
|
+
command = "node"
|
|
23
|
+
args = ["./node_modules/@threenative/core/mcp/devtools.mjs"]
|
|
@@ -22,10 +22,16 @@
|
|
|
22
22
|
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
23
23
|
]
|
|
24
24
|
},
|
|
25
|
-
"threenative-
|
|
25
|
+
"threenative-animation": {
|
|
26
26
|
"command": "node",
|
|
27
27
|
"args": [
|
|
28
|
-
"./node_modules/@threenative/core/mcp/
|
|
28
|
+
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
29
|
+
]
|
|
30
|
+
},
|
|
31
|
+
"threenative-devtools": {
|
|
32
|
+
"command": "node",
|
|
33
|
+
"args": [
|
|
34
|
+
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
29
35
|
]
|
|
30
36
|
}
|
|
31
37
|
}
|