create-threenative 0.2.6 → 0.2.8

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.
Files changed (756) hide show
  1. package/README.md +5 -3
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +607 -26
  4. package/agent-docs/references/performance-basics.md +8 -5
  5. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  6. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  7. package/agent-docs/references/visual-baseline.md +8 -4
  8. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
  10. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
  12. package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
  13. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  14. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  15. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  16. package/capabilities.json +801 -24
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +300 -56
  19. package/dist/threenative.js +717 -156
  20. package/package.json +6 -6
  21. package/template-assets/assets/mannequin-combat.glb +0 -0
  22. package/template-assets/assets/mannequin.glb +0 -0
  23. package/template-assets/assets/player-viewmodel.glb +0 -0
  24. package/template-assets/assets/sky.jpg +0 -0
  25. package/template-assets/clearwater/README.md +141 -0
  26. package/template-assets/clearwater/install.mjs +50 -0
  27. package/template-assets/clearwater/src/clearwater.ts +180 -0
  28. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  29. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  30. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  31. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  32. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  33. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  34. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  35. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  36. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  37. package/template-assets/patches/three@0.185.1.patch +2101 -138
  38. package/template-assets/worldEnvironment.ts +52 -1
  39. package/templates/action-rpg/AGENTS.md +42 -42
  40. package/templates/action-rpg/CLAUDE.md +42 -42
  41. package/templates/action-rpg/kit.json +1 -1
  42. package/templates/action-rpg/package.json +13 -7
  43. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  44. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  45. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  46. package/templates/action-rpg/src/conventions.ts +24 -18
  47. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  48. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  49. package/templates/action-rpg/src/entities/Player.ts +102 -32
  50. package/templates/action-rpg/src/game.ts +3 -3
  51. package/templates/action-rpg/src/render/camera.ts +18 -16
  52. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  53. package/templates/action-rpg/src/render/lighting.ts +45 -28
  54. package/templates/action-rpg/src/render/loading.ts +4 -4
  55. package/templates/action-rpg/src/render/materials.ts +191 -47
  56. package/templates/action-rpg/src/render/palette.ts +14 -13
  57. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  58. package/templates/action-rpg/src/render/props.ts +117 -0
  59. package/templates/action-rpg/src/render/quality.ts +40 -82
  60. package/templates/action-rpg/src/render/sky.ts +36 -13
  61. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  62. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  63. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  64. package/templates/action-rpg/src/style.css +9 -7
  65. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  66. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  67. package/templates/action-rpg/threenative.config.ts +14 -1
  68. package/templates/action-rpg/vite.config.ts +4 -1
  69. package/templates/minimal/AGENTS.md +10 -10
  70. package/templates/minimal/CLAUDE.md +10 -10
  71. package/templates/minimal/package.json +12 -6
  72. package/templates/minimal/playtests/play.playtest.json +6 -5
  73. package/templates/minimal/playtests/sky.playtest.json +27 -0
  74. package/templates/minimal/src/conventions.ts +6 -3
  75. package/templates/minimal/src/entities/Player.ts +73 -27
  76. package/templates/minimal/src/main.ts +2 -3
  77. package/templates/minimal/src/render/camera.ts +22 -4
  78. package/templates/minimal/src/render/lighting.ts +24 -48
  79. package/templates/minimal/src/render/materials.ts +158 -13
  80. package/templates/minimal/src/render/palette.ts +10 -7
  81. package/templates/minimal/src/render/postprocessing.ts +12 -25
  82. package/templates/minimal/src/render/quality.ts +35 -69
  83. package/templates/minimal/src/render/sky.ts +35 -54
  84. package/templates/minimal/src/render/touch-controls.ts +1 -1
  85. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  86. package/templates/minimal/src/scenes/Play.ts +121 -111
  87. package/templates/minimal/src/state.ts +0 -4
  88. package/templates/minimal/src/style.css +0 -10
  89. package/templates/minimal/threenative.config.ts +14 -1
  90. package/templates/minimal/vite.config.ts +4 -1
  91. package/templates/platformer/AGENTS.md +18 -56
  92. package/templates/platformer/CLAUDE.md +18 -56
  93. package/templates/platformer/kit.json +2 -2
  94. package/templates/platformer/package.json +13 -9
  95. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  96. package/templates/platformer/playtests/collect.playtest.json +8 -34
  97. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  98. package/templates/platformer/playtests/damage.playtest.json +40 -15
  99. package/templates/platformer/playtests/hud.playtest.json +34 -0
  100. package/templates/platformer/playtests/move.playtest.json +24 -0
  101. package/templates/platformer/playtests/performance.playtest.json +24 -7
  102. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  103. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  104. package/templates/platformer/playtests/survives.playtest.json +3 -19
  105. package/templates/platformer/playtests/world.playtest.json +26 -0
  106. package/templates/platformer/src/entities/Fox.ts +273 -0
  107. package/templates/platformer/src/entities/Pickup.ts +43 -60
  108. package/templates/platformer/src/entities/Walker.ts +88 -0
  109. package/templates/platformer/src/game.ts +11 -8
  110. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  111. package/templates/platformer/src/level/Stage.ts +469 -0
  112. package/templates/platformer/src/render/blocks.ts +94 -0
  113. package/templates/platformer/src/render/camera.ts +28 -3
  114. package/templates/platformer/src/render/fox.ts +196 -0
  115. package/templates/platformer/src/render/lighting.ts +42 -33
  116. package/templates/platformer/src/render/materials.ts +115 -5
  117. package/templates/platformer/src/render/palette.ts +68 -53
  118. package/templates/platformer/src/render/pickups.ts +142 -0
  119. package/templates/platformer/src/render/postprocessing.ts +12 -2
  120. package/templates/platformer/src/render/props.ts +147 -0
  121. package/templates/platformer/src/render/quality.ts +47 -99
  122. package/templates/platformer/src/render/scenery.ts +172 -0
  123. package/templates/platformer/src/render/sky.ts +120 -31
  124. package/templates/platformer/src/render/touch-controls.ts +5 -2
  125. package/templates/platformer/src/render/walkers.ts +96 -0
  126. package/templates/platformer/src/render/waterfall.ts +85 -0
  127. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  128. package/templates/platformer/src/scenes/Boot.ts +3 -4
  129. package/templates/platformer/src/scenes/Play.ts +362 -0
  130. package/templates/platformer/src/state.ts +16 -14
  131. package/templates/platformer/src/style.css +9 -8
  132. package/templates/platformer/src/ui/Hud.tsx +62 -29
  133. package/templates/platformer/src/ui/Menu.tsx +2 -2
  134. package/templates/platformer/threenative.config.ts +14 -1
  135. package/templates/platformer/vite.config.ts +4 -1
  136. package/templates/puzzle/AGENTS.md +19 -20
  137. package/templates/puzzle/CLAUDE.md +19 -20
  138. package/templates/puzzle/assets/native-proof.glb +0 -0
  139. package/templates/puzzle/assets/native-proof.png +0 -0
  140. package/templates/puzzle/kit.json +1 -1
  141. package/templates/puzzle/package.json +13 -7
  142. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  143. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  144. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  145. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  146. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  147. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  148. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  149. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  150. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  151. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  152. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  153. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  154. package/templates/puzzle/src/entities/Crate.ts +99 -42
  155. package/templates/puzzle/src/entities/Seal.ts +69 -0
  156. package/templates/puzzle/src/entities/Warden.ts +135 -0
  157. package/templates/puzzle/src/game.ts +15 -11
  158. package/templates/puzzle/src/render/camera.ts +66 -31
  159. package/templates/puzzle/src/render/crateShape.ts +70 -0
  160. package/templates/puzzle/src/render/lighting.ts +41 -41
  161. package/templates/puzzle/src/render/loading.ts +4 -4
  162. package/templates/puzzle/src/render/materials.ts +131 -27
  163. package/templates/puzzle/src/render/palette.ts +19 -29
  164. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  165. package/templates/puzzle/src/render/quality.ts +71 -80
  166. package/templates/puzzle/src/render/shapes.ts +109 -108
  167. package/templates/puzzle/src/render/sky.ts +18 -10
  168. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  169. package/templates/puzzle/src/render/vault.ts +315 -0
  170. package/templates/puzzle/src/render/warden.ts +46 -0
  171. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  172. package/templates/puzzle/src/scenes/Play.ts +793 -0
  173. package/templates/puzzle/src/state.ts +55 -24
  174. package/templates/puzzle/src/style.css +7 -8
  175. package/templates/puzzle/src/ui/App.tsx +2 -2
  176. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  177. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  178. package/templates/puzzle/threenative.config.ts +14 -1
  179. package/templates/puzzle/vite.config.ts +4 -1
  180. package/templates/racing/AGENTS.md +19 -20
  181. package/templates/racing/CLAUDE.md +19 -20
  182. package/templates/racing/package.json +13 -7
  183. package/templates/racing/playtests/boost.playtest.json +33 -12
  184. package/templates/racing/playtests/outcome.playtest.json +32 -50
  185. package/templates/racing/playtests/performance.playtest.json +2 -1
  186. package/templates/racing/playtests/ranking.playtest.json +5 -14
  187. package/templates/racing/playtests/rescue.playtest.json +2 -2
  188. package/templates/racing/playtests/reverse.playtest.json +30 -8
  189. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  190. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  191. package/templates/racing/src/entities/CarBody.ts +327 -0
  192. package/templates/racing/src/entities/LineDriver.ts +220 -0
  193. package/templates/racing/src/entities/RacingCar.ts +150 -89
  194. package/templates/racing/src/entities/Rival.ts +61 -24
  195. package/templates/racing/src/game.ts +5 -0
  196. package/templates/racing/src/render/camera.ts +49 -7
  197. package/templates/racing/src/render/lighting.ts +36 -37
  198. package/templates/racing/src/render/materials.ts +239 -19
  199. package/templates/racing/src/render/palette.ts +19 -21
  200. package/templates/racing/src/render/postprocessing.ts +12 -2
  201. package/templates/racing/src/render/quality.ts +43 -82
  202. package/templates/racing/src/render/shapes.ts +20 -6
  203. package/templates/racing/src/render/sky.ts +47 -39
  204. package/templates/racing/src/render/touch-controls.ts +1 -1
  205. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  206. package/templates/racing/src/scenes/Race.ts +107 -54
  207. package/templates/racing/src/state.ts +2 -0
  208. package/templates/racing/src/track/Checkline.ts +22 -7
  209. package/templates/racing/src/track/Lap.ts +64 -36
  210. package/templates/racing/src/track/Ranking.ts +20 -11
  211. package/templates/racing/src/track/Track.ts +809 -361
  212. package/templates/racing/src/track/TrackSector.ts +40 -11
  213. package/templates/racing/src/track/circuit.ts +477 -0
  214. package/templates/racing/src/track/rescue.ts +16 -4
  215. package/templates/racing/threenative.config.ts +14 -1
  216. package/templates/racing/vite.config.ts +4 -1
  217. package/templates/rain/AGENTS.md +96 -0
  218. package/templates/rain/CLAUDE.md +98 -0
  219. package/templates/rain/assets/rain-loop.wav +0 -0
  220. package/templates/rain/assets/thunder.wav +0 -0
  221. package/templates/rain/assets/wind-loop.wav +0 -0
  222. package/templates/rain/index.html +18 -0
  223. package/templates/rain/kit.json +7 -0
  224. package/templates/rain/native-playtests/boot.playtest.json +13 -0
  225. package/templates/rain/native-playtests/lightning.playtest.json +173 -0
  226. package/templates/rain/package.json +56 -0
  227. package/templates/rain/playtests/auto-lightning-clear.playtest.json +66 -0
  228. package/templates/rain/playtests/auto-lightning.playtest.json +26 -0
  229. package/templates/rain/playtests/automation.playtest.json +133 -0
  230. package/templates/rain/playtests/cinematic.playtest.json +59 -0
  231. package/templates/rain/playtests/flash.playtest.json +27 -0
  232. package/templates/rain/playtests/fly.playtest.json +54 -0
  233. package/templates/rain/playtests/lightning.playtest.json +220 -0
  234. package/templates/rain/playtests/loading.playtest.json +57 -0
  235. package/templates/rain/playtests/paused.playtest.json +59 -0
  236. package/templates/rain/playtests/performance.playtest.json +22 -0
  237. package/templates/rain/playtests/reduced-motion.playtest.json +87 -0
  238. package/templates/rain/playtests/simulation.playtest.json +20 -0
  239. package/templates/rain/playtests/storm.playtest.json +150 -0
  240. package/templates/rain/playtests/survives.playtest.json +58 -0
  241. package/templates/rain/playtests/tiers.playtest.json +179 -0
  242. package/templates/rain/playtests/weather.playtest.json +77 -0
  243. package/templates/rain/public/favicon.svg +5 -0
  244. package/templates/rain/src/audio/storm.ts +314 -0
  245. package/templates/rain/src/game.ts +114 -0
  246. package/templates/rain/src/render/bloom-shader.ts +65 -0
  247. package/templates/rain/src/render/camera.ts +160 -0
  248. package/templates/rain/src/render/clouds-shader.ts +242 -0
  249. package/templates/rain/src/render/clouds.ts +142 -0
  250. package/templates/rain/src/render/lighting.ts +39 -0
  251. package/templates/rain/src/render/lightning.ts +360 -0
  252. package/templates/rain/src/render/loading.ts +327 -0
  253. package/templates/rain/src/render/materials.ts +19 -0
  254. package/templates/rain/src/render/noise-volume.ts +159 -0
  255. package/templates/rain/src/render/palette.ts +18 -0
  256. package/templates/rain/src/render/post-shader.ts +178 -0
  257. package/templates/rain/src/render/postprocessing.ts +226 -0
  258. package/templates/rain/src/render/quality.ts +135 -0
  259. package/templates/rain/src/render/rain.ts +299 -0
  260. package/templates/rain/src/render/sky.ts +28 -0
  261. package/templates/rain/src/render/world-shader.ts +680 -0
  262. package/templates/rain/src/render/world.ts +146 -0
  263. package/templates/{defense → rain}/src/render/worldEnvironment.ts +52 -1
  264. package/templates/rain/src/scenes/Boot.ts +334 -0
  265. package/templates/rain/src/state.ts +257 -0
  266. package/templates/rain/src/style.css +1160 -0
  267. package/templates/rain/src/ui/App.tsx +29 -0
  268. package/templates/rain/src/ui/GameUi.tsx +187 -0
  269. package/templates/rain/src/ui/Hud.tsx +327 -0
  270. package/templates/rain/src/ui/LoadingOverlay.tsx +46 -0
  271. package/templates/rain/src/ui/Menu.tsx +370 -0
  272. package/templates/rain/src/ui/automation.ts +60 -0
  273. package/templates/rain/src/ui/main.tsx +7 -0
  274. package/templates/rain/src/ui/tempest.ts +149 -0
  275. package/templates/rain/tailwind.config.ts +2 -0
  276. package/templates/rain/threenative.config.ts +66 -0
  277. package/templates/rain/tools/generate-shaders.mjs +656 -0
  278. package/templates/rain/tools/make-storm-audio.mjs +387 -0
  279. package/templates/rain/tools/storm-dsp.mjs +177 -0
  280. package/templates/rain/tools/tempest-bloom.frag +10 -0
  281. package/templates/rain/tools/tempest-clouds.frag +86 -0
  282. package/templates/rain/tools/tempest-post.frag +47 -0
  283. package/templates/rain/tools/tempest-world.frag +210 -0
  284. package/templates/rain/tools/verify-noise-volume.mjs +61 -0
  285. package/templates/rain/tsconfig.json +17 -0
  286. package/templates/rain/vite.config.ts +37 -0
  287. package/templates/rts/.codex/config.toml +19 -0
  288. package/templates/rts/.cursor/mcp.json +32 -0
  289. package/templates/rts/.gemini/settings.json +32 -0
  290. package/templates/rts/.mcp.json +32 -0
  291. package/templates/rts/.vscode/mcp.json +36 -0
  292. package/templates/rts/.zed/settings.json +36 -0
  293. package/templates/rts/AGENTS.md +96 -0
  294. package/templates/rts/CLAUDE.md +98 -0
  295. package/templates/rts/kit.json +7 -0
  296. package/templates/rts/opencode.json +41 -0
  297. package/templates/{defense → rts}/package.json +13 -7
  298. package/templates/rts/playtests/performance.playtest.json +41 -0
  299. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  300. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  301. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  302. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  303. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  304. package/templates/rts/playtests/survives.playtest.json +58 -0
  305. package/templates/rts/public/favicon.svg +4 -0
  306. package/templates/rts/src/game.ts +64 -0
  307. package/templates/rts/src/main.ts +15 -0
  308. package/templates/rts/src/orders.ts +22 -0
  309. package/templates/rts/src/render/army.ts +346 -0
  310. package/templates/rts/src/render/camera.ts +123 -0
  311. package/templates/rts/src/render/lighting.ts +61 -0
  312. package/templates/rts/src/render/loading.ts +33 -0
  313. package/templates/rts/src/render/materials.ts +152 -0
  314. package/templates/rts/src/render/models.ts +705 -0
  315. package/templates/rts/src/render/palette.ts +17 -0
  316. package/templates/rts/src/render/picking.ts +93 -0
  317. package/templates/rts/src/render/postprocessing.ts +46 -0
  318. package/templates/rts/src/render/quality.ts +128 -0
  319. package/templates/rts/src/render/resources.ts +141 -0
  320. package/templates/rts/src/render/sky.ts +44 -0
  321. package/templates/rts/src/render/terrain.ts +116 -0
  322. package/templates/rts/src/render/worldEnvironment.ts +809 -0
  323. package/templates/rts/src/scenes/Play.ts +650 -0
  324. package/templates/rts/src/sim/ai.ts +1140 -0
  325. package/templates/rts/src/sim/combat.ts +416 -0
  326. package/templates/rts/src/sim/construction.ts +374 -0
  327. package/templates/rts/src/sim/economy.ts +167 -0
  328. package/templates/rts/src/sim/game.ts +1082 -0
  329. package/templates/rts/src/sim/movement.ts +371 -0
  330. package/templates/rts/src/sim/nav.ts +276 -0
  331. package/templates/rts/src/sim/production.ts +180 -0
  332. package/templates/rts/src/sim/terrain.ts +170 -0
  333. package/templates/rts/src/sim/types.ts +647 -0
  334. package/templates/rts/src/sim/vision.ts +46 -0
  335. package/templates/rts/src/state.ts +100 -0
  336. package/templates/{defense → rts}/src/style.css +21 -8
  337. package/templates/rts/src/ui/App.tsx +21 -0
  338. package/templates/rts/src/ui/Commands.tsx +129 -0
  339. package/templates/rts/src/ui/GameUi.tsx +22 -0
  340. package/templates/rts/src/ui/Hud.tsx +165 -0
  341. package/templates/rts/src/ui/Minimap.tsx +84 -0
  342. package/templates/rts/tailwind.config.ts +2 -0
  343. package/templates/rts/threenative.config.ts +56 -0
  344. package/templates/rts/tsconfig.json +17 -0
  345. package/templates/{defense → rts}/vite.config.ts +4 -1
  346. package/templates/runner/AGENTS.md +6 -10
  347. package/templates/runner/CLAUDE.md +6 -10
  348. package/templates/runner/README.md +3 -3
  349. package/templates/runner/package.json +13 -7
  350. package/templates/runner/playtests/performance.playtest.json +2 -2
  351. package/templates/runner/src/conventions.ts +4 -3
  352. package/templates/runner/src/entities/Runner.ts +54 -7
  353. package/templates/runner/src/game.ts +2 -0
  354. package/templates/runner/src/render/camera.ts +4 -2
  355. package/templates/runner/src/render/dust.ts +5 -2
  356. package/templates/runner/src/render/lighting.ts +41 -45
  357. package/templates/runner/src/render/loading.ts +2 -2
  358. package/templates/runner/src/render/materials.ts +165 -25
  359. package/templates/runner/src/render/palette.ts +17 -28
  360. package/templates/runner/src/render/postprocessing.ts +12 -2
  361. package/templates/runner/src/render/quality.ts +42 -96
  362. package/templates/runner/src/render/shapes.ts +59 -37
  363. package/templates/runner/src/render/sky.ts +32 -41
  364. package/templates/runner/src/render/touch-controls.ts +1 -1
  365. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  366. package/templates/runner/src/scenes/Run.ts +26 -6
  367. package/templates/runner/src/track.ts +6 -1
  368. package/templates/runner/threenative.config.ts +14 -1
  369. package/templates/runner/vite.config.ts +4 -1
  370. package/templates/sailing/AGENTS.md +12 -12
  371. package/templates/sailing/CLAUDE.md +12 -12
  372. package/templates/sailing/assets/ship.glb +0 -0
  373. package/templates/sailing/package.json +13 -7
  374. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  375. package/templates/sailing/playtests/sails.playtest.json +33 -0
  376. package/templates/sailing/playtests/win.playtest.json +156 -8
  377. package/templates/sailing/src/conventions.ts +29 -2
  378. package/templates/sailing/src/entities/Ship.ts +381 -57
  379. package/templates/sailing/src/game.ts +14 -0
  380. package/templates/sailing/src/render/camera.ts +63 -9
  381. package/templates/sailing/src/render/lighting.ts +49 -27
  382. package/templates/sailing/src/render/materials.ts +50 -15
  383. package/templates/sailing/src/render/ocean.ts +647 -60
  384. package/templates/sailing/src/render/palette.ts +16 -12
  385. package/templates/sailing/src/render/postprocessing.ts +12 -2
  386. package/templates/sailing/src/render/props.ts +316 -442
  387. package/templates/sailing/src/render/quality.ts +14 -4
  388. package/templates/sailing/src/render/sky.ts +116 -23
  389. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  390. package/templates/sailing/src/scenes/Boot.ts +21 -0
  391. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  392. package/templates/sailing/src/state.ts +6 -0
  393. package/templates/sailing/src/ui/Hud.tsx +41 -9
  394. package/templates/sailing/threenative.config.ts +14 -1
  395. package/templates/sailing/vite.config.ts +4 -1
  396. package/templates/shooter/AGENTS.md +27 -42
  397. package/templates/shooter/CLAUDE.md +27 -42
  398. package/templates/shooter/index.html +1 -0
  399. package/templates/shooter/package.json +13 -7
  400. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  401. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  402. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  403. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  404. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  405. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  406. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  407. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  408. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  409. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  410. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  411. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  412. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  413. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  414. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  415. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  416. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  417. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  418. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  419. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  420. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  421. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  422. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  423. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  424. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  425. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  426. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  427. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  428. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  429. package/templates/shooter/playtests/performance.playtest.json +62 -26
  430. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  431. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  432. package/templates/shooter/playtests/survives.playtest.json +36 -30
  433. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  434. package/templates/shooter/src/entities/Breakables.ts +412 -0
  435. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  436. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  437. package/templates/shooter/src/entities/Rifle.ts +442 -0
  438. package/templates/shooter/src/entities/Target.ts +199 -83
  439. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  440. package/templates/shooter/src/game.ts +75 -41
  441. package/templates/shooter/src/main.ts +0 -1
  442. package/templates/shooter/src/postPhysics.ts +36 -0
  443. package/templates/shooter/src/render/camera.ts +78 -74
  444. package/templates/shooter/src/render/decals.ts +142 -82
  445. package/templates/shooter/src/render/facade.ts +1373 -0
  446. package/templates/shooter/src/render/gunfx.ts +704 -0
  447. package/templates/shooter/src/render/lighting.ts +52 -38
  448. package/templates/shooter/src/render/loading.ts +2 -2
  449. package/templates/shooter/src/render/materials.ts +100 -88
  450. package/templates/shooter/src/render/occlusion.ts +108 -0
  451. package/templates/shooter/src/render/palette.ts +10 -10
  452. package/templates/shooter/src/render/palm.ts +455 -0
  453. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  454. package/templates/shooter/src/render/postprocessing.ts +15 -3
  455. package/templates/shooter/src/render/quality.ts +40 -82
  456. package/templates/shooter/src/render/scale.ts +148 -15
  457. package/templates/shooter/src/render/shapes.ts +138 -613
  458. package/templates/shooter/src/render/sky.ts +35 -35
  459. package/templates/shooter/src/render/town-schematic.ts +120 -0
  460. package/templates/shooter/src/render/town.ts +986 -0
  461. package/templates/shooter/src/render/townMaterials.ts +160 -0
  462. package/templates/shooter/src/render/vehicles.ts +741 -0
  463. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  464. package/templates/shooter/src/scenes/Play.ts +727 -650
  465. package/templates/shooter/src/state.ts +26 -41
  466. package/templates/shooter/src/style.css +207 -11
  467. package/templates/shooter/src/surfaces.ts +131 -0
  468. package/templates/shooter/src/ui/App.tsx +9 -10
  469. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  470. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  471. package/templates/shooter/src/ui/Hud.tsx +428 -39
  472. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  473. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  474. package/templates/shooter/src/ui/main.tsx +2 -3
  475. package/templates/shooter/threenative.config.ts +14 -1
  476. package/templates/shooter/vite.config.ts +4 -1
  477. package/templates/snow/.codex/config.toml +19 -0
  478. package/templates/snow/.cursor/mcp.json +32 -0
  479. package/templates/snow/.gemini/settings.json +32 -0
  480. package/templates/snow/.mcp.json +32 -0
  481. package/templates/snow/.vscode/mcp.json +36 -0
  482. package/templates/snow/.zed/settings.json +36 -0
  483. package/templates/snow/AGENTS.md +88 -0
  484. package/templates/snow/CLAUDE.md +90 -0
  485. package/templates/snow/README.md +26 -0
  486. package/templates/snow/assets/crunch.wav +0 -0
  487. package/templates/snow/assets/wind.wav +0 -0
  488. package/templates/snow/index.html +12 -0
  489. package/templates/snow/kit.json +7 -0
  490. package/templates/snow/native-playtests/snow-physics.playtest.json +150 -0
  491. package/templates/snow/native-playtests/survives.playtest.json +47 -0
  492. package/templates/snow/opencode.json +41 -0
  493. package/templates/snow/package.json +58 -0
  494. package/templates/snow/playtests/footsteps.playtest.json +95 -0
  495. package/templates/{defense → snow}/playtests/performance.playtest.json +4 -7
  496. package/templates/snow/playtests/snow-physics.playtest.json +154 -0
  497. package/templates/{defense → snow}/playtests/survives.playtest.json +26 -6
  498. package/templates/snow/playtests/touch-controls.playtest.json +71 -0
  499. package/templates/snow/playtests/weather.playtest.json +119 -0
  500. package/templates/snow/public/favicon.svg +5 -0
  501. package/templates/snow/src/audio.ts +58 -0
  502. package/templates/snow/src/commands.ts +8 -0
  503. package/templates/snow/src/entities/Explorer.ts +279 -0
  504. package/templates/snow/src/game.ts +69 -0
  505. package/templates/snow/src/main.ts +15 -0
  506. package/templates/snow/src/render/bootPrint.ts +50 -0
  507. package/templates/snow/src/render/camera.ts +84 -0
  508. package/templates/snow/src/render/explorer.ts +321 -0
  509. package/templates/snow/src/render/lighting.ts +50 -0
  510. package/templates/snow/src/render/loading.ts +325 -0
  511. package/templates/snow/src/render/materials.ts +36 -0
  512. package/templates/snow/src/render/palette.ts +17 -0
  513. package/templates/{defense → snow}/src/render/postprocessing.ts +12 -2
  514. package/templates/snow/src/render/props.ts +42 -0
  515. package/templates/{defense → snow}/src/render/quality.ts +37 -72
  516. package/templates/snow/src/render/scenery.ts +244 -0
  517. package/templates/snow/src/render/sky.ts +57 -0
  518. package/templates/snow/src/render/snowSurface.ts +259 -0
  519. package/templates/snow/src/render/touch-controls.ts +143 -0
  520. package/templates/snow/src/render/weather.ts +279 -0
  521. package/templates/snow/src/render/worldEnvironment.ts +809 -0
  522. package/templates/{defense → snow}/src/scenes/Boot.ts +4 -4
  523. package/templates/snow/src/scenes/Snow.ts +635 -0
  524. package/templates/snow/src/state.ts +46 -0
  525. package/templates/snow/src/style.css +143 -0
  526. package/templates/snow/src/terrain.ts +64 -0
  527. package/templates/snow/src/ui/App.tsx +15 -0
  528. package/templates/snow/src/ui/Controls.tsx +322 -0
  529. package/templates/snow/src/ui/GameUi.tsx +354 -0
  530. package/templates/snow/src/ui/icons.tsx +54 -0
  531. package/templates/snow/src/ui/main.tsx +7 -0
  532. package/templates/snow/tailwind.config.ts +2 -0
  533. package/templates/snow/threenative.config.ts +51 -0
  534. package/templates/snow/tsconfig.json +17 -0
  535. package/templates/snow/vite.config.ts +37 -0
  536. package/templates/starter/AGENTS.md +17 -17
  537. package/templates/starter/CLAUDE.md +17 -17
  538. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  539. package/templates/starter/package.json +13 -7
  540. package/templates/starter/playtests/play.playtest.json +2 -1
  541. package/templates/starter/playtests/survives.playtest.json +1 -1
  542. package/templates/starter/src/conventions.ts +6 -3
  543. package/templates/starter/src/entities/Goal.ts +35 -42
  544. package/templates/starter/src/entities/Player.ts +99 -16
  545. package/templates/starter/src/render/arena.ts +131 -0
  546. package/templates/starter/src/render/lighting.ts +27 -44
  547. package/templates/starter/src/render/materials.ts +164 -35
  548. package/templates/starter/src/render/palette.ts +16 -16
  549. package/templates/starter/src/render/postprocessing.ts +6 -7
  550. package/templates/starter/src/render/quality.ts +43 -101
  551. package/templates/starter/src/render/shapes.ts +1 -1
  552. package/templates/starter/src/render/sky.ts +39 -45
  553. package/templates/starter/src/render/touch-controls.ts +3 -1
  554. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  555. package/templates/starter/src/scenes/Play.ts +82 -81
  556. package/templates/starter/threenative.config.ts +14 -1
  557. package/templates/starter/vite.config.ts +4 -1
  558. package/templates/tower-defense/.codex/config.toml +19 -0
  559. package/templates/tower-defense/.cursor/mcp.json +32 -0
  560. package/templates/tower-defense/.gemini/settings.json +32 -0
  561. package/templates/tower-defense/.mcp.json +32 -0
  562. package/templates/tower-defense/.vscode/mcp.json +36 -0
  563. package/templates/tower-defense/.zed/settings.json +36 -0
  564. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  565. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  566. package/templates/tower-defense/README.md +16 -0
  567. package/templates/tower-defense/index.html +12 -0
  568. package/templates/tower-defense/kit.json +7 -0
  569. package/templates/tower-defense/opencode.json +41 -0
  570. package/templates/tower-defense/package.json +56 -0
  571. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  572. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  573. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  574. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  575. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  576. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  577. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  578. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  579. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  580. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  581. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  582. package/templates/tower-defense/src/balance.ts +187 -0
  583. package/templates/tower-defense/src/board/Board.ts +100 -0
  584. package/templates/tower-defense/src/board/Route.ts +84 -0
  585. package/templates/tower-defense/src/camera-rig.ts +62 -0
  586. package/templates/tower-defense/src/economy.ts +64 -0
  587. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  588. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  589. package/templates/tower-defense/src/game.ts +72 -0
  590. package/templates/tower-defense/src/intents.ts +21 -0
  591. package/templates/tower-defense/src/main.ts +15 -0
  592. package/templates/tower-defense/src/physics.ts +6 -0
  593. package/templates/tower-defense/src/render/camera.ts +38 -0
  594. package/templates/tower-defense/src/render/lighting.ts +42 -0
  595. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  596. package/templates/tower-defense/src/render/materials.ts +103 -0
  597. package/templates/tower-defense/src/render/palette.ts +58 -0
  598. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  599. package/templates/tower-defense/src/render/quality.ts +128 -0
  600. package/templates/tower-defense/src/render/shapes.ts +550 -0
  601. package/templates/tower-defense/src/render/sky.ts +27 -0
  602. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  603. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  604. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  605. package/templates/tower-defense/src/state.ts +88 -0
  606. package/templates/tower-defense/src/style.css +137 -0
  607. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  608. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  609. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  610. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  611. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  612. package/templates/tower-defense/src/ui/main.tsx +14 -0
  613. package/templates/tower-defense/src/waves.ts +90 -0
  614. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  615. package/templates/tower-defense/vite.config.ts +41 -0
  616. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  617. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  618. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  619. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  620. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  621. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  622. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  623. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  624. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  625. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  626. package/agent-files/AGENT-ROLES.md +0 -26
  627. package/templates/action-rpg/src/render/shapes.ts +0 -269
  628. package/templates/action-rpg/src/render/types.ts +0 -3
  629. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  630. package/templates/defense/README.md +0 -10
  631. package/templates/defense/kit.json +0 -7
  632. package/templates/defense/playtests/leak.playtest.json +0 -23
  633. package/templates/defense/playtests/placement.playtest.json +0 -40
  634. package/templates/defense/playtests/scan.playtest.json +0 -20
  635. package/templates/defense/playtests/survive.playtest.json +0 -45
  636. package/templates/defense/src/attackers/Attacker.ts +0 -120
  637. package/templates/defense/src/board/Route.ts +0 -94
  638. package/templates/defense/src/conventions.ts +0 -18
  639. package/templates/defense/src/economy.ts +0 -36
  640. package/templates/defense/src/entities/Player.ts +0 -52
  641. package/templates/defense/src/game.ts +0 -51
  642. package/templates/defense/src/physics.ts +0 -13
  643. package/templates/defense/src/placement/Buildable.ts +0 -49
  644. package/templates/defense/src/render/camera.ts +0 -16
  645. package/templates/defense/src/render/lighting.ts +0 -37
  646. package/templates/defense/src/render/materials.ts +0 -22
  647. package/templates/defense/src/render/palette.ts +0 -28
  648. package/templates/defense/src/render/shapes.ts +0 -246
  649. package/templates/defense/src/render/sky.ts +0 -45
  650. package/templates/defense/src/scenes/Defense.ts +0 -231
  651. package/templates/defense/src/state.ts +0 -56
  652. package/templates/defense/src/towers/Tower.ts +0 -95
  653. package/templates/defense/src/towers/targeting.ts +0 -53
  654. package/templates/defense/src/ui/Hud.tsx +0 -62
  655. package/templates/defense/src/ui/Menu.tsx +0 -7
  656. package/templates/defense/src/waves.ts +0 -40
  657. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  658. package/templates/minimal/src/render/hud.ts +0 -69
  659. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  660. package/templates/platformer/playtests/chase.playtest.json +0 -21
  661. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  662. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  663. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  664. package/templates/platformer/playtests/physics.playtest.json +0 -14
  665. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  666. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  667. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  668. package/templates/platformer/src/conventions.ts +0 -18
  669. package/templates/platformer/src/entities/Character.ts +0 -286
  670. package/templates/platformer/src/entities/Chaser.ts +0 -118
  671. package/templates/platformer/src/entities/Patrol.ts +0 -93
  672. package/templates/platformer/src/level/Platform.ts +0 -46
  673. package/templates/platformer/src/render/rig.ts +0 -60
  674. package/templates/platformer/src/render/terrain.ts +0 -31
  675. package/templates/platformer/src/scenes/Level.ts +0 -241
  676. package/templates/puzzle/README.md +0 -43
  677. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  678. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  679. package/templates/puzzle/src/conventions.ts +0 -25
  680. package/templates/puzzle/src/entities/Ball.ts +0 -70
  681. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  682. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  683. package/templates/puzzle/src/physics.ts +0 -19
  684. package/templates/puzzle/src/room.ts +0 -83
  685. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  686. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  687. package/templates/shooter/playtests/combat.playtest.json +0 -48
  688. package/templates/shooter/playtests/fail.playtest.json +0 -31
  689. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  690. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  691. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  692. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  693. package/templates/shooter/src/combat/damage.ts +0 -40
  694. package/templates/shooter/src/conventions.ts +0 -51
  695. package/templates/shooter/src/entities/Pickup.ts +0 -70
  696. package/templates/shooter/src/entities/Player.ts +0 -310
  697. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  698. package/templates/shooter/src/playtest-events.ts +0 -15
  699. package/templates/shooter/src/render/touch-controls.ts +0 -305
  700. package/templates/shooter/src/render/types.ts +0 -3
  701. package/templates/shooter/src/render/ui.css +0 -330
  702. package/templates/shooter/src/render/ui.ts +0 -75
  703. package/templates/shooter/src/render/vfx.ts +0 -215
  704. package/templates/shooter/src/ui/Menu.tsx +0 -41
  705. package/templates/shooter/src/waves.ts +0 -50
  706. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  707. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  708. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  709. package/templates/starter/playtests/assets.playtest.json +0 -65
  710. package/templates/starter/playtests/buffer.playtest.json +0 -79
  711. package/templates/starter/playtests/cloth.playtest.json +0 -113
  712. package/templates/starter/playtests/coyote.playtest.json +0 -87
  713. package/templates/starter/playtests/gameover.playtest.json +0 -66
  714. package/templates/starter/playtests/goal.playtest.json +0 -67
  715. package/templates/starter/playtests/look.playtest.json +0 -175
  716. package/templates/starter/playtests/models-baseline.png +0 -0
  717. package/templates/starter/playtests/models.playtest.json +0 -74
  718. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  719. package/templates/starter/playtests/odometer.playtest.json +0 -54
  720. package/templates/starter/playtests/restart.playtest.json +0 -91
  721. package/templates/starter/playtests/seed.playtest.json +0 -54
  722. package/templates/starter/playtests/textures-baseline.png +0 -0
  723. package/templates/starter/playtests/textures.playtest.json +0 -74
  724. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  725. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  726. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  727. package/templates/starter/src/render/coast.ts +0 -199
  728. package/templates/starter/src/render/hero.ts +0 -88
  729. package/templates/starter/src/render/implicitSurface.ts +0 -199
  730. package/templates/starter/src/render/kuwahara.ts +0 -174
  731. package/templates/starter/src/render/outline.ts +0 -141
  732. package/templates/starter/src/render/painterly.ts +0 -86
  733. package/templates/starter/src/render/rockRidge.ts +0 -198
  734. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  735. package/templates/starter/src/render/scenery.ts +0 -40
  736. package/templates/starter/src/render/textureLifetime.ts +0 -53
  737. package/templates/starter/src/render/water.ts +0 -38
  738. package/templates/starter/src/render/watercolor.ts +0 -85
  739. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  740. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  741. /package/templates/{defense → rain}/.codex/config.toml +0 -0
  742. /package/templates/{defense → rain}/.cursor/mcp.json +0 -0
  743. /package/templates/{defense → rain}/.gemini/settings.json +0 -0
  744. /package/templates/{defense → rain}/.mcp.json +0 -0
  745. /package/templates/{defense → rain}/.vscode/mcp.json +0 -0
  746. /package/templates/{defense → rain}/.zed/settings.json +0 -0
  747. /package/templates/{defense → rain}/opencode.json +0 -0
  748. /package/templates/{defense → rain}/src/main.ts +0 -0
  749. /package/templates/{defense → rts}/index.html +0 -0
  750. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  751. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  752. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  753. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  754. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  755. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  756. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -1,53 +1,442 @@
1
- import { useUiState } from "@threenative/ui";
2
- import { shooterUi } from "../render/ui.js";
3
- import type { GameState } from "../state.js";
1
+ import { useUiIntent, useUiState } from "@threenative/ui";
2
+ import { townSchematic } from "../render/town-schematic.js";
3
+ import { type GameState, TARGET_GOAL } from "../state.js";
4
+ import { Crosshair, type ICrosshairPrimitiveProps } from "./Crosshair.js";
5
+ import { Minimap } from "./Minimap.js";
6
+ import { TouchOverlay } from "./TouchOverlay.js";
4
7
 
5
- type MeterTone = keyof typeof shooterUi.hud.meter.fill;
8
+ const KEYS: readonly (readonly [string, string])[] = [
9
+ ["WASD", "Move"],
10
+ ["Mouse 1", "Fire"],
11
+ ["R", "Reload"],
12
+ ["Enter", "Retry"],
13
+ ];
6
14
 
7
- function Meter({ label, value, tone }: { label: string; tone: MeterTone; value: number }) {
15
+ function Legend() {
8
16
  return (
9
- <div className={shooterUi.hud.meter.root}>
10
- <div className={shooterUi.hud.meter.label}>
11
- <span>{label}</span>
12
- <b className={shooterUi.hud.meter.value}>{Math.round(value)}</b>
13
- </div>
14
- <div className={shooterUi.hud.meter.track}>
15
- <i
16
- className={shooterUi.hud.meter.fill[tone]}
17
- style={{ width: `${Math.max(0, Math.min(100, value))}%` }}
18
- />
19
- </div>
17
+ <div className="desktop-only pointer-events-none flex items-center gap-3 bg-black/45 px-4 py-2 text-[13px] font-semibold tracking-wide">
18
+ {KEYS.map(([key, label], index) => (
19
+ <span className="flex items-center gap-2" key={key}>
20
+ {index > 0 ? <i className="mr-1 not-italic text-white/25">|</i> : null}
21
+ <b className="font-bold text-[#ffa63d]">{key}</b>
22
+ <span className="font-normal text-white/85">{label}</span>
23
+ </span>
24
+ ))}
20
25
  </div>
21
26
  );
22
27
  }
23
28
 
29
+ function ShieldGlyph({ className }: { className?: string }) {
30
+ return (
31
+ <svg viewBox="0 0 24 24" className={className} aria-hidden="true">
32
+ <path d="M12 2l8 3v6c0 5.2-3.4 9.6-8 11-4.6-1.4-8-5.8-8-11V5l8-3z" />
33
+ </svg>
34
+ );
35
+ }
36
+
37
+ /** Bust silhouette used for every roster chip; the chip tint carries the team. */
38
+ function SoldierBust() {
39
+ return (
40
+ <svg viewBox="0 0 32 32" className="h-full w-full" aria-hidden="true">
41
+ <path
42
+ d="M16 5c-3.6 0-6 2.7-6 6.2 0 2.4 1 4.5 2.6 5.6C9 18 6.4 20.4 6 24h20c-.4-3.6-3-6-6.6-7.2 1.6-1.1 2.6-3.2 2.6-5.6C22 7.7 19.6 5 16 5z"
43
+ fill="currentColor"
44
+ />
45
+ </svg>
46
+ );
47
+ }
48
+
49
+ /**
50
+ * One roster slot: dark plate, team-tinted bust, thin accent rail on top.
51
+ *
52
+ * `down` is the reference's dead-player treatment — the chip desaturates and
53
+ * the bust fades rather than disappearing, so the roster keeps its shape and
54
+ * the row still reads as five slots.
55
+ */
56
+ function PortraitChip({ tone, down }: { tone: "ct" | "t"; down?: boolean }) {
57
+ const ct = tone === "ct";
58
+ return (
59
+ <span
60
+ className={`relative block h-[38px] w-[30px] overflow-hidden rounded-[3px] border transition-[opacity,filter] duration-300 ${
61
+ ct ? "border-[#7fb3e8]/70" : "border-[#e8c66f]/70"
62
+ } bg-gradient-to-b ${ct ? "from-[#274a68] to-[#12202e]" : "from-[#6b5524] to-[#241b0c]"} ${
63
+ down === true ? "opacity-40 grayscale" : ""
64
+ }`}
65
+ >
66
+ <i className={`absolute inset-x-0 top-0 h-[2px] ${ct ? "bg-[#7fb3e8]" : "bg-[#e8c66f]"}`} />
67
+ <span
68
+ className={`block p-[3px] ${ct ? "text-[#a9d2f5]" : "text-[#f0d491]"} ${
69
+ down === true ? "opacity-45" : ""
70
+ }`}
71
+ >
72
+ <SoldierBust />
73
+ </span>
74
+ {down === true ? (
75
+ <i className="absolute inset-x-[5px] top-1/2 h-[2px] -translate-y-1/2 rotate-[-24deg] bg-[#ff5f4d]/80" />
76
+ ) : null}
77
+ </span>
78
+ );
79
+ }
80
+
81
+ /** The header roster is five a side, per the design sheet's "5 vs 5". */
82
+ const ROSTER = [0, 1, 2, 3, 4] as const;
83
+
84
+ function WebCrosshairPrimitive({ children, hidden, hitFlash, part }: ICrosshairPrimitiveProps) {
85
+ if (part === "vertical") {
86
+ return <i className="absolute left-1/2 top-0 h-full w-[1.5px] -translate-x-1/2 bg-white/90" />;
87
+ }
88
+ if (part === "horizontal") {
89
+ return <i className="absolute left-0 top-1/2 h-[1.5px] w-full -translate-y-1/2 bg-white/90" />;
90
+ }
91
+ return (
92
+ <div
93
+ className="absolute left-1/2 top-1/2 h-[13px] w-[13px] -translate-x-1/2 -translate-y-1/2"
94
+ style={{
95
+ opacity: hidden ? 0 : 1,
96
+ transform: `translate(-50%, -50%) scale(${(1 + hitFlash * 0.7).toFixed(3)})`,
97
+ }}
98
+ >
99
+ {children}
100
+ </div>
101
+ );
102
+ }
103
+
104
+ /** Gold roundel with a winged star, centred on the bottom HUD row. */
105
+ function RankEmblem() {
106
+ return (
107
+ <svg viewBox="0 0 48 48" className="h-[42px] w-[42px]" aria-hidden="true">
108
+ <circle cx="24" cy="24" r="21" fill="#101418" stroke="#d8b25c" strokeWidth="2.4" />
109
+ <path
110
+ d="M4 24c5-4 9-5 14-4l-3 4c-4-.6-8-.4-11 0zM44 24c-5-4-9-5-14-4l3 4c4-.6 8-.4 11 0z"
111
+ fill="#d8b25c"
112
+ />
113
+ <path
114
+ d="M24 12l2.7 6.1 6.6.6-5 4.4 1.5 6.5L24 26l-5.8 3.6 1.5-6.5-5-4.4 6.6-.6L24 12z"
115
+ fill="#f0cd7a"
116
+ />
117
+ </svg>
118
+ );
119
+ }
120
+
121
+ function BulletsGlyph() {
122
+ return (
123
+ <svg viewBox="0 0 16 16" className="mb-[3px] h-[15px] w-[15px]" aria-hidden="true">
124
+ <rect x={1} y={6} width={3} height={9} rx={1} fill="#ffa63d" />
125
+ <rect x={6.5} y={3} width={3} height={12} rx={1} fill="#ffa63d" />
126
+ <rect x={12} y={1} width={3} height={14} rx={1} fill="#ffa63d" />
127
+ </svg>
128
+ );
129
+ }
130
+
131
+ /**
132
+ * Go full screen and lock to landscape, on the one tap a phone player is guaranteed to make.
133
+ *
134
+ * Two things this fixes, both measured on a Pixel 8 in Chrome. Portrait gives the game a 411x784
135
+ * surface for a scene composed at 1280x720, so the horizontal field of view a shooter needs is
136
+ * simply not there. And even rotated, Chrome's URL bar and gesture bar leave 303 px of height out
137
+ * of 1080 — nearly three quarters of the screen spent on browser furniture.
138
+ *
139
+ * Both APIs are DOM-only and both are gated behind a user gesture, which is why this is a button
140
+ * and not something the scene does at boot. `src/ui/` is the web-only half of this game by
141
+ * contract — the native target never builds it, and the native target has neither problem, because
142
+ * `threenative.config.ts` already declares `orientation: "landscape"` and `fullscreen: true`.
143
+ *
144
+ * Failure is silent and non-fatal on purpose: iOS Safari has no `requestFullscreen` on elements
145
+ * and no orientation lock at all, and a player there should get the game, not an error.
146
+ */
147
+ async function goImmersive(): Promise<void> {
148
+ try {
149
+ if (document.fullscreenElement === null) {
150
+ await document.documentElement.requestFullscreen({
151
+ navigationUI: "hide",
152
+ });
153
+ }
154
+ } catch {
155
+ // Refused (iOS, or no gesture credit left). The orientation attempt below may still work.
156
+ }
157
+ try {
158
+ const orientation = screen.orientation as ScreenOrientation & {
159
+ lock?: (to: string) => Promise<void>;
160
+ };
161
+ await orientation.lock?.("landscape");
162
+ } catch {
163
+ // No orientation lock on this platform. The player rotates the phone themselves.
164
+ }
165
+ }
166
+
167
+ /**
168
+ * A HUD control a thumb can actually press.
169
+ *
170
+ * Everything else under `.touch-only` is `pointer-events-none`, because the gameplay controls are
171
+ * read from `ctx.input.raw.pointers` inside the scene and a div that swallowed touches would make
172
+ * the game stop responding exactly where its controls are drawn. These two are the exception: they
173
+ * are React actions, not gameplay input, so they take their own events and sit clear of the
174
+ * thumb bands the scene reads.
175
+ */
176
+ function TouchAction({
177
+ onPress,
178
+ children,
179
+ className = "",
180
+ }: {
181
+ onPress: () => void;
182
+ children: React.ReactNode;
183
+ className?: string;
184
+ }) {
185
+ return (
186
+ <button
187
+ type="button"
188
+ // The host decides on pointer-down whether a press belongs to the UI or falls through to
189
+ // the game, and it decides from the rectangles the page publishes for elements marked
190
+ // this way. Without it the button is drawn, is styled `pointer-events-auto`, and still
191
+ // never receives the press on native: the platform hands the gesture to the game before
192
+ // any CSS runs. `pointer-events-auto` is a web-only half of the story.
193
+ data-tn-interactive
194
+ // `onPointerDown`, not `onClick`: a click needs a press and a release inside the same
195
+ // element and waits out the gesture, which on a phone is a control that feels broken.
196
+ onPointerDown={(event) => {
197
+ event.preventDefault();
198
+ event.stopPropagation();
199
+ onPress();
200
+ }}
201
+ className={`pointer-events-auto touch-none select-none ${className}`}
202
+ >
203
+ {children}
204
+ </button>
205
+ );
206
+ }
207
+
24
208
  export function Hud() {
25
209
  const state = useUiState<GameState>();
26
- // Nothing to draw until the game publishes its first snapshot, a few milliseconds in. Rendering
27
- // zeroes instead would put wrong numbers on screen and then correct them.
210
+ // An intent, not a state write: on native this component runs in the platform's web view, in a
211
+ // different realm from the game, so it cannot reach `game` at all. The game owns what "restart"
212
+ // means and does the same two things the keyboard's Enter path does.
213
+ const sendIntent = useUiIntent();
214
+ // Nothing to draw until the game has published a frame. The web view loads this page before the
215
+ // game has run a tick, so an empty first paint is the normal path here, not a failure.
28
216
  if (state === undefined) return null;
29
- const { ammo, health, lives, reloading, reserve, wave, wavesCleared, phase } = state;
30
- const targets = state.targetsRemaining;
31
- return (
32
- <section className={shooterUi.hud.root}>
33
- <div className={shooterUi.hud.eyebrow}>{shooterUi.hud.copy.eyebrow}</div>
34
- <div className={shooterUi.hud.wave}>{shooterUi.hud.copy.wave(wave)}</div>
35
- <div className={shooterUi.hud.rules}>{shooterUi.hud.copy.rules}</div>
36
- <Meter label={shooterUi.hud.copy.health} tone="cyan" value={health} />
37
- <Meter label={shooterUi.hud.copy.lives} tone="amber" value={(lives / 3) * 100} />
38
- <div className={shooterUi.hud.summary}>
39
- <span>{shooterUi.hud.copy.targets(targets)}</span>
40
- <span>{shooterUi.hud.copy.clear(wavesCleared)}</span>
217
+ const {
218
+ score,
219
+ health,
220
+ ammo,
221
+ reserve,
222
+ targetsHit,
223
+ timeRemaining,
224
+ hitFlash,
225
+ phase,
226
+ aiming,
227
+ playerX,
228
+ playerZ,
229
+ playerYaw,
230
+ blips,
231
+ hurtFlash,
232
+ } = state;
233
+ // The same two lines the keyboard's Enter path runs in `Play.update`. A phone has no Enter key,
234
+ // and until this existed a mobile player who ran out of time had no way to start another round —
235
+ // the end card told them to press a key their device does not have.
236
+ const restart = () => sendIntent("restart");
237
+
238
+ const lowHealth = health < 35;
239
+ // The header score is the round's real tally, not a placeholder: soldiers
240
+ // down on the left, soldiers still standing on the right.
241
+ const soldiersDown = blips.reduce((total, blip) => total + (blip.alive ? 0 : 1), 0);
242
+ const soldiersStanding = Math.max(0, ROSTER.length - soldiersDown);
243
+ const clockSeconds = Math.max(0, Math.floor(timeRemaining));
244
+ const clockMinutes = Math.floor(clockSeconds / 60);
245
+ const clockPart = String(clockSeconds % 60).padStart(2, "0");
246
+
247
+ return (
248
+ <div className="pointer-events-none absolute inset-0 select-none font-sans">
249
+ {/* Top left: the round minimap, north-up. It renders the plain map data
250
+ the town builder emits — no scene objects cross into the HUD. */}
251
+ <Minimap
252
+ schematic={townSchematic}
253
+ playerX={playerX}
254
+ playerZ={playerZ}
255
+ playerYaw={playerYaw}
256
+ blips={blips}
257
+ />
258
+
259
+ {/* Top centre: team rosters flanking the round clock, score beneath —
260
+ five defenders in blue against five attackers in gold, like the
261
+ reference's 5-vs-5 header. Both rows are live: the gold chips are the
262
+ five patrolling soldiers and grey out as they fall, and the leading
263
+ blue chip is the player. */}
264
+ <div className="hud-top absolute left-1/2 top-2 flex -translate-x-1/2 flex-col items-center drop-shadow-[0_1px_3px_rgba(0,0,0,0.7)]">
265
+ <div className="flex items-start gap-2">
266
+ <div className="flex items-center gap-[3px] pt-1">
267
+ {ROSTER.map((index) => (
268
+ <PortraitChip
269
+ key={`ct-${index}`}
270
+ tone="ct"
271
+ // Slot 0 is the player; the rest of the side is unfilled, and
272
+ // showing it greyed is honest about a roster nobody occupies.
273
+ down={index === 0 ? health <= 0 : true}
274
+ />
275
+ ))}
276
+ </div>
277
+ <div className="min-w-[86px] rounded-[3px] border border-white/15 bg-black/60 px-3 py-0.5 text-center">
278
+ <div className="text-[26px] font-bold leading-tight tabular-nums text-white">
279
+ {clockMinutes}
280
+ <span className="text-[#ffa63d]">:</span>
281
+ {clockPart}
282
+ </div>
283
+ </div>
284
+ <div className="flex items-center gap-[3px] pt-1">
285
+ {ROSTER.map((index) => (
286
+ <PortraitChip
287
+ key={`t-${index}`}
288
+ tone="t"
289
+ // A blip that has not been reported yet counts as standing, so
290
+ // the row reads full during the asset-loading window.
291
+ down={blips[index]?.alive === false}
292
+ />
293
+ ))}
294
+ </div>
295
+ </div>
296
+ <div className="mt-0.5 text-[19px] font-bold leading-none tabular-nums tracking-[0.08em] text-white">
297
+ {soldiersDown}
298
+ <span className="mx-1.5 text-white/45">:</span>
299
+ {soldiersStanding}
300
+ </div>
301
+ <div className="mt-[3px] text-[12px] font-semibold leading-none tracking-[0.04em] text-white/60">
302
+ {ROSTER.length} vs {ROSTER.length}
303
+ </div>
304
+ {phase === "playing" ? (
305
+ <div className="mt-1 text-[13px] font-bold tracking-[0.05em] text-white/85">
306
+ CLEAR THE TOWN · HIT {Math.max(0, TARGET_GOAL - targetsHit)} TARGETS
307
+ </div>
308
+ ) : null}
309
+ </div>
310
+
311
+ {/* Bottom centre: armour badge, health readout, rank emblem and ammo on
312
+ one shared baseline, like the reference's lower cluster. */}
313
+ <div className="hud-bottom absolute bottom-4 left-1/2 flex -translate-x-1/2 items-end gap-9">
314
+ <div className="flex items-end gap-3">
315
+ <span className="relative inline-block h-[34px] w-[30px]">
316
+ <ShieldGlyph className="h-full w-full fill-[#274a68] stroke-[#7fb3e8] stroke-[1.4]" />
317
+ <span className="absolute inset-x-0 top-[11px] text-center text-[12px] font-bold leading-none tabular-nums text-white">
318
+ 100
319
+ </span>
320
+ </span>
321
+ <span>
322
+ <span
323
+ className={`block text-[36px] font-bold leading-none tabular-nums drop-shadow-[0_1px_2px_rgba(0,0,0,0.6)] ${
324
+ lowHealth ? "text-[#ff5f4d]" : "text-white"
325
+ }`}
326
+ >
327
+ {Math.round(health)}
328
+ </span>
329
+ <i
330
+ className={`mt-[3px] block h-[3px] w-[74px] ${lowHealth ? "bg-[#ff5f4d]" : "bg-[#e8c66f]"}`}
331
+ style={{ transformOrigin: "left" }}
332
+ >
333
+ <i
334
+ className={`block h-full ${lowHealth ? "bg-[#ff5f4d]" : "bg-[#ffd166]"}`}
335
+ style={{ width: `${Math.min(100, Math.max(0, health))}%` }}
336
+ />
337
+ </i>
338
+ </span>
339
+ </div>
340
+ <RankEmblem />
341
+ <div className="flex items-baseline gap-2 tabular-nums drop-shadow-[0_1px_2px_rgba(0,0,0,0.6)]">
342
+ <span className="text-[38px] font-bold leading-none text-white">{ammo}</span>
343
+ <span className="text-[19px] font-semibold text-white/55">| {reserve}</span>
344
+ <BulletsGlyph />
345
+ </div>
41
346
  </div>
42
- <div className={shooterUi.hud.ammo.root}>
43
- <b className={shooterUi.hud.ammo.count}>{shooterUi.hud.copy.ammo(ammo, reserve)}</b>
44
- {reloading === 1 && (
45
- <span className={shooterUi.hud.ammo.reloading}>{shooterUi.hud.copy.reloading}</span>
46
- )}
347
+
348
+ {/* Top right: one tap to full screen and landscape. Placed opposite the minimap and above
349
+ the right thumb's look band, so it is reachable but never under a finger that is aiming. */}
350
+ <div className="hud-immersive touch-show pointer-events-none absolute right-2 top-2">
351
+ <TouchAction
352
+ onPress={() => {
353
+ void goImmersive();
354
+ }}
355
+ className="rounded-[4px] border border-white/25 bg-black/50 px-2.5 py-1.5 text-[11px] font-bold tracking-[0.12em] text-white/75"
356
+ >
357
+ FULL
358
+ </TouchAction>
359
+ </div>
360
+
361
+ {/* Thumb controls. A root-level sibling on purpose: every child here is positioned against
362
+ the full HUD surface, and nesting these inside the legend stack below put the fire button
363
+ 62 px from the right edge of a 62 px chip instead of the right edge of the screen. */}
364
+ <TouchOverlay />
365
+
366
+ {/* Bottom left: money chip over the key legend. */}
367
+ <div className="hud-corner absolute bottom-3 left-3 flex flex-col items-start gap-2.5">
368
+ <div className="pl-1 text-[16px] font-bold tabular-nums tracking-[0.03em] text-[#ffd166] drop-shadow-[0_1px_2px_rgba(0,0,0,0.6)]">
369
+ $10000
370
+ </div>
371
+ <Legend />
47
372
  </div>
48
- {phase !== "playing" && (
49
- <div className={shooterUi.hud.phase[phase]}>{shooterUi.hud.phaseCopy[phase]}</div>
50
- )}
51
- </section>
373
+
374
+ {/* Crosshair, with a hit marker that blooms outward on a scoring hit.
375
+
376
+ It is hidden while aiming down the sights. The weapon's own optic is the aim reference
377
+ there, and a second reticle floating beside the red dot reads as a misaligned sight. */}
378
+ <Crosshair aiming={aiming} hitFlash={hitFlash} Primitive={WebCrosshairPrimitive} />
379
+ {hitFlash > 0 ? (
380
+ <div
381
+ className="absolute left-1/2 top-1/2 h-[26px] w-[26px] -translate-x-1/2 -translate-y-1/2 rotate-45"
382
+ style={{ opacity: Math.min(1, hitFlash * 1.6) }}
383
+ >
384
+ <i className="absolute left-1/2 top-0 h-full w-[2px] -translate-x-1/2 bg-[#ffd166]" />
385
+ <i className="absolute left-0 top-1/2 h-[2px] w-full -translate-y-1/2 bg-[#ffd166]" />
386
+ </div>
387
+ ) : null}
388
+ {/* Red only while a round is landing. It used to be driven by `health < 45`, which is a
389
+ low-health indicator wearing a damage vignette's clothes: a soldier at 40 with nobody
390
+ shooting him got a permanently red screen, and the 70 rounds it takes to walk from 100
391
+ to 30 produced no feedback at all. The health bar and the health number already say
392
+ "you are nearly dead". */}
393
+ {hurtFlash > 0 ? (
394
+ <div
395
+ className="absolute inset-0"
396
+ style={{
397
+ background:
398
+ "radial-gradient(circle at 50% 55%, rgba(0,0,0,0) 42%, rgba(190,26,20,0.5) 100%)",
399
+ opacity: Math.min(1, hurtFlash),
400
+ }}
401
+ />
402
+ ) : null}
403
+
404
+ {phase !== "playing" ? (
405
+ <div className="pointer-events-none absolute inset-0 flex flex-col items-center justify-center bg-black/45">
406
+ <div
407
+ className={`text-[42px] font-bold tracking-[0.08em] ${
408
+ phase === "complete" ? "text-[#3ddc6b]" : "text-[#ff5f4d]"
409
+ }`}
410
+ >
411
+ {phase === "complete" ? "TOWN CLEAR" : "RUN OVER"}
412
+ </div>
413
+ <div className="mt-2 text-[18px] font-bold tracking-[0.06em] text-white">
414
+ SCORE {String(score).padStart(4, "0")} · {targetsHit} HITS
415
+ </div>
416
+ <div className="desktop-only mt-6 text-[15px] font-bold tracking-[0.14em] text-[#ffa63d]">
417
+ PRESS ENTER TO RUN IT AGAIN
418
+ </div>
419
+ <div className="touch-show mt-6">
420
+ <TouchAction
421
+ onPress={restart}
422
+ className="rounded-[4px] border-2 border-[#ffa63d] bg-[#ffa63d]/15 px-8 py-3 text-[16px] font-bold tracking-[0.16em] text-[#ffa63d] active:bg-[#ffa63d]/35"
423
+ >
424
+ RUN IT AGAIN
425
+ </TouchAction>
426
+ </div>
427
+ {/* Poly Haven's licence requires a visible credit wherever its API was
428
+ used to source assets, and "visible" means a player has to be able
429
+ to see it — CREDITS.md alone does not discharge that. The sky,
430
+ barrel, gutter, wall lamp and buoy all came from there. ambientCG
431
+ (the plaster, brick, flagstone, concrete, quaystone and steel) is
432
+ CC0 and asks for nothing; it is named here as courtesy, not duty. */}
433
+ <div className="mt-10 text-center text-[11px] leading-relaxed tracking-[0.06em] text-white/40">
434
+ Environment textures and props: Poly Haven (CC0) · ambientCG (CC0)
435
+ <br />
436
+ Audio: Kenney (CC0) · Sonniss
437
+ </div>
438
+ </div>
439
+ ) : null}
440
+ </div>
52
441
  );
53
442
  }
@@ -0,0 +1,164 @@
1
+ import type { ITownSchematic, SchematicRect } from "../render/town.js";
2
+ import type { Blip } from "../state.js";
3
+
4
+ // One SVG unit is one metre. North (-z) points up, east (+x) right, so a world
5
+ // point lands at SVG (x, z) directly — +z (south) draws downward. Every rect,
6
+ // label and extent arrives as plain data in the `schematic` prop emitted by the
7
+ // town builder (see ITownSchematic); this component owns only how that data is
8
+ // presented and the live state drawn on top of it.
9
+ const VIEW_CONE_RADIUS = 26; // metres
10
+ const VIEW_CONE_HALF_ANGLE = Math.PI / 6; // 30 deg each side of facing
11
+ const DOT_CLAMP = 45; // metres from centre; keeps dots just inside the disc rim
12
+
13
+ function AreaRect({ rect, raised }: { rect: SchematicRect; raised?: boolean }) {
14
+ const [x, z, width, depth] = rect;
15
+ return (
16
+ <rect
17
+ x={x}
18
+ y={z}
19
+ width={width}
20
+ height={depth}
21
+ fill={raised ? "none" : "#ffffff"}
22
+ fillOpacity={raised ? 0 : 0.05}
23
+ stroke={raised ? "#ffd166" : "#ffffff"}
24
+ strokeOpacity={raised ? 0.6 : 0.22}
25
+ strokeDasharray={raised ? "3 2" : undefined}
26
+ vectorEffect="non-scaling-stroke"
27
+ />
28
+ );
29
+ }
30
+
31
+ function MapLabel({ label }: { label: ITownSchematic["labels"][number] }) {
32
+ const site = label.kind === "site";
33
+ return (
34
+ <text
35
+ x={label.x}
36
+ y={label.z}
37
+ textAnchor="middle"
38
+ dominantBaseline="central"
39
+ fontSize={site ? 9 : 5.4}
40
+ fontWeight={site ? 700 : 600}
41
+ fill={site ? "#ffb84d" : "#ffd166"}
42
+ fillOpacity={site ? undefined : 0.85}
43
+ >
44
+ {label.text}
45
+ </text>
46
+ );
47
+ }
48
+
49
+ export function Minimap({
50
+ schematic,
51
+ playerX,
52
+ playerZ,
53
+ playerYaw,
54
+ blips,
55
+ }: {
56
+ schematic: ITownSchematic;
57
+ playerX: number;
58
+ playerZ: number;
59
+ playerYaw: number;
60
+ blips: readonly Blip[];
61
+ }) {
62
+ // yaw=0 faces -z (map up); forward matches FpsPlayer: (-sin yaw, -cos yaw).
63
+ // Expressed as an SVG-screen angle for the view cone.
64
+ const facing = Math.atan2(-Math.cos(playerYaw), -Math.sin(playerYaw));
65
+ const coneEdge = (angle: number) => {
66
+ const ex = playerX + VIEW_CONE_RADIUS * Math.cos(angle);
67
+ const ez = playerZ + VIEW_CONE_RADIUS * Math.sin(angle);
68
+ return `${ex.toFixed(1)} ${ez.toFixed(1)}`;
69
+ };
70
+
71
+ return (
72
+ <div className="hud-minimap pointer-events-none absolute left-4 top-4 h-[180px] w-[180px] rounded-full bg-black/55 shadow-[0_2px_12px_rgba(0,0,0,0.45)] ring-1 ring-[#ffa63d]/40">
73
+ <svg
74
+ viewBox="-50 -50 100 100"
75
+ className="absolute inset-0 h-full w-full"
76
+ role="img"
77
+ aria-label={`Town map: the player, their view cone, and ${blips.filter((b) => b.alive).length} soldiers still standing`}
78
+ >
79
+ <title>Bayview town map</title>
80
+ <defs>
81
+ <clipPath id="bayview-map-disc">
82
+ <circle cx="0" cy="0" r="49" />
83
+ </clipPath>
84
+ </defs>
85
+ <g clipPath="url(#bayview-map-disc)">
86
+ {/* Sea east of the deck edge, and the dock pier reaching into it. */}
87
+ <rect
88
+ x={schematic.sea.edgeX}
89
+ y={-50}
90
+ width={8}
91
+ height={100}
92
+ fill="#5b93b8"
93
+ opacity={0.35}
94
+ />
95
+ <line
96
+ x1={schematic.pier.ax}
97
+ y1={schematic.pier.az}
98
+ x2={schematic.pier.bx}
99
+ y2={schematic.pier.bz}
100
+ stroke="#c9a06a"
101
+ strokeOpacity={0.75}
102
+ strokeWidth={1.6}
103
+ strokeLinecap="round"
104
+ />
105
+
106
+ {/* Deck outline, lanes and plazas, raised decks, callout labels —
107
+ all traced from the builder's schematic. */}
108
+ <rect
109
+ x={-schematic.deck.half}
110
+ y={-schematic.deck.half}
111
+ width={schematic.deck.half * 2}
112
+ height={schematic.deck.half * 2}
113
+ fill="#ffffff"
114
+ fillOpacity={0.04}
115
+ stroke="#ffffff"
116
+ strokeOpacity={0.3}
117
+ vectorEffect="non-scaling-stroke"
118
+ />
119
+ {schematic.areas.map((rect) => (
120
+ <AreaRect key={rect.join(",")} rect={rect} />
121
+ ))}
122
+ {schematic.raised.map((rect) => (
123
+ <AreaRect key={rect.join(",")} rect={rect} raised />
124
+ ))}
125
+ {schematic.labels.map((label) => (
126
+ <MapLabel key={label.text} label={label} />
127
+ ))}
128
+
129
+ {/* Facing cone, live enemy dots, player dot on top. */}
130
+ <path
131
+ d={`M ${playerX.toFixed(1)} ${playerZ.toFixed(1)} L ${coneEdge(facing - VIEW_CONE_HALF_ANGLE)} A ${VIEW_CONE_RADIUS} ${VIEW_CONE_RADIUS} 0 0 1 ${coneEdge(facing + VIEW_CONE_HALF_ANGLE)} Z`}
132
+ fill="#ffc861"
133
+ fillOpacity={0.16}
134
+ />
135
+ {blips.map((blip) => {
136
+ if (!blip.alive) return null;
137
+ const distance = Math.hypot(blip.x, blip.z);
138
+ const clamp = distance > DOT_CLAMP ? DOT_CLAMP / distance : 1;
139
+ return (
140
+ <circle
141
+ key={blip.id}
142
+ cx={(blip.x * clamp).toFixed(1)}
143
+ cy={(blip.z * clamp).toFixed(1)}
144
+ r={2}
145
+ fill="#ff5f4d"
146
+ />
147
+ );
148
+ })}
149
+ <circle
150
+ cx={playerX}
151
+ cy={playerZ}
152
+ r={2.4}
153
+ fill="#ffd166"
154
+ stroke="#3a2a08"
155
+ strokeWidth={0.8}
156
+ />
157
+ </g>
158
+ </svg>
159
+ <div className="absolute left-1/2 top-[7px] -translate-x-1/2 text-[9px] font-bold tracking-[0.2em] text-white/55">
160
+ N
161
+ </div>
162
+ </div>
163
+ );
164
+ }