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,72 +1,129 @@
|
|
|
1
1
|
import type { ICtx } from "@threenative/core";
|
|
2
|
-
import { CollisionShape3D, RigidBody3D } from "@threenative/physics";
|
|
3
|
-
import type
|
|
4
|
-
import {
|
|
5
|
-
import { CRATE_SIZE, crate as crateMesh } from "../render/shapes.js";
|
|
2
|
+
import { CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
|
|
3
|
+
import { type Material, Mesh, type Quaternion, Vector3 } from "three";
|
|
4
|
+
import { CRATE_SIZE, crateGeometry } from "../render/crateShape.js";
|
|
6
5
|
import type { GameState } from "../state.js";
|
|
7
6
|
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
7
|
+
/**
|
|
8
|
+
* The two kinds of body in the vault.
|
|
9
|
+
*
|
|
10
|
+
* `solid` crates occupy the default collision layer, so the warden's capsule scans them and is
|
|
11
|
+
* stopped by them. `phase` crates occupy a layer the warden's mask does not include, so they are
|
|
12
|
+
* simulated against the floor and against each other exactly like the solid ones — they fall,
|
|
13
|
+
* stack and are shoved by a solid crate — while the warden's own sweep never sees them.
|
|
14
|
+
*
|
|
15
|
+
* The distinction is a collision layer, not a sensor: a sensor collider would also stop colliding
|
|
16
|
+
* with the crates around it, and a phase crate that fell through the floor would not read as
|
|
17
|
+
* "walk through me", it would read as broken.
|
|
18
|
+
*/
|
|
19
|
+
export type CrateKind = "phase" | "solid";
|
|
12
20
|
|
|
13
21
|
/**
|
|
14
|
-
*
|
|
22
|
+
* Three layers, and the third one is the reason this is not two.
|
|
23
|
+
*
|
|
24
|
+
* 1 — solid crates and the warden. 2 — the room: floor, walls. 4 — the ward.
|
|
15
25
|
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
18
|
-
*
|
|
26
|
+
* The ward has to fall, stack on itself and rest on the floor, so it cannot be a sensor; and it
|
|
27
|
+
* has to be transparent to *everything the player can move*, not only to the warden. A ward that
|
|
28
|
+
* blocked crates while letting the warden through produced a dead level: the warden shoved a crate
|
|
29
|
+
* north, the crate wedged against the ward, and the warden — already touching that crate — could
|
|
30
|
+
* not advance a single millimetre toward the seal. `playerZ` was bit-identical to its spawn value
|
|
31
|
+
* after two hundred ticks of held input, which reads exactly like an input binding that never
|
|
32
|
+
* arrived.
|
|
19
33
|
*/
|
|
34
|
+
export const SOLID_LAYER = 1;
|
|
35
|
+
export const WORLD_LAYER = 2;
|
|
36
|
+
export const PHASE_LAYER = 4;
|
|
37
|
+
/** Solid crates scan other solid crates, the warden, and the room. Never the ward. */
|
|
38
|
+
export const SOLID_MASK = SOLID_LAYER | WORLD_LAYER;
|
|
39
|
+
/** The ward scans the room and itself, and nothing else in the vault. */
|
|
40
|
+
export const PHASE_MASK = WORLD_LAYER | PHASE_LAYER;
|
|
41
|
+
/** What the warden scans: solid crates and the room. */
|
|
42
|
+
export const WARDEN_MASK = SOLID_LAYER | WORLD_LAYER;
|
|
43
|
+
|
|
44
|
+
export interface ICrateOptions {
|
|
45
|
+
/** Names the body for the runner's physics cohort — `settled` matches on this prefix. */
|
|
46
|
+
readonly entity: string;
|
|
47
|
+
readonly kind?: CrateKind;
|
|
48
|
+
/** Restores a full orientation — the replay check rebuilds crates from captured poses. */
|
|
49
|
+
readonly quaternion?: Quaternion;
|
|
50
|
+
readonly rotationY?: number;
|
|
51
|
+
readonly x: number;
|
|
52
|
+
readonly y: number;
|
|
53
|
+
readonly z: number;
|
|
54
|
+
}
|
|
55
|
+
|
|
20
56
|
export class Crate {
|
|
21
57
|
readonly mesh: Mesh;
|
|
22
58
|
readonly body: RigidBody3D;
|
|
23
|
-
|
|
59
|
+
readonly kind: CrateKind;
|
|
60
|
+
/** Where it was authored, before the opening drop. */
|
|
61
|
+
readonly spawn: Vector3;
|
|
62
|
+
/** Where the drop left it, filled in once the vault has settled. */
|
|
63
|
+
readonly rest = new Vector3();
|
|
24
64
|
|
|
25
65
|
constructor(
|
|
26
|
-
ctx:
|
|
27
|
-
|
|
28
|
-
|
|
66
|
+
ctx: ICtx<GameState, IPhysicsContext>,
|
|
67
|
+
material: Material | readonly Material[],
|
|
68
|
+
options: ICrateOptions,
|
|
29
69
|
) {
|
|
30
|
-
this.
|
|
31
|
-
this.mesh
|
|
70
|
+
this.kind = options.kind ?? "solid";
|
|
71
|
+
this.mesh = new Mesh(crateGeometry(), material as Material | Material[]);
|
|
72
|
+
this.mesh.position.set(options.x, options.y, options.z);
|
|
73
|
+
if (options.quaternion === undefined) this.mesh.rotation.y = options.rotationY ?? 0;
|
|
74
|
+
else this.mesh.quaternion.copy(options.quaternion);
|
|
75
|
+
this.mesh.castShadow = true;
|
|
76
|
+
this.mesh.receiveShadow = true;
|
|
77
|
+
this.spawn = this.mesh.position.clone();
|
|
78
|
+
this.rest.copy(this.spawn);
|
|
32
79
|
ctx.add(this.mesh);
|
|
33
80
|
this.body = new RigidBody3D({
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
81
|
+
// A box shape, not `fromMesh`: the merged brace planks would become a convex hull a
|
|
82
|
+
// centimetre proud of the crate on every face, and a stack of those never sits flush.
|
|
83
|
+
collisionLayer: this.kind === "phase" ? PHASE_LAYER : SOLID_LAYER,
|
|
84
|
+
collisionMask: this.kind === "phase" ? PHASE_MASK : SOLID_MASK,
|
|
85
|
+
// Without a name every body is reported as `physics.body.<n>`, and a `settled` assertion can
|
|
86
|
+
// only address the whole world — which always contains the walls and the floor, and those
|
|
87
|
+
// never sleep. Naming the crates is what makes "the crates came to rest" assertable.
|
|
88
|
+
entity: options.entity,
|
|
89
|
+
// Light, and measured rather than chosen. At 6 kg the warden shoving a crate crossed 2.5 m
|
|
90
|
+
// in 3.3 s instead of 11; at 2.5 kg, six. Rapier bounds a character's push by the
|
|
91
|
+
// character's own mass and no option here exposes it, so the crate is what has to give.
|
|
92
|
+
mass: 1.2,
|
|
38
93
|
object: this.mesh,
|
|
39
94
|
physics: ctx.physics,
|
|
40
95
|
shape: CollisionShape3D.box(CRATE_SIZE, CRATE_SIZE, CRATE_SIZE),
|
|
41
96
|
});
|
|
42
97
|
}
|
|
43
98
|
|
|
44
|
-
get
|
|
45
|
-
|
|
99
|
+
get speed(): number {
|
|
100
|
+
const velocity = this.body.linearVelocity;
|
|
101
|
+
return Math.hypot(velocity.x, velocity.y, velocity.z);
|
|
46
102
|
}
|
|
47
103
|
|
|
48
|
-
|
|
49
|
-
|
|
104
|
+
/** Metres from where the opening drop left it. Zero until `markRest` has run. */
|
|
105
|
+
displacement(): number {
|
|
106
|
+
return this.mesh.position.distanceTo(this.rest);
|
|
50
107
|
}
|
|
51
108
|
|
|
52
|
-
/**
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
109
|
+
/**
|
|
110
|
+
* Put this body back at a pose without destroying it.
|
|
111
|
+
*
|
|
112
|
+
* `RigidBody3D` has no `teleport` — `CharacterBody3D` does — so the only documented way to move
|
|
113
|
+
* a dynamic body is an impulse or a force, and neither can place one. `syncToPhysics()` is
|
|
114
|
+
* undocumented but is the one member that could plausibly push the object's transform back into
|
|
115
|
+
* the backend, which is what this needs: destroying and recreating forty-four bodies instead
|
|
116
|
+
* changes the order the backend hands out handles, and that alone moved the pile by centimetres.
|
|
117
|
+
*/
|
|
118
|
+
reset(position: Vector3, quaternion: Quaternion): void {
|
|
119
|
+
this.mesh.position.copy(position);
|
|
120
|
+
this.mesh.quaternion.copy(quaternion);
|
|
121
|
+
this.body.linearVelocity = { x: 0, y: 0, z: 0 };
|
|
122
|
+
this.body.syncToPhysics();
|
|
66
123
|
}
|
|
67
124
|
|
|
68
|
-
|
|
69
|
-
|
|
125
|
+
markRest(): void {
|
|
126
|
+
this.rest.copy(this.mesh.position);
|
|
70
127
|
}
|
|
71
128
|
|
|
72
129
|
dispose(): void {
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import type { ICtx } from "@threenative/core";
|
|
2
|
+
import {
|
|
3
|
+
Area3D,
|
|
4
|
+
CollisionShape3D,
|
|
5
|
+
type IPhysicsContext,
|
|
6
|
+
type PhysicsBody3D,
|
|
7
|
+
} from "@threenative/physics";
|
|
8
|
+
import type { Object3D } from "three";
|
|
9
|
+
import { SEAL } from "../render/vault.js";
|
|
10
|
+
import type { GameState } from "../state.js";
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* The way out, and the only thing in the game that can end the run.
|
|
14
|
+
*
|
|
15
|
+
* It is an `Area3D` and nothing else: the run ends when the physics backend reports that a body
|
|
16
|
+
* has *overlapped* this volume — the warden's capsule, or a crate the warden shoved into it. No
|
|
17
|
+
* distance check, no timer, no "close enough". If the solver never reports contact the run never
|
|
18
|
+
* ends, which is the point: a proximity test would pass on a warden standing on the far side of a
|
|
19
|
+
* crate it could not actually move.
|
|
20
|
+
*/
|
|
21
|
+
export class Seal {
|
|
22
|
+
readonly area: Area3D;
|
|
23
|
+
/** The lit floor plate, so a scenario can ask whether the destination is on screen. */
|
|
24
|
+
readonly mesh: Object3D;
|
|
25
|
+
#contacts = 0;
|
|
26
|
+
|
|
27
|
+
constructor(ctx: ICtx<GameState, IPhysicsContext>, mesh: Object3D) {
|
|
28
|
+
this.mesh = mesh;
|
|
29
|
+
this.area = new Area3D({
|
|
30
|
+
entity: "seal",
|
|
31
|
+
physics: ctx.physics,
|
|
32
|
+
// Lifted clear of the floor slab: an area whose underside sits on y = 0 overlaps the fixed
|
|
33
|
+
// floor body from the first step, and the run reports itself won before anything moves.
|
|
34
|
+
position: { x: SEAL.x, y: 0.78, z: SEAL.z },
|
|
35
|
+
// Tall enough that a crate resting on the plate counts, shallow enough that a crate sailing
|
|
36
|
+
// over the kerb without stopping does not linger in it.
|
|
37
|
+
shape: CollisionShape3D.box(SEAL.half * 2, 1.2, SEAL.half * 2),
|
|
38
|
+
});
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/**
|
|
42
|
+
* Register the two things that can trip it. Returns an unsubscribe for the scene's `exit`.
|
|
43
|
+
*
|
|
44
|
+
* The area hands back the physics node itself, so "was that the warden" is an identity check
|
|
45
|
+
* against the node the scene already holds — not an id lookup, and not a name.
|
|
46
|
+
*/
|
|
47
|
+
watch(handlers: {
|
|
48
|
+
readonly isCrate: (body: PhysicsBody3D) => boolean;
|
|
49
|
+
readonly warden: PhysicsBody3D;
|
|
50
|
+
readonly onContact: (by: "crate" | "warden") => void;
|
|
51
|
+
}): () => void {
|
|
52
|
+
return this.area.on("bodyEntered", (body) => {
|
|
53
|
+
const by = body === handlers.warden ? "warden" : handlers.isCrate(body) ? "crate" : undefined;
|
|
54
|
+
// Walls and the floor slab overlap this volume too. Only the two things the brief allows to
|
|
55
|
+
// end the run are counted, and anything else is not even recorded as a contact.
|
|
56
|
+
if (by === undefined) return;
|
|
57
|
+
this.#contacts += 1;
|
|
58
|
+
handlers.onContact(by);
|
|
59
|
+
});
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
get contacts(): number {
|
|
63
|
+
return this.#contacts;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
dispose(): void {
|
|
67
|
+
this.area.dispose();
|
|
68
|
+
}
|
|
69
|
+
}
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
import type { ICtx } from "@threenative/core";
|
|
2
|
+
import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
|
|
3
|
+
import { Group, Vector3 } from "three";
|
|
4
|
+
import { wardenFigure } from "../render/warden.js";
|
|
5
|
+
import type { GameState } from "../state.js";
|
|
6
|
+
import { WARDEN_MASK } from "./Crate.js";
|
|
7
|
+
|
|
8
|
+
type GameCtx = ICtx<GameState, IPhysicsContext>;
|
|
9
|
+
|
|
10
|
+
const MOVE_SPEED = 4.5;
|
|
11
|
+
/** Capsule: total height 2 * (halfHeight + radius) = 1.12 m, centred on the body origin. */
|
|
12
|
+
const CAPSULE_HALF_HEIGHT = 0.28;
|
|
13
|
+
const CAPSULE_RADIUS = 0.28;
|
|
14
|
+
/** How far the solver has to fall short of the asked-for step before it counts as blocked. */
|
|
15
|
+
const BLOCKED_FRACTION = 0.45;
|
|
16
|
+
|
|
17
|
+
export const WARDEN_SPAWN = { x: -4.2, y: 0.62, z: 2.35 } as const;
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* The controlled character: a capsule that pushes, and a figure that leans the way it is pushing.
|
|
21
|
+
*
|
|
22
|
+
* `pushesDynamicBodies` is the whole point of this class. Its default is `false`, which matches
|
|
23
|
+
* Rapier — a character walks into a crate and the crate does not move, which on screen reads as a
|
|
24
|
+
* broken collider rather than as a default someone chose.
|
|
25
|
+
*/
|
|
26
|
+
export class Warden {
|
|
27
|
+
readonly mesh: Group;
|
|
28
|
+
readonly body: CharacterBody3D;
|
|
29
|
+
#figure: Group;
|
|
30
|
+
#odometer = 0;
|
|
31
|
+
#blockedTicks = 0;
|
|
32
|
+
#previous = new Vector3();
|
|
33
|
+
#hasPrevious = false;
|
|
34
|
+
#asked = 0;
|
|
35
|
+
#facing = 0;
|
|
36
|
+
|
|
37
|
+
constructor(ctx: GameCtx) {
|
|
38
|
+
this.mesh = new Group();
|
|
39
|
+
this.mesh.name = "warden";
|
|
40
|
+
this.#figure = wardenFigure();
|
|
41
|
+
// The capsule is centred on the body origin, so a figure modelled standing on y = 0 floats
|
|
42
|
+
// exactly halfHeight + radius above every floor it lands on unless it is offset back down.
|
|
43
|
+
this.#figure.position.y = -(CAPSULE_HALF_HEIGHT + CAPSULE_RADIUS);
|
|
44
|
+
this.mesh.add(this.#figure);
|
|
45
|
+
this.mesh.position.set(WARDEN_SPAWN.x, WARDEN_SPAWN.y, WARDEN_SPAWN.z);
|
|
46
|
+
ctx.add(this.mesh);
|
|
47
|
+
this.body = new CharacterBody3D({
|
|
48
|
+
autostep: { includeDynamicBodies: false, maxHeight: 0.32, minWidth: 0.2 },
|
|
49
|
+
collisionMask: WARDEN_MASK,
|
|
50
|
+
// Named, or the runtime contact log records this body as an anonymous id and a `contacts`
|
|
51
|
+
// assertion has nothing to match on. The registry name (`ctx.entities.add("player", ...)`)
|
|
52
|
+
// is a different namespace and does not reach the physics observation.
|
|
53
|
+
entity: "player",
|
|
54
|
+
object: this.mesh,
|
|
55
|
+
physics: ctx.physics,
|
|
56
|
+
pushesDynamicBodies: true,
|
|
57
|
+
shape: CollisionShape3D.capsule(CAPSULE_HALF_HEIGHT, CAPSULE_RADIUS),
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
* One fixed step. `move` is the intent in world XZ, already clamped to unit length; the replay
|
|
63
|
+
* check hands the same scripted vector in that the keyboard would have produced.
|
|
64
|
+
*/
|
|
65
|
+
update(dt: number, move: { readonly x: number; readonly z: number }): void {
|
|
66
|
+
// Both measurements below read LAST tick's ask against LAST tick's delivery, and they have to.
|
|
67
|
+
//
|
|
68
|
+
// `moveAndSlide` queues motion for the bulk step; `mesh.position` still holds the previous
|
|
69
|
+
// transform until the solver writes it, some time after this function returns. Comparing the
|
|
70
|
+
// ask with `mesh.position` inside the same call therefore always measures zero delivered
|
|
71
|
+
// motion, and "the warden was blocked" becomes "the warden pressed a key" — measured, it
|
|
72
|
+
// counted 400 blocked ticks in a 400-tick run in which the warden crossed six metres.
|
|
73
|
+
if (this.#hasPrevious) {
|
|
74
|
+
const delivered = Math.hypot(
|
|
75
|
+
this.mesh.position.x - this.#previous.x,
|
|
76
|
+
this.mesh.position.z - this.#previous.z,
|
|
77
|
+
);
|
|
78
|
+
this.#odometer += this.mesh.position.distanceTo(this.#previous);
|
|
79
|
+
if (this.#asked > 0.004 && delivered < this.#asked * BLOCKED_FRACTION)
|
|
80
|
+
this.#blockedTicks += 1;
|
|
81
|
+
}
|
|
82
|
+
this.#previous.copy(this.mesh.position);
|
|
83
|
+
this.body.velocity.x = move.x * MOVE_SPEED;
|
|
84
|
+
this.body.velocity.z = move.z * MOVE_SPEED;
|
|
85
|
+
this.#asked = Math.hypot(this.body.velocity.x, this.body.velocity.z) * dt;
|
|
86
|
+
this.body.moveAndSlide(dt);
|
|
87
|
+
this.#hasPrevious = true;
|
|
88
|
+
if (move.x !== 0 || move.z !== 0) {
|
|
89
|
+
const target = Math.atan2(move.x, move.z);
|
|
90
|
+
// Shortest-arc turn, framerate independent, so the figure faces the shove rather than
|
|
91
|
+
// snapping between the four arrow directions.
|
|
92
|
+
const delta = Math.atan2(Math.sin(target - this.#facing), Math.cos(target - this.#facing));
|
|
93
|
+
this.#facing += delta * (1 - Math.exp(-dt / 0.06));
|
|
94
|
+
this.#figure.rotation.y = this.#facing;
|
|
95
|
+
}
|
|
96
|
+
// Lean into the push. Purely cosmetic, and it is most of what makes the shove read.
|
|
97
|
+
const lean = Math.min(0.28, Math.hypot(move.x, move.z) * 0.28);
|
|
98
|
+
this.#figure.rotation.x += (lean - this.#figure.rotation.x) * (1 - Math.exp(-dt / 0.09));
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
teleport(position: { readonly x: number; readonly y: number; readonly z: number }): void {
|
|
102
|
+
// Velocity survives a teleport, and `velocity.y` is the component this class never writes —
|
|
103
|
+
// gravity accumulates into it every step. Two replay passes that start from different
|
|
104
|
+
// vertical speeds resolve their first contacts differently, and the run that is supposed to
|
|
105
|
+
// prove determinism reports 0.28 m of drift. Reset the whole vector, not the two axes the
|
|
106
|
+
// caller happens to set.
|
|
107
|
+
this.body.velocity.set(0, 0, 0);
|
|
108
|
+
this.body.teleport(position);
|
|
109
|
+
this.mesh.position.set(position.x, position.y, position.z);
|
|
110
|
+
this.#previous.copy(this.mesh.position);
|
|
111
|
+
this.#hasPrevious = false;
|
|
112
|
+
this.#asked = 0;
|
|
113
|
+
}
|
|
114
|
+
|
|
115
|
+
get fallSpeed(): number {
|
|
116
|
+
return this.body.velocity.y;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
get grounded(): boolean {
|
|
120
|
+
return this.body.grounded;
|
|
121
|
+
}
|
|
122
|
+
|
|
123
|
+
get blockedTicks(): number {
|
|
124
|
+
return this.#blockedTicks;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
get odometer(): number {
|
|
128
|
+
return this.#odometer;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
dispose(): void {
|
|
132
|
+
this.body.dispose();
|
|
133
|
+
this.mesh.removeFromParent();
|
|
134
|
+
}
|
|
135
|
+
}
|
|
@@ -1,30 +1,32 @@
|
|
|
1
1
|
import { defineGame } from "@threenative/core";
|
|
2
2
|
import { playtest } from "@threenative/core/playtest";
|
|
3
|
+
import type { IPhysicsContext } from "@threenative/physics";
|
|
3
4
|
import { rapier } from "@threenative/physics";
|
|
4
5
|
import config from "../threenative.config.js";
|
|
5
|
-
import
|
|
6
|
-
import { Boot } from "./scenes/Boot.js";
|
|
7
|
-
import { Puzzle } from "./scenes/Puzzle.js";
|
|
6
|
+
import { Play } from "./scenes/Play.js";
|
|
8
7
|
import type { GameState } from "./state.js";
|
|
9
8
|
|
|
10
|
-
|
|
9
|
+
// game.state is the single store: the fixed-step loop writes it, and React/playtests read it.
|
|
10
|
+
const game = defineGame<GameState, IPhysicsContext>({
|
|
11
11
|
input: {
|
|
12
|
+
// The four directions of `input.vector("move")`. Arrows are what the sealed proof presses;
|
|
13
|
+
// WASD is here so a human plays the same game.
|
|
12
14
|
move: {
|
|
13
15
|
down: ["ArrowDown", "KeyS"],
|
|
14
16
|
left: ["ArrowLeft", "KeyA"],
|
|
15
17
|
right: ["ArrowRight", "KeyD"],
|
|
16
18
|
up: ["ArrowUp", "KeyW"],
|
|
17
19
|
},
|
|
18
|
-
|
|
20
|
+
// V runs the vault twice on the same scripted input and reports whether it landed the same.
|
|
21
|
+
verify: { keys: ["KeyV"] },
|
|
19
22
|
restart: { keys: ["KeyR"] },
|
|
20
|
-
swing: { keys: ["KeyF"] },
|
|
21
23
|
},
|
|
22
|
-
plugins: [rapier(
|
|
24
|
+
plugins: [rapier(), playtest()],
|
|
23
25
|
display: config.display,
|
|
24
26
|
render: config.renderer,
|
|
25
|
-
scenes: {
|
|
26
|
-
seed:
|
|
27
|
-
start: "
|
|
27
|
+
scenes: { play: Play },
|
|
28
|
+
seed: 6132,
|
|
29
|
+
start: "play",
|
|
28
30
|
});
|
|
29
31
|
|
|
30
32
|
export default game;
|
|
@@ -37,10 +39,12 @@ export default game;
|
|
|
37
39
|
* state instead, which keeps one source of truth on the side that owns the simulation.
|
|
38
40
|
*/
|
|
39
41
|
game.ui.onIntent((intent) => {
|
|
40
|
-
if (intent === "restart") void game.goto("
|
|
42
|
+
if (intent === "restart") void game.goto("play");
|
|
41
43
|
if (intent === "pause") game.pause();
|
|
42
44
|
if (intent === "resume") game.resume();
|
|
43
45
|
game.state.set({
|
|
46
|
+
// `game.ui.connected` is true only once the UI announced itself, which is what tells an
|
|
47
|
+
// overlay that never came up apart from a game whose HUD is simply empty.
|
|
44
48
|
uiReady: game.ui.connected,
|
|
45
49
|
...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
|
|
46
50
|
});
|
|
@@ -1,37 +1,72 @@
|
|
|
1
|
+
// Ordinary Three.js — ThreeNative does not read this file.
|
|
2
|
+
//
|
|
3
|
+
// One fixed three-quarter shot of the whole vault, because the reference is a room portrait: the
|
|
4
|
+
// warden, the pile, the phase crates and the seal are all supposed to be legible on the first
|
|
5
|
+
// screen, and a camera that trails the character loses two of the four every time it moves.
|
|
6
|
+
//
|
|
7
|
+
// It still breathes. `settle` eases the framing in over the opening drop, and `nudge` lets the
|
|
8
|
+
// shot drift a fraction of a metre toward the warden so the picture is not completely static.
|
|
1
9
|
import type { PerspectiveCamera, Vector3 } from "three";
|
|
10
|
+
import { Vector3 as Vec3 } from "three";
|
|
2
11
|
|
|
3
|
-
const
|
|
4
|
-
|
|
5
|
-
/**
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
12
|
+
export const VAULT_SHOT = {
|
|
13
|
+
fov: 31,
|
|
14
|
+
/**
|
|
15
|
+
* Where the camera sits: about 44 degrees above the floor and 30 degrees off the room's axis.
|
|
16
|
+
*
|
|
17
|
+
* The yaw is the part that matters, and about twenty degrees is the window. An axis-aligned shot puts the near wall across the bottom of
|
|
18
|
+
* the frame as a flat band and flattens the whole room into a rectangle; swinging the camera
|
|
19
|
+
* onto the corner is what makes the left wall recede and gives the picture the diagonal the
|
|
20
|
+
* reference is built on; past thirty the room reads as a diamond with dead corners.
|
|
21
|
+
*
|
|
22
|
+
* The numbers are solved rather than eyeballed. Four attempts at nudging them by hand each cost
|
|
23
|
+
* a build and a screenshot and each landed with the room cropped on one side; projecting the
|
|
24
|
+
* room's eight outer corners through this exact camera and binary-searching the distance found
|
|
25
|
+
* a fit in one pass. Yaw 17 degrees, elevation 41, the room spanning 1.84 of the 2.0 of clip
|
|
26
|
+
* space vertically — so the near wall is just cropped, as it is in the reference — and biased a
|
|
27
|
+
* little right of centre, which is where the HUD is not.
|
|
28
|
+
*/
|
|
29
|
+
position: new Vec3(-4.35, 13.33, 14.72),
|
|
30
|
+
/** What it points at: the middle of the room, biased toward the seal corner. */
|
|
31
|
+
target: new Vec3(0, 0.4, 0.5),
|
|
32
|
+
/** How far the shot is allowed to drift toward the warden, in metres. */
|
|
33
|
+
drift: 0.1,
|
|
34
|
+
} as const;
|
|
11
35
|
|
|
12
|
-
export
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
camera.far = 120;
|
|
16
|
-
camera.position.set(0, HEIGHT, BACK);
|
|
17
|
-
camera.lookAt(LOOK_AT.x, LOOK_AT.y, LOOK_AT.z);
|
|
18
|
-
camera.updateProjectionMatrix();
|
|
36
|
+
export interface IVaultCamera {
|
|
37
|
+
readonly snap: () => void;
|
|
38
|
+
readonly follow: (subject: Vector3, dt: number) => void;
|
|
19
39
|
}
|
|
20
40
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
const
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
41
|
+
export function createVaultCamera(camera: PerspectiveCamera): IVaultCamera {
|
|
42
|
+
camera.fov = VAULT_SHOT.fov;
|
|
43
|
+
camera.near = 0.5;
|
|
44
|
+
camera.far = 90;
|
|
45
|
+
camera.updateProjectionMatrix();
|
|
46
|
+
|
|
47
|
+
const desired = new Vec3();
|
|
48
|
+
const aim = new Vec3();
|
|
49
|
+
const currentAim = VAULT_SHOT.target.clone();
|
|
50
|
+
|
|
51
|
+
const snap = (): void => {
|
|
52
|
+
camera.position.copy(VAULT_SHOT.position);
|
|
53
|
+
currentAim.copy(VAULT_SHOT.target);
|
|
54
|
+
camera.lookAt(currentAim);
|
|
55
|
+
};
|
|
56
|
+
|
|
57
|
+
const follow = (subject: Vector3, dt: number): void => {
|
|
58
|
+
// Drift a fraction of a metre toward the warden and no further. The shot is the room; this
|
|
59
|
+
// is only enough parallax that the picture is not a still.
|
|
60
|
+
aim.copy(subject).sub(VAULT_SHOT.target);
|
|
61
|
+
aim.y = 0;
|
|
62
|
+
if (aim.lengthSq() > 1e-6) aim.normalize().multiplyScalar(VAULT_SHOT.drift);
|
|
63
|
+
else aim.set(0, 0, 0);
|
|
64
|
+
desired.copy(VAULT_SHOT.position).add(aim);
|
|
65
|
+
// 1 - e^(-dt/tau) is the framerate-independent form of a lerp: the same second of drift at
|
|
66
|
+
// 30 fps and at 120 fps ends in the same place.
|
|
67
|
+
camera.position.lerp(desired, 1 - Math.exp(-dt / 0.9));
|
|
68
|
+
camera.lookAt(currentAim);
|
|
69
|
+
};
|
|
70
|
+
|
|
71
|
+
return { follow, snap };
|
|
37
72
|
}
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
// Ordinary Three.js — ThreeNative does not read this file.
|
|
2
|
+
//
|
|
3
|
+
// A crate is a rounded box with plank braces nailed across each side in an X. Both parts are
|
|
4
|
+
// merged into ONE geometry carrying two material groups, so a crate costs two draws instead of
|
|
5
|
+
// nine, and forty of them stay affordable while every one is a separately simulated body.
|
|
6
|
+
import { BoxGeometry, type BufferGeometry, Matrix4 } from "three";
|
|
7
|
+
import { mergeGeometries } from "three/addons/utils/BufferGeometryUtils.js";
|
|
8
|
+
import { roundedBox } from "./shapes.js";
|
|
9
|
+
|
|
10
|
+
export const CRATE_SIZE = 0.92;
|
|
11
|
+
|
|
12
|
+
let cached: BufferGeometry | undefined;
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* Group 0 is the crate body, group 1 is the brace timber. Build a crate with
|
|
16
|
+
* `new Mesh(crateGeometry(), [colour, braceMaterial])`.
|
|
17
|
+
*/
|
|
18
|
+
export function crateGeometry(): BufferGeometry {
|
|
19
|
+
if (cached !== undefined) return cached;
|
|
20
|
+
const half = CRATE_SIZE / 2;
|
|
21
|
+
const body = roundedBox(CRATE_SIZE, CRATE_SIZE, CRATE_SIZE, 0.075, 3).clone();
|
|
22
|
+
|
|
23
|
+
const planks: BufferGeometry[] = [];
|
|
24
|
+
const diagonal = CRATE_SIZE * 1.24;
|
|
25
|
+
// Four side faces and the lid. The underside is never seen and is not paid for.
|
|
26
|
+
const faces: readonly {
|
|
27
|
+
readonly rotation: Matrix4;
|
|
28
|
+
readonly offset: [number, number, number];
|
|
29
|
+
}[] = [
|
|
30
|
+
{ offset: [0, 0, half], rotation: new Matrix4() },
|
|
31
|
+
{ offset: [0, 0, -half], rotation: new Matrix4().makeRotationY(Math.PI) },
|
|
32
|
+
{ offset: [half, 0, 0], rotation: new Matrix4().makeRotationY(Math.PI / 2) },
|
|
33
|
+
{ offset: [-half, 0, 0], rotation: new Matrix4().makeRotationY(-Math.PI / 2) },
|
|
34
|
+
{ offset: [0, half, 0], rotation: new Matrix4().makeRotationX(-Math.PI / 2) },
|
|
35
|
+
];
|
|
36
|
+
for (const face of faces) {
|
|
37
|
+
for (const sign of [1, -1]) {
|
|
38
|
+
const plank = new BoxGeometry(diagonal, 0.058, 0.028);
|
|
39
|
+
// `roundedBox` welds away its UVs, and `mergeGeometries` refuses a set of geometries whose
|
|
40
|
+
// attributes do not match exactly — it returns null and logs, which is easy to miss.
|
|
41
|
+
plank.deleteAttribute("uv");
|
|
42
|
+
plank.applyMatrix4(new Matrix4().makeRotationZ((sign * Math.PI) / 4));
|
|
43
|
+
plank.applyMatrix4(new Matrix4().makeTranslation(0, 0, 0.01));
|
|
44
|
+
plank.applyMatrix4(face.rotation);
|
|
45
|
+
plank.applyMatrix4(
|
|
46
|
+
new Matrix4().makeTranslation(face.offset[0], face.offset[1], face.offset[2]),
|
|
47
|
+
);
|
|
48
|
+
planks.push(plank);
|
|
49
|
+
}
|
|
50
|
+
// A rail along the top and bottom of each side face, which is what stops the X reading as a
|
|
51
|
+
// sticker and starts it reading as carpentry.
|
|
52
|
+
for (const edge of [half - 0.1, -half + 0.1]) {
|
|
53
|
+
const rail = new BoxGeometry(CRATE_SIZE * 0.98, 0.062, 0.028);
|
|
54
|
+
rail.deleteAttribute("uv");
|
|
55
|
+
rail.applyMatrix4(new Matrix4().makeTranslation(0, edge, 0.01));
|
|
56
|
+
rail.applyMatrix4(face.rotation);
|
|
57
|
+
rail.applyMatrix4(
|
|
58
|
+
new Matrix4().makeTranslation(face.offset[0], face.offset[1], face.offset[2]),
|
|
59
|
+
);
|
|
60
|
+
planks.push(rail);
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
const braces = mergeGeometries(planks, false);
|
|
65
|
+
if (braces === null) throw new Error("Crate braces failed to merge.");
|
|
66
|
+
const merged = mergeGeometries([body, braces], true);
|
|
67
|
+
if (merged === null) throw new Error("Crate geometry failed to merge.");
|
|
68
|
+
cached = merged;
|
|
69
|
+
return merged;
|
|
70
|
+
}
|