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
|
@@ -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
|
|
|
@@ -32,8 +54,9 @@ export function setupLighting(
|
|
|
32
54
|
renderer.shadowMap.enabled = true;
|
|
33
55
|
renderer.shadowMap.type = PCFSoftShadowMap;
|
|
34
56
|
|
|
35
|
-
// Warm white, matched by eye to the photographed midday sun against its own sky
|
|
36
|
-
|
|
57
|
+
// Warm white, matched by eye to the photographed midday sun against its own sky (owner
|
|
58
|
+
// The photo sky keeps the warm white matched by eye to its photographed midday sun.
|
|
59
|
+
const key = SKY_OPTIONS.sky === "photo" ? new DirectionalLight(0xfff1e0, 4.5) : atmosphereSun();
|
|
37
60
|
// The light sits outside the map's own box, so its near plane is not inside the town.
|
|
38
61
|
key.position.copy(SUN_DIRECTION).multiplyScalar(halfExtent * 2);
|
|
39
62
|
key.castShadow = true;
|
|
@@ -65,7 +65,15 @@ export function createMaterialAssignments(scene: Scene, controls: IBacklightCont
|
|
|
65
65
|
converted.delete(source);
|
|
66
66
|
}
|
|
67
67
|
function unsupported(material: Material): string | undefined {
|
|
68
|
-
|
|
68
|
+
// A town surface (`surface.ts`) is a standard node material with no emission of its own, so it
|
|
69
|
+
// takes the same rim and fill: the copy keeps its colour and roughness nodes.
|
|
70
|
+
const surface =
|
|
71
|
+
(material as { isMeshStandardNodeMaterial?: boolean }).isMeshStandardNodeMaterial === true &&
|
|
72
|
+
(material as { emissiveNode?: unknown }).emissiveNode === null;
|
|
73
|
+
if (
|
|
74
|
+
!surface &&
|
|
75
|
+
(!(material instanceof MeshStandardMaterial) || material.type !== "MeshStandardMaterial")
|
|
76
|
+
)
|
|
69
77
|
return "unsupported material type";
|
|
70
78
|
if (
|
|
71
79
|
material.onBeforeCompile !== Material.prototype.onBeforeCompile ||
|
|
@@ -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,
|
|
@@ -49,9 +49,17 @@ export class BoxOccluders {
|
|
|
49
49
|
return this.#boxes.length;
|
|
50
50
|
}
|
|
51
51
|
|
|
52
|
-
/**
|
|
53
|
-
|
|
52
|
+
/**
|
|
53
|
+
* True when nothing solid stands between `from` and `to`.
|
|
54
|
+
*
|
|
55
|
+
* With `into`, every crossed box is appended to it and the walk does not stop at the first
|
|
56
|
+
* one: the caller needs the whole set to narrow its exact test to the pieces standing there.
|
|
57
|
+
* A crossed box is conservative — the deck colliders span the open air beneath a walkway —
|
|
58
|
+
* so it is a candidate list, not the answer.
|
|
59
|
+
*/
|
|
60
|
+
clear(from: Vector3, to: Vector3, into?: TownCollider[]): boolean {
|
|
54
61
|
this.#tests += 1;
|
|
62
|
+
into?.splice(0, into.length);
|
|
55
63
|
const dx = to.x - from.x;
|
|
56
64
|
const dy = to.y - from.y;
|
|
57
65
|
const dz = to.z - from.z;
|
|
@@ -97,9 +105,10 @@ export class BoxOccluders {
|
|
|
97
105
|
if (tEnter > tExit) continue;
|
|
98
106
|
|
|
99
107
|
// The segment enters this box before it ends: something solid is in the way.
|
|
100
|
-
return false;
|
|
108
|
+
if (into === undefined) return false;
|
|
109
|
+
into.push(box);
|
|
101
110
|
}
|
|
102
|
-
return
|
|
111
|
+
return into === undefined || into.length === 0;
|
|
103
112
|
}
|
|
104
113
|
|
|
105
114
|
debug(): { boxes: number; tests: number } {
|
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
// Generated for you. Keep these roles coherent when you change the look.
|
|
2
2
|
// Neutral greys carry the light; one saturated blue marks what you can touch.
|
|
3
3
|
export const palette = {
|
|
4
|
+
// Neutral grey ground: owner 2026-10-26 prefers the 7b546d6 look to the beige 0x9b9185.
|
|
4
5
|
floor: 0xb4b1ae,
|
|
5
6
|
structure: 0x747578,
|
|
6
7
|
gridLine: 0x3a3a3c,
|
|
@@ -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,
|
|
@@ -24,7 +24,14 @@
|
|
|
24
24
|
// frame. With the gather on, `playtests/play.playtest.json` measured **34.2 ms p95 against the
|
|
25
25
|
// 33 ms ceiling**; without it the same scenario passes. Turn it on when you replace the
|
|
26
26
|
// atmosphere with a flat sky, and read the p95 back out of `TN_FRAME_BUDGET`.
|
|
27
|
-
import
|
|
27
|
+
import {
|
|
28
|
+
type IWorldEnvironmentOptions,
|
|
29
|
+
qualityPreset as coreQualityPreset,
|
|
30
|
+
qualityTiers,
|
|
31
|
+
} from "@threenative/core";
|
|
32
|
+
import { exposureSettings } from "./exposure.js";
|
|
33
|
+
export type { QualityTier } from "@threenative/core";
|
|
34
|
+
import type { QualityTier } from "@threenative/core";
|
|
28
35
|
|
|
29
36
|
/**
|
|
30
37
|
* The three names this game's look comes in.
|
|
@@ -34,123 +41,58 @@ import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
|
|
|
34
41
|
* laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
|
|
35
42
|
* what any of them mean.
|
|
36
43
|
*/
|
|
37
|
-
export
|
|
38
|
-
|
|
39
|
-
const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
|
|
44
|
+
export const resolveQualityTier = qualityTiers.resolve;
|
|
40
45
|
|
|
41
46
|
/**
|
|
42
|
-
*
|
|
43
|
-
*
|
|
47
|
+
* Named overrides of core's Unreal look: the owner (2026-10-26) prefers the 7b546d6 neutral look,
|
|
48
|
+
* white plaster and grey ground with no yellow cast. `TN_WORLD_ENVIRONMENT` reports the tone curve,
|
|
49
|
+
* the exposure and the gather this runs; delete a line to take core's value back.
|
|
44
50
|
*/
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
/**
|
|
50
|
-
* Where each GPU family starts, from `ctx.renderer.gpuClass`.
|
|
51
|
-
*
|
|
52
|
-
* A start, not a ceiling: the measured frame-budget windows move the look from here, and an
|
|
53
|
-
* explicit `tier` above still wins. A class absent from this table — `unknown`, an adapter no
|
|
54
|
-
* family rule matched — falls back to the `mobile` flag, exactly as before families existed.
|
|
55
|
-
* Edit the right-hand side to change what a family looks like; nothing outside this file reads it.
|
|
56
|
-
*/
|
|
57
|
-
const START_TIER_BY_GPU_CLASS: Readonly<Record<string, QualityTier | undefined>> = {
|
|
58
|
-
software: "low",
|
|
59
|
-
"mobile-low": "low",
|
|
60
|
-
"mobile-mid": "low",
|
|
61
|
-
"mobile-high": "medium",
|
|
62
|
-
integrated: "medium",
|
|
63
|
-
discrete: "high",
|
|
64
|
-
};
|
|
65
|
-
|
|
66
|
-
/**
|
|
67
|
-
* Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
|
|
68
|
-
*
|
|
69
|
-
* Fails closed. An unrecognised tier name throws with the value it was handed rather than
|
|
70
|
-
* quietly rendering the default, because a silent fallback here looks exactly like a tier that
|
|
71
|
-
* turned out to have no effect.
|
|
72
|
-
*/
|
|
73
|
-
export function resolveQualityTier(
|
|
74
|
-
request: {
|
|
75
|
-
readonly gpuClass?: string;
|
|
76
|
-
readonly mobile?: boolean;
|
|
77
|
-
readonly software?: boolean;
|
|
78
|
-
readonly tier?: string;
|
|
79
|
-
} = {},
|
|
80
|
-
): QualityTier {
|
|
81
|
-
const requested = request.tier;
|
|
82
|
-
if (requested !== undefined) {
|
|
83
|
-
if (!isQualityTier(requested)) {
|
|
84
|
-
throw new Error(
|
|
85
|
-
`Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
86
|
-
);
|
|
87
|
-
}
|
|
88
|
-
return requested;
|
|
89
|
-
}
|
|
90
|
-
// A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
|
|
91
|
-
// game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
|
|
92
|
-
// drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
|
|
93
|
-
// fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
|
|
94
|
-
// `tier` above still wins over it.
|
|
95
|
-
if (request.software === true) return "low";
|
|
96
|
-
const family =
|
|
97
|
-
request.gpuClass === undefined ? undefined : START_TIER_BY_GPU_CLASS[request.gpuClass];
|
|
98
|
-
if (family !== undefined) return family;
|
|
99
|
-
return request.mobile === true ? "low" : "high";
|
|
100
|
-
}
|
|
101
|
-
|
|
102
|
-
/**
|
|
103
|
-
* The look every tier shares: a wide, faint glow on what is genuinely brighter than white — the sun
|
|
104
|
-
* disk, the visor — rather than a haze over the frame (a threshold under 1 blooms lit grey walls and
|
|
105
|
-
* flattens contrast), and a corner falloff. Antialiasing is on in every tier that installs a chain;
|
|
106
|
-
* see `screenSpaceAA` in `worldEnvironment.ts`.
|
|
107
|
-
*
|
|
108
|
-
* No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
|
|
109
|
-
* captured sky (`sky.ts`), and SSR on rough floors traced speckle into the grid; RCAS then rang the
|
|
110
|
-
* smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
|
|
111
|
-
*/
|
|
112
|
-
const shared: IWorldEnvironmentOptions = {
|
|
113
|
-
// Bloom: ~4.6 ms in the reference ablation — the second most expensive stage there.
|
|
114
|
-
bloomEnabled: true,
|
|
115
|
-
bloomRadius: 0.6,
|
|
116
|
-
bloomStrength: 0.22,
|
|
117
|
-
bloomThreshold: 1,
|
|
51
|
+
export const neutralLook: IWorldEnvironmentOptions = {
|
|
52
|
+
// ACES at a fixed exposure: core's filmic curve and metered exposure read yellowish on this town.
|
|
53
|
+
tonemapMode: "aces",
|
|
118
54
|
autoExposureEnabled: false,
|
|
119
55
|
exposure: 0.62,
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
// GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
|
|
133
|
-
gtaoEnabled: true,
|
|
56
|
+
// The kit's bloom: a low threshold that lifts the sunlit whitewash a little.
|
|
57
|
+
bloomRadius: 0.5,
|
|
58
|
+
bloomStrength: 0.7,
|
|
59
|
+
bloomThreshold: 0.2,
|
|
60
|
+
// No screen-probe gather or reflections: the bounce off the sunlit ground tints the shade warm.
|
|
61
|
+
finalGatherMethod: "none",
|
|
62
|
+
ssgiEnabled: false,
|
|
63
|
+
ssrEnabled: false,
|
|
64
|
+
// The kit's contact occlusion: whole-frame, a 0.35 m reach, 16 directions (8 on medium).
|
|
65
|
+
gtaoDistanceExponent: 1,
|
|
66
|
+
gtaoDistanceFalloff: 1,
|
|
67
|
+
gtaoIndirectOnly: false,
|
|
134
68
|
gtaoRadius: 0.35,
|
|
69
|
+
gtaoSamples: 16,
|
|
70
|
+
// 4x MSAA under the chain on every tier.
|
|
71
|
+
samples: 4,
|
|
72
|
+
// No motion blur, on any tier. Core's is Unreal's (UE 5.8.3: Engine/Source/Runtime/Engine/
|
|
73
|
+
// Private/Scene.cpp:646-648, amount 0.5, 5 % cap, 30 fps target), and Unreal scales it by the
|
|
74
|
+
// frame time (Renderer/Private/SceneVisibility.cpp:5650-5658): on a 144 Hz display a moderate
|
|
75
|
+
// mouse turn smears the whole frame to the cap, and aiming is reading that frame. The hands and
|
|
76
|
+
// rifle are skinned, and the engine gives a skinned draw the camera's motion, so they smeared
|
|
77
|
+
// like the far wall; Unreal keeps them sharp with first-person velocity
|
|
78
|
+
// (Engine/Shaders/Private/VelocityShader.usf:74-82). `motionBlurEnabled: true` brings it back.
|
|
79
|
+
motionBlurEnabled: false,
|
|
135
80
|
};
|
|
136
81
|
|
|
137
|
-
/** The
|
|
138
|
-
const
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
|
|
82
|
+
/** The 7b546d6 per-tier values: half the occlusion directions on medium, none of it on a phone. */
|
|
83
|
+
const neutralTiers: Readonly<Record<string, IWorldEnvironmentOptions>> = {
|
|
84
|
+
high: {},
|
|
85
|
+
medium: { gtaoSamples: 8 },
|
|
86
|
+
low: { gtaoEnabled: false, gtaoRadius: 0.25, motionBlurEnabled: false, temporalAA: false },
|
|
87
|
+
};
|
|
144
88
|
|
|
145
|
-
/** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
|
|
146
89
|
export function qualityPreset(tier: string): IWorldEnvironmentOptions {
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
}
|
|
153
|
-
return preset;
|
|
90
|
+
return {
|
|
91
|
+
...coreQualityPreset(tier),
|
|
92
|
+
...neutralLook,
|
|
93
|
+
...neutralTiers[tier],
|
|
94
|
+
exposurePolicy: exposureSettings,
|
|
95
|
+
};
|
|
154
96
|
}
|
|
155
97
|
|
|
156
98
|
/** First admitted material lane: high desktop hardware WebGPU in the browser only. */
|
|
@@ -1,14 +1,3 @@
|
|
|
1
|
-
// The one place a real-world size is declared.
|
|
2
|
-
//
|
|
3
|
-
// One metre is one metre. Everything that builds or measures a physical object imports
|
|
4
|
-
// from here, so the game renders at the right size. A model that arrives in centimetres is
|
|
5
|
-
// normalised on load — never accommodated by tuning a literal beside it.
|
|
6
|
-
//
|
|
7
|
-
// This file is why the 2.68 m soldier, the 1.19 m AK and the 1.43 m viewmodel cannot
|
|
8
|
-
// come back: there is no second place to write a size.
|
|
9
|
-
|
|
10
|
-
import type { Object3D } from "three";
|
|
11
|
-
|
|
12
1
|
/** Real-world sizes, in metres. */
|
|
13
2
|
export const scale = {
|
|
14
3
|
/** Adult soldier, boots to head-top. */
|
|
@@ -1,11 +1,18 @@
|
|
|
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,
|
|
6
12
|
// and — through `SUN_DIRECTION` — the direction the sun's shadows fall. Swap the file for any
|
|
7
13
|
// equirectangular sky and re-aim `SUN_DIRECTION` at its sun.
|
|
8
14
|
import {
|
|
15
|
+
CanvasTexture,
|
|
9
16
|
EquirectangularReflectionMapping,
|
|
10
17
|
FogExp2,
|
|
11
18
|
SRGBColorSpace,
|
|
@@ -13,6 +20,7 @@ import {
|
|
|
13
20
|
type Texture,
|
|
14
21
|
Vector3,
|
|
15
22
|
} from "three";
|
|
23
|
+
import { createGpuSky } from "./gpuSky.js";
|
|
16
24
|
import { HEIGHT_FOG, type HeightFogParams, heightFogDepth, heightFogNode } from "./heightFog.js";
|
|
17
25
|
import { palette } from "./palette.js";
|
|
18
26
|
|
|
@@ -42,15 +50,43 @@ function distanceDensity(p: HeightFogParams = HEIGHT_FOG): number {
|
|
|
42
50
|
return Math.sqrt(Math.max(0, old - height)) / distance;
|
|
43
51
|
}
|
|
44
52
|
|
|
45
|
-
|
|
53
|
+
/**
|
|
54
|
+
* The environment light needs no more than 1024x512 of the 4096x2048 sky: three bakes an
|
|
55
|
+
* equirectangular source into a cube a quarter of its width, so the full image makes a 1024 cube and
|
|
56
|
+
* a bake of about 50 s on a software adapter, longer than the startup hold. Frames then draw with no
|
|
57
|
+
* fill light, and the shade reads black until the bake ends. The 256 cube of this copy lights the
|
|
58
|
+
* matte town the same and bakes in seconds. The background keeps the full image.
|
|
59
|
+
*/
|
|
60
|
+
const ENVIRONMENT_SIZE = { width: 1024, height: 512 } as const;
|
|
61
|
+
|
|
62
|
+
function environmentOf(sky: Texture): Texture {
|
|
63
|
+
const cached = sky.userData.environment as Texture | undefined;
|
|
64
|
+
if (cached !== undefined) return cached;
|
|
65
|
+
// A host with no OffscreenCanvas (a unit-test stub) or no drawable 2d context keeps the full image:
|
|
66
|
+
// the bake is only slower.
|
|
67
|
+
if (typeof OffscreenCanvas === "undefined") return sky;
|
|
68
|
+
const canvas = new OffscreenCanvas(ENVIRONMENT_SIZE.width, ENVIRONMENT_SIZE.height);
|
|
69
|
+
const context = canvas.getContext("2d");
|
|
70
|
+
// The native host's OffscreenCanvas answers "2d" with a bare object that cannot draw an image.
|
|
71
|
+
if (context === null || typeof context.drawImage !== "function") return sky;
|
|
72
|
+
context.drawImage(sky.image as CanvasImageSource, 0, 0, canvas.width, canvas.height);
|
|
73
|
+
const environment = new CanvasTexture(canvas);
|
|
74
|
+
environment.mapping = EquirectangularReflectionMapping;
|
|
75
|
+
environment.colorSpace = SRGBColorSpace;
|
|
76
|
+
sky.userData.environment = environment;
|
|
77
|
+
return environment;
|
|
78
|
+
}
|
|
79
|
+
|
|
80
|
+
function setupPhotoSky(scene: Scene, sky: Texture): void {
|
|
46
81
|
sky.mapping = EquirectangularReflectionMapping;
|
|
47
82
|
sky.colorSpace = SRGBColorSpace;
|
|
48
83
|
scene.background = sky;
|
|
84
|
+
// The full range: owner 2026-10-26 prefers the 7b546d6 neutral look to the dimmed 0.65 / 0.55 sky.
|
|
49
85
|
scene.backgroundIntensity = SKY_RANGE;
|
|
50
86
|
// three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
|
|
51
87
|
// It is what makes a standard material read as a material: sky-blue fill on faces the sun
|
|
52
88
|
// misses, and a sky to reflect, sharper as roughness drops.
|
|
53
|
-
scene.environment = sky;
|
|
89
|
+
scene.environment = environmentOf(sky);
|
|
54
90
|
scene.environmentIntensity = SKY_RANGE;
|
|
55
91
|
// Almost nothing inside the arena (1.4% at 30 m), and the ground plane gone into the horizon by
|
|
56
92
|
// a kilometre — so the floor meets the sky instead of ending at a line.
|
|
@@ -59,3 +95,68 @@ export function setupSky(scene: Scene, sky: Texture): void {
|
|
|
59
95
|
scene.fog = distanceFog;
|
|
60
96
|
scene.fogNode = heightFogNode(distanceFog, HEIGHT_FOG, SUN_DIRECTION);
|
|
61
97
|
}
|
|
98
|
+
|
|
99
|
+
export const SKY_OPTIONS: { sky: "atmosphere" | "photo"; clouds: boolean; ground: boolean } = {
|
|
100
|
+
sky: "atmosphere",
|
|
101
|
+
clouds: true,
|
|
102
|
+
// The sunlit ground below the horizon stands in for Unreal's Lumen floor bounce: it lifts shadow
|
|
103
|
+
// sides and a mirror reflects it. Set false when the game adds its own global illumination.
|
|
104
|
+
ground: true,
|
|
105
|
+
};
|
|
106
|
+
|
|
107
|
+
/**
|
|
108
|
+
* Unreal's default level fog in metres: density and falloff are per 1000 cm (x0.1 per metre), and its
|
|
109
|
+
* line integral carries ln2 against the exact integral `heightFog.ts` evaluates. `fogHeight` sits
|
|
110
|
+
* 68.5 m below the floor, where the default level puts the fog actor. Inscattering is black and the
|
|
111
|
+
* start distance 0, as in Unreal: the colour comes from the sky.
|
|
112
|
+
*/
|
|
113
|
+
const ATMOSPHERE_FOG = {
|
|
114
|
+
...HEIGHT_FOG,
|
|
115
|
+
density: 0.00436 * Math.LN2,
|
|
116
|
+
heightFalloff: 0.02,
|
|
117
|
+
fogHeight: -68.5,
|
|
118
|
+
startDistance: 0,
|
|
119
|
+
};
|
|
120
|
+
|
|
121
|
+
/** White in the 8-bit environment is this much scene radiance (`createGpuSky`). */
|
|
122
|
+
const ENVIRONMENT_RANGE = 4;
|
|
123
|
+
|
|
124
|
+
/**
|
|
125
|
+
* `photo` is only read when `SKY_OPTIONS.sky` is "photo". `fogged` false leaves the sky unfogged;
|
|
126
|
+
* `clouds` false draws the clear atmosphere. A software adapter draws the 64 x 32 bake as the
|
|
127
|
+
* background, with no LUT or cloud passes.
|
|
128
|
+
*/
|
|
129
|
+
export function setupSky(
|
|
130
|
+
scene: Scene,
|
|
131
|
+
photo?: Texture,
|
|
132
|
+
software = false,
|
|
133
|
+
fogged = true,
|
|
134
|
+
clouds = SKY_OPTIONS.clouds,
|
|
135
|
+
): void {
|
|
136
|
+
if (SKY_OPTIONS.sky === "photo") {
|
|
137
|
+
if (photo === undefined) throw new Error('SKY_OPTIONS.sky "photo" needs assets/sky.jpg loaded');
|
|
138
|
+
setupPhotoSky(scene, photo);
|
|
139
|
+
return;
|
|
140
|
+
}
|
|
141
|
+
// Height fog only; FogExp2 holds the colour `heightFogNode` reads, at zero density. `createGpuSky`
|
|
142
|
+
// sets that colour from the sky and again whenever the sun moves.
|
|
143
|
+
const fog = new FogExp2(0xffffff, 0);
|
|
144
|
+
scene.fog = fog;
|
|
145
|
+
scene.fogNode = heightFogNode(fog, { ...ATMOSPHERE_FOG }, SUN_DIRECTION);
|
|
146
|
+
const { node, environment } = createGpuSky(
|
|
147
|
+
scene,
|
|
148
|
+
SUN_DIRECTION,
|
|
149
|
+
fogged,
|
|
150
|
+
clouds,
|
|
151
|
+
ATMOSPHERE_FOG,
|
|
152
|
+
SKY_OPTIONS.ground,
|
|
153
|
+
);
|
|
154
|
+
environment.mapping = EquirectangularReflectionMapping;
|
|
155
|
+
environment.colorSpace = SRGBColorSpace;
|
|
156
|
+
scene.background = environment;
|
|
157
|
+
scene.backgroundNode = software ? null : node.backgroundNode;
|
|
158
|
+
scene.backgroundIntensity = software ? ENVIRONMENT_RANGE : 1;
|
|
159
|
+
// Unreal's sky light: the same sky, so the fill on every shaded face is the sky's colour.
|
|
160
|
+
scene.environment = environment;
|
|
161
|
+
scene.environmentIntensity = ENVIRONMENT_RANGE;
|
|
162
|
+
}
|
|
@@ -0,0 +1,140 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
//
|
|
3
|
+
// Bayview's surfaces: five tiling textures generated for this kit (see `assets/bay-PROVENANCE.md`),
|
|
4
|
+
// loaded once in `Play.load()`. A surface keeps the colour `palette.ts` gives it and takes only the
|
|
5
|
+
// texture's structure: each sample is divided by the texture's own average (its last mip level), so
|
|
6
|
+
// the town's neutral whites and greys stay where the palette puts them. The town's geometry already
|
|
7
|
+
// carries world-metre UVs (`worldGridUVs`), so one sample is a fixed size on every face.
|
|
8
|
+
// - The same texture sampled again at a much larger, turned scale breaks the repeat at street distance.
|
|
9
|
+
// - A wall darkens towards the street, where dust and splash collect (`grime`).
|
|
10
|
+
// - Roughness follows the texture: a worn, lighter patch is smoother than a pit.
|
|
11
|
+
// - The fine detail fades out with distance, as a Megascans detail texture does in Unreal: past
|
|
12
|
+
// `fade` metres a board joint is under a pixel and would only crawl.
|
|
13
|
+
import {
|
|
14
|
+
type ColorRepresentation,
|
|
15
|
+
type Material,
|
|
16
|
+
RepeatWrapping,
|
|
17
|
+
type Texture,
|
|
18
|
+
Vector2,
|
|
19
|
+
} from "three";
|
|
20
|
+
import {
|
|
21
|
+
cameraPosition,
|
|
22
|
+
float,
|
|
23
|
+
materialColor,
|
|
24
|
+
materialRoughness,
|
|
25
|
+
max,
|
|
26
|
+
mix,
|
|
27
|
+
positionWorld,
|
|
28
|
+
smoothstep,
|
|
29
|
+
texture,
|
|
30
|
+
uv,
|
|
31
|
+
vec2,
|
|
32
|
+
vec3,
|
|
33
|
+
} from "three/tsl";
|
|
34
|
+
import { MeshStandardNodeMaterial, type Node } from "three/webgpu";
|
|
35
|
+
|
|
36
|
+
type TextureLoader = {
|
|
37
|
+
texture(
|
|
38
|
+
path: string,
|
|
39
|
+
options?: { wrap?: number; anisotropy?: number; data?: boolean },
|
|
40
|
+
): Promise<Texture>;
|
|
41
|
+
};
|
|
42
|
+
|
|
43
|
+
// The files live once in the package's `template-assets/assets/`; the scaffolder copies each one
|
|
44
|
+
// named here, with `bay-PROVENANCE.md` (its generation record). The three most-seen surfaces also
|
|
45
|
+
// carry a normal map derived from their own light and dark: a joint, a gap or a trowel mark is a dent.
|
|
46
|
+
const FILES = {
|
|
47
|
+
plaster: "bay-plaster.webp",
|
|
48
|
+
pavement: "bay-pavement.webp",
|
|
49
|
+
wood: "bay-wood.webp",
|
|
50
|
+
metal: "bay-metal.webp",
|
|
51
|
+
ground: "bay-ground.webp",
|
|
52
|
+
} as const;
|
|
53
|
+
export type Surface = keyof typeof FILES;
|
|
54
|
+
const NORMALS: Partial<Record<Surface, string>> = {
|
|
55
|
+
plaster: "bay-plaster-normal.webp",
|
|
56
|
+
pavement: "bay-pavement-normal.webp",
|
|
57
|
+
wood: "bay-wood-normal.webp",
|
|
58
|
+
};
|
|
59
|
+
/** Metres per repeat of each tile. */
|
|
60
|
+
const TILE: Record<Surface, number> = {
|
|
61
|
+
plaster: 3,
|
|
62
|
+
pavement: 2.4,
|
|
63
|
+
wood: 2.4,
|
|
64
|
+
metal: 1.5,
|
|
65
|
+
ground: 4,
|
|
66
|
+
};
|
|
67
|
+
|
|
68
|
+
let maps: Record<Surface, Texture> | undefined;
|
|
69
|
+
let normals: Partial<Record<Surface, Texture>> = {};
|
|
70
|
+
|
|
71
|
+
/** Loads the textures once: albedo in sRGB, normal maps as data, all repeating and anisotropic. */
|
|
72
|
+
export async function loadSurfaces(assets: TextureLoader): Promise<void> {
|
|
73
|
+
const load = (file: string, data: boolean) =>
|
|
74
|
+
assets.texture(file, { anisotropy: 8, data, wrap: RepeatWrapping });
|
|
75
|
+
const names = Object.keys(FILES) as Surface[];
|
|
76
|
+
const bumped = names.filter((name) => NORMALS[name] !== undefined);
|
|
77
|
+
const [albedo, normal] = await Promise.all([
|
|
78
|
+
Promise.all(names.map((name) => load(FILES[name], false))),
|
|
79
|
+
Promise.all(bumped.map((name) => load(NORMALS[name] as string, true))),
|
|
80
|
+
]);
|
|
81
|
+
maps = Object.fromEntries(names.map((name, i) => [name, albedo[i]])) as Record<Surface, Texture>;
|
|
82
|
+
normals = Object.fromEntries(
|
|
83
|
+
bumped.map((name, i) => {
|
|
84
|
+
// The normal map rides the geometry's metre UVs, so its repeat sets the tile size.
|
|
85
|
+
(normal[i] as Texture).repeat.setScalar(1 / TILE[name]);
|
|
86
|
+
return [name, normal[i]];
|
|
87
|
+
}),
|
|
88
|
+
);
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
/** A sample over the texture's own average: about 1, darker in its pits, lighter on its ridges. */
|
|
92
|
+
function structure(map: Texture, at: Node<"vec2">, strength: Node<"float"> | number) {
|
|
93
|
+
const mean = max(texture(map, vec2(0.5, 0.5)).level(float(16)).xyz, vec3(0.02, 0.02, 0.02));
|
|
94
|
+
return mix(vec3(1, 1, 1), texture(map, at).xyz.div(mean), strength);
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
export interface ISurfaceOptions {
|
|
98
|
+
readonly roughness: number;
|
|
99
|
+
readonly metalness?: number;
|
|
100
|
+
/** How much of the texture's light and dark shows, 0 to 1. */
|
|
101
|
+
readonly strength?: number;
|
|
102
|
+
/** How much darker the foot of a wall is than its top, 0 to 1. */
|
|
103
|
+
readonly grime?: number;
|
|
104
|
+
/** How deep the surface's normal map reads; 0 is flat. */
|
|
105
|
+
readonly bump?: number;
|
|
106
|
+
/** How much the large, turned copy of the texture shows, 0 to 1. */
|
|
107
|
+
readonly patches?: number;
|
|
108
|
+
/** Metres from the camera at which the fine detail has faded to a fifth. */
|
|
109
|
+
readonly fade?: number;
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
/**
|
|
113
|
+
* A lit surface in `color` carrying the structure of texture `surface`, or `undefined` before
|
|
114
|
+
* `loadSurfaces` resolves (unit tests, a failed download): the caller keeps its plain material then.
|
|
115
|
+
*/
|
|
116
|
+
export function surfaced(
|
|
117
|
+
color: ColorRepresentation,
|
|
118
|
+
surface: Surface,
|
|
119
|
+
options: ISurfaceOptions,
|
|
120
|
+
): Material | undefined {
|
|
121
|
+
if (maps === undefined) return undefined;
|
|
122
|
+
const map = maps[surface];
|
|
123
|
+
const { strength = 0.8, grime = 0, metalness = 0, bump = 0, patches: wear = 0.45 } = options;
|
|
124
|
+
const { fade = 40 } = options;
|
|
125
|
+
const at = uv().div(TILE[surface]);
|
|
126
|
+
const near = smoothstep(fade, fade * 0.25, positionWorld.distance(cameraPosition));
|
|
127
|
+
const detail = structure(map, at, near.mul(0.8).add(0.2).mul(strength));
|
|
128
|
+
// A turned, seven-times-larger copy: soft patches of wear that do not line up with the tile.
|
|
129
|
+
const patches = structure(map, vec2(at.y.mul(-0.137), at.x.mul(0.141)), wear);
|
|
130
|
+
const foot = mix(float(1 - grime), float(1), smoothstep(0, 1.4, positionWorld.y));
|
|
131
|
+
const material = new MeshStandardNodeMaterial({ color, roughness: options.roughness, metalness });
|
|
132
|
+
material.colorNode = materialColor.mul(detail).mul(patches).mul(foot);
|
|
133
|
+
material.roughnessNode = materialRoughness.mul(float(2).sub(detail.x).clamp(0.7, 1.3));
|
|
134
|
+
const normal = normals[surface];
|
|
135
|
+
if (bump > 0 && normal !== undefined) {
|
|
136
|
+
material.normalMap = normal;
|
|
137
|
+
material.normalScale = new Vector2(bump, bump);
|
|
138
|
+
}
|
|
139
|
+
return material;
|
|
140
|
+
}
|
|
@@ -40,7 +40,6 @@ import {
|
|
|
40
40
|
addDoorsAndShutters,
|
|
41
41
|
addRoofLife,
|
|
42
42
|
createFacade,
|
|
43
|
-
finishFacade,
|
|
44
43
|
visibleFaces,
|
|
45
44
|
} from "./facade.js";
|
|
46
45
|
import { worldGridUVs } from "./materials.js";
|
|
@@ -966,11 +965,9 @@ export function buildTown(materials: TownMaterials): Town {
|
|
|
966
965
|
// Raised deck footprints, for the under-the-deck observation.
|
|
967
966
|
const decks: DeckFootprint[] = [BACK_PLAT_DECK, HEAVEN_DECK, CATWALK_DECK];
|
|
968
967
|
|
|
969
|
-
//
|
|
970
|
-
|
|
971
|
-
|
|
972
|
-
// Every solid now exists carrying its final material — merged facade batches
|
|
973
|
-
// included — so this one walk can tag them all. Must stay after the merge.
|
|
968
|
+
// Every solid now exists carrying its final material, so this one walk can
|
|
969
|
+
// tag them all — while a crate is still called "crate": the engine
|
|
970
|
+
// merges the settled town later, and a hit still names the authored mesh.
|
|
974
971
|
tagSurfaces(hittable, materials);
|
|
975
972
|
|
|
976
973
|
return {
|