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,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,
|
|
@@ -9,7 +9,7 @@ export const palette = {
|
|
|
9
9
|
/** Beyond the walls, and the fog the far corners fade into. Almost black, faintly blue. */
|
|
10
10
|
void: 0x0a0e16,
|
|
11
11
|
/** The flagstone floor. */
|
|
12
|
-
floor:
|
|
12
|
+
floor: 0x44587a,
|
|
13
13
|
/** The plaster band the lantern light lands on — the one warm surface that is not a crate. */
|
|
14
14
|
wall: 0xbb9155,
|
|
15
15
|
/** Pillars, capping rail, lantern housings. */
|
|
@@ -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,
|
|
@@ -20,7 +20,14 @@
|
|
|
20
20
|
// expensive stage in the reference ablation by a factor of two (~9.2 ms of a 14.7 ms frame with
|
|
21
21
|
// its two denoise passes); in a room this dark, one bounce of indirect light off a flagstone floor
|
|
22
22
|
// buys nothing the three lanterns do not already put there.
|
|
23
|
-
import
|
|
23
|
+
import {
|
|
24
|
+
type IWorldEnvironmentOptions,
|
|
25
|
+
qualityPreset as coreQualityPreset,
|
|
26
|
+
qualityTiers,
|
|
27
|
+
} from "@threenative/core";
|
|
28
|
+
import { exposureSettings } from "./exposure.js";
|
|
29
|
+
export type { QualityTier } from "@threenative/core";
|
|
30
|
+
import type { QualityTier } from "@threenative/core";
|
|
24
31
|
|
|
25
32
|
/**
|
|
26
33
|
* The three names this game's look comes in.
|
|
@@ -30,162 +37,46 @@ import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
|
|
|
30
37
|
* laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
|
|
31
38
|
* what any of them mean.
|
|
32
39
|
*/
|
|
33
|
-
export
|
|
34
|
-
|
|
35
|
-
const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
|
|
36
|
-
|
|
37
|
-
/**
|
|
38
|
-
* Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
|
|
39
|
-
* `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
|
|
40
|
-
*/
|
|
41
|
-
function isQualityTier(value: string): value is QualityTier {
|
|
42
|
-
return (QUALITY_TIERS as readonly string[]).includes(value);
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
/**
|
|
46
|
-
* Where each GPU family starts, from `ctx.renderer.gpuClass`.
|
|
47
|
-
*
|
|
48
|
-
* A start, not a ceiling: the measured frame-budget windows move the look from here, and an
|
|
49
|
-
* explicit `tier` above still wins. A class absent from this table — `unknown`, an adapter no
|
|
50
|
-
* family rule matched — falls back to the `mobile` flag, exactly as before families existed.
|
|
51
|
-
* Edit the right-hand side to change what a family looks like; nothing outside this file reads it.
|
|
52
|
-
*/
|
|
53
|
-
const START_TIER_BY_GPU_CLASS: Readonly<Record<string, QualityTier | undefined>> = {
|
|
54
|
-
software: "low",
|
|
55
|
-
"mobile-low": "low",
|
|
56
|
-
"mobile-mid": "low",
|
|
57
|
-
"mobile-high": "medium",
|
|
58
|
-
integrated: "medium",
|
|
59
|
-
discrete: "high",
|
|
60
|
-
};
|
|
61
|
-
|
|
62
|
-
/**
|
|
63
|
-
* Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
|
|
64
|
-
*
|
|
65
|
-
* Fails closed. An unrecognised tier name throws with the value it was handed rather than
|
|
66
|
-
* quietly rendering the default, because a silent fallback here looks exactly like a tier that
|
|
67
|
-
* turned out to have no effect.
|
|
68
|
-
*/
|
|
69
|
-
export function resolveQualityTier(
|
|
70
|
-
request: {
|
|
71
|
-
readonly gpuClass?: string;
|
|
72
|
-
readonly mobile?: boolean;
|
|
73
|
-
readonly software?: boolean;
|
|
74
|
-
readonly tier?: string;
|
|
75
|
-
} = {},
|
|
76
|
-
): QualityTier {
|
|
77
|
-
const requested = request.tier;
|
|
78
|
-
if (requested !== undefined) {
|
|
79
|
-
if (!isQualityTier(requested)) {
|
|
80
|
-
throw new Error(
|
|
81
|
-
`Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
|
|
82
|
-
);
|
|
83
|
-
}
|
|
84
|
-
return requested;
|
|
85
|
-
}
|
|
86
|
-
// A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
|
|
87
|
-
// game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
|
|
88
|
-
// drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
|
|
89
|
-
// fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
|
|
90
|
-
// `tier` above still wins over it.
|
|
91
|
-
if (request.software === true) return "low";
|
|
92
|
-
const family =
|
|
93
|
-
request.gpuClass === undefined ? undefined : START_TIER_BY_GPU_CLASS[request.gpuClass];
|
|
94
|
-
if (family !== undefined) return family;
|
|
95
|
-
return request.mobile === true ? "low" : "high";
|
|
96
|
-
}
|
|
40
|
+
export const resolveQualityTier = qualityTiers.resolve;
|
|
97
41
|
|
|
98
42
|
/**
|
|
99
|
-
* The
|
|
100
|
-
*
|
|
101
|
-
*
|
|
102
|
-
*
|
|
103
|
-
*
|
|
43
|
+
* The stages and strengths a tier turns on: the core preset, this game's exposure policy and the
|
|
44
|
+
* named cost override from the header: no final gather, no SSGI, no SSR. Forty-five simulated bodies
|
|
45
|
+
* are already the frame's budget, and one bounce off a flagstone floor adds nothing the lanterns do
|
|
46
|
+
* not already put there. The core stack's motion blur, full-resolution occlusion, local exposure and
|
|
47
|
+
* Unreal bloom each added a few milliseconds to the performance scenario on an RTX 2080 and took its
|
|
48
|
+
* GPU p95 past 16.7 ms; all four are off, and the kit's own bloom keeps the lantern glow. Remove an
|
|
49
|
+
* override and read `TN_FRAME_BUDGET` when the room gets cheaper.
|
|
104
50
|
*/
|
|
105
|
-
const shared: IWorldEnvironmentOptions = {
|
|
106
|
-
// ~4.6 ms in the ablation named above, at that scene's own strength.
|
|
107
|
-
bloomEnabled: true,
|
|
108
|
-
bloomRadius: 0.42,
|
|
109
|
-
bloomStrength: 0.5,
|
|
110
|
-
// High, on purpose: the lantern flames and the seal plate clear it and nothing lit does.
|
|
111
|
-
bloomThreshold: 0.85,
|
|
112
|
-
autoExposureEnabled: false,
|
|
113
|
-
exposure: 1.06,
|
|
114
|
-
tonemapMode: "aces",
|
|
115
|
-
vignetteAmount: 0.34,
|
|
116
|
-
};
|
|
117
|
-
|
|
118
|
-
/**
|
|
119
|
-
* What a desktop gets.
|
|
120
|
-
*
|
|
121
|
-
* Contact occlusion, because a pile of forty crates is nothing but contacts, and a sharpen pass,
|
|
122
|
-
* because RCAS is what puts the edge back on the plank braces the occlusion pass softens.
|
|
123
|
-
*/
|
|
124
|
-
const high: IWorldEnvironmentOptions = {
|
|
125
|
-
...shared,
|
|
126
|
-
// Contact scale, in metres. A crate is 0.92 m, so half a metre gathers the crease where two
|
|
127
|
-
// crates meet and the shadow where one meets the floor, and no further.
|
|
128
|
-
// unmeasured in that ablation — it is not one of the five stages it measured.
|
|
129
|
-
gtaoEnabled: true,
|
|
130
|
-
gtaoRadius: 0.5,
|
|
131
|
-
gtaoResolutionScale: 0.5,
|
|
132
|
-
gtaoSamples: 12,
|
|
133
|
-
gtaoScale: 1.25,
|
|
134
|
-
// unmeasured in that ablation, as with GTAO. RCAS is a radius: 0.95 is nearly full sharpening.
|
|
135
|
-
sharpenEnabled: true,
|
|
136
|
-
sharpenStrength: 0.95,
|
|
137
|
-
};
|
|
138
|
-
|
|
139
|
-
/** A machine between the two: the same look with a cheaper occlusion gather. */
|
|
140
|
-
const medium: IWorldEnvironmentOptions = {
|
|
141
|
-
...shared,
|
|
142
|
-
// The chain's own quality tier: without it the renderer keeps its `high` default at this tier.
|
|
143
|
-
renderChainTier: "medium",
|
|
144
|
-
bloomRadius: 0.38,
|
|
145
|
-
bloomStrength: 0.56,
|
|
146
|
-
bloomThreshold: 0.84,
|
|
147
|
-
exposure: 1.05,
|
|
148
|
-
// unmeasured, as at `high`; this tier is the same gather at fewer samples.
|
|
149
|
-
gtaoEnabled: true,
|
|
150
|
-
gtaoRadius: 0.45,
|
|
151
|
-
gtaoResolutionScale: 0.4,
|
|
152
|
-
gtaoSamples: 8,
|
|
153
|
-
gtaoScale: 1.2,
|
|
154
|
-
sharpenEnabled: false,
|
|
155
|
-
vignetteAmount: 0.3,
|
|
156
|
-
};
|
|
157
|
-
|
|
158
|
-
/**
|
|
159
|
-
* What a phone gets: bloom and a vignette, no screen-space gather at all. The occlusion is the
|
|
160
|
-
* first thing to go — forty simulated bodies are already the frame's budget on a phone.
|
|
161
|
-
*/
|
|
162
|
-
const low: IWorldEnvironmentOptions = {
|
|
163
|
-
// The chain's own quality tier, separate from which stages this preset enables: without it
|
|
164
|
-
// the renderer keeps its `high` default at every tier, so a CPU adapter's low preset still
|
|
165
|
-
// paid for the high chain's denoise and slice counts.
|
|
166
|
-
renderChainTier: "low",
|
|
167
|
-
// ~4.6 ms in the ablation named above, at that scene's own strength.
|
|
168
|
-
bloomEnabled: true,
|
|
169
|
-
bloomRadius: 0.32,
|
|
170
|
-
bloomStrength: 0.48,
|
|
171
|
-
bloomThreshold: 0.86,
|
|
172
|
-
exposure: 1.04,
|
|
173
|
-
gtaoEnabled: false,
|
|
174
|
-
sharpenEnabled: false,
|
|
175
|
-
vignetteAmount: 0.28,
|
|
176
|
-
};
|
|
177
|
-
|
|
178
|
-
const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
|
|
179
|
-
|
|
180
|
-
/** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
|
|
181
51
|
export function qualityPreset(tier: string): IWorldEnvironmentOptions {
|
|
182
|
-
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
52
|
+
console.info(
|
|
53
|
+
`TN_RENDER_CHAIN_COST_OVERRIDE ${JSON.stringify({
|
|
54
|
+
reason:
|
|
55
|
+
"Puzzle: forty-five simulated bodies are the frame budget; the core gather, motion blur, full-resolution occlusion, local exposure and Unreal bloom took the performance scenario past 16.7 ms GPU p95",
|
|
56
|
+
finalGatherMethod: "none",
|
|
57
|
+
ssgiEnabled: false,
|
|
58
|
+
ssrEnabled: false,
|
|
59
|
+
motionBlurEnabled: false,
|
|
60
|
+
gtaoResolutionScale: 0.5,
|
|
61
|
+
localExposureEnabled: false,
|
|
62
|
+
unrealBloomEnabled: false,
|
|
63
|
+
})}`,
|
|
64
|
+
);
|
|
65
|
+
return {
|
|
66
|
+
...coreQualityPreset(tier),
|
|
67
|
+
exposurePolicy: exposureSettings,
|
|
68
|
+
finalGatherMethod: "none",
|
|
69
|
+
ssgiEnabled: false,
|
|
70
|
+
ssrEnabled: false,
|
|
71
|
+
motionBlurEnabled: false,
|
|
72
|
+
gtaoResolutionScale: 0.5,
|
|
73
|
+
localExposureEnabled: false,
|
|
74
|
+
// The kit's own bloom: a high threshold, so only the lantern flames and the seal plate glow.
|
|
75
|
+
unrealBloomEnabled: false,
|
|
76
|
+
bloomRadius: 0.42,
|
|
77
|
+
bloomStrength: 0.5,
|
|
78
|
+
bloomThreshold: 0.85,
|
|
79
|
+
};
|
|
189
80
|
}
|
|
190
81
|
|
|
191
82
|
/** First admitted material lane: high desktop hardware WebGPU in the browser only. */
|
|
@@ -116,6 +116,14 @@ export function createVaultRoom(): IVaultRoom {
|
|
|
116
116
|
: { x: span.sign * (VAULT.halfX + VAULT.wallThickness / 2), z: 0 };
|
|
117
117
|
const size = (width: number, depth: number) => (alongX ? [width, depth] : [depth, width]);
|
|
118
118
|
|
|
119
|
+
// The wall nearest the lens is cut down to a kerb. The camera looks over it, so a full wall
|
|
120
|
+
// stands between the lens and the warden (a small figure, chest at about 0.45 m) whenever she
|
|
121
|
+
// walks along it, and it hides any crate shoved against it: `camera-sees-subject` found that.
|
|
122
|
+
// The portrait loses only the band of plaster along the bottom of the frame.
|
|
123
|
+
const nearest = span.axis === "z" && span.sign === 1;
|
|
124
|
+
const plasterHeight = nearest ? 0.34 : 1.14;
|
|
125
|
+
const railHeight = nearest ? 0 : 0.34;
|
|
126
|
+
|
|
119
127
|
const [plinthW, plinthD] = size(span.length, VAULT.wallThickness);
|
|
120
128
|
const plinth = block(plinthW as number, 0.46, plinthD as number, wallBaseMaterial, {
|
|
121
129
|
radius: 0.06,
|
|
@@ -124,16 +132,20 @@ export function createVaultRoom(): IVaultRoom {
|
|
|
124
132
|
root.add(plinth);
|
|
125
133
|
|
|
126
134
|
const [plasterW, plasterD] = size(span.length, VAULT.wallThickness * 0.86);
|
|
127
|
-
const plaster = block(plasterW as number,
|
|
135
|
+
const plaster = block(plasterW as number, plasterHeight, plasterD as number, wallMaterial, {
|
|
128
136
|
radius: 0.05,
|
|
129
137
|
});
|
|
130
|
-
plaster.position.set(centre.x,
|
|
138
|
+
plaster.position.set(centre.x, 0.46 + plasterHeight / 2, centre.z);
|
|
131
139
|
root.add(plaster);
|
|
132
140
|
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
141
|
+
if (railHeight > 0) {
|
|
142
|
+
const [railW, railD] = size(span.length, VAULT.wallThickness * 1.16);
|
|
143
|
+
const rail = block(railW as number, railHeight, railD as number, timberMaterial, {
|
|
144
|
+
radius: 0.07,
|
|
145
|
+
});
|
|
146
|
+
rail.position.set(centre.x, 0.46 + plasterHeight + railHeight / 2, centre.z);
|
|
147
|
+
root.add(rail);
|
|
148
|
+
}
|
|
137
149
|
|
|
138
150
|
solids.push({
|
|
139
151
|
depth: alongX ? VAULT.wallThickness : outerZ * 2,
|
|
@@ -341,6 +341,8 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
341
341
|
* shove — and drops the amplifier.
|
|
342
342
|
*/
|
|
343
343
|
let snapshot: readonly IPose[] = [];
|
|
344
|
+
/** Where the opening drop left each crate, so the shove count survives the rebuild. */
|
|
345
|
+
let restSnapshot: readonly Vector3[] = [];
|
|
344
346
|
let wardenSnapshot = new Vector3(WARDEN_SPAWN.x, WARDEN_SPAWN.y, WARDEN_SPAWN.z);
|
|
345
347
|
/** V pressed before the opening drop finished: honoured as soon as it has. */
|
|
346
348
|
let replayRequested = false;
|
|
@@ -493,12 +495,14 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
493
495
|
// the two passes agreed to the last bit or merely to a millimetre.
|
|
494
496
|
replayMatch = replayDrift <= REPLAY_TOLERANCE;
|
|
495
497
|
replayPhase = "done";
|
|
498
|
+
const replayBodies = rig.length;
|
|
496
499
|
// Put the vault back exactly as the player left it, then let the seal watch again.
|
|
497
500
|
clearRig();
|
|
498
501
|
buildCrates(snapshot);
|
|
502
|
+
crates.forEach((crate, index) => crate.rest.copy(restSnapshot[index] ?? crate.rest));
|
|
499
503
|
warden.teleport(wardenSnapshot);
|
|
500
504
|
seal.area.monitoring = true;
|
|
501
|
-
frame.state.set({ replayBodies
|
|
505
|
+
frame.state.set({ replayBodies, replayDrift, replayMatch, replayPhase });
|
|
502
506
|
frame.state.flush();
|
|
503
507
|
}
|
|
504
508
|
camera.follow(warden.mesh.position, dt);
|
|
@@ -514,6 +518,7 @@ export class Play extends Scene<GameState, IPhysicsContext> {
|
|
|
514
518
|
if (replayRequested && replayPhase === "idle" && settled) {
|
|
515
519
|
replayRequested = false;
|
|
516
520
|
snapshot = capture();
|
|
521
|
+
restSnapshot = crates.map((crate) => crate.rest.clone());
|
|
517
522
|
|
|
518
523
|
wardenSnapshot = warden.mesh.position.clone();
|
|
519
524
|
// Nothing that happens during the two passes may end the run.
|
|
@@ -16,52 +16,17 @@ export function Hud() {
|
|
|
16
16
|
|
|
17
17
|
return (
|
|
18
18
|
<>
|
|
19
|
+
{/* What a player needs: their progress (the goal is the menu's line). The vault's physics telemetry (bodies,
|
|
20
|
+
blocked ticks, seal contacts, replay drift) stays in the published state for scenarios. */}
|
|
19
21
|
<div className="pointer-events-none absolute left-6 top-6 w-56 select-none">
|
|
20
22
|
<div className="text-[10px] uppercase tracking-[0.22em] text-dim">warden vault</div>
|
|
21
|
-
<div className="mt-1 text-[10px] uppercase tracking-[0.14em] text-dim">
|
|
22
|
-
seed <b className="font-normal tabular-nums text-text">{state.seed}</b>
|
|
23
|
-
</div>
|
|
24
23
|
|
|
25
24
|
<dl className="mt-4 space-y-1 text-[11px] uppercase tracking-[0.12em]">
|
|
26
|
-
<Row label="
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
value={`${state.settledCrates} / ${state.crates + state.phaseCrates}`}
|
|
31
|
-
/>
|
|
32
|
-
<Row label="shoved" value={state.pushedCrates} />
|
|
33
|
-
<Row label="push metres" value={state.pushDistance.toFixed(2)} />
|
|
34
|
-
<Row label="blocked ticks" value={state.blockedTicks} />
|
|
35
|
-
<Row label="walked through" value={state.passThroughs} tone="phase" />
|
|
36
|
-
<Row label="seal contacts" value={state.sealContacts} />
|
|
25
|
+
<Row label="crates shoved" value={state.pushedCrates} />
|
|
26
|
+
{state.replayPhase === "done" ? (
|
|
27
|
+
<Row label="replay" tone="lume" value={state.replayMatch ? "matched" : "drifted"} />
|
|
28
|
+
) : null}
|
|
37
29
|
</dl>
|
|
38
|
-
|
|
39
|
-
<div className="mt-4 border-t border-line pt-2 text-[10px] uppercase tracking-[0.14em] text-dim">
|
|
40
|
-
<div className="flex justify-between gap-2">
|
|
41
|
-
<span>replay</span>
|
|
42
|
-
<b className="font-normal tabular-nums text-text">{state.replayPhase}</b>
|
|
43
|
-
</div>
|
|
44
|
-
<div className="flex justify-between gap-2">
|
|
45
|
-
<span>bodies</span>
|
|
46
|
-
<b className="font-normal tabular-nums text-text">
|
|
47
|
-
{state.replayPhase === "done" ? state.replayBodies : "—"}
|
|
48
|
-
</b>
|
|
49
|
-
</div>
|
|
50
|
-
<div className="flex justify-between gap-2">
|
|
51
|
-
<span>drift</span>
|
|
52
|
-
<b className="font-normal tabular-nums text-text">
|
|
53
|
-
{state.replayPhase === "done" ? state.replayDrift.toExponential(1) : "—"}
|
|
54
|
-
</b>
|
|
55
|
-
</div>
|
|
56
|
-
<div className="flex justify-between gap-2">
|
|
57
|
-
<span>match</span>
|
|
58
|
-
<b
|
|
59
|
-
className={`font-normal tabular-nums ${state.replayMatch ? "text-lume" : "text-text"}`}
|
|
60
|
-
>
|
|
61
|
-
{state.replayMatch ? "yes" : "—"}
|
|
62
|
-
</b>
|
|
63
|
-
</div>
|
|
64
|
-
</div>
|
|
65
30
|
</div>
|
|
66
31
|
|
|
67
32
|
<div className="pointer-events-none absolute bottom-6 left-6 select-none text-[10px] uppercase leading-relaxed tracking-[0.14em] text-dim">
|
|
@@ -97,13 +62,13 @@ function Row({
|
|
|
97
62
|
value,
|
|
98
63
|
}: {
|
|
99
64
|
label: string;
|
|
100
|
-
tone?: "
|
|
65
|
+
tone?: "lume";
|
|
101
66
|
value: number | string;
|
|
102
67
|
}) {
|
|
103
68
|
return (
|
|
104
69
|
<div className="flex justify-between gap-3">
|
|
105
70
|
<dt className="text-dim">{label}</dt>
|
|
106
|
-
<dd className={`tabular-nums ${tone === "
|
|
71
|
+
<dd className={`tabular-nums ${tone === "lume" ? "text-lume" : "text-text"}`}>{value}</dd>
|
|
107
72
|
</div>
|
|
108
73
|
);
|
|
109
74
|
}
|
|
@@ -14,6 +14,10 @@ args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
|
|
|
14
14
|
command = "node"
|
|
15
15
|
args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
|
|
16
16
|
|
|
17
|
-
[mcp_servers.threenative-
|
|
17
|
+
[mcp_servers.threenative-animation]
|
|
18
18
|
command = "node"
|
|
19
|
-
args = ["./node_modules/@threenative/core/mcp/
|
|
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"]
|
|
@@ -22,10 +22,16 @@
|
|
|
22
22
|
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
23
23
|
]
|
|
24
24
|
},
|
|
25
|
-
"threenative-
|
|
25
|
+
"threenative-animation": {
|
|
26
26
|
"command": "node",
|
|
27
27
|
"args": [
|
|
28
|
-
"./node_modules/@threenative/core/mcp/
|
|
28
|
+
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
29
|
+
]
|
|
30
|
+
},
|
|
31
|
+
"threenative-devtools": {
|
|
32
|
+
"command": "node",
|
|
33
|
+
"args": [
|
|
34
|
+
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
29
35
|
]
|
|
30
36
|
}
|
|
31
37
|
}
|
|
@@ -22,10 +22,16 @@
|
|
|
22
22
|
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
23
23
|
]
|
|
24
24
|
},
|
|
25
|
-
"threenative-
|
|
25
|
+
"threenative-animation": {
|
|
26
26
|
"command": "node",
|
|
27
27
|
"args": [
|
|
28
|
-
"./node_modules/@threenative/core/mcp/
|
|
28
|
+
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
29
|
+
]
|
|
30
|
+
},
|
|
31
|
+
"threenative-devtools": {
|
|
32
|
+
"command": "node",
|
|
33
|
+
"args": [
|
|
34
|
+
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
29
35
|
]
|
|
30
36
|
}
|
|
31
37
|
}
|
|
@@ -22,10 +22,16 @@
|
|
|
22
22
|
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
23
23
|
]
|
|
24
24
|
},
|
|
25
|
-
"threenative-
|
|
25
|
+
"threenative-animation": {
|
|
26
26
|
"command": "node",
|
|
27
27
|
"args": [
|
|
28
|
-
"./node_modules/@threenative/core/mcp/
|
|
28
|
+
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
29
|
+
]
|
|
30
|
+
},
|
|
31
|
+
"threenative-devtools": {
|
|
32
|
+
"command": "node",
|
|
33
|
+
"args": [
|
|
34
|
+
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
29
35
|
]
|
|
30
36
|
}
|
|
31
37
|
}
|
|
@@ -25,11 +25,18 @@
|
|
|
25
25
|
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
26
26
|
]
|
|
27
27
|
},
|
|
28
|
-
"threenative-
|
|
28
|
+
"threenative-animation": {
|
|
29
29
|
"type": "stdio",
|
|
30
30
|
"command": "node",
|
|
31
31
|
"args": [
|
|
32
|
-
"./node_modules/@threenative/core/mcp/
|
|
32
|
+
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
33
|
+
]
|
|
34
|
+
},
|
|
35
|
+
"threenative-devtools": {
|
|
36
|
+
"type": "stdio",
|
|
37
|
+
"command": "node",
|
|
38
|
+
"args": [
|
|
39
|
+
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
33
40
|
]
|
|
34
41
|
}
|
|
35
42
|
}
|
|
@@ -25,11 +25,18 @@
|
|
|
25
25
|
"./node_modules/@threenative/core/mcp/engine.mjs"
|
|
26
26
|
]
|
|
27
27
|
},
|
|
28
|
-
"threenative-
|
|
28
|
+
"threenative-animation": {
|
|
29
29
|
"source": "custom",
|
|
30
30
|
"command": "node",
|
|
31
31
|
"args": [
|
|
32
|
-
"./node_modules/@threenative/core/mcp/
|
|
32
|
+
"./node_modules/@threenative/core/mcp/animation.mjs"
|
|
33
|
+
]
|
|
34
|
+
},
|
|
35
|
+
"threenative-devtools": {
|
|
36
|
+
"source": "custom",
|
|
37
|
+
"command": "node",
|
|
38
|
+
"args": [
|
|
39
|
+
"./node_modules/@threenative/core/mcp/devtools.mjs"
|
|
33
40
|
]
|
|
34
41
|
}
|
|
35
42
|
}
|
|
@@ -7,10 +7,8 @@ ThreeNative owns bootstrap, renderer, fixed-step loop, input, loading, physics b
|
|
|
7
7
|
|
|
8
8
|
## Start every change
|
|
9
9
|
|
|
10
|
-
1. **Critical
|
|
11
|
-
|
|
12
|
-
matches with `engine_capability_detail`, and record a capability or no-match for the plan. Apply the `ponytail` ladder before writing code; never hand-write what the capability search already installs.
|
|
13
|
-
2. Then invoke `prd-creator`. Draft the plan around those capabilities and binding constraints,
|
|
10
|
+
1. **Critical authoring gate:** invoke `threenative-capabilities` to choose the route. New games: steps 1-8. Existing games: steps 5-7 only, using existing context. Follow the `ponytail` ladder. References borrow mechanics only: no code, level layouts, character names or art. A session started outside this folder has no `mcp__threenative-*` tools: call them with `node node_modules/@threenative/core/mcp/call.mjs <server> <tool> '<json>'`.
|
|
11
|
+
2. **New game only:** run discovery in `threenative-capabilities` before `prd-creator`. Draft the core-mechanics plan from the kit, both discovery passes and binding constraints,
|
|
14
12
|
direct the user to review it, and wait for explicit approval plus an instruction to implement it.
|
|
15
13
|
3. Treat returned constraints as binding. `@threenative/physics/navigation` is browser-only WASM;
|
|
16
14
|
this kit uses `VehicleBody3D` for the cars and `PathFollow3D` for the rival's line, and no navmesh.
|
|
@@ -26,14 +24,14 @@ bridge; avoid DOM globals, dynamic `import()`, and raw physics handles. **Report
|
|
|
26
24
|
## Workflow skills
|
|
27
25
|
|
|
28
26
|
- `.agents/skills/prd-creator/SKILL.md` / `.claude/skills/prd-creator/SKILL.md` — game plan and approval gate.
|
|
29
|
-
- `.agents/skills/threenative-capabilities/SKILL.md` / `.claude/skills/threenative-capabilities/SKILL.md` — capability search.
|
|
27
|
+
- `.agents/skills/threenative-capabilities/SKILL.md` / `.claude/skills/threenative-capabilities/SKILL.md` — capability search and classic-game mechanics references.
|
|
30
28
|
- `.agents/skills/threenative-playtest/SKILL.md` / `.claude/skills/threenative-playtest/SKILL.md` — diagnosis and proof.
|
|
31
29
|
- `.agents/skills/threenative-assets/SKILL.md` / `.claude/skills/threenative-assets/SKILL.md` — assets and sculpting.
|
|
32
30
|
- `.agents/skills/threenative-visuals/SKILL.md` / `.claude/skills/threenative-visuals/SKILL.md` — captures and look.
|
|
33
|
-
- `.agents/skills/threenative-performance/SKILL.md` / `.claude/skills/threenative-performance/SKILL.md` — measured budgets.
|
|
31
|
+
- `.agents/skills/threenative-performance/SKILL.md` / `.claude/skills/threenative-performance/SKILL.md` — measured budgets; read it first when the game is slow or stutters: `playtest trace`, then the `threenative-devtools` MCP server.
|
|
34
32
|
- `.agents/skills/threenative-ui/SKILL.md` / `.claude/skills/threenative-ui/SKILL.md` — native-safe UI.
|
|
35
33
|
- `.agents/skills/threenative-context/SKILL.md` / `.claude/skills/threenative-context/SKILL.md` — portable ctx APIs.
|
|
36
|
-
- Confirmed framework bugs: use `file-engine-bug` in `.agents/skills/` or `.claude/skills/` after a minimal repro. A game-side `patches/` fix is temporary: once it is settled, it moves into the engine in one PR. Lazy-first: `.agents/skills/ponytail/SKILL.md` / `.claude/skills/ponytail/SKILL.md` — smallest correct change, and its reuse rung is the capability search above. Engine: The owned C++ engine is the default for a new game: the Wasm engine on web and the engine player on desktop. This template
|
|
34
|
+
- Confirmed framework bugs: use `file-engine-bug` in `.agents/skills/` or `.claude/skills/` after a minimal repro. A game-side `patches/` fix is temporary: once it is settled, it moves into the engine in one PR. Lazy-first: `.agents/skills/ponytail/SKILL.md` / `.claude/skills/ponytail/SKILL.md` — smallest correct change, and its reuse rung is the capability search above. Engine: The owned C++ engine is the default for a new game: the Wasm engine on web and the engine player on desktop. This template runs on it: `threenative.config.ts` names no `engine`. `engine: "threejs"` switches to upstream Three.js only when the user asks for it; it is never a fix for a build error. Android and iOS use the legacy host.
|
|
37
35
|
|
|
38
36
|
## Commands and map
|
|
39
37
|
|
|
@@ -42,7 +40,7 @@ pnpm dev
|
|
|
42
40
|
pnpm build
|
|
43
41
|
pnpm build --target desktop
|
|
44
42
|
pnpm test:native
|
|
45
|
-
pnpm test
|
|
43
|
+
pnpm test # runs `pnpm check` first: typecheck, ESLint, Biome format
|
|
46
44
|
pnpm typecheck
|
|
47
45
|
```
|
|
48
46
|
|
|
@@ -72,7 +70,7 @@ state. Seeded randomness is deterministic only when `defineGame({ seed })` is co
|
|
|
72
70
|
|
|
73
71
|
WebGPU reports `TN_GPU_CLASS` once per launch. Automatic `render.resolutionScale` starts at 0.85 for `mobile-low`, otherwise 1; a numeric value pins it. `TN_FRAME_BUDGET` reports the actual scale under both policies. `src/render/quality.ts` owns `low`, `medium`, `high`; the GPU family from `ctx.renderer.gpuClass` sets the start (`discrete` `high`, `integrated` and `mobile-high` `medium`, other phones `low`); `isMobile()` chooses `low`, otherwise `high` when the family is `unknown`;
|
|
74
72
|
override with `setupPost(..., { tier: "low" })`. Unknown tiers throw and `TN_QUALITY_TIER` reports
|
|
75
|
-
the source. The bridge flushes about 100 ms; keep speed/lap in state and frame feedback in Three.js.
|
|
73
|
+
the source. `src/render/sky.ts` draws Unreal's default sky (an atmosphere with clouds: `atmosphere.ts`, `clouds.ts`, `gpuSky.ts`) as background, environment light and height-fog colour, and `lighting.ts` tints the sun at `SUN_DIRECTION` by the air it crosses; `SKY_OPTIONS` takes `sky: "photo"` for `assets/sky.jpg` (Poly Haven, CC0) or `clouds: false`, and `ground: false` once the game has its own global illumination (the sunlit ground under the horizon stands in for the bounce). The shared look comes from core through `src/render/quality.ts`: the filmic curve and metered auto exposure are enabled by default. Set `tonemapMode: "aces"` to choose ACES, or `autoExposureEnabled: false` with a fixed `exposure` to choose manual exposure, on the same quality preset; the render log reports the override. It has Unreal's bloom with no threshold (`unrealBloomEnabled`), local exposure (`localExposureEnabled`, off on `low`), a cosine-fourth vignette (`vignetteAmount: 0.4`) and no camera motion blur (`motionBlurEnabled: true` is the opt-in). Anti-aliasing is core's: 4x MSAA on `high`, SMAA on `medium` and `low`; `temporalAA: true` is the named opt-in. The grade is neutral and the frame has no film grain. Each stage has a named override: `unrealBloomEnabled: false` returns to Three's `BloomNode` (`bloomStrength`, `bloomRadius`, `bloomThreshold`), and `vignetteAmount: 0` removes the vignette. For a colour grade or grain, add the starter's `grade.ts` and `public/grade.cube`, then set `gradeIntensity` and `grainIntensity`. The bridge flushes about 100 ms; keep speed/lap in state and frame feedback in Three.js. Racing keeps its deliberate gather, SSR and sharpening overrides in `quality.ts`: reflected rough tarmac and sharpening produced unstable speckles/bands, and the game retains its 33 ms / 30 FPS budget. The curve and meter stay enabled. The HUD uses the existing opaque `bg-panel` behind race, position, speed/time/boost and outcome text so a brighter road or sky does not erase the readouts.
|
|
76
74
|
|
|
77
75
|
When an animation looks wrong, measure it before rewriting it. `clipPoseError` scores a
|
|
78
76
|
retargeted clip against its source per bone in degrees — whole quaternions relative to each rig's
|
|
@@ -81,10 +79,10 @@ caught where a bone-direction check reads zero. `clipTrackBindings` names tracks
|
|
|
81
79
|
(the `<bone>.undefined` failure that plays the bind pose instead of the animation),
|
|
82
80
|
`clipBoneCoverage` names bones the clip does not drive and which therefore keep the previous
|
|
83
81
|
clip's pose, and `boneContact` reports in metres whether a named bone reaches the prop it is
|
|
84
|
-
supposed to be touching. Two loading conventions come from `@threenative/core`, not from your own loops: `loadAll(items, load)` fetches six at a time and returns results **in the input's order** (a pool that pushes returns completion order, so a positional pick lands a different asset every load), and `addInSlices(objects, (object) => ctx.add(object))` attaches in 8 ms slices so hundreds of objects never land in one long frame; override `concurrency`/`sliceSize`, pass `while: () => alive` to stop a torn-down scene without throwing, and `marker: false` silences `TN_LOAD_ALL`/`TN_ADD_SLICES` but never the measurement. Gate the loading curtain on a measured readiness with `ctx.startup.hold(label, () => ready)`: core polls it every rendered frame, so it settles without a physics step.
|
|
82
|
+
supposed to be touching. Two loading conventions come from `@threenative/core`, not from your own loops: `loadAll(items, load)` fetches six at a time and returns results **in the input's order** (a pool that pushes returns completion order, so a positional pick lands a different asset every load), and `addInSlices(objects, (object) => ctx.add(object))` attaches in 8 ms slices so hundreds of objects never land in one long frame; override `concurrency`/`sliceSize`, pass `while: () => alive` to stop a torn-down scene without throwing, and `marker: false` silences `TN_LOAD_ALL`/`TN_ADD_SLICES` but never the measurement. Gate the loading curtain on a measured readiness with `ctx.startup.hold(label, () => ready)`: core polls it every rendered frame, so it settles without a physics step. Assets download on demand and stay on disk between web visits: await everything the spawn camera sees before the reveal, and `await ctx.assets.prefetch(["next-level.glb"])` before `ctx.goto` only for what is out of view (a reveal before the visible content loads shows a half-built world); the idle fill downloads the rest after the reveal. Overrides on `defineGame`'s `assets`: `cache: false`, `backgroundFill: false`, both reported on `ctx.assets.cache`; native hosts read installed files.
|
|
85
83
|
|
|
84
|
+
`updateRate: "auto"` is the default and follows measured camera policy; `updateRate: 1` is full evaluation, another positive safe integer names a frame interval, and `updateRateReport` shows the effective rate, override status and latest evaluation; one-shots/fades, public mixer listeners/speed overrides, root-motion `AnimationComposer`, automatic camera-ray targets and camera-parented rigs stay full-rate.
|
|
86
85
|
## Budget real time for the look
|
|
87
|
-
|
|
88
86
|
Reference-driven authoring starts at `node_modules/create-threenative/agent-docs/references/dream-loop.md`.
|
|
89
87
|
|
|
90
88
|
Open a capture after visual changes. A scenario with no assertions or missing observations fails. The engine warns you before a human does: `TN_SCENE_WARNING` fires when the GPU used under a third of the frame while the JS render phase ran longer than the display's own period, and names the census behind it — objects considered, draws per pass, triangles per draw, shadow-exempt casters. It is a scene-shape verdict, so answer it by moving the draw and object counts, not the engine: read the bucket census before promising a merge. `npx threenative doctor` repeats the last verdict and the `DEV_MODE=true` chip shows it on screen (it draws the verdict alone — no frame rate, which reads throttled under a compositor or a virtual display; see `agent-docs/references/performance-basics.md`); `TN_FRAME_SPANS=1` adds the render phase's own span tree when you need to know which part costs the milliseconds. The cheapest static object is one whose transform you never write: measured on 1,561 objects, leaving them alone costs 10.10 ms of render phase against 17.45 ms when the game rewrites every transform each frame, because three skips the per-object binding update when nothing changed. So do not touch a transform you do not need to — that is worth ~7 ms where `markStatic(root)`, which additionally composes a never-moving subtree once, measured 0.009 ms. Use it for scenery you are sure of, and `invalidateStatic(object)` to announce a write inside one; it deletes matrix arithmetic, not the walk. `TN_RENDERLIST_VALIDATE=1` recomputes every world matrix the long way each frame and throws on the first that disagrees, which is how you prove a freeze did not leave something stale on screen.
|
|
@@ -93,4 +91,4 @@ For terrain generation or editing, read `node_modules/create-threenative/agent-d
|
|
|
93
91
|
## Optional multiplayer transport
|
|
94
92
|
For online play only, import `connect` from `@threenative/core/net` with an HTTPS URL and nonempty identity credential; configure `connectTimeoutMs`, `maxReliableMessageBytes`, `maxQueuedReliableBytes`, and `maxQueuedDatagrams` (10s/65,536/1 MiB/256), use `reliable-ordered` for ordered reliable messages and bounded `unreliable` datagrams that may drop, and keep serialization, replication, prediction, interpolation, snapshots and rejoin in this game's `src/` and server. There is no fallback: unsupported WebTransport/native rejects with `TN_NET_UNAVAILABLE`; reference Go server: `packages/runtime-native/examples/webtransport/server`.
|
|
95
93
|
Material backlighting lives in `src/render/lighting.ts`: named `rimGain` and `fillGain` controls preserve the authored palette; `materialLighting.ts` reports `TN_ENVIRONMENT_CONTRIBUTION`. Admission is limited to high hardware desktop WebGPU; mobile/software/WebGL/native retain original materials. Existing authored fill stays authoritative.
|
|
96
|
-
`src/render/exposure.ts`
|
|
94
|
+
`src/render/exposure.ts` is optional game policy; pass it as `exposurePolicy` in `quality.ts` to use it. Core owns adaptation and its readback. Recipe: `node_modules/create-threenative/agent-docs/references/auto-exposure.md`. Fog is height fog: `HEIGHT_FOG` in `src/render/heightFog.ts` (`density`, `heightFalloff`, `fogHeight`, `maxOpacity`, `startDistance`, `sunExponent`, `sunStartDistance`, `cutoffDistance`) is added to the `FogExp2` distance term on `scene.fogNode` and never replaces it, so a streaming fog `far` still holds.
|