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