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,354 @@
|
|
|
1
|
+
import { UiLayer, useUiIntent, useUiState } from "@threenative/ui";
|
|
2
|
+
import { useEffect, useState } from "react";
|
|
3
|
+
import { type GameState, PROBE_COLUMNS } from "../state.js";
|
|
4
|
+
import { BallActions, Controls } from "./Controls.js";
|
|
5
|
+
import { Icon, Mark } from "./icons.js";
|
|
6
|
+
|
|
7
|
+
const VIEW_LABELS: Record<GameState["view"], string> = {
|
|
8
|
+
follow: "Follow view",
|
|
9
|
+
overhead: "Overhead view",
|
|
10
|
+
surface: "Surface view",
|
|
11
|
+
};
|
|
12
|
+
|
|
13
|
+
function IconButton({
|
|
14
|
+
icon,
|
|
15
|
+
label,
|
|
16
|
+
onClick,
|
|
17
|
+
pressed,
|
|
18
|
+
className = "",
|
|
19
|
+
}: {
|
|
20
|
+
readonly icon: Parameters<typeof Icon>[0]["name"];
|
|
21
|
+
readonly label: string;
|
|
22
|
+
readonly onClick: () => void;
|
|
23
|
+
readonly pressed?: boolean;
|
|
24
|
+
readonly className?: string;
|
|
25
|
+
}) {
|
|
26
|
+
return (
|
|
27
|
+
<button
|
|
28
|
+
aria-label={label}
|
|
29
|
+
aria-pressed={pressed}
|
|
30
|
+
className={`grid h-11 w-11 place-items-center rounded-full border backdrop-blur-md transition hover:brightness-110 ${
|
|
31
|
+
pressed ? "border-aqua text-aqua" : "border-[rgb(233_247_252/0.22)] text-text"
|
|
32
|
+
} bg-[rgb(21_41_54/0.37)] ${className}`}
|
|
33
|
+
data-tn-interactive
|
|
34
|
+
onClick={onClick}
|
|
35
|
+
title={label}
|
|
36
|
+
type="button"
|
|
37
|
+
>
|
|
38
|
+
<Icon name={icon} />
|
|
39
|
+
</button>
|
|
40
|
+
);
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** The last footprint's floor, drawn as a small depth map: darker blue is deeper. */
|
|
44
|
+
function Probe({ values }: { readonly values: readonly number[] }) {
|
|
45
|
+
const rows = Math.max(1, Math.ceil(values.length / PROBE_COLUMNS));
|
|
46
|
+
return (
|
|
47
|
+
<svg
|
|
48
|
+
aria-label="Depth map of the last footprint"
|
|
49
|
+
className="h-[113px] w-[89px] shrink-0 overflow-hidden rounded-[7px] border border-[#d5e2e955] bg-[#cbdce6]"
|
|
50
|
+
preserveAspectRatio="none"
|
|
51
|
+
role="img"
|
|
52
|
+
viewBox={`0 0 ${PROBE_COLUMNS} ${rows}`}
|
|
53
|
+
>
|
|
54
|
+
<defs>
|
|
55
|
+
{/* The grid is coarse; a slight blur reads as a pressed surface rather than pixels. */}
|
|
56
|
+
<filter id="probe-soften">
|
|
57
|
+
<feGaussianBlur stdDeviation="0.22" />
|
|
58
|
+
</filter>
|
|
59
|
+
</defs>
|
|
60
|
+
<g filter="url(#probe-soften)">
|
|
61
|
+
{values.map((value, index) => {
|
|
62
|
+
const shade = Math.max(0, Math.min(1, value / 0.18));
|
|
63
|
+
const bank = Math.max(0, Math.min(1, -value / 0.045));
|
|
64
|
+
const r = Math.round(214 - shade * 109 + bank * 33);
|
|
65
|
+
const g = Math.round(230 - shade * 92 + bank * 21);
|
|
66
|
+
const b = Math.round(240 - shade * 64 + bank * 15);
|
|
67
|
+
return (
|
|
68
|
+
<rect
|
|
69
|
+
fill={`rgb(${r} ${g} ${b})`}
|
|
70
|
+
height={1.02}
|
|
71
|
+
// biome-ignore lint/suspicious/noArrayIndexKey: a fixed grid whose cells never reorder.
|
|
72
|
+
key={index}
|
|
73
|
+
width={1.02}
|
|
74
|
+
x={index % PROBE_COLUMNS}
|
|
75
|
+
y={Math.floor(index / PROBE_COLUMNS)}
|
|
76
|
+
/>
|
|
77
|
+
);
|
|
78
|
+
})}
|
|
79
|
+
</g>
|
|
80
|
+
</svg>
|
|
81
|
+
);
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
function Metric({
|
|
85
|
+
label,
|
|
86
|
+
value,
|
|
87
|
+
unit,
|
|
88
|
+
}: { readonly label: string; readonly value: string; readonly unit?: string }) {
|
|
89
|
+
return (
|
|
90
|
+
<div>
|
|
91
|
+
<div className="mb-1 text-[9px] uppercase tracking-[0.14em] text-[#9cb7c4]">{label}</div>
|
|
92
|
+
<div className="text-[22px] font-[450] leading-none tracking-tight tabular-nums">
|
|
93
|
+
{value}
|
|
94
|
+
{unit === undefined ? null : (
|
|
95
|
+
<em className="ml-1 text-[10px] not-italic text-[#99b8c6]">{unit}</em>
|
|
96
|
+
)}
|
|
97
|
+
</div>
|
|
98
|
+
</div>
|
|
99
|
+
);
|
|
100
|
+
}
|
|
101
|
+
|
|
102
|
+
function Help({ onClose }: { readonly onClose: () => void }) {
|
|
103
|
+
useEffect(() => {
|
|
104
|
+
const close = (event: KeyboardEvent) => {
|
|
105
|
+
if (event.key === "Escape") onClose();
|
|
106
|
+
};
|
|
107
|
+
window.addEventListener("keydown", close);
|
|
108
|
+
return () => window.removeEventListener("keydown", close);
|
|
109
|
+
}, [onClose]);
|
|
110
|
+
return (
|
|
111
|
+
<div className="pointer-events-auto fixed inset-0 z-30 grid place-items-center bg-[#05182677] p-4 backdrop-blur-sm">
|
|
112
|
+
<dialog
|
|
113
|
+
aria-labelledby="help-title"
|
|
114
|
+
aria-modal="true"
|
|
115
|
+
className="static m-0 w-[420px] max-w-full rounded-[15px] border border-[#647f8e] bg-[#172f3d] p-7 text-[#dbe9ed] shadow-[0_35px_90px_#04121daa]"
|
|
116
|
+
open
|
|
117
|
+
>
|
|
118
|
+
<h2 className="m-0 mb-2 text-[23px] font-[450]" id="help-title">
|
|
119
|
+
Leave a little trace.
|
|
120
|
+
</h2>
|
|
121
|
+
<p className="text-[12px] leading-relaxed text-[#a9c0cd]">
|
|
122
|
+
Walk the glade, push the ball through the powder, or switch on the blizzard and watch the
|
|
123
|
+
tracks fill.
|
|
124
|
+
</p>
|
|
125
|
+
<table className="my-5 w-full border-collapse text-[12px]">
|
|
126
|
+
<tbody>
|
|
127
|
+
{[
|
|
128
|
+
["Walk / run", "WASD or arrows / Shift"],
|
|
129
|
+
["Orbit / zoom", "Drag / scroll"],
|
|
130
|
+
["Drop / push the ball", "F / G"],
|
|
131
|
+
["Blizzard / camera", "B / C"],
|
|
132
|
+
["Auto-explore / compaction", "P / V"],
|
|
133
|
+
["Clear footprints / sound", "R / M"],
|
|
134
|
+
].map(([action, keys]) => (
|
|
135
|
+
<tr className="border-b border-white/10" key={action}>
|
|
136
|
+
<td className="py-2">{action}</td>
|
|
137
|
+
<td className="py-2 text-right text-[#b5dbd5]">{keys}</td>
|
|
138
|
+
</tr>
|
|
139
|
+
))}
|
|
140
|
+
</tbody>
|
|
141
|
+
</table>
|
|
142
|
+
<p className="text-[11px] leading-relaxed text-[#a9c0cd]">
|
|
143
|
+
The snow is a deformable heightfield with approximate compaction and deposition, not a
|
|
144
|
+
granular solver.
|
|
145
|
+
</p>
|
|
146
|
+
<button
|
|
147
|
+
className="mt-2 min-h-11 w-full rounded-[7px] bg-aqua text-[12px] text-aqua-ink"
|
|
148
|
+
data-tn-interactive
|
|
149
|
+
// biome-ignore lint/a11y/noAutofocus: a modal moves focus to its one action.
|
|
150
|
+
autoFocus
|
|
151
|
+
onClick={onClose}
|
|
152
|
+
type="button"
|
|
153
|
+
>
|
|
154
|
+
Back to the snow
|
|
155
|
+
</button>
|
|
156
|
+
</dialog>
|
|
157
|
+
</div>
|
|
158
|
+
);
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
function Toast({ state }: { readonly state: GameState }) {
|
|
162
|
+
const [shown, setShown] = useState(false);
|
|
163
|
+
useEffect(() => {
|
|
164
|
+
if (state.toastId === 0) return;
|
|
165
|
+
setShown(true);
|
|
166
|
+
const timer = setTimeout(() => setShown(false), 2800);
|
|
167
|
+
return () => clearTimeout(timer);
|
|
168
|
+
}, [state.toastId]);
|
|
169
|
+
return (
|
|
170
|
+
<output
|
|
171
|
+
aria-live="polite"
|
|
172
|
+
className={`fixed bottom-[100px] left-1/2 z-20 max-w-[85vw] -translate-x-1/2 rounded-[9px] border border-line bg-[rgb(16_35_46/0.88)] px-4 py-3 text-center text-[12px] backdrop-blur-lg transition-opacity max-[850px]:bottom-[250px] ${
|
|
173
|
+
shown ? "opacity-100" : "opacity-0"
|
|
174
|
+
}`}
|
|
175
|
+
>
|
|
176
|
+
{state.toast}
|
|
177
|
+
</output>
|
|
178
|
+
);
|
|
179
|
+
}
|
|
180
|
+
|
|
181
|
+
function Hud() {
|
|
182
|
+
const state = useUiState<GameState>();
|
|
183
|
+
const send = useUiIntent();
|
|
184
|
+
const [menuOpen, setMenuOpen] = useState(false);
|
|
185
|
+
const [helpOpen, setHelpOpen] = useState(false);
|
|
186
|
+
if (state === undefined) return null;
|
|
187
|
+
const weatherWords = state.blizzard ? "Incoming gusts · spindrift" : "Light air · dry powder";
|
|
188
|
+
return (
|
|
189
|
+
<div className="pointer-events-none absolute inset-0 select-none text-text">
|
|
190
|
+
{/* Vignette and storm veil: atmosphere only, never in the way of a click. */}
|
|
191
|
+
<div className="absolute inset-0 bg-[linear-gradient(90deg,rgb(5_20_31/0.24),transparent_42%),linear-gradient(0deg,rgb(9_24_35/0.46),transparent_18%,transparent_80%,rgb(7_22_32/0.18))]" />
|
|
192
|
+
{/* A soft scrim under the header and readouts keeps small light text legible over snow. */}
|
|
193
|
+
<div className="absolute inset-x-0 top-0 h-[210px] bg-[linear-gradient(180deg,rgb(10_26_36/0.42),transparent)]" />
|
|
194
|
+
<div
|
|
195
|
+
className="absolute inset-0 bg-[radial-gradient(ellipse_at_center,transparent_30%,rgb(224_239_246/0.23))]"
|
|
196
|
+
style={{ opacity: state.storm * 0.8 }}
|
|
197
|
+
/>
|
|
198
|
+
|
|
199
|
+
<header className="absolute left-5 right-5 top-5 flex items-center justify-between gap-3 min-[851px]:left-[34px] min-[851px]:right-[34px] min-[851px]:top-[25px]">
|
|
200
|
+
<div className="flex min-w-0 items-center gap-3">
|
|
201
|
+
<div className="grid h-[38px] w-[38px] shrink-0 place-items-center rounded-[11px] border border-[rgb(238_246_250/0.55)] bg-[rgb(28_50_61/0.16)]">
|
|
202
|
+
<Mark />
|
|
203
|
+
</div>
|
|
204
|
+
<div className="min-w-0">
|
|
205
|
+
<div className="truncate text-[15px] font-semibold tracking-[0.26em]">SNOW GLADE</div>
|
|
206
|
+
<div className="mt-1 truncate text-[9px] tracking-[0.2em] opacity-80">
|
|
207
|
+
DEFORMABLE SNOW STUDY
|
|
208
|
+
</div>
|
|
209
|
+
</div>
|
|
210
|
+
</div>
|
|
211
|
+
<div className="flex shrink-0 items-center gap-2">
|
|
212
|
+
<div className="mr-1 hidden items-center gap-2 rounded-full border border-[rgb(222_242_249/0.25)] bg-[rgb(20_39_51/0.24)] px-4 py-2.5 text-[10px] tracking-[0.13em] backdrop-blur-md min-[560px]:flex">
|
|
213
|
+
<span
|
|
214
|
+
className={`h-[5px] w-[5px] rounded-full ${state.paused ? "bg-[#c4c6c0]" : "bg-aqua shadow-[0_0_9px_rgb(159_226_204/0.5)]"}`}
|
|
215
|
+
/>
|
|
216
|
+
<span>{state.paused ? "SIMULATION PAUSED" : "LIVE SIMULATION"}</span>
|
|
217
|
+
</div>
|
|
218
|
+
<IconButton
|
|
219
|
+
icon={state.muted ? "muted" : "sound"}
|
|
220
|
+
label={state.muted ? "Turn sound on" : "Turn sound off"}
|
|
221
|
+
onClick={() => send("mute")}
|
|
222
|
+
pressed={!state.muted}
|
|
223
|
+
/>
|
|
224
|
+
<IconButton
|
|
225
|
+
className="max-[850px]:hidden"
|
|
226
|
+
icon="help"
|
|
227
|
+
label="Controls and notes"
|
|
228
|
+
onClick={() => setHelpOpen(true)}
|
|
229
|
+
/>
|
|
230
|
+
<IconButton
|
|
231
|
+
className="min-[851px]:hidden"
|
|
232
|
+
icon={menuOpen ? "close" : "menu"}
|
|
233
|
+
label={menuOpen ? "Close settings" : "Open settings"}
|
|
234
|
+
onClick={() => setMenuOpen(!menuOpen)}
|
|
235
|
+
pressed={menuOpen}
|
|
236
|
+
/>
|
|
237
|
+
</div>
|
|
238
|
+
</header>
|
|
239
|
+
|
|
240
|
+
{/* Left column: title, then the controls. On a phone the controls live behind the menu. */}
|
|
241
|
+
<section className="absolute bottom-[98px] left-[34px] top-[120px] w-[285px] [@media(max-height:800px)]:top-[92px] [@media(max-height:800px)]:bottom-[84px] overflow-y-auto [scrollbar-width:none] max-[1100px]:w-[264px] max-[850px]:left-4 max-[850px]:right-4 max-[850px]:top-[84px] max-[850px]:w-auto max-[850px]:bottom-[88px]">
|
|
242
|
+
<div
|
|
243
|
+
className={`mb-6 [text-shadow:0_1px_10px_rgb(16_40_54/0.35)] max-[850px]:mb-3 [@media(max-height:800px)]:mb-5 ${menuOpen ? "max-[850px]:hidden" : ""}`}
|
|
244
|
+
>
|
|
245
|
+
<div className="text-[9px] font-medium tracking-[0.28em] text-[#dfedf2]">
|
|
246
|
+
A STUDY IN WINTER
|
|
247
|
+
</div>
|
|
248
|
+
<h1 className="mb-3 mt-3 text-[46px] font-[450] leading-[1.04] tracking-[-0.05em] max-[1100px]:text-[40px] max-[850px]:text-[32px] [@media(max-height:800px)]:mb-0 [@media(max-height:800px)]:mt-2 [@media(max-height:800px)]:text-[30px]">
|
|
249
|
+
Snow,
|
|
250
|
+
<br className="[@media(max-height:800px)]:hidden" />{" "}
|
|
251
|
+
<span className="font-light text-[#e2eef1]">in motion.</span>
|
|
252
|
+
</h1>
|
|
253
|
+
<p className="m-0 max-w-[250px] text-[12px] leading-[1.7] opacity-90 max-[850px]:hidden [@media(max-height:800px)]:hidden">
|
|
254
|
+
Fresh powder. Every step remembered. A ball that carves its own track.
|
|
255
|
+
</p>
|
|
256
|
+
</div>
|
|
257
|
+
<div className={`pointer-events-auto ${menuOpen ? "" : "max-[850px]:hidden"}`}>
|
|
258
|
+
<Controls send={send} state={state} />
|
|
259
|
+
<p className="mt-3 text-[10px] tracking-[0.05em] text-[#e2ecf0] opacity-90 [text-shadow:0_1px_5px_#264452] max-[850px]:hidden">
|
|
260
|
+
Take over at any time with WASD.
|
|
261
|
+
</p>
|
|
262
|
+
</div>
|
|
263
|
+
</section>
|
|
264
|
+
|
|
265
|
+
<div
|
|
266
|
+
className={`absolute right-[34px] top-[103px] text-right [text-shadow:0_1px_3px_rgb(10_30_40/0.55),0_0_12px_rgb(16_40_54/0.35)] max-[850px]:right-4 max-[850px]:top-[84px] ${menuOpen ? "max-[850px]:hidden" : ""}`}
|
|
267
|
+
>
|
|
268
|
+
<div className="text-[28px] font-light leading-none tabular-nums">
|
|
269
|
+
{state.windNow.toFixed(1)}
|
|
270
|
+
<small className="ml-0.5 text-[10px] opacity-80">m/s</small>
|
|
271
|
+
</div>
|
|
272
|
+
<div className="mt-2 text-[9px] font-medium tracking-[0.2em]">WIND AT SNOWFIELD</div>
|
|
273
|
+
<div className="mt-1.5 text-[9px] font-medium uppercase tracking-[0.18em] opacity-90">
|
|
274
|
+
{weatherWords}
|
|
275
|
+
</div>
|
|
276
|
+
</div>
|
|
277
|
+
|
|
278
|
+
<aside
|
|
279
|
+
aria-label="Snow readouts"
|
|
280
|
+
className="pointer-events-auto absolute bottom-[115px] right-[31px] w-[236px] rounded-[15px] border border-line bg-panel p-4 backdrop-blur-xl max-[1100px]:w-[216px] max-[850px]:hidden"
|
|
281
|
+
>
|
|
282
|
+
<div className="mb-3 flex items-center justify-between text-[9px] tracking-[0.2em] text-[#c2d6e0]">
|
|
283
|
+
<span>LAST FOOTFALL</span>
|
|
284
|
+
<i className="h-[5px] w-[5px] rounded-full bg-aqua" />
|
|
285
|
+
</div>
|
|
286
|
+
<div className="flex items-center gap-4">
|
|
287
|
+
<Probe values={state.probe} />
|
|
288
|
+
<div className="flex flex-col gap-3">
|
|
289
|
+
<Metric label="Boot sink" unit="cm" value={(state.lastSink * 100).toFixed(1)} />
|
|
290
|
+
<Metric label="Contacts" value={state.contacts.toLocaleString("en-US")} />
|
|
291
|
+
</div>
|
|
292
|
+
</div>
|
|
293
|
+
<div className="mt-3 flex justify-between border-t border-line pt-3 text-[10px] text-[#9ebac8]">
|
|
294
|
+
<span>Ground speed</span>
|
|
295
|
+
<span className="tabular-nums text-[#d0e7e7]">{state.speed.toFixed(2)} m/s</span>
|
|
296
|
+
</div>
|
|
297
|
+
<div className="mt-4 flex items-center justify-between border-t border-line pt-3 text-[9px] tracking-[0.2em] text-[#c2d6e0]">
|
|
298
|
+
<span>BALL</span>
|
|
299
|
+
<span className="text-[10px] tracking-normal tabular-nums text-[#d0e7e7]">
|
|
300
|
+
{(state.ballSink * 100).toFixed(1)} cm · {Math.round(state.ballLoad)} N
|
|
301
|
+
</span>
|
|
302
|
+
</div>
|
|
303
|
+
<div className="mt-3">
|
|
304
|
+
<BallActions send={send} />
|
|
305
|
+
</div>
|
|
306
|
+
</aside>
|
|
307
|
+
|
|
308
|
+
<footer className="absolute bottom-[26px] left-[34px] right-[34px] flex items-center justify-between gap-4 max-[850px]:bottom-4 max-[850px]:left-4 max-[850px]:right-4">
|
|
309
|
+
<div className="min-w-[200px] text-[9px] tracking-[0.2em] text-[#e0ecf1] opacity-80 [text-shadow:0_1px_5px_#264452] max-[1100px]:invisible max-[850px]:hidden">
|
|
310
|
+
THREENATIVE <span className="text-[#b9d8de]">/</span> SNOW STUDY
|
|
311
|
+
</div>
|
|
312
|
+
<div className="flex items-center gap-4 rounded-full border border-[rgb(210_233_244/0.18)] bg-[rgb(17_35_46/0.59)] px-[18px] py-[11px] text-[11px] text-[#d8e5eb] backdrop-blur-xl max-[850px]:hidden">
|
|
313
|
+
{[
|
|
314
|
+
["W A S D", "Walk"],
|
|
315
|
+
["SHIFT", "Run"],
|
|
316
|
+
["F / G", "Ball"],
|
|
317
|
+
["B", "Blizzard"],
|
|
318
|
+
["DRAG", "Orbit"],
|
|
319
|
+
].map(([key, action]) => (
|
|
320
|
+
<span className="flex items-center gap-1.5 whitespace-nowrap" key={action}>
|
|
321
|
+
<kbd className="rounded border border-[rgb(206_232_244/0.35)] px-1 py-0.5 font-sans text-[9px] text-[#e6f1f5]">
|
|
322
|
+
{key}
|
|
323
|
+
</kbd>
|
|
324
|
+
{action}
|
|
325
|
+
</span>
|
|
326
|
+
))}
|
|
327
|
+
</div>
|
|
328
|
+
<div className="flex min-w-[150px] justify-end max-[850px]:w-full">
|
|
329
|
+
<button
|
|
330
|
+
className="pointer-events-auto flex min-h-11 items-center gap-2 rounded-[9px] border border-line bg-[rgb(20_39_50/0.75)] px-3.5 text-[11px] backdrop-blur-md transition hover:brightness-110"
|
|
331
|
+
data-tn-interactive
|
|
332
|
+
onClick={() => send("view")}
|
|
333
|
+
title="Cycle camera view (C)"
|
|
334
|
+
type="button"
|
|
335
|
+
>
|
|
336
|
+
<Icon name="camera" />
|
|
337
|
+
{VIEW_LABELS[state.view]}
|
|
338
|
+
</button>
|
|
339
|
+
</div>
|
|
340
|
+
</footer>
|
|
341
|
+
|
|
342
|
+
<Toast state={state} />
|
|
343
|
+
{helpOpen ? <Help onClose={() => setHelpOpen(false)} /> : null}
|
|
344
|
+
</div>
|
|
345
|
+
);
|
|
346
|
+
}
|
|
347
|
+
|
|
348
|
+
export function GameUi() {
|
|
349
|
+
return (
|
|
350
|
+
<UiLayer>
|
|
351
|
+
<Hud />
|
|
352
|
+
</UiLayer>
|
|
353
|
+
);
|
|
354
|
+
}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
// Stroke icons drawn at 24 px; colour follows the text around them.
|
|
2
|
+
const PATHS = {
|
|
3
|
+
blizzard: "M3 8h13a3 3 0 1 0-3-3M2 12h17a3 3 0 1 1-3 3M4 17h6",
|
|
4
|
+
camera: "M3 8h4l2-3h6l2 3h4v12H3V8zM12 16a3 3 0 1 0 0-6 3 3 0 0 0 0 6z",
|
|
5
|
+
drop: "M12 3v12M7 10l5 5 5-5M5 20h14",
|
|
6
|
+
help: "M12 21a9 9 0 1 0 0-18 9 9 0 0 0 0 18zM9.5 9a2.5 2.5 0 1 1 4.5 1.5c-1.4 1-2 1-2 3M12 17h.01",
|
|
7
|
+
menu: "M4 6h16M4 12h16M4 18h16",
|
|
8
|
+
muted: "M11 5L6 9H3v6h3l5 4V5zM16 9l5 6m0-6l-5 6",
|
|
9
|
+
pause: "M8 5v14M16 5v14",
|
|
10
|
+
play: "M8 5l11 7-11 7V5z",
|
|
11
|
+
push: "M4 12h12M12 7l5 5-5 5M20 5v14",
|
|
12
|
+
reset: "M3 10a9 9 0 1 1 2 8M3 4v6h6",
|
|
13
|
+
snow: "M12 3v18M4.2 7.5l15.6 9M4.2 16.5l15.6-9M9 5l3 3 3-3m-6 14l3-3 3 3",
|
|
14
|
+
sound: "M11 5L6 9H3v6h3l5 4V5zM15 8a6 6 0 0 1 0 8m3-11a10 10 0 0 1 0 14",
|
|
15
|
+
close: "M6 6l12 12M18 6L6 18",
|
|
16
|
+
} as const;
|
|
17
|
+
|
|
18
|
+
export type IconName = keyof typeof PATHS;
|
|
19
|
+
|
|
20
|
+
export function Icon({
|
|
21
|
+
name,
|
|
22
|
+
className = "h-[17px] w-[17px]",
|
|
23
|
+
}: { name: IconName; className?: string }) {
|
|
24
|
+
return (
|
|
25
|
+
<svg
|
|
26
|
+
aria-hidden="true"
|
|
27
|
+
className={`shrink-0 ${className}`}
|
|
28
|
+
fill="none"
|
|
29
|
+
stroke="currentColor"
|
|
30
|
+
strokeLinecap="round"
|
|
31
|
+
strokeLinejoin="round"
|
|
32
|
+
strokeWidth={1.6}
|
|
33
|
+
viewBox="0 0 24 24"
|
|
34
|
+
>
|
|
35
|
+
<path d={PATHS[name]} />
|
|
36
|
+
</svg>
|
|
37
|
+
);
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
/** The snowflake mark beside the title. */
|
|
41
|
+
export function Mark() {
|
|
42
|
+
return (
|
|
43
|
+
<svg
|
|
44
|
+
aria-hidden="true"
|
|
45
|
+
className="h-[25px] w-[25px]"
|
|
46
|
+
fill="none"
|
|
47
|
+
stroke="#f0f7f8"
|
|
48
|
+
strokeWidth={1.25}
|
|
49
|
+
viewBox="0 0 32 32"
|
|
50
|
+
>
|
|
51
|
+
<path d="M16 3v26M4.7 9.5l22.6 13M4.7 22.5l22.6-13M12 6l4 4 4-4M12 26l4-4 4 4M6 14l5-1-1-5M26 18l-5 1 1 5M6 18l5 1-1 5M26 14l-5-1 1-5" />
|
|
52
|
+
</svg>
|
|
53
|
+
);
|
|
54
|
+
}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import type { IThreeNativeConfig } from "@threenative/core";
|
|
2
|
+
|
|
3
|
+
const config: IThreeNativeConfig = {
|
|
4
|
+
app: {
|
|
5
|
+
id: "com.threenative.__PROJECT_ID__",
|
|
6
|
+
name: "__PROJECT_NAME__",
|
|
7
|
+
version: "1.0.0",
|
|
8
|
+
build: 1,
|
|
9
|
+
icon: "public/icon.png",
|
|
10
|
+
icons: { web: { favicon: "public/favicon.svg" } },
|
|
11
|
+
},
|
|
12
|
+
display: {
|
|
13
|
+
orientation: "landscape",
|
|
14
|
+
fullscreen: true,
|
|
15
|
+
keepScreenOn: true,
|
|
16
|
+
maxFps: 60,
|
|
17
|
+
},
|
|
18
|
+
window: {
|
|
19
|
+
title: "__PROJECT_NAME__",
|
|
20
|
+
width: 1280,
|
|
21
|
+
height: 720,
|
|
22
|
+
maximized: false,
|
|
23
|
+
resizable: true,
|
|
24
|
+
},
|
|
25
|
+
bootSplash: { backgroundColor: "#0c1c28" },
|
|
26
|
+
nativeEntry: "src/game.ts",
|
|
27
|
+
renderer: {
|
|
28
|
+
preferWebGPU: true,
|
|
29
|
+
resolutionScale: "auto",
|
|
30
|
+
// Multisampling resolves triangle edges. A cutout silhouette — foliage, a fence, hair — is
|
|
31
|
+
// carved inside the triangle by an alpha test, so it resolves through the coverage mask or
|
|
32
|
+
// not at all, which is what this spends the samples above on. It costs no target and no
|
|
33
|
+
// extra pass; set it false for a deliberately hard-edged look. `TN_ALPHA_ANTIALIASING`
|
|
34
|
+
// reports what it did, and says so when a single-sampled surface leaves it nothing to do.
|
|
35
|
+
alphaAntialiasing: true,
|
|
36
|
+
},
|
|
37
|
+
ui: { renderer: "web" },
|
|
38
|
+
// One asset tree, one compiler, one representation per artifact. Uncomment, then cook:
|
|
39
|
+
// threenative build --target android # cooks defaults.android; --profile <name> beats it
|
|
40
|
+
// buildProfiles: {
|
|
41
|
+
// defaults: { android: "compact" },
|
|
42
|
+
// profiles: {
|
|
43
|
+
// compact: {
|
|
44
|
+
// assets: { textures: { maxSize: 1024 }, models: { textures: { maxSize: 1024 } } },
|
|
45
|
+
// } },
|
|
46
|
+
// },
|
|
47
|
+
// Contract, byte definitions, the build report:
|
|
48
|
+
// node_modules/create-threenative/agent-docs/references/build-profiles.md
|
|
49
|
+
};
|
|
50
|
+
|
|
51
|
+
export default config;
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
{
|
|
2
|
+
"compilerOptions": {
|
|
3
|
+
"target": "ES2022",
|
|
4
|
+
"lib": ["ES2022", "DOM", "DOM.Iterable"],
|
|
5
|
+
"module": "ESNext",
|
|
6
|
+
"moduleResolution": "bundler",
|
|
7
|
+
"jsx": "react-jsx",
|
|
8
|
+
"types": ["vite/client"],
|
|
9
|
+
"strict": true,
|
|
10
|
+
"noUncheckedIndexedAccess": true,
|
|
11
|
+
"noEmit": true,
|
|
12
|
+
"skipLibCheck": true,
|
|
13
|
+
"verbatimModuleSyntax": true,
|
|
14
|
+
"isolatedModules": true
|
|
15
|
+
},
|
|
16
|
+
"include": ["src/**/*.ts", "src/**/*.tsx", "tests/**/*.ts", "*.ts"]
|
|
17
|
+
}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import tailwindcss from "@tailwindcss/vite";
|
|
2
|
+
import { watchAssets } from "@threenative/assets";
|
|
3
|
+
import react from "@vitejs/plugin-react";
|
|
4
|
+
import { createEngineFreshnessPlugin, createWebBrandPlugin } from "create-threenative";
|
|
5
|
+
import { defineConfig } from "vite";
|
|
6
|
+
import type { Plugin } from "vite";
|
|
7
|
+
import config from "./threenative.config.js";
|
|
8
|
+
|
|
9
|
+
function assetsWatchPlugin(): Plugin {
|
|
10
|
+
return {
|
|
11
|
+
name: "threenative-assets-watch",
|
|
12
|
+
apply: "serve",
|
|
13
|
+
async configureServer(server) {
|
|
14
|
+
const handle = watchAssets({ config: config.assets, cwd: server.config.root });
|
|
15
|
+
server.httpServer?.once("close", () => handle.close());
|
|
16
|
+
// Nothing is served before the first cook settles: until it does, `public/` has no
|
|
17
|
+
// `assets.manifest.json` and every asset answers from its source fallback.
|
|
18
|
+
await handle.ready;
|
|
19
|
+
},
|
|
20
|
+
};
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
export default defineConfig({
|
|
24
|
+
plugins: [
|
|
25
|
+
createEngineFreshnessPlugin(),
|
|
26
|
+
createWebBrandPlugin(),
|
|
27
|
+
react(),
|
|
28
|
+
tailwindcss(),
|
|
29
|
+
assetsWatchPlugin(),
|
|
30
|
+
],
|
|
31
|
+
server: {
|
|
32
|
+
watch: {
|
|
33
|
+
ignored: ["**/artifacts/**", "**/screenshots/**", "**/playtests/**"],
|
|
34
|
+
usePolling: true,
|
|
35
|
+
},
|
|
36
|
+
},
|
|
37
|
+
});
|
|
@@ -5,7 +5,7 @@ Instructions for the AI agent in this game. `CLAUDE.md` mirrors this file; edit
|
|
|
5
5
|
## Ownership
|
|
6
6
|
|
|
7
7
|
ThreeNative owns bootstrap, renderer, fixed-step loop, input, loading, physics bindings, and the state bridge. This repository owns gameplay and every visible choice in `src/render/`, `src/entities/`,
|
|
8
|
-
`src/scenes/`, and `src/ui/`; `src/game.ts` is portable and React mounts from `src/main.ts`. The render camera also skips an object that projects under **0.5 px** in it; `renderer.minimumProjectedPixels` raises that threshold (`false` disables the cut, not the count) and `alwaysRender(object)` exempts an object, while camera-attached objects and shadow casters are kept. The engine also owns the per-frame world-matrix walk, and by default it does not descend into a hidden subtree — so a game that reads a hidden object's `matrixWorld` directly must use `getWorldPosition` (or call `object.updateWorldMatrix(true, false)`) first; `renderer.matrixWorld: "all"` restores three's every-node walk, and `TN_PROJECTION` reports the visited-node count either way. `src/render/
|
|
8
|
+
`src/scenes/`, and `src/ui/`; `src/game.ts` is portable and React mounts from `src/main.ts`. The render camera also skips an object that projects under **0.5 px** in it; `renderer.minimumProjectedPixels` raises that threshold (`false` disables the cut, not the count) and `alwaysRender(object)` exempts an object, while camera-attached objects and shadow casters are kept. The engine also owns the per-frame world-matrix walk, and by default it does not descend into a hidden subtree — so a game that reads a hidden object's `matrixWorld` directly must use `getWorldPosition` (or call `object.updateWorldMatrix(true, false)`) first; `renderer.matrixWorld: "all"` restores three's every-node walk, and `TN_PROJECTION` reports the visited-node count either way. The look ships as a photographed sky and a rigged figure: `src/render/sky.ts` makes `assets/sky.jpg` (Poly Haven, CC0) the background, the environment light and the fog colour, `lighting.ts` adds the one sun it names in `SUN_DIRECTION`, and `Player.ts` drives `assets/mannequin.glb` (Quaternius, CC0) through `SkeletalMesh3D`. Swap the sky for any equirectangular image and re-aim `SUN_DIRECTION` at its sun; swap the rig and edit `CLIPS`.
|
|
9
9
|
|
|
10
10
|
## Start every change
|
|
11
11
|
|
|
@@ -35,7 +35,7 @@ bridge; avoid DOM globals, dynamic `import()`, and raw physics handles. **Report
|
|
|
35
35
|
- `.agents/skills/threenative-performance/SKILL.md` / `.claude/skills/threenative-performance/SKILL.md` — measured budgets.
|
|
36
36
|
- `.agents/skills/threenative-ui/SKILL.md` / `.claude/skills/threenative-ui/SKILL.md` — native-safe UI.
|
|
37
37
|
- `.agents/skills/threenative-context/SKILL.md` / `.claude/skills/threenative-context/SKILL.md` — portable ctx APIs.
|
|
38
|
-
- Confirmed framework bugs: use `file-engine-bug` in `.agents/skills/` or `.claude/skills/` after a minimal repro. Lazy-first: `.agents/skills/ponytail/SKILL.md` / `.claude/skills/ponytail/SKILL.md` — smallest correct change, and its reuse rung is the capability search above.
|
|
38
|
+
- Confirmed framework bugs: use `file-engine-bug` in `.agents/skills/` or `.claude/skills/` after a minimal repro. A game-side `patches/` fix is temporary: once it is settled, it moves into the engine in one PR. Lazy-first: `.agents/skills/ponytail/SKILL.md` / `.claude/skills/ponytail/SKILL.md` — smallest correct change, and its reuse rung is the capability search above.
|
|
39
39
|
|
|
40
40
|
## Commands and map
|
|
41
41
|
|
|
@@ -48,20 +48,21 @@ pnpm test
|
|
|
48
48
|
node tools/look.mjs
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
-
The game boots straight into `Play`: a
|
|
52
|
-
`lost`; `R` and the React restart intent rebuild from
|
|
53
|
-
`assets/native-proof.glb` load and its console marker for the
|
|
54
|
-
gameplay, `src/render/` owns the look, `src/ui/Hud.tsx`/`Menu.tsx`
|
|
55
|
-
JSON-safe values. Keep `playtests/survives.playtest.json` as smoke
|
|
51
|
+
The game boots straight into `Play`: a test arena holding a pickup, a crate, a gap you must jump and
|
|
52
|
+
a flag, which together produce `won` or `lost`; `R` and the React restart intent rebuild from
|
|
53
|
+
`initialState`. Keep the packaged `assets/native-proof.glb` load and its console marker for the
|
|
54
|
+
desktop asset gate. `Play.ts` owns gameplay, `src/render/` owns the look, `src/ui/Hud.tsx`/`Menu.tsx`
|
|
55
|
+
own UI, and `state.ts` publishes JSON-safe values. Keep `playtests/survives.playtest.json` as smoke
|
|
56
|
+
proof and update outcome tests.
|
|
56
57
|
|
|
57
58
|
On a touch-primary device (`isMobile() && isTouchscreenAvailable()`), local `src/render/touch-controls.ts` adds a left movement stick and right jump button; the scene passes its input to `Player`, with keyboard mapping as the desktop fallback.
|
|
58
59
|
|
|
59
60
|
## Portable authoring contracts
|
|
60
61
|
|
|
61
|
-
Leave `assets` absent: the cook selects target-decodable passes, with `models.sharedImages: true` deduplicating images. `sharedImages: false` embeds duplicate copies; `models: "none"` / `textures: "none"` / `audio: "none"` skip those passes and report uncooked bytes. Android/iOS currently skip compression and model dedupe. `assets.exclude` defaults to `[]`; source-relative globs (for example `["unused/**"]`) omit matching files and report saved bytes. `assets.budget` accepts `{ uncooked?: number | "none", total?: number | "none" }`, default `{ uncooked: 64_000_000, total: "none" }`: only bytes left uncooked where cooking was possible count toward `uncooked`. A number sets that ceiling; `"none"` disables both gates. Either disabled gate still reports bytes. Automatic texture cooking retains unaligned source images unchanged and reports `block-size`; those bytes still count toward the uncooked budget. An explicit compression codec override must satisfy four-pixel block alignment; `codec: "none"` opts out. Cooking never silently resizes an image to fix alignment.
|
|
62
|
+
Leave `assets` absent: the cook selects target-decodable passes, with `models.sharedImages: true` deduplicating images. `sharedImages: false` embeds duplicate copies; `models.compact` (default `{ flatten: true, join: true, instance: true }`) flattens the scene graph, merges primitives by material and batches a mesh shared by several nodes as `EXT_mesh_gpu_instancing` — all lossless, keeping any node matching `protectedPattern` (or named in `protectedNames`), an animation target, or a skin joint individually addressable; `compact: false` ships the scene graph as authored. `models: "none"` / `textures: "none"` / `audio: "none"` skip those passes and report uncooked bytes. Android/iOS currently skip compression and model dedupe. `assets.exclude` defaults to `[]`; source-relative globs (for example `["unused/**"]`) omit matching files and report saved bytes. `assets.budget` accepts `{ uncooked?: number | "none", total?: number | "none" }`, default `{ uncooked: 64_000_000, total: "none" }`: only bytes left uncooked where cooking was possible count toward `uncooked`. A number sets that ceiling; `"none"` disables both gates. Either disabled gate still reports bytes. Automatic texture cooking retains unaligned source images unchanged and reports `block-size`; those bytes still count toward the uncooked budget. An explicit compression codec override must satisfy four-pixel block alignment; `codec: "none"` opts out. Cooking never silently resizes an image to fix alignment.
|
|
62
63
|
|
|
63
64
|
Relative look capture: a binding with `pointerRelative: true` captures the canvas on click by default; set `captureOnClick: false` and call `ctx.input.captureMouse()` from your own gesture to opt out. Desktop mode precedence is CLI (`--windowed`, `--maximized`, `--fullscreen`) over `display.fullscreen` over `window.maximized`; with both false, `window.width`/`height` size the normal window.
|
|
64
|
-
Scenes use `load`, `enter`, `update`, `exit`, `render`; physics nodes are Godot-named and disposable; generated conventions call `GroundSnap` for floor contact and `normaliseToMetres` for authored model scale. `ctx.beforeRender(fn)` registers scene work that runs once per actual world draw, after the frame's last fixed update and before the projection packs, so `fn` reads the frame's final state; a held loader frame draws no world and dispatches nothing, and the registration clears on scene change and stop like `ctx.afterPhysics`. Automatic drawing resolution (`render.resolutionScale: "auto"` on `defineGame`) reads fresh GPU cost before presentation timing, so a host delay alone does not spend pixels while GPU headroom is observed and sustained headroom restores resolution; missing or stale GPU timing probes one rung and refunds it unless fewer pixels earn a better frame rate, oscillation holds are temporary, a numeric `resolutionScale` is the named pin override, and `TN_FRAME_BUDGET` reports the actual scale, its source, the GPU time as a mean/p50/p95/max series over resolved frames (`gpu`, with `gpuStale` counting frames that had no fresh reading and `gpu` absent rather than zero when there were none), and the draw calls and triangles each render pass submitted (main, shadow, reflection) under either policy. The engine's scene-render projection — an internal mirror that collapses repeated draws — is on by default; `render.projection: false` is the named opt-out and builds no mirror, so a game that measured it as a loss pays nothing to decline it, reported as `TN_RENDER_PROJECTION` reasonCode `disabled`. A water surface's mirrored pass redraws every frame by default; `reflection.refreshInterval: N` redraws it every Nth presented frame and samples the previous reflection target in between, which halves the pass's cost at the price of up to `N - 1` frames of lag while the camera moves.
|
|
65
|
+
Scenes use `load`, `enter`, `update`, `exit`, `render`; physics nodes are Godot-named and disposable; generated conventions call `GroundSnap` for floor contact and `normaliseToMetres` for authored model scale. `ctx.beforeRender(fn)` registers scene work that runs once per actual world draw, after the frame's last fixed update and before the projection packs, so `fn` reads the frame's final state; a held loader frame draws no world and dispatches nothing, and the registration clears on scene change and stop like `ctx.afterPhysics`. Automatic drawing resolution (`render.resolutionScale: "auto"` on `defineGame`) reads fresh GPU cost before presentation timing, so a host delay alone does not spend pixels while GPU headroom is observed and sustained headroom restores resolution; missing or stale GPU timing probes one rung and refunds it unless fewer pixels earn a better frame rate, oscillation holds are temporary, a numeric `resolutionScale` is the named pin override, and `TN_FRAME_BUDGET` reports the actual scale, its source, the GPU time as a mean/p50/p95/max series over resolved frames (`gpu`, with `gpuStale` counting frames that had no fresh reading and `gpu` absent rather than zero when there were none), and the draw calls and triangles each render pass submitted (main, shadow, reflection) under either policy. The engine's scene-render projection — an internal mirror that collapses repeated draws — is on by default; `render.projection: false` is the named opt-out and builds no mirror, so a game that measured it as a loss pays nothing to decline it, reported as `TN_RENDER_PROJECTION` reasonCode `disabled`. When the mirror draws props whose materials differ only in base colour, it proves a **bounded slice** of those materials each frame (`render.projection.materialChecks: "spread"`, the default) instead of all of them, so a base-colour edit still lands the same frame while any other material edit — a new roughness, map or define — leaves the batch and is drawn exactly up to `materialCheckStaleFrames` frames later, which `TN_RENDER_PROJECTION` reports. Name `"everyFrame"` to pay for every material every frame instead. A water surface's mirrored pass redraws every frame by default; `reflection.refreshInterval: N` redraws it every Nth presented frame and samples the previous reflection target in between, which halves the pass's cost at the price of up to `N - 1` frames of lag while the camera moves.
|
|
65
66
|
React never touches the scene graph. Native UI reads published state and sends intents; mark every touch target `data-tn-interactive`, and style `[data-tn-native-select]` / `[data-tn-native-select-option]` if the game has a `<select>`: on desktop the UI is drawn into the game's own frame with no view for a native popup to open into, so the engine renders the list in the page and the project gives it a look, the same division as `[data-threenative-debug-overlay]`. Rigged assets: put a `.glb` in `assets/`, await `ctx.assets.model("hero.glb")` in `Scene.load()`, then drive `AnimationPlayer` beside its entity.
|
|
66
67
|
`ctx.goto(name)` rebuilds without resetting game state; from a frame function `goto` and then
|
|
67
68
|
`return`; `ctx.state.set({ /* copy this game's initial-state shape */ })` is a partial patch.
|
|
@@ -73,24 +74,23 @@ rig's own bind pose, so the two rigs' bind conventions cancel and a limb rolled
|
|
|
73
74
|
tracks that bind nothing (the `<bone>.undefined` failure that plays the bind pose instead of the animation), `clipBoneCoverage` names bones the clip does not drive and which
|
|
74
75
|
therefore keep the previous clip's pose, and `boneContact` reports in metres whether a named bone reaches the prop it is supposed to be touching. Two loading conventions come from `@threenative/core`, not from your own loops: `loadAll(items, load)` fetches six at a time and returns results **in the input's order** (a pool that pushes returns completion order, so a positional pick lands a different asset every load), and `addInSlices(objects, (object) => ctx.add(object))` attaches 256 per presented frame so hundreds of objects never land in one long frame; override `concurrency`/`sliceSize`, pass `while: () => alive` to stop a torn-down scene without throwing, and `marker: false` silences `TN_LOAD_ALL`/`TN_ADD_SLICES` but never the measurement.
|
|
75
76
|
|
|
76
|
-
##
|
|
77
|
-
`src/render/
|
|
78
|
-
|
|
79
|
-
`Play.enter` attaches Preview immediately, then the classic Worker refinement swaps atomically; do not add a main-thread showcase fallback.
|
|
77
|
+
## The arena is a test arena, and its look is a grid
|
|
78
|
+
`src/render/arena.ts` owns the ground, the four walls, one pillar, and `platform()`, the single builder both ends of the course are cut from. A platform is a light metre-grid plate over a dark-grid body down to the ground: two meshes, so the player collides with exactly the triangles they can see, and the sides read as structure while the walking surface reads as floor. The ground has no collider — that is the pit under the gap, and why falling costs a life instead of landing on scenery. Move a platform and move its support surface in `Play.ts` and `Goal.ts` with it, or grounding will answer for a surface that is no longer there.
|
|
79
|
+
`materials.ts` is the whole look: two greys and one saturated colour. Light grid where the player walks, dark grid on sides and structure, and the single `accent` hue reserved for the crate, the pickup and the flagpole — what you can touch. `worldGridUVs` makes one grid tile one metre on every face of every prop, so call it after a geometry is placed and before it is given to a mesh.
|
|
80
80
|
|
|
81
81
|
## Quality and proof
|
|
82
82
|
|
|
83
83
|
`src/render/quality.ts` owns `low`, `medium`, `high`; platform selects the boot tier, and `adaptiveQuality.ts` reads `game.ts` frame windows. Fresh GPU time wins, with a named presentation fallback. After startup, two overloaded windows lower quality; five with 20% headroom raise it; cooldown is five seconds. Presentation fallback allows 5% timing jitter (`presentationTolerance`); `overloadBudgetMs` reports its threshold. Vsync-bound presentation alone cannot prove recovery headroom.
|
|
84
84
|
`setupPost` exposes policy options and `targetFps`; `Play` supplies `display.maxFps` and readiness. Pin `{ tier: "low" }`; invalid tiers throw and pinned costs report. The `quality` entity and `TN_QUALITY_TIER` expose decisions; dispose on scene exit.
|
|
85
|
-
The
|
|
85
|
+
The shipped chain is ambient occlusion on `high` and `medium`, bloom, vignette, the tone curve and the shared SMAA. There are no authored paint stages: a real sun and a real sky carry the shading, and a Kuwahara smear or an ink outline over a photograph only cost frames. `quality.ts` owns tier and strength, and every `xxxEnabled: true` carries the measurement that justified it; `TN_RENDER_CHAIN` names each stage independently, and a missing stage observation is a failure.
|
|
86
86
|
`input.vector("move").y` is +up, so forward uses one explicit `-move.y` conversion. A scenario with no assertions or missing observations fails; open a real capture after visual changes. When a frame costs more than it should, find the object first: backtick opens the overlay, whose **Geometry** tab captures one frame on **Capture** and ranks the objects that submitted its triangles beside their projected size on screen; an agent gets the same report from `"assert": { "geometry": { "limit": 25 } }` in a scenario, which needs `runtime.geometry`. Those numbers are measured submissions reconciled against the frame's own pass totals, so the remainder the rows do not account for is reported, and what cannot be measured — a packed batch's per-member draws, unknown bounds — says so with a reason instead of reading as zero.
|
|
87
87
|
|
|
88
88
|
## One shadow for a big outdoor level
|
|
89
89
|
When one directional light must shadow a whole valley and a 2048² map smudges, set `sun.shadow.shadowNode = new VirtualShadowNode(sun, { clipExtents: [12, 40, 120] })` from `@threenative/core`: camera-centred, texel-snapped clip levels, cached until the window moves and shared through Three's shadow slot. Bias, normal bias, intensity, radius, blur samples, map type and filter stay on `sun.shadow`; map sizes come from the options. For movers call `trackCaster(object)` — tracking or untracking refreshes the cached levels once, then movement draws a per-level mover map every frame without invalidating them; call `invalidateAll()` when static geometry changes. `TN_VIRTUAL_SHADOW` reports rendered, mover-map and cached-level work.
|
|
90
90
|
|
|
91
|
-
## Budget real time for the look — see `agent-docs/dream-loop.md`
|
|
91
|
+
## Budget real time for the look — see `node_modules/create-threenative/agent-docs/references/dream-loop.md`
|
|
92
92
|
|
|
93
|
-
The performance skill carries `TN_FRAME_BUDGET`, platform targets, and the `display.maxFps` rule. The engine warns you before a human does: `TN_SCENE_WARNING` fires when the GPU used under a third of the frame while the JS render phase ran longer than the display's own period, and names the census behind it — objects considered, draws per pass, triangles per draw, shadow-exempt casters. It is a scene-shape verdict, so answer it by moving the draw and object counts, not the engine: read the bucket census before promising a merge. `npx threenative doctor` repeats the last verdict and the `DEV_MODE=true` chip shows it
|
|
94
|
-
|
|
93
|
+
The performance skill carries `TN_FRAME_BUDGET`, platform targets, and the `display.maxFps` rule. The engine warns you before a human does: `TN_SCENE_WARNING` fires when the GPU used under a third of the frame while the JS render phase ran longer than the display's own period, and names the census behind it — objects considered, draws per pass, triangles per draw, shadow-exempt casters. It is a scene-shape verdict, so answer it by moving the draw and object counts, not the engine: read the bucket census before promising a merge. `npx threenative doctor` repeats the last verdict and the `DEV_MODE=true` chip shows it on screen (it draws the verdict alone — no frame rate, which reads throttled under a compositor or a virtual display; see `agent-docs/references/performance-basics.md`); `TN_FRAME_SPANS=1` adds the render phase's own span tree when you need to know which part costs the milliseconds. The cheapest static object is one whose transform you never write: measured on 1,561 objects, leaving them alone costs 10.10 ms of render phase against 17.45 ms when the game rewrites every transform each frame, because three skips the per-object binding update when nothing changed. So do not touch a transform you do not need to — that is worth ~7 ms where `markStatic(root)`, which additionally composes a never-moving subtree once, measured 0.009 ms. Use it for scenery you are sure of, and `invalidateStatic(object)` to announce a write inside one; it deletes matrix arithmetic, not the walk. `TN_RENDERLIST_VALIDATE=1` recomputes every world matrix the long way each frame and throws on the first that disagrees, which is how you prove a freeze did not leave something stale on screen.
|
|
94
|
+
Recipes in the installed create-threenative: `node_modules/create-threenative/agent-docs/references/assertion-reference.md`, `node_modules/create-threenative/agent-docs/references/build-profiles.md`, `node_modules/create-threenative/agent-docs/references/capability-reference.md`, `node_modules/create-threenative/agent-docs/references/capture-the-frame.md`, `node_modules/create-threenative/agent-docs/references/creating-creatures.md`, `node_modules/create-threenative/agent-docs/references/ctx-cookbook.md`, `node_modules/create-threenative/agent-docs/references/debug-surface.md`, `node_modules/create-threenative/agent-docs/references/finding-assets.md`, `node_modules/create-threenative/agent-docs/references/gameplay-recipes.md`, `node_modules/create-threenative/agent-docs/references/menu-screens.md`, `node_modules/create-threenative/agent-docs/references/mobile-memory-budget.md`, `node_modules/create-threenative/agent-docs/references/performance-basics.md`, `node_modules/create-threenative/agent-docs/references/rigging-characters.md`, `node_modules/create-threenative/agent-docs/references/sculpt-from-a-reference.md`, `node_modules/create-threenative/agent-docs/references/trace-a-slow-frame.md`, `node_modules/create-threenative/agent-docs/references/visual-baseline.md`, and `node_modules/create-threenative/agent-docs/references/webview-ui.md`.
|
|
95
95
|
## Optional multiplayer transport
|
|
96
96
|
For online play only, import `connect` from `@threenative/core/net` with an HTTPS URL and nonempty identity credential; configure `connectTimeoutMs`, `maxReliableMessageBytes`, `maxQueuedReliableBytes`, and `maxQueuedDatagrams` (10s/65,536/1 MiB/256), use `reliable-ordered` for ordered reliable messages and bounded `unreliable` datagrams that may drop, and keep serialization, replication, prediction, interpolation, snapshots and rejoin in this game's `src/` and server. There is no fallback: unsupported WebTransport/native rejects with `TN_NET_UNAVAILABLE`; reference Go server: `packages/runtime-native/examples/webtransport/server`.
|