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
@@ -0,0 +1,196 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // Chibi fox in a blue jacket, modelled from primitives: no mesh file, no skin, no animation clip.
4
+ // Every joint is a group the run cycle below rotates, so the whole character is one procedural rig
5
+ // and no asset bytes. Local space is feet at y = 0 facing +X; `createFox` returns the group to
6
+ // parent and the one function that poses it, so nothing else knows the rig's joint layout.
7
+ import {
8
+ BoxGeometry,
9
+ type BufferGeometry,
10
+ CapsuleGeometry,
11
+ CircleGeometry,
12
+ ConeGeometry,
13
+ CylinderGeometry,
14
+ Group,
15
+ type Material,
16
+ MathUtils,
17
+ Mesh,
18
+ type MeshBasicMaterial,
19
+ SphereGeometry,
20
+ TorusGeometry,
21
+ } from "three";
22
+ import { flat, toon } from "./materials.js";
23
+ import { C } from "./palette.js";
24
+
25
+ export interface IFoxPose {
26
+ readonly dashing: boolean;
27
+ readonly dt: number;
28
+ /** Metres between the fox's feet and the surface under it, for the contact shadow. */
29
+ readonly drop: number;
30
+ readonly grounded: boolean;
31
+ readonly speed: number;
32
+ readonly vy: number;
33
+ }
34
+
35
+ export interface IFox {
36
+ readonly group: Group;
37
+ update(pose: IFoxPose): void;
38
+ }
39
+ function part(geometry: BufferGeometry, material: Material, x = 0, y = 0, z = 0): Mesh {
40
+ const mesh = new Mesh(geometry, material);
41
+ mesh.position.set(x, y, z);
42
+ mesh.castShadow = true;
43
+ return mesh;
44
+ }
45
+
46
+ export function createFox(): IFox {
47
+ const root = new Group();
48
+ const fur = toon(C.fur);
49
+ const cream = toon(C.cream);
50
+ const jacket = toon(C.jacket);
51
+ const jacketDark = toon(C.jacketDark);
52
+ const ink = toon(C.ink);
53
+
54
+ const body = new Group();
55
+ body.position.y = 0.58;
56
+ root.add(body);
57
+
58
+ // Torso, then the jacket's hem and collar: not one solid tube.
59
+ const torso = part(new CapsuleGeometry(0.3, 0.24, 4, 10), jacket, 0, 0.2, 0);
60
+ torso.scale.set(1, 1, 0.92);
61
+ body.add(torso);
62
+ body.add(part(new CylinderGeometry(0.33, 0.35, 0.12, 12), jacketDark, 0, -0.02, 0));
63
+ body.add(part(new CylinderGeometry(0.25, 0.28, 0.1, 12), jacketDark, 0, 0.44, 0));
64
+
65
+ const belly = part(new SphereGeometry(0.2, 10, 8), cream, 0.2, 0.14, 0);
66
+ belly.scale.set(0.7, 1, 0.9);
67
+ body.add(belly);
68
+ // The backpack and its strap, which is what stops the torso reading as a capsule.
69
+ const pack = part(new BoxGeometry(0.3, 0.34, 0.26), toon(C.pack), -0.26, 0.22, 0);
70
+ const strap = part(new TorusGeometry(0.22, 0.035, 6, 14), toon(C.pack), -0.1, 0.24, 0);
71
+ strap.rotation.y = Math.PI / 2;
72
+ const buckle = part(new CylinderGeometry(0.07, 0.07, 0.06, 8), toon(C.gemLight), -0.42, 0.24, 0);
73
+ buckle.rotation.z = Math.PI / 2;
74
+ body.add(pack, strap, buckle);
75
+
76
+ const head = new Group();
77
+ head.position.set(0.02, 0.62, 0);
78
+ body.add(head);
79
+
80
+ const skull = part(new SphereGeometry(0.34, 12, 10), fur);
81
+ skull.scale.set(0.95, 0.94, 1);
82
+ head.add(skull);
83
+ const cheeks = part(new SphereGeometry(0.26, 10, 8), cream, 0.12, -0.08, 0);
84
+ cheeks.scale.set(0.85, 0.8, 1.02);
85
+ head.add(cheeks);
86
+ const muzzle = part(new SphereGeometry(0.14, 8, 6), cream, 0.3, -0.07, 0);
87
+ muzzle.scale.set(0.9, 0.75, 0.85);
88
+ head.add(muzzle);
89
+ head.add(part(new SphereGeometry(0.055, 8, 6), ink, 0.42, -0.04, 0));
90
+
91
+ for (const side of [-1, 1]) {
92
+ const eye = part(new SphereGeometry(0.062, 8, 6), ink, 0.26, 0.06, 0.15 * side);
93
+ eye.scale.set(0.8, 1.15, 1);
94
+ head.add(eye);
95
+ const glint = part(new SphereGeometry(0.022, 6, 6), toon(0xffffff), 0.31, 0.1, 0.17 * side);
96
+ head.add(glint);
97
+ const ear = new Group();
98
+ ear.position.set(-0.02, 0.28, 0.17 * side);
99
+ ear.rotation.x = -0.35 * side;
100
+ head.add(ear);
101
+ ear.add(part(new ConeGeometry(0.13, 0.3, 8), fur, 0, 0.13, 0));
102
+ ear.add(part(new ConeGeometry(0.075, 0.18, 6), ink, 0.02, 0.13, 0));
103
+ }
104
+
105
+ const limbs: Record<"armL" | "armR" | "legL" | "legR", Group> = {
106
+ armL: new Group(),
107
+ armR: new Group(),
108
+ legL: new Group(),
109
+ legR: new Group(),
110
+ };
111
+ for (const [name, side] of [
112
+ ["L", 1],
113
+ ["R", -1],
114
+ ] as const) {
115
+ const arm = limbs[`arm${name}`];
116
+ arm.position.set(0, 0.34, 0.29 * side);
117
+ body.add(arm);
118
+ arm.add(part(new CapsuleGeometry(0.085, 0.16, 4, 8), jacket, 0, -0.12, 0));
119
+ arm.add(part(new SphereGeometry(0.095, 8, 6), cream, 0, -0.27, 0));
120
+
121
+ const leg = limbs[`leg${name}`];
122
+ leg.position.set(0, 0.02, 0.14 * side);
123
+ body.add(leg);
124
+ leg.add(part(new CapsuleGeometry(0.1, 0.18, 4, 8), cream, 0, -0.16, 0));
125
+ leg.add(part(new BoxGeometry(0.24, 0.11, 0.15), cream, 0.05, -0.33, 0));
126
+ }
127
+
128
+ const tail = new Group();
129
+ tail.position.set(-0.3, 0.18, 0);
130
+ tail.rotation.z = 0.5;
131
+ body.add(tail);
132
+ const tailSegments: Group[] = [];
133
+ const radii = [0.17, 0.19, 0.19, 0.17, 0.13];
134
+ let previous: Group = tail;
135
+ for (let i = 0; i < radii.length; i += 1) {
136
+ const segment = new Group();
137
+ segment.position.x = i === 0 ? -0.12 : -0.19;
138
+ previous.add(segment);
139
+ const colour = i >= radii.length - 1 ? cream : i % 2 === 0 ? fur : cream;
140
+ const ball = part(new SphereGeometry(radii[i] ?? 0.15, 10, 8), colour);
141
+ ball.scale.set(1.05, 1, 1);
142
+ segment.add(ball);
143
+ tailSegments.push(segment);
144
+ previous = segment;
145
+ }
146
+
147
+ // The contact shadow: a blob that shrinks with the drop, which is what keeps the fox planted on
148
+ // a bright grass cap where the shadow map's own shadow is easy to lose.
149
+ const blob = new Mesh(
150
+ new CircleGeometry(0.42, 16),
151
+ flat(0x0a2436, { depthWrite: false, opacity: 0.3 }),
152
+ );
153
+ blob.rotation.x = -Math.PI / 2;
154
+ blob.renderOrder = 2;
155
+ root.add(blob);
156
+
157
+ let time = 0;
158
+ return {
159
+ group: root,
160
+ update(pose: IFoxPose): void {
161
+ time += pose.dt;
162
+ const run = Math.min(1, pose.speed / 7);
163
+ const cycle = time * (6 + run * 9);
164
+ if (pose.grounded) {
165
+ const swing = Math.sin(cycle) * (0.35 + run * 0.75);
166
+ limbs.legL.rotation.z = swing;
167
+ limbs.legR.rotation.z = -swing;
168
+ limbs.armL.rotation.z = -swing * 0.85;
169
+ limbs.armR.rotation.z = swing * 0.85;
170
+ body.position.y =
171
+ 0.58 + Math.abs(Math.sin(cycle)) * 0.06 * run + Math.sin(time * 2.2) * 0.012;
172
+ body.rotation.z = -0.06 - run * 0.16 - (pose.dashing ? 0.16 : 0);
173
+ } else {
174
+ const rise = MathUtils.clamp(pose.vy / 9, -1, 1);
175
+ limbs.legL.rotation.z = MathUtils.lerp(limbs.legL.rotation.z, 0.5 + rise * 0.5, 0.25);
176
+ limbs.legR.rotation.z = MathUtils.lerp(limbs.legR.rotation.z, -0.2 + rise * 0.4, 0.25);
177
+ limbs.armL.rotation.z = MathUtils.lerp(limbs.armL.rotation.z, -1.5 - rise * 0.6, 0.2);
178
+ limbs.armR.rotation.z = MathUtils.lerp(limbs.armR.rotation.z, -1.2 - rise * 0.5, 0.2);
179
+ body.position.y = 0.58;
180
+ body.rotation.z = MathUtils.lerp(body.rotation.z, -0.12, 0.15);
181
+ }
182
+ head.rotation.z = Math.sin(cycle * 0.5) * 0.04 - run * 0.08;
183
+ head.rotation.y = Math.sin(time * 1.3) * 0.06;
184
+ tail.rotation.z = 0.5 - run * 0.55 + Math.sin(time * 3) * 0.08;
185
+ for (const [index, segment] of tailSegments.entries()) {
186
+ segment.rotation.z = Math.sin(time * (5 + run * 4) - index * 0.7) * (0.1 + run * 0.14);
187
+ segment.rotation.y = Math.sin(time * 2.4 - index * 0.5) * 0.1;
188
+ }
189
+ blob.position.y = -pose.drop + 0.02;
190
+ blob.visible = pose.drop < 7;
191
+ const k = MathUtils.clamp(1 - pose.drop / 7, 0.25, 1);
192
+ blob.scale.setScalar(k);
193
+ (blob.material as MeshBasicMaterial).opacity = 0.3 * k;
194
+ },
195
+ };
196
+ }
@@ -1,46 +1,55 @@
1
- import {
2
- AmbientLight,
3
- DirectionalLight,
4
- HemisphereLight,
5
- PCFSoftShadowMap,
6
- type Scene,
7
- } from "three";
8
- import { palette } from "./palette.js";
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // One sun, and the sky photograph in `sky.ts` is the fill. Nothing else is stacked on top: a
5
+ // hemisphere or ambient light next to an image-based environment fills the same faces twice and
6
+ // flattens exactly the shadow side the sun was there to make. The low-poly geometry keeps its own
7
+ // separation through `flatShading` and baked vertex mottle, which is why this level reads as
8
+ // facetted without a second light.
9
+ import { DirectionalLight, PCFSoftShadowMap, type Scene, type Vector3 } from "three";
10
+ import { SUN_DIRECTION } from "./sky.js";
9
11
 
10
12
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
11
13
 
12
- // Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow map, so
13
- // the scene hands the sun to `setupPost` and a shadowless light is refused by name instead of
14
- // rendering a black pass.
15
- export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
14
+ export interface ILighting {
15
+ /** Aimed at the player every frame, so one map covers the route instead of 100 m of it. */
16
+ readonly key: DirectionalLight;
17
+ follow(player: Vector3): void;
18
+ }
19
+
20
+ export function setupLighting(scene: Scene, renderer: ShadowRenderer, mobile = false): ILighting {
16
21
  renderer.shadowMap.enabled = true;
17
22
  renderer.shadowMap.type = PCFSoftShadowMap;
18
- scene.add(new HemisphereLight(palette.skyLow, palette.ground, 0.5));
19
23
 
20
- // Warm white, not the accent. Keyed with a saturated yellow, the grass, the character and the
21
- // stone all took the same cast and the palette collapsed towards one pale band — the same
22
- // failure the fog note in `sky.ts` describes, arriving through the light instead.
23
- const key = new DirectionalLight(0xfff2d8, 2.1);
24
- key.position.set(5, 8, 4);
24
+ // Warm white, matched by eye to the photographed midday sun against its own sky.
25
+ const key = new DirectionalLight(0xfff1e0, 4.2);
25
26
  key.castShadow = true;
26
- // 1024² is one quarter of a 2048² map's texel storage and fill work. The
27
- // 24-unit extent covers the generated opening route; widen both together
28
- // when a larger level needs more shadow coverage, accepting softer shadows.
29
- key.shadow.mapSize.set(1024, 1024);
30
- key.shadow.camera.near = 0.5;
31
- key.shadow.camera.far = 80;
32
- const extent = 24;
27
+ // The camera never sees more than about 40 m of the route at once, so the map is fitted to that
28
+ // window and travels with the player. 4096² over 40 m is under a centimetre a texel; phones
29
+ // take 2048². Fitted to the whole 100 m route instead, every shadow would be the same size as
30
+ // the fox's ear.
31
+ const size = mobile ? 2048 : 4096;
32
+ const extent = mobile ? 14 : 22;
33
+ key.shadow.mapSize.set(size, size);
34
+ key.shadow.radius = 2;
35
+ key.shadow.camera.near = 1;
36
+ key.shadow.camera.far = 120;
33
37
  key.shadow.camera.left = -extent;
34
38
  key.shadow.camera.right = extent;
35
39
  key.shadow.camera.top = extent;
36
40
  key.shadow.camera.bottom = -extent;
37
- key.shadow.normalBias = 0.04;
41
+ // Small biases: a large normal bias is what lifts a shadow off the feet of the thing casting it.
42
+ key.shadow.bias = -0.0002;
43
+ key.shadow.normalBias = 0.02;
38
44
  scene.add(key);
39
-
40
- const rim = new DirectionalLight(palette.skyLow, 0.45);
41
- rim.position.set(-5, 4, -7);
42
- scene.add(rim);
43
- scene.add(new AmbientLight(palette.skyLow, 0.42));
44
-
45
- return key;
45
+ scene.add(key.target);
46
+ const offset = SUN_DIRECTION.clone().multiplyScalar(40);
47
+ return {
48
+ follow(player: Vector3): void {
49
+ key.position.set(player.x + offset.x, player.y + offset.y, player.z + offset.z);
50
+ key.target.position.copy(player);
51
+ key.target.updateMatrixWorld();
52
+ },
53
+ key,
54
+ };
46
55
  }
@@ -1,11 +1,121 @@
1
- import { MeshStandardMaterial } from "three";
2
- import { palette, toon } from "./palette.js";
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // One material per colour, cached, because a level is thousands of small meshes sharing a dozen
5
+ // colours: a fresh material per mesh is a fresh shader compile per mesh. `flat` is the unlit
6
+ // variant for anything that must stay bright regardless of the sun (clouds, water, the goal
7
+ // cloth), and `mottle` is how a flat box becomes mottled stone with no texture at all.
8
+ import {
9
+ BoxGeometry,
10
+ BufferAttribute,
11
+ type BufferGeometry,
12
+ type ColorRepresentation,
13
+ DoubleSide,
14
+ type Material,
15
+ MeshBasicMaterial,
16
+ MeshStandardMaterial,
17
+ } from "three";
18
+ import { C, palette } from "./palette.js";
3
19
 
20
+ const cache = new Map<string, Material>();
21
+
22
+ function cached<T extends Material>(key: string, make: () => T): T {
23
+ const hit = cache.get(key);
24
+ if (hit !== undefined) return hit as T;
25
+ const material = make();
26
+ cache.set(key, material);
27
+ return material;
28
+ }
29
+
30
+ /**
31
+ * Lit surface. `flatShading` keeps the low-poly facets reading as facets under one sun, and
32
+ * `vertexColors` is what makes `mottle`'s baked variation visible.
33
+ *
34
+ * The two flags are part of the cache key, so a mottled material and a plain one of the same
35
+ * colour are different materials. That is what lets a whole scenery subtree be merged into one
36
+ * draw per material: two meshes in one bucket must agree on every attribute, and a bucket that
37
+ * half its pieces cannot see is a bucket that silently loses the mottle.
38
+ */
39
+ export function toon(
40
+ color: ColorRepresentation,
41
+ options: { flat?: boolean; vertexColors?: boolean } = {},
42
+ ): MeshStandardMaterial {
43
+ return cached(
44
+ `lit|${String(color)}|${String(options.flat ?? false)}|${String(options.vertexColors ?? false)}`,
45
+ () =>
46
+ new MeshStandardMaterial({
47
+ color,
48
+ flatShading: options.flat ?? false,
49
+ metalness: 0,
50
+ roughness: 0.82,
51
+ vertexColors: options.vertexColors ?? false,
52
+ }),
53
+ );
54
+ }
55
+
56
+ /** Unlit, for things that must stay bright whatever the sun is doing. */
57
+ export function flat(
58
+ color: ColorRepresentation,
59
+ options: { depthWrite?: boolean; fog?: boolean; opacity?: number; side?: typeof DoubleSide } = {},
60
+ ): MeshBasicMaterial {
61
+ return cached(
62
+ `flat|${String(color)}|${JSON.stringify(options)}`,
63
+ () => new MeshBasicMaterial({ color, ...options }),
64
+ );
65
+ }
66
+
67
+ /**
68
+ * Bake a per-quad brightness variation into a geometry as vertex colours.
69
+ *
70
+ * Two triangles share one tint so a quad reads as a flat stone facet rather than a smooth
71
+ * gradient, which is what turns a grey box into rock without a single texture.
72
+ */
73
+ export function mottle(
74
+ geometry: BufferGeometry,
75
+ variance = 0.18,
76
+ rng: () => number = Math.random,
77
+ ): BufferGeometry {
78
+ const g = geometry.index === null ? geometry : geometry.toNonIndexed();
79
+ const count = g.attributes.position?.count ?? 0;
80
+ const colors = new Float32Array(count * 3);
81
+ for (let i = 0; i < count; i += 6) {
82
+ const k = 1 - variance / 2 + rng() * variance;
83
+ for (let v = 0; v < 6 && i + v < count; v += 1) {
84
+ colors[(i + v) * 3] = k;
85
+ colors[(i + v) * 3 + 1] = k;
86
+ colors[(i + v) * 3 + 2] = k;
87
+ }
88
+ }
89
+ g.setAttribute("color", new BufferAttribute(colors, 3));
90
+ return g;
91
+ }
92
+
93
+ /** A box subdivided into rough facets, ready for `mottle`. */
94
+ export function rockBox(
95
+ width: number,
96
+ height: number,
97
+ depth: number,
98
+ rng: () => number = Math.random,
99
+ variance = 0.2,
100
+ ): BufferGeometry {
101
+ const segments = (n: number): number => Math.max(1, Math.min(6, Math.round(n / 3)));
102
+ return mottle(
103
+ new BoxGeometry(width, height, depth, segments(width), segments(height), segments(depth)),
104
+ variance,
105
+ rng,
106
+ );
107
+ }
108
+
109
+ /** The handful of surfaces this level is made of, resolved once. */
4
110
  export function createMaterials() {
5
111
  return {
6
112
  accent: toon(palette.accent),
7
- character: toon(palette.character),
8
- ground: toon(palette.ground),
9
- shadow: new MeshStandardMaterial({ color: palette.shadow, roughness: 0.9 }),
113
+ cloth: flat(0xff5a4a, { side: DoubleSide }),
114
+ dirt: toon(C.dirt),
115
+ foliage: toon(C.grass),
116
+ rock: toon(C.rock, { flat: true }),
117
+ rockDark: toon(C.rockDark, { flat: true }),
118
+ wood: toon(C.wood),
119
+ woodDark: toon(C.woodDark),
10
120
  };
11
121
  }
@@ -1,57 +1,72 @@
1
- import { BoxGeometry, BufferAttribute, Group, Mesh, MeshStandardMaterial } from "three";
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // `palette` is the six roles the render layer shares: the loading screen's two sky bands, the
5
+ // distance the horizon fades into, the two colours a walkable surface is made of, and one
6
+ // saturated `accent` that marks everything the player can touch. Rename a role and every user of
7
+ // it moves with it, which is the point — there is no second copy of "the green" anywhere.
8
+ //
9
+ // `C` is this game's own colour table for the procedural models below it. A fox with a jacket, a
10
+ // gold coin and a red mushroom cap needs more than six colours and pretending otherwise buys
11
+ // nothing: these are named per part, so swapping one creature's fur never touches a rock.
2
12
 
3
13
  export const palette = {
4
- skyHigh: 0x1458bd,
5
- skyLow: 0x83d8f2,
6
- ground: 0x55b935,
7
- character: 0xf29a38,
8
- accent: 0xffc83d,
9
- // Stone and crates. At 0x241d1a these read as black holes in the frame — the key comes from
10
- // behind and above, so every face the camera can see is the unlit one, and the ambient alone
11
- // has to carry them.
12
- shadow: 0x6b5744,
14
+ grass: 0x5cbb37,
15
+ /** Distance fades into this; also the loading screen's background. */
16
+ horizon: 0xa8d6f5,
17
+ rock: 0xa8927a,
18
+ /** The loading screen's progress track. */
19
+ skyHigh: 0x2e88e0,
20
+ skyLow: 0xbfe4fb,
21
+ /** The one saturated role: coins, gems, stars, the goal. */
22
+ accent: 0xffd23f,
13
23
  } as const;
14
24
 
15
- const materialCache = new Map<number, MeshStandardMaterial>();
16
-
17
- export function toon(color: number): MeshStandardMaterial {
18
- const cached = materialCache.get(color);
19
- if (cached !== undefined) return cached;
20
- const material = new MeshStandardMaterial({ color, roughness: 0.78, metalness: 0 });
21
- materialCache.set(color, material);
22
- return material;
23
- }
24
-
25
- function mottle(mesh: Mesh, seed = 1): void {
26
- const position = mesh.geometry.getAttribute("position");
27
- if (position === undefined) return;
28
- const colors = new Float32Array(position.count * 3);
29
- for (let index = 0; index < position.count; index += 1) {
30
- const value = 0.88 + ((index * 17 + seed * 13) % 7) * 0.02;
31
- colors[index * 3] = value;
32
- colors[index * 3 + 1] = value;
33
- colors[index * 3 + 2] = value;
34
- }
35
- mesh.geometry.setAttribute("color", new BufferAttribute(colors, 3));
36
- const material = (mesh.material as MeshStandardMaterial).clone();
37
- material.vertexColors = true;
38
- mesh.material = material;
39
- }
40
-
41
- export function rockBox(width: number, height: number, depth: number, seed = 1): Group {
42
- const group = new Group();
43
- const top = new Mesh(new BoxGeometry(width, 0.28, depth), toon(palette.ground));
44
- top.position.y = height / 2 - 0.14;
45
- top.castShadow = true;
46
- top.receiveShadow = true;
47
- mottle(top, seed);
48
- const stone = new Mesh(
49
- new BoxGeometry(width * 0.84, height - 0.28, depth * 0.82),
50
- toon(palette.shadow),
51
- );
52
- stone.position.y = -0.14;
53
- stone.castShadow = true;
54
- stone.receiveShadow = true;
55
- group.add(top, stone);
56
- return group;
57
- }
25
+ /** Colours sampled from the reference frame, by part. */
26
+ export const C = {
27
+ skyTop: 0x2e88e0,
28
+ skyBottom: 0xbfe4fb,
29
+ fog: 0xa8d6f5,
30
+ sun: 0xfff4d6,
31
+
32
+ grass: 0x5cbb37,
33
+ grassDark: 0x3f8f28,
34
+ grassLight: 0x8ede4f,
35
+ dirt: 0x8a6a45,
36
+
37
+ rock: 0xa8927a,
38
+ rockDark: 0x776352,
39
+ rockLight: 0xc6b294,
40
+ moss: 0x6a9b3f,
41
+
42
+ wood: 0xd0904c,
43
+ woodDark: 0x9c6330,
44
+ woodPost: 0xb87a3c,
45
+ rope: 0xdcc08a,
46
+
47
+ fur: 0xf2952f,
48
+ furDark: 0xd4761b,
49
+ cream: 0xfbe7c9,
50
+ jacket: 0x2f7fd6,
51
+ jacketDark: 0x2263ab,
52
+ pack: 0x5c7ea3,
53
+ ink: 0x2b1a10,
54
+
55
+ gold: 0xffd23f,
56
+ goldDark: 0xd79a17,
57
+ gem: 0x3fa9f5,
58
+ gemLight: 0x9fe0ff,
59
+
60
+ capRed: 0xdf4a3d,
61
+ capDark: 0xa82f26,
62
+ shellRed: 0x9e3527,
63
+ snailBody: 0xa8c47a,
64
+ spot: 0xfff3e2,
65
+
66
+ water: 0x9fe3fb,
67
+ cloud: 0xffffff,
68
+ brick: 0xb08d72,
69
+ brickDark: 0x8a6c55,
70
+ roof: 0x3f7fbf,
71
+ metal: 0x9aa7b4,
72
+ } as const;
@@ -0,0 +1,142 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // What the fox collects: a spinning coin, a faceted gem, and the big gold star that ends the run.
4
+ // Each is a `Group` whose local origin is its own centre, so a pickup's world position is its
5
+ // rotation as well as its bob — and `coinArc` is how a line of coins becomes a jump arc.
6
+ import {
7
+ CylinderGeometry,
8
+ ExtrudeGeometry,
9
+ Group,
10
+ Mesh,
11
+ type Object3D,
12
+ OctahedronGeometry,
13
+ PointLight,
14
+ Shape,
15
+ SphereGeometry,
16
+ TorusGeometry,
17
+ Vector3,
18
+ } from "three";
19
+ import { flat, toon } from "./materials.js";
20
+ import { C } from "./palette.js";
21
+
22
+ const TAU = Math.PI * 2;
23
+
24
+ /** Spinning coin with an embossed star on both faces. */
25
+ export function coin(): Group {
26
+ const group = new Group();
27
+ const disc = new Mesh(new CylinderGeometry(0.42, 0.42, 0.1, 14), toon(C.gold));
28
+ disc.rotation.x = Math.PI / 2;
29
+ disc.castShadow = true;
30
+ group.add(disc);
31
+ group.add(new Mesh(new TorusGeometry(0.42, 0.07, 6, 16), toon(C.goldDark)));
32
+ // One emboss, not two: the rim already reads as a coin from the side, and the sixty coins on
33
+ // this route are the single biggest draw count in the game.
34
+ const star = new Mesh(new CylinderGeometry(0.2, 0.2, 0.02, 5), toon(C.goldDark));
35
+ star.rotation.x = Math.PI / 2;
36
+ star.position.z = 0.07;
37
+ group.add(star);
38
+ return group;
39
+ }
40
+
41
+ /** Blue octahedral gem. */
42
+ export function gem(): Group {
43
+ const group = new Group();
44
+ const body = new Mesh(new OctahedronGeometry(0.45), toon(C.gem));
45
+ body.castShadow = true;
46
+ group.add(body);
47
+ const shine = new Mesh(new OctahedronGeometry(0.46), flat(C.gemLight, { opacity: 0.45 }));
48
+ shine.scale.set(0.5, 1, 0.5);
49
+ group.add(shine);
50
+ return group;
51
+ }
52
+
53
+ /** The big collectible star, with the light that makes it read as the goal from a distance. */
54
+ export function star(): Group {
55
+ const group = new Group();
56
+ const shape = new Shape();
57
+ for (let i = 0; i < 10; i += 1) {
58
+ const r = i % 2 === 0 ? 0.62 : 0.27;
59
+ const a = (i / 10) * TAU + Math.PI / 2;
60
+ const x = Math.cos(a) * r;
61
+ const y = Math.sin(a) * r;
62
+ if (i === 0) shape.moveTo(x, y);
63
+ else shape.lineTo(x, y);
64
+ }
65
+ shape.closePath();
66
+ const geometry = new ExtrudeGeometry(shape, {
67
+ bevelEnabled: true,
68
+ bevelSegments: 1,
69
+ bevelSize: 0.07,
70
+ bevelThickness: 0.07,
71
+ depth: 0.18,
72
+ });
73
+ geometry.center();
74
+ const body = new Mesh(geometry, toon(C.gold));
75
+ body.castShadow = true;
76
+ group.add(body);
77
+ group.add(new PointLight(0xffe27a, 8, 6));
78
+ return group;
79
+ }
80
+
81
+ /**
82
+ * A short burst of unlit spheres for a pickup or a stomp.
83
+ *
84
+ * Returns the per-frame step and `true` once it is finished, so the scene owns one list of live
85
+ * effects instead of a timer per particle. The geometry is disposed on the way out: a route with
86
+ * two hundred pickups in it would otherwise hold two hundred dead geometries alive.
87
+ */
88
+ export function burst(
89
+ scene: Object3D,
90
+ position: Vector3,
91
+ color: number,
92
+ count = 12,
93
+ ): (dt: number) => boolean {
94
+ const group = new Group();
95
+ group.position.copy(position);
96
+ const material = flat(color);
97
+ const bits: Mesh[] = [];
98
+ for (let i = 0; i < count; i += 1) {
99
+ const bit = new Mesh(new SphereGeometry(0.09 + Math.random() * 0.07, 5, 4), material);
100
+ const a = Math.random() * TAU;
101
+ bit.userData.v = new Vector3(Math.cos(a) * 3.2, (0.4 + Math.random()) * 4.5, Math.sin(a) * 3.2);
102
+ group.add(bit);
103
+ bits.push(bit);
104
+ }
105
+ scene.add(group);
106
+ let life = 0;
107
+ return (dt: number): boolean => {
108
+ life += dt;
109
+ for (const bit of bits) {
110
+ const v = bit.userData.v as Vector3;
111
+ v.y -= 18 * dt;
112
+ bit.position.addScaledVector(v, dt);
113
+ }
114
+ material.opacity = Math.max(0, 1 - life / 0.7);
115
+ if (life <= 0.7) return false;
116
+ scene.remove(group);
117
+ for (const bit of bits) bit.geometry.dispose();
118
+ material.dispose();
119
+ return true;
120
+ };
121
+ }
122
+
123
+ /** An arc of coin positions between two points, for a jump that needs a reward at its top. */
124
+ export function coinArc(
125
+ from: readonly [number, number, number],
126
+ to: readonly [number, number, number],
127
+ count: number,
128
+ height = 2.2,
129
+ ): Vector3[] {
130
+ const out: Vector3[] = [];
131
+ for (let i = 0; i < count; i += 1) {
132
+ const t = count === 1 ? 0.5 : i / (count - 1);
133
+ out.push(
134
+ new Vector3(
135
+ from[0] + (to[0] - from[0]) * t,
136
+ from[1] + (to[1] - from[1]) * t + Math.sin(t * Math.PI) * height,
137
+ from[2] + (to[2] - from[2]) * t,
138
+ ),
139
+ );
140
+ }
141
+ return out;
142
+ }