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,47 +1,61 @@
|
|
|
1
|
-
// Generated for you.
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
} from "three";
|
|
9
|
-
import { palette } from "./palette.js";
|
|
1
|
+
// Generated for you. This is ordinary Three.js — edit or delete it freely.
|
|
2
|
+
// ThreeNative does not read this file.
|
|
3
|
+
//
|
|
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";
|
|
10
8
|
|
|
11
9
|
type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
|
|
12
10
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
11
|
+
/**
|
|
12
|
+
* The sun for this town, and the shadow map fitted to it.
|
|
13
|
+
*
|
|
14
|
+
* ## Why `halfExtent` is a parameter and not a constant
|
|
15
|
+
*
|
|
16
|
+
* A shadow map is an orthographic camera, and geometry outside it does not get a softer shadow —
|
|
17
|
+
* it gets the *edge texel* of the map, clamped, and a whole block of the town reads as solid
|
|
18
|
+
* shade. That is the largest single thing between this game reading as daylight and reading as
|
|
19
|
+
* dark: the map was fitted to an 18 m half-extent inherited from the 36 m arena `minimal` opens
|
|
20
|
+
* with, over a town that is 84 m across, so two thirds of it sat outside the frustum and was lit
|
|
21
|
+
* by nothing but the sky. `Play.enter` passes the town's own `TOWN_HALF`, so the number that
|
|
22
|
+
* sizes the shadow lives beside the number that sizes the world.
|
|
23
|
+
*
|
|
24
|
+
* At 4096² over 84 m a texel is about two centimetres, which still resolves a boot on the ground.
|
|
25
|
+
*/
|
|
26
|
+
export function setupLighting(
|
|
27
|
+
scene: Scene,
|
|
28
|
+
renderer: ShadowRenderer,
|
|
29
|
+
halfExtent: number,
|
|
30
|
+
mobile = false,
|
|
31
|
+
): { key: DirectionalLight } {
|
|
17
32
|
renderer.shadowMap.enabled = true;
|
|
18
33
|
renderer.shadowMap.type = PCFSoftShadowMap;
|
|
19
|
-
// First person puts the player inside the arena rather than above it, so the sky term does
|
|
20
|
-
// most of the work of making a wall read as a surface instead of a silhouette.
|
|
21
|
-
scene.add(new HemisphereLight(palette.skyHigh, palette.arena, 1.5));
|
|
22
34
|
|
|
23
|
-
// Warm white,
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
key.
|
|
27
|
-
key.position.set(-6, 10, 7);
|
|
35
|
+
// Warm white, matched by eye to the photographed midday sun against its own sky.
|
|
36
|
+
const key = new DirectionalLight(0xfff1e0, 4.5);
|
|
37
|
+
// The light sits outside the map's own box, so its near plane is not inside the town.
|
|
38
|
+
key.position.copy(SUN_DIRECTION).multiplyScalar(halfExtent * 2);
|
|
28
39
|
key.castShadow = true;
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
key.shadow.
|
|
34
|
-
key.shadow.
|
|
35
|
-
key.shadow.camera.
|
|
36
|
-
|
|
37
|
-
|
|
40
|
+
// One map fitted to the world. Camera-centred cascades (`VirtualShadowNode`) are for open
|
|
41
|
+
// worlds; here their level boundaries showed as shadows that turned sharp halfway along.
|
|
42
|
+
// Phones take 2048², which is 8 cm a texel over this town and still reads as a soft edge.
|
|
43
|
+
const size = mobile ? 2048 : 4096;
|
|
44
|
+
key.shadow.mapSize.set(size, size);
|
|
45
|
+
key.shadow.radius = 2;
|
|
46
|
+
key.shadow.camera.near = 1;
|
|
47
|
+
// Deep enough to reach the far corner *along the light's own axis*, not just across the ground
|
|
48
|
+
// plane, or the tallest thing in town casts from a depth the map has never recorded.
|
|
49
|
+
key.shadow.camera.far = halfExtent * 4;
|
|
50
|
+
key.shadow.camera.left = -halfExtent;
|
|
51
|
+
key.shadow.camera.right = halfExtent;
|
|
52
|
+
key.shadow.camera.top = halfExtent;
|
|
53
|
+
key.shadow.camera.bottom = -halfExtent;
|
|
54
|
+
// Small biases: a large normal bias is what lifted the mannequin's shadow off its own feet.
|
|
55
|
+
key.shadow.bias = -0.0002;
|
|
56
|
+
key.shadow.normalBias = 0.005;
|
|
38
57
|
scene.add(key);
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
rim.position.set(8, 5, -10);
|
|
43
|
-
scene.add(rim);
|
|
44
|
-
scene.add(new AmbientLight(palette.skyHigh, 0.55));
|
|
45
|
-
|
|
46
|
-
return key;
|
|
58
|
+
// The key light is returned because `WorldEnvironment`'s godrays stage raymarches against its
|
|
59
|
+
// shadow map, so `setupPost` needs the light itself.
|
|
60
|
+
return { key };
|
|
47
61
|
}
|
|
@@ -14,14 +14,14 @@ import { palette } from "./palette.js";
|
|
|
14
14
|
/* BEGIN THREENATIVE LOADING APPEARANCE */
|
|
15
15
|
/** Shooter look and composition; edit this generated source for the launch screen. */
|
|
16
16
|
export const loading = {
|
|
17
|
-
backgroundColor: palette.
|
|
17
|
+
backgroundColor: palette.horizon,
|
|
18
18
|
backgroundImage: undefined as string | undefined,
|
|
19
19
|
enabled: true,
|
|
20
20
|
fillImage: undefined as string | undefined,
|
|
21
21
|
logoImage: undefined as string | undefined,
|
|
22
22
|
progressColor: palette.accent,
|
|
23
23
|
showStatus: false,
|
|
24
|
-
trackColor: palette.
|
|
24
|
+
trackColor: palette.structure,
|
|
25
25
|
bar: { anchorX: 0.5, anchorY: 0.74, height: 10, maxWidth: 520, minWidth: 1, width: 0.6 },
|
|
26
26
|
} as const;
|
|
27
27
|
/* END THREENATIVE LOADING APPEARANCE */
|
|
@@ -1,91 +1,103 @@
|
|
|
1
|
-
// Generated for you
|
|
2
|
-
|
|
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 look every engine ships a new project with: a metre grid on neutral greys, one
|
|
5
|
+
// saturated colour for things you can touch, and a metal figure. It reads as "a real engine" only
|
|
6
|
+
// because `sky.ts` gives every surface an environment to reflect — roughness then decides how much
|
|
7
|
+
// sky a surface mirrors, so keep it varied between neighbours.
|
|
8
|
+
import {
|
|
9
|
+
type BufferGeometry,
|
|
10
|
+
DataTexture,
|
|
11
|
+
Float32BufferAttribute,
|
|
12
|
+
LinearMipmapLinearFilter,
|
|
13
|
+
MeshStandardMaterial,
|
|
14
|
+
RepeatWrapping,
|
|
15
|
+
SRGBColorSpace,
|
|
16
|
+
Vector3,
|
|
17
|
+
} from "three";
|
|
3
18
|
import { palette } from "./palette.js";
|
|
4
19
|
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
// The weapon hangs at the eye, out of reach of the key light, so it carries a little emissive
|
|
41
|
-
// of its own. This is the flat "viewmodel light" every shooter uses, spent as material rather
|
|
42
|
-
// than as a light the rest of the arena would also see.
|
|
43
|
-
gunmetal: new MeshStandardMaterial({
|
|
44
|
-
color: 0x7d8996,
|
|
45
|
-
emissive: 0x2c343d,
|
|
46
|
-
emissiveIntensity: 1,
|
|
47
|
-
metalness: 0.7,
|
|
48
|
-
roughness: 0.42,
|
|
49
|
-
}),
|
|
50
|
-
polymer: new MeshStandardMaterial({
|
|
51
|
-
color: 0x4a5561,
|
|
52
|
-
emissive: 0x1e242b,
|
|
53
|
-
emissiveIntensity: 1,
|
|
54
|
-
metalness: 0.08,
|
|
55
|
-
roughness: 0.66,
|
|
56
|
-
}),
|
|
57
|
-
glove: new MeshStandardMaterial({
|
|
58
|
-
color: 0x6a7986,
|
|
59
|
-
emissive: 0x232b33,
|
|
60
|
-
emissiveIntensity: 1,
|
|
61
|
-
metalness: 0.05,
|
|
62
|
-
roughness: 0.8,
|
|
63
|
-
}),
|
|
64
|
-
/** Inset floor panels: one step off the arena tone, so the deck has a surface rather than a
|
|
65
|
-
* colour. Cheaper and quieter than a painted grid. */
|
|
66
|
-
floorPanel: new MeshStandardMaterial({
|
|
67
|
-
color: 0x2e4257,
|
|
68
|
-
metalness: 0.06,
|
|
69
|
-
roughness: 0.84,
|
|
70
|
-
}),
|
|
71
|
-
/** Waist-high crates and pillars. A mid tone, so a box reads as a box and not as its lit lip. */
|
|
72
|
-
cover: new MeshStandardMaterial({ color: 0x3d5266, metalness: 0.08, roughness: 0.78 }),
|
|
73
|
-
sight: new MeshStandardMaterial({
|
|
74
|
-
color: palette.hostile,
|
|
75
|
-
emissive: palette.hostile,
|
|
76
|
-
emissiveIntensity: 2.4,
|
|
77
|
-
metalness: 0,
|
|
78
|
-
roughness: 1,
|
|
79
|
-
}),
|
|
80
|
-
// Cover edges. Same accent hue as `trim`, a fraction of its emissive: a waist-high crate lit
|
|
81
|
-
// like a HUD element photographs as a glowing platform rather than something to hide behind.
|
|
82
|
-
edge: new MeshStandardMaterial({ color: 0x9a8b55, metalness: 0.35, roughness: 0.6 }),
|
|
83
|
-
trim: new MeshStandardMaterial({
|
|
84
|
-
color: palette.accent,
|
|
85
|
-
emissive: palette.accent,
|
|
86
|
-
emissiveIntensity: 0.45,
|
|
87
|
-
metalness: 0.45,
|
|
88
|
-
roughness: 0.28,
|
|
89
|
-
}),
|
|
90
|
-
};
|
|
20
|
+
/**
|
|
21
|
+
* One metre of grid: a heavy line on the metre, faint lines every 25 cm, a faint per-texel grain so
|
|
22
|
+
* large areas do not band. Built from bytes rather than a canvas so it runs the same in the browser
|
|
23
|
+
* and in the native host.
|
|
24
|
+
*/
|
|
25
|
+
function gridTexture(base: number, line: number, size = 256): DataTexture {
|
|
26
|
+
const data = new Uint8Array(size * size * 4);
|
|
27
|
+
const minorEvery = size / 4;
|
|
28
|
+
let seed = 7;
|
|
29
|
+
for (let y = 0; y < size; y += 1) {
|
|
30
|
+
for (let x = 0; x < size; x += 1) {
|
|
31
|
+
const major = x < 3 || y < 3;
|
|
32
|
+
const minor = x % minorEvery < 1 || y % minorEvery < 1;
|
|
33
|
+
const weight = major ? 0.92 : minor ? 0.22 : 0;
|
|
34
|
+
seed = (seed * 16807) % 2147483647;
|
|
35
|
+
const grain = 1 + (seed / 2147483647 - 0.5) * 0.04;
|
|
36
|
+
const index = (y * size + x) * 4;
|
|
37
|
+
for (let channel = 0; channel < 3; channel += 1) {
|
|
38
|
+
const shift = 16 - channel * 8;
|
|
39
|
+
const from = ((base >> shift) & 0xff) * grain;
|
|
40
|
+
const to = (line >> shift) & 0xff;
|
|
41
|
+
data[index + channel] = Math.min(255, Math.round(from * (1 - weight) + to * weight));
|
|
42
|
+
}
|
|
43
|
+
data[index + 3] = 255;
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
const texture = new DataTexture(data, size, size);
|
|
47
|
+
texture.colorSpace = SRGBColorSpace;
|
|
48
|
+
texture.wrapS = RepeatWrapping;
|
|
49
|
+
texture.wrapT = RepeatWrapping;
|
|
50
|
+
texture.generateMipmaps = true;
|
|
51
|
+
texture.minFilter = LinearMipmapLinearFilter;
|
|
52
|
+
texture.anisotropy = 16;
|
|
53
|
+
texture.needsUpdate = true;
|
|
54
|
+
return texture;
|
|
91
55
|
}
|
|
56
|
+
|
|
57
|
+
const _normal = new Vector3();
|
|
58
|
+
|
|
59
|
+
/**
|
|
60
|
+
* Rewrites a geometry's UVs as world metres, projected along each face's dominant axis, so one grid
|
|
61
|
+
* tile is one metre on every face of every prop regardless of its size. Call it after the geometry
|
|
62
|
+
* is translated into place (merged geometry included), before it is given to a mesh.
|
|
63
|
+
*/
|
|
64
|
+
export function worldGridUVs<T extends BufferGeometry>(geometry: T): T {
|
|
65
|
+
const position = geometry.getAttribute("position");
|
|
66
|
+
const normal = geometry.getAttribute("normal");
|
|
67
|
+
const uv = new Float32Array(position.count * 2);
|
|
68
|
+
for (let index = 0; index < position.count; index += 1) {
|
|
69
|
+
_normal.fromBufferAttribute(normal, index);
|
|
70
|
+
const x = position.getX(index);
|
|
71
|
+
const y = position.getY(index);
|
|
72
|
+
const z = position.getZ(index);
|
|
73
|
+
const ax = Math.abs(_normal.x);
|
|
74
|
+
const ay = Math.abs(_normal.y);
|
|
75
|
+
const az = Math.abs(_normal.z);
|
|
76
|
+
const [u, v] = ay >= ax && ay >= az ? [x, z] : ax >= az ? [z, y] : [x, y];
|
|
77
|
+
uv[index * 2] = u;
|
|
78
|
+
uv[index * 2 + 1] = v;
|
|
79
|
+
}
|
|
80
|
+
geometry.setAttribute("uv", new Float32BufferAttribute(uv, 2));
|
|
81
|
+
return geometry;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
/** Light grid: floors and the ground. */
|
|
85
|
+
export const floorMaterial = new MeshStandardMaterial({
|
|
86
|
+
map: gridTexture(palette.floor, palette.gridLine),
|
|
87
|
+
roughness: 0.62,
|
|
88
|
+
metalness: 0,
|
|
89
|
+
});
|
|
90
|
+
|
|
91
|
+
/** Dark grid: walls, pillars, anything structural. */
|
|
92
|
+
export const structureMaterial = new MeshStandardMaterial({
|
|
93
|
+
map: gridTexture(palette.structure, palette.gridLine),
|
|
94
|
+
roughness: 0.7,
|
|
95
|
+
metalness: 0,
|
|
96
|
+
});
|
|
97
|
+
|
|
98
|
+
/** The one saturated colour: things you can push, pick up or stand on. */
|
|
99
|
+
export const propMaterial = new MeshStandardMaterial({
|
|
100
|
+
color: palette.prop,
|
|
101
|
+
roughness: 0.45,
|
|
102
|
+
metalness: 0,
|
|
103
|
+
});
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
import type { Vector3 } from "three";
|
|
2
|
+
import type { TownCollider } from "./town.js";
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* Whether a sight line is blocked, answered from the world's collision boxes.
|
|
6
|
+
*
|
|
7
|
+
* ## Why not a raycast
|
|
8
|
+
*
|
|
9
|
+
* This started as `ctx.raycastAll` against every solid mesh in the town, run once per soldier per
|
|
10
|
+
* frame. Measured across five soldiers it cost 15.4 ms of a 16.3 ms frame — the whole mid-round
|
|
11
|
+
* hitch, in one call. A raycast has to walk a scene graph, update world matrices, build or consult
|
|
12
|
+
* an acceleration structure per geometry, collect every hit and sort them, and it does all of that
|
|
13
|
+
* to answer a question with one bit in it.
|
|
14
|
+
*
|
|
15
|
+
* The town already publishes exactly what a sight line cares about: `TownCollider`, the axis-
|
|
16
|
+
* aligned boxes that stop the player walking through walls. A segment against an AABB is the slab
|
|
17
|
+
* test — six divides and a few comparisons, no allocation, no traversal — and it stops at the
|
|
18
|
+
* first box that blocks. A couple of hundred boxes come out in microseconds.
|
|
19
|
+
*
|
|
20
|
+
* ## Why this is also more correct
|
|
21
|
+
*
|
|
22
|
+
* The raycast tested render meshes, so a soldier's line of sight could be broken by a handrail, an
|
|
23
|
+
* awning, or a plate of thin dressing that a player can plainly see through, and the old code
|
|
24
|
+
* carried a `userData` special case to unpick one of those. Sight is now blocked by precisely what
|
|
25
|
+
* blocks movement: if you cannot walk through it, you cannot see through it. That is one rule with
|
|
26
|
+
* no exceptions list, and it is the rule the level was built around.
|
|
27
|
+
*
|
|
28
|
+
* Purely decorative geometry no longer occludes. That is the intended trade: a soldier who spots
|
|
29
|
+
* you through a railing is a fair fight, and one who loses you behind a drainpipe is a bug report.
|
|
30
|
+
*/
|
|
31
|
+
|
|
32
|
+
/** A hair off each end, so a body standing flush against a wall does not occlude itself. */
|
|
33
|
+
const END_EPSILON = 0.05;
|
|
34
|
+
|
|
35
|
+
export class BoxOccluders {
|
|
36
|
+
readonly #boxes: readonly TownCollider[];
|
|
37
|
+
#tests = 0;
|
|
38
|
+
|
|
39
|
+
constructor(boxes: readonly TownCollider[]) {
|
|
40
|
+
this.#boxes = boxes;
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
/** Sight-line tests answered since construction; the dev overlay reads it. */
|
|
44
|
+
get tests(): number {
|
|
45
|
+
return this.#tests;
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
get boxes(): number {
|
|
49
|
+
return this.#boxes.length;
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** True when nothing solid stands between `from` and `to`. */
|
|
53
|
+
clear(from: Vector3, to: Vector3): boolean {
|
|
54
|
+
this.#tests += 1;
|
|
55
|
+
const dx = to.x - from.x;
|
|
56
|
+
const dy = to.y - from.y;
|
|
57
|
+
const dz = to.z - from.z;
|
|
58
|
+
const length = Math.hypot(dx, dy, dz);
|
|
59
|
+
if (length < 1e-4) return true;
|
|
60
|
+
const near = END_EPSILON;
|
|
61
|
+
const far = length - END_EPSILON;
|
|
62
|
+
if (far <= near) return true;
|
|
63
|
+
// Unit direction, and its reciprocal once per call rather than once per box.
|
|
64
|
+
const ux = dx / length;
|
|
65
|
+
const uy = dy / length;
|
|
66
|
+
const uz = dz / length;
|
|
67
|
+
const ix = ux === 0 ? Number.POSITIVE_INFINITY : 1 / ux;
|
|
68
|
+
const iy = uy === 0 ? Number.POSITIVE_INFINITY : 1 / uy;
|
|
69
|
+
const iz = uz === 0 ? Number.POSITIVE_INFINITY : 1 / uz;
|
|
70
|
+
|
|
71
|
+
for (const box of this.#boxes) {
|
|
72
|
+
const { min, max } = box;
|
|
73
|
+
// Slab test, one axis at a time. `tEnter` is how far along the ray the box starts,
|
|
74
|
+
// `tExit` how far along it ends; they cross over when the ray misses.
|
|
75
|
+
let tEnter = near;
|
|
76
|
+
let tExit = far;
|
|
77
|
+
|
|
78
|
+
let t1 = ((min[0] as number) - from.x) * ix;
|
|
79
|
+
let t2 = ((max[0] as number) - from.x) * ix;
|
|
80
|
+
if (t1 > t2) [t1, t2] = [t2, t1];
|
|
81
|
+
if (t1 > tEnter) tEnter = t1;
|
|
82
|
+
if (t2 < tExit) tExit = t2;
|
|
83
|
+
if (tEnter > tExit) continue;
|
|
84
|
+
|
|
85
|
+
t1 = ((min[1] as number) - from.y) * iy;
|
|
86
|
+
t2 = ((max[1] as number) - from.y) * iy;
|
|
87
|
+
if (t1 > t2) [t1, t2] = [t2, t1];
|
|
88
|
+
if (t1 > tEnter) tEnter = t1;
|
|
89
|
+
if (t2 < tExit) tExit = t2;
|
|
90
|
+
if (tEnter > tExit) continue;
|
|
91
|
+
|
|
92
|
+
t1 = ((min[2] as number) - from.z) * iz;
|
|
93
|
+
t2 = ((max[2] as number) - from.z) * iz;
|
|
94
|
+
if (t1 > t2) [t1, t2] = [t2, t1];
|
|
95
|
+
if (t1 > tEnter) tEnter = t1;
|
|
96
|
+
if (t2 < tExit) tExit = t2;
|
|
97
|
+
if (tEnter > tExit) continue;
|
|
98
|
+
|
|
99
|
+
// The segment enters this box before it ends: something solid is in the way.
|
|
100
|
+
return false;
|
|
101
|
+
}
|
|
102
|
+
return true;
|
|
103
|
+
}
|
|
104
|
+
|
|
105
|
+
debug(): { boxes: number; tests: number } {
|
|
106
|
+
return { boxes: this.#boxes.length, tests: this.#tests };
|
|
107
|
+
}
|
|
108
|
+
}
|
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
// Generated for you. Keep
|
|
2
|
-
//
|
|
3
|
-
// as near-black with a yellow grid floating on it — the cover, the walls and the ground all
|
|
4
|
-
// collapsed into one value and only the emissive trim survived.
|
|
1
|
+
// Generated for you. Keep these roles coherent when you change the look.
|
|
2
|
+
// Neutral greys carry the light; one saturated blue marks what you can touch.
|
|
5
3
|
export const palette = {
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
accent:
|
|
4
|
+
floor: 0xb4b1ae,
|
|
5
|
+
structure: 0x747578,
|
|
6
|
+
gridLine: 0x3a3a3c,
|
|
7
|
+
prop: 0x2a6cf0,
|
|
8
|
+
/** Touch-control highlight. */
|
|
9
|
+
accent: 0xffffff,
|
|
10
|
+
/** The sky photograph's own horizon, measured from its HDR: distance fades into this. */
|
|
11
|
+
horizon: 0xacb1c1,
|
|
12
12
|
} as const;
|