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,20 @@
|
|
|
1
|
+
// Generated for you. The starter kits share this meter; `pnpm stamp:template-render` copies it into
|
|
2
|
+
// each kit that ships it. Override it for one game in `exposure.ts`, not here.
|
|
3
|
+
//
|
|
4
|
+
// Core's meter is stock Unreal 5.8.3, exposure compensation +1 EV (key 0.36,
|
|
5
|
+
// r.DefaultFeature.AutoExposure.Bias 1.0, UE 5.8.3: Engine/Source/Runtime/Engine/Private/SceneView.cpp:196-199).
|
|
6
|
+
// The kits use 0 EV (key 0.18) instead. Their bright stylised scenes read pastel and veiled at
|
|
7
|
+
// +1 EV. At 0 EV a fresh Opus judge read IMPROVEMENT on 9 of 9 kits (PRD-747, 2026-10-26).
|
|
8
|
+
// The range keeps Unreal's -10..+20 EV100 window around the new key.
|
|
9
|
+
import {
|
|
10
|
+
type IExposureSettings,
|
|
11
|
+
exposureSettings as coreExposureSettings,
|
|
12
|
+
} from "@threenative/core";
|
|
13
|
+
|
|
14
|
+
const KEY = 0.18;
|
|
15
|
+
export const kitExposureSettings: Readonly<IExposureSettings> = {
|
|
16
|
+
...coreExposureSettings,
|
|
17
|
+
key: KEY,
|
|
18
|
+
minStops: Math.log2(KEY) - 20,
|
|
19
|
+
maxStops: Math.log2(KEY) + 10,
|
|
20
|
+
};
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
// ThreeNative does not read this file.
|
|
3
|
+
//
|
|
4
|
+
// One sun, and the sky in `sky.ts` is the fill: no hemisphere or ambient light stacked on top to
|
|
5
|
+
// flatten the shadow side. The dungeon is lit by its own torches (`torch` below), placed by
|
|
6
|
+
// `level/Hollow.ts`; the sun's shadow map follows Wren, so it covers the room she is in.
|
|
7
|
+
import {
|
|
8
|
+
type ColorRepresentation,
|
|
9
|
+
DirectionalLight,
|
|
10
|
+
PCFShadowMap,
|
|
11
|
+
PointLight,
|
|
12
|
+
type Scene,
|
|
13
|
+
type Vector3,
|
|
14
|
+
} from "three";
|
|
15
|
+
import { SUN_DIRECTION, setMist } from "./sky.js";
|
|
16
|
+
|
|
17
|
+
type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
|
|
18
|
+
|
|
19
|
+
export interface ILighting {
|
|
20
|
+
readonly key: DirectionalLight;
|
|
21
|
+
/** Keeps the shadow map centred on Wren. Call after physics has moved her. */
|
|
22
|
+
follow(target: Vector3): void;
|
|
23
|
+
/**
|
|
24
|
+
* Under the Hollow's roof the sky barely reaches: the sky light drops to a twentieth and the torches
|
|
25
|
+
* carry the room, and the forest mist thins so the far wall and the Warden stay clear. Auto
|
|
26
|
+
* exposure (core's default) then meters the darker room on its own.
|
|
27
|
+
*/
|
|
28
|
+
setIndoors(indoors: boolean): void;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
export function setupLighting(scene: Scene, renderer: ShadowRenderer, mobile = false): ILighting {
|
|
32
|
+
renderer.shadowMap.enabled = true;
|
|
33
|
+
renderer.shadowMap.type = PCFShadowMap;
|
|
34
|
+
// Warm late-morning sun. It reaches the floor through the canopy's gaps, as soft pools under the
|
|
35
|
+
// sun shafts (`sky.ts`).
|
|
36
|
+
const key = new DirectionalLight(0xffd9a0, 4);
|
|
37
|
+
key.castShadow = true;
|
|
38
|
+
// The camera sees about 30 m around Wren, so the map covers that window and travels with her:
|
|
39
|
+
// 4096² over 36 m is under a centimetre a texel. Phones take 2048² over a smaller window.
|
|
40
|
+
const size = mobile ? 2048 : 4096;
|
|
41
|
+
const extent = mobile ? 12 : 18;
|
|
42
|
+
key.shadow.mapSize.set(size, size);
|
|
43
|
+
// A soft edge: the canopy's dapple is light through leaves ten metres up, never a sharp cut-out.
|
|
44
|
+
// PCF reads `radius` in texels (12 is about 10 cm here); temporal AA smooths its five samples.
|
|
45
|
+
key.shadow.radius = 12;
|
|
46
|
+
key.shadow.camera.near = 1;
|
|
47
|
+
key.shadow.camera.far = 90;
|
|
48
|
+
key.shadow.camera.left = -extent;
|
|
49
|
+
key.shadow.camera.right = extent;
|
|
50
|
+
key.shadow.camera.top = extent;
|
|
51
|
+
key.shadow.camera.bottom = -extent;
|
|
52
|
+
// Small biases: a large normal bias lifts a shadow off the feet that cast it.
|
|
53
|
+
key.shadow.bias = -0.0003;
|
|
54
|
+
key.shadow.normalBias = 0.02;
|
|
55
|
+
scene.add(key, key.target);
|
|
56
|
+
const offset = SUN_DIRECTION.clone().multiplyScalar(40);
|
|
57
|
+
return {
|
|
58
|
+
follow(target: Vector3): void {
|
|
59
|
+
key.position.copy(target).add(offset);
|
|
60
|
+
key.target.position.copy(target);
|
|
61
|
+
key.target.updateMatrixWorld();
|
|
62
|
+
},
|
|
63
|
+
key,
|
|
64
|
+
setIndoors(indoors: boolean): void {
|
|
65
|
+
scene.environmentIntensity = indoors ? 0.05 : 1;
|
|
66
|
+
setMist(scene, indoors);
|
|
67
|
+
},
|
|
68
|
+
};
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/** A wall torch: warm, short-range, no shadow map (eight of them would be eight more passes). */
|
|
72
|
+
export function torch(color: ColorRepresentation = 0xffa65a, intensity = 14): PointLight {
|
|
73
|
+
return new PointLight(color, intensity, 11, 2);
|
|
74
|
+
}
|
|
@@ -0,0 +1,332 @@
|
|
|
1
|
+
import {
|
|
2
|
+
type Camera,
|
|
3
|
+
CanvasTexture,
|
|
4
|
+
ClampToEdgeWrapping,
|
|
5
|
+
Mesh,
|
|
6
|
+
MeshBasicMaterial,
|
|
7
|
+
type OrthographicCamera,
|
|
8
|
+
PlaneGeometry,
|
|
9
|
+
type Scene,
|
|
10
|
+
type Texture,
|
|
11
|
+
} from "three";
|
|
12
|
+
import { palette } from "./palette.js";
|
|
13
|
+
|
|
14
|
+
/* BEGIN THREENATIVE LOADING APPEARANCE */
|
|
15
|
+
/** The five authoring points for this screen stay in this generated file. */
|
|
16
|
+
export const loading = {
|
|
17
|
+
backgroundColor: palette.skyLow,
|
|
18
|
+
backgroundImage: undefined as string | undefined,
|
|
19
|
+
enabled: true,
|
|
20
|
+
fillImage: undefined as string | undefined,
|
|
21
|
+
logoImage: undefined as string | undefined,
|
|
22
|
+
progressColor: palette.accent,
|
|
23
|
+
showStatus: false,
|
|
24
|
+
trackColor: palette.skyHigh,
|
|
25
|
+
bar: {
|
|
26
|
+
anchorX: 0.5,
|
|
27
|
+
anchorY: 0.72,
|
|
28
|
+
height: 12,
|
|
29
|
+
maxWidth: 1200,
|
|
30
|
+
minWidth: 2,
|
|
31
|
+
width: 0.62,
|
|
32
|
+
},
|
|
33
|
+
} as const;
|
|
34
|
+
/* END THREENATIVE LOADING APPEARANCE */
|
|
35
|
+
|
|
36
|
+
interface ILoadingHost {
|
|
37
|
+
readonly assets?: { texture(path: string): Promise<Texture> };
|
|
38
|
+
readonly camera: Camera;
|
|
39
|
+
readonly canvasLayer: {
|
|
40
|
+
readonly camera: OrthographicCamera;
|
|
41
|
+
readonly scene: Scene;
|
|
42
|
+
opaque: boolean;
|
|
43
|
+
};
|
|
44
|
+
readonly renderer: { compileAsync(scene: Scene, camera: Camera): Promise<void> };
|
|
45
|
+
readonly scene: Scene;
|
|
46
|
+
readonly startup: {
|
|
47
|
+
readonly progress: number;
|
|
48
|
+
readonly warmup?: { readonly status: "complete" | "incomplete" | "unavailable" };
|
|
49
|
+
whenReady(): Promise<void>;
|
|
50
|
+
};
|
|
51
|
+
readonly viewport?: {
|
|
52
|
+
readonly safeArea: { height: number; width: number; x: number; y: number };
|
|
53
|
+
};
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
interface ILoadingController {
|
|
57
|
+
update(): void;
|
|
58
|
+
finish(): void;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
function noOp(layer: ILoadingHost["canvasLayer"]): ILoadingController {
|
|
62
|
+
layer.opaque = false;
|
|
63
|
+
return { finish: () => undefined, update: () => undefined };
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
function meshFor(
|
|
67
|
+
layer: ILoadingHost["canvasLayer"],
|
|
68
|
+
material: MeshBasicMaterial,
|
|
69
|
+
renderOrder: number,
|
|
70
|
+
): Mesh<PlaneGeometry, MeshBasicMaterial> {
|
|
71
|
+
const mesh = new Mesh(new PlaneGeometry(1, 1), material);
|
|
72
|
+
mesh.frustumCulled = false;
|
|
73
|
+
mesh.renderOrder = renderOrder;
|
|
74
|
+
layer.scene.add(mesh);
|
|
75
|
+
return mesh;
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
function imageAspect(texture: Texture | null | undefined): number {
|
|
79
|
+
const image = texture?.image as { height?: number; width?: number } | undefined;
|
|
80
|
+
const width = image?.width ?? 1;
|
|
81
|
+
const height = image?.height ?? 1;
|
|
82
|
+
return width > 0 && height > 0 ? width / height : 1;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
function configureTexture(texture: Texture): void {
|
|
86
|
+
texture.wrapS = ClampToEdgeWrapping;
|
|
87
|
+
texture.wrapT = ClampToEdgeWrapping;
|
|
88
|
+
texture.needsUpdate = true;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
function setFillUv(geometry: PlaneGeometry, progress: number, base: readonly number[]): void {
|
|
92
|
+
const uv = geometry.getAttribute("uv");
|
|
93
|
+
for (let index = 0; index < uv.count; index += 1) uv.setX(index, (base[index] ?? 0) * progress);
|
|
94
|
+
uv.needsUpdate = true;
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
function coverUv(
|
|
98
|
+
geometry: PlaneGeometry,
|
|
99
|
+
texture: Texture,
|
|
100
|
+
width: number,
|
|
101
|
+
height: number,
|
|
102
|
+
baseU: readonly number[],
|
|
103
|
+
baseV: readonly number[],
|
|
104
|
+
): void {
|
|
105
|
+
const imageRatio = imageAspect(texture);
|
|
106
|
+
const boxRatio = width / Math.max(1, height);
|
|
107
|
+
const visibleU = imageRatio > boxRatio ? boxRatio / imageRatio : 1;
|
|
108
|
+
const visibleV = imageRatio < boxRatio ? imageRatio / boxRatio : 1;
|
|
109
|
+
const offsetU = (1 - visibleU) / 2;
|
|
110
|
+
const offsetV = (1 - visibleV) / 2;
|
|
111
|
+
const uv = geometry.getAttribute("uv");
|
|
112
|
+
for (let index = 0; index < uv.count; index += 1) {
|
|
113
|
+
uv.setX(index, offsetU + (baseU[index] ?? 0) * visibleU);
|
|
114
|
+
uv.setY(index, offsetV + (baseV[index] ?? 0) * visibleV);
|
|
115
|
+
}
|
|
116
|
+
uv.needsUpdate = true;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
function statusMesh(
|
|
120
|
+
layer: ILoadingHost["canvasLayer"],
|
|
121
|
+
):
|
|
122
|
+
| { mesh: Mesh<PlaneGeometry, MeshBasicMaterial>; texture: Texture; update(value: number): void }
|
|
123
|
+
| undefined {
|
|
124
|
+
if (!loading.showStatus || typeof document === "undefined") return undefined;
|
|
125
|
+
const canvas = document.createElement("canvas");
|
|
126
|
+
canvas.width = 180;
|
|
127
|
+
canvas.height = 48;
|
|
128
|
+
const context = canvas.getContext("2d");
|
|
129
|
+
if (context === null) return undefined;
|
|
130
|
+
const texture = new CanvasTexture(canvas);
|
|
131
|
+
const mesh = meshFor(
|
|
132
|
+
layer,
|
|
133
|
+
new MeshBasicMaterial({ depthTest: false, depthWrite: false, map: texture, transparent: true }),
|
|
134
|
+
4,
|
|
135
|
+
);
|
|
136
|
+
const update = (value: number): void => {
|
|
137
|
+
context.clearRect(0, 0, canvas.width, canvas.height);
|
|
138
|
+
context.fillStyle = "#ffffff";
|
|
139
|
+
context.font = "700 20px monospace";
|
|
140
|
+
context.textAlign = "center";
|
|
141
|
+
context.textBaseline = "middle";
|
|
142
|
+
context.fillText(`${Math.round(value * 100)}%`, canvas.width / 2, canvas.height / 2);
|
|
143
|
+
texture.needsUpdate = true;
|
|
144
|
+
};
|
|
145
|
+
update(0);
|
|
146
|
+
return { mesh, texture, update };
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
export function createLoadingScreen(host: ILoadingHost): ILoadingController {
|
|
150
|
+
const layer = host.canvasLayer;
|
|
151
|
+
if (!loading.enabled) return noOp(layer);
|
|
152
|
+
const camera = layer.camera;
|
|
153
|
+
const backdrop = meshFor(
|
|
154
|
+
layer,
|
|
155
|
+
new MeshBasicMaterial({ color: loading.backgroundColor, depthTest: false, depthWrite: false }),
|
|
156
|
+
0,
|
|
157
|
+
);
|
|
158
|
+
const track = meshFor(
|
|
159
|
+
layer,
|
|
160
|
+
new MeshBasicMaterial({ color: loading.trackColor, depthTest: false, depthWrite: false }),
|
|
161
|
+
1,
|
|
162
|
+
);
|
|
163
|
+
const fill = meshFor(
|
|
164
|
+
layer,
|
|
165
|
+
new MeshBasicMaterial({ color: loading.progressColor, depthTest: false, depthWrite: false }),
|
|
166
|
+
2,
|
|
167
|
+
);
|
|
168
|
+
const fillBaseU = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
|
|
169
|
+
fill.geometry.getAttribute("uv").getX(index),
|
|
170
|
+
);
|
|
171
|
+
const fillBaseV = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
|
|
172
|
+
fill.geometry.getAttribute("uv").getY(index),
|
|
173
|
+
);
|
|
174
|
+
const logo =
|
|
175
|
+
loading.logoImage === undefined
|
|
176
|
+
? undefined
|
|
177
|
+
: meshFor(
|
|
178
|
+
layer,
|
|
179
|
+
new MeshBasicMaterial({
|
|
180
|
+
color: 0xffffff,
|
|
181
|
+
depthTest: false,
|
|
182
|
+
depthWrite: false,
|
|
183
|
+
transparent: true,
|
|
184
|
+
}),
|
|
185
|
+
3,
|
|
186
|
+
);
|
|
187
|
+
const status = statusMesh(layer);
|
|
188
|
+
const parts = [
|
|
189
|
+
backdrop,
|
|
190
|
+
track,
|
|
191
|
+
fill,
|
|
192
|
+
...(logo === undefined ? [] : [logo]),
|
|
193
|
+
...(status === undefined ? [] : [status.mesh]),
|
|
194
|
+
];
|
|
195
|
+
const ownedTextures = new Set<Texture>(status === undefined ? [] : [status.texture]);
|
|
196
|
+
let width = 1;
|
|
197
|
+
let height = 1;
|
|
198
|
+
let barWidth = 1;
|
|
199
|
+
let barHeight: number = loading.bar.height;
|
|
200
|
+
let barX = 0;
|
|
201
|
+
let barY = 0;
|
|
202
|
+
let progress = 0;
|
|
203
|
+
let done = false;
|
|
204
|
+
let backdropTexture: Texture | undefined;
|
|
205
|
+
|
|
206
|
+
const layout = (): void => {
|
|
207
|
+
width = Math.max(1, camera.right - camera.left);
|
|
208
|
+
height = Math.max(1, camera.top - camera.bottom);
|
|
209
|
+
const safe = host.viewport?.safeArea ?? { height, width, x: 0, y: 0 };
|
|
210
|
+
const safeWidth = Math.max(1, Math.min(width, safe.width));
|
|
211
|
+
const safeHeight = Math.max(1, Math.min(height, safe.height));
|
|
212
|
+
const safeX = Math.max(0, Math.min(width - safeWidth, safe.x));
|
|
213
|
+
const safeY = Math.max(0, Math.min(height - safeHeight, safe.y));
|
|
214
|
+
barWidth = Math.max(2, Math.min(loading.bar.maxWidth, safeWidth * loading.bar.width));
|
|
215
|
+
barHeight = Math.max(2, Math.min(loading.bar.height, safeHeight * 0.05));
|
|
216
|
+
barX = safeX + safeWidth * loading.bar.anchorX;
|
|
217
|
+
barY = safeY + safeHeight * loading.bar.anchorY;
|
|
218
|
+
const worldX = (screenX: number): number => camera.left + screenX;
|
|
219
|
+
const worldY = (screenY: number): number => camera.top - screenY;
|
|
220
|
+
const visibleWidth = Math.max(loading.bar.minWidth, barWidth * progress);
|
|
221
|
+
backdrop.scale.set(width, height, 1);
|
|
222
|
+
backdrop.position.set(worldX(width / 2), worldY(height / 2), 0);
|
|
223
|
+
track.scale.set(barWidth, barHeight, 1);
|
|
224
|
+
track.position.set(worldX(barX), worldY(barY), 0);
|
|
225
|
+
fill.scale.set(visibleWidth, barHeight, 1);
|
|
226
|
+
fill.position.set(worldX(barX - barWidth / 2 + visibleWidth / 2), worldY(barY), 0);
|
|
227
|
+
if (logo?.visible) {
|
|
228
|
+
const logoWidth = Math.min(safeWidth * 0.42, 280);
|
|
229
|
+
logo.scale.set(
|
|
230
|
+
logoWidth,
|
|
231
|
+
Math.min(logoWidth / imageAspect(logo.material.map), safeHeight * 0.22),
|
|
232
|
+
1,
|
|
233
|
+
);
|
|
234
|
+
logo.position.set(worldX(barX), worldY(Math.max(safeY, barY - safeHeight * 0.2)), 0);
|
|
235
|
+
}
|
|
236
|
+
if (status !== undefined) {
|
|
237
|
+
status.mesh.scale.set(Math.min(180, safeWidth * 0.32), 48, 1);
|
|
238
|
+
status.mesh.position.set(worldX(barX), worldY(Math.min(height, barY + barHeight * 2.5)), 0);
|
|
239
|
+
}
|
|
240
|
+
if (backdropTexture !== undefined)
|
|
241
|
+
coverUv(backdrop.geometry, backdropTexture, width, height, fillBaseU, fillBaseV);
|
|
242
|
+
};
|
|
243
|
+
|
|
244
|
+
const updateProgress = (value: number): void => {
|
|
245
|
+
const bounded = Number.isFinite(value) ? Math.max(0, Math.min(1, value)) : 0;
|
|
246
|
+
// A missing or incomplete backend observation cannot prove that all first-use work is done.
|
|
247
|
+
// Keep the bar visibly indeterminate until readiness removes the cover; never turn unknown
|
|
248
|
+
// coverage into a false 100% claim.
|
|
249
|
+
const observationUnknown =
|
|
250
|
+
host.startup.warmup !== undefined && host.startup.warmup.status !== "complete";
|
|
251
|
+
progress = observationUnknown ? Math.min(0.9, bounded) : bounded;
|
|
252
|
+
setFillUv(fill.geometry, progress, fillBaseU);
|
|
253
|
+
status?.update(progress);
|
|
254
|
+
layout();
|
|
255
|
+
};
|
|
256
|
+
|
|
257
|
+
const attachTexture = (mesh: Mesh<PlaneGeometry, MeshBasicMaterial>, texture: Texture): void => {
|
|
258
|
+
if (done) return;
|
|
259
|
+
configureTexture(texture);
|
|
260
|
+
mesh.material.map = texture;
|
|
261
|
+
mesh.material.color.set(0xffffff);
|
|
262
|
+
mesh.material.needsUpdate = true;
|
|
263
|
+
ownedTextures.add(texture);
|
|
264
|
+
if (mesh === backdrop) backdropTexture = texture;
|
|
265
|
+
layout();
|
|
266
|
+
updateProgress(progress);
|
|
267
|
+
};
|
|
268
|
+
|
|
269
|
+
const load = (source: string | undefined, mesh: Mesh<PlaneGeometry, MeshBasicMaterial>): void => {
|
|
270
|
+
if (source === undefined || host.assets === undefined) return;
|
|
271
|
+
void host.assets
|
|
272
|
+
.texture(source)
|
|
273
|
+
.then((texture) => attachTexture(mesh, texture))
|
|
274
|
+
.catch(() => undefined);
|
|
275
|
+
};
|
|
276
|
+
load(loading.backgroundImage, backdrop);
|
|
277
|
+
load(loading.fillImage, fill);
|
|
278
|
+
if (logo !== undefined && loading.logoImage !== undefined && host.assets !== undefined) {
|
|
279
|
+
void host.assets
|
|
280
|
+
.texture(loading.logoImage)
|
|
281
|
+
.then((texture) => {
|
|
282
|
+
if (done) return;
|
|
283
|
+
configureTexture(texture);
|
|
284
|
+
logo.material.map = texture;
|
|
285
|
+
logo.material.needsUpdate = true;
|
|
286
|
+
logo.visible = true;
|
|
287
|
+
ownedTextures.add(texture);
|
|
288
|
+
layout();
|
|
289
|
+
})
|
|
290
|
+
.catch(() => undefined);
|
|
291
|
+
}
|
|
292
|
+
|
|
293
|
+
layer.opaque = true;
|
|
294
|
+
layout();
|
|
295
|
+
updateProgress(0);
|
|
296
|
+
|
|
297
|
+
const finish = (): void => {
|
|
298
|
+
if (done) return;
|
|
299
|
+
done = true;
|
|
300
|
+
for (const mesh of parts) {
|
|
301
|
+
mesh.removeFromParent();
|
|
302
|
+
mesh.geometry.dispose();
|
|
303
|
+
mesh.material.dispose();
|
|
304
|
+
}
|
|
305
|
+
for (const texture of ownedTextures) texture.dispose();
|
|
306
|
+
layer.opaque = false;
|
|
307
|
+
};
|
|
308
|
+
|
|
309
|
+
void (async () => {
|
|
310
|
+
await host.startup.whenReady();
|
|
311
|
+
if (done) return;
|
|
312
|
+
// Prewarm the world's shaders, but do not wait for them here. `whenReady()` already means the
|
|
313
|
+
// world is safe to show, and compiling a lit, post-processed scene takes far longer than the
|
|
314
|
+
// launch window: hold the screen for it and a playtest — which advances a fixed step as fast
|
|
315
|
+
// as the machine allows — runs an entire scenario behind the launch screen, so every capture
|
|
316
|
+
// photographs the loading bar instead of the game. The prewarm still happens; it no longer
|
|
317
|
+
// decides when the player sees the world.
|
|
318
|
+
try {
|
|
319
|
+
void host.renderer.compileAsync(host.scene, host.camera).catch(() => undefined);
|
|
320
|
+
} catch {
|
|
321
|
+
// A renderer without compileAsync is not a reason to keep the world hidden.
|
|
322
|
+
}
|
|
323
|
+
finish();
|
|
324
|
+
})();
|
|
325
|
+
|
|
326
|
+
return {
|
|
327
|
+
finish,
|
|
328
|
+
update(): void {
|
|
329
|
+
if (!done) updateProgress(host.startup.progress);
|
|
330
|
+
},
|
|
331
|
+
};
|
|
332
|
+
}
|
|
@@ -0,0 +1,179 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
// ThreeNative does not read this file.
|
|
3
|
+
//
|
|
4
|
+
// One material per colour, cached: the vale and the Hollow are hundreds of primitives sharing a
|
|
5
|
+
// few dozen colours, and a fresh material per mesh is a fresh shader per mesh. `lit` is the
|
|
6
|
+
// standard surface; `glow` is for what carries its own light (the lantern, the Warden's runes,
|
|
7
|
+
// the reticle), which an emissive keeps bright under any exposure the meter picks.
|
|
8
|
+
import {
|
|
9
|
+
BufferAttribute,
|
|
10
|
+
type BufferGeometry,
|
|
11
|
+
type ColorRepresentation,
|
|
12
|
+
DataTexture,
|
|
13
|
+
DoubleSide,
|
|
14
|
+
FrontSide,
|
|
15
|
+
LinearFilter,
|
|
16
|
+
LinearMipmapLinearFilter,
|
|
17
|
+
type Material,
|
|
18
|
+
MeshBasicMaterial,
|
|
19
|
+
MeshStandardMaterial,
|
|
20
|
+
NoColorSpace,
|
|
21
|
+
RGBAFormat,
|
|
22
|
+
RepeatWrapping,
|
|
23
|
+
} from "three";
|
|
24
|
+
import { palette } from "./palette.js";
|
|
25
|
+
|
|
26
|
+
const cache = new Map<string, Material>();
|
|
27
|
+
|
|
28
|
+
function cached<T extends Material>(key: string, make: () => T): T {
|
|
29
|
+
const hit = cache.get(key);
|
|
30
|
+
if (hit !== undefined) return hit as T;
|
|
31
|
+
const material = make();
|
|
32
|
+
cache.set(key, material);
|
|
33
|
+
return material;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
let detailMap: DataTexture | undefined;
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* A tiling grey grain, 128² fractal value noise baked in code: multiplied over a surface's colour it
|
|
40
|
+
* breaks a flat vertex-coloured face into soil, bark or stone grain. No image file. Values sit
|
|
41
|
+
* between 0.62 and 1, so it only darkens.
|
|
42
|
+
*/
|
|
43
|
+
export function detailTexture(): DataTexture {
|
|
44
|
+
if (detailMap !== undefined) return detailMap;
|
|
45
|
+
const size = 128;
|
|
46
|
+
const lattice = (cells: number, seed: number): ((x: number, y: number) => number) => {
|
|
47
|
+
const rng = (i: number): number => {
|
|
48
|
+
const s = Math.sin(i * 127.1 + seed * 311.7) * 43758.5453;
|
|
49
|
+
return s - Math.floor(s);
|
|
50
|
+
};
|
|
51
|
+
return (x, y) => {
|
|
52
|
+
const fx = (x / size) * cells;
|
|
53
|
+
const fy = (y / size) * cells;
|
|
54
|
+
const x0 = Math.floor(fx);
|
|
55
|
+
const y0 = Math.floor(fy);
|
|
56
|
+
const tx = fx - x0;
|
|
57
|
+
const ty = fy - y0;
|
|
58
|
+
const at = (i: number, j: number): number => rng(((j % cells) * cells + (i % cells)) * 1.37);
|
|
59
|
+
const sx = tx * tx * (3 - 2 * tx);
|
|
60
|
+
const sy = ty * ty * (3 - 2 * ty);
|
|
61
|
+
const top = at(x0, y0) + (at(x0 + 1, y0) - at(x0, y0)) * sx;
|
|
62
|
+
const bottom = at(x0, y0 + 1) + (at(x0 + 1, y0 + 1) - at(x0, y0 + 1)) * sx;
|
|
63
|
+
return top + (bottom - top) * sy;
|
|
64
|
+
};
|
|
65
|
+
};
|
|
66
|
+
const octaves = [lattice(4, 1), lattice(8, 2), lattice(16, 3), lattice(32, 4)];
|
|
67
|
+
const data = new Uint8Array(size * size * 4);
|
|
68
|
+
for (let y = 0; y < size; y += 1) {
|
|
69
|
+
for (let x = 0; x < size; x += 1) {
|
|
70
|
+
const n = octaves.reduce((sum, octave, i) => sum + octave(x, y) / 2 ** i, 0) / 1.875;
|
|
71
|
+
const v = Math.round((0.62 + 0.38 * n) * 255);
|
|
72
|
+
data.set([v, v, v, 255], (y * size + x) * 4);
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
detailMap = new DataTexture(data, size, size, RGBAFormat);
|
|
76
|
+
detailMap.wrapS = RepeatWrapping;
|
|
77
|
+
detailMap.wrapT = RepeatWrapping;
|
|
78
|
+
detailMap.magFilter = LinearFilter;
|
|
79
|
+
detailMap.minFilter = LinearMipmapLinearFilter;
|
|
80
|
+
detailMap.generateMipmaps = true;
|
|
81
|
+
detailMap.colorSpace = NoColorSpace;
|
|
82
|
+
detailMap.needsUpdate = true;
|
|
83
|
+
return detailMap;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/**
|
|
87
|
+
* A lit, rough surface. `vertexColors` shows the baked variation `mottle` writes; `detail` adds the
|
|
88
|
+
* tiling grain of `detailTexture` (the geometry needs uvs).
|
|
89
|
+
*/
|
|
90
|
+
export function lit(
|
|
91
|
+
color: ColorRepresentation,
|
|
92
|
+
options: {
|
|
93
|
+
roughness?: number;
|
|
94
|
+
metalness?: number;
|
|
95
|
+
vertexColors?: boolean;
|
|
96
|
+
flat?: boolean;
|
|
97
|
+
detail?: boolean;
|
|
98
|
+
doubleSided?: boolean;
|
|
99
|
+
/** A faint glow of the material's own, added in shade. */
|
|
100
|
+
emissive?: ColorRepresentation;
|
|
101
|
+
} = {},
|
|
102
|
+
): MeshStandardMaterial {
|
|
103
|
+
return cached(
|
|
104
|
+
`lit|${String(color)}|${JSON.stringify(options)}`,
|
|
105
|
+
() =>
|
|
106
|
+
new MeshStandardMaterial({
|
|
107
|
+
color,
|
|
108
|
+
emissive: options.emissive ?? 0x000000,
|
|
109
|
+
flatShading: options.flat ?? false,
|
|
110
|
+
map: options.detail === true ? detailTexture() : null,
|
|
111
|
+
metalness: options.metalness ?? 0,
|
|
112
|
+
roughness: options.roughness ?? 0.85,
|
|
113
|
+
side: options.doubleSided === true ? DoubleSide : FrontSide,
|
|
114
|
+
vertexColors: options.vertexColors ?? false,
|
|
115
|
+
}),
|
|
116
|
+
);
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/** A surface that is its own light: the lantern flame, the runes, the reticle. */
|
|
120
|
+
export function glow(color: ColorRepresentation, strength = 4): MeshStandardMaterial {
|
|
121
|
+
return cached(
|
|
122
|
+
`glow|${String(color)}|${strength}`,
|
|
123
|
+
() =>
|
|
124
|
+
new MeshStandardMaterial({
|
|
125
|
+
color: 0x000000,
|
|
126
|
+
emissive: color,
|
|
127
|
+
emissiveIntensity: strength,
|
|
128
|
+
roughness: 1,
|
|
129
|
+
}),
|
|
130
|
+
);
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
/** Unlit and see-through, for the blob shadows and the reticle ring. */
|
|
134
|
+
export function flat(
|
|
135
|
+
color: ColorRepresentation,
|
|
136
|
+
opacity = 1,
|
|
137
|
+
options: { depthTest?: boolean } = {},
|
|
138
|
+
): MeshBasicMaterial {
|
|
139
|
+
return cached(
|
|
140
|
+
`flat|${String(color)}|${opacity}|${JSON.stringify(options)}`,
|
|
141
|
+
() =>
|
|
142
|
+
new MeshBasicMaterial({
|
|
143
|
+
color,
|
|
144
|
+
depthTest: options.depthTest ?? true,
|
|
145
|
+
depthWrite: opacity >= 1,
|
|
146
|
+
opacity,
|
|
147
|
+
transparent: opacity < 1,
|
|
148
|
+
}),
|
|
149
|
+
);
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
/**
|
|
153
|
+
* Bakes a per-face brightness variation into vertex colours, so a box reads as cut stone and a
|
|
154
|
+
* plane as uneven turf with no texture file. Two triangles share one tint: a quad stays a facet.
|
|
155
|
+
*/
|
|
156
|
+
export function mottle(
|
|
157
|
+
geometry: BufferGeometry,
|
|
158
|
+
variance = 0.18,
|
|
159
|
+
rng: () => number = Math.random,
|
|
160
|
+
): BufferGeometry {
|
|
161
|
+
const g = geometry.index === null ? geometry : geometry.toNonIndexed();
|
|
162
|
+
const count = g.attributes.position?.count ?? 0;
|
|
163
|
+
const colors = new Float32Array(count * 3);
|
|
164
|
+
for (let i = 0; i < count; i += 6) {
|
|
165
|
+
const k = 1 - variance / 2 + rng() * variance;
|
|
166
|
+
for (let v = 0; v < 6 && i + v < count; v += 1) colors.fill(k, (i + v) * 3, (i + v) * 3 + 3);
|
|
167
|
+
}
|
|
168
|
+
g.setAttribute("color", new BufferAttribute(colors, 3));
|
|
169
|
+
return g;
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
/** The surfaces the world is built from, resolved once. */
|
|
173
|
+
export function worldMaterials() {
|
|
174
|
+
return {
|
|
175
|
+
accent: lit(palette.accent, { metalness: 0.6, roughness: 0.4 }),
|
|
176
|
+
grass: lit(palette.grass, { vertexColors: true }),
|
|
177
|
+
stone: lit(palette.stone, { flat: true, vertexColors: true }),
|
|
178
|
+
};
|
|
179
|
+
}
|