create-threenative 0.2.5 → 0.2.7
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 +25 -3
- package/agent-docs/references/assertion-reference.md +40 -1
- package/agent-docs/references/build-profiles.md +126 -0
- package/agent-docs/references/capability-reference.md +1382 -65
- package/agent-docs/references/finding-assets.md +8 -1
- package/agent-docs/references/performance-basics.md +117 -0
- package/agent-docs/references/rigging-characters.md +51 -0
- 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-docs/references/webview-ui.md +3 -2
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
- package/agent-files/.agents/skills/ponytail/SKILL.md +68 -0
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +12 -4
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-context/SKILL.md +9 -1
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +26 -10
- 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/agent-files/.claude/hooks/ponytail-context.mjs +51 -0
- package/agent-files/.claude/settings.json +38 -0
- package/agent-files/.codex/hooks.json +40 -0
- package/capabilities.json +1891 -101
- package/dist/index.d.ts +39 -1
- package/dist/index.js +480 -56
- package/dist/threenative.js +1247 -177
- 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 +2228 -105
- package/template-assets/worldEnvironment.ts +52 -1
- package/templates/action-rpg/AGENTS.md +43 -43
- package/templates/action-rpg/CLAUDE.md +43 -43
- package/templates/action-rpg/kit.json +1 -1
- package/templates/action-rpg/package.json +14 -8
- 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 +12 -12
- package/templates/minimal/CLAUDE.md +12 -12
- package/templates/minimal/package.json +13 -7
- 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 +15 -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 +14 -10
- 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 +21 -22
- package/templates/puzzle/CLAUDE.md +21 -22
- 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 +14 -8
- 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 +20 -21
- package/templates/racing/CLAUDE.md +20 -21
- package/templates/racing/package.json +14 -8
- 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/rts/AGENTS.md +96 -0
- package/templates/rts/CLAUDE.md +98 -0
- package/templates/rts/kit.json +7 -0
- package/templates/{defense → rts}/package.json +14 -8
- package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
- 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/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/{defense → rts}/src/render/postprocessing.ts +15 -3
- 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/{defense → rts}/src/render/worldEnvironment.ts +52 -1
- 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 +8 -12
- package/templates/runner/CLAUDE.md +8 -12
- package/templates/runner/README.md +3 -3
- package/templates/runner/package.json +14 -8
- 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 +14 -14
- package/templates/sailing/CLAUDE.md +14 -14
- package/templates/sailing/assets/ship.glb +0 -0
- package/templates/sailing/package.json +14 -8
- 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 +29 -44
- package/templates/shooter/CLAUDE.md +29 -44
- package/templates/shooter/index.html +1 -0
- package/templates/shooter/package.json +14 -8
- 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/starter/AGENTS.md +20 -20
- package/templates/starter/CLAUDE.md +20 -20
- package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
- package/templates/starter/package.json +15 -9
- package/templates/starter/playtests/play.playtest.json +2 -1
- package/templates/starter/playtests/{restart.playtest.json → production-readiness.playtest.json} +17 -12
- 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/src/ui/Hud.tsx +2 -2
- package/templates/starter/src/ui/Menu.tsx +5 -1
- 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 +16 -14
- package/templates/{defense → tower-defense}/CLAUDE.md +16 -14
- 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/prd-creator/SKILL.md +0 -40
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -45
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
- package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -57
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -42
- 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/playtests/survives.playtest.json +0 -36
- 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/quality.ts +0 -170
- package/templates/defense/src/render/shapes.ts +0 -246
- package/templates/defense/src/render/sky.ts +0 -45
- package/templates/defense/src/scenes/Boot.ts +0 -12
- 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/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 → rts}/.codex/config.toml +0 -0
- /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
- /package/templates/{defense → rts}/.gemini/settings.json +0 -0
- /package/templates/{defense → rts}/.mcp.json +0 -0
- /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
- /package/templates/{defense → rts}/.zed/settings.json +0 -0
- /package/templates/{defense → rts}/index.html +0 -0
- /package/templates/{defense → rts}/opencode.json +0 -0
- /package/templates/{defense → rts}/src/main.ts +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
|
@@ -1,51 +1,42 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
//
|
|
3
|
+
// The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
|
|
4
|
+
// by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
|
|
5
|
+
// The same image is the background, the environment light every surface reflects and is filled by,
|
|
6
|
+
// and — through `SUN_DIRECTION` — the direction the sun's shadows fall. Swap the file for any
|
|
7
|
+
// equirectangular sky and re-aim `SUN_DIRECTION` at its sun.
|
|
1
8
|
import {
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
Fog,
|
|
6
|
-
MathUtils,
|
|
7
|
-
Mesh,
|
|
8
|
-
MeshBasicMaterial,
|
|
9
|
+
EquirectangularReflectionMapping,
|
|
10
|
+
FogExp2,
|
|
11
|
+
SRGBColorSpace,
|
|
9
12
|
type Scene,
|
|
10
|
-
|
|
13
|
+
type Texture,
|
|
14
|
+
Vector3,
|
|
11
15
|
} from "three";
|
|
12
16
|
import { palette } from "./palette.js";
|
|
13
17
|
|
|
14
18
|
/**
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
18
|
-
* are travelling forward rather than the track sliding underneath them. Warm at the bottom, deep
|
|
19
|
-
* at the top, and the fog is tuned to hand the far chunks over to it rather than to a grey wash.
|
|
19
|
+
* How the JPEG was made from the 4k HDR: linear radiance × 0.4, clipped, sRGB-encoded — so white
|
|
20
|
+
* in the file is 2.5 in the sky. Multiplying back restores the HDR brightness of the clouds; the sun
|
|
21
|
+
* disk itself is clipped, which is why the sun is a light (`lighting.ts`) and not a texel.
|
|
20
22
|
*/
|
|
21
|
-
|
|
22
|
-
const top = new Color(palette.skyHigh);
|
|
23
|
-
const bottom = new Color(palette.skyLow);
|
|
24
|
-
scene.background = top;
|
|
25
|
-
// Far, on purpose. A near fog plane turned the whole track into the horizon's orange and
|
|
26
|
-
// left nothing on screen that was not sky.
|
|
27
|
-
scene.fog = new Fog(palette.skyHigh, 90, 260);
|
|
23
|
+
const SKY_RANGE = 2.5;
|
|
28
24
|
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
const positions = geometry.getAttribute("position");
|
|
32
|
-
const colors = new Float32Array(positions.count * 3);
|
|
33
|
-
const color = new Color();
|
|
34
|
-
for (let index = 0; index < positions.count; index += 1) {
|
|
35
|
-
// The warm band is confined to just above the horizon. Spread across the whole dome it
|
|
36
|
-
// filled four-fifths of the frame with one saturated orange.
|
|
37
|
-
const height = MathUtils.clamp((positions.getY(index) / radius + 0.01) / 0.1, 0, 1);
|
|
38
|
-
color.copy(bottom).lerp(top, height);
|
|
39
|
-
colors.set([color.r, color.g, color.b], index * 3);
|
|
40
|
-
}
|
|
41
|
-
geometry.setAttribute("color", new BufferAttribute(colors, 3));
|
|
25
|
+
/** Unit vector toward the photographed sun: 47.9° up, measured from the source HDR. */
|
|
26
|
+
export const SUN_DIRECTION = new Vector3(0.555, 0.742, 0.38).normalize();
|
|
42
27
|
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
)
|
|
49
|
-
|
|
50
|
-
|
|
28
|
+
export function setupSky(scene: Scene, sky: Texture): void {
|
|
29
|
+
sky.mapping = EquirectangularReflectionMapping;
|
|
30
|
+
sky.colorSpace = SRGBColorSpace;
|
|
31
|
+
scene.background = sky;
|
|
32
|
+
scene.backgroundIntensity = SKY_RANGE;
|
|
33
|
+
// three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
|
|
34
|
+
// It is what makes a standard material read as a material: sky-blue fill on faces the sun
|
|
35
|
+
// misses, and a sky to reflect, sharper as roughness drops.
|
|
36
|
+
scene.environment = sky;
|
|
37
|
+
scene.environmentIntensity = SKY_RANGE;
|
|
38
|
+
// The track runs to a hundred-odd metres of fog, and the ground goes into the photograph by a
|
|
39
|
+
// kilometre, so the far chunks hand over to the sky rather than ending at a line. The colour is
|
|
40
|
+
// the photograph's own horizon, so the fade lands where the sky is.
|
|
41
|
+
scene.fog = new FogExp2(palette.horizon, 0.003);
|
|
51
42
|
}
|
|
@@ -84,7 +84,7 @@ export class TouchControls {
|
|
|
84
84
|
|
|
85
85
|
constructor(camera: PerspectiveCamera) {
|
|
86
86
|
this.#camera = camera;
|
|
87
|
-
this.#idleMaterial = overlayMaterial(palette.
|
|
87
|
+
this.#idleMaterial = overlayMaterial(palette.structure, 0.35);
|
|
88
88
|
this.#activeMaterial = overlayMaterial(palette.accent, 0.6);
|
|
89
89
|
this.#moveBase = ringMesh(MOVE_RADIUS, this.#idleMaterial);
|
|
90
90
|
this.#moveKnob = new Mesh(new CircleGeometry(28, 24), this.#activeMaterial);
|
|
@@ -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,
|
|
@@ -8,8 +8,8 @@ import {
|
|
|
8
8
|
isMobile,
|
|
9
9
|
isTouchscreenAvailable,
|
|
10
10
|
} from "@threenative/core";
|
|
11
|
-
import { type PerspectiveCamera, Vector3 } from "three";
|
|
12
|
-
import { Runner } from "../entities/Runner.js";
|
|
11
|
+
import { type PerspectiveCamera, type Texture, Vector3 } from "three";
|
|
12
|
+
import { type IRunnerModel, Runner } from "../entities/Runner.js";
|
|
13
13
|
import type { RunnerPhysics } from "../physics.js";
|
|
14
14
|
import { chaseRunner, setupCamera } from "../render/camera.js";
|
|
15
15
|
import { createDustTrail } from "../render/dust.js";
|
|
@@ -31,12 +31,32 @@ const ACCELERATION = 0.25;
|
|
|
31
31
|
export class Run extends Scene<GameState, RunnerPhysics> {
|
|
32
32
|
static override readonly initialState = INITIAL_STATE;
|
|
33
33
|
|
|
34
|
+
#model: IRunnerModel | undefined;
|
|
35
|
+
#sky: Texture | undefined;
|
|
36
|
+
|
|
37
|
+
override async load(ctx: GameCtx): Promise<void> {
|
|
38
|
+
[this.#model, this.#sky] = await Promise.all([
|
|
39
|
+
ctx.assets.model<IRunnerModel>("mannequin.glb"),
|
|
40
|
+
ctx.assets.texture("sky.jpg"),
|
|
41
|
+
]);
|
|
42
|
+
}
|
|
43
|
+
|
|
34
44
|
override enter(ctx: GameCtx): SceneFrame<GameState, RunnerPhysics> {
|
|
35
|
-
|
|
36
|
-
|
|
45
|
+
if (this.#model === undefined || this.#sky === undefined)
|
|
46
|
+
throw new Error("Run.enter ran before load() loaded mannequin.glb and sky.jpg.");
|
|
47
|
+
setupSky(ctx.scene, this.#sky);
|
|
48
|
+
const { key } = setupLighting(
|
|
49
|
+
ctx.scene,
|
|
50
|
+
ctx.renderer.raw as Parameters<typeof setupLighting>[1],
|
|
51
|
+
isMobile(),
|
|
52
|
+
);
|
|
37
53
|
// isMobile() arrives as an argument because src/render/ imports no framework package: the
|
|
38
54
|
// platform decision is made here, in portable game code.
|
|
39
|
-
setupPost(ctx.renderer, ctx.scene, ctx.camera, {
|
|
55
|
+
setupPost(ctx.renderer, ctx.scene, ctx.camera, {
|
|
56
|
+
godraysLight: key,
|
|
57
|
+
mobile: isMobile(),
|
|
58
|
+
software: ctx.renderer.softwareAdapter !== undefined,
|
|
59
|
+
});
|
|
40
60
|
const camera = ctx.camera as PerspectiveCamera;
|
|
41
61
|
setupCamera(camera);
|
|
42
62
|
ctx.add(camera);
|
|
@@ -55,7 +75,7 @@ export class Run extends Scene<GameState, RunnerPhysics> {
|
|
|
55
75
|
random: () => ctx.random(),
|
|
56
76
|
};
|
|
57
77
|
const track = new Track(chunkContext);
|
|
58
|
-
const runner = new Runner(ctx);
|
|
78
|
+
const runner = new Runner(ctx, this.#model);
|
|
59
79
|
ctx.entities.add("player", runner);
|
|
60
80
|
|
|
61
81
|
const dust = ctx.add(new GPUParticles3D(createDustTrail()));
|
|
@@ -11,6 +11,7 @@ import { OBSTACLE_LAYER, type RunnerPhysics } from "./physics.js";
|
|
|
11
11
|
import {
|
|
12
12
|
LANE_WIDTH,
|
|
13
13
|
OBSTACLE_SIZE,
|
|
14
|
+
ground,
|
|
14
15
|
obstacleShape,
|
|
15
16
|
trackRails,
|
|
16
17
|
trackSlab,
|
|
@@ -63,7 +64,7 @@ export class Chunk {
|
|
|
63
64
|
material: MeshStandardMaterial,
|
|
64
65
|
) {
|
|
65
66
|
this.group.name = `chunk-${index}`;
|
|
66
|
-
this.group.add(
|
|
67
|
+
this.group.add(trackRails(CHUNK_LENGTH), trackSlab(CHUNK_LENGTH));
|
|
67
68
|
const batch = new InstancedBatch({ geometry, material });
|
|
68
69
|
for (let slot = 0; slot < MAX_OBSTACLES; slot += 1) batch.place({ position: [0, -1000, 0] });
|
|
69
70
|
this.#obstacles = batch.build({ castShadow: true, name: "obstacles", parent: this.group });
|
|
@@ -135,6 +136,9 @@ export class Chunk {
|
|
|
135
136
|
* rewrites it. The obstacle geometry and material are created here, once, and shared by every
|
|
136
137
|
* chunk: they are the same box and the same surface every time, and building them per chunk was
|
|
137
138
|
* both an allocation and — with no `dispose` — a leak.
|
|
139
|
+
*
|
|
140
|
+
* The ground the track runs over is added here too, under the whole stream, so the horizon reads
|
|
141
|
+
* as ground meeting sky rather than a road over a void.
|
|
138
142
|
*/
|
|
139
143
|
export class Track {
|
|
140
144
|
readonly chunks: Chunk[] = [];
|
|
@@ -143,6 +147,7 @@ export class Track {
|
|
|
143
147
|
#built = 0;
|
|
144
148
|
|
|
145
149
|
constructor(ctx: IChunkContext) {
|
|
150
|
+
ctx.add(ground());
|
|
146
151
|
const shape = obstacleShape();
|
|
147
152
|
this.#geometry = shape.geometry;
|
|
148
153
|
this.#material = shape.material;
|
|
@@ -13,7 +13,9 @@ const config: IThreeNativeConfig = {
|
|
|
13
13
|
orientation: "landscape",
|
|
14
14
|
fullscreen: true,
|
|
15
15
|
keepScreenOn: true,
|
|
16
|
-
maxFps
|
|
16
|
+
// No `maxFps`: the engine targets the display's own refresh rate, capped at 120 on desktop
|
|
17
|
+
// and web and 60 on mobile, and reports the resolved value in every `TN_FRAME_BUDGET` window.
|
|
18
|
+
// Set a number to override it, or 0 to remove the ceiling.
|
|
17
19
|
},
|
|
18
20
|
window: {
|
|
19
21
|
title: "__PROJECT_NAME__",
|
|
@@ -44,6 +46,17 @@ const config: IThreeNativeConfig = {
|
|
|
44
46
|
// Switch to "native" for a UI drawn as part of the rendered frame, with no web view and no
|
|
45
47
|
// extra process — and own the appearance difference that comes with it.
|
|
46
48
|
ui: { renderer: "web" },
|
|
49
|
+
// One asset tree, one compiler, one representation per artifact. Uncomment, then cook:
|
|
50
|
+
// threenative build --target android # cooks defaults.android; --profile <name> beats it
|
|
51
|
+
// buildProfiles: {
|
|
52
|
+
// defaults: { android: "compact" },
|
|
53
|
+
// profiles: {
|
|
54
|
+
// compact: {
|
|
55
|
+
// assets: { textures: { maxSize: 1024 }, models: { textures: { maxSize: 1024 } } },
|
|
56
|
+
// } },
|
|
57
|
+
// },
|
|
58
|
+
// Contract, byte definitions, the build report:
|
|
59
|
+
// node_modules/create-threenative/agent-docs/references/build-profiles.md
|
|
47
60
|
};
|
|
48
61
|
|
|
49
62
|
export default config;
|
|
@@ -14,9 +14,12 @@ function assetsWatchPlugin(): Plugin {
|
|
|
14
14
|
return {
|
|
15
15
|
name: "threenative-assets-watch",
|
|
16
16
|
apply: "serve",
|
|
17
|
-
configureServer(server) {
|
|
17
|
+
async configureServer(server) {
|
|
18
18
|
const handle = watchAssets({ config: config.assets, cwd: server.config.root });
|
|
19
19
|
server.httpServer?.once("close", () => handle.close());
|
|
20
|
+
// Nothing is served before the first cook settles: until it does, `public/` has no
|
|
21
|
+
// `assets.manifest.json` and every asset answers from its source fallback.
|
|
22
|
+
await handle.ready;
|
|
20
23
|
},
|
|
21
24
|
};
|
|
22
25
|
}
|
|
@@ -5,13 +5,13 @@ 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 ship handling, the sea's look and tuning, `Buoyancy3D`, course order, HUD,
|
|
8
|
-
water, and look; `src/game.ts` is portable and React mounts from `src/main.ts`.
|
|
8
|
+
water, and look; `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.
|
|
9
9
|
|
|
10
10
|
## Start every change
|
|
11
11
|
|
|
12
12
|
1. **Critical planning gate:** invoke `threenative-capabilities` before `prd-creator`. Search
|
|
13
13
|
`engine_search_capabilities` for the full request and each concrete mechanic, inspect relevant
|
|
14
|
-
matches with `engine_capability_detail`, and record a capability or no-match for the plan.
|
|
14
|
+
matches with `engine_capability_detail`, and record a capability or no-match for the plan. Apply the `ponytail` ladder before writing code; never hand-write what the capability search already installs.
|
|
15
15
|
2. Then invoke `prd-creator`. Draft the plan around those capabilities and binding constraints,
|
|
16
16
|
direct the user to review it, and wait for explicit approval plus an instruction to implement it.
|
|
17
17
|
3. Treat returned constraints as binding. `@threenative/physics/navigation` is browser-only WASM;
|
|
@@ -37,7 +37,7 @@ bridge; avoid DOM globals, dynamic `import()`, and raw physics handles. **Report
|
|
|
37
37
|
- `.agents/skills/threenative-performance/SKILL.md` / `.claude/skills/threenative-performance/SKILL.md` — measured budgets.
|
|
38
38
|
- `.agents/skills/threenative-ui/SKILL.md` / `.claude/skills/threenative-ui/SKILL.md` — native-safe UI.
|
|
39
39
|
- `.agents/skills/threenative-context/SKILL.md` / `.claude/skills/threenative-context/SKILL.md` — portable ctx APIs.
|
|
40
|
-
- Confirmed framework bugs: use `file-engine-bug` in `.agents/skills/` or `.claude/skills/` after a minimal repro.
|
|
40
|
+
- 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.
|
|
41
41
|
|
|
42
42
|
## Commands and map
|
|
43
43
|
|
|
@@ -48,22 +48,22 @@ pnpm build --target desktop
|
|
|
48
48
|
pnpm test:native
|
|
49
49
|
```
|
|
50
50
|
|
|
51
|
-
`Ship.ts` uses `RigidBody3D` plus `Buoyancy3D
|
|
51
|
+
Four course marks around the headland, a helm and a set of sheets, 120 seconds of wind. The hull and rig are `assets/ship.glb` — Poly Haven's `dutch_ship_medium` (CC0; James Ray Cock, Rico Cilliers, Nicolò Zubbini) — fetched by `Boot.load()` (`props.ts#loadShipModel`, alongside the sky) and read back synchronously in `Sailing.enter()` (`props.ts#getShipModel`), then oriented by `props.ts#createShipModel`: a scene-level `load()` on `Sailing` itself would still leave the registry empty the instant `enter()` returns, since `Boot.enter()` calls `goto("sailing")` without awaiting it. `conventions.ts#measureHull` reads the physics body's box and `Buoyancy3D` hull points off the loaded model rather than a hand-tuned constant, so a different hull model never needs those numbers touched by hand. `SHIP_SAILS` in `props.ts` stays simulated cloth: the GLB's own baked sail mesh is stripped at cook time so the two never double up. `Ship.ts` uses `RigidBody3D` plus `Buoyancy3D`, and reads the hull's attitude off four swell samples rotated by the heading rather than leaving it to the solver: `Buoyancy3D`'s drag comes from the body's *linear* velocity and so damps no rotation at all, and a free body capsizes inside seconds. A helm and sheets are two axes, not one stick: `vector("move")` clamps its diagonal to unit length, which is right for a thumb and wrong for a ship that must hold full sail and hard over at once.
|
|
52
52
|
|
|
53
|
-
The sea is `SpectralOcean`, added with `ctx.add` so the compute registry runs its passes. It draws nothing: `src/render/ocean.ts` owns the mesh, the material and every colour, and is the only file to edit for the water's look. The cascade buffers the vertex stage reads are the ones the CPU height query is copied from
|
|
53
|
+
The sea is `SpectralOcean`, added with `ctx.add` so the compute registry runs its passes. It draws nothing: `src/render/ocean.ts` owns the mesh, the material, the mirror and every colour, and is the only file to edit for the water's look. The cascade buffers the vertex stage reads are the ones the CPU height query is copied from, so the hull floats on the surface that is drawn; two fields would leave the ship riding water nothing renders, with every assertion here still green.
|
|
54
54
|
|
|
55
|
-
|
|
55
|
+
Five details are load-bearing. The material is `MeshStandardNodeMaterial`, not a basic one: a basic material takes no lights, so the sun on the water has to be faked with a `pow()` term, and the sea cannot agree with the hull floating on it. `normalNode` overrides `normalView`, so feed it a view-space normal or the reflection becomes a column of glare that follows the camera. The surface is a **logarithmic disc** centred on the ship, the cascade lookup adding the disc's own offset back: a square patch either ends inside the haze as a visible rectangular hem, or reaches the horizon with 300 m quads beside the hull. The ripple normals fade on the **pixel footprint** (`dFdx`/`dFdy` of the world position) and the slope they lose is spent as roughness, or every sea past 130 m is a mirror. And the CPU height is a coarse throttled copy: `readbackResolution` over the largest `patchSize` is the spacing between samples, and make that spacing wider than the waves and the ship sits at a smoothed mean sea level, hanging over its own troughs. It is also `undefined` until the first copy lands, which `Ship.ts` handles by falling back to mean sea level, and `surfaceHeight(ocean, x, z, dt)` is the call anything that floats should use rather than `sampleHeight` raw: it samples upwind by however far the swell will have run during the copy's age, so a hull is not left riding water the renderer stopped drawing. `WaveField.sample(x, z, time)` returns height and normal and allocates; `heightAt(x, z, time)` is the same arithmetic without the jacobian and without an allocation — ask it for floats, splash and wake, and keep `sample` where you shade with the normal. `RippleField` is the sea answering back: a finite patch carrying only the disturbance, so add its `heightAt` to the sea height and its `foamAt` to the foam and never use it in place of a sea. It steps at display rate or the CFL limit, whichever is smaller; `speed`, `damping`, `foamHalfLife`, `current`, `step` and `maxSteps` override that, and a `step` over the limit is rejected with the limit in the message. Its rim absorbs, so `recenter` it on whatever the player is watching.
|
|
56
56
|
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
`playtests/survives.playtest.json` as smoke proof and native scenarios honest.
|
|
57
|
+
The sky is `assets/sky.jpg` (Poly Haven, CC0), fetched in `Boot.load` beside the ship — a scene's `load` is the one method allowed to await, and `Sailing.enter` must stay synchronous, because a playtest runner reads the registry the instant `enter()` returns. `sky.ts` draws it at `SKY_RANGE` and lights the scene at `FILL_RANGE`, and those are different numbers on purpose: half that photograph is a flat grey placeholder where a panorama's lower hemisphere should be, and at full range it becomes the largest term in every surface's light budget. Reflection is one half-res `WaterSurface3D` pass, with `markReflected` naming what the mirror may draw — it is a second draw of the world, so the sea stays off it, the sky arrives in the same texture, and there is no second sky lookup to blend against it.
|
|
58
|
+
|
|
59
|
+
Tune the sea state in `src/render/ocean.ts`, the rig and hull in `src/render/props.ts` and `src/entities/Ship.ts`, and the course in `src/scenes/Sailing.ts`. The React HUD reads published state; keep `playtests/survives.playtest.json` as smoke proof and native scenarios honest.
|
|
60
60
|
|
|
61
61
|
On a touch-primary device (`isMobile() && isTouchscreenAvailable()`), `src/render/touch-controls.ts`
|
|
62
|
-
adds a left
|
|
62
|
+
adds a left stick whose vector `Sailing` adds into both the helm and the sheets; keyboard is the fallback.
|
|
63
63
|
|
|
64
64
|
## Portable authoring contracts
|
|
65
65
|
|
|
66
|
-
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.
|
|
66
|
+
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.
|
|
67
67
|
|
|
68
68
|
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.
|
|
69
69
|
Scenes use `load`, `enter`, `update`, `exit`, `render`; physics nodes are Godot-named and disposable. Generated conventions call `normaliseToMetres` for authored ship scale; buoyancy owns water contact.
|
|
@@ -86,10 +86,10 @@ clip's pose, and `boneContact` reports in metres whether a named bone reaches th
|
|
|
86
86
|
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.
|
|
87
87
|
## Budget real time for the look
|
|
88
88
|
|
|
89
|
-
Reference-driven authoring starts at `agent-docs/dream-loop.md`.
|
|
89
|
+
Reference-driven authoring starts at `node_modules/create-threenative/agent-docs/references/dream-loop.md`.
|
|
90
90
|
|
|
91
|
-
Open a capture after visual changes. A scenario with no assertions or missing observations fails.
|
|
91
|
+
Open a capture after visual changes. A scenario with no assertions or missing observations fails. 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.
|
|
92
92
|
|
|
93
|
-
Recipes
|
|
93
|
+
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`.
|
|
94
94
|
## Optional multiplayer transport
|
|
95
95
|
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`.
|
|
@@ -7,13 +7,13 @@ Instructions for the AI agent in this game. `CLAUDE.md` mirrors this file; edit
|
|
|
7
7
|
## Ownership
|
|
8
8
|
|
|
9
9
|
ThreeNative owns bootstrap, renderer, fixed-step loop, input, loading, physics bindings, and the state bridge. This repository owns ship handling, the sea's look and tuning, `Buoyancy3D`, course order, HUD,
|
|
10
|
-
water, and look; `src/game.ts` is portable and React mounts from `src/main.ts`.
|
|
10
|
+
water, and look; `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.
|
|
11
11
|
|
|
12
12
|
## Start every change
|
|
13
13
|
|
|
14
14
|
1. **Critical planning gate:** invoke `threenative-capabilities` before `prd-creator`. Search
|
|
15
15
|
`engine_search_capabilities` for the full request and each concrete mechanic, inspect relevant
|
|
16
|
-
matches with `engine_capability_detail`, and record a capability or no-match for the plan.
|
|
16
|
+
matches with `engine_capability_detail`, and record a capability or no-match for the plan. Apply the `ponytail` ladder before writing code; never hand-write what the capability search already installs.
|
|
17
17
|
2. Then invoke `prd-creator`. Draft the plan around those capabilities and binding constraints,
|
|
18
18
|
direct the user to review it, and wait for explicit approval plus an instruction to implement it.
|
|
19
19
|
3. Treat returned constraints as binding. `@threenative/physics/navigation` is browser-only WASM;
|
|
@@ -39,7 +39,7 @@ bridge; avoid DOM globals, dynamic `import()`, and raw physics handles. **Report
|
|
|
39
39
|
- `.agents/skills/threenative-performance/SKILL.md` / `.claude/skills/threenative-performance/SKILL.md` — measured budgets.
|
|
40
40
|
- `.agents/skills/threenative-ui/SKILL.md` / `.claude/skills/threenative-ui/SKILL.md` — native-safe UI.
|
|
41
41
|
- `.agents/skills/threenative-context/SKILL.md` / `.claude/skills/threenative-context/SKILL.md` — portable ctx APIs.
|
|
42
|
-
- Confirmed framework bugs: use `file-engine-bug` in `.agents/skills/` or `.claude/skills/` after a minimal repro.
|
|
42
|
+
- 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.
|
|
43
43
|
|
|
44
44
|
## Commands and map
|
|
45
45
|
|
|
@@ -50,22 +50,22 @@ pnpm build --target desktop
|
|
|
50
50
|
pnpm test:native
|
|
51
51
|
```
|
|
52
52
|
|
|
53
|
-
`Ship.ts` uses `RigidBody3D` plus `Buoyancy3D
|
|
53
|
+
Four course marks around the headland, a helm and a set of sheets, 120 seconds of wind. The hull and rig are `assets/ship.glb` — Poly Haven's `dutch_ship_medium` (CC0; James Ray Cock, Rico Cilliers, Nicolò Zubbini) — fetched by `Boot.load()` (`props.ts#loadShipModel`, alongside the sky) and read back synchronously in `Sailing.enter()` (`props.ts#getShipModel`), then oriented by `props.ts#createShipModel`: a scene-level `load()` on `Sailing` itself would still leave the registry empty the instant `enter()` returns, since `Boot.enter()` calls `goto("sailing")` without awaiting it. `conventions.ts#measureHull` reads the physics body's box and `Buoyancy3D` hull points off the loaded model rather than a hand-tuned constant, so a different hull model never needs those numbers touched by hand. `SHIP_SAILS` in `props.ts` stays simulated cloth: the GLB's own baked sail mesh is stripped at cook time so the two never double up. `Ship.ts` uses `RigidBody3D` plus `Buoyancy3D`, and reads the hull's attitude off four swell samples rotated by the heading rather than leaving it to the solver: `Buoyancy3D`'s drag comes from the body's *linear* velocity and so damps no rotation at all, and a free body capsizes inside seconds. A helm and sheets are two axes, not one stick: `vector("move")` clamps its diagonal to unit length, which is right for a thumb and wrong for a ship that must hold full sail and hard over at once.
|
|
54
54
|
|
|
55
|
-
The sea is `SpectralOcean`, added with `ctx.add` so the compute registry runs its passes. It draws nothing: `src/render/ocean.ts` owns the mesh, the material and every colour, and is the only file to edit for the water's look. The cascade buffers the vertex stage reads are the ones the CPU height query is copied from
|
|
55
|
+
The sea is `SpectralOcean`, added with `ctx.add` so the compute registry runs its passes. It draws nothing: `src/render/ocean.ts` owns the mesh, the material, the mirror and every colour, and is the only file to edit for the water's look. The cascade buffers the vertex stage reads are the ones the CPU height query is copied from, so the hull floats on the surface that is drawn; two fields would leave the ship riding water nothing renders, with every assertion here still green.
|
|
56
56
|
|
|
57
|
-
|
|
57
|
+
Five details are load-bearing. The material is `MeshStandardNodeMaterial`, not a basic one: a basic material takes no lights, so the sun on the water has to be faked with a `pow()` term, and the sea cannot agree with the hull floating on it. `normalNode` overrides `normalView`, so feed it a view-space normal or the reflection becomes a column of glare that follows the camera. The surface is a **logarithmic disc** centred on the ship, the cascade lookup adding the disc's own offset back: a square patch either ends inside the haze as a visible rectangular hem, or reaches the horizon with 300 m quads beside the hull. The ripple normals fade on the **pixel footprint** (`dFdx`/`dFdy` of the world position) and the slope they lose is spent as roughness, or every sea past 130 m is a mirror. And the CPU height is a coarse throttled copy: `readbackResolution` over the largest `patchSize` is the spacing between samples, and make that spacing wider than the waves and the ship sits at a smoothed mean sea level, hanging over its own troughs. It is also `undefined` until the first copy lands, which `Ship.ts` handles by falling back to mean sea level, and `surfaceHeight(ocean, x, z, dt)` is the call anything that floats should use rather than `sampleHeight` raw: it samples upwind by however far the swell will have run during the copy's age, so a hull is not left riding water the renderer stopped drawing. `WaveField.sample(x, z, time)` returns height and normal and allocates; `heightAt(x, z, time)` is the same arithmetic without the jacobian and without an allocation — ask it for floats, splash and wake, and keep `sample` where you shade with the normal. `RippleField` is the sea answering back: a finite patch carrying only the disturbance, so add its `heightAt` to the sea height and its `foamAt` to the foam and never use it in place of a sea. It steps at display rate or the CFL limit, whichever is smaller; `speed`, `damping`, `foamHalfLife`, `current`, `step` and `maxSteps` override that, and a `step` over the limit is rejected with the limit in the message. Its rim absorbs, so `recenter` it on whatever the player is watching.
|
|
58
58
|
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
`playtests/survives.playtest.json` as smoke proof and native scenarios honest.
|
|
59
|
+
The sky is `assets/sky.jpg` (Poly Haven, CC0), fetched in `Boot.load` beside the ship — a scene's `load` is the one method allowed to await, and `Sailing.enter` must stay synchronous, because a playtest runner reads the registry the instant `enter()` returns. `sky.ts` draws it at `SKY_RANGE` and lights the scene at `FILL_RANGE`, and those are different numbers on purpose: half that photograph is a flat grey placeholder where a panorama's lower hemisphere should be, and at full range it becomes the largest term in every surface's light budget. Reflection is one half-res `WaterSurface3D` pass, with `markReflected` naming what the mirror may draw — it is a second draw of the world, so the sea stays off it, the sky arrives in the same texture, and there is no second sky lookup to blend against it.
|
|
60
|
+
|
|
61
|
+
Tune the sea state in `src/render/ocean.ts`, the rig and hull in `src/render/props.ts` and `src/entities/Ship.ts`, and the course in `src/scenes/Sailing.ts`. The React HUD reads published state; keep `playtests/survives.playtest.json` as smoke proof and native scenarios honest.
|
|
62
62
|
|
|
63
63
|
On a touch-primary device (`isMobile() && isTouchscreenAvailable()`), `src/render/touch-controls.ts`
|
|
64
|
-
adds a left
|
|
64
|
+
adds a left stick whose vector `Sailing` adds into both the helm and the sheets; keyboard is the fallback.
|
|
65
65
|
|
|
66
66
|
## Portable authoring contracts
|
|
67
67
|
|
|
68
|
-
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.
|
|
68
|
+
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.
|
|
69
69
|
|
|
70
70
|
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.
|
|
71
71
|
Scenes use `load`, `enter`, `update`, `exit`, `render`; physics nodes are Godot-named and disposable. Generated conventions call `normaliseToMetres` for authored ship scale; buoyancy owns water contact.
|
|
@@ -88,10 +88,10 @@ clip's pose, and `boneContact` reports in metres whether a named bone reaches th
|
|
|
88
88
|
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.
|
|
89
89
|
## Budget real time for the look
|
|
90
90
|
|
|
91
|
-
Reference-driven authoring starts at `agent-docs/dream-loop.md`.
|
|
91
|
+
Reference-driven authoring starts at `node_modules/create-threenative/agent-docs/references/dream-loop.md`.
|
|
92
92
|
|
|
93
|
-
Open a capture after visual changes. A scenario with no assertions or missing observations fails.
|
|
93
|
+
Open a capture after visual changes. A scenario with no assertions or missing observations fails. 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
94
|
|
|
95
|
-
Recipes
|
|
95
|
+
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`.
|
|
96
96
|
## Optional multiplayer transport
|
|
97
97
|
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`.
|
|
Binary file
|
|
@@ -12,13 +12,13 @@
|
|
|
12
12
|
"build:ios": "threenative build --target ios",
|
|
13
13
|
"test:native": "pnpm build:desktop && threenative-playtest --scenario native-playtests/survives.playtest.json --scenario native-playtests/float.playtest.json --target desktop --executable dist-native/__PROJECT_NAME__",
|
|
14
14
|
"pretest": "playwright install chromium",
|
|
15
|
-
"test": "
|
|
15
|
+
"test": "pnpm build:web && threenative-playtest --scenario \"playtests/*.playtest.json\" --browser-recipe webgpu --headed --server-command \"pnpm exec vite preview --host 127.0.0.1 --port $PORT --strictPort\"",
|
|
16
16
|
"typecheck": "tsc --noEmit -p tsconfig.json"
|
|
17
17
|
},
|
|
18
18
|
"dependencies": {
|
|
19
|
-
"@threenative/core": "0.3.
|
|
20
|
-
"@threenative/physics": "0.3.
|
|
21
|
-
"@threenative/ui": "0.3.
|
|
19
|
+
"@threenative/core": "0.3.4",
|
|
20
|
+
"@threenative/physics": "0.3.4",
|
|
21
|
+
"@threenative/ui": "0.3.4",
|
|
22
22
|
"react": "19.2.0",
|
|
23
23
|
"react-dom": "19.2.0",
|
|
24
24
|
"react-reconciler": "0.33.0",
|
|
@@ -26,13 +26,13 @@
|
|
|
26
26
|
},
|
|
27
27
|
"devDependencies": {
|
|
28
28
|
"@tailwindcss/vite": "4.3.3",
|
|
29
|
-
"@threenative/assets": "0.3.
|
|
30
|
-
"@threenative/playtest": "0.3.
|
|
29
|
+
"@threenative/assets": "0.3.5",
|
|
30
|
+
"@threenative/playtest": "0.3.4",
|
|
31
31
|
"@types/react": "19.2.0",
|
|
32
32
|
"@types/react-dom": "19.2.0",
|
|
33
33
|
"@types/three": "0.185.3",
|
|
34
34
|
"@vitejs/plugin-react": "6.0.5",
|
|
35
|
-
"create-threenative": "0.2.
|
|
35
|
+
"create-threenative": "0.2.7",
|
|
36
36
|
"esbuild": "0.27.0",
|
|
37
37
|
"playwright": "1.62.1",
|
|
38
38
|
"tailwindcss": "4.3.3",
|
|
@@ -41,9 +41,15 @@
|
|
|
41
41
|
"@gltf-transform/cli": "4.4.2"
|
|
42
42
|
},
|
|
43
43
|
"optionalDependencies": {
|
|
44
|
-
"@threenative/runtime-native": "0.3.
|
|
44
|
+
"@threenative/runtime-native": "0.3.4"
|
|
45
|
+
},
|
|
46
|
+
"overrides": {
|
|
47
|
+
"sharp": ">=0.35.4"
|
|
45
48
|
},
|
|
46
49
|
"pnpm": {
|
|
50
|
+
"overrides": {
|
|
51
|
+
"sharp": ">=0.35.4"
|
|
52
|
+
},
|
|
47
53
|
"onlyBuiltDependencies": ["@threenative/core", "@threenative/runtime-native"],
|
|
48
54
|
"patchedDependencies": {
|
|
49
55
|
"three@0.185.1": "patches/three@0.185.1.patch"
|