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
@@ -1,48 +1,45 @@
1
1
  import { type ICtx, SoftBody3D } from "@threenative/core";
2
2
  import { Area3D, CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
3
- import { type BufferGeometry, type Material, Matrix4, Mesh } from "three";
3
+ import { type BufferGeometry, Matrix4, Mesh } from "three";
4
+ import { platform } from "../render/arena.js";
5
+ import { propMaterial } from "../render/materials.js";
4
6
  import { tessellatePennant } from "../render/pennant.js";
5
- import { block, tube } from "../render/shapes.js";
7
+ import { tube } from "../render/shapes.js";
6
8
  import type { GameState } from "../state.js";
7
9
 
8
10
  /**
9
- * The far side of the gap: a fixed island, a flagpole, and the pennant the packaged glTF
11
+ * The far side of the gap: a fixed deck, a flagpole, and the pennant the packaged glTF
10
12
  * proof asset is cut from. Landing anywhere on it ends the run.
11
13
  *
12
- * The island top sits below the ledge on purpose. A same-height landing has to be jumped
14
+ * The deck top sits below the ledge on purpose. A same-height landing has to be jumped
13
15
  * within a couple of frames of the edge; dropping 0.4 m widens that window to about half
14
- * a second, which is what makes coyote time feel generous instead of decorative. Its visual
15
- * slab is shallow because the waterline sits just below the top, so the far island reads as
16
- * a sandbar rather than a submerged rectangular block.
16
+ * a second, which is what makes coyote time feel generous instead of decorative. The deck is
17
+ * the same light-grid plate over a dark-grid base as the near platform, so the far side reads
18
+ * as more of the same ground and the gap between them stays legible as a gap.
17
19
  */
18
20
  export const ISLAND = { depth: 2.6, height: 0.1, top: -0.4, width: 3, x: 7.9, z: 0 } as const;
19
21
  const POLE = { height: 2.4, radius: 0.05, x: 8.4, z: -0.5 } as const;
20
22
  const PENNANT_SCALE = 0.55;
21
23
 
22
- export interface IGoalMaterials {
23
- /** The island itself: the same ground the ledge is made of, across the gap. */
24
- readonly floor: Material;
25
- /** The pole. The accent role, and the only warm thing on the far side. */
26
- readonly goal: Material;
27
- /** The sandbar's beach rim and the flank below it. */
28
- readonly shore: Material;
29
- }
30
-
31
24
  export class Goal {
32
25
  /** The whole marker, so a playtest `visibility` row can ask whether it is on screen. */
33
26
  readonly mesh: SoftBody3D;
34
27
  readonly pennant: SoftBody3D;
35
28
  readonly area: Area3D;
36
- readonly #body: RigidBody3D;
29
+ readonly #bodies: RigidBody3D[] = [];
37
30
 
38
- constructor(ctx: ICtx<GameState, IPhysicsContext>, materials: IGoalMaterials, pennant: Mesh) {
31
+ constructor(ctx: ICtx<GameState, IPhysicsContext>, pennant: Mesh) {
39
32
  // Children carry world coordinates and the group stays at the origin: a physics body
40
33
  // reads its object's own transform, and a nested offset would silently desync them.
41
- const island = block(ISLAND.width, ISLAND.height, ISLAND.depth, materials.floor, {
42
- radius: 0.16,
43
- });
44
- island.position.set(ISLAND.x, ISLAND.top - ISLAND.height / 2, ISLAND.z);
45
- const pole = tube(POLE.radius, POLE.radius, POLE.height, materials.goal);
34
+ const { base, plate: deck } = platform(
35
+ ISLAND.width,
36
+ ISLAND.depth,
37
+ ISLAND.top,
38
+ ISLAND.x,
39
+ ISLAND.z,
40
+ 0.05,
41
+ );
42
+ const pole = tube(POLE.radius, POLE.radius, POLE.height, propMaterial);
46
43
  pole.position.set(POLE.x, ISLAND.top + POLE.height / 2, POLE.z);
47
44
  // The proof triangle points +x once it is turned on its side, which is a pennant. Its
48
45
  // hoist edge lands on the pole; the rest of it flies clear.
@@ -67,26 +64,22 @@ export class Goal {
67
64
  });
68
65
  this.pennant.name = "finish-flag-cloth";
69
66
  this.mesh = this.pennant;
70
- // A sand rim and a flank, so the far side is a sandbar and not a green rectangle floating on
71
- // the water. Left bare it was the one piece of the coast with a hard cut edge and no shore,
72
- // and it read as unfinished next to the main island's beach.
73
- const rim = block(ISLAND.width + 0.7, 0.09, ISLAND.depth + 0.7, materials.shore, {
74
- radius: 0.3,
75
- });
76
- rim.position.set(ISLAND.x, ISLAND.top - ISLAND.height - 0.02, ISLAND.z);
77
- const flank = block(ISLAND.width + 0.35, 0.5, ISLAND.depth + 0.35, materials.shore, {
78
- radius: 0.24,
79
- });
80
- flank.position.set(ISLAND.x, ISLAND.top - ISLAND.height - 0.3, ISLAND.z);
81
- this.mesh.add(island, rim, flank, pole);
67
+ this.mesh.add(deck, base, pole);
82
68
  ctx.add(this.mesh);
83
69
 
84
- this.#body = new RigidBody3D({
85
- object: island,
86
- physics: ctx.physics,
87
- shape: CollisionShape3D.fromMesh(island),
88
- type: "fixed",
89
- });
70
+ // Two fixed bodies, one per solid: the plate is what a landing lands on, and the base is
71
+ // what a body still falling past the deck's flank hits instead of passing through. Both are
72
+ // trimeshes, so the collider is the grid the player can see.
73
+ for (const mesh of [deck, base]) {
74
+ this.#bodies.push(
75
+ new RigidBody3D({
76
+ object: mesh,
77
+ physics: ctx.physics,
78
+ shape: CollisionShape3D.fromMesh(mesh, "trimesh"),
79
+ type: "fixed",
80
+ }),
81
+ );
82
+ }
90
83
  // Tall enough to catch a landing, shallow enough that a body still falling past the
91
84
  // island's flank in the gap is metres below it and never trips the finish.
92
85
  this.area = new Area3D({
@@ -118,7 +111,7 @@ export class Goal {
118
111
 
119
112
  dispose(): void {
120
113
  this.area.dispose();
121
- this.#body.dispose();
114
+ for (const body of this.#bodies) body.dispose();
122
115
  this.mesh.removeFromParent();
123
116
  }
124
117
  }
@@ -1,37 +1,58 @@
1
- import { type ICtx, mergeParts } from "@threenative/core";
1
+ import { type ICtx, SkeletalMesh3D } from "@threenative/core";
2
2
  import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
3
- import { Group, type Mesh, Vector3 } from "three";
3
+ import { type AnimationClip, Group, MathUtils, type Mesh, type Object3D, Vector3 } from "three";
4
4
  import { type IStarterConventions, preparePlayerConventions } from "../conventions.js";
5
- import { type IHeroMaterials, hero } from "../render/hero.js";
6
5
  import type { ITouchInput } from "../render/touch-controls.js";
7
6
  import type { GameState } from "../state.js";
8
7
 
9
8
  type GameCtx = ICtx<GameState, IPhysicsContext>;
10
9
 
11
10
  // Tune these two timers for jump feel; they forgive a late or early button press.
12
- // 0.12s is 7.2 ticks at the 1/60 step, and `playtests/coyote.playtest.json` is written against
13
- // that: 3 ticks walking off the ledge, 5 more airborne, then the jump — the jump lands about 5
14
- // ticks after the player actually leaves the ground, inside the window. Change this and those two
15
- // step lengths move with it. Tightening the airborne hold does NOT make the scenario safer: with
16
- // 2 the player has not left the ledge yet, and the jump is counted as an ordinary one
11
+ // 0.12s is 7.2 ticks at the 1/60 step, which is what a jump scenario measures against: 3 ticks
12
+ // walking off the ledge, 5 more airborne, then the jump — the jump lands about 5 ticks after the
13
+ // player actually leaves the ground, inside the window. Change this and those two step lengths
14
+ // move with it. Tightening the airborne hold does NOT make the scenario safer: with 2 the player
15
+ // has not left the ledge yet, and the jump is counted as an ordinary one
17
16
  // (`jumps: 1, coyoteJumps: 0`), which is what it measured when I tried.
18
17
  const COYOTE_TIME = 0.12;
19
18
  const JUMP_BUFFER = 0.14;
20
19
  const JUMP_SPEED = 5;
21
20
  const MOVE_SPEED = 2;
22
- const PLAYER_FOOT_OFFSET = 0.51;
21
+ /** Capsule for a 1.8 m figure: 0.6 m half-height plus a 0.3 m radius at each end. */
22
+ const HALF_HEIGHT = 0.6;
23
+ const RADIUS = 0.3;
24
+ const PLAYER_FOOT_OFFSET = HALF_HEIGHT + RADIUS + 0.01;
25
+ /** Where the capsule rests on a floor at y = 0: its own half-height above that surface. */
26
+ export const PLAYER_STAND_Y = HALF_HEIGHT + RADIUS;
23
27
  const VISUAL_ATTACHMENT_TOLERANCE = 0.1;
24
- const SPAWN = { x: -2, y: 0.5, z: 0 } as const;
28
+ const SPAWN = { x: -2, y: PLAYER_STAND_Y, z: 0 } as const;
29
+
30
+ /** The clips `assets/mannequin.glb` ships, by the name this file plays them under. */
31
+ const CLIPS = {
32
+ idle: "Idle_Loop",
33
+ jog: "Jog_Fwd_Loop",
34
+ jumpStart: "Jump_Start",
35
+ jumpLoop: "Jump_Loop",
36
+ jumpLand: "Jump_Land",
37
+ } as const;
38
+
39
+ export interface IPlayerModel {
40
+ readonly scene: Object3D;
41
+ readonly animations: readonly AnimationClip[];
42
+ }
25
43
 
26
44
  export class Player {
27
45
  readonly mesh: Group;
28
46
  readonly visual: Mesh;
29
47
  readonly body: CharacterBody3D;
48
+ readonly character: SkeletalMesh3D;
30
49
  #coyoteTime = 0;
31
50
  #jumpBuffer = 0;
32
51
  #jumps = 0;
33
52
  #coyoteJumps = 0;
34
53
  #odometer = 0;
54
+ #landing = 0;
55
+ #wasGrounded = true;
35
56
  #supportSurfaceY = 0;
36
57
  #previousPosition = new Vector3();
37
58
  #bodyWorldPosition = new Vector3();
@@ -40,23 +61,44 @@ export class Player {
40
61
  #hasPreviousPosition = false;
41
62
  #conventions: IStarterConventions;
42
63
 
64
+ /**
65
+ * `model` is the loaded `mannequin.glb` — Quaternius' Universal Animation Library mannequin
66
+ * (CC0), recoloured and cut to the locomotion clips. Swap in any rigged glTF with the same clip
67
+ * roles by editing `CLIPS`; `requiredClips` fails the load, by name, if one is missing.
68
+ */
43
69
  constructor(
44
70
  ctx: GameCtx,
45
- materials: IHeroMaterials,
71
+ model: IPlayerModel,
46
72
  spawn: { readonly x: number; readonly y: number; readonly z: number } = SPAWN,
47
73
  ) {
48
74
  this.mesh = new Group();
49
- this.visual = hero(materials, mergeParts);
50
- this.visual.castShadow = true;
51
- this.mesh.add(this.visual);
75
+ this.character = new SkeletalMesh3D({
76
+ source: model.scene,
77
+ clips: model.animations,
78
+ requiredClips: Object.values(CLIPS),
79
+ strideRoot: this.mesh,
80
+ });
81
+ const figure = this.character.root;
82
+ figure.traverse((object) => {
83
+ object.castShadow = true;
84
+ });
85
+ // Feet at the bottom of the capsule, sunk one centimetre so a sole never floats on the floor.
86
+ figure.position.y = -PLAYER_FOOT_OFFSET;
87
+ // The model faces +Z; start facing into the level, away from the camera.
88
+ figure.rotation.y = Math.PI;
89
+ this.mesh.add(figure);
90
+ // `visual` is the skinned figure itself: the skinned `Mesh` at the top of the rig, so the
91
+ // attachment and grounding readbacks below measure the geometry the player actually sees.
92
+ this.visual = skinnedMeshOf(figure);
52
93
  this.mesh.position.set(spawn.x, spawn.y, spawn.z);
53
- this.#conventions = preparePlayerConventions(this.visual);
94
+ this.#conventions = preparePlayerConventions(figure);
95
+ this.character.play(CLIPS.idle);
54
96
  ctx.add(this.mesh);
55
97
  this.body = new CharacterBody3D({
56
98
  autostep: { maxHeight: 0.4, minWidth: 0.2 },
57
99
  object: this.mesh,
58
100
  physics: ctx.physics,
59
- shape: CollisionShape3D.capsule(0.2, 0.3),
101
+ shape: CollisionShape3D.capsule(HALF_HEIGHT, RADIUS),
60
102
  });
61
103
  }
62
104
 
@@ -75,12 +117,14 @@ export class Player {
75
117
  if (grounded) this.#coyoteTime = COYOTE_TIME;
76
118
  if (ctx.input.justPressed("jump") || touch?.jumpPressed === true)
77
119
  this.#jumpBuffer = JUMP_BUFFER;
120
+ let jumped = false;
78
121
  if (this.#jumpBuffer > 0 && this.#coyoteTime > 0) {
79
122
  this.body.velocity.y = JUMP_SPEED;
80
123
  this.#jumpBuffer = 0;
81
124
  this.#coyoteTime = 0;
82
125
  this.#jumps += 1;
83
126
  if (!grounded) this.#coyoteJumps += 1;
127
+ jumped = true;
84
128
  }
85
129
  const move = ctx.input.vector("move");
86
130
  if (touch !== undefined) {
@@ -103,6 +147,7 @@ export class Player {
103
147
  this.#conventions.groundSnap.enabled = canCorrectGrounding;
104
148
  this.#conventions.applyGrounding(this.#supportSurfaceY, dt);
105
149
  this.#captureVisualBodyOffset();
150
+ this.#animate(dt, move.length(), jumped);
106
151
  }
107
152
 
108
153
  respawn(): void {
@@ -162,6 +207,28 @@ export class Player {
162
207
  this.mesh.removeFromParent();
163
208
  }
164
209
 
210
+ /** Faces the direction of travel and picks a clip from what the body is actually doing. */
211
+ #animate(dt: number, speed: number, jumped: boolean): void {
212
+ const figure = this.character.root;
213
+ if (speed > 0.05) {
214
+ const heading = Math.atan2(this.body.velocity.x, this.body.velocity.z);
215
+ const turn = MathUtils.euclideanModulo(heading - figure.rotation.y + Math.PI, Math.PI * 2);
216
+ figure.rotation.y += (turn - Math.PI) * Math.min(1, dt * 12);
217
+ }
218
+ const grounded = this.body.grounded;
219
+ this.#landing -= dt;
220
+ if (jumped) this.character.play(CLIPS.jumpStart, { fade: 0.08, mode: "once" });
221
+ else if (!grounded && this.character.finished)
222
+ this.character.play(CLIPS.jumpLoop, { fade: 0.15 });
223
+ else if (grounded && !this.#wasGrounded) {
224
+ this.#landing = 0.25;
225
+ this.character.play(CLIPS.jumpLand, { fade: 0.06, mode: "once" });
226
+ } else if (grounded && this.#landing <= 0)
227
+ this.character.play(speed > 0.05 ? CLIPS.jog : CLIPS.idle, { fade: 0.2 });
228
+ this.#wasGrounded = grounded;
229
+ this.character.update(dt);
230
+ }
231
+
165
232
  #captureVisualBodyOffset(): void {
166
233
  if (this.#visualBodyOffsetY !== undefined || !this.body.grounded || this.body.velocity.y > 0)
167
234
  return;
@@ -179,3 +246,19 @@ export class Player {
179
246
  );
180
247
  }
181
248
  }
249
+
250
+ /**
251
+ * The skinned `Mesh` inside a rig, which is the geometry the player actually sees.
252
+ *
253
+ * The rig's root is whatever glTF happened to call its top node, so a rig can arrive as a `Group`
254
+ * with the `Mesh` below it or already be the `Mesh`. The readbacks in `debug()` measure the drawn
255
+ * figure against the body, so they need that `Mesh` and not the wrapper above it.
256
+ */
257
+ function skinnedMeshOf(figure: Object3D): Mesh {
258
+ let found: Mesh | undefined;
259
+ figure.traverse((object) => {
260
+ if (found === undefined && (object as Mesh).isMesh === true) found = object as Mesh;
261
+ });
262
+ if (found === undefined) throw new Error("The player rig carried no skinned mesh to animate.");
263
+ return found;
264
+ }
@@ -0,0 +1,131 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // The prototype test arena every engine opens a new project on, and the one shape every platform
5
+ // in it is cut from: a light metre-grid plate on top of a dark-grid body that reaches the ground.
6
+ // Two meshes, so the walking surface reads as floor and the sides read as structure — and two
7
+ // solids, so the player collides with exactly the triangles they can see.
8
+ //
9
+ // Every solid here is **placed in the geometry, not on the mesh**, for one reason: `worldGridUVs`
10
+ // measures UVs in world metres, and a trimesh collider built from that geometry is the exact
11
+ // surface the player sees. Move a solid by rebuilding it here, not by writing `mesh.position` —
12
+ // a collider reads the mesh transform and the shape separately, and the two only agree while the
13
+ // mesh sits at the origin.
14
+ import { type BufferGeometry, CylinderGeometry, Group, Mesh, PlaneGeometry } from "three";
15
+ import { floorMaterial, structureMaterial, worldGridUVs } from "./materials.js";
16
+ import { roundedBox } from "./shapes.js";
17
+
18
+ /**
19
+ * The light grid the arena stands on, six metres below the route. Nothing collides with it, which
20
+ * is what makes the gap between the two platforms a real pit rather than scenery underfoot.
21
+ */
22
+ const GROUND_Y = -6;
23
+ /** The dark-grid walls that close the arena, and how far the route's own ground sits below them. */
24
+ const ARENA = { halfX: 13, halfZ: 11, thickness: 1, wallTop: 4 } as const;
25
+
26
+ const PLATE = 0.2;
27
+
28
+ /** `roundedBox` caches and hands back one instance per size, so a placed copy has to be its own. */
29
+ function placed(geometry: BufferGeometry, at: readonly [number, number, number]): BufferGeometry {
30
+ return worldGridUVs(geometry.clone().translate(...at));
31
+ }
32
+
33
+ function meshOf(
34
+ geometry: BufferGeometry,
35
+ at: readonly [number, number, number],
36
+ material: Mesh["material"],
37
+ ): Mesh {
38
+ const mesh = new Mesh(placed(geometry, at), material);
39
+ mesh.castShadow = true;
40
+ mesh.receiveShadow = true;
41
+ return mesh;
42
+ }
43
+
44
+ /** A rounded box: a wall, a pillar, a platform's plate or its body. */
45
+ function box(
46
+ size: readonly [number, number, number],
47
+ at: readonly [number, number, number],
48
+ material: Mesh["material"],
49
+ radius: number,
50
+ ): Mesh {
51
+ return meshOf(roundedBox(size[0], size[1], size[2], radius), at, material);
52
+ }
53
+
54
+ export interface IPlatform {
55
+ /** The authoritative support surface: its top face is the surface's `y`. */
56
+ readonly plate: Mesh;
57
+ /** The dark-grid body under it, running down to `GROUND_Y`. */
58
+ readonly base: Mesh;
59
+ }
60
+
61
+ /** One platform: a light-grid top at `top`, on a dark-grid body that meets the ground. */
62
+ export function platform(
63
+ width: number,
64
+ depth: number,
65
+ top: number,
66
+ x: number,
67
+ z: number,
68
+ radius = 0.1,
69
+ ): IPlatform {
70
+ const height = top - PLATE - GROUND_Y;
71
+ return {
72
+ base: box([width, height, depth], [x, top - PLATE - height / 2, z], structureMaterial, radius),
73
+ plate: box([width, PLATE, depth], [x, top - PLATE / 2, z], floorMaterial, radius),
74
+ };
75
+ }
76
+
77
+ export interface IArena {
78
+ /** Everything static, added in one call. */
79
+ readonly group: Group;
80
+ /**
81
+ * The meshes that must collide. Give each one `CollisionShape3D.fromMesh(mesh, "trimesh")`:
82
+ * the kind is named rather than inferred, because an inferred box of a geometry whose offset is
83
+ * baked in would collide at the world origin.
84
+ */
85
+ readonly solids: Mesh[];
86
+ }
87
+
88
+ /**
89
+ * The ground, the four walls and one pillar. `platform` is deliberately not in here — the two
90
+ * platforms are the course, and the course is gameplay, so the scene places them itself.
91
+ */
92
+ export function createArena(): IArena {
93
+ const group = new Group();
94
+ // The ground runs out past the walls to the haze line, so the sky over a wall meets ground and
95
+ // not a void. It is decoration, not floor: it has no collider, and that is the pit under the gap.
96
+ const ground = new Mesh(
97
+ worldGridUVs(new PlaneGeometry(12_000, 12_000).rotateX(-Math.PI / 2)),
98
+ floorMaterial,
99
+ );
100
+ ground.position.y = GROUND_Y;
101
+ ground.receiveShadow = true;
102
+ group.add(ground);
103
+ const height = ARENA.wallTop - GROUND_Y;
104
+ const y = GROUND_Y + height / 2;
105
+ const walls = (
106
+ [
107
+ [
108
+ [ARENA.halfX * 2 + ARENA.thickness, height, ARENA.thickness],
109
+ [0, y, -ARENA.halfZ],
110
+ ],
111
+ [
112
+ [ARENA.halfX * 2 + ARENA.thickness, height, ARENA.thickness],
113
+ [0, y, ARENA.halfZ],
114
+ ],
115
+ [
116
+ [ARENA.thickness, height, ARENA.halfZ * 2 - ARENA.thickness],
117
+ [-ARENA.halfX, y, 0],
118
+ ],
119
+ [
120
+ [ARENA.thickness, height, ARENA.halfZ * 2 - ARENA.thickness],
121
+ [ARENA.halfX, y, 0],
122
+ ],
123
+ ] as const
124
+ ).map(([size, at]) => box(size, at, structureMaterial, 0.14));
125
+ // A tall dark mass behind the route: the course is a corridor, and this is what tells the player
126
+ // where the frame stops. A cylinder rather than a box, so its collider has to be a trimesh.
127
+ const pillar = meshOf(new CylinderGeometry(1.6, 1.6, height, 48), [-9, y, -8], structureMaterial);
128
+ const solids = [...walls, pillar];
129
+ for (const solid of solids) group.add(solid);
130
+ return { group, solids };
131
+ }
@@ -1,60 +1,43 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  // ThreeNative does not read this file.
3
3
  //
4
- // Four lights, and the fourth is the one people forget: a cool rim from behind
5
- // so silhouettes separate from the background instead of reading as flat
6
- // cut-outs. Key + bounce + ambient gets you a lit scene; the rim is what makes
7
- // it look shaded.
8
- import {
9
- AmbientLight,
10
- DirectionalLight,
11
- HemisphereLight,
12
- PCFSoftShadowMap,
13
- type Scene,
14
- } from "three";
15
- import { palette } from "./palette.js";
4
+ // One sun. The sky image in `sky.ts` is the fill light — its environment reaches every face the
5
+ // sun misses — so there is no hemisphere or ambient light stacked on top to flatten the frame.
6
+ import { DirectionalLight, PCFSoftShadowMap, type Scene } from "three";
7
+ import { SUN_DIRECTION } from "./sky.js";
16
8
 
17
9
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
18
10
 
19
- // Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow
20
- // map, so the scene hands the sun to `setupPost` and a shadowless light is refused by name
21
- // instead of rendering a black pass.
22
- export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
11
+ export function setupLighting(
12
+ scene: Scene,
13
+ renderer: ShadowRenderer,
14
+ mobile = false,
15
+ ): { key: DirectionalLight } {
23
16
  renderer.shadowMap.enabled = true;
24
17
  renderer.shadowMap.type = PCFSoftShadowMap;
25
18
 
26
- // Sky above, ground bounce below. Tint the second colour toward whatever the
27
- // floor actually is — it is the cheapest realism in the whole rig.
28
- scene.add(new HemisphereLight(palette.skyHigh, palette.skyLow, 1.8));
29
-
30
- const key = new DirectionalLight(palette.accent, 2.4);
31
- key.position.set(4, 7, 3);
19
+ // Warm white, matched by eye to the photographed midday sun against its own sky.
20
+ const key = new DirectionalLight(0xfff1e0, 4.5);
21
+ key.position.copy(SUN_DIRECTION).multiplyScalar(30);
32
22
  key.castShadow = true;
33
- // 1024² is one quarter of a 2048² map's texel storage and fill work while
34
- // retaining enough resolution for this small authored route. Increase it
35
- // only when a larger level makes the 18-unit camera extent visibly soft.
36
- key.shadow.mapSize.set(1024, 1024);
37
- key.shadow.camera.near = 0.5;
38
- key.shadow.camera.far = 60;
39
- // A shadow camera tight enough to stay crisp cannot also cover a big level;
40
- // this extent matches the generated route. Widen it, or move the light with
41
- // the player, when the world grows.
42
- const extent = 18;
23
+ // One map fitted to the 28 m arena: 4096² is under a centimetre a texel, so every shadow has the
24
+ // same softness. Camera-centred cascades (`VirtualShadowNode`) are for open worlds; here their
25
+ // level boundaries showed as shadows that turned sharp halfway along. Phones take 2048².
26
+ const size = mobile ? 2048 : 4096;
27
+ key.shadow.mapSize.set(size, size);
28
+ key.shadow.radius = 2;
29
+ key.shadow.camera.near = 1;
30
+ key.shadow.camera.far = 80;
31
+ const extent = 14;
43
32
  key.shadow.camera.left = -extent;
44
33
  key.shadow.camera.right = extent;
45
34
  key.shadow.camera.top = extent;
46
35
  key.shadow.camera.bottom = -extent;
47
- key.shadow.bias = -0.0008;
48
- // Rounded geometry self-shadows at grazing angles without this, and the bias
49
- // alone would have to grow big enough to detach contact shadows.
50
- key.shadow.normalBias = 0.03;
36
+ // Small biases: a large normal bias is what lifted the mannequin's shadow off its own feet.
37
+ key.shadow.bias = -0.0002;
38
+ key.shadow.normalBias = 0.005;
51
39
  scene.add(key);
52
-
53
- const rim = new DirectionalLight(palette.skyHigh, 0.9);
54
- rim.position.set(-5, 3, -6);
55
- scene.add(rim);
56
-
57
- scene.add(new AmbientLight(palette.skyLow, 0.38));
58
-
59
- return key;
40
+ // The key light is returned because `WorldEnvironment`'s godrays stage raymarches against its
41
+ // shadow map, so `setupPost` needs the light itself.
42
+ return { key };
60
43
  }