create-threenative 0.2.10 → 0.2.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agent-docs/references/assertion-reference.md +109 -3
- package/agent-docs/references/auto-exposure.md +28 -45
- package/agent-docs/references/build-profiles.md +1 -1
- package/agent-docs/references/capability-reference.md +527 -44
- package/agent-docs/references/debug-surface.md +64 -0
- package/agent-docs/references/finding-assets.md +11 -12
- package/agent-docs/references/performance-basics.md +19 -0
- package/agent-docs/references/trace-a-slow-frame.md +21 -0
- package/agent-docs/references/visual-baseline.md +23 -4
- package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
- package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
- package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
- package/agent-files/scripts/reference.mjs +9 -4
- package/capabilities.json +739 -50
- package/dist/index.d.ts +40 -6
- package/dist/index.js +227 -34
- package/dist/quality.d.ts +12 -0
- package/dist/quality.js +166747 -0
- package/dist/threenative.js +60 -44
- package/dist/web-engine-gltf-loader.js +2 -0
- package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
- package/dist/web-engine-mesh-bvh.js +7 -0
- package/dist/web-engine-post-effects.js +645 -19
- package/dist/web-engine-runtime.js +3528 -343
- package/package.json +19 -9
- package/template-assets/assets/bay-PROVENANCE.md +21 -0
- package/template-assets/assets/bay-ground.webp +0 -0
- package/template-assets/assets/bay-metal.webp +0 -0
- package/template-assets/assets/bay-pavement-normal.webp +0 -0
- package/template-assets/assets/bay-pavement.webp +0 -0
- package/template-assets/assets/bay-plaster-normal.webp +0 -0
- package/template-assets/assets/bay-plaster.webp +0 -0
- package/template-assets/assets/bay-wood-normal.webp +0 -0
- package/template-assets/assets/bay-wood.webp +0 -0
- package/template-assets/assets/tex-PROVENANCE.md +25 -0
- package/template-assets/assets/tex-bark-normal.webp +0 -0
- package/template-assets/assets/tex-bark.webp +0 -0
- package/template-assets/assets/tex-birch-bark.webp +0 -0
- package/template-assets/assets/tex-grass.webp +0 -0
- package/template-assets/assets/tex-planks-normal.webp +0 -0
- package/template-assets/assets/tex-planks.webp +0 -0
- package/template-assets/assets/tex-rock-normal.webp +0 -0
- package/template-assets/assets/tex-rock.webp +0 -0
- package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
- package/template-assets/assets/tex-roof-tiles.webp +0 -0
- package/template-assets/assets/tex-sand-normal.webp +0 -0
- package/template-assets/assets/tex-sand.webp +0 -0
- package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
- package/template-assets/assets/tex-stone-wall.webp +0 -0
- package/template-assets/kitExposure.ts +20 -0
- package/template-assets/patches/three@0.185.1.patch +481 -272
- package/template-assets/quality/biome.json +7 -0
- package/template-assets/quality/eslint.config.js +3 -0
- package/template-assets/realistic-ocean/README.md +113 -0
- package/template-assets/realistic-ocean/install.mjs +56 -0
- package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
- package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
- package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
- package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
- package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
- package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
- package/templates/AGENTS.md +21 -0
- package/templates/CLAUDE.md +23 -0
- package/templates/action-rpg/.codex/config.toml +6 -2
- package/templates/action-rpg/.cursor/mcp.json +8 -2
- package/templates/action-rpg/.gemini/settings.json +8 -2
- package/templates/action-rpg/.mcp.json +8 -2
- package/templates/action-rpg/.vscode/mcp.json +9 -2
- package/templates/action-rpg/.zed/settings.json +9 -2
- package/templates/action-rpg/AGENTS.md +11 -11
- package/templates/action-rpg/CLAUDE.md +11 -11
- package/templates/action-rpg/opencode.json +10 -2
- package/templates/action-rpg/package.json +15 -10
- package/templates/action-rpg/playtests/combat.playtest.json +6 -0
- package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
- package/templates/action-rpg/playtests/performance.playtest.json +1 -1
- package/templates/action-rpg/playtests/roll.playtest.json +112 -0
- package/templates/action-rpg/playtests/swing.playtest.json +55 -0
- package/templates/action-rpg/playtests/win.playtest.json +4 -4
- package/templates/action-rpg/src/entities/Fighter.ts +44 -4
- package/templates/action-rpg/src/entities/Player.ts +64 -12
- package/templates/action-rpg/src/render/atmosphere.ts +444 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
- package/templates/action-rpg/src/render/clouds.ts +605 -0
- package/templates/action-rpg/src/render/dungeon.ts +8 -6
- package/templates/action-rpg/src/render/exposure.ts +11 -109
- package/templates/action-rpg/src/render/gpuSky.ts +752 -0
- package/templates/action-rpg/src/render/lighting.ts +27 -4
- package/templates/action-rpg/src/render/materialLighting.ts +2 -11
- package/templates/action-rpg/src/render/palette.ts +1 -0
- package/templates/action-rpg/src/render/postprocessing.ts +4 -4
- package/templates/action-rpg/src/render/props.ts +10 -8
- package/templates/action-rpg/src/render/quality.ts +56 -108
- package/templates/action-rpg/src/render/sky.ts +74 -1
- package/templates/action-rpg/src/scenes/Play.ts +16 -12
- package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
- package/templates/action-rpg/src/ui/Hud.tsx +5 -7
- package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
- package/templates/action-rpg/threenative.config.ts +3 -0
- package/templates/adventure/.codex/config.toml +23 -0
- package/templates/adventure/.cursor/mcp.json +38 -0
- package/templates/adventure/.gemini/settings.json +38 -0
- package/templates/adventure/.mcp.json +38 -0
- package/templates/adventure/.vscode/mcp.json +43 -0
- package/templates/adventure/.zed/settings.json +43 -0
- package/templates/adventure/AGENTS.md +60 -0
- package/templates/adventure/CLAUDE.md +62 -0
- package/templates/adventure/index.html +14 -0
- package/templates/adventure/kit.json +8 -0
- package/templates/adventure/native-playtests/survives.playtest.json +52 -0
- package/templates/adventure/opencode.json +49 -0
- package/templates/adventure/package.json +65 -0
- package/templates/adventure/playtests/boss.playtest.json +406 -0
- package/templates/adventure/playtests/combat.playtest.json +342 -0
- package/templates/adventure/playtests/controls.playtest.json +142 -0
- package/templates/adventure/playtests/explore.playtest.json +45 -0
- package/templates/adventure/playtests/flicker.playtest.json +206 -0
- package/templates/adventure/playtests/hearts.playtest.json +171 -0
- package/templates/adventure/playtests/lockon.playtest.json +256 -0
- package/templates/adventure/playtests/look.playtest.json +72 -0
- package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
- package/templates/adventure/playtests/move.playtest.json +84 -0
- package/templates/adventure/playtests/performance.playtest.json +55 -0
- package/templates/adventure/playtests/puzzle.playtest.json +250 -0
- package/templates/adventure/playtests/stride.playtest.json +67 -0
- package/templates/adventure/playtests/survives.playtest.json +171 -0
- package/templates/adventure/playtests/thornback.playtest.json +267 -0
- package/templates/adventure/public/favicon.svg +4 -0
- package/templates/adventure/src/entities/Block.ts +114 -0
- package/templates/adventure/src/entities/Chest.ts +69 -0
- package/templates/adventure/src/entities/Door.ts +81 -0
- package/templates/adventure/src/entities/Dummy.ts +69 -0
- package/templates/adventure/src/entities/Flicker.ts +239 -0
- package/templates/adventure/src/entities/Hero.ts +561 -0
- package/templates/adventure/src/entities/LockOn.ts +180 -0
- package/templates/adventure/src/entities/Mossling.ts +249 -0
- package/templates/adventure/src/entities/Switch.ts +49 -0
- package/templates/adventure/src/entities/Thornback.ts +238 -0
- package/templates/adventure/src/entities/Warden.ts +196 -0
- package/templates/adventure/src/game.ts +65 -0
- package/templates/adventure/src/interact.ts +63 -0
- package/templates/adventure/src/level/Hollow.ts +240 -0
- package/templates/adventure/src/level/Vale.ts +383 -0
- package/templates/adventure/src/main.ts +18 -0
- package/templates/adventure/src/render/camera.ts +416 -0
- package/templates/adventure/src/render/creatures.ts +405 -0
- package/templates/adventure/src/render/effects.ts +333 -0
- package/templates/adventure/src/render/foliage.ts +1072 -0
- package/templates/adventure/src/render/hero.ts +1447 -0
- package/templates/adventure/src/render/kitExposure.ts +20 -0
- package/templates/adventure/src/render/lighting.ts +74 -0
- package/templates/adventure/src/render/loading.ts +332 -0
- package/templates/adventure/src/render/materials.ts +179 -0
- package/templates/adventure/src/render/palette.ts +137 -0
- package/templates/adventure/src/render/postprocessing.ts +70 -0
- package/templates/adventure/src/render/props.ts +383 -0
- package/templates/adventure/src/render/quality.ts +46 -0
- package/templates/adventure/src/render/sky.ts +271 -0
- package/templates/adventure/src/render/surface.ts +259 -0
- package/templates/adventure/src/render/touch-controls.ts +137 -0
- package/templates/adventure/src/scenes/Play.ts +959 -0
- package/templates/adventure/src/state.ts +113 -0
- package/templates/adventure/src/style.css +98 -0
- package/templates/adventure/src/ui/App.tsx +22 -0
- package/templates/adventure/src/ui/GameUi.tsx +20 -0
- package/templates/adventure/src/ui/Hud.tsx +70 -0
- package/templates/adventure/src/ui/Menu.tsx +15 -0
- package/templates/adventure/src/ui/main.tsx +14 -0
- package/templates/adventure/tailwind.config.ts +2 -0
- package/templates/adventure/threenative.config.ts +62 -0
- package/templates/adventure/tsconfig.json +17 -0
- package/templates/adventure/vite.config.ts +49 -0
- package/templates/collectathon/.codex/config.toml +23 -0
- package/templates/collectathon/.cursor/mcp.json +38 -0
- package/templates/collectathon/.gemini/settings.json +38 -0
- package/templates/collectathon/.mcp.json +38 -0
- package/templates/collectathon/.vscode/mcp.json +43 -0
- package/templates/collectathon/.zed/settings.json +43 -0
- package/templates/collectathon/AGENTS.md +58 -0
- package/templates/collectathon/CLAUDE.md +60 -0
- package/templates/collectathon/index.html +14 -0
- package/templates/collectathon/kit.json +8 -0
- package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
- package/templates/collectathon/opencode.json +49 -0
- package/templates/collectathon/package.json +65 -0
- package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
- package/templates/collectathon/playtests/camera.playtest.json +80 -0
- package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
- package/templates/collectathon/playtests/collect.playtest.json +196 -0
- package/templates/collectathon/playtests/combat.playtest.json +246 -0
- package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
- package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
- package/templates/collectathon/playtests/effects.playtest.json +124 -0
- package/templates/collectathon/playtests/enemies.playtest.json +295 -0
- package/templates/collectathon/playtests/explore.playtest.json +45 -0
- package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
- package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
- package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
- package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
- package/templates/collectathon/playtests/ledge.playtest.json +100 -0
- package/templates/collectathon/playtests/look.playtest.json +64 -0
- package/templates/collectathon/playtests/performance.playtest.json +55 -0
- package/templates/collectathon/playtests/stride.playtest.json +111 -0
- package/templates/collectathon/playtests/survives.playtest.json +123 -0
- package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
- package/templates/collectathon/playtests/thornback.playtest.json +157 -0
- package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
- package/templates/collectathon/playtests/win.playtest.json +166 -0
- package/templates/collectathon/public/favicon.svg +4 -0
- package/templates/collectathon/src/entities/Hero.ts +915 -0
- package/templates/collectathon/src/entities/Pickup.ts +63 -0
- package/templates/collectathon/src/entities/Walker.ts +248 -0
- package/templates/collectathon/src/game.ts +51 -0
- package/templates/collectathon/src/level/Course.ts +590 -0
- package/templates/collectathon/src/level/terrain.ts +144 -0
- package/templates/collectathon/src/main.ts +14 -0
- package/templates/collectathon/src/playtest-events.ts +15 -0
- package/templates/collectathon/src/render/camera.ts +163 -0
- package/templates/collectathon/src/render/castle.ts +408 -0
- package/templates/collectathon/src/render/effects.ts +284 -0
- package/templates/collectathon/src/render/foliage.ts +744 -0
- package/templates/collectathon/src/render/ground.ts +139 -0
- package/templates/collectathon/src/render/hero.ts +452 -0
- package/templates/collectathon/src/render/kitExposure.ts +20 -0
- package/templates/collectathon/src/render/lighting.ts +65 -0
- package/templates/collectathon/src/render/loading.ts +332 -0
- package/templates/collectathon/src/render/materials.ts +196 -0
- package/templates/collectathon/src/render/palette.ts +82 -0
- package/templates/collectathon/src/render/postprocessing.ts +79 -0
- package/templates/collectathon/src/render/props.ts +218 -0
- package/templates/collectathon/src/render/quality.ts +54 -0
- package/templates/collectathon/src/render/sky.ts +262 -0
- package/templates/collectathon/src/render/surface.ts +269 -0
- package/templates/collectathon/src/render/touch-controls.ts +179 -0
- package/templates/collectathon/src/render/touch-layout.ts +48 -0
- package/templates/collectathon/src/render/water.ts +191 -0
- package/templates/collectathon/src/scenes/Play.ts +481 -0
- package/templates/collectathon/src/state.ts +38 -0
- package/templates/collectathon/src/style.css +106 -0
- package/templates/collectathon/src/ui/App.tsx +22 -0
- package/templates/collectathon/src/ui/GameUi.tsx +20 -0
- package/templates/collectathon/src/ui/Hud.tsx +77 -0
- package/templates/collectathon/src/ui/Menu.tsx +13 -0
- package/templates/collectathon/src/ui/main.tsx +14 -0
- package/templates/collectathon/tailwind.config.ts +2 -0
- package/templates/collectathon/threenative.config.ts +62 -0
- package/templates/collectathon/tsconfig.json +17 -0
- package/templates/collectathon/vite.config.ts +49 -0
- package/templates/kart/.codex/config.toml +23 -0
- package/templates/kart/.cursor/mcp.json +38 -0
- package/templates/kart/.gemini/settings.json +38 -0
- package/templates/kart/.mcp.json +38 -0
- package/templates/kart/.vscode/mcp.json +43 -0
- package/templates/kart/.zed/settings.json +43 -0
- package/templates/kart/AGENTS.md +58 -0
- package/templates/kart/CLAUDE.md +60 -0
- package/templates/kart/index.html +14 -0
- package/templates/kart/kit.json +8 -0
- package/templates/kart/native-playtests/survives.playtest.json +65 -0
- package/templates/kart/opencode.json +49 -0
- package/templates/kart/package.json +64 -0
- package/templates/kart/playtests/drift.playtest.json +226 -0
- package/templates/kart/playtests/explore.playtest.json +45 -0
- package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
- package/templates/kart/playtests/item-key.playtest.json +108 -0
- package/templates/kart/playtests/items.playtest.json +143 -0
- package/templates/kart/playtests/lap-times.playtest.json +138 -0
- package/templates/kart/playtests/laps.playtest.json +149 -0
- package/templates/kart/playtests/performance.playtest.json +57 -0
- package/templates/kart/playtests/race.playtest.json +294 -0
- package/templates/kart/playtests/restart.playtest.json +87 -0
- package/templates/kart/playtests/rocket-start.playtest.json +56 -0
- package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
- package/templates/kart/playtests/surfaces.playtest.json +113 -0
- package/templates/kart/playtests/survives.playtest.json +116 -0
- package/templates/kart/playtests/wall.playtest.json +118 -0
- package/templates/kart/public/favicon.svg +4 -0
- package/templates/kart/src/entities/Driver.ts +123 -0
- package/templates/kart/src/entities/Items.ts +194 -0
- package/templates/kart/src/entities/Kart.ts +517 -0
- package/templates/kart/src/game.ts +45 -0
- package/templates/kart/src/main.ts +14 -0
- package/templates/kart/src/playtest-events.ts +15 -0
- package/templates/kart/src/render/camera.ts +83 -0
- package/templates/kart/src/render/course.ts +579 -0
- package/templates/kart/src/render/effects.ts +266 -0
- package/templates/kart/src/render/items.ts +163 -0
- package/templates/kart/src/render/kart.ts +256 -0
- package/templates/kart/src/render/kitExposure.ts +20 -0
- package/templates/kart/src/render/lighting.ts +58 -0
- package/templates/kart/src/render/loading.ts +332 -0
- package/templates/kart/src/render/materials.ts +119 -0
- package/templates/kart/src/render/palette.ts +74 -0
- package/templates/kart/src/render/postprocessing.ts +79 -0
- package/templates/kart/src/render/quality.ts +54 -0
- package/templates/kart/src/render/skids.ts +86 -0
- package/templates/kart/src/render/sky.ts +105 -0
- package/templates/kart/src/render/touch-controls.ts +168 -0
- package/templates/kart/src/render/touch-layout.ts +48 -0
- package/templates/kart/src/scenes/Race.ts +850 -0
- package/templates/kart/src/state.ts +53 -0
- package/templates/kart/src/style.css +106 -0
- package/templates/kart/src/track/Course.ts +276 -0
- package/templates/kart/src/track/Race.ts +133 -0
- package/templates/kart/src/ui/App.tsx +21 -0
- package/templates/kart/src/ui/GameUi.tsx +20 -0
- package/templates/kart/src/ui/Hud.tsx +172 -0
- package/templates/kart/src/ui/Menu.tsx +13 -0
- package/templates/kart/src/ui/main.tsx +14 -0
- package/templates/kart/tailwind.config.ts +2 -0
- package/templates/kart/threenative.config.ts +62 -0
- package/templates/kart/tsconfig.json +17 -0
- package/templates/kart/vite.config.ts +49 -0
- package/templates/minimal/.codex/config.toml +6 -2
- package/templates/minimal/.cursor/mcp.json +8 -2
- package/templates/minimal/.gemini/settings.json +8 -2
- package/templates/minimal/.mcp.json +8 -2
- package/templates/minimal/.vscode/mcp.json +9 -2
- package/templates/minimal/.zed/settings.json +9 -2
- package/templates/minimal/AGENTS.md +11 -13
- package/templates/minimal/CLAUDE.md +11 -13
- package/templates/minimal/opencode.json +10 -2
- package/templates/minimal/package.json +14 -9
- package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
- package/templates/minimal/playtests/jump.playtest.json +45 -0
- package/templates/minimal/playtests/play.playtest.json +1 -1
- package/templates/minimal/src/game.ts +2 -0
- package/templates/minimal/src/render/atmosphere.ts +444 -0
- package/templates/minimal/src/render/backlightMaterial.ts +49 -18
- package/templates/minimal/src/render/camera.ts +35 -4
- package/templates/minimal/src/render/clouds.ts +605 -0
- package/templates/minimal/src/render/exposure.ts +7 -111
- package/templates/minimal/src/render/gpuSky.ts +752 -0
- package/templates/minimal/src/render/lighting.ts +26 -4
- package/templates/minimal/src/render/materialLighting.ts +2 -10
- package/templates/minimal/src/render/postprocessing.ts +4 -4
- package/templates/minimal/src/render/quality.ts +10 -116
- package/templates/minimal/src/render/sky.ts +73 -1
- package/templates/minimal/src/scenes/Play.ts +18 -7
- package/templates/platformer/.codex/config.toml +6 -2
- package/templates/platformer/.cursor/mcp.json +8 -2
- package/templates/platformer/.gemini/settings.json +8 -2
- package/templates/platformer/.mcp.json +8 -2
- package/templates/platformer/.vscode/mcp.json +9 -2
- package/templates/platformer/.zed/settings.json +9 -2
- package/templates/platformer/AGENTS.md +13 -9
- package/templates/platformer/CLAUDE.md +13 -9
- package/templates/platformer/opencode.json +10 -2
- package/templates/platformer/package.json +15 -10
- package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
- package/templates/platformer/playtests/finish.playtest.json +58 -0
- package/templates/platformer/playtests/idle.playtest.json +44 -0
- package/templates/platformer/playtests/performance.playtest.json +1 -1
- package/templates/platformer/src/entities/Fox.ts +19 -6
- package/templates/platformer/src/game.ts +1 -0
- package/templates/platformer/src/level/Stage.ts +4 -1
- package/templates/platformer/src/render/backlightMaterial.ts +49 -18
- package/templates/platformer/src/render/camera.ts +30 -1
- package/templates/platformer/src/render/exposure.ts +6 -111
- package/templates/platformer/src/render/fox.ts +5 -2
- package/templates/platformer/src/render/kitExposure.ts +20 -0
- package/templates/platformer/src/render/materialLighting.ts +2 -11
- package/templates/platformer/src/render/postprocessing.ts +4 -4
- package/templates/platformer/src/render/props.ts +1 -2
- package/templates/platformer/src/render/quality.ts +10 -118
- package/templates/platformer/src/scenes/Play.ts +31 -15
- package/templates/platformer/src/ui/Menu.tsx +1 -1
- package/templates/puzzle/.codex/config.toml +6 -2
- package/templates/puzzle/.cursor/mcp.json +8 -2
- package/templates/puzzle/.gemini/settings.json +8 -2
- package/templates/puzzle/.mcp.json +8 -2
- package/templates/puzzle/.vscode/mcp.json +9 -2
- package/templates/puzzle/.zed/settings.json +9 -2
- package/templates/puzzle/AGENTS.md +14 -17
- package/templates/puzzle/CLAUDE.md +14 -17
- package/templates/puzzle/opencode.json +10 -2
- package/templates/puzzle/package.json +15 -10
- package/templates/puzzle/playtests/performance.playtest.json +1 -1
- package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
- package/templates/puzzle/src/render/exposure.ts +11 -109
- package/templates/puzzle/src/render/lighting.ts +3 -3
- package/templates/puzzle/src/render/materialLighting.ts +2 -11
- package/templates/puzzle/src/render/palette.ts +1 -1
- package/templates/puzzle/src/render/postprocessing.ts +4 -4
- package/templates/puzzle/src/render/quality.ts +44 -153
- package/templates/puzzle/src/render/vault.ts +18 -6
- package/templates/puzzle/src/scenes/Play.ts +6 -1
- package/templates/puzzle/src/ui/Hud.tsx +8 -43
- package/templates/racing/.codex/config.toml +6 -2
- package/templates/racing/.cursor/mcp.json +8 -2
- package/templates/racing/.gemini/settings.json +8 -2
- package/templates/racing/.mcp.json +8 -2
- package/templates/racing/.vscode/mcp.json +9 -2
- package/templates/racing/.zed/settings.json +9 -2
- package/templates/racing/AGENTS.md +10 -12
- package/templates/racing/CLAUDE.md +10 -12
- package/templates/racing/opencode.json +10 -2
- package/templates/racing/package.json +15 -10
- package/templates/racing/playtests/brake.playtest.json +54 -0
- package/templates/racing/playtests/outcome.playtest.json +19 -0
- package/templates/racing/playtests/performance.playtest.json +1 -1
- package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
- package/templates/racing/src/entities/RacingCar.ts +12 -3
- package/templates/racing/src/entities/Rival.ts +11 -2
- package/templates/racing/src/render/atmosphere.ts +444 -0
- package/templates/racing/src/render/backlightMaterial.ts +49 -18
- package/templates/racing/src/render/clouds.ts +605 -0
- package/templates/racing/src/render/exposure.ts +6 -111
- package/templates/racing/src/render/gpuSky.ts +752 -0
- package/templates/racing/src/render/kitExposure.ts +20 -0
- package/templates/racing/src/render/lighting.ts +26 -4
- package/templates/racing/src/render/materialLighting.ts +2 -11
- package/templates/racing/src/render/materials.ts +2 -1
- package/templates/racing/src/render/postprocessing.ts +4 -4
- package/templates/racing/src/render/quality.ts +27 -115
- package/templates/racing/src/render/sky.ts +72 -1
- package/templates/racing/src/scenes/Race.ts +9 -7
- package/templates/racing/src/track/TrackSector.ts +5 -2
- package/templates/racing/src/ui/Hud.tsx +12 -7
- package/templates/rain/.codex/config.toml +6 -2
- package/templates/rain/.cursor/mcp.json +8 -2
- package/templates/rain/.gemini/settings.json +8 -2
- package/templates/rain/.mcp.json +8 -2
- package/templates/rain/.vscode/mcp.json +9 -2
- package/templates/rain/.zed/settings.json +9 -2
- package/templates/rain/AGENTS.md +12 -12
- package/templates/rain/CLAUDE.md +12 -12
- package/templates/rain/opencode.json +10 -2
- package/templates/rain/package.json +14 -9
- package/templates/rain/playtests/performance.playtest.json +1 -1
- package/templates/rain/src/game.ts +1 -1
- package/templates/rain/src/render/bloom-shader.ts +1 -1
- package/templates/rain/src/render/clouds-shader.ts +2 -2
- package/templates/rain/src/render/clouds.ts +2 -1
- package/templates/rain/src/render/exposure.ts +11 -109
- package/templates/rain/src/render/post-shader.ts +7 -11
- package/templates/rain/src/render/postprocessing.ts +8 -24
- package/templates/rain/src/render/quality.ts +44 -98
- package/templates/rain/src/render/world-shader.ts +281 -97
- package/templates/rain/src/render/world.ts +82 -2
- package/templates/rain/src/style.css +1 -1
- package/templates/rain/src/ui/GameUi.tsx +6 -2
- package/templates/rain/src/ui/Hud.tsx +1 -1
- package/templates/rain/tools/generate-shaders.mjs +2 -2
- package/templates/rain/tools/tempest-post.frag +4 -6
- package/templates/rain/tools/tempest-world.frag +80 -12
- package/templates/rts/.codex/config.toml +6 -2
- package/templates/rts/.cursor/mcp.json +8 -2
- package/templates/rts/.gemini/settings.json +8 -2
- package/templates/rts/.mcp.json +8 -2
- package/templates/rts/.vscode/mcp.json +9 -2
- package/templates/rts/.zed/settings.json +9 -2
- package/templates/rts/AGENTS.md +15 -16
- package/templates/rts/CLAUDE.md +15 -16
- package/templates/rts/opencode.json +10 -2
- package/templates/rts/package.json +14 -9
- package/templates/rts/playtests/performance.playtest.json +1 -1
- package/templates/rts/playtests/rts-attack.playtest.json +5 -0
- package/templates/rts/playtests/rts-build.playtest.json +20 -1
- package/templates/rts/playtests/rts-orders.playtest.json +1 -1
- package/templates/rts/playtests/rts-pause.playtest.json +112 -0
- package/templates/rts/playtests/rts-train.playtest.json +1 -1
- package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
- package/templates/rts/src/game.ts +29 -7
- package/templates/rts/src/render/army.ts +181 -49
- package/templates/rts/src/render/backlightMaterial.ts +49 -18
- package/templates/rts/src/render/environment.ts +276 -0
- package/templates/rts/src/render/exposure.ts +3 -65
- package/templates/rts/src/render/ground.ts +478 -0
- package/templates/rts/src/render/lighting.ts +62 -11
- package/templates/rts/src/render/materialLighting.ts +2 -11
- package/templates/rts/src/render/materials.ts +47 -118
- package/templates/rts/src/render/palette.ts +30 -13
- package/templates/rts/src/render/picking.ts +18 -0
- package/templates/rts/src/render/postprocessing.ts +4 -4
- package/templates/rts/src/render/quality.ts +64 -85
- package/templates/rts/src/render/resources.ts +21 -22
- package/templates/rts/src/render/sky.ts +9 -12
- package/templates/rts/src/render/terrain.ts +36 -11
- package/templates/rts/src/scenes/Play.ts +373 -38
- package/templates/rts/src/sim/ai.ts +0 -11
- package/templates/rts/src/state.ts +46 -0
- package/templates/rts/src/style.css +1543 -0
- package/templates/rts/src/ui/Commands.tsx +204 -107
- package/templates/rts/src/ui/GameUi.tsx +12 -5
- package/templates/rts/src/ui/Hud.tsx +611 -116
- package/templates/rts/src/ui/Minimap.tsx +103 -37
- package/templates/rts/src/ui/icons.tsx +116 -0
- package/templates/rts/src/ui/labels.ts +73 -0
- package/templates/rts/src/ui/minimapPoint.ts +30 -0
- package/templates/rts/threenative.config.ts +1 -1
- package/templates/runner/.codex/config.toml +6 -2
- package/templates/runner/.cursor/mcp.json +8 -2
- package/templates/runner/.gemini/settings.json +8 -2
- package/templates/runner/.mcp.json +8 -2
- package/templates/runner/.vscode/mcp.json +9 -2
- package/templates/runner/.zed/settings.json +9 -2
- package/templates/runner/AGENTS.md +12 -12
- package/templates/runner/CLAUDE.md +12 -12
- package/templates/runner/opencode.json +10 -2
- package/templates/runner/package.json +15 -10
- package/templates/runner/playtests/near-miss.playtest.json +48 -0
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/playtests/stride.playtest.json +27 -0
- package/templates/runner/playtests/survives.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +3 -1
- package/templates/runner/src/entities/Runner.ts +11 -5
- package/templates/runner/src/render/atmosphere.ts +444 -0
- package/templates/runner/src/render/backlightMaterial.ts +49 -18
- package/templates/runner/src/render/clouds.ts +605 -0
- package/templates/runner/src/render/exposure.ts +6 -111
- package/templates/runner/src/render/gpuSky.ts +752 -0
- package/templates/runner/src/render/kitExposure.ts +20 -0
- package/templates/runner/src/render/lighting.ts +26 -4
- package/templates/runner/src/render/materialLighting.ts +2 -11
- package/templates/runner/src/render/postprocessing.ts +4 -4
- package/templates/runner/src/render/quality.ts +26 -114
- package/templates/runner/src/render/sky.ts +73 -1
- package/templates/runner/src/scenes/Run.ts +19 -15
- package/templates/runner/src/track.ts +12 -3
- package/templates/sailing/.codex/config.toml +6 -2
- package/templates/sailing/.cursor/mcp.json +8 -2
- package/templates/sailing/.gemini/settings.json +8 -2
- package/templates/sailing/.mcp.json +8 -2
- package/templates/sailing/.vscode/mcp.json +9 -2
- package/templates/sailing/.zed/settings.json +9 -2
- package/templates/sailing/AGENTS.md +10 -11
- package/templates/sailing/CLAUDE.md +10 -11
- package/templates/sailing/opencode.json +10 -2
- package/templates/sailing/package.json +15 -10
- package/templates/sailing/playtests/fail.playtest.json +46 -5
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
- package/templates/sailing/playtests/performance.playtest.json +1 -1
- package/templates/sailing/src/game.ts +1 -0
- package/templates/sailing/src/render/backlightMaterial.ts +49 -18
- package/templates/sailing/src/render/exposure.ts +6 -111
- package/templates/sailing/src/render/kitExposure.ts +20 -0
- package/templates/sailing/src/render/materialLighting.ts +2 -11
- package/templates/sailing/src/render/ocean.ts +0 -1
- package/templates/sailing/src/render/postprocessing.ts +4 -4
- package/templates/sailing/src/render/quality.ts +31 -138
- package/templates/sailing/src/scenes/Sailing.ts +12 -4
- package/templates/sailing/src/ui/Hud.tsx +6 -2
- package/templates/sailing/src/ui/Menu.tsx +1 -1
- package/templates/shooter/.codex/config.toml +6 -2
- package/templates/shooter/.cursor/mcp.json +8 -2
- package/templates/shooter/.gemini/settings.json +8 -2
- package/templates/shooter/.mcp.json +8 -2
- package/templates/shooter/.vscode/mcp.json +9 -2
- package/templates/shooter/.zed/settings.json +9 -2
- package/templates/shooter/AGENTS.md +13 -12
- package/templates/shooter/CLAUDE.md +13 -12
- package/templates/shooter/index.html +1 -1
- package/templates/shooter/main.html +13 -0
- package/templates/shooter/opencode.json +10 -2
- package/templates/shooter/package.json +15 -10
- package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
- package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
- package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
- package/templates/shooter/playtests/performance.playtest.json +3 -3
- package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
- package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
- package/templates/shooter/src/entities/Breakables.ts +34 -10
- package/templates/shooter/src/entities/Enemy.ts +176 -54
- package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
- package/templates/shooter/src/entities/Rifle.ts +83 -9
- package/templates/shooter/src/entities/movement.ts +96 -0
- package/templates/shooter/src/render/atmosphere.ts +444 -0
- package/templates/shooter/src/render/backlightMaterial.ts +49 -18
- package/templates/shooter/src/render/camera.ts +3 -1
- package/templates/shooter/src/render/clouds.ts +605 -0
- package/templates/shooter/src/render/exposure.ts +10 -109
- package/templates/shooter/src/render/facade.ts +26 -68
- package/templates/shooter/src/render/gpuSky.ts +752 -0
- package/templates/shooter/src/render/lighting.ts +27 -4
- package/templates/shooter/src/render/materialAssignments.ts +9 -1
- package/templates/shooter/src/render/materialLighting.ts +2 -11
- package/templates/shooter/src/render/occlusion.ts +13 -4
- package/templates/shooter/src/render/palette.ts +1 -0
- package/templates/shooter/src/render/postprocessing.ts +4 -4
- package/templates/shooter/src/render/quality.ts +50 -108
- package/templates/shooter/src/render/scale.ts +0 -11
- package/templates/shooter/src/render/sky.ts +103 -2
- package/templates/shooter/src/render/surface.ts +140 -0
- package/templates/shooter/src/render/town.ts +3 -6
- package/templates/shooter/src/render/townMaterials.ts +95 -42
- package/templates/shooter/src/render/vehicles.ts +2 -0
- package/templates/shooter/src/scenes/Play.ts +83 -23
- package/templates/shooter/src/ui/Hud.tsx +268 -193
- package/templates/shooter/src/worker-page.ts +29 -0
- package/templates/shooter/src/worker.ts +5 -0
- package/templates/shooter/threenative.config.ts +3 -0
- package/templates/shooter/vite.config.ts +2 -0
- package/templates/snow/.codex/config.toml +6 -2
- package/templates/snow/.cursor/mcp.json +8 -2
- package/templates/snow/.gemini/settings.json +8 -2
- package/templates/snow/.mcp.json +8 -2
- package/templates/snow/.vscode/mcp.json +9 -2
- package/templates/snow/.zed/settings.json +9 -2
- package/templates/snow/AGENTS.md +12 -10
- package/templates/snow/CLAUDE.md +12 -10
- package/templates/snow/opencode.json +10 -2
- package/templates/snow/package.json +15 -10
- package/templates/snow/playtests/performance.playtest.json +1 -1
- package/templates/snow/src/render/backlightMaterial.ts +49 -18
- package/templates/snow/src/render/exposure.ts +17 -106
- package/templates/snow/src/render/materialLighting.ts +2 -11
- package/templates/snow/src/render/postprocessing.ts +11 -5
- package/templates/snow/src/render/quality.ts +46 -126
- package/templates/snow/src/render/snowSurface.ts +32 -15
- package/templates/snow/src/scenes/Snow.ts +2 -1
- package/templates/starter/.codex/config.toml +6 -2
- package/templates/starter/.cursor/mcp.json +8 -2
- package/templates/starter/.gemini/settings.json +8 -2
- package/templates/starter/.mcp.json +8 -2
- package/templates/starter/.vscode/mcp.json +9 -2
- package/templates/starter/.zed/settings.json +9 -2
- package/templates/starter/AGENTS.md +18 -14
- package/templates/starter/CLAUDE.md +18 -14
- package/templates/starter/index.html +1 -1
- package/templates/starter/main.html +12 -0
- package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
- package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
- package/templates/starter/opencode.json +10 -2
- package/templates/starter/package.json +15 -10
- package/templates/starter/playtests/play.playtest.json +22 -2
- package/templates/starter/playtests/production-readiness.playtest.json +14 -0
- package/templates/starter/src/entities/Crate.ts +19 -1
- package/templates/starter/src/render/arena.ts +2 -2
- package/templates/starter/src/render/atmosphere.ts +444 -0
- package/templates/starter/src/render/backlightMaterial.ts +49 -18
- package/templates/starter/src/render/camera.ts +28 -0
- package/templates/starter/src/render/clouds.ts +605 -0
- package/templates/starter/src/render/contactShadow.ts +50 -0
- package/templates/starter/src/render/exposure.ts +9 -111
- package/templates/starter/src/render/gpuSky.ts +752 -0
- package/templates/starter/src/render/grade.ts +1 -1
- package/templates/starter/src/render/lighting.ts +34 -6
- package/templates/starter/src/render/materialLighting.ts +2 -11
- package/templates/starter/src/render/postprocessing.ts +27 -14
- package/templates/starter/src/render/quality.ts +18 -147
- package/templates/starter/src/render/sky.ts +90 -40
- package/templates/starter/src/render/temporalAA.ts +1 -1
- package/templates/starter/src/render/temporalAAStage.ts +1 -1
- package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
- package/templates/starter/src/render/temporalDetailStage.ts +106 -0
- package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
- package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
- package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
- package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
- package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
- package/templates/starter/src/scenes/Play.ts +11 -8
- package/templates/starter/src/ui/Hud.tsx +1 -1
- package/templates/starter/src/worker-page.ts +29 -0
- package/templates/starter/src/worker.ts +5 -0
- package/templates/starter/vite.config.ts +2 -0
- package/templates/tower-defense/.codex/config.toml +6 -2
- package/templates/tower-defense/.cursor/mcp.json +8 -2
- package/templates/tower-defense/.gemini/settings.json +8 -2
- package/templates/tower-defense/.mcp.json +8 -2
- package/templates/tower-defense/.vscode/mcp.json +9 -2
- package/templates/tower-defense/.zed/settings.json +9 -2
- package/templates/tower-defense/AGENTS.md +10 -12
- package/templates/tower-defense/CLAUDE.md +10 -12
- package/templates/tower-defense/opencode.json +10 -2
- package/templates/tower-defense/package.json +15 -10
- package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
- package/templates/tower-defense/playtests/performance.playtest.json +1 -1
- package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
- package/templates/tower-defense/src/render/exposure.ts +11 -109
- package/templates/tower-defense/src/render/lighting.ts +4 -2
- package/templates/tower-defense/src/render/materialLighting.ts +2 -11
- package/templates/tower-defense/src/render/postprocessing.ts +4 -4
- package/templates/tower-defense/src/render/quality.ts +10 -116
- package/templates/tower-defense/src/render/sky.ts +2 -2
- package/templates/tower-defense/src/scenes/Battle.ts +4 -0
- package/template-assets/autoExposure.ts +0 -225
- package/template-assets/exposureGraph.ts +0 -178
- package/template-assets/exposureReadback.ts +0 -79
- package/template-assets/worldEnvironment.ts +0 -1212
- package/templates/action-rpg/src/render/autoExposure.ts +0 -225
- package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
- package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
- package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
- package/templates/minimal/src/render/autoExposure.ts +0 -225
- package/templates/minimal/src/render/exposureGraph.ts +0 -178
- package/templates/minimal/src/render/exposureReadback.ts +0 -79
- package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
- package/templates/platformer/src/render/autoExposure.ts +0 -225
- package/templates/platformer/src/render/exposureGraph.ts +0 -178
- package/templates/platformer/src/render/exposureReadback.ts +0 -79
- package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
- package/templates/puzzle/src/render/autoExposure.ts +0 -225
- package/templates/puzzle/src/render/exposureGraph.ts +0 -178
- package/templates/puzzle/src/render/exposureReadback.ts +0 -79
- package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
- package/templates/racing/src/render/autoExposure.ts +0 -225
- package/templates/racing/src/render/exposureGraph.ts +0 -178
- package/templates/racing/src/render/exposureReadback.ts +0 -79
- package/templates/racing/src/render/worldEnvironment.ts +0 -1212
- package/templates/rain/src/render/autoExposure.ts +0 -225
- package/templates/rain/src/render/exposureGraph.ts +0 -178
- package/templates/rain/src/render/exposureReadback.ts +0 -79
- package/templates/rain/src/render/worldEnvironment.ts +0 -1212
- package/templates/rts/src/render/autoExposure.ts +0 -225
- package/templates/rts/src/render/exposureGraph.ts +0 -178
- package/templates/rts/src/render/exposureReadback.ts +0 -79
- package/templates/rts/src/render/worldEnvironment.ts +0 -1212
- package/templates/runner/src/render/autoExposure.ts +0 -225
- package/templates/runner/src/render/exposureGraph.ts +0 -178
- package/templates/runner/src/render/exposureReadback.ts +0 -79
- package/templates/runner/src/render/worldEnvironment.ts +0 -1212
- package/templates/sailing/src/render/autoExposure.ts +0 -225
- package/templates/sailing/src/render/exposureGraph.ts +0 -178
- package/templates/sailing/src/render/exposureReadback.ts +0 -79
- package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
- package/templates/shooter/src/render/autoExposure.ts +0 -225
- package/templates/shooter/src/render/exposureGraph.ts +0 -178
- package/templates/shooter/src/render/exposureReadback.ts +0 -79
- package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
- package/templates/snow/src/render/autoExposure.ts +0 -225
- package/templates/snow/src/render/exposureGraph.ts +0 -178
- package/templates/snow/src/render/exposureReadback.ts +0 -79
- package/templates/snow/src/render/worldEnvironment.ts +0 -1212
- package/templates/starter/src/render/autoExposure.ts +0 -225
- package/templates/starter/src/render/exposureGraph.ts +0 -178
- package/templates/starter/src/render/exposureReadback.ts +0 -79
- package/templates/starter/src/render/worldEnvironment.ts +0 -1212
- package/templates/tower-defense/src/render/autoExposure.ts +0 -225
- package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
- package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
- package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
|
@@ -0,0 +1,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,12 +1,34 @@
|
|
|
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
|
// The rig is returned because `WorldEnvironment`'s godrays stage raymarches against a shadow map,
|
|
7
7
|
// so `setupPost` needs the key light itself; a shadowless one is refused by name.
|
|
8
8
|
import { Color, DirectionalLight, PCFSoftShadowMap, type Scene, Vector3 } from "three";
|
|
9
|
-
import {
|
|
9
|
+
import {
|
|
10
|
+
SUN_ILLUMINANCE,
|
|
11
|
+
SUN_KELVIN,
|
|
12
|
+
sunLight,
|
|
13
|
+
sunLightTransmittance,
|
|
14
|
+
temperatureColour,
|
|
15
|
+
} from "./atmosphere.js";
|
|
16
|
+
import { SKY_OPTIONS, SUN_DIRECTION } from "./sky.js";
|
|
17
|
+
|
|
18
|
+
/** The sun as Unreal's default level has it: 6 lux at 6500 K, tinted by the air it crosses. */
|
|
19
|
+
function atmosphereSun(): DirectionalLight {
|
|
20
|
+
const tint = temperatureColour(SUN_KELVIN);
|
|
21
|
+
const through = sunLightTransmittance(Math.asin(Math.min(1, Math.max(-1, SUN_DIRECTION.y))));
|
|
22
|
+
const colour = new Color().setRGB(
|
|
23
|
+
tint[0] * through[0],
|
|
24
|
+
tint[1] * through[1],
|
|
25
|
+
tint[2] * through[2],
|
|
26
|
+
);
|
|
27
|
+
const key = new DirectionalLight(colour, SUN_ILLUMINANCE);
|
|
28
|
+
// `gpuSky.ts` re-tints it when the sun moves.
|
|
29
|
+
sunLight.current = key;
|
|
30
|
+
return key;
|
|
31
|
+
}
|
|
10
32
|
|
|
11
33
|
type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
|
|
12
34
|
|
|
@@ -20,8 +42,8 @@ export function setupLighting(
|
|
|
20
42
|
|
|
21
43
|
// Warm white, matched by eye to the photographed midday sun against its own sky. Aimed low and
|
|
22
44
|
// down-track so it rakes across the obstacles and throws each one's shadow back toward the
|
|
23
|
-
//
|
|
24
|
-
const key = new DirectionalLight(0xfff1e0, 4.5);
|
|
45
|
+
// The photo sky keeps the warm white matched by eye to its photographed midday sun.
|
|
46
|
+
const key = SKY_OPTIONS.sky === "photo" ? new DirectionalLight(0xfff1e0, 4.5) : atmosphereSun();
|
|
25
47
|
key.position.copy(SUN_DIRECTION).multiplyScalar(30);
|
|
26
48
|
key.castShadow = true;
|
|
27
49
|
// One map fitted to what the chase camera can see from the runner: 4096² is well under a
|
|
@@ -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,
|
|
@@ -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,
|
|
@@ -3,8 +3,9 @@
|
|
|
3
3
|
//
|
|
4
4
|
// This is the one place this game decides how expensive it looks. `postprocessing.ts` reads
|
|
5
5
|
// `qualityPreset(resolveQualityTier(...))` and nothing else, so "make it run on a phone" is one
|
|
6
|
-
// file to edit rather than a hunt through anonymous literals.
|
|
7
|
-
// Environment's shared SMAA stage; see
|
|
6
|
+
// file to edit rather than a hunt through anonymous literals. `high` and `medium` anti-alias
|
|
7
|
+
// temporally (`temporalAA`) and `low` uses the World Environment's shared SMAA stage; see
|
|
8
|
+
// `screenSpaceAA` in `worldEnvironment.ts`.
|
|
8
9
|
//
|
|
9
10
|
// **Where the numbers come from.** Every millisecond below is GPU time from the per-stage
|
|
10
11
|
// ablation recorded in the engine repository's `docs/verification/runtime-perf-state.md`: Chrome
|
|
@@ -17,7 +18,14 @@
|
|
|
17
18
|
// One cost that is **not** a stage here and outweighs most of them: the prefiltered reflection
|
|
18
19
|
// probe on `scene.environment`, measured at **~6.3 ms of an 18-19 ms Pixel 8 frame**. It is set
|
|
19
20
|
// in `sky.ts`, not in this file.
|
|
20
|
-
import
|
|
21
|
+
import {
|
|
22
|
+
type IWorldEnvironmentOptions,
|
|
23
|
+
qualityPreset as coreQualityPreset,
|
|
24
|
+
qualityTiers,
|
|
25
|
+
} from "@threenative/core";
|
|
26
|
+
import { exposureSettings } from "./exposure.js";
|
|
27
|
+
export type { QualityTier } from "@threenative/core";
|
|
28
|
+
import type { QualityTier } from "@threenative/core";
|
|
21
29
|
|
|
22
30
|
/**
|
|
23
31
|
* The three names this game's look comes in.
|
|
@@ -26,119 +34,23 @@ import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
|
|
|
26
34
|
* machine that is neither: a laptop iGPU, a handheld, a desktop dropping frames. Nothing outside
|
|
27
35
|
* this file decides what any of them mean.
|
|
28
36
|
*/
|
|
29
|
-
export
|
|
37
|
+
export const resolveQualityTier = qualityTiers.resolve;
|
|
30
38
|
|
|
31
|
-
const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
|
|
32
|
-
|
|
33
|
-
/**
|
|
34
|
-
* Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
|
|
35
|
-
* `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
|
|
36
|
-
*/
|
|
37
|
-
function isQualityTier(value: string): value is QualityTier {
|
|
38
|
-
return (QUALITY_TIERS as readonly string[]).includes(value);
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
/**
|
|
42
|
-
* Where each GPU family starts, from `ctx.renderer.gpuClass`.
|
|
43
|
-
*
|
|
44
|
-
* A start, not a ceiling: the measured frame-budget windows move the look from here, and an
|
|
45
|
-
* explicit `tier` above still wins. A class absent from this table — `unknown`, an adapter no
|
|
46
|
-
* family rule matched — falls back to the `mobile` flag, exactly as before families existed.
|
|
47
|
-
* Edit the right-hand side to change what a family looks like; nothing outside this file reads it.
|
|
48
|
-
*/
|
|
49
|
-
const START_TIER_BY_GPU_CLASS: Readonly<Record<string, QualityTier | undefined>> = {
|
|
50
|
-
software: "low",
|
|
51
|
-
"mobile-low": "low",
|
|
52
|
-
"mobile-mid": "low",
|
|
53
|
-
"mobile-high": "medium",
|
|
54
|
-
integrated: "medium",
|
|
55
|
-
discrete: "high",
|
|
56
|
-
};
|
|
57
|
-
|
|
58
|
-
/**
|
|
59
|
-
* Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
|
|
60
|
-
*
|
|
61
|
-
* Fails closed. An unrecognised tier name throws with the value it was handed rather than
|
|
62
|
-
* quietly rendering the default, because a silent fallback here looks exactly like a tier that
|
|
63
|
-
* turned out to have no effect.
|
|
64
|
-
*/
|
|
65
|
-
export function resolveQualityTier(
|
|
66
|
-
request: {
|
|
67
|
-
readonly gpuClass?: string;
|
|
68
|
-
readonly mobile?: boolean;
|
|
69
|
-
readonly software?: boolean;
|
|
70
|
-
readonly tier?: string;
|
|
71
|
-
} = {},
|
|
72
|
-
): QualityTier {
|
|
73
|
-
const requested = request.tier;
|
|
74
|
-
if (requested !== undefined) {
|
|
75
|
-
if (!isQualityTier(requested)) {
|
|
76
|
-
throw new Error(
|
|
77
|
-
`Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
78
|
-
);
|
|
79
|
-
}
|
|
80
|
-
return requested;
|
|
81
|
-
}
|
|
82
|
-
// A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
|
|
83
|
-
// game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
|
|
84
|
-
// drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
|
|
85
|
-
// fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
|
|
86
|
-
// `tier` above still wins over it.
|
|
87
|
-
if (request.software === true) return "low";
|
|
88
|
-
const family =
|
|
89
|
-
request.gpuClass === undefined ? undefined : START_TIER_BY_GPU_CLASS[request.gpuClass];
|
|
90
|
-
if (family !== undefined) return family;
|
|
91
|
-
return request.mobile === true ? "low" : "high";
|
|
92
|
-
}
|
|
93
|
-
|
|
94
|
-
/**
|
|
95
|
-
* The look every tier shares: a wide, faint glow on what is genuinely brighter than white rather
|
|
96
|
-
* than a haze over the frame (a threshold under 1 blooms lit grey surfaces and flattens
|
|
97
|
-
* contrast), a corner falloff, and the tone curve. Antialiasing (SMAA) is on in every tier that
|
|
98
|
-
* installs a chain.
|
|
99
|
-
*/
|
|
100
|
-
const shared: IWorldEnvironmentOptions = {
|
|
101
|
-
// Bloom: ~4.6 ms in the reference ablation — the second most expensive stage there.
|
|
102
|
-
bloomEnabled: true,
|
|
103
|
-
bloomRadius: 0.6,
|
|
104
|
-
bloomStrength: 0.22,
|
|
105
|
-
bloomThreshold: 1,
|
|
106
|
-
autoExposureEnabled: false,
|
|
107
|
-
exposure: 0.62,
|
|
108
|
-
tonemapMode: "aces",
|
|
109
|
-
vignetteAmount: 0.22,
|
|
110
|
-
};
|
|
111
|
-
|
|
112
|
-
/**
|
|
113
|
-
* What a desktop gets: contact occlusion on top — the dark line where the runner meets the track
|
|
114
|
-
* and an obstacle meets the ground, most of what separates "objects in a world" from "objects
|
|
115
|
-
* pasted on a background". Gathered at full resolution and denoised: at half, the upsample left a
|
|
116
|
-
* grain around every foot.
|
|
117
|
-
*/
|
|
118
|
-
const high: IWorldEnvironmentOptions = {
|
|
119
|
-
...shared,
|
|
120
|
-
// GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
|
|
121
|
-
gtaoEnabled: true,
|
|
122
|
-
gtaoRadius: 0.35,
|
|
123
|
-
};
|
|
124
|
-
|
|
125
|
-
/** The rung in between: the same occlusion at half the directions. Saving unmeasured. */
|
|
126
|
-
const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8, renderChainTier: "medium" };
|
|
127
|
-
|
|
128
|
-
/** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
|
|
129
|
-
const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
|
|
130
|
-
|
|
131
|
-
const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
|
|
132
|
-
|
|
133
|
-
/** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
|
|
134
39
|
export function qualityPreset(tier: string): IWorldEnvironmentOptions {
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
40
|
+
// Core high measured 51.3/52 ms p95 against 33 ms; retain the core curve and meter at medium.
|
|
41
|
+
const renderTier = tier === "high" ? "medium" : tier;
|
|
42
|
+
if (renderTier !== tier)
|
|
43
|
+
console.info("TN_RENDER_CHAIN_TIER_OVERRIDE high->medium: 52 ms p95 exceeded 33 ms");
|
|
44
|
+
return {
|
|
45
|
+
...coreQualityPreset(renderTier),
|
|
46
|
+
// Rough track needs no SSR; retain 33 ms p95 (real-display runs: 17.0/20.3 ms).
|
|
47
|
+
ssrEnabled: false,
|
|
48
|
+
// Keep Runner’s authored foot-contact radius under the core curve.
|
|
49
|
+
gtaoRadius: 0.35,
|
|
50
|
+
// The Three.js fallback uses SMAA; retain authored MSAA for the thin track rails.
|
|
51
|
+
samples: 4,
|
|
52
|
+
exposurePolicy: exposureSettings,
|
|
53
|
+
};
|
|
142
54
|
}
|
|
143
55
|
|
|
144
56
|
/** First admitted material lane: high desktop hardware WebGPU in the browser only. */
|
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
2
|
//
|
|
3
|
+
// The default sky is Unreal 5.8.3's default level: a Sky Atmosphere with its volumetric cloud layer, a
|
|
4
|
+
// sky light that captures it, a sun tinted by the air it crosses, and an exponential height fog that
|
|
5
|
+
// takes its colour from the sky (`atmosphere.ts`, `clouds.ts`, `gpuSky.ts`). Sun, sky and fog read one
|
|
6
|
+
// illuminance, so moving `SUN_DIRECTION` recolours all three together. `SKY_OPTIONS.sky = "photo"`
|
|
7
|
+
// keeps the photograph below; `clouds: false` keeps a clear sky.
|
|
8
|
+
//
|
|
3
9
|
// The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
|
|
4
10
|
// by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
|
|
5
11
|
// The same image is the background, the environment light every surface reflects and is filled by,
|
|
@@ -13,6 +19,7 @@ import {
|
|
|
13
19
|
type Texture,
|
|
14
20
|
Vector3,
|
|
15
21
|
} from "three";
|
|
22
|
+
import { createGpuSky } from "./gpuSky.js";
|
|
16
23
|
import { HEIGHT_FOG, type HeightFogParams, heightFogDepth, heightFogNode } from "./heightFog.js";
|
|
17
24
|
import { palette } from "./palette.js";
|
|
18
25
|
|
|
@@ -42,7 +49,7 @@ function distanceDensity(p: HeightFogParams = HEIGHT_FOG): number {
|
|
|
42
49
|
return Math.sqrt(Math.max(0, old - height)) / distance;
|
|
43
50
|
}
|
|
44
51
|
|
|
45
|
-
|
|
52
|
+
function setupPhotoSky(scene: Scene, sky: Texture): void {
|
|
46
53
|
sky.mapping = EquirectangularReflectionMapping;
|
|
47
54
|
sky.colorSpace = SRGBColorSpace;
|
|
48
55
|
scene.background = sky;
|
|
@@ -60,3 +67,68 @@ export function setupSky(scene: Scene, sky: Texture): void {
|
|
|
60
67
|
scene.fog = distanceFog;
|
|
61
68
|
scene.fogNode = heightFogNode(distanceFog, HEIGHT_FOG, SUN_DIRECTION);
|
|
62
69
|
}
|
|
70
|
+
|
|
71
|
+
export const SKY_OPTIONS: { sky: "atmosphere" | "photo"; clouds: boolean; ground: boolean } = {
|
|
72
|
+
sky: "atmosphere",
|
|
73
|
+
clouds: true,
|
|
74
|
+
// The sunlit ground below the horizon stands in for Unreal's Lumen floor bounce: it lifts shadow
|
|
75
|
+
// sides and a mirror reflects it. Set false when the game adds its own global illumination.
|
|
76
|
+
ground: true,
|
|
77
|
+
};
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* Unreal's default level fog in metres: density and falloff are per 1000 cm (x0.1 per metre), and its
|
|
81
|
+
* line integral carries ln2 against the exact integral `heightFog.ts` evaluates. `fogHeight` sits
|
|
82
|
+
* 68.5 m below the floor, where the default level puts the fog actor. Inscattering is black and the
|
|
83
|
+
* start distance 0, as in Unreal: the colour comes from the sky.
|
|
84
|
+
*/
|
|
85
|
+
const ATMOSPHERE_FOG = {
|
|
86
|
+
...HEIGHT_FOG,
|
|
87
|
+
density: 0.00436 * Math.LN2,
|
|
88
|
+
heightFalloff: 0.02,
|
|
89
|
+
fogHeight: -68.5,
|
|
90
|
+
startDistance: 0,
|
|
91
|
+
};
|
|
92
|
+
|
|
93
|
+
/** White in the 8-bit environment is this much scene radiance (`createGpuSky`). */
|
|
94
|
+
const ENVIRONMENT_RANGE = 4;
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* `photo` is only read when `SKY_OPTIONS.sky` is "photo". `fogged` false leaves the sky unfogged;
|
|
98
|
+
* `clouds` false draws the clear atmosphere. A software adapter draws the 64 x 32 bake as the
|
|
99
|
+
* background, with no LUT or cloud passes.
|
|
100
|
+
*/
|
|
101
|
+
export function setupSky(
|
|
102
|
+
scene: Scene,
|
|
103
|
+
photo?: Texture,
|
|
104
|
+
software = false,
|
|
105
|
+
fogged = true,
|
|
106
|
+
clouds = SKY_OPTIONS.clouds,
|
|
107
|
+
): void {
|
|
108
|
+
if (SKY_OPTIONS.sky === "photo") {
|
|
109
|
+
if (photo === undefined) throw new Error('SKY_OPTIONS.sky "photo" needs assets/sky.jpg loaded');
|
|
110
|
+
setupPhotoSky(scene, photo);
|
|
111
|
+
return;
|
|
112
|
+
}
|
|
113
|
+
// Height fog only; FogExp2 holds the colour `heightFogNode` reads, at zero density. `createGpuSky`
|
|
114
|
+
// sets that colour from the sky and again whenever the sun moves.
|
|
115
|
+
const fog = new FogExp2(0xffffff, 0);
|
|
116
|
+
scene.fog = fog;
|
|
117
|
+
scene.fogNode = heightFogNode(fog, { ...ATMOSPHERE_FOG }, SUN_DIRECTION);
|
|
118
|
+
const { node, environment } = createGpuSky(
|
|
119
|
+
scene,
|
|
120
|
+
SUN_DIRECTION,
|
|
121
|
+
fogged,
|
|
122
|
+
clouds,
|
|
123
|
+
ATMOSPHERE_FOG,
|
|
124
|
+
SKY_OPTIONS.ground,
|
|
125
|
+
);
|
|
126
|
+
environment.mapping = EquirectangularReflectionMapping;
|
|
127
|
+
environment.colorSpace = SRGBColorSpace;
|
|
128
|
+
scene.background = environment;
|
|
129
|
+
scene.backgroundNode = software ? null : node.backgroundNode;
|
|
130
|
+
scene.backgroundIntensity = software ? ENVIRONMENT_RANGE : 1;
|
|
131
|
+
// Unreal's sky light: the same sky, so the fill on every shaded face is the sky's colour.
|
|
132
|
+
scene.environment = environment;
|
|
133
|
+
scene.environmentIntensity = ENVIRONMENT_RANGE;
|
|
134
|
+
}
|
|
@@ -10,7 +10,7 @@ import {
|
|
|
10
10
|
isTouchscreenAvailable,
|
|
11
11
|
} from "@threenative/core";
|
|
12
12
|
import { type PerspectiveCamera, type Texture, Vector3 } from "three";
|
|
13
|
-
import { type IRunnerModel, Runner } from "../entities/Runner.js";
|
|
13
|
+
import { HITBOX, type IRunnerModel, Runner } from "../entities/Runner.js";
|
|
14
14
|
import type { RunnerPhysics } from "../physics.js";
|
|
15
15
|
import { chaseRunner, setupCamera } from "../render/camera.js";
|
|
16
16
|
import { createDustTrail } from "../render/dust.js";
|
|
@@ -24,10 +24,11 @@ import {
|
|
|
24
24
|
isWebGLFallbackRenderer,
|
|
25
25
|
materialLightingEnabled,
|
|
26
26
|
} from "../render/quality.js";
|
|
27
|
-
import {
|
|
27
|
+
import { OBSTACLE_SIZE } from "../render/shapes.js";
|
|
28
|
+
import { SKY_OPTIONS, setupSky } from "../render/sky.js";
|
|
28
29
|
import { TouchControls } from "../render/touch-controls.js";
|
|
29
30
|
import { type GameState, INITIAL_STATE } from "../state.js";
|
|
30
|
-
import {
|
|
31
|
+
import { Track } from "../track.js";
|
|
31
32
|
|
|
32
33
|
export type GameCtx = ICtx<GameState, RunnerPhysics>;
|
|
33
34
|
|
|
@@ -35,6 +36,8 @@ const START_SPEED = 11;
|
|
|
35
36
|
const TOP_SPEED = 26;
|
|
36
37
|
/** Metres per second gained per second run. Reach top speed at about a minute. */
|
|
37
38
|
const ACCELERATION = 0.25;
|
|
39
|
+
/** Metres either side of an obstacle's centre where the runner is level with it (its depth plus the hitbox's). */
|
|
40
|
+
const NEAR_MISS_REACH = (OBSTACLE_SIZE.depth + HITBOX.depth) / 2;
|
|
38
41
|
|
|
39
42
|
export class Run extends Scene<GameState, RunnerPhysics> {
|
|
40
43
|
static override readonly initialState = INITIAL_STATE;
|
|
@@ -49,9 +52,10 @@ export class Run extends Scene<GameState, RunnerPhysics> {
|
|
|
49
52
|
override async load(ctx: GameCtx): Promise<void> {
|
|
50
53
|
[this.#model, this.#sky] = await Promise.all([
|
|
51
54
|
ctx.assets.model<IRunnerModel>("mannequin.glb"),
|
|
52
|
-
|
|
55
|
+
// Only the photo-sky override reads the photograph; the atmosphere sky is computed.
|
|
56
|
+
SKY_OPTIONS.sky === "photo" ? ctx.assets.texture("sky.jpg") : undefined,
|
|
53
57
|
]);
|
|
54
|
-
setupSky(ctx.scene, this.#sky);
|
|
58
|
+
setupSky(ctx.scene, this.#sky, ctx.renderer.softwareAdapter !== undefined);
|
|
55
59
|
this.#environmentSample = await sampleEnvironment(ctx.renderer.raw, ctx.scene, {
|
|
56
60
|
web: getPlatform().runtime === "web",
|
|
57
61
|
rendererKind: ctx.renderer.kind,
|
|
@@ -62,9 +66,9 @@ export class Run extends Scene<GameState, RunnerPhysics> {
|
|
|
62
66
|
}
|
|
63
67
|
|
|
64
68
|
override enter(ctx: GameCtx): SceneFrame<GameState, RunnerPhysics> {
|
|
65
|
-
if (this.#model === undefined
|
|
66
|
-
throw new Error("Run.enter ran before load() loaded mannequin.glb
|
|
67
|
-
setupSky(ctx.scene, this.#sky);
|
|
69
|
+
if (this.#model === undefined)
|
|
70
|
+
throw new Error("Run.enter ran before load() loaded mannequin.glb.");
|
|
71
|
+
setupSky(ctx.scene, this.#sky, ctx.renderer.softwareAdapter !== undefined);
|
|
68
72
|
const { key } = setupLighting(
|
|
69
73
|
ctx.scene,
|
|
70
74
|
ctx.renderer.raw as Parameters<typeof setupLighting>[1],
|
|
@@ -176,14 +180,14 @@ export class Run extends Scene<GameState, RunnerPhysics> {
|
|
|
176
180
|
status = "CRASHED";
|
|
177
181
|
shake.trigger();
|
|
178
182
|
} else {
|
|
179
|
-
// A near miss is an obstacle
|
|
180
|
-
// once per obstacle is what stops a single block shaking the camera for a whole second
|
|
183
|
+
// A near miss is an obstacle the runner passed beside rather than through. Counting it
|
|
184
|
+
// once per obstacle is what stops a single block shaking the camera for a whole second;
|
|
185
|
+
// testing real obstacles, not every lane, is what stops an empty road scoring one.
|
|
181
186
|
for (const chunk of track.chunks) {
|
|
182
|
-
const
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
if (scored.has(key) || !runner.isNearMiss(lane)) continue;
|
|
187
|
+
for (const [index, obstacle] of chunk.obstacles.entries()) {
|
|
188
|
+
if (Math.abs(distance - obstacle.distance) > NEAR_MISS_REACH) continue;
|
|
189
|
+
const key = `${chunk.start}:${index}`;
|
|
190
|
+
if (scored.has(key) || !runner.isNearMiss(obstacle.x)) continue;
|
|
187
191
|
scored.add(key);
|
|
188
192
|
runner.recordNearMiss();
|
|
189
193
|
nearMisses = runner.nearMisses;
|
|
@@ -25,8 +25,8 @@ export const MAX_OBSTACLES = 4;
|
|
|
25
25
|
export const LANE_X = [-LANE_WIDTH, 0, LANE_WIDTH] as const;
|
|
26
26
|
/** No obstacles this close to the start, so the first seconds teach the controls. */
|
|
27
27
|
const GRACE_METRES = 34;
|
|
28
|
-
/** Where an unused slot goes:
|
|
29
|
-
const PARKED = new Matrix4().makeScale(0, 0, 0)
|
|
28
|
+
/** Where an unused slot goes: scaled to nothing at the chunk's centre, so it keeps the bounds tight. */
|
|
29
|
+
const PARKED = new Matrix4().makeScale(0, 0, 0);
|
|
30
30
|
|
|
31
31
|
export interface IChunkContext {
|
|
32
32
|
readonly physics: RunnerPhysics;
|
|
@@ -55,6 +55,8 @@ export class Chunk {
|
|
|
55
55
|
readonly #bodies: RigidBody3D[] = [];
|
|
56
56
|
readonly #obstacles: ReturnType<InstancedBatch["build"]>;
|
|
57
57
|
readonly #matrix = new Matrix4();
|
|
58
|
+
/** This stretch's obstacles: lane x and the run distance at their centre. */
|
|
59
|
+
readonly obstacles: { x: number; distance: number }[] = [];
|
|
58
60
|
#start = 0;
|
|
59
61
|
|
|
60
62
|
constructor(
|
|
@@ -81,6 +83,7 @@ export class Chunk {
|
|
|
81
83
|
this.group.position.z = -(start + CHUNK_LENGTH / 2);
|
|
82
84
|
for (const body of this.#bodies) body.dispose();
|
|
83
85
|
this.#bodies.length = 0;
|
|
86
|
+
this.obstacles.length = 0;
|
|
84
87
|
|
|
85
88
|
let placed = 0;
|
|
86
89
|
if (start >= GRACE_METRES) {
|
|
@@ -95,6 +98,7 @@ export class Chunk {
|
|
|
95
98
|
this.#matrix.identity().setPosition(laneX, OBSTACLE_SIZE.height / 2, localZ),
|
|
96
99
|
);
|
|
97
100
|
placed += 1;
|
|
101
|
+
this.obstacles.push({ x: laneX, distance: -(this.group.position.z + localZ) });
|
|
98
102
|
this.#bodies.push(
|
|
99
103
|
new RigidBody3D({
|
|
100
104
|
collisionLayer: OBSTACLE_LAYER,
|
|
@@ -119,7 +123,12 @@ export class Chunk {
|
|
|
119
123
|
for (let slot = placed; slot < MAX_OBSTACLES; slot += 1) {
|
|
120
124
|
this.#obstacles?.setMatrixAt(slot, PARKED);
|
|
121
125
|
}
|
|
122
|
-
if (this.#obstacles !== undefined)
|
|
126
|
+
if (this.#obstacles !== undefined) {
|
|
127
|
+
this.#obstacles.instanceMatrix.needsUpdate = true;
|
|
128
|
+
// Three.js culls an InstancedMesh by the bounds it last computed. Those were taken around the
|
|
129
|
+
// parked slots, so without this every rewritten obstacle was culled: unseen, still solid.
|
|
130
|
+
this.#obstacles.computeBoundingSphere();
|
|
131
|
+
}
|
|
123
132
|
}
|
|
124
133
|
|
|
125
134
|
dispose(): void {
|
|
@@ -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
|
}
|
|
@@ -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
|
}
|
|
@@ -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
|
}
|
|
@@ -25,11 +25,18 @@
|
|
|
25
25
|
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
26
26
|
]
|
|
27
27
|
},
|
|
28
|
-
"threenative-
|
|
28
|
+
"threenative-animation": {
|
|
29
29
|
"type": "stdio",
|
|
30
30
|
"command": "node",
|
|
31
31
|
"args": [
|
|
32
|
-
"./node_modules/@threenative/core/mcp/
|
|
32
|
+
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
33
|
+
]
|
|
34
|
+
},
|
|
35
|
+
"threenative-devtools": {
|
|
36
|
+
"type": "stdio",
|
|
37
|
+
"command": "node",
|
|
38
|
+
"args": [
|
|
39
|
+
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
33
40
|
]
|
|
34
41
|
}
|
|
35
42
|
}
|
|
@@ -25,11 +25,18 @@
|
|
|
25
25
|
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
26
26
|
]
|
|
27
27
|
},
|
|
28
|
-
"threenative-
|
|
28
|
+
"threenative-animation": {
|
|
29
29
|
"source": "custom",
|
|
30
30
|
"command": "node",
|
|
31
31
|
"args": [
|
|
32
|
-
"./node_modules/@threenative/core/mcp/
|
|
32
|
+
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
33
|
+
]
|
|
34
|
+
},
|
|
35
|
+
"threenative-devtools": {
|
|
36
|
+
"source": "custom",
|
|
37
|
+
"command": "node",
|
|
38
|
+
"args": [
|
|
39
|
+
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
33
40
|
]
|
|
34
41
|
}
|
|
35
42
|
}
|