create-threenative 0.2.10 → 0.2.12
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,54 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js configuration — edit it freely.
|
|
2
|
+
//
|
|
3
|
+
// The look is a fresh Unreal 5.8.3 project's, and it comes from ThreeNative core: the filmic
|
|
4
|
+
// tone curve, metered auto exposure, local exposure, Unreal's bloom and vignette, contact
|
|
5
|
+
// occlusion and temporal anti-aliasing on `high`. The engine's `qualityPreset(tier)` is that look
|
|
6
|
+
// per tier; this file's `qualityPreset` only adds what this game changes on top of it, each change with its reason and its
|
|
7
|
+
// cost. It starts empty on purpose: no tone curve or exposure is pinned here, so the game looks
|
|
8
|
+
// like the engine default until you decide otherwise. The meter is the starter kits' shared one
|
|
9
|
+
// (`kitExposure.ts`: core's Unreal meter at 0 EV).
|
|
10
|
+
//
|
|
11
|
+
// Tiers: `high` (a desktop GPU, Unreal's Epic), `medium` (integrated GPUs and high-end phones)
|
|
12
|
+
// and `low` (other phones and software adapters). A budget breach drops `renderChainTier`, never
|
|
13
|
+
// the curve or the meter. Force one with `setupPost(renderer, scene, camera, { tier: "low" })`.
|
|
14
|
+
import {
|
|
15
|
+
type IWorldEnvironmentOptions,
|
|
16
|
+
type QualityTier,
|
|
17
|
+
qualityPreset as engineQualityPreset,
|
|
18
|
+
qualityTiers,
|
|
19
|
+
} from "@threenative/core";
|
|
20
|
+
import { kitExposureSettings } from "./kitExposure.js";
|
|
21
|
+
|
|
22
|
+
export type { QualityTier };
|
|
23
|
+
|
|
24
|
+
// What `high` changes on top of the engine's `high`: no motion blur. The owner (2026-10-26) read
|
|
25
|
+
// the chase camera's blur as the kart hanging while it drives.
|
|
26
|
+
const high: IWorldEnvironmentOptions = { motionBlurEnabled: false };
|
|
27
|
+
// What `medium` changes on top of the engine's `medium`: no motion blur, as on `high`.
|
|
28
|
+
const medium: IWorldEnvironmentOptions = { motionBlurEnabled: false };
|
|
29
|
+
// What `low` changes on top of the engine's `low`. Nothing yet.
|
|
30
|
+
const low: IWorldEnvironmentOptions = {};
|
|
31
|
+
|
|
32
|
+
const OVERRIDES: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* Share of the meadow's grass tufts each tier draws (`render/foliage.ts`). Not a look option: the
|
|
36
|
+
* same seeded tufts, fewer of them. Cost: every tuft is 9 triangles, so the full meadow is about
|
|
37
|
+
* 100k triangles in about 60 cells, of which the camera sees a third to a half.
|
|
38
|
+
*/
|
|
39
|
+
export const GRASS_SHARE: Record<QualityTier, number> = { high: 1, low: 0.25, medium: 0.55 };
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* Picks the tier: an explicit `tier` wins, a software adapter gets `low`, then the GPU family,
|
|
43
|
+
* then `mobile`. An unknown tier name throws (in core) rather than rendering the default.
|
|
44
|
+
*/
|
|
45
|
+
export function resolveQualityTier(
|
|
46
|
+
request: Parameters<typeof qualityTiers.resolve>[0] = {},
|
|
47
|
+
): QualityTier {
|
|
48
|
+
return qualityTiers.resolve(request);
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** The engine's look for `tier`, with this game's overrides on top. */
|
|
52
|
+
export function qualityPreset(tier: QualityTier): IWorldEnvironmentOptions {
|
|
53
|
+
return { ...engineQualityPreset(tier), exposurePolicy: kitExposureSettings, ...OVERRIDES[tier] };
|
|
54
|
+
}
|
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
// ThreeNative does not read this file.
|
|
3
|
+
//
|
|
4
|
+
// Skid marks: a dark rubber strip behind each rear tyre in a drift, one segment per mark in an
|
|
5
|
+
// instanced ring, so the oldest mark is reused when the ring is full. One draw call for the whole
|
|
6
|
+
// field.
|
|
7
|
+
import {
|
|
8
|
+
Color,
|
|
9
|
+
type Group,
|
|
10
|
+
InstancedMesh,
|
|
11
|
+
MeshStandardMaterial,
|
|
12
|
+
Object3D,
|
|
13
|
+
PlaneGeometry,
|
|
14
|
+
} from "three";
|
|
15
|
+
import { C } from "./palette.js";
|
|
16
|
+
|
|
17
|
+
export class SkidMarks {
|
|
18
|
+
readonly #mesh: InstancedMesh;
|
|
19
|
+
readonly #dummy = new Object3D();
|
|
20
|
+
#next = 0;
|
|
21
|
+
/** Where each tyre's trail ends, by the key the race lays it under. */
|
|
22
|
+
readonly #ends = new Map<string, { x: number; y: number; z: number }>();
|
|
23
|
+
laid = 0;
|
|
24
|
+
|
|
25
|
+
constructor(
|
|
26
|
+
group: Group,
|
|
27
|
+
readonly capacity = 900,
|
|
28
|
+
) {
|
|
29
|
+
// Opaque rubber, 40% of the way from asphalt to tyre: see-through strips darkened wherever two
|
|
30
|
+
// trails crossed or two segments met, and a pack's racing line read as a brick pattern.
|
|
31
|
+
const material = new MeshStandardMaterial({
|
|
32
|
+
color: new Color(C.asphalt).lerp(new Color(C.tyre), 0.4),
|
|
33
|
+
polygonOffset: true,
|
|
34
|
+
polygonOffsetFactor: -2,
|
|
35
|
+
roughness: 0.9,
|
|
36
|
+
});
|
|
37
|
+
// One metre long, scaled to each segment, so a trail's segments meet end to end.
|
|
38
|
+
this.#mesh = new InstancedMesh(
|
|
39
|
+
new PlaneGeometry(0.26, 1).rotateX(-Math.PI / 2),
|
|
40
|
+
material,
|
|
41
|
+
capacity,
|
|
42
|
+
);
|
|
43
|
+
// A fixed count, with the unused dashes at zero scale: the ring only rewrites matrices, so the
|
|
44
|
+
// draw never changes size while the race runs.
|
|
45
|
+
const hidden = new Object3D();
|
|
46
|
+
hidden.scale.setScalar(0);
|
|
47
|
+
hidden.updateMatrix();
|
|
48
|
+
for (let i = 0; i < capacity; i += 1) this.#mesh.setMatrixAt(i, hidden.matrix);
|
|
49
|
+
this.#mesh.name = "skid-marks";
|
|
50
|
+
this.#mesh.frustumCulled = false;
|
|
51
|
+
this.#mesh.receiveShadow = true;
|
|
52
|
+
group.add(this.#mesh);
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/**
|
|
56
|
+
* A mark from where this tyre's trail ends up to its contact point, so the trail is one strip
|
|
57
|
+
* whose segments meet end to end: a trail joined by nearness alone jumped to the next tyre or
|
|
58
|
+
* kart and laid a zigzag.
|
|
59
|
+
* A trail end more than 4 m away starts a new trail (a kart on a mini-turbo covers 1.5 m between
|
|
60
|
+
* two marks), and a new trail lays nothing yet.
|
|
61
|
+
*/
|
|
62
|
+
lay(trail: string, x: number, y: number, z: number): void {
|
|
63
|
+
const from = this.#ends.get(trail);
|
|
64
|
+
const gap =
|
|
65
|
+
from === undefined ? Number.POSITIVE_INFINITY : (x - from.x) ** 2 + (z - from.z) ** 2;
|
|
66
|
+
if (from === undefined || gap > 4 * 4) {
|
|
67
|
+
this.#ends.set(trail, { x, y, z });
|
|
68
|
+
return;
|
|
69
|
+
}
|
|
70
|
+
if (gap < 0.0001) return;
|
|
71
|
+
const d = this.#dummy;
|
|
72
|
+
// Pitched along the road, not flat: a level segment on a slope sinks one half under the
|
|
73
|
+
// asphalt, and the trail reads as dashes.
|
|
74
|
+
d.position.set((x + from.x) / 2, (y + from.y) / 2 + 0.03, (z + from.z) / 2);
|
|
75
|
+
d.lookAt(x, y + 0.03, z);
|
|
76
|
+
d.scale.set(1, 1, Math.hypot(Math.sqrt(gap), y - from.y));
|
|
77
|
+
from.x = x;
|
|
78
|
+
from.y = y;
|
|
79
|
+
from.z = z;
|
|
80
|
+
d.updateMatrix();
|
|
81
|
+
this.#mesh.setMatrixAt(this.#next, d.matrix);
|
|
82
|
+
this.#next = (this.#next + 1) % this.capacity;
|
|
83
|
+
this.#mesh.instanceMatrix.needsUpdate = true;
|
|
84
|
+
this.laid += 1;
|
|
85
|
+
}
|
|
86
|
+
}
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
//
|
|
3
|
+
// A vertical blue gradient is the background and, prefiltered by three, the environment: the sky
|
|
4
|
+
// lights every face the sun misses, which is the stock Unreal outdoor setup of one directional sun
|
|
5
|
+
// plus a sky light. Brightness is the tone curve's and the meter's business (`postprocessing.ts`);
|
|
6
|
+
// this file only decides colour, so a darker or warmer sky is an edit to `palette.ts`.
|
|
7
|
+
import {
|
|
8
|
+
Color,
|
|
9
|
+
DataTexture,
|
|
10
|
+
EquirectangularReflectionMapping,
|
|
11
|
+
FogExp2,
|
|
12
|
+
LinearFilter,
|
|
13
|
+
RGBAFormat,
|
|
14
|
+
SRGBColorSpace,
|
|
15
|
+
type Scene,
|
|
16
|
+
UnsignedByteType,
|
|
17
|
+
Vector3,
|
|
18
|
+
} from "three";
|
|
19
|
+
import { palette } from "./palette.js";
|
|
20
|
+
|
|
21
|
+
/** Unit vector toward the sun: a mid-morning sun, 42° up, behind the camera's left shoulder. */
|
|
22
|
+
export const SUN_DIRECTION = new Vector3(0.45, 0.67, 0.59).normalize();
|
|
23
|
+
|
|
24
|
+
function gradientColor(row: number, height: number): Color {
|
|
25
|
+
const high = new Color(palette.skyHigh);
|
|
26
|
+
const low = new Color(palette.skyLow);
|
|
27
|
+
const horizon = new Color(palette.horizon);
|
|
28
|
+
// DataTexture rows start at v=0 (nadir); equirectangular v=0.5 is the horizon.
|
|
29
|
+
const elevation = Math.sin((row / (height - 1) - 0.5) * Math.PI);
|
|
30
|
+
if (elevation < 0) return horizon.clone().lerp(new Color(palette.grass), Math.min(1, -elevation));
|
|
31
|
+
// A thin haze band, then blue: a third-person camera sees the sky only up to about 30°.
|
|
32
|
+
return elevation < 0.15
|
|
33
|
+
? horizon.clone().lerp(low, elevation / 0.15)
|
|
34
|
+
: low.clone().lerp(high, Math.min(1, (elevation - 0.15) / 0.5));
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
/** A few soft, flat-bottomed clouds low in the sky: [azimuth 0..1, elevation 0..1, width, height]. */
|
|
38
|
+
const CLOUDS = [
|
|
39
|
+
[0.06, 0.16, 0.05, 0.035],
|
|
40
|
+
[0.19, 0.22, 0.035, 0.025],
|
|
41
|
+
[0.33, 0.13, 0.06, 0.03],
|
|
42
|
+
[0.52, 0.2, 0.045, 0.03],
|
|
43
|
+
[0.64, 0.12, 0.055, 0.025],
|
|
44
|
+
[0.8, 0.18, 0.05, 0.035],
|
|
45
|
+
[0.92, 0.25, 0.03, 0.02],
|
|
46
|
+
] as const;
|
|
47
|
+
|
|
48
|
+
function cloudCover(u: number, elevation: number): number {
|
|
49
|
+
let cover = 0;
|
|
50
|
+
for (const [cu, ce, w, h] of CLOUDS) {
|
|
51
|
+
const du = Math.min(Math.abs(u - cu), 1 - Math.abs(u - cu)) / w;
|
|
52
|
+
// Flat bottoms: below the centre the cloud fades twice as fast.
|
|
53
|
+
const de = (elevation - ce) / (elevation < ce ? h * 0.5 : h);
|
|
54
|
+
cover = Math.max(cover, Math.exp(-(du * du + de * de) * 2));
|
|
55
|
+
}
|
|
56
|
+
return cover;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* sRGB equirectangular radiance from the ground bounce through the horizon to the zenith.
|
|
61
|
+
* `saturation` below 1 pulls every texel toward its own grey: the fill light uses a 30%-saturated
|
|
62
|
+
* copy, because a real sky's shade light is greyed by haze and cloud, and the full blue of the
|
|
63
|
+
* backdrop turns every shadow on the grass teal.
|
|
64
|
+
*/
|
|
65
|
+
export function skyTexture(saturation = 1, width = 512): DataTexture {
|
|
66
|
+
// three's PMREM sizes its cube from width / 4 and needs at least 16: keep width >= 64.
|
|
67
|
+
const height = width / 2;
|
|
68
|
+
const data = new Uint8Array(width * height * 4);
|
|
69
|
+
const cloud = new Color(0xffffff);
|
|
70
|
+
const grey = new Color();
|
|
71
|
+
for (let row = 0; row < height; row += 1) {
|
|
72
|
+
const base = gradientColor(row, height);
|
|
73
|
+
const elevation = row / (height - 1) - 0.5;
|
|
74
|
+
for (let column = 0; column < width; column += 1) {
|
|
75
|
+
const cover = elevation > 0 ? cloudCover(column / width, elevation * 2) : 0;
|
|
76
|
+
const texel = base.clone().lerp(cloud, cover * 0.85);
|
|
77
|
+
grey.setScalar(texel.r * 0.2126 + texel.g * 0.7152 + texel.b * 0.0722);
|
|
78
|
+
const { r, g, b } = texel.lerp(grey, 1 - saturation).convertLinearToSRGB();
|
|
79
|
+
data.set(
|
|
80
|
+
[Math.round(r * 255), Math.round(g * 255), Math.round(b * 255), 255],
|
|
81
|
+
(row * width + column) * 4,
|
|
82
|
+
);
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
const sky = new DataTexture(data, width, height, RGBAFormat, UnsignedByteType);
|
|
86
|
+
sky.mapping = EquirectangularReflectionMapping;
|
|
87
|
+
sky.colorSpace = SRGBColorSpace;
|
|
88
|
+
sky.magFilter = LinearFilter;
|
|
89
|
+
sky.minFilter = LinearFilter;
|
|
90
|
+
sky.needsUpdate = true;
|
|
91
|
+
return sky;
|
|
92
|
+
}
|
|
93
|
+
|
|
94
|
+
/** `fill` is the environment light: by default the sky itself, in this game `skyTexture(0.3, 128)`. */
|
|
95
|
+
export function setupSky(scene: Scene, sky: DataTexture, fill: DataTexture = sky): void {
|
|
96
|
+
scene.background = sky;
|
|
97
|
+
scene.backgroundIntensity = 1;
|
|
98
|
+
scene.environment = fill;
|
|
99
|
+
// The sky fills the shade above the background's own level, so a cast shadow reads as a
|
|
100
|
+
// mid-tone of the ground's colour, not a near-black hole in it.
|
|
101
|
+
scene.environmentIntensity = 1.65;
|
|
102
|
+
// Thin on purpose: the course is about 250 m across, so the haze only reads on the far side of
|
|
103
|
+
// it and on the ring of hills, where it is what turns the horizon line into distance.
|
|
104
|
+
scene.fog = new FogExp2(palette.horizon, 0.0024);
|
|
105
|
+
}
|
|
@@ -0,0 +1,168 @@
|
|
|
1
|
+
import {
|
|
2
|
+
CircleGeometry,
|
|
3
|
+
type ColorRepresentation,
|
|
4
|
+
Group,
|
|
5
|
+
MathUtils,
|
|
6
|
+
Mesh,
|
|
7
|
+
MeshBasicMaterial,
|
|
8
|
+
type PerspectiveCamera,
|
|
9
|
+
RingGeometry,
|
|
10
|
+
Vector2,
|
|
11
|
+
} from "three";
|
|
12
|
+
import { C, palette } from "./palette.js";
|
|
13
|
+
import {
|
|
14
|
+
BUTTON_RADIUS,
|
|
15
|
+
type ITouchInput,
|
|
16
|
+
type ITouchPointer,
|
|
17
|
+
type ITouchViewport,
|
|
18
|
+
MOVE_RADIUS,
|
|
19
|
+
type TouchButton,
|
|
20
|
+
touchControlPoint,
|
|
21
|
+
} from "./touch-layout.js";
|
|
22
|
+
|
|
23
|
+
export type { ITouchInput };
|
|
24
|
+
|
|
25
|
+
/** Flat overlay material: drawn over the scene, never occluded by it. */
|
|
26
|
+
function overlayMaterial(color: ColorRepresentation, opacity: number): MeshBasicMaterial {
|
|
27
|
+
return new MeshBasicMaterial({
|
|
28
|
+
color,
|
|
29
|
+
depthTest: false,
|
|
30
|
+
depthWrite: false,
|
|
31
|
+
opacity,
|
|
32
|
+
transparent: true,
|
|
33
|
+
});
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
/** The 5px-thick outline every control shares. */
|
|
37
|
+
function ringMesh(radius: number, material: MeshBasicMaterial): Mesh {
|
|
38
|
+
return new Mesh(new RingGeometry(radius - 5, radius, 32), material);
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
const BUTTONS: readonly TouchButton[] = ["accel", "drift", "item"];
|
|
42
|
+
|
|
43
|
+
/**
|
|
44
|
+
* A thumbstick anchored where the thumb lands, plus accelerate, drift and item buttons, drawn on a
|
|
45
|
+
* plane in front of the camera. Pixel space in, `ITouchInput` out; `scenes/Race.ts` adds it to the keys.
|
|
46
|
+
*/
|
|
47
|
+
export class TouchControls {
|
|
48
|
+
readonly root = new Group();
|
|
49
|
+
readonly object = this.root;
|
|
50
|
+
#camera: PerspectiveCamera;
|
|
51
|
+
#input = { accelHeld: false, driftHeld: false, itemPressed: false, move: new Vector2() };
|
|
52
|
+
readonly #held: Record<TouchButton, boolean> = { accel: false, drift: false, item: false };
|
|
53
|
+
readonly #centres: Record<TouchButton, Vector2> = {
|
|
54
|
+
accel: new Vector2(),
|
|
55
|
+
drift: new Vector2(),
|
|
56
|
+
item: new Vector2(),
|
|
57
|
+
};
|
|
58
|
+
readonly #rings: Record<TouchButton, Mesh>;
|
|
59
|
+
#moveAnchor = new Vector2();
|
|
60
|
+
#hasMoveAnchor = false;
|
|
61
|
+
#resting = new Vector2();
|
|
62
|
+
#lastWidth = -1;
|
|
63
|
+
#lastHeight = -1;
|
|
64
|
+
#moveBase: Mesh;
|
|
65
|
+
#moveKnob: Mesh;
|
|
66
|
+
#idleMaterial: MeshBasicMaterial;
|
|
67
|
+
#activeMaterial: MeshBasicMaterial;
|
|
68
|
+
|
|
69
|
+
constructor(camera: PerspectiveCamera) {
|
|
70
|
+
this.#camera = camera;
|
|
71
|
+
// Ink, not white: the course is bright grass and sky almost everywhere a thumb lands.
|
|
72
|
+
this.#idleMaterial = overlayMaterial(C.ink, 0.3);
|
|
73
|
+
this.#activeMaterial = overlayMaterial(palette.accent, 0.58);
|
|
74
|
+
this.#moveBase = ringMesh(MOVE_RADIUS, this.#idleMaterial);
|
|
75
|
+
this.#moveKnob = new Mesh(new CircleGeometry(28, 24), this.#activeMaterial);
|
|
76
|
+
this.#rings = {
|
|
77
|
+
accel: ringMesh(BUTTON_RADIUS, this.#idleMaterial),
|
|
78
|
+
drift: ringMesh(BUTTON_RADIUS, this.#idleMaterial),
|
|
79
|
+
item: ringMesh(BUTTON_RADIUS, this.#idleMaterial),
|
|
80
|
+
};
|
|
81
|
+
this.root.add(this.#moveBase, this.#moveKnob, ...Object.values(this.#rings));
|
|
82
|
+
this.root.renderOrder = 10_001;
|
|
83
|
+
camera.add(this.root);
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
update(pointers: ReadonlyMap<number, ITouchPointer>, size: ITouchViewport): ITouchInput {
|
|
87
|
+
this.#ensureLayout(size);
|
|
88
|
+
let left: ITouchPointer | undefined;
|
|
89
|
+
for (const pointer of pointers.values()) {
|
|
90
|
+
if (pointer.position.x < size.width * 0.5 && pointer.position.y > size.height * 0.4) {
|
|
91
|
+
left = pointer;
|
|
92
|
+
break;
|
|
93
|
+
}
|
|
94
|
+
}
|
|
95
|
+
const move = this.#input.move;
|
|
96
|
+
if (left === undefined) {
|
|
97
|
+
this.#hasMoveAnchor = false;
|
|
98
|
+
move.set(0, 0);
|
|
99
|
+
} else {
|
|
100
|
+
if (!this.#hasMoveAnchor) {
|
|
101
|
+
this.#moveAnchor.copy(left.position);
|
|
102
|
+
this.#hasMoveAnchor = true;
|
|
103
|
+
}
|
|
104
|
+
move.set(
|
|
105
|
+
MathUtils.clamp((left.position.x - this.#moveAnchor.x) / MOVE_RADIUS, -1, 1),
|
|
106
|
+
// Screen y grows downward and the game's move.y is +up.
|
|
107
|
+
MathUtils.clamp((this.#moveAnchor.y - left.position.y) / MOVE_RADIUS, -1, 1),
|
|
108
|
+
);
|
|
109
|
+
}
|
|
110
|
+
const centre = this.#hasMoveAnchor ? this.#moveAnchor : this.#resting;
|
|
111
|
+
this.#moveKnob.position.set(
|
|
112
|
+
centre.x + move.x * MOVE_RADIUS,
|
|
113
|
+
centre.y - move.y * MOVE_RADIUS,
|
|
114
|
+
0,
|
|
115
|
+
);
|
|
116
|
+
for (const name of BUTTONS) {
|
|
117
|
+
const down = this.#at(pointers, this.#centres[name]);
|
|
118
|
+
const pressed = down && !this.#held[name];
|
|
119
|
+
this.#held[name] = down;
|
|
120
|
+
this.#rings[name].material = down ? this.#activeMaterial : this.#idleMaterial;
|
|
121
|
+
if (name === "accel") this.#input.accelHeld = down;
|
|
122
|
+
else if (name === "drift") this.#input.driftHeld = down;
|
|
123
|
+
else this.#input.itemPressed = pressed;
|
|
124
|
+
}
|
|
125
|
+
this.#layout(size);
|
|
126
|
+
return this.#input;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
debug(): Record<string, unknown> {
|
|
130
|
+
return { ...this.#held, move: this.#input.move.toArray() };
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
dispose(): void {
|
|
134
|
+
this.root.removeFromParent();
|
|
135
|
+
for (const child of this.root.children) {
|
|
136
|
+
if (child instanceof Mesh) child.geometry.dispose();
|
|
137
|
+
}
|
|
138
|
+
this.#idleMaterial.dispose();
|
|
139
|
+
this.#activeMaterial.dispose();
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
#ensureLayout(size: ITouchViewport): void {
|
|
143
|
+
if (size.width === this.#lastWidth && size.height === this.#lastHeight) return;
|
|
144
|
+
this.#lastWidth = size.width;
|
|
145
|
+
this.#lastHeight = size.height;
|
|
146
|
+
this.#resting.copy(touchControlPoint(size, "move"));
|
|
147
|
+
for (const name of BUTTONS) this.#centres[name].copy(touchControlPoint(size, name));
|
|
148
|
+
}
|
|
149
|
+
|
|
150
|
+
#layout(size: ITouchViewport): void {
|
|
151
|
+
const worldHeight = 2 * Math.tan(MathUtils.degToRad(this.#camera.fov / 2));
|
|
152
|
+
const pixels = worldHeight / Math.max(1, size.height);
|
|
153
|
+
this.root.position.set((-size.width * pixels) / 2, worldHeight / 2, -1);
|
|
154
|
+
this.root.scale.set(pixels, -pixels, 1);
|
|
155
|
+
const move = this.#hasMoveAnchor ? this.#moveAnchor : this.#resting;
|
|
156
|
+
this.#moveBase.position.set(move.x, move.y, 0);
|
|
157
|
+
for (const name of BUTTONS)
|
|
158
|
+
this.#rings[name].position.set(this.#centres[name].x, this.#centres[name].y, 0);
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
#at(pointers: ReadonlyMap<number, ITouchPointer>, centre: Vector2): boolean {
|
|
162
|
+
const radiusSquared = BUTTON_RADIUS * BUTTON_RADIUS;
|
|
163
|
+
for (const pointer of pointers.values()) {
|
|
164
|
+
if (pointer.position.distanceToSquared(centre) <= radiusSquared) return true;
|
|
165
|
+
}
|
|
166
|
+
return false;
|
|
167
|
+
}
|
|
168
|
+
}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { Vector2 } from "three";
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Where the on-screen controls sit. Pure geometry: no Three.js objects, no scene, so a test can
|
|
5
|
+
* check the maths without a renderer.
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
export const MOVE_RADIUS = 72;
|
|
9
|
+
export const BUTTON_RADIUS = 58;
|
|
10
|
+
const EDGE = 36;
|
|
11
|
+
|
|
12
|
+
export interface ITouchPointer {
|
|
13
|
+
readonly position: Vector2;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
export interface ITouchViewport {
|
|
17
|
+
readonly height: number;
|
|
18
|
+
readonly width: number;
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
export type TouchButton = "accel" | "drift" | "item";
|
|
22
|
+
type TouchControlName = TouchButton | "move";
|
|
23
|
+
|
|
24
|
+
/** Accelerate under the thumb's rest, drift beside it, the item above them: the thumb holds
|
|
25
|
+
* accelerate and rolls onto drift without letting go. */
|
|
26
|
+
const BUTTON_SLOTS: Record<TouchButton, readonly [number, number]> = {
|
|
27
|
+
accel: [0, 0],
|
|
28
|
+
drift: [1, 0],
|
|
29
|
+
item: [0.5, 1],
|
|
30
|
+
};
|
|
31
|
+
|
|
32
|
+
export function touchControlPoint(size: ITouchViewport, name: TouchControlName): Vector2 {
|
|
33
|
+
if (name === "move") return new Vector2(MOVE_RADIUS + EDGE, size.height - MOVE_RADIUS - EDGE);
|
|
34
|
+
const [column, row] = BUTTON_SLOTS[name];
|
|
35
|
+
const step = BUTTON_RADIUS * 2 + 16;
|
|
36
|
+
return new Vector2(
|
|
37
|
+
size.width - BUTTON_RADIUS - EDGE - column * step,
|
|
38
|
+
size.height - BUTTON_RADIUS - EDGE - row * step,
|
|
39
|
+
);
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
export interface ITouchInput {
|
|
43
|
+
readonly accelHeld: boolean;
|
|
44
|
+
readonly driftHeld: boolean;
|
|
45
|
+
readonly itemPressed: boolean;
|
|
46
|
+
/** x steers; y below −0.5 brakes. */
|
|
47
|
+
readonly move: Vector2;
|
|
48
|
+
}
|