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,241 +0,0 @@
1
- import {
2
- type ICtx,
3
- Scene,
4
- type SceneFrame,
5
- isMobile,
6
- isTouchscreenAvailable,
7
- } from "@threenative/core";
8
- import { CollisionShape3D, RigidBody3D } from "@threenative/physics";
9
- import type { IPhysicsContext } from "@threenative/physics";
10
- import { BoxGeometry, Group, Mesh, type PerspectiveCamera, Vector3 } from "three";
11
- import { Character, PLATFORMER_FEEL } from "../entities/Character.js";
12
- import { Chaser } from "../entities/Chaser.js";
13
- import { Patrol } from "../entities/Patrol.js";
14
- import { Pickup, coinArc } from "../entities/Pickup.js";
15
- import { Checkpoints } from "../level/Checkpoints.js";
16
- import { type IPlatform, createPlatform } from "../level/Platform.js";
17
- import { emitPlaytestEvent } from "../playtest-events.js";
18
- import { setupCamera } from "../render/camera.js";
19
- import { setupLighting } from "../render/lighting.js";
20
- import { createLoadingScreen } from "../render/loading.js";
21
- import { createMaterials } from "../render/materials.js";
22
- import { setupPost } from "../render/postprocessing.js";
23
- import { setupSky } from "../render/sky.js";
24
- import { crate as crateMesh } from "../render/terrain.js";
25
- import { TouchControls } from "../render/touch-controls.js";
26
- import { type GameState, TERMINAL, type TerminalState } from "../state.js";
27
- export type GameCtx = ICtx<GameState, IPhysicsContext>;
28
- const SPAWN = new Vector3(0, 0.75, 0);
29
- const PATROL_FROM = new Vector3(5.2, 0.66, 0);
30
- const PATROL_TO = new Vector3(7.4, 0.66, 0);
31
- const KILL_PLANE = -8;
32
- const GOAL_X = 21.5;
33
- export class Level extends Scene<GameState, IPhysicsContext> {
34
- static override readonly initialState = {
35
- paused: false,
36
- uiReady: false,
37
- checkpoint: 0,
38
- coins: 0,
39
- coyoteJumps: 0,
40
- defeated: 0,
41
- dashes: 0,
42
- hearts: 3,
43
- jumps: 0,
44
- peakRise: 0,
45
- playerX: SPAWN.x,
46
- grounded: false,
47
- respawns: 0,
48
- terminal: TERMINAL.playing,
49
- topSpeed: 0,
50
- };
51
-
52
- override load(ctx: GameCtx): void {
53
- // A runner applies setup after load() but before enter(). Keep a transform-bearing placeholder
54
- // for the patrol so a setup can position/freeze it before Patrol creates its authoritative
55
- // trigger in enter(). The placeholder is never rendered or stepped.
56
- const patrol = new Group();
57
- patrol.position.copy(PATROL_FROM);
58
- ctx.entities.add("patrol", patrol);
59
- }
60
-
61
- override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
62
- setupSky(ctx.scene);
63
- const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
64
- // isMobile() arrives as an argument because src/render/ imports no framework package: the
65
- // platform decision is made here, in portable game code, exactly like createRandom.
66
- setupPost(ctx.renderer, ctx.scene, ctx.camera, { godraysLight: sun, mobile: isMobile() });
67
- const camera = ctx.camera as PerspectiveCamera;
68
- setupCamera(camera);
69
- const loading = createLoadingScreen(ctx);
70
- ctx.add(camera);
71
- const showTouchControls = isMobile() && isTouchscreenAvailable();
72
- const touchControls = showTouchControls
73
- ? ctx.entities.add("touch-controls", new TouchControls(camera))
74
- : undefined;
75
- ctx.viewport.resize();
76
- const platforms: IPlatform[] = [
77
- createPlatform(ctx, new Vector3(0, 0, 0), 18, { depth: 7, seed: 3 }),
78
- createPlatform(ctx, new Vector3(14, 0, 0), 10, { depth: 7, seed: 7 }),
79
- createPlatform(ctx, new Vector3(25, 0, 0), 8, { depth: 7, seed: 11 }),
80
- createPlatform(ctx, new Vector3(0, 2.6, 0), 6, { depth: 5, oneWay: true, seed: 17 }),
81
- ];
82
- const supportSurfaceY = (position: Pick<Vector3, "x" | "y" | "z">): number | undefined => {
83
- let surfaceY: number | undefined;
84
- for (const platform of platforms) {
85
- if (!platform.contains(position) || platform.surfaceY > position.y) continue;
86
- if (surfaceY === undefined || platform.surfaceY > surfaceY) surfaceY = platform.surfaceY;
87
- }
88
- return surfaceY;
89
- };
90
- const crate = crateMesh();
91
- crate.position.set(-3, 1, 0);
92
- crate.castShadow = crate.receiveShadow = true;
93
- ctx.add(crate);
94
- const crateBody = new RigidBody3D({
95
- object: crate,
96
- physics: ctx.physics,
97
- shape: CollisionShape3D.box(0.8, 0.8, 0.8),
98
- });
99
- ctx.entities.add("crate", { body: crateBody, object: crate });
100
- const blocker = new Mesh(new BoxGeometry(0.6, 1.6, 5.2), createMaterials().shadow);
101
- blocker.position.set(3.4, 0.8, 0);
102
- blocker.castShadow = blocker.receiveShadow = true;
103
- ctx.add(blocker);
104
- new RigidBody3D({
105
- collisionLayer: 4,
106
- object: blocker,
107
- physics: ctx.physics,
108
- shape: CollisionShape3D.box(0.6, 1.6, 5.2),
109
- type: "fixed",
110
- });
111
- const { playerX } = ctx.state.getState() as { playerX?: number };
112
- const spawn = SPAWN.clone();
113
- if (Number.isFinite(playerX)) spawn.x = playerX ?? SPAWN.x;
114
- const character = new Character(ctx, spawn);
115
- ctx.entities.add("player", character);
116
- const p = (x: number) => new Vector3(x, 0.75, 0);
117
- const checkpoints = new Checkpoints([SPAWN, p(14), p(25)], 3, PLATFORMER_FEEL);
118
- let coins = 0;
119
- let defeated = 0;
120
- let nextCoin = 0;
121
- const cameraAnchor = new Vector3();
122
- const addPickup = (at: Vector3): void => {
123
- const id = `coin.${nextCoin}`;
124
- nextCoin += 1;
125
- const pickup = new Pickup(ctx, at, () => {
126
- coins += 1;
127
- emitPlaytestEvent({ entity: "player", name: "collected" });
128
- });
129
- ctx.entities.add(id, pickup);
130
- };
131
- const followCamera = (target: Vector3, dt: number): void => {
132
- // The eye stays **below** the one-way platform, which sits at y = 2.6 directly over the
133
- // spawn because `oneway.playtest.json` jumps straight up from there and lands on it. At the
134
- // old +4.4 the camera looked down onto that slab and the character it is standing under, so
135
- // the opening frame was a green rectangle with the player hidden behind it; raising the
136
- // camera further only made it worse. Under the slab, the level reads and the platform
137
- // overhead reads as an overhang, which is what it is.
138
- const desired = cameraAnchor.set(target.x + 1.4, target.y + 1.75, target.z + 10.6);
139
- if (dt >= 1) camera.position.copy(desired);
140
- else camera.position.lerp(desired, 1 - Math.exp(-dt / 0.18));
141
- camera.lookAt(target.x + 2.2, target.y + 0.35, target.z - 0.4);
142
- };
143
- addPickup(new Vector3(2, 1.05, 0));
144
- addPickup(new Vector3(3.2, 1.05, 0));
145
- addPickup(new Vector3(4.4, 1.05, 0));
146
- for (const point of coinArc(new Vector3(11, 1.05, 0), 4, 3.6, 1.4)) addPickup(point);
147
- const patrolSetup = ctx.entities.get<Group>("patrol");
148
- const patrolPosition = patrolSetup?.position.clone() ?? PATROL_FROM.clone();
149
- const patrolQuaternion = patrolSetup?.quaternion.clone();
150
- const patrolScale = patrolSetup?.scale.clone();
151
- const patrolUserData = patrolSetup === undefined ? undefined : { ...patrolSetup.userData };
152
- if (patrolSetup !== undefined) ctx.entities.remove("patrol");
153
- const patrol = new Patrol(
154
- ctx,
155
- character,
156
- PATROL_FROM,
157
- PATROL_TO,
158
- () => {
159
- defeated += 1;
160
- },
161
- (fromX) => checkpoints.hurt(character, fromX),
162
- PLATFORMER_FEEL,
163
- );
164
- patrol.mesh.position.copy(patrolPosition);
165
- if (patrolQuaternion !== undefined) patrol.mesh.quaternion.copy(patrolQuaternion);
166
- if (patrolScale !== undefined) patrol.mesh.scale.copy(patrolScale);
167
- if (patrolUserData !== undefined) Object.assign(patrol.mesh.userData, patrolUserData);
168
- patrol.mesh.updateMatrix();
169
- patrol.area.setPosition(patrol.mesh.position);
170
- ctx.entities.add("patrol", patrol);
171
- const chaser = new Chaser(ctx, new Vector3(7.5, 0.66, 0));
172
- const avoidanceChaser = new Chaser(ctx, new Vector3(8.2, 0.66, 0.7));
173
- chaser.mesh.userData.peer = avoidanceChaser.mesh;
174
- avoidanceChaser.mesh.userData.peer = chaser.mesh;
175
- ctx.entities.add("chaser", chaser);
176
- ctx.entities.add("chaser.avoidance", avoidanceChaser);
177
- followCamera(spawn, 1);
178
- let elapsed = 0;
179
- let terminal: TerminalState = TERMINAL.playing;
180
- const statePatch: Partial<GameState> = {};
181
- const finish = (next: TerminalState): void => {
182
- if (terminal !== TERMINAL.playing) return;
183
- terminal = next;
184
- emitPlaytestEvent({ entity: "game", name: next === TERMINAL.won ? "won" : "lost" });
185
- };
186
- const updatePlaying = (frameCtx: GameCtx, dt: number): void => {
187
- elapsed += dt;
188
- character.update(
189
- frameCtx,
190
- dt,
191
- touchControls?.update(frameCtx.input.raw.pointers, frameCtx.viewport.size),
192
- supportSurfaceY,
193
- );
194
- // The chasers walk a measured route, and `pathLength` assertions read how much of it was
195
- // walked while a runner was watching. Stepping them before the world reports startup ready
196
- // spends part of the route where nothing can observe it, so the measurement becomes a
197
- // function of how long startup took — it passed on a workstation and failed in CI at
198
- // `4.43 of a required 6`, with `routeComplete` already true before the scenario began.
199
- // Everything else in this frame keeps running: only the measured routes wait.
200
- // `compileSettled`, not `phase === "ready"`: readiness additionally waits for a sustained
201
- // in-budget frame window, which a software rasteriser never meets, so gating on it froze
202
- // these routes for the whole scenario and measured a path length of 0.
203
- if (frameCtx.startup.compileSettled) {
204
- chaser.update(dt);
205
- avoidanceChaser.update(dt);
206
- }
207
- patrol.update(dt);
208
- checkpoints.pass(character.mesh.position);
209
- checkpoints.update(dt, character);
210
- character.health = checkpoints.hearts;
211
- if (character.mesh.position.y < KILL_PLANE) checkpoints.respawn(character);
212
- };
213
- return (frameCtx, dt) => {
214
- loading.update();
215
- if (terminal === TERMINAL.playing) {
216
- updatePlaying(frameCtx, dt);
217
- if (checkpoints.hearts <= 0) finish(TERMINAL.lost);
218
- else if (character.mesh.position.x >= GOAL_X && character.body.grounded)
219
- finish(TERMINAL.won);
220
- }
221
- const rise = Math.max(0, character.mesh.position.y - SPAWN.y);
222
- const speed = Math.hypot(character.body.velocity.x, character.body.velocity.z);
223
- const previous = frameCtx.state.getState();
224
- statePatch.checkpoint = checkpoints.currentIndex;
225
- statePatch.coins = coins;
226
- statePatch.coyoteJumps = character.coyoteJumps;
227
- statePatch.defeated = defeated;
228
- statePatch.dashes = character.dashes;
229
- statePatch.hearts = checkpoints.hearts;
230
- statePatch.jumps = character.jumps;
231
- statePatch.peakRise = Math.max(previous.peakRise, rise);
232
- statePatch.playerX = character.mesh.position.x;
233
- statePatch.grounded = character.body.grounded;
234
- statePatch.respawns = checkpoints.respawns;
235
- statePatch.terminal = terminal;
236
- statePatch.topSpeed = Math.max(previous.topSpeed, speed);
237
- frameCtx.state.set(statePatch);
238
- followCamera(character.mesh.position, dt);
239
- };
240
- }
241
- }
@@ -1,43 +0,0 @@
1
- # Puzzle starter kit
2
-
3
- A contraption room. A ball has to reach a ring on the far side of a lip it cannot roll over, and
4
- everything in the room is a way of getting it there: three crates you carry into a ramp, and a
5
- 90 kg weight hanging from a hinge that you can set swinging.
6
-
7
- Nothing here is downloaded. Every shape is a box, cylinder, sphere or torus built in
8
- `src/render/shapes.ts`, so the kit has no asset licence, no loading wait, and nothing to fetch.
9
-
10
- ```sh
11
- pnpm dev # play it
12
- pnpm test # the committed scenarios, in a real browser
13
- pnpm build # web
14
- pnpm build --target desktop
15
- ```
16
-
17
- ## Controls
18
-
19
- | Input | Does |
20
- | --- | --- |
21
- | `W A S D` / arrows | move the claw |
22
- | `E` or `Space`, or tap a crate | grab and drop the nearest crate |
23
- | `F` | shove the hanging weight |
24
- | `R` | reset the room |
25
-
26
- On a touch device a left thumbstick and two buttons appear instead; the same code path runs.
27
-
28
- ## What each piece is
29
-
30
- | File | Owns |
31
- | --- | --- |
32
- | `src/room.ts` | the room's geometry, its static colliders, and the instanced floor grid |
33
- | `src/entities/Crate.ts` | a carried box — steered by velocity, never teleported |
34
- | `src/entities/Pendulum.ts` | the beam, the bob, and the hinge between them |
35
- | `src/entities/Ball.ts` | the ball and the goal volume that notices it |
36
- | `src/entities/Gripper.ts` | the player |
37
- | `src/render/` | everything that decides how it looks. Yours to rewrite. |
38
-
39
- ## Where to take it
40
-
41
- The room is one `buildRoom()` call and three crate spawns. Move the lip, add a second ball, hang
42
- two weights on one beam, or make the goal move. If you want a second room, add a scene beside
43
- `Puzzle` and `goto` it — the state shape and HUD already carry a status.
@@ -1,71 +0,0 @@
1
- {
2
- "name": "carry",
3
- "target": "web",
4
- "schemaVersion": 1,
5
- "viewport": {
6
- "width": 1280,
7
- "height": 720
8
- },
9
- "warmupFrames": 40,
10
- "subject": "player",
11
- "steps": [
12
- {
13
- "kind": "input",
14
- "label": "walk-to-crate",
15
- "press": "ArrowUp",
16
- "holdTicks": 30,
17
- "release": true
18
- },
19
- {
20
- "kind": "input",
21
- "label": "grab",
22
- "press": "KeyE",
23
- "holdTicks": 4,
24
- "release": true
25
- },
26
- {
27
- "kind": "wait",
28
- "label": "lift",
29
- "waitTicks": 30,
30
- "release": true
31
- },
32
- {
33
- "kind": "input",
34
- "label": "carry-back",
35
- "press": "ArrowDown",
36
- "holdTicks": 70,
37
- "release": true
38
- },
39
- {
40
- "kind": "wait",
41
- "label": "settle",
42
- "waitTicks": 20,
43
- "release": true
44
- }
45
- ],
46
- "assert": {
47
- "diagnostics": {
48
- "noConsoleErrors": true,
49
- "noNetworkErrors": true,
50
- "noRuntimeDiagnostics": true,
51
- "runtimeReady": true
52
- },
53
- "components": [
54
- {
55
- "component": "held",
56
- "entity": "crate.0",
57
- "equals": true
58
- },
59
- {
60
- "changed": true,
61
- "component": "position",
62
- "entity": "crate.0",
63
- "path": "2"
64
- }
65
- ],
66
- "movement": {
67
- "entity": "player",
68
- "minDistance": 1.5
69
- }
70
- }
71
- }
@@ -1,38 +0,0 @@
1
- {
2
- "name": "swing",
3
- "target": "web",
4
- "schemaVersion": 1,
5
- "viewport": { "width": 1280, "height": 720 },
6
- "warmupFrames": 60,
7
- "subject": "pendulum",
8
- "steps": [
9
- { "kind": "wait", "label": "hang-still", "waitTicks": 60, "release": true },
10
- { "kind": "input", "label": "shove", "press": "KeyF", "holdTicks": 4, "release": true },
11
- { "kind": "wait", "label": "swing-out", "waitTicks": 40, "release": true }
12
- ],
13
- "assert": {
14
- "diagnostics": {
15
- "noConsoleErrors": true,
16
- "noNetworkErrors": true,
17
- "noRuntimeDiagnostics": true,
18
- "runtimeReady": true
19
- },
20
- "components": [
21
- {
22
- "component": "swings",
23
- "entity": "pendulum",
24
- "gte": 1
25
- },
26
- {
27
- "changed": true,
28
- "component": "position",
29
- "entity": "pendulum",
30
- "path": "2"
31
- }
32
- ],
33
- "movement": {
34
- "entity": "pendulum",
35
- "minDistance": 0.3
36
- }
37
- }
38
- }
@@ -1,25 +0,0 @@
1
- import { GroundSnap, normaliseToMetres } from "@threenative/core";
2
- import type { Group } from "three";
3
-
4
- export interface IPuzzleConventions {
5
- readonly applyGrounding: (surfaceY: number, dt: number) => void;
6
- readonly groundSnap: GroundSnap;
7
- readonly normaliseFactor: number;
8
- }
9
-
10
- /**
11
- * One metre is one metre, and the claw's feet meet the floor.
12
- *
13
- * `normaliseToMetres` returns the factor it applied, and `GroundSnap` reports the clearance it
14
- * settled on. Both are published through the gripper's `debug()`, so a scenario can prove the
15
- * conventions ran rather than trusting that they did.
16
- */
17
- export function prepareGripperConventions(model: Group): IPuzzleConventions {
18
- const normaliseFactor = normaliseToMetres(model, { axis: "height", metres: 1.7 });
19
- const groundSnap = new GroundSnap(model);
20
- return {
21
- applyGrounding: (surfaceY, dt) => groundSnap.apply(model, surfaceY, dt),
22
- groundSnap,
23
- normaliseFactor,
24
- };
25
- }
@@ -1,70 +0,0 @@
1
- import type { ICtx } from "@threenative/core";
2
- import { Area3D, CollisionShape3D, RigidBody3D } from "@threenative/physics";
3
- import type { Mesh } from "three";
4
- import { BALL_LAYER, BALL_MASK, type PuzzlePhysics } from "../physics.js";
5
- import { BALL_RADIUS, GOAL_RADIUS, ball as ballMesh } from "../render/shapes.js";
6
- import { BALL_START, GOAL_POSITION } from "../room.js";
7
- import type { GameState } from "../state.js";
8
-
9
- type GameCtx = ICtx<GameState, PuzzlePhysics>;
10
-
11
- /**
12
- * The thing that has to reach the goal, and the goal that notices when it does.
13
- *
14
- * The goal is an `Area3D`: an overlap volume that reports what is inside it without becoming
15
- * something the ball can bounce off. A win condition written as a distance check instead would
16
- * pass through walls and fire on a ball that flew over the ring.
17
- */
18
- export class Ball {
19
- readonly mesh: Mesh;
20
- readonly body: RigidBody3D;
21
- readonly goal: Area3D;
22
- #scored = false;
23
-
24
- constructor(ctx: GameCtx) {
25
- this.mesh = ballMesh();
26
- this.mesh.position.set(BALL_START.x, BALL_START.y, BALL_START.z);
27
- ctx.add(this.mesh);
28
- this.body = new RigidBody3D({
29
- collisionLayer: BALL_LAYER,
30
- collisionMask: BALL_MASK,
31
- entity: "ball",
32
- mass: 3.2,
33
- object: this.mesh,
34
- physics: ctx.physics,
35
- shape: CollisionShape3D.sphere(BALL_RADIUS),
36
- });
37
- this.goal = new Area3D({
38
- collisionLayer: 0,
39
- collisionMask: BALL_LAYER,
40
- entity: "goal",
41
- physics: ctx.physics,
42
- position: { x: GOAL_POSITION.x, y: GOAL_POSITION.y + 0.5, z: GOAL_POSITION.z },
43
- shape: CollisionShape3D.sphere(GOAL_RADIUS),
44
- });
45
- // Godot's `Area3D.body_entered`, unchanged. The mask above means only the ball can raise it.
46
- this.goal.on("bodyEntered", () => {
47
- this.#scored = true;
48
- });
49
- }
50
-
51
- /** True once the ball has entered the goal volume, and every frame after. */
52
- get scored(): boolean {
53
- return this.#scored;
54
- }
55
-
56
- debug(): Record<string, unknown> {
57
- const velocity = this.body.linearVelocity;
58
- return {
59
- position: this.mesh.position.toArray(),
60
- scored: this.scored,
61
- speed: Math.hypot(velocity.x, velocity.y, velocity.z),
62
- };
63
- }
64
-
65
- dispose(): void {
66
- this.goal.dispose();
67
- this.body.dispose();
68
- this.mesh.removeFromParent();
69
- }
70
- }
@@ -1,69 +0,0 @@
1
- import type { ICtx } from "@threenative/core";
2
- import { type Group, Vector3 } from "three";
3
- import { type IPuzzleConventions, prepareGripperConventions } from "../conventions.js";
4
- import type { PuzzlePhysics } from "../physics.js";
5
- import { gripper as gripperMesh } from "../render/shapes.js";
6
- import type { ITouchInput } from "../render/touch-controls.js";
7
- import { ROOM_DEPTH, ROOM_WIDTH } from "../room.js";
8
- import type { GameState } from "../state.js";
9
-
10
- type GameCtx = ICtx<GameState, PuzzlePhysics>;
11
-
12
- const MOVE_SPEED = 5.2;
13
- const SPAWN = new Vector3(-5.5, 0, 9);
14
- const MARGIN = 1.4;
15
-
16
- /**
17
- * The player.
18
- *
19
- * A claw rather than a character: this game is about what the player moves, not about the mover,
20
- * so the gripper is kinematic, stays on the floor, and carries exactly one crate. It is a plain
21
- * transform with no rigid body — nothing in the room should be solvable by shoving the player
22
- * into it.
23
- */
24
- export class Gripper {
25
- readonly mesh: Group;
26
- readonly tags = ["player", "gripper"];
27
- #conventions: IPuzzleConventions;
28
-
29
- constructor(ctx: GameCtx) {
30
- this.mesh = gripperMesh();
31
- this.mesh.name = "player";
32
- this.mesh.position.copy(SPAWN);
33
- this.#conventions = prepareGripperConventions(this.mesh);
34
- ctx.add(this.mesh);
35
- }
36
-
37
- update(ctx: GameCtx, dt: number, touch?: ITouchInput): void {
38
- const move = ctx.input.vector("move");
39
- if (touch !== undefined) {
40
- move.x += touch.move.x;
41
- move.y += touch.move.y;
42
- move.clampLength(0, 1);
43
- }
44
- const limitX = ROOM_WIDTH / 2 - MARGIN;
45
- const limitZ = ROOM_DEPTH / 2 - MARGIN;
46
- this.mesh.position.x = Math.min(
47
- limitX,
48
- Math.max(-limitX, this.mesh.position.x + move.x * MOVE_SPEED * dt),
49
- );
50
- this.mesh.position.z = Math.min(
51
- limitZ,
52
- Math.max(-limitZ, this.mesh.position.z - move.y * MOVE_SPEED * dt),
53
- );
54
- if (move.lengthSq() > 0) this.mesh.rotation.y = Math.atan2(move.x, -move.y);
55
- this.#conventions.applyGrounding(0, dt);
56
- }
57
-
58
- debug(): Record<string, unknown> {
59
- return {
60
- groundClearance: this.#conventions.groundSnap.clearance,
61
- normaliseFactor: this.#conventions.normaliseFactor,
62
- position: this.mesh.position.toArray(),
63
- };
64
- }
65
-
66
- dispose(): void {
67
- this.mesh.removeFromParent();
68
- }
69
- }
@@ -1,89 +0,0 @@
1
- import type { ICtx } from "@threenative/core";
2
- import { CollisionShape3D, Joint3D, RigidBody3D } from "@threenative/physics";
3
- import { type Mesh, Vector3 } from "three";
4
- import { type PuzzlePhysics, ROOM_LAYER, WEIGHT_LAYER } from "../physics.js";
5
- import { weight as weightMesh } from "../render/shapes.js";
6
- import { GANTRY_HEIGHT } from "../room.js";
7
- import type { GameState } from "../state.js";
8
-
9
- type GameCtx = ICtx<GameState, PuzzlePhysics>;
10
-
11
- const BOB_RADIUS = 0.62;
12
- const CABLE = 2.6;
13
- const ANCHOR = new Vector3(0, GANTRY_HEIGHT, 3.2);
14
- const SHOVE = 7.5;
15
-
16
- /**
17
- * A weight on a hinge, and the only force in the room the player cannot supply by walking.
18
- *
19
- * The beam is a fixed body with no visual of its own — the gantry mesh is decoration, and the
20
- * hinge needs something on the world side to hang from. `Joint3D.hinge` takes the anchor in each
21
- * body's *local* space, so the beam's anchor is its origin and the bob's is the cable length
22
- * above its centre.
23
- */
24
- export class Pendulum {
25
- readonly mesh: Mesh;
26
- readonly bob: RigidBody3D;
27
- readonly beam: RigidBody3D;
28
- readonly hinge: Joint3D;
29
- #swings = 0;
30
-
31
- constructor(ctx: GameCtx) {
32
- this.mesh = weightMesh(BOB_RADIUS);
33
- this.mesh.name = "pendulum-weight";
34
- this.mesh.position.set(ANCHOR.x, ANCHOR.y - CABLE, ANCHOR.z);
35
- ctx.add(this.mesh);
36
-
37
- this.beam = new RigidBody3D({
38
- collisionLayer: ROOM_LAYER,
39
- collisionMask: 0,
40
- entity: "pendulum.beam",
41
- physics: ctx.physics,
42
- position: { x: ANCHOR.x, y: ANCHOR.y, z: ANCHOR.z },
43
- shape: CollisionShape3D.box(0.3, 0.2, 0.3),
44
- type: "fixed",
45
- });
46
- this.bob = new RigidBody3D({
47
- collisionLayer: WEIGHT_LAYER,
48
- entity: "pendulum.bob",
49
- mass: 90,
50
- object: this.mesh,
51
- physics: ctx.physics,
52
- shape: CollisionShape3D.sphere(BOB_RADIUS),
53
- });
54
- this.hinge = Joint3D.hinge({
55
- anchorA: { x: 0, y: 0, z: 0 },
56
- anchorB: { x: 0, y: CABLE, z: 0 },
57
- axis: { x: 1, y: 0, z: 0 },
58
- bodyA: this.beam,
59
- bodyB: this.bob,
60
- physics: ctx.physics,
61
- });
62
- }
63
-
64
- get swings(): number {
65
- return this.#swings;
66
- }
67
-
68
- /** One shove along +z. The bob does the rest, which is the reason it is on a hinge. */
69
- swing(): void {
70
- this.#swings += 1;
71
- const velocity = this.bob.linearVelocity;
72
- this.bob.linearVelocity = { x: velocity.x, y: velocity.y, z: velocity.z + SHOVE };
73
- }
74
-
75
- debug(): Record<string, unknown> {
76
- return {
77
- position: this.mesh.position.toArray(),
78
- speed: Math.hypot(this.bob.linearVelocity.x, this.bob.linearVelocity.z),
79
- swings: this.#swings,
80
- };
81
- }
82
-
83
- dispose(): void {
84
- this.hinge.dispose();
85
- this.bob.dispose();
86
- this.beam.dispose();
87
- this.mesh.removeFromParent();
88
- }
89
- }
@@ -1,19 +0,0 @@
1
- import type { IPhysicsContext } from "@threenative/physics";
2
-
3
- /**
4
- * One bit per thing that can touch another thing.
5
- *
6
- * Layers are the game's, not the framework's: `interactionGroups` from `@threenative/physics`
7
- * encodes whichever numbers you put here into a Rapier group. Keep them powers of two and keep
8
- * the meaning in one place — a mask assembled inline at three call sites is how a crate quietly
9
- * stops colliding with the ball.
10
- */
11
- export const ROOM_LAYER = 1;
12
- export const CRATE_LAYER = 2;
13
- export const BALL_LAYER = 4;
14
- export const WEIGHT_LAYER = 8;
15
-
16
- export const CRATE_MASK = ROOM_LAYER | CRATE_LAYER | BALL_LAYER | WEIGHT_LAYER;
17
- export const BALL_MASK = ROOM_LAYER | CRATE_LAYER | BALL_LAYER | WEIGHT_LAYER;
18
-
19
- export type PuzzlePhysics = IPhysicsContext;