create-threenative 0.2.6 → 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 (622) hide show
  1. package/README.md +2 -2
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +431 -20
  4. package/agent-docs/references/performance-basics.md +8 -5
  5. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  6. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  7. package/agent-docs/references/visual-baseline.md +8 -4
  8. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
  10. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
  12. package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
  13. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  14. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  15. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  16. package/capabilities.json +555 -21
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +294 -55
  19. package/dist/threenative.js +714 -154
  20. package/package.json +6 -6
  21. package/template-assets/assets/mannequin-combat.glb +0 -0
  22. package/template-assets/assets/mannequin.glb +0 -0
  23. package/template-assets/assets/player-viewmodel.glb +0 -0
  24. package/template-assets/assets/sky.jpg +0 -0
  25. package/template-assets/clearwater/README.md +141 -0
  26. package/template-assets/clearwater/install.mjs +50 -0
  27. package/template-assets/clearwater/src/clearwater.ts +180 -0
  28. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  29. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  30. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  31. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  32. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  33. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  34. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  35. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  36. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  37. package/template-assets/patches/three@0.185.1.patch +2101 -138
  38. package/template-assets/worldEnvironment.ts +52 -1
  39. package/templates/action-rpg/AGENTS.md +42 -42
  40. package/templates/action-rpg/CLAUDE.md +42 -42
  41. package/templates/action-rpg/kit.json +1 -1
  42. package/templates/action-rpg/package.json +13 -7
  43. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  44. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  45. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  46. package/templates/action-rpg/src/conventions.ts +24 -18
  47. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  48. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  49. package/templates/action-rpg/src/entities/Player.ts +102 -32
  50. package/templates/action-rpg/src/game.ts +3 -3
  51. package/templates/action-rpg/src/render/camera.ts +18 -16
  52. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  53. package/templates/action-rpg/src/render/lighting.ts +45 -28
  54. package/templates/action-rpg/src/render/loading.ts +4 -4
  55. package/templates/action-rpg/src/render/materials.ts +191 -47
  56. package/templates/action-rpg/src/render/palette.ts +14 -13
  57. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  58. package/templates/action-rpg/src/render/props.ts +117 -0
  59. package/templates/action-rpg/src/render/quality.ts +40 -82
  60. package/templates/action-rpg/src/render/sky.ts +36 -13
  61. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  62. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  63. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  64. package/templates/action-rpg/src/style.css +9 -7
  65. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  66. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  67. package/templates/action-rpg/threenative.config.ts +14 -1
  68. package/templates/action-rpg/vite.config.ts +4 -1
  69. package/templates/minimal/AGENTS.md +10 -10
  70. package/templates/minimal/CLAUDE.md +10 -10
  71. package/templates/minimal/package.json +12 -6
  72. package/templates/minimal/playtests/play.playtest.json +6 -5
  73. package/templates/minimal/playtests/sky.playtest.json +27 -0
  74. package/templates/minimal/src/conventions.ts +6 -3
  75. package/templates/minimal/src/entities/Player.ts +73 -27
  76. package/templates/minimal/src/main.ts +2 -3
  77. package/templates/minimal/src/render/camera.ts +22 -4
  78. package/templates/minimal/src/render/lighting.ts +24 -48
  79. package/templates/minimal/src/render/materials.ts +158 -13
  80. package/templates/minimal/src/render/palette.ts +10 -7
  81. package/templates/minimal/src/render/postprocessing.ts +12 -25
  82. package/templates/minimal/src/render/quality.ts +35 -69
  83. package/templates/minimal/src/render/sky.ts +35 -54
  84. package/templates/minimal/src/render/touch-controls.ts +1 -1
  85. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  86. package/templates/minimal/src/scenes/Play.ts +121 -111
  87. package/templates/minimal/src/state.ts +0 -4
  88. package/templates/minimal/src/style.css +0 -10
  89. package/templates/minimal/threenative.config.ts +14 -1
  90. package/templates/minimal/vite.config.ts +4 -1
  91. package/templates/platformer/AGENTS.md +18 -56
  92. package/templates/platformer/CLAUDE.md +18 -56
  93. package/templates/platformer/kit.json +2 -2
  94. package/templates/platformer/package.json +13 -9
  95. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  96. package/templates/platformer/playtests/collect.playtest.json +8 -34
  97. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  98. package/templates/platformer/playtests/damage.playtest.json +40 -15
  99. package/templates/platformer/playtests/hud.playtest.json +34 -0
  100. package/templates/platformer/playtests/move.playtest.json +24 -0
  101. package/templates/platformer/playtests/performance.playtest.json +24 -7
  102. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  103. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  104. package/templates/platformer/playtests/survives.playtest.json +3 -19
  105. package/templates/platformer/playtests/world.playtest.json +26 -0
  106. package/templates/platformer/src/entities/Fox.ts +273 -0
  107. package/templates/platformer/src/entities/Pickup.ts +43 -60
  108. package/templates/platformer/src/entities/Walker.ts +88 -0
  109. package/templates/platformer/src/game.ts +11 -8
  110. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  111. package/templates/platformer/src/level/Stage.ts +469 -0
  112. package/templates/platformer/src/render/blocks.ts +94 -0
  113. package/templates/platformer/src/render/camera.ts +28 -3
  114. package/templates/platformer/src/render/fox.ts +196 -0
  115. package/templates/platformer/src/render/lighting.ts +42 -33
  116. package/templates/platformer/src/render/materials.ts +115 -5
  117. package/templates/platformer/src/render/palette.ts +68 -53
  118. package/templates/platformer/src/render/pickups.ts +142 -0
  119. package/templates/platformer/src/render/postprocessing.ts +12 -2
  120. package/templates/platformer/src/render/props.ts +147 -0
  121. package/templates/platformer/src/render/quality.ts +47 -99
  122. package/templates/platformer/src/render/scenery.ts +172 -0
  123. package/templates/platformer/src/render/sky.ts +120 -31
  124. package/templates/platformer/src/render/touch-controls.ts +5 -2
  125. package/templates/platformer/src/render/walkers.ts +96 -0
  126. package/templates/platformer/src/render/waterfall.ts +85 -0
  127. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  128. package/templates/platformer/src/scenes/Boot.ts +3 -4
  129. package/templates/platformer/src/scenes/Play.ts +362 -0
  130. package/templates/platformer/src/state.ts +16 -14
  131. package/templates/platformer/src/style.css +9 -8
  132. package/templates/platformer/src/ui/Hud.tsx +62 -29
  133. package/templates/platformer/src/ui/Menu.tsx +2 -2
  134. package/templates/platformer/threenative.config.ts +14 -1
  135. package/templates/platformer/vite.config.ts +4 -1
  136. package/templates/puzzle/AGENTS.md +19 -20
  137. package/templates/puzzle/CLAUDE.md +19 -20
  138. package/templates/puzzle/assets/native-proof.glb +0 -0
  139. package/templates/puzzle/assets/native-proof.png +0 -0
  140. package/templates/puzzle/kit.json +1 -1
  141. package/templates/puzzle/package.json +13 -7
  142. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  143. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  144. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  145. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  146. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  147. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  148. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  149. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  150. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  151. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  152. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  153. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  154. package/templates/puzzle/src/entities/Crate.ts +99 -42
  155. package/templates/puzzle/src/entities/Seal.ts +69 -0
  156. package/templates/puzzle/src/entities/Warden.ts +135 -0
  157. package/templates/puzzle/src/game.ts +15 -11
  158. package/templates/puzzle/src/render/camera.ts +66 -31
  159. package/templates/puzzle/src/render/crateShape.ts +70 -0
  160. package/templates/puzzle/src/render/lighting.ts +41 -41
  161. package/templates/puzzle/src/render/loading.ts +4 -4
  162. package/templates/puzzle/src/render/materials.ts +131 -27
  163. package/templates/puzzle/src/render/palette.ts +19 -29
  164. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  165. package/templates/puzzle/src/render/quality.ts +71 -80
  166. package/templates/puzzle/src/render/shapes.ts +109 -108
  167. package/templates/puzzle/src/render/sky.ts +18 -10
  168. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  169. package/templates/puzzle/src/render/vault.ts +315 -0
  170. package/templates/puzzle/src/render/warden.ts +46 -0
  171. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  172. package/templates/puzzle/src/scenes/Play.ts +793 -0
  173. package/templates/puzzle/src/state.ts +55 -24
  174. package/templates/puzzle/src/style.css +7 -8
  175. package/templates/puzzle/src/ui/App.tsx +2 -2
  176. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  177. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  178. package/templates/puzzle/threenative.config.ts +14 -1
  179. package/templates/puzzle/vite.config.ts +4 -1
  180. package/templates/racing/AGENTS.md +19 -20
  181. package/templates/racing/CLAUDE.md +19 -20
  182. package/templates/racing/package.json +13 -7
  183. package/templates/racing/playtests/boost.playtest.json +33 -12
  184. package/templates/racing/playtests/outcome.playtest.json +32 -50
  185. package/templates/racing/playtests/performance.playtest.json +2 -1
  186. package/templates/racing/playtests/ranking.playtest.json +5 -14
  187. package/templates/racing/playtests/rescue.playtest.json +2 -2
  188. package/templates/racing/playtests/reverse.playtest.json +30 -8
  189. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  190. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  191. package/templates/racing/src/entities/CarBody.ts +327 -0
  192. package/templates/racing/src/entities/LineDriver.ts +220 -0
  193. package/templates/racing/src/entities/RacingCar.ts +150 -89
  194. package/templates/racing/src/entities/Rival.ts +61 -24
  195. package/templates/racing/src/game.ts +5 -0
  196. package/templates/racing/src/render/camera.ts +49 -7
  197. package/templates/racing/src/render/lighting.ts +36 -37
  198. package/templates/racing/src/render/materials.ts +239 -19
  199. package/templates/racing/src/render/palette.ts +19 -21
  200. package/templates/racing/src/render/postprocessing.ts +12 -2
  201. package/templates/racing/src/render/quality.ts +43 -82
  202. package/templates/racing/src/render/shapes.ts +20 -6
  203. package/templates/racing/src/render/sky.ts +47 -39
  204. package/templates/racing/src/render/touch-controls.ts +1 -1
  205. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  206. package/templates/racing/src/scenes/Race.ts +107 -54
  207. package/templates/racing/src/state.ts +2 -0
  208. package/templates/racing/src/track/Checkline.ts +22 -7
  209. package/templates/racing/src/track/Lap.ts +64 -36
  210. package/templates/racing/src/track/Ranking.ts +20 -11
  211. package/templates/racing/src/track/Track.ts +809 -361
  212. package/templates/racing/src/track/TrackSector.ts +40 -11
  213. package/templates/racing/src/track/circuit.ts +477 -0
  214. package/templates/racing/src/track/rescue.ts +16 -4
  215. package/templates/racing/threenative.config.ts +14 -1
  216. package/templates/racing/vite.config.ts +4 -1
  217. package/templates/rts/AGENTS.md +96 -0
  218. package/templates/rts/CLAUDE.md +98 -0
  219. package/templates/rts/kit.json +7 -0
  220. package/templates/{defense → rts}/package.json +13 -7
  221. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  222. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  223. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  224. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  225. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  226. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  227. package/templates/rts/playtests/survives.playtest.json +58 -0
  228. package/templates/rts/public/favicon.svg +4 -0
  229. package/templates/rts/src/game.ts +64 -0
  230. package/templates/rts/src/orders.ts +22 -0
  231. package/templates/rts/src/render/army.ts +346 -0
  232. package/templates/rts/src/render/camera.ts +123 -0
  233. package/templates/rts/src/render/lighting.ts +61 -0
  234. package/templates/rts/src/render/loading.ts +33 -0
  235. package/templates/rts/src/render/materials.ts +152 -0
  236. package/templates/rts/src/render/models.ts +705 -0
  237. package/templates/rts/src/render/palette.ts +17 -0
  238. package/templates/rts/src/render/picking.ts +93 -0
  239. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  240. package/templates/rts/src/render/quality.ts +128 -0
  241. package/templates/rts/src/render/resources.ts +141 -0
  242. package/templates/rts/src/render/sky.ts +44 -0
  243. package/templates/rts/src/render/terrain.ts +116 -0
  244. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  245. package/templates/rts/src/scenes/Play.ts +650 -0
  246. package/templates/rts/src/sim/ai.ts +1140 -0
  247. package/templates/rts/src/sim/combat.ts +416 -0
  248. package/templates/rts/src/sim/construction.ts +374 -0
  249. package/templates/rts/src/sim/economy.ts +167 -0
  250. package/templates/rts/src/sim/game.ts +1082 -0
  251. package/templates/rts/src/sim/movement.ts +371 -0
  252. package/templates/rts/src/sim/nav.ts +276 -0
  253. package/templates/rts/src/sim/production.ts +180 -0
  254. package/templates/rts/src/sim/terrain.ts +170 -0
  255. package/templates/rts/src/sim/types.ts +647 -0
  256. package/templates/rts/src/sim/vision.ts +46 -0
  257. package/templates/rts/src/state.ts +100 -0
  258. package/templates/{defense → rts}/src/style.css +21 -8
  259. package/templates/rts/src/ui/App.tsx +21 -0
  260. package/templates/rts/src/ui/Commands.tsx +129 -0
  261. package/templates/rts/src/ui/GameUi.tsx +22 -0
  262. package/templates/rts/src/ui/Hud.tsx +165 -0
  263. package/templates/rts/src/ui/Minimap.tsx +84 -0
  264. package/templates/rts/tailwind.config.ts +2 -0
  265. package/templates/rts/threenative.config.ts +56 -0
  266. package/templates/rts/tsconfig.json +17 -0
  267. package/templates/{defense → rts}/vite.config.ts +4 -1
  268. package/templates/runner/AGENTS.md +6 -10
  269. package/templates/runner/CLAUDE.md +6 -10
  270. package/templates/runner/README.md +3 -3
  271. package/templates/runner/package.json +13 -7
  272. package/templates/runner/playtests/performance.playtest.json +2 -2
  273. package/templates/runner/src/conventions.ts +4 -3
  274. package/templates/runner/src/entities/Runner.ts +54 -7
  275. package/templates/runner/src/game.ts +2 -0
  276. package/templates/runner/src/render/camera.ts +4 -2
  277. package/templates/runner/src/render/dust.ts +5 -2
  278. package/templates/runner/src/render/lighting.ts +41 -45
  279. package/templates/runner/src/render/loading.ts +2 -2
  280. package/templates/runner/src/render/materials.ts +165 -25
  281. package/templates/runner/src/render/palette.ts +17 -28
  282. package/templates/runner/src/render/postprocessing.ts +12 -2
  283. package/templates/runner/src/render/quality.ts +42 -96
  284. package/templates/runner/src/render/shapes.ts +59 -37
  285. package/templates/runner/src/render/sky.ts +32 -41
  286. package/templates/runner/src/render/touch-controls.ts +1 -1
  287. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  288. package/templates/runner/src/scenes/Run.ts +26 -6
  289. package/templates/runner/src/track.ts +6 -1
  290. package/templates/runner/threenative.config.ts +14 -1
  291. package/templates/runner/vite.config.ts +4 -1
  292. package/templates/sailing/AGENTS.md +12 -12
  293. package/templates/sailing/CLAUDE.md +12 -12
  294. package/templates/sailing/assets/ship.glb +0 -0
  295. package/templates/sailing/package.json +13 -7
  296. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  297. package/templates/sailing/playtests/sails.playtest.json +33 -0
  298. package/templates/sailing/playtests/win.playtest.json +156 -8
  299. package/templates/sailing/src/conventions.ts +29 -2
  300. package/templates/sailing/src/entities/Ship.ts +381 -57
  301. package/templates/sailing/src/game.ts +14 -0
  302. package/templates/sailing/src/render/camera.ts +63 -9
  303. package/templates/sailing/src/render/lighting.ts +49 -27
  304. package/templates/sailing/src/render/materials.ts +50 -15
  305. package/templates/sailing/src/render/ocean.ts +647 -60
  306. package/templates/sailing/src/render/palette.ts +16 -12
  307. package/templates/sailing/src/render/postprocessing.ts +12 -2
  308. package/templates/sailing/src/render/props.ts +316 -442
  309. package/templates/sailing/src/render/quality.ts +14 -4
  310. package/templates/sailing/src/render/sky.ts +116 -23
  311. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  312. package/templates/sailing/src/scenes/Boot.ts +21 -0
  313. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  314. package/templates/sailing/src/state.ts +6 -0
  315. package/templates/sailing/src/ui/Hud.tsx +41 -9
  316. package/templates/sailing/threenative.config.ts +14 -1
  317. package/templates/sailing/vite.config.ts +4 -1
  318. package/templates/shooter/AGENTS.md +27 -42
  319. package/templates/shooter/CLAUDE.md +27 -42
  320. package/templates/shooter/index.html +1 -0
  321. package/templates/shooter/package.json +13 -7
  322. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  323. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  324. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  325. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  326. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  327. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  328. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  329. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  330. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  331. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  332. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  333. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  334. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  335. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  336. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  337. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  338. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  339. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  340. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  341. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  342. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  343. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  344. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  345. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  346. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  347. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  348. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  349. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  350. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  351. package/templates/shooter/playtests/performance.playtest.json +62 -26
  352. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  353. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  354. package/templates/shooter/playtests/survives.playtest.json +36 -30
  355. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  356. package/templates/shooter/src/entities/Breakables.ts +412 -0
  357. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  358. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  359. package/templates/shooter/src/entities/Rifle.ts +442 -0
  360. package/templates/shooter/src/entities/Target.ts +199 -83
  361. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  362. package/templates/shooter/src/game.ts +75 -41
  363. package/templates/shooter/src/main.ts +0 -1
  364. package/templates/shooter/src/postPhysics.ts +36 -0
  365. package/templates/shooter/src/render/camera.ts +78 -74
  366. package/templates/shooter/src/render/decals.ts +142 -82
  367. package/templates/shooter/src/render/facade.ts +1373 -0
  368. package/templates/shooter/src/render/gunfx.ts +704 -0
  369. package/templates/shooter/src/render/lighting.ts +52 -38
  370. package/templates/shooter/src/render/loading.ts +2 -2
  371. package/templates/shooter/src/render/materials.ts +100 -88
  372. package/templates/shooter/src/render/occlusion.ts +108 -0
  373. package/templates/shooter/src/render/palette.ts +10 -10
  374. package/templates/shooter/src/render/palm.ts +455 -0
  375. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  376. package/templates/shooter/src/render/postprocessing.ts +15 -3
  377. package/templates/shooter/src/render/quality.ts +40 -82
  378. package/templates/shooter/src/render/scale.ts +148 -15
  379. package/templates/shooter/src/render/shapes.ts +138 -613
  380. package/templates/shooter/src/render/sky.ts +35 -35
  381. package/templates/shooter/src/render/town-schematic.ts +120 -0
  382. package/templates/shooter/src/render/town.ts +986 -0
  383. package/templates/shooter/src/render/townMaterials.ts +160 -0
  384. package/templates/shooter/src/render/vehicles.ts +741 -0
  385. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  386. package/templates/shooter/src/scenes/Play.ts +727 -650
  387. package/templates/shooter/src/state.ts +26 -41
  388. package/templates/shooter/src/style.css +207 -11
  389. package/templates/shooter/src/surfaces.ts +131 -0
  390. package/templates/shooter/src/ui/App.tsx +9 -10
  391. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  392. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  393. package/templates/shooter/src/ui/Hud.tsx +428 -39
  394. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  395. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  396. package/templates/shooter/src/ui/main.tsx +2 -3
  397. package/templates/shooter/threenative.config.ts +14 -1
  398. package/templates/shooter/vite.config.ts +4 -1
  399. package/templates/starter/AGENTS.md +17 -17
  400. package/templates/starter/CLAUDE.md +17 -17
  401. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  402. package/templates/starter/package.json +13 -7
  403. package/templates/starter/playtests/play.playtest.json +2 -1
  404. package/templates/starter/playtests/survives.playtest.json +1 -1
  405. package/templates/starter/src/conventions.ts +6 -3
  406. package/templates/starter/src/entities/Goal.ts +35 -42
  407. package/templates/starter/src/entities/Player.ts +99 -16
  408. package/templates/starter/src/render/arena.ts +131 -0
  409. package/templates/starter/src/render/lighting.ts +27 -44
  410. package/templates/starter/src/render/materials.ts +164 -35
  411. package/templates/starter/src/render/palette.ts +16 -16
  412. package/templates/starter/src/render/postprocessing.ts +6 -7
  413. package/templates/starter/src/render/quality.ts +43 -101
  414. package/templates/starter/src/render/shapes.ts +1 -1
  415. package/templates/starter/src/render/sky.ts +39 -45
  416. package/templates/starter/src/render/touch-controls.ts +3 -1
  417. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  418. package/templates/starter/src/scenes/Play.ts +82 -81
  419. package/templates/starter/threenative.config.ts +14 -1
  420. package/templates/starter/vite.config.ts +4 -1
  421. package/templates/tower-defense/.codex/config.toml +19 -0
  422. package/templates/tower-defense/.cursor/mcp.json +32 -0
  423. package/templates/tower-defense/.gemini/settings.json +32 -0
  424. package/templates/tower-defense/.mcp.json +32 -0
  425. package/templates/tower-defense/.vscode/mcp.json +36 -0
  426. package/templates/tower-defense/.zed/settings.json +36 -0
  427. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  428. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  429. package/templates/tower-defense/README.md +16 -0
  430. package/templates/tower-defense/index.html +12 -0
  431. package/templates/tower-defense/kit.json +7 -0
  432. package/templates/tower-defense/opencode.json +41 -0
  433. package/templates/tower-defense/package.json +56 -0
  434. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  435. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  436. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  437. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  438. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  439. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  440. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  441. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  442. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  443. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  444. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  445. package/templates/tower-defense/src/balance.ts +187 -0
  446. package/templates/tower-defense/src/board/Board.ts +100 -0
  447. package/templates/tower-defense/src/board/Route.ts +84 -0
  448. package/templates/tower-defense/src/camera-rig.ts +62 -0
  449. package/templates/tower-defense/src/economy.ts +64 -0
  450. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  451. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  452. package/templates/tower-defense/src/game.ts +72 -0
  453. package/templates/tower-defense/src/intents.ts +21 -0
  454. package/templates/tower-defense/src/main.ts +15 -0
  455. package/templates/tower-defense/src/physics.ts +6 -0
  456. package/templates/tower-defense/src/render/camera.ts +38 -0
  457. package/templates/tower-defense/src/render/lighting.ts +42 -0
  458. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  459. package/templates/tower-defense/src/render/materials.ts +103 -0
  460. package/templates/tower-defense/src/render/palette.ts +58 -0
  461. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  462. package/templates/tower-defense/src/render/quality.ts +128 -0
  463. package/templates/tower-defense/src/render/shapes.ts +550 -0
  464. package/templates/tower-defense/src/render/sky.ts +27 -0
  465. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  466. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  467. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  468. package/templates/tower-defense/src/state.ts +88 -0
  469. package/templates/tower-defense/src/style.css +137 -0
  470. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  471. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  472. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  473. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  474. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  475. package/templates/tower-defense/src/ui/main.tsx +14 -0
  476. package/templates/tower-defense/src/waves.ts +90 -0
  477. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  478. package/templates/tower-defense/vite.config.ts +41 -0
  479. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  480. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  481. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  482. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  483. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  484. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  485. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  486. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  487. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  488. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  489. package/agent-files/AGENT-ROLES.md +0 -26
  490. package/templates/action-rpg/src/render/shapes.ts +0 -269
  491. package/templates/action-rpg/src/render/types.ts +0 -3
  492. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  493. package/templates/defense/README.md +0 -10
  494. package/templates/defense/kit.json +0 -7
  495. package/templates/defense/playtests/leak.playtest.json +0 -23
  496. package/templates/defense/playtests/placement.playtest.json +0 -40
  497. package/templates/defense/playtests/scan.playtest.json +0 -20
  498. package/templates/defense/playtests/survive.playtest.json +0 -45
  499. package/templates/defense/playtests/survives.playtest.json +0 -36
  500. package/templates/defense/src/attackers/Attacker.ts +0 -120
  501. package/templates/defense/src/board/Route.ts +0 -94
  502. package/templates/defense/src/conventions.ts +0 -18
  503. package/templates/defense/src/economy.ts +0 -36
  504. package/templates/defense/src/entities/Player.ts +0 -52
  505. package/templates/defense/src/game.ts +0 -51
  506. package/templates/defense/src/physics.ts +0 -13
  507. package/templates/defense/src/placement/Buildable.ts +0 -49
  508. package/templates/defense/src/render/camera.ts +0 -16
  509. package/templates/defense/src/render/lighting.ts +0 -37
  510. package/templates/defense/src/render/materials.ts +0 -22
  511. package/templates/defense/src/render/palette.ts +0 -28
  512. package/templates/defense/src/render/quality.ts +0 -170
  513. package/templates/defense/src/render/shapes.ts +0 -246
  514. package/templates/defense/src/render/sky.ts +0 -45
  515. package/templates/defense/src/scenes/Boot.ts +0 -12
  516. package/templates/defense/src/scenes/Defense.ts +0 -231
  517. package/templates/defense/src/state.ts +0 -56
  518. package/templates/defense/src/towers/Tower.ts +0 -95
  519. package/templates/defense/src/towers/targeting.ts +0 -53
  520. package/templates/defense/src/ui/Hud.tsx +0 -62
  521. package/templates/defense/src/ui/Menu.tsx +0 -7
  522. package/templates/defense/src/waves.ts +0 -40
  523. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  524. package/templates/minimal/src/render/hud.ts +0 -69
  525. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  526. package/templates/platformer/playtests/chase.playtest.json +0 -21
  527. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  528. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  529. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  530. package/templates/platformer/playtests/physics.playtest.json +0 -14
  531. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  532. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  533. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  534. package/templates/platformer/src/conventions.ts +0 -18
  535. package/templates/platformer/src/entities/Character.ts +0 -286
  536. package/templates/platformer/src/entities/Chaser.ts +0 -118
  537. package/templates/platformer/src/entities/Patrol.ts +0 -93
  538. package/templates/platformer/src/level/Platform.ts +0 -46
  539. package/templates/platformer/src/render/rig.ts +0 -60
  540. package/templates/platformer/src/render/terrain.ts +0 -31
  541. package/templates/platformer/src/scenes/Level.ts +0 -241
  542. package/templates/puzzle/README.md +0 -43
  543. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  544. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  545. package/templates/puzzle/src/conventions.ts +0 -25
  546. package/templates/puzzle/src/entities/Ball.ts +0 -70
  547. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  548. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  549. package/templates/puzzle/src/physics.ts +0 -19
  550. package/templates/puzzle/src/room.ts +0 -83
  551. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  552. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  553. package/templates/shooter/playtests/combat.playtest.json +0 -48
  554. package/templates/shooter/playtests/fail.playtest.json +0 -31
  555. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  556. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  557. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  558. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  559. package/templates/shooter/src/combat/damage.ts +0 -40
  560. package/templates/shooter/src/conventions.ts +0 -51
  561. package/templates/shooter/src/entities/Pickup.ts +0 -70
  562. package/templates/shooter/src/entities/Player.ts +0 -310
  563. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  564. package/templates/shooter/src/playtest-events.ts +0 -15
  565. package/templates/shooter/src/render/touch-controls.ts +0 -305
  566. package/templates/shooter/src/render/types.ts +0 -3
  567. package/templates/shooter/src/render/ui.css +0 -330
  568. package/templates/shooter/src/render/ui.ts +0 -75
  569. package/templates/shooter/src/render/vfx.ts +0 -215
  570. package/templates/shooter/src/ui/Menu.tsx +0 -41
  571. package/templates/shooter/src/waves.ts +0 -50
  572. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  573. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  574. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  575. package/templates/starter/playtests/assets.playtest.json +0 -65
  576. package/templates/starter/playtests/buffer.playtest.json +0 -79
  577. package/templates/starter/playtests/cloth.playtest.json +0 -113
  578. package/templates/starter/playtests/coyote.playtest.json +0 -87
  579. package/templates/starter/playtests/gameover.playtest.json +0 -66
  580. package/templates/starter/playtests/goal.playtest.json +0 -67
  581. package/templates/starter/playtests/look.playtest.json +0 -175
  582. package/templates/starter/playtests/models-baseline.png +0 -0
  583. package/templates/starter/playtests/models.playtest.json +0 -74
  584. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  585. package/templates/starter/playtests/odometer.playtest.json +0 -54
  586. package/templates/starter/playtests/restart.playtest.json +0 -91
  587. package/templates/starter/playtests/seed.playtest.json +0 -54
  588. package/templates/starter/playtests/textures-baseline.png +0 -0
  589. package/templates/starter/playtests/textures.playtest.json +0 -74
  590. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  591. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  592. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  593. package/templates/starter/src/render/coast.ts +0 -199
  594. package/templates/starter/src/render/hero.ts +0 -88
  595. package/templates/starter/src/render/implicitSurface.ts +0 -199
  596. package/templates/starter/src/render/kuwahara.ts +0 -174
  597. package/templates/starter/src/render/outline.ts +0 -141
  598. package/templates/starter/src/render/painterly.ts +0 -86
  599. package/templates/starter/src/render/rockRidge.ts +0 -198
  600. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  601. package/templates/starter/src/render/scenery.ts +0 -40
  602. package/templates/starter/src/render/textureLifetime.ts +0 -53
  603. package/templates/starter/src/render/water.ts +0 -38
  604. package/templates/starter/src/render/watercolor.ts +0 -85
  605. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  606. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  607. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  608. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  609. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  610. /package/templates/{defense → rts}/.mcp.json +0 -0
  611. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  612. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  613. /package/templates/{defense → rts}/index.html +0 -0
  614. /package/templates/{defense → rts}/opencode.json +0 -0
  615. /package/templates/{defense → rts}/src/main.ts +0 -0
  616. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  617. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  618. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  619. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  620. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  621. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  622. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -0,0 +1,362 @@
1
+ import {
2
+ type ICtx,
3
+ InstancedBatch,
4
+ Scene,
5
+ type SceneFrame,
6
+ afterPhysics,
7
+ isMobile,
8
+ isTouchscreenAvailable,
9
+ mergeByMaterial,
10
+ } from "@threenative/core";
11
+ import { type IPhysicsContext, buildStaticColliders } from "@threenative/physics";
12
+ import {
13
+ type Group,
14
+ Mesh,
15
+ type Object3D,
16
+ type PerspectiveCamera,
17
+ SphereGeometry,
18
+ type Texture,
19
+ Vector3,
20
+ } from "three";
21
+ import { FOX_FEEL, Fox, type GameCtx } from "../entities/Fox.js";
22
+ import { Pickup } from "../entities/Pickup.js";
23
+ import { Walker, type WalkerKind } from "../entities/Walker.js";
24
+ import { Checkpoints } from "../level/Checkpoints.js";
25
+ import { buildStage, makeRng } from "../level/Stage.js";
26
+ import { emitPlaytestEvent } from "../playtest-events.js";
27
+ import { followCamera, setupCamera } from "../render/camera.js";
28
+ import { setupLighting } from "../render/lighting.js";
29
+ import { createLoadingScreen } from "../render/loading.js";
30
+ import { flat } from "../render/materials.js";
31
+ import { C } from "../render/palette.js";
32
+ import { burst, coinArc } from "../render/pickups.js";
33
+ import { setupPost } from "../render/postprocessing.js";
34
+ import { cloudLobes, setupSky, skyFloor } from "../render/sky.js";
35
+ import { TouchControls } from "../render/touch-controls.js";
36
+ import type { GameState } from "../state.js";
37
+
38
+ export type { GameCtx };
39
+
40
+ /** Where the five gems sit along the route, and how many there are to find. */
41
+ const GEMS: readonly (readonly [number, number, number])[] = [
42
+ [16, 1.5, -1.5],
43
+ [37.5, 3, 0],
44
+ [50.5, 6.6, -1.4],
45
+ [66, 4.5, 2.2],
46
+ [90, 4.5, -2],
47
+ ];
48
+
49
+ /** Three big stars, well above the ground, so they are a target and not litter. */
50
+ const STARS: readonly (readonly [number, number, number])[] = [
51
+ [24, 6, 2.6],
52
+ [55, 9, 1],
53
+ [94.5, 5, 0],
54
+ ];
55
+
56
+ /**
57
+ * The five walkers on the route: kind, x, y, z, and the two x values they turn around at.
58
+ * Built in `load()` so a scenario can place one, and frozen on placement so the stomp lands on
59
+ * the same target every run.
60
+ */
61
+ const WALKERS: readonly (readonly [WalkerKind, number, number, number, number, number, number])[] =
62
+ [
63
+ ["snail", 22, 0, 2.4, 18, 28, 1.2],
64
+ ["mushroom", 37, 1.5, 0, 34.8, 40.2, 2.4],
65
+ ["mushroom", 63, 3, -1.5, 60, 68, 2.6],
66
+ ["mushroom", 71, 3, 1.8, 67, 73.5, 2.2],
67
+ ["snail", 87, 3, 2.6, 83.5, 92, 1.1],
68
+ ];
69
+
70
+ /** The stomp window: falling onto a walker from above, in metres. */
71
+ const STOMP = { drop: -1, rise: 0.45, below: -1.1, above: 1.5, near: 0.95 } as const;
72
+
73
+ export class Play extends Scene<GameState, IPhysicsContext> {
74
+ static override readonly initialState: GameState = {
75
+ checkpoint: 0,
76
+ coins: 0,
77
+ coyoteJumps: 0,
78
+ dashes: 0,
79
+ defeated: 0,
80
+ finished: false,
81
+ gemTotal: GEMS.length,
82
+ gems: 0,
83
+ hearts: 3,
84
+ jumps: 0,
85
+ paused: false,
86
+ peakRise: 0,
87
+ playerX: -5,
88
+ grounded: false,
89
+ respawns: 0,
90
+ stars: 0,
91
+ time: 0,
92
+ toast: "",
93
+ topSpeed: 0,
94
+ uiReady: false,
95
+ };
96
+
97
+ #sky: Texture | undefined;
98
+ #walkers: Walker[] = [];
99
+
100
+ /**
101
+ * The sky photograph and the walkers are both built here, and the walkers are registered here
102
+ * too — a scenario's `setup.place` is applied between `load()` and `enter()`, so an entity that
103
+ * only appears in `enter()` cannot be placed. That is what makes a stomp reproducible: the
104
+ * walker is where the scenario put it, not where boot time left it.
105
+ */
106
+ override async load(ctx: GameCtx): Promise<void> {
107
+ // Registered before the first `await`, because that is the whole window a scenario's
108
+ // `setup.place` has to find them in: the bridge applies setup between `load()` starting and
109
+ // `enter()` running, and anything after an await is too late.
110
+ for (const [kind, x, y, z, from, to, speed] of WALKERS) {
111
+ const walker = new Walker(kind, x, { from, speed, to, y, z });
112
+ ctx.add(walker.mesh);
113
+ ctx.entities.add(`walker.${this.#walkers.length}`, walker);
114
+ this.#walkers.push(walker);
115
+ }
116
+ this.#sky = await ctx.assets.texture("sky.jpg");
117
+ }
118
+
119
+ override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
120
+ const stage = buildStage(makeRng(90210));
121
+ // The whole route goes in as one root, and the predicate is the game's: `userData.solid` is
122
+ // set on exactly the walkable meshes in `level/Stage.ts`, so the engine builds a fixed trimesh
123
+ // body for those and leaves several thousand decorative meshes out of collision entirely.
124
+ ctx.add(stage.group);
125
+ buildStaticColliders(ctx, stage.group, {
126
+ predicate: (object) => object.userData.solid === true,
127
+ });
128
+ collapseStage(stage.group);
129
+ if (this.#sky === undefined) throw new Error("Play.enter ran before load() loaded sky.jpg.");
130
+ setupSky(ctx.scene, this.#sky);
131
+ ctx.scene.add(skyFloor());
132
+ const lighting = setupLighting(
133
+ ctx.scene,
134
+ ctx.renderer.raw as Parameters<typeof setupLighting>[1],
135
+ isMobile(),
136
+ );
137
+ // isMobile() arrives as an argument because src/render/ imports no framework package: the
138
+ // platform decision is made here, in portable game code.
139
+ setupPost(ctx.renderer, ctx.scene, ctx.camera, {
140
+ godraysLight: lighting.key,
141
+ mobile: isMobile(),
142
+ software: ctx.renderer.softwareAdapter !== undefined,
143
+ });
144
+ const camera = ctx.camera as PerspectiveCamera;
145
+ setupCamera(camera);
146
+ const loading = createLoadingScreen(ctx);
147
+ ctx.add(camera);
148
+ const touchControls =
149
+ isMobile() && isTouchscreenAvailable()
150
+ ? ctx.entities.add("touch-controls", new TouchControls(camera))
151
+ : undefined;
152
+ // 130 cloud lobes as one draw. The layout is `src/render/sky.js`'s; the batching is the
153
+ // scene's, because the render layer is ordinary Three.js and never reaches into the framework.
154
+ const clouds = new InstancedBatch({
155
+ geometry: new SphereGeometry(1, 8, 6),
156
+ material: flat(C.cloud, { fog: false }),
157
+ });
158
+ for (const lobe of cloudLobes(makeRng(4242))) clouds.place(lobe);
159
+ clouds.build({ name: "clouds", parent: ctx.scene });
160
+
161
+ // ------------------------------------------------------------------ actors
162
+ const fox = new Fox(ctx, stage.spawn);
163
+ ctx.entities.add("player", fox);
164
+ const checkpoints = new Checkpoints(stage.checkpoints, 3);
165
+ const pickups: Pickup[] = [];
166
+ const effects: ((dt: number) => boolean)[] = [];
167
+ const spawnBurst = (position: Vector3, color: number, count: number): void => {
168
+ effects.push(burst(ctx.scene, position, color, count));
169
+ };
170
+ const addPickup = (kind: "coin" | "gem" | "star", x: number, y: number, z = 0): Pickup => {
171
+ const pickup = new Pickup(kind, x, y, z);
172
+ ctx.add(pickup.mesh);
173
+ pickups.push(pickup);
174
+ return pickup;
175
+ };
176
+
177
+ // The coin lines are the route's teaching: one along the floor, one arced over every jump.
178
+ // The opening nine weave, but inside the reach a straight run actually collects: a coin the
179
+ // player can see and cannot take is worse than no coin at all.
180
+ for (let i = 0; i < 9; i += 1) addPickup("coin", -5 + i * 1.6, 1.25, Math.sin(i * 0.9) * 0.6);
181
+ for (let i = 0; i < 8; i += 1) addPickup("coin", 12 + i * 2, 1.25, i % 2 ? 1.6 : -1.4);
182
+ for (const point of coinArc([30, 1.3, 0], [34, 2.8, 0], 6, 1.6))
183
+ addPickup("coin", point.x, point.y, point.z);
184
+ for (const point of coinArc([41, 3, 0], [45.5, 4.4, 1.2], 4, 1.2))
185
+ addPickup("coin", point.x, point.y, point.z);
186
+ for (const [x, y, z] of [
187
+ [45.5, 4.6, 1.2],
188
+ [48, 5.6, 0],
189
+ [50.5, 6.2, -1.4],
190
+ [52.8, 7, 0],
191
+ [55, 7.6, 1],
192
+ ] as const)
193
+ addPickup("coin", x, y, z);
194
+ for (let i = 0; i < 10; i += 1)
195
+ addPickup("coin", 60 + i * 1.4, 4.25, -0.4 + Math.sin(i * 0.7) * 1.8);
196
+ for (let i = 0; i < 6; i += 1)
197
+ addPickup("coin", 75 + i * 1.3, 4.4 + Math.sin(i * 0.8) * 0.5, 0);
198
+ for (let i = 0; i < 5; i += 1) addPickup("coin", 84 + i * 1.5, 4.25, i % 2 ? 1.5 : -1.5);
199
+ for (const [x, y, z] of GEMS) addPickup("gem", x, y, z);
200
+ for (const [x, y, z] of STARS) addPickup("star", x, y, z);
201
+
202
+ const walkers = this.#walkers;
203
+
204
+ // ------------------------------------------------------------------- state
205
+ let coins = 0;
206
+ let gems = 0;
207
+ let stars = 0;
208
+ let defeated = 0;
209
+ let elapsed = 0;
210
+ let toastUntil = 0;
211
+ let finished = false;
212
+ const state = ctx.state.getState();
213
+ const spawn = stage.spawn.clone();
214
+ if (Number.isFinite(state.playerX)) spawn.x = state.playerX;
215
+ fox.teleport(spawn);
216
+ const toast = (text: string, seconds = 1.6): void => {
217
+ ctx.state.set({ toast: text });
218
+ toastUntil = elapsed + seconds;
219
+ };
220
+ const statePatch: Partial<GameState> = {};
221
+
222
+ // The camera and the sun both read the solved body, so they run in `afterPhysics` where the
223
+ // physics step has already moved it and this frame has not drawn yet.
224
+ afterPhysics(ctx, (dt) => {
225
+ followCamera(camera, fox.mesh.position, fox.body.velocity.x, dt);
226
+ lighting.follow(fox.mesh.position);
227
+ });
228
+
229
+ return (frameCtx, dt) => {
230
+ loading.update();
231
+ fox.update(
232
+ frameCtx,
233
+ dt,
234
+ touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size),
235
+ );
236
+ checkpoints.update(dt);
237
+ fox.setVisible(checkpoints.blinks(elapsed));
238
+ for (const walker of walkers) walker.update(dt, elapsed);
239
+
240
+ for (const pickup of pickups) {
241
+ pickup.update(dt, elapsed);
242
+ if (pickup.taken) continue;
243
+ if (pickup.mesh.position.distanceToSquared(fox.centre) >= pickup.reach ** 2) continue;
244
+ pickup.take();
245
+ spawnBurst(pickup.mesh.position, pickup.burstColor, pickup.kind === "coin" ? 8 : 16);
246
+ emitPlaytestEvent({ entity: "player", name: "collected" });
247
+ if (pickup.kind === "coin") coins += 1;
248
+ else if (pickup.kind === "gem") {
249
+ gems += 1;
250
+ toast(`GEM ${gems}/${GEMS.length}`);
251
+ } else {
252
+ stars += 1;
253
+ toast("STAR!", 2.4);
254
+ }
255
+ }
256
+
257
+ for (const walker of walkers) {
258
+ if (!walker.alive) continue;
259
+ const dx = Math.abs(walker.mesh.position.x - fox.mesh.position.x);
260
+ const dz = Math.abs(walker.mesh.position.z - fox.mesh.position.z);
261
+ const dy = fox.mesh.position.y - walker.y;
262
+ if (dx >= STOMP.near || dz >= STOMP.near || dy >= STOMP.above || dy <= STOMP.below)
263
+ continue;
264
+ if (fox.body.velocity.y < STOMP.drop && dy > STOMP.rise) {
265
+ walker.kill();
266
+ fox.bounce();
267
+ defeated += 1;
268
+ spawnBurst(
269
+ new Vector3(walker.mesh.position.x, walker.y + 0.6, walker.mesh.position.z),
270
+ walker.burstColor,
271
+ 14,
272
+ );
273
+ emitPlaytestEvent({ entity: "player", name: "stomped" });
274
+ toast("NICE!", 0.9);
275
+ } else if (checkpoints.hurt(fox, walker.mesh.position.x)) toast("OUCH!");
276
+ }
277
+
278
+ checkpoints.pass(fox.mesh.position);
279
+ if (fox.mesh.position.y < FOX_FEEL.killPlane) {
280
+ checkpoints.respawn(fox);
281
+ emitPlaytestEvent({ entity: "player", name: "respawned" });
282
+ }
283
+ if (checkpoints.hearts <= 0) {
284
+ checkpoints.restore();
285
+ checkpoints.respawn(fox);
286
+ toast("OUT OF HEARTS", 2.4);
287
+ }
288
+ if (!finished && fox.mesh.position.x > stage.goalX - 0.8) {
289
+ finished = true;
290
+ emitPlaytestEvent({ entity: "game", name: "won" });
291
+ toast("LEVEL CLEAR!", 6);
292
+ }
293
+ if (!finished) elapsed += dt;
294
+ if (toastUntil !== 0 && elapsed > toastUntil) {
295
+ toastUntil = 0;
296
+ frameCtx.state.set({ toast: "" });
297
+ }
298
+ stage.update(dt, elapsed);
299
+ for (let i = effects.length - 1; i >= 0; i -= 1) {
300
+ const effect = effects[i];
301
+ if (effect?.(dt) === true) effects.splice(i, 1);
302
+ }
303
+
304
+ const previous = frameCtx.state.getState();
305
+ statePatch.checkpoint = checkpoints.currentIndex;
306
+ statePatch.coins = coins;
307
+ statePatch.coyoteJumps = fox.coyoteJumps;
308
+ statePatch.dashes = fox.dashes;
309
+ statePatch.defeated = defeated;
310
+ statePatch.finished = finished;
311
+ statePatch.gems = gems;
312
+ statePatch.hearts = checkpoints.hearts;
313
+ statePatch.jumps = fox.jumps;
314
+ statePatch.peakRise = Math.max(previous.peakRise, fox.mesh.position.y - fox.groundY - 0.74);
315
+ statePatch.playerX = fox.mesh.position.x;
316
+ statePatch.grounded = fox.body.grounded;
317
+ statePatch.respawns = checkpoints.respawns;
318
+ statePatch.stars = stars;
319
+ statePatch.time = elapsed;
320
+ statePatch.topSpeed = Math.max(
321
+ previous.topSpeed,
322
+ Math.hypot(fox.body.velocity.x, fox.body.velocity.z),
323
+ );
324
+ frameCtx.state.set(statePatch);
325
+ };
326
+ }
327
+ }
328
+
329
+ /**
330
+ * Two thousand small meshes is two thousand draw calls, and the route is authored out of
331
+ * primitives, which is exactly the shape `mergeByMaterial` exists for: the static scenery is baked
332
+ * into one mesh per material, with the transforms already in the vertices.
333
+ *
334
+ * Three kinds of mesh stay out. The walkable ones, because `buildStaticColliders` needs them as
335
+ * trimesh sources and a baked buffer is no longer the surface the player stands on. The ones under
336
+ * a `userData.moving` subtree, because baking a transform that changes next frame freezes it. And
337
+ * the `userData.faceted` polyhedra, which carry no uv and would leave their bucket with
338
+ * mismatched attributes.
339
+ */
340
+ function collapseStage(root: Group): void {
341
+ const keep = (object: Object3D): boolean => {
342
+ for (let node = object; node !== root; node = node.parent as Object3D) {
343
+ if (node === undefined || node.userData.moving === true) return true;
344
+ }
345
+ return object.userData.solid === true || object.userData.faceted === true;
346
+ };
347
+ const sources = new Set<Mesh>();
348
+ root.traverse((object) => {
349
+ if (object instanceof Mesh && !keep(object)) sources.add(object);
350
+ });
351
+ if (sources.size === 0) return;
352
+ const merged = mergeByMaterial(root, { label: "stage", skip: (mesh) => !sources.has(mesh) });
353
+ for (const mesh of merged) {
354
+ mesh.castShadow = true;
355
+ mesh.receiveShadow = true;
356
+ root.add(mesh);
357
+ }
358
+ for (const source of sources) source.removeFromParent();
359
+ console.info(
360
+ `TN_STAGE_COLLAPSE:${JSON.stringify({ merged: merged.length, from: sources.size })}`,
361
+ );
362
+ }
@@ -1,27 +1,29 @@
1
- export const TERMINAL = {
2
- playing: 0,
3
- won: 1,
4
- lost: 2,
5
- } as const;
6
-
7
- export type TerminalState = (typeof TERMINAL)[keyof typeof TERMINAL];
8
-
9
1
  export type GameState = {
10
- /** Set from the UI\'s pause and resume intents, and read back by the menu. */
11
- paused: boolean;
12
- /** True once the UI layer has rendered and published its interactive rectangles. */
13
- uiReady: boolean;
2
+ /** Which checkpoint the fox would respawn at, as an index into the route's points. */
14
3
  checkpoint: number;
15
4
  coins: number;
16
5
  coyoteJumps: number;
17
- defeated: number;
18
6
  dashes: number;
7
+ defeated: number;
8
+ /** True once the fox has touched the goal flag; the run's clock stops here. */
9
+ finished: boolean;
10
+ gemTotal: number;
11
+ gems: number;
19
12
  hearts: number;
20
13
  jumps: number;
14
+ /** Set from the UI's pause and resume intents, and read back by the menu. */
15
+ paused: boolean;
16
+ /** How high the fox has ever got, which is what proves a jump happened. */
21
17
  peakRise: number;
22
18
  playerX: number;
23
19
  grounded: boolean;
24
20
  respawns: number;
25
- terminal: TerminalState;
21
+ stars: number;
22
+ /** Seconds on the route, frozen when the run finishes. */
23
+ time: number;
24
+ /** A short line under the HUD — "GEM 2/5", "NICE!", "LEVEL CLEAR!". */
25
+ toast: string;
26
26
  topSpeed: number;
27
+ /** True once the UI layer has rendered and published its interactive rectangles. */
28
+ uiReady: boolean;
27
29
  };
@@ -4,14 +4,15 @@
4
4
  @source "./";
5
5
 
6
6
  @theme {
7
- --color-ink: #04080d;
8
- --color-panel: #0d1c26;
9
- --color-line: #14313f;
10
- --color-lume: #6fe8ff;
11
- --color-warn: #ffd27a;
12
- --color-text: #a8ccd8;
13
- --color-dim: #4e7686;
14
- --font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;
7
+ --color-ink: #1d3a5c;
8
+ --color-panel: #2a1a0e;
9
+ --color-line: #ffffff40;
10
+ --color-lume: #ffb35c;
11
+ --color-warn: #f2b01e;
12
+ --color-heart: #e5484d;
13
+ --color-text: #fff4dc;
14
+ --color-dim: #e9c98a;
15
+ --font-mono: ui-rounded, "Nunito", "Trebuchet MS", system-ui, sans-serif;
15
16
  }
16
17
 
17
18
  html,
@@ -1,42 +1,75 @@
1
1
  import { useUiState } from "@threenative/ui";
2
2
  import type { GameState } from "../state.js";
3
3
 
4
+ function Heart({ full }: { full: boolean }) {
5
+ return (
6
+ <svg aria-hidden="true" className="h-6 w-6" viewBox="0 0 24 24">
7
+ <path
8
+ d="M12 21s-8.5-5.4-8.5-11.2A4.8 4.8 0 0 1 12 7a4.8 4.8 0 0 1 8.5 2.8C20.5 15.6 12 21 12 21z"
9
+ fill={full ? "var(--color-heart)" : "var(--color-line)"}
10
+ stroke={full ? "#8f1f2a" : "var(--color-line)"}
11
+ strokeWidth="1.6"
12
+ />
13
+ </svg>
14
+ );
15
+ }
16
+
17
+ function clock(seconds: number): string {
18
+ const whole = Math.floor(seconds);
19
+ return `${String(Math.floor(whole / 60)).padStart(2, "0")}:${String(whole % 60).padStart(2, "0")}`;
20
+ }
21
+
22
+ /**
23
+ * The one HUD, and the same file on every target.
24
+ *
25
+ * It reads published state and nothing else: the simulation keeps its own numbers and this never
26
+ * reaches into the scene. The bridge flushes about every 100 ms, so a number here is at most that
27
+ * old — which is why the fox's per-frame feel is never read from this component.
28
+ */
4
29
  export function Hud() {
5
30
  const state = useUiState<GameState>();
6
31
  // Nothing to draw until the game publishes its first snapshot, a few milliseconds in.
7
32
  // Rendering zeroes instead would put wrong numbers on screen and then correct them.
8
33
  if (state === undefined) return null;
9
34
  return (
10
- <div className="pointer-events-none absolute inset-0 p-6 text-[11px] uppercase tracking-[0.14em] text-text">
11
- <div className="flex gap-5">
12
- <span>
13
- coins{" "}
14
- <b id="coins" className="text-lume">
15
- {state.coins}
16
- </b>
17
- </span>
18
- <span>
19
- hearts{" "}
20
- <b id="hearts" className="text-warn">
21
- {state.hearts}
22
- </b>
23
- </span>
24
- <span>
25
- checkpoint{" "}
26
- <b id="checkpoint" className="text-lume">
27
- {state.checkpoint}
28
- </b>
29
- </span>
30
- <span>
31
- term{" "}
32
- <b id="terminal" className="text-lume">
33
- {state.terminal}
34
- </b>
35
- </span>
36
- </div>
37
- <div className="mt-2 text-dim">
38
- jumps {state.jumps} · dashes {state.dashes} · defeated {state.defeated}
35
+ <div className="pointer-events-none absolute inset-0 p-6 text-sm font-bold text-text">
36
+ <div className="w-fit rounded-2xl border-2 border-line bg-panel/40 backdrop-blur-sm px-4 py-3 shadow-none">
37
+ <div className="flex items-center gap-2">
38
+ <span aria-label={`${state.hearts} of 3 hearts left`} className="flex gap-0.5">
39
+ {[0, 1, 2].map((slot) => (
40
+ <Heart full={slot < state.hearts} key={slot} />
41
+ ))}
42
+ </span>
43
+ <span>
44
+ coins{" "}
45
+ <b id="coins" className="text-lume">
46
+ {state.coins}
47
+ </b>
48
+ </span>
49
+ <span>
50
+ gems{" "}
51
+ <b id="gems" className="text-lume">
52
+ {state.gems}/{state.gemTotal}
53
+ </b>
54
+ </span>
55
+ <span>
56
+ stars{" "}
57
+ <b id="stars" className="text-lume">
58
+ {state.stars}
59
+ </b>
60
+ </span>
61
+ </div>
62
+ <div className="mt-2 flex gap-5 text-xs text-dim">
63
+ <span id="clock">{clock(state.time)}</span>
64
+ <span>checkpoint {state.checkpoint}</span>
65
+ {state.finished ? <span className="text-lume">level clear</span> : null}
66
+ </div>
39
67
  </div>
68
+ {state.toast !== "" ? (
69
+ <div className="absolute left-1/2 top-16 -translate-x-1/2 rounded-full border-2 border-line bg-panel/40 backdrop-blur-sm px-4 py-1 text-base font-bold text-lume shadow-none">
70
+ {state.toast}
71
+ </div>
72
+ ) : null}
40
73
  </div>
41
74
  );
42
75
  }
@@ -1,7 +1,7 @@
1
1
  export function Menu() {
2
2
  return (
3
- <div className="pointer-events-none absolute bottom-6 left-6 border border-line bg-panel/75 px-4 py-3 text-[11px] uppercase tracking-[0.14em] text-dim">
4
- arrows / WASD move · space jump · shift dash
3
+ <div className="pointer-events-none absolute bottom-6 left-6 rounded-2xl border-2 border-line bg-panel/40 backdrop-blur-sm px-4 py-3 text-xs font-bold tracking-wide text-text shadow-none">
4
+ arrows / WASD run · space jump (twice) · shift dash · stomp the walkers
5
5
  </div>
6
6
  );
7
7
  }
@@ -13,7 +13,9 @@ const config: IThreeNativeConfig = {
13
13
  orientation: "landscape", // Mobile viewport orientation.
14
14
  fullscreen: true, // Keep the game surface edge to edge.
15
15
  keepScreenOn: true, // Do not dim during a play session.
16
- maxFps: 60, // Set 120 to opt into a supported high-refresh display mode.
16
+ // No `maxFps`: the engine targets the display's own refresh rate, capped at 120 on desktop
17
+ // and web and 60 on mobile, and reports the resolved value in every `TN_FRAME_BUDGET` window.
18
+ // Set a number to override it, or 0 to remove the ceiling.
17
19
  },
18
20
  window: {
19
21
  title: "__PROJECT_NAME__", // Desktop window title.
@@ -44,6 +46,17 @@ const config: IThreeNativeConfig = {
44
46
  // Switch to "native" for a UI drawn as part of the rendered frame, with no web view and no
45
47
  // extra process — and own the appearance difference that comes with it.
46
48
  ui: { renderer: "web" },
49
+ // One asset tree, one compiler, one representation per artifact. Uncomment, then cook:
50
+ // threenative build --target android # cooks defaults.android; --profile <name> beats it
51
+ // buildProfiles: {
52
+ // defaults: { android: "compact" },
53
+ // profiles: {
54
+ // compact: {
55
+ // assets: { textures: { maxSize: 1024 }, models: { textures: { maxSize: 1024 } } },
56
+ // } },
57
+ // },
58
+ // Contract, byte definitions, the build report:
59
+ // node_modules/create-threenative/agent-docs/references/build-profiles.md
47
60
  };
48
61
 
49
62
  export default config;
@@ -14,9 +14,12 @@ function assetsWatchPlugin(): Plugin {
14
14
  return {
15
15
  name: "threenative-assets-watch",
16
16
  apply: "serve",
17
- configureServer(server) {
17
+ async configureServer(server) {
18
18
  const handle = watchAssets({ config: config.assets, cwd: server.config.root });
19
19
  server.httpServer?.once("close", () => handle.close());
20
+ // Nothing is served before the first cook settles: until it does, `public/` has no
21
+ // `assets.manifest.json` and every asset answers from its source fallback.
22
+ await handle.ready;
20
23
  },
21
24
  };
22
25
  }