create-threenative 0.2.5 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (631) hide show
  1. package/README.md +25 -3
  2. package/agent-docs/references/assertion-reference.md +40 -1
  3. package/agent-docs/references/build-profiles.md +126 -0
  4. package/agent-docs/references/capability-reference.md +1382 -65
  5. package/agent-docs/references/finding-assets.md +8 -1
  6. package/agent-docs/references/performance-basics.md +117 -0
  7. package/agent-docs/references/rigging-characters.md +51 -0
  8. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  9. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  10. package/agent-docs/references/visual-baseline.md +8 -4
  11. package/agent-docs/references/webview-ui.md +3 -2
  12. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  13. package/agent-files/.agents/skills/ponytail/SKILL.md +68 -0
  14. package/agent-files/.agents/skills/threenative-assets/SKILL.md +12 -4
  15. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  16. package/agent-files/.agents/skills/threenative-context/SKILL.md +9 -1
  17. package/agent-files/.agents/skills/threenative-performance/SKILL.md +26 -10
  18. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  19. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  20. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  21. package/agent-files/.claude/hooks/ponytail-context.mjs +51 -0
  22. package/agent-files/.claude/settings.json +38 -0
  23. package/agent-files/.codex/hooks.json +40 -0
  24. package/capabilities.json +1891 -101
  25. package/dist/index.d.ts +39 -1
  26. package/dist/index.js +480 -56
  27. package/dist/threenative.js +1247 -177
  28. package/package.json +6 -6
  29. package/template-assets/assets/mannequin-combat.glb +0 -0
  30. package/template-assets/assets/mannequin.glb +0 -0
  31. package/template-assets/assets/player-viewmodel.glb +0 -0
  32. package/template-assets/assets/sky.jpg +0 -0
  33. package/template-assets/clearwater/README.md +141 -0
  34. package/template-assets/clearwater/install.mjs +50 -0
  35. package/template-assets/clearwater/src/clearwater.ts +180 -0
  36. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  37. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  38. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  39. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  40. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  41. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  42. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  43. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  44. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  45. package/template-assets/patches/three@0.185.1.patch +2228 -105
  46. package/template-assets/worldEnvironment.ts +52 -1
  47. package/templates/action-rpg/AGENTS.md +43 -43
  48. package/templates/action-rpg/CLAUDE.md +43 -43
  49. package/templates/action-rpg/kit.json +1 -1
  50. package/templates/action-rpg/package.json +14 -8
  51. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  52. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  53. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  54. package/templates/action-rpg/src/conventions.ts +24 -18
  55. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  56. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  57. package/templates/action-rpg/src/entities/Player.ts +102 -32
  58. package/templates/action-rpg/src/game.ts +3 -3
  59. package/templates/action-rpg/src/render/camera.ts +18 -16
  60. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  61. package/templates/action-rpg/src/render/lighting.ts +45 -28
  62. package/templates/action-rpg/src/render/loading.ts +4 -4
  63. package/templates/action-rpg/src/render/materials.ts +191 -47
  64. package/templates/action-rpg/src/render/palette.ts +14 -13
  65. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  66. package/templates/action-rpg/src/render/props.ts +117 -0
  67. package/templates/action-rpg/src/render/quality.ts +40 -82
  68. package/templates/action-rpg/src/render/sky.ts +36 -13
  69. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  70. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  71. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  72. package/templates/action-rpg/src/style.css +9 -7
  73. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  74. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  75. package/templates/action-rpg/threenative.config.ts +14 -1
  76. package/templates/action-rpg/vite.config.ts +4 -1
  77. package/templates/minimal/AGENTS.md +12 -12
  78. package/templates/minimal/CLAUDE.md +12 -12
  79. package/templates/minimal/package.json +13 -7
  80. package/templates/minimal/playtests/play.playtest.json +6 -5
  81. package/templates/minimal/playtests/sky.playtest.json +27 -0
  82. package/templates/minimal/src/conventions.ts +6 -3
  83. package/templates/minimal/src/entities/Player.ts +73 -27
  84. package/templates/minimal/src/main.ts +2 -3
  85. package/templates/minimal/src/render/camera.ts +22 -4
  86. package/templates/minimal/src/render/lighting.ts +24 -48
  87. package/templates/minimal/src/render/materials.ts +158 -13
  88. package/templates/minimal/src/render/palette.ts +10 -7
  89. package/templates/minimal/src/render/postprocessing.ts +12 -25
  90. package/templates/minimal/src/render/quality.ts +35 -69
  91. package/templates/minimal/src/render/sky.ts +35 -54
  92. package/templates/minimal/src/render/touch-controls.ts +1 -1
  93. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  94. package/templates/minimal/src/scenes/Play.ts +121 -111
  95. package/templates/minimal/src/state.ts +0 -4
  96. package/templates/minimal/src/style.css +0 -10
  97. package/templates/minimal/threenative.config.ts +15 -1
  98. package/templates/minimal/vite.config.ts +4 -1
  99. package/templates/platformer/AGENTS.md +18 -56
  100. package/templates/platformer/CLAUDE.md +18 -56
  101. package/templates/platformer/kit.json +2 -2
  102. package/templates/platformer/package.json +14 -10
  103. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  104. package/templates/platformer/playtests/collect.playtest.json +8 -34
  105. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  106. package/templates/platformer/playtests/damage.playtest.json +40 -15
  107. package/templates/platformer/playtests/hud.playtest.json +34 -0
  108. package/templates/platformer/playtests/move.playtest.json +24 -0
  109. package/templates/platformer/playtests/performance.playtest.json +24 -7
  110. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  111. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  112. package/templates/platformer/playtests/survives.playtest.json +3 -19
  113. package/templates/platformer/playtests/world.playtest.json +26 -0
  114. package/templates/platformer/src/entities/Fox.ts +273 -0
  115. package/templates/platformer/src/entities/Pickup.ts +43 -60
  116. package/templates/platformer/src/entities/Walker.ts +88 -0
  117. package/templates/platformer/src/game.ts +11 -8
  118. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  119. package/templates/platformer/src/level/Stage.ts +469 -0
  120. package/templates/platformer/src/render/blocks.ts +94 -0
  121. package/templates/platformer/src/render/camera.ts +28 -3
  122. package/templates/platformer/src/render/fox.ts +196 -0
  123. package/templates/platformer/src/render/lighting.ts +42 -33
  124. package/templates/platformer/src/render/materials.ts +115 -5
  125. package/templates/platformer/src/render/palette.ts +68 -53
  126. package/templates/platformer/src/render/pickups.ts +142 -0
  127. package/templates/platformer/src/render/postprocessing.ts +12 -2
  128. package/templates/platformer/src/render/props.ts +147 -0
  129. package/templates/platformer/src/render/quality.ts +47 -99
  130. package/templates/platformer/src/render/scenery.ts +172 -0
  131. package/templates/platformer/src/render/sky.ts +120 -31
  132. package/templates/platformer/src/render/touch-controls.ts +5 -2
  133. package/templates/platformer/src/render/walkers.ts +96 -0
  134. package/templates/platformer/src/render/waterfall.ts +85 -0
  135. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  136. package/templates/platformer/src/scenes/Boot.ts +3 -4
  137. package/templates/platformer/src/scenes/Play.ts +362 -0
  138. package/templates/platformer/src/state.ts +16 -14
  139. package/templates/platformer/src/style.css +9 -8
  140. package/templates/platformer/src/ui/Hud.tsx +62 -29
  141. package/templates/platformer/src/ui/Menu.tsx +2 -2
  142. package/templates/platformer/threenative.config.ts +14 -1
  143. package/templates/platformer/vite.config.ts +4 -1
  144. package/templates/puzzle/AGENTS.md +21 -22
  145. package/templates/puzzle/CLAUDE.md +21 -22
  146. package/templates/puzzle/assets/native-proof.glb +0 -0
  147. package/templates/puzzle/assets/native-proof.png +0 -0
  148. package/templates/puzzle/kit.json +1 -1
  149. package/templates/puzzle/package.json +14 -8
  150. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  151. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  152. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  153. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  154. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  155. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  156. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  157. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  158. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  159. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  160. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  161. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  162. package/templates/puzzle/src/entities/Crate.ts +99 -42
  163. package/templates/puzzle/src/entities/Seal.ts +69 -0
  164. package/templates/puzzle/src/entities/Warden.ts +135 -0
  165. package/templates/puzzle/src/game.ts +15 -11
  166. package/templates/puzzle/src/render/camera.ts +66 -31
  167. package/templates/puzzle/src/render/crateShape.ts +70 -0
  168. package/templates/puzzle/src/render/lighting.ts +41 -41
  169. package/templates/puzzle/src/render/loading.ts +4 -4
  170. package/templates/puzzle/src/render/materials.ts +131 -27
  171. package/templates/puzzle/src/render/palette.ts +19 -29
  172. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  173. package/templates/puzzle/src/render/quality.ts +71 -80
  174. package/templates/puzzle/src/render/shapes.ts +109 -108
  175. package/templates/puzzle/src/render/sky.ts +18 -10
  176. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  177. package/templates/puzzle/src/render/vault.ts +315 -0
  178. package/templates/puzzle/src/render/warden.ts +46 -0
  179. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  180. package/templates/puzzle/src/scenes/Play.ts +793 -0
  181. package/templates/puzzle/src/state.ts +55 -24
  182. package/templates/puzzle/src/style.css +7 -8
  183. package/templates/puzzle/src/ui/App.tsx +2 -2
  184. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  185. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  186. package/templates/puzzle/threenative.config.ts +14 -1
  187. package/templates/puzzle/vite.config.ts +4 -1
  188. package/templates/racing/AGENTS.md +20 -21
  189. package/templates/racing/CLAUDE.md +20 -21
  190. package/templates/racing/package.json +14 -8
  191. package/templates/racing/playtests/boost.playtest.json +33 -12
  192. package/templates/racing/playtests/outcome.playtest.json +32 -50
  193. package/templates/racing/playtests/performance.playtest.json +2 -1
  194. package/templates/racing/playtests/ranking.playtest.json +5 -14
  195. package/templates/racing/playtests/rescue.playtest.json +2 -2
  196. package/templates/racing/playtests/reverse.playtest.json +30 -8
  197. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  198. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  199. package/templates/racing/src/entities/CarBody.ts +327 -0
  200. package/templates/racing/src/entities/LineDriver.ts +220 -0
  201. package/templates/racing/src/entities/RacingCar.ts +150 -89
  202. package/templates/racing/src/entities/Rival.ts +61 -24
  203. package/templates/racing/src/game.ts +5 -0
  204. package/templates/racing/src/render/camera.ts +49 -7
  205. package/templates/racing/src/render/lighting.ts +36 -37
  206. package/templates/racing/src/render/materials.ts +239 -19
  207. package/templates/racing/src/render/palette.ts +19 -21
  208. package/templates/racing/src/render/postprocessing.ts +12 -2
  209. package/templates/racing/src/render/quality.ts +43 -82
  210. package/templates/racing/src/render/shapes.ts +20 -6
  211. package/templates/racing/src/render/sky.ts +47 -39
  212. package/templates/racing/src/render/touch-controls.ts +1 -1
  213. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  214. package/templates/racing/src/scenes/Race.ts +107 -54
  215. package/templates/racing/src/state.ts +2 -0
  216. package/templates/racing/src/track/Checkline.ts +22 -7
  217. package/templates/racing/src/track/Lap.ts +64 -36
  218. package/templates/racing/src/track/Ranking.ts +20 -11
  219. package/templates/racing/src/track/Track.ts +809 -361
  220. package/templates/racing/src/track/TrackSector.ts +40 -11
  221. package/templates/racing/src/track/circuit.ts +477 -0
  222. package/templates/racing/src/track/rescue.ts +16 -4
  223. package/templates/racing/threenative.config.ts +14 -1
  224. package/templates/racing/vite.config.ts +4 -1
  225. package/templates/rts/AGENTS.md +96 -0
  226. package/templates/rts/CLAUDE.md +98 -0
  227. package/templates/rts/kit.json +7 -0
  228. package/templates/{defense → rts}/package.json +14 -8
  229. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  230. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  231. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  232. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  233. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  234. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  235. package/templates/rts/playtests/survives.playtest.json +58 -0
  236. package/templates/rts/public/favicon.svg +4 -0
  237. package/templates/rts/src/game.ts +64 -0
  238. package/templates/rts/src/orders.ts +22 -0
  239. package/templates/rts/src/render/army.ts +346 -0
  240. package/templates/rts/src/render/camera.ts +123 -0
  241. package/templates/rts/src/render/lighting.ts +61 -0
  242. package/templates/rts/src/render/loading.ts +33 -0
  243. package/templates/rts/src/render/materials.ts +152 -0
  244. package/templates/rts/src/render/models.ts +705 -0
  245. package/templates/rts/src/render/palette.ts +17 -0
  246. package/templates/rts/src/render/picking.ts +93 -0
  247. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  248. package/templates/rts/src/render/quality.ts +128 -0
  249. package/templates/rts/src/render/resources.ts +141 -0
  250. package/templates/rts/src/render/sky.ts +44 -0
  251. package/templates/rts/src/render/terrain.ts +116 -0
  252. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  253. package/templates/rts/src/scenes/Play.ts +650 -0
  254. package/templates/rts/src/sim/ai.ts +1140 -0
  255. package/templates/rts/src/sim/combat.ts +416 -0
  256. package/templates/rts/src/sim/construction.ts +374 -0
  257. package/templates/rts/src/sim/economy.ts +167 -0
  258. package/templates/rts/src/sim/game.ts +1082 -0
  259. package/templates/rts/src/sim/movement.ts +371 -0
  260. package/templates/rts/src/sim/nav.ts +276 -0
  261. package/templates/rts/src/sim/production.ts +180 -0
  262. package/templates/rts/src/sim/terrain.ts +170 -0
  263. package/templates/rts/src/sim/types.ts +647 -0
  264. package/templates/rts/src/sim/vision.ts +46 -0
  265. package/templates/rts/src/state.ts +100 -0
  266. package/templates/{defense → rts}/src/style.css +21 -8
  267. package/templates/rts/src/ui/App.tsx +21 -0
  268. package/templates/rts/src/ui/Commands.tsx +129 -0
  269. package/templates/rts/src/ui/GameUi.tsx +22 -0
  270. package/templates/rts/src/ui/Hud.tsx +165 -0
  271. package/templates/rts/src/ui/Minimap.tsx +84 -0
  272. package/templates/rts/tailwind.config.ts +2 -0
  273. package/templates/rts/threenative.config.ts +56 -0
  274. package/templates/rts/tsconfig.json +17 -0
  275. package/templates/{defense → rts}/vite.config.ts +4 -1
  276. package/templates/runner/AGENTS.md +8 -12
  277. package/templates/runner/CLAUDE.md +8 -12
  278. package/templates/runner/README.md +3 -3
  279. package/templates/runner/package.json +14 -8
  280. package/templates/runner/playtests/performance.playtest.json +2 -2
  281. package/templates/runner/src/conventions.ts +4 -3
  282. package/templates/runner/src/entities/Runner.ts +54 -7
  283. package/templates/runner/src/game.ts +2 -0
  284. package/templates/runner/src/render/camera.ts +4 -2
  285. package/templates/runner/src/render/dust.ts +5 -2
  286. package/templates/runner/src/render/lighting.ts +41 -45
  287. package/templates/runner/src/render/loading.ts +2 -2
  288. package/templates/runner/src/render/materials.ts +165 -25
  289. package/templates/runner/src/render/palette.ts +17 -28
  290. package/templates/runner/src/render/postprocessing.ts +12 -2
  291. package/templates/runner/src/render/quality.ts +42 -96
  292. package/templates/runner/src/render/shapes.ts +59 -37
  293. package/templates/runner/src/render/sky.ts +32 -41
  294. package/templates/runner/src/render/touch-controls.ts +1 -1
  295. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  296. package/templates/runner/src/scenes/Run.ts +26 -6
  297. package/templates/runner/src/track.ts +6 -1
  298. package/templates/runner/threenative.config.ts +14 -1
  299. package/templates/runner/vite.config.ts +4 -1
  300. package/templates/sailing/AGENTS.md +14 -14
  301. package/templates/sailing/CLAUDE.md +14 -14
  302. package/templates/sailing/assets/ship.glb +0 -0
  303. package/templates/sailing/package.json +14 -8
  304. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  305. package/templates/sailing/playtests/sails.playtest.json +33 -0
  306. package/templates/sailing/playtests/win.playtest.json +156 -8
  307. package/templates/sailing/src/conventions.ts +29 -2
  308. package/templates/sailing/src/entities/Ship.ts +381 -57
  309. package/templates/sailing/src/game.ts +14 -0
  310. package/templates/sailing/src/render/camera.ts +63 -9
  311. package/templates/sailing/src/render/lighting.ts +49 -27
  312. package/templates/sailing/src/render/materials.ts +50 -15
  313. package/templates/sailing/src/render/ocean.ts +647 -60
  314. package/templates/sailing/src/render/palette.ts +16 -12
  315. package/templates/sailing/src/render/postprocessing.ts +12 -2
  316. package/templates/sailing/src/render/props.ts +316 -442
  317. package/templates/sailing/src/render/quality.ts +14 -4
  318. package/templates/sailing/src/render/sky.ts +116 -23
  319. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  320. package/templates/sailing/src/scenes/Boot.ts +21 -0
  321. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  322. package/templates/sailing/src/state.ts +6 -0
  323. package/templates/sailing/src/ui/Hud.tsx +41 -9
  324. package/templates/sailing/threenative.config.ts +14 -1
  325. package/templates/sailing/vite.config.ts +4 -1
  326. package/templates/shooter/AGENTS.md +29 -44
  327. package/templates/shooter/CLAUDE.md +29 -44
  328. package/templates/shooter/index.html +1 -0
  329. package/templates/shooter/package.json +14 -8
  330. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  331. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  332. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  333. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  334. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  335. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  336. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  337. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  338. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  339. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  340. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  341. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  342. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  343. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  344. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  345. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  346. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  347. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  348. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  349. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  350. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  351. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  352. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  353. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  354. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  355. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  356. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  357. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  358. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  359. package/templates/shooter/playtests/performance.playtest.json +62 -26
  360. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  361. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  362. package/templates/shooter/playtests/survives.playtest.json +36 -30
  363. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  364. package/templates/shooter/src/entities/Breakables.ts +412 -0
  365. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  366. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  367. package/templates/shooter/src/entities/Rifle.ts +442 -0
  368. package/templates/shooter/src/entities/Target.ts +199 -83
  369. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  370. package/templates/shooter/src/game.ts +75 -41
  371. package/templates/shooter/src/main.ts +0 -1
  372. package/templates/shooter/src/postPhysics.ts +36 -0
  373. package/templates/shooter/src/render/camera.ts +78 -74
  374. package/templates/shooter/src/render/decals.ts +142 -82
  375. package/templates/shooter/src/render/facade.ts +1373 -0
  376. package/templates/shooter/src/render/gunfx.ts +704 -0
  377. package/templates/shooter/src/render/lighting.ts +52 -38
  378. package/templates/shooter/src/render/loading.ts +2 -2
  379. package/templates/shooter/src/render/materials.ts +100 -88
  380. package/templates/shooter/src/render/occlusion.ts +108 -0
  381. package/templates/shooter/src/render/palette.ts +10 -10
  382. package/templates/shooter/src/render/palm.ts +455 -0
  383. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  384. package/templates/shooter/src/render/postprocessing.ts +15 -3
  385. package/templates/shooter/src/render/quality.ts +40 -82
  386. package/templates/shooter/src/render/scale.ts +148 -15
  387. package/templates/shooter/src/render/shapes.ts +138 -613
  388. package/templates/shooter/src/render/sky.ts +35 -35
  389. package/templates/shooter/src/render/town-schematic.ts +120 -0
  390. package/templates/shooter/src/render/town.ts +986 -0
  391. package/templates/shooter/src/render/townMaterials.ts +160 -0
  392. package/templates/shooter/src/render/vehicles.ts +741 -0
  393. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  394. package/templates/shooter/src/scenes/Play.ts +727 -650
  395. package/templates/shooter/src/state.ts +26 -41
  396. package/templates/shooter/src/style.css +207 -11
  397. package/templates/shooter/src/surfaces.ts +131 -0
  398. package/templates/shooter/src/ui/App.tsx +9 -10
  399. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  400. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  401. package/templates/shooter/src/ui/Hud.tsx +428 -39
  402. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  403. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  404. package/templates/shooter/src/ui/main.tsx +2 -3
  405. package/templates/shooter/threenative.config.ts +14 -1
  406. package/templates/shooter/vite.config.ts +4 -1
  407. package/templates/starter/AGENTS.md +20 -20
  408. package/templates/starter/CLAUDE.md +20 -20
  409. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  410. package/templates/starter/package.json +15 -9
  411. package/templates/starter/playtests/play.playtest.json +2 -1
  412. package/templates/starter/playtests/{restart.playtest.json → production-readiness.playtest.json} +17 -12
  413. package/templates/starter/playtests/survives.playtest.json +1 -1
  414. package/templates/starter/src/conventions.ts +6 -3
  415. package/templates/starter/src/entities/Goal.ts +35 -42
  416. package/templates/starter/src/entities/Player.ts +99 -16
  417. package/templates/starter/src/render/arena.ts +131 -0
  418. package/templates/starter/src/render/lighting.ts +27 -44
  419. package/templates/starter/src/render/materials.ts +164 -35
  420. package/templates/starter/src/render/palette.ts +16 -16
  421. package/templates/starter/src/render/postprocessing.ts +6 -7
  422. package/templates/starter/src/render/quality.ts +43 -101
  423. package/templates/starter/src/render/shapes.ts +1 -1
  424. package/templates/starter/src/render/sky.ts +39 -45
  425. package/templates/starter/src/render/touch-controls.ts +3 -1
  426. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  427. package/templates/starter/src/scenes/Play.ts +82 -81
  428. package/templates/starter/src/ui/Hud.tsx +2 -2
  429. package/templates/starter/src/ui/Menu.tsx +5 -1
  430. package/templates/starter/threenative.config.ts +14 -1
  431. package/templates/starter/vite.config.ts +4 -1
  432. package/templates/tower-defense/.codex/config.toml +19 -0
  433. package/templates/tower-defense/.cursor/mcp.json +32 -0
  434. package/templates/tower-defense/.gemini/settings.json +32 -0
  435. package/templates/tower-defense/.mcp.json +32 -0
  436. package/templates/tower-defense/.vscode/mcp.json +36 -0
  437. package/templates/tower-defense/.zed/settings.json +36 -0
  438. package/templates/{defense → tower-defense}/AGENTS.md +16 -14
  439. package/templates/{defense → tower-defense}/CLAUDE.md +16 -14
  440. package/templates/tower-defense/README.md +16 -0
  441. package/templates/tower-defense/index.html +12 -0
  442. package/templates/tower-defense/kit.json +7 -0
  443. package/templates/tower-defense/opencode.json +41 -0
  444. package/templates/tower-defense/package.json +56 -0
  445. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  446. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  447. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  448. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  449. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  450. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  451. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  452. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  453. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  454. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  455. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  456. package/templates/tower-defense/src/balance.ts +187 -0
  457. package/templates/tower-defense/src/board/Board.ts +100 -0
  458. package/templates/tower-defense/src/board/Route.ts +84 -0
  459. package/templates/tower-defense/src/camera-rig.ts +62 -0
  460. package/templates/tower-defense/src/economy.ts +64 -0
  461. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  462. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  463. package/templates/tower-defense/src/game.ts +72 -0
  464. package/templates/tower-defense/src/intents.ts +21 -0
  465. package/templates/tower-defense/src/main.ts +15 -0
  466. package/templates/tower-defense/src/physics.ts +6 -0
  467. package/templates/tower-defense/src/render/camera.ts +38 -0
  468. package/templates/tower-defense/src/render/lighting.ts +42 -0
  469. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  470. package/templates/tower-defense/src/render/materials.ts +103 -0
  471. package/templates/tower-defense/src/render/palette.ts +58 -0
  472. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  473. package/templates/tower-defense/src/render/quality.ts +128 -0
  474. package/templates/tower-defense/src/render/shapes.ts +550 -0
  475. package/templates/tower-defense/src/render/sky.ts +27 -0
  476. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  477. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  478. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  479. package/templates/tower-defense/src/state.ts +88 -0
  480. package/templates/tower-defense/src/style.css +137 -0
  481. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  482. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  483. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  484. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  485. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  486. package/templates/tower-defense/src/ui/main.tsx +14 -0
  487. package/templates/tower-defense/src/waves.ts +90 -0
  488. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  489. package/templates/tower-defense/vite.config.ts +41 -0
  490. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  491. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  492. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -45
  493. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  494. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -57
  495. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -42
  496. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  497. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  498. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  499. package/agent-files/AGENT-ROLES.md +0 -26
  500. package/templates/action-rpg/src/render/shapes.ts +0 -269
  501. package/templates/action-rpg/src/render/types.ts +0 -3
  502. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  503. package/templates/defense/README.md +0 -10
  504. package/templates/defense/kit.json +0 -7
  505. package/templates/defense/playtests/leak.playtest.json +0 -23
  506. package/templates/defense/playtests/placement.playtest.json +0 -40
  507. package/templates/defense/playtests/scan.playtest.json +0 -20
  508. package/templates/defense/playtests/survive.playtest.json +0 -45
  509. package/templates/defense/playtests/survives.playtest.json +0 -36
  510. package/templates/defense/src/attackers/Attacker.ts +0 -120
  511. package/templates/defense/src/board/Route.ts +0 -94
  512. package/templates/defense/src/conventions.ts +0 -18
  513. package/templates/defense/src/economy.ts +0 -36
  514. package/templates/defense/src/entities/Player.ts +0 -52
  515. package/templates/defense/src/game.ts +0 -51
  516. package/templates/defense/src/physics.ts +0 -13
  517. package/templates/defense/src/placement/Buildable.ts +0 -49
  518. package/templates/defense/src/render/camera.ts +0 -16
  519. package/templates/defense/src/render/lighting.ts +0 -37
  520. package/templates/defense/src/render/materials.ts +0 -22
  521. package/templates/defense/src/render/palette.ts +0 -28
  522. package/templates/defense/src/render/quality.ts +0 -170
  523. package/templates/defense/src/render/shapes.ts +0 -246
  524. package/templates/defense/src/render/sky.ts +0 -45
  525. package/templates/defense/src/scenes/Boot.ts +0 -12
  526. package/templates/defense/src/scenes/Defense.ts +0 -231
  527. package/templates/defense/src/state.ts +0 -56
  528. package/templates/defense/src/towers/Tower.ts +0 -95
  529. package/templates/defense/src/towers/targeting.ts +0 -53
  530. package/templates/defense/src/ui/Hud.tsx +0 -62
  531. package/templates/defense/src/ui/Menu.tsx +0 -7
  532. package/templates/defense/src/waves.ts +0 -40
  533. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  534. package/templates/minimal/src/render/hud.ts +0 -69
  535. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  536. package/templates/platformer/playtests/chase.playtest.json +0 -21
  537. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  538. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  539. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  540. package/templates/platformer/playtests/physics.playtest.json +0 -14
  541. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  542. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  543. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  544. package/templates/platformer/src/conventions.ts +0 -18
  545. package/templates/platformer/src/entities/Character.ts +0 -286
  546. package/templates/platformer/src/entities/Chaser.ts +0 -118
  547. package/templates/platformer/src/entities/Patrol.ts +0 -93
  548. package/templates/platformer/src/level/Platform.ts +0 -46
  549. package/templates/platformer/src/render/rig.ts +0 -60
  550. package/templates/platformer/src/render/terrain.ts +0 -31
  551. package/templates/platformer/src/scenes/Level.ts +0 -241
  552. package/templates/puzzle/README.md +0 -43
  553. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  554. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  555. package/templates/puzzle/src/conventions.ts +0 -25
  556. package/templates/puzzle/src/entities/Ball.ts +0 -70
  557. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  558. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  559. package/templates/puzzle/src/physics.ts +0 -19
  560. package/templates/puzzle/src/room.ts +0 -83
  561. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  562. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  563. package/templates/shooter/playtests/combat.playtest.json +0 -48
  564. package/templates/shooter/playtests/fail.playtest.json +0 -31
  565. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  566. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  567. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  568. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  569. package/templates/shooter/src/combat/damage.ts +0 -40
  570. package/templates/shooter/src/conventions.ts +0 -51
  571. package/templates/shooter/src/entities/Pickup.ts +0 -70
  572. package/templates/shooter/src/entities/Player.ts +0 -310
  573. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  574. package/templates/shooter/src/playtest-events.ts +0 -15
  575. package/templates/shooter/src/render/touch-controls.ts +0 -305
  576. package/templates/shooter/src/render/types.ts +0 -3
  577. package/templates/shooter/src/render/ui.css +0 -330
  578. package/templates/shooter/src/render/ui.ts +0 -75
  579. package/templates/shooter/src/render/vfx.ts +0 -215
  580. package/templates/shooter/src/ui/Menu.tsx +0 -41
  581. package/templates/shooter/src/waves.ts +0 -50
  582. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  583. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  584. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  585. package/templates/starter/playtests/assets.playtest.json +0 -65
  586. package/templates/starter/playtests/buffer.playtest.json +0 -79
  587. package/templates/starter/playtests/cloth.playtest.json +0 -113
  588. package/templates/starter/playtests/coyote.playtest.json +0 -87
  589. package/templates/starter/playtests/gameover.playtest.json +0 -66
  590. package/templates/starter/playtests/goal.playtest.json +0 -67
  591. package/templates/starter/playtests/look.playtest.json +0 -175
  592. package/templates/starter/playtests/models-baseline.png +0 -0
  593. package/templates/starter/playtests/models.playtest.json +0 -74
  594. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  595. package/templates/starter/playtests/odometer.playtest.json +0 -54
  596. package/templates/starter/playtests/seed.playtest.json +0 -54
  597. package/templates/starter/playtests/textures-baseline.png +0 -0
  598. package/templates/starter/playtests/textures.playtest.json +0 -74
  599. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  600. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  601. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  602. package/templates/starter/src/render/coast.ts +0 -199
  603. package/templates/starter/src/render/hero.ts +0 -88
  604. package/templates/starter/src/render/implicitSurface.ts +0 -199
  605. package/templates/starter/src/render/kuwahara.ts +0 -174
  606. package/templates/starter/src/render/outline.ts +0 -141
  607. package/templates/starter/src/render/painterly.ts +0 -86
  608. package/templates/starter/src/render/rockRidge.ts +0 -198
  609. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  610. package/templates/starter/src/render/scenery.ts +0 -40
  611. package/templates/starter/src/render/textureLifetime.ts +0 -53
  612. package/templates/starter/src/render/water.ts +0 -38
  613. package/templates/starter/src/render/watercolor.ts +0 -85
  614. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  615. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  616. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  617. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  618. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  619. /package/templates/{defense → rts}/.mcp.json +0 -0
  620. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  621. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  622. /package/templates/{defense → rts}/index.html +0 -0
  623. /package/templates/{defense → rts}/opencode.json +0 -0
  624. /package/templates/{defense → rts}/src/main.ts +0 -0
  625. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  626. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  627. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  628. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  629. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  630. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  631. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -0,0 +1,17 @@
1
+ // Generated for you. Keep these roles coherent when you change the look.
2
+ // A lit grid over rock: one light ground, one dark ground for the slopes a tank cannot climb, and
3
+ // the three faction colours the simulation already owns (`STARTS` in src/sim/terrain.ts).
4
+ export const palette = {
5
+ /** Buildable ground: the light grid. */
6
+ ground: 0x6f6a55,
7
+ /** Cliffs, ramps and the map edge: the same grid, far darker. */
8
+ cliff: 0x35322b,
9
+ /** The grid line both grounds share, and every route ring's outline. */
10
+ gridLine: 0x24231f,
11
+ /** Ground nobody has ever seen. */
12
+ unseen: 0x0b1a20,
13
+ /** The sky photograph's own horizon, measured from its HDR: distance fades into this. */
14
+ horizon: 0xacb1c1,
15
+ /** The one saturated colour: what the player can touch. */
16
+ accent: 0xffffff,
17
+ } as const;
@@ -0,0 +1,93 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // Selection, in screen space, the way a strategy game does it: a click is the nearest thing to
4
+ // the cursor, a drag is everything whose footprint the rectangle touched. Both work off the
5
+ // simulation's own positions, so there is no picking layer to keep in step with the rules — what
6
+ // you can click is what exists, under the same fog of war the fog of war draws.
7
+ import type { Camera } from "three";
8
+ import type { Game } from "../sim/game.js";
9
+ import { terrainHeight } from "../sim/terrain.js";
10
+ import type { IEntity } from "../sim/types.js";
11
+ import { type IRtsView, type IViewSize, toScreen } from "./camera.js";
12
+
13
+ export interface IPoint2 {
14
+ readonly x: number;
15
+ readonly y: number;
16
+ }
17
+
18
+ /** What a click landed on: a unit or a building, or nothing. */
19
+ export type PickTarget = IEntity | undefined;
20
+
21
+ /** Everything the player is allowed to know about: their own, and what their units can see. */
22
+ function visible(game: Game, entity: IEntity): boolean {
23
+ if (entity.team === 0) return true;
24
+ return game.visibleAt(entity.x, entity.z);
25
+ }
26
+
27
+ /** Height a click aims at: the middle of the model, not its feet. */
28
+ function aimHeight(entity: IEntity): number {
29
+ return terrainHeight(entity.x, entity.z) + (entity.altitude || 0) + entity.r + 0.4;
30
+ }
31
+
32
+ /**
33
+ * The nearest selectable thing under the cursor.
34
+ *
35
+ * A screen-space radius rather than a ray: at this zoom a `ranger` is about thirteen pixels
36
+ * across, which is smaller than the cursor, and a ray against a nine-part instanced model would
37
+ * need the whole instancing layer behind it to answer. The radius is derived from the same
38
+ * collision radius the pathfinder uses, so what is clickable is what is walkable-around.
39
+ */
40
+ export function pickEntity(
41
+ game: Game,
42
+ camera: Camera,
43
+ view: IRtsView,
44
+ size: IViewSize,
45
+ x: number,
46
+ y: number,
47
+ ): PickTarget {
48
+ let best: PickTarget;
49
+ let bestDistance = Number.POSITIVE_INFINITY;
50
+ for (const entity of game.entities) {
51
+ if (entity.garrisonId !== null || !visible(game, entity)) continue;
52
+ const point = toScreen(camera, entity.x, aimHeight(entity), entity.z, size);
53
+ const radius = Math.max(entity.building ? 24 : 13, entity.r * (size.height / view.zoom) * 0.55);
54
+ const distance = Math.hypot(point.x - x, point.y - y);
55
+ if (distance < radius && distance < bestDistance) {
56
+ bestDistance = distance;
57
+ best = entity;
58
+ }
59
+ }
60
+ return best;
61
+ }
62
+
63
+ /**
64
+ * The player's own mobile units whose footprint the drag rectangle touched.
65
+ *
66
+ * Workers are excluded unless the drag started with Alt held: an army box that scooped up the
67
+ * mining crew is the single most common way to lose a strategy game, and the modifier is how every
68
+ * genre in this shape solves it.
69
+ */
70
+ export function unitsInBox(
71
+ game: Game,
72
+ camera: Camera,
73
+ view: IRtsView,
74
+ size: IViewSize,
75
+ from: IPoint2,
76
+ to: IPoint2,
77
+ includeWorkers: boolean,
78
+ into: number[],
79
+ ): number[] {
80
+ const left = Math.min(from.x, to.x);
81
+ const right = Math.max(from.x, to.x);
82
+ const top = Math.min(from.y, to.y);
83
+ const bottom = Math.max(from.y, to.y);
84
+ into.length = 0;
85
+ for (const entity of game.own()) {
86
+ if (entity.building || entity.garrisonId !== null) continue;
87
+ const point = toScreen(camera, entity.x, aimHeight(entity), entity.z, size);
88
+ if (point.x < left || point.x > right || point.y < top || point.y > bottom) continue;
89
+ if (!includeWorkers && entity.type === "worker") continue;
90
+ into.push(entity.id);
91
+ }
92
+ return into;
93
+ }
@@ -22,13 +22,25 @@ export function setupPost(
22
22
  environment: {
23
23
  godraysLight?: DirectionalLight;
24
24
  mobile?: boolean;
25
+ /** The renderer named a software adapter; this game's answer is its `low` tier. */
26
+ software?: boolean;
25
27
  /** Forces a tier, ignoring `mobile`. An unknown name throws rather than falling back. */
26
28
  tier?: QualityTier;
27
29
  } = {},
28
30
  ): void {
29
- const tier = resolveQualityTier({ mobile: environment.mobile, tier: environment.tier });
31
+ const tier = resolveQualityTier({
32
+ mobile: environment.mobile,
33
+ software: environment.software,
34
+ tier: environment.tier,
35
+ });
30
36
  const source = environment.tier === undefined ? "platform" : "override";
31
- console.info(`TN_QUALITY_TIER ${tier} mobile=${environment.mobile === true} source=${source}`);
37
+ console.info(
38
+ `TN_QUALITY_TIER ${tier} mobile=${environment.mobile === true} software=${
39
+ environment.software === true
40
+ } source=${source}`,
41
+ );
32
42
  const world = new WorldEnvironment(qualityPreset(tier));
33
- world.apply(renderer, scene, camera, { godraysLight: environment.godraysLight });
43
+ world.apply(renderer, scene, camera, {
44
+ godraysLight: environment.godraysLight,
45
+ });
34
46
  }
@@ -0,0 +1,128 @@
1
+ // Generated for you: ordinary Three.js; ThreeNative does not read this file. Delete or rewrite
2
+ // it freely — the tiers below are a starting point, not a framework look.
3
+ //
4
+ // This is the one place this game decides how expensive it looks. `postprocessing.ts` reads
5
+ // `qualityPreset(resolveQualityTier(...))` and nothing else, so "make it run on a phone" is one
6
+ // file to edit rather than a hunt through anonymous literals.
7
+ //
8
+ // **Where the numbers come from.** Every millisecond below is GPU time from the per-stage
9
+ // ablation recorded in the engine repository's `docs/verification/runtime-perf-state.md`: Chrome
10
+ // on an RTX 2080, 1600x900, static build, `gpuMs` read from three's `timestamp-query`. In that
11
+ // scene the whole five-stage chain costs **12.5 ms of a 14.7 ms GPU frame**, and the same frame
12
+ // with every stage off costs **2.2 ms**. The per-stage figures oversum — removing SSGI also
13
+ // removes the denoise passes the later stages sample — so read each as *what turning this one off
14
+ // gave back*, not as a share of a partition. A stage nobody has ablated on its own says
15
+ // `unmeasured` rather than guessing, and your scene is not that scene: read `TN_FRAME_BUDGET`
16
+ // back after you change a tier.
17
+ //
18
+ // One cost that is **not** a stage here and outweighs most of them: the prefiltered reflection
19
+ // probe on `scene.environment`, measured at **~6.3 ms of an 18-19 ms Pixel 8 frame**. It is set
20
+ // in `sky.ts`, not in this file.
21
+ //
22
+ // **This template runs no SSGI at any tier, and that is a measurement rather than a taste.** Its
23
+ // sky, sun colour and depth haze are a volumetric `Atmosphere`, which already owns most of the
24
+ // frame. With the gather on, `playtests/play.playtest.json` measured **34.2 ms p95 against the
25
+ // 33 ms ceiling**; without it the same scenario passes. Turn it on when you replace the
26
+ // atmosphere with a flat sky, and read the p95 back out of `TN_FRAME_BUDGET`.
27
+ import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
28
+
29
+ /**
30
+ * The three names this game's look comes in.
31
+ *
32
+ * `low` is what a phone gets and `high` what a desktop gets — those two are this template's
33
+ * shipped looks, unchanged. `medium` is the rung in between for a machine that is neither: a
34
+ * laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
35
+ * what any of them mean.
36
+ */
37
+ export type QualityTier = "low" | "medium" | "high";
38
+
39
+ const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
40
+
41
+ /**
42
+ * Narrows an arbitrary string — a URL parameter, a saved setting — to a tier name. Not exported:
43
+ * `resolveQualityTier` is the one door in, so an unknown name cannot be waved past the throw.
44
+ */
45
+ function isQualityTier(value: string): value is QualityTier {
46
+ return (QUALITY_TIERS as readonly string[]).includes(value);
47
+ }
48
+
49
+ /**
50
+ * Picks the tier: an explicit `tier` always wins, otherwise the platform decides.
51
+ *
52
+ * Fails closed. An unrecognised tier name throws with the value it was handed rather than
53
+ * quietly rendering the default, because a silent fallback here looks exactly like a tier that
54
+ * turned out to have no effect.
55
+ */
56
+ export function resolveQualityTier(
57
+ request: { readonly mobile?: boolean; readonly software?: boolean; readonly tier?: string } = {},
58
+ ): QualityTier {
59
+ const requested = request.tier;
60
+ if (requested !== undefined) {
61
+ if (!isQualityTier(requested)) {
62
+ throw new Error(
63
+ `Unknown quality tier ${JSON.stringify(requested)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
64
+ );
65
+ }
66
+ return requested;
67
+ }
68
+ // A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
69
+ // game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
70
+ // drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
71
+ // fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
72
+ // `tier` above still wins over it.
73
+ if (request.software === true) return "low";
74
+ return request.mobile === true ? "low" : "high";
75
+ }
76
+
77
+ /**
78
+ * The look every tier shares: a wide, faint glow on what is genuinely brighter than white — the sun
79
+ * disk, the visor — rather than a haze over the frame (a threshold under 1 blooms lit grey walls and
80
+ * flattens contrast), and a corner falloff. Antialiasing is on in every tier that installs a chain;
81
+ * see `screenSpaceAA` in `worldEnvironment.ts`.
82
+ *
83
+ * No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
84
+ * captured sky (`sky.ts`), and SSR on rough floors traced speckle into the grid; RCAS then rang the
85
+ * smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
86
+ */
87
+ const shared: IWorldEnvironmentOptions = {
88
+ // Bloom: ~4.6 ms in the reference ablation — the second most expensive stage there.
89
+ bloomEnabled: true,
90
+ bloomRadius: 0.6,
91
+ bloomStrength: 0.22,
92
+ bloomThreshold: 1,
93
+ exposure: 0.62,
94
+ tonemapMode: "aces",
95
+ vignetteAmount: 0.22,
96
+ };
97
+
98
+ /**
99
+ * What a desktop gets: contact occlusion on top — the dark line where a foot meets the floor and a
100
+ * wall meets the ground, most of what separates "objects in a world" from "objects pasted on a
101
+ * background". Gathered at full resolution and denoised: at half, the upsample left a grain around
102
+ * every foot.
103
+ */
104
+ const high: IWorldEnvironmentOptions = {
105
+ ...shared,
106
+ // GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
107
+ gtaoEnabled: true,
108
+ gtaoRadius: 0.35,
109
+ };
110
+
111
+ /** The rung in between: the same occlusion at half the directions. Saving unmeasured. */
112
+ const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8 };
113
+
114
+ /** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
115
+ const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
116
+
117
+ const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
118
+
119
+ /** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
120
+ export function qualityPreset(tier: string): IWorldEnvironmentOptions {
121
+ const preset = QUALITY_PRESETS[tier as QualityTier];
122
+ if (preset === undefined) {
123
+ throw new Error(
124
+ `Unknown quality tier ${JSON.stringify(tier)} — expected one of ${QUALITY_TIERS.join(", ")}.`,
125
+ );
126
+ }
127
+ return preset;
128
+ }
@@ -0,0 +1,141 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // The two things worth walking to: an ore field and a gas vent. Both are instanced and both are
4
+ // cut by the same fog of war as the terrain — a vent nobody has scouted is not on the map, and an
5
+ // ore field visibly shortens as the Surveyors empty it, so the economy is legible from the field
6
+ // alone without opening a panel.
7
+ import {
8
+ Color,
9
+ ConeGeometry,
10
+ CylinderGeometry,
11
+ IcosahedronGeometry,
12
+ InstancedMesh,
13
+ MeshStandardMaterial,
14
+ Object3D,
15
+ } from "three";
16
+ import type { Game } from "../sim/game.js";
17
+ import { HALF, RESOURCE_SITES, terrainHeight } from "../sim/terrain.js";
18
+
19
+ /** Seven crystals per ore node, as authored: the multiplier is what makes a field read as one
20
+ * deposit rather than as seven unrelated props. */
21
+ const CRYSTALS = 7;
22
+ const ROCKS = 5;
23
+ const CRYSTAL_TINT = new Color(0x8ae5f1);
24
+ const CRYSTAL_BASE = new Color(0xffffff);
25
+ const CRYSTAL_HEIGHT = [1.05, 1.6, 2.15, 2.7, 3.25] as const;
26
+
27
+ const _dummy = new Object3D();
28
+
29
+ export interface IResources {
30
+ readonly root: Object3D;
31
+ readonly sync: (game: Game) => void;
32
+ readonly dispose: () => void;
33
+ }
34
+
35
+ export function createResources(): IResources {
36
+ const root = new Object3D();
37
+ const sites = RESOURCE_SITES.length;
38
+ const crystals = new InstancedMesh(
39
+ new ConeGeometry(0.55, 1, 5),
40
+ new MeshStandardMaterial({
41
+ color: 0x38a5c5,
42
+ emissive: 0x065572,
43
+ metalness: 0.5,
44
+ roughness: 0.2,
45
+ }),
46
+ sites * CRYSTALS * 7,
47
+ );
48
+ const vents = new InstancedMesh(
49
+ new CylinderGeometry(2.5, 2.7, 0.35, 6),
50
+ new MeshStandardMaterial({ color: 0x314b39, roughness: 0.9 }),
51
+ sites,
52
+ );
53
+ const rubble = new InstancedMesh(
54
+ new IcosahedronGeometry(0.7, 0),
55
+ new MeshStandardMaterial({ color: 0x6b7050, roughness: 1 }),
56
+ sites * ROCKS,
57
+ );
58
+ // Listed once: the sync below walks this every frame, and a literal here is an array a frame.
59
+ const meshes = [crystals, vents, rubble];
60
+ for (const mesh of meshes) {
61
+ mesh.castShadow = true;
62
+ mesh.receiveShadow = true;
63
+ mesh.frustumCulled = false;
64
+ mesh.count = 0;
65
+ root.add(mesh);
66
+ }
67
+ return {
68
+ root,
69
+ sync: (game) => {
70
+ let crystal = 0;
71
+ let vent = 0;
72
+ let rock = 0;
73
+ for (const node of game.nodes) {
74
+ if (node.amount <= 0 || !scouted(game, node.x, node.z)) continue;
75
+ const ground = terrainHeight(node.x, node.z);
76
+ if (node.kind === "ore") {
77
+ // A field that has been half mined is half as tall, which is the whole readout.
78
+ const left = 0.4 + 0.6 * Math.min(1, node.amount / 2100);
79
+ for (let index = 0; index < CRYSTALS; index += 1) {
80
+ const angle = 0.15 + (index / CRYSTALS) * Math.PI * 1.8;
81
+ const spread = (node.r * 0.78 * (1 + (index % 3))) / 3;
82
+ const height = (CRYSTAL_HEIGHT[index % CRYSTAL_HEIGHT.length] ?? 1) * left;
83
+ _dummy.position.set(
84
+ node.x + Math.cos(angle) * spread,
85
+ ground + height * 0.47,
86
+ node.z + Math.sin(angle) * spread,
87
+ );
88
+ _dummy.rotation.set(((index % 5) - 2) * 0.08, angle, ((index % 3) - 1) * 0.16);
89
+ _dummy.scale.set(0.46 + (index % 3) * 0.14, height, 0.5 + (index % 2) * 0.2);
90
+ _dummy.updateMatrix();
91
+ crystals.setMatrixAt(crystal, _dummy.matrix);
92
+ crystals.setColorAt(crystal, index % 3 === 0 ? CRYSTAL_TINT : CRYSTAL_BASE);
93
+ crystal += 1;
94
+ }
95
+ } else {
96
+ _dummy.position.set(node.x, ground + 0.18, node.z);
97
+ _dummy.rotation.set(0, node.x * 0.1, 0);
98
+ _dummy.scale.set(1, 1, 1);
99
+ _dummy.updateMatrix();
100
+ vents.setMatrixAt(vent, _dummy.matrix);
101
+ vent += 1;
102
+ for (let index = 0; index < ROCKS; index += 1) {
103
+ const angle = (index / ROCKS) * Math.PI * 2;
104
+ _dummy.position.set(
105
+ node.x + Math.cos(angle) * 2,
106
+ ground + 0.3,
107
+ node.z + Math.sin(angle) * 2,
108
+ );
109
+ _dummy.rotation.set(angle, angle * 1.7, 0);
110
+ _dummy.scale.setScalar(0.85 + (index % 3) * 0.18);
111
+ _dummy.updateMatrix();
112
+ rubble.setMatrixAt(rock, _dummy.matrix);
113
+ rock += 1;
114
+ }
115
+ }
116
+ }
117
+ crystals.count = crystal;
118
+ vents.count = vent;
119
+ rubble.count = rock;
120
+ for (const mesh of meshes) {
121
+ mesh.instanceMatrix.needsUpdate = true;
122
+ if (mesh.instanceColor !== null) mesh.instanceColor.needsUpdate = true;
123
+ if (mesh.count > 0) mesh.computeBoundingSphere();
124
+ }
125
+ },
126
+ dispose: () => {
127
+ for (const mesh of meshes) {
128
+ mesh.geometry.dispose();
129
+ (mesh.material as MeshStandardMaterial).dispose();
130
+ }
131
+ },
132
+ };
133
+ }
134
+
135
+ /** Whether the cell has ever been seen: the fog of war applies to the map, not just the armies. */
136
+ function scouted(game: Game, x: number, z: number): boolean {
137
+ const ix = Math.floor((x + HALF) / game.cell);
138
+ const iz = Math.floor((z + HALF) / game.cell);
139
+ if (ix < 0 || iz < 0 || ix >= game.gridSize || iz >= game.gridSize) return false;
140
+ return game.explored[iz * game.gridSize + ix] === 1;
141
+ }
@@ -0,0 +1,44 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
4
+ // by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
5
+ // The same image is the background, the environment light every surface reflects and is filled by,
6
+ // and — through `SUN_DIRECTION` — the direction the sun's shadows fall. Swap the file for any
7
+ // equirectangular sky and re-aim `SUN_DIRECTION` at its sun.
8
+ import {
9
+ EquirectangularReflectionMapping,
10
+ FogExp2,
11
+ SRGBColorSpace,
12
+ type Scene,
13
+ type Texture,
14
+ Vector3,
15
+ } from "three";
16
+ import { palette } from "./palette.js";
17
+
18
+ /**
19
+ * How the JPEG was made from the 4k HDR: linear radiance × 0.4, clipped, sRGB-encoded — so white
20
+ * in the file is 2.5 in the sky. Multiplying back restores the HDR brightness of the clouds; the sun
21
+ * disk itself is clipped, which is why the sun is a light (`lighting.ts`) and not a texel.
22
+ */
23
+ const SKY_RANGE = 2.5;
24
+
25
+ /** Unit vector toward the photographed sun: 47.9° up, measured from the source HDR. */
26
+ export const SUN_DIRECTION = new Vector3(0.555, 0.742, 0.38).normalize();
27
+
28
+ export function setupSky(scene: Scene, sky: Texture): void {
29
+ sky.mapping = EquirectangularReflectionMapping;
30
+ sky.colorSpace = SRGBColorSpace;
31
+ scene.background = sky;
32
+ scene.backgroundIntensity = SKY_RANGE;
33
+ // three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
34
+ // It is what makes a standard material read as a material: sky-blue fill on faces the sun
35
+ // misses, and a sky to reflect, sharper as roughness drops.
36
+ scene.environment = sky;
37
+ scene.environmentIntensity = SKY_RANGE;
38
+ // Tuned for a 224 m battlefield rather than a 36 m arena, and then tuned again: the first
39
+ // value meant to hide the map's far edge (0.0075) hazed the fog of war away with it, because a
40
+ // cell the player has never seen is 60 m away and a distant cell is 150. At 0.0035 the far corner
41
+ // is a quarter hazed and an unexplored cell next to the camera is 4% — the haze stays a horizon
42
+ // instead of becoming the map.
43
+ scene.fog = new FogExp2(palette.horizon, 0.0035);
44
+ }
@@ -0,0 +1,116 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // The battlefield: a plane displaced by the simulation's own `terrainHeight`, so the art, the
4
+ // navigation grid and every click agree about where the ground is by construction. What the ground
5
+ // *looks* like is `materials.ts`; this file is the ground itself, its water, and the one texture
6
+ // the fog of war lives in.
7
+ import {
8
+ DataTexture,
9
+ InstancedMesh,
10
+ LinearFilter,
11
+ Mesh,
12
+ MeshStandardMaterial,
13
+ Object3D,
14
+ PlaneGeometry,
15
+ } from "three";
16
+ import type { Game } from "../sim/game.js";
17
+ import { MAP_CELL, POOLS, WORLD, terrainHeight } from "../sim/terrain.js";
18
+ import {
19
+ createTerrainMaterial,
20
+ createWaterMaterial,
21
+ waterDisc,
22
+ worldMetreUVs,
23
+ } from "./materials.js";
24
+ import { palette } from "./palette.js";
25
+
26
+ /**
27
+ * Quads across the map: one every 2 m, which is exactly the simulation's navigation cell, so the
28
+ * drawn surface and the walkable surface are the same resolution. Measured, not guessed: at 176
29
+ * segments this plane was 31 000 triangles and cost 5.3 s of boot compile here, against 12 600 and
30
+ * 2.8 s at 112 — and the heightfield is two octaves of smooth noise, so there is nothing between
31
+ * the vertices for the extra rings to find.
32
+ */
33
+ const SEGMENTS = 112;
34
+
35
+ /**
36
+ * The plain the battlefield stands on, in metres across and in metres below the map.
37
+ *
38
+ * Wide enough that the widest zoom cannot reach its edge: the rig's ground parallelogram reaches
39
+ * about 195 m from the origin at most, so 800 is four times the reach. Low enough to sit under
40
+ * every hollow the simulation digs — the deepest pool bed is 1.45 m up, the water 0.18 m up — and
41
+ * high enough that the terrain's own lowest ground, 0.15 m, never sinks into it.
42
+ */
43
+ const APRON = 800;
44
+ const APRON_Y = -1.75;
45
+
46
+ export interface ITerrain {
47
+ /** Rewrite the fog texture from the simulation's vision arrays. Cheap; not every frame. */
48
+ readonly updateFog: (game: Game) => void;
49
+ readonly root: Object3D;
50
+ }
51
+
52
+ export function createTerrain(): ITerrain {
53
+ const root = new Object3D();
54
+
55
+ const geometry = new PlaneGeometry(WORLD, WORLD, SEGMENTS, SEGMENTS).rotateX(-Math.PI / 2);
56
+ const position = geometry.getAttribute("position");
57
+ for (let index = 0; index < position.count; index += 1)
58
+ position.setY(index, terrainHeight(position.getX(index), position.getZ(index)));
59
+ geometry.computeVertexNormals();
60
+ worldMetreUVs(geometry);
61
+
62
+ // 102 = never seen, 191 = remembered, 255 = in sight right now.
63
+ const cells = WORLD / MAP_CELL;
64
+ const fogBytes = new Uint8Array(cells * cells * 4);
65
+ const fog = new DataTexture(fogBytes, cells, cells);
66
+ fog.minFilter = LinearFilter;
67
+ fog.magFilter = LinearFilter;
68
+ fog.needsUpdate = true;
69
+
70
+ const ground = new Mesh(geometry, createTerrainMaterial(fog));
71
+ ground.receiveShadow = true;
72
+ root.add(ground);
73
+
74
+ // The plain the battlefield stands on, so no camera angle looks off the map into a void.
75
+ //
76
+ // The orthographic rig covers a 228 m x 128 m parallelogram of ground at its widest zoom —
77
+ // wider than the 224 m map — and an orthographic camera's rays are parallel, so every one of
78
+ // them meets the ground at the same depth: past the map's rim there is nothing left to hit, and
79
+ // the background, sampled at the one direction every ray shares, filled the corner of the frame
80
+ // with a flat grey wedge. One plane, two triangles, below the deepest pool bed so no water is
81
+ // covered, and the battlefield reads as a plateau over a plain instead of a floating sheet.
82
+ const plain = new Mesh(
83
+ new PlaneGeometry(APRON, APRON).rotateX(-Math.PI / 2),
84
+ new MeshStandardMaterial({ color: palette.cliff, roughness: 1 }),
85
+ );
86
+ plain.position.y = APRON_Y;
87
+ root.add(plain);
88
+
89
+ // The pools the simulation refuses to path across: one instanced disc, so four lakes cost one
90
+ // draw. The matrices never move, so the pool is sized for the world's sites rather than grown.
91
+ const water = new InstancedMesh(waterDisc(), createWaterMaterial(), POOLS.length);
92
+ const dummy = new Object3D();
93
+ POOLS.forEach((pool, index) => {
94
+ dummy.position.set(pool.x, -0.18, pool.z);
95
+ dummy.scale.set(pool.rx * 1.04, 1, pool.rz * 1.04);
96
+ dummy.updateMatrix();
97
+ water.setMatrixAt(index, dummy.matrix);
98
+ });
99
+ water.renderOrder = 1;
100
+ root.add(water);
101
+
102
+ return {
103
+ root,
104
+ updateFog: (game) => {
105
+ const size = game.gridSize;
106
+ for (let cell = 0; cell < size * size; cell += 1) {
107
+ const value = game.visible[cell] === 1 ? 255 : game.explored[cell] === 1 ? 191 : 102;
108
+ fogBytes[cell * 4] = value;
109
+ fogBytes[cell * 4 + 1] = value;
110
+ fogBytes[cell * 4 + 2] = value;
111
+ fogBytes[cell * 4 + 3] = 255;
112
+ }
113
+ fog.needsUpdate = true;
114
+ },
115
+ };
116
+ }