create-threenative 0.2.6 → 0.2.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/agent-docs/references/build-profiles.md +126 -0
- package/agent-docs/references/capability-reference.md +431 -20
- package/agent-docs/references/performance-basics.md +8 -5
- package/agent-docs/references/sculpt-from-a-reference.md +1 -1
- package/agent-docs/references/trace-a-slow-frame.md +1 -1
- package/agent-docs/references/visual-baseline.md +8 -4
- package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
- package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
- package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
- package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
- package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
- package/capabilities.json +555 -21
- package/dist/index.d.ts +30 -1
- package/dist/index.js +294 -55
- package/dist/threenative.js +714 -154
- package/package.json +6 -6
- package/template-assets/assets/mannequin-combat.glb +0 -0
- package/template-assets/assets/mannequin.glb +0 -0
- package/template-assets/assets/player-viewmodel.glb +0 -0
- package/template-assets/assets/sky.jpg +0 -0
- package/template-assets/clearwater/README.md +141 -0
- package/template-assets/clearwater/install.mjs +50 -0
- package/template-assets/clearwater/src/clearwater.ts +180 -0
- package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
- package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
- package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
- package/template-assets/clearwater/src/render/clearwater.ts +278 -0
- package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
- package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
- package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
- package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
- package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
- package/template-assets/patches/three@0.185.1.patch +2101 -138
- package/template-assets/worldEnvironment.ts +52 -1
- package/templates/action-rpg/AGENTS.md +42 -42
- package/templates/action-rpg/CLAUDE.md +42 -42
- package/templates/action-rpg/kit.json +1 -1
- package/templates/action-rpg/package.json +13 -7
- package/templates/action-rpg/playtests/combat.playtest.json +162 -23
- package/templates/action-rpg/playtests/performance.playtest.json +4 -3
- package/templates/action-rpg/playtests/survives.playtest.json +25 -8
- package/templates/action-rpg/src/conventions.ts +24 -18
- package/templates/action-rpg/src/entities/Enemy.ts +74 -24
- package/templates/action-rpg/src/entities/Fighter.ts +127 -0
- package/templates/action-rpg/src/entities/Player.ts +102 -32
- package/templates/action-rpg/src/game.ts +3 -3
- package/templates/action-rpg/src/render/camera.ts +18 -16
- package/templates/action-rpg/src/render/dungeon.ts +192 -0
- package/templates/action-rpg/src/render/lighting.ts +45 -28
- package/templates/action-rpg/src/render/loading.ts +4 -4
- package/templates/action-rpg/src/render/materials.ts +191 -47
- package/templates/action-rpg/src/render/palette.ts +14 -13
- package/templates/action-rpg/src/render/postprocessing.ts +12 -2
- package/templates/action-rpg/src/render/props.ts +117 -0
- package/templates/action-rpg/src/render/quality.ts +40 -82
- package/templates/action-rpg/src/render/sky.ts +36 -13
- package/templates/action-rpg/src/render/touch-controls.ts +1 -1
- package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
- package/templates/action-rpg/src/scenes/Play.ts +61 -39
- package/templates/action-rpg/src/style.css +9 -7
- package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
- package/templates/action-rpg/src/ui/Hud.tsx +3 -3
- package/templates/action-rpg/threenative.config.ts +14 -1
- package/templates/action-rpg/vite.config.ts +4 -1
- package/templates/minimal/AGENTS.md +10 -10
- package/templates/minimal/CLAUDE.md +10 -10
- package/templates/minimal/package.json +12 -6
- package/templates/minimal/playtests/play.playtest.json +6 -5
- package/templates/minimal/playtests/sky.playtest.json +27 -0
- package/templates/minimal/src/conventions.ts +6 -3
- package/templates/minimal/src/entities/Player.ts +73 -27
- package/templates/minimal/src/main.ts +2 -3
- package/templates/minimal/src/render/camera.ts +22 -4
- package/templates/minimal/src/render/lighting.ts +24 -48
- package/templates/minimal/src/render/materials.ts +158 -13
- package/templates/minimal/src/render/palette.ts +10 -7
- package/templates/minimal/src/render/postprocessing.ts +12 -25
- package/templates/minimal/src/render/quality.ts +35 -69
- package/templates/minimal/src/render/sky.ts +35 -54
- package/templates/minimal/src/render/touch-controls.ts +1 -1
- package/templates/minimal/src/render/worldEnvironment.ts +52 -1
- package/templates/minimal/src/scenes/Play.ts +121 -111
- package/templates/minimal/src/state.ts +0 -4
- package/templates/minimal/src/style.css +0 -10
- package/templates/minimal/threenative.config.ts +14 -1
- package/templates/minimal/vite.config.ts +4 -1
- package/templates/platformer/AGENTS.md +18 -56
- package/templates/platformer/CLAUDE.md +18 -56
- package/templates/platformer/kit.json +2 -2
- package/templates/platformer/package.json +13 -9
- package/templates/platformer/playtests/buffer.playtest.json +15 -5
- package/templates/platformer/playtests/collect.playtest.json +8 -34
- package/templates/platformer/playtests/coyote.playtest.json +12 -34
- package/templates/platformer/playtests/damage.playtest.json +40 -15
- package/templates/platformer/playtests/hud.playtest.json +34 -0
- package/templates/platformer/playtests/move.playtest.json +24 -0
- package/templates/platformer/playtests/performance.playtest.json +24 -7
- package/templates/platformer/playtests/respawn.playtest.json +46 -11
- package/templates/platformer/playtests/stomp.playtest.json +49 -12
- package/templates/platformer/playtests/survives.playtest.json +3 -19
- package/templates/platformer/playtests/world.playtest.json +26 -0
- package/templates/platformer/src/entities/Fox.ts +273 -0
- package/templates/platformer/src/entities/Pickup.ts +43 -60
- package/templates/platformer/src/entities/Walker.ts +88 -0
- package/templates/platformer/src/game.ts +11 -8
- package/templates/platformer/src/level/Checkpoints.ts +29 -16
- package/templates/platformer/src/level/Stage.ts +469 -0
- package/templates/platformer/src/render/blocks.ts +94 -0
- package/templates/platformer/src/render/camera.ts +28 -3
- package/templates/platformer/src/render/fox.ts +196 -0
- package/templates/platformer/src/render/lighting.ts +42 -33
- package/templates/platformer/src/render/materials.ts +115 -5
- package/templates/platformer/src/render/palette.ts +68 -53
- package/templates/platformer/src/render/pickups.ts +142 -0
- package/templates/platformer/src/render/postprocessing.ts +12 -2
- package/templates/platformer/src/render/props.ts +147 -0
- package/templates/platformer/src/render/quality.ts +47 -99
- package/templates/platformer/src/render/scenery.ts +172 -0
- package/templates/platformer/src/render/sky.ts +120 -31
- package/templates/platformer/src/render/touch-controls.ts +5 -2
- package/templates/platformer/src/render/walkers.ts +96 -0
- package/templates/platformer/src/render/waterfall.ts +85 -0
- package/templates/platformer/src/render/worldEnvironment.ts +52 -1
- package/templates/platformer/src/scenes/Boot.ts +3 -4
- package/templates/platformer/src/scenes/Play.ts +362 -0
- package/templates/platformer/src/state.ts +16 -14
- package/templates/platformer/src/style.css +9 -8
- package/templates/platformer/src/ui/Hud.tsx +62 -29
- package/templates/platformer/src/ui/Menu.tsx +2 -2
- package/templates/platformer/threenative.config.ts +14 -1
- package/templates/platformer/vite.config.ts +4 -1
- package/templates/puzzle/AGENTS.md +19 -20
- package/templates/puzzle/CLAUDE.md +19 -20
- package/templates/puzzle/assets/native-proof.glb +0 -0
- package/templates/puzzle/assets/native-proof.png +0 -0
- package/templates/puzzle/kit.json +1 -1
- package/templates/puzzle/package.json +13 -7
- package/templates/puzzle/playtests/axis.playtest.json +20 -0
- package/templates/puzzle/playtests/blocked.playtest.json +73 -0
- package/templates/puzzle/playtests/caused.playtest.json +65 -0
- package/templates/puzzle/playtests/lit.playtest.json +74 -0
- package/templates/puzzle/playtests/performance.playtest.json +24 -7
- package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
- package/templates/puzzle/playtests/replay.playtest.json +81 -0
- package/templates/puzzle/playtests/restart.playtest.json +108 -0
- package/templates/puzzle/playtests/seal.playtest.json +98 -0
- package/templates/puzzle/playtests/settle.playtest.json +100 -0
- package/templates/puzzle/playtests/survives.playtest.json +6 -29
- package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
- package/templates/puzzle/src/entities/Crate.ts +99 -42
- package/templates/puzzle/src/entities/Seal.ts +69 -0
- package/templates/puzzle/src/entities/Warden.ts +135 -0
- package/templates/puzzle/src/game.ts +15 -11
- package/templates/puzzle/src/render/camera.ts +66 -31
- package/templates/puzzle/src/render/crateShape.ts +70 -0
- package/templates/puzzle/src/render/lighting.ts +41 -41
- package/templates/puzzle/src/render/loading.ts +4 -4
- package/templates/puzzle/src/render/materials.ts +131 -27
- package/templates/puzzle/src/render/palette.ts +19 -29
- package/templates/puzzle/src/render/postprocessing.ts +15 -3
- package/templates/puzzle/src/render/quality.ts +71 -80
- package/templates/puzzle/src/render/shapes.ts +109 -108
- package/templates/puzzle/src/render/sky.ts +18 -10
- package/templates/puzzle/src/render/touch-controls.ts +8 -51
- package/templates/puzzle/src/render/vault.ts +315 -0
- package/templates/puzzle/src/render/warden.ts +46 -0
- package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
- package/templates/puzzle/src/scenes/Play.ts +793 -0
- package/templates/puzzle/src/state.ts +55 -24
- package/templates/puzzle/src/style.css +7 -8
- package/templates/puzzle/src/ui/App.tsx +2 -2
- package/templates/puzzle/src/ui/Hud.tsx +92 -40
- package/templates/puzzle/src/ui/Menu.tsx +40 -2
- package/templates/puzzle/threenative.config.ts +14 -1
- package/templates/puzzle/vite.config.ts +4 -1
- package/templates/racing/AGENTS.md +19 -20
- package/templates/racing/CLAUDE.md +19 -20
- package/templates/racing/package.json +13 -7
- package/templates/racing/playtests/boost.playtest.json +33 -12
- package/templates/racing/playtests/outcome.playtest.json +32 -50
- package/templates/racing/playtests/performance.playtest.json +2 -1
- package/templates/racing/playtests/ranking.playtest.json +5 -14
- package/templates/racing/playtests/rescue.playtest.json +2 -2
- package/templates/racing/playtests/reverse.playtest.json +30 -8
- package/templates/racing/playtests/shortcut.playtest.json +54 -9
- package/templates/racing/playtests/touch-controls.playtest.json +32 -5
- package/templates/racing/src/entities/CarBody.ts +327 -0
- package/templates/racing/src/entities/LineDriver.ts +220 -0
- package/templates/racing/src/entities/RacingCar.ts +150 -89
- package/templates/racing/src/entities/Rival.ts +61 -24
- package/templates/racing/src/game.ts +5 -0
- package/templates/racing/src/render/camera.ts +49 -7
- package/templates/racing/src/render/lighting.ts +36 -37
- package/templates/racing/src/render/materials.ts +239 -19
- package/templates/racing/src/render/palette.ts +19 -21
- package/templates/racing/src/render/postprocessing.ts +12 -2
- package/templates/racing/src/render/quality.ts +43 -82
- package/templates/racing/src/render/shapes.ts +20 -6
- package/templates/racing/src/render/sky.ts +47 -39
- package/templates/racing/src/render/touch-controls.ts +1 -1
- package/templates/racing/src/render/worldEnvironment.ts +52 -1
- package/templates/racing/src/scenes/Race.ts +107 -54
- package/templates/racing/src/state.ts +2 -0
- package/templates/racing/src/track/Checkline.ts +22 -7
- package/templates/racing/src/track/Lap.ts +64 -36
- package/templates/racing/src/track/Ranking.ts +20 -11
- package/templates/racing/src/track/Track.ts +809 -361
- package/templates/racing/src/track/TrackSector.ts +40 -11
- package/templates/racing/src/track/circuit.ts +477 -0
- package/templates/racing/src/track/rescue.ts +16 -4
- package/templates/racing/threenative.config.ts +14 -1
- package/templates/racing/vite.config.ts +4 -1
- package/templates/rts/AGENTS.md +96 -0
- package/templates/rts/CLAUDE.md +98 -0
- package/templates/rts/kit.json +7 -0
- package/templates/{defense → rts}/package.json +13 -7
- package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
- package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
- package/templates/rts/playtests/rts-attack.playtest.json +75 -0
- package/templates/rts/playtests/rts-build.playtest.json +68 -0
- package/templates/rts/playtests/rts-orders.playtest.json +150 -0
- package/templates/rts/playtests/rts-train.playtest.json +62 -0
- package/templates/rts/playtests/survives.playtest.json +58 -0
- package/templates/rts/public/favicon.svg +4 -0
- package/templates/rts/src/game.ts +64 -0
- package/templates/rts/src/orders.ts +22 -0
- package/templates/rts/src/render/army.ts +346 -0
- package/templates/rts/src/render/camera.ts +123 -0
- package/templates/rts/src/render/lighting.ts +61 -0
- package/templates/rts/src/render/loading.ts +33 -0
- package/templates/rts/src/render/materials.ts +152 -0
- package/templates/rts/src/render/models.ts +705 -0
- package/templates/rts/src/render/palette.ts +17 -0
- package/templates/rts/src/render/picking.ts +93 -0
- package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
- package/templates/rts/src/render/quality.ts +128 -0
- package/templates/rts/src/render/resources.ts +141 -0
- package/templates/rts/src/render/sky.ts +44 -0
- package/templates/rts/src/render/terrain.ts +116 -0
- package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
- package/templates/rts/src/scenes/Play.ts +650 -0
- package/templates/rts/src/sim/ai.ts +1140 -0
- package/templates/rts/src/sim/combat.ts +416 -0
- package/templates/rts/src/sim/construction.ts +374 -0
- package/templates/rts/src/sim/economy.ts +167 -0
- package/templates/rts/src/sim/game.ts +1082 -0
- package/templates/rts/src/sim/movement.ts +371 -0
- package/templates/rts/src/sim/nav.ts +276 -0
- package/templates/rts/src/sim/production.ts +180 -0
- package/templates/rts/src/sim/terrain.ts +170 -0
- package/templates/rts/src/sim/types.ts +647 -0
- package/templates/rts/src/sim/vision.ts +46 -0
- package/templates/rts/src/state.ts +100 -0
- package/templates/{defense → rts}/src/style.css +21 -8
- package/templates/rts/src/ui/App.tsx +21 -0
- package/templates/rts/src/ui/Commands.tsx +129 -0
- package/templates/rts/src/ui/GameUi.tsx +22 -0
- package/templates/rts/src/ui/Hud.tsx +165 -0
- package/templates/rts/src/ui/Minimap.tsx +84 -0
- package/templates/rts/tailwind.config.ts +2 -0
- package/templates/rts/threenative.config.ts +56 -0
- package/templates/rts/tsconfig.json +17 -0
- package/templates/{defense → rts}/vite.config.ts +4 -1
- package/templates/runner/AGENTS.md +6 -10
- package/templates/runner/CLAUDE.md +6 -10
- package/templates/runner/README.md +3 -3
- package/templates/runner/package.json +13 -7
- package/templates/runner/playtests/performance.playtest.json +2 -2
- package/templates/runner/src/conventions.ts +4 -3
- package/templates/runner/src/entities/Runner.ts +54 -7
- package/templates/runner/src/game.ts +2 -0
- package/templates/runner/src/render/camera.ts +4 -2
- package/templates/runner/src/render/dust.ts +5 -2
- package/templates/runner/src/render/lighting.ts +41 -45
- package/templates/runner/src/render/loading.ts +2 -2
- package/templates/runner/src/render/materials.ts +165 -25
- package/templates/runner/src/render/palette.ts +17 -28
- package/templates/runner/src/render/postprocessing.ts +12 -2
- package/templates/runner/src/render/quality.ts +42 -96
- package/templates/runner/src/render/shapes.ts +59 -37
- package/templates/runner/src/render/sky.ts +32 -41
- package/templates/runner/src/render/touch-controls.ts +1 -1
- package/templates/runner/src/render/worldEnvironment.ts +52 -1
- package/templates/runner/src/scenes/Run.ts +26 -6
- package/templates/runner/src/track.ts +6 -1
- package/templates/runner/threenative.config.ts +14 -1
- package/templates/runner/vite.config.ts +4 -1
- package/templates/sailing/AGENTS.md +12 -12
- package/templates/sailing/CLAUDE.md +12 -12
- package/templates/sailing/assets/ship.glb +0 -0
- package/templates/sailing/package.json +13 -7
- package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
- package/templates/sailing/playtests/sails.playtest.json +33 -0
- package/templates/sailing/playtests/win.playtest.json +156 -8
- package/templates/sailing/src/conventions.ts +29 -2
- package/templates/sailing/src/entities/Ship.ts +381 -57
- package/templates/sailing/src/game.ts +14 -0
- package/templates/sailing/src/render/camera.ts +63 -9
- package/templates/sailing/src/render/lighting.ts +49 -27
- package/templates/sailing/src/render/materials.ts +50 -15
- package/templates/sailing/src/render/ocean.ts +647 -60
- package/templates/sailing/src/render/palette.ts +16 -12
- package/templates/sailing/src/render/postprocessing.ts +12 -2
- package/templates/sailing/src/render/props.ts +316 -442
- package/templates/sailing/src/render/quality.ts +14 -4
- package/templates/sailing/src/render/sky.ts +116 -23
- package/templates/sailing/src/render/worldEnvironment.ts +52 -1
- package/templates/sailing/src/scenes/Boot.ts +21 -0
- package/templates/sailing/src/scenes/Sailing.ts +173 -39
- package/templates/sailing/src/state.ts +6 -0
- package/templates/sailing/src/ui/Hud.tsx +41 -9
- package/templates/sailing/threenative.config.ts +14 -1
- package/templates/sailing/vite.config.ts +4 -1
- package/templates/shooter/AGENTS.md +27 -42
- package/templates/shooter/CLAUDE.md +27 -42
- package/templates/shooter/index.html +1 -0
- package/templates/shooter/package.json +13 -7
- package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
- package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
- package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
- package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
- package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
- package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
- package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
- package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
- package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
- package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
- package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
- package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
- package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
- package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
- package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
- package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
- package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
- package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
- package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
- package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
- package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
- package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
- package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
- package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
- package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
- package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
- package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
- package/templates/shooter/playtests/input-control.playtest.json +43 -98
- package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
- package/templates/shooter/playtests/performance.playtest.json +62 -26
- package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
- package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
- package/templates/shooter/playtests/survives.playtest.json +36 -30
- package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
- package/templates/shooter/src/entities/Breakables.ts +412 -0
- package/templates/shooter/src/entities/Enemy.ts +2095 -0
- package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
- package/templates/shooter/src/entities/Rifle.ts +442 -0
- package/templates/shooter/src/entities/Target.ts +199 -83
- package/templates/shooter/src/entities/TouchControls.ts +276 -0
- package/templates/shooter/src/game.ts +75 -41
- package/templates/shooter/src/main.ts +0 -1
- package/templates/shooter/src/postPhysics.ts +36 -0
- package/templates/shooter/src/render/camera.ts +78 -74
- package/templates/shooter/src/render/decals.ts +142 -82
- package/templates/shooter/src/render/facade.ts +1373 -0
- package/templates/shooter/src/render/gunfx.ts +704 -0
- package/templates/shooter/src/render/lighting.ts +52 -38
- package/templates/shooter/src/render/loading.ts +2 -2
- package/templates/shooter/src/render/materials.ts +100 -88
- package/templates/shooter/src/render/occlusion.ts +108 -0
- package/templates/shooter/src/render/palette.ts +10 -10
- package/templates/shooter/src/render/palm.ts +455 -0
- package/templates/shooter/src/render/pooled-billboards.ts +144 -0
- package/templates/shooter/src/render/postprocessing.ts +15 -3
- package/templates/shooter/src/render/quality.ts +40 -82
- package/templates/shooter/src/render/scale.ts +148 -15
- package/templates/shooter/src/render/shapes.ts +138 -613
- package/templates/shooter/src/render/sky.ts +35 -35
- package/templates/shooter/src/render/town-schematic.ts +120 -0
- package/templates/shooter/src/render/town.ts +986 -0
- package/templates/shooter/src/render/townMaterials.ts +160 -0
- package/templates/shooter/src/render/vehicles.ts +741 -0
- package/templates/shooter/src/render/worldEnvironment.ts +52 -1
- package/templates/shooter/src/scenes/Play.ts +727 -650
- package/templates/shooter/src/state.ts +26 -41
- package/templates/shooter/src/style.css +207 -11
- package/templates/shooter/src/surfaces.ts +131 -0
- package/templates/shooter/src/ui/App.tsx +9 -10
- package/templates/shooter/src/ui/Crosshair.tsx +25 -18
- package/templates/shooter/src/ui/GameUi.tsx +6 -9
- package/templates/shooter/src/ui/Hud.tsx +428 -39
- package/templates/shooter/src/ui/Minimap.tsx +164 -0
- package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
- package/templates/shooter/src/ui/main.tsx +2 -3
- package/templates/shooter/threenative.config.ts +14 -1
- package/templates/shooter/vite.config.ts +4 -1
- package/templates/starter/AGENTS.md +17 -17
- package/templates/starter/CLAUDE.md +17 -17
- package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
- package/templates/starter/package.json +13 -7
- package/templates/starter/playtests/play.playtest.json +2 -1
- package/templates/starter/playtests/survives.playtest.json +1 -1
- package/templates/starter/src/conventions.ts +6 -3
- package/templates/starter/src/entities/Goal.ts +35 -42
- package/templates/starter/src/entities/Player.ts +99 -16
- package/templates/starter/src/render/arena.ts +131 -0
- package/templates/starter/src/render/lighting.ts +27 -44
- package/templates/starter/src/render/materials.ts +164 -35
- package/templates/starter/src/render/palette.ts +16 -16
- package/templates/starter/src/render/postprocessing.ts +6 -7
- package/templates/starter/src/render/quality.ts +43 -101
- package/templates/starter/src/render/shapes.ts +1 -1
- package/templates/starter/src/render/sky.ts +39 -45
- package/templates/starter/src/render/touch-controls.ts +3 -1
- package/templates/starter/src/render/worldEnvironment.ts +52 -1
- package/templates/starter/src/scenes/Play.ts +82 -81
- package/templates/starter/threenative.config.ts +14 -1
- package/templates/starter/vite.config.ts +4 -1
- package/templates/tower-defense/.codex/config.toml +19 -0
- package/templates/tower-defense/.cursor/mcp.json +32 -0
- package/templates/tower-defense/.gemini/settings.json +32 -0
- package/templates/tower-defense/.mcp.json +32 -0
- package/templates/tower-defense/.vscode/mcp.json +36 -0
- package/templates/tower-defense/.zed/settings.json +36 -0
- package/templates/{defense → tower-defense}/AGENTS.md +14 -12
- package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
- package/templates/tower-defense/README.md +16 -0
- package/templates/tower-defense/index.html +12 -0
- package/templates/tower-defense/kit.json +7 -0
- package/templates/tower-defense/opencode.json +41 -0
- package/templates/tower-defense/package.json +56 -0
- package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
- package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
- package/templates/tower-defense/playtests/look.playtest.json +130 -0
- package/templates/tower-defense/playtests/performance.playtest.json +77 -0
- package/templates/tower-defense/playtests/placement.playtest.json +115 -0
- package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
- package/templates/tower-defense/playtests/strike.playtest.json +98 -0
- package/templates/tower-defense/playtests/survives.playtest.json +85 -0
- package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
- package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
- package/templates/tower-defense/playtests/victory.playtest.json +810 -0
- package/templates/tower-defense/src/balance.ts +187 -0
- package/templates/tower-defense/src/board/Board.ts +100 -0
- package/templates/tower-defense/src/board/Route.ts +84 -0
- package/templates/tower-defense/src/camera-rig.ts +62 -0
- package/templates/tower-defense/src/economy.ts +64 -0
- package/templates/tower-defense/src/effects/Effects.ts +284 -0
- package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
- package/templates/tower-defense/src/game.ts +72 -0
- package/templates/tower-defense/src/intents.ts +21 -0
- package/templates/tower-defense/src/main.ts +15 -0
- package/templates/tower-defense/src/physics.ts +6 -0
- package/templates/tower-defense/src/render/camera.ts +38 -0
- package/templates/tower-defense/src/render/lighting.ts +42 -0
- package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
- package/templates/tower-defense/src/render/materials.ts +103 -0
- package/templates/tower-defense/src/render/palette.ts +58 -0
- package/templates/tower-defense/src/render/postprocessing.ts +46 -0
- package/templates/tower-defense/src/render/quality.ts +128 -0
- package/templates/tower-defense/src/render/shapes.ts +550 -0
- package/templates/tower-defense/src/render/sky.ts +27 -0
- package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
- package/templates/tower-defense/src/scenes/Battle.ts +539 -0
- package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
- package/templates/tower-defense/src/state.ts +88 -0
- package/templates/tower-defense/src/style.css +137 -0
- package/templates/tower-defense/src/towers/Tower.ts +230 -0
- package/templates/tower-defense/src/towers/targeting.ts +97 -0
- package/templates/tower-defense/src/ui/Hud.tsx +270 -0
- package/templates/tower-defense/src/ui/Menu.tsx +134 -0
- package/templates/tower-defense/src/ui/icons.tsx +54 -0
- package/templates/tower-defense/src/ui/main.tsx +14 -0
- package/templates/tower-defense/src/waves.ts +90 -0
- package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
- package/templates/tower-defense/vite.config.ts +41 -0
- package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
- package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
- package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
- package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
- package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
- package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
- package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
- package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
- package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
- package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
- package/agent-files/AGENT-ROLES.md +0 -26
- package/templates/action-rpg/src/render/shapes.ts +0 -269
- package/templates/action-rpg/src/render/types.ts +0 -3
- package/templates/action-rpg/src/scenes/Boot.ts +0 -12
- package/templates/defense/README.md +0 -10
- package/templates/defense/kit.json +0 -7
- package/templates/defense/playtests/leak.playtest.json +0 -23
- package/templates/defense/playtests/placement.playtest.json +0 -40
- package/templates/defense/playtests/scan.playtest.json +0 -20
- package/templates/defense/playtests/survive.playtest.json +0 -45
- package/templates/defense/playtests/survives.playtest.json +0 -36
- package/templates/defense/src/attackers/Attacker.ts +0 -120
- package/templates/defense/src/board/Route.ts +0 -94
- package/templates/defense/src/conventions.ts +0 -18
- package/templates/defense/src/economy.ts +0 -36
- package/templates/defense/src/entities/Player.ts +0 -52
- package/templates/defense/src/game.ts +0 -51
- package/templates/defense/src/physics.ts +0 -13
- package/templates/defense/src/placement/Buildable.ts +0 -49
- package/templates/defense/src/render/camera.ts +0 -16
- package/templates/defense/src/render/lighting.ts +0 -37
- package/templates/defense/src/render/materials.ts +0 -22
- package/templates/defense/src/render/palette.ts +0 -28
- package/templates/defense/src/render/quality.ts +0 -170
- package/templates/defense/src/render/shapes.ts +0 -246
- package/templates/defense/src/render/sky.ts +0 -45
- package/templates/defense/src/scenes/Boot.ts +0 -12
- package/templates/defense/src/scenes/Defense.ts +0 -231
- package/templates/defense/src/state.ts +0 -56
- package/templates/defense/src/towers/Tower.ts +0 -95
- package/templates/defense/src/towers/targeting.ts +0 -53
- package/templates/defense/src/ui/Hud.tsx +0 -62
- package/templates/defense/src/ui/Menu.tsx +0 -7
- package/templates/defense/src/waves.ts +0 -40
- package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
- package/templates/minimal/src/render/hud.ts +0 -69
- package/templates/platformer/playtests/avoidance.playtest.json +0 -28
- package/templates/platformer/playtests/chase.playtest.json +0 -21
- package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
- package/templates/platformer/playtests/oneway.playtest.json +0 -44
- package/templates/platformer/playtests/patrol.playtest.json +0 -13
- package/templates/platformer/playtests/physics.playtest.json +0 -14
- package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
- package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
- package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
- package/templates/platformer/src/conventions.ts +0 -18
- package/templates/platformer/src/entities/Character.ts +0 -286
- package/templates/platformer/src/entities/Chaser.ts +0 -118
- package/templates/platformer/src/entities/Patrol.ts +0 -93
- package/templates/platformer/src/level/Platform.ts +0 -46
- package/templates/platformer/src/render/rig.ts +0 -60
- package/templates/platformer/src/render/terrain.ts +0 -31
- package/templates/platformer/src/scenes/Level.ts +0 -241
- package/templates/puzzle/README.md +0 -43
- package/templates/puzzle/playtests/carry.playtest.json +0 -71
- package/templates/puzzle/playtests/swing.playtest.json +0 -38
- package/templates/puzzle/src/conventions.ts +0 -25
- package/templates/puzzle/src/entities/Ball.ts +0 -70
- package/templates/puzzle/src/entities/Gripper.ts +0 -69
- package/templates/puzzle/src/entities/Pendulum.ts +0 -89
- package/templates/puzzle/src/physics.ts +0 -19
- package/templates/puzzle/src/room.ts +0 -83
- package/templates/puzzle/src/scenes/Boot.ts +0 -12
- package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
- package/templates/shooter/playtests/combat.playtest.json +0 -48
- package/templates/shooter/playtests/fail.playtest.json +0 -31
- package/templates/shooter/playtests/per-item.playtest.json +0 -59
- package/templates/shooter/playtests/shooter.playtest.json +0 -99
- package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
- package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
- package/templates/shooter/src/combat/damage.ts +0 -40
- package/templates/shooter/src/conventions.ts +0 -51
- package/templates/shooter/src/entities/Pickup.ts +0 -70
- package/templates/shooter/src/entities/Player.ts +0 -310
- package/templates/shooter/src/level/SpawnPoints.ts +0 -28
- package/templates/shooter/src/playtest-events.ts +0 -15
- package/templates/shooter/src/render/touch-controls.ts +0 -305
- package/templates/shooter/src/render/types.ts +0 -3
- package/templates/shooter/src/render/ui.css +0 -330
- package/templates/shooter/src/render/ui.ts +0 -75
- package/templates/shooter/src/render/vfx.ts +0 -215
- package/templates/shooter/src/ui/Menu.tsx +0 -41
- package/templates/shooter/src/waves.ts +0 -50
- package/templates/shooter/src/weapons/Hitscan.ts +0 -42
- package/templates/shooter/src/weapons/Projectile.ts +0 -92
- package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
- package/templates/starter/playtests/assets.playtest.json +0 -65
- package/templates/starter/playtests/buffer.playtest.json +0 -79
- package/templates/starter/playtests/cloth.playtest.json +0 -113
- package/templates/starter/playtests/coyote.playtest.json +0 -87
- package/templates/starter/playtests/gameover.playtest.json +0 -66
- package/templates/starter/playtests/goal.playtest.json +0 -67
- package/templates/starter/playtests/look.playtest.json +0 -175
- package/templates/starter/playtests/models-baseline.png +0 -0
- package/templates/starter/playtests/models.playtest.json +0 -74
- package/templates/starter/playtests/monitoring.playtest.json +0 -72
- package/templates/starter/playtests/odometer.playtest.json +0 -54
- package/templates/starter/playtests/restart.playtest.json +0 -91
- package/templates/starter/playtests/seed.playtest.json +0 -54
- package/templates/starter/playtests/textures-baseline.png +0 -0
- package/templates/starter/playtests/textures.playtest.json +0 -74
- package/templates/starter/playtests/touch-controls.playtest.json +0 -42
- package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
- package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
- package/templates/starter/src/render/coast.ts +0 -199
- package/templates/starter/src/render/hero.ts +0 -88
- package/templates/starter/src/render/implicitSurface.ts +0 -199
- package/templates/starter/src/render/kuwahara.ts +0 -174
- package/templates/starter/src/render/outline.ts +0 -141
- package/templates/starter/src/render/painterly.ts +0 -86
- package/templates/starter/src/render/rockRidge.ts +0 -198
- package/templates/starter/src/render/rockRidge.worker.ts +0 -77
- package/templates/starter/src/render/scenery.ts +0 -40
- package/templates/starter/src/render/textureLifetime.ts +0 -53
- package/templates/starter/src/render/water.ts +0 -38
- package/templates/starter/src/render/watercolor.ts +0 -85
- /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
- /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
- /package/templates/{defense → rts}/.codex/config.toml +0 -0
- /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
- /package/templates/{defense → rts}/.gemini/settings.json +0 -0
- /package/templates/{defense → rts}/.mcp.json +0 -0
- /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
- /package/templates/{defense → rts}/.zed/settings.json +0 -0
- /package/templates/{defense → rts}/index.html +0 -0
- /package/templates/{defense → rts}/opencode.json +0 -0
- /package/templates/{defense → rts}/src/main.ts +0 -0
- /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
- /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
- /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
- /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
- /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
- /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
- /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
|
@@ -1,47 +1,32 @@
|
|
|
1
|
-
|
|
1
|
+
/** One soldier's dot on the minimap; `id` is that soldier's slot, so React can keep the node. */
|
|
2
|
+
export type Blip = { id: number; x: number; z: number; alive: boolean };
|
|
2
3
|
|
|
3
4
|
export type GameState = {
|
|
4
|
-
|
|
5
|
-
paused: boolean;
|
|
6
|
-
/** True once the UI layer has rendered and published its interactive rectangles. */
|
|
7
|
-
uiReady: boolean;
|
|
8
|
-
aimedShots: number;
|
|
9
|
-
aiming: number;
|
|
10
|
-
/** Rounds in the magazine, and in reserve. The HUD reads both; a scenario asserts them. */
|
|
5
|
+
aiming: boolean;
|
|
11
6
|
ammo: number;
|
|
12
|
-
|
|
13
|
-
reloading: number;
|
|
14
|
-
armor: number;
|
|
15
|
-
cameraShakes: number;
|
|
16
|
-
deaths: number;
|
|
17
|
-
demoDamage: number;
|
|
18
|
-
demoTargetAlive: number;
|
|
19
|
-
friendlyPassed: number;
|
|
20
|
-
gameOver: number;
|
|
21
|
-
gameWon: number;
|
|
7
|
+
distanceMoved: number;
|
|
22
8
|
health: number;
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
radiusInsideDeaths: number;
|
|
34
|
-
radiusMidAlive: number;
|
|
35
|
-
radiusNearAlive: number;
|
|
36
|
-
radiusOutsideAlive: number;
|
|
37
|
-
respawns: number;
|
|
38
|
-
scanCount: number;
|
|
9
|
+
hitFlash: number;
|
|
10
|
+
/**
|
|
11
|
+
* Red damage vignette, 1 on the frame a round lands and decaying to 0 over about a third of a
|
|
12
|
+
* second. Published as a scalar rather than derived from `health` so "am I being shot" and "am
|
|
13
|
+
* I nearly dead" are two different facts, and the player gets the first one.
|
|
14
|
+
*/
|
|
15
|
+
hurtFlash: number;
|
|
16
|
+
phase: "playing" | "complete" | "failed";
|
|
17
|
+
reloads: number;
|
|
18
|
+
reserve: number;
|
|
39
19
|
score: number;
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
20
|
+
shots: number;
|
|
21
|
+
targetsHit: number;
|
|
22
|
+
timeRemaining: number;
|
|
23
|
+
/** Player ground position and facing, for the minimap. */
|
|
24
|
+
playerX: number;
|
|
25
|
+
playerZ: number;
|
|
26
|
+
playerYaw: number;
|
|
27
|
+
/** Enemy positions for the minimap, one entry per soldier. */
|
|
28
|
+
blips: Blip[];
|
|
47
29
|
};
|
|
30
|
+
|
|
31
|
+
/** Shared objective contract for the scene and the HUD. */
|
|
32
|
+
export const TARGET_GOAL = 12;
|
|
@@ -1,31 +1,209 @@
|
|
|
1
|
+
@import "tailwindcss";
|
|
2
|
+
|
|
3
|
+
/*
|
|
4
|
+
* Sources declared explicitly rather than left to automatic detection. When
|
|
5
|
+
* Tailwind finds no sources it still builds successfully — it emits the @theme
|
|
6
|
+
* variables and zero utilities, so every class name in src/ui/ becomes an inert
|
|
7
|
+
* string with no error anywhere to explain it. Being explicit makes that
|
|
8
|
+
* failure impossible rather than merely unlikely.
|
|
9
|
+
*/
|
|
10
|
+
@source "../index.html";
|
|
11
|
+
@source "./";
|
|
12
|
+
|
|
13
|
+
/*
|
|
14
|
+
* Your palette. Every name here becomes a real Tailwind utility — `bg-ink`,
|
|
15
|
+
* `text-lume`, `border-line` — so the HUD reads in game terms instead of
|
|
16
|
+
* `bg-slate-950`. Rename them, add to them, or delete the block and use
|
|
17
|
+
* Tailwind's defaults. Nothing in @threenative/* reads this.
|
|
18
|
+
*/
|
|
19
|
+
@theme {
|
|
20
|
+
--color-ink: #04080d;
|
|
21
|
+
--color-panel: #0d1c26;
|
|
22
|
+
--color-line: #14313f;
|
|
23
|
+
--color-lume: #6fe8ff;
|
|
24
|
+
--color-warn: #ffd27a;
|
|
25
|
+
--color-text: #a8ccd8;
|
|
26
|
+
--color-dim: #4e7686;
|
|
27
|
+
|
|
28
|
+
--font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/*
|
|
32
|
+
* `100dvh`, not `100%`.
|
|
33
|
+
*
|
|
34
|
+
* `height: 100%` resolves against the initial containing block, which on mobile Chrome is the
|
|
35
|
+
* *large* viewport — the one that counts the space behind the retractable URL bar. Measured on a
|
|
36
|
+
* Pixel 8: the canvas came out 411x840 while only 784 px of it was ever on the glass. Two things
|
|
37
|
+
* broke because of it. The canvas rendered 56 rows of pixels nobody could see, and every
|
|
38
|
+
* `bottom-*` anchored HUD element — the ammo counter among them — sat below the fold.
|
|
39
|
+
*
|
|
40
|
+
* `100dvh` is the viewport as it is right now, so the canvas matches the glass, the crosshair sits
|
|
41
|
+
* at the centre of what you can see, and the bottom cluster is on screen. `overflow: hidden` keeps
|
|
42
|
+
* the page unscrollable, so the URL bar does not retract and this does not thrash the resize.
|
|
43
|
+
*/
|
|
1
44
|
html,
|
|
2
45
|
body,
|
|
3
46
|
#root {
|
|
4
47
|
width: 100%;
|
|
5
48
|
height: 100%;
|
|
49
|
+
height: 100dvh;
|
|
6
50
|
margin: 0;
|
|
7
51
|
overflow: hidden;
|
|
8
52
|
}
|
|
9
53
|
|
|
54
|
+
/*
|
|
55
|
+
* The backdrop belongs to the web document's own mount point, never to `body`: `src/ui/main.tsx`
|
|
56
|
+
* imports this stylesheet, and on native that file is what the transparent web view loads over the
|
|
57
|
+
* game, where a `body` background is an opaque sheet over the frame just rendered.
|
|
58
|
+
*/
|
|
59
|
+
#root {
|
|
60
|
+
background: var(--color-ink);
|
|
61
|
+
}
|
|
62
|
+
|
|
10
63
|
body {
|
|
11
|
-
color:
|
|
12
|
-
font-family:
|
|
64
|
+
color: var(--color-text);
|
|
65
|
+
font-family: var(--font-mono);
|
|
13
66
|
-webkit-font-smoothing: antialiased;
|
|
14
67
|
}
|
|
15
68
|
|
|
16
69
|
/*
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
* the frame the game just rendered, and the HUD appears to float on nothing. `#root` exists only
|
|
21
|
-
* in the web page, so the backdrop stays where it belongs and the UI layer stays see-through.
|
|
70
|
+
* No mouse cursor over the game. Pointer lock hides it while it is engaged, but the cursor is
|
|
71
|
+
* visible before the first click and every time the player presses Escape — an arrow sitting on
|
|
72
|
+
* top of a crosshair in a first-person shooter reads as an unfinished game.
|
|
22
73
|
*/
|
|
74
|
+
html,
|
|
75
|
+
body,
|
|
76
|
+
canvas {
|
|
77
|
+
cursor: none;
|
|
78
|
+
}
|
|
23
79
|
|
|
24
|
-
|
|
25
|
-
|
|
80
|
+
/*
|
|
81
|
+
* Thumb controls, and the desktop legend they replace.
|
|
82
|
+
*
|
|
83
|
+
* Gated on `pointer: coarse` rather than on a width breakpoint: a narrow desktop window is still a
|
|
84
|
+
* mouse, and a tablet in landscape is still a thumb. Width would get both of those wrong.
|
|
85
|
+
*/
|
|
86
|
+
.touch-only,
|
|
87
|
+
.touch-show {
|
|
88
|
+
display: none;
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
@media (pointer: coarse) {
|
|
92
|
+
.touch-only {
|
|
93
|
+
display: block;
|
|
94
|
+
/*
|
|
95
|
+
* The root is already `100dvh`; the remaining job is the gesture bar, which overlays the
|
|
96
|
+
* bottom of the viewport and would otherwise swallow the fire button's lower edge.
|
|
97
|
+
*/
|
|
98
|
+
height: calc(100% - env(safe-area-inset-bottom, 0px));
|
|
99
|
+
bottom: auto;
|
|
100
|
+
}
|
|
101
|
+
/*
|
|
102
|
+
* `.touch-only` carries the full-surface sizing the thumb overlay needs. `.touch-show` is just
|
|
103
|
+
* the visibility half of it, for controls that live inside somebody else's layout — a button in
|
|
104
|
+
* a centred flex column must not also be told it is 100% tall.
|
|
105
|
+
*/
|
|
106
|
+
.touch-show {
|
|
107
|
+
display: block;
|
|
108
|
+
}
|
|
109
|
+
.desktop-only {
|
|
110
|
+
display: none;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/*
|
|
114
|
+
* The HUD was laid out against a 1280x720 desktop window. On a 411 px phone the same pixel
|
|
115
|
+
* sizes are roughly three times the share of the screen they were designed to take: the 180 px
|
|
116
|
+
* minimap covered 44% of the width and sat on top of the roster, the clock and the objective
|
|
117
|
+
* line, and in landscape it covered the left thumb's stick band entirely.
|
|
118
|
+
*
|
|
119
|
+
* Scaled rather than re-laid-out, because the composition is right — it is only ever asked to
|
|
120
|
+
* be too big. Each cluster scales about the corner it is anchored to, so nothing drifts off an
|
|
121
|
+
* edge, and the touch controls are deliberately NOT scaled: their sizes are thumb dimensions,
|
|
122
|
+
* not layout dimensions, and a thumb is the same size on every phone.
|
|
123
|
+
*/
|
|
124
|
+
.hud-minimap {
|
|
125
|
+
height: 108px;
|
|
126
|
+
width: 108px;
|
|
127
|
+
}
|
|
128
|
+
/*
|
|
129
|
+
* `scale` alone, with no translate of its own. Tailwind 4 centres these with the standalone
|
|
130
|
+
* `translate` property, not with `transform`, and the two compose — an extra `translateX(-50%)`
|
|
131
|
+
* here shifted the whole roster half its own width off the left edge of the screen.
|
|
132
|
+
*/
|
|
133
|
+
.hud-top {
|
|
134
|
+
transform: scale(0.78);
|
|
135
|
+
transform-origin: top center;
|
|
136
|
+
}
|
|
137
|
+
.hud-bottom {
|
|
138
|
+
transform: scale(0.74);
|
|
139
|
+
transform-origin: bottom center;
|
|
140
|
+
}
|
|
141
|
+
.hud-corner {
|
|
142
|
+
transform: scale(0.8);
|
|
143
|
+
transform-origin: bottom left;
|
|
144
|
+
}
|
|
26
145
|
}
|
|
27
146
|
|
|
28
|
-
/*
|
|
147
|
+
/*
|
|
148
|
+
* A phone in portrait is 411 px wide, and three things want the same corners.
|
|
149
|
+
*
|
|
150
|
+
* The roster row spans almost the full width even scaled, so the immersive button sat on top of
|
|
151
|
+
* the fifth chip; it drops below the row instead. And the bottom cluster is centred, which on a
|
|
152
|
+
* surface this narrow puts the ammo readout underneath the fire button — a number you cannot read
|
|
153
|
+
* because your thumb is on it. Nudging the cluster left of the fire circle is enough; it clears
|
|
154
|
+
* the move ring vertically, so nothing else has to move.
|
|
155
|
+
*/
|
|
156
|
+
@media (pointer: coarse) and (max-width: 520px) {
|
|
157
|
+
.hud-immersive {
|
|
158
|
+
top: 46px;
|
|
159
|
+
}
|
|
160
|
+
.hud-bottom {
|
|
161
|
+
transform: translateX(-25%) scale(0.66);
|
|
162
|
+
}
|
|
163
|
+
/*
|
|
164
|
+
* The money chip goes. It is a hardcoded `$10000` placeholder with no gameplay behind it, and on
|
|
165
|
+
* a 411 px surface it lands underneath the armour badge — two numbers overlapping, one of them
|
|
166
|
+
* fiction. The key legend in the same corner is already hidden here, so this empties the block.
|
|
167
|
+
*/
|
|
168
|
+
.hud-corner {
|
|
169
|
+
display: none;
|
|
170
|
+
}
|
|
171
|
+
}
|
|
172
|
+
|
|
173
|
+
/*
|
|
174
|
+
* A phone held in landscape gives the game 303 px of height in Chrome, and the game-over card,
|
|
175
|
+
* the credits and the objective line all shared that space with the fight. Below 420 px the
|
|
176
|
+
* overlay drops to a single tight column.
|
|
177
|
+
*/
|
|
178
|
+
@media (pointer: coarse) and (max-height: 420px) {
|
|
179
|
+
.hud-top {
|
|
180
|
+
transform: scale(0.62);
|
|
181
|
+
}
|
|
182
|
+
.hud-bottom {
|
|
183
|
+
transform: scale(0.62);
|
|
184
|
+
}
|
|
185
|
+
.hud-minimap {
|
|
186
|
+
height: 92px;
|
|
187
|
+
width: 92px;
|
|
188
|
+
}
|
|
189
|
+
/*
|
|
190
|
+
* The stick hint is 148 px across, which is half the height of a phone held sideways in Chrome.
|
|
191
|
+
* At that size it collided with the minimap in the top-left and read as clutter rather than as
|
|
192
|
+
* a resting place. The stick itself still floats to wherever the thumb lands, so shrinking the
|
|
193
|
+
* ring costs no reach — only the drawn hint gets smaller.
|
|
194
|
+
*/
|
|
195
|
+
.stick-hint {
|
|
196
|
+
bottom: 56px !important;
|
|
197
|
+
height: 104px !important;
|
|
198
|
+
width: 104px !important;
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
|
|
202
|
+
/*
|
|
203
|
+
* The boot-failure surface. The engine sets this attribute on the canvas when the
|
|
204
|
+
* renderer cannot start at all, and the message it carries is the only thing on screen.
|
|
205
|
+
* Generated source: restyle it freely, delete it if your game never fails to boot.
|
|
206
|
+
*/
|
|
29
207
|
[data-threenative-canvas-error="true"] {
|
|
30
208
|
position: fixed;
|
|
31
209
|
inset: 0;
|
|
@@ -36,7 +214,7 @@ body {
|
|
|
36
214
|
padding: clamp(1.5rem, 8vw, 6rem);
|
|
37
215
|
overflow: auto;
|
|
38
216
|
background: #fff7ed;
|
|
39
|
-
color:
|
|
217
|
+
color: var(--color-ink);
|
|
40
218
|
font-family: inherit;
|
|
41
219
|
font-size: clamp(1rem, 2vw, 1.5rem);
|
|
42
220
|
line-height: 1.5;
|
|
@@ -44,3 +222,21 @@ body {
|
|
|
44
222
|
white-space: pre-wrap;
|
|
45
223
|
overflow-wrap: anywhere;
|
|
46
224
|
}
|
|
225
|
+
|
|
226
|
+
/* The debug surface is framework plumbing; its default presentation is yours to change. */
|
|
227
|
+
[data-threenative-debug-overlay="true"] {
|
|
228
|
+
position: fixed;
|
|
229
|
+
top: 1rem;
|
|
230
|
+
right: 1rem;
|
|
231
|
+
z-index: 50;
|
|
232
|
+
max-width: 24rem;
|
|
233
|
+
padding: 0.75rem;
|
|
234
|
+
pointer-events: none;
|
|
235
|
+
background: rgb(4 8 13 / 90%);
|
|
236
|
+
color: #6fe8ff;
|
|
237
|
+
font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
|
|
238
|
+
font-size: 0.75rem;
|
|
239
|
+
line-height: 1.4;
|
|
240
|
+
white-space: pre-wrap;
|
|
241
|
+
overflow-wrap: anywhere;
|
|
242
|
+
}
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
import type { Material, Mesh, Object3D } from "three";
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* One impact-surface vocabulary for every consumer of a bullet hit: the audio
|
|
5
|
+
* team picks its impact voice with it, the VFX team styles its burst with it,
|
|
6
|
+
* and decals will read it later. The values are game content and live only
|
|
7
|
+
* here.
|
|
8
|
+
*
|
|
9
|
+
* The flow is one tag, resolved once: the world builder stamps every hittable
|
|
10
|
+
* mesh with `userData.surface` at construction (`tagSurfaces`), and any
|
|
11
|
+
* consumer calls `resolveSurface(hit.object)` instead of re-deriving
|
|
12
|
+
* name tables of its own. Nothing downstream walks mesh names any more.
|
|
13
|
+
*/
|
|
14
|
+
export type ImpactSurface = "plaster" | "wood" | "steel" | "stone";
|
|
15
|
+
|
|
16
|
+
/** Every legal value, so a stale or foreign tag is checked before trusted. */
|
|
17
|
+
const SURFACES: readonly ImpactSurface[] = ["plaster", "wood", "steel", "stone"];
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* What an untagged mesh answers: whitewash plaster — the dominant wall in the
|
|
21
|
+
* town and the honest default. The plaster/brick building shells are
|
|
22
|
+
* world-projected per-mesh materials, so they cannot be tabled by identity;
|
|
23
|
+
* they land here rather than in a table row.
|
|
24
|
+
*/
|
|
25
|
+
export const DEFAULT_SURFACE: ImpactSurface = "plaster";
|
|
26
|
+
|
|
27
|
+
/**
|
|
28
|
+
* Mesh-name rules. Fallback ONLY, for meshes nobody tagged at construction —
|
|
29
|
+
* dynamic props or proxies dropped into a scene by code that never heard of
|
|
30
|
+
* surfaces. Every mesh the world builder makes is tagged before play starts
|
|
31
|
+
* and never consults these.
|
|
32
|
+
*/
|
|
33
|
+
const NAME_RULES: readonly (readonly [RegExp, ImpactSurface])[] = [
|
|
34
|
+
[/crate|deck|pier|rail|stair/, "wood"],
|
|
35
|
+
[/barrel|bollard|post|mast|tank|roller|shutter/, "steel"],
|
|
36
|
+
[/quay|plaza|ground/, "stone"],
|
|
37
|
+
];
|
|
38
|
+
|
|
39
|
+
/**
|
|
40
|
+
* Town-material member → what a bullet hears when it lands there. Used once,
|
|
41
|
+
* at construction, to stamp the tag onto every mesh wearing the material —
|
|
42
|
+
* shared palette materials mean one row covers hundreds of meshes. Members
|
|
43
|
+
* left out (water, shallows, fronds) have no honest cue of their own and fall
|
|
44
|
+
* through to the default.
|
|
45
|
+
*/
|
|
46
|
+
const PALETTE_SURFACES: Readonly<Record<string, ImpactSurface>> = {
|
|
47
|
+
ground: "stone",
|
|
48
|
+
dadoBand: "plaster",
|
|
49
|
+
plasterTrim: "plaster",
|
|
50
|
+
brickTrim: "plaster",
|
|
51
|
+
doorBlue: "wood",
|
|
52
|
+
shutter: "wood",
|
|
53
|
+
rollerSteel: "steel",
|
|
54
|
+
awningCanvas: "plaster",
|
|
55
|
+
awningStripe: "plaster",
|
|
56
|
+
crate: "wood",
|
|
57
|
+
deckWood: "wood",
|
|
58
|
+
barrel: "steel",
|
|
59
|
+
palmTrunk: "wood",
|
|
60
|
+
siteMark: "stone",
|
|
61
|
+
plateFace: "steel",
|
|
62
|
+
plateHit: "steel",
|
|
63
|
+
plateFrame: "steel",
|
|
64
|
+
steel: "steel",
|
|
65
|
+
steelPost: "steel",
|
|
66
|
+
steelMast: "steel",
|
|
67
|
+
tankDark: "steel",
|
|
68
|
+
quay: "stone",
|
|
69
|
+
plazaWarm: "stone",
|
|
70
|
+
plazaCool: "stone",
|
|
71
|
+
plazaPale: "stone",
|
|
72
|
+
};
|
|
73
|
+
|
|
74
|
+
/** The name-rule half of the derivation, shared by both paths below. */
|
|
75
|
+
const surfaceFromName = (name: string): ImpactSurface | undefined => {
|
|
76
|
+
for (const [pattern, surface] of NAME_RULES) {
|
|
77
|
+
if (pattern.test(name)) return surface;
|
|
78
|
+
}
|
|
79
|
+
return undefined;
|
|
80
|
+
};
|
|
81
|
+
|
|
82
|
+
/**
|
|
83
|
+
* What a struck object answers as: its construction-time tag if it has one,
|
|
84
|
+
* else the name rules, else the default. The only surface lookup consumers
|
|
85
|
+
* should ever perform.
|
|
86
|
+
*/
|
|
87
|
+
export const resolveSurface = (object: Object3D): ImpactSurface => {
|
|
88
|
+
const tagged: unknown = object.userData?.surface;
|
|
89
|
+
if (SURFACES.includes(tagged as ImpactSurface)) return tagged as ImpactSurface;
|
|
90
|
+
return surfaceFromName(object.name) ?? DEFAULT_SURFACE;
|
|
91
|
+
};
|
|
92
|
+
|
|
93
|
+
/** Stamp the tag one mesh will answer bullets as. Builders call this. */
|
|
94
|
+
export const tagSurface = (object: Object3D, surface: ImpactSurface): void => {
|
|
95
|
+
object.userData.surface = surface;
|
|
96
|
+
};
|
|
97
|
+
|
|
98
|
+
/**
|
|
99
|
+
* Tag every hittable mesh with the surface it answers as. Called once by the
|
|
100
|
+
* world builder after the last merge, when every mesh exists carrying its
|
|
101
|
+
* final material — the merged facade batches included.
|
|
102
|
+
*
|
|
103
|
+
* Per mesh the priority is the one the old per-shot resolver used, so tags
|
|
104
|
+
* match what hits resolved to before tagging existed: a name rule first (a
|
|
105
|
+
* mesh called "crate" is wood whatever it wears), then palette identity off
|
|
106
|
+
* the mesh's first material, then the default.
|
|
107
|
+
*/
|
|
108
|
+
export const tagSurfaces = (meshes: readonly Mesh[], palette: object): void => {
|
|
109
|
+
const byMaterial = new Map<Material, ImpactSurface>();
|
|
110
|
+
const members = palette as Record<string, unknown>;
|
|
111
|
+
for (const [key, surface] of Object.entries(PALETTE_SURFACES)) {
|
|
112
|
+
const value = members[key];
|
|
113
|
+
if (
|
|
114
|
+
typeof value === "object" &&
|
|
115
|
+
value !== null &&
|
|
116
|
+
(value as { isMaterial?: boolean }).isMaterial === true
|
|
117
|
+
) {
|
|
118
|
+
byMaterial.set(value as Material, surface);
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
for (const mesh of meshes) {
|
|
122
|
+
// Only meshes carry a material; every hittable here is one.
|
|
123
|
+
const meshMaterial = mesh.material;
|
|
124
|
+
const first = Array.isArray(meshMaterial) ? meshMaterial[0] : meshMaterial;
|
|
125
|
+
const surface =
|
|
126
|
+
surfaceFromName(mesh.name) ??
|
|
127
|
+
(first === undefined ? undefined : byMaterial.get(first)) ??
|
|
128
|
+
DEFAULT_SURFACE;
|
|
129
|
+
tagSurface(mesh, surface);
|
|
130
|
+
}
|
|
131
|
+
};
|
|
@@ -1,21 +1,20 @@
|
|
|
1
1
|
import type { IGame } from "@threenative/core";
|
|
2
2
|
import type { IPhysicsContext } from "@threenative/physics";
|
|
3
3
|
import { DebugOverlay, GameCanvas } from "@threenative/ui";
|
|
4
|
-
import { shooterUi } from "../render/ui.js";
|
|
5
4
|
import type { GameState } from "../state.js";
|
|
6
5
|
import { GameUi } from "./GameUi.js";
|
|
7
6
|
|
|
8
|
-
/**
|
|
9
|
-
* The web target's page: the canvas, then the same UI every other target renders.
|
|
10
|
-
*
|
|
11
|
-
* `GameCanvas` hosts the renderer and everything after it paints on top; keep the canvas first.
|
|
12
|
-
* The UI itself comes from `GameUi`, unchanged — this file exists only because the web build also
|
|
13
|
-
* has to put a canvas on the page.
|
|
14
|
-
*/
|
|
15
7
|
export function App({ game }: { game: IGame<GameState, IPhysicsContext> }) {
|
|
16
8
|
return (
|
|
17
|
-
|
|
18
|
-
|
|
9
|
+
// GameCanvas hosts the renderer; everything after it in this list paints on
|
|
10
|
+
// top. Keep the canvas first.
|
|
11
|
+
// `h-full`, not `h-screen`: `100vh` on mobile Chrome is the tall viewport behind the URL bar,
|
|
12
|
+
// which sized the canvas 56 px taller than the glass on a Pixel 8 — pixels rendered for nobody,
|
|
13
|
+
// and a crosshair 28 px below the centre of what the player can see. `#root` is `100dvh`.
|
|
14
|
+
<main className="relative h-full w-full overflow-hidden bg-ink">
|
|
15
|
+
<GameCanvas className="absolute inset-0" game={game} />
|
|
16
|
+
{/* The same tree the web view loads on native, so the browser is not a second UI to keep
|
|
17
|
+
in step — it is the same one, reached through the same bridge. */}
|
|
19
18
|
<GameUi />
|
|
20
19
|
<DebugOverlay />
|
|
21
20
|
</main>
|
|
@@ -1,25 +1,32 @@
|
|
|
1
|
-
import {
|
|
2
|
-
|
|
3
|
-
|
|
1
|
+
import type { ComponentType, ReactNode } from "react";
|
|
2
|
+
|
|
3
|
+
export type CrosshairPart = "root" | "vertical" | "horizontal";
|
|
4
|
+
|
|
5
|
+
export interface ICrosshairPrimitiveProps {
|
|
6
|
+
readonly children?: ReactNode;
|
|
7
|
+
readonly hidden: boolean;
|
|
8
|
+
readonly hitFlash: number;
|
|
9
|
+
readonly part: CrosshairPart;
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
export interface ICrosshairProps {
|
|
13
|
+
readonly aiming: boolean;
|
|
14
|
+
readonly hitFlash: number;
|
|
15
|
+
readonly Primitive: ComponentType<ICrosshairPrimitiveProps>;
|
|
16
|
+
}
|
|
4
17
|
|
|
5
18
|
/**
|
|
6
|
-
* The
|
|
7
|
-
*
|
|
8
|
-
* Two bars with a gap, not a dot: the gap is where the round goes, and it is the only part of a
|
|
9
|
-
* first-person HUD the player actually looks at. It disappears down the sights, because the optic
|
|
10
|
-
* on the weapon is the sight at that point and two reticles read as a bug.
|
|
19
|
+
* The gameplay crosshair shared by the DOM and CanvasLayer React renderers.
|
|
11
20
|
*
|
|
12
|
-
*
|
|
13
|
-
*
|
|
14
|
-
*
|
|
21
|
+
* The component owns when the reticle exists and its two-bar structure. Each renderer supplies
|
|
22
|
+
* only the platform primitive that paints a root or bar, because DOM classes cannot execute on the
|
|
23
|
+
* native host and CanvasLayer styles are not CSS.
|
|
15
24
|
*/
|
|
16
|
-
export function Crosshair() {
|
|
17
|
-
const state = useUiState<GameState>();
|
|
18
|
-
if (state === undefined || state.phase !== "playing") return null;
|
|
25
|
+
export function Crosshair({ aiming, hitFlash, Primitive }: ICrosshairProps) {
|
|
19
26
|
return (
|
|
20
|
-
<
|
|
21
|
-
<
|
|
22
|
-
<
|
|
23
|
-
</
|
|
27
|
+
<Primitive hidden={aiming} hitFlash={hitFlash} part="root">
|
|
28
|
+
<Primitive hidden={aiming} hitFlash={hitFlash} part="vertical" />
|
|
29
|
+
<Primitive hidden={aiming} hitFlash={hitFlash} part="horizontal" />
|
|
30
|
+
</Primitive>
|
|
24
31
|
);
|
|
25
32
|
}
|
|
@@ -1,22 +1,19 @@
|
|
|
1
1
|
import { UiLayer } from "@threenative/ui";
|
|
2
|
-
import { Crosshair } from "./Crosshair.js";
|
|
3
2
|
import { Hud } from "./Hud.js";
|
|
4
|
-
import { Menu } from "./Menu.js";
|
|
5
3
|
|
|
6
4
|
/**
|
|
7
|
-
* Everything the player sees that is not the
|
|
5
|
+
* Everything the player sees that is not the rendered frame.
|
|
8
6
|
*
|
|
9
|
-
*
|
|
10
|
-
*
|
|
11
|
-
*
|
|
12
|
-
*
|
|
7
|
+
* `UiLayer` is what connects this tree to the game: it opens the bridge, mirrors published state,
|
|
8
|
+
* and publishes the rectangles of every `data-tn-interactive` element so the host knows which
|
|
9
|
+
* presses belong to the UI and which fall through to the game. There is no `game` prop anywhere
|
|
10
|
+
* below it — on native this whole tree runs in the platform's web view, in a different process
|
|
11
|
+
* from the scene, and reaches the game only through state and intents.
|
|
13
12
|
*/
|
|
14
13
|
export function GameUi() {
|
|
15
14
|
return (
|
|
16
15
|
<UiLayer>
|
|
17
|
-
<Crosshair />
|
|
18
16
|
<Hud />
|
|
19
|
-
<Menu />
|
|
20
17
|
</UiLayer>
|
|
21
18
|
);
|
|
22
19
|
}
|