create-threenative 0.2.10 → 0.2.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agent-docs/references/assertion-reference.md +109 -3
- package/agent-docs/references/auto-exposure.md +28 -45
- package/agent-docs/references/build-profiles.md +1 -1
- package/agent-docs/references/capability-reference.md +527 -44
- package/agent-docs/references/debug-surface.md +64 -0
- package/agent-docs/references/finding-assets.md +11 -12
- package/agent-docs/references/performance-basics.md +19 -0
- package/agent-docs/references/trace-a-slow-frame.md +21 -0
- package/agent-docs/references/visual-baseline.md +23 -4
- package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
- package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
- package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
- package/agent-files/scripts/reference.mjs +9 -4
- package/capabilities.json +739 -50
- package/dist/index.d.ts +40 -6
- package/dist/index.js +227 -34
- package/dist/quality.d.ts +12 -0
- package/dist/quality.js +166747 -0
- package/dist/threenative.js +60 -44
- package/dist/web-engine-gltf-loader.js +2 -0
- package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
- package/dist/web-engine-mesh-bvh.js +7 -0
- package/dist/web-engine-post-effects.js +645 -19
- package/dist/web-engine-runtime.js +3528 -343
- package/package.json +19 -9
- package/template-assets/assets/bay-PROVENANCE.md +21 -0
- package/template-assets/assets/bay-ground.webp +0 -0
- package/template-assets/assets/bay-metal.webp +0 -0
- package/template-assets/assets/bay-pavement-normal.webp +0 -0
- package/template-assets/assets/bay-pavement.webp +0 -0
- package/template-assets/assets/bay-plaster-normal.webp +0 -0
- package/template-assets/assets/bay-plaster.webp +0 -0
- package/template-assets/assets/bay-wood-normal.webp +0 -0
- package/template-assets/assets/bay-wood.webp +0 -0
- package/template-assets/assets/tex-PROVENANCE.md +25 -0
- package/template-assets/assets/tex-bark-normal.webp +0 -0
- package/template-assets/assets/tex-bark.webp +0 -0
- package/template-assets/assets/tex-birch-bark.webp +0 -0
- package/template-assets/assets/tex-grass.webp +0 -0
- package/template-assets/assets/tex-planks-normal.webp +0 -0
- package/template-assets/assets/tex-planks.webp +0 -0
- package/template-assets/assets/tex-rock-normal.webp +0 -0
- package/template-assets/assets/tex-rock.webp +0 -0
- package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
- package/template-assets/assets/tex-roof-tiles.webp +0 -0
- package/template-assets/assets/tex-sand-normal.webp +0 -0
- package/template-assets/assets/tex-sand.webp +0 -0
- package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
- package/template-assets/assets/tex-stone-wall.webp +0 -0
- package/template-assets/kitExposure.ts +20 -0
- package/template-assets/patches/three@0.185.1.patch +481 -272
- package/template-assets/quality/biome.json +7 -0
- package/template-assets/quality/eslint.config.js +3 -0
- package/template-assets/realistic-ocean/README.md +113 -0
- package/template-assets/realistic-ocean/install.mjs +56 -0
- package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
- package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
- package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
- package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
- package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
- package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
- package/templates/AGENTS.md +21 -0
- package/templates/CLAUDE.md +23 -0
- package/templates/action-rpg/.codex/config.toml +6 -2
- package/templates/action-rpg/.cursor/mcp.json +8 -2
- package/templates/action-rpg/.gemini/settings.json +8 -2
- package/templates/action-rpg/.mcp.json +8 -2
- package/templates/action-rpg/.vscode/mcp.json +9 -2
- package/templates/action-rpg/.zed/settings.json +9 -2
- package/templates/action-rpg/AGENTS.md +11 -11
- package/templates/action-rpg/CLAUDE.md +11 -11
- package/templates/action-rpg/opencode.json +10 -2
- package/templates/action-rpg/package.json +15 -10
- package/templates/action-rpg/playtests/combat.playtest.json +6 -0
- package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
- package/templates/action-rpg/playtests/performance.playtest.json +1 -1
- package/templates/action-rpg/playtests/roll.playtest.json +112 -0
- package/templates/action-rpg/playtests/swing.playtest.json +55 -0
- package/templates/action-rpg/playtests/win.playtest.json +4 -4
- package/templates/action-rpg/src/entities/Fighter.ts +44 -4
- package/templates/action-rpg/src/entities/Player.ts +64 -12
- package/templates/action-rpg/src/render/atmosphere.ts +444 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
- package/templates/action-rpg/src/render/clouds.ts +605 -0
- package/templates/action-rpg/src/render/dungeon.ts +8 -6
- package/templates/action-rpg/src/render/exposure.ts +11 -109
- package/templates/action-rpg/src/render/gpuSky.ts +752 -0
- package/templates/action-rpg/src/render/lighting.ts +27 -4
- package/templates/action-rpg/src/render/materialLighting.ts +2 -11
- package/templates/action-rpg/src/render/palette.ts +1 -0
- package/templates/action-rpg/src/render/postprocessing.ts +4 -4
- package/templates/action-rpg/src/render/props.ts +10 -8
- package/templates/action-rpg/src/render/quality.ts +56 -108
- package/templates/action-rpg/src/render/sky.ts +74 -1
- package/templates/action-rpg/src/scenes/Play.ts +16 -12
- package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
- package/templates/action-rpg/src/ui/Hud.tsx +5 -7
- package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
- package/templates/action-rpg/threenative.config.ts +3 -0
- package/templates/adventure/.codex/config.toml +23 -0
- package/templates/adventure/.cursor/mcp.json +38 -0
- package/templates/adventure/.gemini/settings.json +38 -0
- package/templates/adventure/.mcp.json +38 -0
- package/templates/adventure/.vscode/mcp.json +43 -0
- package/templates/adventure/.zed/settings.json +43 -0
- package/templates/adventure/AGENTS.md +60 -0
- package/templates/adventure/CLAUDE.md +62 -0
- package/templates/adventure/index.html +14 -0
- package/templates/adventure/kit.json +8 -0
- package/templates/adventure/native-playtests/survives.playtest.json +52 -0
- package/templates/adventure/opencode.json +49 -0
- package/templates/adventure/package.json +65 -0
- package/templates/adventure/playtests/boss.playtest.json +406 -0
- package/templates/adventure/playtests/combat.playtest.json +342 -0
- package/templates/adventure/playtests/controls.playtest.json +142 -0
- package/templates/adventure/playtests/explore.playtest.json +45 -0
- package/templates/adventure/playtests/flicker.playtest.json +206 -0
- package/templates/adventure/playtests/hearts.playtest.json +171 -0
- package/templates/adventure/playtests/lockon.playtest.json +256 -0
- package/templates/adventure/playtests/look.playtest.json +72 -0
- package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
- package/templates/adventure/playtests/move.playtest.json +84 -0
- package/templates/adventure/playtests/performance.playtest.json +55 -0
- package/templates/adventure/playtests/puzzle.playtest.json +250 -0
- package/templates/adventure/playtests/stride.playtest.json +67 -0
- package/templates/adventure/playtests/survives.playtest.json +171 -0
- package/templates/adventure/playtests/thornback.playtest.json +267 -0
- package/templates/adventure/public/favicon.svg +4 -0
- package/templates/adventure/src/entities/Block.ts +114 -0
- package/templates/adventure/src/entities/Chest.ts +69 -0
- package/templates/adventure/src/entities/Door.ts +81 -0
- package/templates/adventure/src/entities/Dummy.ts +69 -0
- package/templates/adventure/src/entities/Flicker.ts +239 -0
- package/templates/adventure/src/entities/Hero.ts +561 -0
- package/templates/adventure/src/entities/LockOn.ts +180 -0
- package/templates/adventure/src/entities/Mossling.ts +249 -0
- package/templates/adventure/src/entities/Switch.ts +49 -0
- package/templates/adventure/src/entities/Thornback.ts +238 -0
- package/templates/adventure/src/entities/Warden.ts +196 -0
- package/templates/adventure/src/game.ts +65 -0
- package/templates/adventure/src/interact.ts +63 -0
- package/templates/adventure/src/level/Hollow.ts +240 -0
- package/templates/adventure/src/level/Vale.ts +383 -0
- package/templates/adventure/src/main.ts +18 -0
- package/templates/adventure/src/render/camera.ts +416 -0
- package/templates/adventure/src/render/creatures.ts +405 -0
- package/templates/adventure/src/render/effects.ts +333 -0
- package/templates/adventure/src/render/foliage.ts +1072 -0
- package/templates/adventure/src/render/hero.ts +1447 -0
- package/templates/adventure/src/render/kitExposure.ts +20 -0
- package/templates/adventure/src/render/lighting.ts +74 -0
- package/templates/adventure/src/render/loading.ts +332 -0
- package/templates/adventure/src/render/materials.ts +179 -0
- package/templates/adventure/src/render/palette.ts +137 -0
- package/templates/adventure/src/render/postprocessing.ts +70 -0
- package/templates/adventure/src/render/props.ts +383 -0
- package/templates/adventure/src/render/quality.ts +46 -0
- package/templates/adventure/src/render/sky.ts +271 -0
- package/templates/adventure/src/render/surface.ts +259 -0
- package/templates/adventure/src/render/touch-controls.ts +137 -0
- package/templates/adventure/src/scenes/Play.ts +959 -0
- package/templates/adventure/src/state.ts +113 -0
- package/templates/adventure/src/style.css +98 -0
- package/templates/adventure/src/ui/App.tsx +22 -0
- package/templates/adventure/src/ui/GameUi.tsx +20 -0
- package/templates/adventure/src/ui/Hud.tsx +70 -0
- package/templates/adventure/src/ui/Menu.tsx +15 -0
- package/templates/adventure/src/ui/main.tsx +14 -0
- package/templates/adventure/tailwind.config.ts +2 -0
- package/templates/adventure/threenative.config.ts +62 -0
- package/templates/adventure/tsconfig.json +17 -0
- package/templates/adventure/vite.config.ts +49 -0
- package/templates/collectathon/.codex/config.toml +23 -0
- package/templates/collectathon/.cursor/mcp.json +38 -0
- package/templates/collectathon/.gemini/settings.json +38 -0
- package/templates/collectathon/.mcp.json +38 -0
- package/templates/collectathon/.vscode/mcp.json +43 -0
- package/templates/collectathon/.zed/settings.json +43 -0
- package/templates/collectathon/AGENTS.md +58 -0
- package/templates/collectathon/CLAUDE.md +60 -0
- package/templates/collectathon/index.html +14 -0
- package/templates/collectathon/kit.json +8 -0
- package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
- package/templates/collectathon/opencode.json +49 -0
- package/templates/collectathon/package.json +65 -0
- package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
- package/templates/collectathon/playtests/camera.playtest.json +80 -0
- package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
- package/templates/collectathon/playtests/collect.playtest.json +196 -0
- package/templates/collectathon/playtests/combat.playtest.json +246 -0
- package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
- package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
- package/templates/collectathon/playtests/effects.playtest.json +124 -0
- package/templates/collectathon/playtests/enemies.playtest.json +295 -0
- package/templates/collectathon/playtests/explore.playtest.json +45 -0
- package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
- package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
- package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
- package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
- package/templates/collectathon/playtests/ledge.playtest.json +100 -0
- package/templates/collectathon/playtests/look.playtest.json +64 -0
- package/templates/collectathon/playtests/performance.playtest.json +55 -0
- package/templates/collectathon/playtests/stride.playtest.json +111 -0
- package/templates/collectathon/playtests/survives.playtest.json +123 -0
- package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
- package/templates/collectathon/playtests/thornback.playtest.json +157 -0
- package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
- package/templates/collectathon/playtests/win.playtest.json +166 -0
- package/templates/collectathon/public/favicon.svg +4 -0
- package/templates/collectathon/src/entities/Hero.ts +915 -0
- package/templates/collectathon/src/entities/Pickup.ts +63 -0
- package/templates/collectathon/src/entities/Walker.ts +248 -0
- package/templates/collectathon/src/game.ts +51 -0
- package/templates/collectathon/src/level/Course.ts +590 -0
- package/templates/collectathon/src/level/terrain.ts +144 -0
- package/templates/collectathon/src/main.ts +14 -0
- package/templates/collectathon/src/playtest-events.ts +15 -0
- package/templates/collectathon/src/render/camera.ts +163 -0
- package/templates/collectathon/src/render/castle.ts +408 -0
- package/templates/collectathon/src/render/effects.ts +284 -0
- package/templates/collectathon/src/render/foliage.ts +744 -0
- package/templates/collectathon/src/render/ground.ts +139 -0
- package/templates/collectathon/src/render/hero.ts +452 -0
- package/templates/collectathon/src/render/kitExposure.ts +20 -0
- package/templates/collectathon/src/render/lighting.ts +65 -0
- package/templates/collectathon/src/render/loading.ts +332 -0
- package/templates/collectathon/src/render/materials.ts +196 -0
- package/templates/collectathon/src/render/palette.ts +82 -0
- package/templates/collectathon/src/render/postprocessing.ts +79 -0
- package/templates/collectathon/src/render/props.ts +218 -0
- package/templates/collectathon/src/render/quality.ts +54 -0
- package/templates/collectathon/src/render/sky.ts +262 -0
- package/templates/collectathon/src/render/surface.ts +269 -0
- package/templates/collectathon/src/render/touch-controls.ts +179 -0
- package/templates/collectathon/src/render/touch-layout.ts +48 -0
- package/templates/collectathon/src/render/water.ts +191 -0
- package/templates/collectathon/src/scenes/Play.ts +481 -0
- package/templates/collectathon/src/state.ts +38 -0
- package/templates/collectathon/src/style.css +106 -0
- package/templates/collectathon/src/ui/App.tsx +22 -0
- package/templates/collectathon/src/ui/GameUi.tsx +20 -0
- package/templates/collectathon/src/ui/Hud.tsx +77 -0
- package/templates/collectathon/src/ui/Menu.tsx +13 -0
- package/templates/collectathon/src/ui/main.tsx +14 -0
- package/templates/collectathon/tailwind.config.ts +2 -0
- package/templates/collectathon/threenative.config.ts +62 -0
- package/templates/collectathon/tsconfig.json +17 -0
- package/templates/collectathon/vite.config.ts +49 -0
- package/templates/kart/.codex/config.toml +23 -0
- package/templates/kart/.cursor/mcp.json +38 -0
- package/templates/kart/.gemini/settings.json +38 -0
- package/templates/kart/.mcp.json +38 -0
- package/templates/kart/.vscode/mcp.json +43 -0
- package/templates/kart/.zed/settings.json +43 -0
- package/templates/kart/AGENTS.md +58 -0
- package/templates/kart/CLAUDE.md +60 -0
- package/templates/kart/index.html +14 -0
- package/templates/kart/kit.json +8 -0
- package/templates/kart/native-playtests/survives.playtest.json +65 -0
- package/templates/kart/opencode.json +49 -0
- package/templates/kart/package.json +64 -0
- package/templates/kart/playtests/drift.playtest.json +226 -0
- package/templates/kart/playtests/explore.playtest.json +45 -0
- package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
- package/templates/kart/playtests/item-key.playtest.json +108 -0
- package/templates/kart/playtests/items.playtest.json +143 -0
- package/templates/kart/playtests/lap-times.playtest.json +138 -0
- package/templates/kart/playtests/laps.playtest.json +149 -0
- package/templates/kart/playtests/performance.playtest.json +57 -0
- package/templates/kart/playtests/race.playtest.json +294 -0
- package/templates/kart/playtests/restart.playtest.json +87 -0
- package/templates/kart/playtests/rocket-start.playtest.json +56 -0
- package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
- package/templates/kart/playtests/surfaces.playtest.json +113 -0
- package/templates/kart/playtests/survives.playtest.json +116 -0
- package/templates/kart/playtests/wall.playtest.json +118 -0
- package/templates/kart/public/favicon.svg +4 -0
- package/templates/kart/src/entities/Driver.ts +123 -0
- package/templates/kart/src/entities/Items.ts +194 -0
- package/templates/kart/src/entities/Kart.ts +517 -0
- package/templates/kart/src/game.ts +45 -0
- package/templates/kart/src/main.ts +14 -0
- package/templates/kart/src/playtest-events.ts +15 -0
- package/templates/kart/src/render/camera.ts +83 -0
- package/templates/kart/src/render/course.ts +579 -0
- package/templates/kart/src/render/effects.ts +266 -0
- package/templates/kart/src/render/items.ts +163 -0
- package/templates/kart/src/render/kart.ts +256 -0
- package/templates/kart/src/render/kitExposure.ts +20 -0
- package/templates/kart/src/render/lighting.ts +58 -0
- package/templates/kart/src/render/loading.ts +332 -0
- package/templates/kart/src/render/materials.ts +119 -0
- package/templates/kart/src/render/palette.ts +74 -0
- package/templates/kart/src/render/postprocessing.ts +79 -0
- package/templates/kart/src/render/quality.ts +54 -0
- package/templates/kart/src/render/skids.ts +86 -0
- package/templates/kart/src/render/sky.ts +105 -0
- package/templates/kart/src/render/touch-controls.ts +168 -0
- package/templates/kart/src/render/touch-layout.ts +48 -0
- package/templates/kart/src/scenes/Race.ts +850 -0
- package/templates/kart/src/state.ts +53 -0
- package/templates/kart/src/style.css +106 -0
- package/templates/kart/src/track/Course.ts +276 -0
- package/templates/kart/src/track/Race.ts +133 -0
- package/templates/kart/src/ui/App.tsx +21 -0
- package/templates/kart/src/ui/GameUi.tsx +20 -0
- package/templates/kart/src/ui/Hud.tsx +172 -0
- package/templates/kart/src/ui/Menu.tsx +13 -0
- package/templates/kart/src/ui/main.tsx +14 -0
- package/templates/kart/tailwind.config.ts +2 -0
- package/templates/kart/threenative.config.ts +62 -0
- package/templates/kart/tsconfig.json +17 -0
- package/templates/kart/vite.config.ts +49 -0
- package/templates/minimal/.codex/config.toml +6 -2
- package/templates/minimal/.cursor/mcp.json +8 -2
- package/templates/minimal/.gemini/settings.json +8 -2
- package/templates/minimal/.mcp.json +8 -2
- package/templates/minimal/.vscode/mcp.json +9 -2
- package/templates/minimal/.zed/settings.json +9 -2
- package/templates/minimal/AGENTS.md +11 -13
- package/templates/minimal/CLAUDE.md +11 -13
- package/templates/minimal/opencode.json +10 -2
- package/templates/minimal/package.json +14 -9
- package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
- package/templates/minimal/playtests/jump.playtest.json +45 -0
- package/templates/minimal/playtests/play.playtest.json +1 -1
- package/templates/minimal/src/game.ts +2 -0
- package/templates/minimal/src/render/atmosphere.ts +444 -0
- package/templates/minimal/src/render/backlightMaterial.ts +49 -18
- package/templates/minimal/src/render/camera.ts +35 -4
- package/templates/minimal/src/render/clouds.ts +605 -0
- package/templates/minimal/src/render/exposure.ts +7 -111
- package/templates/minimal/src/render/gpuSky.ts +752 -0
- package/templates/minimal/src/render/lighting.ts +26 -4
- package/templates/minimal/src/render/materialLighting.ts +2 -10
- package/templates/minimal/src/render/postprocessing.ts +4 -4
- package/templates/minimal/src/render/quality.ts +10 -116
- package/templates/minimal/src/render/sky.ts +73 -1
- package/templates/minimal/src/scenes/Play.ts +18 -7
- package/templates/platformer/.codex/config.toml +6 -2
- package/templates/platformer/.cursor/mcp.json +8 -2
- package/templates/platformer/.gemini/settings.json +8 -2
- package/templates/platformer/.mcp.json +8 -2
- package/templates/platformer/.vscode/mcp.json +9 -2
- package/templates/platformer/.zed/settings.json +9 -2
- package/templates/platformer/AGENTS.md +13 -9
- package/templates/platformer/CLAUDE.md +13 -9
- package/templates/platformer/opencode.json +10 -2
- package/templates/platformer/package.json +15 -10
- package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
- package/templates/platformer/playtests/finish.playtest.json +58 -0
- package/templates/platformer/playtests/idle.playtest.json +44 -0
- package/templates/platformer/playtests/performance.playtest.json +1 -1
- package/templates/platformer/src/entities/Fox.ts +19 -6
- package/templates/platformer/src/game.ts +1 -0
- package/templates/platformer/src/level/Stage.ts +4 -1
- package/templates/platformer/src/render/backlightMaterial.ts +49 -18
- package/templates/platformer/src/render/camera.ts +30 -1
- package/templates/platformer/src/render/exposure.ts +6 -111
- package/templates/platformer/src/render/fox.ts +5 -2
- package/templates/platformer/src/render/kitExposure.ts +20 -0
- package/templates/platformer/src/render/materialLighting.ts +2 -11
- package/templates/platformer/src/render/postprocessing.ts +4 -4
- package/templates/platformer/src/render/props.ts +1 -2
- package/templates/platformer/src/render/quality.ts +10 -118
- package/templates/platformer/src/scenes/Play.ts +31 -15
- package/templates/platformer/src/ui/Menu.tsx +1 -1
- package/templates/puzzle/.codex/config.toml +6 -2
- package/templates/puzzle/.cursor/mcp.json +8 -2
- package/templates/puzzle/.gemini/settings.json +8 -2
- package/templates/puzzle/.mcp.json +8 -2
- package/templates/puzzle/.vscode/mcp.json +9 -2
- package/templates/puzzle/.zed/settings.json +9 -2
- package/templates/puzzle/AGENTS.md +14 -17
- package/templates/puzzle/CLAUDE.md +14 -17
- package/templates/puzzle/opencode.json +10 -2
- package/templates/puzzle/package.json +15 -10
- package/templates/puzzle/playtests/performance.playtest.json +1 -1
- package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
- package/templates/puzzle/src/render/exposure.ts +11 -109
- package/templates/puzzle/src/render/lighting.ts +3 -3
- package/templates/puzzle/src/render/materialLighting.ts +2 -11
- package/templates/puzzle/src/render/palette.ts +1 -1
- package/templates/puzzle/src/render/postprocessing.ts +4 -4
- package/templates/puzzle/src/render/quality.ts +44 -153
- package/templates/puzzle/src/render/vault.ts +18 -6
- package/templates/puzzle/src/scenes/Play.ts +6 -1
- package/templates/puzzle/src/ui/Hud.tsx +8 -43
- package/templates/racing/.codex/config.toml +6 -2
- package/templates/racing/.cursor/mcp.json +8 -2
- package/templates/racing/.gemini/settings.json +8 -2
- package/templates/racing/.mcp.json +8 -2
- package/templates/racing/.vscode/mcp.json +9 -2
- package/templates/racing/.zed/settings.json +9 -2
- package/templates/racing/AGENTS.md +10 -12
- package/templates/racing/CLAUDE.md +10 -12
- package/templates/racing/opencode.json +10 -2
- package/templates/racing/package.json +15 -10
- package/templates/racing/playtests/brake.playtest.json +54 -0
- package/templates/racing/playtests/outcome.playtest.json +19 -0
- package/templates/racing/playtests/performance.playtest.json +1 -1
- package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
- package/templates/racing/src/entities/RacingCar.ts +12 -3
- package/templates/racing/src/entities/Rival.ts +11 -2
- package/templates/racing/src/render/atmosphere.ts +444 -0
- package/templates/racing/src/render/backlightMaterial.ts +49 -18
- package/templates/racing/src/render/clouds.ts +605 -0
- package/templates/racing/src/render/exposure.ts +6 -111
- package/templates/racing/src/render/gpuSky.ts +752 -0
- package/templates/racing/src/render/kitExposure.ts +20 -0
- package/templates/racing/src/render/lighting.ts +26 -4
- package/templates/racing/src/render/materialLighting.ts +2 -11
- package/templates/racing/src/render/materials.ts +2 -1
- package/templates/racing/src/render/postprocessing.ts +4 -4
- package/templates/racing/src/render/quality.ts +27 -115
- package/templates/racing/src/render/sky.ts +72 -1
- package/templates/racing/src/scenes/Race.ts +9 -7
- package/templates/racing/src/track/TrackSector.ts +5 -2
- package/templates/racing/src/ui/Hud.tsx +12 -7
- package/templates/rain/.codex/config.toml +6 -2
- package/templates/rain/.cursor/mcp.json +8 -2
- package/templates/rain/.gemini/settings.json +8 -2
- package/templates/rain/.mcp.json +8 -2
- package/templates/rain/.vscode/mcp.json +9 -2
- package/templates/rain/.zed/settings.json +9 -2
- package/templates/rain/AGENTS.md +12 -12
- package/templates/rain/CLAUDE.md +12 -12
- package/templates/rain/opencode.json +10 -2
- package/templates/rain/package.json +14 -9
- package/templates/rain/playtests/performance.playtest.json +1 -1
- package/templates/rain/src/game.ts +1 -1
- package/templates/rain/src/render/bloom-shader.ts +1 -1
- package/templates/rain/src/render/clouds-shader.ts +2 -2
- package/templates/rain/src/render/clouds.ts +2 -1
- package/templates/rain/src/render/exposure.ts +11 -109
- package/templates/rain/src/render/post-shader.ts +7 -11
- package/templates/rain/src/render/postprocessing.ts +8 -24
- package/templates/rain/src/render/quality.ts +44 -98
- package/templates/rain/src/render/world-shader.ts +281 -97
- package/templates/rain/src/render/world.ts +82 -2
- package/templates/rain/src/style.css +1 -1
- package/templates/rain/src/ui/GameUi.tsx +6 -2
- package/templates/rain/src/ui/Hud.tsx +1 -1
- package/templates/rain/tools/generate-shaders.mjs +2 -2
- package/templates/rain/tools/tempest-post.frag +4 -6
- package/templates/rain/tools/tempest-world.frag +80 -12
- package/templates/rts/.codex/config.toml +6 -2
- package/templates/rts/.cursor/mcp.json +8 -2
- package/templates/rts/.gemini/settings.json +8 -2
- package/templates/rts/.mcp.json +8 -2
- package/templates/rts/.vscode/mcp.json +9 -2
- package/templates/rts/.zed/settings.json +9 -2
- package/templates/rts/AGENTS.md +15 -16
- package/templates/rts/CLAUDE.md +15 -16
- package/templates/rts/opencode.json +10 -2
- package/templates/rts/package.json +14 -9
- package/templates/rts/playtests/performance.playtest.json +1 -1
- package/templates/rts/playtests/rts-attack.playtest.json +5 -0
- package/templates/rts/playtests/rts-build.playtest.json +20 -1
- package/templates/rts/playtests/rts-orders.playtest.json +1 -1
- package/templates/rts/playtests/rts-pause.playtest.json +112 -0
- package/templates/rts/playtests/rts-train.playtest.json +1 -1
- package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
- package/templates/rts/src/game.ts +29 -7
- package/templates/rts/src/render/army.ts +181 -49
- package/templates/rts/src/render/backlightMaterial.ts +49 -18
- package/templates/rts/src/render/environment.ts +276 -0
- package/templates/rts/src/render/exposure.ts +3 -65
- package/templates/rts/src/render/ground.ts +478 -0
- package/templates/rts/src/render/lighting.ts +62 -11
- package/templates/rts/src/render/materialLighting.ts +2 -11
- package/templates/rts/src/render/materials.ts +47 -118
- package/templates/rts/src/render/palette.ts +30 -13
- package/templates/rts/src/render/picking.ts +18 -0
- package/templates/rts/src/render/postprocessing.ts +4 -4
- package/templates/rts/src/render/quality.ts +64 -85
- package/templates/rts/src/render/resources.ts +21 -22
- package/templates/rts/src/render/sky.ts +9 -12
- package/templates/rts/src/render/terrain.ts +36 -11
- package/templates/rts/src/scenes/Play.ts +373 -38
- package/templates/rts/src/sim/ai.ts +0 -11
- package/templates/rts/src/state.ts +46 -0
- package/templates/rts/src/style.css +1543 -0
- package/templates/rts/src/ui/Commands.tsx +204 -107
- package/templates/rts/src/ui/GameUi.tsx +12 -5
- package/templates/rts/src/ui/Hud.tsx +611 -116
- package/templates/rts/src/ui/Minimap.tsx +103 -37
- package/templates/rts/src/ui/icons.tsx +116 -0
- package/templates/rts/src/ui/labels.ts +73 -0
- package/templates/rts/src/ui/minimapPoint.ts +30 -0
- package/templates/rts/threenative.config.ts +1 -1
- package/templates/runner/.codex/config.toml +6 -2
- package/templates/runner/.cursor/mcp.json +8 -2
- package/templates/runner/.gemini/settings.json +8 -2
- package/templates/runner/.mcp.json +8 -2
- package/templates/runner/.vscode/mcp.json +9 -2
- package/templates/runner/.zed/settings.json +9 -2
- package/templates/runner/AGENTS.md +12 -12
- package/templates/runner/CLAUDE.md +12 -12
- package/templates/runner/opencode.json +10 -2
- package/templates/runner/package.json +15 -10
- package/templates/runner/playtests/near-miss.playtest.json +48 -0
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/playtests/stride.playtest.json +27 -0
- package/templates/runner/playtests/survives.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +3 -1
- package/templates/runner/src/entities/Runner.ts +11 -5
- package/templates/runner/src/render/atmosphere.ts +444 -0
- package/templates/runner/src/render/backlightMaterial.ts +49 -18
- package/templates/runner/src/render/clouds.ts +605 -0
- package/templates/runner/src/render/exposure.ts +6 -111
- package/templates/runner/src/render/gpuSky.ts +752 -0
- package/templates/runner/src/render/kitExposure.ts +20 -0
- package/templates/runner/src/render/lighting.ts +26 -4
- package/templates/runner/src/render/materialLighting.ts +2 -11
- package/templates/runner/src/render/postprocessing.ts +4 -4
- package/templates/runner/src/render/quality.ts +26 -114
- package/templates/runner/src/render/sky.ts +73 -1
- package/templates/runner/src/scenes/Run.ts +19 -15
- package/templates/runner/src/track.ts +12 -3
- package/templates/sailing/.codex/config.toml +6 -2
- package/templates/sailing/.cursor/mcp.json +8 -2
- package/templates/sailing/.gemini/settings.json +8 -2
- package/templates/sailing/.mcp.json +8 -2
- package/templates/sailing/.vscode/mcp.json +9 -2
- package/templates/sailing/.zed/settings.json +9 -2
- package/templates/sailing/AGENTS.md +10 -11
- package/templates/sailing/CLAUDE.md +10 -11
- package/templates/sailing/opencode.json +10 -2
- package/templates/sailing/package.json +15 -10
- package/templates/sailing/playtests/fail.playtest.json +46 -5
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
- package/templates/sailing/playtests/performance.playtest.json +1 -1
- package/templates/sailing/src/game.ts +1 -0
- package/templates/sailing/src/render/backlightMaterial.ts +49 -18
- package/templates/sailing/src/render/exposure.ts +6 -111
- package/templates/sailing/src/render/kitExposure.ts +20 -0
- package/templates/sailing/src/render/materialLighting.ts +2 -11
- package/templates/sailing/src/render/ocean.ts +0 -1
- package/templates/sailing/src/render/postprocessing.ts +4 -4
- package/templates/sailing/src/render/quality.ts +31 -138
- package/templates/sailing/src/scenes/Sailing.ts +12 -4
- package/templates/sailing/src/ui/Hud.tsx +6 -2
- package/templates/sailing/src/ui/Menu.tsx +1 -1
- package/templates/shooter/.codex/config.toml +6 -2
- package/templates/shooter/.cursor/mcp.json +8 -2
- package/templates/shooter/.gemini/settings.json +8 -2
- package/templates/shooter/.mcp.json +8 -2
- package/templates/shooter/.vscode/mcp.json +9 -2
- package/templates/shooter/.zed/settings.json +9 -2
- package/templates/shooter/AGENTS.md +13 -12
- package/templates/shooter/CLAUDE.md +13 -12
- package/templates/shooter/index.html +1 -1
- package/templates/shooter/main.html +13 -0
- package/templates/shooter/opencode.json +10 -2
- package/templates/shooter/package.json +15 -10
- package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
- package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
- package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
- package/templates/shooter/playtests/performance.playtest.json +3 -3
- package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
- package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
- package/templates/shooter/src/entities/Breakables.ts +34 -10
- package/templates/shooter/src/entities/Enemy.ts +176 -54
- package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
- package/templates/shooter/src/entities/Rifle.ts +83 -9
- package/templates/shooter/src/entities/movement.ts +96 -0
- package/templates/shooter/src/render/atmosphere.ts +444 -0
- package/templates/shooter/src/render/backlightMaterial.ts +49 -18
- package/templates/shooter/src/render/camera.ts +3 -1
- package/templates/shooter/src/render/clouds.ts +605 -0
- package/templates/shooter/src/render/exposure.ts +10 -109
- package/templates/shooter/src/render/facade.ts +26 -68
- package/templates/shooter/src/render/gpuSky.ts +752 -0
- package/templates/shooter/src/render/lighting.ts +27 -4
- package/templates/shooter/src/render/materialAssignments.ts +9 -1
- package/templates/shooter/src/render/materialLighting.ts +2 -11
- package/templates/shooter/src/render/occlusion.ts +13 -4
- package/templates/shooter/src/render/palette.ts +1 -0
- package/templates/shooter/src/render/postprocessing.ts +4 -4
- package/templates/shooter/src/render/quality.ts +50 -108
- package/templates/shooter/src/render/scale.ts +0 -11
- package/templates/shooter/src/render/sky.ts +103 -2
- package/templates/shooter/src/render/surface.ts +140 -0
- package/templates/shooter/src/render/town.ts +3 -6
- package/templates/shooter/src/render/townMaterials.ts +95 -42
- package/templates/shooter/src/render/vehicles.ts +2 -0
- package/templates/shooter/src/scenes/Play.ts +83 -23
- package/templates/shooter/src/ui/Hud.tsx +268 -193
- package/templates/shooter/src/worker-page.ts +29 -0
- package/templates/shooter/src/worker.ts +5 -0
- package/templates/shooter/threenative.config.ts +3 -0
- package/templates/shooter/vite.config.ts +2 -0
- package/templates/snow/.codex/config.toml +6 -2
- package/templates/snow/.cursor/mcp.json +8 -2
- package/templates/snow/.gemini/settings.json +8 -2
- package/templates/snow/.mcp.json +8 -2
- package/templates/snow/.vscode/mcp.json +9 -2
- package/templates/snow/.zed/settings.json +9 -2
- package/templates/snow/AGENTS.md +12 -10
- package/templates/snow/CLAUDE.md +12 -10
- package/templates/snow/opencode.json +10 -2
- package/templates/snow/package.json +15 -10
- package/templates/snow/playtests/performance.playtest.json +1 -1
- package/templates/snow/src/render/backlightMaterial.ts +49 -18
- package/templates/snow/src/render/exposure.ts +17 -106
- package/templates/snow/src/render/materialLighting.ts +2 -11
- package/templates/snow/src/render/postprocessing.ts +11 -5
- package/templates/snow/src/render/quality.ts +46 -126
- package/templates/snow/src/render/snowSurface.ts +32 -15
- package/templates/snow/src/scenes/Snow.ts +2 -1
- package/templates/starter/.codex/config.toml +6 -2
- package/templates/starter/.cursor/mcp.json +8 -2
- package/templates/starter/.gemini/settings.json +8 -2
- package/templates/starter/.mcp.json +8 -2
- package/templates/starter/.vscode/mcp.json +9 -2
- package/templates/starter/.zed/settings.json +9 -2
- package/templates/starter/AGENTS.md +18 -14
- package/templates/starter/CLAUDE.md +18 -14
- package/templates/starter/index.html +1 -1
- package/templates/starter/main.html +12 -0
- package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
- package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
- package/templates/starter/opencode.json +10 -2
- package/templates/starter/package.json +15 -10
- package/templates/starter/playtests/play.playtest.json +22 -2
- package/templates/starter/playtests/production-readiness.playtest.json +14 -0
- package/templates/starter/src/entities/Crate.ts +19 -1
- package/templates/starter/src/render/arena.ts +2 -2
- package/templates/starter/src/render/atmosphere.ts +444 -0
- package/templates/starter/src/render/backlightMaterial.ts +49 -18
- package/templates/starter/src/render/camera.ts +28 -0
- package/templates/starter/src/render/clouds.ts +605 -0
- package/templates/starter/src/render/contactShadow.ts +50 -0
- package/templates/starter/src/render/exposure.ts +9 -111
- package/templates/starter/src/render/gpuSky.ts +752 -0
- package/templates/starter/src/render/grade.ts +1 -1
- package/templates/starter/src/render/lighting.ts +34 -6
- package/templates/starter/src/render/materialLighting.ts +2 -11
- package/templates/starter/src/render/postprocessing.ts +27 -14
- package/templates/starter/src/render/quality.ts +18 -147
- package/templates/starter/src/render/sky.ts +90 -40
- package/templates/starter/src/render/temporalAA.ts +1 -1
- package/templates/starter/src/render/temporalAAStage.ts +1 -1
- package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
- package/templates/starter/src/render/temporalDetailStage.ts +106 -0
- package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
- package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
- package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
- package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
- package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
- package/templates/starter/src/scenes/Play.ts +11 -8
- package/templates/starter/src/ui/Hud.tsx +1 -1
- package/templates/starter/src/worker-page.ts +29 -0
- package/templates/starter/src/worker.ts +5 -0
- package/templates/starter/vite.config.ts +2 -0
- package/templates/tower-defense/.codex/config.toml +6 -2
- package/templates/tower-defense/.cursor/mcp.json +8 -2
- package/templates/tower-defense/.gemini/settings.json +8 -2
- package/templates/tower-defense/.mcp.json +8 -2
- package/templates/tower-defense/.vscode/mcp.json +9 -2
- package/templates/tower-defense/.zed/settings.json +9 -2
- package/templates/tower-defense/AGENTS.md +10 -12
- package/templates/tower-defense/CLAUDE.md +10 -12
- package/templates/tower-defense/opencode.json +10 -2
- package/templates/tower-defense/package.json +15 -10
- package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
- package/templates/tower-defense/playtests/performance.playtest.json +1 -1
- package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
- package/templates/tower-defense/src/render/exposure.ts +11 -109
- package/templates/tower-defense/src/render/lighting.ts +4 -2
- package/templates/tower-defense/src/render/materialLighting.ts +2 -11
- package/templates/tower-defense/src/render/postprocessing.ts +4 -4
- package/templates/tower-defense/src/render/quality.ts +10 -116
- package/templates/tower-defense/src/render/sky.ts +2 -2
- package/templates/tower-defense/src/scenes/Battle.ts +4 -0
- package/template-assets/autoExposure.ts +0 -225
- package/template-assets/exposureGraph.ts +0 -178
- package/template-assets/exposureReadback.ts +0 -79
- package/template-assets/worldEnvironment.ts +0 -1212
- package/templates/action-rpg/src/render/autoExposure.ts +0 -225
- package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
- package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
- package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
- package/templates/minimal/src/render/autoExposure.ts +0 -225
- package/templates/minimal/src/render/exposureGraph.ts +0 -178
- package/templates/minimal/src/render/exposureReadback.ts +0 -79
- package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
- package/templates/platformer/src/render/autoExposure.ts +0 -225
- package/templates/platformer/src/render/exposureGraph.ts +0 -178
- package/templates/platformer/src/render/exposureReadback.ts +0 -79
- package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
- package/templates/puzzle/src/render/autoExposure.ts +0 -225
- package/templates/puzzle/src/render/exposureGraph.ts +0 -178
- package/templates/puzzle/src/render/exposureReadback.ts +0 -79
- package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
- package/templates/racing/src/render/autoExposure.ts +0 -225
- package/templates/racing/src/render/exposureGraph.ts +0 -178
- package/templates/racing/src/render/exposureReadback.ts +0 -79
- package/templates/racing/src/render/worldEnvironment.ts +0 -1212
- package/templates/rain/src/render/autoExposure.ts +0 -225
- package/templates/rain/src/render/exposureGraph.ts +0 -178
- package/templates/rain/src/render/exposureReadback.ts +0 -79
- package/templates/rain/src/render/worldEnvironment.ts +0 -1212
- package/templates/rts/src/render/autoExposure.ts +0 -225
- package/templates/rts/src/render/exposureGraph.ts +0 -178
- package/templates/rts/src/render/exposureReadback.ts +0 -79
- package/templates/rts/src/render/worldEnvironment.ts +0 -1212
- package/templates/runner/src/render/autoExposure.ts +0 -225
- package/templates/runner/src/render/exposureGraph.ts +0 -178
- package/templates/runner/src/render/exposureReadback.ts +0 -79
- package/templates/runner/src/render/worldEnvironment.ts +0 -1212
- package/templates/sailing/src/render/autoExposure.ts +0 -225
- package/templates/sailing/src/render/exposureGraph.ts +0 -178
- package/templates/sailing/src/render/exposureReadback.ts +0 -79
- package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
- package/templates/shooter/src/render/autoExposure.ts +0 -225
- package/templates/shooter/src/render/exposureGraph.ts +0 -178
- package/templates/shooter/src/render/exposureReadback.ts +0 -79
- package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
- package/templates/snow/src/render/autoExposure.ts +0 -225
- package/templates/snow/src/render/exposureGraph.ts +0 -178
- package/templates/snow/src/render/exposureReadback.ts +0 -79
- package/templates/snow/src/render/worldEnvironment.ts +0 -1212
- package/templates/starter/src/render/autoExposure.ts +0 -225
- package/templates/starter/src/render/exposureGraph.ts +0 -178
- package/templates/starter/src/render/exposureReadback.ts +0 -79
- package/templates/starter/src/render/worldEnvironment.ts +0 -1212
- package/templates/tower-defense/src/render/autoExposure.ts +0 -225
- package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
- package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
- package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
|
@@ -0,0 +1,408 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
//
|
|
3
|
+
// The mill keep on the headland, and the wooden arrow sign at the path's fork, from primitives: the
|
|
4
|
+
// sandstone walls and the wooden shingle roofs take the photo textures in `assets/` (`tex-*.webp`)
|
|
5
|
+
// (surface.ts); a green sprout in relief over the door, a windmill on the corner tower whose sails
|
|
6
|
+
// turn on the GPU, and the teal flag with the hero's leaf painted in code; the arched doorway glows
|
|
7
|
+
// warm. Every part of one material is merged into one geometry, so the whole keep costs eight draws.
|
|
8
|
+
import {
|
|
9
|
+
BoxGeometry,
|
|
10
|
+
BufferAttribute,
|
|
11
|
+
BufferGeometry,
|
|
12
|
+
CircleGeometry,
|
|
13
|
+
ConeGeometry,
|
|
14
|
+
CylinderGeometry,
|
|
15
|
+
DoubleSide,
|
|
16
|
+
ExtrudeGeometry,
|
|
17
|
+
Group,
|
|
18
|
+
Mesh,
|
|
19
|
+
MeshBasicMaterial,
|
|
20
|
+
MeshStandardMaterial,
|
|
21
|
+
PlaneGeometry,
|
|
22
|
+
Shape,
|
|
23
|
+
TorusGeometry,
|
|
24
|
+
} from "three";
|
|
25
|
+
import { cos, positionLocal, sin, time, vec3 } from "three/tsl";
|
|
26
|
+
import { MeshStandardNodeMaterial } from "three/webgpu";
|
|
27
|
+
import { paintedTexture } from "./materials.js";
|
|
28
|
+
import { C } from "./palette.js";
|
|
29
|
+
import { type ISurfaces, masonryMaterial, texturedMaterial } from "./surface.js";
|
|
30
|
+
|
|
31
|
+
const hex = (color: number): [number, number, number] => [
|
|
32
|
+
((color >> 16) & 255) / 255,
|
|
33
|
+
((color >> 8) & 255) / 255,
|
|
34
|
+
(color & 255) / 255,
|
|
35
|
+
];
|
|
36
|
+
|
|
37
|
+
/** The flag: a teal field and a cream leaf, the hero's own badge. */
|
|
38
|
+
function flagMap(): ReturnType<typeof paintedTexture> {
|
|
39
|
+
const teal = hex(C.cap);
|
|
40
|
+
const cream = hex(C.button);
|
|
41
|
+
return paintedTexture(
|
|
42
|
+
64,
|
|
43
|
+
40,
|
|
44
|
+
(x, y) => {
|
|
45
|
+
const u = (x - 30) / 16;
|
|
46
|
+
const v = (y - 20) / 16;
|
|
47
|
+
const lu = u * 0.8 + v * 0.6;
|
|
48
|
+
const lv = -u * 0.6 + v * 0.8;
|
|
49
|
+
return Math.abs(lu) < 1 && Math.abs(lv) < 0.42 * (1 - lu * lu) ? cream : teal;
|
|
50
|
+
},
|
|
51
|
+
true,
|
|
52
|
+
);
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** UVs from world-aligned planes, `tile` metres per repeat, chosen by each vertex's normal. */
|
|
56
|
+
export function planarUv(geometry: BufferGeometry, tile: number): BufferGeometry {
|
|
57
|
+
const g = geometry.index === null ? geometry : geometry.toNonIndexed();
|
|
58
|
+
const position = g.attributes.position;
|
|
59
|
+
const normal = g.attributes.normal;
|
|
60
|
+
const count = position?.count ?? 0;
|
|
61
|
+
const uv = new Float32Array(count * 2);
|
|
62
|
+
for (let i = 0; i < count; i += 1) {
|
|
63
|
+
const x = position?.getX(i) ?? 0;
|
|
64
|
+
const y = position?.getY(i) ?? 0;
|
|
65
|
+
const z = position?.getZ(i) ?? 0;
|
|
66
|
+
const nx = Math.abs(normal?.getX(i) ?? 0);
|
|
67
|
+
const ny = Math.abs(normal?.getY(i) ?? 0);
|
|
68
|
+
const nz = Math.abs(normal?.getZ(i) ?? 0);
|
|
69
|
+
const [u, v] = ny > nx && ny > nz ? [x, z] : nx > nz ? [z, y] : [x, y];
|
|
70
|
+
uv.set([u / tile, v / tile], i * 2);
|
|
71
|
+
}
|
|
72
|
+
g.setAttribute("uv", new BufferAttribute(uv, 2));
|
|
73
|
+
return g;
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/** UVs wrapped round a cylinder or cone about its own axis, `tile` metres per repeat. */
|
|
77
|
+
export function wrapUv(geometry: BufferGeometry, radius: number, tile: number): BufferGeometry {
|
|
78
|
+
const uv = geometry.attributes.uv;
|
|
79
|
+
const position = geometry.attributes.position;
|
|
80
|
+
for (let i = 0; i < (uv?.count ?? 0); i += 1) {
|
|
81
|
+
uv?.setXY(
|
|
82
|
+
i,
|
|
83
|
+
((uv.getX(i) ?? 0) * Math.PI * 2 * radius) / tile,
|
|
84
|
+
(position?.getY(i) ?? 0) / tile,
|
|
85
|
+
);
|
|
86
|
+
}
|
|
87
|
+
return geometry.index === null ? geometry : geometry.toNonIndexed();
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
/** One geometry from many non-indexed parts that share position, normal and uv (and color, if all have it). */
|
|
91
|
+
function merge(parts: readonly BufferGeometry[]): BufferGeometry {
|
|
92
|
+
const merged = new BufferGeometry();
|
|
93
|
+
for (const name of ["position", "normal", "uv", "color"]) {
|
|
94
|
+
if (!parts.every((part) => part.attributes[name] !== undefined)) continue;
|
|
95
|
+
const size = parts[0]?.attributes[name]?.itemSize ?? 3;
|
|
96
|
+
const total = parts.reduce((sum, part) => sum + (part.attributes[name]?.count ?? 0), 0);
|
|
97
|
+
const data = new Float32Array(total * size);
|
|
98
|
+
let offset = 0;
|
|
99
|
+
for (const part of parts) {
|
|
100
|
+
const attribute = part.attributes[name];
|
|
101
|
+
if (attribute === undefined) continue;
|
|
102
|
+
for (let i = 0; i < attribute.count; i += 1) {
|
|
103
|
+
for (let c = 0; c < size; c += 1)
|
|
104
|
+
data[(offset + i) * size + c] = attribute.getComponent(i, c);
|
|
105
|
+
}
|
|
106
|
+
offset += attribute.count;
|
|
107
|
+
}
|
|
108
|
+
merged.setAttribute(name, new BufferAttribute(data, size));
|
|
109
|
+
}
|
|
110
|
+
return merged;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/** The windmill tower: x, z, radius, wall top, cap height, sail length from the hub. */
|
|
114
|
+
const MILL = { x: -12.5, z: -2.5, radius: 3.2, top: 13, cap: 3.5, sail: 7 } as const;
|
|
115
|
+
|
|
116
|
+
const box = (x0: number, y0: number, z0: number, x1: number, y1: number, z1: number) =>
|
|
117
|
+
new BoxGeometry(x1 - x0, y1 - y0, z1 - z0).translate((x0 + x1) / 2, (y0 + y1) / 2, (z0 + z1) / 2);
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* A gable roof as one prism: ridge along X (or along Z with `alongZ`), eaves at `y0`, ridge at `y1`,
|
|
121
|
+
* over the footprint [x0, x1] x [z0, z1]. Returns the two sloped planes and the two gable ends.
|
|
122
|
+
*/
|
|
123
|
+
function gable(
|
|
124
|
+
x0: number,
|
|
125
|
+
x1: number,
|
|
126
|
+
z0: number,
|
|
127
|
+
z1: number,
|
|
128
|
+
y0: number,
|
|
129
|
+
y1: number,
|
|
130
|
+
alongZ = false,
|
|
131
|
+
): { slopes: BufferGeometry; ends: BufferGeometry } {
|
|
132
|
+
const quad = (a: number[], b: number[], c: number[], d: number[]) => [
|
|
133
|
+
...a,
|
|
134
|
+
...b,
|
|
135
|
+
...c,
|
|
136
|
+
...a,
|
|
137
|
+
...c,
|
|
138
|
+
...d,
|
|
139
|
+
];
|
|
140
|
+
const s = (p: number[]): number[] => (alongZ ? [p[2] ?? 0, p[1] ?? 0, p[0] ?? 0] : p);
|
|
141
|
+
// Built along X, then swizzled: [x, y, z] -> [z, y, x] when the ridge runs along Z.
|
|
142
|
+
const [a0, a1, b0, b1] = alongZ ? [z0, z1, x0, x1] : [x0, x1, z0, z1];
|
|
143
|
+
const mid = (b0 + b1) / 2;
|
|
144
|
+
const slopes = new BufferGeometry();
|
|
145
|
+
slopes.setAttribute(
|
|
146
|
+
"position",
|
|
147
|
+
new BufferAttribute(
|
|
148
|
+
new Float32Array([
|
|
149
|
+
...quad(s([a0, y0, b1]), s([a1, y0, b1]), s([a1, y1, mid]), s([a0, y1, mid])),
|
|
150
|
+
...quad(s([a1, y0, b0]), s([a0, y0, b0]), s([a0, y1, mid]), s([a1, y1, mid])),
|
|
151
|
+
]),
|
|
152
|
+
3,
|
|
153
|
+
),
|
|
154
|
+
);
|
|
155
|
+
const ends = new BufferGeometry();
|
|
156
|
+
ends.setAttribute(
|
|
157
|
+
"position",
|
|
158
|
+
new BufferAttribute(
|
|
159
|
+
new Float32Array([
|
|
160
|
+
...s([a0, y0, b0]),
|
|
161
|
+
...s([a0, y0, b1]),
|
|
162
|
+
...s([a0, y1, mid]),
|
|
163
|
+
...s([a1, y0, b1]),
|
|
164
|
+
...s([a1, y0, b0]),
|
|
165
|
+
...s([a1, y1, mid]),
|
|
166
|
+
]),
|
|
167
|
+
3,
|
|
168
|
+
),
|
|
169
|
+
);
|
|
170
|
+
for (const g of [slopes, ends]) g.computeVertexNormals();
|
|
171
|
+
// Mirrored swizzle flips the winding; flip it back so the faces point out.
|
|
172
|
+
if (alongZ) {
|
|
173
|
+
for (const g of [slopes, ends]) {
|
|
174
|
+
const p = g.attributes.position;
|
|
175
|
+
for (let i = 0; i < (p?.count ?? 0); i += 3) {
|
|
176
|
+
if (p === undefined) continue;
|
|
177
|
+
const [x, y, z] = [p.getX(i + 1), p.getY(i + 1), p.getZ(i + 1)];
|
|
178
|
+
p.setXYZ(i + 1, p.getX(i + 2), p.getY(i + 2), p.getZ(i + 2));
|
|
179
|
+
p.setXYZ(i + 2, x, y, z);
|
|
180
|
+
}
|
|
181
|
+
g.computeVertexNormals();
|
|
182
|
+
}
|
|
183
|
+
}
|
|
184
|
+
return { ends, slopes };
|
|
185
|
+
}
|
|
186
|
+
|
|
187
|
+
/** An arch panel (a rectangle under a half disc), facing +Z, its base centre at the origin. */
|
|
188
|
+
function archPanel(width: number, height: number): BufferGeometry {
|
|
189
|
+
const radius = width / 2;
|
|
190
|
+
// Subdivided: `glow` paints per vertex, and a one-quad panel has vertices only at the jambs.
|
|
191
|
+
const rect = new PlaneGeometry(width, height - radius, 8, 6).translate(
|
|
192
|
+
0,
|
|
193
|
+
(height - radius) / 2,
|
|
194
|
+
0,
|
|
195
|
+
);
|
|
196
|
+
const top = new CircleGeometry(radius, 16, 0, Math.PI).translate(0, height - radius, 0);
|
|
197
|
+
return merge([rect.toNonIndexed(), top.toNonIndexed()]);
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/**
|
|
201
|
+
* Warm light inside a doorway or window: unlit vertex colours, bright at the floor's centre and
|
|
202
|
+
* dark at the jambs, a deep amber just above 1 so the lit room reads warm behind the arch in full
|
|
203
|
+
* sun (a brighter glow tone-maps to a flat cream).
|
|
204
|
+
*/
|
|
205
|
+
function glow(geometry: BufferGeometry, width: number): BufferGeometry {
|
|
206
|
+
const position = geometry.attributes.position;
|
|
207
|
+
const colors = new Float32Array((position?.count ?? 0) * 3);
|
|
208
|
+
for (let i = 0; i < (position?.count ?? 0); i += 1) {
|
|
209
|
+
const x = (position?.getX(i) ?? 0) / (width / 2);
|
|
210
|
+
const y = position?.getY(i) ?? 0;
|
|
211
|
+
const k = Math.max(
|
|
212
|
+
0.12,
|
|
213
|
+
(1 - 0.8 * Math.min(1, Math.abs(x))) * (1 - 0.8 * Math.min(1, y / (width * 1.6))),
|
|
214
|
+
);
|
|
215
|
+
colors.set([1.5 * k, 0.68 * k, 0.22 * k], i * 3);
|
|
216
|
+
}
|
|
217
|
+
geometry.setAttribute("color", new BufferAttribute(colors, 3));
|
|
218
|
+
return geometry;
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
/** A pointed leaf in the XY plane, its stalk at the origin, `length` along +Y, `depth` deep along +Z. */
|
|
222
|
+
function leaf(length: number, depth: number): BufferGeometry {
|
|
223
|
+
const w = length * 0.36;
|
|
224
|
+
const outline = new Shape()
|
|
225
|
+
.moveTo(0, 0)
|
|
226
|
+
.quadraticCurveTo(w, length * 0.45, 0, length)
|
|
227
|
+
.quadraticCurveTo(-w, length * 0.45, 0, 0);
|
|
228
|
+
return new ExtrudeGeometry(outline, { bevelEnabled: false, curveSegments: 8, depth });
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
/**
|
|
232
|
+
* The keep, its origin at the foot of its front door, facing +Z: a hall with a gable roof, a gabled
|
|
233
|
+
* gatehouse with a sprout in relief over the door, a windmill on the corner tower with the flag on
|
|
234
|
+
* its cap, and a small back turret. `stone` is solid; the roofs, sails, relief and flag are not.
|
|
235
|
+
*/
|
|
236
|
+
export function buildCastle(s: ISurfaces, footY: number): { group: Group; stone: Mesh } {
|
|
237
|
+
const group = new Group();
|
|
238
|
+
group.name = "castle";
|
|
239
|
+
const stoneParts: BufferGeometry[] = [];
|
|
240
|
+
const roofParts: BufferGeometry[] = [];
|
|
241
|
+
const glowParts: BufferGeometry[] = [];
|
|
242
|
+
const addStone = (g: BufferGeometry) => stoneParts.push(planarUv(g, 4));
|
|
243
|
+
|
|
244
|
+
// Hall, gatehouse and the gatehouse's gable wall, sunk a metre so no seam shows on a slope.
|
|
245
|
+
addStone(box(-11, -1, -12, 11, 9, -2));
|
|
246
|
+
addStone(box(-4.5, -1, -3, 4.5, 13, 0));
|
|
247
|
+
const hallRoof = gable(-11, 11, -12.6, -1.4, 9, 14);
|
|
248
|
+
roofParts.push(planarUv(hallRoof.slopes, 2.5));
|
|
249
|
+
addStone(hallRoof.ends);
|
|
250
|
+
const gateRoof = gable(-5.1, 5.1, -3.2, 0, 13, 17, true);
|
|
251
|
+
roofParts.push(planarUv(gateRoof.slopes, 2.5));
|
|
252
|
+
addStone(gateRoof.ends);
|
|
253
|
+
// A plinth course and a string course: two stone bands that read as weight and as storeys.
|
|
254
|
+
addStone(box(-11.3, -1, -12.3, 11.3, 0.6, -1.7));
|
|
255
|
+
addStone(box(-4.8, 8.6, -3.3, 4.8, 9.1, 0.3));
|
|
256
|
+
// Towers: x, z, radius, wall top, roof height. The first is the windmill: a low cap, sails in front.
|
|
257
|
+
for (const [x, z, radius, top, roof] of [
|
|
258
|
+
[MILL.x, MILL.z, MILL.radius, MILL.top, MILL.cap],
|
|
259
|
+
[11.5, -11.5, 2.4, 13, 6],
|
|
260
|
+
] as const) {
|
|
261
|
+
stoneParts.push(
|
|
262
|
+
wrapUv(
|
|
263
|
+
new CylinderGeometry(radius, radius * 1.08, top + 1, 20, 1, true).translate(
|
|
264
|
+
0,
|
|
265
|
+
(top - 1) / 2,
|
|
266
|
+
0,
|
|
267
|
+
),
|
|
268
|
+
radius,
|
|
269
|
+
4,
|
|
270
|
+
).translate(x, 0, z),
|
|
271
|
+
);
|
|
272
|
+
stoneParts.push(
|
|
273
|
+
wrapUv(
|
|
274
|
+
new CylinderGeometry(radius + 0.35, radius + 0.35, 0.6, 20).translate(0, top - 0.3, 0),
|
|
275
|
+
radius,
|
|
276
|
+
4,
|
|
277
|
+
).translate(x, 0, z),
|
|
278
|
+
);
|
|
279
|
+
roofParts.push(
|
|
280
|
+
wrapUv(
|
|
281
|
+
new ConeGeometry(radius + 0.6, roof, 20, 1, true).translate(0, top + roof / 2, 0),
|
|
282
|
+
radius,
|
|
283
|
+
2.5,
|
|
284
|
+
).translate(x, 0, z),
|
|
285
|
+
);
|
|
286
|
+
glowParts.push(glow(archPanel(0.9, 1.8), 0.9).translate(x, top - 5, z + radius + 0.06));
|
|
287
|
+
}
|
|
288
|
+
// The arched door with its stone voussoirs, and the windows of the hall.
|
|
289
|
+
glowParts.push(glow(archPanel(3.6, 4.6), 3.6).translate(0, 0, 0.03));
|
|
290
|
+
stoneParts.push(
|
|
291
|
+
planarUv(new TorusGeometry(1.95, 0.32, 6, 16, Math.PI).translate(0, 2.8, 0.05), 4),
|
|
292
|
+
);
|
|
293
|
+
for (const x of [-8.5, -6, 6, 8.5]) {
|
|
294
|
+
glowParts.push(glow(archPanel(1.2, 2.4), 1.2).translate(x, 3, -1.97));
|
|
295
|
+
stoneParts.push(planarUv(box(x - 0.8, 2.75, -1.95, x + 0.8, 3, -1.6), 4));
|
|
296
|
+
}
|
|
297
|
+
|
|
298
|
+
const stone = new Mesh(merge(stoneParts), masonryMaterial(s, footY));
|
|
299
|
+
stone.name = "castle-stone";
|
|
300
|
+
const wood = texturedMaterial(s, "planks", { doubleSided: true });
|
|
301
|
+
const roofs = new Mesh(merge(roofParts), wood);
|
|
302
|
+
const light = new Mesh(merge(glowParts), new MeshBasicMaterial({ vertexColors: true }));
|
|
303
|
+
// The sprout over the door: a stem and two leaves standing proud of the gable wall.
|
|
304
|
+
const sproutParts = [
|
|
305
|
+
new BoxGeometry(0.3, 2.4, 0.22).translate(0, 10.4, 0.11).toNonIndexed(),
|
|
306
|
+
leaf(2.6, 0.24).rotateZ(0.75).translate(0, 11, 0),
|
|
307
|
+
leaf(2.3, 0.24).rotateZ(-0.7).translate(0, 10.6, 0),
|
|
308
|
+
];
|
|
309
|
+
const sprout = new Mesh(
|
|
310
|
+
merge(sproutParts),
|
|
311
|
+
new MeshStandardMaterial({ color: C.leaf, roughness: 0.6 }),
|
|
312
|
+
);
|
|
313
|
+
// The sails: four lattice arms on a hub before the tower, turned about the hub's axis on the GPU.
|
|
314
|
+
const spin = time.mul(0.45);
|
|
315
|
+
const turned = vec3(
|
|
316
|
+
positionLocal.x.mul(cos(spin)).sub(positionLocal.y.mul(sin(spin))),
|
|
317
|
+
positionLocal.x.mul(sin(spin)).add(positionLocal.y.mul(cos(spin))),
|
|
318
|
+
positionLocal.z,
|
|
319
|
+
);
|
|
320
|
+
const spars: BufferGeometry[] = [
|
|
321
|
+
planarUv(new CylinderGeometry(0.55, 0.55, 1.2, 10).rotateX(Math.PI / 2), 2),
|
|
322
|
+
];
|
|
323
|
+
const cloth: BufferGeometry[] = [];
|
|
324
|
+
for (let arm = 0; arm < 4; arm += 1) {
|
|
325
|
+
const a = (arm * Math.PI) / 2;
|
|
326
|
+
spars.push(planarUv(box(-0.14, 0.4, 0.4, 0.14, MILL.sail, 0.62), 2).rotateZ(a));
|
|
327
|
+
cloth.push(planarUv(box(0.14, 1.5, 0.5, 1.6, MILL.sail - 0.3, 0.56), 2).rotateZ(a));
|
|
328
|
+
}
|
|
329
|
+
const sparMaterial = new MeshStandardNodeMaterial({ map: wood.map, roughness: 0.85 });
|
|
330
|
+
sparMaterial.colorNode = wood.colorNode;
|
|
331
|
+
sparMaterial.positionNode = turned;
|
|
332
|
+
const clothMaterial = new MeshStandardNodeMaterial({
|
|
333
|
+
color: C.button,
|
|
334
|
+
roughness: 0.9,
|
|
335
|
+
side: DoubleSide,
|
|
336
|
+
});
|
|
337
|
+
clothMaterial.positionNode = turned;
|
|
338
|
+
const hub = [MILL.x, MILL.top + 0.4, MILL.z + MILL.radius + 0.7] as const;
|
|
339
|
+
const sails = new Group();
|
|
340
|
+
sails.name = "mill-sails";
|
|
341
|
+
sails.position.set(...hub);
|
|
342
|
+
sails.add(new Mesh(merge(spars), sparMaterial), new Mesh(merge(cloth), clothMaterial));
|
|
343
|
+
for (const mesh of [stone, roofs, sprout, ...(sails.children as Mesh[])]) {
|
|
344
|
+
mesh.castShadow = true;
|
|
345
|
+
mesh.receiveShadow = true;
|
|
346
|
+
}
|
|
347
|
+
group.add(stone, roofs, light, sprout, sails);
|
|
348
|
+
|
|
349
|
+
// The flag on the windmill's cap, waving from the pole.
|
|
350
|
+
const capTop = MILL.top + MILL.cap;
|
|
351
|
+
const pole = new Mesh(
|
|
352
|
+
new CylinderGeometry(0.07, 0.09, 4, 6).translate(MILL.x, capTop + 1.5, MILL.z),
|
|
353
|
+
wood,
|
|
354
|
+
);
|
|
355
|
+
pole.castShadow = true;
|
|
356
|
+
const flagMaterial = new MeshStandardNodeMaterial({
|
|
357
|
+
map: flagMap(),
|
|
358
|
+
roughness: 0.8,
|
|
359
|
+
side: DoubleSide,
|
|
360
|
+
});
|
|
361
|
+
const along = positionLocal.x.add(1.25).max(0);
|
|
362
|
+
flagMaterial.positionNode = positionLocal.add(
|
|
363
|
+
vec3(
|
|
364
|
+
0,
|
|
365
|
+
sin(time.mul(3.1).add(along.mul(2.2)))
|
|
366
|
+
.mul(along)
|
|
367
|
+
.mul(0.06),
|
|
368
|
+
sin(time.mul(4).add(along.mul(2.6)))
|
|
369
|
+
.mul(along)
|
|
370
|
+
.mul(0.22),
|
|
371
|
+
),
|
|
372
|
+
);
|
|
373
|
+
const flag = new Mesh(new PlaneGeometry(2.5, 1.55, 10, 4), flagMaterial);
|
|
374
|
+
flag.position.set(MILL.x + 1.3, capTop + 2.6, MILL.z);
|
|
375
|
+
flag.castShadow = true;
|
|
376
|
+
group.add(pole, flag);
|
|
377
|
+
return { group, stone };
|
|
378
|
+
}
|
|
379
|
+
|
|
380
|
+
/** A wooden arrow sign on a post, its origin at the post's foot, pointing along +X. */
|
|
381
|
+
export function buildSignpost(s: ISurfaces): Group {
|
|
382
|
+
const sign = new Group();
|
|
383
|
+
sign.name = "signpost";
|
|
384
|
+
const wood = texturedMaterial(s, "planks");
|
|
385
|
+
// Planar UVs at 2 m a tile: the board shows a plank and a half with its grain along the arrow.
|
|
386
|
+
const post = new Mesh(planarUv(new BoxGeometry(0.16, 1.5, 0.16).translate(0, 0.75, 0), 2), wood);
|
|
387
|
+
const board = new Mesh(
|
|
388
|
+
planarUv(new BoxGeometry(1.1, 0.34, 0.07).translate(0.45, 1.25, 0.1), 2),
|
|
389
|
+
wood,
|
|
390
|
+
);
|
|
391
|
+
// The arrow's head: a wedge as wide as the board is tall plus a lip, so it reads at 10 m.
|
|
392
|
+
const tip = new Mesh(
|
|
393
|
+
planarUv(
|
|
394
|
+
new CylinderGeometry(0.3, 0.3, 0.07, 3)
|
|
395
|
+
.rotateX(Math.PI / 2)
|
|
396
|
+
.rotateZ(-Math.PI / 2)
|
|
397
|
+
.translate(1.12, 1.25, 0.1),
|
|
398
|
+
2,
|
|
399
|
+
),
|
|
400
|
+
wood,
|
|
401
|
+
);
|
|
402
|
+
for (const mesh of [post, board, tip]) {
|
|
403
|
+
mesh.castShadow = true;
|
|
404
|
+
mesh.receiveShadow = true;
|
|
405
|
+
sign.add(mesh);
|
|
406
|
+
}
|
|
407
|
+
return sign;
|
|
408
|
+
}
|
|
@@ -0,0 +1,284 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js TSL — edit or delete it freely.
|
|
2
|
+
//
|
|
3
|
+
// The moveset's feedback: dust under the feet, rings on landings, sparkles on pickups, flashes on
|
|
4
|
+
// impacts, pollen on the breeze. Four pooled emitters cover every effect. `GPUParticles3D` (built in `scenes/Play.ts`) owns the slots, the
|
|
5
|
+
// dispatch, the birth stamps and the culling. Every look choice is this file's: life, drag,
|
|
6
|
+
// gravity, size, colour, blend and sprite mask. A burst passes its shape as the request's
|
|
7
|
+
// `direction`: x is the outward speed, y the upward speed, and z the radius it starts in.
|
|
8
|
+
import {
|
|
9
|
+
Fn,
|
|
10
|
+
If,
|
|
11
|
+
abs,
|
|
12
|
+
cos,
|
|
13
|
+
exp,
|
|
14
|
+
float,
|
|
15
|
+
hash,
|
|
16
|
+
instanceIndex,
|
|
17
|
+
mix,
|
|
18
|
+
sin,
|
|
19
|
+
smoothstep,
|
|
20
|
+
step,
|
|
21
|
+
time,
|
|
22
|
+
uint,
|
|
23
|
+
uv,
|
|
24
|
+
varying,
|
|
25
|
+
vec3,
|
|
26
|
+
vec4,
|
|
27
|
+
} from "three/tsl";
|
|
28
|
+
import {
|
|
29
|
+
AdditiveBlending,
|
|
30
|
+
type ComputeNode,
|
|
31
|
+
type Node,
|
|
32
|
+
NormalBlending,
|
|
33
|
+
SpriteNodeMaterial,
|
|
34
|
+
type StorageBufferNode,
|
|
35
|
+
type UniformNode,
|
|
36
|
+
type Vector3,
|
|
37
|
+
} from "three/webgpu";
|
|
38
|
+
|
|
39
|
+
export interface IEffectBuffers {
|
|
40
|
+
readonly positions: StorageBufferNode<"vec3">;
|
|
41
|
+
readonly velocities: StorageBufferNode<"vec3">;
|
|
42
|
+
readonly births: StorageBufferNode<"float">;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
export interface IEffectRequest {
|
|
46
|
+
readonly first: UniformNode<"uint", number>;
|
|
47
|
+
readonly count: UniformNode<"uint", number>;
|
|
48
|
+
readonly origin: UniformNode<"vec3", Vector3>;
|
|
49
|
+
readonly direction: UniformNode<"vec3", Vector3>;
|
|
50
|
+
readonly seed: UniformNode<"float", number>;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
export interface IEffectOptions {
|
|
54
|
+
readonly amount: number;
|
|
55
|
+
readonly lifetime: number;
|
|
56
|
+
readonly material: SpriteNodeMaterial;
|
|
57
|
+
readonly spawn: (buffers: IEffectBuffers, request: IEffectRequest) => ComputeNode;
|
|
58
|
+
readonly process: (
|
|
59
|
+
buffers: IEffectBuffers,
|
|
60
|
+
runtime: { readonly time: Node<"float">; readonly delta: Node<"float"> },
|
|
61
|
+
) => ComputeNode;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
interface IRecipe {
|
|
65
|
+
readonly amount: number;
|
|
66
|
+
/** Seconds a particle lives. */
|
|
67
|
+
readonly life: number;
|
|
68
|
+
/** Fraction of speed lost per second, as an exponential rate. */
|
|
69
|
+
readonly drag: number;
|
|
70
|
+
/** Metres per second squared on y: negative falls, positive rises like warm dust. */
|
|
71
|
+
readonly gravity: number;
|
|
72
|
+
/** Sprite size in metres at birth and at death. */
|
|
73
|
+
readonly size: readonly [number, number];
|
|
74
|
+
/** Linear colour at birth and at death. */
|
|
75
|
+
readonly colour: readonly [readonly [number, number, number], readonly [number, number, number]];
|
|
76
|
+
readonly opacity: number;
|
|
77
|
+
readonly additive: boolean;
|
|
78
|
+
readonly mask: "puff" | "star";
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
const TAU = Math.PI * 2;
|
|
82
|
+
|
|
83
|
+
/** A soft round puff, or a four-point star with a soft core: no texture, no download. */
|
|
84
|
+
function sprite(mask: IRecipe["mask"]) {
|
|
85
|
+
const point = uv().sub(0.5);
|
|
86
|
+
const round = float(1).sub(smoothstep(0.05, 0.5, point.length()));
|
|
87
|
+
if (mask === "puff") return round.mul(round);
|
|
88
|
+
const ray = float(1)
|
|
89
|
+
.sub(smoothstep(0.02, 0.07, abs(point.x)))
|
|
90
|
+
.max(float(1).sub(smoothstep(0.02, 0.07, abs(point.y))))
|
|
91
|
+
.mul(float(1).sub(smoothstep(0.1, 0.5, point.length())));
|
|
92
|
+
return round.mul(round).max(ray);
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
function emitter(recipe: IRecipe): IEffectOptions {
|
|
96
|
+
const material = new SpriteNodeMaterial({
|
|
97
|
+
blending: recipe.additive ? AdditiveBlending : NormalBlending,
|
|
98
|
+
depthWrite: false,
|
|
99
|
+
transparent: true,
|
|
100
|
+
});
|
|
101
|
+
// The quad's empty corners write nothing to the depth and normal buffers, so AO skips them.
|
|
102
|
+
material.alphaTest = 0.02;
|
|
103
|
+
const [birth, death] = recipe.colour;
|
|
104
|
+
// The material reads the birth stamp the engine writes, so it binds once the buffer exists.
|
|
105
|
+
const bind = (born: Node<"float">): void => {
|
|
106
|
+
const age = time.sub(born);
|
|
107
|
+
const alive = varying(step(0, age).mul(step(age, recipe.life)));
|
|
108
|
+
const phase = varying(age.div(recipe.life).clamp(0, 1));
|
|
109
|
+
const jitter = hash(instanceIndex.add(7)).mul(0.6).add(0.7);
|
|
110
|
+
material.scaleNode = mix(float(recipe.size[0]), float(recipe.size[1]), phase)
|
|
111
|
+
.mul(jitter)
|
|
112
|
+
.mul(alive);
|
|
113
|
+
material.colorNode = vec4(
|
|
114
|
+
mix(vec3(...birth), vec3(...death), phase),
|
|
115
|
+
sprite(recipe.mask)
|
|
116
|
+
.mul(float(1).sub(smoothstep(0.55, 1, phase)))
|
|
117
|
+
.mul(recipe.opacity)
|
|
118
|
+
.mul(alive),
|
|
119
|
+
);
|
|
120
|
+
};
|
|
121
|
+
const spawn = (
|
|
122
|
+
{ positions, velocities, births }: IEffectBuffers,
|
|
123
|
+
request: IEffectRequest,
|
|
124
|
+
): ComputeNode => {
|
|
125
|
+
bind(births.toAttribute());
|
|
126
|
+
return Fn(() => {
|
|
127
|
+
If(instanceIndex.lessThan(request.count), () => {
|
|
128
|
+
const slot = request.first.add(instanceIndex).mod(uint(recipe.amount));
|
|
129
|
+
const key = instanceIndex.add(request.seed.mul(977).toUint());
|
|
130
|
+
const r = (salt: number) => hash(key.add(salt));
|
|
131
|
+
const angle = r(1).mul(TAU);
|
|
132
|
+
const radius = r(2).sqrt().mul(request.direction.z);
|
|
133
|
+
const out = request.direction.x.mul(r(3).mul(0.6).add(0.5));
|
|
134
|
+
positions
|
|
135
|
+
.element(slot)
|
|
136
|
+
.assign(
|
|
137
|
+
request.origin.add(
|
|
138
|
+
vec3(cos(angle).mul(radius), r(4).mul(0.12), sin(angle).mul(radius)),
|
|
139
|
+
),
|
|
140
|
+
);
|
|
141
|
+
velocities
|
|
142
|
+
.element(slot)
|
|
143
|
+
.assign(
|
|
144
|
+
vec3(
|
|
145
|
+
cos(angle).mul(out),
|
|
146
|
+
request.direction.y.mul(r(5).mul(0.8).add(0.6)),
|
|
147
|
+
sin(angle).mul(out),
|
|
148
|
+
),
|
|
149
|
+
);
|
|
150
|
+
});
|
|
151
|
+
})().compute(recipe.amount);
|
|
152
|
+
};
|
|
153
|
+
const process = (
|
|
154
|
+
{ positions, velocities, births }: IEffectBuffers,
|
|
155
|
+
runtime: { readonly time: Node<"float">; readonly delta: Node<"float"> },
|
|
156
|
+
): ComputeNode =>
|
|
157
|
+
Fn(() => {
|
|
158
|
+
const age = runtime.time.sub(births.element(instanceIndex));
|
|
159
|
+
If(age.greaterThanEqual(0).and(age.lessThan(recipe.life)), () => {
|
|
160
|
+
const velocity = velocities
|
|
161
|
+
.element(instanceIndex)
|
|
162
|
+
.mul(exp(float(-recipe.drag).mul(runtime.delta)))
|
|
163
|
+
.add(vec3(0, recipe.gravity, 0).mul(runtime.delta));
|
|
164
|
+
velocities.element(instanceIndex).assign(velocity);
|
|
165
|
+
positions.element(instanceIndex).addAssign(velocity.mul(runtime.delta));
|
|
166
|
+
});
|
|
167
|
+
})().compute(recipe.amount);
|
|
168
|
+
return { amount: recipe.amount, lifetime: recipe.life, material, process, spawn };
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
/** Warm cream dust that billows, slows and drifts up: run puffs, landings, skids, poofs. */
|
|
172
|
+
export function dustEffect(): IEffectOptions {
|
|
173
|
+
return emitter({
|
|
174
|
+
additive: false,
|
|
175
|
+
amount: 768,
|
|
176
|
+
colour: [
|
|
177
|
+
[0.72, 0.64, 0.5],
|
|
178
|
+
[0.92, 0.9, 0.85],
|
|
179
|
+
],
|
|
180
|
+
drag: 4,
|
|
181
|
+
gravity: 0.8,
|
|
182
|
+
life: 0.9,
|
|
183
|
+
mask: "puff",
|
|
184
|
+
// Light enough that the shoes read through a run's trail of puffs.
|
|
185
|
+
opacity: 0.55,
|
|
186
|
+
size: [0.41, 1.12],
|
|
187
|
+
});
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
/** Hot white-to-amber flashes that burst wide and die fast: wall-kick sparks, the ground-pound ring. */
|
|
191
|
+
export function flashEffect(): IEffectOptions {
|
|
192
|
+
return emitter({
|
|
193
|
+
additive: true,
|
|
194
|
+
amount: 256,
|
|
195
|
+
// Warm, not white: overlapping additive stars brighter than this read as one glowing slab.
|
|
196
|
+
colour: [
|
|
197
|
+
[1.2, 0.9, 0.45],
|
|
198
|
+
[0.8, 0.28, 0.04],
|
|
199
|
+
],
|
|
200
|
+
drag: 3.5,
|
|
201
|
+
gravity: -2,
|
|
202
|
+
// 0.9 s, as long as a dust puff, so a kick's sparks still trail the hero off the wall.
|
|
203
|
+
life: 0.9,
|
|
204
|
+
mask: "star",
|
|
205
|
+
opacity: 1,
|
|
206
|
+
// Small and fast: the motion blur draws each one out into a streak.
|
|
207
|
+
size: [0.35, 0.1],
|
|
208
|
+
});
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
/** Gold-white stars that pop out and fall: pickups, wall-kick sparks, jump trails, gem glints. */
|
|
212
|
+
export function sparkleEffect(): IEffectOptions {
|
|
213
|
+
return emitter({
|
|
214
|
+
additive: true,
|
|
215
|
+
amount: 512,
|
|
216
|
+
colour: [
|
|
217
|
+
[1.6, 1.45, 1.0],
|
|
218
|
+
[1.2, 0.55, 0.08],
|
|
219
|
+
],
|
|
220
|
+
drag: 2.2,
|
|
221
|
+
gravity: -5,
|
|
222
|
+
life: 0.9,
|
|
223
|
+
mask: "star",
|
|
224
|
+
opacity: 0.9,
|
|
225
|
+
size: [0.32, 0.08],
|
|
226
|
+
});
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
/** Petals and pollen that drift round the hero on the breeze, pale pink to cream. */
|
|
230
|
+
export function pollenEffect(): IEffectOptions {
|
|
231
|
+
return emitter({
|
|
232
|
+
additive: false,
|
|
233
|
+
amount: 256,
|
|
234
|
+
colour: [
|
|
235
|
+
[1, 0.72, 0.82],
|
|
236
|
+
[1, 0.95, 0.75],
|
|
237
|
+
],
|
|
238
|
+
drag: 0.4,
|
|
239
|
+
gravity: -0.06,
|
|
240
|
+
life: 5,
|
|
241
|
+
mask: "puff",
|
|
242
|
+
opacity: 0.85,
|
|
243
|
+
size: [0.11, 0.08],
|
|
244
|
+
});
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
/** The four emitters `scenes/Play.ts` builds, by the name a burst picks one with. */
|
|
248
|
+
export const EFFECTS = {
|
|
249
|
+
dust: dustEffect,
|
|
250
|
+
flash: flashEffect,
|
|
251
|
+
pollen: pollenEffect,
|
|
252
|
+
sparkle: sparkleEffect,
|
|
253
|
+
} as const;
|
|
254
|
+
|
|
255
|
+
/**
|
|
256
|
+
* Every burst the game fires, by name: its emitter, how many particles and the request's
|
|
257
|
+
* `direction` (outward speed, upward speed, start radius). Tune the feel here, not in `scenes/Play.ts`.
|
|
258
|
+
*/
|
|
259
|
+
export const BURSTS = {
|
|
260
|
+
run: { emitter: "dust", count: 4, shape: [0.9, 1.1, 0.3] },
|
|
261
|
+
skid: { emitter: "dust", count: 16, shape: [2.6, 1, 0.35] },
|
|
262
|
+
takeoff: { emitter: "dust", count: 12, shape: [2, 0.8, 0.3] },
|
|
263
|
+
landing: { emitter: "dust", count: 24, shape: [3.6, 0.4, 0.4] },
|
|
264
|
+
pound: { emitter: "dust", count: 39, shape: [8, 0.6, 0.5] },
|
|
265
|
+
// A thin ring of sparks that skims out along the ground: almost no upward speed.
|
|
266
|
+
poundRing: { emitter: "flash", count: 48, shape: [9, 0.15, 0.6] },
|
|
267
|
+
debris: { emitter: "dust", count: 14, shape: [2.5, 6, 0.6] },
|
|
268
|
+
ledge: { emitter: "dust", count: 6, shape: [0.8, 0.4, 0.3] },
|
|
269
|
+
poof: { emitter: "dust", count: 24, shape: [2.6, 1.6, 0.4] },
|
|
270
|
+
// A kick: 18 amber streaks off the wall plus 8 gold-white stars, slower than a pound's ring so
|
|
271
|
+
// they stay round the hero; 10 streaks at 7 m/s were gone before the eye found them.
|
|
272
|
+
wallKick: { emitter: "flash", count: 18, shape: [5, 2.5, 0.12] },
|
|
273
|
+
kickStars: { emitter: "sparkle", count: 8, shape: [3, 2, 0.1] },
|
|
274
|
+
trail: { emitter: "sparkle", count: 2, shape: [0.4, 0.3, 0.25] },
|
|
275
|
+
streak: { emitter: "sparkle", count: 3, shape: [0.2, 0.1, 0.15] },
|
|
276
|
+
coin: { emitter: "sparkle", count: 14, shape: [2.4, 3.5, 0.2] },
|
|
277
|
+
gem: { emitter: "sparkle", count: 22, shape: [3, 4, 0.3] },
|
|
278
|
+
seed: { emitter: "sparkle", count: 60, shape: [4.5, 6, 0.4] },
|
|
279
|
+
glint: { emitter: "sparkle", count: 1, shape: [0.3, 0.8, 0.35] },
|
|
280
|
+
pollen: { emitter: "pollen", count: 3, shape: [0.5, 0.35, 14] },
|
|
281
|
+
} as const satisfies Record<
|
|
282
|
+
string,
|
|
283
|
+
{ emitter: keyof typeof EFFECTS; count: number; shape: readonly [number, number, number] }
|
|
284
|
+
>;
|