create-threenative 0.2.6 → 0.2.8
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 +5 -3
- package/agent-docs/references/build-profiles.md +126 -0
- package/agent-docs/references/capability-reference.md +607 -26
- package/agent-docs/references/performance-basics.md +8 -5
- package/agent-docs/references/sculpt-from-a-reference.md +1 -1
- package/agent-docs/references/trace-a-slow-frame.md +1 -1
- package/agent-docs/references/visual-baseline.md +8 -4
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
- package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
- package/capabilities.json +801 -24
- package/dist/index.d.ts +30 -1
- package/dist/index.js +300 -56
- package/dist/threenative.js +717 -156
- package/package.json +6 -6
- package/template-assets/assets/mannequin-combat.glb +0 -0
- package/template-assets/assets/mannequin.glb +0 -0
- package/template-assets/assets/player-viewmodel.glb +0 -0
- package/template-assets/assets/sky.jpg +0 -0
- package/template-assets/clearwater/README.md +141 -0
- package/template-assets/clearwater/install.mjs +50 -0
- package/template-assets/clearwater/src/clearwater.ts +180 -0
- package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
- package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
- package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
- package/template-assets/clearwater/src/render/clearwater.ts +278 -0
- package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
- package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
- package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
- package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
- package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
- package/template-assets/patches/three@0.185.1.patch +2101 -138
- package/template-assets/worldEnvironment.ts +52 -1
- package/templates/action-rpg/AGENTS.md +42 -42
- package/templates/action-rpg/CLAUDE.md +42 -42
- package/templates/action-rpg/kit.json +1 -1
- package/templates/action-rpg/package.json +13 -7
- package/templates/action-rpg/playtests/combat.playtest.json +162 -23
- package/templates/action-rpg/playtests/performance.playtest.json +4 -3
- package/templates/action-rpg/playtests/survives.playtest.json +25 -8
- package/templates/action-rpg/src/conventions.ts +24 -18
- package/templates/action-rpg/src/entities/Enemy.ts +74 -24
- package/templates/action-rpg/src/entities/Fighter.ts +127 -0
- package/templates/action-rpg/src/entities/Player.ts +102 -32
- package/templates/action-rpg/src/game.ts +3 -3
- package/templates/action-rpg/src/render/camera.ts +18 -16
- package/templates/action-rpg/src/render/dungeon.ts +192 -0
- package/templates/action-rpg/src/render/lighting.ts +45 -28
- package/templates/action-rpg/src/render/loading.ts +4 -4
- package/templates/action-rpg/src/render/materials.ts +191 -47
- package/templates/action-rpg/src/render/palette.ts +14 -13
- package/templates/action-rpg/src/render/postprocessing.ts +12 -2
- package/templates/action-rpg/src/render/props.ts +117 -0
- package/templates/action-rpg/src/render/quality.ts +40 -82
- package/templates/action-rpg/src/render/sky.ts +36 -13
- package/templates/action-rpg/src/render/touch-controls.ts +1 -1
- package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
- package/templates/action-rpg/src/scenes/Play.ts +61 -39
- package/templates/action-rpg/src/style.css +9 -7
- package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
- package/templates/action-rpg/src/ui/Hud.tsx +3 -3
- package/templates/action-rpg/threenative.config.ts +14 -1
- package/templates/action-rpg/vite.config.ts +4 -1
- package/templates/minimal/AGENTS.md +10 -10
- package/templates/minimal/CLAUDE.md +10 -10
- package/templates/minimal/package.json +12 -6
- package/templates/minimal/playtests/play.playtest.json +6 -5
- package/templates/minimal/playtests/sky.playtest.json +27 -0
- package/templates/minimal/src/conventions.ts +6 -3
- package/templates/minimal/src/entities/Player.ts +73 -27
- package/templates/minimal/src/main.ts +2 -3
- package/templates/minimal/src/render/camera.ts +22 -4
- package/templates/minimal/src/render/lighting.ts +24 -48
- package/templates/minimal/src/render/materials.ts +158 -13
- package/templates/minimal/src/render/palette.ts +10 -7
- package/templates/minimal/src/render/postprocessing.ts +12 -25
- package/templates/minimal/src/render/quality.ts +35 -69
- package/templates/minimal/src/render/sky.ts +35 -54
- package/templates/minimal/src/render/touch-controls.ts +1 -1
- package/templates/minimal/src/render/worldEnvironment.ts +52 -1
- package/templates/minimal/src/scenes/Play.ts +121 -111
- package/templates/minimal/src/state.ts +0 -4
- package/templates/minimal/src/style.css +0 -10
- package/templates/minimal/threenative.config.ts +14 -1
- package/templates/minimal/vite.config.ts +4 -1
- package/templates/platformer/AGENTS.md +18 -56
- package/templates/platformer/CLAUDE.md +18 -56
- package/templates/platformer/kit.json +2 -2
- package/templates/platformer/package.json +13 -9
- package/templates/platformer/playtests/buffer.playtest.json +15 -5
- package/templates/platformer/playtests/collect.playtest.json +8 -34
- package/templates/platformer/playtests/coyote.playtest.json +12 -34
- package/templates/platformer/playtests/damage.playtest.json +40 -15
- package/templates/platformer/playtests/hud.playtest.json +34 -0
- package/templates/platformer/playtests/move.playtest.json +24 -0
- package/templates/platformer/playtests/performance.playtest.json +24 -7
- package/templates/platformer/playtests/respawn.playtest.json +46 -11
- package/templates/platformer/playtests/stomp.playtest.json +49 -12
- package/templates/platformer/playtests/survives.playtest.json +3 -19
- package/templates/platformer/playtests/world.playtest.json +26 -0
- package/templates/platformer/src/entities/Fox.ts +273 -0
- package/templates/platformer/src/entities/Pickup.ts +43 -60
- package/templates/platformer/src/entities/Walker.ts +88 -0
- package/templates/platformer/src/game.ts +11 -8
- package/templates/platformer/src/level/Checkpoints.ts +29 -16
- package/templates/platformer/src/level/Stage.ts +469 -0
- package/templates/platformer/src/render/blocks.ts +94 -0
- package/templates/platformer/src/render/camera.ts +28 -3
- package/templates/platformer/src/render/fox.ts +196 -0
- package/templates/platformer/src/render/lighting.ts +42 -33
- package/templates/platformer/src/render/materials.ts +115 -5
- package/templates/platformer/src/render/palette.ts +68 -53
- package/templates/platformer/src/render/pickups.ts +142 -0
- package/templates/platformer/src/render/postprocessing.ts +12 -2
- package/templates/platformer/src/render/props.ts +147 -0
- package/templates/platformer/src/render/quality.ts +47 -99
- package/templates/platformer/src/render/scenery.ts +172 -0
- package/templates/platformer/src/render/sky.ts +120 -31
- package/templates/platformer/src/render/touch-controls.ts +5 -2
- package/templates/platformer/src/render/walkers.ts +96 -0
- package/templates/platformer/src/render/waterfall.ts +85 -0
- package/templates/platformer/src/render/worldEnvironment.ts +52 -1
- package/templates/platformer/src/scenes/Boot.ts +3 -4
- package/templates/platformer/src/scenes/Play.ts +362 -0
- package/templates/platformer/src/state.ts +16 -14
- package/templates/platformer/src/style.css +9 -8
- package/templates/platformer/src/ui/Hud.tsx +62 -29
- package/templates/platformer/src/ui/Menu.tsx +2 -2
- package/templates/platformer/threenative.config.ts +14 -1
- package/templates/platformer/vite.config.ts +4 -1
- package/templates/puzzle/AGENTS.md +19 -20
- package/templates/puzzle/CLAUDE.md +19 -20
- package/templates/puzzle/assets/native-proof.glb +0 -0
- package/templates/puzzle/assets/native-proof.png +0 -0
- package/templates/puzzle/kit.json +1 -1
- package/templates/puzzle/package.json +13 -7
- package/templates/puzzle/playtests/axis.playtest.json +20 -0
- package/templates/puzzle/playtests/blocked.playtest.json +73 -0
- package/templates/puzzle/playtests/caused.playtest.json +65 -0
- package/templates/puzzle/playtests/lit.playtest.json +74 -0
- package/templates/puzzle/playtests/performance.playtest.json +24 -7
- package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
- package/templates/puzzle/playtests/replay.playtest.json +81 -0
- package/templates/puzzle/playtests/restart.playtest.json +108 -0
- package/templates/puzzle/playtests/seal.playtest.json +98 -0
- package/templates/puzzle/playtests/settle.playtest.json +100 -0
- package/templates/puzzle/playtests/survives.playtest.json +6 -29
- package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
- package/templates/puzzle/src/entities/Crate.ts +99 -42
- package/templates/puzzle/src/entities/Seal.ts +69 -0
- package/templates/puzzle/src/entities/Warden.ts +135 -0
- package/templates/puzzle/src/game.ts +15 -11
- package/templates/puzzle/src/render/camera.ts +66 -31
- package/templates/puzzle/src/render/crateShape.ts +70 -0
- package/templates/puzzle/src/render/lighting.ts +41 -41
- package/templates/puzzle/src/render/loading.ts +4 -4
- package/templates/puzzle/src/render/materials.ts +131 -27
- package/templates/puzzle/src/render/palette.ts +19 -29
- package/templates/puzzle/src/render/postprocessing.ts +15 -3
- package/templates/puzzle/src/render/quality.ts +71 -80
- package/templates/puzzle/src/render/shapes.ts +109 -108
- package/templates/puzzle/src/render/sky.ts +18 -10
- package/templates/puzzle/src/render/touch-controls.ts +8 -51
- package/templates/puzzle/src/render/vault.ts +315 -0
- package/templates/puzzle/src/render/warden.ts +46 -0
- package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
- package/templates/puzzle/src/scenes/Play.ts +793 -0
- package/templates/puzzle/src/state.ts +55 -24
- package/templates/puzzle/src/style.css +7 -8
- package/templates/puzzle/src/ui/App.tsx +2 -2
- package/templates/puzzle/src/ui/Hud.tsx +92 -40
- package/templates/puzzle/src/ui/Menu.tsx +40 -2
- package/templates/puzzle/threenative.config.ts +14 -1
- package/templates/puzzle/vite.config.ts +4 -1
- package/templates/racing/AGENTS.md +19 -20
- package/templates/racing/CLAUDE.md +19 -20
- package/templates/racing/package.json +13 -7
- package/templates/racing/playtests/boost.playtest.json +33 -12
- package/templates/racing/playtests/outcome.playtest.json +32 -50
- package/templates/racing/playtests/performance.playtest.json +2 -1
- package/templates/racing/playtests/ranking.playtest.json +5 -14
- package/templates/racing/playtests/rescue.playtest.json +2 -2
- package/templates/racing/playtests/reverse.playtest.json +30 -8
- package/templates/racing/playtests/shortcut.playtest.json +54 -9
- package/templates/racing/playtests/touch-controls.playtest.json +32 -5
- package/templates/racing/src/entities/CarBody.ts +327 -0
- package/templates/racing/src/entities/LineDriver.ts +220 -0
- package/templates/racing/src/entities/RacingCar.ts +150 -89
- package/templates/racing/src/entities/Rival.ts +61 -24
- package/templates/racing/src/game.ts +5 -0
- package/templates/racing/src/render/camera.ts +49 -7
- package/templates/racing/src/render/lighting.ts +36 -37
- package/templates/racing/src/render/materials.ts +239 -19
- package/templates/racing/src/render/palette.ts +19 -21
- package/templates/racing/src/render/postprocessing.ts +12 -2
- package/templates/racing/src/render/quality.ts +43 -82
- package/templates/racing/src/render/shapes.ts +20 -6
- package/templates/racing/src/render/sky.ts +47 -39
- package/templates/racing/src/render/touch-controls.ts +1 -1
- package/templates/racing/src/render/worldEnvironment.ts +52 -1
- package/templates/racing/src/scenes/Race.ts +107 -54
- package/templates/racing/src/state.ts +2 -0
- package/templates/racing/src/track/Checkline.ts +22 -7
- package/templates/racing/src/track/Lap.ts +64 -36
- package/templates/racing/src/track/Ranking.ts +20 -11
- package/templates/racing/src/track/Track.ts +809 -361
- package/templates/racing/src/track/TrackSector.ts +40 -11
- package/templates/racing/src/track/circuit.ts +477 -0
- package/templates/racing/src/track/rescue.ts +16 -4
- package/templates/racing/threenative.config.ts +14 -1
- package/templates/racing/vite.config.ts +4 -1
- package/templates/rain/AGENTS.md +96 -0
- package/templates/rain/CLAUDE.md +98 -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 +13 -0
- package/templates/rain/native-playtests/lightning.playtest.json +173 -0
- package/templates/rain/package.json +56 -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 +22 -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 +179 -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 +114 -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/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 +226 -0
- package/templates/rain/src/render/quality.ts +135 -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/{defense → rain}/src/render/worldEnvironment.ts +52 -1
- package/templates/rain/src/scenes/Boot.ts +334 -0
- package/templates/rain/src/state.ts +257 -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 +37 -0
- package/templates/rts/.codex/config.toml +19 -0
- package/templates/rts/.cursor/mcp.json +32 -0
- package/templates/rts/.gemini/settings.json +32 -0
- package/templates/rts/.mcp.json +32 -0
- package/templates/rts/.vscode/mcp.json +36 -0
- package/templates/rts/.zed/settings.json +36 -0
- package/templates/rts/AGENTS.md +96 -0
- package/templates/rts/CLAUDE.md +98 -0
- package/templates/rts/kit.json +7 -0
- package/templates/rts/opencode.json +41 -0
- package/templates/{defense → rts}/package.json +13 -7
- package/templates/rts/playtests/performance.playtest.json +41 -0
- package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
- package/templates/rts/playtests/rts-attack.playtest.json +75 -0
- package/templates/rts/playtests/rts-build.playtest.json +68 -0
- package/templates/rts/playtests/rts-orders.playtest.json +150 -0
- package/templates/rts/playtests/rts-train.playtest.json +62 -0
- package/templates/rts/playtests/survives.playtest.json +58 -0
- package/templates/rts/public/favicon.svg +4 -0
- package/templates/rts/src/game.ts +64 -0
- package/templates/rts/src/main.ts +15 -0
- package/templates/rts/src/orders.ts +22 -0
- package/templates/rts/src/render/army.ts +346 -0
- package/templates/rts/src/render/camera.ts +123 -0
- package/templates/rts/src/render/lighting.ts +61 -0
- package/templates/rts/src/render/loading.ts +33 -0
- package/templates/rts/src/render/materials.ts +152 -0
- package/templates/rts/src/render/models.ts +705 -0
- package/templates/rts/src/render/palette.ts +17 -0
- package/templates/rts/src/render/picking.ts +93 -0
- package/templates/rts/src/render/postprocessing.ts +46 -0
- package/templates/rts/src/render/quality.ts +128 -0
- package/templates/rts/src/render/resources.ts +141 -0
- package/templates/rts/src/render/sky.ts +44 -0
- package/templates/rts/src/render/terrain.ts +116 -0
- package/templates/rts/src/render/worldEnvironment.ts +809 -0
- package/templates/rts/src/scenes/Play.ts +650 -0
- package/templates/rts/src/sim/ai.ts +1140 -0
- package/templates/rts/src/sim/combat.ts +416 -0
- package/templates/rts/src/sim/construction.ts +374 -0
- package/templates/rts/src/sim/economy.ts +167 -0
- package/templates/rts/src/sim/game.ts +1082 -0
- package/templates/rts/src/sim/movement.ts +371 -0
- package/templates/rts/src/sim/nav.ts +276 -0
- package/templates/rts/src/sim/production.ts +180 -0
- package/templates/rts/src/sim/terrain.ts +170 -0
- package/templates/rts/src/sim/types.ts +647 -0
- package/templates/rts/src/sim/vision.ts +46 -0
- package/templates/rts/src/state.ts +100 -0
- package/templates/{defense → rts}/src/style.css +21 -8
- package/templates/rts/src/ui/App.tsx +21 -0
- package/templates/rts/src/ui/Commands.tsx +129 -0
- package/templates/rts/src/ui/GameUi.tsx +22 -0
- package/templates/rts/src/ui/Hud.tsx +165 -0
- package/templates/rts/src/ui/Minimap.tsx +84 -0
- package/templates/rts/tailwind.config.ts +2 -0
- package/templates/rts/threenative.config.ts +56 -0
- package/templates/rts/tsconfig.json +17 -0
- package/templates/{defense → rts}/vite.config.ts +4 -1
- package/templates/runner/AGENTS.md +6 -10
- package/templates/runner/CLAUDE.md +6 -10
- package/templates/runner/README.md +3 -3
- package/templates/runner/package.json +13 -7
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +4 -3
- package/templates/runner/src/entities/Runner.ts +54 -7
- package/templates/runner/src/game.ts +2 -0
- package/templates/runner/src/render/camera.ts +4 -2
- package/templates/runner/src/render/dust.ts +5 -2
- package/templates/runner/src/render/lighting.ts +41 -45
- package/templates/runner/src/render/loading.ts +2 -2
- package/templates/runner/src/render/materials.ts +165 -25
- package/templates/runner/src/render/palette.ts +17 -28
- package/templates/runner/src/render/postprocessing.ts +12 -2
- package/templates/runner/src/render/quality.ts +42 -96
- package/templates/runner/src/render/shapes.ts +59 -37
- package/templates/runner/src/render/sky.ts +32 -41
- package/templates/runner/src/render/touch-controls.ts +1 -1
- package/templates/runner/src/render/worldEnvironment.ts +52 -1
- package/templates/runner/src/scenes/Run.ts +26 -6
- package/templates/runner/src/track.ts +6 -1
- package/templates/runner/threenative.config.ts +14 -1
- package/templates/runner/vite.config.ts +4 -1
- package/templates/sailing/AGENTS.md +12 -12
- package/templates/sailing/CLAUDE.md +12 -12
- package/templates/sailing/assets/ship.glb +0 -0
- package/templates/sailing/package.json +13 -7
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
- package/templates/sailing/playtests/sails.playtest.json +33 -0
- package/templates/sailing/playtests/win.playtest.json +156 -8
- package/templates/sailing/src/conventions.ts +29 -2
- package/templates/sailing/src/entities/Ship.ts +381 -57
- package/templates/sailing/src/game.ts +14 -0
- package/templates/sailing/src/render/camera.ts +63 -9
- package/templates/sailing/src/render/lighting.ts +49 -27
- package/templates/sailing/src/render/materials.ts +50 -15
- package/templates/sailing/src/render/ocean.ts +647 -60
- package/templates/sailing/src/render/palette.ts +16 -12
- package/templates/sailing/src/render/postprocessing.ts +12 -2
- package/templates/sailing/src/render/props.ts +316 -442
- package/templates/sailing/src/render/quality.ts +14 -4
- package/templates/sailing/src/render/sky.ts +116 -23
- package/templates/sailing/src/render/worldEnvironment.ts +52 -1
- package/templates/sailing/src/scenes/Boot.ts +21 -0
- package/templates/sailing/src/scenes/Sailing.ts +173 -39
- package/templates/sailing/src/state.ts +6 -0
- package/templates/sailing/src/ui/Hud.tsx +41 -9
- package/templates/sailing/threenative.config.ts +14 -1
- package/templates/sailing/vite.config.ts +4 -1
- package/templates/shooter/AGENTS.md +27 -42
- package/templates/shooter/CLAUDE.md +27 -42
- package/templates/shooter/index.html +1 -0
- package/templates/shooter/package.json +13 -7
- package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
- package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
- package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
- package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
- package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
- package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
- package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
- package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
- package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
- package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
- package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
- package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
- package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
- package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
- package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
- package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
- package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
- package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
- package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
- package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
- package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
- package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
- package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
- package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
- package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
- package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
- package/templates/shooter/playtests/input-control.playtest.json +43 -98
- package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
- package/templates/shooter/playtests/performance.playtest.json +62 -26
- package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
- package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
- package/templates/shooter/playtests/survives.playtest.json +36 -30
- package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
- package/templates/shooter/src/entities/Breakables.ts +412 -0
- package/templates/shooter/src/entities/Enemy.ts +2095 -0
- package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
- package/templates/shooter/src/entities/Rifle.ts +442 -0
- package/templates/shooter/src/entities/Target.ts +199 -83
- package/templates/shooter/src/entities/TouchControls.ts +276 -0
- package/templates/shooter/src/game.ts +75 -41
- package/templates/shooter/src/main.ts +0 -1
- package/templates/shooter/src/postPhysics.ts +36 -0
- package/templates/shooter/src/render/camera.ts +78 -74
- package/templates/shooter/src/render/decals.ts +142 -82
- package/templates/shooter/src/render/facade.ts +1373 -0
- package/templates/shooter/src/render/gunfx.ts +704 -0
- package/templates/shooter/src/render/lighting.ts +52 -38
- package/templates/shooter/src/render/loading.ts +2 -2
- package/templates/shooter/src/render/materials.ts +100 -88
- package/templates/shooter/src/render/occlusion.ts +108 -0
- package/templates/shooter/src/render/palette.ts +10 -10
- package/templates/shooter/src/render/palm.ts +455 -0
- package/templates/shooter/src/render/pooled-billboards.ts +144 -0
- package/templates/shooter/src/render/postprocessing.ts +15 -3
- package/templates/shooter/src/render/quality.ts +40 -82
- package/templates/shooter/src/render/scale.ts +148 -15
- package/templates/shooter/src/render/shapes.ts +138 -613
- package/templates/shooter/src/render/sky.ts +35 -35
- package/templates/shooter/src/render/town-schematic.ts +120 -0
- package/templates/shooter/src/render/town.ts +986 -0
- package/templates/shooter/src/render/townMaterials.ts +160 -0
- package/templates/shooter/src/render/vehicles.ts +741 -0
- package/templates/shooter/src/render/worldEnvironment.ts +52 -1
- package/templates/shooter/src/scenes/Play.ts +727 -650
- package/templates/shooter/src/state.ts +26 -41
- package/templates/shooter/src/style.css +207 -11
- package/templates/shooter/src/surfaces.ts +131 -0
- package/templates/shooter/src/ui/App.tsx +9 -10
- package/templates/shooter/src/ui/Crosshair.tsx +25 -18
- package/templates/shooter/src/ui/GameUi.tsx +6 -9
- package/templates/shooter/src/ui/Hud.tsx +428 -39
- package/templates/shooter/src/ui/Minimap.tsx +164 -0
- package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
- package/templates/shooter/src/ui/main.tsx +2 -3
- package/templates/shooter/threenative.config.ts +14 -1
- package/templates/shooter/vite.config.ts +4 -1
- 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 +88 -0
- package/templates/snow/CLAUDE.md +90 -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 +58 -0
- package/templates/snow/playtests/footsteps.playtest.json +95 -0
- package/templates/{defense → snow}/playtests/performance.playtest.json +4 -7
- package/templates/snow/playtests/snow-physics.playtest.json +154 -0
- package/templates/{defense → snow}/playtests/survives.playtest.json +26 -6
- 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/bootPrint.ts +50 -0
- package/templates/snow/src/render/camera.ts +84 -0
- package/templates/snow/src/render/explorer.ts +321 -0
- package/templates/snow/src/render/lighting.ts +50 -0
- package/templates/snow/src/render/loading.ts +325 -0
- package/templates/snow/src/render/materials.ts +36 -0
- package/templates/snow/src/render/palette.ts +17 -0
- package/templates/{defense → snow}/src/render/postprocessing.ts +12 -2
- package/templates/snow/src/render/props.ts +42 -0
- package/templates/{defense → snow}/src/render/quality.ts +37 -72
- package/templates/snow/src/render/scenery.ts +244 -0
- package/templates/snow/src/render/sky.ts +57 -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 +809 -0
- package/templates/{defense → snow}/src/scenes/Boot.ts +4 -4
- package/templates/snow/src/scenes/Snow.ts +635 -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 +51 -0
- package/templates/snow/tsconfig.json +17 -0
- package/templates/snow/vite.config.ts +37 -0
- package/templates/starter/AGENTS.md +17 -17
- package/templates/starter/CLAUDE.md +17 -17
- package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
- package/templates/starter/package.json +13 -7
- package/templates/starter/playtests/play.playtest.json +2 -1
- package/templates/starter/playtests/survives.playtest.json +1 -1
- package/templates/starter/src/conventions.ts +6 -3
- package/templates/starter/src/entities/Goal.ts +35 -42
- package/templates/starter/src/entities/Player.ts +99 -16
- package/templates/starter/src/render/arena.ts +131 -0
- package/templates/starter/src/render/lighting.ts +27 -44
- package/templates/starter/src/render/materials.ts +164 -35
- package/templates/starter/src/render/palette.ts +16 -16
- package/templates/starter/src/render/postprocessing.ts +6 -7
- package/templates/starter/src/render/quality.ts +43 -101
- package/templates/starter/src/render/shapes.ts +1 -1
- package/templates/starter/src/render/sky.ts +39 -45
- package/templates/starter/src/render/touch-controls.ts +3 -1
- package/templates/starter/src/render/worldEnvironment.ts +52 -1
- package/templates/starter/src/scenes/Play.ts +82 -81
- package/templates/starter/threenative.config.ts +14 -1
- package/templates/starter/vite.config.ts +4 -1
- package/templates/tower-defense/.codex/config.toml +19 -0
- package/templates/tower-defense/.cursor/mcp.json +32 -0
- package/templates/tower-defense/.gemini/settings.json +32 -0
- package/templates/tower-defense/.mcp.json +32 -0
- package/templates/tower-defense/.vscode/mcp.json +36 -0
- package/templates/tower-defense/.zed/settings.json +36 -0
- package/templates/{defense → tower-defense}/AGENTS.md +14 -12
- package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
- package/templates/tower-defense/README.md +16 -0
- package/templates/tower-defense/index.html +12 -0
- package/templates/tower-defense/kit.json +7 -0
- package/templates/tower-defense/opencode.json +41 -0
- package/templates/tower-defense/package.json +56 -0
- package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
- package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
- package/templates/tower-defense/playtests/look.playtest.json +130 -0
- package/templates/tower-defense/playtests/performance.playtest.json +77 -0
- package/templates/tower-defense/playtests/placement.playtest.json +115 -0
- package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
- package/templates/tower-defense/playtests/strike.playtest.json +98 -0
- package/templates/tower-defense/playtests/survives.playtest.json +85 -0
- package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
- package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
- package/templates/tower-defense/playtests/victory.playtest.json +810 -0
- package/templates/tower-defense/src/balance.ts +187 -0
- package/templates/tower-defense/src/board/Board.ts +100 -0
- package/templates/tower-defense/src/board/Route.ts +84 -0
- package/templates/tower-defense/src/camera-rig.ts +62 -0
- package/templates/tower-defense/src/economy.ts +64 -0
- package/templates/tower-defense/src/effects/Effects.ts +284 -0
- package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
- package/templates/tower-defense/src/game.ts +72 -0
- package/templates/tower-defense/src/intents.ts +21 -0
- package/templates/tower-defense/src/main.ts +15 -0
- package/templates/tower-defense/src/physics.ts +6 -0
- package/templates/tower-defense/src/render/camera.ts +38 -0
- package/templates/tower-defense/src/render/lighting.ts +42 -0
- package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
- package/templates/tower-defense/src/render/materials.ts +103 -0
- package/templates/tower-defense/src/render/palette.ts +58 -0
- package/templates/tower-defense/src/render/postprocessing.ts +46 -0
- package/templates/tower-defense/src/render/quality.ts +128 -0
- package/templates/tower-defense/src/render/shapes.ts +550 -0
- package/templates/tower-defense/src/render/sky.ts +27 -0
- package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
- package/templates/tower-defense/src/scenes/Battle.ts +539 -0
- package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
- package/templates/tower-defense/src/state.ts +88 -0
- package/templates/tower-defense/src/style.css +137 -0
- package/templates/tower-defense/src/towers/Tower.ts +230 -0
- package/templates/tower-defense/src/towers/targeting.ts +97 -0
- package/templates/tower-defense/src/ui/Hud.tsx +270 -0
- package/templates/tower-defense/src/ui/Menu.tsx +134 -0
- package/templates/tower-defense/src/ui/icons.tsx +54 -0
- package/templates/tower-defense/src/ui/main.tsx +14 -0
- package/templates/tower-defense/src/waves.ts +90 -0
- package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
- package/templates/tower-defense/vite.config.ts +41 -0
- package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
- package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
- package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
- package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
- package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
- package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
- package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
- package/agent-files/AGENT-ROLES.md +0 -26
- package/templates/action-rpg/src/render/shapes.ts +0 -269
- package/templates/action-rpg/src/render/types.ts +0 -3
- package/templates/action-rpg/src/scenes/Boot.ts +0 -12
- package/templates/defense/README.md +0 -10
- package/templates/defense/kit.json +0 -7
- package/templates/defense/playtests/leak.playtest.json +0 -23
- package/templates/defense/playtests/placement.playtest.json +0 -40
- package/templates/defense/playtests/scan.playtest.json +0 -20
- package/templates/defense/playtests/survive.playtest.json +0 -45
- package/templates/defense/src/attackers/Attacker.ts +0 -120
- package/templates/defense/src/board/Route.ts +0 -94
- package/templates/defense/src/conventions.ts +0 -18
- package/templates/defense/src/economy.ts +0 -36
- package/templates/defense/src/entities/Player.ts +0 -52
- package/templates/defense/src/game.ts +0 -51
- package/templates/defense/src/physics.ts +0 -13
- package/templates/defense/src/placement/Buildable.ts +0 -49
- package/templates/defense/src/render/camera.ts +0 -16
- package/templates/defense/src/render/lighting.ts +0 -37
- package/templates/defense/src/render/materials.ts +0 -22
- package/templates/defense/src/render/palette.ts +0 -28
- package/templates/defense/src/render/shapes.ts +0 -246
- package/templates/defense/src/render/sky.ts +0 -45
- package/templates/defense/src/scenes/Defense.ts +0 -231
- package/templates/defense/src/state.ts +0 -56
- package/templates/defense/src/towers/Tower.ts +0 -95
- package/templates/defense/src/towers/targeting.ts +0 -53
- package/templates/defense/src/ui/Hud.tsx +0 -62
- package/templates/defense/src/ui/Menu.tsx +0 -7
- package/templates/defense/src/waves.ts +0 -40
- package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
- package/templates/minimal/src/render/hud.ts +0 -69
- package/templates/platformer/playtests/avoidance.playtest.json +0 -28
- package/templates/platformer/playtests/chase.playtest.json +0 -21
- package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
- package/templates/platformer/playtests/oneway.playtest.json +0 -44
- package/templates/platformer/playtests/patrol.playtest.json +0 -13
- package/templates/platformer/playtests/physics.playtest.json +0 -14
- package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
- package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
- package/templates/platformer/src/conventions.ts +0 -18
- package/templates/platformer/src/entities/Character.ts +0 -286
- package/templates/platformer/src/entities/Chaser.ts +0 -118
- package/templates/platformer/src/entities/Patrol.ts +0 -93
- package/templates/platformer/src/level/Platform.ts +0 -46
- package/templates/platformer/src/render/rig.ts +0 -60
- package/templates/platformer/src/render/terrain.ts +0 -31
- package/templates/platformer/src/scenes/Level.ts +0 -241
- package/templates/puzzle/README.md +0 -43
- package/templates/puzzle/playtests/carry.playtest.json +0 -71
- package/templates/puzzle/playtests/swing.playtest.json +0 -38
- package/templates/puzzle/src/conventions.ts +0 -25
- package/templates/puzzle/src/entities/Ball.ts +0 -70
- package/templates/puzzle/src/entities/Gripper.ts +0 -69
- package/templates/puzzle/src/entities/Pendulum.ts +0 -89
- package/templates/puzzle/src/physics.ts +0 -19
- package/templates/puzzle/src/room.ts +0 -83
- package/templates/puzzle/src/scenes/Boot.ts +0 -12
- package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
- package/templates/shooter/playtests/combat.playtest.json +0 -48
- package/templates/shooter/playtests/fail.playtest.json +0 -31
- package/templates/shooter/playtests/per-item.playtest.json +0 -59
- package/templates/shooter/playtests/shooter.playtest.json +0 -99
- package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
- package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
- package/templates/shooter/src/combat/damage.ts +0 -40
- package/templates/shooter/src/conventions.ts +0 -51
- package/templates/shooter/src/entities/Pickup.ts +0 -70
- package/templates/shooter/src/entities/Player.ts +0 -310
- package/templates/shooter/src/level/SpawnPoints.ts +0 -28
- package/templates/shooter/src/playtest-events.ts +0 -15
- package/templates/shooter/src/render/touch-controls.ts +0 -305
- package/templates/shooter/src/render/types.ts +0 -3
- package/templates/shooter/src/render/ui.css +0 -330
- package/templates/shooter/src/render/ui.ts +0 -75
- package/templates/shooter/src/render/vfx.ts +0 -215
- package/templates/shooter/src/ui/Menu.tsx +0 -41
- package/templates/shooter/src/waves.ts +0 -50
- package/templates/shooter/src/weapons/Hitscan.ts +0 -42
- package/templates/shooter/src/weapons/Projectile.ts +0 -92
- package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
- package/templates/starter/playtests/assets.playtest.json +0 -65
- package/templates/starter/playtests/buffer.playtest.json +0 -79
- package/templates/starter/playtests/cloth.playtest.json +0 -113
- package/templates/starter/playtests/coyote.playtest.json +0 -87
- package/templates/starter/playtests/gameover.playtest.json +0 -66
- package/templates/starter/playtests/goal.playtest.json +0 -67
- package/templates/starter/playtests/look.playtest.json +0 -175
- package/templates/starter/playtests/models-baseline.png +0 -0
- package/templates/starter/playtests/models.playtest.json +0 -74
- package/templates/starter/playtests/monitoring.playtest.json +0 -72
- package/templates/starter/playtests/odometer.playtest.json +0 -54
- package/templates/starter/playtests/restart.playtest.json +0 -91
- package/templates/starter/playtests/seed.playtest.json +0 -54
- package/templates/starter/playtests/textures-baseline.png +0 -0
- package/templates/starter/playtests/textures.playtest.json +0 -74
- package/templates/starter/playtests/touch-controls.playtest.json +0 -42
- package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
- package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
- package/templates/starter/src/render/coast.ts +0 -199
- package/templates/starter/src/render/hero.ts +0 -88
- package/templates/starter/src/render/implicitSurface.ts +0 -199
- package/templates/starter/src/render/kuwahara.ts +0 -174
- package/templates/starter/src/render/outline.ts +0 -141
- package/templates/starter/src/render/painterly.ts +0 -86
- package/templates/starter/src/render/rockRidge.ts +0 -198
- package/templates/starter/src/render/rockRidge.worker.ts +0 -77
- package/templates/starter/src/render/scenery.ts +0 -40
- package/templates/starter/src/render/textureLifetime.ts +0 -53
- package/templates/starter/src/render/water.ts +0 -38
- package/templates/starter/src/render/watercolor.ts +0 -85
- /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
- /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
- /package/templates/{defense → rain}/.codex/config.toml +0 -0
- /package/templates/{defense → rain}/.cursor/mcp.json +0 -0
- /package/templates/{defense → rain}/.gemini/settings.json +0 -0
- /package/templates/{defense → rain}/.mcp.json +0 -0
- /package/templates/{defense → rain}/.vscode/mcp.json +0 -0
- /package/templates/{defense → rain}/.zed/settings.json +0 -0
- /package/templates/{defense → rain}/opencode.json +0 -0
- /package/templates/{defense → rain}/src/main.ts +0 -0
- /package/templates/{defense → rts}/index.html +0 -0
- /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
- /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
- /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
- /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
- /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
- /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
- /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
// Generated for you. Ordinary Three.js, and the whole coastal look lives in this file.
|
|
2
|
+
//
|
|
3
|
+
// The coast is not a set of meshes. It is one raymarched distance field — terrain, the road down
|
|
4
|
+
// it, the double yellow line, the sea, the island, the forest, the six lamps, the rail, the cabin
|
|
5
|
+
// with its lit window and its antenna, the wet reflections and the rain ripples — evaluated in the
|
|
6
|
+
// fragment shader, which is why the whole thing is a single screen-sized quad. Its maths lives in
|
|
7
|
+
// `world-shader.ts`, which `tools/generate-shaders.mjs` transpiles from GLSL; this file
|
|
8
|
+
// owns the camera basis, the weather uniforms and the sky it reflects, and nothing else.
|
|
9
|
+
//
|
|
10
|
+
// Conventions: one world unit is one metre, +x is out to sea, -z runs down the coast.
|
|
11
|
+
import {
|
|
12
|
+
DoubleSide,
|
|
13
|
+
Mesh,
|
|
14
|
+
type PerspectiveCamera,
|
|
15
|
+
PlaneGeometry,
|
|
16
|
+
type Scene,
|
|
17
|
+
Vector3,
|
|
18
|
+
} from "three";
|
|
19
|
+
import { cameraFar, cameraNear, clamp, float, positionGeometry, uv, vec4 } from "three/tsl";
|
|
20
|
+
import { MeshBasicNodeMaterial } from "three/webgpu";
|
|
21
|
+
import type { QualityName, Weather } from "../state.js";
|
|
22
|
+
import { type ICloudPass, createCloudPass } from "./clouds.js";
|
|
23
|
+
import { setupLighting } from "./lighting.js";
|
|
24
|
+
import { setupMaterials } from "./materials.js";
|
|
25
|
+
import { studyTier } from "./quality.js";
|
|
26
|
+
import { setupSky } from "./sky.js";
|
|
27
|
+
import {
|
|
28
|
+
tempestWorld,
|
|
29
|
+
uAspect,
|
|
30
|
+
uCam,
|
|
31
|
+
uFlash,
|
|
32
|
+
uFog,
|
|
33
|
+
uForward,
|
|
34
|
+
uRain,
|
|
35
|
+
uReflect,
|
|
36
|
+
uRight,
|
|
37
|
+
uStrike,
|
|
38
|
+
uTan,
|
|
39
|
+
uTime,
|
|
40
|
+
uUp,
|
|
41
|
+
uWet,
|
|
42
|
+
} from "./world-shader.js";
|
|
43
|
+
|
|
44
|
+
export interface IWeatherWorldOptions {
|
|
45
|
+
/** Absolute seconds, so the weather phase does not depend on how the frame was scheduled. */
|
|
46
|
+
readonly elapsed: number;
|
|
47
|
+
/** Current flash envelope, already gated on the photosensitivity switch by the caller. */
|
|
48
|
+
readonly flash: number;
|
|
49
|
+
readonly weather: Weather;
|
|
50
|
+
/** Where the last strike landed, in metres. Only visible while `flash` is above zero. */
|
|
51
|
+
readonly strike: Vector3;
|
|
52
|
+
/** The player's tier: `quality.ts` decides whether it runs the 36-step reflection march. */
|
|
53
|
+
readonly quality: QualityName;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
export interface IWeatherWorld {
|
|
57
|
+
/** The screen quad, for the engine's culling pass: see the engine's `alwaysRender`. */
|
|
58
|
+
readonly quad: Mesh;
|
|
59
|
+
/** What the cloud pass really drew last frame: its target size and its march steps. */
|
|
60
|
+
readonly clouds: ICloudPass["measured"];
|
|
61
|
+
dispose(): void;
|
|
62
|
+
update(options: IWeatherWorldOptions): void;
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
/**
|
|
66
|
+
* The cloud pass is built first because it is what the world samples: `createCloudPass` binds the
|
|
67
|
+
* pass's texture node to the world's `uSky`, and the world shader's own functions read that binding
|
|
68
|
+
* when this call below builds their graph. The order of these two lines is the whole dependency.
|
|
69
|
+
*/
|
|
70
|
+
export function createWeatherWorld(scene: Scene, camera: PerspectiveCamera): IWeatherWorld {
|
|
71
|
+
const clouds: ICloudPass = createCloudPass({ camera });
|
|
72
|
+
// The look the two passes read: sky and haze colours, the sun and the flash light, and the lamp
|
|
73
|
+
// and sea colours. Set once; nothing here changes per frame.
|
|
74
|
+
setupSky(scene);
|
|
75
|
+
setupLighting();
|
|
76
|
+
setupMaterials();
|
|
77
|
+
|
|
78
|
+
const world = tempestWorld(uv());
|
|
79
|
+
// The shader's own depth is a curve fitted to the source's camera; the closed form is reversible,
|
|
80
|
+
// so the engine's near/far decide the real clip depth and anything drawn after this quad — rain,
|
|
81
|
+
// then lightning — is occluded by the coast rather than floating through it.
|
|
82
|
+
const viewDistance = float(0.150009).div(float(1.00006).sub(world.w));
|
|
83
|
+
const material = new MeshBasicNodeMaterial();
|
|
84
|
+
// The source driver drew its coast quad with both faces, so the vertex stage is written to flip
|
|
85
|
+
// the corner order; a single-face material would cull whichever way that lands.
|
|
86
|
+
material.side = DoubleSide;
|
|
87
|
+
material.vertexNode = vec4(positionGeometry.xy, 0, 1);
|
|
88
|
+
material.fragmentNode = world.xyz;
|
|
89
|
+
material.depthNode = clamp(
|
|
90
|
+
cameraNear
|
|
91
|
+
.add(cameraFar)
|
|
92
|
+
.sub(cameraNear.mul(cameraFar).mul(2).div(viewDistance))
|
|
93
|
+
.div(cameraFar.sub(cameraNear))
|
|
94
|
+
.add(1)
|
|
95
|
+
.mul(0.5),
|
|
96
|
+
0,
|
|
97
|
+
1,
|
|
98
|
+
);
|
|
99
|
+
|
|
100
|
+
const geometry = new PlaneGeometry(2, 2);
|
|
101
|
+
const quad = new Mesh(geometry, material);
|
|
102
|
+
// The quad's own bounds are two metres wide and sit at the origin, so both frustum tests would
|
|
103
|
+
// throw it away the moment the camera looks along the coast.
|
|
104
|
+
quad.frustumCulled = false;
|
|
105
|
+
scene.add(quad);
|
|
106
|
+
|
|
107
|
+
const forward = new Vector3();
|
|
108
|
+
const right = new Vector3();
|
|
109
|
+
const up = new Vector3();
|
|
110
|
+
|
|
111
|
+
return {
|
|
112
|
+
quad,
|
|
113
|
+
clouds: clouds.measured,
|
|
114
|
+
dispose(): void {
|
|
115
|
+
scene.remove(quad);
|
|
116
|
+
geometry.dispose();
|
|
117
|
+
material.dispose();
|
|
118
|
+
clouds.dispose();
|
|
119
|
+
},
|
|
120
|
+
update({ elapsed, flash, quality, strike, weather }): void {
|
|
121
|
+
// The camera basis the shader raymarches from: the same three axes the renderer draws with,
|
|
122
|
+
// and the same field of view, so the coast lines up with anything the engine adds later.
|
|
123
|
+
camera.getWorldDirection(forward);
|
|
124
|
+
right.set(1, 0, 0).applyQuaternion(camera.quaternion);
|
|
125
|
+
up.set(0, 1, 0).applyQuaternion(camera.quaternion);
|
|
126
|
+
uCam.value.copy(camera.position);
|
|
127
|
+
uForward.value.copy(forward);
|
|
128
|
+
uRight.value.copy(right);
|
|
129
|
+
uUp.value.copy(up);
|
|
130
|
+
uAspect.value = camera.aspect;
|
|
131
|
+
uTan.value = Math.tan((camera.fov * Math.PI) / 360);
|
|
132
|
+
uTime.value = elapsed;
|
|
133
|
+
|
|
134
|
+
uRain.value = weather.rain;
|
|
135
|
+
uFog.value = weather.fog;
|
|
136
|
+
uWet.value = weather.wet;
|
|
137
|
+
uFlash.value = flash;
|
|
138
|
+
uStrike.value.copy(strike);
|
|
139
|
+
uReflect.value = studyTier(quality).reflections ? 1 : 0;
|
|
140
|
+
|
|
141
|
+
// The sky the shader draws and reflects is the cloud target, so the same weather that steers
|
|
142
|
+
// the rain also lights the ceiling, and a flash reaches both from one value.
|
|
143
|
+
clouds.update({ elapsed, flash, quality, strike, weather });
|
|
144
|
+
},
|
|
145
|
+
};
|
|
146
|
+
}
|
|
@@ -24,8 +24,10 @@ import {
|
|
|
24
24
|
} from "three";
|
|
25
25
|
import { bloom } from "three/addons/tsl/display/BloomNode.js";
|
|
26
26
|
import { denoise } from "three/addons/tsl/display/DenoiseNode.js";
|
|
27
|
+
import { fxaa } from "three/addons/tsl/display/FXAANode.js";
|
|
27
28
|
import { ao } from "three/addons/tsl/display/GTAONode.js";
|
|
28
29
|
import { godrays } from "three/addons/tsl/display/GodraysNode.js";
|
|
30
|
+
import { smaa } from "three/addons/tsl/display/SMAANode.js";
|
|
29
31
|
import { ssgi } from "three/addons/tsl/display/SSGINode.js";
|
|
30
32
|
import { ssr } from "three/addons/tsl/display/SSRNode.js";
|
|
31
33
|
import { sharpen } from "three/addons/tsl/display/SharpenNode.js";
|
|
@@ -33,6 +35,7 @@ import {
|
|
|
33
35
|
color,
|
|
34
36
|
convertToTexture,
|
|
35
37
|
float,
|
|
38
|
+
max,
|
|
36
39
|
metalness,
|
|
37
40
|
mrt,
|
|
38
41
|
normalView,
|
|
@@ -45,6 +48,9 @@ import {
|
|
|
45
48
|
} from "three/tsl";
|
|
46
49
|
import type { Node } from "three/webgpu";
|
|
47
50
|
|
|
51
|
+
/** Godot's `Viewport.screen_space_aa`: which post-process antialiasing smooths the frame's edges. */
|
|
52
|
+
export type ScreenSpaceAA = "smaa" | "fxaa" | "disabled";
|
|
53
|
+
|
|
48
54
|
/** Godot's `Environment.tonemap_mode`, with the modes Three.js actually ships. */
|
|
49
55
|
export type TonemapMode = "aces" | "agx" | "neutral";
|
|
50
56
|
|
|
@@ -184,6 +190,16 @@ export interface IWorldEnvironmentOptions {
|
|
|
184
190
|
readonly sharpenStrength?: number;
|
|
185
191
|
/** Corner darkening, as a fraction removed at the extreme corner. Zero disables it. */
|
|
186
192
|
readonly vignetteAmount?: number;
|
|
193
|
+
/**
|
|
194
|
+
* Post-process antialiasing, run last. Godot's `Viewport.screen_space_aa`. Default `"smaa"`.
|
|
195
|
+
*
|
|
196
|
+
* Not optional in practice: the chain renders `pass(scene, camera)` single-sampled, so the moment
|
|
197
|
+
* any stage runs, the renderer's own multisampling no longer reaches the frame and every edge
|
|
198
|
+
* stairsteps — the single loudest "this is a prototype" signal in a frame. It is requested only
|
|
199
|
+
* when some other stage (or a `baseColour`) installs a chain; with nothing installed the renderer
|
|
200
|
+
* draws straight to the canvas with its own MSAA and this would be paying twice.
|
|
201
|
+
*/
|
|
202
|
+
readonly screenSpaceAA?: ScreenSpaceAA;
|
|
187
203
|
/** Godot's `glow_enabled`. */
|
|
188
204
|
readonly bloomEnabled?: boolean;
|
|
189
205
|
readonly bloomStrength?: number;
|
|
@@ -391,6 +407,7 @@ export class WorldEnvironment {
|
|
|
391
407
|
sharpenEnabled: options.sharpenEnabled ?? false,
|
|
392
408
|
sharpenStrength: options.sharpenStrength ?? 0.2,
|
|
393
409
|
vignetteAmount: options.vignetteAmount ?? 0,
|
|
410
|
+
screenSpaceAA: options.screenSpaceAA ?? "smaa",
|
|
394
411
|
bloomEnabled: options.bloomEnabled ?? true,
|
|
395
412
|
bloomStrength: options.bloomStrength ?? 0.7,
|
|
396
413
|
bloomRadius: options.bloomRadius ?? 0.5,
|
|
@@ -432,6 +449,11 @@ export class WorldEnvironment {
|
|
|
432
449
|
(name === "vignette" && options.vignetteAmount > 0),
|
|
433
450
|
);
|
|
434
451
|
requested.push(...options.authoredStageNames);
|
|
452
|
+
if (
|
|
453
|
+
options.screenSpaceAA !== "disabled" &&
|
|
454
|
+
(requested.length > 0 || target.baseColour !== undefined)
|
|
455
|
+
)
|
|
456
|
+
requested.push("antialias");
|
|
435
457
|
|
|
436
458
|
// With no stage running there is no node graph to install — the renderer's own
|
|
437
459
|
// tone-mapping path renders the frame, and the exposure scalar is live there (measured:
|
|
@@ -542,7 +564,14 @@ export class WorldEnvironment {
|
|
|
542
564
|
// Applied before SSGI by the chain's canonical order; composing it after the GI
|
|
543
565
|
// combine instead darkens crevices the gather re-lit — that is a look choice, and
|
|
544
566
|
// this file is where you make it.
|
|
545
|
-
|
|
567
|
+
//
|
|
568
|
+
// Denoised with the same depth-aware filter as the GI gather: GTAO's interleaved
|
|
569
|
+
// sampling otherwise reads as a speckled halo around every contact — around feet on a
|
|
570
|
+
// plain floor most of all — which is exactly the "not smooth" a player notices first.
|
|
571
|
+
const occlusion = options.denoiseEnabled
|
|
572
|
+
? denoised(denoise(contact.getTextureNode(), depth(), normal(), view))
|
|
573
|
+
: contact;
|
|
574
|
+
return input.mul(occlusion.r);
|
|
546
575
|
},
|
|
547
576
|
}),
|
|
548
577
|
stage({
|
|
@@ -668,6 +697,26 @@ export class WorldEnvironment {
|
|
|
668
697
|
return input.mul(fall.oneMinus());
|
|
669
698
|
},
|
|
670
699
|
}),
|
|
700
|
+
{
|
|
701
|
+
// Last, after every built-in: antialiasing is defined on the finished picture, and any
|
|
702
|
+
// stage after it would put the stairsteps back.
|
|
703
|
+
name: "antialias",
|
|
704
|
+
after: "gradualBackground",
|
|
705
|
+
build: (input) => {
|
|
706
|
+
const colour = input as ChainNode;
|
|
707
|
+
// SMAA and FXAA find edges by local contrast and expect display-range colour, but this is
|
|
708
|
+
// the linear HDR frame before the tone curve — a sun-lit edge at 20 against sky at 3
|
|
709
|
+
// would blend into a bright halo. The reversible Karis weighting squeezes it into [0, 1)
|
|
710
|
+
// for the filter and expands it back afterwards, so edges resolve without the halo.
|
|
711
|
+
const peak = max(colour.r, max(colour.g, colour.b));
|
|
712
|
+
const squeezed = colour.div(peak.add(1));
|
|
713
|
+
const filtered = (options.screenSpaceAA === "fxaa"
|
|
714
|
+
? fxaa(squeezed)
|
|
715
|
+
: smaa(squeezed)) as unknown as ChainNode;
|
|
716
|
+
const back = max(filtered.r, max(filtered.g, filtered.b));
|
|
717
|
+
return filtered.div(float(1).sub(back).max(1e-4));
|
|
718
|
+
},
|
|
719
|
+
},
|
|
671
720
|
];
|
|
672
721
|
|
|
673
722
|
// The kit's own stages, composed after the built-ins. The factory is called with the two
|
|
@@ -723,6 +772,7 @@ export class WorldEnvironment {
|
|
|
723
772
|
const options = this.#options;
|
|
724
773
|
const off: Record<string, string> = {
|
|
725
774
|
ambientOcclusion: "gtaoEnabled is false",
|
|
775
|
+
antialias: 'screenSpaceAA is "disabled", or no other stage installed a chain',
|
|
726
776
|
bloom: "bloomEnabled is false",
|
|
727
777
|
godRays: "godraysEnabled is false",
|
|
728
778
|
sharpen: "sharpenEnabled is false",
|
|
@@ -745,6 +795,7 @@ export class WorldEnvironment {
|
|
|
745
795
|
denoise: options.denoiseEnabled,
|
|
746
796
|
exposure: options.exposure,
|
|
747
797
|
marker: "TN_WORLD_ENVIRONMENT",
|
|
798
|
+
screenSpaceAA: options.screenSpaceAA,
|
|
748
799
|
ssgiQuality: options.ssgiQuality,
|
|
749
800
|
stages,
|
|
750
801
|
tonemapMode: options.tonemapMode,
|
|
@@ -0,0 +1,334 @@
|
|
|
1
|
+
// Generated for you. The one scene: a coast you can walk, and an atmosphere you can reshape.
|
|
2
|
+
import { type ICtx, Scene, type SceneFrame, alwaysRender, isMobile } from "@threenative/core";
|
|
3
|
+
import { type PerspectiveCamera, Vector3 } from "three";
|
|
4
|
+
import { STORM_AUDIO_ENTITY, createStormAudio } from "../audio/storm.js";
|
|
5
|
+
import { createCameraRig, setupCamera } from "../render/camera.js";
|
|
6
|
+
import { type IStormLightning, createStormLightning } from "../render/lightning.js";
|
|
7
|
+
import { createLoadingScreen } from "../render/loading.js";
|
|
8
|
+
import { type IStormPost, setupPost } from "../render/postprocessing.js";
|
|
9
|
+
import { type IStormRain, createStormRain } from "../render/rain.js";
|
|
10
|
+
import { createWeatherWorld } from "../render/world.js";
|
|
11
|
+
import {
|
|
12
|
+
AUTO_STRIKE_CLOUD,
|
|
13
|
+
type GameState,
|
|
14
|
+
MAX_STEP,
|
|
15
|
+
type SimStatus,
|
|
16
|
+
WEATHER_KEYS,
|
|
17
|
+
type Weather,
|
|
18
|
+
easeWeather,
|
|
19
|
+
flashAt,
|
|
20
|
+
intentPatch,
|
|
21
|
+
thunderDelay,
|
|
22
|
+
} from "../state.js";
|
|
23
|
+
|
|
24
|
+
export type WeatherCtx = ICtx<GameState>;
|
|
25
|
+
|
|
26
|
+
/** Seconds of weather the clock starts on, so the first frame is not the start of the storm. */
|
|
27
|
+
const START_TIME = 28;
|
|
28
|
+
/** The storm, this far in, is not waiting for the first automatic strike. */
|
|
29
|
+
const FIRST_STRIKE_DELAY = 9;
|
|
30
|
+
const STRIKE_MIN_GAP = 8;
|
|
31
|
+
const STRIKE_SPREAD = 16;
|
|
32
|
+
/** Below this gap the atmosphere is where it was aimed, and the status can say so. */
|
|
33
|
+
const SETTLED = 0.004;
|
|
34
|
+
/** Where a strike lands, in the game's own coordinates: out to sea, ahead of the coast. */
|
|
35
|
+
const STRIKE_SITE = { maxX: 49, minX: -45, nearZ: -250, spread: 220 } as const;
|
|
36
|
+
|
|
37
|
+
const STORM: Weather = {
|
|
38
|
+
cloud: 0.76,
|
|
39
|
+
exposure: 1.12,
|
|
40
|
+
fog: 0.4,
|
|
41
|
+
rain: 0.76,
|
|
42
|
+
wet: 1,
|
|
43
|
+
wind: 0.55,
|
|
44
|
+
};
|
|
45
|
+
|
|
46
|
+
export class Coast extends Scene<GameState> {
|
|
47
|
+
// Kept on the instance because `enter` builds them and `exit` is the only hook that runs when the
|
|
48
|
+
// scene goes away: a dropped handle is a shader chain and a geometry that never come back.
|
|
49
|
+
#rain: IStormRain | undefined;
|
|
50
|
+
#post: IStormPost | undefined;
|
|
51
|
+
#lightning: IStormLightning | undefined;
|
|
52
|
+
#measureClouds: (() => GameState["cloudPass"]) | undefined;
|
|
53
|
+
#curtainLifted: (() => boolean) | undefined;
|
|
54
|
+
|
|
55
|
+
static override readonly initialState: GameState = {
|
|
56
|
+
audioEnabled: false,
|
|
57
|
+
autoLightning: true,
|
|
58
|
+
cameraReset: false,
|
|
59
|
+
cinematic: false,
|
|
60
|
+
cloudPass: { height: 0, steps: 0, width: 0 },
|
|
61
|
+
droplets: true,
|
|
62
|
+
dropCount: 0,
|
|
63
|
+
elapsed: START_TIME,
|
|
64
|
+
flash: 0,
|
|
65
|
+
fps: 0,
|
|
66
|
+
frame: 0,
|
|
67
|
+
frozen: false,
|
|
68
|
+
heading: 0,
|
|
69
|
+
helpOpen: false,
|
|
70
|
+
muted: false,
|
|
71
|
+
paused: false,
|
|
72
|
+
lastStrike: { at: -1, delay: 0, metres: 0 },
|
|
73
|
+
loading: { progress: 0, ready: false },
|
|
74
|
+
pendingThunderAt: -1,
|
|
75
|
+
position: { x: 0, y: 0, z: 0 },
|
|
76
|
+
preset: "storm",
|
|
77
|
+
quality: "balanced",
|
|
78
|
+
safe: false,
|
|
79
|
+
status: "steady",
|
|
80
|
+
stepRequest: 0,
|
|
81
|
+
strikeRequested: false,
|
|
82
|
+
strikes: 0,
|
|
83
|
+
target: { ...STORM },
|
|
84
|
+
uiHidden: false,
|
|
85
|
+
uiReady: false,
|
|
86
|
+
weather: { ...STORM },
|
|
87
|
+
};
|
|
88
|
+
|
|
89
|
+
override enter(ctx: WeatherCtx): SceneFrame<GameState> {
|
|
90
|
+
const camera = ctx.camera as PerspectiveCamera;
|
|
91
|
+
setupCamera(camera);
|
|
92
|
+
const rig = createCameraRig(camera);
|
|
93
|
+
// The study's player is the fly camera, so that is the subject a playtest moves and measures.
|
|
94
|
+
ctx.entities.add("player", camera);
|
|
95
|
+
const loading = createLoadingScreen(ctx);
|
|
96
|
+
// The storm's noise volume is the same 64³ every run whatever the player does: it is seeded
|
|
97
|
+
// inside the render layer, because the sequence that fills it is the storm's appearance.
|
|
98
|
+
const world = createWeatherWorld(ctx.scene, camera);
|
|
99
|
+
// The world is one screen-sized quad at the origin, so the camera's own frustum would cull it
|
|
100
|
+
// the moment it looked along the coast. Marking it is how a game says "this is always drawn".
|
|
101
|
+
alwaysRender(world.quad);
|
|
102
|
+
// The rain is one instanced draw whose drops are projected by its own vertex stage, so its
|
|
103
|
+
// bounds say nothing about where they land and the same marker keeps it drawn at any heading.
|
|
104
|
+
const rain = createStormRain(ctx.scene, camera);
|
|
105
|
+
alwaysRender(rain.mesh);
|
|
106
|
+
// The bolt is drawn after the coast and depth-tested against it, so a strike behind the
|
|
107
|
+
// headland is hidden by it. Its quads are projected by its own vertex stage, like the rain.
|
|
108
|
+
const lightning = createStormLightning(ctx.scene, camera);
|
|
109
|
+
alwaysRender(lightning.mesh);
|
|
110
|
+
// Retained, not called and dropped: `update` is where the post pass learns this frame's time,
|
|
111
|
+
// exposure, rain and droplet toggle, and `uRes` is zero until it has run once.
|
|
112
|
+
const post = setupPost(ctx.renderer, ctx.scene, camera, {
|
|
113
|
+
mobile: isMobile(),
|
|
114
|
+
software: ctx.renderer.softwareAdapter !== undefined,
|
|
115
|
+
});
|
|
116
|
+
this.#rain = rain;
|
|
117
|
+
this.#post = post;
|
|
118
|
+
this.#lightning = lightning;
|
|
119
|
+
this.#measureClouds = world.clouds;
|
|
120
|
+
// `loading.ts` lifts its cover by making the canvas layer transparent again; that is the frame
|
|
121
|
+
// the world is on screen, so it is the frame the interface may appear on.
|
|
122
|
+
this.#curtainLifted = () => !ctx.canvasLayer.opaque;
|
|
123
|
+
// Registered, so the engine's registry disposes it with the game and `game.ts` can reach it by
|
|
124
|
+
// name for the two holds that arrive outside a frame (the pause intent and tab visibility).
|
|
125
|
+
const audio = ctx.entities.add(STORM_AUDIO_ENTITY, createStormAudio(ctx));
|
|
126
|
+
|
|
127
|
+
let weather: Weather = { ...STORM };
|
|
128
|
+
let elapsed = START_TIME;
|
|
129
|
+
let frame = 0;
|
|
130
|
+
let nextStrikeAt = START_TIME + FIRST_STRIKE_DELAY;
|
|
131
|
+
let strikeAt = -100;
|
|
132
|
+
let pendingThunderAt = -1;
|
|
133
|
+
let cinematic = false;
|
|
134
|
+
let safe = false;
|
|
135
|
+
let strikes = 0;
|
|
136
|
+
let lastStrike = { at: -1, delay: 0, metres: 0 };
|
|
137
|
+
// Where the bolt lands, and where it entered the cloud deck. The deck point is what the clouds
|
|
138
|
+
// glow around and what the coast is lit from; the ground point is what the thunder crosses.
|
|
139
|
+
// Out at sea, so a flash that lands before the first strike still lights open water.
|
|
140
|
+
const site = new Vector3(0, 0, -400);
|
|
141
|
+
const strikePoint = new Vector3(0, 180, -400);
|
|
142
|
+
|
|
143
|
+
/**
|
|
144
|
+
* A strike is queued on the same clock as everything else, so the flash, the thunder and the
|
|
145
|
+
* distance it crossed cannot disagree with each other. Gated on the photosensitivity switch
|
|
146
|
+
* at the one door every path comes through, manual key and automatic alike.
|
|
147
|
+
*/
|
|
148
|
+
const strike = (): void => {
|
|
149
|
+
if (safe) return;
|
|
150
|
+
strikeAt = elapsed - 0.025;
|
|
151
|
+
site.set(
|
|
152
|
+
STRIKE_SITE.minX + ctx.random() * (STRIKE_SITE.maxX - STRIKE_SITE.minX),
|
|
153
|
+
0,
|
|
154
|
+
STRIKE_SITE.nearZ - ctx.random() * STRIKE_SITE.spread,
|
|
155
|
+
);
|
|
156
|
+
strikePoint.copy(lightning.strike(site, ctx.random));
|
|
157
|
+
const metres = rig.position.distanceTo(site);
|
|
158
|
+
const delay = thunderDelay(metres);
|
|
159
|
+
pendingThunderAt = elapsed + delay;
|
|
160
|
+
nextStrikeAt = elapsed + STRIKE_MIN_GAP + ctx.random() * STRIKE_SPREAD;
|
|
161
|
+
strikes += 1;
|
|
162
|
+
lastStrike = { at: elapsed, delay, metres };
|
|
163
|
+
// The thunder is queued on the same clock the flash is drawn against, by the same distance
|
|
164
|
+
// the delay came from, so what is heard cannot disagree with what was seen.
|
|
165
|
+
audio.queueStrike({ at: pendingThunderAt, metres });
|
|
166
|
+
};
|
|
167
|
+
|
|
168
|
+
/**
|
|
169
|
+
* The keyboard shortcuts, through the same validated door the panel's controls use, so a key
|
|
170
|
+
* and a click cannot disagree about what photosensitivity mode or sound means.
|
|
171
|
+
*/
|
|
172
|
+
const readKeys = (frameCtx: WeatherCtx): void => {
|
|
173
|
+
const input = frameCtx.input;
|
|
174
|
+
const ui = frameCtx.state.getState();
|
|
175
|
+
let patch: Partial<GameState> = {};
|
|
176
|
+
if (input.justPressed("safe"))
|
|
177
|
+
patch = { ...patch, ...intentPatch("setSafe", !ui.safe, ui.target) };
|
|
178
|
+
if (input.justPressed("hideUi")) patch.uiHidden = !ui.uiHidden;
|
|
179
|
+
if (input.justPressed("sound")) {
|
|
180
|
+
const on = ui.audioEnabled && !ui.muted;
|
|
181
|
+
patch.audioEnabled = true;
|
|
182
|
+
patch.muted = on;
|
|
183
|
+
}
|
|
184
|
+
if (input.justPressed("pause")) {
|
|
185
|
+
patch.paused = !ui.paused;
|
|
186
|
+
audio.setSilenced(patch.paused);
|
|
187
|
+
}
|
|
188
|
+
if (Object.keys(patch).length > 0) frameCtx.state.set(patch);
|
|
189
|
+
};
|
|
190
|
+
|
|
191
|
+
/** Read the intent the UI sent between frames, before anything is derived from it. */
|
|
192
|
+
const readIntent = (frameCtx: WeatherCtx): GameState => {
|
|
193
|
+
readKeys(frameCtx);
|
|
194
|
+
const ui = frameCtx.state.getState();
|
|
195
|
+
// Both resets come through the same door, and each one is a fresh request: the flag is
|
|
196
|
+
// consumed and cleared below, never latched, so a second reset still lands.
|
|
197
|
+
const reset = ui.cameraReset || frameCtx.input.justPressed("resetCamera");
|
|
198
|
+
if (reset) {
|
|
199
|
+
rig.reset();
|
|
200
|
+
cinematic = false;
|
|
201
|
+
} else {
|
|
202
|
+
// Any real input hands the camera back: the orbit is a mode, not a cage.
|
|
203
|
+
cinematic = ui.cinematic && !rig.manual;
|
|
204
|
+
}
|
|
205
|
+
safe = ui.safe;
|
|
206
|
+
if (ui.strikeRequested || frameCtx.input.justPressed("strike")) strike();
|
|
207
|
+
return ui;
|
|
208
|
+
};
|
|
209
|
+
|
|
210
|
+
const advance = (ui: GameState, step: number): void => {
|
|
211
|
+
// A held simulation still draws, as the study's did: the look follows the panel at once
|
|
212
|
+
// instead of easing on a clock that is not running, and nothing else moves.
|
|
213
|
+
if (ui.paused || ui.frozen) weather = { ...ui.target };
|
|
214
|
+
if (step <= 0) return;
|
|
215
|
+
elapsed += step;
|
|
216
|
+
weather = easeWeather(weather, ui.target, step);
|
|
217
|
+
// The study's own gate: past its time, the first frame with real cloud cover strikes.
|
|
218
|
+
if (ui.autoLightning && elapsed > nextStrikeAt && weather.cloud > AUTO_STRIKE_CLOUD) strike();
|
|
219
|
+
};
|
|
220
|
+
|
|
221
|
+
return (frameCtx, dt) => {
|
|
222
|
+
const ui = readIntent(frameCtx);
|
|
223
|
+
// Pause holds the simulation the way the study's did — the frame is still drawn, so a drag
|
|
224
|
+
// still looks around — and `frozen` is the automation's stopped clock, which only an explicit
|
|
225
|
+
// `step` moves on. A step never runs while paused, exactly as the study's `step(dt)`.
|
|
226
|
+
const wall = ui.paused || ui.frozen ? 0 : Math.min(dt, MAX_STEP);
|
|
227
|
+
const step = wall + (ui.paused ? 0 : ui.stepRequest);
|
|
228
|
+
advance(ui, step);
|
|
229
|
+
|
|
230
|
+
const flash = safe ? 0 : flashAt(elapsed - strikeAt);
|
|
231
|
+
if (pendingThunderAt >= 0 && elapsed >= pendingThunderAt) pendingThunderAt = -1;
|
|
232
|
+
|
|
233
|
+
rig.update(wall, elapsed, frameCtx.input, cinematic);
|
|
234
|
+
// The rig only learns it is being driven once it has run, so the published flag is settled
|
|
235
|
+
// after it: a hand on the camera ends the orbit on the same frame it happened.
|
|
236
|
+
if (rig.manual) cinematic = false;
|
|
237
|
+
// Both passes read the weather this frame has just eased towards, not the target the UI
|
|
238
|
+
// asked for, so a drop and a lens bead are lit by the same air the coast is drawn with.
|
|
239
|
+
rain.update({ elapsed, flash, weather, quality: ui.quality });
|
|
240
|
+
lightning.update(flash);
|
|
241
|
+
post.update({
|
|
242
|
+
elapsed,
|
|
243
|
+
exposure: weather.exposure,
|
|
244
|
+
rain: weather.rain,
|
|
245
|
+
droplets: ui.droplets,
|
|
246
|
+
});
|
|
247
|
+
world.update({
|
|
248
|
+
elapsed,
|
|
249
|
+
flash,
|
|
250
|
+
quality: ui.quality,
|
|
251
|
+
strike: strikePoint,
|
|
252
|
+
weather,
|
|
253
|
+
});
|
|
254
|
+
loading.update();
|
|
255
|
+
frame += 1;
|
|
256
|
+
|
|
257
|
+
// Both request flags are consumed here, so the next request is a new one.
|
|
258
|
+
frameCtx.state.set({
|
|
259
|
+
cameraReset: false,
|
|
260
|
+
cinematic,
|
|
261
|
+
cloudPass: { ...frameCtx.state.getState().cloudPass, steps: world.clouds().steps },
|
|
262
|
+
dropCount: rain.instanceCount,
|
|
263
|
+
elapsed,
|
|
264
|
+
flash,
|
|
265
|
+
fps: frameCtx.fps,
|
|
266
|
+
frame,
|
|
267
|
+
heading: rig.heading,
|
|
268
|
+
lastStrike,
|
|
269
|
+
pendingThunderAt,
|
|
270
|
+
position: { x: rig.position.x, y: rig.position.y, z: rig.position.z },
|
|
271
|
+
safe,
|
|
272
|
+
stepRequest: 0,
|
|
273
|
+
strikeRequested: false,
|
|
274
|
+
strikes,
|
|
275
|
+
status: statusOf(ui.paused, flash, weather, ui.target),
|
|
276
|
+
weather,
|
|
277
|
+
});
|
|
278
|
+
frameCtx.state.flush();
|
|
279
|
+
// Last, so the mix is written from the frame that just ran rather than the one before it:
|
|
280
|
+
// `getState` already carries the patch above. The pause hold itself is an intent in
|
|
281
|
+
// `game.ts`, so the sound stops on the press rather than a frame later.
|
|
282
|
+
audio.update(frameCtx.state.getState());
|
|
283
|
+
};
|
|
284
|
+
}
|
|
285
|
+
|
|
286
|
+
/**
|
|
287
|
+
* The launch and the cloud target, published from the render hook rather than the simulation
|
|
288
|
+
* frame: a frame is drawn whether or not the clock moved (a paused or tick-driven run draws
|
|
289
|
+
* without simulating), the loading curtain must lift on the frame that shows the storm, and the
|
|
290
|
+
* cloud target is only resized by the render itself. "Ready" is the canvas loading screen in
|
|
291
|
+
* `src/render/loading.ts` having lifted, so the interface and the world appear together.
|
|
292
|
+
*/
|
|
293
|
+
override render(ctx: WeatherCtx): void {
|
|
294
|
+
const progress = ctx.startup.progress;
|
|
295
|
+
// The interface's curtain lifts with the engine's own loading screen, on the same frame.
|
|
296
|
+
const ready = this.#curtainLifted?.() ?? false;
|
|
297
|
+
const current = ctx.state.getState();
|
|
298
|
+
// Read after the frame was drawn, so it is the target the cloud pass really rendered into.
|
|
299
|
+
const clouds = this.#measureClouds?.() ?? current.cloudPass;
|
|
300
|
+
// Steps are the frame's own (set by the tier this frame simulated); the size is the render's.
|
|
301
|
+
const same =
|
|
302
|
+
current.loading.ready === ready &&
|
|
303
|
+
current.loading.progress === progress &&
|
|
304
|
+
current.cloudPass.width === clouds.width &&
|
|
305
|
+
current.cloudPass.height === clouds.height;
|
|
306
|
+
if (same) return;
|
|
307
|
+
ctx.state.set({
|
|
308
|
+
cloudPass: { ...current.cloudPass, height: clouds.height, width: clouds.width },
|
|
309
|
+
loading: { progress, ready },
|
|
310
|
+
});
|
|
311
|
+
ctx.state.flush();
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
/** The scene is leaving: both passes were built here, so both are released here. */
|
|
315
|
+
override exit(): void {
|
|
316
|
+
this.#rain?.dispose();
|
|
317
|
+
this.#post?.dispose();
|
|
318
|
+
this.#lightning?.dispose();
|
|
319
|
+
this.#rain = undefined;
|
|
320
|
+
this.#post = undefined;
|
|
321
|
+
this.#lightning = undefined;
|
|
322
|
+
}
|
|
323
|
+
}
|
|
324
|
+
|
|
325
|
+
/** Derived from the frame that just ran, so the label cannot describe a frame that is over. */
|
|
326
|
+
function statusOf(paused: boolean, flash: number, weather: Weather, target: Weather): SimStatus {
|
|
327
|
+
if (paused) return "paused";
|
|
328
|
+
if (flash > 0.003) return "flashing";
|
|
329
|
+
return settled(weather, target) ? "steady" : "settling";
|
|
330
|
+
}
|
|
331
|
+
|
|
332
|
+
function settled(current: Weather, target: Weather): boolean {
|
|
333
|
+
return WEATHER_KEYS.every((key) => Math.abs(current[key] - target[key]) < SETTLED);
|
|
334
|
+
}
|