create-threenative 0.2.6 → 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 +2 -2
- package/agent-docs/references/build-profiles.md +126 -0
- package/agent-docs/references/capability-reference.md +431 -20
- package/agent-docs/references/performance-basics.md +8 -5
- package/agent-docs/references/sculpt-from-a-reference.md +1 -1
- package/agent-docs/references/trace-a-slow-frame.md +1 -1
- package/agent-docs/references/visual-baseline.md +8 -4
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
- package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
- package/capabilities.json +555 -21
- package/dist/index.d.ts +30 -1
- package/dist/index.js +294 -55
- package/dist/threenative.js +714 -154
- package/package.json +6 -6
- package/template-assets/assets/mannequin-combat.glb +0 -0
- package/template-assets/assets/mannequin.glb +0 -0
- package/template-assets/assets/player-viewmodel.glb +0 -0
- package/template-assets/assets/sky.jpg +0 -0
- package/template-assets/clearwater/README.md +141 -0
- package/template-assets/clearwater/install.mjs +50 -0
- package/template-assets/clearwater/src/clearwater.ts +180 -0
- package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
- package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
- package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
- package/template-assets/clearwater/src/render/clearwater.ts +278 -0
- package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
- package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
- package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
- package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
- package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
- package/template-assets/patches/three@0.185.1.patch +2101 -138
- package/template-assets/worldEnvironment.ts +52 -1
- package/templates/action-rpg/AGENTS.md +42 -42
- package/templates/action-rpg/CLAUDE.md +42 -42
- package/templates/action-rpg/kit.json +1 -1
- package/templates/action-rpg/package.json +13 -7
- package/templates/action-rpg/playtests/combat.playtest.json +162 -23
- package/templates/action-rpg/playtests/performance.playtest.json +4 -3
- package/templates/action-rpg/playtests/survives.playtest.json +25 -8
- package/templates/action-rpg/src/conventions.ts +24 -18
- package/templates/action-rpg/src/entities/Enemy.ts +74 -24
- package/templates/action-rpg/src/entities/Fighter.ts +127 -0
- package/templates/action-rpg/src/entities/Player.ts +102 -32
- package/templates/action-rpg/src/game.ts +3 -3
- package/templates/action-rpg/src/render/camera.ts +18 -16
- package/templates/action-rpg/src/render/dungeon.ts +192 -0
- package/templates/action-rpg/src/render/lighting.ts +45 -28
- package/templates/action-rpg/src/render/loading.ts +4 -4
- package/templates/action-rpg/src/render/materials.ts +191 -47
- package/templates/action-rpg/src/render/palette.ts +14 -13
- package/templates/action-rpg/src/render/postprocessing.ts +12 -2
- package/templates/action-rpg/src/render/props.ts +117 -0
- package/templates/action-rpg/src/render/quality.ts +40 -82
- package/templates/action-rpg/src/render/sky.ts +36 -13
- package/templates/action-rpg/src/render/touch-controls.ts +1 -1
- package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
- package/templates/action-rpg/src/scenes/Play.ts +61 -39
- package/templates/action-rpg/src/style.css +9 -7
- package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
- package/templates/action-rpg/src/ui/Hud.tsx +3 -3
- package/templates/action-rpg/threenative.config.ts +14 -1
- package/templates/action-rpg/vite.config.ts +4 -1
- package/templates/minimal/AGENTS.md +10 -10
- package/templates/minimal/CLAUDE.md +10 -10
- package/templates/minimal/package.json +12 -6
- package/templates/minimal/playtests/play.playtest.json +6 -5
- package/templates/minimal/playtests/sky.playtest.json +27 -0
- package/templates/minimal/src/conventions.ts +6 -3
- package/templates/minimal/src/entities/Player.ts +73 -27
- package/templates/minimal/src/main.ts +2 -3
- package/templates/minimal/src/render/camera.ts +22 -4
- package/templates/minimal/src/render/lighting.ts +24 -48
- package/templates/minimal/src/render/materials.ts +158 -13
- package/templates/minimal/src/render/palette.ts +10 -7
- package/templates/minimal/src/render/postprocessing.ts +12 -25
- package/templates/minimal/src/render/quality.ts +35 -69
- package/templates/minimal/src/render/sky.ts +35 -54
- package/templates/minimal/src/render/touch-controls.ts +1 -1
- package/templates/minimal/src/render/worldEnvironment.ts +52 -1
- package/templates/minimal/src/scenes/Play.ts +121 -111
- package/templates/minimal/src/state.ts +0 -4
- package/templates/minimal/src/style.css +0 -10
- package/templates/minimal/threenative.config.ts +14 -1
- package/templates/minimal/vite.config.ts +4 -1
- package/templates/platformer/AGENTS.md +18 -56
- package/templates/platformer/CLAUDE.md +18 -56
- package/templates/platformer/kit.json +2 -2
- package/templates/platformer/package.json +13 -9
- package/templates/platformer/playtests/buffer.playtest.json +15 -5
- package/templates/platformer/playtests/collect.playtest.json +8 -34
- package/templates/platformer/playtests/coyote.playtest.json +12 -34
- package/templates/platformer/playtests/damage.playtest.json +40 -15
- package/templates/platformer/playtests/hud.playtest.json +34 -0
- package/templates/platformer/playtests/move.playtest.json +24 -0
- package/templates/platformer/playtests/performance.playtest.json +24 -7
- package/templates/platformer/playtests/respawn.playtest.json +46 -11
- package/templates/platformer/playtests/stomp.playtest.json +49 -12
- package/templates/platformer/playtests/survives.playtest.json +3 -19
- package/templates/platformer/playtests/world.playtest.json +26 -0
- package/templates/platformer/src/entities/Fox.ts +273 -0
- package/templates/platformer/src/entities/Pickup.ts +43 -60
- package/templates/platformer/src/entities/Walker.ts +88 -0
- package/templates/platformer/src/game.ts +11 -8
- package/templates/platformer/src/level/Checkpoints.ts +29 -16
- package/templates/platformer/src/level/Stage.ts +469 -0
- package/templates/platformer/src/render/blocks.ts +94 -0
- package/templates/platformer/src/render/camera.ts +28 -3
- package/templates/platformer/src/render/fox.ts +196 -0
- package/templates/platformer/src/render/lighting.ts +42 -33
- package/templates/platformer/src/render/materials.ts +115 -5
- package/templates/platformer/src/render/palette.ts +68 -53
- package/templates/platformer/src/render/pickups.ts +142 -0
- package/templates/platformer/src/render/postprocessing.ts +12 -2
- package/templates/platformer/src/render/props.ts +147 -0
- package/templates/platformer/src/render/quality.ts +47 -99
- package/templates/platformer/src/render/scenery.ts +172 -0
- package/templates/platformer/src/render/sky.ts +120 -31
- package/templates/platformer/src/render/touch-controls.ts +5 -2
- package/templates/platformer/src/render/walkers.ts +96 -0
- package/templates/platformer/src/render/waterfall.ts +85 -0
- package/templates/platformer/src/render/worldEnvironment.ts +52 -1
- package/templates/platformer/src/scenes/Boot.ts +3 -4
- package/templates/platformer/src/scenes/Play.ts +362 -0
- package/templates/platformer/src/state.ts +16 -14
- package/templates/platformer/src/style.css +9 -8
- package/templates/platformer/src/ui/Hud.tsx +62 -29
- package/templates/platformer/src/ui/Menu.tsx +2 -2
- package/templates/platformer/threenative.config.ts +14 -1
- package/templates/platformer/vite.config.ts +4 -1
- package/templates/puzzle/AGENTS.md +19 -20
- package/templates/puzzle/CLAUDE.md +19 -20
- package/templates/puzzle/assets/native-proof.glb +0 -0
- package/templates/puzzle/assets/native-proof.png +0 -0
- package/templates/puzzle/kit.json +1 -1
- package/templates/puzzle/package.json +13 -7
- package/templates/puzzle/playtests/axis.playtest.json +20 -0
- package/templates/puzzle/playtests/blocked.playtest.json +73 -0
- package/templates/puzzle/playtests/caused.playtest.json +65 -0
- package/templates/puzzle/playtests/lit.playtest.json +74 -0
- package/templates/puzzle/playtests/performance.playtest.json +24 -7
- package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
- package/templates/puzzle/playtests/replay.playtest.json +81 -0
- package/templates/puzzle/playtests/restart.playtest.json +108 -0
- package/templates/puzzle/playtests/seal.playtest.json +98 -0
- package/templates/puzzle/playtests/settle.playtest.json +100 -0
- package/templates/puzzle/playtests/survives.playtest.json +6 -29
- package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
- package/templates/puzzle/src/entities/Crate.ts +99 -42
- package/templates/puzzle/src/entities/Seal.ts +69 -0
- package/templates/puzzle/src/entities/Warden.ts +135 -0
- package/templates/puzzle/src/game.ts +15 -11
- package/templates/puzzle/src/render/camera.ts +66 -31
- package/templates/puzzle/src/render/crateShape.ts +70 -0
- package/templates/puzzle/src/render/lighting.ts +41 -41
- package/templates/puzzle/src/render/loading.ts +4 -4
- package/templates/puzzle/src/render/materials.ts +131 -27
- package/templates/puzzle/src/render/palette.ts +19 -29
- package/templates/puzzle/src/render/postprocessing.ts +15 -3
- package/templates/puzzle/src/render/quality.ts +71 -80
- package/templates/puzzle/src/render/shapes.ts +109 -108
- package/templates/puzzle/src/render/sky.ts +18 -10
- package/templates/puzzle/src/render/touch-controls.ts +8 -51
- package/templates/puzzle/src/render/vault.ts +315 -0
- package/templates/puzzle/src/render/warden.ts +46 -0
- package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
- package/templates/puzzle/src/scenes/Play.ts +793 -0
- package/templates/puzzle/src/state.ts +55 -24
- package/templates/puzzle/src/style.css +7 -8
- package/templates/puzzle/src/ui/App.tsx +2 -2
- package/templates/puzzle/src/ui/Hud.tsx +92 -40
- package/templates/puzzle/src/ui/Menu.tsx +40 -2
- package/templates/puzzle/threenative.config.ts +14 -1
- package/templates/puzzle/vite.config.ts +4 -1
- package/templates/racing/AGENTS.md +19 -20
- package/templates/racing/CLAUDE.md +19 -20
- package/templates/racing/package.json +13 -7
- package/templates/racing/playtests/boost.playtest.json +33 -12
- package/templates/racing/playtests/outcome.playtest.json +32 -50
- package/templates/racing/playtests/performance.playtest.json +2 -1
- package/templates/racing/playtests/ranking.playtest.json +5 -14
- package/templates/racing/playtests/rescue.playtest.json +2 -2
- package/templates/racing/playtests/reverse.playtest.json +30 -8
- package/templates/racing/playtests/shortcut.playtest.json +54 -9
- package/templates/racing/playtests/touch-controls.playtest.json +32 -5
- package/templates/racing/src/entities/CarBody.ts +327 -0
- package/templates/racing/src/entities/LineDriver.ts +220 -0
- package/templates/racing/src/entities/RacingCar.ts +150 -89
- package/templates/racing/src/entities/Rival.ts +61 -24
- package/templates/racing/src/game.ts +5 -0
- package/templates/racing/src/render/camera.ts +49 -7
- package/templates/racing/src/render/lighting.ts +36 -37
- package/templates/racing/src/render/materials.ts +239 -19
- package/templates/racing/src/render/palette.ts +19 -21
- package/templates/racing/src/render/postprocessing.ts +12 -2
- package/templates/racing/src/render/quality.ts +43 -82
- package/templates/racing/src/render/shapes.ts +20 -6
- package/templates/racing/src/render/sky.ts +47 -39
- package/templates/racing/src/render/touch-controls.ts +1 -1
- package/templates/racing/src/render/worldEnvironment.ts +52 -1
- package/templates/racing/src/scenes/Race.ts +107 -54
- package/templates/racing/src/state.ts +2 -0
- package/templates/racing/src/track/Checkline.ts +22 -7
- package/templates/racing/src/track/Lap.ts +64 -36
- package/templates/racing/src/track/Ranking.ts +20 -11
- package/templates/racing/src/track/Track.ts +809 -361
- package/templates/racing/src/track/TrackSector.ts +40 -11
- package/templates/racing/src/track/circuit.ts +477 -0
- package/templates/racing/src/track/rescue.ts +16 -4
- package/templates/racing/threenative.config.ts +14 -1
- package/templates/racing/vite.config.ts +4 -1
- package/templates/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 +13 -7
- 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 +6 -10
- package/templates/runner/CLAUDE.md +6 -10
- package/templates/runner/README.md +3 -3
- package/templates/runner/package.json +13 -7
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +4 -3
- package/templates/runner/src/entities/Runner.ts +54 -7
- package/templates/runner/src/game.ts +2 -0
- package/templates/runner/src/render/camera.ts +4 -2
- package/templates/runner/src/render/dust.ts +5 -2
- package/templates/runner/src/render/lighting.ts +41 -45
- package/templates/runner/src/render/loading.ts +2 -2
- package/templates/runner/src/render/materials.ts +165 -25
- package/templates/runner/src/render/palette.ts +17 -28
- package/templates/runner/src/render/postprocessing.ts +12 -2
- package/templates/runner/src/render/quality.ts +42 -96
- package/templates/runner/src/render/shapes.ts +59 -37
- package/templates/runner/src/render/sky.ts +32 -41
- package/templates/runner/src/render/touch-controls.ts +1 -1
- package/templates/runner/src/render/worldEnvironment.ts +52 -1
- package/templates/runner/src/scenes/Run.ts +26 -6
- package/templates/runner/src/track.ts +6 -1
- package/templates/runner/threenative.config.ts +14 -1
- package/templates/runner/vite.config.ts +4 -1
- package/templates/sailing/AGENTS.md +12 -12
- package/templates/sailing/CLAUDE.md +12 -12
- package/templates/sailing/assets/ship.glb +0 -0
- package/templates/sailing/package.json +13 -7
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
- package/templates/sailing/playtests/sails.playtest.json +33 -0
- package/templates/sailing/playtests/win.playtest.json +156 -8
- package/templates/sailing/src/conventions.ts +29 -2
- package/templates/sailing/src/entities/Ship.ts +381 -57
- package/templates/sailing/src/game.ts +14 -0
- package/templates/sailing/src/render/camera.ts +63 -9
- package/templates/sailing/src/render/lighting.ts +49 -27
- package/templates/sailing/src/render/materials.ts +50 -15
- package/templates/sailing/src/render/ocean.ts +647 -60
- package/templates/sailing/src/render/palette.ts +16 -12
- package/templates/sailing/src/render/postprocessing.ts +12 -2
- package/templates/sailing/src/render/props.ts +316 -442
- package/templates/sailing/src/render/quality.ts +14 -4
- package/templates/sailing/src/render/sky.ts +116 -23
- package/templates/sailing/src/render/worldEnvironment.ts +52 -1
- package/templates/sailing/src/scenes/Boot.ts +21 -0
- package/templates/sailing/src/scenes/Sailing.ts +173 -39
- package/templates/sailing/src/state.ts +6 -0
- package/templates/sailing/src/ui/Hud.tsx +41 -9
- package/templates/sailing/threenative.config.ts +14 -1
- package/templates/sailing/vite.config.ts +4 -1
- package/templates/shooter/AGENTS.md +27 -42
- package/templates/shooter/CLAUDE.md +27 -42
- package/templates/shooter/index.html +1 -0
- package/templates/shooter/package.json +13 -7
- package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
- package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
- package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
- package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
- package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
- package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
- package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
- package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
- package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
- package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
- package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
- package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
- package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
- package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
- package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
- package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
- package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
- package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
- package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
- package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
- package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
- package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
- package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
- package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
- package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
- package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
- package/templates/shooter/playtests/input-control.playtest.json +43 -98
- package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
- package/templates/shooter/playtests/performance.playtest.json +62 -26
- package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
- package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
- package/templates/shooter/playtests/survives.playtest.json +36 -30
- package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
- package/templates/shooter/src/entities/Breakables.ts +412 -0
- package/templates/shooter/src/entities/Enemy.ts +2095 -0
- package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
- package/templates/shooter/src/entities/Rifle.ts +442 -0
- package/templates/shooter/src/entities/Target.ts +199 -83
- package/templates/shooter/src/entities/TouchControls.ts +276 -0
- package/templates/shooter/src/game.ts +75 -41
- package/templates/shooter/src/main.ts +0 -1
- package/templates/shooter/src/postPhysics.ts +36 -0
- package/templates/shooter/src/render/camera.ts +78 -74
- package/templates/shooter/src/render/decals.ts +142 -82
- package/templates/shooter/src/render/facade.ts +1373 -0
- package/templates/shooter/src/render/gunfx.ts +704 -0
- package/templates/shooter/src/render/lighting.ts +52 -38
- package/templates/shooter/src/render/loading.ts +2 -2
- package/templates/shooter/src/render/materials.ts +100 -88
- package/templates/shooter/src/render/occlusion.ts +108 -0
- package/templates/shooter/src/render/palette.ts +10 -10
- package/templates/shooter/src/render/palm.ts +455 -0
- package/templates/shooter/src/render/pooled-billboards.ts +144 -0
- package/templates/shooter/src/render/postprocessing.ts +15 -3
- package/templates/shooter/src/render/quality.ts +40 -82
- package/templates/shooter/src/render/scale.ts +148 -15
- package/templates/shooter/src/render/shapes.ts +138 -613
- package/templates/shooter/src/render/sky.ts +35 -35
- package/templates/shooter/src/render/town-schematic.ts +120 -0
- package/templates/shooter/src/render/town.ts +986 -0
- package/templates/shooter/src/render/townMaterials.ts +160 -0
- package/templates/shooter/src/render/vehicles.ts +741 -0
- package/templates/shooter/src/render/worldEnvironment.ts +52 -1
- package/templates/shooter/src/scenes/Play.ts +727 -650
- package/templates/shooter/src/state.ts +26 -41
- package/templates/shooter/src/style.css +207 -11
- package/templates/shooter/src/surfaces.ts +131 -0
- package/templates/shooter/src/ui/App.tsx +9 -10
- package/templates/shooter/src/ui/Crosshair.tsx +25 -18
- package/templates/shooter/src/ui/GameUi.tsx +6 -9
- package/templates/shooter/src/ui/Hud.tsx +428 -39
- package/templates/shooter/src/ui/Minimap.tsx +164 -0
- package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
- package/templates/shooter/src/ui/main.tsx +2 -3
- package/templates/shooter/threenative.config.ts +14 -1
- package/templates/shooter/vite.config.ts +4 -1
- package/templates/starter/AGENTS.md +17 -17
- package/templates/starter/CLAUDE.md +17 -17
- package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
- package/templates/starter/package.json +13 -7
- package/templates/starter/playtests/play.playtest.json +2 -1
- package/templates/starter/playtests/survives.playtest.json +1 -1
- package/templates/starter/src/conventions.ts +6 -3
- package/templates/starter/src/entities/Goal.ts +35 -42
- package/templates/starter/src/entities/Player.ts +99 -16
- package/templates/starter/src/render/arena.ts +131 -0
- package/templates/starter/src/render/lighting.ts +27 -44
- package/templates/starter/src/render/materials.ts +164 -35
- package/templates/starter/src/render/palette.ts +16 -16
- package/templates/starter/src/render/postprocessing.ts +6 -7
- package/templates/starter/src/render/quality.ts +43 -101
- package/templates/starter/src/render/shapes.ts +1 -1
- package/templates/starter/src/render/sky.ts +39 -45
- package/templates/starter/src/render/touch-controls.ts +3 -1
- package/templates/starter/src/render/worldEnvironment.ts +52 -1
- package/templates/starter/src/scenes/Play.ts +82 -81
- package/templates/starter/threenative.config.ts +14 -1
- package/templates/starter/vite.config.ts +4 -1
- package/templates/tower-defense/.codex/config.toml +19 -0
- package/templates/tower-defense/.cursor/mcp.json +32 -0
- package/templates/tower-defense/.gemini/settings.json +32 -0
- package/templates/tower-defense/.mcp.json +32 -0
- package/templates/tower-defense/.vscode/mcp.json +36 -0
- package/templates/tower-defense/.zed/settings.json +36 -0
- package/templates/{defense → tower-defense}/AGENTS.md +14 -12
- package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
- package/templates/tower-defense/README.md +16 -0
- package/templates/tower-defense/index.html +12 -0
- package/templates/tower-defense/kit.json +7 -0
- package/templates/tower-defense/opencode.json +41 -0
- package/templates/tower-defense/package.json +56 -0
- package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
- package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
- package/templates/tower-defense/playtests/look.playtest.json +130 -0
- package/templates/tower-defense/playtests/performance.playtest.json +77 -0
- package/templates/tower-defense/playtests/placement.playtest.json +115 -0
- package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
- package/templates/tower-defense/playtests/strike.playtest.json +98 -0
- package/templates/tower-defense/playtests/survives.playtest.json +85 -0
- package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
- package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
- package/templates/tower-defense/playtests/victory.playtest.json +810 -0
- package/templates/tower-defense/src/balance.ts +187 -0
- package/templates/tower-defense/src/board/Board.ts +100 -0
- package/templates/tower-defense/src/board/Route.ts +84 -0
- package/templates/tower-defense/src/camera-rig.ts +62 -0
- package/templates/tower-defense/src/economy.ts +64 -0
- package/templates/tower-defense/src/effects/Effects.ts +284 -0
- package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
- package/templates/tower-defense/src/game.ts +72 -0
- package/templates/tower-defense/src/intents.ts +21 -0
- package/templates/tower-defense/src/main.ts +15 -0
- package/templates/tower-defense/src/physics.ts +6 -0
- package/templates/tower-defense/src/render/camera.ts +38 -0
- package/templates/tower-defense/src/render/lighting.ts +42 -0
- package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
- package/templates/tower-defense/src/render/materials.ts +103 -0
- package/templates/tower-defense/src/render/palette.ts +58 -0
- package/templates/tower-defense/src/render/postprocessing.ts +46 -0
- package/templates/tower-defense/src/render/quality.ts +128 -0
- package/templates/tower-defense/src/render/shapes.ts +550 -0
- package/templates/tower-defense/src/render/sky.ts +27 -0
- package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
- package/templates/tower-defense/src/scenes/Battle.ts +539 -0
- package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
- package/templates/tower-defense/src/state.ts +88 -0
- package/templates/tower-defense/src/style.css +137 -0
- package/templates/tower-defense/src/towers/Tower.ts +230 -0
- package/templates/tower-defense/src/towers/targeting.ts +97 -0
- package/templates/tower-defense/src/ui/Hud.tsx +270 -0
- package/templates/tower-defense/src/ui/Menu.tsx +134 -0
- package/templates/tower-defense/src/ui/icons.tsx +54 -0
- package/templates/tower-defense/src/ui/main.tsx +14 -0
- package/templates/tower-defense/src/waves.ts +90 -0
- package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
- package/templates/tower-defense/vite.config.ts +41 -0
- package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
- package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
- package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
- package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
- package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
- package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
- package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
- package/agent-files/AGENT-ROLES.md +0 -26
- package/templates/action-rpg/src/render/shapes.ts +0 -269
- package/templates/action-rpg/src/render/types.ts +0 -3
- package/templates/action-rpg/src/scenes/Boot.ts +0 -12
- package/templates/defense/README.md +0 -10
- package/templates/defense/kit.json +0 -7
- package/templates/defense/playtests/leak.playtest.json +0 -23
- package/templates/defense/playtests/placement.playtest.json +0 -40
- package/templates/defense/playtests/scan.playtest.json +0 -20
- package/templates/defense/playtests/survive.playtest.json +0 -45
- package/templates/defense/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/restart.playtest.json +0 -91
- package/templates/starter/playtests/seed.playtest.json +0 -54
- package/templates/starter/playtests/textures-baseline.png +0 -0
- package/templates/starter/playtests/textures.playtest.json +0 -74
- package/templates/starter/playtests/touch-controls.playtest.json +0 -42
- package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
- package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
- package/templates/starter/src/render/coast.ts +0 -199
- package/templates/starter/src/render/hero.ts +0 -88
- package/templates/starter/src/render/implicitSurface.ts +0 -199
- package/templates/starter/src/render/kuwahara.ts +0 -174
- package/templates/starter/src/render/outline.ts +0 -141
- package/templates/starter/src/render/painterly.ts +0 -86
- package/templates/starter/src/render/rockRidge.ts +0 -198
- package/templates/starter/src/render/rockRidge.worker.ts +0 -77
- package/templates/starter/src/render/scenery.ts +0 -40
- package/templates/starter/src/render/textureLifetime.ts +0 -53
- package/templates/starter/src/render/water.ts +0 -38
- package/templates/starter/src/render/watercolor.ts +0 -85
- /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
- /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
- /package/templates/{defense → 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,48 +1,45 @@
|
|
|
1
1
|
import { type ICtx, SoftBody3D } from "@threenative/core";
|
|
2
2
|
import { Area3D, CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
|
|
3
|
-
import { type BufferGeometry,
|
|
3
|
+
import { type BufferGeometry, Matrix4, Mesh } from "three";
|
|
4
|
+
import { platform } from "../render/arena.js";
|
|
5
|
+
import { propMaterial } from "../render/materials.js";
|
|
4
6
|
import { tessellatePennant } from "../render/pennant.js";
|
|
5
|
-
import {
|
|
7
|
+
import { tube } from "../render/shapes.js";
|
|
6
8
|
import type { GameState } from "../state.js";
|
|
7
9
|
|
|
8
10
|
/**
|
|
9
|
-
* The far side of the gap: a fixed
|
|
11
|
+
* The far side of the gap: a fixed deck, a flagpole, and the pennant the packaged glTF
|
|
10
12
|
* proof asset is cut from. Landing anywhere on it ends the run.
|
|
11
13
|
*
|
|
12
|
-
* The
|
|
14
|
+
* The deck top sits below the ledge on purpose. A same-height landing has to be jumped
|
|
13
15
|
* within a couple of frames of the edge; dropping 0.4 m widens that window to about half
|
|
14
|
-
* a second, which is what makes coyote time feel generous instead of decorative.
|
|
15
|
-
*
|
|
16
|
-
*
|
|
16
|
+
* a second, which is what makes coyote time feel generous instead of decorative. The deck is
|
|
17
|
+
* the same light-grid plate over a dark-grid base as the near platform, so the far side reads
|
|
18
|
+
* as more of the same ground and the gap between them stays legible as a gap.
|
|
17
19
|
*/
|
|
18
20
|
export const ISLAND = { depth: 2.6, height: 0.1, top: -0.4, width: 3, x: 7.9, z: 0 } as const;
|
|
19
21
|
const POLE = { height: 2.4, radius: 0.05, x: 8.4, z: -0.5 } as const;
|
|
20
22
|
const PENNANT_SCALE = 0.55;
|
|
21
23
|
|
|
22
|
-
export interface IGoalMaterials {
|
|
23
|
-
/** The island itself: the same ground the ledge is made of, across the gap. */
|
|
24
|
-
readonly floor: Material;
|
|
25
|
-
/** The pole. The accent role, and the only warm thing on the far side. */
|
|
26
|
-
readonly goal: Material;
|
|
27
|
-
/** The sandbar's beach rim and the flank below it. */
|
|
28
|
-
readonly shore: Material;
|
|
29
|
-
}
|
|
30
|
-
|
|
31
24
|
export class Goal {
|
|
32
25
|
/** The whole marker, so a playtest `visibility` row can ask whether it is on screen. */
|
|
33
26
|
readonly mesh: SoftBody3D;
|
|
34
27
|
readonly pennant: SoftBody3D;
|
|
35
28
|
readonly area: Area3D;
|
|
36
|
-
readonly #
|
|
29
|
+
readonly #bodies: RigidBody3D[] = [];
|
|
37
30
|
|
|
38
|
-
constructor(ctx: ICtx<GameState, IPhysicsContext>,
|
|
31
|
+
constructor(ctx: ICtx<GameState, IPhysicsContext>, pennant: Mesh) {
|
|
39
32
|
// Children carry world coordinates and the group stays at the origin: a physics body
|
|
40
33
|
// reads its object's own transform, and a nested offset would silently desync them.
|
|
41
|
-
const
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
34
|
+
const { base, plate: deck } = platform(
|
|
35
|
+
ISLAND.width,
|
|
36
|
+
ISLAND.depth,
|
|
37
|
+
ISLAND.top,
|
|
38
|
+
ISLAND.x,
|
|
39
|
+
ISLAND.z,
|
|
40
|
+
0.05,
|
|
41
|
+
);
|
|
42
|
+
const pole = tube(POLE.radius, POLE.radius, POLE.height, propMaterial);
|
|
46
43
|
pole.position.set(POLE.x, ISLAND.top + POLE.height / 2, POLE.z);
|
|
47
44
|
// The proof triangle points +x once it is turned on its side, which is a pennant. Its
|
|
48
45
|
// hoist edge lands on the pole; the rest of it flies clear.
|
|
@@ -67,26 +64,22 @@ export class Goal {
|
|
|
67
64
|
});
|
|
68
65
|
this.pennant.name = "finish-flag-cloth";
|
|
69
66
|
this.mesh = this.pennant;
|
|
70
|
-
|
|
71
|
-
// the water. Left bare it was the one piece of the coast with a hard cut edge and no shore,
|
|
72
|
-
// and it read as unfinished next to the main island's beach.
|
|
73
|
-
const rim = block(ISLAND.width + 0.7, 0.09, ISLAND.depth + 0.7, materials.shore, {
|
|
74
|
-
radius: 0.3,
|
|
75
|
-
});
|
|
76
|
-
rim.position.set(ISLAND.x, ISLAND.top - ISLAND.height - 0.02, ISLAND.z);
|
|
77
|
-
const flank = block(ISLAND.width + 0.35, 0.5, ISLAND.depth + 0.35, materials.shore, {
|
|
78
|
-
radius: 0.24,
|
|
79
|
-
});
|
|
80
|
-
flank.position.set(ISLAND.x, ISLAND.top - ISLAND.height - 0.3, ISLAND.z);
|
|
81
|
-
this.mesh.add(island, rim, flank, pole);
|
|
67
|
+
this.mesh.add(deck, base, pole);
|
|
82
68
|
ctx.add(this.mesh);
|
|
83
69
|
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
70
|
+
// Two fixed bodies, one per solid: the plate is what a landing lands on, and the base is
|
|
71
|
+
// what a body still falling past the deck's flank hits instead of passing through. Both are
|
|
72
|
+
// trimeshes, so the collider is the grid the player can see.
|
|
73
|
+
for (const mesh of [deck, base]) {
|
|
74
|
+
this.#bodies.push(
|
|
75
|
+
new RigidBody3D({
|
|
76
|
+
object: mesh,
|
|
77
|
+
physics: ctx.physics,
|
|
78
|
+
shape: CollisionShape3D.fromMesh(mesh, "trimesh"),
|
|
79
|
+
type: "fixed",
|
|
80
|
+
}),
|
|
81
|
+
);
|
|
82
|
+
}
|
|
90
83
|
// Tall enough to catch a landing, shallow enough that a body still falling past the
|
|
91
84
|
// island's flank in the gap is metres below it and never trips the finish.
|
|
92
85
|
this.area = new Area3D({
|
|
@@ -118,7 +111,7 @@ export class Goal {
|
|
|
118
111
|
|
|
119
112
|
dispose(): void {
|
|
120
113
|
this.area.dispose();
|
|
121
|
-
this.#body.dispose();
|
|
114
|
+
for (const body of this.#bodies) body.dispose();
|
|
122
115
|
this.mesh.removeFromParent();
|
|
123
116
|
}
|
|
124
117
|
}
|
|
@@ -1,37 +1,58 @@
|
|
|
1
|
-
import { type ICtx,
|
|
1
|
+
import { type ICtx, SkeletalMesh3D } from "@threenative/core";
|
|
2
2
|
import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
|
|
3
|
-
import { Group, type Mesh, Vector3 } from "three";
|
|
3
|
+
import { type AnimationClip, Group, MathUtils, type Mesh, type Object3D, Vector3 } from "three";
|
|
4
4
|
import { type IStarterConventions, preparePlayerConventions } from "../conventions.js";
|
|
5
|
-
import { type IHeroMaterials, hero } from "../render/hero.js";
|
|
6
5
|
import type { ITouchInput } from "../render/touch-controls.js";
|
|
7
6
|
import type { GameState } from "../state.js";
|
|
8
7
|
|
|
9
8
|
type GameCtx = ICtx<GameState, IPhysicsContext>;
|
|
10
9
|
|
|
11
10
|
// Tune these two timers for jump feel; they forgive a late or early button press.
|
|
12
|
-
// 0.12s is 7.2 ticks at the 1/60 step,
|
|
13
|
-
//
|
|
14
|
-
//
|
|
15
|
-
//
|
|
16
|
-
//
|
|
11
|
+
// 0.12s is 7.2 ticks at the 1/60 step, which is what a jump scenario measures against: 3 ticks
|
|
12
|
+
// walking off the ledge, 5 more airborne, then the jump — the jump lands about 5 ticks after the
|
|
13
|
+
// player actually leaves the ground, inside the window. Change this and those two step lengths
|
|
14
|
+
// move with it. Tightening the airborne hold does NOT make the scenario safer: with 2 the player
|
|
15
|
+
// has not left the ledge yet, and the jump is counted as an ordinary one
|
|
17
16
|
// (`jumps: 1, coyoteJumps: 0`), which is what it measured when I tried.
|
|
18
17
|
const COYOTE_TIME = 0.12;
|
|
19
18
|
const JUMP_BUFFER = 0.14;
|
|
20
19
|
const JUMP_SPEED = 5;
|
|
21
20
|
const MOVE_SPEED = 2;
|
|
22
|
-
|
|
21
|
+
/** Capsule for a 1.8 m figure: 0.6 m half-height plus a 0.3 m radius at each end. */
|
|
22
|
+
const HALF_HEIGHT = 0.6;
|
|
23
|
+
const RADIUS = 0.3;
|
|
24
|
+
const PLAYER_FOOT_OFFSET = HALF_HEIGHT + RADIUS + 0.01;
|
|
25
|
+
/** Where the capsule rests on a floor at y = 0: its own half-height above that surface. */
|
|
26
|
+
export const PLAYER_STAND_Y = HALF_HEIGHT + RADIUS;
|
|
23
27
|
const VISUAL_ATTACHMENT_TOLERANCE = 0.1;
|
|
24
|
-
const SPAWN = { x: -2, y:
|
|
28
|
+
const SPAWN = { x: -2, y: PLAYER_STAND_Y, z: 0 } as const;
|
|
29
|
+
|
|
30
|
+
/** The clips `assets/mannequin.glb` ships, by the name this file plays them under. */
|
|
31
|
+
const CLIPS = {
|
|
32
|
+
idle: "Idle_Loop",
|
|
33
|
+
jog: "Jog_Fwd_Loop",
|
|
34
|
+
jumpStart: "Jump_Start",
|
|
35
|
+
jumpLoop: "Jump_Loop",
|
|
36
|
+
jumpLand: "Jump_Land",
|
|
37
|
+
} as const;
|
|
38
|
+
|
|
39
|
+
export interface IPlayerModel {
|
|
40
|
+
readonly scene: Object3D;
|
|
41
|
+
readonly animations: readonly AnimationClip[];
|
|
42
|
+
}
|
|
25
43
|
|
|
26
44
|
export class Player {
|
|
27
45
|
readonly mesh: Group;
|
|
28
46
|
readonly visual: Mesh;
|
|
29
47
|
readonly body: CharacterBody3D;
|
|
48
|
+
readonly character: SkeletalMesh3D;
|
|
30
49
|
#coyoteTime = 0;
|
|
31
50
|
#jumpBuffer = 0;
|
|
32
51
|
#jumps = 0;
|
|
33
52
|
#coyoteJumps = 0;
|
|
34
53
|
#odometer = 0;
|
|
54
|
+
#landing = 0;
|
|
55
|
+
#wasGrounded = true;
|
|
35
56
|
#supportSurfaceY = 0;
|
|
36
57
|
#previousPosition = new Vector3();
|
|
37
58
|
#bodyWorldPosition = new Vector3();
|
|
@@ -40,23 +61,44 @@ export class Player {
|
|
|
40
61
|
#hasPreviousPosition = false;
|
|
41
62
|
#conventions: IStarterConventions;
|
|
42
63
|
|
|
64
|
+
/**
|
|
65
|
+
* `model` is the loaded `mannequin.glb` — Quaternius' Universal Animation Library mannequin
|
|
66
|
+
* (CC0), recoloured and cut to the locomotion clips. Swap in any rigged glTF with the same clip
|
|
67
|
+
* roles by editing `CLIPS`; `requiredClips` fails the load, by name, if one is missing.
|
|
68
|
+
*/
|
|
43
69
|
constructor(
|
|
44
70
|
ctx: GameCtx,
|
|
45
|
-
|
|
71
|
+
model: IPlayerModel,
|
|
46
72
|
spawn: { readonly x: number; readonly y: number; readonly z: number } = SPAWN,
|
|
47
73
|
) {
|
|
48
74
|
this.mesh = new Group();
|
|
49
|
-
this.
|
|
50
|
-
|
|
51
|
-
|
|
75
|
+
this.character = new SkeletalMesh3D({
|
|
76
|
+
source: model.scene,
|
|
77
|
+
clips: model.animations,
|
|
78
|
+
requiredClips: Object.values(CLIPS),
|
|
79
|
+
strideRoot: this.mesh,
|
|
80
|
+
});
|
|
81
|
+
const figure = this.character.root;
|
|
82
|
+
figure.traverse((object) => {
|
|
83
|
+
object.castShadow = true;
|
|
84
|
+
});
|
|
85
|
+
// Feet at the bottom of the capsule, sunk one centimetre so a sole never floats on the floor.
|
|
86
|
+
figure.position.y = -PLAYER_FOOT_OFFSET;
|
|
87
|
+
// The model faces +Z; start facing into the level, away from the camera.
|
|
88
|
+
figure.rotation.y = Math.PI;
|
|
89
|
+
this.mesh.add(figure);
|
|
90
|
+
// `visual` is the skinned figure itself: the skinned `Mesh` at the top of the rig, so the
|
|
91
|
+
// attachment and grounding readbacks below measure the geometry the player actually sees.
|
|
92
|
+
this.visual = skinnedMeshOf(figure);
|
|
52
93
|
this.mesh.position.set(spawn.x, spawn.y, spawn.z);
|
|
53
|
-
this.#conventions = preparePlayerConventions(
|
|
94
|
+
this.#conventions = preparePlayerConventions(figure);
|
|
95
|
+
this.character.play(CLIPS.idle);
|
|
54
96
|
ctx.add(this.mesh);
|
|
55
97
|
this.body = new CharacterBody3D({
|
|
56
98
|
autostep: { maxHeight: 0.4, minWidth: 0.2 },
|
|
57
99
|
object: this.mesh,
|
|
58
100
|
physics: ctx.physics,
|
|
59
|
-
shape: CollisionShape3D.capsule(
|
|
101
|
+
shape: CollisionShape3D.capsule(HALF_HEIGHT, RADIUS),
|
|
60
102
|
});
|
|
61
103
|
}
|
|
62
104
|
|
|
@@ -75,12 +117,14 @@ export class Player {
|
|
|
75
117
|
if (grounded) this.#coyoteTime = COYOTE_TIME;
|
|
76
118
|
if (ctx.input.justPressed("jump") || touch?.jumpPressed === true)
|
|
77
119
|
this.#jumpBuffer = JUMP_BUFFER;
|
|
120
|
+
let jumped = false;
|
|
78
121
|
if (this.#jumpBuffer > 0 && this.#coyoteTime > 0) {
|
|
79
122
|
this.body.velocity.y = JUMP_SPEED;
|
|
80
123
|
this.#jumpBuffer = 0;
|
|
81
124
|
this.#coyoteTime = 0;
|
|
82
125
|
this.#jumps += 1;
|
|
83
126
|
if (!grounded) this.#coyoteJumps += 1;
|
|
127
|
+
jumped = true;
|
|
84
128
|
}
|
|
85
129
|
const move = ctx.input.vector("move");
|
|
86
130
|
if (touch !== undefined) {
|
|
@@ -103,6 +147,7 @@ export class Player {
|
|
|
103
147
|
this.#conventions.groundSnap.enabled = canCorrectGrounding;
|
|
104
148
|
this.#conventions.applyGrounding(this.#supportSurfaceY, dt);
|
|
105
149
|
this.#captureVisualBodyOffset();
|
|
150
|
+
this.#animate(dt, move.length(), jumped);
|
|
106
151
|
}
|
|
107
152
|
|
|
108
153
|
respawn(): void {
|
|
@@ -162,6 +207,28 @@ export class Player {
|
|
|
162
207
|
this.mesh.removeFromParent();
|
|
163
208
|
}
|
|
164
209
|
|
|
210
|
+
/** Faces the direction of travel and picks a clip from what the body is actually doing. */
|
|
211
|
+
#animate(dt: number, speed: number, jumped: boolean): void {
|
|
212
|
+
const figure = this.character.root;
|
|
213
|
+
if (speed > 0.05) {
|
|
214
|
+
const heading = Math.atan2(this.body.velocity.x, this.body.velocity.z);
|
|
215
|
+
const turn = MathUtils.euclideanModulo(heading - figure.rotation.y + Math.PI, Math.PI * 2);
|
|
216
|
+
figure.rotation.y += (turn - Math.PI) * Math.min(1, dt * 12);
|
|
217
|
+
}
|
|
218
|
+
const grounded = this.body.grounded;
|
|
219
|
+
this.#landing -= dt;
|
|
220
|
+
if (jumped) this.character.play(CLIPS.jumpStart, { fade: 0.08, mode: "once" });
|
|
221
|
+
else if (!grounded && this.character.finished)
|
|
222
|
+
this.character.play(CLIPS.jumpLoop, { fade: 0.15 });
|
|
223
|
+
else if (grounded && !this.#wasGrounded) {
|
|
224
|
+
this.#landing = 0.25;
|
|
225
|
+
this.character.play(CLIPS.jumpLand, { fade: 0.06, mode: "once" });
|
|
226
|
+
} else if (grounded && this.#landing <= 0)
|
|
227
|
+
this.character.play(speed > 0.05 ? CLIPS.jog : CLIPS.idle, { fade: 0.2 });
|
|
228
|
+
this.#wasGrounded = grounded;
|
|
229
|
+
this.character.update(dt);
|
|
230
|
+
}
|
|
231
|
+
|
|
165
232
|
#captureVisualBodyOffset(): void {
|
|
166
233
|
if (this.#visualBodyOffsetY !== undefined || !this.body.grounded || this.body.velocity.y > 0)
|
|
167
234
|
return;
|
|
@@ -179,3 +246,19 @@ export class Player {
|
|
|
179
246
|
);
|
|
180
247
|
}
|
|
181
248
|
}
|
|
249
|
+
|
|
250
|
+
/**
|
|
251
|
+
* The skinned `Mesh` inside a rig, which is the geometry the player actually sees.
|
|
252
|
+
*
|
|
253
|
+
* The rig's root is whatever glTF happened to call its top node, so a rig can arrive as a `Group`
|
|
254
|
+
* with the `Mesh` below it or already be the `Mesh`. The readbacks in `debug()` measure the drawn
|
|
255
|
+
* figure against the body, so they need that `Mesh` and not the wrapper above it.
|
|
256
|
+
*/
|
|
257
|
+
function skinnedMeshOf(figure: Object3D): Mesh {
|
|
258
|
+
let found: Mesh | undefined;
|
|
259
|
+
figure.traverse((object) => {
|
|
260
|
+
if (found === undefined && (object as Mesh).isMesh === true) found = object as Mesh;
|
|
261
|
+
});
|
|
262
|
+
if (found === undefined) throw new Error("The player rig carried no skinned mesh to animate.");
|
|
263
|
+
return found;
|
|
264
|
+
}
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
// ThreeNative does not read this file.
|
|
3
|
+
//
|
|
4
|
+
// The prototype test arena every engine opens a new project on, and the one shape every platform
|
|
5
|
+
// in it is cut from: a light metre-grid plate on top of a dark-grid body that reaches the ground.
|
|
6
|
+
// Two meshes, so the walking surface reads as floor and the sides read as structure — and two
|
|
7
|
+
// solids, so the player collides with exactly the triangles they can see.
|
|
8
|
+
//
|
|
9
|
+
// Every solid here is **placed in the geometry, not on the mesh**, for one reason: `worldGridUVs`
|
|
10
|
+
// measures UVs in world metres, and a trimesh collider built from that geometry is the exact
|
|
11
|
+
// surface the player sees. Move a solid by rebuilding it here, not by writing `mesh.position` —
|
|
12
|
+
// a collider reads the mesh transform and the shape separately, and the two only agree while the
|
|
13
|
+
// mesh sits at the origin.
|
|
14
|
+
import { type BufferGeometry, CylinderGeometry, Group, Mesh, PlaneGeometry } from "three";
|
|
15
|
+
import { floorMaterial, structureMaterial, worldGridUVs } from "./materials.js";
|
|
16
|
+
import { roundedBox } from "./shapes.js";
|
|
17
|
+
|
|
18
|
+
/**
|
|
19
|
+
* The light grid the arena stands on, six metres below the route. Nothing collides with it, which
|
|
20
|
+
* is what makes the gap between the two platforms a real pit rather than scenery underfoot.
|
|
21
|
+
*/
|
|
22
|
+
const GROUND_Y = -6;
|
|
23
|
+
/** The dark-grid walls that close the arena, and how far the route's own ground sits below them. */
|
|
24
|
+
const ARENA = { halfX: 13, halfZ: 11, thickness: 1, wallTop: 4 } as const;
|
|
25
|
+
|
|
26
|
+
const PLATE = 0.2;
|
|
27
|
+
|
|
28
|
+
/** `roundedBox` caches and hands back one instance per size, so a placed copy has to be its own. */
|
|
29
|
+
function placed(geometry: BufferGeometry, at: readonly [number, number, number]): BufferGeometry {
|
|
30
|
+
return worldGridUVs(geometry.clone().translate(...at));
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
function meshOf(
|
|
34
|
+
geometry: BufferGeometry,
|
|
35
|
+
at: readonly [number, number, number],
|
|
36
|
+
material: Mesh["material"],
|
|
37
|
+
): Mesh {
|
|
38
|
+
const mesh = new Mesh(placed(geometry, at), material);
|
|
39
|
+
mesh.castShadow = true;
|
|
40
|
+
mesh.receiveShadow = true;
|
|
41
|
+
return mesh;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** A rounded box: a wall, a pillar, a platform's plate or its body. */
|
|
45
|
+
function box(
|
|
46
|
+
size: readonly [number, number, number],
|
|
47
|
+
at: readonly [number, number, number],
|
|
48
|
+
material: Mesh["material"],
|
|
49
|
+
radius: number,
|
|
50
|
+
): Mesh {
|
|
51
|
+
return meshOf(roundedBox(size[0], size[1], size[2], radius), at, material);
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
export interface IPlatform {
|
|
55
|
+
/** The authoritative support surface: its top face is the surface's `y`. */
|
|
56
|
+
readonly plate: Mesh;
|
|
57
|
+
/** The dark-grid body under it, running down to `GROUND_Y`. */
|
|
58
|
+
readonly base: Mesh;
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/** One platform: a light-grid top at `top`, on a dark-grid body that meets the ground. */
|
|
62
|
+
export function platform(
|
|
63
|
+
width: number,
|
|
64
|
+
depth: number,
|
|
65
|
+
top: number,
|
|
66
|
+
x: number,
|
|
67
|
+
z: number,
|
|
68
|
+
radius = 0.1,
|
|
69
|
+
): IPlatform {
|
|
70
|
+
const height = top - PLATE - GROUND_Y;
|
|
71
|
+
return {
|
|
72
|
+
base: box([width, height, depth], [x, top - PLATE - height / 2, z], structureMaterial, radius),
|
|
73
|
+
plate: box([width, PLATE, depth], [x, top - PLATE / 2, z], floorMaterial, radius),
|
|
74
|
+
};
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
export interface IArena {
|
|
78
|
+
/** Everything static, added in one call. */
|
|
79
|
+
readonly group: Group;
|
|
80
|
+
/**
|
|
81
|
+
* The meshes that must collide. Give each one `CollisionShape3D.fromMesh(mesh, "trimesh")`:
|
|
82
|
+
* the kind is named rather than inferred, because an inferred box of a geometry whose offset is
|
|
83
|
+
* baked in would collide at the world origin.
|
|
84
|
+
*/
|
|
85
|
+
readonly solids: Mesh[];
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/**
|
|
89
|
+
* The ground, the four walls and one pillar. `platform` is deliberately not in here — the two
|
|
90
|
+
* platforms are the course, and the course is gameplay, so the scene places them itself.
|
|
91
|
+
*/
|
|
92
|
+
export function createArena(): IArena {
|
|
93
|
+
const group = new Group();
|
|
94
|
+
// The ground runs out past the walls to the haze line, so the sky over a wall meets ground and
|
|
95
|
+
// not a void. It is decoration, not floor: it has no collider, and that is the pit under the gap.
|
|
96
|
+
const ground = new Mesh(
|
|
97
|
+
worldGridUVs(new PlaneGeometry(12_000, 12_000).rotateX(-Math.PI / 2)),
|
|
98
|
+
floorMaterial,
|
|
99
|
+
);
|
|
100
|
+
ground.position.y = GROUND_Y;
|
|
101
|
+
ground.receiveShadow = true;
|
|
102
|
+
group.add(ground);
|
|
103
|
+
const height = ARENA.wallTop - GROUND_Y;
|
|
104
|
+
const y = GROUND_Y + height / 2;
|
|
105
|
+
const walls = (
|
|
106
|
+
[
|
|
107
|
+
[
|
|
108
|
+
[ARENA.halfX * 2 + ARENA.thickness, height, ARENA.thickness],
|
|
109
|
+
[0, y, -ARENA.halfZ],
|
|
110
|
+
],
|
|
111
|
+
[
|
|
112
|
+
[ARENA.halfX * 2 + ARENA.thickness, height, ARENA.thickness],
|
|
113
|
+
[0, y, ARENA.halfZ],
|
|
114
|
+
],
|
|
115
|
+
[
|
|
116
|
+
[ARENA.thickness, height, ARENA.halfZ * 2 - ARENA.thickness],
|
|
117
|
+
[-ARENA.halfX, y, 0],
|
|
118
|
+
],
|
|
119
|
+
[
|
|
120
|
+
[ARENA.thickness, height, ARENA.halfZ * 2 - ARENA.thickness],
|
|
121
|
+
[ARENA.halfX, y, 0],
|
|
122
|
+
],
|
|
123
|
+
] as const
|
|
124
|
+
).map(([size, at]) => box(size, at, structureMaterial, 0.14));
|
|
125
|
+
// A tall dark mass behind the route: the course is a corridor, and this is what tells the player
|
|
126
|
+
// where the frame stops. A cylinder rather than a box, so its collider has to be a trimesh.
|
|
127
|
+
const pillar = meshOf(new CylinderGeometry(1.6, 1.6, height, 48), [-9, y, -8], structureMaterial);
|
|
128
|
+
const solids = [...walls, pillar];
|
|
129
|
+
for (const solid of solids) group.add(solid);
|
|
130
|
+
return { group, solids };
|
|
131
|
+
}
|
|
@@ -1,60 +1,43 @@
|
|
|
1
1
|
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
2
|
// ThreeNative does not read this file.
|
|
3
3
|
//
|
|
4
|
-
//
|
|
5
|
-
// so
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
import {
|
|
9
|
-
AmbientLight,
|
|
10
|
-
DirectionalLight,
|
|
11
|
-
HemisphereLight,
|
|
12
|
-
PCFSoftShadowMap,
|
|
13
|
-
type Scene,
|
|
14
|
-
} from "three";
|
|
15
|
-
import { palette } from "./palette.js";
|
|
4
|
+
// One sun. The sky image in `sky.ts` is the fill light — its environment reaches every face the
|
|
5
|
+
// sun misses — so there is no hemisphere or ambient light stacked on top to flatten the frame.
|
|
6
|
+
import { DirectionalLight, PCFSoftShadowMap, type Scene } from "three";
|
|
7
|
+
import { SUN_DIRECTION } from "./sky.js";
|
|
16
8
|
|
|
17
9
|
type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
|
|
18
10
|
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
11
|
+
export function setupLighting(
|
|
12
|
+
scene: Scene,
|
|
13
|
+
renderer: ShadowRenderer,
|
|
14
|
+
mobile = false,
|
|
15
|
+
): { key: DirectionalLight } {
|
|
23
16
|
renderer.shadowMap.enabled = true;
|
|
24
17
|
renderer.shadowMap.type = PCFSoftShadowMap;
|
|
25
18
|
|
|
26
|
-
//
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
const key = new DirectionalLight(palette.accent, 2.4);
|
|
31
|
-
key.position.set(4, 7, 3);
|
|
19
|
+
// Warm white, matched by eye to the photographed midday sun against its own sky.
|
|
20
|
+
const key = new DirectionalLight(0xfff1e0, 4.5);
|
|
21
|
+
key.position.copy(SUN_DIRECTION).multiplyScalar(30);
|
|
32
22
|
key.castShadow = true;
|
|
33
|
-
//
|
|
34
|
-
//
|
|
35
|
-
//
|
|
36
|
-
|
|
37
|
-
key.shadow.
|
|
38
|
-
key.shadow.
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
const extent = 18;
|
|
23
|
+
// One map fitted to the 28 m arena: 4096² is under a centimetre a texel, so every shadow has the
|
|
24
|
+
// same softness. Camera-centred cascades (`VirtualShadowNode`) are for open worlds; here their
|
|
25
|
+
// level boundaries showed as shadows that turned sharp halfway along. Phones take 2048².
|
|
26
|
+
const size = mobile ? 2048 : 4096;
|
|
27
|
+
key.shadow.mapSize.set(size, size);
|
|
28
|
+
key.shadow.radius = 2;
|
|
29
|
+
key.shadow.camera.near = 1;
|
|
30
|
+
key.shadow.camera.far = 80;
|
|
31
|
+
const extent = 14;
|
|
43
32
|
key.shadow.camera.left = -extent;
|
|
44
33
|
key.shadow.camera.right = extent;
|
|
45
34
|
key.shadow.camera.top = extent;
|
|
46
35
|
key.shadow.camera.bottom = -extent;
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
key.shadow.normalBias = 0.03;
|
|
36
|
+
// Small biases: a large normal bias is what lifted the mannequin's shadow off its own feet.
|
|
37
|
+
key.shadow.bias = -0.0002;
|
|
38
|
+
key.shadow.normalBias = 0.005;
|
|
51
39
|
scene.add(key);
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
scene.add(rim);
|
|
56
|
-
|
|
57
|
-
scene.add(new AmbientLight(palette.skyLow, 0.38));
|
|
58
|
-
|
|
59
|
-
return key;
|
|
40
|
+
// The key light is returned because `WorldEnvironment`'s godrays stage raymarches against its
|
|
41
|
+
// shadow map, so `setupPost` needs the light itself.
|
|
42
|
+
return { key };
|
|
60
43
|
}
|