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
|
@@ -0,0 +1,412 @@
|
|
|
1
|
+
import { CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
|
|
2
|
+
import {
|
|
3
|
+
type BufferGeometry,
|
|
4
|
+
Group,
|
|
5
|
+
IcosahedronGeometry,
|
|
6
|
+
LatheGeometry,
|
|
7
|
+
type Material,
|
|
8
|
+
Mesh,
|
|
9
|
+
MeshStandardMaterial,
|
|
10
|
+
type Object3D,
|
|
11
|
+
Vector2,
|
|
12
|
+
Vector3,
|
|
13
|
+
} from "three";
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* Props that come apart when you shoot them.
|
|
17
|
+
*
|
|
18
|
+
* ## Why this is worth having
|
|
19
|
+
*
|
|
20
|
+
* A world where every round lands on something immovable teaches the player that shooting has
|
|
21
|
+
* no consequence outside the scoreboard. One pot that bursts into shards which then bounce down
|
|
22
|
+
* the steps does more for how a weapon feels than any amount of tuning on the weapon itself.
|
|
23
|
+
*
|
|
24
|
+
* ## The two halves
|
|
25
|
+
*
|
|
26
|
+
* `BreakableField` owns mechanism: intact props, the shard pool, the physics bodies, and the
|
|
27
|
+
* lifetime that returns a shard to the pool. `KIND_STYLES` below is this game's content and can
|
|
28
|
+
* be replaced wholesale — a different game keeps the field and writes its own pots.
|
|
29
|
+
*
|
|
30
|
+
* ## Real bodies, borrowed briefly
|
|
31
|
+
*
|
|
32
|
+
* Shards are actual dynamic Rapier bodies, so they land on the steps and pile against walls
|
|
33
|
+
* instead of falling through the world. But a dynamic body is a permanent cost in the
|
|
34
|
+
* simulation, and a round is a hundred-odd seconds of shooting — so a shard's body exists only
|
|
35
|
+
* while the shard is moving. `SHARD_SECONDS` after the break, the body is disposed and the mesh
|
|
36
|
+
* goes back to the pool. That keeps the live-body count bounded by `maxLiveShards` however many
|
|
37
|
+
* pots the player shoots.
|
|
38
|
+
*
|
|
39
|
+
* The shard meshes themselves are allocated once, up front, at zero opacity and in the scene —
|
|
40
|
+
* building a mesh mid-round is the WebGPU pipeline stall recorded in `Rifle` and `gunfx`.
|
|
41
|
+
*/
|
|
42
|
+
|
|
43
|
+
export type BreakableKind = "pot" | "jar" | "bottle";
|
|
44
|
+
|
|
45
|
+
type KindStyle = {
|
|
46
|
+
/** Lathe profile in metres: the silhouette that gets turned about the Y axis. */
|
|
47
|
+
readonly profile: readonly [number, number][];
|
|
48
|
+
readonly colour: number;
|
|
49
|
+
readonly roughness: number;
|
|
50
|
+
readonly metalness: number;
|
|
51
|
+
readonly shardColour: number;
|
|
52
|
+
readonly shardCount: number;
|
|
53
|
+
/** Half-extents of the raycast box that stands in for this prop, in metres. */
|
|
54
|
+
readonly hitHalf: readonly [number, number, number];
|
|
55
|
+
/** How hard the pieces leave, in metres per second. */
|
|
56
|
+
readonly burst: number;
|
|
57
|
+
};
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Three vessels with clearly different silhouettes. Reading which one you are looking at from
|
|
61
|
+
* across the plaza matters more than any of their surface detail: a row of identical pots is
|
|
62
|
+
* scenery, and three different ones is a place where people live.
|
|
63
|
+
*/
|
|
64
|
+
const KIND_STYLES: Readonly<Record<BreakableKind, KindStyle>> = {
|
|
65
|
+
// Tall amphora: narrow foot, full shoulder, pinched neck, flared lip.
|
|
66
|
+
pot: {
|
|
67
|
+
profile: [
|
|
68
|
+
[0.0, 0.0],
|
|
69
|
+
[0.09, 0.0],
|
|
70
|
+
[0.1, 0.03],
|
|
71
|
+
[0.14, 0.14],
|
|
72
|
+
[0.2, 0.3],
|
|
73
|
+
[0.19, 0.44],
|
|
74
|
+
[0.12, 0.56],
|
|
75
|
+
[0.1, 0.62],
|
|
76
|
+
[0.13, 0.66],
|
|
77
|
+
[0.12, 0.68],
|
|
78
|
+
],
|
|
79
|
+
colour: 0xa8592f,
|
|
80
|
+
roughness: 0.85,
|
|
81
|
+
metalness: 0.02,
|
|
82
|
+
shardColour: 0x9c5330,
|
|
83
|
+
shardCount: 9,
|
|
84
|
+
hitHalf: [0.2, 0.35, 0.2],
|
|
85
|
+
burst: 3.4,
|
|
86
|
+
},
|
|
87
|
+
// Squat storage jar: wide, low, straight-sided.
|
|
88
|
+
jar: {
|
|
89
|
+
profile: [
|
|
90
|
+
[0.0, 0.0],
|
|
91
|
+
[0.13, 0.0],
|
|
92
|
+
[0.17, 0.05],
|
|
93
|
+
[0.19, 0.18],
|
|
94
|
+
[0.17, 0.3],
|
|
95
|
+
[0.14, 0.34],
|
|
96
|
+
[0.15, 0.36],
|
|
97
|
+
],
|
|
98
|
+
colour: 0xc4a074,
|
|
99
|
+
roughness: 0.9,
|
|
100
|
+
metalness: 0.02,
|
|
101
|
+
shardColour: 0xb08f66,
|
|
102
|
+
shardCount: 8,
|
|
103
|
+
hitHalf: [0.19, 0.19, 0.19],
|
|
104
|
+
burst: 3.0,
|
|
105
|
+
},
|
|
106
|
+
// Glass bottle: thin, tall neck, and it goes further when it lets go.
|
|
107
|
+
bottle: {
|
|
108
|
+
profile: [
|
|
109
|
+
[0.0, 0.0],
|
|
110
|
+
[0.055, 0.0],
|
|
111
|
+
[0.06, 0.02],
|
|
112
|
+
[0.06, 0.16],
|
|
113
|
+
[0.035, 0.24],
|
|
114
|
+
[0.028, 0.3],
|
|
115
|
+
[0.034, 0.32],
|
|
116
|
+
],
|
|
117
|
+
colour: 0x2f5f4a,
|
|
118
|
+
roughness: 0.18,
|
|
119
|
+
metalness: 0.05,
|
|
120
|
+
shardColour: 0x3f7a60,
|
|
121
|
+
shardCount: 7,
|
|
122
|
+
hitHalf: [0.07, 0.17, 0.07],
|
|
123
|
+
burst: 4.2,
|
|
124
|
+
},
|
|
125
|
+
};
|
|
126
|
+
|
|
127
|
+
/** Seconds a shard keeps its physics body before it is recycled. */
|
|
128
|
+
const SHARD_SECONDS = 5.5;
|
|
129
|
+
/** Seconds of that life spent fading, so nothing blinks out of existence. */
|
|
130
|
+
const SHARD_FADE_SECONDS = 1.1;
|
|
131
|
+
|
|
132
|
+
type Prop = {
|
|
133
|
+
readonly kind: BreakableKind;
|
|
134
|
+
readonly group: Group;
|
|
135
|
+
readonly hitMesh: Mesh;
|
|
136
|
+
readonly origin: Vector3;
|
|
137
|
+
broken: boolean;
|
|
138
|
+
};
|
|
139
|
+
|
|
140
|
+
type Shard = {
|
|
141
|
+
readonly mesh: Mesh;
|
|
142
|
+
readonly material: MeshStandardMaterial;
|
|
143
|
+
body: RigidBody3D | undefined;
|
|
144
|
+
age: number;
|
|
145
|
+
live: boolean;
|
|
146
|
+
};
|
|
147
|
+
|
|
148
|
+
const scratchDirection = new Vector3();
|
|
149
|
+
const scratchOffset = new Vector3();
|
|
150
|
+
|
|
151
|
+
/** The vessel silhouette, turned about Y. `LatheGeometry` is why a pot costs six lines. */
|
|
152
|
+
function latheFrom(profile: readonly [number, number][], segments: number): BufferGeometry {
|
|
153
|
+
return new LatheGeometry(
|
|
154
|
+
profile.map(([x, y]) => new Vector2(x, y)),
|
|
155
|
+
segments,
|
|
156
|
+
);
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
export class BreakableField {
|
|
160
|
+
readonly #scene: Object3D;
|
|
161
|
+
readonly #physics: IPhysicsContext;
|
|
162
|
+
readonly #rng: () => number;
|
|
163
|
+
readonly #props: Prop[] = [];
|
|
164
|
+
readonly #shards: Shard[] = [];
|
|
165
|
+
readonly #shardGeometry: BufferGeometry;
|
|
166
|
+
#shardCursor = 0;
|
|
167
|
+
#broken = 0;
|
|
168
|
+
#liveShards = 0;
|
|
169
|
+
/** Dead shards stop being submitted once their pipeline exists. See `settle`. */
|
|
170
|
+
#settled = false;
|
|
171
|
+
|
|
172
|
+
constructor(
|
|
173
|
+
scene: Object3D,
|
|
174
|
+
physics: IPhysicsContext,
|
|
175
|
+
rng: () => number,
|
|
176
|
+
options: { maxLiveShards?: number } = {},
|
|
177
|
+
) {
|
|
178
|
+
this.#scene = scene;
|
|
179
|
+
this.#physics = physics;
|
|
180
|
+
this.#rng = rng;
|
|
181
|
+
// One angular solid, scaled per shard. Pottery does not break into spheres, and an
|
|
182
|
+
// icosahedron at detail 0 has the flat facets that catch the key light like a broken edge.
|
|
183
|
+
this.#shardGeometry = new IcosahedronGeometry(1, 0);
|
|
184
|
+
const capacity = options.maxLiveShards ?? 27;
|
|
185
|
+
for (let index = 0; index < capacity; index += 1) {
|
|
186
|
+
const material = new MeshStandardMaterial({
|
|
187
|
+
color: 0xffffff,
|
|
188
|
+
metalness: 0.02,
|
|
189
|
+
opacity: 0,
|
|
190
|
+
roughness: 0.85,
|
|
191
|
+
transparent: true,
|
|
192
|
+
});
|
|
193
|
+
const mesh = new Mesh(this.#shardGeometry, material);
|
|
194
|
+
// Present from the first frame at a size nothing can see, so the pipeline for this
|
|
195
|
+
// material is built during loading rather than on the frame a pot bursts.
|
|
196
|
+
mesh.scale.setScalar(0.0001);
|
|
197
|
+
mesh.visible = true;
|
|
198
|
+
// Flying shards are centimetres wide and short-lived; submitting each to
|
|
199
|
+
// the town-wide sun map costs a draw for a sub-pixel silhouette.
|
|
200
|
+
mesh.castShadow = false;
|
|
201
|
+
mesh.frustumCulled = false;
|
|
202
|
+
scene.add(mesh);
|
|
203
|
+
this.#shards.push({ mesh, material, body: undefined, age: 0, live: false });
|
|
204
|
+
}
|
|
205
|
+
}
|
|
206
|
+
|
|
207
|
+
/** Props broken this round. The playtest gate for "a shot vessel actually comes apart". */
|
|
208
|
+
get broken(): number {
|
|
209
|
+
return this.#broken;
|
|
210
|
+
}
|
|
211
|
+
|
|
212
|
+
/** Shards currently carrying a physics body — bounded by the pool, never by the round length. */
|
|
213
|
+
get liveShards(): number {
|
|
214
|
+
return this.#liveShards;
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
/**
|
|
218
|
+
* Stand a vessel at `position`. The returned mesh is the raycast proxy, not the visible
|
|
219
|
+
* geometry: a lathe with a hollow interior gives a raycast an inside face to hit, and the
|
|
220
|
+
* player would watch rounds pass through the near wall and mark the far one.
|
|
221
|
+
*/
|
|
222
|
+
add(kind: BreakableKind, position: { x: number; y: number; z: number }, yaw = 0): Mesh {
|
|
223
|
+
const style = KIND_STYLES[kind];
|
|
224
|
+
const group = new Group();
|
|
225
|
+
group.position.set(position.x, position.y, position.z);
|
|
226
|
+
group.rotation.y = yaw;
|
|
227
|
+
const shell = new Mesh(
|
|
228
|
+
latheFrom(style.profile, 20),
|
|
229
|
+
new MeshStandardMaterial({
|
|
230
|
+
color: style.colour,
|
|
231
|
+
metalness: style.metalness,
|
|
232
|
+
roughness: style.roughness,
|
|
233
|
+
}),
|
|
234
|
+
);
|
|
235
|
+
// The vessels are small moving props. Keep their lit volume and received
|
|
236
|
+
// town shadows, but leave the 2048 px sun pass to architectural casters.
|
|
237
|
+
shell.castShadow = false;
|
|
238
|
+
shell.receiveShadow = true;
|
|
239
|
+
group.add(shell);
|
|
240
|
+
|
|
241
|
+
const [hx, hy, hz] = style.hitHalf;
|
|
242
|
+
const hitMesh = new Mesh(this.#shardGeometry, new MeshStandardMaterial({ visible: false }));
|
|
243
|
+
hitMesh.scale.set(hx, hy, hz);
|
|
244
|
+
hitMesh.position.y = hy;
|
|
245
|
+
hitMesh.visible = true;
|
|
246
|
+
group.add(hitMesh);
|
|
247
|
+
this.#scene.add(group);
|
|
248
|
+
|
|
249
|
+
const prop: Prop = {
|
|
250
|
+
kind,
|
|
251
|
+
group,
|
|
252
|
+
hitMesh,
|
|
253
|
+
origin: new Vector3(position.x, position.y, position.z),
|
|
254
|
+
broken: false,
|
|
255
|
+
};
|
|
256
|
+
// The raycast hands back the struck object; this is how the scene gets from a hit to the
|
|
257
|
+
// prop without a lookup table that can fall out of step with the scene graph.
|
|
258
|
+
hitMesh.userData.breakable = prop;
|
|
259
|
+
this.#props.push(prop);
|
|
260
|
+
return hitMesh;
|
|
261
|
+
}
|
|
262
|
+
|
|
263
|
+
/** Every raycast proxy, for the scene's `hittable` list. */
|
|
264
|
+
hittable(): Object3D[] {
|
|
265
|
+
return this.#props.map((prop) => prop.hitMesh);
|
|
266
|
+
}
|
|
267
|
+
|
|
268
|
+
/**
|
|
269
|
+
* Take a prop apart. Returns the world point the break happened at, or undefined when the
|
|
270
|
+
* object struck was not an intact breakable — so a caller can branch on one call.
|
|
271
|
+
*/
|
|
272
|
+
shatter(struck: Object3D, at: Vector3, direction: Vector3): Vector3 | undefined {
|
|
273
|
+
const prop = struck.userData.breakable as Prop | undefined;
|
|
274
|
+
if (prop === undefined || prop.broken) return undefined;
|
|
275
|
+
prop.broken = true;
|
|
276
|
+
this.#broken += 1;
|
|
277
|
+
prop.group.visible = false;
|
|
278
|
+
const style = KIND_STYLES[prop.kind];
|
|
279
|
+
scratchDirection.copy(direction).normalize();
|
|
280
|
+
for (let index = 0; index < style.shardCount; index += 1) {
|
|
281
|
+
this.#launchShard(prop, style, index);
|
|
282
|
+
}
|
|
283
|
+
return at;
|
|
284
|
+
}
|
|
285
|
+
|
|
286
|
+
/** Age every live shard, fade the dying ones, and hand settled bodies back to the simulation. */
|
|
287
|
+
update(dt: number): void {
|
|
288
|
+
for (const shard of this.#shards) {
|
|
289
|
+
if (!shard.live) continue;
|
|
290
|
+
shard.age += dt;
|
|
291
|
+
if (shard.age >= SHARD_SECONDS) {
|
|
292
|
+
this.#retire(shard);
|
|
293
|
+
continue;
|
|
294
|
+
}
|
|
295
|
+
const remaining = SHARD_SECONDS - shard.age;
|
|
296
|
+
shard.material.opacity =
|
|
297
|
+
remaining >= SHARD_FADE_SECONDS ? 1 : Math.max(0, remaining / SHARD_FADE_SECONDS);
|
|
298
|
+
}
|
|
299
|
+
}
|
|
300
|
+
|
|
301
|
+
/**
|
|
302
|
+
* Stop submitting the shards that are not flying.
|
|
303
|
+
*
|
|
304
|
+
* Every shard is resident from frame one at a size nothing can see, so its pipeline compiles
|
|
305
|
+
* during loading; the cost is a draw per dead shard forever, and on a phone the draw call is the
|
|
306
|
+
* expensive part, not the triangles. Once compiled the pipeline is cached, so `#launchShard`
|
|
307
|
+
* re-showing a shard is free.
|
|
308
|
+
*/
|
|
309
|
+
settle(): void {
|
|
310
|
+
this.#settled = true;
|
|
311
|
+
for (const shard of this.#shards) {
|
|
312
|
+
if (!shard.live) shard.mesh.visible = false;
|
|
313
|
+
}
|
|
314
|
+
}
|
|
315
|
+
|
|
316
|
+
/** Registered as an entity so a scenario can assert a shot vessel came apart and cleaned up. */
|
|
317
|
+
debug(): { broken: number; liveShards: number; props: number; shardCapacity: number } {
|
|
318
|
+
return {
|
|
319
|
+
broken: this.#broken,
|
|
320
|
+
liveShards: this.#liveShards,
|
|
321
|
+
props: this.#props.length,
|
|
322
|
+
shardCapacity: this.#shards.length,
|
|
323
|
+
};
|
|
324
|
+
}
|
|
325
|
+
|
|
326
|
+
dispose(): void {
|
|
327
|
+
for (const shard of this.#shards) {
|
|
328
|
+
shard.body?.dispose();
|
|
329
|
+
shard.material.dispose();
|
|
330
|
+
shard.mesh.removeFromParent();
|
|
331
|
+
}
|
|
332
|
+
this.#shards.length = 0;
|
|
333
|
+
for (const prop of this.#props) {
|
|
334
|
+
prop.group.traverse((object) => {
|
|
335
|
+
const mesh = object as Mesh;
|
|
336
|
+
if (mesh.isMesh === true) {
|
|
337
|
+
mesh.geometry.dispose();
|
|
338
|
+
(mesh.material as Material).dispose();
|
|
339
|
+
}
|
|
340
|
+
});
|
|
341
|
+
prop.group.removeFromParent();
|
|
342
|
+
}
|
|
343
|
+
this.#props.length = 0;
|
|
344
|
+
this.#shardGeometry.dispose();
|
|
345
|
+
}
|
|
346
|
+
|
|
347
|
+
#launchShard(prop: Prop, style: KindStyle, index: number): void {
|
|
348
|
+
const shard = this.#shards[this.#shardCursor % this.#shards.length];
|
|
349
|
+
this.#shardCursor += 1;
|
|
350
|
+
if (shard === undefined) return;
|
|
351
|
+
// Stealing a still-flying shard is how the pool stays bounded: the newest break is the one
|
|
352
|
+
// the player is looking at, and an older pile losing a piece is not something they can see.
|
|
353
|
+
if (shard.live) this.#retire(shard);
|
|
354
|
+
|
|
355
|
+
const rng = this.#rng;
|
|
356
|
+
// Pottery breaks into a few big pieces and a lot of small ones, not into uniform flakes. The
|
|
357
|
+
// cube here is what produces that spread: most draws stay small, a few come out as a shoulder
|
|
358
|
+
// or a base you can recognise from across the plaza. Shards are plates rather than pebbles —
|
|
359
|
+
// wide and thin, so they tumble on landing instead of rolling away.
|
|
360
|
+
const size = 0.045 + rng() ** 3 * 0.075;
|
|
361
|
+
const thickness = size * (0.3 + rng() * 0.25);
|
|
362
|
+
shard.mesh.scale.set(size, thickness, size * (0.75 + rng() * 0.7));
|
|
363
|
+
shard.mesh.visible = true;
|
|
364
|
+
// Spread the pieces around the vessel's own body rather than all from the bullet's entry —
|
|
365
|
+
// a pot that comes apart only where it was hit reads as a decal, not a break.
|
|
366
|
+
const around = (index / style.shardCount) * Math.PI * 2;
|
|
367
|
+
const height = rng() * (style.hitHalf[1] ?? 0.2) * 2;
|
|
368
|
+
scratchOffset.set(
|
|
369
|
+
Math.cos(around) * (style.hitHalf[0] ?? 0.2) * 0.8,
|
|
370
|
+
height,
|
|
371
|
+
Math.sin(around) * (style.hitHalf[2] ?? 0.2) * 0.8,
|
|
372
|
+
);
|
|
373
|
+
shard.mesh.position.copy(prop.origin).add(scratchOffset);
|
|
374
|
+
shard.mesh.rotation.set(rng() * Math.PI, rng() * Math.PI, rng() * Math.PI);
|
|
375
|
+
// A fired vessel is not one colour: the glazed outside, the raw clay core and the shadowed
|
|
376
|
+
// inside all show once it opens up. A little spread per shard is what stops the pile reading
|
|
377
|
+
// as confetti cut from a single sheet.
|
|
378
|
+
shard.material.color.setHex(style.shardColour);
|
|
379
|
+
shard.material.color.multiplyScalar(0.72 + rng() * 0.5);
|
|
380
|
+
shard.material.opacity = 1;
|
|
381
|
+
|
|
382
|
+
const body = new RigidBody3D({
|
|
383
|
+
object: shard.mesh,
|
|
384
|
+
physics: this.#physics,
|
|
385
|
+
shape: CollisionShape3D.box(size * 2, thickness * 2, size * 2),
|
|
386
|
+
mass: 0.09,
|
|
387
|
+
type: "dynamic",
|
|
388
|
+
});
|
|
389
|
+
// Outward from the vessel's axis, carried along by the round, and lifted: a break that only
|
|
390
|
+
// pushes along the bullet leaves every piece in one flat fan.
|
|
391
|
+
body.linearVelocity = {
|
|
392
|
+
x: (scratchOffset.x * 5 + scratchDirection.x * 1.6 + (rng() - 0.5)) * style.burst * 0.32,
|
|
393
|
+
y: (1.1 + rng() * 1.5) * style.burst * 0.32,
|
|
394
|
+
z: (scratchOffset.z * 5 + scratchDirection.z * 1.6 + (rng() - 0.5)) * style.burst * 0.32,
|
|
395
|
+
};
|
|
396
|
+
shard.body = body;
|
|
397
|
+
shard.age = 0;
|
|
398
|
+
shard.live = true;
|
|
399
|
+
this.#liveShards += 1;
|
|
400
|
+
}
|
|
401
|
+
|
|
402
|
+
#retire(shard: Shard): void {
|
|
403
|
+
shard.body?.dispose();
|
|
404
|
+
shard.body = undefined;
|
|
405
|
+
shard.live = false;
|
|
406
|
+
shard.age = 0;
|
|
407
|
+
shard.material.opacity = 0;
|
|
408
|
+
shard.mesh.scale.setScalar(0.0001);
|
|
409
|
+
if (this.#settled) shard.mesh.visible = false;
|
|
410
|
+
this.#liveShards = Math.max(0, this.#liveShards - 1);
|
|
411
|
+
}
|
|
412
|
+
}
|