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
|
@@ -1,12 +1,34 @@
|
|
|
1
1
|
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
2
|
// ThreeNative does not read this file.
|
|
3
3
|
//
|
|
4
|
-
// One sun. The sky
|
|
4
|
+
// One sun. The sky in `sky.ts` is the fill light — its environment reaches every face the
|
|
5
5
|
// sun misses — so there is no hemisphere or ambient light stacked on top to flatten the frame.
|
|
6
6
|
// The torch point lights in `dungeon.ts` are the only other sources, and they carry no shadows.
|
|
7
7
|
import { Color, DirectionalLight, Object3D, PCFSoftShadowMap, type Scene, Vector3 } from "three";
|
|
8
|
+
import {
|
|
9
|
+
SUN_ILLUMINANCE,
|
|
10
|
+
SUN_KELVIN,
|
|
11
|
+
sunLight,
|
|
12
|
+
sunLightTransmittance,
|
|
13
|
+
temperatureColour,
|
|
14
|
+
} from "./atmosphere.js";
|
|
8
15
|
import { DUNGEON_CENTRE } from "./dungeon.js";
|
|
9
|
-
import { SUN_DIRECTION } from "./sky.js";
|
|
16
|
+
import { SKY_OPTIONS, SUN_DIRECTION } from "./sky.js";
|
|
17
|
+
|
|
18
|
+
/** The sun as Unreal's default level has it: 6 lux at 6500 K, tinted by the air it crosses. */
|
|
19
|
+
function atmosphereSun(): DirectionalLight {
|
|
20
|
+
const tint = temperatureColour(SUN_KELVIN);
|
|
21
|
+
const through = sunLightTransmittance(Math.asin(Math.min(1, Math.max(-1, SUN_DIRECTION.y))));
|
|
22
|
+
const colour = new Color().setRGB(
|
|
23
|
+
tint[0] * through[0],
|
|
24
|
+
tint[1] * through[1],
|
|
25
|
+
tint[2] * through[2],
|
|
26
|
+
);
|
|
27
|
+
const key = new DirectionalLight(colour, SUN_ILLUMINANCE);
|
|
28
|
+
// `gpuSky.ts` re-tints it when the sun moves.
|
|
29
|
+
sunLight.current = key;
|
|
30
|
+
return key;
|
|
31
|
+
}
|
|
10
32
|
|
|
11
33
|
type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
|
|
12
34
|
|
|
@@ -21,8 +43,9 @@ export function setupLighting(
|
|
|
21
43
|
renderer.shadowMap.enabled = true;
|
|
22
44
|
renderer.shadowMap.type = PCFSoftShadowMap;
|
|
23
45
|
|
|
24
|
-
// Warm white, matched by eye to the photographed midday sun against its own sky
|
|
25
|
-
|
|
46
|
+
// Warm white, matched by eye to the photographed midday sun against its own sky (owner
|
|
47
|
+
// The photo sky keeps the warm white matched by eye to its photographed midday sun.
|
|
48
|
+
const key = SKY_OPTIONS.sky === "photo" ? new DirectionalLight(0xfff1e0, 4.5) : atmosphereSun();
|
|
26
49
|
key.name = "key-light";
|
|
27
50
|
key.position.copy(SUN_DIRECTION).multiplyScalar(40);
|
|
28
51
|
// A directional light aims at its target, and the default target sits on the world origin — six
|
|
@@ -1,15 +1,6 @@
|
|
|
1
1
|
// Generated for you. Scene-owned material assignments; no engine appearance hooks.
|
|
2
|
-
import {
|
|
3
|
-
|
|
4
|
-
type DirectionalLight,
|
|
5
|
-
Material,
|
|
6
|
-
Mesh,
|
|
7
|
-
MeshStandardMaterial,
|
|
8
|
-
type Object3D,
|
|
9
|
-
type Scene,
|
|
10
|
-
type Texture,
|
|
11
|
-
} from "three";
|
|
12
|
-
import { type IBacklightControls, backlightMaterial } from "./backlightMaterial.js";
|
|
2
|
+
import type { Camera, DirectionalLight, Object3D, Scene, Texture } from "three";
|
|
3
|
+
import type { IBacklightControls } from "./backlightMaterial.js";
|
|
13
4
|
import {
|
|
14
5
|
type IEnvironmentMeasurement,
|
|
15
6
|
measureEnvironment,
|
|
@@ -2,6 +2,7 @@
|
|
|
2
2
|
// Neutral greys carry the light; one saturated blue marks what you can touch.
|
|
3
3
|
export const palette = {
|
|
4
4
|
/** Light grid: room floors and the ground the dungeon stands on. */
|
|
5
|
+
// Owner 2026-10-26 prefers the 7b546d6 neutral floor to the darker beige 0x98948e.
|
|
5
6
|
floor: 0xb4b1ae,
|
|
6
7
|
/** Dark grid: walls, door lintels, pillars — anything structural. */
|
|
7
8
|
structure: 0x747578,
|
|
@@ -1,8 +1,10 @@
|
|
|
1
|
+
import type { OutputRenderer } from "@threenative/core";
|
|
2
|
+
import { WorldEnvironment } from "@threenative/core";
|
|
1
3
|
// Generated for you: ordinary Three.js; ThreeNative does not read this file.
|
|
2
4
|
//
|
|
3
5
|
// This file wires two things together and decides nothing itself. `quality.ts`, in this folder,
|
|
4
|
-
// owns which stages run at which tier and records what each one measured. `WorldEnvironment
|
|
5
|
-
//
|
|
6
|
+
// owns which stages run at which tier and records what each one measured. `WorldEnvironment` from
|
|
7
|
+
// the core package builds them and prints `TN_WORLD_ENVIRONMENT` naming every stage as
|
|
6
8
|
// applied or refused **with a reason**, so a stage that silently no-op'd is never mistaken for
|
|
7
9
|
// one you turned off.
|
|
8
10
|
//
|
|
@@ -12,8 +14,6 @@
|
|
|
12
14
|
// `TN_QUALITY_TIER` names the tier that ran either way.
|
|
13
15
|
import type { Camera, DirectionalLight, Scene } from "three";
|
|
14
16
|
import { type QualityTier, qualityPreset, resolveQualityTier } from "./quality.js";
|
|
15
|
-
import type { OutputRenderer } from "./worldEnvironment.js";
|
|
16
|
-
import { WorldEnvironment } from "./worldEnvironment.js";
|
|
17
17
|
|
|
18
18
|
export function setupPost(
|
|
19
19
|
renderer: OutputRenderer,
|
|
@@ -10,13 +10,7 @@
|
|
|
10
10
|
import { BoxGeometry, CylinderGeometry, Group, type Material, Mesh } from "three";
|
|
11
11
|
import { RoundedBoxGeometry } from "three/addons/geometries/RoundedBoxGeometry.js";
|
|
12
12
|
import { mergeGeometries } from "three/addons/utils/BufferGeometryUtils.js";
|
|
13
|
-
import {
|
|
14
|
-
bladeMaterial,
|
|
15
|
-
flameMaterial,
|
|
16
|
-
propMaterial,
|
|
17
|
-
structureMaterial,
|
|
18
|
-
worldGridUVs,
|
|
19
|
-
} from "./materials.js";
|
|
13
|
+
import { bladeMaterial, propMaterial, structureMaterial, worldGridUVs } from "./materials.js";
|
|
20
14
|
|
|
21
15
|
/** The corner radius every solid in this game is cut with. */
|
|
22
16
|
export const BEVEL = 0.03;
|
|
@@ -34,7 +28,9 @@ export function solidBox(
|
|
|
34
28
|
material: Material,
|
|
35
29
|
radius = BEVEL,
|
|
36
30
|
): Mesh {
|
|
37
|
-
|
|
31
|
+
// One bevel segment: at 3 cm the second ring of a two-segment round is under a pixel from the
|
|
32
|
+
// top-down camera, and it triples the triangles of every wall in the main and the shadow pass.
|
|
33
|
+
const geometry = new RoundedBoxGeometry(size[0], size[1], size[2], 1, radius);
|
|
38
34
|
geometry.translate(at[0], at[1] + size[1] / 2 - radius, at[2]);
|
|
39
35
|
const mesh = new Mesh(worldGridUVs(geometry), material);
|
|
40
36
|
mesh.castShadow = true;
|
|
@@ -80,6 +76,12 @@ export function bakeByMaterial(parts: readonly Mesh[], into: Group, name: string
|
|
|
80
76
|
merged.castShadow = meshes[0]?.castShadow ?? true;
|
|
81
77
|
merged.receiveShadow = true;
|
|
82
78
|
into.add(merged);
|
|
79
|
+
// The merged mesh replaces its parts. Left in place they draw a second time, in the main and
|
|
80
|
+
// the shadow pass alike.
|
|
81
|
+
for (const mesh of meshes) {
|
|
82
|
+
mesh.removeFromParent();
|
|
83
|
+
mesh.geometry.dispose();
|
|
84
|
+
}
|
|
83
85
|
}
|
|
84
86
|
}
|
|
85
87
|
|
|
@@ -24,7 +24,14 @@
|
|
|
24
24
|
// frame. With the gather on, `playtests/play.playtest.json` measured **34.2 ms p95 against the
|
|
25
25
|
// 33 ms ceiling**; without it the same scenario passes. Turn it on when you replace the
|
|
26
26
|
// atmosphere with a flat sky, and read the p95 back out of `TN_FRAME_BUDGET`.
|
|
27
|
-
import
|
|
27
|
+
import {
|
|
28
|
+
type IWorldEnvironmentOptions,
|
|
29
|
+
qualityPreset as coreQualityPreset,
|
|
30
|
+
qualityTiers,
|
|
31
|
+
} from "@threenative/core";
|
|
32
|
+
import { exposureSettings } from "./exposure.js";
|
|
33
|
+
export type { QualityTier } from "@threenative/core";
|
|
34
|
+
import type { QualityTier } from "@threenative/core";
|
|
28
35
|
|
|
29
36
|
/**
|
|
30
37
|
* The three names this game's look comes in.
|
|
@@ -34,123 +41,64 @@ import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
|
|
|
34
41
|
* laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
|
|
35
42
|
* what any of them mean.
|
|
36
43
|
*/
|
|
37
|
-
export
|
|
38
|
-
|
|
39
|
-
const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
|
|
40
|
-
|
|
41
|
-
/**
|
|
42
|
-
* Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
|
|
43
|
-
* `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
|
|
44
|
-
*/
|
|
45
|
-
function isQualityTier(value: string): value is QualityTier {
|
|
46
|
-
return (QUALITY_TIERS as readonly string[]).includes(value);
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
/**
|
|
50
|
-
* Where each GPU family starts, from `ctx.renderer.gpuClass`.
|
|
51
|
-
*
|
|
52
|
-
* A start, not a ceiling: the measured frame-budget windows move the look from here, and an
|
|
53
|
-
* explicit `tier` above still wins. A class absent from this table — `unknown`, an adapter no
|
|
54
|
-
* family rule matched — falls back to the `mobile` flag, exactly as before families existed.
|
|
55
|
-
* Edit the right-hand side to change what a family looks like; nothing outside this file reads it.
|
|
56
|
-
*/
|
|
57
|
-
const START_TIER_BY_GPU_CLASS: Readonly<Record<string, QualityTier | undefined>> = {
|
|
58
|
-
software: "low",
|
|
59
|
-
"mobile-low": "low",
|
|
60
|
-
"mobile-mid": "low",
|
|
61
|
-
"mobile-high": "medium",
|
|
62
|
-
integrated: "medium",
|
|
63
|
-
discrete: "high",
|
|
64
|
-
};
|
|
65
|
-
|
|
66
|
-
/**
|
|
67
|
-
* Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
|
|
68
|
-
*
|
|
69
|
-
* Fails closed. An unrecognised tier name throws with the value it was handed rather than
|
|
70
|
-
* quietly rendering the default, because a silent fallback here looks exactly like a tier that
|
|
71
|
-
* turned out to have no effect.
|
|
72
|
-
*/
|
|
73
|
-
export function resolveQualityTier(
|
|
74
|
-
request: {
|
|
75
|
-
readonly gpuClass?: string;
|
|
76
|
-
readonly mobile?: boolean;
|
|
77
|
-
readonly software?: boolean;
|
|
78
|
-
readonly tier?: string;
|
|
79
|
-
} = {},
|
|
80
|
-
): QualityTier {
|
|
81
|
-
const requested = request.tier;
|
|
82
|
-
if (requested !== undefined) {
|
|
83
|
-
if (!isQualityTier(requested)) {
|
|
84
|
-
throw new Error(
|
|
85
|
-
`Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
86
|
-
);
|
|
87
|
-
}
|
|
88
|
-
return requested;
|
|
89
|
-
}
|
|
90
|
-
// A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
|
|
91
|
-
// game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
|
|
92
|
-
// drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
|
|
93
|
-
// fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
|
|
94
|
-
// `tier` above still wins over it.
|
|
95
|
-
if (request.software === true) return "low";
|
|
96
|
-
const family =
|
|
97
|
-
request.gpuClass === undefined ? undefined : START_TIER_BY_GPU_CLASS[request.gpuClass];
|
|
98
|
-
if (family !== undefined) return family;
|
|
99
|
-
return request.mobile === true ? "low" : "high";
|
|
100
|
-
}
|
|
44
|
+
export const resolveQualityTier = qualityTiers.resolve;
|
|
101
45
|
|
|
102
46
|
/**
|
|
103
|
-
*
|
|
104
|
-
*
|
|
105
|
-
*
|
|
106
|
-
* see `screenSpaceAA` in `worldEnvironment.ts`.
|
|
107
|
-
*
|
|
108
|
-
* No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
|
|
109
|
-
* captured sky (`sky.ts`), and SSR on rough floors traced speckle into the grid; RCAS then rang the
|
|
110
|
-
* smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
|
|
47
|
+
* Named overrides of core's Unreal look: the owner (2026-10-26) prefers the 7b546d6 neutral look,
|
|
48
|
+
* grey stone and pale floor with no yellow cast. `TN_WORLD_ENVIRONMENT` reports the tone curve and
|
|
49
|
+
* the exposure this runs; delete a line to take core's value back.
|
|
111
50
|
*/
|
|
112
|
-
const
|
|
113
|
-
//
|
|
114
|
-
|
|
115
|
-
bloomRadius: 0.6,
|
|
116
|
-
bloomStrength: 0.22,
|
|
117
|
-
bloomThreshold: 1,
|
|
51
|
+
export const neutralLook: IWorldEnvironmentOptions = {
|
|
52
|
+
// ACES at a fixed exposure: core's filmic curve and metered exposure read yellowish here.
|
|
53
|
+
tonemapMode: "aces",
|
|
118
54
|
autoExposureEnabled: false,
|
|
119
55
|
exposure: 0.62,
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
* every foot.
|
|
129
|
-
*/
|
|
130
|
-
const high: IWorldEnvironmentOptions = {
|
|
131
|
-
...shared,
|
|
132
|
-
// GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
|
|
133
|
-
gtaoEnabled: true,
|
|
56
|
+
// The kit's bloom: a low threshold that lifts the sunlit floor a little.
|
|
57
|
+
bloomRadius: 0.5,
|
|
58
|
+
bloomStrength: 0.7,
|
|
59
|
+
bloomThreshold: 0.2,
|
|
60
|
+
// The kit's contact occlusion: whole-frame, a 0.35 m reach, 16 directions (8 on medium).
|
|
61
|
+
gtaoDistanceExponent: 1,
|
|
62
|
+
gtaoDistanceFalloff: 1,
|
|
63
|
+
gtaoIndirectOnly: false,
|
|
134
64
|
gtaoRadius: 0.35,
|
|
65
|
+
gtaoSamples: 16,
|
|
66
|
+
// 4x MSAA under the chain on every tier.
|
|
67
|
+
samples: 4,
|
|
135
68
|
};
|
|
136
69
|
|
|
137
|
-
/** The
|
|
138
|
-
const
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
|
|
70
|
+
/** The 7b546d6 per-tier values: half the occlusion directions on medium, none of it on a phone. */
|
|
71
|
+
const neutralTiers: Readonly<Record<string, IWorldEnvironmentOptions>> = {
|
|
72
|
+
high: {},
|
|
73
|
+
medium: { gtaoSamples: 8 },
|
|
74
|
+
low: { gtaoEnabled: false, gtaoRadius: 0.25, motionBlurEnabled: false, temporalAA: false },
|
|
75
|
+
};
|
|
144
76
|
|
|
145
|
-
/**
|
|
77
|
+
/**
|
|
78
|
+
* The stages and strengths a tier turns on: the core preset, the neutral look above, this game's
|
|
79
|
+
* exposure policy and the named cost override: no gather, no reflections. The volumetric atmosphere already owns most
|
|
80
|
+
* of the frame; the performance scenario measured 39 to 42 ms GPU p95 with them on and about 1.5 ms
|
|
81
|
+
* of frame time without them. Remove the override when the atmosphere is replaced by a flat sky.
|
|
82
|
+
*/
|
|
146
83
|
export function qualityPreset(tier: string): IWorldEnvironmentOptions {
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
84
|
+
console.info(
|
|
85
|
+
`TN_RENDER_CHAIN_COST_OVERRIDE ${JSON.stringify({
|
|
86
|
+
reason:
|
|
87
|
+
"Action RPG: the volumetric atmosphere owns the frame; the gather and reflections took the performance scenario to 39-42 ms GPU p95",
|
|
88
|
+
finalGatherMethod: "none",
|
|
89
|
+
ssgiEnabled: false,
|
|
90
|
+
ssrEnabled: false,
|
|
91
|
+
})}`,
|
|
92
|
+
);
|
|
93
|
+
return {
|
|
94
|
+
...coreQualityPreset(tier),
|
|
95
|
+
...neutralLook,
|
|
96
|
+
...neutralTiers[tier],
|
|
97
|
+
exposurePolicy: exposureSettings,
|
|
98
|
+
finalGatherMethod: "none",
|
|
99
|
+
ssgiEnabled: false,
|
|
100
|
+
ssrEnabled: false,
|
|
101
|
+
};
|
|
154
102
|
}
|
|
155
103
|
|
|
156
104
|
/** First admitted material lane: high desktop hardware WebGPU in the browser only. */
|
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
2
|
//
|
|
3
|
+
// The default sky is Unreal 5.8.3's default level: a Sky Atmosphere with its volumetric cloud layer, a
|
|
4
|
+
// sky light that captures it, a sun tinted by the air it crosses, and an exponential height fog that
|
|
5
|
+
// takes its colour from the sky (`atmosphere.ts`, `clouds.ts`, `gpuSky.ts`). Sun, sky and fog read one
|
|
6
|
+
// illuminance, so moving `SUN_DIRECTION` recolours all three together. `SKY_OPTIONS.sky = "photo"`
|
|
7
|
+
// keeps the photograph below; `clouds: false` keeps a clear sky.
|
|
8
|
+
//
|
|
3
9
|
// The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
|
|
4
10
|
// by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
|
|
5
11
|
// The same image is the background, the environment light every surface reflects and is filled by,
|
|
@@ -13,6 +19,7 @@ import {
|
|
|
13
19
|
type Texture,
|
|
14
20
|
Vector3,
|
|
15
21
|
} from "three";
|
|
22
|
+
import { createGpuSky } from "./gpuSky.js";
|
|
16
23
|
import { HEIGHT_FOG, type HeightFogParams, heightFogDepth, heightFogNode } from "./heightFog.js";
|
|
17
24
|
import { palette } from "./palette.js";
|
|
18
25
|
|
|
@@ -42,10 +49,11 @@ function distanceDensity(p: HeightFogParams = HEIGHT_FOG): number {
|
|
|
42
49
|
return Math.sqrt(Math.max(0, old - height)) / distance;
|
|
43
50
|
}
|
|
44
51
|
|
|
45
|
-
|
|
52
|
+
function setupPhotoSky(scene: Scene, sky: Texture): void {
|
|
46
53
|
sky.mapping = EquirectangularReflectionMapping;
|
|
47
54
|
sky.colorSpace = SRGBColorSpace;
|
|
48
55
|
scene.background = sky;
|
|
56
|
+
// The full range: owner 2026-10-26 prefers the 7b546d6 neutral look to the dimmed 0.8 / 0.45 sky.
|
|
49
57
|
scene.backgroundIntensity = SKY_RANGE;
|
|
50
58
|
// three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
|
|
51
59
|
// It is what makes a standard material read as a material: sky-blue fill on faces the sun
|
|
@@ -59,3 +67,68 @@ export function setupSky(scene: Scene, sky: Texture): void {
|
|
|
59
67
|
scene.fog = distanceFog;
|
|
60
68
|
scene.fogNode = heightFogNode(distanceFog, HEIGHT_FOG, SUN_DIRECTION);
|
|
61
69
|
}
|
|
70
|
+
|
|
71
|
+
export const SKY_OPTIONS: { sky: "atmosphere" | "photo"; clouds: boolean; ground: boolean } = {
|
|
72
|
+
sky: "atmosphere",
|
|
73
|
+
clouds: true,
|
|
74
|
+
// The sunlit ground below the horizon stands in for Unreal's Lumen floor bounce: it lifts shadow
|
|
75
|
+
// sides and a mirror reflects it. Set false when the game adds its own global illumination.
|
|
76
|
+
ground: true,
|
|
77
|
+
};
|
|
78
|
+
|
|
79
|
+
/**
|
|
80
|
+
* Unreal's default level fog in metres: density and falloff are per 1000 cm (x0.1 per metre), and its
|
|
81
|
+
* line integral carries ln2 against the exact integral `heightFog.ts` evaluates. `fogHeight` sits
|
|
82
|
+
* 68.5 m below the floor, where the default level puts the fog actor. Inscattering is black and the
|
|
83
|
+
* start distance 0, as in Unreal: the colour comes from the sky.
|
|
84
|
+
*/
|
|
85
|
+
const ATMOSPHERE_FOG = {
|
|
86
|
+
...HEIGHT_FOG,
|
|
87
|
+
density: 0.00436 * Math.LN2,
|
|
88
|
+
heightFalloff: 0.02,
|
|
89
|
+
fogHeight: -68.5,
|
|
90
|
+
startDistance: 0,
|
|
91
|
+
};
|
|
92
|
+
|
|
93
|
+
/** White in the 8-bit environment is this much scene radiance (`createGpuSky`). */
|
|
94
|
+
const ENVIRONMENT_RANGE = 4;
|
|
95
|
+
|
|
96
|
+
/**
|
|
97
|
+
* `photo` is only read when `SKY_OPTIONS.sky` is "photo". `fogged` false leaves the sky unfogged;
|
|
98
|
+
* `clouds` false draws the clear atmosphere. A software adapter draws the 64 x 32 bake as the
|
|
99
|
+
* background, with no LUT or cloud passes.
|
|
100
|
+
*/
|
|
101
|
+
export function setupSky(
|
|
102
|
+
scene: Scene,
|
|
103
|
+
photo?: Texture,
|
|
104
|
+
software = false,
|
|
105
|
+
fogged = true,
|
|
106
|
+
clouds = SKY_OPTIONS.clouds,
|
|
107
|
+
): void {
|
|
108
|
+
if (SKY_OPTIONS.sky === "photo") {
|
|
109
|
+
if (photo === undefined) throw new Error('SKY_OPTIONS.sky "photo" needs assets/sky.jpg loaded');
|
|
110
|
+
setupPhotoSky(scene, photo);
|
|
111
|
+
return;
|
|
112
|
+
}
|
|
113
|
+
// Height fog only; FogExp2 holds the colour `heightFogNode` reads, at zero density. `createGpuSky`
|
|
114
|
+
// sets that colour from the sky and again whenever the sun moves.
|
|
115
|
+
const fog = new FogExp2(0xffffff, 0);
|
|
116
|
+
scene.fog = fog;
|
|
117
|
+
scene.fogNode = heightFogNode(fog, { ...ATMOSPHERE_FOG }, SUN_DIRECTION);
|
|
118
|
+
const { node, environment } = createGpuSky(
|
|
119
|
+
scene,
|
|
120
|
+
SUN_DIRECTION,
|
|
121
|
+
fogged,
|
|
122
|
+
clouds,
|
|
123
|
+
ATMOSPHERE_FOG,
|
|
124
|
+
SKY_OPTIONS.ground,
|
|
125
|
+
);
|
|
126
|
+
environment.mapping = EquirectangularReflectionMapping;
|
|
127
|
+
environment.colorSpace = SRGBColorSpace;
|
|
128
|
+
scene.background = environment;
|
|
129
|
+
scene.backgroundNode = software ? null : node.backgroundNode;
|
|
130
|
+
scene.backgroundIntensity = software ? ENVIRONMENT_RANGE : 1;
|
|
131
|
+
// Unreal's sky light: the same sky, so the fill on every shaded face is the sky's colour.
|
|
132
|
+
scene.environment = environment;
|
|
133
|
+
scene.environmentIntensity = ENVIRONMENT_RANGE;
|
|
134
|
+
}
|
|
@@ -30,7 +30,7 @@ import {
|
|
|
30
30
|
isWebGLFallbackRenderer,
|
|
31
31
|
materialLightingEnabled,
|
|
32
32
|
} from "../render/quality.js";
|
|
33
|
-
import { setupSky } from "../render/sky.js";
|
|
33
|
+
import { SKY_OPTIONS, setupSky } from "../render/sky.js";
|
|
34
34
|
import { TouchControls } from "../render/touch-controls.js";
|
|
35
35
|
import {
|
|
36
36
|
type IActionRpgVfxOptions,
|
|
@@ -107,9 +107,10 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
107
107
|
// is a constructor call and never a second file to cook.
|
|
108
108
|
[this.#mannequin, this.#sky] = await Promise.all([
|
|
109
109
|
ctx.assets.model<IMannequin>("mannequin-combat.glb"),
|
|
110
|
-
|
|
110
|
+
// Only the photo-sky override reads the photograph; the atmosphere sky is computed.
|
|
111
|
+
SKY_OPTIONS.sky === "photo" ? ctx.assets.texture("sky.jpg") : undefined,
|
|
111
112
|
]);
|
|
112
|
-
setupSky(ctx.scene, this.#sky);
|
|
113
|
+
setupSky(ctx.scene, this.#sky, ctx.renderer.softwareAdapter !== undefined);
|
|
113
114
|
this.#environmentSample = await sampleEnvironment(ctx.renderer.raw, ctx.scene, {
|
|
114
115
|
web: getPlatform().runtime === "web",
|
|
115
116
|
rendererKind: ctx.renderer.kind,
|
|
@@ -121,14 +122,14 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
121
122
|
|
|
122
123
|
override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
|
|
123
124
|
const mannequin = this.#mannequin;
|
|
124
|
-
if (mannequin === undefined
|
|
125
|
-
throw new Error("Play.enter ran before load() loaded mannequin-combat.glb
|
|
125
|
+
if (mannequin === undefined)
|
|
126
|
+
throw new Error("Play.enter ran before load() loaded mannequin-combat.glb.");
|
|
126
127
|
const restored = loadProgress(Play.initialState);
|
|
127
128
|
ctx.state.set(restored);
|
|
128
129
|
ctx.state.flush();
|
|
129
130
|
|
|
130
131
|
const camera = ctx.camera as PerspectiveCamera;
|
|
131
|
-
setupSky(ctx.scene, this.#sky);
|
|
132
|
+
setupSky(ctx.scene, this.#sky, ctx.renderer.softwareAdapter !== undefined);
|
|
132
133
|
const lighting = setupLighting(
|
|
133
134
|
ctx.scene,
|
|
134
135
|
ctx.renderer.raw as Parameters<typeof setupLighting>[1],
|
|
@@ -187,6 +188,8 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
187
188
|
inventory.add("rusted-blade", 1);
|
|
188
189
|
inventory.add("ember-blade", 1);
|
|
189
190
|
inventory.add("potion", 2);
|
|
191
|
+
// The hero starts with the rusted blade in hand, so the HUD names the sword the figure holds.
|
|
192
|
+
inventory.equip("rusted-blade");
|
|
190
193
|
}
|
|
191
194
|
|
|
192
195
|
const playerRef: { value?: Player } = {};
|
|
@@ -509,13 +512,14 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
509
512
|
if (frameCtx.input.justPressed("lethal")) player.takeDamage(player.health + 1);
|
|
510
513
|
if (frameCtx.input.justPressed("damage")) player.takeDamage(18);
|
|
511
514
|
const touch = touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size);
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
+
// A fallen hero swings, casts and rolls no more: the run is over, not the input.
|
|
516
|
+
if (!player.dead) {
|
|
517
|
+
if (frameCtx.input.justPressed("attack") || touch?.attackPressed === true)
|
|
518
|
+
player.strike(() => strike(Math.round(damageStats.value(elapsed))));
|
|
519
|
+
if (frameCtx.input.justPressed("ability") || touch?.abilityPressed === true) ability.cast();
|
|
520
|
+
if (frameCtx.input.justPressed("dodge") && player.dodge())
|
|
521
|
+
emitPlaytestEvent({ entity: "player", name: "dodged" });
|
|
515
522
|
}
|
|
516
|
-
if (frameCtx.input.justPressed("ability") || touch?.abilityPressed === true) ability.cast();
|
|
517
|
-
if (frameCtx.input.justPressed("dodge") && player.dodge())
|
|
518
|
-
emitPlaytestEvent({ entity: "player", name: "dodged" });
|
|
519
523
|
if (frameCtx.input.justPressed("equip")) {
|
|
520
524
|
if (inventory.equip("ember-blade")) {
|
|
521
525
|
syncEquipmentStat();
|
|
@@ -1,6 +1,11 @@
|
|
|
1
1
|
import { useUiState } from "@threenative/ui";
|
|
2
|
+
import { ITEMS } from "../items/Inventory.js";
|
|
2
3
|
import type { GameState } from "../state.js";
|
|
3
4
|
|
|
5
|
+
function itemLabel(itemId: string): string {
|
|
6
|
+
return Object.values(ITEMS).find((item) => item.id === itemId)?.label ?? "none";
|
|
7
|
+
}
|
|
8
|
+
|
|
4
9
|
export function CharacterPanel() {
|
|
5
10
|
const state = useUiState<GameState>();
|
|
6
11
|
// Nothing to draw until the game publishes its first snapshot, a few milliseconds in.
|
|
@@ -15,7 +20,7 @@ export function CharacterPanel() {
|
|
|
15
20
|
<div className="text-amber">character</div>
|
|
16
21
|
<div className="mt-3 flex justify-between text-dim">
|
|
17
22
|
<span>health</span>
|
|
18
|
-
<span className="text-
|
|
23
|
+
<span className="text-text">{Math.round(health)} / 100</span>
|
|
19
24
|
</div>
|
|
20
25
|
<div className="mt-1 h-1 bg-void">
|
|
21
26
|
<i className="block h-full bg-cyan" style={{ width: `${Math.max(0, health)}%` }} />
|
|
@@ -25,7 +30,7 @@ export function CharacterPanel() {
|
|
|
25
30
|
<span className="text-text">{Math.round(damage)}</span>
|
|
26
31
|
</div>
|
|
27
32
|
<div className="mt-2 border-t border-line pt-2 text-dim">
|
|
28
|
-
weapon <span className="text-text">{equipped
|
|
33
|
+
weapon <span className="text-text">{itemLabel(equipped)}</span>
|
|
29
34
|
</div>
|
|
30
35
|
<div className="mt-1 text-dim">last hit {Math.round(lastDamage)}</div>
|
|
31
36
|
</aside>
|
|
@@ -9,16 +9,14 @@ export function Hud() {
|
|
|
9
9
|
const room = state.room;
|
|
10
10
|
const phase = state.phase;
|
|
11
11
|
const enemies = state.enemiesDefeated;
|
|
12
|
-
const blocked = state.lineOfSightBlocked;
|
|
13
12
|
return (
|
|
14
|
-
<section
|
|
13
|
+
<section
|
|
14
|
+
id="run-hud"
|
|
15
|
+
className="pointer-events-none absolute left-6 top-5 w-72 rounded bg-black/70 p-3 text-[10px] uppercase tracking-[0.16em]"
|
|
16
|
+
>
|
|
15
17
|
<div className="text-dim">grid dungeon / action rpg</div>
|
|
16
18
|
<div className="mt-2 text-3xl leading-none text-amber">room {room} / 3</div>
|
|
17
|
-
<div className="mt-2 text-
|
|
18
|
-
<div className="mt-2 flex justify-between border-t border-line pt-2 text-dim">
|
|
19
|
-
<span>defeated {enemies}</span>
|
|
20
|
-
<span>wall ray {blocked === 1 ? "blocked" : "clear"}</span>
|
|
21
|
-
</div>
|
|
19
|
+
<div className="mt-2 border-t border-line pt-2 text-dim">defeated {enemies}</div>
|
|
22
20
|
{phase !== "playing" && (
|
|
23
21
|
<div
|
|
24
22
|
className={`mt-4 border px-3 py-2 text-center text-sm tracking-[0.28em] ${phase === "won" ? "border-amber text-amber" : "border-red text-red"}`}
|
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
import { useUiState } from "@threenative/ui";
|
|
2
|
+
import { ITEMS } from "../items/Inventory.js";
|
|
2
3
|
import type { GameState } from "../state.js";
|
|
3
4
|
|
|
4
5
|
export function InventoryPanel() {
|
|
@@ -6,27 +7,26 @@ export function InventoryPanel() {
|
|
|
6
7
|
// Nothing to draw until the game publishes its first snapshot, a few milliseconds in.
|
|
7
8
|
// Rendering zeroes instead would put wrong numbers on screen and then correct them.
|
|
8
9
|
if (state === undefined) return null;
|
|
9
|
-
const
|
|
10
|
+
const slots = state.inventorySlots;
|
|
10
11
|
const refused = state.inventoryFullRefused;
|
|
11
12
|
const pending = state.pendingLoot;
|
|
12
|
-
|
|
13
|
+
// A stack holds three potions, so four potions fill two slots — but the player owns one kind of
|
|
14
|
+
// item, so the list shows one row per item with its total and the header counts the slots.
|
|
15
|
+
const totals = new Map<string, number>();
|
|
16
|
+
for (const slot of slots) totals.set(slot.itemId, (totals.get(slot.itemId) ?? 0) + slot.quantity);
|
|
13
17
|
return (
|
|
14
18
|
<aside className="pointer-events-none absolute bottom-6 right-6 w-64 border border-line bg-panel/90 p-3 text-[10px] uppercase tracking-[0.14em]">
|
|
15
19
|
<div className="flex justify-between text-amber">
|
|
16
20
|
<span>inventory</span>
|
|
17
|
-
<span className="text-dim">{
|
|
21
|
+
<span className="text-dim">{slots.length} / 6 slots</span>
|
|
18
22
|
</div>
|
|
19
|
-
<div className="mt-3 space-y-1 text-dim">
|
|
20
|
-
{
|
|
21
|
-
{
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
{item}
|
|
27
|
-
</div>
|
|
28
|
-
);
|
|
29
|
-
})}
|
|
23
|
+
<div id="inventory-items" className="mt-3 space-y-1 text-dim">
|
|
24
|
+
{totals.size === 0 && <div>empty</div>}
|
|
25
|
+
{[...totals].map(([itemId, quantity]) => (
|
|
26
|
+
<div className="border-b border-line/60 pb-1 text-text" key={itemId}>
|
|
27
|
+
{Object.values(ITEMS).find((item) => item.id === itemId)?.label ?? itemId} x{quantity}
|
|
28
|
+
</div>
|
|
29
|
+
))}
|
|
30
30
|
</div>
|
|
31
31
|
{refused === 1 && (
|
|
32
32
|
<div className="mt-2 border border-red px-2 py-1 text-red">
|
|
@@ -43,6 +43,9 @@ const config: IThreeNativeConfig = {
|
|
|
43
43
|
// extra pass; set it false for a deliberately hard-edged look. `TN_ALPHA_ANTIALIASING`
|
|
44
44
|
// reports what it did, and says so when a single-sampled surface leaves it nothing to do.
|
|
45
45
|
alphaAntialiasing: true,
|
|
46
|
+
// The authored props are unique (geometry, material) pairs; the batching projection measures
|
|
47
|
+
// `notWorthwhile` and falls back, so the game states the opt-out instead of paying its scan.
|
|
48
|
+
projection: false,
|
|
46
49
|
},
|
|
47
50
|
// One UI on every target: src/ui/ renders through the platform's own browser-class renderer,
|
|
48
51
|
// so the same React, Tailwind, CSS and SVG run on web, desktop, Android and iOS alike.
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
[mcp_servers.threenative-assets]
|
|
2
|
+
command = "node"
|
|
3
|
+
args = ["./node_modules/@threenative/core/mcp/assets.mjs"]
|
|
4
|
+
|
|
5
|
+
[mcp_servers.threenative-assets.env]
|
|
6
|
+
ASSET_DOWNLOAD_DIR = "./public/assets"
|
|
7
|
+
AUDIO_DOWNLOAD_DIR = "./public/audio"
|
|
8
|
+
|
|
9
|
+
[mcp_servers.threenative-sculpt]
|
|
10
|
+
command = "node"
|
|
11
|
+
args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
|
|
12
|
+
|
|
13
|
+
[mcp_servers.threenative-engine]
|
|
14
|
+
command = "node"
|
|
15
|
+
args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
|
|
16
|
+
|
|
17
|
+
[mcp_servers.threenative-animation]
|
|
18
|
+
command = "node"
|
|
19
|
+
args = ["./node_modules/@threenative/core/mcp/animation.mjs"]
|
|
20
|
+
|
|
21
|
+
[mcp_servers.threenative-devtools]
|
|
22
|
+
command = "node"
|
|
23
|
+
args = ["./node_modules/@threenative/core/mcp/devtools.mjs"]
|