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
|
@@ -2,47 +2,98 @@ import {
|
|
|
2
2
|
type ICtx,
|
|
3
3
|
Scene,
|
|
4
4
|
type SceneFrame,
|
|
5
|
+
WaterSurface3D,
|
|
5
6
|
isMobile,
|
|
6
7
|
isTouchscreenAvailable,
|
|
7
8
|
} from "@threenative/core";
|
|
8
9
|
import type { IPhysicsContext } from "@threenative/physics";
|
|
9
|
-
import {
|
|
10
|
+
import type { Group, PerspectiveCamera, Texture } from "three";
|
|
10
11
|
import { Ship } from "../entities/Ship.js";
|
|
11
12
|
import { followShip, setupCamera } from "../render/camera.js";
|
|
12
|
-
import { setupLighting } from "../render/lighting.js";
|
|
13
|
+
import { followSun, setupLighting } from "../render/lighting.js";
|
|
13
14
|
import { createLoadingScreen } from "../render/loading.js";
|
|
14
15
|
import { createMaterials } from "../render/materials.js";
|
|
15
|
-
import {
|
|
16
|
-
|
|
16
|
+
import {
|
|
17
|
+
SEA_MIRROR,
|
|
18
|
+
createOcean,
|
|
19
|
+
createWaterMesh,
|
|
20
|
+
markReflected,
|
|
21
|
+
surfaceHeight,
|
|
22
|
+
} from "../render/ocean.js";
|
|
17
23
|
import { setupPost } from "../render/postprocessing.js";
|
|
18
|
-
import { createBuoy, createIsland } from "../render/props.js";
|
|
24
|
+
import { createBuoy, createIsland, getShipModel } from "../render/props.js";
|
|
19
25
|
import { setupSky } from "../render/sky.js";
|
|
20
26
|
import { TouchControls } from "../render/touch-controls.js";
|
|
21
27
|
import type { GameState } from "../state.js";
|
|
22
28
|
|
|
23
29
|
export type GameCtx = ICtx<GameState, IPhysicsContext>;
|
|
24
30
|
|
|
25
|
-
|
|
31
|
+
/**
|
|
32
|
+
* The passage: four marks to be rounded in order, laid out as a circuit around the headland.
|
|
33
|
+
*
|
|
34
|
+
* What this replaces was four buoys strung along the z axis between 5 and -1, two metres apart,
|
|
35
|
+
* with the ship starting at z = 7 — a course shorter than the ship was long, sailed in under three
|
|
36
|
+
* seconds without touching the helm once. There is no passage in that, and no reason for a rudder.
|
|
37
|
+
* These four are about thirty metres apart and each one is on a different bearing from the last,
|
|
38
|
+
* so every mark is a turn, and the headland at (-13, -17) has to be sailed around rather than
|
|
39
|
+
* through.
|
|
40
|
+
*/
|
|
41
|
+
const COURSE = [
|
|
42
|
+
{ x: 12, z: -10 },
|
|
43
|
+
{ x: 2, z: -40 },
|
|
44
|
+
{ x: -30, z: -46 },
|
|
45
|
+
{ x: -34, z: -6 },
|
|
46
|
+
] as const;
|
|
47
|
+
|
|
48
|
+
/** How close the ship must pass to a mark for it to count as rounded, in metres. */
|
|
49
|
+
const ROUNDING_RADIUS = 7;
|
|
50
|
+
/**
|
|
51
|
+
* How far a mark's origin sits below the surface it floats on, in metres.
|
|
52
|
+
*
|
|
53
|
+
* The buoy model is built about its own waterline, not its keel, so putting its origin *at* the
|
|
54
|
+
* sea height floated the whole float clear of the water — a barrel hanging in the air with its
|
|
55
|
+
* shadow on the sea beside it. This is the draught that puts the paint line where the water is.
|
|
56
|
+
*/
|
|
57
|
+
const BUOY_DRAUGHT = 0.32;
|
|
58
|
+
/** Half the hull's length: where the wake is born. */
|
|
59
|
+
const TRANSOM = 2.1;
|
|
60
|
+
/** The speed the wake is at its fullest, in metres per second. `Ship`'s own hull speed. */
|
|
61
|
+
const MAX_WAKE_SPEED = 4.6;
|
|
62
|
+
/** Seconds of fair wind. Run out of it before the last mark and the passage is lost. */
|
|
63
|
+
const WIND_DURATION = 120;
|
|
26
64
|
|
|
27
65
|
export class Sailing extends Scene<GameState, IPhysicsContext> {
|
|
28
66
|
static override readonly initialState: GameState = {
|
|
29
67
|
buoysRounded: 0,
|
|
30
68
|
elapsed: 0,
|
|
69
|
+
markBearing: 0,
|
|
70
|
+
markDistance: 0,
|
|
31
71
|
paused: false,
|
|
32
72
|
shipZ: 7,
|
|
73
|
+
speed: 0,
|
|
33
74
|
status: "sailing",
|
|
34
75
|
submergedFraction: 0,
|
|
35
76
|
uiReady: false,
|
|
36
77
|
wind: 1,
|
|
37
78
|
};
|
|
38
79
|
|
|
80
|
+
#sea: ReturnType<typeof createWaterMesh> | undefined;
|
|
81
|
+
|
|
82
|
+
// No `load()` here: `ship.glb` is fetched in `Boot.load()`, alongside the sky, so this scene's
|
|
83
|
+
// `enter()` stays synchronous — a playtest runner reads the registry the instant it returns, and
|
|
84
|
+
// `Boot.enter()` calls `goto("sailing")` without awaiting it, so an async load *here* would still
|
|
85
|
+
// leave the registry empty at that moment. `ship.glb` is Poly Haven's `dutch_ship_medium` (CC0;
|
|
86
|
+
// James Ray Cock, Rico Cilliers, Nicolò Zubbini); see `props.ts`.
|
|
39
87
|
override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
ctx.scene.fog = new Fog(palette.skyLow, 95, 330);
|
|
88
|
+
const shipModel = getShipModel();
|
|
89
|
+
const software = ctx.renderer.softwareAdapter !== undefined;
|
|
90
|
+
setupSky(ctx.scene, { software });
|
|
44
91
|
const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
|
|
45
|
-
setupPost(ctx.renderer, ctx.scene, ctx.camera, {
|
|
92
|
+
setupPost(ctx.renderer, ctx.scene, ctx.camera, {
|
|
93
|
+
godraysLight: sun,
|
|
94
|
+
mobile: isMobile(),
|
|
95
|
+
software,
|
|
96
|
+
});
|
|
46
97
|
const loading = createLoadingScreen(ctx);
|
|
47
98
|
const camera = ctx.camera as PerspectiveCamera;
|
|
48
99
|
setupCamera(camera);
|
|
@@ -56,40 +107,61 @@ export class Sailing extends Scene<GameState, IPhysicsContext> {
|
|
|
56
107
|
// passes in the warmup set. It draws nothing — the mesh and its material are this game's, and
|
|
57
108
|
// both live in `src/render/ocean.ts`.
|
|
58
109
|
const ocean = ctx.add(createOcean());
|
|
59
|
-
|
|
110
|
+
// The mirror is constructed here and handed to the material: `src/render/` reaches the engine
|
|
111
|
+
// for the wave field it draws and nothing else, so the pass that draws the world a second time
|
|
112
|
+
// is built in game code from the options that file authored.
|
|
113
|
+
const sea = createWaterMesh(ocean, new WaterSurface3D(SEA_MIRROR), { software });
|
|
114
|
+
this.#sea = sea;
|
|
115
|
+
ctx.add(sea.mesh);
|
|
60
116
|
|
|
61
117
|
const materials = createMaterials();
|
|
62
|
-
|
|
63
|
-
|
|
118
|
+
// Everything the sea's mirror is allowed to draw, and nothing else. The mirrored pass is a
|
|
119
|
+
// second draw of the world, and on this scene it is a draw-call bill rather than a pixel one,
|
|
120
|
+
// so it is told what to draw: the silhouettes a player reads in the water. A layer, not a
|
|
121
|
+
// second scene, because every one of these is also on layer 0 and the main camera is untouched.
|
|
122
|
+
markReflected(ctx.add(createIsland(materials)));
|
|
123
|
+
const marks: Group[] = [];
|
|
124
|
+
for (const mark of COURSE) {
|
|
64
125
|
const buoy = createBuoy(materials);
|
|
65
|
-
buoy.position.set(
|
|
66
|
-
|
|
126
|
+
buoy.position.set(mark.x, 0, mark.z);
|
|
127
|
+
marks.push(buoy);
|
|
128
|
+
markReflected(ctx.add(buoy));
|
|
67
129
|
}
|
|
68
130
|
|
|
69
|
-
const ship = new Ship(ctx, ocean);
|
|
131
|
+
const ship = new Ship(ctx, ocean, shipModel);
|
|
132
|
+
// The ship is deliberately not in the sea's mirror: it is a second draw of the hull *and its
|
|
133
|
+
// keel*, which the mirror sees from below as a black blot smeared under the stern.
|
|
70
134
|
ctx.entities.add("player", ship);
|
|
71
135
|
let elapsed = 0;
|
|
72
136
|
let buoysRounded = 0;
|
|
137
|
+
let markBearing = 0;
|
|
138
|
+
let markDistance = 0;
|
|
73
139
|
let status: GameState["status"] = "sailing";
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
ship.
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
140
|
+
|
|
141
|
+
const scoreCourse = (wind: number): void => {
|
|
142
|
+
const next = COURSE[buoysRounded];
|
|
143
|
+
if (next === undefined) return;
|
|
144
|
+
// Bearing to the next mark **relative to the bow**, which is what the HUD arrow points
|
|
145
|
+
// along: a compass bearing would be right and useless, because the player is looking down
|
|
146
|
+
// the ship's centreline and not at a compass rose.
|
|
147
|
+
const toMarkX = next.x - ship.mesh.position.x;
|
|
148
|
+
const toMarkZ = next.z - ship.mesh.position.z;
|
|
149
|
+
markDistance = Math.hypot(toMarkX, toMarkZ);
|
|
150
|
+
const forward = ship.forward;
|
|
151
|
+
const starboard = ship.starboard;
|
|
152
|
+
markBearing = Math.atan2(
|
|
153
|
+
toMarkX * starboard.x + toMarkZ * starboard.z,
|
|
154
|
+
toMarkX * forward.x + toMarkZ * forward.z,
|
|
85
155
|
);
|
|
86
|
-
|
|
87
|
-
|
|
156
|
+
// Rounded by sailing close to it, not by crossing a line of latitude. The old test was
|
|
157
|
+
// `position.z > mark`, which the ship passed by drifting sideways past a buoy it never came
|
|
158
|
+
// near, and which no course that turns can even express.
|
|
159
|
+
if (markDistance > ROUNDING_RADIUS) {
|
|
88
160
|
if (wind <= 0) status = "lost";
|
|
89
161
|
return;
|
|
90
162
|
}
|
|
91
163
|
buoysRounded += 1;
|
|
92
|
-
if (buoysRounded ===
|
|
164
|
+
if (buoysRounded === COURSE.length) status = "won";
|
|
93
165
|
else if (wind <= 0) status = "lost";
|
|
94
166
|
};
|
|
95
167
|
|
|
@@ -103,23 +175,59 @@ export class Sailing extends Scene<GameState, IPhysicsContext> {
|
|
|
103
175
|
}
|
|
104
176
|
|
|
105
177
|
elapsed += deltaTime;
|
|
106
|
-
|
|
178
|
+
// The sea's clock. `SpectralOcean` dispatches its transform every frame regardless, but it
|
|
179
|
+
// transforms the spectrum *at the time it was last given* — so an ocean that is never
|
|
180
|
+
// advanced recomputes t = 0 forever: the compute passes run, the readback lands, and the
|
|
181
|
+
// bytes that come back are identical to sixteen significant figures. That is what a still
|
|
182
|
+
// photograph of a sea looks like from the inside, and it is why the hull sat at one constant
|
|
183
|
+
// height with `oceanSteps` climbing past 400. The game owns this clock, so a paused game has
|
|
184
|
+
// a paused sea.
|
|
107
185
|
ocean.advance(elapsed);
|
|
108
|
-
|
|
109
|
-
//
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
186
|
+
// The ripple normals run on the game's clock rather than the engine's, so a paused game
|
|
187
|
+
// has a still sea and a capture is reproducible.
|
|
188
|
+
sea.advance(elapsed);
|
|
189
|
+
const wind = Math.max(0, 1 - elapsed / WIND_DURATION);
|
|
190
|
+
const sailing = status === "sailing";
|
|
191
|
+
if (sailing && frameCtx.input.justPressed("capsize")) {
|
|
192
|
+
ship.capsize();
|
|
193
|
+
status = "lost";
|
|
194
|
+
}
|
|
195
|
+
// The hull is updated whatever the outcome, and only the *scoring* stops.
|
|
196
|
+
//
|
|
197
|
+
// Skipping the whole update once the passage ended froze the ship where it stood while the
|
|
198
|
+
// sea went on moving underneath it — the one thing in the frame that cannot happen, and the
|
|
199
|
+
// frame the player is left looking at while they read "course complete". A finished ship
|
|
200
|
+
// carries its way, rides the swell and slows; a capsized one has no wind in anything.
|
|
201
|
+
ship.update(
|
|
202
|
+
frameCtx,
|
|
203
|
+
deltaTime,
|
|
204
|
+
ship.capsized ? 0 : wind,
|
|
205
|
+
touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size),
|
|
206
|
+
);
|
|
207
|
+
if (status === "sailing") scoreCourse(wind);
|
|
208
|
+
|
|
209
|
+
// The marks float. They are moored to the sea bed, not nailed to y = 0: left at a fixed
|
|
210
|
+
// height they stood in a hole when the swell rose past them and hung in the air over every
|
|
211
|
+
// trough, which reads as the buoys being the only things in the frame that are not in the
|
|
212
|
+
// water they are floating in.
|
|
213
|
+
for (const [index, mark] of COURSE.entries()) {
|
|
214
|
+
const buoy = marks[index];
|
|
215
|
+
if (buoy === undefined) continue;
|
|
216
|
+
buoy.position.y = (surfaceHeight(ocean, mark.x, mark.z, deltaTime) ?? 0) - BUOY_DRAUGHT;
|
|
217
|
+
}
|
|
113
218
|
|
|
114
219
|
const state = frameCtx.state.getState();
|
|
115
220
|
frameCtx.state.set({
|
|
116
221
|
buoysRounded,
|
|
117
222
|
elapsed,
|
|
223
|
+
markBearing,
|
|
224
|
+
markDistance,
|
|
118
225
|
paused: state.paused,
|
|
119
226
|
shipZ: ship.mesh.position.z,
|
|
227
|
+
speed: ship.speed,
|
|
120
228
|
status,
|
|
121
229
|
submergedFraction: ship.immersion,
|
|
122
|
-
uiReady:
|
|
230
|
+
uiReady: state.uiReady,
|
|
123
231
|
wind,
|
|
124
232
|
});
|
|
125
233
|
// The **visual**, not the body. `Ship` draws the hull from `ship.visual`, whose y is the sea
|
|
@@ -127,7 +235,33 @@ export class Sailing extends Scene<GameState, IPhysicsContext> {
|
|
|
127
235
|
// is no longer what anything is drawn at. Following the body pointed the camera somewhere
|
|
128
236
|
// the ship was not: the horizon slid up and down behind a hull that was itself steady, so
|
|
129
237
|
// the ship read as bobbing out of the water and back into it.
|
|
130
|
-
|
|
238
|
+
sea.follow(ship.visual.position.x, ship.visual.position.z);
|
|
239
|
+
// The wake starts at the transom, not at the ship's centre, or the foam runs up under the
|
|
240
|
+
// hull and the caravel appears to be sitting in it rather than making it.
|
|
241
|
+
const bow = ship.forward;
|
|
242
|
+
sea.wake(
|
|
243
|
+
ship.visual.position.x - bow.x * TRANSOM,
|
|
244
|
+
ship.visual.position.z - bow.z * TRANSOM,
|
|
245
|
+
bow.x,
|
|
246
|
+
bow.z,
|
|
247
|
+
ship.speed / MAX_WAKE_SPEED,
|
|
248
|
+
);
|
|
249
|
+
followShip(
|
|
250
|
+
camera,
|
|
251
|
+
ship.visual.position,
|
|
252
|
+
ship.heading,
|
|
253
|
+
deltaTime,
|
|
254
|
+
(x, z) => surfaceHeight(ocean, x, z, deltaTime) ?? 0,
|
|
255
|
+
);
|
|
256
|
+
followSun(sun, ship.visual.position);
|
|
131
257
|
};
|
|
132
258
|
}
|
|
259
|
+
|
|
260
|
+
override exit(ctx: GameCtx): void {
|
|
261
|
+
// The mirror owns a render target and a pass. Nothing in the frame releases it, so a restart
|
|
262
|
+
// — which is `goto("sailing")`, and this scene is entered again — would leak one every time.
|
|
263
|
+
this.#sea?.dispose();
|
|
264
|
+
this.#sea = undefined;
|
|
265
|
+
super.exit(ctx);
|
|
266
|
+
}
|
|
133
267
|
}
|
|
@@ -1,6 +1,12 @@
|
|
|
1
1
|
export type GameState = {
|
|
2
2
|
buoysRounded: number;
|
|
3
3
|
elapsed: number;
|
|
4
|
+
/** Bearing to the next mark, in radians to starboard of the bow. The HUD arrow points along it. */
|
|
5
|
+
markBearing: number;
|
|
6
|
+
/** Metres to the next mark, over the ground. */
|
|
7
|
+
markDistance: number;
|
|
8
|
+
/** Way on, in metres per second. */
|
|
9
|
+
speed: number;
|
|
4
10
|
paused: boolean;
|
|
5
11
|
submergedFraction: number;
|
|
6
12
|
status: "sailing" | "won" | "lost";
|
|
@@ -8,8 +8,11 @@ export function Hud() {
|
|
|
8
8
|
state.status === "won" ? "text-win" : state.status === "lost" ? "text-danger" : "text-accent";
|
|
9
9
|
return (
|
|
10
10
|
<div className="pointer-events-none absolute inset-0 p-6 text-[11px] uppercase tracking-[0.16em] text-text">
|
|
11
|
-
<div className="flex items-start justify-between">
|
|
12
|
-
|
|
11
|
+
<div className="flex items-start justify-between gap-4">
|
|
12
|
+
{/* A panel, not loose type. The sailing kit puts the frame two thirds sky and a bright
|
|
13
|
+
specular path across the water, and a HUD written straight onto that is unreadable for
|
|
14
|
+
exactly as long as the wind is up. */}
|
|
15
|
+
<div className="rounded bg-black/70 px-4 py-3">
|
|
13
16
|
<div className="text-[10px] text-muted">passage / bluewater run</div>
|
|
14
17
|
<div className="mt-2 flex items-baseline gap-5 text-[18px] text-white">
|
|
15
18
|
<span>
|
|
@@ -20,22 +23,51 @@ export function Hud() {
|
|
|
20
23
|
</span>
|
|
21
24
|
</div>
|
|
22
25
|
</div>
|
|
23
|
-
<div className="
|
|
24
|
-
<div className="
|
|
25
|
-
|
|
26
|
-
|
|
26
|
+
<div className="flex items-start gap-4">
|
|
27
|
+
<div className="rounded bg-black/70 px-4 py-3 text-right">
|
|
28
|
+
<div className="text-[10px] text-muted">next mark</div>
|
|
29
|
+
<div className="mt-2 flex items-center justify-end gap-3">
|
|
30
|
+
{/* The arrow the course is steered by. Without it the fourth mark is a hundred
|
|
31
|
+
metres away behind a headland and the player is guessing. `markBearing` is
|
|
32
|
+
already relative to the bow, so this is a plain rotation with no compass maths
|
|
33
|
+
in the view. */}
|
|
34
|
+
<span
|
|
35
|
+
className="inline-block text-[20px] leading-none text-accent"
|
|
36
|
+
id="mark-bearing"
|
|
37
|
+
style={{ rotate: `${state.markBearing}rad` }}
|
|
38
|
+
>
|
|
39
|
+
↑
|
|
40
|
+
</span>
|
|
41
|
+
<span className="text-[22px] text-white" id="mark-distance">
|
|
42
|
+
{Math.round(state.markDistance)}
|
|
43
|
+
<span className="text-[11px] text-muted">m</span>
|
|
44
|
+
</span>
|
|
45
|
+
</div>
|
|
46
|
+
</div>
|
|
47
|
+
<div className="rounded bg-black/70 px-4 py-3 text-right">
|
|
48
|
+
<div className="text-[10px] text-muted">wind</div>
|
|
49
|
+
<div className="mt-2 text-[22px] text-white" id="wind">
|
|
50
|
+
{Math.round(state.wind * 100)}%
|
|
51
|
+
</div>
|
|
27
52
|
</div>
|
|
28
53
|
</div>
|
|
29
54
|
</div>
|
|
30
|
-
<div className="absolute bottom-6 left-6 flex items-end gap-
|
|
31
|
-
<div>
|
|
55
|
+
<div className="absolute bottom-6 left-6 flex items-end gap-6">
|
|
56
|
+
<div className="rounded bg-black/70 px-4 py-3">
|
|
32
57
|
<div className="text-[10px] text-muted">waterline</div>
|
|
33
58
|
<div className="mt-1 text-[26px] leading-none text-white" id="submerged-fraction">
|
|
34
59
|
{Math.round(state.submergedFraction * 100)}
|
|
35
60
|
<span className="text-[11px] text-muted">%</span>
|
|
36
61
|
</div>
|
|
37
62
|
</div>
|
|
38
|
-
<div>
|
|
63
|
+
<div className="rounded bg-black/70 px-4 py-3">
|
|
64
|
+
<div className="text-[10px] text-muted">speed</div>
|
|
65
|
+
<div className="mt-1 text-[18px] leading-none text-white" id="speed">
|
|
66
|
+
{(state.speed * 1.944).toFixed(1)}
|
|
67
|
+
<span className="text-[11px] text-muted">kn</span>
|
|
68
|
+
</div>
|
|
69
|
+
</div>
|
|
70
|
+
<div className="rounded bg-black/70 px-4 py-3">
|
|
39
71
|
<div className="text-[10px] text-muted">elapsed</div>
|
|
40
72
|
<div className="mt-1 text-[18px] leading-none text-white" id="elapsed">
|
|
41
73
|
{state.elapsed.toFixed(1)}s
|
|
@@ -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__",
|
|
@@ -35,6 +37,17 @@ const config: IThreeNativeConfig = {
|
|
|
35
37
|
alphaAntialiasing: true,
|
|
36
38
|
},
|
|
37
39
|
ui: { renderer: "web" },
|
|
40
|
+
// One asset tree, one compiler, one representation per artifact. Uncomment, then cook:
|
|
41
|
+
// threenative build --target android # cooks defaults.android; --profile <name> beats it
|
|
42
|
+
// buildProfiles: {
|
|
43
|
+
// defaults: { android: "compact" },
|
|
44
|
+
// profiles: {
|
|
45
|
+
// compact: {
|
|
46
|
+
// assets: { textures: { maxSize: 1024 }, models: { textures: { maxSize: 1024 } } },
|
|
47
|
+
// } },
|
|
48
|
+
// },
|
|
49
|
+
// Contract, byte definitions, the build report:
|
|
50
|
+
// node_modules/create-threenative/agent-docs/references/build-profiles.md
|
|
38
51
|
};
|
|
39
52
|
|
|
40
53
|
export default config;
|
|
@@ -10,9 +10,12 @@ function assetsWatchPlugin(): Plugin {
|
|
|
10
10
|
return {
|
|
11
11
|
name: "threenative-assets-watch",
|
|
12
12
|
apply: "serve",
|
|
13
|
-
configureServer(server) {
|
|
13
|
+
async configureServer(server) {
|
|
14
14
|
const handle = watchAssets({ config: config.assets, cwd: server.config.root });
|
|
15
15
|
server.httpServer?.once("close", () => handle.close());
|
|
16
|
+
// Nothing is served before the first cook settles: until it does, `public/` has no
|
|
17
|
+
// `assets.manifest.json` and every asset answers from its source fallback.
|
|
18
|
+
await handle.ready;
|
|
16
19
|
},
|
|
17
20
|
};
|
|
18
21
|
}
|
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
# AGENTS.md — __PROJECT_NAME__ first-person
|
|
1
|
+
# AGENTS.md — __PROJECT_NAME__ first-person town firefight
|
|
2
2
|
|
|
3
3
|
Instructions for the AI agent in this game. `CLAUDE.md` mirrors this file; edit `AGENTS.md`.
|
|
4
4
|
|
|
5
5
|
## Ownership
|
|
6
6
|
|
|
7
|
-
ThreeNative owns bootstrap, renderer, fixed-step loop, input, loading, physics bindings, and the state bridge. This repository owns the
|
|
8
|
-
portable, `src/main.ts` is the web-only React mount.
|
|
7
|
+
ThreeNative owns bootstrap, renderer, fixed-step loop, input, loading, physics bindings, and the state bridge. This repository owns the town, the soldiers, the rifle, the HUD and the look; `src/game.ts` is
|
|
8
|
+
portable, `src/main.ts` is the web-only React mount. 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 matches
|
|
14
|
-
with `engine_capability_detail`, and record a capability or no-match for the plan.
|
|
14
|
+
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.
|
|
17
17
|
3. Treat returned constraints as binding. `@threenative/physics/navigation` is browser-only WASM;
|
|
@@ -37,7 +37,7 @@ result, replacement); never stall the game.
|
|
|
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
|
|
|
@@ -49,48 +49,33 @@ pnpm test
|
|
|
49
49
|
pnpm typecheck
|
|
50
50
|
```
|
|
51
51
|
|
|
52
|
-
Contract:
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
`src/
|
|
57
|
-
`
|
|
52
|
+
Contract: a 105-second round in a procedurally built 84 m waterfront town; 12 hits completes it, zero
|
|
53
|
+
health or an expired clock fails it, Enter restarts. Mouse looks, WASD or arrows move, Space or left
|
|
54
|
+
click fires, F or right click aims, R reloads, shift sprints, ctrl/C crouches. `src/render/town.ts`
|
|
55
|
+
owns the layout — blocks, quay, pier, raised decks, routes, spawns — and every solid in it is both a
|
|
56
|
+
collider and a raycast target. `src/entities/` owns the fight: `FpsPlayer` moves, `Rifle` fires and
|
|
57
|
+
zeroes, `Enemy` patrols, hears, sees and shoots back, `Target` scores the plates. `src/scenes/Play.ts`
|
|
58
|
+
wires them and `src/ui/Hud.tsx` is the only HUD. `playtests/survives.playtest.json` is the durable
|
|
59
|
+
smoke proof. The soldiers are `assets/mannequin-combat.glb` (Quaternius UAL, CC0); the hands in
|
|
60
|
+
`assets/player-viewmodel.glb` are "Animated FPS hands (rifle animation pack)" by Cransh,
|
|
61
|
+
CC-BY-4.0 — https://sketchfab.com/3d-models/animated-fps-hands-rifle-animation-pack-5f2d0ed780a94724b36ab505f7564057.
|
|
58
62
|
|
|
59
63
|
## Portable authoring contracts
|
|
60
64
|
|
|
61
|
-
Leave `assets` absent: the cook selects target-decodable passes,
|
|
62
|
-
|
|
65
|
+
Leave `assets` absent: the cook selects target-decodable passes, and `models.compact` (default `{ flatten: true, join: true, instance: true }`) flattens the scene graph losslessly while keeping any node matching `protectedPattern` or `protectedNames`, an animation target, or a skin joint individually addressable; `compact: false` ships it as authored. `models`/`textures`/`audio`: `"none"` skip those passes and report uncooked bytes, and a codec override must satisfy four-pixel block alignment — `codec: "none"` opts out. `assets.exclude` (source-relative globs) omits files and reports 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, an unaligned source image is retained unchanged and still counted, and cooking never resizes one to fix alignment. Android/iOS skip compression and dedupe.
|
|
63
66
|
Relative look capture: a binding with `pointerRelative: true` captures the canvas on click by default; set `captureOnClick: false` and call `ctx.input.captureMouse()` from your own gesture to opt out. Desktop mode precedence is CLI (`--windowed`, `--maximized`, `--fullscreen`) over `display.fullscreen` over `window.maximized`; with both false, `window.width`/`height` size the normal window.
|
|
64
|
-
First person, four rules: place the camera in
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
`
|
|
77
|
-
override with `setupPost(..., { tier: "low" })`. Unknown tiers throw, `TN_QUALITY_TIER` reports the
|
|
78
|
-
source, and the bridge flushes about 100 ms — keep lives/wave in state, feedback in Three.js.
|
|
79
|
-
|
|
80
|
-
When an animation looks wrong, measure it before rewriting it: `clipPoseError` scores a retargeted
|
|
81
|
-
clip per bone in degrees relative to each rig's own bind pose, `clipTrackBindings` names tracks that
|
|
82
|
-
bind nothing (the `<bone>.undefined` failure that plays the bind pose), `clipBoneCoverage` names
|
|
83
|
-
bones the clip does not drive, and `boneContact` reports whether a bone reaches its prop. 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.
|
|
84
|
-
|
|
85
|
-
## Budget real time for the look — see `agent-docs/dream-loop.md`
|
|
86
|
-
|
|
87
|
-
Open a capture after visual changes; a scenario with no assertions or missing observations fails.
|
|
88
|
-
VFX appearance belongs in `src/render/vfx.ts`: its TSL material, geometry, colour, blend, curves,
|
|
89
|
-
timing and capacity. Gameplay creates `GPUParticles3D` or an `IComputeDriven` object once, adds it
|
|
90
|
-
with `ctx.add`, and calls `restart()` from the real fire or hit path; never move appearance into
|
|
91
|
-
core or replace the event with a demo-only caller.
|
|
92
|
-
|
|
93
|
-
Recipes shipped in the project: `agent-docs/assertion-reference.md`, `agent-docs/capability-reference.md`, `agent-docs/capture-the-frame.md`, `agent-docs/creating-creatures.md`, `agent-docs/ctx-cookbook.md`, `agent-docs/debug-surface.md`, `agent-docs/finding-assets.md`, `agent-docs/gameplay-recipes.md`, `agent-docs/menu-screens.md`, `agent-docs/mobile-memory-budget.md`, `agent-docs/sculpt-from-a-reference.md`, `agent-docs/trace-a-slow-frame.md`, `agent-docs/visual-baseline.md`, and `agent-docs/webview-ui.md`.
|
|
94
|
-
On a touch-primary device, `src/render/touch-controls.ts` adds a movement stick, a look stick, and fire, aim, reload and crouch pads; the stick pushed to its rim sprints. Keyboard is the fallback.
|
|
67
|
+
First person, four rules: place the camera in the plugin hook after the physics step, never at the end of the frame function, or the eye sits one step behind the body and shots land in the floor on the deck stairs; start every shot at `player.aimRay()`, where the crosshair is, and let `Rifle.converge` lean the weapon to meet it; the trigger takes `pressed` and `justPressed`, because the cooldown makes the cadence and the edge catches a click the harness delivers no other way; `src/render/scale.ts` is the only size table.
|
|
68
|
+
|
|
69
|
+
Scenes use `load`, `enter`, `update`, `exit`, `render`; physics nodes are Godot-named and disposable. Rigged assets: put a `.glb` in `assets/`, await `ctx.assets.model("hero.glb")` in `Scene.load()`, size it with `normaliseToMetres` at a named joint, drive `AnimationPlayer` beside its entity, and reach a held prop with `attachToBone`. `input.vector("move").y` is +up, so forward uses one explicit `-move.y`. `ctx.goto(name)` rebuilds without resetting game state (from a frame function, `goto` then `return`); `ctx.state.set({ … })` is a partial patch; `game.goto()` rebuilds and resets. Seeded randomness needs `defineGame({ seed })`.
|
|
70
|
+
`src/render/sky.ts` makes `assets/sky.jpg` (Poly Haven, CC0) background, environment light and fog colour (re-aim `SUN_DIRECTION` when you swap it); `src/render/quality.ts` owns `low`, `medium`, `high`; `isMobile()` picks `low`, otherwise `high`; override with `setupPost(..., { tier: "low" })`. Unknown tiers throw, `TN_QUALITY_TIER` reports the source, and the bridge flushes about 100 ms — keep score/phase in state, feedback in Three.js.
|
|
71
|
+
|
|
72
|
+
When an animation looks wrong, measure it before rewriting it: `clipPoseError` scores a retargeted clip per bone in degrees relative to each rig's own bind pose, `clipTrackBindings` names tracks that bind nothing (the `<bone>.undefined` failure that plays the bind pose), `clipBoneCoverage` names bones the clip does not drive, and `boneContact` reports whether a bone reaches its prop. A soldier reads as a soldier only when every AI state picks a clip that names the action — patrol and chase `Rifle_Walk`, standing aim `Rifle_Idle`, firing `Rifle_Shoot`, crouch `Rifle_Crouch_To_Idle`/`Rifle_Crouch_Walk` (the six `Rifle_*` clips are Mixamo rifle clips retargeted onto the mannequin, and `RIFLE_HOLD` in `Enemy.ts` turns the rifle to each; the soldier's `rightHandContact`/`leftHandContact` are `boneContact` metres, held under 0.05), hit `Rifle_Hit`, dead `Death01` — crossfaded, feet snapped to the floor, body turned into the direction of travel or aim, and tinted so he does not vanish into the white first-person hands.
|
|
73
|
+
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.
|
|
74
|
+
|
|
75
|
+
## Budget real time for the look — see `node_modules/create-threenative/agent-docs/references/dream-loop.md`
|
|
76
|
+
|
|
77
|
+
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; `TN_FRAME_SPANS=1` adds the render phase's own span tree. 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.
|
|
78
|
+
|
|
79
|
+
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`. On a touch-primary device, `src/entities/TouchControls.ts` adds a movement stick, a look stick, and fire, aim, reload and crouch pads; the stick pushed to its rim sprints.
|
|
95
80
|
## Optional multiplayer transport
|
|
96
81
|
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`.
|