create-threenative 0.2.9 → 0.2.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agent-docs/references/assertion-reference.md +109 -3
- package/agent-docs/references/auto-exposure.md +28 -45
- package/agent-docs/references/build-profiles.md +1 -1
- package/agent-docs/references/capability-reference.md +527 -44
- package/agent-docs/references/debug-surface.md +64 -0
- package/agent-docs/references/finding-assets.md +11 -12
- package/agent-docs/references/performance-basics.md +19 -0
- package/agent-docs/references/trace-a-slow-frame.md +21 -0
- package/agent-docs/references/visual-baseline.md +23 -4
- package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
- package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
- package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
- package/agent-files/scripts/reference.mjs +9 -4
- package/capabilities.json +739 -50
- package/dist/index.d.ts +40 -6
- package/dist/index.js +229 -36
- package/dist/quality.d.ts +12 -0
- package/dist/quality.js +166747 -0
- package/dist/threenative.js +60 -44
- package/dist/web-engine-gltf-loader.js +2 -0
- package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
- package/dist/web-engine-mesh-bvh.js +7 -0
- package/dist/web-engine-post-effects.js +645 -19
- package/dist/web-engine-runtime.js +3528 -343
- package/package.json +19 -9
- package/template-assets/assets/bay-PROVENANCE.md +21 -0
- package/template-assets/assets/bay-ground.webp +0 -0
- package/template-assets/assets/bay-metal.webp +0 -0
- package/template-assets/assets/bay-pavement-normal.webp +0 -0
- package/template-assets/assets/bay-pavement.webp +0 -0
- package/template-assets/assets/bay-plaster-normal.webp +0 -0
- package/template-assets/assets/bay-plaster.webp +0 -0
- package/template-assets/assets/bay-wood-normal.webp +0 -0
- package/template-assets/assets/bay-wood.webp +0 -0
- package/template-assets/assets/tex-PROVENANCE.md +25 -0
- package/template-assets/assets/tex-bark-normal.webp +0 -0
- package/template-assets/assets/tex-bark.webp +0 -0
- package/template-assets/assets/tex-birch-bark.webp +0 -0
- package/template-assets/assets/tex-grass.webp +0 -0
- package/template-assets/assets/tex-planks-normal.webp +0 -0
- package/template-assets/assets/tex-planks.webp +0 -0
- package/template-assets/assets/tex-rock-normal.webp +0 -0
- package/template-assets/assets/tex-rock.webp +0 -0
- package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
- package/template-assets/assets/tex-roof-tiles.webp +0 -0
- package/template-assets/assets/tex-sand-normal.webp +0 -0
- package/template-assets/assets/tex-sand.webp +0 -0
- package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
- package/template-assets/assets/tex-stone-wall.webp +0 -0
- package/template-assets/kitExposure.ts +20 -0
- package/template-assets/patches/three@0.185.1.patch +481 -272
- package/template-assets/quality/biome.json +7 -0
- package/template-assets/quality/eslint.config.js +3 -0
- package/template-assets/realistic-ocean/README.md +113 -0
- package/template-assets/realistic-ocean/install.mjs +56 -0
- package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
- package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
- package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
- package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
- package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
- package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
- package/templates/AGENTS.md +21 -0
- package/templates/CLAUDE.md +23 -0
- package/templates/action-rpg/.codex/config.toml +6 -2
- package/templates/action-rpg/.cursor/mcp.json +8 -2
- package/templates/action-rpg/.gemini/settings.json +8 -2
- package/templates/action-rpg/.mcp.json +8 -2
- package/templates/action-rpg/.vscode/mcp.json +9 -2
- package/templates/action-rpg/.zed/settings.json +9 -2
- package/templates/action-rpg/AGENTS.md +11 -11
- package/templates/action-rpg/CLAUDE.md +11 -11
- package/templates/action-rpg/opencode.json +10 -2
- package/templates/action-rpg/package.json +17 -11
- package/templates/action-rpg/playtests/combat.playtest.json +6 -0
- package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
- package/templates/action-rpg/playtests/performance.playtest.json +1 -1
- package/templates/action-rpg/playtests/roll.playtest.json +112 -0
- package/templates/action-rpg/playtests/swing.playtest.json +55 -0
- package/templates/action-rpg/playtests/win.playtest.json +4 -4
- package/templates/action-rpg/src/entities/Fighter.ts +44 -4
- package/templates/action-rpg/src/entities/Player.ts +64 -12
- package/templates/action-rpg/src/render/atmosphere.ts +444 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
- package/templates/action-rpg/src/render/clouds.ts +605 -0
- package/templates/action-rpg/src/render/dungeon.ts +8 -6
- package/templates/action-rpg/src/render/exposure.ts +11 -109
- package/templates/action-rpg/src/render/gpuSky.ts +752 -0
- package/templates/action-rpg/src/render/lighting.ts +27 -4
- package/templates/action-rpg/src/render/materialLighting.ts +2 -11
- package/templates/action-rpg/src/render/palette.ts +1 -0
- package/templates/action-rpg/src/render/postprocessing.ts +4 -4
- package/templates/action-rpg/src/render/props.ts +10 -8
- package/templates/action-rpg/src/render/quality.ts +56 -108
- package/templates/action-rpg/src/render/sky.ts +74 -1
- package/templates/action-rpg/src/scenes/Play.ts +16 -12
- package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
- package/templates/action-rpg/src/ui/Hud.tsx +5 -7
- package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
- package/templates/action-rpg/threenative.config.ts +3 -0
- package/templates/adventure/.codex/config.toml +23 -0
- package/templates/adventure/.cursor/mcp.json +38 -0
- package/templates/adventure/.gemini/settings.json +38 -0
- package/templates/adventure/.mcp.json +38 -0
- package/templates/adventure/.vscode/mcp.json +43 -0
- package/templates/adventure/.zed/settings.json +43 -0
- package/templates/adventure/AGENTS.md +60 -0
- package/templates/adventure/CLAUDE.md +62 -0
- package/templates/adventure/index.html +14 -0
- package/templates/adventure/kit.json +8 -0
- package/templates/adventure/native-playtests/survives.playtest.json +52 -0
- package/templates/adventure/opencode.json +49 -0
- package/templates/adventure/package.json +65 -0
- package/templates/adventure/playtests/boss.playtest.json +406 -0
- package/templates/adventure/playtests/combat.playtest.json +342 -0
- package/templates/adventure/playtests/controls.playtest.json +142 -0
- package/templates/adventure/playtests/explore.playtest.json +45 -0
- package/templates/adventure/playtests/flicker.playtest.json +206 -0
- package/templates/adventure/playtests/hearts.playtest.json +171 -0
- package/templates/adventure/playtests/lockon.playtest.json +256 -0
- package/templates/adventure/playtests/look.playtest.json +72 -0
- package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
- package/templates/adventure/playtests/move.playtest.json +84 -0
- package/templates/adventure/playtests/performance.playtest.json +55 -0
- package/templates/adventure/playtests/puzzle.playtest.json +250 -0
- package/templates/adventure/playtests/stride.playtest.json +67 -0
- package/templates/adventure/playtests/survives.playtest.json +171 -0
- package/templates/adventure/playtests/thornback.playtest.json +267 -0
- package/templates/adventure/public/favicon.svg +4 -0
- package/templates/adventure/src/entities/Block.ts +114 -0
- package/templates/adventure/src/entities/Chest.ts +69 -0
- package/templates/adventure/src/entities/Door.ts +81 -0
- package/templates/adventure/src/entities/Dummy.ts +69 -0
- package/templates/adventure/src/entities/Flicker.ts +239 -0
- package/templates/adventure/src/entities/Hero.ts +561 -0
- package/templates/adventure/src/entities/LockOn.ts +180 -0
- package/templates/adventure/src/entities/Mossling.ts +249 -0
- package/templates/adventure/src/entities/Switch.ts +49 -0
- package/templates/adventure/src/entities/Thornback.ts +238 -0
- package/templates/adventure/src/entities/Warden.ts +196 -0
- package/templates/adventure/src/game.ts +65 -0
- package/templates/adventure/src/interact.ts +63 -0
- package/templates/adventure/src/level/Hollow.ts +240 -0
- package/templates/adventure/src/level/Vale.ts +383 -0
- package/templates/adventure/src/main.ts +18 -0
- package/templates/adventure/src/render/camera.ts +416 -0
- package/templates/adventure/src/render/creatures.ts +405 -0
- package/templates/adventure/src/render/effects.ts +333 -0
- package/templates/adventure/src/render/foliage.ts +1072 -0
- package/templates/adventure/src/render/hero.ts +1447 -0
- package/templates/adventure/src/render/kitExposure.ts +20 -0
- package/templates/adventure/src/render/lighting.ts +74 -0
- package/templates/adventure/src/render/loading.ts +332 -0
- package/templates/adventure/src/render/materials.ts +179 -0
- package/templates/adventure/src/render/palette.ts +137 -0
- package/templates/adventure/src/render/postprocessing.ts +70 -0
- package/templates/adventure/src/render/props.ts +383 -0
- package/templates/adventure/src/render/quality.ts +46 -0
- package/templates/adventure/src/render/sky.ts +271 -0
- package/templates/adventure/src/render/surface.ts +259 -0
- package/templates/adventure/src/render/touch-controls.ts +137 -0
- package/templates/adventure/src/scenes/Play.ts +959 -0
- package/templates/adventure/src/state.ts +113 -0
- package/templates/adventure/src/style.css +98 -0
- package/templates/adventure/src/ui/App.tsx +22 -0
- package/templates/adventure/src/ui/GameUi.tsx +20 -0
- package/templates/adventure/src/ui/Hud.tsx +70 -0
- package/templates/adventure/src/ui/Menu.tsx +15 -0
- package/templates/adventure/src/ui/main.tsx +14 -0
- package/templates/adventure/tailwind.config.ts +2 -0
- package/templates/adventure/threenative.config.ts +62 -0
- package/templates/adventure/tsconfig.json +17 -0
- package/templates/adventure/vite.config.ts +49 -0
- package/templates/collectathon/.codex/config.toml +23 -0
- package/templates/collectathon/.cursor/mcp.json +38 -0
- package/templates/collectathon/.gemini/settings.json +38 -0
- package/templates/collectathon/.mcp.json +38 -0
- package/templates/collectathon/.vscode/mcp.json +43 -0
- package/templates/collectathon/.zed/settings.json +43 -0
- package/templates/collectathon/AGENTS.md +58 -0
- package/templates/collectathon/CLAUDE.md +60 -0
- package/templates/collectathon/index.html +14 -0
- package/templates/collectathon/kit.json +8 -0
- package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
- package/templates/collectathon/opencode.json +49 -0
- package/templates/collectathon/package.json +65 -0
- package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
- package/templates/collectathon/playtests/camera.playtest.json +80 -0
- package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
- package/templates/collectathon/playtests/collect.playtest.json +196 -0
- package/templates/collectathon/playtests/combat.playtest.json +246 -0
- package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
- package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
- package/templates/collectathon/playtests/effects.playtest.json +124 -0
- package/templates/collectathon/playtests/enemies.playtest.json +295 -0
- package/templates/collectathon/playtests/explore.playtest.json +45 -0
- package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
- package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
- package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
- package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
- package/templates/collectathon/playtests/ledge.playtest.json +100 -0
- package/templates/collectathon/playtests/look.playtest.json +64 -0
- package/templates/collectathon/playtests/performance.playtest.json +55 -0
- package/templates/collectathon/playtests/stride.playtest.json +111 -0
- package/templates/collectathon/playtests/survives.playtest.json +123 -0
- package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
- package/templates/collectathon/playtests/thornback.playtest.json +157 -0
- package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
- package/templates/collectathon/playtests/win.playtest.json +166 -0
- package/templates/collectathon/public/favicon.svg +4 -0
- package/templates/collectathon/src/entities/Hero.ts +915 -0
- package/templates/collectathon/src/entities/Pickup.ts +63 -0
- package/templates/collectathon/src/entities/Walker.ts +248 -0
- package/templates/collectathon/src/game.ts +51 -0
- package/templates/collectathon/src/level/Course.ts +590 -0
- package/templates/collectathon/src/level/terrain.ts +144 -0
- package/templates/collectathon/src/main.ts +14 -0
- package/templates/collectathon/src/playtest-events.ts +15 -0
- package/templates/collectathon/src/render/camera.ts +163 -0
- package/templates/collectathon/src/render/castle.ts +408 -0
- package/templates/collectathon/src/render/effects.ts +284 -0
- package/templates/collectathon/src/render/foliage.ts +744 -0
- package/templates/collectathon/src/render/ground.ts +139 -0
- package/templates/collectathon/src/render/hero.ts +452 -0
- package/templates/collectathon/src/render/kitExposure.ts +20 -0
- package/templates/collectathon/src/render/lighting.ts +65 -0
- package/templates/collectathon/src/render/loading.ts +332 -0
- package/templates/collectathon/src/render/materials.ts +196 -0
- package/templates/collectathon/src/render/palette.ts +82 -0
- package/templates/collectathon/src/render/postprocessing.ts +79 -0
- package/templates/collectathon/src/render/props.ts +218 -0
- package/templates/collectathon/src/render/quality.ts +54 -0
- package/templates/collectathon/src/render/sky.ts +262 -0
- package/templates/collectathon/src/render/surface.ts +269 -0
- package/templates/collectathon/src/render/touch-controls.ts +179 -0
- package/templates/collectathon/src/render/touch-layout.ts +48 -0
- package/templates/collectathon/src/render/water.ts +191 -0
- package/templates/collectathon/src/scenes/Play.ts +481 -0
- package/templates/collectathon/src/state.ts +38 -0
- package/templates/collectathon/src/style.css +106 -0
- package/templates/collectathon/src/ui/App.tsx +22 -0
- package/templates/collectathon/src/ui/GameUi.tsx +20 -0
- package/templates/collectathon/src/ui/Hud.tsx +77 -0
- package/templates/collectathon/src/ui/Menu.tsx +13 -0
- package/templates/collectathon/src/ui/main.tsx +14 -0
- package/templates/collectathon/tailwind.config.ts +2 -0
- package/templates/collectathon/threenative.config.ts +62 -0
- package/templates/collectathon/tsconfig.json +17 -0
- package/templates/collectathon/vite.config.ts +49 -0
- package/templates/kart/.codex/config.toml +23 -0
- package/templates/kart/.cursor/mcp.json +38 -0
- package/templates/kart/.gemini/settings.json +38 -0
- package/templates/kart/.mcp.json +38 -0
- package/templates/kart/.vscode/mcp.json +43 -0
- package/templates/kart/.zed/settings.json +43 -0
- package/templates/kart/AGENTS.md +58 -0
- package/templates/kart/CLAUDE.md +60 -0
- package/templates/kart/index.html +14 -0
- package/templates/kart/kit.json +8 -0
- package/templates/kart/native-playtests/survives.playtest.json +65 -0
- package/templates/kart/opencode.json +49 -0
- package/templates/kart/package.json +64 -0
- package/templates/kart/playtests/drift.playtest.json +226 -0
- package/templates/kart/playtests/explore.playtest.json +45 -0
- package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
- package/templates/kart/playtests/item-key.playtest.json +108 -0
- package/templates/kart/playtests/items.playtest.json +143 -0
- package/templates/kart/playtests/lap-times.playtest.json +138 -0
- package/templates/kart/playtests/laps.playtest.json +149 -0
- package/templates/kart/playtests/performance.playtest.json +57 -0
- package/templates/kart/playtests/race.playtest.json +294 -0
- package/templates/kart/playtests/restart.playtest.json +87 -0
- package/templates/kart/playtests/rocket-start.playtest.json +56 -0
- package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
- package/templates/kart/playtests/surfaces.playtest.json +113 -0
- package/templates/kart/playtests/survives.playtest.json +116 -0
- package/templates/kart/playtests/wall.playtest.json +118 -0
- package/templates/kart/public/favicon.svg +4 -0
- package/templates/kart/src/entities/Driver.ts +123 -0
- package/templates/kart/src/entities/Items.ts +194 -0
- package/templates/kart/src/entities/Kart.ts +517 -0
- package/templates/kart/src/game.ts +45 -0
- package/templates/kart/src/main.ts +14 -0
- package/templates/kart/src/playtest-events.ts +15 -0
- package/templates/kart/src/render/camera.ts +83 -0
- package/templates/kart/src/render/course.ts +579 -0
- package/templates/kart/src/render/effects.ts +266 -0
- package/templates/kart/src/render/items.ts +163 -0
- package/templates/kart/src/render/kart.ts +256 -0
- package/templates/kart/src/render/kitExposure.ts +20 -0
- package/templates/kart/src/render/lighting.ts +58 -0
- package/templates/kart/src/render/loading.ts +332 -0
- package/templates/kart/src/render/materials.ts +119 -0
- package/templates/kart/src/render/palette.ts +74 -0
- package/templates/kart/src/render/postprocessing.ts +79 -0
- package/templates/kart/src/render/quality.ts +54 -0
- package/templates/kart/src/render/skids.ts +86 -0
- package/templates/kart/src/render/sky.ts +105 -0
- package/templates/kart/src/render/touch-controls.ts +168 -0
- package/templates/kart/src/render/touch-layout.ts +48 -0
- package/templates/kart/src/scenes/Race.ts +850 -0
- package/templates/kart/src/state.ts +53 -0
- package/templates/kart/src/style.css +106 -0
- package/templates/kart/src/track/Course.ts +276 -0
- package/templates/kart/src/track/Race.ts +133 -0
- package/templates/kart/src/ui/App.tsx +21 -0
- package/templates/kart/src/ui/GameUi.tsx +20 -0
- package/templates/kart/src/ui/Hud.tsx +172 -0
- package/templates/kart/src/ui/Menu.tsx +13 -0
- package/templates/kart/src/ui/main.tsx +14 -0
- package/templates/kart/tailwind.config.ts +2 -0
- package/templates/kart/threenative.config.ts +62 -0
- package/templates/kart/tsconfig.json +17 -0
- package/templates/kart/vite.config.ts +49 -0
- package/templates/minimal/.codex/config.toml +6 -2
- package/templates/minimal/.cursor/mcp.json +8 -2
- package/templates/minimal/.gemini/settings.json +8 -2
- package/templates/minimal/.mcp.json +8 -2
- package/templates/minimal/.vscode/mcp.json +9 -2
- package/templates/minimal/.zed/settings.json +9 -2
- package/templates/minimal/AGENTS.md +11 -13
- package/templates/minimal/CLAUDE.md +11 -13
- package/templates/minimal/opencode.json +10 -2
- package/templates/minimal/package.json +16 -10
- package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
- package/templates/minimal/playtests/jump.playtest.json +45 -0
- package/templates/minimal/playtests/play.playtest.json +1 -1
- package/templates/minimal/src/game.ts +2 -0
- package/templates/minimal/src/render/atmosphere.ts +444 -0
- package/templates/minimal/src/render/backlightMaterial.ts +49 -18
- package/templates/minimal/src/render/camera.ts +35 -4
- package/templates/minimal/src/render/clouds.ts +605 -0
- package/templates/minimal/src/render/exposure.ts +7 -111
- package/templates/minimal/src/render/gpuSky.ts +752 -0
- package/templates/minimal/src/render/lighting.ts +26 -4
- package/templates/minimal/src/render/materialLighting.ts +2 -10
- package/templates/minimal/src/render/postprocessing.ts +4 -4
- package/templates/minimal/src/render/quality.ts +10 -116
- package/templates/minimal/src/render/sky.ts +73 -1
- package/templates/minimal/src/scenes/Play.ts +18 -7
- package/templates/platformer/.codex/config.toml +6 -2
- package/templates/platformer/.cursor/mcp.json +8 -2
- package/templates/platformer/.gemini/settings.json +8 -2
- package/templates/platformer/.mcp.json +8 -2
- package/templates/platformer/.vscode/mcp.json +9 -2
- package/templates/platformer/.zed/settings.json +9 -2
- package/templates/platformer/AGENTS.md +13 -9
- package/templates/platformer/CLAUDE.md +13 -9
- package/templates/platformer/opencode.json +10 -2
- package/templates/platformer/package.json +17 -11
- package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
- package/templates/platformer/playtests/finish.playtest.json +58 -0
- package/templates/platformer/playtests/idle.playtest.json +44 -0
- package/templates/platformer/playtests/performance.playtest.json +1 -1
- package/templates/platformer/src/entities/Fox.ts +19 -6
- package/templates/platformer/src/game.ts +1 -0
- package/templates/platformer/src/level/Stage.ts +4 -1
- package/templates/platformer/src/render/backlightMaterial.ts +49 -18
- package/templates/platformer/src/render/camera.ts +30 -1
- package/templates/platformer/src/render/exposure.ts +6 -111
- package/templates/platformer/src/render/fox.ts +5 -2
- package/templates/platformer/src/render/kitExposure.ts +20 -0
- package/templates/platformer/src/render/materialLighting.ts +2 -11
- package/templates/platformer/src/render/postprocessing.ts +4 -4
- package/templates/platformer/src/render/props.ts +1 -2
- package/templates/platformer/src/render/quality.ts +10 -118
- package/templates/platformer/src/scenes/Play.ts +31 -15
- package/templates/platformer/src/ui/Menu.tsx +1 -1
- package/templates/puzzle/.codex/config.toml +6 -2
- package/templates/puzzle/.cursor/mcp.json +8 -2
- package/templates/puzzle/.gemini/settings.json +8 -2
- package/templates/puzzle/.mcp.json +8 -2
- package/templates/puzzle/.vscode/mcp.json +9 -2
- package/templates/puzzle/.zed/settings.json +9 -2
- package/templates/puzzle/AGENTS.md +14 -17
- package/templates/puzzle/CLAUDE.md +14 -17
- package/templates/puzzle/opencode.json +10 -2
- package/templates/puzzle/package.json +17 -11
- package/templates/puzzle/playtests/performance.playtest.json +1 -1
- package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
- package/templates/puzzle/src/render/exposure.ts +11 -109
- package/templates/puzzle/src/render/lighting.ts +3 -3
- package/templates/puzzle/src/render/materialLighting.ts +2 -11
- package/templates/puzzle/src/render/palette.ts +1 -1
- package/templates/puzzle/src/render/postprocessing.ts +4 -4
- package/templates/puzzle/src/render/quality.ts +44 -153
- package/templates/puzzle/src/render/vault.ts +18 -6
- package/templates/puzzle/src/scenes/Play.ts +6 -1
- package/templates/puzzle/src/ui/Hud.tsx +8 -43
- package/templates/racing/.codex/config.toml +6 -2
- package/templates/racing/.cursor/mcp.json +8 -2
- package/templates/racing/.gemini/settings.json +8 -2
- package/templates/racing/.mcp.json +8 -2
- package/templates/racing/.vscode/mcp.json +9 -2
- package/templates/racing/.zed/settings.json +9 -2
- package/templates/racing/AGENTS.md +10 -12
- package/templates/racing/CLAUDE.md +10 -12
- package/templates/racing/opencode.json +10 -2
- package/templates/racing/package.json +17 -11
- package/templates/racing/playtests/brake.playtest.json +54 -0
- package/templates/racing/playtests/outcome.playtest.json +19 -0
- package/templates/racing/playtests/performance.playtest.json +1 -1
- package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
- package/templates/racing/src/entities/RacingCar.ts +12 -3
- package/templates/racing/src/entities/Rival.ts +11 -2
- package/templates/racing/src/render/atmosphere.ts +444 -0
- package/templates/racing/src/render/backlightMaterial.ts +49 -18
- package/templates/racing/src/render/clouds.ts +605 -0
- package/templates/racing/src/render/exposure.ts +6 -111
- package/templates/racing/src/render/gpuSky.ts +752 -0
- package/templates/racing/src/render/kitExposure.ts +20 -0
- package/templates/racing/src/render/lighting.ts +26 -4
- package/templates/racing/src/render/materialLighting.ts +2 -11
- package/templates/racing/src/render/materials.ts +2 -1
- package/templates/racing/src/render/postprocessing.ts +4 -4
- package/templates/racing/src/render/quality.ts +27 -115
- package/templates/racing/src/render/sky.ts +76 -5
- package/templates/racing/src/scenes/Race.ts +53 -42
- package/templates/racing/src/track/TrackSector.ts +5 -2
- package/templates/racing/src/ui/Hud.tsx +12 -7
- package/templates/rain/.codex/config.toml +6 -2
- package/templates/rain/.cursor/mcp.json +8 -2
- package/templates/rain/.gemini/settings.json +8 -2
- package/templates/rain/.mcp.json +8 -2
- package/templates/rain/.vscode/mcp.json +9 -2
- package/templates/rain/.zed/settings.json +9 -2
- package/templates/rain/AGENTS.md +12 -12
- package/templates/rain/CLAUDE.md +12 -12
- package/templates/rain/opencode.json +10 -2
- package/templates/rain/package.json +16 -10
- package/templates/rain/playtests/performance.playtest.json +1 -1
- package/templates/rain/src/game.ts +1 -1
- package/templates/rain/src/render/bloom-shader.ts +1 -1
- package/templates/rain/src/render/clouds-shader.ts +2 -2
- package/templates/rain/src/render/clouds.ts +2 -1
- package/templates/rain/src/render/exposure.ts +11 -109
- package/templates/rain/src/render/post-shader.ts +7 -11
- package/templates/rain/src/render/postprocessing.ts +8 -24
- package/templates/rain/src/render/quality.ts +44 -98
- package/templates/rain/src/render/world-shader.ts +281 -97
- package/templates/rain/src/render/world.ts +82 -2
- package/templates/rain/src/style.css +1 -1
- package/templates/rain/src/ui/GameUi.tsx +6 -2
- package/templates/rain/src/ui/Hud.tsx +1 -1
- package/templates/rain/tools/generate-shaders.mjs +2 -2
- package/templates/rain/tools/tempest-post.frag +4 -6
- package/templates/rain/tools/tempest-world.frag +80 -12
- package/templates/rts/.codex/config.toml +6 -2
- package/templates/rts/.cursor/mcp.json +8 -2
- package/templates/rts/.gemini/settings.json +8 -2
- package/templates/rts/.mcp.json +8 -2
- package/templates/rts/.vscode/mcp.json +9 -2
- package/templates/rts/.zed/settings.json +9 -2
- package/templates/rts/AGENTS.md +15 -16
- package/templates/rts/CLAUDE.md +15 -16
- package/templates/rts/opencode.json +10 -2
- package/templates/rts/package.json +16 -10
- package/templates/rts/playtests/performance.playtest.json +1 -1
- package/templates/rts/playtests/rts-attack.playtest.json +5 -0
- package/templates/rts/playtests/rts-build.playtest.json +20 -1
- package/templates/rts/playtests/rts-orders.playtest.json +1 -1
- package/templates/rts/playtests/rts-pause.playtest.json +112 -0
- package/templates/rts/playtests/rts-train.playtest.json +1 -1
- package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
- package/templates/rts/src/game.ts +29 -7
- package/templates/rts/src/render/army.ts +181 -49
- package/templates/rts/src/render/backlightMaterial.ts +49 -18
- package/templates/rts/src/render/environment.ts +276 -0
- package/templates/rts/src/render/exposure.ts +3 -65
- package/templates/rts/src/render/ground.ts +478 -0
- package/templates/rts/src/render/lighting.ts +62 -11
- package/templates/rts/src/render/materialLighting.ts +2 -11
- package/templates/rts/src/render/materials.ts +47 -118
- package/templates/rts/src/render/palette.ts +30 -13
- package/templates/rts/src/render/picking.ts +18 -0
- package/templates/rts/src/render/postprocessing.ts +4 -4
- package/templates/rts/src/render/quality.ts +64 -85
- package/templates/rts/src/render/resources.ts +21 -22
- package/templates/rts/src/render/sky.ts +9 -12
- package/templates/rts/src/render/terrain.ts +36 -11
- package/templates/rts/src/scenes/Play.ts +373 -38
- package/templates/rts/src/sim/ai.ts +0 -11
- package/templates/rts/src/state.ts +46 -0
- package/templates/rts/src/style.css +1543 -0
- package/templates/rts/src/ui/Commands.tsx +204 -107
- package/templates/rts/src/ui/GameUi.tsx +12 -5
- package/templates/rts/src/ui/Hud.tsx +611 -116
- package/templates/rts/src/ui/Minimap.tsx +103 -37
- package/templates/rts/src/ui/icons.tsx +116 -0
- package/templates/rts/src/ui/labels.ts +73 -0
- package/templates/rts/src/ui/minimapPoint.ts +30 -0
- package/templates/rts/threenative.config.ts +1 -1
- package/templates/runner/.codex/config.toml +6 -2
- package/templates/runner/.cursor/mcp.json +8 -2
- package/templates/runner/.gemini/settings.json +8 -2
- package/templates/runner/.mcp.json +8 -2
- package/templates/runner/.vscode/mcp.json +9 -2
- package/templates/runner/.zed/settings.json +9 -2
- package/templates/runner/AGENTS.md +12 -12
- package/templates/runner/CLAUDE.md +12 -12
- package/templates/runner/opencode.json +10 -2
- package/templates/runner/package.json +17 -11
- package/templates/runner/playtests/near-miss.playtest.json +48 -0
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/playtests/stride.playtest.json +27 -0
- package/templates/runner/playtests/survives.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +3 -1
- package/templates/runner/src/entities/Runner.ts +11 -5
- package/templates/runner/src/render/atmosphere.ts +444 -0
- package/templates/runner/src/render/backlightMaterial.ts +49 -18
- package/templates/runner/src/render/clouds.ts +605 -0
- package/templates/runner/src/render/exposure.ts +6 -111
- package/templates/runner/src/render/gpuSky.ts +752 -0
- package/templates/runner/src/render/kitExposure.ts +20 -0
- package/templates/runner/src/render/lighting.ts +26 -4
- package/templates/runner/src/render/materialLighting.ts +2 -11
- package/templates/runner/src/render/postprocessing.ts +4 -4
- package/templates/runner/src/render/quality.ts +26 -114
- package/templates/runner/src/render/sky.ts +73 -1
- package/templates/runner/src/scenes/Run.ts +19 -15
- package/templates/runner/src/track.ts +12 -3
- package/templates/sailing/.codex/config.toml +6 -2
- package/templates/sailing/.cursor/mcp.json +8 -2
- package/templates/sailing/.gemini/settings.json +8 -2
- package/templates/sailing/.mcp.json +8 -2
- package/templates/sailing/.vscode/mcp.json +9 -2
- package/templates/sailing/.zed/settings.json +9 -2
- package/templates/sailing/AGENTS.md +10 -11
- package/templates/sailing/CLAUDE.md +10 -11
- package/templates/sailing/opencode.json +10 -2
- package/templates/sailing/package.json +17 -11
- package/templates/sailing/playtests/fail.playtest.json +46 -5
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
- package/templates/sailing/playtests/performance.playtest.json +1 -1
- package/templates/sailing/src/game.ts +1 -0
- package/templates/sailing/src/render/backlightMaterial.ts +49 -18
- package/templates/sailing/src/render/exposure.ts +6 -111
- package/templates/sailing/src/render/kitExposure.ts +20 -0
- package/templates/sailing/src/render/materialLighting.ts +2 -11
- package/templates/sailing/src/render/ocean.ts +0 -1
- package/templates/sailing/src/render/postprocessing.ts +4 -4
- package/templates/sailing/src/render/quality.ts +31 -138
- package/templates/sailing/src/scenes/Sailing.ts +12 -4
- package/templates/sailing/src/ui/Hud.tsx +6 -2
- package/templates/sailing/src/ui/Menu.tsx +1 -1
- package/templates/shooter/.codex/config.toml +6 -2
- package/templates/shooter/.cursor/mcp.json +8 -2
- package/templates/shooter/.gemini/settings.json +8 -2
- package/templates/shooter/.mcp.json +8 -2
- package/templates/shooter/.vscode/mcp.json +9 -2
- package/templates/shooter/.zed/settings.json +9 -2
- package/templates/shooter/AGENTS.md +13 -12
- package/templates/shooter/CLAUDE.md +13 -12
- package/templates/shooter/index.html +1 -1
- package/templates/shooter/main.html +13 -0
- package/templates/shooter/opencode.json +10 -2
- package/templates/shooter/package.json +17 -11
- package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
- package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
- package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
- package/templates/shooter/playtests/performance.playtest.json +3 -3
- package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
- package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
- package/templates/shooter/src/entities/Breakables.ts +34 -10
- package/templates/shooter/src/entities/Enemy.ts +176 -54
- package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
- package/templates/shooter/src/entities/Rifle.ts +83 -9
- package/templates/shooter/src/entities/movement.ts +96 -0
- package/templates/shooter/src/render/atmosphere.ts +444 -0
- package/templates/shooter/src/render/backlightMaterial.ts +49 -18
- package/templates/shooter/src/render/camera.ts +3 -1
- package/templates/shooter/src/render/clouds.ts +605 -0
- package/templates/shooter/src/render/exposure.ts +10 -109
- package/templates/shooter/src/render/facade.ts +26 -68
- package/templates/shooter/src/render/gpuSky.ts +752 -0
- package/templates/shooter/src/render/lighting.ts +27 -4
- package/templates/shooter/src/render/materialAssignments.ts +9 -1
- package/templates/shooter/src/render/materialLighting.ts +2 -11
- package/templates/shooter/src/render/occlusion.ts +13 -4
- package/templates/shooter/src/render/palette.ts +1 -0
- package/templates/shooter/src/render/postprocessing.ts +4 -4
- package/templates/shooter/src/render/quality.ts +50 -108
- package/templates/shooter/src/render/scale.ts +0 -11
- package/templates/shooter/src/render/sky.ts +103 -2
- package/templates/shooter/src/render/surface.ts +140 -0
- package/templates/shooter/src/render/town.ts +3 -6
- package/templates/shooter/src/render/townMaterials.ts +95 -42
- package/templates/shooter/src/render/vehicles.ts +2 -0
- package/templates/shooter/src/scenes/Play.ts +83 -23
- package/templates/shooter/src/ui/Hud.tsx +268 -193
- package/templates/shooter/src/worker-page.ts +29 -0
- package/templates/shooter/src/worker.ts +5 -0
- package/templates/shooter/threenative.config.ts +3 -0
- package/templates/shooter/vite.config.ts +2 -0
- package/templates/snow/.codex/config.toml +6 -2
- package/templates/snow/.cursor/mcp.json +8 -2
- package/templates/snow/.gemini/settings.json +8 -2
- package/templates/snow/.mcp.json +8 -2
- package/templates/snow/.vscode/mcp.json +9 -2
- package/templates/snow/.zed/settings.json +9 -2
- package/templates/snow/AGENTS.md +12 -10
- package/templates/snow/CLAUDE.md +12 -10
- package/templates/snow/opencode.json +10 -2
- package/templates/snow/package.json +17 -11
- package/templates/snow/playtests/performance.playtest.json +1 -1
- package/templates/snow/src/render/backlightMaterial.ts +49 -18
- package/templates/snow/src/render/exposure.ts +17 -106
- package/templates/snow/src/render/materialLighting.ts +2 -11
- package/templates/snow/src/render/postprocessing.ts +11 -5
- package/templates/snow/src/render/quality.ts +46 -126
- package/templates/snow/src/render/snowSurface.ts +32 -15
- package/templates/snow/src/scenes/Snow.ts +2 -1
- package/templates/starter/.codex/config.toml +6 -2
- package/templates/starter/.cursor/mcp.json +8 -2
- package/templates/starter/.gemini/settings.json +8 -2
- package/templates/starter/.mcp.json +8 -2
- package/templates/starter/.vscode/mcp.json +9 -2
- package/templates/starter/.zed/settings.json +9 -2
- package/templates/starter/AGENTS.md +18 -14
- package/templates/starter/CLAUDE.md +18 -14
- package/templates/starter/index.html +1 -1
- package/templates/starter/main.html +12 -0
- package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
- package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
- package/templates/starter/opencode.json +10 -2
- package/templates/starter/package.json +17 -11
- package/templates/starter/playtests/play.playtest.json +22 -2
- package/templates/starter/playtests/production-readiness.playtest.json +56 -0
- package/templates/starter/src/entities/Crate.ts +19 -1
- package/templates/starter/src/render/arena.ts +2 -2
- package/templates/starter/src/render/atmosphere.ts +444 -0
- package/templates/starter/src/render/backlightMaterial.ts +49 -18
- package/templates/starter/src/render/camera.ts +28 -0
- package/templates/starter/src/render/clouds.ts +605 -0
- package/templates/starter/src/render/contactShadow.ts +50 -0
- package/templates/starter/src/render/exposure.ts +9 -111
- package/templates/starter/src/render/gpuSky.ts +752 -0
- package/templates/starter/src/render/grade.ts +1 -1
- package/templates/starter/src/render/lighting.ts +34 -6
- package/templates/starter/src/render/materialLighting.ts +2 -11
- package/templates/starter/src/render/postprocessing.ts +53 -34
- package/templates/starter/src/render/quality.ts +18 -147
- package/templates/starter/src/render/sky.ts +90 -40
- package/templates/starter/src/render/temporalAA.ts +1 -1
- package/templates/starter/src/render/temporalAAStage.ts +1 -1
- package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
- package/templates/starter/src/render/temporalDetailStage.ts +106 -0
- package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
- package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
- package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
- package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
- package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
- package/templates/starter/src/scenes/Play.ts +11 -8
- package/templates/starter/src/ui/Hud.tsx +1 -1
- package/templates/starter/src/worker-page.ts +29 -0
- package/templates/starter/src/worker.ts +5 -0
- package/templates/starter/vite.config.ts +2 -0
- package/templates/tower-defense/.codex/config.toml +6 -2
- package/templates/tower-defense/.cursor/mcp.json +8 -2
- package/templates/tower-defense/.gemini/settings.json +8 -2
- package/templates/tower-defense/.mcp.json +8 -2
- package/templates/tower-defense/.vscode/mcp.json +9 -2
- package/templates/tower-defense/.zed/settings.json +9 -2
- package/templates/tower-defense/AGENTS.md +10 -12
- package/templates/tower-defense/CLAUDE.md +10 -12
- package/templates/tower-defense/opencode.json +10 -2
- package/templates/tower-defense/package.json +17 -11
- package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
- package/templates/tower-defense/playtests/performance.playtest.json +1 -1
- package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
- package/templates/tower-defense/src/render/exposure.ts +11 -109
- package/templates/tower-defense/src/render/lighting.ts +4 -2
- package/templates/tower-defense/src/render/materialLighting.ts +2 -11
- package/templates/tower-defense/src/render/postprocessing.ts +4 -4
- package/templates/tower-defense/src/render/quality.ts +10 -116
- package/templates/tower-defense/src/render/sky.ts +2 -2
- package/templates/tower-defense/src/scenes/Battle.ts +4 -0
- package/template-assets/autoExposure.ts +0 -225
- package/template-assets/exposureGraph.ts +0 -178
- package/template-assets/exposureReadback.ts +0 -79
- package/template-assets/worldEnvironment.ts +0 -1212
- package/templates/action-rpg/src/render/autoExposure.ts +0 -225
- package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
- package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
- package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
- package/templates/minimal/src/render/autoExposure.ts +0 -225
- package/templates/minimal/src/render/exposureGraph.ts +0 -178
- package/templates/minimal/src/render/exposureReadback.ts +0 -79
- package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
- package/templates/platformer/src/render/autoExposure.ts +0 -225
- package/templates/platformer/src/render/exposureGraph.ts +0 -178
- package/templates/platformer/src/render/exposureReadback.ts +0 -79
- package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
- package/templates/puzzle/src/render/autoExposure.ts +0 -225
- package/templates/puzzle/src/render/exposureGraph.ts +0 -178
- package/templates/puzzle/src/render/exposureReadback.ts +0 -79
- package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
- package/templates/racing/src/render/autoExposure.ts +0 -225
- package/templates/racing/src/render/exposureGraph.ts +0 -178
- package/templates/racing/src/render/exposureReadback.ts +0 -79
- package/templates/racing/src/render/worldEnvironment.ts +0 -1212
- package/templates/rain/src/render/autoExposure.ts +0 -225
- package/templates/rain/src/render/exposureGraph.ts +0 -178
- package/templates/rain/src/render/exposureReadback.ts +0 -79
- package/templates/rain/src/render/worldEnvironment.ts +0 -1212
- package/templates/rts/src/render/autoExposure.ts +0 -225
- package/templates/rts/src/render/exposureGraph.ts +0 -178
- package/templates/rts/src/render/exposureReadback.ts +0 -79
- package/templates/rts/src/render/worldEnvironment.ts +0 -1212
- package/templates/runner/src/render/autoExposure.ts +0 -225
- package/templates/runner/src/render/exposureGraph.ts +0 -178
- package/templates/runner/src/render/exposureReadback.ts +0 -79
- package/templates/runner/src/render/worldEnvironment.ts +0 -1212
- package/templates/sailing/src/render/autoExposure.ts +0 -225
- package/templates/sailing/src/render/exposureGraph.ts +0 -178
- package/templates/sailing/src/render/exposureReadback.ts +0 -79
- package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
- package/templates/shooter/src/render/autoExposure.ts +0 -225
- package/templates/shooter/src/render/exposureGraph.ts +0 -178
- package/templates/shooter/src/render/exposureReadback.ts +0 -79
- package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
- package/templates/snow/src/render/autoExposure.ts +0 -225
- package/templates/snow/src/render/exposureGraph.ts +0 -178
- package/templates/snow/src/render/exposureReadback.ts +0 -79
- package/templates/snow/src/render/worldEnvironment.ts +0 -1212
- package/templates/starter/src/render/autoExposure.ts +0 -225
- package/templates/starter/src/render/exposureGraph.ts +0 -178
- package/templates/starter/src/render/exposureReadback.ts +0 -79
- package/templates/starter/src/render/worldEnvironment.ts +0 -1212
- package/templates/tower-defense/src/render/autoExposure.ts +0 -225
- package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
- package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
- package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
|
@@ -0,0 +1,605 @@
|
|
|
1
|
+
// Generated for you. Plain maths, edit or delete it freely: the cloud layer Unreal's default level draws.
|
|
2
|
+
// Model references (UE 5.8.3): Engine/Content/EngineSky/VolumetricClouds/m_SimpleVolumetricCloud
|
|
3
|
+
// (the default cloud material; its node graph and parameter defaults are read through the editor),
|
|
4
|
+
// Engine/Shaders/Private/VolumetricCloud.usf (dual HG phase, scattering octaves, sky term, shadow
|
|
5
|
+
// march), Engine/Source/Runtime/Engine/Private/Components/VolumetricCloudComponent.cpp (km defaults).
|
|
6
|
+
// Independent CPU implementation. The material samples four Unreal textures that this repository
|
|
7
|
+
// must not carry, so each one is regenerated here from a seeded noise whose per-channel value
|
|
8
|
+
// quantiles and correlation lengths match the Unreal texture (measured, see the spec).
|
|
9
|
+
import {
|
|
10
|
+
BOTTOM_KM,
|
|
11
|
+
CAMERA_KM,
|
|
12
|
+
MIE_ABSORB,
|
|
13
|
+
MIE_SCATTER,
|
|
14
|
+
RAYLEIGH,
|
|
15
|
+
type Rgb,
|
|
16
|
+
transmittanceToTop,
|
|
17
|
+
} from "./atmosphere.js";
|
|
18
|
+
|
|
19
|
+
const PLANET = BOTTOM_KM;
|
|
20
|
+
export const CLOUD_BOTTOM_KM = 5; // VolumetricCloudComponent LayerBottomAltitude in the reference level
|
|
21
|
+
export const CLOUD_TOP_KM = 15; // bottom + LayerHeight 10
|
|
22
|
+
const CAMERA = PLANET + CAMERA_KM;
|
|
23
|
+
|
|
24
|
+
/** m_SimpleVolumetricCloud parameter defaults (the instance overrides only textures). */
|
|
25
|
+
export const CLOUD_MATERIAL = {
|
|
26
|
+
layoutKm: 256, // Layout_CloudGlobalScale: the pattern repeats every 256 km
|
|
27
|
+
density: 0.008, // Cloud_GlobalDensity, extinction per metre
|
|
28
|
+
coverage: -0.2, // Cloud_GlobalCoverage
|
|
29
|
+
noise1Scale: [4.167, 4.444, 9.091], // Noise1_Coordinates, in volume repeats per layout tile
|
|
30
|
+
noise2Scale: [60, 60, 75], // Noise2_Coordinates, the distortion lookup
|
|
31
|
+
noiseBias: [0.5, 0.8], // Noise_Bias R (shape) and G (distortion)
|
|
32
|
+
noiseStrength: [0.8, 0.08], // Noise_Strength R and G
|
|
33
|
+
insideLayer: [0.02, 0.98], // the material returns zero in the outer 2% of the layer
|
|
34
|
+
albedo: 0.98, // Cloud_AlbedoColor
|
|
35
|
+
skyOcclusion: 0.5, // Cloud_AlbedoColor alpha, drives the sky-light term
|
|
36
|
+
phase: { g: 0.8, g2: 0.166667, blend: 0.575 }, // Phase_Controls
|
|
37
|
+
multiScatter: { contribution: 0.666667, occlusion: 0.25, eccentricity: 0.18, octaves: 2 },
|
|
38
|
+
} as const;
|
|
39
|
+
export const CLOUD_MODEL = {
|
|
40
|
+
viewStepMetres: 300,
|
|
41
|
+
minViewSteps: 32,
|
|
42
|
+
maxViewSteps: 192,
|
|
43
|
+
lightSteps: 6,
|
|
44
|
+
// TracingMaxDistance, taken from the layer entry point (TracingMaxDistanceMode 0, the default).
|
|
45
|
+
tracingKm: 200,
|
|
46
|
+
// TracingMaxDistance of the reference actor is 200 km (tools/unreal-reference/template-actors.json).
|
|
47
|
+
horizonFadeStartKm: 150,
|
|
48
|
+
horizonFadeEndKm: 200,
|
|
49
|
+
} as const;
|
|
50
|
+
export const PATTERN_SIZE = 256;
|
|
51
|
+
export const VOLUME_SIZE = 64;
|
|
52
|
+
// Value quantiles (17 points, 0 to 1) of T_CloudPattern R,G,B, of the volume's R and G channels.
|
|
53
|
+
const PATTERN_QUANTILES = [
|
|
54
|
+
[0, 0, 0, 0, 0, 0.012, 0.034, 0.06, 0.092, 0.13, 0.176, 0.234, 0.307, 0.405, 0.541, 0.753, 1],
|
|
55
|
+
[
|
|
56
|
+
0, 0, 0, 0.001, 0.006, 0.021, 0.048, 0.086, 0.135, 0.193, 0.26, 0.342, 0.44, 0.562, 0.731,
|
|
57
|
+
0.978, 1,
|
|
58
|
+
],
|
|
59
|
+
[
|
|
60
|
+
0, 0, 0, 0.004, 0.018, 0.036, 0.054, 0.072, 0.092, 0.113, 0.138, 0.168, 0.204, 0.248, 0.314,
|
|
61
|
+
0.435, 1,
|
|
62
|
+
],
|
|
63
|
+
] as const;
|
|
64
|
+
const VOLUME_QUANTILES = [
|
|
65
|
+
[
|
|
66
|
+
-0.147, 0.309, 0.365, 0.405, 0.437, 0.464, 0.489, 0.513, 0.536, 0.558, 0.582, 0.606, 0.633,
|
|
67
|
+
0.665, 0.703, 0.756, 1.071,
|
|
68
|
+
],
|
|
69
|
+
[
|
|
70
|
+
0, 0.173, 0.235, 0.282, 0.322, 0.357, 0.39, 0.42, 0.45, 0.481, 0.512, 0.545, 0.581, 0.619,
|
|
71
|
+
0.666, 0.728, 1.022,
|
|
72
|
+
],
|
|
73
|
+
] as const;
|
|
74
|
+
// Cells per repeat of the pattern's base octave: sets each channel's correlation length.
|
|
75
|
+
const PATTERN_CELLS = [6, 15, 30] as const;
|
|
76
|
+
// T_Profile_08 channels as degree-4 polynomials in (altitude in layer, pattern value):
|
|
77
|
+
// exponents [i, j] and coefficients for u^i v^j. Fitted to the texture (rms error 0.006 to 0.012).
|
|
78
|
+
const PROFILE_TERMS: ReadonlyArray<readonly [number, number]> = [
|
|
79
|
+
[0, 0],
|
|
80
|
+
[0, 1],
|
|
81
|
+
[0, 2],
|
|
82
|
+
[0, 3],
|
|
83
|
+
[0, 4],
|
|
84
|
+
[1, 0],
|
|
85
|
+
[1, 1],
|
|
86
|
+
[1, 2],
|
|
87
|
+
[1, 3],
|
|
88
|
+
[2, 0],
|
|
89
|
+
[2, 1],
|
|
90
|
+
[2, 2],
|
|
91
|
+
[3, 0],
|
|
92
|
+
[3, 1],
|
|
93
|
+
[4, 0],
|
|
94
|
+
];
|
|
95
|
+
const PROFILE_COEFFICIENTS = [
|
|
96
|
+
[
|
|
97
|
+
0.3741, 0.499, -1.2672, 1.2328, -0.4107, 0.8894, 0.3392, 0.4021, -0.2367, -2.8264, -1.2088,
|
|
98
|
+
0.4296, 2.6391, 0.5109, -0.8971,
|
|
99
|
+
],
|
|
100
|
+
[
|
|
101
|
+
0.2818, 0.049, -0.3788, 0.7721, -0.1495, -0.1268, 1.0841, -1.9311, 0.0666, 2.8644, 0.0744,
|
|
102
|
+
1.329, -5.4491, -0.7025, 2.7003,
|
|
103
|
+
],
|
|
104
|
+
[
|
|
105
|
+
0.049, 0.0514, -0.119, 0.1602, -0.077, 0.7471, 0.0678, -0.1132, 0.0743, -1.4245, -0.0577,
|
|
106
|
+
-0.0141, 2.7099, 0.0675, -1.6358,
|
|
107
|
+
],
|
|
108
|
+
] as const;
|
|
109
|
+
|
|
110
|
+
const clamp = (v: number): number => Math.max(0, Math.min(1, v));
|
|
111
|
+
const smooth = (v: number): number => {
|
|
112
|
+
const t = clamp(v);
|
|
113
|
+
return t * t * (3 - 2 * t);
|
|
114
|
+
};
|
|
115
|
+
const mod = (a: number, n: number): number => ((a % n) + n) % n;
|
|
116
|
+
|
|
117
|
+
function rng(seed: number): () => number {
|
|
118
|
+
let state = seed | 0;
|
|
119
|
+
return () => {
|
|
120
|
+
state = (Math.imul(state, 1664525) + 1013904223) | 0;
|
|
121
|
+
return (state >>> 0) / 4294967296;
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
/**
|
|
126
|
+
* One axis of a periodic lattice, per voxel: the two cells it blends (wrapped), and the blend weight of
|
|
127
|
+
* the second (`smooth` of the fraction) with its complement. Computed once per axis position, not once
|
|
128
|
+
* per voxel and neighbour; the expressions are the ones the per-voxel loop used, so every float matches.
|
|
129
|
+
*/
|
|
130
|
+
function latticeAxis(cells: number, size: number) {
|
|
131
|
+
const first = new Int32Array(size);
|
|
132
|
+
const second = new Int32Array(size);
|
|
133
|
+
const upper = new Float64Array(size);
|
|
134
|
+
const lower = new Float64Array(size);
|
|
135
|
+
for (let n = 0; n < size; n++) {
|
|
136
|
+
const f = ((n + 0.5) / size) * cells - 0.5;
|
|
137
|
+
const i = Math.floor(f);
|
|
138
|
+
const w = smooth(f - i);
|
|
139
|
+
first[n] = mod(i, cells);
|
|
140
|
+
second[n] = mod(i + 1, cells);
|
|
141
|
+
upper[n] = w;
|
|
142
|
+
lower[n] = 1 - w;
|
|
143
|
+
}
|
|
144
|
+
return { first, second, upper, lower };
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/** Periodic value noise on a size^dims grid with `cells` lattice cells per axis. */
|
|
148
|
+
function valueNoise(cells: number, size: number, dims: 2 | 3, next: () => number): Float32Array {
|
|
149
|
+
const lattice = Float32Array.from({ length: cells ** dims }, next);
|
|
150
|
+
const out = new Float32Array(size ** dims);
|
|
151
|
+
const depth = dims === 3 ? size : 1;
|
|
152
|
+
const layers = dims === 3 ? 2 : 1;
|
|
153
|
+
const axis = latticeAxis(cells, size);
|
|
154
|
+
// Typed-array reads are in range by construction (every index is below `size`), hence the casts.
|
|
155
|
+
const { first, second, lower, upper } = axis;
|
|
156
|
+
for (let z = 0; z < depth; z++) {
|
|
157
|
+
for (let y = 0; y < size; y++) {
|
|
158
|
+
for (let x = 0; x < size; x++) {
|
|
159
|
+
let sum = 0;
|
|
160
|
+
for (let c = 0; c < layers; c++) {
|
|
161
|
+
const zOffset = dims === 3 ? cells * cells * ((c ? second[z] : first[z]) as number) : 0;
|
|
162
|
+
const wz = dims === 3 ? ((c ? upper[z] : lower[z]) as number) : 1;
|
|
163
|
+
for (let b = 0; b < 2; b++) {
|
|
164
|
+
const yOffset = cells * ((b ? second[y] : first[y]) as number);
|
|
165
|
+
const wy = (b ? upper[y] : lower[y]) as number;
|
|
166
|
+
for (let a = 0; a < 2; a++) {
|
|
167
|
+
const at = ((a ? second[x] : first[x]) as number) + yOffset + zOffset;
|
|
168
|
+
sum += (lattice[at] ?? 0) * ((a ? upper[x] : lower[x]) as number) * wy * wz;
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
out[x + size * (y + size * z)] = sum;
|
|
173
|
+
}
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
return out;
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
/**
|
|
180
|
+
* Periodic inverted Worley F1: 1 minus the distance to the nearest of one point per cell.
|
|
181
|
+
*
|
|
182
|
+
* The nearest of the 27 surrounding cells' points is a minimum, so it does not depend on the order the
|
|
183
|
+
* cells are visited, and a cell whose nearest possible point (its whole cell box) is already farther
|
|
184
|
+
* than the best so far cannot change it. The cells are visited centre first and the far ones are
|
|
185
|
+
* skipped by that bound; each point's distance is computed with the same expression as before, so the
|
|
186
|
+
* result is bit for bit the full 27-cell scan.
|
|
187
|
+
*/
|
|
188
|
+
function worleyInverted(cells: number, size: number, next: () => number): Float32Array {
|
|
189
|
+
const points = Float32Array.from({ length: cells ** 3 * 3 }, next);
|
|
190
|
+
const out = new Float32Array(size ** 3);
|
|
191
|
+
// Per axis position: the sample point, its cell, the wrapped cell and the squared distance from the
|
|
192
|
+
// sample to the nearest edge of the box of each of the three neighbours (-1, 0, +1). A point lies
|
|
193
|
+
// in [0, 1) of its cell, and the margin covers the rounding of the bound itself.
|
|
194
|
+
const p = new Float64Array(size);
|
|
195
|
+
const cell = new Int32Array(size);
|
|
196
|
+
const wrapped = new Int32Array(size * 3);
|
|
197
|
+
const gap = new Float64Array(size * 3);
|
|
198
|
+
const margin = 1e-9;
|
|
199
|
+
for (let n = 0; n < size; n++) {
|
|
200
|
+
p[n] = ((n + 0.5) / size) * cells;
|
|
201
|
+
cell[n] = Math.floor(p[n] as number);
|
|
202
|
+
for (let d = 0; d < 3; d++) {
|
|
203
|
+
const low = (cell[n] as number) + d - 1 - (p[n] as number);
|
|
204
|
+
wrapped[n * 3 + d] = mod((cell[n] as number) + d - 1, cells);
|
|
205
|
+
gap[n * 3 + d] = low > 0 ? low * low : low + 1 < 0 ? (low + 1) ** 2 : 0;
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
for (let z = 0; z < size; z++) {
|
|
209
|
+
const pz = p[z] as number;
|
|
210
|
+
const cz = cell[z] as number;
|
|
211
|
+
for (let y = 0; y < size; y++) {
|
|
212
|
+
const py = p[y] as number;
|
|
213
|
+
const cy = cell[y] as number;
|
|
214
|
+
for (let x = 0; x < size; x++) {
|
|
215
|
+
const px = p[x] as number;
|
|
216
|
+
const cx = cell[x] as number;
|
|
217
|
+
let best = 9;
|
|
218
|
+
for (let a = 0; a < 3; a++) {
|
|
219
|
+
const kk = (a + 1) % 3;
|
|
220
|
+
const gz = gap[z * 3 + kk] as number;
|
|
221
|
+
if (gz > best + margin) continue;
|
|
222
|
+
const k = kk - 1;
|
|
223
|
+
const zOffset = cells * cells * (wrapped[z * 3 + kk] as number);
|
|
224
|
+
for (let b = 0; b < 3; b++) {
|
|
225
|
+
const jj = (b + 1) % 3;
|
|
226
|
+
const gyz = gz + (gap[y * 3 + jj] as number);
|
|
227
|
+
if (gyz > best + margin) continue;
|
|
228
|
+
const j = jj - 1;
|
|
229
|
+
const yOffset = cells * (wrapped[y * 3 + jj] as number);
|
|
230
|
+
for (let c = 0; c < 3; c++) {
|
|
231
|
+
const ii = (c + 1) % 3;
|
|
232
|
+
if (gyz + (gap[x * 3 + ii] as number) > best + margin) continue;
|
|
233
|
+
const i = ii - 1;
|
|
234
|
+
const at = 3 * ((wrapped[x * 3 + ii] as number) + yOffset + zOffset);
|
|
235
|
+
const dx = cx + i + (points[at] ?? 0) - px;
|
|
236
|
+
const dy = cy + j + (points[at + 1] ?? 0) - py;
|
|
237
|
+
const dz = cz + k + (points[at + 2] ?? 0) - pz;
|
|
238
|
+
best = Math.min(best, dx * dx + dy * dy + dz * dz);
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
}
|
|
242
|
+
out[x + size * (y + size * z)] = 1 - Math.sqrt(best);
|
|
243
|
+
}
|
|
244
|
+
}
|
|
245
|
+
}
|
|
246
|
+
return out;
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
const standardise = (v: Float32Array): Float32Array => {
|
|
250
|
+
let mean = 0;
|
|
251
|
+
for (const x of v) mean += x;
|
|
252
|
+
mean /= v.length;
|
|
253
|
+
let variance = 0;
|
|
254
|
+
for (const x of v) variance += (x - mean) ** 2;
|
|
255
|
+
const scale = 1 / Math.sqrt(variance / v.length || 1);
|
|
256
|
+
return v.map((x) => (x - mean) * scale);
|
|
257
|
+
};
|
|
258
|
+
|
|
259
|
+
/** Replace each value by the quantile-table value at its rank, keeping the noise's spatial order. */
|
|
260
|
+
function matchQuantiles(values: Float32Array, table: readonly number[]): Float32Array {
|
|
261
|
+
const sorted = Float32Array.from(values).sort();
|
|
262
|
+
const last = table.length - 1;
|
|
263
|
+
return values.map((value) => {
|
|
264
|
+
let lo = 0;
|
|
265
|
+
let hi = sorted.length;
|
|
266
|
+
while (lo < hi) {
|
|
267
|
+
const mid = (lo + hi) >> 1;
|
|
268
|
+
if ((sorted[mid] ?? 0) < value) lo = mid + 1;
|
|
269
|
+
else hi = mid;
|
|
270
|
+
}
|
|
271
|
+
const t = (lo / Math.max(1, sorted.length - 1)) * last;
|
|
272
|
+
const i = Math.min(last - 1, Math.floor(t));
|
|
273
|
+
return (table[i] ?? 0) + ((table[i + 1] ?? 0) - (table[i] ?? 0)) * (t - i);
|
|
274
|
+
});
|
|
275
|
+
}
|
|
276
|
+
|
|
277
|
+
export interface ICloudTextures {
|
|
278
|
+
/** RGBA float, PATTERN_SIZE squared, one cloud type per channel (alpha unused). */
|
|
279
|
+
pattern: Float32Array;
|
|
280
|
+
/** RG float, VOLUME_SIZE cubed: R is the distortion noise, G the shape noise. */
|
|
281
|
+
volume: Float32Array;
|
|
282
|
+
}
|
|
283
|
+
const textureCache = new Map<number, ICloudTextures>();
|
|
284
|
+
|
|
285
|
+
export function cloudTextures(seed = 631): ICloudTextures {
|
|
286
|
+
const cached = textureCache.get(seed);
|
|
287
|
+
if (cached) return cached;
|
|
288
|
+
const next = rng(seed);
|
|
289
|
+
const n = PATTERN_SIZE;
|
|
290
|
+
const pattern = new Float32Array(n * n * 4);
|
|
291
|
+
for (let c = 0; c < 3; c++) {
|
|
292
|
+
let field = new Float32Array(n * n);
|
|
293
|
+
for (let o = 0; o < 3; o++) {
|
|
294
|
+
const octave = valueNoise((PATTERN_CELLS[c] ?? 8) * 2 ** o, n, 2, next);
|
|
295
|
+
field = field.map((v, i) => v + (octave[i] ?? 0) * 0.5 ** o);
|
|
296
|
+
}
|
|
297
|
+
const mapped = matchQuantiles(field, PATTERN_QUANTILES[c] ?? []);
|
|
298
|
+
for (let i = 0; i < n * n; i++) pattern[i * 4 + c] = mapped[i] ?? 0;
|
|
299
|
+
}
|
|
300
|
+
const v = VOLUME_SIZE;
|
|
301
|
+
const blend = (
|
|
302
|
+
cells: number,
|
|
303
|
+
noiseCells: number,
|
|
304
|
+
weight: number,
|
|
305
|
+
table: readonly number[],
|
|
306
|
+
): Float32Array => {
|
|
307
|
+
const worley = standardise(worleyInverted(cells, v, next));
|
|
308
|
+
const smoothNoise = standardise(valueNoise(noiseCells, v, 3, next));
|
|
309
|
+
return matchQuantiles(
|
|
310
|
+
worley.map((x, i) => weight * x + (1 - weight) * (smoothNoise[i] ?? 0)),
|
|
311
|
+
table,
|
|
312
|
+
);
|
|
313
|
+
};
|
|
314
|
+
const shape = blend(6, 3, 0.7, VOLUME_QUANTILES[1]);
|
|
315
|
+
const distortion = blend(3, 8, 0.92, VOLUME_QUANTILES[0]);
|
|
316
|
+
const volume = new Float32Array(v ** 3 * 2);
|
|
317
|
+
for (let i = 0; i < v ** 3; i++) {
|
|
318
|
+
volume[i * 2] = distortion[i] ?? 0;
|
|
319
|
+
volume[i * 2 + 1] = shape[i] ?? 0;
|
|
320
|
+
}
|
|
321
|
+
const textures = { pattern, volume };
|
|
322
|
+
textureCache.set(seed, textures);
|
|
323
|
+
return textures;
|
|
324
|
+
}
|
|
325
|
+
|
|
326
|
+
/** T_Profile_08 stand-in: the three cloud types' vertical profile at altitude fraction u, pattern v. */
|
|
327
|
+
function cloudProfile(type: 0 | 1 | 2, u: number, v: number): number {
|
|
328
|
+
const coefficients = PROFILE_COEFFICIENTS[type];
|
|
329
|
+
const u2 = u * u;
|
|
330
|
+
const u3 = u2 * u;
|
|
331
|
+
const v2 = v * v;
|
|
332
|
+
const v3 = v2 * v;
|
|
333
|
+
const u4 = u3 * u;
|
|
334
|
+
const v4 = v3 * v;
|
|
335
|
+
const us = [1, u, u2, u3, u4];
|
|
336
|
+
const vs = [1, v, v2, v3, v4];
|
|
337
|
+
let sum = 0;
|
|
338
|
+
for (let i = 0; i < PROFILE_TERMS.length; i++) {
|
|
339
|
+
const term = PROFILE_TERMS[i] ?? [0, 0];
|
|
340
|
+
sum += (coefficients[i] ?? 0) * (us[term[0]] ?? 0) * (vs[term[1]] ?? 0);
|
|
341
|
+
}
|
|
342
|
+
return sum;
|
|
343
|
+
}
|
|
344
|
+
/** Profile baked to a 64 x 64 RGBA texture, u along x and the pattern value along y. */
|
|
345
|
+
export function cloudProfileTexture(size = 64): Float32Array {
|
|
346
|
+
const out = new Float32Array(size * size * 4);
|
|
347
|
+
for (let y = 0; y < size; y++)
|
|
348
|
+
for (let x = 0; x < size; x++)
|
|
349
|
+
for (let c = 0; c < 3; c++)
|
|
350
|
+
out[(y * size + x) * 4 + c] = cloudProfile(
|
|
351
|
+
c as 0 | 1 | 2,
|
|
352
|
+
(x + 0.5) / size,
|
|
353
|
+
(y + 0.5) / size,
|
|
354
|
+
);
|
|
355
|
+
return out;
|
|
356
|
+
}
|
|
357
|
+
|
|
358
|
+
// The two samplers run per ray step in the CPU sky bake. The wrapped cell indices and the complementary
|
|
359
|
+
// weights are computed once per call, not once per tap or closure; every product and sum is the one the
|
|
360
|
+
// closure form evaluated, in the same order.
|
|
361
|
+
function samplePattern(pattern: Float32Array, u: number, v: number, c: number): number {
|
|
362
|
+
const n = PATTERN_SIZE;
|
|
363
|
+
const fx = u * n - 0.5;
|
|
364
|
+
const fy = v * n - 0.5;
|
|
365
|
+
const ix = Math.floor(fx);
|
|
366
|
+
const iy = Math.floor(fy);
|
|
367
|
+
const wx = fx - ix;
|
|
368
|
+
const wy = fy - iy;
|
|
369
|
+
const x0 = mod(ix, n);
|
|
370
|
+
const x1 = mod(ix + 1, n);
|
|
371
|
+
const row0 = mod(iy, n) * n;
|
|
372
|
+
const row1 = mod(iy + 1, n) * n;
|
|
373
|
+
const nx = 1 - wx;
|
|
374
|
+
return (
|
|
375
|
+
((pattern[(row0 + x0) * 4 + c] ?? 0) * nx + (pattern[(row0 + x1) * 4 + c] ?? 0) * wx) *
|
|
376
|
+
(1 - wy) +
|
|
377
|
+
((pattern[(row1 + x0) * 4 + c] ?? 0) * nx + (pattern[(row1 + x1) * 4 + c] ?? 0) * wx) * wy
|
|
378
|
+
);
|
|
379
|
+
}
|
|
380
|
+
|
|
381
|
+
function sampleVolume(volume: Float32Array, x: number, y: number, z: number, c: number): number {
|
|
382
|
+
const n = VOLUME_SIZE;
|
|
383
|
+
const fx = x * n - 0.5;
|
|
384
|
+
const fy = y * n - 0.5;
|
|
385
|
+
const fz = z * n - 0.5;
|
|
386
|
+
const ix = Math.floor(fx);
|
|
387
|
+
const iy = Math.floor(fy);
|
|
388
|
+
const iz = Math.floor(fz);
|
|
389
|
+
const wx = fx - ix;
|
|
390
|
+
const wy = fy - iy;
|
|
391
|
+
const wz = fz - iz;
|
|
392
|
+
const x0 = mod(ix, n);
|
|
393
|
+
const x1 = mod(ix + 1, n);
|
|
394
|
+
const y0 = n * mod(iy, n);
|
|
395
|
+
const y1 = n * mod(iy + 1, n);
|
|
396
|
+
const z0 = n * n * mod(iz, n);
|
|
397
|
+
const z1 = n * n * mod(iz + 1, n);
|
|
398
|
+
const nx = 1 - wx;
|
|
399
|
+
const ny = 1 - wy;
|
|
400
|
+
const plane0 =
|
|
401
|
+
((volume[(x0 + y0 + z0) * 2 + c] ?? 0) * nx + (volume[(x1 + y0 + z0) * 2 + c] ?? 0) * wx) * ny +
|
|
402
|
+
((volume[(x0 + y1 + z0) * 2 + c] ?? 0) * nx + (volume[(x1 + y1 + z0) * 2 + c] ?? 0) * wx) * wy;
|
|
403
|
+
const plane1 =
|
|
404
|
+
((volume[(x0 + y0 + z1) * 2 + c] ?? 0) * nx + (volume[(x1 + y0 + z1) * 2 + c] ?? 0) * wx) * ny +
|
|
405
|
+
((volume[(x0 + y1 + z1) * 2 + c] ?? 0) * nx + (volume[(x1 + y1 + z1) * 2 + c] ?? 0) * wx) * wy;
|
|
406
|
+
return plane0 * (1 - wz) + plane1 * wz;
|
|
407
|
+
}
|
|
408
|
+
|
|
409
|
+
/**
|
|
410
|
+
* Extinction per metre at planet-centred (x, y, z) km, y up. The material's graph, with wind at
|
|
411
|
+
* zero and the three cloud types at weight one: coverage pattern times (altitude profile
|
|
412
|
+
* minus one half plus distorted shape noise), times Cloud_GlobalDensity, zero near layer edges.
|
|
413
|
+
*/
|
|
414
|
+
function cloudDensityField(seed = 631): (x: number, y: number, z: number) => number {
|
|
415
|
+
const { pattern, volume } = cloudTextures(seed);
|
|
416
|
+
const m = CLOUD_MATERIAL;
|
|
417
|
+
return (x, y, z) => {
|
|
418
|
+
const altitude = Math.hypot(x, y, z) - PLANET;
|
|
419
|
+
if (altitude <= CLOUD_BOTTOM_KM || altitude >= CLOUD_TOP_KM) return 0;
|
|
420
|
+
const h = (altitude - CLOUD_BOTTOM_KM) / (CLOUD_TOP_KM - CLOUD_BOTTOM_KM);
|
|
421
|
+
if (h < m.insideLayer[0] || h > m.insideLayer[1]) return 0;
|
|
422
|
+
const u = x / m.layoutKm;
|
|
423
|
+
const v = z / m.layoutKm;
|
|
424
|
+
const p0 = samplePattern(pattern, u, v, 0);
|
|
425
|
+
const p1 = samplePattern(pattern, u, v, 1);
|
|
426
|
+
const p2 = samplePattern(pattern, u, v, 2);
|
|
427
|
+
const coverage = Math.max(p0, p1, p2);
|
|
428
|
+
if (coverage <= 0) return 0;
|
|
429
|
+
const profile =
|
|
430
|
+
Math.max(cloudProfile(0, h, p0), cloudProfile(1, h, p1), cloudProfile(2, h, p2)) - 0.5;
|
|
431
|
+
const sky: [number, number, number] = [u + 0.5, v + 0.5, (y - PLANET) / m.layoutKm];
|
|
432
|
+
const a = h * 0.95 + 0.05;
|
|
433
|
+
const c = (2 * Math.abs(a - 0.5)) ** 2;
|
|
434
|
+
const warp =
|
|
435
|
+
(sampleVolume(
|
|
436
|
+
volume,
|
|
437
|
+
sky[0] * m.noise2Scale[0],
|
|
438
|
+
sky[1] * m.noise2Scale[1],
|
|
439
|
+
sky[2] * m.noise2Scale[2],
|
|
440
|
+
0,
|
|
441
|
+
) -
|
|
442
|
+
m.noiseBias[1]) *
|
|
443
|
+
m.noiseStrength[1];
|
|
444
|
+
const shape = sampleVolume(
|
|
445
|
+
volume,
|
|
446
|
+
sky[0] * m.noise1Scale[0] + a * warp,
|
|
447
|
+
sky[1] * m.noise1Scale[1] + a * warp,
|
|
448
|
+
sky[2] * m.noise1Scale[2] + c * warp,
|
|
449
|
+
1,
|
|
450
|
+
);
|
|
451
|
+
const noise = (shape - m.noiseBias[0] + m.coverage) * m.noiseStrength[0];
|
|
452
|
+
return clamp(coverage * (profile + noise) * m.density);
|
|
453
|
+
};
|
|
454
|
+
}
|
|
455
|
+
|
|
456
|
+
/** Beer–Lambert transmission for a nonnegative optical depth. */
|
|
457
|
+
const cloudTransmittance = (depth: number): number => Math.exp(-Math.max(0, depth));
|
|
458
|
+
const hg = (cosine: number, g: number): number =>
|
|
459
|
+
(1 - g * g) / (4 * Math.PI * (1 + g * g - 2 * g * cosine) ** 1.5);
|
|
460
|
+
/** The material's dual lobe: HG(g) blended toward HG(g2). */
|
|
461
|
+
const cloudPhase = (cosine: number): number => {
|
|
462
|
+
const p = CLOUD_MATERIAL.phase;
|
|
463
|
+
const forward = hg(cosine, p.g);
|
|
464
|
+
return forward + p.blend * (hg(cosine, p.g2) - forward);
|
|
465
|
+
};
|
|
466
|
+
/** Per scattering octave: scattering and extinction scale, and the lerp toward isotropic phase. */
|
|
467
|
+
export function cloudOctaves(): Array<{ scatter: number; extinction: number; anisotropy: number }> {
|
|
468
|
+
const ms = CLOUD_MATERIAL.multiScatter;
|
|
469
|
+
let s = ms.contribution;
|
|
470
|
+
let e = ms.occlusion;
|
|
471
|
+
let f = ms.eccentricity;
|
|
472
|
+
const out = [{ scatter: 1, extinction: 1, anisotropy: 1 }];
|
|
473
|
+
for (let i = 1; i <= ms.octaves; i++) {
|
|
474
|
+
const last = out[i - 1] ?? { scatter: 1, extinction: 1, anisotropy: 1 };
|
|
475
|
+
out.push({ scatter: last.scatter * s, extinction: last.extinction * e, anisotropy: f });
|
|
476
|
+
s *= s;
|
|
477
|
+
e *= e;
|
|
478
|
+
f *= f;
|
|
479
|
+
}
|
|
480
|
+
return out;
|
|
481
|
+
}
|
|
482
|
+
const sphereExit = (r: number, mu: number, radius: number): number =>
|
|
483
|
+
-r * mu + Math.sqrt(r * r * mu * mu + radius * radius - r * r);
|
|
484
|
+
|
|
485
|
+
/** Composite in place, in bakeSkyRadiance's radiance per unit sun illuminance; no DOM or GPU. */
|
|
486
|
+
export function bakeCloudRadiance(
|
|
487
|
+
radiance: Float32Array,
|
|
488
|
+
sun: { x: number; y: number; z: number },
|
|
489
|
+
width: number,
|
|
490
|
+
height: number,
|
|
491
|
+
seed = 631,
|
|
492
|
+
): void {
|
|
493
|
+
if (
|
|
494
|
+
!Number.isInteger(width) ||
|
|
495
|
+
!Number.isInteger(height) ||
|
|
496
|
+
width < 1 ||
|
|
497
|
+
height < 1 ||
|
|
498
|
+
radiance.length !== width * height * 3 ||
|
|
499
|
+
!Number.isFinite(seed) ||
|
|
500
|
+
!(Math.abs(Math.hypot(sun.x, sun.y, sun.z) - 1) <= 0.001)
|
|
501
|
+
) {
|
|
502
|
+
throw new Error(
|
|
503
|
+
"Cloud bake requires matching positive dimensions, a finite seed and a unit sun",
|
|
504
|
+
);
|
|
505
|
+
}
|
|
506
|
+
const density = cloudDensityField(seed);
|
|
507
|
+
const octaves = cloudOctaves();
|
|
508
|
+
const ambient = [0, 0, 0];
|
|
509
|
+
let weights = 0;
|
|
510
|
+
for (let y = 0; y < height / 2; y += 1) {
|
|
511
|
+
const theta = ((y + 0.5) / height) * Math.PI;
|
|
512
|
+
const weight = Math.sin(theta) * Math.max(0, Math.cos(theta));
|
|
513
|
+
for (let x = 0; x < width; x += 1) {
|
|
514
|
+
for (let c = 0; c < 3; c += 1)
|
|
515
|
+
ambient[c] = (ambient[c] ?? 0) + (radiance[(y * width + x) * 3 + c] ?? 0) * weight;
|
|
516
|
+
weights += weight;
|
|
517
|
+
}
|
|
518
|
+
}
|
|
519
|
+
for (let c = 0; c < 3; c += 1) ambient[c] = (ambient[c] ?? 0) / Math.max(weights, 1e-9);
|
|
520
|
+
for (let y = 0; y < height / 2; y += 1) {
|
|
521
|
+
const elevation = Math.PI / 2 - ((y + 0.5) / height) * Math.PI;
|
|
522
|
+
const dy = Math.sin(elevation);
|
|
523
|
+
const horizontal = Math.cos(elevation);
|
|
524
|
+
const entry = sphereExit(CAMERA, dy, PLANET + CLOUD_BOTTOM_KM);
|
|
525
|
+
if (entry > 350) continue;
|
|
526
|
+
const length = Math.min(
|
|
527
|
+
CLOUD_MODEL.tracingKm,
|
|
528
|
+
sphereExit(CAMERA, dy, PLANET + CLOUD_TOP_KM) - entry,
|
|
529
|
+
);
|
|
530
|
+
const steps = Math.min(
|
|
531
|
+
CLOUD_MODEL.maxViewSteps,
|
|
532
|
+
Math.max(CLOUD_MODEL.minViewSteps, Math.ceil((length * 1000) / CLOUD_MODEL.viewStepMetres)),
|
|
533
|
+
);
|
|
534
|
+
const dt = length / steps;
|
|
535
|
+
const fade =
|
|
536
|
+
1 -
|
|
537
|
+
smooth(
|
|
538
|
+
(entry - CLOUD_MODEL.horizonFadeStartKm) /
|
|
539
|
+
(CLOUD_MODEL.horizonFadeEndKm - CLOUD_MODEL.horizonFadeStartKm),
|
|
540
|
+
);
|
|
541
|
+
// shortcut: integrate the clear-air column to layer entry, not per cloud sample; upgrade for airborne cameras.
|
|
542
|
+
const airDepth = [0, 0, 0];
|
|
543
|
+
for (let i = 0; i < 8; i += 1) {
|
|
544
|
+
const t = (entry * (i + 0.5)) / 8;
|
|
545
|
+
const h = Math.hypot(horizontal * t, CAMERA + dy * t) - PLANET;
|
|
546
|
+
for (let c = 0; c < 3; c += 1)
|
|
547
|
+
airDepth[c] =
|
|
548
|
+
(airDepth[c] ?? 0) +
|
|
549
|
+
(((RAYLEIGH[c as 0 | 1 | 2] ?? 0) * Math.exp(-h / 8) +
|
|
550
|
+
(MIE_SCATTER + MIE_ABSORB) * Math.exp(-h / 1.2)) *
|
|
551
|
+
entry) /
|
|
552
|
+
8;
|
|
553
|
+
}
|
|
554
|
+
for (let x = 0; x < width; x += 1) {
|
|
555
|
+
const azimuth = ((x + 0.5) / width - 0.5) * 2 * Math.PI;
|
|
556
|
+
const dx = horizontal * Math.cos(azimuth);
|
|
557
|
+
const dz = horizontal * Math.sin(azimuth);
|
|
558
|
+
const phase = cloudPhase(dx * sun.x + dy * sun.y + dz * sun.z);
|
|
559
|
+
let through = 1;
|
|
560
|
+
const light = [0, 0, 0];
|
|
561
|
+
for (let i = 0; i < steps && through > 0.005; i += 1) {
|
|
562
|
+
const t = entry + (i + 0.5) * dt;
|
|
563
|
+
const px = dx * t;
|
|
564
|
+
const py = CAMERA + dy * t;
|
|
565
|
+
const pz = dz * t;
|
|
566
|
+
const extinction = density(px, py, pz) * 1000 * fade; // per km
|
|
567
|
+
if (extinction === 0) continue;
|
|
568
|
+
const r = Math.hypot(px, py, pz);
|
|
569
|
+
const shadowLength = Math.min(
|
|
570
|
+
15,
|
|
571
|
+
sphereExit(r, (px * sun.x + py * sun.y + pz * sun.z) / r, PLANET + CLOUD_TOP_KM),
|
|
572
|
+
);
|
|
573
|
+
let shadowDepth = 0;
|
|
574
|
+
for (let j = 0; j < CLOUD_MODEL.lightSteps; j += 1) {
|
|
575
|
+
const s = shadowLength * ((j + 0.5) / CLOUD_MODEL.lightSteps) ** 2;
|
|
576
|
+
const ds = (shadowLength * (2 * j + 1)) / CLOUD_MODEL.lightSteps ** 2;
|
|
577
|
+
shadowDepth += density(px + sun.x * s, py + sun.y * s, pz + sun.z * s) * 1000 * ds;
|
|
578
|
+
}
|
|
579
|
+
const stepT = cloudTransmittance(extinction * dt);
|
|
580
|
+
let direct = 0;
|
|
581
|
+
for (const o of octaves)
|
|
582
|
+
direct +=
|
|
583
|
+
o.scatter *
|
|
584
|
+
cloudTransmittance(shadowDepth * o.extinction) *
|
|
585
|
+
(1 / (4 * Math.PI) + (phase - 1 / (4 * Math.PI)) * o.anisotropy);
|
|
586
|
+
// The sun reaches this sample through the air above it, not through the whole atmosphere.
|
|
587
|
+
const sunlight = transmittanceToTop(r, (px * sun.x + py * sun.y + pz * sun.z) / r);
|
|
588
|
+
for (let c = 0; c < 3; c += 1) {
|
|
589
|
+
const source =
|
|
590
|
+
direct * (sunlight[c as 0 | 1 | 2] ?? 0) +
|
|
591
|
+
(ambient[c] ?? 0) * CLOUD_MATERIAL.skyOcclusion;
|
|
592
|
+
light[c] = (light[c] ?? 0) + through * (1 - stepT) * CLOUD_MATERIAL.albedo * source;
|
|
593
|
+
}
|
|
594
|
+
through *= stepT;
|
|
595
|
+
}
|
|
596
|
+
for (let c = 0; c < 3; c += 1) {
|
|
597
|
+
const at = (y * width + x) * 3 + c;
|
|
598
|
+
const sky = radiance[at] ?? 0;
|
|
599
|
+
radiance[at] =
|
|
600
|
+
sky + Math.exp(-(airDepth[c] ?? 0)) * ((light[c] ?? 0) - sky * (1 - through));
|
|
601
|
+
}
|
|
602
|
+
}
|
|
603
|
+
}
|
|
604
|
+
}
|
|
605
|
+
export type { Rgb };
|
|
@@ -25,7 +25,9 @@ export const ROOM_CENTRES = [-6, 6, 18] as const;
|
|
|
25
25
|
const ROOM_HALF_DEPTH = 6;
|
|
26
26
|
/** North and south walls; the south one is low so the top-down camera can see over it. */
|
|
27
27
|
const NORTH_WALL = 5.2;
|
|
28
|
-
|
|
28
|
+
// A kerb on purpose: the camera sits over this wall, and a ray from the lens to a player who stands
|
|
29
|
+
// against it crosses the wall at about 0.9 m, so a taller wall hides the player.
|
|
30
|
+
const SOUTH_WALL = 0.6;
|
|
29
31
|
const WALL_THICKNESS = 0.5;
|
|
30
32
|
const DOOR_HALF_WIDTH = 2;
|
|
31
33
|
const DOOR_HEIGHT = 3;
|
|
@@ -44,17 +46,17 @@ export interface IDungeon {
|
|
|
44
46
|
* A wall torch: a bracket, an emissive flame, and the point light that sells it. The light is
|
|
45
47
|
* the only warm source in the frame, so it is what tells you which wall the room's other end is.
|
|
46
48
|
*/
|
|
47
|
-
function addTorch(room: Group, x: number, wallZ: number, inward: number): void {
|
|
48
|
-
const bracket = solidBox([0.1, 0.1, 0.5], [x,
|
|
49
|
+
function addTorch(room: Group, x: number, wallZ: number, inward: number, mount = 2.25): void {
|
|
50
|
+
const bracket = solidBox([0.1, 0.1, 0.5], [x, mount, wallZ + inward * 0.25], structureMaterial);
|
|
49
51
|
bracket.name = "torch-bracket";
|
|
50
52
|
room.add(bracket);
|
|
51
53
|
const flame = new Mesh(new SphereGeometry(0.13, 8, 6), flameMaterial);
|
|
52
54
|
flame.name = "torch-flame";
|
|
53
55
|
flame.scale.y = 1.6;
|
|
54
|
-
flame.position.set(x, 2
|
|
56
|
+
flame.position.set(x, mount + 0.2, wallZ + inward * 0.45);
|
|
55
57
|
room.add(flame);
|
|
56
58
|
const light = new PointLight(0xffb066, 6, 9, 2);
|
|
57
|
-
light.position.set(x,
|
|
59
|
+
light.position.set(x, mount + 0.25, wallZ + inward * 0.7);
|
|
58
60
|
room.add(light);
|
|
59
61
|
}
|
|
60
62
|
|
|
@@ -170,7 +172,7 @@ export function createDungeon(): IDungeon {
|
|
|
170
172
|
room.add(cover);
|
|
171
173
|
}
|
|
172
174
|
addTorch(room, centre - 2.5, -ROOM_HALF_DEPTH, 1);
|
|
173
|
-
addTorch(room, centre + 2.5, ROOM_HALF_DEPTH, -1);
|
|
175
|
+
addTorch(room, centre + 2.5, ROOM_HALF_DEPTH, -1, SOUTH_WALL + 0.05);
|
|
174
176
|
// Torches and brackets never move relative to their room, so they bake down to one mesh per
|
|
175
177
|
// material; the floor, walls, pillars and doorway stay separate objects, because those are the
|
|
176
178
|
// ones a playtest looks up by name and the ones a trimesh body is built from.
|