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
|
@@ -41,6 +41,9 @@ export abstract class Fighter {
|
|
|
41
41
|
readonly conventions: IActionRpgConventions;
|
|
42
42
|
#action = "";
|
|
43
43
|
#actionRemaining = 0;
|
|
44
|
+
readonly #clipDuration = new Map<string, number>();
|
|
45
|
+
/** The last one-shot clip, the frames it advanced and the seconds it ran against the seconds its whole clip needs. */
|
|
46
|
+
#oneShot = { clip: "", frames: 0, needed: 0, ran: 0 };
|
|
44
47
|
|
|
45
48
|
protected constructor(
|
|
46
49
|
ctx: GameCtx,
|
|
@@ -58,6 +61,7 @@ export abstract class Fighter {
|
|
|
58
61
|
this.figure.scale.setScalar(options.scale ?? 1);
|
|
59
62
|
this.figure.rotation.y = options.facing ?? Math.PI;
|
|
60
63
|
this.mesh.add(this.figure);
|
|
64
|
+
for (const clip of model.animations) this.#clipDuration.set(clip.name, clip.duration);
|
|
61
65
|
// Measured, not guessed: the figure sinks by the distance from its own origin to its lowest
|
|
62
66
|
// posed point, so an asset authored feet-down and one authored mid-stride both land on the
|
|
63
67
|
// floor. Measured before the body is placed, while the mesh is still at the origin.
|
|
@@ -77,15 +81,47 @@ export abstract class Fighter {
|
|
|
77
81
|
}
|
|
78
82
|
|
|
79
83
|
/**
|
|
80
|
-
*
|
|
81
|
-
*
|
|
84
|
+
* What the playtest bridge reads off a registered entity, and what `assert.animation[]` bounds:
|
|
85
|
+
* the last one-shot action (swing, cast, roll, death; a flinch is a reaction, not an action) and
|
|
86
|
+
* whether it ran its whole clip before locomotion or another action took the rig over. The rig's
|
|
87
|
+
* own clip is the locomotion loop by then, so the one-shot is kept until the next one starts.
|
|
82
88
|
*/
|
|
83
|
-
|
|
89
|
+
get animation(): { advancedFrames: number; current: string; finished: boolean } {
|
|
90
|
+
const { clip, frames, needed, ran } = this.#oneShot;
|
|
91
|
+
return {
|
|
92
|
+
advancedFrames: frames,
|
|
93
|
+
current: clip === "" ? (this.character.current ?? "") : clip,
|
|
94
|
+
finished: clip !== "" && ran >= needed - 1e-6,
|
|
95
|
+
};
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Start a clip and return the rate it plays at. `hold` is how long a one-shot keeps the fighter
|
|
100
|
+
* out of its locomotion loop; the caller that owns the state machine decides when the action
|
|
101
|
+
* ends, not the clip. `fit` speeds the clip up so the whole clip plays inside `hold`.
|
|
102
|
+
*/
|
|
103
|
+
play(
|
|
104
|
+
action: string,
|
|
105
|
+
options: { readonly fade?: number; readonly fit?: boolean; readonly hold?: number } = {},
|
|
106
|
+
): number {
|
|
84
107
|
const clip = this.clips[action];
|
|
85
108
|
if (clip === undefined) throw new Error(`Unknown fighter action '${action}'.`);
|
|
86
109
|
this.#action = action;
|
|
87
110
|
this.#actionRemaining = options.hold ?? 0;
|
|
88
|
-
this.
|
|
111
|
+
const duration = this.#clipDuration.get(clip) ?? 0;
|
|
112
|
+
const speed =
|
|
113
|
+
options.fit === true && this.#actionRemaining > 0 && duration > 0
|
|
114
|
+
? duration / this.#actionRemaining
|
|
115
|
+
: undefined;
|
|
116
|
+
this.character.play(clip, {
|
|
117
|
+
fade: options.fade ?? 0.15,
|
|
118
|
+
mode: "once",
|
|
119
|
+
...(speed === undefined ? {} : { speed }),
|
|
120
|
+
});
|
|
121
|
+
// A flinch is a reaction to an enemy, not an action the fighter chose: it never replaces the record.
|
|
122
|
+
if (this.#actionRemaining > 0 && action !== "hit")
|
|
123
|
+
this.#oneShot = { clip, frames: 0, needed: duration / (speed ?? 1), ran: 0 };
|
|
124
|
+
return speed ?? 1;
|
|
89
125
|
}
|
|
90
126
|
|
|
91
127
|
/** True while a one-shot is still holding; locomotion waits for it. */
|
|
@@ -100,6 +136,10 @@ export abstract class Fighter {
|
|
|
100
136
|
* from the stick, and `AnimationPlayer`'s stride sync re-times it to the ground actually covered.
|
|
101
137
|
*/
|
|
102
138
|
protected animateRig(dt: number, heading: number | undefined, speed: number): void {
|
|
139
|
+
if (this.#actionRemaining > 0 && this.#action !== "hit") {
|
|
140
|
+
this.#oneShot.frames += 1;
|
|
141
|
+
this.#oneShot.ran += Math.min(dt, this.#actionRemaining);
|
|
142
|
+
}
|
|
103
143
|
this.#actionRemaining = Math.max(0, this.#actionRemaining - dt);
|
|
104
144
|
if (heading !== undefined && speed > 0.05) {
|
|
105
145
|
const turn = MathUtils.euclideanModulo(
|
|
@@ -1,8 +1,7 @@
|
|
|
1
1
|
import { CharacterBody3D, CollisionShape3D } from "@threenative/physics";
|
|
2
|
-
import { Vector3 } from "three";
|
|
2
|
+
import { MathUtils, type Object3D, Vector3 } from "three";
|
|
3
3
|
import { createSword } from "../render/props.js";
|
|
4
4
|
import type { ITouchInput } from "../render/touch-controls.js";
|
|
5
|
-
import type { GameState } from "../state.js";
|
|
6
5
|
import { Fighter, type GameCtx, type IMannequin } from "./Fighter.js";
|
|
7
6
|
|
|
8
7
|
export const WORLD_LAYER = 1;
|
|
@@ -26,10 +25,16 @@ const DODGE_SPEED = 9;
|
|
|
26
25
|
/** Capsule for a 1.8 m figure: 0.38 m half-height plus a 0.34 m radius at each end. */
|
|
27
26
|
const HALF_HEIGHT = 0.38;
|
|
28
27
|
const RADIUS = 0.34;
|
|
29
|
-
/**
|
|
30
|
-
|
|
28
|
+
/**
|
|
29
|
+
* How long a swing, a cast and a roll keep the legs from taking over the clip. The swing and the
|
|
30
|
+
* roll are fitted: their whole clip (`Sword_Attack` 1.53 s, `Roll` 1.47 s) plays inside the hold, so
|
|
31
|
+
* the follow-through is never cut, and a new swing waits for it.
|
|
32
|
+
*/
|
|
33
|
+
const SWING = 0.8;
|
|
34
|
+
/** When the blade crosses the front of the figure in `Sword_Attack`, in clip seconds: the hand peaks at 0.40 s. */
|
|
35
|
+
const SWING_CONTACT = 0.4;
|
|
31
36
|
const CAST = 0.7;
|
|
32
|
-
const ROLL = 0.
|
|
37
|
+
const ROLL = 0.7;
|
|
33
38
|
const DODGE_COOLDOWN = 1;
|
|
34
39
|
const REACH = 0.9;
|
|
35
40
|
|
|
@@ -38,10 +43,15 @@ export class Player extends Fighter {
|
|
|
38
43
|
readonly maxHealth = 100;
|
|
39
44
|
health: number;
|
|
40
45
|
dead = false;
|
|
41
|
-
equippedItem = "";
|
|
42
46
|
#bodyDisposed = false;
|
|
47
|
+
#equippedItem = "";
|
|
48
|
+
#sword: Object3D;
|
|
49
|
+
/** The landing half of the swing in progress: damage waits for the blade, not the key. */
|
|
50
|
+
#swing: { remaining: number; land: () => void } | undefined;
|
|
43
51
|
#dodgeCooldown = 0;
|
|
44
52
|
#dodgeRemaining = 0;
|
|
53
|
+
#rollDirection = new Vector3();
|
|
54
|
+
#rollDirectionChosen = false;
|
|
45
55
|
#forward = new Vector3();
|
|
46
56
|
#origin = new Vector3();
|
|
47
57
|
#onDamage: (amount: number) => void;
|
|
@@ -55,7 +65,10 @@ export class Player extends Fighter {
|
|
|
55
65
|
onDamage: (amount: number) => void,
|
|
56
66
|
onDeath: () => void,
|
|
57
67
|
) {
|
|
58
|
-
|
|
68
|
+
const sword = createSword();
|
|
69
|
+
super(ctx, model, CLIPS, { halfExtent: HALF_HEIGHT + RADIUS, weapon: sword });
|
|
70
|
+
this.#sword = sword;
|
|
71
|
+
this.equippedItem = "";
|
|
59
72
|
this.health = Math.max(0, Math.min(this.maxHealth, health));
|
|
60
73
|
this.mesh.position.copy(spawn);
|
|
61
74
|
this.#onDamage = onDamage;
|
|
@@ -83,18 +96,51 @@ export class Player extends Fighter {
|
|
|
83
96
|
}
|
|
84
97
|
this.#dodgeCooldown = Math.max(0, this.#dodgeCooldown - dt);
|
|
85
98
|
this.#dodgeRemaining = Math.max(0, this.#dodgeRemaining - dt);
|
|
99
|
+
if (this.#dodgeRemaining > 0 && !this.#rollDirectionChosen) {
|
|
100
|
+
this.#rollDirectionChosen = true;
|
|
101
|
+
this.#rollDirection.set(move.x, 0, -move.y);
|
|
102
|
+
if (this.#rollDirection.lengthSq() > 0.01) this.#rollDirection.normalize();
|
|
103
|
+
else this.facingVector(this.#rollDirection);
|
|
104
|
+
this.figure.rotation.y = Math.atan2(this.#rollDirection.x, this.#rollDirection.z);
|
|
105
|
+
}
|
|
86
106
|
const speed =
|
|
87
107
|
this.#dodgeRemaining > 0 ? DODGE_SPEED * (this.#dodgeRemaining / ROLL) : MOVE_SPEED;
|
|
88
|
-
this
|
|
108
|
+
if (this.#dodgeRemaining > 0)
|
|
109
|
+
this.body.velocity.copy(this.#rollDirection).multiplyScalar(speed);
|
|
110
|
+
else this.body.velocity.set(move.x * speed, 0, -move.y * speed);
|
|
89
111
|
this.body.moveAndSlide(dt);
|
|
90
112
|
this.conventions.applyGrounding(0, dt);
|
|
91
113
|
const heading = this.busy ? undefined : Math.atan2(this.body.velocity.x, this.body.velocity.z);
|
|
92
114
|
this.animateRig(dt, heading, Math.hypot(this.body.velocity.x, this.body.velocity.z));
|
|
115
|
+
const swing = this.#swing;
|
|
116
|
+
if (swing === undefined) return;
|
|
117
|
+
swing.remaining -= dt;
|
|
118
|
+
if (swing.remaining > 0) return;
|
|
119
|
+
this.#swing = undefined;
|
|
120
|
+
// A cast or a roll that took the clip over took the blade with it.
|
|
121
|
+
if (this.action === "attack") swing.land();
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
/** The hand holds the blade only while a weapon is equipped, so the figure and the HUD agree. */
|
|
125
|
+
get equippedItem(): string {
|
|
126
|
+
return this.#equippedItem;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
set equippedItem(itemId: string) {
|
|
130
|
+
this.#equippedItem = itemId;
|
|
131
|
+
this.#sword.visible = itemId !== "";
|
|
93
132
|
}
|
|
94
133
|
|
|
95
|
-
/**
|
|
96
|
-
|
|
97
|
-
|
|
134
|
+
/**
|
|
135
|
+
* The swing, the cast and the roll: three inputs, three clips, one state machine. `land` runs
|
|
136
|
+
* when the blade reaches the front of the figure; a press during a swing is ignored, so the
|
|
137
|
+
* clip and the hits it deals stay one to one.
|
|
138
|
+
*/
|
|
139
|
+
strike(land: () => void): boolean {
|
|
140
|
+
if (this.dead || (this.action === "attack" && this.busy)) return false;
|
|
141
|
+
const rate = this.play("attack", { fade: 0.05, fit: true, hold: SWING });
|
|
142
|
+
this.#swing = { land, remaining: SWING_CONTACT / rate };
|
|
143
|
+
return true;
|
|
98
144
|
}
|
|
99
145
|
|
|
100
146
|
cast(): void {
|
|
@@ -105,7 +151,8 @@ export class Player extends Fighter {
|
|
|
105
151
|
if (this.busy || this.#dodgeCooldown > 0) return false;
|
|
106
152
|
this.#dodgeCooldown = DODGE_COOLDOWN;
|
|
107
153
|
this.#dodgeRemaining = ROLL;
|
|
108
|
-
this
|
|
154
|
+
this.#rollDirectionChosen = false;
|
|
155
|
+
this.play("dodge", { fade: 0.05, hold: ROLL, fit: true });
|
|
109
156
|
return true;
|
|
110
157
|
}
|
|
111
158
|
|
|
@@ -148,12 +195,17 @@ export class Player extends Fighter {
|
|
|
148
195
|
action: this.action,
|
|
149
196
|
dead: this.dead,
|
|
150
197
|
equippedItem: this.equippedItem,
|
|
198
|
+
facingDegrees:
|
|
199
|
+
Math.round(
|
|
200
|
+
MathUtils.radToDeg(MathUtils.euclideanModulo(this.figure.rotation.y, Math.PI * 2)),
|
|
201
|
+
) % 360,
|
|
151
202
|
groundClearance: this.conventions.groundSnap.clearance,
|
|
152
203
|
health: this.health,
|
|
153
204
|
normaliseFactor: this.conventions.normaliseFactor,
|
|
154
205
|
position: this.mesh.position.toArray(),
|
|
155
206
|
skeletonBones: this.conventions.boneNames,
|
|
156
207
|
weaponBone: this.conventions.attachedBone,
|
|
208
|
+
weaponVisible: this.#sword.visible,
|
|
157
209
|
};
|
|
158
210
|
}
|
|
159
211
|
|
|
@@ -0,0 +1,444 @@
|
|
|
1
|
+
// Generated for you. Plain maths, edit or delete it freely: the sky the sun lights, in the sun's own units.
|
|
2
|
+
//
|
|
3
|
+
// Unreal's default level draws its sky from the Sky Atmosphere, lights the scene with a Sky Light
|
|
4
|
+
// that captures it, and tints the sun by the air the sun passes through. All three read ONE sun
|
|
5
|
+
// illuminance, so the sun-to-sky ratio is a consequence of the model and not a constant. This file
|
|
6
|
+
// ports that model: single scattering with Rayleigh and Mie phase functions, an ozone absorption
|
|
7
|
+
// layer, a ground bounce, and the isotropic multiple-scattering approximation (Hillaire, "A
|
|
8
|
+
// Scalable and Production Ready Sky and Atmosphere Rendering Technique", EGSR 2020, the paper the
|
|
9
|
+
// Unreal atmosphere implements). Coefficients are Unreal 5.8.3's defaults, read from
|
|
10
|
+
// Engine/Source/Runtime/Engine/Private/Components/SkyAtmosphereComponent.cpp:95-128 and checked
|
|
11
|
+
// against tools/unreal-reference/template-actors.json. The integration structure follows
|
|
12
|
+
// Engine/Shaders/Private/SkyAtmosphere.usf (IntegrateSingleScatteredLuminance and the multiple
|
|
13
|
+
// scattering pass) and the phase functions in ParticipatingMediaCommon.ush.
|
|
14
|
+
//
|
|
15
|
+
// Units: every radiance below is per unit sun illuminance (1.0 outside the atmosphere). Multiply
|
|
16
|
+
// by the sun's illuminance in the scene's light units (lighting.ts) to get scene radiance, so the
|
|
17
|
+
// sun and the sky can never disagree about exposure.
|
|
18
|
+
//
|
|
19
|
+
// Plain numbers and no `three` import: the same code runs under node for the unit check.
|
|
20
|
+
// ponytail: direct numerical integration at load (about a second at 256x128). A transmittance LUT,
|
|
21
|
+
// or core's `SkyCapture` once its sky-view LUT is physical, replaces the inner loops.
|
|
22
|
+
|
|
23
|
+
export type Rgb = readonly [number, number, number];
|
|
24
|
+
type Vec3 = readonly [number, number, number];
|
|
25
|
+
|
|
26
|
+
export const BOTTOM_KM = 6360;
|
|
27
|
+
export const TOP_KM = 6420;
|
|
28
|
+
export const RAYLEIGH: Rgb = [0.005802, 0.013558, 0.0331]; // per km at sea level
|
|
29
|
+
export const MIE_SCATTER = 0.003996;
|
|
30
|
+
export const MIE_ABSORB = 0.000444;
|
|
31
|
+
export const OZONE: Rgb = [0.00065, 0.001881, 0.000085];
|
|
32
|
+
export const MIE_G = 0.8;
|
|
33
|
+
export const GROUND_ALBEDO = 0.4; // 170/255 sRGB, linear
|
|
34
|
+
export const CAMERA_KM = 0.06; // the reference floor sits 60 m above the planet top
|
|
35
|
+
const FOUR_PI = 4 * Math.PI;
|
|
36
|
+
|
|
37
|
+
const rayleighPhase = (c: number): number => (3 / (16 * Math.PI)) * (1 + c * c);
|
|
38
|
+
const hgPhase = (c: number): number =>
|
|
39
|
+
(1 - MIE_G * MIE_G) / (FOUR_PI * (1 + MIE_G * MIE_G - 2 * MIE_G * c) ** 1.5);
|
|
40
|
+
|
|
41
|
+
const dot = (a: Vec3, b: Vec3): number => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
|
|
42
|
+
|
|
43
|
+
interface IMedium {
|
|
44
|
+
ray: Rgb;
|
|
45
|
+
mie: number;
|
|
46
|
+
ext: Rgb;
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
function medium(h: number): IMedium {
|
|
50
|
+
const ray = Math.exp(-h / 8);
|
|
51
|
+
const mie = Math.exp(-h / 1.2);
|
|
52
|
+
const ozone = Math.max(0, Math.min(1, h < 25 ? h / 15 - 2 / 3 : -h / 15 + 8 / 3));
|
|
53
|
+
const e = (i: 0 | 1 | 2): number =>
|
|
54
|
+
RAYLEIGH[i] * ray + (MIE_SCATTER + MIE_ABSORB) * mie + OZONE[i] * ozone;
|
|
55
|
+
return {
|
|
56
|
+
ray: [RAYLEIGH[0] * ray, RAYLEIGH[1] * ray, RAYLEIGH[2] * ray],
|
|
57
|
+
mie: MIE_SCATTER * mie,
|
|
58
|
+
ext: [e(0), e(1), e(2)],
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/** Distance from a point at radius `r`, heading with cosine `mu` to the local up, to a sphere. */
|
|
63
|
+
function hitSphere(r: number, mu: number, radius: number, far: boolean): number | undefined {
|
|
64
|
+
const b = r * mu;
|
|
65
|
+
const disc = b * b - (r * r - radius * radius);
|
|
66
|
+
if (disc < 0) return undefined;
|
|
67
|
+
const t = far ? -b + Math.sqrt(disc) : -b - Math.sqrt(disc);
|
|
68
|
+
return t >= 0 ? t : undefined;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/**
|
|
72
|
+
* Optical depth from a point to the top of the atmosphere; undefined when the planet blocks the way.
|
|
73
|
+
* Unreal stores this in its transmittance LUT, ten samples a ray (r.SkyAtmosphere.TransmittanceLUT.SampleCount).
|
|
74
|
+
*/
|
|
75
|
+
function opticalDepthToTop(r: number, mu: number): Rgb | undefined {
|
|
76
|
+
if (mu < 0 && hitSphere(r, mu, BOTTOM_KM, false) !== undefined) return undefined;
|
|
77
|
+
const length = hitSphere(r, mu, TOP_KM, true) ?? 0;
|
|
78
|
+
const sum: [number, number, number] = [0, 0, 0];
|
|
79
|
+
for (const { from, to, at } of linear(10)(length)) {
|
|
80
|
+
const m = medium(Math.max(0, Math.sqrt(r * r + 2 * r * mu * at + at * at) - BOTTOM_KM));
|
|
81
|
+
for (let c = 0; c < 3; c += 1) sum[c] = (sum[c] ?? 0) + m.ext[c as 0 | 1 | 2] * (to - from);
|
|
82
|
+
}
|
|
83
|
+
return sum;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/** Fraction of the sun's illuminance that reaches the ground, per channel. */
|
|
87
|
+
export function sunTransmittance(elevationRad: number): Rgb {
|
|
88
|
+
const depth = opticalDepthToTop(BOTTOM_KM + CAMERA_KM, Math.sin(elevationRad));
|
|
89
|
+
if (depth === undefined) return [0, 0, 0];
|
|
90
|
+
return [Math.exp(-depth[0]), Math.exp(-depth[1]), Math.exp(-depth[2])];
|
|
91
|
+
}
|
|
92
|
+
|
|
93
|
+
/**
|
|
94
|
+
* The colour Unreal gives the sun light itself (FAtmosphereSetup::GetTransmittanceAtGroundLevel,
|
|
95
|
+
* Engine/Source/Runtime/Engine/Private/Components/SkyAtmosphere*): a CPU estimate, not the exact
|
|
96
|
+
* integral. It starts 500 m above the planet, sums 15 equal segments by their start point (the
|
|
97
|
+
* rule over-counts the dense low air) and has no minimum elevation (TransmittanceMinLightElevationAngle
|
|
98
|
+
* is -90). The sky itself reads the transmittance LUT (`sunTransmittance`), so the two differ.
|
|
99
|
+
*/
|
|
100
|
+
export function sunLightTransmittance(elevationRad: number): Rgb {
|
|
101
|
+
const f = Math.fround;
|
|
102
|
+
const r0 = BOTTOM_KM + 0.5;
|
|
103
|
+
const mu = Math.sin(elevationRad);
|
|
104
|
+
const tMax = hitSphere(r0, mu, TOP_KM, true) ?? 0;
|
|
105
|
+
const depth: [number, number, number] = [0, 0, 0];
|
|
106
|
+
const step = f(1 / 15);
|
|
107
|
+
for (let t = 0; t < 1; t = f(t + step)) {
|
|
108
|
+
const along = tMax * t;
|
|
109
|
+
const h = Math.max(0, Math.sqrt(r0 * r0 + 2 * r0 * mu * along + along * along) - BOTTOM_KM);
|
|
110
|
+
const m = medium(h);
|
|
111
|
+
for (let c = 0; c < 3; c += 1) depth[c] = (depth[c] ?? 0) + m.ext[c as 0 | 1 | 2] * step * tMax;
|
|
112
|
+
}
|
|
113
|
+
return [Math.exp(-depth[0]), Math.exp(-depth[1]), Math.exp(-depth[2])];
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/** Fraction of the sun's illuminance that reaches radius `r` where the sun's cosine to local up is `mu`. */
|
|
117
|
+
export function transmittanceToTop(r: number, mu: number): Rgb {
|
|
118
|
+
const depth = opticalDepthToTop(r, mu);
|
|
119
|
+
if (depth === undefined) return [0, 0, 0];
|
|
120
|
+
return [Math.exp(-depth[0]), Math.exp(-depth[1]), Math.exp(-depth[2])];
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
type Multi = (heightKm: number, cosSun: number) => Rgb;
|
|
124
|
+
|
|
125
|
+
/** One ray segment: it spans [from, to] in kilometres and its medium is read at `at`. */
|
|
126
|
+
interface ISegment {
|
|
127
|
+
from: number;
|
|
128
|
+
to: number;
|
|
129
|
+
at: number;
|
|
130
|
+
}
|
|
131
|
+
type Sampling = (tMax: number) => ISegment[];
|
|
132
|
+
|
|
133
|
+
/** Unreal's fixed march (the transmittance, multiple-scattering and distant sky light passes): equal segments, read `offset` of the way in. */
|
|
134
|
+
const linear =
|
|
135
|
+
(steps: number, offset = 0.3): Sampling =>
|
|
136
|
+
(tMax) =>
|
|
137
|
+
Array.from({ length: steps }, (_, i) => ({
|
|
138
|
+
from: (tMax * i) / steps,
|
|
139
|
+
to: (tMax * (i + 1)) / steps,
|
|
140
|
+
at: (tMax * (i + offset)) / steps,
|
|
141
|
+
}));
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* Unreal's sky-view march (SamplingSetup.VariableSampleCount in SkyAtmosphere.usf): the count grows
|
|
145
|
+
* from `min` to `max` with the distance, the segments grow with the square of it, and the last one
|
|
146
|
+
* runs on to the end of the ray.
|
|
147
|
+
*/
|
|
148
|
+
const variable =
|
|
149
|
+
(min: number, max: number, distanceKm: number, offset = 0.3): Sampling =>
|
|
150
|
+
(tMax) => {
|
|
151
|
+
const count = min + (max - min) * Math.min(1, Math.max(0, tMax / distanceKm));
|
|
152
|
+
const whole = Math.floor(count);
|
|
153
|
+
const tMaxWhole = (tMax * whole) / count;
|
|
154
|
+
return Array.from({ length: Math.ceil(count) }, (_, i) => {
|
|
155
|
+
const [u0, u1] = [(i / whole) ** 2, ((i + 1) / whole) ** 2];
|
|
156
|
+
const from = tMaxWhole * u0;
|
|
157
|
+
const to = u1 > 1 ? tMax : tMaxWhole * u1;
|
|
158
|
+
return { from, to, at: from + (to - from) * offset };
|
|
159
|
+
});
|
|
160
|
+
};
|
|
161
|
+
|
|
162
|
+
interface IGather {
|
|
163
|
+
radiance: [number, number, number];
|
|
164
|
+
/** Integral of the scattering coefficient along the ray, attenuated: the transfer factor. */
|
|
165
|
+
transfer: [number, number, number];
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
/**
|
|
169
|
+
* One view ray from (0, r0, 0) along `dir`, the planet at the origin and `sun` a unit vector.
|
|
170
|
+
* `iso` swaps the phase functions for the isotropic one, as the multiple-scattering pass does.
|
|
171
|
+
* `multi` adds the multiple-scattering luminance at each sample.
|
|
172
|
+
*/
|
|
173
|
+
function march(
|
|
174
|
+
r0: number,
|
|
175
|
+
dir: Vec3,
|
|
176
|
+
sun: Vec3,
|
|
177
|
+
iso: boolean,
|
|
178
|
+
multi: Multi | undefined,
|
|
179
|
+
ground: boolean,
|
|
180
|
+
sampling: Sampling,
|
|
181
|
+
): IGather {
|
|
182
|
+
const out: IGather = { radiance: [0, 0, 0], transfer: [0, 0, 0] };
|
|
183
|
+
const mu0 = dir[1];
|
|
184
|
+
const groundT = mu0 < 0 ? hitSphere(r0, mu0, BOTTOM_KM, false) : undefined;
|
|
185
|
+
const tMax = groundT ?? hitSphere(r0, mu0, TOP_KM, true) ?? 0;
|
|
186
|
+
const cosView = dot(dir, sun);
|
|
187
|
+
const phaseRay = iso ? 1 / FOUR_PI : rayleighPhase(cosView);
|
|
188
|
+
const phaseMie = iso ? 1 / FOUR_PI : hgPhase(cosView);
|
|
189
|
+
const through: [number, number, number] = [1, 1, 1];
|
|
190
|
+
const at = (t: number): Vec3 => [dir[0] * t, r0 + dir[1] * t, dir[2] * t];
|
|
191
|
+
for (const { from, to, at: mid } of sampling(tMax)) {
|
|
192
|
+
const dt = to - from;
|
|
193
|
+
const p = at(mid);
|
|
194
|
+
const rr = Math.hypot(p[0], p[1], p[2]);
|
|
195
|
+
const cosSun = dot(p, sun) / rr;
|
|
196
|
+
const m = medium(Math.max(0, rr - BOTTOM_KM));
|
|
197
|
+
const depth = opticalDepthToTop(rr, cosSun);
|
|
198
|
+
const ms = multi?.(Math.max(0, rr - BOTTOM_KM), cosSun);
|
|
199
|
+
for (let c = 0; c < 3; c += 1) {
|
|
200
|
+
const k = c as 0 | 1 | 2;
|
|
201
|
+
const e = m.ext[k];
|
|
202
|
+
const scatter = m.ray[k] + m.mie;
|
|
203
|
+
const stepT = Math.exp(-e * dt);
|
|
204
|
+
let source = 0;
|
|
205
|
+
if (depth !== undefined)
|
|
206
|
+
source += Math.exp(-depth[k]) * (m.ray[k] * phaseRay + m.mie * phaseMie);
|
|
207
|
+
if (ms !== undefined) source += ms[k] * scatter;
|
|
208
|
+
const integral = e > 1e-12 ? (1 - stepT) / e : dt;
|
|
209
|
+
out.radiance[c] = (out.radiance[c] ?? 0) + (through[c] ?? 1) * source * integral;
|
|
210
|
+
out.transfer[c] = (out.transfer[c] ?? 0) + (through[c] ?? 1) * scatter * integral;
|
|
211
|
+
through[c] = (through[c] ?? 1) * stepT;
|
|
212
|
+
}
|
|
213
|
+
}
|
|
214
|
+
// The sky pass draws no ground luminance (Unreal's sky render passes Ground = false), so the nadir
|
|
215
|
+
// is only the in-scatter up to the planet, near black. The multiple-scattering pass does bounce
|
|
216
|
+
// light off the ground (Ground = true), so `iso` keeps it.
|
|
217
|
+
if (ground && groundT !== undefined) {
|
|
218
|
+
const p = at(groundT);
|
|
219
|
+
const rr = Math.hypot(p[0], p[1], p[2]);
|
|
220
|
+
const cosSun = dot(p, sun) / rr;
|
|
221
|
+
const depth = opticalDepthToTop(rr, cosSun);
|
|
222
|
+
if (depth !== undefined && cosSun > 0)
|
|
223
|
+
for (let c = 0; c < 3; c += 1)
|
|
224
|
+
out.radiance[c] =
|
|
225
|
+
(out.radiance[c] ?? 0) +
|
|
226
|
+
(through[c] ?? 1) * Math.exp(-depth[c as 0 | 1 | 2]) * cosSun * (GROUND_ALBEDO / Math.PI);
|
|
227
|
+
}
|
|
228
|
+
return out;
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
/**
|
|
232
|
+
* Multiple-scattering luminance per unit scattering coefficient, by altitude and the cosine
|
|
233
|
+
* between the local up and the sun: Psi = L2 / (1 - f), the isotropic infinite-bounce sum.
|
|
234
|
+
* Unreal gathers L2 and f from two rays only, straight up and straight down (the shipped "cheap"
|
|
235
|
+
* approximation in RenderMultiScatteredLuminanceLutCS); the full sphere gather overestimated the
|
|
236
|
+
* ground bounce against the Unreal frames by up to 1.6x, so this uses the same two rays.
|
|
237
|
+
*/
|
|
238
|
+
function multipleScatteringTable(): Multi {
|
|
239
|
+
const nh = 12;
|
|
240
|
+
const nc = 16;
|
|
241
|
+
const dirs: Vec3[] = [
|
|
242
|
+
[0, 1, 0],
|
|
243
|
+
[0, -1, 0],
|
|
244
|
+
];
|
|
245
|
+
const table: Rgb[] = [];
|
|
246
|
+
for (let ih = 0; ih < nh; ih += 1) {
|
|
247
|
+
const h = ((ih + 0.5) / nh) ** 2 * (TOP_KM - BOTTOM_KM);
|
|
248
|
+
for (let ic = 0; ic < nc; ic += 1) {
|
|
249
|
+
const cosSun = -1 + (2 * (ic + 0.5)) / nc;
|
|
250
|
+
const sun: Vec3 = [Math.sqrt(1 - cosSun * cosSun), cosSun, 0];
|
|
251
|
+
const sum = [0, 0, 0];
|
|
252
|
+
const transfer = [0, 0, 0];
|
|
253
|
+
for (const dir of dirs) {
|
|
254
|
+
const ray = march(BOTTOM_KM + h, dir, sun, true, undefined, true, linear(15));
|
|
255
|
+
for (let c = 0; c < 3; c += 1) {
|
|
256
|
+
sum[c] = (sum[c] ?? 0) + (ray.radiance[c] ?? 0);
|
|
257
|
+
transfer[c] = (transfer[c] ?? 0) + (ray.transfer[c] ?? 0);
|
|
258
|
+
}
|
|
259
|
+
}
|
|
260
|
+
table.push(
|
|
261
|
+
[0, 1, 2].map((c) => {
|
|
262
|
+
const l2 = (sum[c] ?? 0) / dirs.length;
|
|
263
|
+
const f = Math.min(0.99, (transfer[c] ?? 0) / dirs.length);
|
|
264
|
+
return l2 / (1 - f);
|
|
265
|
+
}) as unknown as Rgb,
|
|
266
|
+
);
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
return (h, cosSun) => {
|
|
270
|
+
const u = Math.min(
|
|
271
|
+
nh - 1,
|
|
272
|
+
Math.max(0, Math.sqrt(Math.max(0, h) / (TOP_KM - BOTTOM_KM)) * nh - 0.5),
|
|
273
|
+
);
|
|
274
|
+
const v = Math.min(nc - 1, Math.max(0, ((cosSun + 1) / 2) * nc - 0.5));
|
|
275
|
+
const [u0, v0] = [Math.floor(u), Math.floor(v)];
|
|
276
|
+
const [u1, v1] = [Math.min(nh - 1, u0 + 1), Math.min(nc - 1, v0 + 1)];
|
|
277
|
+
const [fu, fv] = [u - u0, v - v0];
|
|
278
|
+
const cell = (i: number, j: number): Rgb => table[i * nc + j] as Rgb;
|
|
279
|
+
return [0, 1, 2].map((c) => {
|
|
280
|
+
const k = c as 0 | 1 | 2;
|
|
281
|
+
const a = cell(u0, v0)[k] * (1 - fv) + cell(u0, v1)[k] * fv;
|
|
282
|
+
const b = cell(u1, v0)[k] * (1 - fv) + cell(u1, v1)[k] * fv;
|
|
283
|
+
return a * (1 - fu) + b * fu;
|
|
284
|
+
}) as unknown as Rgb;
|
|
285
|
+
};
|
|
286
|
+
}
|
|
287
|
+
|
|
288
|
+
/**
|
|
289
|
+
* Unreal's distant sky light: the mean radiance over the whole sphere seen from `altitudeKm`
|
|
290
|
+
* (r.SkyAtmosphere.DistantSkyLightLUT.Altitude, 6 km), isotropic phase, no ground bounce, the
|
|
291
|
+
* multiple-scattering term included (RenderDistantSkyLightLutCS in
|
|
292
|
+
* Engine/Shaders/Private/SkyAtmosphere.usf). Height fog and volumetric clouds both light with it
|
|
293
|
+
* (GetViewDistanceSkyLightColor). Per unit sun illuminance, like `bakeSkyRadiance`.
|
|
294
|
+
*/
|
|
295
|
+
const DISTANT_SKY_LIGHT_ALTITUDE_KM = 6;
|
|
296
|
+
/**
|
|
297
|
+
* Unreal's distant sky light shader: one 8 x 8 group, one stratified direction a thread, ten linear
|
|
298
|
+
* samples a ray (RenderDistantSkyLightLutCS). The directions come from a seeded linear congruential
|
|
299
|
+
* stream (0xDE4DC0DE, GUniformSphereSamplesBuffer in SkyAtmosphereRendering.cpp), so the coarse
|
|
300
|
+
* result is one fixed draw, not a mean; the same draw is reproduced here.
|
|
301
|
+
*/
|
|
302
|
+
const DISTANT_GROUP = 8;
|
|
303
|
+
function distantDirections(): Vec3[] {
|
|
304
|
+
let seed = 0xde4dc0de;
|
|
305
|
+
const fraction = (): number => {
|
|
306
|
+
seed = (Math.imul(seed, 196314165) + 907633515) >>> 0;
|
|
307
|
+
return (seed >>> 9) / 8388608;
|
|
308
|
+
};
|
|
309
|
+
const dirs: Vec3[] = new Array(DISTANT_GROUP * DISTANT_GROUP);
|
|
310
|
+
for (let i = 0; i < DISTANT_GROUP; i += 1) {
|
|
311
|
+
for (let j = 0; j < DISTANT_GROUP; j += 1) {
|
|
312
|
+
const up = 1 - (2 * (i + fraction())) / DISTANT_GROUP;
|
|
313
|
+
const phi = (2 * Math.PI * (j + fraction())) / DISTANT_GROUP;
|
|
314
|
+
const ring = Math.sqrt(1 - up * up);
|
|
315
|
+
dirs[j * DISTANT_GROUP + i] = [ring * Math.cos(phi), up, ring * Math.sin(phi)];
|
|
316
|
+
}
|
|
317
|
+
}
|
|
318
|
+
return dirs;
|
|
319
|
+
}
|
|
320
|
+
function distantSkyLight(toSun: { x: number; y: number; z: number }): Rgb {
|
|
321
|
+
const sun: Vec3 = [toSun.x, toSun.y, toSun.z];
|
|
322
|
+
const multi = multipleScatteringTable();
|
|
323
|
+
const dirs = distantDirections();
|
|
324
|
+
const sum: [number, number, number] = [0, 0, 0];
|
|
325
|
+
for (const dir of dirs) {
|
|
326
|
+
const ray = march(
|
|
327
|
+
BOTTOM_KM + DISTANT_SKY_LIGHT_ALTITUDE_KM,
|
|
328
|
+
dir,
|
|
329
|
+
sun,
|
|
330
|
+
true,
|
|
331
|
+
multi,
|
|
332
|
+
false,
|
|
333
|
+
linear(10),
|
|
334
|
+
);
|
|
335
|
+
for (let c = 0; c < 3; c += 1) sum[c] = (sum[c] ?? 0) + (ray.radiance[c] ?? 0) / dirs.length;
|
|
336
|
+
}
|
|
337
|
+
return sum;
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
/**
|
|
341
|
+
* The light height fog and clouds take from the sky, per unit sun illuminance: Unreal's distant sky
|
|
342
|
+
* light (GetViewDistanceSkyLightColor). It needs no fit. The 0.76 / 0.871 / 0.941 factors that stood
|
|
343
|
+
* here made up for a finer march than Unreal's own, ten samples a ray from one fixed 8 x 8 draw of
|
|
344
|
+
* directions (`distantSkyLight`); the same march agrees with the Unreal L3 void within 2.4 percent in
|
|
345
|
+
* green and blue at 15 and 60 degrees, and within 0.6 percent in red at 15 degrees. Red stays 10 percent
|
|
346
|
+
* high at 60 degrees, the same excess the clear sky shows at a high sun (open, PRD-633).
|
|
347
|
+
*/
|
|
348
|
+
export function viewDistanceSkyLight(toSun: { x: number; y: number; z: number }): Rgb {
|
|
349
|
+
return distantSkyLight(toSun);
|
|
350
|
+
}
|
|
351
|
+
|
|
352
|
+
/**
|
|
353
|
+
* Sky radiance per unit sun illuminance on an equirectangular grid in three's layout: row 0 is the
|
|
354
|
+
* zenith, the middle row the horizon, the last row the nadir, and u = atan2(z, x) / 2pi + 0.5. `sun`
|
|
355
|
+
* is the unit direction toward the sun, y up.
|
|
356
|
+
*
|
|
357
|
+
* Below the horizon it draws the atmosphere's sunlit ground (albedo `GROUND_ALBEDO`, the term
|
|
358
|
+
* Unreal's multiple-scattering pass uses), where Unreal's own sky capture is near black. Unreal's
|
|
359
|
+
* default level fills that half with Lumen: the floor bounces sun into shadow sides and a mirror
|
|
360
|
+
* reflects it. This environment is the only indirect light the templates have, so the ground stands
|
|
361
|
+
* in for that bounce; without it shadow sides read navy and a chrome ball's lower half black (judge,
|
|
362
|
+
* PRD-633). `ground` false draws Unreal's dark nadir, for a game with its own global illumination.
|
|
363
|
+
*/
|
|
364
|
+
export function bakeSkyRadiance(
|
|
365
|
+
toSun: { x: number; y: number; z: number },
|
|
366
|
+
width: number,
|
|
367
|
+
height: number,
|
|
368
|
+
ground: boolean,
|
|
369
|
+
): Float32Array {
|
|
370
|
+
const sun: Vec3 = [toSun.x, toSun.y, toSun.z];
|
|
371
|
+
const multi = multipleScatteringTable();
|
|
372
|
+
const data = new Float32Array(width * height * 3);
|
|
373
|
+
const r0 = BOTTOM_KM + CAMERA_KM;
|
|
374
|
+
for (let y = 0; y < height; y += 1) {
|
|
375
|
+
const elevation = Math.PI / 2 - ((y + 0.5) / height) * Math.PI;
|
|
376
|
+
for (let x = 0; x < width; x += 1) {
|
|
377
|
+
// three's equirectangular lookup: u = atan2(z, x) / 2pi + 0.5.
|
|
378
|
+
const azimuth = ((x + 0.5) / width - 0.5) * 2 * Math.PI;
|
|
379
|
+
const dir: Vec3 = [
|
|
380
|
+
Math.cos(azimuth) * Math.cos(elevation),
|
|
381
|
+
Math.sin(elevation),
|
|
382
|
+
Math.sin(azimuth) * Math.cos(elevation),
|
|
383
|
+
];
|
|
384
|
+
const ray = march(r0, dir, sun, false, multi, ground, variable(4, 32, 150));
|
|
385
|
+
const o = (y * width + x) * 3;
|
|
386
|
+
data[o] = ray.radiance[0];
|
|
387
|
+
data[o + 1] = ray.radiance[1];
|
|
388
|
+
data[o + 2] = ray.radiance[2];
|
|
389
|
+
}
|
|
390
|
+
}
|
|
391
|
+
return data;
|
|
392
|
+
}
|
|
393
|
+
|
|
394
|
+
/** The default level's sun: 6 lux, 6500 K (tools/unreal-reference/template-actors.json, every sun). */
|
|
395
|
+
const SUN_LUX = 6;
|
|
396
|
+
export const SUN_KELVIN = 6500;
|
|
397
|
+
|
|
398
|
+
/**
|
|
399
|
+
* The sun in three's light units. Unreal renders a lit diffuse surface as albedo x lux x cos(theta);
|
|
400
|
+
* three's Lambert BRDF carries a 1/pi, so the same lux is pi times as large here. Measured on the
|
|
401
|
+
* Unreal L1 cells (no atmosphere, scene-linear EXR): a 0.18 floor under the 60 degree sun reads
|
|
402
|
+
* 0.874 luminance, within 7% of 0.18 x 6 x sin(60 deg) = 0.935 (the residual is checked on the
|
|
403
|
+
* engine's own L1 capture).
|
|
404
|
+
*/
|
|
405
|
+
export const SUN_ILLUMINANCE = SUN_LUX * Math.PI;
|
|
406
|
+
|
|
407
|
+
/**
|
|
408
|
+
* Sky radiance relative to the sun, as Unreal renders it. TEMPORARY, measured and not derived: with
|
|
409
|
+
* the sun at 6 lux the model above is 1.3x too bright against the Unreal L2 frames, flat across
|
|
410
|
+
* channels and across the 15 and 4 degree suns (1.30 / 1.30 / 1.35 at 19 degrees elevation), so
|
|
411
|
+
* the sky is scaled by 1/1.3. The lens attenuation constant 0.78 (PostProcessEyeAdaptation.cpp,
|
|
412
|
+
* r.EyeAdaptation.LensAttenuation) has the right size but the path that would apply it to the
|
|
413
|
+
* atmosphere and not to the sun is not found in the source yet.
|
|
414
|
+
*/
|
|
415
|
+
export const SKY_TO_SUN = 0.78;
|
|
416
|
+
|
|
417
|
+
/**
|
|
418
|
+
* Colour of a black-body-like light at `kelvin` as linear sRGB with unit luminance: the Planckian
|
|
419
|
+
* locus fit in the CIE 1960 UCS plane (Krystek 1985) that Unreal uses for a light's temperature
|
|
420
|
+
* (Engine/Source/Runtime/Core/Private/Math/Color.cpp, MakeFromColorTemperature), then XYZ to BT.709.
|
|
421
|
+
*/
|
|
422
|
+
export function temperatureColour(kelvin: number): Rgb {
|
|
423
|
+
const t = Math.min(15000, Math.max(1000, kelvin));
|
|
424
|
+
const u =
|
|
425
|
+
(0.860117757 + 1.54118254e-4 * t + 1.28641212e-7 * t * t) /
|
|
426
|
+
(1 + 8.42420235e-4 * t + 7.08145163e-7 * t * t);
|
|
427
|
+
const v =
|
|
428
|
+
(0.317398726 + 4.22806245e-5 * t + 4.20481691e-8 * t * t) /
|
|
429
|
+
(1 - 2.89741816e-5 * t + 1.61456053e-7 * t * t);
|
|
430
|
+
const d = 2 * u - 8 * v + 4;
|
|
431
|
+
const x = (3 * u) / d;
|
|
432
|
+
const y = (2 * v) / d;
|
|
433
|
+
const [bx, bz] = [x / y, (1 - x - y) / y];
|
|
434
|
+
return [
|
|
435
|
+
Math.max(0, 3.2404542 * bx - 1.5371385 - 0.4985314 * bz),
|
|
436
|
+
Math.max(0, -0.969266 * bx + 1.8760108 + 0.041556 * bz),
|
|
437
|
+
Math.max(0, 0.0556434 * bx - 0.2040259 + 1.0572252 * bz),
|
|
438
|
+
];
|
|
439
|
+
}
|
|
440
|
+
|
|
441
|
+
/** The scene's sun light, registered by `setupLighting` so `setupSky` can tint it by the air. */
|
|
442
|
+
export const sunLight: {
|
|
443
|
+
current?: { color: { setRGB(r: number, g: number, b: number): unknown } };
|
|
444
|
+
} = {};
|