create-threenative 0.2.7 → 0.2.9
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/README.md +3 -1
- package/agent-docs/references/assertion-reference.md +87 -35
- package/agent-docs/references/auto-exposure.md +57 -0
- package/agent-docs/references/capability-reference.md +1306 -62
- package/agent-docs/references/debug-surface.md +6 -0
- package/agent-docs/references/finding-assets.md +46 -10
- package/agent-docs/references/performance-basics.md +5 -4
- package/agent-docs/references/terrain-authoring.md +140 -0
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +2 -1
- package/capabilities.json +1505 -79
- package/dist/index.d.ts +28 -3
- package/dist/index.js +402 -167
- package/dist/threenative.js +989 -237
- package/dist/web-engine-buffer-geometry-utils.js +281 -0
- package/dist/web-engine-decal-geometry.js +184 -0
- package/dist/web-engine-gltf-loader.js +196 -0
- package/dist/web-engine-hdr-loader.js +190 -0
- package/dist/web-engine-lut-cube-loader.js +122 -0
- package/dist/web-engine-mesh-bvh-webgpu.js +29 -0
- package/dist/web-engine-mesh-bvh.js +32 -0
- package/dist/web-engine-post-effects.js +168 -0
- package/dist/web-engine-runtime.js +42506 -0
- package/package.json +11 -8
- package/template-assets/autoExposure.ts +225 -0
- package/template-assets/exposure.ts +111 -0
- package/template-assets/exposureGraph.ts +178 -0
- package/template-assets/exposureReadback.ts +79 -0
- package/template-assets/patches/@tailwindcss__node@4.3.3.patch +22 -0
- package/template-assets/patches/three@0.185.1.patch +6594 -700
- package/template-assets/patches/vite@8.2.0.patch +422 -0
- package/template-assets/worldEnvironment.ts +433 -30
- package/templates/action-rpg/AGENTS.md +11 -10
- package/templates/action-rpg/CLAUDE.md +11 -10
- package/templates/action-rpg/package.json +11 -9
- package/templates/action-rpg/playtests/performance.playtest.json +7 -1
- package/templates/action-rpg/src/progress.ts +0 -4
- package/templates/action-rpg/src/render/autoExposure.ts +225 -0
- package/templates/action-rpg/src/render/backlightControls.ts +66 -0
- package/templates/action-rpg/src/render/backlightMaterial.ts +147 -0
- package/templates/action-rpg/src/render/environmentContribution.ts +188 -0
- package/templates/action-rpg/src/render/environmentRadiance.ts +36 -0
- package/templates/action-rpg/src/render/environmentSampleCache.ts +43 -0
- package/templates/action-rpg/src/render/environmentSampling.ts +193 -0
- package/templates/action-rpg/src/render/environmentSnapshot.ts +53 -0
- package/templates/action-rpg/src/render/exposure.ts +111 -0
- package/templates/action-rpg/src/render/exposureGraph.ts +178 -0
- package/templates/action-rpg/src/render/exposureReadback.ts +79 -0
- package/templates/action-rpg/src/render/heightFog.ts +118 -0
- package/templates/action-rpg/src/render/lighting.ts +26 -1
- package/templates/action-rpg/src/render/materialAssignments.ts +160 -0
- package/templates/action-rpg/src/render/materialLighting.ts +155 -0
- package/templates/action-rpg/src/render/postprocessing.ts +17 -2
- package/templates/action-rpg/src/render/quality.ts +61 -2
- package/templates/action-rpg/src/render/sky.ts +21 -1
- package/templates/action-rpg/src/render/vfx.ts +133 -58
- package/templates/action-rpg/src/render/worldEnvironment.ts +433 -30
- package/templates/action-rpg/src/scenes/Play.ts +81 -16
- package/templates/action-rpg/threenative.config.ts +3 -0
- package/templates/action-rpg/vite.config.ts +10 -2
- package/templates/minimal/AGENTS.md +9 -10
- package/templates/minimal/CLAUDE.md +9 -10
- package/templates/minimal/package.json +9 -8
- package/templates/minimal/playtests/play.playtest.json +7 -1
- package/templates/minimal/playtests/sky.playtest.json +10 -1
- package/templates/minimal/src/render/autoExposure.ts +225 -0
- package/templates/minimal/src/render/backlightControls.ts +66 -0
- package/templates/minimal/src/render/backlightMaterial.ts +147 -0
- package/templates/minimal/src/render/environmentContribution.ts +188 -0
- package/templates/minimal/src/render/environmentRadiance.ts +36 -0
- package/templates/minimal/src/render/environmentSampleCache.ts +43 -0
- package/templates/minimal/src/render/environmentSampling.ts +193 -0
- package/templates/minimal/src/render/environmentSnapshot.ts +53 -0
- package/templates/minimal/src/render/exposure.ts +111 -0
- package/templates/minimal/src/render/exposureGraph.ts +178 -0
- package/templates/minimal/src/render/exposureReadback.ts +79 -0
- package/templates/minimal/src/render/heightFog.ts +118 -0
- package/templates/minimal/src/render/lighting.ts +25 -1
- package/templates/minimal/src/render/materialAssignments.ts +102 -0
- package/templates/minimal/src/render/materialLighting.ts +146 -0
- package/templates/minimal/src/render/postprocessing.ts +16 -2
- package/templates/minimal/src/render/quality.ts +60 -2
- package/templates/minimal/src/render/sky.ts +21 -1
- package/templates/minimal/src/render/worldEnvironment.ts +433 -30
- package/templates/minimal/src/scenes/Play.ts +50 -1
- package/templates/minimal/vite.config.ts +10 -2
- package/templates/platformer/AGENTS.md +7 -5
- package/templates/platformer/CLAUDE.md +7 -5
- package/templates/platformer/package.json +11 -9
- package/templates/platformer/playtests/performance.playtest.json +7 -1
- package/templates/platformer/src/render/autoExposure.ts +225 -0
- package/templates/platformer/src/render/backlightControls.ts +66 -0
- package/templates/platformer/src/render/backlightMaterial.ts +147 -0
- package/templates/platformer/src/render/environmentContribution.ts +188 -0
- package/templates/platformer/src/render/environmentRadiance.ts +36 -0
- package/templates/platformer/src/render/environmentSampleCache.ts +43 -0
- package/templates/platformer/src/render/environmentSampling.ts +193 -0
- package/templates/platformer/src/render/environmentSnapshot.ts +53 -0
- package/templates/platformer/src/render/exposure.ts +111 -0
- package/templates/platformer/src/render/exposureGraph.ts +178 -0
- package/templates/platformer/src/render/exposureReadback.ts +79 -0
- package/templates/platformer/src/render/heightFog.ts +118 -0
- package/templates/platformer/src/render/lighting.ts +26 -1
- package/templates/platformer/src/render/materialAssignments.ts +160 -0
- package/templates/platformer/src/render/materialLighting.ts +155 -0
- package/templates/platformer/src/render/materials.ts +7 -2
- package/templates/platformer/src/render/palette.ts +3 -3
- package/templates/platformer/src/render/postprocessing.ts +17 -2
- package/templates/platformer/src/render/quality.ts +61 -2
- package/templates/platformer/src/render/sky.ts +72 -23
- package/templates/platformer/src/render/skyEnvironment.ts +50 -0
- package/templates/platformer/src/render/worldEnvironment.ts +433 -30
- package/templates/platformer/src/scenes/Play.ts +70 -6
- package/templates/platformer/vite.config.ts +10 -2
- package/templates/puzzle/AGENTS.md +10 -9
- package/templates/puzzle/CLAUDE.md +10 -9
- package/templates/puzzle/package.json +11 -9
- package/templates/puzzle/playtests/boot-failure.playtest.json +2 -2
- package/templates/puzzle/playtests/lit.playtest.json +7 -1
- package/templates/puzzle/playtests/performance.playtest.json +7 -1
- package/templates/puzzle/src/render/autoExposure.ts +225 -0
- package/templates/puzzle/src/render/backlightControls.ts +66 -0
- package/templates/puzzle/src/render/backlightMaterial.ts +147 -0
- package/templates/puzzle/src/render/environmentContribution.ts +188 -0
- package/templates/puzzle/src/render/environmentRadiance.ts +36 -0
- package/templates/puzzle/src/render/environmentSampleCache.ts +43 -0
- package/templates/puzzle/src/render/environmentSampling.ts +193 -0
- package/templates/puzzle/src/render/environmentSnapshot.ts +53 -0
- package/templates/puzzle/src/render/exposure.ts +111 -0
- package/templates/puzzle/src/render/exposureGraph.ts +178 -0
- package/templates/puzzle/src/render/exposureReadback.ts +79 -0
- package/templates/puzzle/src/render/heightFog.ts +118 -0
- package/templates/puzzle/src/render/lighting.ts +33 -1
- package/templates/puzzle/src/render/materialAssignments.ts +160 -0
- package/templates/puzzle/src/render/materialLighting.ts +155 -0
- package/templates/puzzle/src/render/materials.ts +1 -1
- package/templates/puzzle/src/render/postprocessing.ts +8 -2
- package/templates/puzzle/src/render/quality.ts +62 -1
- package/templates/puzzle/src/render/sky.ts +20 -1
- package/templates/puzzle/src/render/worldEnvironment.ts +433 -30
- package/templates/puzzle/src/scenes/Play.ts +51 -2
- package/templates/puzzle/vite.config.ts +10 -2
- package/templates/racing/AGENTS.md +8 -7
- package/templates/racing/CLAUDE.md +8 -7
- package/templates/racing/package.json +11 -9
- package/templates/racing/playtests/performance.playtest.json +7 -1
- package/templates/racing/playtests/survives.playtest.json +6 -0
- package/templates/racing/src/render/autoExposure.ts +225 -0
- package/templates/racing/src/render/backlightControls.ts +66 -0
- package/templates/racing/src/render/backlightMaterial.ts +147 -0
- package/templates/racing/src/render/environmentContribution.ts +188 -0
- package/templates/racing/src/render/environmentRadiance.ts +36 -0
- package/templates/racing/src/render/environmentSampleCache.ts +43 -0
- package/templates/racing/src/render/environmentSampling.ts +193 -0
- package/templates/racing/src/render/environmentSnapshot.ts +53 -0
- package/templates/racing/src/render/exposure.ts +111 -0
- package/templates/racing/src/render/exposureGraph.ts +178 -0
- package/templates/racing/src/render/exposureReadback.ts +79 -0
- package/templates/racing/src/render/heightFog.ts +118 -0
- package/templates/racing/src/render/lighting.ts +29 -1
- package/templates/racing/src/render/materialAssignments.ts +160 -0
- package/templates/racing/src/render/materialLighting.ts +155 -0
- package/templates/racing/src/render/palette.ts +1 -10
- package/templates/racing/src/render/postprocessing.ts +17 -2
- package/templates/racing/src/render/quality.ts +61 -2
- package/templates/racing/src/render/shapes.ts +0 -25
- package/templates/racing/src/render/sky.ts +21 -1
- package/templates/racing/src/render/worldEnvironment.ts +433 -30
- package/templates/racing/src/scenes/Race.ts +91 -3
- package/templates/racing/src/track/circuit.ts +0 -9
- package/templates/racing/vite.config.ts +10 -2
- package/templates/rain/.codex/config.toml +19 -0
- package/templates/rain/.cursor/mcp.json +32 -0
- package/templates/rain/.gemini/settings.json +32 -0
- package/templates/rain/.mcp.json +32 -0
- package/templates/rain/.vscode/mcp.json +36 -0
- package/templates/rain/.zed/settings.json +36 -0
- package/templates/rain/AGENTS.md +95 -0
- package/templates/rain/CLAUDE.md +97 -0
- package/templates/rain/assets/rain-loop.wav +0 -0
- package/templates/rain/assets/thunder.wav +0 -0
- package/templates/rain/assets/wind-loop.wav +0 -0
- package/templates/rain/index.html +18 -0
- package/templates/rain/kit.json +7 -0
- package/templates/rain/native-playtests/boot.playtest.json +23 -0
- package/templates/rain/native-playtests/lightning.playtest.json +173 -0
- package/templates/rain/opencode.json +41 -0
- package/templates/rain/package.json +59 -0
- package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
- package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
- package/templates/rain/playtests/automation.playtest.json +133 -0
- package/templates/rain/playtests/cinematic.playtest.json +59 -0
- package/templates/rain/playtests/flash.playtest.json +27 -0
- package/templates/rain/playtests/fly.playtest.json +54 -0
- package/templates/rain/playtests/lightning.playtest.json +220 -0
- package/templates/rain/playtests/loading.playtest.json +57 -0
- package/templates/rain/playtests/paused.playtest.json +59 -0
- package/templates/rain/playtests/performance.playtest.json +32 -0
- package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
- package/templates/rain/playtests/simulation.playtest.json +20 -0
- package/templates/rain/playtests/storm.playtest.json +150 -0
- package/templates/rain/playtests/survives.playtest.json +58 -0
- package/templates/rain/playtests/tiers.playtest.json +194 -0
- package/templates/rain/playtests/weather.playtest.json +77 -0
- package/templates/rain/public/favicon.svg +5 -0
- package/templates/rain/src/audio/storm.ts +314 -0
- package/templates/rain/src/game.ts +81 -0
- package/templates/rain/src/main.ts +15 -0
- package/templates/rain/src/render/autoExposure.ts +225 -0
- package/templates/rain/src/render/bloom-shader.ts +65 -0
- package/templates/rain/src/render/camera.ts +160 -0
- package/templates/rain/src/render/clouds-shader.ts +242 -0
- package/templates/rain/src/render/clouds.ts +142 -0
- package/templates/rain/src/render/exposure.ts +111 -0
- package/templates/rain/src/render/exposureGraph.ts +178 -0
- package/templates/rain/src/render/exposureReadback.ts +79 -0
- package/templates/rain/src/render/lighting.ts +39 -0
- package/templates/rain/src/render/lightning.ts +360 -0
- package/templates/rain/src/render/loading.ts +327 -0
- package/templates/rain/src/render/materials.ts +19 -0
- package/templates/rain/src/render/noise-volume.ts +159 -0
- package/templates/rain/src/render/palette.ts +18 -0
- package/templates/rain/src/render/post-shader.ts +178 -0
- package/templates/rain/src/render/postprocessing.ts +229 -0
- package/templates/rain/src/render/quality.ts +161 -0
- package/templates/rain/src/render/rain.ts +299 -0
- package/templates/rain/src/render/sky.ts +28 -0
- package/templates/rain/src/render/world-shader.ts +680 -0
- package/templates/rain/src/render/world.ts +146 -0
- package/templates/rain/src/render/worldEnvironment.ts +1212 -0
- package/templates/rain/src/scenes/Boot.ts +348 -0
- package/templates/rain/src/state.ts +261 -0
- package/templates/rain/src/style.css +1160 -0
- package/templates/rain/src/ui/App.tsx +29 -0
- package/templates/rain/src/ui/GameUi.tsx +187 -0
- package/templates/rain/src/ui/Hud.tsx +327 -0
- package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
- package/templates/rain/src/ui/Menu.tsx +370 -0
- package/templates/rain/src/ui/automation.ts +60 -0
- package/templates/rain/src/ui/main.tsx +7 -0
- package/templates/rain/src/ui/tempest.ts +149 -0
- package/templates/rain/tailwind.config.ts +2 -0
- package/templates/rain/threenative.config.ts +66 -0
- package/templates/rain/tools/generate-shaders.mjs +656 -0
- package/templates/rain/tools/make-storm-audio.mjs +387 -0
- package/templates/rain/tools/storm-dsp.mjs +177 -0
- package/templates/rain/tools/tempest-bloom.frag +10 -0
- package/templates/rain/tools/tempest-clouds.frag +86 -0
- package/templates/rain/tools/tempest-post.frag +47 -0
- package/templates/rain/tools/tempest-world.frag +210 -0
- package/templates/rain/tools/verify-noise-volume.mjs +61 -0
- package/templates/rain/tsconfig.json +17 -0
- package/templates/rain/vite.config.ts +45 -0
- package/templates/rts/AGENTS.md +10 -11
- package/templates/rts/CLAUDE.md +10 -11
- package/templates/rts/package.json +10 -8
- package/templates/rts/playtests/performance.playtest.json +7 -1
- package/templates/rts/playtests/rts-ai-attack.playtest.json +10 -1
- package/templates/rts/playtests/rts-attack.playtest.json +10 -1
- package/templates/rts/playtests/rts-build.playtest.json +10 -1
- package/templates/rts/playtests/rts-orders.playtest.json +7 -1
- package/templates/rts/playtests/rts-train.playtest.json +10 -1
- package/templates/rts/src/render/army.ts +10 -2
- package/templates/rts/src/render/autoExposure.ts +225 -0
- package/templates/rts/src/render/backlightControls.ts +66 -0
- package/templates/rts/src/render/backlightMaterial.ts +147 -0
- package/templates/rts/src/render/environmentContribution.ts +188 -0
- package/templates/rts/src/render/environmentRadiance.ts +36 -0
- package/templates/rts/src/render/environmentSampleCache.ts +43 -0
- package/templates/rts/src/render/environmentSampling.ts +193 -0
- package/templates/rts/src/render/environmentSnapshot.ts +53 -0
- package/templates/rts/src/render/exposure.ts +111 -0
- package/templates/rts/src/render/exposureGraph.ts +178 -0
- package/templates/rts/src/render/exposureReadback.ts +79 -0
- package/templates/rts/src/render/heightFog.ts +118 -0
- package/templates/rts/src/render/lighting.ts +26 -1
- package/templates/rts/src/render/materialAssignments.ts +160 -0
- package/templates/rts/src/render/materialLighting.ts +155 -0
- package/templates/rts/src/render/postprocessing.ts +8 -2
- package/templates/rts/src/render/quality.ts +61 -2
- package/templates/rts/src/render/sky.ts +21 -1
- package/templates/rts/src/render/worldEnvironment.ts +433 -30
- package/templates/rts/src/scenes/Play.ts +54 -3
- package/templates/rts/src/sim/ai.ts +0 -1
- package/templates/rts/src/sim/terrain.ts +0 -4
- package/templates/rts/vite.config.ts +10 -2
- package/templates/runner/AGENTS.md +10 -8
- package/templates/runner/CLAUDE.md +10 -8
- package/templates/runner/package.json +11 -9
- package/templates/runner/playtests/performance.playtest.json +10 -1
- package/templates/runner/src/physics.ts +0 -1
- package/templates/runner/src/render/autoExposure.ts +225 -0
- package/templates/runner/src/render/backlightControls.ts +66 -0
- package/templates/runner/src/render/backlightMaterial.ts +147 -0
- package/templates/runner/src/render/environmentContribution.ts +188 -0
- package/templates/runner/src/render/environmentRadiance.ts +36 -0
- package/templates/runner/src/render/environmentSampleCache.ts +43 -0
- package/templates/runner/src/render/environmentSampling.ts +193 -0
- package/templates/runner/src/render/environmentSnapshot.ts +53 -0
- package/templates/runner/src/render/exposure.ts +111 -0
- package/templates/runner/src/render/exposureGraph.ts +178 -0
- package/templates/runner/src/render/exposureReadback.ts +79 -0
- package/templates/runner/src/render/heightFog.ts +118 -0
- package/templates/runner/src/render/lighting.ts +26 -1
- package/templates/runner/src/render/materialAssignments.ts +160 -0
- package/templates/runner/src/render/materialLighting.ts +155 -0
- package/templates/runner/src/render/postprocessing.ts +17 -2
- package/templates/runner/src/render/quality.ts +61 -2
- package/templates/runner/src/render/sky.ts +21 -1
- package/templates/runner/src/render/worldEnvironment.ts +433 -30
- package/templates/runner/src/scenes/Run.ts +67 -2
- package/templates/runner/threenative.config.ts +3 -0
- package/templates/runner/vite.config.ts +10 -2
- package/templates/sailing/AGENTS.md +14 -13
- package/templates/sailing/CLAUDE.md +14 -13
- package/templates/sailing/native-playtests/survives.playtest.json +7 -0
- package/templates/sailing/package.json +11 -9
- package/templates/sailing/playtests/live/render-motion.playtest.json +30 -0
- package/templates/sailing/src/entities/Ship.ts +38 -18
- package/templates/sailing/src/render/autoExposure.ts +225 -0
- package/templates/sailing/src/render/backlightControls.ts +66 -0
- package/templates/sailing/src/render/backlightMaterial.ts +147 -0
- package/templates/sailing/src/render/camera.ts +12 -4
- package/templates/sailing/src/render/environmentContribution.ts +188 -0
- package/templates/sailing/src/render/environmentRadiance.ts +36 -0
- package/templates/sailing/src/render/environmentSampleCache.ts +43 -0
- package/templates/sailing/src/render/environmentSampling.ts +193 -0
- package/templates/sailing/src/render/environmentSetup.ts +24 -0
- package/templates/sailing/src/render/environmentSnapshot.ts +53 -0
- package/templates/sailing/src/render/exposure.ts +111 -0
- package/templates/sailing/src/render/exposureGraph.ts +178 -0
- package/templates/sailing/src/render/exposureReadback.ts +79 -0
- package/templates/sailing/src/render/heightFog.ts +118 -0
- package/templates/sailing/src/render/lighting.ts +26 -1
- package/templates/sailing/src/render/materialAssignments.ts +160 -0
- package/templates/sailing/src/render/materialLighting.ts +155 -0
- package/templates/sailing/src/render/ocean.ts +71 -53
- package/templates/sailing/src/render/postprocessing.ts +16 -2
- package/templates/sailing/src/render/props.ts +0 -45
- package/templates/sailing/src/render/quality.ts +61 -1
- package/templates/sailing/src/render/sky.ts +21 -1
- package/templates/sailing/src/render/worldEnvironment.ts +433 -30
- package/templates/sailing/src/scenes/Boot.ts +12 -1
- package/templates/sailing/src/scenes/Sailing.ts +87 -2
- package/templates/sailing/src/scenes/ocean-readiness.ts +68 -0
- package/templates/sailing/threenative.config.ts +3 -0
- package/templates/sailing/vite.config.ts +10 -2
- package/templates/shooter/AGENTS.md +8 -6
- package/templates/shooter/CLAUDE.md +8 -6
- package/templates/shooter/package.json +11 -9
- package/templates/shooter/playtests/performance.playtest.json +7 -1
- package/templates/shooter/src/entities/Enemy.ts +0 -15
- package/templates/shooter/src/entities/Rifle.ts +38 -1
- package/templates/shooter/src/render/autoExposure.ts +225 -0
- package/templates/shooter/src/render/backlightControls.ts +66 -0
- package/templates/shooter/src/render/backlightMaterial.ts +147 -0
- package/templates/shooter/src/render/camera.ts +1 -12
- package/templates/shooter/src/render/decals.ts +299 -5
- package/templates/shooter/src/render/environmentContribution.ts +188 -0
- package/templates/shooter/src/render/environmentRadiance.ts +36 -0
- package/templates/shooter/src/render/environmentSampleCache.ts +43 -0
- package/templates/shooter/src/render/environmentSampling.ts +193 -0
- package/templates/shooter/src/render/environmentSnapshot.ts +53 -0
- package/templates/shooter/src/render/exposure.ts +111 -0
- package/templates/shooter/src/render/exposureGraph.ts +178 -0
- package/templates/shooter/src/render/exposureReadback.ts +79 -0
- package/templates/shooter/src/render/gunfx.ts +0 -1
- package/templates/shooter/src/render/heightFog.ts +118 -0
- package/templates/shooter/src/render/lighting.ts +26 -1
- package/templates/shooter/src/render/materialAssignments.ts +160 -0
- package/templates/shooter/src/render/materialLighting.ts +155 -0
- package/templates/shooter/src/render/postprocessing.ts +17 -2
- package/templates/shooter/src/render/quality.ts +61 -2
- package/templates/shooter/src/render/scale.ts +2 -93
- package/templates/shooter/src/render/sky.ts +21 -1
- package/templates/shooter/src/render/vehicles.ts +0 -17
- package/templates/shooter/src/render/worldEnvironment.ts +433 -30
- package/templates/shooter/src/scenes/Play.ts +64 -2
- package/templates/shooter/vite.config.ts +10 -2
- package/templates/snow/.codex/config.toml +19 -0
- package/templates/snow/.cursor/mcp.json +32 -0
- package/templates/snow/.gemini/settings.json +32 -0
- package/templates/snow/.mcp.json +32 -0
- package/templates/snow/.vscode/mcp.json +36 -0
- package/templates/snow/.zed/settings.json +36 -0
- package/templates/snow/AGENTS.md +90 -0
- package/templates/snow/CLAUDE.md +92 -0
- package/templates/snow/README.md +26 -0
- package/templates/snow/assets/crunch.wav +0 -0
- package/templates/snow/assets/wind.wav +0 -0
- package/templates/snow/index.html +12 -0
- package/templates/snow/kit.json +7 -0
- package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
- package/templates/snow/native-playtests/survives.playtest.json +47 -0
- package/templates/snow/opencode.json +41 -0
- package/templates/snow/package.json +60 -0
- package/templates/snow/playtests/footsteps.playtest.json +95 -0
- package/templates/snow/playtests/performance.playtest.json +36 -0
- package/templates/snow/playtests/snow-physics.playtest.json +154 -0
- package/templates/snow/playtests/survives.playtest.json +56 -0
- package/templates/snow/playtests/touch-controls.playtest.json +71 -0
- package/templates/snow/playtests/weather.playtest.json +119 -0
- package/templates/snow/public/favicon.svg +5 -0
- package/templates/snow/src/audio.ts +58 -0
- package/templates/snow/src/commands.ts +8 -0
- package/templates/snow/src/entities/Explorer.ts +279 -0
- package/templates/snow/src/game.ts +69 -0
- package/templates/snow/src/main.ts +15 -0
- package/templates/snow/src/render/autoExposure.ts +225 -0
- package/templates/snow/src/render/backlightControls.ts +66 -0
- package/templates/snow/src/render/backlightMaterial.ts +147 -0
- package/templates/snow/src/render/bootPrint.ts +50 -0
- package/templates/snow/src/render/camera.ts +84 -0
- package/templates/snow/src/render/environmentContribution.ts +188 -0
- package/templates/snow/src/render/environmentRadiance.ts +36 -0
- package/templates/snow/src/render/environmentSampleCache.ts +43 -0
- package/templates/snow/src/render/environmentSampling.ts +193 -0
- package/templates/snow/src/render/environmentSnapshot.ts +53 -0
- package/templates/snow/src/render/explorer.ts +321 -0
- package/templates/snow/src/render/exposure.ts +111 -0
- package/templates/snow/src/render/exposureGraph.ts +178 -0
- package/templates/snow/src/render/exposureReadback.ts +79 -0
- package/templates/snow/src/render/heightFog.ts +118 -0
- package/templates/snow/src/render/lighting.ts +82 -0
- package/templates/snow/src/render/loading.ts +325 -0
- package/templates/snow/src/render/materialAssignments.ts +160 -0
- package/templates/snow/src/render/materialLighting.ts +155 -0
- package/templates/snow/src/render/materials.ts +36 -0
- package/templates/snow/src/render/palette.ts +17 -0
- package/templates/snow/src/render/postprocessing.ts +58 -0
- package/templates/snow/src/render/props.ts +42 -0
- package/templates/snow/src/render/quality.ts +193 -0
- package/templates/snow/src/render/scenery.ts +244 -0
- package/templates/snow/src/render/sky.ts +76 -0
- package/templates/snow/src/render/snowSurface.ts +259 -0
- package/templates/snow/src/render/touch-controls.ts +143 -0
- package/templates/snow/src/render/weather.ts +279 -0
- package/templates/snow/src/render/worldEnvironment.ts +1212 -0
- package/templates/snow/src/scenes/Boot.ts +12 -0
- package/templates/snow/src/scenes/Snow.ts +663 -0
- package/templates/snow/src/state.ts +46 -0
- package/templates/snow/src/style.css +143 -0
- package/templates/snow/src/terrain.ts +64 -0
- package/templates/snow/src/ui/App.tsx +15 -0
- package/templates/snow/src/ui/Controls.tsx +322 -0
- package/templates/snow/src/ui/GameUi.tsx +354 -0
- package/templates/snow/src/ui/icons.tsx +54 -0
- package/templates/snow/src/ui/main.tsx +7 -0
- package/templates/snow/tailwind.config.ts +2 -0
- package/templates/snow/threenative.config.ts +54 -0
- package/templates/snow/tsconfig.json +17 -0
- package/templates/snow/vite.config.ts +45 -0
- package/templates/starter/AGENTS.md +11 -16
- package/templates/starter/CLAUDE.md +11 -16
- package/templates/starter/native-playtests/react-hud.playtest.json +1 -1
- package/templates/starter/native-playtests/render-chain.playtest.json +51 -8
- package/templates/starter/native-playtests/smooth-motion.playtest.json +64 -0
- package/templates/starter/package.json +11 -9
- package/templates/starter/playtests/live/smooth-motion.playtest.json +63 -0
- package/templates/starter/playtests/movement.playtest.json +192 -0
- package/templates/starter/playtests/play.playtest.json +18 -2
- package/templates/starter/playtests/production-readiness.playtest.json +1 -1
- package/templates/starter/public/grade.cube +735 -0
- package/templates/starter/src/entities/Crate.ts +4 -0
- package/templates/starter/src/entities/Player.ts +79 -18
- package/templates/starter/src/game.ts +1 -0
- package/templates/starter/src/render/adaptiveQuality.ts +28 -41
- package/templates/starter/src/render/autoExposure.ts +225 -0
- package/templates/starter/src/render/backlightControls.ts +66 -0
- package/templates/starter/src/render/backlightMaterial.ts +147 -0
- package/templates/starter/src/render/environmentContribution.ts +188 -0
- package/templates/starter/src/render/environmentRadiance.ts +36 -0
- package/templates/starter/src/render/environmentSampleCache.ts +43 -0
- package/templates/starter/src/render/environmentSampling.ts +193 -0
- package/templates/starter/src/render/environmentSnapshot.ts +53 -0
- package/templates/starter/src/render/exposure.ts +111 -0
- package/templates/starter/src/render/exposureGraph.ts +178 -0
- package/templates/starter/src/render/exposureReadback.ts +79 -0
- package/templates/starter/src/render/grade.ts +157 -0
- package/templates/starter/src/render/heightFog.ts +118 -0
- package/templates/starter/src/render/lighting.ts +26 -1
- package/templates/starter/src/render/materialAssignments.ts +160 -0
- package/templates/starter/src/render/materialLighting.ts +155 -0
- package/templates/starter/src/render/postprocessing.ts +84 -4
- package/templates/starter/src/render/quality.ts +80 -8
- package/templates/starter/src/render/qualityPolicy.ts +54 -0
- package/templates/starter/src/render/rendererGate.ts +36 -0
- package/templates/starter/src/render/sky.ts +23 -1
- package/templates/starter/src/render/temporalAA.ts +197 -0
- package/templates/starter/src/render/temporalAAFrame.ts +179 -0
- package/templates/starter/src/render/temporalAAHooks.ts +101 -0
- package/templates/starter/src/render/temporalAAInput.ts +56 -0
- package/templates/starter/src/render/temporalAAResolve.ts +65 -0
- package/templates/starter/src/render/temporalAAStage.ts +76 -0
- package/templates/starter/src/render/temporalCurrentArea.ts +31 -0
- package/templates/starter/src/render/temporalCurrentFootprint.ts +198 -0
- package/templates/starter/src/render/temporalCurrentFootprintMath.ts +41 -0
- package/templates/starter/src/render/temporalCurrentProducer.ts +161 -0
- package/templates/starter/src/render/temporalCurrentReplay.ts +160 -0
- package/templates/starter/src/render/temporalCurrentSelection.ts +89 -0
- package/templates/starter/src/render/temporalCurrentVisibility.ts +170 -0
- package/templates/starter/src/render/temporalDepthSamples.ts +34 -0
- package/templates/starter/src/render/temporalRejectionCounter.ts +179 -0
- package/templates/starter/src/render/temporalResolve.ts +139 -0
- package/templates/starter/src/render/temporalResolveDepth.ts +193 -0
- package/templates/starter/src/render/temporalResolveMath.ts +196 -0
- package/templates/starter/src/render/volumetricFog.ts +124 -0
- package/templates/starter/src/render/volumetricFogOptions.ts +96 -0
- package/templates/starter/src/render/volumetricFogTransport.ts +176 -0
- package/templates/starter/src/render/volumetricFogVolume.ts +139 -0
- package/templates/starter/src/render/worldEnvironment.ts +433 -30
- package/templates/starter/src/scenes/Play.ts +110 -1
- package/templates/starter/src/state.ts +1 -0
- package/templates/starter/src/ui/Hud.tsx +1 -1
- package/templates/starter/src/ui/Menu.tsx +1 -1
- package/templates/starter/tools/make-grade-lut.mjs +101 -0
- package/templates/starter/vite.config.ts +10 -2
- package/templates/tower-defense/AGENTS.md +10 -9
- package/templates/tower-defense/CLAUDE.md +10 -9
- package/templates/tower-defense/package.json +11 -9
- package/templates/tower-defense/playtests/performance.playtest.json +7 -1
- package/templates/tower-defense/src/render/autoExposure.ts +225 -0
- package/templates/tower-defense/src/render/backlightControls.ts +66 -0
- package/templates/tower-defense/src/render/backlightMaterial.ts +147 -0
- package/templates/tower-defense/src/render/environmentContribution.ts +188 -0
- package/templates/tower-defense/src/render/environmentRadiance.ts +36 -0
- package/templates/tower-defense/src/render/environmentSampleCache.ts +43 -0
- package/templates/tower-defense/src/render/environmentSampling.ts +193 -0
- package/templates/tower-defense/src/render/environmentSnapshot.ts +53 -0
- package/templates/tower-defense/src/render/exposure.ts +111 -0
- package/templates/tower-defense/src/render/exposureGraph.ts +178 -0
- package/templates/tower-defense/src/render/exposureReadback.ts +79 -0
- package/templates/tower-defense/src/render/lighting.ts +33 -1
- package/templates/tower-defense/src/render/materialAssignments.ts +160 -0
- package/templates/tower-defense/src/render/materialLighting.ts +155 -0
- package/templates/tower-defense/src/render/postprocessing.ts +8 -2
- package/templates/tower-defense/src/render/quality.ts +61 -2
- package/templates/tower-defense/src/render/shapes.ts +0 -3
- package/templates/tower-defense/src/render/worldEnvironment.ts +433 -30
- package/templates/tower-defense/src/scenes/Battle.ts +65 -2
- package/templates/tower-defense/vite.config.ts +10 -2
- package/templates/minimal/src/scenes/Boot.ts +0 -5
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "snow-touch-controls",
|
|
3
|
+
"schemaVersion": 1,
|
|
4
|
+
"target": "web",
|
|
5
|
+
"viewport": {
|
|
6
|
+
"width": 390,
|
|
7
|
+
"height": 844
|
|
8
|
+
},
|
|
9
|
+
"warmupFrames": 10,
|
|
10
|
+
"subject": "player",
|
|
11
|
+
"steps": [
|
|
12
|
+
{
|
|
13
|
+
"kind": "input",
|
|
14
|
+
"label": "movement-anchor",
|
|
15
|
+
"pointers": [
|
|
16
|
+
{
|
|
17
|
+
"id": 7,
|
|
18
|
+
"x": 0.25,
|
|
19
|
+
"y": 0.82
|
|
20
|
+
}
|
|
21
|
+
],
|
|
22
|
+
"holdTicks": 2,
|
|
23
|
+
"release": false
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"kind": "input",
|
|
27
|
+
"label": "walk-forward",
|
|
28
|
+
"pointers": [
|
|
29
|
+
{
|
|
30
|
+
"id": 7,
|
|
31
|
+
"x": 0.25,
|
|
32
|
+
"y": 0.72
|
|
33
|
+
}
|
|
34
|
+
],
|
|
35
|
+
"holdTicks": 120,
|
|
36
|
+
"release": true
|
|
37
|
+
},
|
|
38
|
+
{
|
|
39
|
+
"kind": "wait",
|
|
40
|
+
"label": "settled",
|
|
41
|
+
"waitTicks": 10,
|
|
42
|
+
"release": true
|
|
43
|
+
}
|
|
44
|
+
],
|
|
45
|
+
"assert": {
|
|
46
|
+
"diagnostics": {
|
|
47
|
+
"noConsoleErrors": true,
|
|
48
|
+
"noNetworkErrors": true,
|
|
49
|
+
"noRuntimeDiagnostics": true,
|
|
50
|
+
"runtimeReady": true
|
|
51
|
+
},
|
|
52
|
+
"movement": {
|
|
53
|
+
"entity": "player",
|
|
54
|
+
"minDistance": 0.5
|
|
55
|
+
},
|
|
56
|
+
"resources": [
|
|
57
|
+
{
|
|
58
|
+
"id": "state",
|
|
59
|
+
"path": "autoExplore",
|
|
60
|
+
"equals": false
|
|
61
|
+
}
|
|
62
|
+
],
|
|
63
|
+
"visibility": [
|
|
64
|
+
{
|
|
65
|
+
"entity": "touch-controls",
|
|
66
|
+
"present": true,
|
|
67
|
+
"allowTrivial": "Touch-primary lanes keep the movement stick visible while the walk proves it is live."
|
|
68
|
+
}
|
|
69
|
+
]
|
|
70
|
+
}
|
|
71
|
+
}
|
|
@@ -0,0 +1,119 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "snow-weather",
|
|
3
|
+
"schemaVersion": 1,
|
|
4
|
+
"target": "web",
|
|
5
|
+
"viewport": {
|
|
6
|
+
"width": 1280,
|
|
7
|
+
"height": 720
|
|
8
|
+
},
|
|
9
|
+
"warmupFrames": 20,
|
|
10
|
+
"subject": "player",
|
|
11
|
+
"steps": [
|
|
12
|
+
{
|
|
13
|
+
"kind": "input",
|
|
14
|
+
"label": "hands-off",
|
|
15
|
+
"press": "KeyP",
|
|
16
|
+
"holdTicks": 2,
|
|
17
|
+
"release": true
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"kind": "wait",
|
|
21
|
+
"label": "calm",
|
|
22
|
+
"waitTicks": 20,
|
|
23
|
+
"release": true
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"kind": "input",
|
|
27
|
+
"label": "blizzard",
|
|
28
|
+
"press": "KeyB",
|
|
29
|
+
"holdTicks": 1,
|
|
30
|
+
"release": true
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
"kind": "wait",
|
|
34
|
+
"label": "storm",
|
|
35
|
+
"waitTicks": 300,
|
|
36
|
+
"release": true
|
|
37
|
+
},
|
|
38
|
+
{
|
|
39
|
+
"kind": "input",
|
|
40
|
+
"label": "compaction",
|
|
41
|
+
"press": "KeyV",
|
|
42
|
+
"holdTicks": 1,
|
|
43
|
+
"release": true
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
"kind": "input",
|
|
47
|
+
"label": "reset",
|
|
48
|
+
"press": "KeyR",
|
|
49
|
+
"holdTicks": 1,
|
|
50
|
+
"release": true
|
|
51
|
+
},
|
|
52
|
+
{
|
|
53
|
+
"kind": "wait",
|
|
54
|
+
"label": "fresh",
|
|
55
|
+
"waitTicks": 20,
|
|
56
|
+
"release": true
|
|
57
|
+
}
|
|
58
|
+
],
|
|
59
|
+
"assert": {
|
|
60
|
+
"diagnostics": {
|
|
61
|
+
"noConsoleErrors": true,
|
|
62
|
+
"noNetworkErrors": true,
|
|
63
|
+
"noRuntimeDiagnostics": true,
|
|
64
|
+
"runtimeReady": true
|
|
65
|
+
},
|
|
66
|
+
"components": [
|
|
67
|
+
{
|
|
68
|
+
"entity": "weather",
|
|
69
|
+
"component": "storm",
|
|
70
|
+
"gte": 0.6,
|
|
71
|
+
"allowTrivial": "Five seconds after B the blizzard has mostly built: the eased storm level passes 0.6."
|
|
72
|
+
},
|
|
73
|
+
{
|
|
74
|
+
"entity": "weather",
|
|
75
|
+
"component": "wind",
|
|
76
|
+
"gte": 4,
|
|
77
|
+
"allowTrivial": "A blizzard blows at several metres a second, gusts included."
|
|
78
|
+
},
|
|
79
|
+
{
|
|
80
|
+
"entity": "snow",
|
|
81
|
+
"component": "trailPressed",
|
|
82
|
+
"atSteps": [
|
|
83
|
+
{
|
|
84
|
+
"label": "calm",
|
|
85
|
+
"equals": true
|
|
86
|
+
},
|
|
87
|
+
{
|
|
88
|
+
"label": "fresh",
|
|
89
|
+
"equals": false
|
|
90
|
+
}
|
|
91
|
+
],
|
|
92
|
+
"allowTrivial": "The arrival trail is in the snow at the start and gone after R clears every footprint."
|
|
93
|
+
}
|
|
94
|
+
],
|
|
95
|
+
"resources": [
|
|
96
|
+
{
|
|
97
|
+
"id": "state",
|
|
98
|
+
"path": "blizzard",
|
|
99
|
+
"equals": true
|
|
100
|
+
},
|
|
101
|
+
{
|
|
102
|
+
"id": "state",
|
|
103
|
+
"path": "compaction",
|
|
104
|
+
"equals": true
|
|
105
|
+
}
|
|
106
|
+
],
|
|
107
|
+
"visual": [
|
|
108
|
+
{
|
|
109
|
+
"region": {
|
|
110
|
+
"x": 0,
|
|
111
|
+
"y": 0,
|
|
112
|
+
"width": 1280,
|
|
113
|
+
"height": 720,
|
|
114
|
+
"minNonblankPixelRatio": 0.01
|
|
115
|
+
}
|
|
116
|
+
}
|
|
117
|
+
]
|
|
118
|
+
}
|
|
119
|
+
}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64">
|
|
2
|
+
<rect width="64" height="64" rx="14" fill="#061b2b"/>
|
|
3
|
+
<path d="M10 45h44M17 45l16-30 14 30M25 30h17" fill="none" stroke="#ffd27a" stroke-linecap="round" stroke-linejoin="round" stroke-width="5"/>
|
|
4
|
+
<path d="M12 51c8-4 16 4 24 0s16 4 16 0" fill="none" stroke="#6fe8ff" stroke-linecap="round" stroke-width="4"/>
|
|
5
|
+
</svg>
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { AudioBus } from "@threenative/core";
|
|
2
|
+
import type { Audio, Object3D } from "three";
|
|
3
|
+
import type { IFootstep } from "./entities/Explorer.js";
|
|
4
|
+
|
|
5
|
+
/**
|
|
6
|
+
* Boot crunch and a wind bed through one `AudioBus`. Both clips in `assets/` are generated
|
|
7
|
+
* noise — a bandpass sweep for the crunch, filtered brown noise for the wind — so swap either
|
|
8
|
+
* file for a recording without touching this code. Muted means the bus level is zero; the wind
|
|
9
|
+
* keeps looping underneath so unmuting never restarts it mid-gust.
|
|
10
|
+
*/
|
|
11
|
+
export class SnowAudio {
|
|
12
|
+
readonly bus: AudioBus;
|
|
13
|
+
#crunch: AudioBuffer | undefined;
|
|
14
|
+
#wind: Audio | undefined;
|
|
15
|
+
#muted = true;
|
|
16
|
+
|
|
17
|
+
constructor(camera: Object3D, load: (name: string) => Promise<AudioBuffer>) {
|
|
18
|
+
this.bus = new AudioBus({ camera });
|
|
19
|
+
this.bus.setVolume(0);
|
|
20
|
+
void load("crunch.wav")
|
|
21
|
+
.then((buffer) => {
|
|
22
|
+
this.#crunch = buffer;
|
|
23
|
+
})
|
|
24
|
+
.catch(() => undefined);
|
|
25
|
+
void load("wind.wav")
|
|
26
|
+
.then((buffer) => {
|
|
27
|
+
this.#wind = this.bus.play(buffer, { cue: "wind", loop: true, volume: 0 });
|
|
28
|
+
})
|
|
29
|
+
.catch(() => undefined);
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
get muted(): boolean {
|
|
33
|
+
return this.#muted;
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
setMuted(muted: boolean): void {
|
|
37
|
+
this.#muted = muted;
|
|
38
|
+
this.bus.setVolume(muted ? 0 : 1, 0.2);
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
footstep(step: IFootstep): void {
|
|
42
|
+
if (this.#muted || this.#crunch === undefined || step.penetration <= 0) return;
|
|
43
|
+
this.bus.play(this.#crunch, {
|
|
44
|
+
cue: "crunch",
|
|
45
|
+
detune: (Math.random() - 0.5) * 400,
|
|
46
|
+
volume: Math.min(1, 0.42 + step.penetration * 2),
|
|
47
|
+
});
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/** The wind bed follows the live wind and swells with the storm. */
|
|
51
|
+
update(wind: number, storm: number): void {
|
|
52
|
+
this.#wind?.setVolume(Math.min(1, 0.12 + storm * 0.55 + wind * 0.01));
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
dispose(): void {
|
|
56
|
+
this.bus.dispose();
|
|
57
|
+
}
|
|
58
|
+
}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* One-shot actions from the HUD. Sliders and toggles are state; these are verbs, so the UI pushes
|
|
3
|
+
* them here and the scene drains the queue on its next fixed step — the same functions a key
|
|
4
|
+
* press calls, so the keyboard and the panel can never disagree.
|
|
5
|
+
*/
|
|
6
|
+
export type Command = "reset" | "drop" | "kick" | "view" | "auto" | "blizzard" | "mute";
|
|
7
|
+
|
|
8
|
+
export const commands: Command[] = [];
|
|
@@ -0,0 +1,279 @@
|
|
|
1
|
+
import type { SnowField } from "@threenative/core/world";
|
|
2
|
+
import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
|
|
3
|
+
import { Object3D } from "three";
|
|
4
|
+
import { BOOT_AREA, bootPrint } from "../render/bootPrint.js";
|
|
5
|
+
import { ExplorerModel, type IFootPose } from "../render/explorer.js";
|
|
6
|
+
import type { SnowMaterials } from "../render/materials.js";
|
|
7
|
+
import { EXPLORER_LAYER, SNOW_LAYER, terrainHeight } from "../terrain.js";
|
|
8
|
+
|
|
9
|
+
/** One planted boot: where, how it was turned, and how far it sank. */
|
|
10
|
+
export interface IFootstep {
|
|
11
|
+
readonly x: number;
|
|
12
|
+
readonly y: number;
|
|
13
|
+
readonly z: number;
|
|
14
|
+
readonly angle: number;
|
|
15
|
+
readonly penetration: number;
|
|
16
|
+
readonly speed: number;
|
|
17
|
+
readonly side: number;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
interface IFoot extends IFootPose {
|
|
21
|
+
side: number;
|
|
22
|
+
x: number;
|
|
23
|
+
y: number;
|
|
24
|
+
z: number;
|
|
25
|
+
angle: number;
|
|
26
|
+
swing: boolean;
|
|
27
|
+
progress: number;
|
|
28
|
+
stop: number;
|
|
29
|
+
from: { x: number; z: number };
|
|
30
|
+
to: { x: number; z: number };
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
/** The explorer's weight, which every planted boot presses into the snow. */
|
|
34
|
+
const MASS = 80;
|
|
35
|
+
const GRAVITY = 9.81;
|
|
36
|
+
/** Capsule straight half-length and radius: 1.7 m tall, origin at the waist. */
|
|
37
|
+
const HALF_HEIGHT = 0.55;
|
|
38
|
+
const RADIUS = 0.3;
|
|
39
|
+
const WAIST = HALF_HEIGHT + RADIUS;
|
|
40
|
+
/**
|
|
41
|
+
* How far each boot lands from the line of travel. Wide enough that the left and right prints
|
|
42
|
+
* stay two rows with snow between them rather than merging into one trench.
|
|
43
|
+
*/
|
|
44
|
+
export const STANCE = 0.2;
|
|
45
|
+
|
|
46
|
+
const clamp = (value: number, low: number, high: number) => Math.max(low, Math.min(high, value));
|
|
47
|
+
const lerp = (a: number, b: number, t: number) => a + (b - a) * t;
|
|
48
|
+
const damp = (a: number, b: number, rate: number, dt: number) =>
|
|
49
|
+
lerp(a, b, 1 - Math.exp(-rate * Math.max(0, dt)));
|
|
50
|
+
const smoothstep = (edge0: number, edge1: number, value: number) => {
|
|
51
|
+
const t = clamp((value - edge0) / (edge1 - edge0), 0, 1);
|
|
52
|
+
return t * t * (3 - 2 * t);
|
|
53
|
+
};
|
|
54
|
+
|
|
55
|
+
/** Walking pace through powder: deeper, softer snow is slower; packed snow is faster. */
|
|
56
|
+
function paceThrough(depth: number, compaction: number, running: boolean): number {
|
|
57
|
+
const resistance = clamp(depth, 0, 0.6) * (1 - clamp(compaction, 0, 1) * 0.75);
|
|
58
|
+
return (running ? 3.25 : 1.65) / (1 + resistance * 3.5);
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* The procedural explorer. Movement goes through a `CharacterBody3D`, so trees, rocks and the
|
|
63
|
+
* ball stop or get pushed by real collision; each boot is planted by the walk cycle, and only a
|
|
64
|
+
* grounded body plants one. A planted boot presses `bootPrint` into the snow with the explorer's
|
|
65
|
+
* own weight over the sole's area — the snow decides how deep that goes.
|
|
66
|
+
*/
|
|
67
|
+
export class Explorer {
|
|
68
|
+
readonly body: CharacterBody3D;
|
|
69
|
+
readonly model: ExplorerModel;
|
|
70
|
+
/** What a playtest or camera tracks: the drawn explorer, not the collision capsule. */
|
|
71
|
+
readonly object: Object3D;
|
|
72
|
+
readonly position = { x: 0, y: 0, z: 0 };
|
|
73
|
+
heading = Math.PI;
|
|
74
|
+
speed = 0;
|
|
75
|
+
steps = 0;
|
|
76
|
+
#velocity = { x: 0, z: 0 };
|
|
77
|
+
#cycle = 0.1;
|
|
78
|
+
#elapsed = 0;
|
|
79
|
+
#last = { x: 0, z: 0 };
|
|
80
|
+
readonly #feet: IFoot[] = [];
|
|
81
|
+
readonly #snow: SnowField;
|
|
82
|
+
readonly #onStep: (step: IFootstep) => void;
|
|
83
|
+
|
|
84
|
+
constructor(
|
|
85
|
+
physics: IPhysicsContext,
|
|
86
|
+
snow: SnowField,
|
|
87
|
+
materials: SnowMaterials,
|
|
88
|
+
start: { x: number; z: number },
|
|
89
|
+
onStep: (step: IFootstep) => void,
|
|
90
|
+
) {
|
|
91
|
+
this.#snow = snow;
|
|
92
|
+
this.#onStep = onStep;
|
|
93
|
+
const anchor = new Object3D();
|
|
94
|
+
anchor.position.set(start.x, snow.heightAt(start.x, start.z) + WAIST + 0.05, start.z);
|
|
95
|
+
this.body = new CharacterBody3D({
|
|
96
|
+
autostep: { maxHeight: 0.25, minWidth: 0.1 },
|
|
97
|
+
maxSlopeClimbAngle: 0.8,
|
|
98
|
+
object: anchor,
|
|
99
|
+
physics,
|
|
100
|
+
// Stands on the coarse walk surface, never the 6 cm snow collider (see `WALK_SAMPLES`).
|
|
101
|
+
collisionLayer: EXPLORER_LAYER,
|
|
102
|
+
collisionMask: 0xffff & ~SNOW_LAYER,
|
|
103
|
+
pushesDynamicBodies: true,
|
|
104
|
+
shape: CollisionShape3D.capsule(HALF_HEIGHT, RADIUS),
|
|
105
|
+
snapToGround: 0.3,
|
|
106
|
+
});
|
|
107
|
+
this.model = new ExplorerModel(materials);
|
|
108
|
+
this.object = this.model.root;
|
|
109
|
+
this.position.x = start.x;
|
|
110
|
+
this.position.z = start.z;
|
|
111
|
+
this.position.y = snow.heightAt(start.x, start.z) - 0.07;
|
|
112
|
+
this.#last = { x: start.x, z: start.z };
|
|
113
|
+
for (const side of [-1, 1]) {
|
|
114
|
+
const x = start.x + side * STANCE * Math.cos(this.heading);
|
|
115
|
+
const z = start.z - side * STANCE * Math.sin(this.heading);
|
|
116
|
+
this.#feet.push({
|
|
117
|
+
angle: this.heading,
|
|
118
|
+
from: { x, z },
|
|
119
|
+
progress: 0,
|
|
120
|
+
side,
|
|
121
|
+
stop: 0,
|
|
122
|
+
swing: false,
|
|
123
|
+
to: { x, z },
|
|
124
|
+
x,
|
|
125
|
+
y: snow.heightAt(x, z) + 0.14,
|
|
126
|
+
z,
|
|
127
|
+
});
|
|
128
|
+
}
|
|
129
|
+
this.model.pose(this.position, this.heading, this.#feet, this.#cycle, 0, 0);
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/** Steer towards `move` (a world-space direction, length up to 1) for one fixed step. */
|
|
133
|
+
update(dt: number, move: { x: number; z: number }, running: boolean, hardness: number): void {
|
|
134
|
+
this.#elapsed += dt;
|
|
135
|
+
const snow = this.#snow;
|
|
136
|
+
const anchor = this.body.object.position;
|
|
137
|
+
// The walk cycle advances by the ground the body actually covered, so a blocked explorer
|
|
138
|
+
// treads in place instead of skating.
|
|
139
|
+
const travelled = Math.hypot(anchor.x - this.#last.x, anchor.z - this.#last.z);
|
|
140
|
+
this.speed = travelled / Math.max(1e-4, dt);
|
|
141
|
+
this.#last = { x: anchor.x, z: anchor.z };
|
|
142
|
+
this.position.x = anchor.x;
|
|
143
|
+
this.position.z = anchor.z;
|
|
144
|
+
|
|
145
|
+
const pace = paceThrough(snow.depth, snow.sample(anchor.x, anchor.z).compaction, running);
|
|
146
|
+
const length = Math.hypot(move.x, move.z);
|
|
147
|
+
const scale = length > 1 ? 1 / length : 1;
|
|
148
|
+
const moving = length > 0.01;
|
|
149
|
+
this.#velocity.x = damp(this.#velocity.x, move.x * scale * pace, moving ? 5 : 8, dt);
|
|
150
|
+
this.#velocity.z = damp(this.#velocity.z, move.z * scale * pace, moving ? 5 : 8, dt);
|
|
151
|
+
if (!moving && Math.hypot(this.#velocity.x, this.#velocity.z) < 0.025) {
|
|
152
|
+
this.#velocity.x = 0;
|
|
153
|
+
this.#velocity.z = 0;
|
|
154
|
+
}
|
|
155
|
+
this.body.velocity.x = this.#velocity.x;
|
|
156
|
+
this.body.velocity.z = this.#velocity.z;
|
|
157
|
+
this.body.moveAndSlide(dt);
|
|
158
|
+
|
|
159
|
+
if (this.speed > 0.05) {
|
|
160
|
+
const desired = Math.atan2(this.#velocity.x, this.#velocity.z);
|
|
161
|
+
const turn = Math.atan2(Math.sin(desired - this.heading), Math.cos(desired - this.heading));
|
|
162
|
+
this.heading += turn * (1 - Math.exp(-7 * dt));
|
|
163
|
+
}
|
|
164
|
+
this.#cycle += travelled / (running ? 1.22 : 1.04);
|
|
165
|
+
this.#stepFeet(dt, running, hardness);
|
|
166
|
+
|
|
167
|
+
const sink = this.#sinkDepth(hardness) * 0.6;
|
|
168
|
+
const bob =
|
|
169
|
+
this.speed > 0.02
|
|
170
|
+
? Math.cos(this.#cycle * Math.PI * 4) * 0.016
|
|
171
|
+
: Math.sin(this.#elapsed * 1.8) * 0.003;
|
|
172
|
+
this.position.y = damp(
|
|
173
|
+
this.position.y,
|
|
174
|
+
terrainHeight(anchor.x, anchor.z) + snow.depth - sink + bob,
|
|
175
|
+
14,
|
|
176
|
+
dt,
|
|
177
|
+
);
|
|
178
|
+
this.model.pose(
|
|
179
|
+
this.position,
|
|
180
|
+
this.heading,
|
|
181
|
+
this.#feet,
|
|
182
|
+
this.#cycle,
|
|
183
|
+
this.speed,
|
|
184
|
+
this.#elapsed,
|
|
185
|
+
);
|
|
186
|
+
}
|
|
187
|
+
|
|
188
|
+
/** How far an 80 kg boot sinks in this snow, for the body's visual height. */
|
|
189
|
+
#sinkDepth(hardness: number): number {
|
|
190
|
+
const pressure = (MASS * GRAVITY) / BOOT_AREA;
|
|
191
|
+
const resistance = 18_000 + clamp(hardness, 0, 1) ** 1.5 * 140_000;
|
|
192
|
+
return clamp(this.#snow.depth * (0.16 + pressure / resistance), 0, this.#snow.depth * 0.82);
|
|
193
|
+
}
|
|
194
|
+
|
|
195
|
+
#stepFeet(dt: number, running: boolean, hardness: number): void {
|
|
196
|
+
const snow = this.#snow;
|
|
197
|
+
const forward = { x: Math.sin(this.heading), z: Math.cos(this.heading) };
|
|
198
|
+
const right = { x: Math.cos(this.heading), z: -Math.sin(this.heading) };
|
|
199
|
+
for (const foot of this.#feet) {
|
|
200
|
+
const phase = (this.#cycle + (foot.side > 0 ? 0.5 : 0)) % 1;
|
|
201
|
+
if (!foot.swing && phase >= 0.58 && this.speed > 0.08) {
|
|
202
|
+
foot.swing = true;
|
|
203
|
+
foot.progress = 0;
|
|
204
|
+
foot.stop = 0;
|
|
205
|
+
foot.from = { x: foot.x, z: foot.z };
|
|
206
|
+
foot.angle = this.heading;
|
|
207
|
+
const reach = running ? 0.64 : 0.49;
|
|
208
|
+
foot.to = {
|
|
209
|
+
x: this.position.x + forward.x * reach + right.x * foot.side * STANCE,
|
|
210
|
+
z: this.position.z + forward.z * reach + right.z * foot.side * STANCE,
|
|
211
|
+
};
|
|
212
|
+
}
|
|
213
|
+
if (foot.swing) {
|
|
214
|
+
if (phase < 0.58 && this.speed > 0.08) {
|
|
215
|
+
this.#plant(foot, running, hardness);
|
|
216
|
+
continue;
|
|
217
|
+
}
|
|
218
|
+
let progress = clamp((phase - 0.58) / 0.42, 0, 1);
|
|
219
|
+
if (this.speed < 0.08) {
|
|
220
|
+
foot.stop += dt * 3.2;
|
|
221
|
+
progress = Math.max(foot.progress, clamp(foot.progress + foot.stop, 0, 1));
|
|
222
|
+
}
|
|
223
|
+
foot.progress = progress;
|
|
224
|
+
const eased = smoothstep(0, 1, progress);
|
|
225
|
+
foot.x = lerp(foot.from.x, foot.to.x, eased);
|
|
226
|
+
foot.z = lerp(foot.from.z, foot.to.z, eased);
|
|
227
|
+
const lift =
|
|
228
|
+
Math.sin(progress * Math.PI) * (0.15 + snow.depth * 0.3 + (running ? 0.07 : 0));
|
|
229
|
+
foot.y = this.#surface(foot.x, foot.z) + 0.14 + lift;
|
|
230
|
+
if (progress >= 0.999) this.#plant(foot, running, hardness);
|
|
231
|
+
} else foot.y = this.#surface(foot.x, foot.z) + 0.14;
|
|
232
|
+
}
|
|
233
|
+
}
|
|
234
|
+
|
|
235
|
+
#surface(x: number, z: number): number {
|
|
236
|
+
const half = this.#snow.field.width / 2 - 1e-3;
|
|
237
|
+
return this.#snow.heightAt(clamp(x, -half, half), clamp(z, -half, half));
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
#plant(foot: IFoot, running: boolean, hardness: number): void {
|
|
241
|
+
foot.x = foot.to.x;
|
|
242
|
+
foot.z = foot.to.z;
|
|
243
|
+
foot.swing = false;
|
|
244
|
+
foot.stop = 0;
|
|
245
|
+
// A boot only presses snow when the body is standing on it: a jump or a fall plants nothing.
|
|
246
|
+
const penetration = this.body.grounded
|
|
247
|
+
? this.#snow.stamp({
|
|
248
|
+
area: BOOT_AREA,
|
|
249
|
+
footprint: bootPrint,
|
|
250
|
+
hardness,
|
|
251
|
+
load: MASS * GRAVITY * (running ? 1.2 : 1),
|
|
252
|
+
rotation: foot.angle,
|
|
253
|
+
x: foot.x,
|
|
254
|
+
z: foot.z,
|
|
255
|
+
})
|
|
256
|
+
: 0;
|
|
257
|
+
if (penetration > 0) this.steps += 1;
|
|
258
|
+
foot.y = this.#surface(foot.x, foot.z) + 0.14;
|
|
259
|
+
this.#onStep({
|
|
260
|
+
angle: foot.angle,
|
|
261
|
+
penetration,
|
|
262
|
+
side: foot.side,
|
|
263
|
+
speed: this.speed,
|
|
264
|
+
x: foot.x,
|
|
265
|
+
y: foot.y - 0.12,
|
|
266
|
+
z: foot.z,
|
|
267
|
+
});
|
|
268
|
+
}
|
|
269
|
+
|
|
270
|
+
debug(): Record<string, unknown> {
|
|
271
|
+
return {
|
|
272
|
+
grounded: this.body.grounded,
|
|
273
|
+
heading: this.heading,
|
|
274
|
+
position: [this.position.x, this.position.y, this.position.z],
|
|
275
|
+
speed: this.speed,
|
|
276
|
+
steps: this.steps,
|
|
277
|
+
};
|
|
278
|
+
}
|
|
279
|
+
}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { defineGame } from "@threenative/core";
|
|
2
|
+
import { playtest } from "@threenative/core/playtest";
|
|
3
|
+
import type { IPhysicsContext } from "@threenative/physics";
|
|
4
|
+
import { rapier } from "@threenative/physics";
|
|
5
|
+
import config from "../threenative.config.js";
|
|
6
|
+
import { type Command, commands } from "./commands.js";
|
|
7
|
+
import { Boot } from "./scenes/Boot.js";
|
|
8
|
+
import { Snow } from "./scenes/Snow.js";
|
|
9
|
+
import type { GameState } from "./state.js";
|
|
10
|
+
|
|
11
|
+
const game = defineGame<GameState, IPhysicsContext>({
|
|
12
|
+
input: {
|
|
13
|
+
move: {
|
|
14
|
+
down: ["ArrowDown", "KeyS"],
|
|
15
|
+
left: ["ArrowLeft", "KeyA"],
|
|
16
|
+
right: ["ArrowRight", "KeyD"],
|
|
17
|
+
up: ["ArrowUp", "KeyW"],
|
|
18
|
+
},
|
|
19
|
+
run: { keys: ["ShiftLeft", "ShiftRight"] },
|
|
20
|
+
auto: { keys: ["KeyP"] },
|
|
21
|
+
blizzard: { keys: ["KeyB"] },
|
|
22
|
+
compaction: { keys: ["KeyV"] },
|
|
23
|
+
drop: { keys: ["KeyF"] },
|
|
24
|
+
kick: { keys: ["KeyG"] },
|
|
25
|
+
mute: { keys: ["KeyM"] },
|
|
26
|
+
reset: { keys: ["KeyR"] },
|
|
27
|
+
view: { keys: ["KeyC"] },
|
|
28
|
+
zoom: { pinch: true, scroll: true },
|
|
29
|
+
},
|
|
30
|
+
plugins: [rapier({ gravity: { x: 0, y: -9.81, z: 0 } }), playtest()],
|
|
31
|
+
display: config.display,
|
|
32
|
+
render: config.renderer,
|
|
33
|
+
scenes: { boot: Boot, snow: Snow },
|
|
34
|
+
seed: 2_024,
|
|
35
|
+
start: "boot",
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
export default game;
|
|
39
|
+
|
|
40
|
+
/** Settings the panel may change directly. Anything else in a `set` intent is ignored. */
|
|
41
|
+
const SETTINGS = new Set<keyof GameState>([
|
|
42
|
+
"snowfall",
|
|
43
|
+
"depth",
|
|
44
|
+
"fallSpeed",
|
|
45
|
+
"hardness",
|
|
46
|
+
"wind",
|
|
47
|
+
"recovery",
|
|
48
|
+
"compaction",
|
|
49
|
+
]);
|
|
50
|
+
const COMMANDS = new Set<Command>(["reset", "drop", "kick", "view", "auto", "blizzard", "mute"]);
|
|
51
|
+
|
|
52
|
+
game.ui.onIntent((intent, payload) => {
|
|
53
|
+
if (intent === "pause") game.pause();
|
|
54
|
+
if (intent === "resume") game.resume();
|
|
55
|
+
if (intent === "set" && typeof payload === "object" && payload !== null) {
|
|
56
|
+
const { key, value } = payload as { key?: string; value?: unknown };
|
|
57
|
+
if (
|
|
58
|
+
SETTINGS.has(key as keyof GameState) &&
|
|
59
|
+
(typeof value === "number" || typeof value === "boolean")
|
|
60
|
+
)
|
|
61
|
+
game.state.set({ [key as string]: value } as Partial<GameState>);
|
|
62
|
+
}
|
|
63
|
+
if (COMMANDS.has(intent as Command)) commands.push(intent as Command);
|
|
64
|
+
game.state.set({
|
|
65
|
+
uiReady: game.ui.connected,
|
|
66
|
+
...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
|
|
67
|
+
} as Partial<GameState>);
|
|
68
|
+
game.state.flush();
|
|
69
|
+
});
|
|
@@ -0,0 +1,15 @@
|
|
|
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
|
+
|
|
8
|
+
import.meta.hot?.accept();
|
|
9
|
+
acceptHotUpdate(game, import.meta.hot);
|
|
10
|
+
const root = document.getElementById("root");
|
|
11
|
+
if (root === null) throw new Error("Missing #root element.");
|
|
12
|
+
const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
|
|
13
|
+
const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
|
|
14
|
+
appRoot.__threenativeRoot = reactRoot;
|
|
15
|
+
reactRoot.render(createElement(App, { game }));
|