create-threenative 0.2.10 → 0.2.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agent-docs/references/assertion-reference.md +109 -3
- package/agent-docs/references/auto-exposure.md +28 -45
- package/agent-docs/references/build-profiles.md +1 -1
- package/agent-docs/references/capability-reference.md +527 -44
- package/agent-docs/references/debug-surface.md +64 -0
- package/agent-docs/references/finding-assets.md +11 -12
- package/agent-docs/references/performance-basics.md +19 -0
- package/agent-docs/references/trace-a-slow-frame.md +21 -0
- package/agent-docs/references/visual-baseline.md +23 -4
- package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
- package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
- package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
- package/agent-files/scripts/reference.mjs +9 -4
- package/capabilities.json +739 -50
- package/dist/index.d.ts +40 -6
- package/dist/index.js +227 -34
- package/dist/quality.d.ts +12 -0
- package/dist/quality.js +166747 -0
- package/dist/threenative.js +60 -44
- package/dist/web-engine-gltf-loader.js +2 -0
- package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
- package/dist/web-engine-mesh-bvh.js +7 -0
- package/dist/web-engine-post-effects.js +645 -19
- package/dist/web-engine-runtime.js +3528 -343
- package/package.json +19 -9
- package/template-assets/assets/bay-PROVENANCE.md +21 -0
- package/template-assets/assets/bay-ground.webp +0 -0
- package/template-assets/assets/bay-metal.webp +0 -0
- package/template-assets/assets/bay-pavement-normal.webp +0 -0
- package/template-assets/assets/bay-pavement.webp +0 -0
- package/template-assets/assets/bay-plaster-normal.webp +0 -0
- package/template-assets/assets/bay-plaster.webp +0 -0
- package/template-assets/assets/bay-wood-normal.webp +0 -0
- package/template-assets/assets/bay-wood.webp +0 -0
- package/template-assets/assets/tex-PROVENANCE.md +25 -0
- package/template-assets/assets/tex-bark-normal.webp +0 -0
- package/template-assets/assets/tex-bark.webp +0 -0
- package/template-assets/assets/tex-birch-bark.webp +0 -0
- package/template-assets/assets/tex-grass.webp +0 -0
- package/template-assets/assets/tex-planks-normal.webp +0 -0
- package/template-assets/assets/tex-planks.webp +0 -0
- package/template-assets/assets/tex-rock-normal.webp +0 -0
- package/template-assets/assets/tex-rock.webp +0 -0
- package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
- package/template-assets/assets/tex-roof-tiles.webp +0 -0
- package/template-assets/assets/tex-sand-normal.webp +0 -0
- package/template-assets/assets/tex-sand.webp +0 -0
- package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
- package/template-assets/assets/tex-stone-wall.webp +0 -0
- package/template-assets/kitExposure.ts +20 -0
- package/template-assets/patches/three@0.185.1.patch +481 -272
- package/template-assets/quality/biome.json +7 -0
- package/template-assets/quality/eslint.config.js +3 -0
- package/template-assets/realistic-ocean/README.md +113 -0
- package/template-assets/realistic-ocean/install.mjs +56 -0
- package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
- package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
- package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
- package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
- package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
- package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
- package/templates/AGENTS.md +21 -0
- package/templates/CLAUDE.md +23 -0
- package/templates/action-rpg/.codex/config.toml +6 -2
- package/templates/action-rpg/.cursor/mcp.json +8 -2
- package/templates/action-rpg/.gemini/settings.json +8 -2
- package/templates/action-rpg/.mcp.json +8 -2
- package/templates/action-rpg/.vscode/mcp.json +9 -2
- package/templates/action-rpg/.zed/settings.json +9 -2
- package/templates/action-rpg/AGENTS.md +11 -11
- package/templates/action-rpg/CLAUDE.md +11 -11
- package/templates/action-rpg/opencode.json +10 -2
- package/templates/action-rpg/package.json +15 -10
- package/templates/action-rpg/playtests/combat.playtest.json +6 -0
- package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
- package/templates/action-rpg/playtests/performance.playtest.json +1 -1
- package/templates/action-rpg/playtests/roll.playtest.json +112 -0
- package/templates/action-rpg/playtests/swing.playtest.json +55 -0
- package/templates/action-rpg/playtests/win.playtest.json +4 -4
- package/templates/action-rpg/src/entities/Fighter.ts +44 -4
- package/templates/action-rpg/src/entities/Player.ts +64 -12
- package/templates/action-rpg/src/render/atmosphere.ts +444 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
- package/templates/action-rpg/src/render/clouds.ts +605 -0
- package/templates/action-rpg/src/render/dungeon.ts +8 -6
- package/templates/action-rpg/src/render/exposure.ts +11 -109
- package/templates/action-rpg/src/render/gpuSky.ts +752 -0
- package/templates/action-rpg/src/render/lighting.ts +27 -4
- package/templates/action-rpg/src/render/materialLighting.ts +2 -11
- package/templates/action-rpg/src/render/palette.ts +1 -0
- package/templates/action-rpg/src/render/postprocessing.ts +4 -4
- package/templates/action-rpg/src/render/props.ts +10 -8
- package/templates/action-rpg/src/render/quality.ts +56 -108
- package/templates/action-rpg/src/render/sky.ts +74 -1
- package/templates/action-rpg/src/scenes/Play.ts +16 -12
- package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
- package/templates/action-rpg/src/ui/Hud.tsx +5 -7
- package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
- package/templates/action-rpg/threenative.config.ts +3 -0
- package/templates/adventure/.codex/config.toml +23 -0
- package/templates/adventure/.cursor/mcp.json +38 -0
- package/templates/adventure/.gemini/settings.json +38 -0
- package/templates/adventure/.mcp.json +38 -0
- package/templates/adventure/.vscode/mcp.json +43 -0
- package/templates/adventure/.zed/settings.json +43 -0
- package/templates/adventure/AGENTS.md +60 -0
- package/templates/adventure/CLAUDE.md +62 -0
- package/templates/adventure/index.html +14 -0
- package/templates/adventure/kit.json +8 -0
- package/templates/adventure/native-playtests/survives.playtest.json +52 -0
- package/templates/adventure/opencode.json +49 -0
- package/templates/adventure/package.json +65 -0
- package/templates/adventure/playtests/boss.playtest.json +406 -0
- package/templates/adventure/playtests/combat.playtest.json +342 -0
- package/templates/adventure/playtests/controls.playtest.json +142 -0
- package/templates/adventure/playtests/explore.playtest.json +45 -0
- package/templates/adventure/playtests/flicker.playtest.json +206 -0
- package/templates/adventure/playtests/hearts.playtest.json +171 -0
- package/templates/adventure/playtests/lockon.playtest.json +256 -0
- package/templates/adventure/playtests/look.playtest.json +72 -0
- package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
- package/templates/adventure/playtests/move.playtest.json +84 -0
- package/templates/adventure/playtests/performance.playtest.json +55 -0
- package/templates/adventure/playtests/puzzle.playtest.json +250 -0
- package/templates/adventure/playtests/stride.playtest.json +67 -0
- package/templates/adventure/playtests/survives.playtest.json +171 -0
- package/templates/adventure/playtests/thornback.playtest.json +267 -0
- package/templates/adventure/public/favicon.svg +4 -0
- package/templates/adventure/src/entities/Block.ts +114 -0
- package/templates/adventure/src/entities/Chest.ts +69 -0
- package/templates/adventure/src/entities/Door.ts +81 -0
- package/templates/adventure/src/entities/Dummy.ts +69 -0
- package/templates/adventure/src/entities/Flicker.ts +239 -0
- package/templates/adventure/src/entities/Hero.ts +561 -0
- package/templates/adventure/src/entities/LockOn.ts +180 -0
- package/templates/adventure/src/entities/Mossling.ts +249 -0
- package/templates/adventure/src/entities/Switch.ts +49 -0
- package/templates/adventure/src/entities/Thornback.ts +238 -0
- package/templates/adventure/src/entities/Warden.ts +196 -0
- package/templates/adventure/src/game.ts +65 -0
- package/templates/adventure/src/interact.ts +63 -0
- package/templates/adventure/src/level/Hollow.ts +240 -0
- package/templates/adventure/src/level/Vale.ts +383 -0
- package/templates/adventure/src/main.ts +18 -0
- package/templates/adventure/src/render/camera.ts +416 -0
- package/templates/adventure/src/render/creatures.ts +405 -0
- package/templates/adventure/src/render/effects.ts +333 -0
- package/templates/adventure/src/render/foliage.ts +1072 -0
- package/templates/adventure/src/render/hero.ts +1447 -0
- package/templates/adventure/src/render/kitExposure.ts +20 -0
- package/templates/adventure/src/render/lighting.ts +74 -0
- package/templates/adventure/src/render/loading.ts +332 -0
- package/templates/adventure/src/render/materials.ts +179 -0
- package/templates/adventure/src/render/palette.ts +137 -0
- package/templates/adventure/src/render/postprocessing.ts +70 -0
- package/templates/adventure/src/render/props.ts +383 -0
- package/templates/adventure/src/render/quality.ts +46 -0
- package/templates/adventure/src/render/sky.ts +271 -0
- package/templates/adventure/src/render/surface.ts +259 -0
- package/templates/adventure/src/render/touch-controls.ts +137 -0
- package/templates/adventure/src/scenes/Play.ts +959 -0
- package/templates/adventure/src/state.ts +113 -0
- package/templates/adventure/src/style.css +98 -0
- package/templates/adventure/src/ui/App.tsx +22 -0
- package/templates/adventure/src/ui/GameUi.tsx +20 -0
- package/templates/adventure/src/ui/Hud.tsx +70 -0
- package/templates/adventure/src/ui/Menu.tsx +15 -0
- package/templates/adventure/src/ui/main.tsx +14 -0
- package/templates/adventure/tailwind.config.ts +2 -0
- package/templates/adventure/threenative.config.ts +62 -0
- package/templates/adventure/tsconfig.json +17 -0
- package/templates/adventure/vite.config.ts +49 -0
- package/templates/collectathon/.codex/config.toml +23 -0
- package/templates/collectathon/.cursor/mcp.json +38 -0
- package/templates/collectathon/.gemini/settings.json +38 -0
- package/templates/collectathon/.mcp.json +38 -0
- package/templates/collectathon/.vscode/mcp.json +43 -0
- package/templates/collectathon/.zed/settings.json +43 -0
- package/templates/collectathon/AGENTS.md +58 -0
- package/templates/collectathon/CLAUDE.md +60 -0
- package/templates/collectathon/index.html +14 -0
- package/templates/collectathon/kit.json +8 -0
- package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
- package/templates/collectathon/opencode.json +49 -0
- package/templates/collectathon/package.json +65 -0
- package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
- package/templates/collectathon/playtests/camera.playtest.json +80 -0
- package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
- package/templates/collectathon/playtests/collect.playtest.json +196 -0
- package/templates/collectathon/playtests/combat.playtest.json +246 -0
- package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
- package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
- package/templates/collectathon/playtests/effects.playtest.json +124 -0
- package/templates/collectathon/playtests/enemies.playtest.json +295 -0
- package/templates/collectathon/playtests/explore.playtest.json +45 -0
- package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
- package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
- package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
- package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
- package/templates/collectathon/playtests/ledge.playtest.json +100 -0
- package/templates/collectathon/playtests/look.playtest.json +64 -0
- package/templates/collectathon/playtests/performance.playtest.json +55 -0
- package/templates/collectathon/playtests/stride.playtest.json +111 -0
- package/templates/collectathon/playtests/survives.playtest.json +123 -0
- package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
- package/templates/collectathon/playtests/thornback.playtest.json +157 -0
- package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
- package/templates/collectathon/playtests/win.playtest.json +166 -0
- package/templates/collectathon/public/favicon.svg +4 -0
- package/templates/collectathon/src/entities/Hero.ts +915 -0
- package/templates/collectathon/src/entities/Pickup.ts +63 -0
- package/templates/collectathon/src/entities/Walker.ts +248 -0
- package/templates/collectathon/src/game.ts +51 -0
- package/templates/collectathon/src/level/Course.ts +590 -0
- package/templates/collectathon/src/level/terrain.ts +144 -0
- package/templates/collectathon/src/main.ts +14 -0
- package/templates/collectathon/src/playtest-events.ts +15 -0
- package/templates/collectathon/src/render/camera.ts +163 -0
- package/templates/collectathon/src/render/castle.ts +408 -0
- package/templates/collectathon/src/render/effects.ts +284 -0
- package/templates/collectathon/src/render/foliage.ts +744 -0
- package/templates/collectathon/src/render/ground.ts +139 -0
- package/templates/collectathon/src/render/hero.ts +452 -0
- package/templates/collectathon/src/render/kitExposure.ts +20 -0
- package/templates/collectathon/src/render/lighting.ts +65 -0
- package/templates/collectathon/src/render/loading.ts +332 -0
- package/templates/collectathon/src/render/materials.ts +196 -0
- package/templates/collectathon/src/render/palette.ts +82 -0
- package/templates/collectathon/src/render/postprocessing.ts +79 -0
- package/templates/collectathon/src/render/props.ts +218 -0
- package/templates/collectathon/src/render/quality.ts +54 -0
- package/templates/collectathon/src/render/sky.ts +262 -0
- package/templates/collectathon/src/render/surface.ts +269 -0
- package/templates/collectathon/src/render/touch-controls.ts +179 -0
- package/templates/collectathon/src/render/touch-layout.ts +48 -0
- package/templates/collectathon/src/render/water.ts +191 -0
- package/templates/collectathon/src/scenes/Play.ts +481 -0
- package/templates/collectathon/src/state.ts +38 -0
- package/templates/collectathon/src/style.css +106 -0
- package/templates/collectathon/src/ui/App.tsx +22 -0
- package/templates/collectathon/src/ui/GameUi.tsx +20 -0
- package/templates/collectathon/src/ui/Hud.tsx +77 -0
- package/templates/collectathon/src/ui/Menu.tsx +13 -0
- package/templates/collectathon/src/ui/main.tsx +14 -0
- package/templates/collectathon/tailwind.config.ts +2 -0
- package/templates/collectathon/threenative.config.ts +62 -0
- package/templates/collectathon/tsconfig.json +17 -0
- package/templates/collectathon/vite.config.ts +49 -0
- package/templates/kart/.codex/config.toml +23 -0
- package/templates/kart/.cursor/mcp.json +38 -0
- package/templates/kart/.gemini/settings.json +38 -0
- package/templates/kart/.mcp.json +38 -0
- package/templates/kart/.vscode/mcp.json +43 -0
- package/templates/kart/.zed/settings.json +43 -0
- package/templates/kart/AGENTS.md +58 -0
- package/templates/kart/CLAUDE.md +60 -0
- package/templates/kart/index.html +14 -0
- package/templates/kart/kit.json +8 -0
- package/templates/kart/native-playtests/survives.playtest.json +65 -0
- package/templates/kart/opencode.json +49 -0
- package/templates/kart/package.json +64 -0
- package/templates/kart/playtests/drift.playtest.json +226 -0
- package/templates/kart/playtests/explore.playtest.json +45 -0
- package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
- package/templates/kart/playtests/item-key.playtest.json +108 -0
- package/templates/kart/playtests/items.playtest.json +143 -0
- package/templates/kart/playtests/lap-times.playtest.json +138 -0
- package/templates/kart/playtests/laps.playtest.json +149 -0
- package/templates/kart/playtests/performance.playtest.json +57 -0
- package/templates/kart/playtests/race.playtest.json +294 -0
- package/templates/kart/playtests/restart.playtest.json +87 -0
- package/templates/kart/playtests/rocket-start.playtest.json +56 -0
- package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
- package/templates/kart/playtests/surfaces.playtest.json +113 -0
- package/templates/kart/playtests/survives.playtest.json +116 -0
- package/templates/kart/playtests/wall.playtest.json +118 -0
- package/templates/kart/public/favicon.svg +4 -0
- package/templates/kart/src/entities/Driver.ts +123 -0
- package/templates/kart/src/entities/Items.ts +194 -0
- package/templates/kart/src/entities/Kart.ts +517 -0
- package/templates/kart/src/game.ts +45 -0
- package/templates/kart/src/main.ts +14 -0
- package/templates/kart/src/playtest-events.ts +15 -0
- package/templates/kart/src/render/camera.ts +83 -0
- package/templates/kart/src/render/course.ts +579 -0
- package/templates/kart/src/render/effects.ts +266 -0
- package/templates/kart/src/render/items.ts +163 -0
- package/templates/kart/src/render/kart.ts +256 -0
- package/templates/kart/src/render/kitExposure.ts +20 -0
- package/templates/kart/src/render/lighting.ts +58 -0
- package/templates/kart/src/render/loading.ts +332 -0
- package/templates/kart/src/render/materials.ts +119 -0
- package/templates/kart/src/render/palette.ts +74 -0
- package/templates/kart/src/render/postprocessing.ts +79 -0
- package/templates/kart/src/render/quality.ts +54 -0
- package/templates/kart/src/render/skids.ts +86 -0
- package/templates/kart/src/render/sky.ts +105 -0
- package/templates/kart/src/render/touch-controls.ts +168 -0
- package/templates/kart/src/render/touch-layout.ts +48 -0
- package/templates/kart/src/scenes/Race.ts +850 -0
- package/templates/kart/src/state.ts +53 -0
- package/templates/kart/src/style.css +106 -0
- package/templates/kart/src/track/Course.ts +276 -0
- package/templates/kart/src/track/Race.ts +133 -0
- package/templates/kart/src/ui/App.tsx +21 -0
- package/templates/kart/src/ui/GameUi.tsx +20 -0
- package/templates/kart/src/ui/Hud.tsx +172 -0
- package/templates/kart/src/ui/Menu.tsx +13 -0
- package/templates/kart/src/ui/main.tsx +14 -0
- package/templates/kart/tailwind.config.ts +2 -0
- package/templates/kart/threenative.config.ts +62 -0
- package/templates/kart/tsconfig.json +17 -0
- package/templates/kart/vite.config.ts +49 -0
- package/templates/minimal/.codex/config.toml +6 -2
- package/templates/minimal/.cursor/mcp.json +8 -2
- package/templates/minimal/.gemini/settings.json +8 -2
- package/templates/minimal/.mcp.json +8 -2
- package/templates/minimal/.vscode/mcp.json +9 -2
- package/templates/minimal/.zed/settings.json +9 -2
- package/templates/minimal/AGENTS.md +11 -13
- package/templates/minimal/CLAUDE.md +11 -13
- package/templates/minimal/opencode.json +10 -2
- package/templates/minimal/package.json +14 -9
- package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
- package/templates/minimal/playtests/jump.playtest.json +45 -0
- package/templates/minimal/playtests/play.playtest.json +1 -1
- package/templates/minimal/src/game.ts +2 -0
- package/templates/minimal/src/render/atmosphere.ts +444 -0
- package/templates/minimal/src/render/backlightMaterial.ts +49 -18
- package/templates/minimal/src/render/camera.ts +35 -4
- package/templates/minimal/src/render/clouds.ts +605 -0
- package/templates/minimal/src/render/exposure.ts +7 -111
- package/templates/minimal/src/render/gpuSky.ts +752 -0
- package/templates/minimal/src/render/lighting.ts +26 -4
- package/templates/minimal/src/render/materialLighting.ts +2 -10
- package/templates/minimal/src/render/postprocessing.ts +4 -4
- package/templates/minimal/src/render/quality.ts +10 -116
- package/templates/minimal/src/render/sky.ts +73 -1
- package/templates/minimal/src/scenes/Play.ts +18 -7
- package/templates/platformer/.codex/config.toml +6 -2
- package/templates/platformer/.cursor/mcp.json +8 -2
- package/templates/platformer/.gemini/settings.json +8 -2
- package/templates/platformer/.mcp.json +8 -2
- package/templates/platformer/.vscode/mcp.json +9 -2
- package/templates/platformer/.zed/settings.json +9 -2
- package/templates/platformer/AGENTS.md +13 -9
- package/templates/platformer/CLAUDE.md +13 -9
- package/templates/platformer/opencode.json +10 -2
- package/templates/platformer/package.json +15 -10
- package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
- package/templates/platformer/playtests/finish.playtest.json +58 -0
- package/templates/platformer/playtests/idle.playtest.json +44 -0
- package/templates/platformer/playtests/performance.playtest.json +1 -1
- package/templates/platformer/src/entities/Fox.ts +19 -6
- package/templates/platformer/src/game.ts +1 -0
- package/templates/platformer/src/level/Stage.ts +4 -1
- package/templates/platformer/src/render/backlightMaterial.ts +49 -18
- package/templates/platformer/src/render/camera.ts +30 -1
- package/templates/platformer/src/render/exposure.ts +6 -111
- package/templates/platformer/src/render/fox.ts +5 -2
- package/templates/platformer/src/render/kitExposure.ts +20 -0
- package/templates/platformer/src/render/materialLighting.ts +2 -11
- package/templates/platformer/src/render/postprocessing.ts +4 -4
- package/templates/platformer/src/render/props.ts +1 -2
- package/templates/platformer/src/render/quality.ts +10 -118
- package/templates/platformer/src/scenes/Play.ts +31 -15
- package/templates/platformer/src/ui/Menu.tsx +1 -1
- package/templates/puzzle/.codex/config.toml +6 -2
- package/templates/puzzle/.cursor/mcp.json +8 -2
- package/templates/puzzle/.gemini/settings.json +8 -2
- package/templates/puzzle/.mcp.json +8 -2
- package/templates/puzzle/.vscode/mcp.json +9 -2
- package/templates/puzzle/.zed/settings.json +9 -2
- package/templates/puzzle/AGENTS.md +14 -17
- package/templates/puzzle/CLAUDE.md +14 -17
- package/templates/puzzle/opencode.json +10 -2
- package/templates/puzzle/package.json +15 -10
- package/templates/puzzle/playtests/performance.playtest.json +1 -1
- package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
- package/templates/puzzle/src/render/exposure.ts +11 -109
- package/templates/puzzle/src/render/lighting.ts +3 -3
- package/templates/puzzle/src/render/materialLighting.ts +2 -11
- package/templates/puzzle/src/render/palette.ts +1 -1
- package/templates/puzzle/src/render/postprocessing.ts +4 -4
- package/templates/puzzle/src/render/quality.ts +44 -153
- package/templates/puzzle/src/render/vault.ts +18 -6
- package/templates/puzzle/src/scenes/Play.ts +6 -1
- package/templates/puzzle/src/ui/Hud.tsx +8 -43
- package/templates/racing/.codex/config.toml +6 -2
- package/templates/racing/.cursor/mcp.json +8 -2
- package/templates/racing/.gemini/settings.json +8 -2
- package/templates/racing/.mcp.json +8 -2
- package/templates/racing/.vscode/mcp.json +9 -2
- package/templates/racing/.zed/settings.json +9 -2
- package/templates/racing/AGENTS.md +10 -12
- package/templates/racing/CLAUDE.md +10 -12
- package/templates/racing/opencode.json +10 -2
- package/templates/racing/package.json +15 -10
- package/templates/racing/playtests/brake.playtest.json +54 -0
- package/templates/racing/playtests/outcome.playtest.json +19 -0
- package/templates/racing/playtests/performance.playtest.json +1 -1
- package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
- package/templates/racing/src/entities/RacingCar.ts +12 -3
- package/templates/racing/src/entities/Rival.ts +11 -2
- package/templates/racing/src/render/atmosphere.ts +444 -0
- package/templates/racing/src/render/backlightMaterial.ts +49 -18
- package/templates/racing/src/render/clouds.ts +605 -0
- package/templates/racing/src/render/exposure.ts +6 -111
- package/templates/racing/src/render/gpuSky.ts +752 -0
- package/templates/racing/src/render/kitExposure.ts +20 -0
- package/templates/racing/src/render/lighting.ts +26 -4
- package/templates/racing/src/render/materialLighting.ts +2 -11
- package/templates/racing/src/render/materials.ts +2 -1
- package/templates/racing/src/render/postprocessing.ts +4 -4
- package/templates/racing/src/render/quality.ts +27 -115
- package/templates/racing/src/render/sky.ts +72 -1
- package/templates/racing/src/scenes/Race.ts +9 -7
- package/templates/racing/src/track/TrackSector.ts +5 -2
- package/templates/racing/src/ui/Hud.tsx +12 -7
- package/templates/rain/.codex/config.toml +6 -2
- package/templates/rain/.cursor/mcp.json +8 -2
- package/templates/rain/.gemini/settings.json +8 -2
- package/templates/rain/.mcp.json +8 -2
- package/templates/rain/.vscode/mcp.json +9 -2
- package/templates/rain/.zed/settings.json +9 -2
- package/templates/rain/AGENTS.md +12 -12
- package/templates/rain/CLAUDE.md +12 -12
- package/templates/rain/opencode.json +10 -2
- package/templates/rain/package.json +14 -9
- package/templates/rain/playtests/performance.playtest.json +1 -1
- package/templates/rain/src/game.ts +1 -1
- package/templates/rain/src/render/bloom-shader.ts +1 -1
- package/templates/rain/src/render/clouds-shader.ts +2 -2
- package/templates/rain/src/render/clouds.ts +2 -1
- package/templates/rain/src/render/exposure.ts +11 -109
- package/templates/rain/src/render/post-shader.ts +7 -11
- package/templates/rain/src/render/postprocessing.ts +8 -24
- package/templates/rain/src/render/quality.ts +44 -98
- package/templates/rain/src/render/world-shader.ts +281 -97
- package/templates/rain/src/render/world.ts +82 -2
- package/templates/rain/src/style.css +1 -1
- package/templates/rain/src/ui/GameUi.tsx +6 -2
- package/templates/rain/src/ui/Hud.tsx +1 -1
- package/templates/rain/tools/generate-shaders.mjs +2 -2
- package/templates/rain/tools/tempest-post.frag +4 -6
- package/templates/rain/tools/tempest-world.frag +80 -12
- package/templates/rts/.codex/config.toml +6 -2
- package/templates/rts/.cursor/mcp.json +8 -2
- package/templates/rts/.gemini/settings.json +8 -2
- package/templates/rts/.mcp.json +8 -2
- package/templates/rts/.vscode/mcp.json +9 -2
- package/templates/rts/.zed/settings.json +9 -2
- package/templates/rts/AGENTS.md +15 -16
- package/templates/rts/CLAUDE.md +15 -16
- package/templates/rts/opencode.json +10 -2
- package/templates/rts/package.json +14 -9
- package/templates/rts/playtests/performance.playtest.json +1 -1
- package/templates/rts/playtests/rts-attack.playtest.json +5 -0
- package/templates/rts/playtests/rts-build.playtest.json +20 -1
- package/templates/rts/playtests/rts-orders.playtest.json +1 -1
- package/templates/rts/playtests/rts-pause.playtest.json +112 -0
- package/templates/rts/playtests/rts-train.playtest.json +1 -1
- package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
- package/templates/rts/src/game.ts +29 -7
- package/templates/rts/src/render/army.ts +181 -49
- package/templates/rts/src/render/backlightMaterial.ts +49 -18
- package/templates/rts/src/render/environment.ts +276 -0
- package/templates/rts/src/render/exposure.ts +3 -65
- package/templates/rts/src/render/ground.ts +478 -0
- package/templates/rts/src/render/lighting.ts +62 -11
- package/templates/rts/src/render/materialLighting.ts +2 -11
- package/templates/rts/src/render/materials.ts +47 -118
- package/templates/rts/src/render/palette.ts +30 -13
- package/templates/rts/src/render/picking.ts +18 -0
- package/templates/rts/src/render/postprocessing.ts +4 -4
- package/templates/rts/src/render/quality.ts +64 -85
- package/templates/rts/src/render/resources.ts +21 -22
- package/templates/rts/src/render/sky.ts +9 -12
- package/templates/rts/src/render/terrain.ts +36 -11
- package/templates/rts/src/scenes/Play.ts +373 -38
- package/templates/rts/src/sim/ai.ts +0 -11
- package/templates/rts/src/state.ts +46 -0
- package/templates/rts/src/style.css +1543 -0
- package/templates/rts/src/ui/Commands.tsx +204 -107
- package/templates/rts/src/ui/GameUi.tsx +12 -5
- package/templates/rts/src/ui/Hud.tsx +611 -116
- package/templates/rts/src/ui/Minimap.tsx +103 -37
- package/templates/rts/src/ui/icons.tsx +116 -0
- package/templates/rts/src/ui/labels.ts +73 -0
- package/templates/rts/src/ui/minimapPoint.ts +30 -0
- package/templates/rts/threenative.config.ts +1 -1
- package/templates/runner/.codex/config.toml +6 -2
- package/templates/runner/.cursor/mcp.json +8 -2
- package/templates/runner/.gemini/settings.json +8 -2
- package/templates/runner/.mcp.json +8 -2
- package/templates/runner/.vscode/mcp.json +9 -2
- package/templates/runner/.zed/settings.json +9 -2
- package/templates/runner/AGENTS.md +12 -12
- package/templates/runner/CLAUDE.md +12 -12
- package/templates/runner/opencode.json +10 -2
- package/templates/runner/package.json +15 -10
- package/templates/runner/playtests/near-miss.playtest.json +48 -0
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/playtests/stride.playtest.json +27 -0
- package/templates/runner/playtests/survives.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +3 -1
- package/templates/runner/src/entities/Runner.ts +11 -5
- package/templates/runner/src/render/atmosphere.ts +444 -0
- package/templates/runner/src/render/backlightMaterial.ts +49 -18
- package/templates/runner/src/render/clouds.ts +605 -0
- package/templates/runner/src/render/exposure.ts +6 -111
- package/templates/runner/src/render/gpuSky.ts +752 -0
- package/templates/runner/src/render/kitExposure.ts +20 -0
- package/templates/runner/src/render/lighting.ts +26 -4
- package/templates/runner/src/render/materialLighting.ts +2 -11
- package/templates/runner/src/render/postprocessing.ts +4 -4
- package/templates/runner/src/render/quality.ts +26 -114
- package/templates/runner/src/render/sky.ts +73 -1
- package/templates/runner/src/scenes/Run.ts +19 -15
- package/templates/runner/src/track.ts +12 -3
- package/templates/sailing/.codex/config.toml +6 -2
- package/templates/sailing/.cursor/mcp.json +8 -2
- package/templates/sailing/.gemini/settings.json +8 -2
- package/templates/sailing/.mcp.json +8 -2
- package/templates/sailing/.vscode/mcp.json +9 -2
- package/templates/sailing/.zed/settings.json +9 -2
- package/templates/sailing/AGENTS.md +10 -11
- package/templates/sailing/CLAUDE.md +10 -11
- package/templates/sailing/opencode.json +10 -2
- package/templates/sailing/package.json +15 -10
- package/templates/sailing/playtests/fail.playtest.json +46 -5
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
- package/templates/sailing/playtests/performance.playtest.json +1 -1
- package/templates/sailing/src/game.ts +1 -0
- package/templates/sailing/src/render/backlightMaterial.ts +49 -18
- package/templates/sailing/src/render/exposure.ts +6 -111
- package/templates/sailing/src/render/kitExposure.ts +20 -0
- package/templates/sailing/src/render/materialLighting.ts +2 -11
- package/templates/sailing/src/render/ocean.ts +0 -1
- package/templates/sailing/src/render/postprocessing.ts +4 -4
- package/templates/sailing/src/render/quality.ts +31 -138
- package/templates/sailing/src/scenes/Sailing.ts +12 -4
- package/templates/sailing/src/ui/Hud.tsx +6 -2
- package/templates/sailing/src/ui/Menu.tsx +1 -1
- package/templates/shooter/.codex/config.toml +6 -2
- package/templates/shooter/.cursor/mcp.json +8 -2
- package/templates/shooter/.gemini/settings.json +8 -2
- package/templates/shooter/.mcp.json +8 -2
- package/templates/shooter/.vscode/mcp.json +9 -2
- package/templates/shooter/.zed/settings.json +9 -2
- package/templates/shooter/AGENTS.md +13 -12
- package/templates/shooter/CLAUDE.md +13 -12
- package/templates/shooter/index.html +1 -1
- package/templates/shooter/main.html +13 -0
- package/templates/shooter/opencode.json +10 -2
- package/templates/shooter/package.json +15 -10
- package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
- package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
- package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
- package/templates/shooter/playtests/performance.playtest.json +3 -3
- package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
- package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
- package/templates/shooter/src/entities/Breakables.ts +34 -10
- package/templates/shooter/src/entities/Enemy.ts +176 -54
- package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
- package/templates/shooter/src/entities/Rifle.ts +83 -9
- package/templates/shooter/src/entities/movement.ts +96 -0
- package/templates/shooter/src/render/atmosphere.ts +444 -0
- package/templates/shooter/src/render/backlightMaterial.ts +49 -18
- package/templates/shooter/src/render/camera.ts +3 -1
- package/templates/shooter/src/render/clouds.ts +605 -0
- package/templates/shooter/src/render/exposure.ts +10 -109
- package/templates/shooter/src/render/facade.ts +26 -68
- package/templates/shooter/src/render/gpuSky.ts +752 -0
- package/templates/shooter/src/render/lighting.ts +27 -4
- package/templates/shooter/src/render/materialAssignments.ts +9 -1
- package/templates/shooter/src/render/materialLighting.ts +2 -11
- package/templates/shooter/src/render/occlusion.ts +13 -4
- package/templates/shooter/src/render/palette.ts +1 -0
- package/templates/shooter/src/render/postprocessing.ts +4 -4
- package/templates/shooter/src/render/quality.ts +50 -108
- package/templates/shooter/src/render/scale.ts +0 -11
- package/templates/shooter/src/render/sky.ts +103 -2
- package/templates/shooter/src/render/surface.ts +140 -0
- package/templates/shooter/src/render/town.ts +3 -6
- package/templates/shooter/src/render/townMaterials.ts +95 -42
- package/templates/shooter/src/render/vehicles.ts +2 -0
- package/templates/shooter/src/scenes/Play.ts +83 -23
- package/templates/shooter/src/ui/Hud.tsx +268 -193
- package/templates/shooter/src/worker-page.ts +29 -0
- package/templates/shooter/src/worker.ts +5 -0
- package/templates/shooter/threenative.config.ts +3 -0
- package/templates/shooter/vite.config.ts +2 -0
- package/templates/snow/.codex/config.toml +6 -2
- package/templates/snow/.cursor/mcp.json +8 -2
- package/templates/snow/.gemini/settings.json +8 -2
- package/templates/snow/.mcp.json +8 -2
- package/templates/snow/.vscode/mcp.json +9 -2
- package/templates/snow/.zed/settings.json +9 -2
- package/templates/snow/AGENTS.md +12 -10
- package/templates/snow/CLAUDE.md +12 -10
- package/templates/snow/opencode.json +10 -2
- package/templates/snow/package.json +15 -10
- package/templates/snow/playtests/performance.playtest.json +1 -1
- package/templates/snow/src/render/backlightMaterial.ts +49 -18
- package/templates/snow/src/render/exposure.ts +17 -106
- package/templates/snow/src/render/materialLighting.ts +2 -11
- package/templates/snow/src/render/postprocessing.ts +11 -5
- package/templates/snow/src/render/quality.ts +46 -126
- package/templates/snow/src/render/snowSurface.ts +32 -15
- package/templates/snow/src/scenes/Snow.ts +2 -1
- package/templates/starter/.codex/config.toml +6 -2
- package/templates/starter/.cursor/mcp.json +8 -2
- package/templates/starter/.gemini/settings.json +8 -2
- package/templates/starter/.mcp.json +8 -2
- package/templates/starter/.vscode/mcp.json +9 -2
- package/templates/starter/.zed/settings.json +9 -2
- package/templates/starter/AGENTS.md +18 -14
- package/templates/starter/CLAUDE.md +18 -14
- package/templates/starter/index.html +1 -1
- package/templates/starter/main.html +12 -0
- package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
- package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
- package/templates/starter/opencode.json +10 -2
- package/templates/starter/package.json +15 -10
- package/templates/starter/playtests/play.playtest.json +22 -2
- package/templates/starter/playtests/production-readiness.playtest.json +14 -0
- package/templates/starter/src/entities/Crate.ts +19 -1
- package/templates/starter/src/render/arena.ts +2 -2
- package/templates/starter/src/render/atmosphere.ts +444 -0
- package/templates/starter/src/render/backlightMaterial.ts +49 -18
- package/templates/starter/src/render/camera.ts +28 -0
- package/templates/starter/src/render/clouds.ts +605 -0
- package/templates/starter/src/render/contactShadow.ts +50 -0
- package/templates/starter/src/render/exposure.ts +9 -111
- package/templates/starter/src/render/gpuSky.ts +752 -0
- package/templates/starter/src/render/grade.ts +1 -1
- package/templates/starter/src/render/lighting.ts +34 -6
- package/templates/starter/src/render/materialLighting.ts +2 -11
- package/templates/starter/src/render/postprocessing.ts +27 -14
- package/templates/starter/src/render/quality.ts +18 -147
- package/templates/starter/src/render/sky.ts +90 -40
- package/templates/starter/src/render/temporalAA.ts +1 -1
- package/templates/starter/src/render/temporalAAStage.ts +1 -1
- package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
- package/templates/starter/src/render/temporalDetailStage.ts +106 -0
- package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
- package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
- package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
- package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
- package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
- package/templates/starter/src/scenes/Play.ts +11 -8
- package/templates/starter/src/ui/Hud.tsx +1 -1
- package/templates/starter/src/worker-page.ts +29 -0
- package/templates/starter/src/worker.ts +5 -0
- package/templates/starter/vite.config.ts +2 -0
- package/templates/tower-defense/.codex/config.toml +6 -2
- package/templates/tower-defense/.cursor/mcp.json +8 -2
- package/templates/tower-defense/.gemini/settings.json +8 -2
- package/templates/tower-defense/.mcp.json +8 -2
- package/templates/tower-defense/.vscode/mcp.json +9 -2
- package/templates/tower-defense/.zed/settings.json +9 -2
- package/templates/tower-defense/AGENTS.md +10 -12
- package/templates/tower-defense/CLAUDE.md +10 -12
- package/templates/tower-defense/opencode.json +10 -2
- package/templates/tower-defense/package.json +15 -10
- package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
- package/templates/tower-defense/playtests/performance.playtest.json +1 -1
- package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
- package/templates/tower-defense/src/render/exposure.ts +11 -109
- package/templates/tower-defense/src/render/lighting.ts +4 -2
- package/templates/tower-defense/src/render/materialLighting.ts +2 -11
- package/templates/tower-defense/src/render/postprocessing.ts +4 -4
- package/templates/tower-defense/src/render/quality.ts +10 -116
- package/templates/tower-defense/src/render/sky.ts +2 -2
- package/templates/tower-defense/src/scenes/Battle.ts +4 -0
- package/template-assets/autoExposure.ts +0 -225
- package/template-assets/exposureGraph.ts +0 -178
- package/template-assets/exposureReadback.ts +0 -79
- package/template-assets/worldEnvironment.ts +0 -1212
- package/templates/action-rpg/src/render/autoExposure.ts +0 -225
- package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
- package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
- package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
- package/templates/minimal/src/render/autoExposure.ts +0 -225
- package/templates/minimal/src/render/exposureGraph.ts +0 -178
- package/templates/minimal/src/render/exposureReadback.ts +0 -79
- package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
- package/templates/platformer/src/render/autoExposure.ts +0 -225
- package/templates/platformer/src/render/exposureGraph.ts +0 -178
- package/templates/platformer/src/render/exposureReadback.ts +0 -79
- package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
- package/templates/puzzle/src/render/autoExposure.ts +0 -225
- package/templates/puzzle/src/render/exposureGraph.ts +0 -178
- package/templates/puzzle/src/render/exposureReadback.ts +0 -79
- package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
- package/templates/racing/src/render/autoExposure.ts +0 -225
- package/templates/racing/src/render/exposureGraph.ts +0 -178
- package/templates/racing/src/render/exposureReadback.ts +0 -79
- package/templates/racing/src/render/worldEnvironment.ts +0 -1212
- package/templates/rain/src/render/autoExposure.ts +0 -225
- package/templates/rain/src/render/exposureGraph.ts +0 -178
- package/templates/rain/src/render/exposureReadback.ts +0 -79
- package/templates/rain/src/render/worldEnvironment.ts +0 -1212
- package/templates/rts/src/render/autoExposure.ts +0 -225
- package/templates/rts/src/render/exposureGraph.ts +0 -178
- package/templates/rts/src/render/exposureReadback.ts +0 -79
- package/templates/rts/src/render/worldEnvironment.ts +0 -1212
- package/templates/runner/src/render/autoExposure.ts +0 -225
- package/templates/runner/src/render/exposureGraph.ts +0 -178
- package/templates/runner/src/render/exposureReadback.ts +0 -79
- package/templates/runner/src/render/worldEnvironment.ts +0 -1212
- package/templates/sailing/src/render/autoExposure.ts +0 -225
- package/templates/sailing/src/render/exposureGraph.ts +0 -178
- package/templates/sailing/src/render/exposureReadback.ts +0 -79
- package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
- package/templates/shooter/src/render/autoExposure.ts +0 -225
- package/templates/shooter/src/render/exposureGraph.ts +0 -178
- package/templates/shooter/src/render/exposureReadback.ts +0 -79
- package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
- package/templates/snow/src/render/autoExposure.ts +0 -225
- package/templates/snow/src/render/exposureGraph.ts +0 -178
- package/templates/snow/src/render/exposureReadback.ts +0 -79
- package/templates/snow/src/render/worldEnvironment.ts +0 -1212
- package/templates/starter/src/render/autoExposure.ts +0 -225
- package/templates/starter/src/render/exposureGraph.ts +0 -178
- package/templates/starter/src/render/exposureReadback.ts +0 -79
- package/templates/starter/src/render/worldEnvironment.ts +0 -1212
- package/templates/tower-defense/src/render/autoExposure.ts +0 -225
- package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
- package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
- package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
import { Heightfield } from "@threenative/core/world";
|
|
2
|
+
|
|
3
|
+
/** A rectangle [x min, x max, z min, z max] or a disc [x, z, radius] of level ground at y = 0. */
|
|
4
|
+
export type LevelZone =
|
|
5
|
+
| readonly [number, number, number, number]
|
|
6
|
+
| readonly [number, number, number];
|
|
7
|
+
|
|
8
|
+
export interface ITerrainPlan {
|
|
9
|
+
/** Ground the course's metres are measured on: every scenario route and landmark foot. */
|
|
10
|
+
readonly level: readonly LevelZone[];
|
|
11
|
+
/** A flat pad at its own height: x, z, radius, y (the castle's plateau). */
|
|
12
|
+
readonly pad: readonly [number, number, number, number];
|
|
13
|
+
/** Dirt paths, each a polyline of x, z corners; they follow the ground, they do not level it. */
|
|
14
|
+
readonly paths: readonly (readonly (readonly [number, number])[])[];
|
|
15
|
+
readonly seaLevel: number;
|
|
16
|
+
}
|
|
17
|
+
|
|
18
|
+
export interface ITerrain {
|
|
19
|
+
/** One height buffer for the drawn mesh, the collider and every snap (`@threenative/core/world`). */
|
|
20
|
+
readonly field: Heightfield;
|
|
21
|
+
/** Ground height at (x, z), the same bilinear numbers the mesh is built from; the sea floor off it. */
|
|
22
|
+
ground(x: number, z: number): number;
|
|
23
|
+
/** The up component of the ground's normal: 1 is flat, below 0.7 is steeper than the hero's 45° climb. */
|
|
24
|
+
flatness(x: number, z: number): number;
|
|
25
|
+
/** Metres from the nearest dirt path's centre line. */
|
|
26
|
+
pathDistance(x: number, z: number): number;
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
/** The grid: 1 m cells over the main island and the castle's headland to the north. */
|
|
30
|
+
export const TERRAIN_BOUNDS = { minX: -46, maxX: 46, minZ: -90, maxZ: 46 } as const;
|
|
31
|
+
const ISLAND_RADIUS = 36;
|
|
32
|
+
/** The headland the castle stands on: an ellipse joined to the island's north shore. */
|
|
33
|
+
const HEADLAND = { x: 2, z: -60, rx: 30, rz: 26 } as const;
|
|
34
|
+
|
|
35
|
+
const clamp01 = (t: number): number => Math.min(1, Math.max(0, t));
|
|
36
|
+
const smooth = (from: number, to: number, value: number): number => {
|
|
37
|
+
const t = clamp01((value - from) / (to - from));
|
|
38
|
+
return t * t * (3 - 2 * t);
|
|
39
|
+
};
|
|
40
|
+
const lerp = (a: number, b: number, t: number): number => a + (b - a) * t;
|
|
41
|
+
|
|
42
|
+
/** Distance from (x, z) to a level zone; 0 inside it. */
|
|
43
|
+
function zoneDistance(zone: LevelZone, x: number, z: number): number {
|
|
44
|
+
if (zone.length === 3) return Math.max(0, Math.hypot(x - zone[0], z - zone[1]) - zone[2]);
|
|
45
|
+
const dx = Math.max(zone[0] - x, 0, x - zone[1]);
|
|
46
|
+
const dz = Math.max(zone[2] - z, 0, z - zone[3]);
|
|
47
|
+
return Math.hypot(dx, dz);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
function segmentDistance(
|
|
51
|
+
x: number,
|
|
52
|
+
z: number,
|
|
53
|
+
[ax, az]: readonly [number, number],
|
|
54
|
+
[bx, bz]: readonly [number, number],
|
|
55
|
+
): number {
|
|
56
|
+
const lx = bx - ax;
|
|
57
|
+
const lz = bz - az;
|
|
58
|
+
const t = clamp01(((x - ax) * lx + (z - az) * lz) / (lx * lx + lz * lz));
|
|
59
|
+
return Math.hypot(x - (ax + lx * t), z - (az + lz * t));
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/** Rounded hills: x, z, radius, height. Placed off the routes, so they rise beside the play, not under it. */
|
|
63
|
+
const HILLS = [
|
|
64
|
+
[17, -5, 8, 4.5],
|
|
65
|
+
[21, 24, 11, 7],
|
|
66
|
+
[-19, 31, 8, 4],
|
|
67
|
+
[-34, -8, 7, 5],
|
|
68
|
+
[27, -21, 8, 6],
|
|
69
|
+
[-33, 30, 6, 3],
|
|
70
|
+
[33, 18, 6, 3.5],
|
|
71
|
+
] as const;
|
|
72
|
+
|
|
73
|
+
/**
|
|
74
|
+
* The island's shape in metres, before it is sampled: rolling ground with designed hills, the level
|
|
75
|
+
* zones pressed flat with a 6 m bank, a ramp up to the castle's plateau, and a shore that is a sand
|
|
76
|
+
* beach on the south-west and a rock cliff everywhere else (the long-jump gap to the east islet keeps
|
|
77
|
+
* its cliff edge). Deterministic: no random numbers, so every build and every snap agrees.
|
|
78
|
+
*/
|
|
79
|
+
function shape(plan: ITerrainPlan, x: number, z: number): number {
|
|
80
|
+
const { seaLevel } = plan;
|
|
81
|
+
// Rolling ground: two crossed waves and a short ripple, about ±1.4 m round a 1 m rise.
|
|
82
|
+
let relief =
|
|
83
|
+
1 +
|
|
84
|
+
0.9 * Math.sin(x * 0.21 + Math.sin(z * 0.17) * 1.7) * Math.cos(z * 0.19 - x * 0.07) +
|
|
85
|
+
0.45 * Math.sin(x * 0.43 + z * 0.37) * Math.cos(z * 0.51 - 0.3);
|
|
86
|
+
for (const [hx, hz, r, h] of HILLS)
|
|
87
|
+
relief += h * Math.exp(-((x - hx) ** 2 + (z - hz) ** 2) / r ** 2);
|
|
88
|
+
// The castle's plateau: the ground climbs northward to the pad's height.
|
|
89
|
+
const [px, pz, pr, py] = plan.pad;
|
|
90
|
+
relief = Math.max(relief, py * smooth(-36, -56, z) * (1 - smooth(18, 30, Math.abs(x - px))));
|
|
91
|
+
relief = Math.max(-0.6, relief);
|
|
92
|
+
// Level zones: flat inside, a bank rising over the next 6 m.
|
|
93
|
+
const away = Math.min(...plan.level.map((zone) => zoneDistance(zone, x, z)));
|
|
94
|
+
let height = relief * smooth(1, 7, away);
|
|
95
|
+
height = lerp(height, py, 1 - smooth(pr, pr + 5, Math.hypot(x - px, z - pz)));
|
|
96
|
+
|
|
97
|
+
// The shore: how far (x, z) is inside the coast, positive on land.
|
|
98
|
+
const angle = Math.atan2(z, x);
|
|
99
|
+
const wobble =
|
|
100
|
+
(1.6 * Math.sin(angle * 3 + 0.7) + Math.sin(angle * 7 + 1.9)) *
|
|
101
|
+
smooth(0.3, 0.7, Math.abs(angle));
|
|
102
|
+
const island = ISLAND_RADIUS - Math.hypot(x, z) + wobble;
|
|
103
|
+
const headland =
|
|
104
|
+
HEADLAND.rz * (1 - Math.hypot((x - HEADLAND.x) / HEADLAND.rx, (z - HEADLAND.z) / HEADLAND.rz));
|
|
105
|
+
// A smooth union, so the headland joins the island across a broad neck, not a pinch.
|
|
106
|
+
const blend = clamp01(0.5 + (island - headland) / 16);
|
|
107
|
+
const inland = lerp(headland, island, blend) + 8 * blend * (1 - blend);
|
|
108
|
+
// A beach on the west and south-west, about 2.0 to 3.2 rad; a rock cliff everywhere else.
|
|
109
|
+
const beach = smooth(0.55, 0.85, Math.cos(angle - 2.6)) * (z > -30 ? 1 : 0);
|
|
110
|
+
const cliff = lerp(seaLevel - 6.5, height, smooth(-1.6, 0, inland));
|
|
111
|
+
const sand =
|
|
112
|
+
inland > 0
|
|
113
|
+
? lerp(seaLevel + 0.35, height, smooth(0, 8, inland))
|
|
114
|
+
: lerp(seaLevel + 0.35, seaLevel - 3.5, smooth(0, -7, inland));
|
|
115
|
+
const coast = lerp(cliff, sand, beach);
|
|
116
|
+
// A level zone stays level up to the shore, whatever the beach does round it.
|
|
117
|
+
return inland > 0 ? lerp(coast, height, 1 - smooth(1, 7, away)) : coast;
|
|
118
|
+
}
|
|
119
|
+
|
|
120
|
+
export function buildTerrain(plan: ITerrainPlan): ITerrain {
|
|
121
|
+
const { minX, maxX, minZ, maxZ } = TERRAIN_BOUNDS;
|
|
122
|
+
const field = Heightfield.fromSampler({
|
|
123
|
+
columns: maxX - minX + 1,
|
|
124
|
+
depth: maxZ - minZ,
|
|
125
|
+
origin: { x: (minX + maxX) / 2, z: (minZ + maxZ) / 2 },
|
|
126
|
+
rows: maxZ - minZ + 1,
|
|
127
|
+
sampleHeight: (x, z) => shape(plan, x, z),
|
|
128
|
+
width: maxX - minX,
|
|
129
|
+
});
|
|
130
|
+
const inside = (x: number, z: number): boolean =>
|
|
131
|
+
x >= minX && x <= maxX && z >= minZ && z <= maxZ;
|
|
132
|
+
const seaFloor = plan.seaLevel - 6.5;
|
|
133
|
+
return {
|
|
134
|
+
field,
|
|
135
|
+
flatness: (x, z) => (inside(x, z) ? field.normalAt(x, z).y : 1),
|
|
136
|
+
ground: (x, z) => (inside(x, z) ? field.heightAt(x, z) : seaFloor),
|
|
137
|
+
pathDistance: (x, z) =>
|
|
138
|
+
Math.min(
|
|
139
|
+
...plan.paths.flatMap((path) =>
|
|
140
|
+
path.slice(1).map((corner, i) => segmentDistance(x, z, path[i] ?? corner, corner)),
|
|
141
|
+
),
|
|
142
|
+
),
|
|
143
|
+
};
|
|
144
|
+
}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { acceptHotUpdate } from "@threenative/core/hot";
|
|
2
|
+
import { createElement } from "react";
|
|
3
|
+
import { createRoot } from "react-dom/client";
|
|
4
|
+
import game from "./game.js";
|
|
5
|
+
import { App } from "./ui/App.js";
|
|
6
|
+
import "./style.css";
|
|
7
|
+
import.meta.hot?.accept();
|
|
8
|
+
acceptHotUpdate(game, import.meta.hot);
|
|
9
|
+
const root = document.getElementById("root");
|
|
10
|
+
if (root === null) throw new Error("Missing #root element.");
|
|
11
|
+
const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
|
|
12
|
+
const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
|
|
13
|
+
appRoot.__threenativeRoot = reactRoot;
|
|
14
|
+
reactRoot.render(createElement(App, { game }));
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
type PlaytestEvent = {
|
|
2
|
+
readonly [key: string]: string;
|
|
3
|
+
readonly entity: string;
|
|
4
|
+
readonly name: string;
|
|
5
|
+
};
|
|
6
|
+
|
|
7
|
+
const pendingEvents: PlaytestEvent[] = [];
|
|
8
|
+
|
|
9
|
+
export function emitPlaytestEvent(event: PlaytestEvent): void {
|
|
10
|
+
pendingEvents.push(event);
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
export function drainPlaytestEvents(): PlaytestEvent[] {
|
|
14
|
+
return pendingEvents.splice(0);
|
|
15
|
+
}
|
|
@@ -0,0 +1,163 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
//
|
|
3
|
+
// An orbit follow camera. It sits behind the hero on a fixed arm, swings slowly toward the
|
|
4
|
+
// direction the hero travels (so a long run straightens the view out behind it), and pulls in
|
|
5
|
+
// in front of any wall between the hero and the arm's end. `scenes/Play.ts` calls `update` from
|
|
6
|
+
// `afterPhysics`: `moveAndSlide` only queues motion, so a camera written earlier frames where the
|
|
7
|
+
// body was, not where it ended up. The wall test is a function the scene passes in, because this
|
|
8
|
+
// folder imports no physics.
|
|
9
|
+
import { MathUtils, type PerspectiveCamera, Vector3 } from "three";
|
|
10
|
+
|
|
11
|
+
/** Camera framing, in metres and radians. */
|
|
12
|
+
export const CAMERA_RIG = {
|
|
13
|
+
/** Arm length from the aim point. */
|
|
14
|
+
distance: 9,
|
|
15
|
+
/** Arm angle above the horizon. */
|
|
16
|
+
elevation: 0.32,
|
|
17
|
+
/** The aim point sits this high above the hero's waist, so the ground ahead fills the frame. */
|
|
18
|
+
aimHeight: 1.1,
|
|
19
|
+
/**
|
|
20
|
+
* The lens looks this far above the aim point at full arm length (less as the arm shortens), so
|
|
21
|
+
* the view pitches about 8° down instead of the arm's 18°: the hero sits in the lower third and
|
|
22
|
+
* the horizon, the hills and the castle fill the top, as in a 3D platformer's establishing view.
|
|
23
|
+
*/
|
|
24
|
+
lookAbove: 1.6,
|
|
25
|
+
/** How fast the arm swings toward the travel direction at full run, in 1/s. */
|
|
26
|
+
swingRate: 1.6,
|
|
27
|
+
/** Closest the camera comes to the aim point, even when the hero has its back to a wall. */
|
|
28
|
+
minDistance: 0.3,
|
|
29
|
+
/** Gap kept between the camera and the wall it is pulled in front of. */
|
|
30
|
+
wallGap: 0.35,
|
|
31
|
+
/** Ease toward the arm's end, in 1/s; a pull-in snaps instead. */
|
|
32
|
+
followRate: 9,
|
|
33
|
+
/**
|
|
34
|
+
* When a wall would pull the camera closer than this, it looks for a clearer arm instead: in a
|
|
35
|
+
* shaft the open side is beside the hero, and a camera at 0.3 m shows the back of the cap.
|
|
36
|
+
*/
|
|
37
|
+
craneBelow: 4,
|
|
38
|
+
/** The steepest arm angle it tries: 35° above the horizon, so the view never turns top-down. */
|
|
39
|
+
craneElevation: 0.61,
|
|
40
|
+
/** The headings it tries, as offsets from the current yaw, nearest first. */
|
|
41
|
+
craneHeadings: [0, Math.PI / 2, -Math.PI / 2, Math.PI / 4, -Math.PI / 4, 2.36, -2.36],
|
|
42
|
+
/** Mouse orbit, in radians per pixel of pointer motion. */
|
|
43
|
+
lookSensitivity: 0.0035,
|
|
44
|
+
/** The arm angles the mouse can tilt between: just above the ground to 50° above the horizon. */
|
|
45
|
+
lookElevation: [0.05, 0.87],
|
|
46
|
+
/** After the mouse turns the arm, the travel swing waits this long, in seconds. */
|
|
47
|
+
lookHold: 1.5,
|
|
48
|
+
} as const;
|
|
49
|
+
|
|
50
|
+
/** Distance along the ray from `from` to `to` to the first wall, or undefined when clear. */
|
|
51
|
+
export type WallProbe = (from: Vector3, to: Vector3) => number | undefined;
|
|
52
|
+
|
|
53
|
+
export interface IOrbitCamera {
|
|
54
|
+
/** The yaw the camera looks along (Three.js convention: forward is -Z at 0). */
|
|
55
|
+
readonly yaw: number;
|
|
56
|
+
/** Puts the camera behind a hero facing `yaw`, with no easing. */
|
|
57
|
+
snap(target: Vector3, yaw: number, probe: WallProbe): void;
|
|
58
|
+
/** Turns the arm by a pointer delta in pixels: right turns the view right, down raises the arm. */
|
|
59
|
+
look(dx: number, dy: number): void;
|
|
60
|
+
update(target: Vector3, velocity: Vector3, dt: number, probe: WallProbe): void;
|
|
61
|
+
debug(): Record<string, unknown>;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
export function createOrbitCamera(camera: PerspectiveCamera): IOrbitCamera {
|
|
65
|
+
// 60° vertical is Unreal's 90° horizontal at 16:9.
|
|
66
|
+
camera.fov = 60;
|
|
67
|
+
camera.near = 0.1;
|
|
68
|
+
camera.far = 2_000;
|
|
69
|
+
camera.updateProjectionMatrix();
|
|
70
|
+
const aim = new Vector3();
|
|
71
|
+
const desired = new Vector3();
|
|
72
|
+
const arm = new Vector3();
|
|
73
|
+
let yaw = 0;
|
|
74
|
+
let distance: number = CAMERA_RIG.distance;
|
|
75
|
+
let elevation: number = CAMERA_RIG.elevation;
|
|
76
|
+
// The arm angle at rest, which the mouse tilts, and how long the travel swing still waits.
|
|
77
|
+
let tilt: number = CAMERA_RIG.elevation;
|
|
78
|
+
let held = 0;
|
|
79
|
+
let pulledIn = false;
|
|
80
|
+
let cuts = 0;
|
|
81
|
+
let peakElevation = elevation;
|
|
82
|
+
let closest = distance;
|
|
83
|
+
|
|
84
|
+
/** How far the arm reaches along `heading` at `angle`; also leaves `arm` pointing along it. */
|
|
85
|
+
const reachAt = (heading: number, angle: number, probe: WallProbe): number => {
|
|
86
|
+
const flat = Math.cos(angle);
|
|
87
|
+
arm.set(Math.sin(heading) * flat, Math.sin(angle), Math.cos(heading) * flat);
|
|
88
|
+
desired.copy(aim).addScaledVector(arm, CAMERA_RIG.distance);
|
|
89
|
+
const hit = probe(aim, desired);
|
|
90
|
+
return hit === undefined ? CAMERA_RIG.distance : hit - CAMERA_RIG.wallGap;
|
|
91
|
+
};
|
|
92
|
+
|
|
93
|
+
const place = (target: Vector3, probe: WallProbe, ease: number): void => {
|
|
94
|
+
aim.set(target.x, target.y + CAMERA_RIG.aimHeight, target.z);
|
|
95
|
+
// Crane: when the arm is boxed in, take the heading and angle that reach farthest. A new
|
|
96
|
+
// heading is a cut, not a swing: an arm swept round a shaft passes through its wall.
|
|
97
|
+
let goal = tilt;
|
|
98
|
+
let heading = yaw;
|
|
99
|
+
let best = reachAt(yaw, goal, probe);
|
|
100
|
+
if (best < CAMERA_RIG.craneBelow) {
|
|
101
|
+
for (const offset of CAMERA_RIG.craneHeadings) {
|
|
102
|
+
// The 35° arm first: on a tie it looks down into a shaft instead of along its walls.
|
|
103
|
+
for (const angle of [CAMERA_RIG.craneElevation, CAMERA_RIG.elevation]) {
|
|
104
|
+
const reach = reachAt(yaw + offset, angle, probe);
|
|
105
|
+
if (reach > best + 0.5) [heading, goal, best] = [yaw + offset, angle, reach];
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
if (heading !== yaw) {
|
|
110
|
+
[yaw, elevation, distance] = [heading, goal, best];
|
|
111
|
+
cuts += 1;
|
|
112
|
+
}
|
|
113
|
+
// Up is immediate, like a pull-in; back down is eased.
|
|
114
|
+
elevation = goal > elevation ? goal : elevation + (goal - elevation) * ease;
|
|
115
|
+
const hit = reachAt(yaw, elevation, probe);
|
|
116
|
+
pulledIn = hit < CAMERA_RIG.distance;
|
|
117
|
+
const reach = Math.max(CAMERA_RIG.minDistance, hit);
|
|
118
|
+
// Out is eased, in is immediate: a camera that eases into a wall shows the inside of it.
|
|
119
|
+
distance = reach < distance ? reach : distance + (reach - distance) * ease;
|
|
120
|
+
camera.position.copy(aim).addScaledVector(arm, distance);
|
|
121
|
+
camera.lookAt(aim.x, aim.y + (CAMERA_RIG.lookAbove * distance) / CAMERA_RIG.distance, aim.z);
|
|
122
|
+
peakElevation = Math.max(peakElevation, elevation);
|
|
123
|
+
closest = Math.min(closest, distance);
|
|
124
|
+
};
|
|
125
|
+
|
|
126
|
+
return {
|
|
127
|
+
get yaw() {
|
|
128
|
+
return yaw;
|
|
129
|
+
},
|
|
130
|
+
snap(target, heroYaw, probe) {
|
|
131
|
+
yaw = heroYaw;
|
|
132
|
+
distance = CAMERA_RIG.distance;
|
|
133
|
+
elevation = tilt = CAMERA_RIG.elevation;
|
|
134
|
+
held = 0;
|
|
135
|
+
[cuts, peakElevation, closest] = [0, elevation, distance];
|
|
136
|
+
place(target, probe, 1);
|
|
137
|
+
},
|
|
138
|
+
look(dx, dy) {
|
|
139
|
+
if (dx === 0 && dy === 0) return;
|
|
140
|
+
yaw -= dx * CAMERA_RIG.lookSensitivity;
|
|
141
|
+
const [low, high] = CAMERA_RIG.lookElevation;
|
|
142
|
+
tilt = MathUtils.clamp(tilt + dy * CAMERA_RIG.lookSensitivity, low, high);
|
|
143
|
+
held = CAMERA_RIG.lookHold;
|
|
144
|
+
},
|
|
145
|
+
update(target, velocity, dt, probe) {
|
|
146
|
+
const speed = Math.hypot(velocity.x, velocity.z);
|
|
147
|
+
held = Math.max(0, held - dt);
|
|
148
|
+
if (speed > 1 && held === 0) {
|
|
149
|
+
const travel = Math.atan2(-velocity.x, -velocity.z);
|
|
150
|
+
const turn = MathUtils.euclideanModulo(travel - yaw + Math.PI, Math.PI * 2) - Math.PI;
|
|
151
|
+
// Running at the camera does not spin it round: only travel within 120° of the view swings it.
|
|
152
|
+
if (Math.abs(turn) < (Math.PI * 2) / 3) {
|
|
153
|
+
const rate = CAMERA_RIG.swingRate * Math.min(1, speed / 9.6);
|
|
154
|
+
yaw += turn * (1 - Math.exp(-dt * rate));
|
|
155
|
+
}
|
|
156
|
+
}
|
|
157
|
+
place(target, probe, 1 - Math.exp(-dt * CAMERA_RIG.followRate));
|
|
158
|
+
},
|
|
159
|
+
debug() {
|
|
160
|
+
return { closest, cuts, distance, elevation, peakElevation, pulledIn, tilt, yaw };
|
|
161
|
+
},
|
|
162
|
+
};
|
|
163
|
+
}
|