create-threenative 0.2.5 → 0.2.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +25 -3
- package/agent-docs/references/assertion-reference.md +40 -1
- package/agent-docs/references/build-profiles.md +126 -0
- package/agent-docs/references/capability-reference.md +1382 -65
- package/agent-docs/references/finding-assets.md +8 -1
- package/agent-docs/references/performance-basics.md +117 -0
- package/agent-docs/references/rigging-characters.md +51 -0
- package/agent-docs/references/sculpt-from-a-reference.md +1 -1
- package/agent-docs/references/trace-a-slow-frame.md +1 -1
- package/agent-docs/references/visual-baseline.md +8 -4
- package/agent-docs/references/webview-ui.md +3 -2
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
- package/agent-files/.agents/skills/ponytail/SKILL.md +68 -0
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +12 -4
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-context/SKILL.md +9 -1
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +26 -10
- package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
- package/agent-files/.claude/hooks/ponytail-context.mjs +51 -0
- package/agent-files/.claude/settings.json +38 -0
- package/agent-files/.codex/hooks.json +40 -0
- package/capabilities.json +1891 -101
- package/dist/index.d.ts +39 -1
- package/dist/index.js +480 -56
- package/dist/threenative.js +1247 -177
- package/package.json +6 -6
- package/template-assets/assets/mannequin-combat.glb +0 -0
- package/template-assets/assets/mannequin.glb +0 -0
- package/template-assets/assets/player-viewmodel.glb +0 -0
- package/template-assets/assets/sky.jpg +0 -0
- package/template-assets/clearwater/README.md +141 -0
- package/template-assets/clearwater/install.mjs +50 -0
- package/template-assets/clearwater/src/clearwater.ts +180 -0
- package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
- package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
- package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
- package/template-assets/clearwater/src/render/clearwater.ts +278 -0
- package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
- package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
- package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
- package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
- package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
- package/template-assets/patches/three@0.185.1.patch +2228 -105
- package/template-assets/worldEnvironment.ts +52 -1
- package/templates/action-rpg/AGENTS.md +43 -43
- package/templates/action-rpg/CLAUDE.md +43 -43
- package/templates/action-rpg/kit.json +1 -1
- package/templates/action-rpg/package.json +14 -8
- package/templates/action-rpg/playtests/combat.playtest.json +162 -23
- package/templates/action-rpg/playtests/performance.playtest.json +4 -3
- package/templates/action-rpg/playtests/survives.playtest.json +25 -8
- package/templates/action-rpg/src/conventions.ts +24 -18
- package/templates/action-rpg/src/entities/Enemy.ts +74 -24
- package/templates/action-rpg/src/entities/Fighter.ts +127 -0
- package/templates/action-rpg/src/entities/Player.ts +102 -32
- package/templates/action-rpg/src/game.ts +3 -3
- package/templates/action-rpg/src/render/camera.ts +18 -16
- package/templates/action-rpg/src/render/dungeon.ts +192 -0
- package/templates/action-rpg/src/render/lighting.ts +45 -28
- package/templates/action-rpg/src/render/loading.ts +4 -4
- package/templates/action-rpg/src/render/materials.ts +191 -47
- package/templates/action-rpg/src/render/palette.ts +14 -13
- package/templates/action-rpg/src/render/postprocessing.ts +12 -2
- package/templates/action-rpg/src/render/props.ts +117 -0
- package/templates/action-rpg/src/render/quality.ts +40 -82
- package/templates/action-rpg/src/render/sky.ts +36 -13
- package/templates/action-rpg/src/render/touch-controls.ts +1 -1
- package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
- package/templates/action-rpg/src/scenes/Play.ts +61 -39
- package/templates/action-rpg/src/style.css +9 -7
- package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
- package/templates/action-rpg/src/ui/Hud.tsx +3 -3
- package/templates/action-rpg/threenative.config.ts +14 -1
- package/templates/action-rpg/vite.config.ts +4 -1
- package/templates/minimal/AGENTS.md +12 -12
- package/templates/minimal/CLAUDE.md +12 -12
- package/templates/minimal/package.json +13 -7
- package/templates/minimal/playtests/play.playtest.json +6 -5
- package/templates/minimal/playtests/sky.playtest.json +27 -0
- package/templates/minimal/src/conventions.ts +6 -3
- package/templates/minimal/src/entities/Player.ts +73 -27
- package/templates/minimal/src/main.ts +2 -3
- package/templates/minimal/src/render/camera.ts +22 -4
- package/templates/minimal/src/render/lighting.ts +24 -48
- package/templates/minimal/src/render/materials.ts +158 -13
- package/templates/minimal/src/render/palette.ts +10 -7
- package/templates/minimal/src/render/postprocessing.ts +12 -25
- package/templates/minimal/src/render/quality.ts +35 -69
- package/templates/minimal/src/render/sky.ts +35 -54
- package/templates/minimal/src/render/touch-controls.ts +1 -1
- package/templates/minimal/src/render/worldEnvironment.ts +52 -1
- package/templates/minimal/src/scenes/Play.ts +121 -111
- package/templates/minimal/src/state.ts +0 -4
- package/templates/minimal/src/style.css +0 -10
- package/templates/minimal/threenative.config.ts +15 -1
- package/templates/minimal/vite.config.ts +4 -1
- package/templates/platformer/AGENTS.md +18 -56
- package/templates/platformer/CLAUDE.md +18 -56
- package/templates/platformer/kit.json +2 -2
- package/templates/platformer/package.json +14 -10
- package/templates/platformer/playtests/buffer.playtest.json +15 -5
- package/templates/platformer/playtests/collect.playtest.json +8 -34
- package/templates/platformer/playtests/coyote.playtest.json +12 -34
- package/templates/platformer/playtests/damage.playtest.json +40 -15
- package/templates/platformer/playtests/hud.playtest.json +34 -0
- package/templates/platformer/playtests/move.playtest.json +24 -0
- package/templates/platformer/playtests/performance.playtest.json +24 -7
- package/templates/platformer/playtests/respawn.playtest.json +46 -11
- package/templates/platformer/playtests/stomp.playtest.json +49 -12
- package/templates/platformer/playtests/survives.playtest.json +3 -19
- package/templates/platformer/playtests/world.playtest.json +26 -0
- package/templates/platformer/src/entities/Fox.ts +273 -0
- package/templates/platformer/src/entities/Pickup.ts +43 -60
- package/templates/platformer/src/entities/Walker.ts +88 -0
- package/templates/platformer/src/game.ts +11 -8
- package/templates/platformer/src/level/Checkpoints.ts +29 -16
- package/templates/platformer/src/level/Stage.ts +469 -0
- package/templates/platformer/src/render/blocks.ts +94 -0
- package/templates/platformer/src/render/camera.ts +28 -3
- package/templates/platformer/src/render/fox.ts +196 -0
- package/templates/platformer/src/render/lighting.ts +42 -33
- package/templates/platformer/src/render/materials.ts +115 -5
- package/templates/platformer/src/render/palette.ts +68 -53
- package/templates/platformer/src/render/pickups.ts +142 -0
- package/templates/platformer/src/render/postprocessing.ts +12 -2
- package/templates/platformer/src/render/props.ts +147 -0
- package/templates/platformer/src/render/quality.ts +47 -99
- package/templates/platformer/src/render/scenery.ts +172 -0
- package/templates/platformer/src/render/sky.ts +120 -31
- package/templates/platformer/src/render/touch-controls.ts +5 -2
- package/templates/platformer/src/render/walkers.ts +96 -0
- package/templates/platformer/src/render/waterfall.ts +85 -0
- package/templates/platformer/src/render/worldEnvironment.ts +52 -1
- package/templates/platformer/src/scenes/Boot.ts +3 -4
- package/templates/platformer/src/scenes/Play.ts +362 -0
- package/templates/platformer/src/state.ts +16 -14
- package/templates/platformer/src/style.css +9 -8
- package/templates/platformer/src/ui/Hud.tsx +62 -29
- package/templates/platformer/src/ui/Menu.tsx +2 -2
- package/templates/platformer/threenative.config.ts +14 -1
- package/templates/platformer/vite.config.ts +4 -1
- package/templates/puzzle/AGENTS.md +21 -22
- package/templates/puzzle/CLAUDE.md +21 -22
- package/templates/puzzle/assets/native-proof.glb +0 -0
- package/templates/puzzle/assets/native-proof.png +0 -0
- package/templates/puzzle/kit.json +1 -1
- package/templates/puzzle/package.json +14 -8
- package/templates/puzzle/playtests/axis.playtest.json +20 -0
- package/templates/puzzle/playtests/blocked.playtest.json +73 -0
- package/templates/puzzle/playtests/caused.playtest.json +65 -0
- package/templates/puzzle/playtests/lit.playtest.json +74 -0
- package/templates/puzzle/playtests/performance.playtest.json +24 -7
- package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
- package/templates/puzzle/playtests/replay.playtest.json +81 -0
- package/templates/puzzle/playtests/restart.playtest.json +108 -0
- package/templates/puzzle/playtests/seal.playtest.json +98 -0
- package/templates/puzzle/playtests/settle.playtest.json +100 -0
- package/templates/puzzle/playtests/survives.playtest.json +6 -29
- package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
- package/templates/puzzle/src/entities/Crate.ts +99 -42
- package/templates/puzzle/src/entities/Seal.ts +69 -0
- package/templates/puzzle/src/entities/Warden.ts +135 -0
- package/templates/puzzle/src/game.ts +15 -11
- package/templates/puzzle/src/render/camera.ts +66 -31
- package/templates/puzzle/src/render/crateShape.ts +70 -0
- package/templates/puzzle/src/render/lighting.ts +41 -41
- package/templates/puzzle/src/render/loading.ts +4 -4
- package/templates/puzzle/src/render/materials.ts +131 -27
- package/templates/puzzle/src/render/palette.ts +19 -29
- package/templates/puzzle/src/render/postprocessing.ts +15 -3
- package/templates/puzzle/src/render/quality.ts +71 -80
- package/templates/puzzle/src/render/shapes.ts +109 -108
- package/templates/puzzle/src/render/sky.ts +18 -10
- package/templates/puzzle/src/render/touch-controls.ts +8 -51
- package/templates/puzzle/src/render/vault.ts +315 -0
- package/templates/puzzle/src/render/warden.ts +46 -0
- package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
- package/templates/puzzle/src/scenes/Play.ts +793 -0
- package/templates/puzzle/src/state.ts +55 -24
- package/templates/puzzle/src/style.css +7 -8
- package/templates/puzzle/src/ui/App.tsx +2 -2
- package/templates/puzzle/src/ui/Hud.tsx +92 -40
- package/templates/puzzle/src/ui/Menu.tsx +40 -2
- package/templates/puzzle/threenative.config.ts +14 -1
- package/templates/puzzle/vite.config.ts +4 -1
- package/templates/racing/AGENTS.md +20 -21
- package/templates/racing/CLAUDE.md +20 -21
- package/templates/racing/package.json +14 -8
- package/templates/racing/playtests/boost.playtest.json +33 -12
- package/templates/racing/playtests/outcome.playtest.json +32 -50
- package/templates/racing/playtests/performance.playtest.json +2 -1
- package/templates/racing/playtests/ranking.playtest.json +5 -14
- package/templates/racing/playtests/rescue.playtest.json +2 -2
- package/templates/racing/playtests/reverse.playtest.json +30 -8
- package/templates/racing/playtests/shortcut.playtest.json +54 -9
- package/templates/racing/playtests/touch-controls.playtest.json +32 -5
- package/templates/racing/src/entities/CarBody.ts +327 -0
- package/templates/racing/src/entities/LineDriver.ts +220 -0
- package/templates/racing/src/entities/RacingCar.ts +150 -89
- package/templates/racing/src/entities/Rival.ts +61 -24
- package/templates/racing/src/game.ts +5 -0
- package/templates/racing/src/render/camera.ts +49 -7
- package/templates/racing/src/render/lighting.ts +36 -37
- package/templates/racing/src/render/materials.ts +239 -19
- package/templates/racing/src/render/palette.ts +19 -21
- package/templates/racing/src/render/postprocessing.ts +12 -2
- package/templates/racing/src/render/quality.ts +43 -82
- package/templates/racing/src/render/shapes.ts +20 -6
- package/templates/racing/src/render/sky.ts +47 -39
- package/templates/racing/src/render/touch-controls.ts +1 -1
- package/templates/racing/src/render/worldEnvironment.ts +52 -1
- package/templates/racing/src/scenes/Race.ts +107 -54
- package/templates/racing/src/state.ts +2 -0
- package/templates/racing/src/track/Checkline.ts +22 -7
- package/templates/racing/src/track/Lap.ts +64 -36
- package/templates/racing/src/track/Ranking.ts +20 -11
- package/templates/racing/src/track/Track.ts +809 -361
- package/templates/racing/src/track/TrackSector.ts +40 -11
- package/templates/racing/src/track/circuit.ts +477 -0
- package/templates/racing/src/track/rescue.ts +16 -4
- package/templates/racing/threenative.config.ts +14 -1
- package/templates/racing/vite.config.ts +4 -1
- package/templates/rts/AGENTS.md +96 -0
- package/templates/rts/CLAUDE.md +98 -0
- package/templates/rts/kit.json +7 -0
- package/templates/{defense → rts}/package.json +14 -8
- package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
- package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
- package/templates/rts/playtests/rts-attack.playtest.json +75 -0
- package/templates/rts/playtests/rts-build.playtest.json +68 -0
- package/templates/rts/playtests/rts-orders.playtest.json +150 -0
- package/templates/rts/playtests/rts-train.playtest.json +62 -0
- package/templates/rts/playtests/survives.playtest.json +58 -0
- package/templates/rts/public/favicon.svg +4 -0
- package/templates/rts/src/game.ts +64 -0
- package/templates/rts/src/orders.ts +22 -0
- package/templates/rts/src/render/army.ts +346 -0
- package/templates/rts/src/render/camera.ts +123 -0
- package/templates/rts/src/render/lighting.ts +61 -0
- package/templates/rts/src/render/loading.ts +33 -0
- package/templates/rts/src/render/materials.ts +152 -0
- package/templates/rts/src/render/models.ts +705 -0
- package/templates/rts/src/render/palette.ts +17 -0
- package/templates/rts/src/render/picking.ts +93 -0
- package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
- package/templates/rts/src/render/quality.ts +128 -0
- package/templates/rts/src/render/resources.ts +141 -0
- package/templates/rts/src/render/sky.ts +44 -0
- package/templates/rts/src/render/terrain.ts +116 -0
- package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
- package/templates/rts/src/scenes/Play.ts +650 -0
- package/templates/rts/src/sim/ai.ts +1140 -0
- package/templates/rts/src/sim/combat.ts +416 -0
- package/templates/rts/src/sim/construction.ts +374 -0
- package/templates/rts/src/sim/economy.ts +167 -0
- package/templates/rts/src/sim/game.ts +1082 -0
- package/templates/rts/src/sim/movement.ts +371 -0
- package/templates/rts/src/sim/nav.ts +276 -0
- package/templates/rts/src/sim/production.ts +180 -0
- package/templates/rts/src/sim/terrain.ts +170 -0
- package/templates/rts/src/sim/types.ts +647 -0
- package/templates/rts/src/sim/vision.ts +46 -0
- package/templates/rts/src/state.ts +100 -0
- package/templates/{defense → rts}/src/style.css +21 -8
- package/templates/rts/src/ui/App.tsx +21 -0
- package/templates/rts/src/ui/Commands.tsx +129 -0
- package/templates/rts/src/ui/GameUi.tsx +22 -0
- package/templates/rts/src/ui/Hud.tsx +165 -0
- package/templates/rts/src/ui/Minimap.tsx +84 -0
- package/templates/rts/tailwind.config.ts +2 -0
- package/templates/rts/threenative.config.ts +56 -0
- package/templates/rts/tsconfig.json +17 -0
- package/templates/{defense → rts}/vite.config.ts +4 -1
- package/templates/runner/AGENTS.md +8 -12
- package/templates/runner/CLAUDE.md +8 -12
- package/templates/runner/README.md +3 -3
- package/templates/runner/package.json +14 -8
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +4 -3
- package/templates/runner/src/entities/Runner.ts +54 -7
- package/templates/runner/src/game.ts +2 -0
- package/templates/runner/src/render/camera.ts +4 -2
- package/templates/runner/src/render/dust.ts +5 -2
- package/templates/runner/src/render/lighting.ts +41 -45
- package/templates/runner/src/render/loading.ts +2 -2
- package/templates/runner/src/render/materials.ts +165 -25
- package/templates/runner/src/render/palette.ts +17 -28
- package/templates/runner/src/render/postprocessing.ts +12 -2
- package/templates/runner/src/render/quality.ts +42 -96
- package/templates/runner/src/render/shapes.ts +59 -37
- package/templates/runner/src/render/sky.ts +32 -41
- package/templates/runner/src/render/touch-controls.ts +1 -1
- package/templates/runner/src/render/worldEnvironment.ts +52 -1
- package/templates/runner/src/scenes/Run.ts +26 -6
- package/templates/runner/src/track.ts +6 -1
- package/templates/runner/threenative.config.ts +14 -1
- package/templates/runner/vite.config.ts +4 -1
- package/templates/sailing/AGENTS.md +14 -14
- package/templates/sailing/CLAUDE.md +14 -14
- package/templates/sailing/assets/ship.glb +0 -0
- package/templates/sailing/package.json +14 -8
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
- package/templates/sailing/playtests/sails.playtest.json +33 -0
- package/templates/sailing/playtests/win.playtest.json +156 -8
- package/templates/sailing/src/conventions.ts +29 -2
- package/templates/sailing/src/entities/Ship.ts +381 -57
- package/templates/sailing/src/game.ts +14 -0
- package/templates/sailing/src/render/camera.ts +63 -9
- package/templates/sailing/src/render/lighting.ts +49 -27
- package/templates/sailing/src/render/materials.ts +50 -15
- package/templates/sailing/src/render/ocean.ts +647 -60
- package/templates/sailing/src/render/palette.ts +16 -12
- package/templates/sailing/src/render/postprocessing.ts +12 -2
- package/templates/sailing/src/render/props.ts +316 -442
- package/templates/sailing/src/render/quality.ts +14 -4
- package/templates/sailing/src/render/sky.ts +116 -23
- package/templates/sailing/src/render/worldEnvironment.ts +52 -1
- package/templates/sailing/src/scenes/Boot.ts +21 -0
- package/templates/sailing/src/scenes/Sailing.ts +173 -39
- package/templates/sailing/src/state.ts +6 -0
- package/templates/sailing/src/ui/Hud.tsx +41 -9
- package/templates/sailing/threenative.config.ts +14 -1
- package/templates/sailing/vite.config.ts +4 -1
- package/templates/shooter/AGENTS.md +29 -44
- package/templates/shooter/CLAUDE.md +29 -44
- package/templates/shooter/index.html +1 -0
- package/templates/shooter/package.json +14 -8
- package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
- package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
- package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
- package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
- package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
- package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
- package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
- package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
- package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
- package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
- package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
- package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
- package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
- package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
- package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
- package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
- package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
- package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
- package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
- package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
- package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
- package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
- package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
- package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
- package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
- package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
- package/templates/shooter/playtests/input-control.playtest.json +43 -98
- package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
- package/templates/shooter/playtests/performance.playtest.json +62 -26
- package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
- package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
- package/templates/shooter/playtests/survives.playtest.json +36 -30
- package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
- package/templates/shooter/src/entities/Breakables.ts +412 -0
- package/templates/shooter/src/entities/Enemy.ts +2095 -0
- package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
- package/templates/shooter/src/entities/Rifle.ts +442 -0
- package/templates/shooter/src/entities/Target.ts +199 -83
- package/templates/shooter/src/entities/TouchControls.ts +276 -0
- package/templates/shooter/src/game.ts +75 -41
- package/templates/shooter/src/main.ts +0 -1
- package/templates/shooter/src/postPhysics.ts +36 -0
- package/templates/shooter/src/render/camera.ts +78 -74
- package/templates/shooter/src/render/decals.ts +142 -82
- package/templates/shooter/src/render/facade.ts +1373 -0
- package/templates/shooter/src/render/gunfx.ts +704 -0
- package/templates/shooter/src/render/lighting.ts +52 -38
- package/templates/shooter/src/render/loading.ts +2 -2
- package/templates/shooter/src/render/materials.ts +100 -88
- package/templates/shooter/src/render/occlusion.ts +108 -0
- package/templates/shooter/src/render/palette.ts +10 -10
- package/templates/shooter/src/render/palm.ts +455 -0
- package/templates/shooter/src/render/pooled-billboards.ts +144 -0
- package/templates/shooter/src/render/postprocessing.ts +15 -3
- package/templates/shooter/src/render/quality.ts +40 -82
- package/templates/shooter/src/render/scale.ts +148 -15
- package/templates/shooter/src/render/shapes.ts +138 -613
- package/templates/shooter/src/render/sky.ts +35 -35
- package/templates/shooter/src/render/town-schematic.ts +120 -0
- package/templates/shooter/src/render/town.ts +986 -0
- package/templates/shooter/src/render/townMaterials.ts +160 -0
- package/templates/shooter/src/render/vehicles.ts +741 -0
- package/templates/shooter/src/render/worldEnvironment.ts +52 -1
- package/templates/shooter/src/scenes/Play.ts +727 -650
- package/templates/shooter/src/state.ts +26 -41
- package/templates/shooter/src/style.css +207 -11
- package/templates/shooter/src/surfaces.ts +131 -0
- package/templates/shooter/src/ui/App.tsx +9 -10
- package/templates/shooter/src/ui/Crosshair.tsx +25 -18
- package/templates/shooter/src/ui/GameUi.tsx +6 -9
- package/templates/shooter/src/ui/Hud.tsx +428 -39
- package/templates/shooter/src/ui/Minimap.tsx +164 -0
- package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
- package/templates/shooter/src/ui/main.tsx +2 -3
- package/templates/shooter/threenative.config.ts +14 -1
- package/templates/shooter/vite.config.ts +4 -1
- package/templates/starter/AGENTS.md +20 -20
- package/templates/starter/CLAUDE.md +20 -20
- package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
- package/templates/starter/package.json +15 -9
- package/templates/starter/playtests/play.playtest.json +2 -1
- package/templates/starter/playtests/{restart.playtest.json → production-readiness.playtest.json} +17 -12
- package/templates/starter/playtests/survives.playtest.json +1 -1
- package/templates/starter/src/conventions.ts +6 -3
- package/templates/starter/src/entities/Goal.ts +35 -42
- package/templates/starter/src/entities/Player.ts +99 -16
- package/templates/starter/src/render/arena.ts +131 -0
- package/templates/starter/src/render/lighting.ts +27 -44
- package/templates/starter/src/render/materials.ts +164 -35
- package/templates/starter/src/render/palette.ts +16 -16
- package/templates/starter/src/render/postprocessing.ts +6 -7
- package/templates/starter/src/render/quality.ts +43 -101
- package/templates/starter/src/render/shapes.ts +1 -1
- package/templates/starter/src/render/sky.ts +39 -45
- package/templates/starter/src/render/touch-controls.ts +3 -1
- package/templates/starter/src/render/worldEnvironment.ts +52 -1
- package/templates/starter/src/scenes/Play.ts +82 -81
- package/templates/starter/src/ui/Hud.tsx +2 -2
- package/templates/starter/src/ui/Menu.tsx +5 -1
- package/templates/starter/threenative.config.ts +14 -1
- package/templates/starter/vite.config.ts +4 -1
- package/templates/tower-defense/.codex/config.toml +19 -0
- package/templates/tower-defense/.cursor/mcp.json +32 -0
- package/templates/tower-defense/.gemini/settings.json +32 -0
- package/templates/tower-defense/.mcp.json +32 -0
- package/templates/tower-defense/.vscode/mcp.json +36 -0
- package/templates/tower-defense/.zed/settings.json +36 -0
- package/templates/{defense → tower-defense}/AGENTS.md +16 -14
- package/templates/{defense → tower-defense}/CLAUDE.md +16 -14
- package/templates/tower-defense/README.md +16 -0
- package/templates/tower-defense/index.html +12 -0
- package/templates/tower-defense/kit.json +7 -0
- package/templates/tower-defense/opencode.json +41 -0
- package/templates/tower-defense/package.json +56 -0
- package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
- package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
- package/templates/tower-defense/playtests/look.playtest.json +130 -0
- package/templates/tower-defense/playtests/performance.playtest.json +77 -0
- package/templates/tower-defense/playtests/placement.playtest.json +115 -0
- package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
- package/templates/tower-defense/playtests/strike.playtest.json +98 -0
- package/templates/tower-defense/playtests/survives.playtest.json +85 -0
- package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
- package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
- package/templates/tower-defense/playtests/victory.playtest.json +810 -0
- package/templates/tower-defense/src/balance.ts +187 -0
- package/templates/tower-defense/src/board/Board.ts +100 -0
- package/templates/tower-defense/src/board/Route.ts +84 -0
- package/templates/tower-defense/src/camera-rig.ts +62 -0
- package/templates/tower-defense/src/economy.ts +64 -0
- package/templates/tower-defense/src/effects/Effects.ts +284 -0
- package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
- package/templates/tower-defense/src/game.ts +72 -0
- package/templates/tower-defense/src/intents.ts +21 -0
- package/templates/tower-defense/src/main.ts +15 -0
- package/templates/tower-defense/src/physics.ts +6 -0
- package/templates/tower-defense/src/render/camera.ts +38 -0
- package/templates/tower-defense/src/render/lighting.ts +42 -0
- package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
- package/templates/tower-defense/src/render/materials.ts +103 -0
- package/templates/tower-defense/src/render/palette.ts +58 -0
- package/templates/tower-defense/src/render/postprocessing.ts +46 -0
- package/templates/tower-defense/src/render/quality.ts +128 -0
- package/templates/tower-defense/src/render/shapes.ts +550 -0
- package/templates/tower-defense/src/render/sky.ts +27 -0
- package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
- package/templates/tower-defense/src/scenes/Battle.ts +539 -0
- package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
- package/templates/tower-defense/src/state.ts +88 -0
- package/templates/tower-defense/src/style.css +137 -0
- package/templates/tower-defense/src/towers/Tower.ts +230 -0
- package/templates/tower-defense/src/towers/targeting.ts +97 -0
- package/templates/tower-defense/src/ui/Hud.tsx +270 -0
- package/templates/tower-defense/src/ui/Menu.tsx +134 -0
- package/templates/tower-defense/src/ui/icons.tsx +54 -0
- package/templates/tower-defense/src/ui/main.tsx +14 -0
- package/templates/tower-defense/src/waves.ts +90 -0
- package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
- package/templates/tower-defense/vite.config.ts +41 -0
- package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
- package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -45
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
- package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -57
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -42
- package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
- package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
- package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
- package/agent-files/AGENT-ROLES.md +0 -26
- package/templates/action-rpg/src/render/shapes.ts +0 -269
- package/templates/action-rpg/src/render/types.ts +0 -3
- package/templates/action-rpg/src/scenes/Boot.ts +0 -12
- package/templates/defense/README.md +0 -10
- package/templates/defense/kit.json +0 -7
- package/templates/defense/playtests/leak.playtest.json +0 -23
- package/templates/defense/playtests/placement.playtest.json +0 -40
- package/templates/defense/playtests/scan.playtest.json +0 -20
- package/templates/defense/playtests/survive.playtest.json +0 -45
- package/templates/defense/playtests/survives.playtest.json +0 -36
- package/templates/defense/src/attackers/Attacker.ts +0 -120
- package/templates/defense/src/board/Route.ts +0 -94
- package/templates/defense/src/conventions.ts +0 -18
- package/templates/defense/src/economy.ts +0 -36
- package/templates/defense/src/entities/Player.ts +0 -52
- package/templates/defense/src/game.ts +0 -51
- package/templates/defense/src/physics.ts +0 -13
- package/templates/defense/src/placement/Buildable.ts +0 -49
- package/templates/defense/src/render/camera.ts +0 -16
- package/templates/defense/src/render/lighting.ts +0 -37
- package/templates/defense/src/render/materials.ts +0 -22
- package/templates/defense/src/render/palette.ts +0 -28
- package/templates/defense/src/render/quality.ts +0 -170
- package/templates/defense/src/render/shapes.ts +0 -246
- package/templates/defense/src/render/sky.ts +0 -45
- package/templates/defense/src/scenes/Boot.ts +0 -12
- package/templates/defense/src/scenes/Defense.ts +0 -231
- package/templates/defense/src/state.ts +0 -56
- package/templates/defense/src/towers/Tower.ts +0 -95
- package/templates/defense/src/towers/targeting.ts +0 -53
- package/templates/defense/src/ui/Hud.tsx +0 -62
- package/templates/defense/src/ui/Menu.tsx +0 -7
- package/templates/defense/src/waves.ts +0 -40
- package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
- package/templates/minimal/src/render/hud.ts +0 -69
- package/templates/platformer/playtests/avoidance.playtest.json +0 -28
- package/templates/platformer/playtests/chase.playtest.json +0 -21
- package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
- package/templates/platformer/playtests/oneway.playtest.json +0 -44
- package/templates/platformer/playtests/patrol.playtest.json +0 -13
- package/templates/platformer/playtests/physics.playtest.json +0 -14
- package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
- package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
- package/templates/platformer/src/conventions.ts +0 -18
- package/templates/platformer/src/entities/Character.ts +0 -286
- package/templates/platformer/src/entities/Chaser.ts +0 -118
- package/templates/platformer/src/entities/Patrol.ts +0 -93
- package/templates/platformer/src/level/Platform.ts +0 -46
- package/templates/platformer/src/render/rig.ts +0 -60
- package/templates/platformer/src/render/terrain.ts +0 -31
- package/templates/platformer/src/scenes/Level.ts +0 -241
- package/templates/puzzle/README.md +0 -43
- package/templates/puzzle/playtests/carry.playtest.json +0 -71
- package/templates/puzzle/playtests/swing.playtest.json +0 -38
- package/templates/puzzle/src/conventions.ts +0 -25
- package/templates/puzzle/src/entities/Ball.ts +0 -70
- package/templates/puzzle/src/entities/Gripper.ts +0 -69
- package/templates/puzzle/src/entities/Pendulum.ts +0 -89
- package/templates/puzzle/src/physics.ts +0 -19
- package/templates/puzzle/src/room.ts +0 -83
- package/templates/puzzle/src/scenes/Boot.ts +0 -12
- package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
- package/templates/shooter/playtests/combat.playtest.json +0 -48
- package/templates/shooter/playtests/fail.playtest.json +0 -31
- package/templates/shooter/playtests/per-item.playtest.json +0 -59
- package/templates/shooter/playtests/shooter.playtest.json +0 -99
- package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
- package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
- package/templates/shooter/src/combat/damage.ts +0 -40
- package/templates/shooter/src/conventions.ts +0 -51
- package/templates/shooter/src/entities/Pickup.ts +0 -70
- package/templates/shooter/src/entities/Player.ts +0 -310
- package/templates/shooter/src/level/SpawnPoints.ts +0 -28
- package/templates/shooter/src/playtest-events.ts +0 -15
- package/templates/shooter/src/render/touch-controls.ts +0 -305
- package/templates/shooter/src/render/types.ts +0 -3
- package/templates/shooter/src/render/ui.css +0 -330
- package/templates/shooter/src/render/ui.ts +0 -75
- package/templates/shooter/src/render/vfx.ts +0 -215
- package/templates/shooter/src/ui/Menu.tsx +0 -41
- package/templates/shooter/src/waves.ts +0 -50
- package/templates/shooter/src/weapons/Hitscan.ts +0 -42
- package/templates/shooter/src/weapons/Projectile.ts +0 -92
- package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
- package/templates/starter/playtests/assets.playtest.json +0 -65
- package/templates/starter/playtests/buffer.playtest.json +0 -79
- package/templates/starter/playtests/cloth.playtest.json +0 -113
- package/templates/starter/playtests/coyote.playtest.json +0 -87
- package/templates/starter/playtests/gameover.playtest.json +0 -66
- package/templates/starter/playtests/goal.playtest.json +0 -67
- package/templates/starter/playtests/look.playtest.json +0 -175
- package/templates/starter/playtests/models-baseline.png +0 -0
- package/templates/starter/playtests/models.playtest.json +0 -74
- package/templates/starter/playtests/monitoring.playtest.json +0 -72
- package/templates/starter/playtests/odometer.playtest.json +0 -54
- package/templates/starter/playtests/seed.playtest.json +0 -54
- package/templates/starter/playtests/textures-baseline.png +0 -0
- package/templates/starter/playtests/textures.playtest.json +0 -74
- package/templates/starter/playtests/touch-controls.playtest.json +0 -42
- package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
- package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
- package/templates/starter/src/render/coast.ts +0 -199
- package/templates/starter/src/render/hero.ts +0 -88
- package/templates/starter/src/render/implicitSurface.ts +0 -199
- package/templates/starter/src/render/kuwahara.ts +0 -174
- package/templates/starter/src/render/outline.ts +0 -141
- package/templates/starter/src/render/painterly.ts +0 -86
- package/templates/starter/src/render/rockRidge.ts +0 -198
- package/templates/starter/src/render/rockRidge.worker.ts +0 -77
- package/templates/starter/src/render/scenery.ts +0 -40
- package/templates/starter/src/render/textureLifetime.ts +0 -53
- package/templates/starter/src/render/water.ts +0 -38
- package/templates/starter/src/render/watercolor.ts +0 -85
- /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
- /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
- /package/templates/{defense → rts}/.codex/config.toml +0 -0
- /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
- /package/templates/{defense → rts}/.gemini/settings.json +0 -0
- /package/templates/{defense → rts}/.mcp.json +0 -0
- /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
- /package/templates/{defense → rts}/.zed/settings.json +0 -0
- /package/templates/{defense → rts}/index.html +0 -0
- /package/templates/{defense → rts}/opencode.json +0 -0
- /package/templates/{defense → rts}/src/main.ts +0 -0
- /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
- /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
- /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
- /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
- /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
- /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
- /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
|
@@ -1,8 +1,19 @@
|
|
|
1
1
|
import type { Vector3 } from "three";
|
|
2
|
-
import
|
|
2
|
+
import { FOX_FEEL } from "../entities/Fox.js";
|
|
3
3
|
|
|
4
|
-
type RespawnTarget =
|
|
4
|
+
type RespawnTarget = {
|
|
5
|
+
body: { teleport(p: Vector3): void; velocity: { set(x: number, y: number, z: number): void } };
|
|
6
|
+
mesh: { position: Vector3 };
|
|
7
|
+
};
|
|
5
8
|
|
|
9
|
+
/**
|
|
10
|
+
* Hearts, the invulnerability window, and the ordered points a fall puts the fox back at.
|
|
11
|
+
*
|
|
12
|
+
* Three lives and a checkpoint per walkable stretch, which is the whole of the fox's failure
|
|
13
|
+
* state: run out of hearts and the fox respawns at the last point it passed with a full set,
|
|
14
|
+
* rather than the run ending. That is why this game has no lose screen, and why `hearts` reaching
|
|
15
|
+
* zero is a transition rather than a terminal state.
|
|
16
|
+
*/
|
|
6
17
|
export class Checkpoints {
|
|
7
18
|
readonly points: readonly Vector3[];
|
|
8
19
|
readonly maxHearts: number;
|
|
@@ -10,27 +21,28 @@ export class Checkpoints {
|
|
|
10
21
|
currentIndex = 0;
|
|
11
22
|
respawns = 0;
|
|
12
23
|
#invulnerable = 0;
|
|
13
|
-
#feel: typeof PLATFORMER_FEEL;
|
|
14
24
|
|
|
15
|
-
constructor(points: readonly Vector3[], maxHearts: number
|
|
25
|
+
constructor(points: readonly Vector3[], maxHearts: number) {
|
|
16
26
|
if (points.length === 0) throw new Error("Checkpoints requires at least one checkpoint.");
|
|
17
27
|
if (!Number.isInteger(maxHearts) || maxHearts <= 0)
|
|
18
28
|
throw new Error("Checkpoints requires a positive heart count.");
|
|
19
29
|
this.points = points.map((point) => point.clone());
|
|
20
30
|
this.maxHearts = maxHearts;
|
|
21
31
|
this.hearts = maxHearts;
|
|
22
|
-
this.#feel = feel;
|
|
23
32
|
}
|
|
24
33
|
|
|
25
34
|
get invulnerable(): boolean {
|
|
26
35
|
return this.#invulnerable > 0;
|
|
27
36
|
}
|
|
28
37
|
|
|
29
|
-
update(dt: number
|
|
38
|
+
update(dt: number): void {
|
|
30
39
|
if (!Number.isFinite(dt) || dt < 0) throw new Error("Checkpoints.update requires a valid dt.");
|
|
31
40
|
this.#invulnerable = Math.max(0, this.#invulnerable - dt);
|
|
32
|
-
|
|
33
|
-
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** The fox blinks while invulnerable; the frame it is hidden on is the one it would read as a flicker. */
|
|
44
|
+
blinks(time: number): boolean {
|
|
45
|
+
return !this.invulnerable || Math.floor(time * FOX_FEEL.blinkRate) % 2 === 0;
|
|
34
46
|
}
|
|
35
47
|
|
|
36
48
|
pass(position: Vector3): void {
|
|
@@ -44,23 +56,24 @@ export class Checkpoints {
|
|
|
44
56
|
hurt(target: RespawnTarget, fromX: number): boolean {
|
|
45
57
|
if (this.#invulnerable > 0 || this.hearts <= 0) return false;
|
|
46
58
|
this.hearts -= 1;
|
|
47
|
-
this.#invulnerable =
|
|
59
|
+
this.#invulnerable = FOX_FEEL.invulnerabilityTime;
|
|
60
|
+
// Knocked away from whatever hit it, and up, so a mushroom cannot chain into a second one.
|
|
48
61
|
const away = Math.sign(target.mesh.position.x - fromX) || -1;
|
|
49
|
-
target.body.velocity.set(
|
|
50
|
-
away * this.#feel.hurtHorizontalSpeed,
|
|
51
|
-
this.#feel.hurtVerticalSpeed,
|
|
52
|
-
0,
|
|
53
|
-
);
|
|
62
|
+
target.body.velocity.set(away * FOX_FEEL.dashSpeed * 0.4, FOX_FEEL.jumpSpeed * 0.4, 0);
|
|
54
63
|
return true;
|
|
55
64
|
}
|
|
56
65
|
|
|
57
66
|
respawn(target: RespawnTarget): void {
|
|
58
|
-
if (this.hearts <= 0) return;
|
|
59
67
|
const point = this.points[this.currentIndex];
|
|
60
68
|
if (point === undefined) throw new Error(`Missing checkpoint ${this.currentIndex}.`);
|
|
61
69
|
target.body.velocity.set(0, 0, 0);
|
|
62
70
|
target.body.teleport(point);
|
|
63
|
-
this.#invulnerable = this.#feel.invulnerabilityTime;
|
|
64
71
|
this.respawns += 1;
|
|
65
72
|
}
|
|
73
|
+
|
|
74
|
+
/** Out of hearts: the fox is put back with a full set, which is this game's only failure. */
|
|
75
|
+
restore(): void {
|
|
76
|
+
this.hearts = this.maxHearts;
|
|
77
|
+
this.#invulnerable = FOX_FEEL.invulnerabilityTime;
|
|
78
|
+
}
|
|
66
79
|
}
|
|
@@ -0,0 +1,469 @@
|
|
|
1
|
+
import {
|
|
2
|
+
BoxGeometry,
|
|
3
|
+
ConeGeometry,
|
|
4
|
+
CylinderGeometry,
|
|
5
|
+
DodecahedronGeometry,
|
|
6
|
+
Group,
|
|
7
|
+
Mesh,
|
|
8
|
+
SphereGeometry,
|
|
9
|
+
TorusGeometry,
|
|
10
|
+
Vector3,
|
|
11
|
+
} from "three";
|
|
12
|
+
import { crate, goalFlag, questionBlock } from "../render/blocks.js";
|
|
13
|
+
import { rockBox, toon } from "../render/materials.js";
|
|
14
|
+
import { C } from "../render/palette.js";
|
|
15
|
+
import { bush, fence, flower, pineTree, roundTree, swayFlag, vines } from "../render/props.js";
|
|
16
|
+
import { airship, castle, cliff, windmill } from "../render/scenery.js";
|
|
17
|
+
import { waterfall } from "../render/waterfall.js";
|
|
18
|
+
|
|
19
|
+
/** Deterministic, so the route is the same course every run. */
|
|
20
|
+
export function makeRng(seed = 90210): () => number {
|
|
21
|
+
let state = seed >>> 0;
|
|
22
|
+
return () => {
|
|
23
|
+
state = (state * 1664525 + 1013904223) >>> 0;
|
|
24
|
+
return state / 4294967296;
|
|
25
|
+
};
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
export interface IStage {
|
|
29
|
+
/** The one root to add to the scene and hand to `buildStaticColliders`. */
|
|
30
|
+
readonly group: Group;
|
|
31
|
+
/** Where a fall puts the fox back: one point per walkable stretch, in route order. */
|
|
32
|
+
readonly checkpoints: Vector3[];
|
|
33
|
+
readonly goalX: number;
|
|
34
|
+
readonly spawn: Vector3;
|
|
35
|
+
update(dt: number, time: number): void;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
* The route, in three acts: a mesa and a rope bridge, rising islands, then the high meadow and
|
|
40
|
+
* the goal. Ninety-seven metres end to end, and every metre of it is authored here.
|
|
41
|
+
*
|
|
42
|
+
* Walkable geometry is tagged `userData.solid` and nothing else is, so the engine's
|
|
43
|
+
* `buildStaticColliders` gets exactly the surfaces the fox can stand on out of a root that also
|
|
44
|
+
* holds several thousand decorative meshes. Everything else — foliage, trees, the castle, the
|
|
45
|
+
* airship — is silhouette that costs no collision query.
|
|
46
|
+
*
|
|
47
|
+
* Two more tags, read by the scene's merge: `userData.moving` on a subtree that animates, and
|
|
48
|
+
* `userData.faceted` on a uv-less polyhedron. Both are the reason a mesh stays its own draw
|
|
49
|
+
* instead of joining a material bucket.
|
|
50
|
+
*/
|
|
51
|
+
export function buildStage(rng: () => number): IStage {
|
|
52
|
+
const group = new Group();
|
|
53
|
+
const checkpoints: Vector3[] = [];
|
|
54
|
+
const updaters: ((dt: number, time: number) => void)[] = [];
|
|
55
|
+
const goalX = 92;
|
|
56
|
+
const spawn = new Vector3(-5, 1.2, 0);
|
|
57
|
+
|
|
58
|
+
const solid = (mesh: Mesh): Mesh => {
|
|
59
|
+
mesh.userData.solid = true;
|
|
60
|
+
mesh.receiveShadow = true;
|
|
61
|
+
return mesh;
|
|
62
|
+
};
|
|
63
|
+
const attach = (child: Mesh | Group): void => {
|
|
64
|
+
group.add(child);
|
|
65
|
+
};
|
|
66
|
+
|
|
67
|
+
/** A rock block with a grass cap. `top` is the walkable surface height. */
|
|
68
|
+
const ground = (options: {
|
|
69
|
+
x0: number;
|
|
70
|
+
x1: number;
|
|
71
|
+
top: number;
|
|
72
|
+
z0?: number;
|
|
73
|
+
z1?: number;
|
|
74
|
+
depth?: number;
|
|
75
|
+
}): void => {
|
|
76
|
+
const { x0, x1, top } = options;
|
|
77
|
+
const z0 = options.z0 ?? -7;
|
|
78
|
+
const z1 = options.z1 ?? 6;
|
|
79
|
+
const depth = options.depth ?? 16;
|
|
80
|
+
const width = x1 - x0;
|
|
81
|
+
const depthZ = z1 - z0;
|
|
82
|
+
const cx = (x0 + x1) / 2;
|
|
83
|
+
const cz = (z0 + z1) / 2;
|
|
84
|
+
const chunk = new Group();
|
|
85
|
+
|
|
86
|
+
const cap = solid(
|
|
87
|
+
new Mesh(
|
|
88
|
+
rockBox(width + 0.25, 0.6, depthZ + 0.25, rng, 0.12),
|
|
89
|
+
toon(C.grass, { vertexColors: true }),
|
|
90
|
+
),
|
|
91
|
+
);
|
|
92
|
+
cap.position.set(cx, top - 0.3, cz);
|
|
93
|
+
cap.castShadow = true;
|
|
94
|
+
chunk.add(cap);
|
|
95
|
+
// The dirt band right under the turf is what makes a cliff edge read as a cliff.
|
|
96
|
+
const dirt = new Mesh(new BoxGeometry(width + 0.12, 0.5, depthZ + 0.12), toon(C.dirt));
|
|
97
|
+
dirt.position.set(cx, top - 0.82, cz);
|
|
98
|
+
chunk.add(dirt);
|
|
99
|
+
grassSkirt(chunk, x0, x1, z0, z1, top - 0.6, rng);
|
|
100
|
+
scatterFoliage(chunk, x0, x1, z0, z1, top, rng);
|
|
101
|
+
|
|
102
|
+
// The rock body is NOT solid. Only the walkable cap is, and that is a deliberate correction:
|
|
103
|
+
// a collider for the whole 16 m block turns every gap in the route into a 16 m wall the fox
|
|
104
|
+
// slides down and gets caught on the lip of — it walked up the face of the far side instead of
|
|
105
|
+
// falling into the chasm at x=30. The cap is the surface; the rock below it is scenery.
|
|
106
|
+
const body = new Mesh(
|
|
107
|
+
rockBox(width, depth, depthZ, rng, 0.22),
|
|
108
|
+
toon(C.rock, { flat: true, vertexColors: true }),
|
|
109
|
+
);
|
|
110
|
+
body.position.set(cx, top - 0.6 - depth / 2, cz);
|
|
111
|
+
body.castShadow = true;
|
|
112
|
+
chunk.add(body);
|
|
113
|
+
// Strata bands and boulders break up the big rock face.
|
|
114
|
+
for (let i = 0; i < 3; i += 1) {
|
|
115
|
+
const y = top - 2 - i * 2.1;
|
|
116
|
+
if (y < top - 0.6 - depth) break;
|
|
117
|
+
const band = new Mesh(
|
|
118
|
+
rockBox(width * 0.99, 0.5 + rng() * 0.3, depthZ + 0.1, rng, 0.16),
|
|
119
|
+
toon(i % 2 ? C.rockDark : C.rockLight, { flat: true, vertexColors: true }),
|
|
120
|
+
);
|
|
121
|
+
band.position.set(cx, y, cz);
|
|
122
|
+
chunk.add(band);
|
|
123
|
+
}
|
|
124
|
+
for (let i = 0; i < Math.max(3, Math.floor(width / 3)); i += 1) {
|
|
125
|
+
const boulder = new Mesh(
|
|
126
|
+
new DodecahedronGeometry(0.5 + rng() * 0.9),
|
|
127
|
+
toon(rng() < 0.5 ? C.rockDark : C.rockLight, { flat: true }),
|
|
128
|
+
);
|
|
129
|
+
// A polyhedron carries no uv, and a bucket whose pieces disagree about their attributes is
|
|
130
|
+
// a bucket the merge refuses. Faceted stones stay out of it; they are 6 per block.
|
|
131
|
+
boulder.userData.faceted = true;
|
|
132
|
+
boulder.position.set(
|
|
133
|
+
x0 + rng() * width,
|
|
134
|
+
top - 1.4 - rng() * (depth - 2),
|
|
135
|
+
z1 - 0.2 + rng() * 0.6,
|
|
136
|
+
);
|
|
137
|
+
boulder.rotation.set(rng() * 3, rng() * 3, rng() * 3);
|
|
138
|
+
boulder.castShadow = true;
|
|
139
|
+
chunk.add(boulder);
|
|
140
|
+
}
|
|
141
|
+
for (let i = 0; i < Math.max(2, Math.floor(width / 5)); i += 1) {
|
|
142
|
+
const moss = new Mesh(new SphereGeometry(0.55 + rng() * 0.5, 8, 6), toon(C.moss));
|
|
143
|
+
moss.scale.set(1.4, 0.5, 0.6);
|
|
144
|
+
moss.position.set(x0 + 1 + rng() * (width - 2), top - 1.15 - rng() * 1.2, z1 + 0.05);
|
|
145
|
+
chunk.add(moss);
|
|
146
|
+
}
|
|
147
|
+
attach(chunk);
|
|
148
|
+
checkpoints.push(new Vector3(x0 + 1.5, top + 1.2, 0));
|
|
149
|
+
};
|
|
150
|
+
|
|
151
|
+
/** A floating island: grass disc on a rock spike. The disc is the whole landing. */
|
|
152
|
+
const island = (
|
|
153
|
+
x: number,
|
|
154
|
+
y: number,
|
|
155
|
+
z: number,
|
|
156
|
+
radius: number,
|
|
157
|
+
depth: number,
|
|
158
|
+
tree: boolean,
|
|
159
|
+
): void => {
|
|
160
|
+
const chunk = new Group();
|
|
161
|
+
const cap = solid(
|
|
162
|
+
new Mesh(new CylinderGeometry(radius, radius * 0.97, 0.5, 12), toon(C.grass)),
|
|
163
|
+
);
|
|
164
|
+
cap.position.y = -0.25;
|
|
165
|
+
cap.castShadow = true;
|
|
166
|
+
chunk.add(cap);
|
|
167
|
+
const rim = new Mesh(new TorusGeometry(radius * 0.99, 0.24, 6, 14), toon(C.grass));
|
|
168
|
+
rim.rotation.x = Math.PI / 2;
|
|
169
|
+
rim.position.y = -0.42;
|
|
170
|
+
chunk.add(rim);
|
|
171
|
+
const spike = new Mesh(
|
|
172
|
+
new ConeGeometry(radius * 0.95, depth, 10),
|
|
173
|
+
toon(C.rock, { flat: true }),
|
|
174
|
+
);
|
|
175
|
+
// ConeGeometry points up; flip it so the spike hangs point-down under the disc.
|
|
176
|
+
spike.rotation.x = Math.PI;
|
|
177
|
+
spike.position.y = -0.5 - depth / 2;
|
|
178
|
+
chunk.add(spike);
|
|
179
|
+
const underSpike = new Mesh(
|
|
180
|
+
new ConeGeometry(radius * 0.6, depth * 0.7, 8),
|
|
181
|
+
toon(C.rockDark, { flat: true }),
|
|
182
|
+
);
|
|
183
|
+
underSpike.position.set(radius * 0.25, -0.5 - depth * 0.6, -radius * 0.2);
|
|
184
|
+
underSpike.rotation.set(Math.PI, 0, 0.25);
|
|
185
|
+
chunk.add(underSpike);
|
|
186
|
+
const tendrils = vines(3, rng);
|
|
187
|
+
tendrils.position.set(radius * 0.4, -0.6, radius * 0.5);
|
|
188
|
+
chunk.add(tendrils);
|
|
189
|
+
if (tree) {
|
|
190
|
+
const trunk = rng() < 0.5 ? pineTree(0.9 + rng() * 0.4, rng) : roundTree(0.8, rng);
|
|
191
|
+
trunk.position.set((rng() - 0.5) * radius * 0.6, 0, -radius * 0.3);
|
|
192
|
+
chunk.add(trunk);
|
|
193
|
+
}
|
|
194
|
+
for (let i = 0; i < 3; i += 1) {
|
|
195
|
+
const bloom = flower([0xff8fb0, 0xffe066, 0xffffff][i] ?? 0xffffff);
|
|
196
|
+
bloom.position.set((rng() - 0.5) * radius * 1.2, 0, (rng() - 0.5) * radius * 1.2);
|
|
197
|
+
chunk.add(bloom);
|
|
198
|
+
}
|
|
199
|
+
chunk.position.set(x, y, z);
|
|
200
|
+
attach(chunk);
|
|
201
|
+
checkpoints.push(new Vector3(x, y + 1.2, z));
|
|
202
|
+
};
|
|
203
|
+
|
|
204
|
+
/** Plank bridge with rope rails. One solid deck under the planks is the whole collider. */
|
|
205
|
+
const bridge = (x0: number, x1: number, top: number, width: number): void => {
|
|
206
|
+
const chunk = new Group();
|
|
207
|
+
const span = x1 - x0;
|
|
208
|
+
// The planks are the walkable surface, so they are what collides: a separate invisible deck box
|
|
209
|
+
// would put the fox's feet a quarter of a metre inside the boards it is standing on.
|
|
210
|
+
const planks = Math.round(span / 1.1);
|
|
211
|
+
for (let i = 0; i < planks; i += 1) {
|
|
212
|
+
const plank = solid(
|
|
213
|
+
new Mesh(
|
|
214
|
+
new BoxGeometry((span / planks) * 0.94, 0.26, width),
|
|
215
|
+
toon(i % 3 === 0 ? C.woodDark : C.wood),
|
|
216
|
+
),
|
|
217
|
+
);
|
|
218
|
+
plank.position.set(x0 + (i + 0.5) * (span / planks), top - 0.13, 0);
|
|
219
|
+
plank.rotation.x = (rng() - 0.5) * 0.02;
|
|
220
|
+
plank.castShadow = true;
|
|
221
|
+
chunk.add(plank);
|
|
222
|
+
}
|
|
223
|
+
for (const side of [-1, 1]) {
|
|
224
|
+
const beam = new Mesh(new BoxGeometry(span, 0.3, 0.35), toon(C.woodDark));
|
|
225
|
+
beam.position.set((x0 + x1) / 2, top - 0.6, side * (width / 2 - 0.35));
|
|
226
|
+
chunk.add(beam);
|
|
227
|
+
}
|
|
228
|
+
const posts = Math.max(3, Math.round(span / 4.5));
|
|
229
|
+
for (let i = 0; i <= posts; i += 1) {
|
|
230
|
+
const px = x0 + (span * i) / posts;
|
|
231
|
+
for (const side of [-1, 1]) {
|
|
232
|
+
const post = new Mesh(new CylinderGeometry(0.16, 0.19, 1.9, 8), toon(C.woodPost));
|
|
233
|
+
post.position.set(px, top + 0.55, side * (width / 2 - 0.15));
|
|
234
|
+
const capTop = new Mesh(new CylinderGeometry(0.2, 0.2, 0.14, 8), toon(C.woodDark));
|
|
235
|
+
capTop.position.set(px, top + 1.55, side * (width / 2 - 0.15));
|
|
236
|
+
chunk.add(post, capTop);
|
|
237
|
+
if (i >= posts) continue;
|
|
238
|
+
const segment = span / posts;
|
|
239
|
+
for (const [height, radius] of [
|
|
240
|
+
[1.15, 0.05],
|
|
241
|
+
[0.65, 0.045],
|
|
242
|
+
] as const) {
|
|
243
|
+
const rope = new Mesh(new CylinderGeometry(radius, radius, segment, 6), toon(C.rope));
|
|
244
|
+
rope.rotation.z = Math.PI / 2;
|
|
245
|
+
rope.position.set(px + segment / 2, top + height - 0.08, side * (width / 2 - 0.15));
|
|
246
|
+
chunk.add(rope);
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
attach(chunk);
|
|
251
|
+
checkpoints.push(new Vector3(x0 + 1, top + 1.2, 0));
|
|
252
|
+
};
|
|
253
|
+
|
|
254
|
+
// --- act 1: the mesa, the rope bridge, the meadow ------------------------
|
|
255
|
+
ground({ x0: -20, x1: -7, top: 0 });
|
|
256
|
+
bridge(-7, 10, 0, 5.4);
|
|
257
|
+
ground({ x0: 10, x1: 30, top: 0 });
|
|
258
|
+
// --- act 2: the rising islands ------------------------------------------
|
|
259
|
+
ground({ x0: 34, x1: 41, top: 1.5, z0: -5, z1: 5, depth: 14 });
|
|
260
|
+
island(45.5, 3.2, 1.2, 2.4, 3.5, true);
|
|
261
|
+
island(50.5, 4.8, -1.4, 2.1, 3.5, false);
|
|
262
|
+
island(55, 6.2, 1, 2.6, 3.5, true);
|
|
263
|
+
// --- act 3: the high meadow, the second bridge, the goal ----------------
|
|
264
|
+
ground({ x0: 59, x1: 74, top: 3, depth: 18 });
|
|
265
|
+
bridge(74, 82, 3, 5);
|
|
266
|
+
ground({ x0: 82, x1: 97, top: 3, depth: 20 });
|
|
267
|
+
|
|
268
|
+
for (const [x, z, scale] of [
|
|
269
|
+
[13, -5.4, 1.1],
|
|
270
|
+
[17.5, -5.8, 0.9],
|
|
271
|
+
[27, -5.2, 1.2],
|
|
272
|
+
[62, -5.6, 1.1],
|
|
273
|
+
[70, -5.4, 1.3],
|
|
274
|
+
[86, -5.6, 1.2],
|
|
275
|
+
[93, -5, 1],
|
|
276
|
+
] as const) {
|
|
277
|
+
const tree = rng() < 0.5 ? pineTree(scale * 1.3, rng) : roundTree(scale * 1.2, rng);
|
|
278
|
+
tree.position.set(x, x < 32 ? 0 : 3, z);
|
|
279
|
+
attach(tree);
|
|
280
|
+
}
|
|
281
|
+
for (const [x, top, length] of [
|
|
282
|
+
[19, 0, 7],
|
|
283
|
+
[63, 3, 8],
|
|
284
|
+
] as const) {
|
|
285
|
+
const rail = fence(length, 5);
|
|
286
|
+
rail.position.set(x, top, -6.2);
|
|
287
|
+
attach(rail);
|
|
288
|
+
}
|
|
289
|
+
for (const [x, y, z, size] of [
|
|
290
|
+
[27.6, 0, 3.2, 1.1],
|
|
291
|
+
[28.8, 0, 3.2, 1.1],
|
|
292
|
+
[27.6, 1.1, 3.2, 1.1],
|
|
293
|
+
[88, 3, 3.4, 1.2],
|
|
294
|
+
] as const) {
|
|
295
|
+
const box = crate(size);
|
|
296
|
+
box.box.userData.solid = true;
|
|
297
|
+
box.group.position.set(x, y + size / 2, z);
|
|
298
|
+
attach(box.group);
|
|
299
|
+
}
|
|
300
|
+
// The '?' block floats 3.6 m up and bobs; a static collider cannot follow a bob, so it is
|
|
301
|
+
// decoration and the star above it is the reward.
|
|
302
|
+
const block = questionBlock(1.2);
|
|
303
|
+
block.group.userData.moving = true;
|
|
304
|
+
block.group.position.set(24, 3.6, 2.6);
|
|
305
|
+
attach(block.group);
|
|
306
|
+
updaters.push((_dt, time) => {
|
|
307
|
+
block.group.position.y = 3.6 + Math.sin(time * 2) * 0.08;
|
|
308
|
+
});
|
|
309
|
+
const flag = goalFlag();
|
|
310
|
+
flag.group.userData.moving = true;
|
|
311
|
+
flag.group.position.set(goalX, 3, 0);
|
|
312
|
+
attach(flag.group);
|
|
313
|
+
updaters.push((_dt, time) => swayFlag(flag.cloth, time));
|
|
314
|
+
|
|
315
|
+
// --- the world behind the route ----------------------------------------
|
|
316
|
+
const tops: number[] = [];
|
|
317
|
+
const backdrop = [
|
|
318
|
+
[4, -16, -46, 26, 24, 14],
|
|
319
|
+
[40, -14, -54, 30, 28, 16],
|
|
320
|
+
[78, -16, -48, 26, 26, 14],
|
|
321
|
+
[-30, -18, -42, 20, 22, 12],
|
|
322
|
+
[108, -18, -56, 28, 28, 16],
|
|
323
|
+
[22, -22, -72, 34, 30, 18],
|
|
324
|
+
[92, -24, -80, 30, 32, 18],
|
|
325
|
+
] as const;
|
|
326
|
+
for (const [i, cliffRow] of backdrop.entries()) {
|
|
327
|
+
const [x, y, z, w, h, d] = cliffRow;
|
|
328
|
+
const face = cliff(w, h, d, rng);
|
|
329
|
+
face.position.set(x, y, z);
|
|
330
|
+
attach(face);
|
|
331
|
+
// `cliff` is centred on its origin and carries its grass cap 0.7 m above the box. Everything
|
|
332
|
+
// that stands on it, hangs from it or is measured against it goes from this height; anchoring
|
|
333
|
+
// to `y + h` left the trees, falls, castle and windmill 12 m above the rock they belong to.
|
|
334
|
+
const top = y + h / 2 + 0.7;
|
|
335
|
+
tops.push(top);
|
|
336
|
+
// Half the cliffs carry water. These are 50 m behind the route: at that distance a fifth one
|
|
337
|
+
// is a smear, and each is two dozen transparent draws that the near cliffs hide anyway.
|
|
338
|
+
if (i % 2 === 0) {
|
|
339
|
+
const fall = waterfall(3 + rng() * 3, h * 0.85);
|
|
340
|
+
fall.group.userData.moving = true;
|
|
341
|
+
fall.group.position.set(x + (rng() - 0.5) * w * 0.5, top - 0.5, z + d / 2 + 0.2);
|
|
342
|
+
attach(fall.group);
|
|
343
|
+
updaters.push((dt) => fall.update(dt));
|
|
344
|
+
}
|
|
345
|
+
for (let i = 0; i < 4; i += 1) {
|
|
346
|
+
const tree = rng() < 0.6 ? pineTree(1.6 + rng() * 1.2, rng) : roundTree(1.5 + rng(), rng);
|
|
347
|
+
tree.position.set(x + (rng() - 0.5) * w * 0.85, top, z + (rng() - 0.5) * d * 0.5);
|
|
348
|
+
attach(tree);
|
|
349
|
+
}
|
|
350
|
+
}
|
|
351
|
+
for (let i = 0; i < 10; i += 1) {
|
|
352
|
+
const distant = new Group();
|
|
353
|
+
const radius = 2 + rng() * 5;
|
|
354
|
+
distant.add(new Mesh(new CylinderGeometry(radius, radius * 0.95, 1.2, 8), toon(C.grass)));
|
|
355
|
+
const spike = new Mesh(
|
|
356
|
+
new ConeGeometry(radius * 0.9, radius * 2.2, 8),
|
|
357
|
+
toon(C.rock, { flat: true }),
|
|
358
|
+
);
|
|
359
|
+
spike.rotation.x = Math.PI;
|
|
360
|
+
spike.position.y = -0.6 - radius * 1.1;
|
|
361
|
+
distant.add(spike);
|
|
362
|
+
for (let t = 0; t < 3; t += 1) {
|
|
363
|
+
const tree =
|
|
364
|
+
rng() < 0.5 ? pineTree(0.8 + rng() * 0.8, rng) : roundTree(0.7 + rng() * 0.6, rng);
|
|
365
|
+
tree.position.set((rng() - 0.5) * radius, 0.6, (rng() - 0.5) * radius);
|
|
366
|
+
distant.add(tree);
|
|
367
|
+
}
|
|
368
|
+
distant.position.set(-40 + rng() * 190, 4 + rng() * 28, -45 - rng() * 90);
|
|
369
|
+
attach(distant);
|
|
370
|
+
}
|
|
371
|
+
const keep = castle(rng);
|
|
372
|
+
keep.position.set(22, tops[5] ?? 0, -72);
|
|
373
|
+
keep.scale.setScalar(1.7);
|
|
374
|
+
attach(keep);
|
|
375
|
+
const mill = windmill();
|
|
376
|
+
mill.group.userData.moving = true;
|
|
377
|
+
mill.group.position.set(74, tops[2] ?? 0, -48);
|
|
378
|
+
mill.group.scale.setScalar(1.9);
|
|
379
|
+
attach(mill.group);
|
|
380
|
+
updaters.push((dt) => mill.spin(dt));
|
|
381
|
+
const ship = airship();
|
|
382
|
+
ship.userData.moving = true;
|
|
383
|
+
ship.position.set(-10, 34, -52);
|
|
384
|
+
ship.scale.setScalar(2.2);
|
|
385
|
+
attach(ship);
|
|
386
|
+
updaters.push((dt, time) => {
|
|
387
|
+
ship.position.x += dt * 1.4;
|
|
388
|
+
ship.position.y += Math.sin(time * 0.4) * dt * 1.5;
|
|
389
|
+
if (ship.position.x > 190) ship.position.x = -60;
|
|
390
|
+
});
|
|
391
|
+
|
|
392
|
+
checkpoints.sort((a, b) => a.x - b.x);
|
|
393
|
+
return {
|
|
394
|
+
checkpoints,
|
|
395
|
+
goalX,
|
|
396
|
+
group,
|
|
397
|
+
spawn,
|
|
398
|
+
update(dt: number, time: number): void {
|
|
399
|
+
for (const step of updaters) step(dt, time);
|
|
400
|
+
},
|
|
401
|
+
};
|
|
402
|
+
}
|
|
403
|
+
|
|
404
|
+
/** Scalloped grass tufts along the top edge of a block. */
|
|
405
|
+
function grassSkirt(
|
|
406
|
+
parent: Group,
|
|
407
|
+
x0: number,
|
|
408
|
+
x1: number,
|
|
409
|
+
z0: number,
|
|
410
|
+
z1: number,
|
|
411
|
+
y: number,
|
|
412
|
+
rng: () => number,
|
|
413
|
+
): void {
|
|
414
|
+
const material = toon(C.grass);
|
|
415
|
+
for (const [fromX, fromZ, toX, toZ] of [
|
|
416
|
+
[x0, z1, x1, z1],
|
|
417
|
+
[x0, z0, x1, z0],
|
|
418
|
+
[x0, z0, x0, z1],
|
|
419
|
+
[x1, z0, x1, z1],
|
|
420
|
+
] as const) {
|
|
421
|
+
const length = Math.hypot(toX - fromX, toZ - fromZ);
|
|
422
|
+
const count = Math.max(2, Math.round(length / 0.85));
|
|
423
|
+
for (let i = 0; i <= count; i += 1) {
|
|
424
|
+
const t = i / count;
|
|
425
|
+
const tuft = new Mesh(new SphereGeometry(0.42 + rng() * 0.18, 8, 6), material);
|
|
426
|
+
tuft.position.set(
|
|
427
|
+
fromX + (toX - fromX) * t,
|
|
428
|
+
y + 0.12 - rng() * 0.25,
|
|
429
|
+
fromZ + (toZ - fromZ) * t,
|
|
430
|
+
);
|
|
431
|
+
tuft.scale.set(1, 0.75, 1);
|
|
432
|
+
tuft.castShadow = true;
|
|
433
|
+
parent.add(tuft);
|
|
434
|
+
}
|
|
435
|
+
}
|
|
436
|
+
}
|
|
437
|
+
|
|
438
|
+
/** Bushes, flowers and grass blades scattered on top of a block. */
|
|
439
|
+
function scatterFoliage(
|
|
440
|
+
parent: Group,
|
|
441
|
+
x0: number,
|
|
442
|
+
x1: number,
|
|
443
|
+
z0: number,
|
|
444
|
+
z1: number,
|
|
445
|
+
top: number,
|
|
446
|
+
rng: () => number,
|
|
447
|
+
): void {
|
|
448
|
+
const petals = [0xff8fb0, 0xffe066, 0xffffff, 0xc78fff];
|
|
449
|
+
for (let i = 0; i < Math.floor((x1 - x0) * 0.7); i += 1) {
|
|
450
|
+
const x = x0 + 1 + rng() * (x1 - x0 - 2);
|
|
451
|
+
const back = rng() < 0.75;
|
|
452
|
+
const z = back ? z0 + 0.6 + rng() * (z1 - z0) * 0.35 : z1 - (z1 - z0) * 0.25 - rng() * 0.5;
|
|
453
|
+
const roll = rng();
|
|
454
|
+
let prop: Group;
|
|
455
|
+
if (roll < 0.3) prop = bush(0.6 + rng() * 0.5, rng);
|
|
456
|
+
else if (roll < 0.75) prop = flower(petals[Math.floor(rng() * petals.length)] ?? 0xffffff);
|
|
457
|
+
else {
|
|
458
|
+
prop = new Group();
|
|
459
|
+
for (let blade = 0; blade < 4; blade += 1) {
|
|
460
|
+
const tuft = new Mesh(new ConeGeometry(0.06, 0.4 + rng() * 0.3, 4), toon(C.grassLight));
|
|
461
|
+
tuft.position.set((rng() - 0.5) * 0.35, 0.2, (rng() - 0.5) * 0.35);
|
|
462
|
+
tuft.rotation.z = (rng() - 0.5) * 0.5;
|
|
463
|
+
prop.add(tuft);
|
|
464
|
+
}
|
|
465
|
+
}
|
|
466
|
+
prop.position.set(x, top, z);
|
|
467
|
+
parent.add(prop);
|
|
468
|
+
}
|
|
469
|
+
}
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
//
|
|
3
|
+
// The three pieces of level furniture you can stand on or reach: a crate, the `?` block and the
|
|
4
|
+
// goal flag. Each takes a size, centres itself on its own origin, and — unlike the decoration in
|
|
5
|
+
// `props.ts` — each is handed to `buildStaticColliders` as walkable geometry.
|
|
6
|
+
import {
|
|
7
|
+
BoxGeometry,
|
|
8
|
+
type BufferGeometry,
|
|
9
|
+
CylinderGeometry,
|
|
10
|
+
Group,
|
|
11
|
+
type Material,
|
|
12
|
+
Mesh,
|
|
13
|
+
PlaneGeometry,
|
|
14
|
+
SphereGeometry,
|
|
15
|
+
} from "three";
|
|
16
|
+
import { toon } from "./materials.js";
|
|
17
|
+
import { C } from "./palette.js";
|
|
18
|
+
|
|
19
|
+
function mesh(geometry: BufferGeometry, material: Material): Mesh {
|
|
20
|
+
const m = new Mesh(geometry, material);
|
|
21
|
+
m.castShadow = true;
|
|
22
|
+
m.receiveShadow = true;
|
|
23
|
+
return m;
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* Wooden crate with plank detail. The origin is its own centre, and `box` is the one mesh inside
|
|
28
|
+
* it that collides — the planks are 2 cm proud of the faces and are decoration.
|
|
29
|
+
*/
|
|
30
|
+
export function crate(size = 1): { box: Mesh; group: Group } {
|
|
31
|
+
const group = new Group();
|
|
32
|
+
const box = mesh(new BoxGeometry(size, size, size), toon(C.wood));
|
|
33
|
+
group.add(box);
|
|
34
|
+
const half = size / 2 + 0.01;
|
|
35
|
+
for (const [rx, ry, rz, px, pz] of [
|
|
36
|
+
[0, 0, 0, 0, half],
|
|
37
|
+
[0, Math.PI, 0, 0, -half],
|
|
38
|
+
[0, Math.PI / 2, 0, half, 0],
|
|
39
|
+
[0, -Math.PI / 2, 0, -half, 0],
|
|
40
|
+
] as const) {
|
|
41
|
+
for (const y of [-size * 0.3, 0, size * 0.3]) {
|
|
42
|
+
const plank = mesh(new BoxGeometry(size * 0.96, size * 0.24, 0.02), toon(C.woodDark));
|
|
43
|
+
plank.rotation.set(rx, ry, rz);
|
|
44
|
+
plank.position.set(px, y, pz);
|
|
45
|
+
group.add(plank);
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
return { box, group };
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/** Classic '?' block, drawn from three boxes. The origin is its own centre. */
|
|
52
|
+
export function questionBlock(size = 1): { box: Mesh; group: Group } {
|
|
53
|
+
const group = new Group();
|
|
54
|
+
const box = mesh(new BoxGeometry(size, size, size), toon(0xe89b25));
|
|
55
|
+
group.add(box);
|
|
56
|
+
const half = size / 2 + 0.02;
|
|
57
|
+
for (const [ry, px, pz] of [
|
|
58
|
+
[0, 0, half],
|
|
59
|
+
[Math.PI, 0, -half],
|
|
60
|
+
[Math.PI / 2, half, 0],
|
|
61
|
+
[-Math.PI / 2, -half, 0],
|
|
62
|
+
] as const) {
|
|
63
|
+
const face = new Group();
|
|
64
|
+
face.rotation.y = ry;
|
|
65
|
+
face.position.set(px, 0, pz);
|
|
66
|
+
group.add(face);
|
|
67
|
+
const bar = mesh(new BoxGeometry(size * 0.34, size * 0.12, 0.02), toon(0xfff0c9));
|
|
68
|
+
bar.position.set(0, size * 0.2, 0);
|
|
69
|
+
const stem = mesh(new BoxGeometry(size * 0.12, size * 0.3, 0.02), toon(0xfff0c9));
|
|
70
|
+
stem.position.set(size * 0.11, size * 0.02, 0);
|
|
71
|
+
const dot = mesh(new BoxGeometry(size * 0.12, size * 0.12, 0.02), toon(0xfff0c9));
|
|
72
|
+
dot.position.set(0, -size * 0.26, 0);
|
|
73
|
+
face.add(bar, stem, dot);
|
|
74
|
+
}
|
|
75
|
+
return { box, group };
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/** Goal flag on a pole. `cloth` is the plane `swayFlag` waves. */
|
|
79
|
+
export function goalFlag(): { cloth: Mesh; group: Group } {
|
|
80
|
+
const group = new Group();
|
|
81
|
+
const pole = mesh(new CylinderGeometry(0.1, 0.12, 6, 6), toon(C.metal));
|
|
82
|
+
pole.position.y = 3;
|
|
83
|
+
group.add(pole);
|
|
84
|
+
const base = mesh(new CylinderGeometry(0.6, 0.75, 0.4, 10), toon(C.rockDark));
|
|
85
|
+
base.position.y = 0.2;
|
|
86
|
+
group.add(base);
|
|
87
|
+
const cloth = mesh(new PlaneGeometry(1.8, 1.1, 8, 1), toon(0xff5a4a, { flat: true }));
|
|
88
|
+
cloth.position.set(0.9, 5.2, 0);
|
|
89
|
+
group.add(cloth);
|
|
90
|
+
const ball = mesh(new SphereGeometry(0.16, 8, 6), toon(C.gold));
|
|
91
|
+
ball.position.y = 6.1;
|
|
92
|
+
group.add(ball);
|
|
93
|
+
return { cloth, group };
|
|
94
|
+
}
|
|
@@ -1,8 +1,33 @@
|
|
|
1
|
-
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
//
|
|
3
|
+
// One side-on camera that trails the fox and leads the run. It is called from `afterPhysics` in
|
|
4
|
+
// `scenes/Play.ts`, never from the scene's own frame function: `moveAndSlide` only queues motion,
|
|
5
|
+
// so a camera written before the physics step frames where the body was, not where it ended up.
|
|
6
|
+
import type { PerspectiveCamera, Vector3 } from "three";
|
|
7
|
+
|
|
8
|
+
/** Behind and above, in metres, from the fox. */
|
|
9
|
+
const CAMERA_OFFSET = { x: -5.5, y: 5.2, z: 14.5 } as const;
|
|
10
|
+
/** Rate the camera closes on its target. Above 0 the frame time is treated as seconds. */
|
|
11
|
+
const FOLLOW_RATE = 0.0018;
|
|
2
12
|
|
|
3
13
|
export function setupCamera(camera: PerspectiveCamera): void {
|
|
4
|
-
camera.fov =
|
|
14
|
+
camera.fov = 52;
|
|
5
15
|
camera.near = 0.1;
|
|
6
|
-
camera.far =
|
|
16
|
+
camera.far = 900;
|
|
7
17
|
camera.updateProjectionMatrix();
|
|
8
18
|
}
|
|
19
|
+
|
|
20
|
+
export function followCamera(
|
|
21
|
+
camera: PerspectiveCamera,
|
|
22
|
+
player: Vector3,
|
|
23
|
+
velocityX: number,
|
|
24
|
+
dt: number,
|
|
25
|
+
): void {
|
|
26
|
+
camera.position.x += (player.x + CAMERA_OFFSET.x - camera.position.x) * (1 - FOLLOW_RATE ** dt);
|
|
27
|
+
camera.position.y +=
|
|
28
|
+
(Math.max(player.y + CAMERA_OFFSET.y, player.y + 2.2) - camera.position.y) *
|
|
29
|
+
(1 - FOLLOW_RATE ** dt);
|
|
30
|
+
camera.position.z = player.z + CAMERA_OFFSET.z;
|
|
31
|
+
// Look ahead of the run, so the next gap is on screen before the fox reaches it.
|
|
32
|
+
camera.lookAt(player.x + 3.4 + velocityX * 0.14, player.y + 2.6, player.z * 0.5);
|
|
33
|
+
}
|