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
@@ -0,0 +1,100 @@
1
+ /**
2
+ * Everything the HUD reads, and nothing it can derive for itself.
3
+ *
4
+ * The simulation owns the rules; the UI is a mirror. Two rules follow. First, the *rules table*
5
+ * (`TYPES` in `src/sim/types.ts`) is not published: the panel imports it and reads a unit's name,
6
+ * role and cost from the same source the pathfinder does, so a rebalance cannot leave the HUD
7
+ * quoting last season's numbers. Second, a value that changes every frame is counted or rounded
8
+ * here rather than sent raw, because the store is cloned whole for every playtest observation and
9
+ * a per-frame vector of sixty positions would cost more than the game it measures.
10
+ */
11
+ export type GameState = {
12
+ /** Ore, gas, and the supply the built structures grant. */
13
+ gas: number;
14
+ ore: number;
15
+ supplyCap: number;
16
+ supplyUsed: number;
17
+ /** What the commander has spent and banked. */
18
+ gathered: number;
19
+ kills: number;
20
+ /** Whole 0.05 s steps since the match started. */
21
+ simTime: number;
22
+ /** "victory", "defeat", or "" while the match runs. */
23
+ result: string;
24
+ /** The last thing the simulation reported, for the toast. */
25
+ notice: string;
26
+ /**
27
+ * The selection. `primaryType` is a key of the rules table and "" for an empty selection; the
28
+ * panel reads the rest of the unit's card out of that table rather than being told twice.
29
+ */
30
+ primaryType: string;
31
+ primaryTeam: number;
32
+ primaryHp: number;
33
+ primaryMaxHp: number;
34
+ primaryBuilt: boolean;
35
+ primaryProgress: number;
36
+ /** How many are selected, and how many distinct factions they belong to. */
37
+ selection: number;
38
+ selectionTeams: number;
39
+ /** Distinct order kinds across the selection, comma-joined, so the panel can say "3 mining". */
40
+ selectionOrder: string;
41
+ /** The primary selected entity's position, for the panel's readout and for a scenario. */
42
+ selectionX: number;
43
+ selectionZ: number;
44
+ /** The selected producer's queue, as `"<type>:<progress 0..1>"` strings. */
45
+ queue: string[];
46
+ /** The pending order mode: "", "build:<type>", "move", "attack", "garrison", "repair", "rally". */
47
+ mode: string;
48
+ /** Camera focus and zoom, so the minimap can draw the view rectangle. */
49
+ cameraX: number;
50
+ cameraZoom: number;
51
+ cameraZ: number;
52
+ /**
53
+ * The tactical overview, as one coarse raster plus one flat run of quads.
54
+ *
55
+ * `minimapFog` is `minimapSize²` characters, row-major: `.` never seen, `,` remembered, `#` in
56
+ * sight. `minimapDots` is `[x, z, team, kind, …]` in minimap pixels. Strings and numbers rather
57
+ * than an object per entity, because this is the one part of the state big enough to notice.
58
+ */
59
+ minimapDots: number[];
60
+ minimapFog: string;
61
+ /** The rubber band, in client pixels, or null. Drawn by the UI, not the scene. */
62
+ dragBox: number[] | null;
63
+ /** Set from the UI's pause and resume intents, and read back by the menu. */
64
+ paused: boolean;
65
+ /** True once the UI layer has rendered and published its interactive rectangles. */
66
+ uiReady: boolean;
67
+ };
68
+
69
+ export const INITIAL_STATE: GameState = {
70
+ cameraX: 0,
71
+ cameraZoom: 30,
72
+ cameraZ: 0,
73
+ dragBox: null,
74
+ gathered: 0,
75
+ gas: 0,
76
+ kills: 0,
77
+ minimapDots: [],
78
+ minimapFog: "",
79
+ mode: "",
80
+ notice: "",
81
+ ore: 0,
82
+ paused: false,
83
+ primaryBuilt: true,
84
+ primaryHp: 0,
85
+ primaryMaxHp: 0,
86
+ primaryProgress: 0,
87
+ primaryTeam: 0,
88
+ primaryType: "",
89
+ queue: [],
90
+ result: "",
91
+ selection: 0,
92
+ selectionOrder: "",
93
+ selectionTeams: 0,
94
+ selectionX: 0,
95
+ selectionZ: 0,
96
+ simTime: 0,
97
+ supplyCap: 0,
98
+ supplyUsed: 0,
99
+ uiReady: false,
100
+ };
@@ -1,17 +1,30 @@
1
1
  @import "tailwindcss";
2
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
+ */
3
10
  @source "../index.html";
4
11
  @source "./";
5
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
+ */
6
19
  @theme {
7
- --color-ink: #07131d;
8
- --color-panel: #0d2430;
9
- --color-line: #1d4a58;
10
- --color-lume: #f5c451;
11
- --color-win: #79e0b2;
12
- --color-danger: #ff7182;
13
- --color-text: #c1dce2;
14
- --color-muted: #6c9aa5;
20
+ --color-ink: #17384a;
21
+ --color-panel: #24566a;
22
+ --color-line: #55929a;
23
+ --color-lume: #c2f2d6;
24
+ --color-warn: #ffdda1;
25
+ --color-text: #eff6dc;
26
+ --color-dim: #b1d2c7;
27
+
15
28
  --font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;
16
29
  }
17
30
 
@@ -0,0 +1,21 @@
1
+ import type { IGame } from "@threenative/core";
2
+ import { DebugOverlay, GameCanvas } from "@threenative/ui";
3
+ import type { GameState } from "../state.js";
4
+ import { GameUi } from "./GameUi.js";
5
+
6
+ /**
7
+ * The web target's page: the canvas, then the same UI every other target renders.
8
+ *
9
+ * `GameCanvas` hosts the renderer and everything after it paints on top; keep the canvas first. The
10
+ * UI itself comes from `GameUi`, unchanged — this file exists only because the web build also has
11
+ * to put a canvas on the page.
12
+ */
13
+ export function App({ game }: { game: IGame<GameState, undefined> }) {
14
+ return (
15
+ <main className="relative h-screen w-screen overflow-hidden bg-ink">
16
+ <GameCanvas className="absolute inset-0" game={game} />
17
+ <GameUi />
18
+ <DebugOverlay />
19
+ </main>
20
+ );
21
+ }
@@ -0,0 +1,129 @@
1
+ import { useUiIntent, useUiState } from "@threenative/ui";
2
+ import { type BuildingType, type EntityType, TYPES } from "../sim/types.js";
3
+ import type { GameState } from "../state.js";
4
+
5
+ /** Every structure the rules table knows how to place, in the table's own order. */
6
+ const STRUCTURES = (Object.keys(TYPES) as EntityType[]).filter(
7
+ (type) => TYPES[type].building === true,
8
+ ) as BuildingType[];
9
+
10
+ /**
11
+ * The command panel: orders for what is selected, and the build menu.
12
+ *
13
+ * The panel never decides anything. Each button names an intent — `order`, `place`, `train` — and
14
+ * the scene decides what it means, which is why the same rules table the pathfinder reads is also
15
+ * the one that prices these buttons: a structure the player cannot afford is greyed out here
16
+ * because `canAfford` is the same arithmetic the simulation charges them with.
17
+ */
18
+ export function Commands() {
19
+ const state = useUiState<GameState>();
20
+ const send = useUiIntent();
21
+ if (state === undefined) return null;
22
+ const card = state.primaryType === "" ? undefined : TYPES[state.primaryType as EntityType];
23
+ const producer = card?.building === true ? (state.primaryType as EntityType) : undefined;
24
+ const placing = state.mode.startsWith("build:") ? state.mode.slice(6) : "";
25
+
26
+ return (
27
+ <section className="pointer-events-none absolute right-4 bottom-14 flex max-w-80 flex-col gap-2">
28
+ {producer === undefined ? null : (
29
+ <div className="flex flex-wrap justify-end gap-1">
30
+ {(card?.trains ?? []).map((type) => {
31
+ const cost = TYPES[type];
32
+ const afford = state.ore >= cost.ore && state.gas >= cost.gas;
33
+ return (
34
+ <Button
35
+ afford={afford}
36
+ key={type}
37
+ label={cost.name}
38
+ onClick={() => send("train", type)}
39
+ testid={`train-${type}`}
40
+ />
41
+ );
42
+ })}
43
+ </div>
44
+ )}
45
+ <div className="flex flex-wrap justify-end gap-1">
46
+ {state.selection === 0 ? null : (
47
+ <>
48
+ <Button
49
+ label="attack-move"
50
+ onClick={() => send("order", "attack")}
51
+ testid="order-attack"
52
+ />
53
+ <Button label="move" onClick={() => send("order", "move")} testid="order-move" />
54
+ <Button
55
+ label="garrison"
56
+ onClick={() => send("order", "garrison")}
57
+ testid="order-garrison"
58
+ />
59
+ <Button label="repair" onClick={() => send("order", "repair")} testid="order-repair" />
60
+ <Button label="retreat" onClick={() => send("retreat")} testid="order-retreat" />
61
+ </>
62
+ )}
63
+ <Button label="all army" onClick={() => send("army")} testid="order-army" />
64
+ <Button label="base" onClick={() => send("base")} testid="order-base" />
65
+ </div>
66
+ <div className="flex flex-wrap justify-end gap-1">
67
+ {STRUCTURES.map((type) => {
68
+ const cost = TYPES[type];
69
+ // Greying an unaffordable structure is the same arithmetic the simulation charges with.
70
+ // A structure whose prerequisite is missing is left enabled: the scene refuses it with a
71
+ // reason, which is more useful than a button that silently does nothing.
72
+ const afford = state.ore >= cost.ore && state.gas >= cost.gas;
73
+ return (
74
+ <Button
75
+ afford={afford}
76
+ key={type}
77
+ label={cost.name}
78
+ onClick={() => send("place", type)}
79
+ testid={`build-${type}`}
80
+ active={placing === type}
81
+ title={`${cost.name} — ${cost.ore} ore${cost.gas > 0 ? `, ${cost.gas} gas` : ""}`}
82
+ />
83
+ );
84
+ })}
85
+ </div>
86
+ <p className="text-right text-[10px] uppercase tracking-[0.14em] text-dim" id="command-hint">
87
+ {placing === ""
88
+ ? "drag to select · right-click to order · wheel to zoom"
89
+ : `placing ${TYPES[placing as BuildingType].name} — click the ground, esc to cancel`}
90
+ </p>
91
+ </section>
92
+ );
93
+ }
94
+
95
+ function Button({
96
+ active = false,
97
+ afford = true,
98
+ label,
99
+ onClick,
100
+ testid,
101
+ title,
102
+ }: {
103
+ readonly active?: boolean;
104
+ readonly afford?: boolean;
105
+ readonly label: string;
106
+ readonly onClick: () => void;
107
+ readonly testid: string;
108
+ readonly title?: string;
109
+ }) {
110
+ return (
111
+ <button
112
+ // The panel is `pointer-events-none` so its empty space hands the click to the battlefield
113
+ // underneath, which is what a strategy game needs: the only pixels that take a gesture are
114
+ // the buttons. A button inside a `none` island is inert until it opts back in, so this
115
+ // class is load-bearing rather than decoration — without it every order in this panel is
116
+ // dead to a mouse and only the keyboard can issue one.
117
+ className={`pointer-events-auto border px-2 py-1 text-[10px] uppercase tracking-[0.12em] ${
118
+ active ? "border-lume bg-lume/20 text-lume" : "border-line bg-panel/80 text-text"
119
+ } ${afford ? "" : "text-dim/60 line-through"}`}
120
+ data-tn-interactive
121
+ data-testid={testid}
122
+ onClick={onClick}
123
+ title={title}
124
+ type="button"
125
+ >
126
+ {label}
127
+ </button>
128
+ );
129
+ }
@@ -0,0 +1,22 @@
1
+ import { UiLayer } from "@threenative/ui";
2
+ import { Commands } from "./Commands.js";
3
+ import { Hud } from "./Hud.js";
4
+ import { Minimap } from "./Minimap.js";
5
+
6
+ /**
7
+ * Everything the player sees that is not the battlefield.
8
+ *
9
+ * One component, mounted twice by two entries that differ only in what else is on the page:
10
+ * `src/main.ts` puts it beside the canvas on the web target, and `src/ui/main.tsx` is the whole
11
+ * page the native web view loads. Keeping both entries pointed at this file is what makes "the
12
+ * same UI on every target" a fact rather than an intention.
13
+ */
14
+ export function GameUi() {
15
+ return (
16
+ <UiLayer>
17
+ <Hud />
18
+ <Minimap />
19
+ <Commands />
20
+ </UiLayer>
21
+ );
22
+ }
@@ -0,0 +1,165 @@
1
+ import { useUiIntent, useUiState } from "@threenative/ui";
2
+ import { type EntityType, TYPES } from "../sim/types.js";
3
+ import type { GameState } from "../state.js";
4
+
5
+ /** Read a `"<type>:<progress 0..1>"` pair back apart. */
6
+ function readQueueItem(entry: string): { progress: number; type: EntityType } | undefined {
7
+ const at = entry.lastIndexOf(":");
8
+ if (at < 1) return undefined;
9
+ const type = entry.slice(0, at) as EntityType;
10
+ const progress = Number(entry.slice(at + 1));
11
+ return TYPES[type] === undefined || !Number.isFinite(progress) ? undefined : { progress, type };
12
+ }
13
+
14
+ function clock(seconds: number): string {
15
+ const whole = Math.max(0, Math.floor(seconds));
16
+ return `${String(Math.floor(whole / 60)).padStart(2, "0")}:${String(whole % 60).padStart(2, "0")}`;
17
+ }
18
+
19
+ /**
20
+ * The top bar and the selection panel: what is banked, what is selected, what it is doing.
21
+ *
22
+ * Plain Tailwind, plain DOM, and the same file on every target. The unit's *name*, role and cost
23
+ * are not published by the game — they come out of the same rules table the pathfinder reads, so a
24
+ * rebalance cannot leave this panel quoting last season's numbers.
25
+ */
26
+ export function Hud() {
27
+ const state = useUiState<GameState>();
28
+ const send = useUiIntent();
29
+ // Nothing to draw until the game publishes its first snapshot. Rendering zeros instead would put
30
+ // a wrong supply figure on screen and then correct it.
31
+ if (state === undefined) return null;
32
+ const card = state.primaryType === "" ? undefined : TYPES[state.primaryType as EntityType];
33
+ const queue = state.queue
34
+ .map(readQueueItem)
35
+ .filter((item): item is { progress: number; type: EntityType } => item !== undefined);
36
+ const supplyBlocked = state.supplyUsed >= state.supplyCap;
37
+
38
+ return (
39
+ <>
40
+ <header className="pointer-events-none absolute inset-x-0 top-0 flex items-start justify-between gap-4 p-4">
41
+ <div className="flex items-center gap-5 bg-panel/80 px-4 py-2 text-lume">
42
+ <Stat label="ore" value={state.ore.toLocaleString()} id="ore" />
43
+ <Stat label="gas" value={state.gas.toLocaleString()} id="gas" />
44
+ <Stat
45
+ label="supply"
46
+ value={`${state.supplyUsed} / ${state.supplyCap}`}
47
+ id="supply"
48
+ warn={supplyBlocked}
49
+ />
50
+ <Stat label="clock" value={clock(state.simTime / 20)} id="clock" />
51
+ </div>
52
+ {state.notice === "" ? null : (
53
+ <output className="max-w-sm bg-panel/80 px-3 py-2 text-xs uppercase tracking-[0.14em] text-warn">
54
+ {state.notice}
55
+ </output>
56
+ )}
57
+ </header>
58
+
59
+ <section className="pointer-events-none absolute bottom-4 left-4 w-72 bg-panel/80 p-3">
60
+ <div className="flex items-baseline justify-between text-[10px] uppercase tracking-[0.14em] text-dim">
61
+ <span>{state.selection === 0 ? "no selection" : "strike group"}</span>
62
+ <span id="selection-count">{state.selection} selected</span>
63
+ </div>
64
+ <h2 className="mt-1 text-xl leading-none text-text">{card?.name ?? "Awaiting orders"}</h2>
65
+ <p className="mt-1 text-xs text-dim">{card?.role ?? "Select a unit or a structure."}</p>
66
+ <div className="relative mt-2 h-1.5 overflow-hidden border border-line bg-ink">
67
+ <i
68
+ className="absolute inset-y-0 left-0 bg-lume"
69
+ style={{
70
+ width: `${state.primaryMaxHp > 0 ? (state.primaryHp / state.primaryMaxHp) * 100 : 0}%`,
71
+ }}
72
+ />
73
+ </div>
74
+ <div className="mt-1 flex justify-between text-[10px] uppercase tracking-[0.14em] text-dim">
75
+ <span id="health">
76
+ {state.primaryMaxHp} / {state.primaryMaxHp}
77
+ </span>
78
+ <span id="selection-position">
79
+ {state.selectionX.toFixed(0)} · {state.selectionZ.toFixed(0)}
80
+ </span>
81
+ </div>
82
+ {state.primaryType === "" || state.primaryBuilt ? null : (
83
+ <p className="mt-2 text-[10px] uppercase tracking-[0.14em] text-lume">
84
+ site {Math.round(state.primaryProgress * 100)}%
85
+ </p>
86
+ )}
87
+ {queue.length === 0 ? null : (
88
+ <ul className="mt-2 flex flex-wrap gap-1">
89
+ {queue.map((item, index) => (
90
+ <li
91
+ className="relative h-6 w-12 overflow-hidden border border-line bg-ink text-[9px] uppercase tracking-[0.1em] text-text"
92
+ key={`${item.type}-${index}`}
93
+ >
94
+ <i
95
+ className="absolute inset-y-0 left-0 bg-panel"
96
+ style={{ width: `${item.progress * 100}%` }}
97
+ />
98
+ <span className="relative">{TYPES[item.type].name}</span>
99
+ </li>
100
+ ))}
101
+ </ul>
102
+ )}
103
+ {state.selectionOrder === "" ? null : (
104
+ <p className="mt-2 text-[10px] uppercase tracking-[0.14em] text-dim" id="selection-order">
105
+ {state.selectionOrder}
106
+ </p>
107
+ )}
108
+ </section>
109
+
110
+ {state.dragBox === null ? null : (
111
+ <div
112
+ className="pointer-events-none absolute border border-lume/80 bg-lume/10"
113
+ style={{
114
+ left: `${state.dragBox[0]}px`,
115
+ top: `${state.dragBox[1]}px`,
116
+ width: `${state.dragBox[2]}px`,
117
+ height: `${state.dragBox[3]}px`,
118
+ }}
119
+ />
120
+ )}
121
+ <p className="sr-only" id="selection-live">
122
+ {`${state.selection} selected, orders ${state.selectionOrder}`}
123
+ </p>
124
+ <div className="pointer-events-none absolute right-4 bottom-4 flex flex-col items-end gap-1">
125
+ {state.result === "" ? null : (
126
+ <span className="bg-panel/80 px-3 py-1 text-xs uppercase tracking-[0.2em] text-warn">
127
+ {state.result}
128
+ </span>
129
+ )}
130
+ <button
131
+ className="pointer-events-auto border border-line bg-panel/80 px-3 py-1 text-[10px] uppercase tracking-[0.14em] text-text"
132
+ data-tn-interactive
133
+ onClick={() => send(state.paused ? "resume" : "pause")}
134
+ type="button"
135
+ >
136
+ {state.paused ? "resume" : "pause"}
137
+ </button>
138
+ </div>
139
+ </>
140
+ );
141
+ }
142
+
143
+ function Stat({
144
+ id,
145
+ label,
146
+ value,
147
+ warn = false,
148
+ }: {
149
+ readonly id: string;
150
+ readonly label: string;
151
+ readonly value: string;
152
+ readonly warn?: boolean;
153
+ }) {
154
+ return (
155
+ <div>
156
+ <div className="text-[9px] uppercase tracking-[0.18em] text-dim">{label}</div>
157
+ <div
158
+ className={`text-lg leading-none tabular-nums ${warn ? "text-warn" : "text-text"}`}
159
+ id={id}
160
+ >
161
+ {value}
162
+ </div>
163
+ </div>
164
+ );
165
+ }
@@ -0,0 +1,84 @@
1
+ import { useUiState } from "@threenative/ui";
2
+ import { useEffect, useRef } from "react";
3
+ import { STARTS } from "../sim/terrain.js";
4
+ import type { GameState } from "../state.js";
5
+
6
+ const SIZE = 28;
7
+ /** Side of the minimap canvas in device pixels; the coarse raster is upscaled into it. */
8
+ const EDGE = "#d4f8ec";
9
+ const UNSEEN = "#0b1a20";
10
+ const EXPLORED = "#1b2f33";
11
+ const VISIBLE = "#33585a";
12
+ const ORE = "#76d3e7";
13
+ const GAS = "#b7dd77";
14
+
15
+ /**
16
+ * The tactical overview.
17
+ *
18
+ * A 28×28 character raster of the fog and a flat run of quads for everything on it, both
19
+ * published by the scene. Deliberately a canvas in the *UI* layer: this is a map, drawn in the
20
+ * layer that is allowed to be a document, and it is rebuilt only when the game replaces the
21
+ * payload, so the HUD and the map never disagree about a frame.
22
+ */
23
+ export function Minimap() {
24
+ const state = useUiState<GameState>();
25
+ const canvas = useRef<HTMLCanvasElement>(null);
26
+ // The two payloads are replaced only on the simulation's clock, so their identity is the
27
+ // redraw signal: this map repaints twenty times a second, not once per published frame.
28
+ const fog = state?.minimapFog;
29
+ const dots = state?.minimapDots;
30
+ const cameraX = state?.cameraX ?? 0;
31
+ const cameraZ = state?.cameraZ ?? 0;
32
+ const cameraZoom = state?.cameraZoom ?? 30;
33
+ useEffect(() => {
34
+ const host = canvas.current;
35
+ if (host === null || fog === undefined || fog === "") return;
36
+ const size = host.width;
37
+ const context = host.getContext("2d");
38
+ if (context === null) return;
39
+ const cell = size / SIZE;
40
+ for (let row = 0; row < SIZE; row += 1)
41
+ for (let column = 0; column < SIZE; column += 1) {
42
+ const mark = fog.charAt(row * SIZE + column);
43
+ context.fillStyle = mark === "#" ? VISIBLE : mark === "," ? EXPLORED : UNSEEN;
44
+ context.fillRect(column * cell, row * cell, cell + 0.5, cell + 0.5);
45
+ }
46
+ const contacts = dots ?? [];
47
+ for (let index = 0; index < contacts.length; index += 4) {
48
+ const x = (contacts[index] ?? 0) / 10;
49
+ const z = (contacts[index + 1] ?? 0) / 10;
50
+ const team = contacts[index + 2] ?? 0;
51
+ const kind = contacts[index + 3] ?? 0;
52
+ if (team === 9) {
53
+ context.fillStyle = kind === 2 ? ORE : GAS;
54
+ context.fillRect(x - 1, z - 1, 2.5, 2.5);
55
+ continue;
56
+ }
57
+ context.fillStyle = STARTS[team]?.css ?? EDGE;
58
+ if (kind === 1) context.fillRect(x - 2.5, z - 2.5, 5, 5);
59
+ else context.fillRect(x - 1.5, z - 1.5, 3, 3);
60
+ }
61
+ // The view rectangle: what the camera is actually looking at, at the map's own scale.
62
+ const span = cameraZoom;
63
+ const half = (span / SIZE) * (size / 2);
64
+ const cx = cameraX / 2 + size / 2;
65
+ const cz = cameraZ / 2 + size / 2;
66
+ context.strokeStyle = EDGE;
67
+ context.lineWidth = 1;
68
+ context.strokeRect(cx - half, cz - half, half * 2, half * 2);
69
+ }, [fog, dots, cameraX, cameraZ, cameraZoom]);
70
+
71
+ return (
72
+ <section className="pointer-events-none absolute right-4 bottom-56 bg-panel/80 p-2">
73
+ <div className="mb-1 text-[9px] uppercase tracking-[0.18em] text-dim">tactical overview</div>
74
+ <canvas
75
+ aria-label="Tactical overview"
76
+ className="block h-40 w-40 border border-line"
77
+ height={SIZE * 5}
78
+ ref={canvas}
79
+ role="img"
80
+ width={SIZE * 5}
81
+ />
82
+ </section>
83
+ );
84
+ }
@@ -0,0 +1,2 @@
1
+ // Tailwind 4 is CSS-first. Keep this file for familiar project discovery.
2
+ export default {};
@@ -0,0 +1,56 @@
1
+ import type { IThreeNativeConfig } from "@threenative/core";
2
+
3
+ const config: IThreeNativeConfig = {
4
+ app: {
5
+ id: "com.threenative.__PROJECT_ID__",
6
+ name: "__PROJECT_NAME__",
7
+ version: "1.0.0",
8
+ build: 1,
9
+ icon: "public/icon.png",
10
+ icons: { web: { favicon: "public/favicon.svg" } },
11
+ },
12
+ display: {
13
+ orientation: "landscape", // Mobile viewport orientation.
14
+ fullscreen: true, // Keep the game surface edge to edge.
15
+ keepScreenOn: true, // Do not dim during a play session.
16
+ maxFps: 60, // Set 120 to opt into a supported high-refresh display mode.
17
+ },
18
+ window: {
19
+ title: "__PROJECT_NAME__", // Desktop window title.
20
+ width: 1280,
21
+ height: 720,
22
+ maximized: false,
23
+ resizable: true,
24
+ },
25
+ bootSplash: {
26
+ backgroundColor: "#0d1b2a",
27
+ },
28
+ nativeEntry: "src/game.ts",
29
+ ui: { renderer: "native" }, // src/ui/ is the HUD on every target; this selects the native web view.
30
+ // One asset tree, one compiler, one representation per artifact. Uncomment, then cook:
31
+ // threenative build --target android # cooks defaults.android; --profile <name> beats it
32
+ // buildProfiles: {
33
+ // defaults: { android: "compact" },
34
+ // profiles: {
35
+ // compact: {
36
+ // assets: { textures: { maxSize: 1024 }, models: { textures: { maxSize: 1024 } } },
37
+ // } },
38
+ // },
39
+ // Contract, byte definitions, the build report:
40
+ // node_modules/create-threenative/agent-docs/references/build-profiles.md
41
+ renderer: {
42
+ preferWebGPU: true, // Use WebGPU when the host exposes it.
43
+ // The engine holds the `display.maxFps` budget by scaling the 3D drawing buffer, and reports
44
+ // the scale it settled on in every `TN_FRAME_BUDGET` window. Replace with a number in (0, 1]
45
+ // to pin it — the loop stops and the reporting does not. CSS, UI and camera framing never move.
46
+ resolutionScale: "auto",
47
+ // Multisampling resolves triangle edges. A cutout silhouette — foliage, a fence, hair — is
48
+ // carved inside the triangle by an alpha test, so it resolves through the coverage mask or
49
+ // not at all, which is what this spends the samples above on. It costs no target and no
50
+ // extra pass; set it false for a deliberately hard-edged look. `TN_ALPHA_ANTIALIASING`
51
+ // reports what it did, and says so when a single-sampled surface leaves it nothing to do.
52
+ alphaAntialiasing: true,
53
+ },
54
+ };
55
+
56
+ export default config;
@@ -0,0 +1,17 @@
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2022",
4
+ "lib": ["ES2022", "DOM", "DOM.Iterable"],
5
+ "module": "ESNext",
6
+ "moduleResolution": "bundler",
7
+ "jsx": "react-jsx",
8
+ "types": ["vite/client"],
9
+ "strict": true,
10
+ "noUncheckedIndexedAccess": true,
11
+ "noEmit": true,
12
+ "skipLibCheck": true,
13
+ "verbatimModuleSyntax": true,
14
+ "isolatedModules": true
15
+ },
16
+ "include": ["src/**/*.ts", "src/**/*.tsx", "tests/**/*.ts", "*.ts"]
17
+ }
@@ -14,9 +14,12 @@ function assetsWatchPlugin(): Plugin {
14
14
  return {
15
15
  name: "threenative-assets-watch",
16
16
  apply: "serve",
17
- configureServer(server) {
17
+ async configureServer(server) {
18
18
  const handle = watchAssets({ config: config.assets, cwd: server.config.root });
19
19
  server.httpServer?.once("close", () => handle.close());
20
+ // Nothing is served before the first cook settles: until it does, `public/` has no
21
+ // `assets.manifest.json` and every asset answers from its source fallback.
22
+ await handle.ready;
20
23
  },
21
24
  };
22
25
  }