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,271 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
//
|
|
3
|
+
// A procedural misty sky and the forest's mist. The sky is a vertical gradient for the background,
|
|
4
|
+
// and a half-float copy of the same gradient, lifted into light units, for the environment every
|
|
5
|
+
// surface is filled and reflects by. No image file. The mist is height fog on `scene.fogNode`: a
|
|
6
|
+
// distance term (the live `FogExp2`) times a height term that thickens toward the ground, plus a
|
|
7
|
+
// warm glow toward the sun, so the path ahead fades into bright haze while the near ferns stay
|
|
8
|
+
// dark. The engine meters the frame (auto exposure) and maps it through the filmic curve, so these
|
|
9
|
+
// numbers say how the sky and mist relate to the sun, not how bright the screen is.
|
|
10
|
+
import {
|
|
11
|
+
AdditiveBlending,
|
|
12
|
+
Color,
|
|
13
|
+
CylinderGeometry,
|
|
14
|
+
DataTexture,
|
|
15
|
+
DataUtils,
|
|
16
|
+
EquirectangularReflectionMapping,
|
|
17
|
+
FogExp2,
|
|
18
|
+
HalfFloatType,
|
|
19
|
+
InstancedMesh,
|
|
20
|
+
LinearFilter,
|
|
21
|
+
LinearSRGBColorSpace,
|
|
22
|
+
Object3D,
|
|
23
|
+
RGBAFormat,
|
|
24
|
+
type Scene,
|
|
25
|
+
Vector3,
|
|
26
|
+
} from "three";
|
|
27
|
+
import {
|
|
28
|
+
cameraPosition,
|
|
29
|
+
densityFogFactor,
|
|
30
|
+
dot,
|
|
31
|
+
exp2,
|
|
32
|
+
float,
|
|
33
|
+
fog,
|
|
34
|
+
hash,
|
|
35
|
+
instanceIndex,
|
|
36
|
+
max,
|
|
37
|
+
mix,
|
|
38
|
+
normalView,
|
|
39
|
+
positionViewDirection,
|
|
40
|
+
positionWorld,
|
|
41
|
+
pow,
|
|
42
|
+
saturate,
|
|
43
|
+
select,
|
|
44
|
+
sin,
|
|
45
|
+
smoothstep,
|
|
46
|
+
uniform,
|
|
47
|
+
uv,
|
|
48
|
+
vec3,
|
|
49
|
+
} from "three/tsl";
|
|
50
|
+
import { MeshBasicNodeMaterial } from "three/webgpu";
|
|
51
|
+
import { palette } from "./palette.js";
|
|
52
|
+
|
|
53
|
+
/**
|
|
54
|
+
* Unit vector toward the sun: high in the north-west, ahead of a camera that looks down the path,
|
|
55
|
+
* so its shafts slant through the canopy toward the lens and the mist glows on that side.
|
|
56
|
+
*/
|
|
57
|
+
export const SUN_DIRECTION = new Vector3(-0.5, 0.72, -0.48).normalize();
|
|
58
|
+
|
|
59
|
+
/** The sky above the canopy, brighter than the mist under it: the forest stands against the light. */
|
|
60
|
+
const SKY_GLOW = 1.5;
|
|
61
|
+
/** How much brighter the sky's light is than its picture. The canopy keeps most of it off the floor. */
|
|
62
|
+
const SKY_RADIANCE = 0.45;
|
|
63
|
+
/** The ground half of the environment: dim green bounce off the moss. */
|
|
64
|
+
const GROUND_FILL = new Color(0.1, 0.13, 0.07);
|
|
65
|
+
|
|
66
|
+
/**
|
|
67
|
+
* The mist, outdoors and under the Hollow's roof. `distance` is the `FogExp2` density; the height
|
|
68
|
+
* term is base-2 optical depth per metre at the ground (`density`), thinning by `heightFalloff` per
|
|
69
|
+
* metre up. `glow` scales the fog colour to the light under the canopy: a mist brighter than the shade
|
|
70
|
+
* it hangs in washes the midground out.
|
|
71
|
+
*/
|
|
72
|
+
const MIST = {
|
|
73
|
+
vale: { distance: 0.016, density: 0.005, glow: 0.8 },
|
|
74
|
+
hollow: { distance: 0.004, density: 0.002, glow: 0.5 },
|
|
75
|
+
heightFalloff: 0.3,
|
|
76
|
+
/** Metres of clear air before the mist starts, so the ground at Wren's feet stays crisp. */
|
|
77
|
+
startDistance: 10,
|
|
78
|
+
/** Sun lobe sharpness: up for a tighter glow round the sun. */
|
|
79
|
+
sunExponent: 5,
|
|
80
|
+
/** Metres before the sun glow starts, so the near path is not tinted. */
|
|
81
|
+
sunStartDistance: 6,
|
|
82
|
+
};
|
|
83
|
+
const SUN_COLOUR = new Color(0xffe2b0);
|
|
84
|
+
/** A shaft's added light at its brightest, in the sun's colour; the meter keeps it relative. */
|
|
85
|
+
const SHAFT_BRIGHTNESS = 0.3;
|
|
86
|
+
|
|
87
|
+
function gradient(elevation: number): Color {
|
|
88
|
+
const high = new Color(palette.skyHigh);
|
|
89
|
+
const low = new Color(palette.skyLow);
|
|
90
|
+
const horizon = new Color(palette.horizon);
|
|
91
|
+
if (elevation <= 0) return horizon;
|
|
92
|
+
return elevation < 0.25
|
|
93
|
+
? horizon.lerp(low, elevation / 0.25)
|
|
94
|
+
: low.lerp(high, Math.min(1, (elevation - 0.25) / 0.75));
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
function equirect(rgba: (elevation: number) => readonly number[]): DataTexture {
|
|
98
|
+
// three's PMREM sizes its cube from width / 4 and needs at least 16: keep width >= 64.
|
|
99
|
+
const width = 128;
|
|
100
|
+
const height = 64;
|
|
101
|
+
const data = new Uint16Array(width * height * 4);
|
|
102
|
+
for (let row = 0; row < height; row += 1) {
|
|
103
|
+
// DataTexture rows start at v=0 (nadir); v=0.5 is the horizon.
|
|
104
|
+
const elevation = Math.sin((row / (height - 1) - 0.5) * Math.PI);
|
|
105
|
+
const texel = rgba(elevation).map(DataUtils.toHalfFloat);
|
|
106
|
+
for (let column = 0; column < width; column += 1) data.set(texel, (row * width + column) * 4);
|
|
107
|
+
}
|
|
108
|
+
const texture = new DataTexture(data, width, height, RGBAFormat, HalfFloatType);
|
|
109
|
+
texture.colorSpace = LinearSRGBColorSpace;
|
|
110
|
+
texture.mapping = EquirectangularReflectionMapping;
|
|
111
|
+
texture.minFilter = LinearFilter;
|
|
112
|
+
texture.magFilter = LinearFilter;
|
|
113
|
+
texture.needsUpdate = true;
|
|
114
|
+
return texture;
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
export interface ISky {
|
|
118
|
+
readonly background: DataTexture;
|
|
119
|
+
readonly environment: DataTexture;
|
|
120
|
+
/** Under the Hollow's roof: a cool stone-grey fill, so the warm torches read against it. */
|
|
121
|
+
readonly hollow: DataTexture;
|
|
122
|
+
}
|
|
123
|
+
|
|
124
|
+
export function createSky(): ISky {
|
|
125
|
+
return {
|
|
126
|
+
background: equirect((e) => [...gradient(e).multiplyScalar(SKY_GLOW).toArray(), 1]),
|
|
127
|
+
environment: equirect((e) => {
|
|
128
|
+
const c = e < 0 ? GROUND_FILL : gradient(e).multiplyScalar(SKY_RADIANCE);
|
|
129
|
+
return [c.r, c.g, c.b, 1];
|
|
130
|
+
}),
|
|
131
|
+
hollow: equirect((e) => [
|
|
132
|
+
...HOLLOW_FILL.clone()
|
|
133
|
+
.multiplyScalar(e < 0 ? 0.6 : 1)
|
|
134
|
+
.toArray(),
|
|
135
|
+
1,
|
|
136
|
+
]),
|
|
137
|
+
};
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
/** The Hollow's sky light: cool blue-grey, the colour of daylight leaking down a stone shaft. */
|
|
141
|
+
const HOLLOW_FILL = new Color(0.42, 0.5, 0.66);
|
|
142
|
+
/** The forest's and the Hollow's light, swapped by `setMist`. */
|
|
143
|
+
let fills: { readonly vale: DataTexture; readonly hollow: DataTexture } | undefined;
|
|
144
|
+
|
|
145
|
+
/** The height term's density at the ground; the fog node reads it every frame. */
|
|
146
|
+
const ground = { density: MIST.vale.density };
|
|
147
|
+
|
|
148
|
+
/**
|
|
149
|
+
* `T_distance x T_height` on `scene.fogNode`: three applies it wherever `scene.fog` would apply.
|
|
150
|
+
* The ray from the camera to a fragment integrates a density that halves every
|
|
151
|
+
* `1 / heightFalloff` metres up, in closed form, so the low path reads hazier than the canopy at the
|
|
152
|
+
* same distance. Toward the sun the mist takes the sun's colour.
|
|
153
|
+
*/
|
|
154
|
+
function mistNode(distanceFog: FogExp2) {
|
|
155
|
+
const LN2 = Math.LN2;
|
|
156
|
+
const color = uniform(new Color());
|
|
157
|
+
color.onRenderUpdate(() => color.value.copy(distanceFog.color));
|
|
158
|
+
const density = uniform(0);
|
|
159
|
+
density.onRenderUpdate(() => {
|
|
160
|
+
density.value = distanceFog.density;
|
|
161
|
+
});
|
|
162
|
+
// Density at the camera, once per frame instead of once per fragment.
|
|
163
|
+
const cameraDensity = uniform(0);
|
|
164
|
+
cameraDensity.onRenderUpdate(({ camera }) => {
|
|
165
|
+
const y = camera?.matrixWorld.elements[13] ?? 0;
|
|
166
|
+
cameraDensity.value =
|
|
167
|
+
ground.density * 2 ** Math.max(-127, Math.min(127, -MIST.heightFalloff * y));
|
|
168
|
+
});
|
|
169
|
+
const ray = positionWorld.sub(cameraPosition);
|
|
170
|
+
const length = ray.length().max(1e-4);
|
|
171
|
+
const k = float(MIST.heightFalloff).mul(positionWorld.y.sub(cameraPosition.y)).div(length);
|
|
172
|
+
const integral = (a: number) => {
|
|
173
|
+
const b = max(length, a);
|
|
174
|
+
const curved = cameraDensity
|
|
175
|
+
.mul(exp2(k.mul(a).negate()).sub(exp2(k.mul(b).negate())))
|
|
176
|
+
.div(k.mul(LN2));
|
|
177
|
+
return select(k.mul(b).abs().lessThan(0.01), cameraDensity.mul(b.sub(a)), curved);
|
|
178
|
+
};
|
|
179
|
+
const heightT = exp2(integral(MIST.startDistance).negate());
|
|
180
|
+
const opacity = densityFogFactor(density).oneMinus().mul(heightT).oneMinus();
|
|
181
|
+
const lobe = pow(
|
|
182
|
+
saturate(dot(ray.div(length), vec3(SUN_DIRECTION.x, SUN_DIRECTION.y, SUN_DIRECTION.z))),
|
|
183
|
+
MIST.sunExponent,
|
|
184
|
+
);
|
|
185
|
+
const glow = float(1)
|
|
186
|
+
.sub(exp2(integral(MIST.sunStartDistance).negate()))
|
|
187
|
+
.mul(lobe);
|
|
188
|
+
const sun = new Color(SUN_COLOUR).multiplyScalar(1.4);
|
|
189
|
+
return fog(mix(color, vec3(sun.r, sun.g, sun.b), glow), opacity);
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
export function setupSky(scene: Scene, sky: ISky): void {
|
|
193
|
+
scene.background = sky.background;
|
|
194
|
+
scene.backgroundIntensity = 1;
|
|
195
|
+
// three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
|
|
196
|
+
scene.environment = sky.environment;
|
|
197
|
+
scene.environmentIntensity = 1;
|
|
198
|
+
fills = { hollow: sky.hollow, vale: sky.environment };
|
|
199
|
+
if (scene.fog instanceof FogExp2) return;
|
|
200
|
+
const distanceFog = new FogExp2(palette.horizon, MIST.vale.distance);
|
|
201
|
+
distanceFog.color.multiplyScalar(MIST.vale.glow);
|
|
202
|
+
scene.fog = distanceFog;
|
|
203
|
+
scene.fogNode = mistNode(distanceFog);
|
|
204
|
+
}
|
|
205
|
+
|
|
206
|
+
/**
|
|
207
|
+
* Thins the mist under the Hollow's roof, so a room's far wall and the Warden stay clear, and swaps
|
|
208
|
+
* the forest's green sky light for the Hollow's cool stone fill.
|
|
209
|
+
*/
|
|
210
|
+
export function setMist(scene: Scene, indoors: boolean): void {
|
|
211
|
+
const mist = indoors ? MIST.hollow : MIST.vale;
|
|
212
|
+
ground.density = mist.density;
|
|
213
|
+
if (fills !== undefined) scene.environment = indoors ? fills.hollow : fills.vale;
|
|
214
|
+
if (!(scene.fog instanceof FogExp2)) return;
|
|
215
|
+
scene.fog.density = mist.distance;
|
|
216
|
+
scene.fog.color.set(indoors ? HOLLOW_MIST : palette.horizon).multiplyScalar(mist.glow);
|
|
217
|
+
}
|
|
218
|
+
/** The Hollow's thin haze: cool grey, never the forest's green. */
|
|
219
|
+
const HOLLOW_MIST = 0x8a96a4;
|
|
220
|
+
|
|
221
|
+
/**
|
|
222
|
+
* Sun shafts through the canopy: soft open tubes along the sun's direction, added on top of the
|
|
223
|
+
* frame. A tube fades to nothing where its side turns away from the eye, at both ends and close to
|
|
224
|
+
* the lens, and streaks along its length, so it reads as lit mist rather than a solid; it casts and
|
|
225
|
+
* takes no light. Each entry is the x, z where a shaft meets the ground and its radius in metres.
|
|
226
|
+
* Cost: one draw, a few hundred triangles, additive overdraw only where a shaft is on screen.
|
|
227
|
+
*/
|
|
228
|
+
export function sunShafts(
|
|
229
|
+
feet: readonly (readonly [number, number, number])[],
|
|
230
|
+
height: (x: number, z: number) => number,
|
|
231
|
+
): InstancedMesh {
|
|
232
|
+
const length = 18;
|
|
233
|
+
const material = new MeshBasicNodeMaterial({
|
|
234
|
+
blending: AdditiveBlending,
|
|
235
|
+
depthWrite: false,
|
|
236
|
+
fog: false,
|
|
237
|
+
transparent: true,
|
|
238
|
+
});
|
|
239
|
+
const facing = normalView.dot(positionViewDirection).abs();
|
|
240
|
+
const along = uv().y;
|
|
241
|
+
const strength = hash(instanceIndex).mul(hash(instanceIndex)).mul(0.8).add(0.2);
|
|
242
|
+
const streaks = sin(
|
|
243
|
+
uv()
|
|
244
|
+
.x.mul(Math.PI * 14)
|
|
245
|
+
.add(hash(instanceIndex.add(7)).mul(40)),
|
|
246
|
+
)
|
|
247
|
+
.mul(0.3)
|
|
248
|
+
.add(0.7);
|
|
249
|
+
material.colorNode = vec3(SUN_COLOUR.r, SUN_COLOUR.g, SUN_COLOUR.b).mul(SHAFT_BRIGHTNESS);
|
|
250
|
+
material.opacityNode = pow(facing, 2.5)
|
|
251
|
+
.mul(smoothstep(0, 0.12, along))
|
|
252
|
+
.mul(smoothstep(1, 0.45, along))
|
|
253
|
+
.mul(smoothstep(2, 7, positionWorld.distance(cameraPosition)))
|
|
254
|
+
.mul(streaks)
|
|
255
|
+
.mul(strength);
|
|
256
|
+
const geometry = new CylinderGeometry(1, 1, 1, 14, 1, true).translate(0, 0.5, 0);
|
|
257
|
+
const mesh = new InstancedMesh(geometry, material, feet.length);
|
|
258
|
+
mesh.name = "sun-shafts";
|
|
259
|
+
mesh.castShadow = false;
|
|
260
|
+
mesh.receiveShadow = false;
|
|
261
|
+
mesh.frustumCulled = false;
|
|
262
|
+
const place = new Object3D();
|
|
263
|
+
place.quaternion.setFromUnitVectors(new Vector3(0, 1, 0), SUN_DIRECTION);
|
|
264
|
+
feet.forEach(([x, z, radius], i) => {
|
|
265
|
+
place.position.set(x, height(x, z) - 0.5, z);
|
|
266
|
+
place.scale.set(radius, length, radius);
|
|
267
|
+
place.updateMatrix();
|
|
268
|
+
mesh.setMatrixAt(i, place.matrix);
|
|
269
|
+
});
|
|
270
|
+
return mesh;
|
|
271
|
+
}
|
|
@@ -0,0 +1,259 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
//
|
|
3
|
+
// The vale's and the Hollow's surfaces: five tiling photo textures shared with the other kits (see
|
|
4
|
+
// `assets/tex-PROVENANCE.md`), loaded once in `Play.load()`. A surface keeps the colour and the
|
|
5
|
+
// vertex shading the scene paints and takes only the photo's structure: each sample is divided by
|
|
6
|
+
// the photo's own average (its last mip level), so grass blades, rock cracks, bark grooves and
|
|
7
|
+
// coursed stone show in the vale's palette. No surface samples a tile plainly:
|
|
8
|
+
// - `stochastic` (Inigo Quilez's "texture repetition" technique) shifts the floor's grass by a
|
|
9
|
+
// random offset per noise patch and cross-fades two neighbouring offsets, so no two patches line
|
|
10
|
+
// up. The mip level comes from the base UV's own derivatives, so the seams never pick a blurred mip.
|
|
11
|
+
// - `triplanar` maps from the three world axes, so stones, trunks and walls need no UVs and a tile
|
|
12
|
+
// never stretches over a long face.
|
|
13
|
+
import {
|
|
14
|
+
Color,
|
|
15
|
+
type ColorRepresentation,
|
|
16
|
+
DoubleSide,
|
|
17
|
+
FrontSide,
|
|
18
|
+
type Material,
|
|
19
|
+
type Mesh,
|
|
20
|
+
type MeshStandardMaterial,
|
|
21
|
+
type Object3D,
|
|
22
|
+
RepeatWrapping,
|
|
23
|
+
type Texture,
|
|
24
|
+
} from "three";
|
|
25
|
+
import {
|
|
26
|
+
abs,
|
|
27
|
+
attribute,
|
|
28
|
+
color as colorNode,
|
|
29
|
+
cross,
|
|
30
|
+
dFdx,
|
|
31
|
+
dFdy,
|
|
32
|
+
dot,
|
|
33
|
+
float,
|
|
34
|
+
floor,
|
|
35
|
+
fract,
|
|
36
|
+
log2,
|
|
37
|
+
max,
|
|
38
|
+
min,
|
|
39
|
+
mix,
|
|
40
|
+
normalLocal,
|
|
41
|
+
normalWorldGeometry,
|
|
42
|
+
positionLocal,
|
|
43
|
+
positionWorld,
|
|
44
|
+
sin,
|
|
45
|
+
smoothstep,
|
|
46
|
+
texture,
|
|
47
|
+
uniform,
|
|
48
|
+
vec2,
|
|
49
|
+
vec3,
|
|
50
|
+
vec4,
|
|
51
|
+
} from "three/tsl";
|
|
52
|
+
import { MeshStandardNodeMaterial, type Node } from "three/webgpu";
|
|
53
|
+
import { detailTexture, lit } from "./materials.js";
|
|
54
|
+
|
|
55
|
+
/** Game-owned texture detail: an explicit mipBias overrides the temporal sampling convention. */
|
|
56
|
+
export const surfaceSampling: { mipBias: "auto" | number } = { mipBias: "auto" };
|
|
57
|
+
const surfaceMipBias = uniform(0);
|
|
58
|
+
const reportedMipBias = new Set<number>();
|
|
59
|
+
|
|
60
|
+
export function updateSurfaceSampling(scale: number): number {
|
|
61
|
+
if (!Number.isFinite(scale) || scale <= 0 || scale > 1)
|
|
62
|
+
throw new Error("Surface sampling scale must be finite and in (0, 1].");
|
|
63
|
+
const requested = surfaceSampling.mipBias;
|
|
64
|
+
if (requested !== "auto" && !Number.isFinite(requested))
|
|
65
|
+
throw new Error("Surface sampling mipBias must be auto or a finite number.");
|
|
66
|
+
// UE 5.8.3: SceneVisibility.cpp:5338–5352, defaults :180–193; preserve full-resolution sampling.
|
|
67
|
+
const bias = Math.max(
|
|
68
|
+
-4,
|
|
69
|
+
Math.min(
|
|
70
|
+
4,
|
|
71
|
+
requested === "auto" ? (scale === 1 ? 0 : Math.max(-2, Math.log2(scale) - 0.3)) : requested,
|
|
72
|
+
),
|
|
73
|
+
);
|
|
74
|
+
surfaceMipBias.value = bias;
|
|
75
|
+
if (requested !== "auto" && !reportedMipBias.has(requested)) {
|
|
76
|
+
console.info(
|
|
77
|
+
`TN_SURFACE_SAMPLING:${JSON.stringify({ mipBias: requested, appliedMipBias: bias })}`,
|
|
78
|
+
);
|
|
79
|
+
reportedMipBias.add(requested);
|
|
80
|
+
}
|
|
81
|
+
return bias;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
type TextureLoader = {
|
|
85
|
+
texture(path: string, options?: { wrap?: number; anisotropy?: number }): Promise<Texture>;
|
|
86
|
+
};
|
|
87
|
+
|
|
88
|
+
// The files live once in the package's `template-assets/assets/`; the scaffolder copies each one
|
|
89
|
+
// named here, with `tex-PROVENANCE.md` (its licence record).
|
|
90
|
+
const FILES = {
|
|
91
|
+
bark: "tex-bark.webp",
|
|
92
|
+
grass: "tex-grass.webp",
|
|
93
|
+
planks: "tex-planks.webp",
|
|
94
|
+
rock: "tex-rock.webp",
|
|
95
|
+
"stone-wall": "tex-stone-wall.webp",
|
|
96
|
+
} as const;
|
|
97
|
+
export type Surface = keyof typeof FILES;
|
|
98
|
+
/** Metres per repeat of each tile. */
|
|
99
|
+
const TILE: Record<Surface, number> = {
|
|
100
|
+
bark: 1.2,
|
|
101
|
+
grass: 4,
|
|
102
|
+
planks: 1,
|
|
103
|
+
rock: 2.5,
|
|
104
|
+
"stone-wall": 3,
|
|
105
|
+
};
|
|
106
|
+
|
|
107
|
+
let maps: Record<Surface, Texture> | undefined;
|
|
108
|
+
const cache = new Map<string, Material>();
|
|
109
|
+
/** Every colour a surface was asked for: wood, stone and bark tones. */
|
|
110
|
+
const surfaceColors = new Set<number>();
|
|
111
|
+
|
|
112
|
+
/** Loads the five textures once, in sRGB, repeating and anisotropic. */
|
|
113
|
+
export async function loadSurfaces(assets: TextureLoader): Promise<void> {
|
|
114
|
+
const names = Object.keys(FILES) as Surface[];
|
|
115
|
+
const loaded = await Promise.all(
|
|
116
|
+
names.map((name) => assets.texture(FILES[name], { anisotropy: 8, wrap: RepeatWrapping })),
|
|
117
|
+
);
|
|
118
|
+
maps = Object.fromEntries(names.map((name, i) => [name, loaded[i]])) as Record<Surface, Texture>;
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* `map` at `at` (in tiles), shifted by a random offset per noise patch and cross-faded between two
|
|
123
|
+
* offsets. `size` is the texture's width in texels: the mip level is computed from it and the base
|
|
124
|
+
* UV's derivatives (the geometric mean of the two axes, at most two levels finer than the long one).
|
|
125
|
+
*/
|
|
126
|
+
function stochastic(map: Texture, at: Node<"vec2">, size: number) {
|
|
127
|
+
const dx = dFdx(at);
|
|
128
|
+
const dy = dFdy(at);
|
|
129
|
+
const long = max(dot(dx, dx), dot(dy, dy));
|
|
130
|
+
const short = min(dot(dx, dx), dot(dy, dy));
|
|
131
|
+
const level = max(log2(long).mul(0.5).sub(2), log2(long).add(log2(short)).mul(0.25))
|
|
132
|
+
.add(Math.log2(size))
|
|
133
|
+
.add(surfaceMipBias)
|
|
134
|
+
.max(0);
|
|
135
|
+
// The grain map spans 0.62 to 1: stretched to eight offsets per unit, one noise texel a tile.
|
|
136
|
+
const index = texture(detailTexture(), at.mul(1 / 48))
|
|
137
|
+
.x.sub(0.62)
|
|
138
|
+
.mul(21);
|
|
139
|
+
const i = floor(index);
|
|
140
|
+
const f = fract(index);
|
|
141
|
+
const a = texture(map, at.add(sin(vec2(3, 7).mul(i)))).level(level);
|
|
142
|
+
const b = texture(map, at.add(sin(vec2(3, 7).mul(i.add(1))))).level(level);
|
|
143
|
+
// Fade on the texels' own difference, so the switch follows the texture's features, not a line.
|
|
144
|
+
const fade = smoothstep(0.2, 0.8, f.sub(dot(a.sub(b), vec4(0.1, 0.1, 0.1, 0))));
|
|
145
|
+
return mix(a, b, fade).xyz;
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
/**
|
|
149
|
+
* `map` projected from three axes (world, or the object's own when `local`), `tile` metres per
|
|
150
|
+
* repeat, blended by the normal. A
|
|
151
|
+
* flat-shaded surface takes its face's own normal from the position's derivatives: the owned engine
|
|
152
|
+
* gives a flat-shaded material no vertex normal, so `normalWorldGeometry` would stop the renderer.
|
|
153
|
+
*/
|
|
154
|
+
function triplanar(map: Texture, tile: number, flat: boolean, local: boolean) {
|
|
155
|
+
const position = local ? positionLocal : positionWorld;
|
|
156
|
+
const p = position.div(tile);
|
|
157
|
+
const n = abs(
|
|
158
|
+
flat
|
|
159
|
+
? cross(dFdx(position), dFdy(position)).normalize()
|
|
160
|
+
: local
|
|
161
|
+
? normalLocal
|
|
162
|
+
: normalWorldGeometry,
|
|
163
|
+
);
|
|
164
|
+
const w = n.mul(n).mul(n).mul(n);
|
|
165
|
+
const sum = w.x.add(w.y).add(w.z);
|
|
166
|
+
return texture(map, p.zy)
|
|
167
|
+
.bias(surfaceMipBias)
|
|
168
|
+
.xyz.mul(w.x)
|
|
169
|
+
.add(texture(map, p.xz).bias(surfaceMipBias).xyz.mul(w.y))
|
|
170
|
+
.add(texture(map, p.xy).bias(surfaceMipBias).xyz.mul(w.z))
|
|
171
|
+
.div(sum);
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
/** A sample over the photo's own average colour: about 1, darker in its cracks, lighter on its ridges. */
|
|
175
|
+
function structure(map: Texture, sample: Node<"vec3">, strength: number | Node<"float">) {
|
|
176
|
+
const mean = max(texture(map, vec2(0.5, 0.5)).level(float(16)).xyz, vec3(0.02, 0.02, 0.02));
|
|
177
|
+
return mix(colorNode(1, 1, 1), sample.div(mean), strength);
|
|
178
|
+
}
|
|
179
|
+
|
|
180
|
+
/**
|
|
181
|
+
* A lit, rough surface in `color` (times the vertex colours when `vertexColors`) carrying the
|
|
182
|
+
* structure of photo `surface`. Before `loadSurfaces` resolves (the hero viewer, unit tests) it is
|
|
183
|
+
* `lit` with the code-baked grain.
|
|
184
|
+
*/
|
|
185
|
+
export function surfaced(
|
|
186
|
+
color: ColorRepresentation,
|
|
187
|
+
surface: Surface,
|
|
188
|
+
options: {
|
|
189
|
+
roughness?: number;
|
|
190
|
+
vertexColors?: boolean;
|
|
191
|
+
flat?: boolean;
|
|
192
|
+
doubleSided?: boolean;
|
|
193
|
+
/** How much of the photo's light and dark shows, 0 to 1. */
|
|
194
|
+
strength?: number;
|
|
195
|
+
/** Object-space UVs, so a surface that moves carries its texture with it. */
|
|
196
|
+
local?: boolean;
|
|
197
|
+
} = {},
|
|
198
|
+
): Material {
|
|
199
|
+
const { strength = 0.9, local = false, ...shape } = options;
|
|
200
|
+
surfaceColors.add(new Color(color).getHex());
|
|
201
|
+
if (maps === undefined) return lit(color, { ...shape, detail: true });
|
|
202
|
+
const key = `${String(color)}|${surface}|${JSON.stringify(options)}`;
|
|
203
|
+
const hit = cache.get(key);
|
|
204
|
+
if (hit !== undefined) return hit;
|
|
205
|
+
const map = maps[surface];
|
|
206
|
+
const material = new MeshStandardNodeMaterial({
|
|
207
|
+
flatShading: options.flat ?? false,
|
|
208
|
+
roughness: options.roughness ?? 0.85,
|
|
209
|
+
side: options.doubleSided === true ? DoubleSide : FrontSide,
|
|
210
|
+
vertexColors: options.vertexColors ?? false,
|
|
211
|
+
});
|
|
212
|
+
material.colorNode = structure(
|
|
213
|
+
map,
|
|
214
|
+
triplanar(map, TILE[surface], options.flat ?? false, local),
|
|
215
|
+
strength,
|
|
216
|
+
).mul(colorNode(new Color(color)));
|
|
217
|
+
cache.set(key, material);
|
|
218
|
+
return material;
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
/**
|
|
222
|
+
* Meshes under `root` painted in a surface's colour with a plain material and no photo: a chest or
|
|
223
|
+
* a post built with `lit(C.wood)` where `surfaced(C.wood, "planks")` was meant. White is skipped,
|
|
224
|
+
* as a white material takes its colours from the vertices. 0 when every wood, stone and bark tone
|
|
225
|
+
* carries its photo; the whole set when the photos failed to load.
|
|
226
|
+
*/
|
|
227
|
+
export function untexturedSurfaces(root: Object3D): number {
|
|
228
|
+
let count = 0;
|
|
229
|
+
root.traverse((object) => {
|
|
230
|
+
if (!(object as Mesh).isMesh) return;
|
|
231
|
+
const materials = [(object as Mesh).material].flat();
|
|
232
|
+
for (const material of materials) {
|
|
233
|
+
const plain = material as MeshStandardMaterial | null;
|
|
234
|
+
if (plain?.type !== "MeshStandardMaterial") continue;
|
|
235
|
+
const hex = plain.color.getHex();
|
|
236
|
+
if (hex !== 0xffffff && surfaceColors.has(hex)) count += 1;
|
|
237
|
+
}
|
|
238
|
+
});
|
|
239
|
+
return count;
|
|
240
|
+
}
|
|
241
|
+
|
|
242
|
+
/**
|
|
243
|
+
* The vale's floor: grass offset per patch on level ground, rock projected from three axes where
|
|
244
|
+
* the ground is steeper than Wren can climb, under the colours `valeGround` paints. Blades show in
|
|
245
|
+
* full only where that paint is green: on the dry, brown banks a grass photo reads as straw.
|
|
246
|
+
*/
|
|
247
|
+
export function groundSurface(): Material {
|
|
248
|
+
if (maps === undefined) return lit(0xffffff, { detail: true, vertexColors: true });
|
|
249
|
+
const material = new MeshStandardNodeMaterial({ roughness: 0.9, vertexColors: true });
|
|
250
|
+
const paint = attribute<"vec3">("color", "vec3");
|
|
251
|
+
const grass = structure(
|
|
252
|
+
maps.grass,
|
|
253
|
+
stochastic(maps.grass, positionWorld.xz.div(TILE.grass), 512),
|
|
254
|
+
smoothstep(-0.02, 0.06, paint.y.sub(paint.x)).mul(0.6).add(0.3),
|
|
255
|
+
);
|
|
256
|
+
const rock = structure(maps.rock, triplanar(maps.rock, TILE.rock, false, false), 0.9);
|
|
257
|
+
material.colorNode = mix(grass, rock, smoothstep(0.8, 0.68, normalWorldGeometry.y));
|
|
258
|
+
return material;
|
|
259
|
+
}
|
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
//
|
|
3
|
+
// On-screen controls for a touch screen, cloned from Fox Dash: a thumbstick that anchors where
|
|
4
|
+
// the thumb lands, and five buttons in a fan on the right — slash, roll, shield, target, use.
|
|
5
|
+
// Drawn as flat overlay meshes on the camera, so they exist on every target the scene does.
|
|
6
|
+
import {
|
|
7
|
+
CircleGeometry,
|
|
8
|
+
Group,
|
|
9
|
+
MathUtils,
|
|
10
|
+
Mesh,
|
|
11
|
+
type MeshBasicMaterial,
|
|
12
|
+
type PerspectiveCamera,
|
|
13
|
+
RingGeometry,
|
|
14
|
+
Vector2,
|
|
15
|
+
} from "three";
|
|
16
|
+
import { flat } from "./materials.js";
|
|
17
|
+
import { C, palette } from "./palette.js";
|
|
18
|
+
|
|
19
|
+
export const TOUCH_BUTTONS = ["attack", "action", "block", "target", "interact"] as const;
|
|
20
|
+
export type TouchButton = (typeof TOUCH_BUTTONS)[number];
|
|
21
|
+
|
|
22
|
+
export interface ITouchPointer {
|
|
23
|
+
readonly position: Vector2;
|
|
24
|
+
}
|
|
25
|
+
export interface ITouchViewport {
|
|
26
|
+
readonly height: number;
|
|
27
|
+
readonly width: number;
|
|
28
|
+
}
|
|
29
|
+
export interface ITouchInput {
|
|
30
|
+
readonly move: Vector2;
|
|
31
|
+
readonly held: Readonly<Record<TouchButton, boolean>>;
|
|
32
|
+
readonly pressed: Readonly<Record<TouchButton, boolean>>;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
const STICK_RADIUS = 72;
|
|
36
|
+
const BUTTON_RADIUS = 46;
|
|
37
|
+
const EDGE = 36;
|
|
38
|
+
|
|
39
|
+
/** Where each button sits: a quarter-circle fan around the bottom-right corner. */
|
|
40
|
+
function buttonPoint(size: ITouchViewport, index: number): Vector2 {
|
|
41
|
+
const cx = size.width - EDGE - BUTTON_RADIUS;
|
|
42
|
+
const cy = size.height - EDGE - BUTTON_RADIUS;
|
|
43
|
+
if (index === 0) return new Vector2(cx, cy);
|
|
44
|
+
const angle = Math.PI + ((index - 1) / 3) * (Math.PI / 2);
|
|
45
|
+
const reach = BUTTON_RADIUS * 3.1;
|
|
46
|
+
return new Vector2(cx + Math.cos(angle) * reach, cy + Math.sin(angle) * reach);
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
const none = (): Record<TouchButton, boolean> => ({
|
|
50
|
+
action: false,
|
|
51
|
+
attack: false,
|
|
52
|
+
block: false,
|
|
53
|
+
interact: false,
|
|
54
|
+
target: false,
|
|
55
|
+
});
|
|
56
|
+
|
|
57
|
+
export class TouchControls {
|
|
58
|
+
readonly root = new Group();
|
|
59
|
+
readonly object = this.root;
|
|
60
|
+
readonly #camera: PerspectiveCamera;
|
|
61
|
+
readonly #input = { held: none(), move: new Vector2(), pressed: none() };
|
|
62
|
+
readonly #idle: MeshBasicMaterial;
|
|
63
|
+
readonly #active: MeshBasicMaterial;
|
|
64
|
+
readonly #stick: Mesh;
|
|
65
|
+
readonly #knob: Mesh;
|
|
66
|
+
readonly #buttons: Mesh[] = [];
|
|
67
|
+
#anchor = new Vector2();
|
|
68
|
+
#anchored = false;
|
|
69
|
+
|
|
70
|
+
constructor(camera: PerspectiveCamera) {
|
|
71
|
+
this.#camera = camera;
|
|
72
|
+
this.#idle = flat(C.eye, 0.32, { depthTest: false });
|
|
73
|
+
this.#active = flat(palette.accent, 0.6, { depthTest: false });
|
|
74
|
+
this.#stick = new Mesh(new RingGeometry(STICK_RADIUS - 5, STICK_RADIUS, 32), this.#idle);
|
|
75
|
+
this.#knob = new Mesh(new CircleGeometry(28, 24), this.#active);
|
|
76
|
+
this.root.add(this.#stick, this.#knob);
|
|
77
|
+
for (const _ of TOUCH_BUTTONS) {
|
|
78
|
+
const button = new Mesh(new RingGeometry(BUTTON_RADIUS - 5, BUTTON_RADIUS, 28), this.#idle);
|
|
79
|
+
this.#buttons.push(button);
|
|
80
|
+
this.root.add(button);
|
|
81
|
+
}
|
|
82
|
+
this.root.renderOrder = 10_001;
|
|
83
|
+
camera.add(this.root);
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
update(pointers: ReadonlyMap<number, ITouchPointer>, size: ITouchViewport): ITouchInput {
|
|
87
|
+
const rest = new Vector2(STICK_RADIUS + EDGE, size.height - STICK_RADIUS - EDGE);
|
|
88
|
+
let thumb: ITouchPointer | undefined;
|
|
89
|
+
for (const pointer of pointers.values()) {
|
|
90
|
+
if (pointer.position.x < size.width * 0.45 && pointer.position.y > size.height * 0.4) {
|
|
91
|
+
thumb = pointer;
|
|
92
|
+
break;
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
const move = this.#input.move;
|
|
96
|
+
if (thumb === undefined) {
|
|
97
|
+
this.#anchored = false;
|
|
98
|
+
move.set(0, 0);
|
|
99
|
+
} else {
|
|
100
|
+
if (!this.#anchored) this.#anchor.copy(thumb.position);
|
|
101
|
+
this.#anchored = true;
|
|
102
|
+
move.set(
|
|
103
|
+
MathUtils.clamp((thumb.position.x - this.#anchor.x) / STICK_RADIUS, -1, 1),
|
|
104
|
+
MathUtils.clamp((this.#anchor.y - thumb.position.y) / STICK_RADIUS, -1, 1),
|
|
105
|
+
);
|
|
106
|
+
}
|
|
107
|
+
const centre = this.#anchored ? this.#anchor : rest;
|
|
108
|
+
for (const [index, name] of TOUCH_BUTTONS.entries()) {
|
|
109
|
+
const point = buttonPoint(size, index);
|
|
110
|
+
let down = false;
|
|
111
|
+
for (const pointer of pointers.values())
|
|
112
|
+
if (pointer.position.distanceToSquared(point) <= BUTTON_RADIUS ** 2) down = true;
|
|
113
|
+
this.#input.pressed[name] = down && !this.#input.held[name];
|
|
114
|
+
this.#input.held[name] = down;
|
|
115
|
+
const button = this.#buttons[index];
|
|
116
|
+
if (button === undefined) continue;
|
|
117
|
+
button.material = down ? this.#active : this.#idle;
|
|
118
|
+
button.position.set(point.x, point.y, 0);
|
|
119
|
+
}
|
|
120
|
+
this.#stick.position.set(centre.x, centre.y, 0);
|
|
121
|
+
this.#knob.position.set(centre.x + move.x * STICK_RADIUS, centre.y - move.y * STICK_RADIUS, 0);
|
|
122
|
+
const worldHeight = 2 * Math.tan(MathUtils.degToRad(this.#camera.fov / 2));
|
|
123
|
+
const pixels = worldHeight / Math.max(1, size.height);
|
|
124
|
+
this.root.position.set((-size.width * pixels) / 2, worldHeight / 2, -1);
|
|
125
|
+
this.root.scale.set(pixels, -pixels, 1);
|
|
126
|
+
return this.#input;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
debug(): Record<string, unknown> {
|
|
130
|
+
return { held: { ...this.#input.held }, move: this.#input.move.toArray() };
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
dispose(): void {
|
|
134
|
+
this.root.removeFromParent();
|
|
135
|
+
for (const child of this.root.children) if (child instanceof Mesh) child.geometry.dispose();
|
|
136
|
+
}
|
|
137
|
+
}
|