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,55 +1,55 @@
1
- import {
2
- AmbientLight,
3
- DirectionalLight,
4
- HemisphereLight,
5
- PCFSoftShadowMap,
6
- type Scene,
7
- } from "three";
8
- 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
+ // A dark room with two warm lamps in it (authored with the props themselves, in `vault.ts`). The
5
+ // whole read of this picture is that the *ambient* is almost nothing and every bright surface is
6
+ // bright because a named source is pointing at it, so the temptation to raise the fill until the
7
+ // crates are comfortably visible has to be resisted: the moment the floor stops being near-black
8
+ // the picture stops being a vault.
9
+ import { DirectionalLight, HemisphereLight, PCFSoftShadowMap, type Scene } from "three";
9
10
 
10
11
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
11
12
 
12
- /**
13
- * Key, fill, rim, ambient — named, so each one can be changed on its own.
14
- *
15
- * An indoor contraption room lives or dies on contact shadows: the player has to see that a crate
16
- * is *on* the floor and that the ball is *touching* the ramp, or every physical judgement becomes
17
- * a guess. So the key is hard, with a tight shadow frustum.
18
- *
19
- * It is also nearly overhead, and that was a fix rather than a preference. A key at fifteen
20
- * degrees off the horizon threw the left wall across half the play area, and the first capture
21
- * had a black floor on one side and a legible one on the other — the room looked broken. In an
22
- * interior with walls this tall, the key belongs above the room and the fill has to be strong
23
- * enough that its shadow still has a readable floor inside it.
24
- *
25
- * Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow map, so
26
- * the scene hands the sun to `setupPost` and a shadowless light is refused by name instead of
27
- * rendering a black pass.
28
- */
29
- export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
13
+ /** Returns the key light: the godrays stage raymarches a shadow map and refuses a shadowless one. */
14
+ export function setupLighting(
15
+ scene: Scene,
16
+ renderer: ShadowRenderer,
17
+ mobile = false,
18
+ ): DirectionalLight {
30
19
  renderer.shadowMap.enabled = true;
31
20
  renderer.shadowMap.type = PCFSoftShadowMap;
32
- scene.add(new HemisphereLight(palette.skyLow, palette.floor, 2.4));
33
21
 
34
- const key = new DirectionalLight(0xfff2dd, 3);
35
- key.position.set(-4, 24, 7);
22
+ // Sky above, floor bounce below, both cold and both very quiet.
23
+ scene.add(new HemisphereLight(0x33456a, 0x171d29, 0.6));
24
+
25
+ // The key. Warm, high, and from the lantern side, so crate tops catch a little of the same
26
+ // colour the plaster does and the shadows all fall the same way.
27
+ const key = new DirectionalLight(0xf4e8da, 0.8);
28
+ key.position.set(-7, 15, 5);
36
29
  key.castShadow = true;
37
- key.shadow.mapSize.set(1024, 1024);
38
- key.shadow.camera.near = 0.5;
39
- key.shadow.camera.far = 70;
40
- key.shadow.camera.left = -18;
41
- key.shadow.camera.right = 18;
42
- key.shadow.camera.top = 18;
43
- key.shadow.camera.bottom = -18;
30
+ const size = mobile ? 1024 : 2048;
31
+ key.shadow.mapSize.set(size, size);
32
+ key.shadow.camera.near = 1;
33
+ key.shadow.camera.far = 46;
34
+ // The extent covers the whole room and nothing else: the vault is 16 x 11 metres and a shadow
35
+ // camera any wider spends its texels outside the walls.
36
+ const extent = 10;
37
+ key.shadow.camera.left = -extent;
38
+ key.shadow.camera.right = extent;
39
+ key.shadow.camera.top = extent;
40
+ key.shadow.camera.bottom = -extent;
41
+ key.shadow.bias = -0.0006;
42
+ // Rounded geometry self-shadows at grazing angles without this, and the bias alone would have
43
+ // to grow big enough to detach the contact shadow under every crate.
44
44
  key.shadow.normalBias = 0.035;
45
45
  scene.add(key);
46
46
 
47
- // Cool, from behind and low: it separates the steel and the wall tops from the dark beyond the
48
- // room without adding a second set of shadows to read.
49
- const rim = new DirectionalLight(palette.skyLow, 1.3);
50
- rim.position.set(9, 5, -14);
47
+ // The rim: cold, low and shadowless, from the far corner the lanterns never reach. A crate's
48
+ // shadowed side is otherwise the same black as the floor it stands on, and the pile stops
49
+ // reading as forty separate boxes.
50
+ const rim = new DirectionalLight(0x5f7fb0, 0.24);
51
+ rim.position.set(9, 5, -7);
51
52
  scene.add(rim);
52
- scene.add(new AmbientLight(palette.skyLow, 0.5));
53
53
 
54
54
  return key;
55
55
  }
@@ -12,17 +12,17 @@ import {
12
12
  import { palette } from "./palette.js";
13
13
 
14
14
  /* BEGIN THREENATIVE LOADING APPEARANCE */
15
- /** Puzzle look and composition; edit this generated source to change the screen. */
15
+ /** Vault look and composition; edit this generated source to change the screen. */
16
16
  export const loading = {
17
- backgroundColor: palette.skyLow,
17
+ backgroundColor: palette.void,
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,
25
- bar: { anchorX: 0.5, anchorY: 0.76, height: 11, maxWidth: 520, minWidth: 1, width: 0.6 },
24
+ trackColor: palette.timber,
25
+ bar: { anchorX: 0.5, anchorY: 0.72, height: 12, maxWidth: 520, minWidth: 1, width: 0.62 },
26
26
  } as const;
27
27
  /* END THREENATIVE LOADING APPEARANCE */
28
28
 
@@ -1,28 +1,132 @@
1
- import { MeshStandardMaterial } from "three";
2
- import { palette, surface } from "./palette.js";
3
-
4
- export function createMaterials() {
5
- return {
6
- // Steel is the wall grey read at low roughness and high metalness. A ball that is a different
7
- // hue from the room reads as a sticker on it; one that is the same grey, polished, reads as
8
- // a machined part of the same place.
9
- ball: surface(palette.wall, 0.2, 0.72),
10
- crate: surface(palette.accent, 0.62),
11
- floor: surface(palette.floor, 0.95),
12
- // The goal carries the same accent as the crates and separates from them by being emissive
13
- // and translucent — a light in the floor rather than a seventh colour in the palette.
14
- goal: new MeshStandardMaterial({
15
- color: palette.accent,
16
- emissive: palette.accent,
17
- emissiveIntensity: 1.15,
18
- opacity: 0.55,
19
- roughness: 0.4,
20
- transparent: true,
21
- }),
22
- shadow: new MeshStandardMaterial({ color: palette.shadow, roughness: 1 }),
23
- steel: surface(palette.wall, 0.34, 0.55),
24
- // A half-step above the floor slab, mixed from the two greys the palette already names.
25
- tile: surface(0x2c3644, 0.93),
26
- wall: surface(palette.wall, 0.88),
27
- };
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // One material per role, shared by every mesh that plays that role, so the whole vault is a couple
5
+ // of dozen draw-call-sharing surfaces rather than four hundred unique ones. Surface variety comes
6
+ // from alternating entries, never from a bitmap: `CanvasTexture` samples BLACK under
7
+ // `WebGPURenderer`, and a flagstone seam drawn as geometry reads correctly on every target.
8
+ //
9
+ // The room needs more tints than `palette.ts` has roles, so they live here, beside the material
10
+ // that wears them, and `palette.ts` keeps the six that are contracts rather than choices.
11
+
12
+ import {
13
+ Color,
14
+ DoubleSide,
15
+ type Material,
16
+ MeshBasicMaterial,
17
+ MeshStandardMaterial,
18
+ type Texture,
19
+ } from "three";
20
+ import { palette } from "./palette.js";
21
+
22
+ /** The seams between flagstones: one step darker than the floor, never black. */
23
+ const SEAM = 0x171d29;
24
+ /** The dark plinth under the plaster, and the skirting at the floor. */
25
+ const WALL_BASE = 0x2b3242;
26
+ /** Cut stone, not timber: the kerb the seal is set into. Never emissive. */
27
+ const SEAL_STONE = 0x434d5d;
28
+ /** The diamond insets and the rail highlights. */
29
+ const TIMBER_LIGHT = 0x8f6742;
30
+ /** The plank braces nailed across every crate face. */
31
+ const CRATE_BRACE = 0x3d2a1a;
32
+ /** The second crate tint, sea teal. `palette.prop` is the first. */
33
+ const CRATE_TEAL = 0x2b9187;
34
+ /** The third crate tint, amber. */
35
+ const CRATE_AMBER = 0xdb9835;
36
+ /** Hanging banners on the east wall. */
37
+ const BANNER = 0x1d3a5c;
38
+ /** The warden: unpainted, matte, the lightest thing in the room. */
39
+ const WARDEN = 0xefe7d6;
40
+
41
+ /** Lantern flame. Exported because the point light beside each flame is this same colour. */
42
+ export const LANTERN = 0xff9a3c;
43
+
44
+ export const floorMaterial = new MeshStandardMaterial({
45
+ color: palette.floor,
46
+ metalness: 0.04,
47
+ roughness: 0.86,
48
+ });
49
+
50
+ export const floorSeamMaterial = new MeshStandardMaterial({ color: SEAM, roughness: 0.95 });
51
+
52
+ export const wallMaterial = new MeshStandardMaterial({ color: palette.wall, roughness: 0.92 });
53
+
54
+ export const wallBaseMaterial = new MeshStandardMaterial({ color: WALL_BASE, roughness: 0.9 });
55
+
56
+ export const timberMaterial = new MeshStandardMaterial({ color: palette.timber, roughness: 0.82 });
57
+
58
+ export const timberLightMaterial = new MeshStandardMaterial({
59
+ color: TIMBER_LIGHT,
60
+ roughness: 0.74,
61
+ });
62
+
63
+ /**
64
+ * The three crate tints, cycled across the pile by a seeded draw. Three are the whole reason the
65
+ * pile reads as a heap of crates rather than as one mass of colour: with one tint, forty bodies of
66
+ * it are forty of the same thing.
67
+ */
68
+ export const crateMaterials: readonly Material[] = [
69
+ new MeshStandardMaterial({ color: palette.prop, roughness: 0.72 }),
70
+ new MeshStandardMaterial({ color: CRATE_TEAL, roughness: 0.72 }),
71
+ new MeshStandardMaterial({ color: CRATE_AMBER, roughness: 0.72 }),
72
+ ];
73
+
74
+ /** The battens nailed across a crate's faces. Untextured on purpose: a batten is 6 cm thick. */
75
+ export const crateBraceMaterial = new MeshStandardMaterial({ color: CRATE_BRACE, roughness: 0.86 });
76
+
77
+ /**
78
+ * A phase crate: the accent, emissive and translucent, so the room reads straight through it.
79
+ *
80
+ * A glass shell plus an emissive edge cage (`phaseCoreMaterial`), so it still reads as a
81
+ * solid-shaped object rather than as a smudge. Emissive as well as lit because the collider behind
82
+ * it is one a body can walk through, and the material is the only thing saying so before you try.
83
+ */
84
+ export const phaseMaterial = new MeshStandardMaterial({
85
+ color: palette.accent,
86
+ emissive: new Color(palette.accent).multiplyScalar(0.34),
87
+ metalness: 0,
88
+ opacity: 0.55,
89
+ roughness: 0.1,
90
+ transparent: true,
91
+ });
92
+
93
+ /**
94
+ * The edge cage inside a phase crate. Dimmer than the palette entry: at full value the ward clips
95
+ * to white under bloom and stops reading as a crate-shaped thing at all.
96
+ */
97
+ export const phaseCoreMaterial = new MeshBasicMaterial({
98
+ color: new Color(palette.accent).multiplyScalar(0.46),
99
+ });
100
+
101
+ /**
102
+ * The lantern flame. Below full value on purpose: an unclamped emissive at this bloom threshold
103
+ * turns each lantern into a white disc and the wall behind it into a wash.
104
+ */
105
+ export const lanternMaterial = new MeshBasicMaterial({
106
+ color: new Color(LANTERN).multiplyScalar(0.8),
107
+ });
108
+
109
+ export const bannerMaterial = new MeshStandardMaterial({
110
+ color: BANNER,
111
+ roughness: 0.95,
112
+ side: DoubleSide,
113
+ });
114
+
115
+ /**
116
+ * The kerb around the seal. Cut stone: it was emissive for one iteration and the whole plate
117
+ * clipped to a white square under bloom, and the seal is supposed to be the bright thing, not its
118
+ * frame.
119
+ */
120
+ export const sealRimMaterial = new MeshStandardMaterial({ color: SEAL_STONE, roughness: 0.82 });
121
+
122
+ export const wardenMaterial = new MeshStandardMaterial({ color: WARDEN, roughness: 0.62 });
123
+
124
+ export const wardenFootMaterial = new MeshStandardMaterial({
125
+ color: new Color(WARDEN).multiplyScalar(0.72),
126
+ roughness: 0.7,
127
+ });
128
+
129
+ /** The packaged proof glTF hangs on the east wall as a banner; it owns its sampled look. */
130
+ export function createBannerMaterial(texture: Texture): Material {
131
+ return new MeshBasicMaterial({ map: texture, side: DoubleSide });
28
132
  }
@@ -1,31 +1,21 @@
1
- import { MeshStandardMaterial } from "three";
2
-
3
- /**
4
- * The room's colours, in one place. Six names, one accent.
5
- *
6
- * A contraption room reads by contrast, not by hue: a cool concrete shell, and one warm accent
7
- * carried by everything the puzzle is *about* — the crates you move and the ring you are aiming
8
- * for. The ring separates from the crates by being emissive and translucent rather than by being
9
- * a seventh colour, which is what keeps the frame legible. Change these six numbers and the whole
10
- * kit follows.
11
- */
1
+ // Generated for you. Keep these roles coherent when you change the look.
2
+ //
3
+ // Six names, and each is a job rather than a swatch: the room is a dark cool box, the crates are the
4
+ // only warm mass in it, and exactly two things emit — the lanterns and the seal. That two-source
5
+ // split is what the picture is made of. The room's other tints are named constants in
6
+ // `materials.ts` beside the material that wears them, because a tint is a choice, a role is a
7
+ // contract, and only the contract is worth spending one of the six on.
12
8
  export const palette = {
13
- skyHigh: 0x101a2c,
14
- skyLow: 0x35526b,
15
- floor: 0x232c38,
16
- wall: 0x39434f,
17
- accent: 0xd08a3c,
18
- shadow: 0x080d14,
9
+ /** Beyond the walls, and the fog the far corners fade into. Almost black, faintly blue. */
10
+ void: 0x0a0e16,
11
+ /** The flagstone floor. */
12
+ floor: 0x2a3341,
13
+ /** The plaster band the lantern light lands on — the one warm surface that is not a crate. */
14
+ wall: 0xbb9155,
15
+ /** Pillars, capping rail, lantern housings. */
16
+ timber: 0x6b4a32,
17
+ /** Solid crates, and every other thing a body can shove. */
18
+ prop: 0xd05a33,
19
+ /** Phase crates and the seal: the way through, and the way out. Deliberately the cyan end. */
20
+ accent: 0x2fd2f0,
19
21
  } as const;
20
-
21
- const materials = new Map<string, MeshStandardMaterial>();
22
-
23
- /** One cached standard material per colour and roughness, so a room of crates is one material. */
24
- export function surface(color: number, roughness = 0.8, metalness = 0.06): MeshStandardMaterial {
25
- const key = `${color}:${roughness}:${metalness}`;
26
- const cached = materials.get(key);
27
- if (cached !== undefined) return cached;
28
- const material = new MeshStandardMaterial({ color, metalness, roughness });
29
- materials.set(key, material);
30
- return material;
31
- }
@@ -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
  }
@@ -15,10 +15,11 @@
15
15
  // `unmeasured` rather than guessing, and your scene is not that scene: read `TN_FRAME_BUDGET`
16
16
  // back after you change a tier.
17
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
- //
18
+ // **This template runs no SSGI and no SSR at any tier, and both are measurements rather than
19
+ // tastes.** Forty-five simulated bodies are already the frame's budget, and SSGI is the most
20
+ // expensive stage in the reference ablation by a factor of two (~9.2 ms of a 14.7 ms frame with
21
+ // its two denoise passes); in a room this dark, one bounce of indirect light off a flagstone floor
22
+ // buys nothing the three lanterns do not already put there.
22
23
  import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
23
24
 
24
25
  /**
@@ -49,7 +50,7 @@ function isQualityTier(value: string): value is QualityTier {
49
50
  * turned out to have no effect.
50
51
  */
51
52
  export function resolveQualityTier(
52
- request: { readonly mobile?: boolean; readonly tier?: string } = {},
53
+ request: { readonly mobile?: boolean; readonly software?: boolean; readonly tier?: string } = {},
53
54
  ): QualityTier {
54
55
  const requested = request.tier;
55
56
  if (requested !== undefined) {
@@ -60,100 +61,90 @@ export function resolveQualityTier(
60
61
  }
61
62
  return requested;
62
63
  }
64
+ // A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
65
+ // game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
66
+ // drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
67
+ // fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
68
+ // `tier` above still wins over it.
69
+ if (request.software === true) return "low";
63
70
  return request.mobile === true ? "low" : "high";
64
71
  }
65
72
 
66
73
  /**
67
- * What a desktop gets: this template's shipped desktop look, unchanged.
74
+ * The look every tier shares: the tone curve, a corner falloff, and bloom over a high threshold.
68
75
  *
69
- * The whole chain measured 12.5 ms of a 14.7 ms GPU frame in the reference ablation, and SSGI
70
- * with its denoiser is ~9.2 ms of that.
76
+ * Bloom is the one stage this look cannot do without. Exactly two things in the vault emit — the
77
+ * three lantern flames and the seal — and a threshold high enough to clear them and nothing lit
78
+ * is what keeps the glow on the two warm sources and off the forty crates.
71
79
  */
72
- const high: IWorldEnvironmentOptions = {
73
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
74
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
75
- // to be.
80
+ const shared: IWorldEnvironmentOptions = {
81
+ // ~4.6 ms in the ablation named above, at that scene's own strength.
76
82
  bloomEnabled: true,
77
- bloomRadius: 0.5,
78
- bloomStrength: 0.42,
79
- bloomThreshold: 0.2,
80
- exposure: 1.15,
81
- // The two full-resolution denoise passes over the AO and GI terms: ~1.9 ms. Only worth running
82
- // when SSGI is on — its noise is what they clean up.
83
- denoiseEnabled: true,
84
- // SSGI, the screen-space indirect-light gather: ~7.3 ms alone, ~9.2 ms with the two denoise
85
- // passes it feeds. The largest stage in the chain by a factor of two, of a 14.7 ms frame.
86
- // Dropping this pair is what `medium` is.
87
- ssgiEnabled: true,
88
- ssgiRadius: 18,
89
- ssgiQuality: "medium",
90
- // Half the frame in each axis, so a quarter of the pixels. Full-res SSGI cost 14.4 ms
91
- // of a 39.7 ms frame on an RTX 2080; this is the same gather over a quarter of the work,
92
- // and it measured *sharper* because the scaler spends what it hands back on resolution.
93
- // `worldEnvironment.ts` explains why it takes a wrapper instead of a property.
94
- ssgiResolutionScale: 0.5,
95
- // Screen-space reflections: ~4.1 ms.
96
- ssrEnabled: true,
97
- // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
98
- // are on and do nothing" — the ray dies a metre from where it started.
99
- ssrMaxDistance: 44,
100
- // A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
101
- // the rays and is very hard to see in the result.
102
- ssrResolutionScale: 0.5,
103
- // RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
104
- // denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
105
- // that runs one of them.
106
- sharpenEnabled: true,
107
- // **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
108
- sharpenStrength: 0.3,
83
+ bloomRadius: 0.42,
84
+ bloomStrength: 0.5,
85
+ // High, on purpose: the lantern flames and the seal plate clear it and nothing lit does.
86
+ bloomThreshold: 0.85,
87
+ exposure: 1.06,
109
88
  tonemapMode: "aces",
89
+ vignetteAmount: 0.34,
110
90
  };
111
91
 
112
92
  /**
113
- * `high` minus the gather and its denoiser — the single change in this chain measured to give
114
- * back most of the frame: **14.7 ms -> 5.5 ms of GPU** in the reference ablation. Reflections,
115
- * bloom and the sharpener stay, so it is recognisably the same look.
93
+ * What a desktop gets.
94
+ *
95
+ * Contact occlusion, because a pile of forty crates is nothing but contacts, and a sharpen pass,
96
+ * because RCAS is what puts the edge back on the plank braces the occlusion pass softens.
116
97
  */
117
- const medium: IWorldEnvironmentOptions = {
118
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
119
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
120
- // to be.
121
- bloomEnabled: true,
122
- bloomRadius: 0.5,
123
- bloomStrength: 0.42,
124
- bloomThreshold: 0.2,
125
- exposure: 1.15,
126
- // Screen-space reflections: ~4.1 ms.
127
- ssrEnabled: true,
128
- // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
129
- // are on and do nothing" — the ray dies a metre from where it started.
130
- ssrMaxDistance: 44,
131
- // A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
132
- // the rays and is very hard to see in the result.
133
- ssrResolutionScale: 0.5,
134
- // RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
135
- // denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
136
- // that runs one of them.
98
+ const high: IWorldEnvironmentOptions = {
99
+ ...shared,
100
+ // Contact scale, in metres. A crate is 0.92 m, so half a metre gathers the crease where two
101
+ // crates meet and the shadow where one meets the floor, and no further.
102
+ // unmeasured in that ablation — it is not one of the five stages it measured.
103
+ gtaoEnabled: true,
104
+ gtaoRadius: 0.5,
105
+ gtaoResolutionScale: 0.5,
106
+ gtaoSamples: 12,
107
+ gtaoScale: 1.25,
108
+ // unmeasured in that ablation, as with GTAO. RCAS is a radius: 0.95 is nearly full sharpening.
137
109
  sharpenEnabled: true,
138
- // **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
139
- sharpenStrength: 0.3,
140
- tonemapMode: "aces",
110
+ sharpenStrength: 0.95,
111
+ };
112
+
113
+ /** A machine between the two: the same look with a cheaper occlusion gather. */
114
+ const medium: IWorldEnvironmentOptions = {
115
+ ...shared,
116
+ bloomRadius: 0.38,
117
+ bloomStrength: 0.56,
118
+ bloomThreshold: 0.84,
119
+ exposure: 1.05,
120
+ // unmeasured, as at `high`; this tier is the same gather at fewer samples.
121
+ gtaoEnabled: true,
122
+ gtaoRadius: 0.45,
123
+ gtaoResolutionScale: 0.4,
124
+ gtaoSamples: 8,
125
+ gtaoScale: 1.2,
126
+ sharpenEnabled: false,
127
+ vignetteAmount: 0.3,
141
128
  };
142
129
 
143
130
  /**
144
- * What a phone gets: this template's shipped mobile look, unchanged. Bloom and the tone curve,
145
- * nothing screen-space. The ablation's floor — every stage off — was 2.2 ms.
131
+ * What a phone gets: bloom and a vignette, no screen-space gather at all. The occlusion is the
132
+ * first thing to go — forty simulated bodies are already the frame's budget on a phone.
146
133
  */
147
134
  const low: IWorldEnvironmentOptions = {
148
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
149
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
150
- // to be.
135
+ // The chain's own quality tier, separate from which stages this preset enables: without it
136
+ // the renderer keeps its `high` default at every tier, so a CPU adapter's low preset still
137
+ // paid for the high chain's denoise and slice counts.
138
+ renderChainTier: "low",
139
+ // ~4.6 ms in the ablation named above, at that scene's own strength.
151
140
  bloomEnabled: true,
152
- bloomRadius: 0.5,
153
- bloomStrength: 0.42,
154
- bloomThreshold: 0.2,
155
- exposure: 1.15,
156
- tonemapMode: "aces",
141
+ bloomRadius: 0.32,
142
+ bloomStrength: 0.48,
143
+ bloomThreshold: 0.86,
144
+ exposure: 1.04,
145
+ gtaoEnabled: false,
146
+ sharpenEnabled: false,
147
+ vignetteAmount: 0.28,
157
148
  };
158
149
 
159
150
  const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };