create-threenative 0.2.10 → 0.2.13

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 (737) hide show
  1. package/agent-docs/references/assertion-reference.md +109 -3
  2. package/agent-docs/references/auto-exposure.md +28 -45
  3. package/agent-docs/references/build-profiles.md +1 -1
  4. package/agent-docs/references/capability-reference.md +527 -44
  5. package/agent-docs/references/debug-surface.md +64 -0
  6. package/agent-docs/references/finding-assets.md +11 -12
  7. package/agent-docs/references/performance-basics.md +19 -0
  8. package/agent-docs/references/trace-a-slow-frame.md +21 -0
  9. package/agent-docs/references/visual-baseline.md +23 -4
  10. package/agent-files/.agents/skills/ponytail/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/prd-creator/SKILL.md +17 -6
  12. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +87 -23
  13. package/agent-files/.agents/skills/threenative-performance/SKILL.md +12 -11
  14. package/agent-files/.claude/hooks/ponytail-context.mjs +1 -1
  15. package/agent-files/scripts/reference.mjs +9 -4
  16. package/capabilities.json +739 -50
  17. package/dist/index.d.ts +40 -6
  18. package/dist/index.js +227 -34
  19. package/dist/quality.d.ts +12 -0
  20. package/dist/quality.js +166747 -0
  21. package/dist/threenative.js +60 -44
  22. package/dist/web-engine-gltf-loader.js +2 -0
  23. package/dist/web-engine-mesh-bvh-webgpu.js +1 -1
  24. package/dist/web-engine-mesh-bvh.js +7 -0
  25. package/dist/web-engine-post-effects.js +645 -19
  26. package/dist/web-engine-runtime.js +3528 -343
  27. package/package.json +19 -9
  28. package/template-assets/assets/bay-PROVENANCE.md +21 -0
  29. package/template-assets/assets/bay-ground.webp +0 -0
  30. package/template-assets/assets/bay-metal.webp +0 -0
  31. package/template-assets/assets/bay-pavement-normal.webp +0 -0
  32. package/template-assets/assets/bay-pavement.webp +0 -0
  33. package/template-assets/assets/bay-plaster-normal.webp +0 -0
  34. package/template-assets/assets/bay-plaster.webp +0 -0
  35. package/template-assets/assets/bay-wood-normal.webp +0 -0
  36. package/template-assets/assets/bay-wood.webp +0 -0
  37. package/template-assets/assets/tex-PROVENANCE.md +25 -0
  38. package/template-assets/assets/tex-bark-normal.webp +0 -0
  39. package/template-assets/assets/tex-bark.webp +0 -0
  40. package/template-assets/assets/tex-birch-bark.webp +0 -0
  41. package/template-assets/assets/tex-grass.webp +0 -0
  42. package/template-assets/assets/tex-planks-normal.webp +0 -0
  43. package/template-assets/assets/tex-planks.webp +0 -0
  44. package/template-assets/assets/tex-rock-normal.webp +0 -0
  45. package/template-assets/assets/tex-rock.webp +0 -0
  46. package/template-assets/assets/tex-roof-tiles-normal.webp +0 -0
  47. package/template-assets/assets/tex-roof-tiles.webp +0 -0
  48. package/template-assets/assets/tex-sand-normal.webp +0 -0
  49. package/template-assets/assets/tex-sand.webp +0 -0
  50. package/template-assets/assets/tex-stone-wall-normal.webp +0 -0
  51. package/template-assets/assets/tex-stone-wall.webp +0 -0
  52. package/template-assets/kitExposure.ts +20 -0
  53. package/template-assets/patches/three@0.185.1.patch +481 -272
  54. package/template-assets/quality/biome.json +7 -0
  55. package/template-assets/quality/eslint.config.js +3 -0
  56. package/template-assets/realistic-ocean/README.md +113 -0
  57. package/template-assets/realistic-ocean/install.mjs +56 -0
  58. package/template-assets/realistic-ocean/src/realisticOcean.ts +151 -0
  59. package/template-assets/realistic-ocean/src/realisticOceanLifetime.ts +29 -0
  60. package/template-assets/realistic-ocean/src/render/REALISTIC-OCEAN-LICENSE.txt +25 -0
  61. package/template-assets/realistic-ocean/src/render/realisticSea.ts +642 -0
  62. package/template-assets/realistic-ocean/src/render/realisticSeaMaps.ts +311 -0
  63. package/template-assets/realistic-ocean/src/render/realisticSpectrum.ts +289 -0
  64. package/templates/AGENTS.md +21 -0
  65. package/templates/CLAUDE.md +23 -0
  66. package/templates/action-rpg/.codex/config.toml +6 -2
  67. package/templates/action-rpg/.cursor/mcp.json +8 -2
  68. package/templates/action-rpg/.gemini/settings.json +8 -2
  69. package/templates/action-rpg/.mcp.json +8 -2
  70. package/templates/action-rpg/.vscode/mcp.json +9 -2
  71. package/templates/action-rpg/.zed/settings.json +9 -2
  72. package/templates/action-rpg/AGENTS.md +11 -11
  73. package/templates/action-rpg/CLAUDE.md +11 -11
  74. package/templates/action-rpg/opencode.json +10 -2
  75. package/templates/action-rpg/package.json +15 -10
  76. package/templates/action-rpg/playtests/combat.playtest.json +6 -0
  77. package/templates/action-rpg/playtests/inventory.playtest.json +22 -0
  78. package/templates/action-rpg/playtests/performance.playtest.json +1 -1
  79. package/templates/action-rpg/playtests/roll.playtest.json +112 -0
  80. package/templates/action-rpg/playtests/swing.playtest.json +55 -0
  81. package/templates/action-rpg/playtests/win.playtest.json +4 -4
  82. package/templates/action-rpg/src/entities/Fighter.ts +44 -4
  83. package/templates/action-rpg/src/entities/Player.ts +64 -12
  84. package/templates/action-rpg/src/render/atmosphere.ts +444 -0
  85. package/templates/action-rpg/src/render/backlightMaterial.ts +49 -18
  86. package/templates/action-rpg/src/render/clouds.ts +605 -0
  87. package/templates/action-rpg/src/render/dungeon.ts +8 -6
  88. package/templates/action-rpg/src/render/exposure.ts +11 -109
  89. package/templates/action-rpg/src/render/gpuSky.ts +752 -0
  90. package/templates/action-rpg/src/render/lighting.ts +27 -4
  91. package/templates/action-rpg/src/render/materialLighting.ts +2 -11
  92. package/templates/action-rpg/src/render/palette.ts +1 -0
  93. package/templates/action-rpg/src/render/postprocessing.ts +4 -4
  94. package/templates/action-rpg/src/render/props.ts +10 -8
  95. package/templates/action-rpg/src/render/quality.ts +56 -108
  96. package/templates/action-rpg/src/render/sky.ts +74 -1
  97. package/templates/action-rpg/src/scenes/Play.ts +16 -12
  98. package/templates/action-rpg/src/ui/CharacterPanel.tsx +7 -2
  99. package/templates/action-rpg/src/ui/Hud.tsx +5 -7
  100. package/templates/action-rpg/src/ui/InventoryPanel.tsx +14 -14
  101. package/templates/action-rpg/threenative.config.ts +3 -0
  102. package/templates/adventure/.codex/config.toml +23 -0
  103. package/templates/adventure/.cursor/mcp.json +38 -0
  104. package/templates/adventure/.gemini/settings.json +38 -0
  105. package/templates/adventure/.mcp.json +38 -0
  106. package/templates/adventure/.vscode/mcp.json +43 -0
  107. package/templates/adventure/.zed/settings.json +43 -0
  108. package/templates/adventure/AGENTS.md +60 -0
  109. package/templates/adventure/CLAUDE.md +62 -0
  110. package/templates/adventure/index.html +14 -0
  111. package/templates/adventure/kit.json +8 -0
  112. package/templates/adventure/native-playtests/survives.playtest.json +52 -0
  113. package/templates/adventure/opencode.json +49 -0
  114. package/templates/adventure/package.json +65 -0
  115. package/templates/adventure/playtests/boss.playtest.json +406 -0
  116. package/templates/adventure/playtests/combat.playtest.json +342 -0
  117. package/templates/adventure/playtests/controls.playtest.json +142 -0
  118. package/templates/adventure/playtests/explore.playtest.json +45 -0
  119. package/templates/adventure/playtests/flicker.playtest.json +206 -0
  120. package/templates/adventure/playtests/hearts.playtest.json +171 -0
  121. package/templates/adventure/playtests/lockon.playtest.json +256 -0
  122. package/templates/adventure/playtests/look.playtest.json +72 -0
  123. package/templates/adventure/playtests/move-hollow.playtest.json +106 -0
  124. package/templates/adventure/playtests/move.playtest.json +84 -0
  125. package/templates/adventure/playtests/performance.playtest.json +55 -0
  126. package/templates/adventure/playtests/puzzle.playtest.json +250 -0
  127. package/templates/adventure/playtests/stride.playtest.json +67 -0
  128. package/templates/adventure/playtests/survives.playtest.json +171 -0
  129. package/templates/adventure/playtests/thornback.playtest.json +267 -0
  130. package/templates/adventure/public/favicon.svg +4 -0
  131. package/templates/adventure/src/entities/Block.ts +114 -0
  132. package/templates/adventure/src/entities/Chest.ts +69 -0
  133. package/templates/adventure/src/entities/Door.ts +81 -0
  134. package/templates/adventure/src/entities/Dummy.ts +69 -0
  135. package/templates/adventure/src/entities/Flicker.ts +239 -0
  136. package/templates/adventure/src/entities/Hero.ts +561 -0
  137. package/templates/adventure/src/entities/LockOn.ts +180 -0
  138. package/templates/adventure/src/entities/Mossling.ts +249 -0
  139. package/templates/adventure/src/entities/Switch.ts +49 -0
  140. package/templates/adventure/src/entities/Thornback.ts +238 -0
  141. package/templates/adventure/src/entities/Warden.ts +196 -0
  142. package/templates/adventure/src/game.ts +65 -0
  143. package/templates/adventure/src/interact.ts +63 -0
  144. package/templates/adventure/src/level/Hollow.ts +240 -0
  145. package/templates/adventure/src/level/Vale.ts +383 -0
  146. package/templates/adventure/src/main.ts +18 -0
  147. package/templates/adventure/src/render/camera.ts +416 -0
  148. package/templates/adventure/src/render/creatures.ts +405 -0
  149. package/templates/adventure/src/render/effects.ts +333 -0
  150. package/templates/adventure/src/render/foliage.ts +1072 -0
  151. package/templates/adventure/src/render/hero.ts +1447 -0
  152. package/templates/adventure/src/render/kitExposure.ts +20 -0
  153. package/templates/adventure/src/render/lighting.ts +74 -0
  154. package/templates/adventure/src/render/loading.ts +332 -0
  155. package/templates/adventure/src/render/materials.ts +179 -0
  156. package/templates/adventure/src/render/palette.ts +137 -0
  157. package/templates/adventure/src/render/postprocessing.ts +70 -0
  158. package/templates/adventure/src/render/props.ts +383 -0
  159. package/templates/adventure/src/render/quality.ts +46 -0
  160. package/templates/adventure/src/render/sky.ts +271 -0
  161. package/templates/adventure/src/render/surface.ts +259 -0
  162. package/templates/adventure/src/render/touch-controls.ts +137 -0
  163. package/templates/adventure/src/scenes/Play.ts +959 -0
  164. package/templates/adventure/src/state.ts +113 -0
  165. package/templates/adventure/src/style.css +98 -0
  166. package/templates/adventure/src/ui/App.tsx +22 -0
  167. package/templates/adventure/src/ui/GameUi.tsx +20 -0
  168. package/templates/adventure/src/ui/Hud.tsx +70 -0
  169. package/templates/adventure/src/ui/Menu.tsx +15 -0
  170. package/templates/adventure/src/ui/main.tsx +14 -0
  171. package/templates/adventure/tailwind.config.ts +2 -0
  172. package/templates/adventure/threenative.config.ts +62 -0
  173. package/templates/adventure/tsconfig.json +17 -0
  174. package/templates/adventure/vite.config.ts +49 -0
  175. package/templates/collectathon/.codex/config.toml +23 -0
  176. package/templates/collectathon/.cursor/mcp.json +38 -0
  177. package/templates/collectathon/.gemini/settings.json +38 -0
  178. package/templates/collectathon/.mcp.json +38 -0
  179. package/templates/collectathon/.vscode/mcp.json +43 -0
  180. package/templates/collectathon/.zed/settings.json +43 -0
  181. package/templates/collectathon/AGENTS.md +58 -0
  182. package/templates/collectathon/CLAUDE.md +60 -0
  183. package/templates/collectathon/index.html +14 -0
  184. package/templates/collectathon/kit.json +8 -0
  185. package/templates/collectathon/native-playtests/survives.playtest.json +52 -0
  186. package/templates/collectathon/opencode.json +49 -0
  187. package/templates/collectathon/package.json +65 -0
  188. package/templates/collectathon/playtests/acrobatics.playtest.json +238 -0
  189. package/templates/collectathon/playtests/camera.playtest.json +80 -0
  190. package/templates/collectathon/playtests/clipped-probe.playtest.json +101 -0
  191. package/templates/collectathon/playtests/collect.playtest.json +196 -0
  192. package/templates/collectathon/playtests/combat.playtest.json +246 -0
  193. package/templates/collectathon/playtests/double-tap-air.playtest.json +198 -0
  194. package/templates/collectathon/playtests/double-tap.playtest.json +136 -0
  195. package/templates/collectathon/playtests/effects.playtest.json +124 -0
  196. package/templates/collectathon/playtests/enemies.playtest.json +295 -0
  197. package/templates/collectathon/playtests/explore.playtest.json +45 -0
  198. package/templates/collectathon/playtests/hop-reach.playtest.json +117 -0
  199. package/templates/collectathon/playtests/jump-chain.playtest.json +274 -0
  200. package/templates/collectathon/playtests/ledge-angle.playtest.json +107 -0
  201. package/templates/collectathon/playtests/ledge-too-high.playtest.json +115 -0
  202. package/templates/collectathon/playtests/ledge.playtest.json +100 -0
  203. package/templates/collectathon/playtests/look.playtest.json +64 -0
  204. package/templates/collectathon/playtests/performance.playtest.json +55 -0
  205. package/templates/collectathon/playtests/stride.playtest.json +111 -0
  206. package/templates/collectathon/playtests/survives.playtest.json +123 -0
  207. package/templates/collectathon/playtests/telegraphs.playtest.json +132 -0
  208. package/templates/collectathon/playtests/thornback.playtest.json +157 -0
  209. package/templates/collectathon/playtests/wall-kick.playtest.json +206 -0
  210. package/templates/collectathon/playtests/win.playtest.json +166 -0
  211. package/templates/collectathon/public/favicon.svg +4 -0
  212. package/templates/collectathon/src/entities/Hero.ts +915 -0
  213. package/templates/collectathon/src/entities/Pickup.ts +63 -0
  214. package/templates/collectathon/src/entities/Walker.ts +248 -0
  215. package/templates/collectathon/src/game.ts +51 -0
  216. package/templates/collectathon/src/level/Course.ts +590 -0
  217. package/templates/collectathon/src/level/terrain.ts +144 -0
  218. package/templates/collectathon/src/main.ts +14 -0
  219. package/templates/collectathon/src/playtest-events.ts +15 -0
  220. package/templates/collectathon/src/render/camera.ts +163 -0
  221. package/templates/collectathon/src/render/castle.ts +408 -0
  222. package/templates/collectathon/src/render/effects.ts +284 -0
  223. package/templates/collectathon/src/render/foliage.ts +744 -0
  224. package/templates/collectathon/src/render/ground.ts +139 -0
  225. package/templates/collectathon/src/render/hero.ts +452 -0
  226. package/templates/collectathon/src/render/kitExposure.ts +20 -0
  227. package/templates/collectathon/src/render/lighting.ts +65 -0
  228. package/templates/collectathon/src/render/loading.ts +332 -0
  229. package/templates/collectathon/src/render/materials.ts +196 -0
  230. package/templates/collectathon/src/render/palette.ts +82 -0
  231. package/templates/collectathon/src/render/postprocessing.ts +79 -0
  232. package/templates/collectathon/src/render/props.ts +218 -0
  233. package/templates/collectathon/src/render/quality.ts +54 -0
  234. package/templates/collectathon/src/render/sky.ts +262 -0
  235. package/templates/collectathon/src/render/surface.ts +269 -0
  236. package/templates/collectathon/src/render/touch-controls.ts +179 -0
  237. package/templates/collectathon/src/render/touch-layout.ts +48 -0
  238. package/templates/collectathon/src/render/water.ts +191 -0
  239. package/templates/collectathon/src/scenes/Play.ts +481 -0
  240. package/templates/collectathon/src/state.ts +38 -0
  241. package/templates/collectathon/src/style.css +106 -0
  242. package/templates/collectathon/src/ui/App.tsx +22 -0
  243. package/templates/collectathon/src/ui/GameUi.tsx +20 -0
  244. package/templates/collectathon/src/ui/Hud.tsx +77 -0
  245. package/templates/collectathon/src/ui/Menu.tsx +13 -0
  246. package/templates/collectathon/src/ui/main.tsx +14 -0
  247. package/templates/collectathon/tailwind.config.ts +2 -0
  248. package/templates/collectathon/threenative.config.ts +62 -0
  249. package/templates/collectathon/tsconfig.json +17 -0
  250. package/templates/collectathon/vite.config.ts +49 -0
  251. package/templates/kart/.codex/config.toml +23 -0
  252. package/templates/kart/.cursor/mcp.json +38 -0
  253. package/templates/kart/.gemini/settings.json +38 -0
  254. package/templates/kart/.mcp.json +38 -0
  255. package/templates/kart/.vscode/mcp.json +43 -0
  256. package/templates/kart/.zed/settings.json +43 -0
  257. package/templates/kart/AGENTS.md +58 -0
  258. package/templates/kart/CLAUDE.md +60 -0
  259. package/templates/kart/index.html +14 -0
  260. package/templates/kart/kit.json +8 -0
  261. package/templates/kart/native-playtests/survives.playtest.json +65 -0
  262. package/templates/kart/opencode.json +49 -0
  263. package/templates/kart/package.json +64 -0
  264. package/templates/kart/playtests/drift.playtest.json +226 -0
  265. package/templates/kart/playtests/explore.playtest.json +45 -0
  266. package/templates/kart/playtests/hit-stays-above-road.playtest.json +92 -0
  267. package/templates/kart/playtests/item-key.playtest.json +108 -0
  268. package/templates/kart/playtests/items.playtest.json +143 -0
  269. package/templates/kart/playtests/lap-times.playtest.json +138 -0
  270. package/templates/kart/playtests/laps.playtest.json +149 -0
  271. package/templates/kart/playtests/performance.playtest.json +57 -0
  272. package/templates/kart/playtests/race.playtest.json +294 -0
  273. package/templates/kart/playtests/restart.playtest.json +87 -0
  274. package/templates/kart/playtests/rocket-start.playtest.json +56 -0
  275. package/templates/kart/playtests/smooth-drive.playtest.json +101 -0
  276. package/templates/kart/playtests/surfaces.playtest.json +113 -0
  277. package/templates/kart/playtests/survives.playtest.json +116 -0
  278. package/templates/kart/playtests/wall.playtest.json +118 -0
  279. package/templates/kart/public/favicon.svg +4 -0
  280. package/templates/kart/src/entities/Driver.ts +123 -0
  281. package/templates/kart/src/entities/Items.ts +194 -0
  282. package/templates/kart/src/entities/Kart.ts +517 -0
  283. package/templates/kart/src/game.ts +45 -0
  284. package/templates/kart/src/main.ts +14 -0
  285. package/templates/kart/src/playtest-events.ts +15 -0
  286. package/templates/kart/src/render/camera.ts +83 -0
  287. package/templates/kart/src/render/course.ts +579 -0
  288. package/templates/kart/src/render/effects.ts +266 -0
  289. package/templates/kart/src/render/items.ts +163 -0
  290. package/templates/kart/src/render/kart.ts +256 -0
  291. package/templates/kart/src/render/kitExposure.ts +20 -0
  292. package/templates/kart/src/render/lighting.ts +58 -0
  293. package/templates/kart/src/render/loading.ts +332 -0
  294. package/templates/kart/src/render/materials.ts +119 -0
  295. package/templates/kart/src/render/palette.ts +74 -0
  296. package/templates/kart/src/render/postprocessing.ts +79 -0
  297. package/templates/kart/src/render/quality.ts +54 -0
  298. package/templates/kart/src/render/skids.ts +86 -0
  299. package/templates/kart/src/render/sky.ts +105 -0
  300. package/templates/kart/src/render/touch-controls.ts +168 -0
  301. package/templates/kart/src/render/touch-layout.ts +48 -0
  302. package/templates/kart/src/scenes/Race.ts +850 -0
  303. package/templates/kart/src/state.ts +53 -0
  304. package/templates/kart/src/style.css +106 -0
  305. package/templates/kart/src/track/Course.ts +276 -0
  306. package/templates/kart/src/track/Race.ts +133 -0
  307. package/templates/kart/src/ui/App.tsx +21 -0
  308. package/templates/kart/src/ui/GameUi.tsx +20 -0
  309. package/templates/kart/src/ui/Hud.tsx +172 -0
  310. package/templates/kart/src/ui/Menu.tsx +13 -0
  311. package/templates/kart/src/ui/main.tsx +14 -0
  312. package/templates/kart/tailwind.config.ts +2 -0
  313. package/templates/kart/threenative.config.ts +62 -0
  314. package/templates/kart/tsconfig.json +17 -0
  315. package/templates/kart/vite.config.ts +49 -0
  316. package/templates/minimal/.codex/config.toml +6 -2
  317. package/templates/minimal/.cursor/mcp.json +8 -2
  318. package/templates/minimal/.gemini/settings.json +8 -2
  319. package/templates/minimal/.mcp.json +8 -2
  320. package/templates/minimal/.vscode/mcp.json +9 -2
  321. package/templates/minimal/.zed/settings.json +9 -2
  322. package/templates/minimal/AGENTS.md +11 -13
  323. package/templates/minimal/CLAUDE.md +11 -13
  324. package/templates/minimal/opencode.json +10 -2
  325. package/templates/minimal/package.json +14 -9
  326. package/templates/minimal/playtests/camera-wall.playtest.json +36 -0
  327. package/templates/minimal/playtests/jump.playtest.json +45 -0
  328. package/templates/minimal/playtests/play.playtest.json +1 -1
  329. package/templates/minimal/src/game.ts +2 -0
  330. package/templates/minimal/src/render/atmosphere.ts +444 -0
  331. package/templates/minimal/src/render/backlightMaterial.ts +49 -18
  332. package/templates/minimal/src/render/camera.ts +35 -4
  333. package/templates/minimal/src/render/clouds.ts +605 -0
  334. package/templates/minimal/src/render/exposure.ts +7 -111
  335. package/templates/minimal/src/render/gpuSky.ts +752 -0
  336. package/templates/minimal/src/render/lighting.ts +26 -4
  337. package/templates/minimal/src/render/materialLighting.ts +2 -10
  338. package/templates/minimal/src/render/postprocessing.ts +4 -4
  339. package/templates/minimal/src/render/quality.ts +10 -116
  340. package/templates/minimal/src/render/sky.ts +73 -1
  341. package/templates/minimal/src/scenes/Play.ts +18 -7
  342. package/templates/platformer/.codex/config.toml +6 -2
  343. package/templates/platformer/.cursor/mcp.json +8 -2
  344. package/templates/platformer/.gemini/settings.json +8 -2
  345. package/templates/platformer/.mcp.json +8 -2
  346. package/templates/platformer/.vscode/mcp.json +9 -2
  347. package/templates/platformer/.zed/settings.json +9 -2
  348. package/templates/platformer/AGENTS.md +13 -9
  349. package/templates/platformer/CLAUDE.md +13 -9
  350. package/templates/platformer/opencode.json +10 -2
  351. package/templates/platformer/package.json +15 -10
  352. package/templates/platformer/playtests/dash-jump.playtest.json +34 -0
  353. package/templates/platformer/playtests/finish.playtest.json +58 -0
  354. package/templates/platformer/playtests/idle.playtest.json +44 -0
  355. package/templates/platformer/playtests/performance.playtest.json +1 -1
  356. package/templates/platformer/src/entities/Fox.ts +19 -6
  357. package/templates/platformer/src/game.ts +1 -0
  358. package/templates/platformer/src/level/Stage.ts +4 -1
  359. package/templates/platformer/src/render/backlightMaterial.ts +49 -18
  360. package/templates/platformer/src/render/camera.ts +30 -1
  361. package/templates/platformer/src/render/exposure.ts +6 -111
  362. package/templates/platformer/src/render/fox.ts +5 -2
  363. package/templates/platformer/src/render/kitExposure.ts +20 -0
  364. package/templates/platformer/src/render/materialLighting.ts +2 -11
  365. package/templates/platformer/src/render/postprocessing.ts +4 -4
  366. package/templates/platformer/src/render/props.ts +1 -2
  367. package/templates/platformer/src/render/quality.ts +10 -118
  368. package/templates/platformer/src/scenes/Play.ts +31 -15
  369. package/templates/platformer/src/ui/Menu.tsx +1 -1
  370. package/templates/puzzle/.codex/config.toml +6 -2
  371. package/templates/puzzle/.cursor/mcp.json +8 -2
  372. package/templates/puzzle/.gemini/settings.json +8 -2
  373. package/templates/puzzle/.mcp.json +8 -2
  374. package/templates/puzzle/.vscode/mcp.json +9 -2
  375. package/templates/puzzle/.zed/settings.json +9 -2
  376. package/templates/puzzle/AGENTS.md +14 -17
  377. package/templates/puzzle/CLAUDE.md +14 -17
  378. package/templates/puzzle/opencode.json +10 -2
  379. package/templates/puzzle/package.json +15 -10
  380. package/templates/puzzle/playtests/performance.playtest.json +1 -1
  381. package/templates/puzzle/playtests/replay-keeps-progress.playtest.json +78 -0
  382. package/templates/puzzle/src/render/backlightMaterial.ts +49 -18
  383. package/templates/puzzle/src/render/exposure.ts +11 -109
  384. package/templates/puzzle/src/render/lighting.ts +3 -3
  385. package/templates/puzzle/src/render/materialLighting.ts +2 -11
  386. package/templates/puzzle/src/render/palette.ts +1 -1
  387. package/templates/puzzle/src/render/postprocessing.ts +4 -4
  388. package/templates/puzzle/src/render/quality.ts +44 -153
  389. package/templates/puzzle/src/render/vault.ts +18 -6
  390. package/templates/puzzle/src/scenes/Play.ts +6 -1
  391. package/templates/puzzle/src/ui/Hud.tsx +8 -43
  392. package/templates/racing/.codex/config.toml +6 -2
  393. package/templates/racing/.cursor/mcp.json +8 -2
  394. package/templates/racing/.gemini/settings.json +8 -2
  395. package/templates/racing/.mcp.json +8 -2
  396. package/templates/racing/.vscode/mcp.json +9 -2
  397. package/templates/racing/.zed/settings.json +9 -2
  398. package/templates/racing/AGENTS.md +10 -12
  399. package/templates/racing/CLAUDE.md +10 -12
  400. package/templates/racing/opencode.json +10 -2
  401. package/templates/racing/package.json +15 -10
  402. package/templates/racing/playtests/brake.playtest.json +54 -0
  403. package/templates/racing/playtests/outcome.playtest.json +19 -0
  404. package/templates/racing/playtests/performance.playtest.json +1 -1
  405. package/templates/racing/playtests/stopped-car-is-not-rescued.playtest.json +59 -0
  406. package/templates/racing/src/entities/RacingCar.ts +12 -3
  407. package/templates/racing/src/entities/Rival.ts +11 -2
  408. package/templates/racing/src/render/atmosphere.ts +444 -0
  409. package/templates/racing/src/render/backlightMaterial.ts +49 -18
  410. package/templates/racing/src/render/clouds.ts +605 -0
  411. package/templates/racing/src/render/exposure.ts +6 -111
  412. package/templates/racing/src/render/gpuSky.ts +752 -0
  413. package/templates/racing/src/render/kitExposure.ts +20 -0
  414. package/templates/racing/src/render/lighting.ts +26 -4
  415. package/templates/racing/src/render/materialLighting.ts +2 -11
  416. package/templates/racing/src/render/materials.ts +2 -1
  417. package/templates/racing/src/render/postprocessing.ts +4 -4
  418. package/templates/racing/src/render/quality.ts +27 -115
  419. package/templates/racing/src/render/sky.ts +72 -1
  420. package/templates/racing/src/scenes/Race.ts +9 -7
  421. package/templates/racing/src/track/TrackSector.ts +5 -2
  422. package/templates/racing/src/ui/Hud.tsx +12 -7
  423. package/templates/rain/.codex/config.toml +6 -2
  424. package/templates/rain/.cursor/mcp.json +8 -2
  425. package/templates/rain/.gemini/settings.json +8 -2
  426. package/templates/rain/.mcp.json +8 -2
  427. package/templates/rain/.vscode/mcp.json +9 -2
  428. package/templates/rain/.zed/settings.json +9 -2
  429. package/templates/rain/AGENTS.md +12 -12
  430. package/templates/rain/CLAUDE.md +12 -12
  431. package/templates/rain/opencode.json +10 -2
  432. package/templates/rain/package.json +14 -9
  433. package/templates/rain/playtests/performance.playtest.json +1 -1
  434. package/templates/rain/src/game.ts +1 -1
  435. package/templates/rain/src/render/bloom-shader.ts +1 -1
  436. package/templates/rain/src/render/clouds-shader.ts +2 -2
  437. package/templates/rain/src/render/clouds.ts +2 -1
  438. package/templates/rain/src/render/exposure.ts +11 -109
  439. package/templates/rain/src/render/post-shader.ts +7 -11
  440. package/templates/rain/src/render/postprocessing.ts +8 -24
  441. package/templates/rain/src/render/quality.ts +44 -98
  442. package/templates/rain/src/render/world-shader.ts +281 -97
  443. package/templates/rain/src/render/world.ts +82 -2
  444. package/templates/rain/src/style.css +1 -1
  445. package/templates/rain/src/ui/GameUi.tsx +6 -2
  446. package/templates/rain/src/ui/Hud.tsx +1 -1
  447. package/templates/rain/tools/generate-shaders.mjs +2 -2
  448. package/templates/rain/tools/tempest-post.frag +4 -6
  449. package/templates/rain/tools/tempest-world.frag +80 -12
  450. package/templates/rts/.codex/config.toml +6 -2
  451. package/templates/rts/.cursor/mcp.json +8 -2
  452. package/templates/rts/.gemini/settings.json +8 -2
  453. package/templates/rts/.mcp.json +8 -2
  454. package/templates/rts/.vscode/mcp.json +9 -2
  455. package/templates/rts/.zed/settings.json +9 -2
  456. package/templates/rts/AGENTS.md +15 -16
  457. package/templates/rts/CLAUDE.md +15 -16
  458. package/templates/rts/opencode.json +10 -2
  459. package/templates/rts/package.json +14 -9
  460. package/templates/rts/playtests/performance.playtest.json +1 -1
  461. package/templates/rts/playtests/rts-attack.playtest.json +5 -0
  462. package/templates/rts/playtests/rts-build.playtest.json +20 -1
  463. package/templates/rts/playtests/rts-orders.playtest.json +1 -1
  464. package/templates/rts/playtests/rts-pause.playtest.json +112 -0
  465. package/templates/rts/playtests/rts-train.playtest.json +1 -1
  466. package/templates/rts/playtests/rts-zoom.playtest.json +81 -0
  467. package/templates/rts/src/game.ts +29 -7
  468. package/templates/rts/src/render/army.ts +181 -49
  469. package/templates/rts/src/render/backlightMaterial.ts +49 -18
  470. package/templates/rts/src/render/environment.ts +276 -0
  471. package/templates/rts/src/render/exposure.ts +3 -65
  472. package/templates/rts/src/render/ground.ts +478 -0
  473. package/templates/rts/src/render/lighting.ts +62 -11
  474. package/templates/rts/src/render/materialLighting.ts +2 -11
  475. package/templates/rts/src/render/materials.ts +47 -118
  476. package/templates/rts/src/render/palette.ts +30 -13
  477. package/templates/rts/src/render/picking.ts +18 -0
  478. package/templates/rts/src/render/postprocessing.ts +4 -4
  479. package/templates/rts/src/render/quality.ts +64 -85
  480. package/templates/rts/src/render/resources.ts +21 -22
  481. package/templates/rts/src/render/sky.ts +9 -12
  482. package/templates/rts/src/render/terrain.ts +36 -11
  483. package/templates/rts/src/scenes/Play.ts +373 -38
  484. package/templates/rts/src/sim/ai.ts +0 -11
  485. package/templates/rts/src/state.ts +46 -0
  486. package/templates/rts/src/style.css +1543 -0
  487. package/templates/rts/src/ui/Commands.tsx +204 -107
  488. package/templates/rts/src/ui/GameUi.tsx +12 -5
  489. package/templates/rts/src/ui/Hud.tsx +611 -116
  490. package/templates/rts/src/ui/Minimap.tsx +103 -37
  491. package/templates/rts/src/ui/icons.tsx +116 -0
  492. package/templates/rts/src/ui/labels.ts +73 -0
  493. package/templates/rts/src/ui/minimapPoint.ts +30 -0
  494. package/templates/rts/threenative.config.ts +1 -1
  495. package/templates/runner/.codex/config.toml +6 -2
  496. package/templates/runner/.cursor/mcp.json +8 -2
  497. package/templates/runner/.gemini/settings.json +8 -2
  498. package/templates/runner/.mcp.json +8 -2
  499. package/templates/runner/.vscode/mcp.json +9 -2
  500. package/templates/runner/.zed/settings.json +9 -2
  501. package/templates/runner/AGENTS.md +12 -12
  502. package/templates/runner/CLAUDE.md +12 -12
  503. package/templates/runner/opencode.json +10 -2
  504. package/templates/runner/package.json +15 -10
  505. package/templates/runner/playtests/near-miss.playtest.json +48 -0
  506. package/templates/runner/playtests/performance.playtest.json +2 -2
  507. package/templates/runner/playtests/stride.playtest.json +27 -0
  508. package/templates/runner/playtests/survives.playtest.json +2 -2
  509. package/templates/runner/src/conventions.ts +3 -1
  510. package/templates/runner/src/entities/Runner.ts +11 -5
  511. package/templates/runner/src/render/atmosphere.ts +444 -0
  512. package/templates/runner/src/render/backlightMaterial.ts +49 -18
  513. package/templates/runner/src/render/clouds.ts +605 -0
  514. package/templates/runner/src/render/exposure.ts +6 -111
  515. package/templates/runner/src/render/gpuSky.ts +752 -0
  516. package/templates/runner/src/render/kitExposure.ts +20 -0
  517. package/templates/runner/src/render/lighting.ts +26 -4
  518. package/templates/runner/src/render/materialLighting.ts +2 -11
  519. package/templates/runner/src/render/postprocessing.ts +4 -4
  520. package/templates/runner/src/render/quality.ts +26 -114
  521. package/templates/runner/src/render/sky.ts +73 -1
  522. package/templates/runner/src/scenes/Run.ts +19 -15
  523. package/templates/runner/src/track.ts +12 -3
  524. package/templates/sailing/.codex/config.toml +6 -2
  525. package/templates/sailing/.cursor/mcp.json +8 -2
  526. package/templates/sailing/.gemini/settings.json +8 -2
  527. package/templates/sailing/.mcp.json +8 -2
  528. package/templates/sailing/.vscode/mcp.json +9 -2
  529. package/templates/sailing/.zed/settings.json +9 -2
  530. package/templates/sailing/AGENTS.md +10 -11
  531. package/templates/sailing/CLAUDE.md +10 -11
  532. package/templates/sailing/opencode.json +10 -2
  533. package/templates/sailing/package.json +15 -10
  534. package/templates/sailing/playtests/fail.playtest.json +46 -5
  535. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +7 -0
  536. package/templates/sailing/playtests/performance.playtest.json +1 -1
  537. package/templates/sailing/src/game.ts +1 -0
  538. package/templates/sailing/src/render/backlightMaterial.ts +49 -18
  539. package/templates/sailing/src/render/exposure.ts +6 -111
  540. package/templates/sailing/src/render/kitExposure.ts +20 -0
  541. package/templates/sailing/src/render/materialLighting.ts +2 -11
  542. package/templates/sailing/src/render/ocean.ts +0 -1
  543. package/templates/sailing/src/render/postprocessing.ts +4 -4
  544. package/templates/sailing/src/render/quality.ts +31 -138
  545. package/templates/sailing/src/scenes/Sailing.ts +12 -4
  546. package/templates/sailing/src/ui/Hud.tsx +6 -2
  547. package/templates/sailing/src/ui/Menu.tsx +1 -1
  548. package/templates/shooter/.codex/config.toml +6 -2
  549. package/templates/shooter/.cursor/mcp.json +8 -2
  550. package/templates/shooter/.gemini/settings.json +8 -2
  551. package/templates/shooter/.mcp.json +8 -2
  552. package/templates/shooter/.vscode/mcp.json +9 -2
  553. package/templates/shooter/.zed/settings.json +9 -2
  554. package/templates/shooter/AGENTS.md +13 -12
  555. package/templates/shooter/CLAUDE.md +13 -12
  556. package/templates/shooter/index.html +1 -1
  557. package/templates/shooter/main.html +13 -0
  558. package/templates/shooter/opencode.json +10 -2
  559. package/templates/shooter/package.json +15 -10
  560. package/templates/shooter/playtests/breakable-shatters.playtest.json +6 -0
  561. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +6 -0
  562. package/templates/shooter/playtests/hands-authored-rate.playtest.json +54 -0
  563. package/templates/shooter/playtests/movement-eases.playtest.json +53 -0
  564. package/templates/shooter/playtests/performance.playtest.json +3 -3
  565. package/templates/shooter/playtests/stairs-smooth-the-eye.playtest.json +56 -0
  566. package/templates/shooter/playtests/weapon-sharp-while-turning.playtest.json +206 -0
  567. package/templates/shooter/src/entities/Breakables.ts +34 -10
  568. package/templates/shooter/src/entities/Enemy.ts +176 -54
  569. package/templates/shooter/src/entities/FpsPlayer.ts +55 -16
  570. package/templates/shooter/src/entities/Rifle.ts +83 -9
  571. package/templates/shooter/src/entities/movement.ts +96 -0
  572. package/templates/shooter/src/render/atmosphere.ts +444 -0
  573. package/templates/shooter/src/render/backlightMaterial.ts +49 -18
  574. package/templates/shooter/src/render/camera.ts +3 -1
  575. package/templates/shooter/src/render/clouds.ts +605 -0
  576. package/templates/shooter/src/render/exposure.ts +10 -109
  577. package/templates/shooter/src/render/facade.ts +26 -68
  578. package/templates/shooter/src/render/gpuSky.ts +752 -0
  579. package/templates/shooter/src/render/lighting.ts +27 -4
  580. package/templates/shooter/src/render/materialAssignments.ts +9 -1
  581. package/templates/shooter/src/render/materialLighting.ts +2 -11
  582. package/templates/shooter/src/render/occlusion.ts +13 -4
  583. package/templates/shooter/src/render/palette.ts +1 -0
  584. package/templates/shooter/src/render/postprocessing.ts +4 -4
  585. package/templates/shooter/src/render/quality.ts +50 -108
  586. package/templates/shooter/src/render/scale.ts +0 -11
  587. package/templates/shooter/src/render/sky.ts +103 -2
  588. package/templates/shooter/src/render/surface.ts +140 -0
  589. package/templates/shooter/src/render/town.ts +3 -6
  590. package/templates/shooter/src/render/townMaterials.ts +95 -42
  591. package/templates/shooter/src/render/vehicles.ts +2 -0
  592. package/templates/shooter/src/scenes/Play.ts +83 -23
  593. package/templates/shooter/src/ui/Hud.tsx +268 -193
  594. package/templates/shooter/src/worker-page.ts +29 -0
  595. package/templates/shooter/src/worker.ts +5 -0
  596. package/templates/shooter/threenative.config.ts +3 -0
  597. package/templates/shooter/vite.config.ts +2 -0
  598. package/templates/snow/.codex/config.toml +6 -2
  599. package/templates/snow/.cursor/mcp.json +8 -2
  600. package/templates/snow/.gemini/settings.json +8 -2
  601. package/templates/snow/.mcp.json +8 -2
  602. package/templates/snow/.vscode/mcp.json +9 -2
  603. package/templates/snow/.zed/settings.json +9 -2
  604. package/templates/snow/AGENTS.md +12 -10
  605. package/templates/snow/CLAUDE.md +12 -10
  606. package/templates/snow/opencode.json +10 -2
  607. package/templates/snow/package.json +15 -10
  608. package/templates/snow/playtests/performance.playtest.json +1 -1
  609. package/templates/snow/src/render/backlightMaterial.ts +49 -18
  610. package/templates/snow/src/render/exposure.ts +17 -106
  611. package/templates/snow/src/render/materialLighting.ts +2 -11
  612. package/templates/snow/src/render/postprocessing.ts +11 -5
  613. package/templates/snow/src/render/quality.ts +46 -126
  614. package/templates/snow/src/render/snowSurface.ts +32 -15
  615. package/templates/snow/src/scenes/Snow.ts +2 -1
  616. package/templates/starter/.codex/config.toml +6 -2
  617. package/templates/starter/.cursor/mcp.json +8 -2
  618. package/templates/starter/.gemini/settings.json +8 -2
  619. package/templates/starter/.mcp.json +8 -2
  620. package/templates/starter/.vscode/mcp.json +9 -2
  621. package/templates/starter/.zed/settings.json +9 -2
  622. package/templates/starter/AGENTS.md +18 -14
  623. package/templates/starter/CLAUDE.md +18 -14
  624. package/templates/starter/index.html +1 -1
  625. package/templates/starter/main.html +12 -0
  626. package/templates/starter/native-playtests/react-hud.playtest.json +1 -0
  627. package/templates/starter/native-playtests/render-chain.playtest.json +34 -21
  628. package/templates/starter/opencode.json +10 -2
  629. package/templates/starter/package.json +15 -10
  630. package/templates/starter/playtests/play.playtest.json +22 -2
  631. package/templates/starter/playtests/production-readiness.playtest.json +14 -0
  632. package/templates/starter/src/entities/Crate.ts +19 -1
  633. package/templates/starter/src/render/arena.ts +2 -2
  634. package/templates/starter/src/render/atmosphere.ts +444 -0
  635. package/templates/starter/src/render/backlightMaterial.ts +49 -18
  636. package/templates/starter/src/render/camera.ts +28 -0
  637. package/templates/starter/src/render/clouds.ts +605 -0
  638. package/templates/starter/src/render/contactShadow.ts +50 -0
  639. package/templates/starter/src/render/exposure.ts +9 -111
  640. package/templates/starter/src/render/gpuSky.ts +752 -0
  641. package/templates/starter/src/render/grade.ts +1 -1
  642. package/templates/starter/src/render/lighting.ts +34 -6
  643. package/templates/starter/src/render/materialLighting.ts +2 -11
  644. package/templates/starter/src/render/postprocessing.ts +27 -14
  645. package/templates/starter/src/render/quality.ts +18 -147
  646. package/templates/starter/src/render/sky.ts +90 -40
  647. package/templates/starter/src/render/temporalAA.ts +1 -1
  648. package/templates/starter/src/render/temporalAAStage.ts +1 -1
  649. package/templates/starter/src/render/temporalCurrentFootprint.ts +0 -1
  650. package/templates/starter/src/render/temporalDetailStage.ts +106 -0
  651. package/templates/starter/src/render/temporalRejectionCounter.ts +2 -2
  652. package/templates/starter/src/render/volumetricFogCamera.ts +32 -0
  653. package/templates/starter/src/render/volumetricFogOptions.ts +7 -0
  654. package/templates/starter/src/render/volumetricFogTransport.ts +27 -19
  655. package/templates/starter/src/render/volumetricFogVolume.ts +31 -7
  656. package/templates/starter/src/scenes/Play.ts +11 -8
  657. package/templates/starter/src/ui/Hud.tsx +1 -1
  658. package/templates/starter/src/worker-page.ts +29 -0
  659. package/templates/starter/src/worker.ts +5 -0
  660. package/templates/starter/vite.config.ts +2 -0
  661. package/templates/tower-defense/.codex/config.toml +6 -2
  662. package/templates/tower-defense/.cursor/mcp.json +8 -2
  663. package/templates/tower-defense/.gemini/settings.json +8 -2
  664. package/templates/tower-defense/.mcp.json +8 -2
  665. package/templates/tower-defense/.vscode/mcp.json +9 -2
  666. package/templates/tower-defense/.zed/settings.json +9 -2
  667. package/templates/tower-defense/AGENTS.md +10 -12
  668. package/templates/tower-defense/CLAUDE.md +10 -12
  669. package/templates/tower-defense/opencode.json +10 -2
  670. package/templates/tower-defense/package.json +15 -10
  671. package/templates/tower-defense/playtests/chill-tint.playtest.json +387 -0
  672. package/templates/tower-defense/playtests/performance.playtest.json +1 -1
  673. package/templates/tower-defense/src/enemies/Enemy.ts +9 -0
  674. package/templates/tower-defense/src/render/backlightMaterial.ts +49 -18
  675. package/templates/tower-defense/src/render/exposure.ts +11 -109
  676. package/templates/tower-defense/src/render/lighting.ts +4 -2
  677. package/templates/tower-defense/src/render/materialLighting.ts +2 -11
  678. package/templates/tower-defense/src/render/postprocessing.ts +4 -4
  679. package/templates/tower-defense/src/render/quality.ts +10 -116
  680. package/templates/tower-defense/src/render/sky.ts +2 -2
  681. package/templates/tower-defense/src/scenes/Battle.ts +4 -0
  682. package/template-assets/autoExposure.ts +0 -225
  683. package/template-assets/exposureGraph.ts +0 -178
  684. package/template-assets/exposureReadback.ts +0 -79
  685. package/template-assets/worldEnvironment.ts +0 -1212
  686. package/templates/action-rpg/src/render/autoExposure.ts +0 -225
  687. package/templates/action-rpg/src/render/exposureGraph.ts +0 -178
  688. package/templates/action-rpg/src/render/exposureReadback.ts +0 -79
  689. package/templates/action-rpg/src/render/worldEnvironment.ts +0 -1212
  690. package/templates/minimal/src/render/autoExposure.ts +0 -225
  691. package/templates/minimal/src/render/exposureGraph.ts +0 -178
  692. package/templates/minimal/src/render/exposureReadback.ts +0 -79
  693. package/templates/minimal/src/render/worldEnvironment.ts +0 -1212
  694. package/templates/platformer/src/render/autoExposure.ts +0 -225
  695. package/templates/platformer/src/render/exposureGraph.ts +0 -178
  696. package/templates/platformer/src/render/exposureReadback.ts +0 -79
  697. package/templates/platformer/src/render/worldEnvironment.ts +0 -1212
  698. package/templates/puzzle/src/render/autoExposure.ts +0 -225
  699. package/templates/puzzle/src/render/exposureGraph.ts +0 -178
  700. package/templates/puzzle/src/render/exposureReadback.ts +0 -79
  701. package/templates/puzzle/src/render/worldEnvironment.ts +0 -1212
  702. package/templates/racing/src/render/autoExposure.ts +0 -225
  703. package/templates/racing/src/render/exposureGraph.ts +0 -178
  704. package/templates/racing/src/render/exposureReadback.ts +0 -79
  705. package/templates/racing/src/render/worldEnvironment.ts +0 -1212
  706. package/templates/rain/src/render/autoExposure.ts +0 -225
  707. package/templates/rain/src/render/exposureGraph.ts +0 -178
  708. package/templates/rain/src/render/exposureReadback.ts +0 -79
  709. package/templates/rain/src/render/worldEnvironment.ts +0 -1212
  710. package/templates/rts/src/render/autoExposure.ts +0 -225
  711. package/templates/rts/src/render/exposureGraph.ts +0 -178
  712. package/templates/rts/src/render/exposureReadback.ts +0 -79
  713. package/templates/rts/src/render/worldEnvironment.ts +0 -1212
  714. package/templates/runner/src/render/autoExposure.ts +0 -225
  715. package/templates/runner/src/render/exposureGraph.ts +0 -178
  716. package/templates/runner/src/render/exposureReadback.ts +0 -79
  717. package/templates/runner/src/render/worldEnvironment.ts +0 -1212
  718. package/templates/sailing/src/render/autoExposure.ts +0 -225
  719. package/templates/sailing/src/render/exposureGraph.ts +0 -178
  720. package/templates/sailing/src/render/exposureReadback.ts +0 -79
  721. package/templates/sailing/src/render/worldEnvironment.ts +0 -1212
  722. package/templates/shooter/src/render/autoExposure.ts +0 -225
  723. package/templates/shooter/src/render/exposureGraph.ts +0 -178
  724. package/templates/shooter/src/render/exposureReadback.ts +0 -79
  725. package/templates/shooter/src/render/worldEnvironment.ts +0 -1212
  726. package/templates/snow/src/render/autoExposure.ts +0 -225
  727. package/templates/snow/src/render/exposureGraph.ts +0 -178
  728. package/templates/snow/src/render/exposureReadback.ts +0 -79
  729. package/templates/snow/src/render/worldEnvironment.ts +0 -1212
  730. package/templates/starter/src/render/autoExposure.ts +0 -225
  731. package/templates/starter/src/render/exposureGraph.ts +0 -178
  732. package/templates/starter/src/render/exposureReadback.ts +0 -79
  733. package/templates/starter/src/render/worldEnvironment.ts +0 -1212
  734. package/templates/tower-defense/src/render/autoExposure.ts +0 -225
  735. package/templates/tower-defense/src/render/exposureGraph.ts +0 -178
  736. package/templates/tower-defense/src/render/exposureReadback.ts +0 -79
  737. package/templates/tower-defense/src/render/worldEnvironment.ts +0 -1212
@@ -0,0 +1,517 @@
1
+ import { type ICourse, SURFACE_DRAG, type Surface } from "../track/Course.js";
2
+
3
+ /**
4
+ * The kart's feel: every number the reference decides, in metres, seconds and its own 60 Hz ticks.
5
+ * MK64 has no metre, so the kit keeps its ratios and times and sets one scale, `topSpeed`; every
6
+ * other speed is a ratio of it. Change a value here and the whole field changes with it, the CPUs
7
+ * included, because they drive this same model.
8
+ */
9
+ export const KART_FEEL = {
10
+ /** Terminal road speed at full throttle in each class, m/s. Terminal speed is ∝ throttle², and
11
+ * the throttle tops out at 290 / 310 / 320 (`mk64: src/data/kart_attributes.c:65-75`). */
12
+ topSpeed: { "50cc": 24 * (290 / 320) ** 2, "100cc": 24 * (310 / 320) ** 2, "150cc": 24 },
13
+ /** The throttle's top in each class; the throttle is the pedal, not the speed. */
14
+ throttleTop: { "50cc": 290, "100cc": 310, "150cc": 320 },
15
+ /** Throttle gained per tick in each tenth of its top (medium weight, `kart_attributes.c:248`). */
16
+ accel: [2.0, 2.0, 2.0, 1.6, 1.4, 1.2, 1.0, 0.8, 0.6, 0.4],
17
+ /** Throttle lost per tick off the pedal, and braking (`player_controller.c:4688`, `:3563`). */
18
+ coast: 1,
19
+ brake: 3,
20
+ /** Speed follows its target with this lag, in ticks: 6000 / (0.12 · 5800) (`player_controller.c:2413`). */
21
+ lagTicks: 8.62,
22
+ /** Reverse speed with the brake held from a stop, m/s. Kit value. */
23
+ reverse: 4,
24
+ /** Yaw at full lock: `K·s·|s| / (8 + throttle/50)` deg/s, so 94 °/s at the 150cc top
25
+ * (`player_controller.c:4137-4173`), ×1.12 past 85% lock (handling +0.15 on 1.25). */
26
+ steerK: 94 * (8 + 320 / 50),
27
+ steerHardLock: 0.85,
28
+ steerHardGain: 1.12,
29
+ /** Below this speed the steering fades out, so a parked kart does not spin on the spot. Kit guard. */
30
+ steerFadeSpeed: 3,
31
+ /** The velocity's heading follows the kart's at 1/12 per tick, at most 40° behind (`:1300`, `:1348`). */
32
+ slipFollow: 1 / 12,
33
+ slipMax: (40 * Math.PI) / 180,
34
+ /** Drag per degree of slip, drifting and turning (`player_controller.c:2990-3106`), and how fast
35
+ * any drag eases in (5% per tick). */
36
+ driftDrag: 0.004,
37
+ turnDrag: 0.01,
38
+ dragEase: 0.05,
39
+ /** The hop: up 0.35 m in 8 ticks (`kart_attributes.c:401`, `player_controller.c:1192-1241`). */
40
+ hopSpeed: 5.4,
41
+ hopGravity: 41.5,
42
+ /** Gravity off a ramp, m/s². Kit value: an arcade arc, not 9.8. */
43
+ gravity: 30,
44
+ /** A drift starts only above 28% of top speed (20 of 70.7 display km/h, `player_controller.c:4327`). */
45
+ driftMinFraction: 0.28,
46
+ /** Drift yaw, deg/s: stick neutral, extra at full inside, less at full outside (`:4197-4228`). */
47
+ driftYaw: 36,
48
+ driftYawInside: 54,
49
+ driftYawOutside: 21,
50
+ /** Stick past 10/53 against the drift charges the mini-turbo (`player_controller.c:1145-1190`). */
51
+ chargeStick: 10 / 53,
52
+ /** Ticks held against the drift for one stage, the counter kept after a stage, and the stall. */
53
+ chargeTicks: 18,
54
+ chargeKeep: 10,
55
+ chargeStall: 100,
56
+ /** The mini-turbo: 31 ticks at +580/4096 force, eased in at 20% a tick and bled at 1% a tick
57
+ * (`player_controller.c:1123-1140`, `:3094`). */
58
+ miniTurboTicks: 31,
59
+ miniTurbo: 580 / 4096,
60
+ /** The nitro can and the boost pad: 80 ticks at +400/4096, eased in at 50% a tick, then −10% a
61
+ * tick (`effects.c:547`, `player_controller.c:1120`, `:3117`). */
62
+ boostTicks: 80,
63
+ boost: 400 / 4096,
64
+ /** A CPU behind the leader's pace gets +380/4096 force (`player_controller.c:3085`). */
65
+ catchUp: 380 / 4096,
66
+ /** A wall: speed into it reflected ×0.5, throttle −18 a contact tick (`player_controller.c:1952`). */
67
+ wallBounce: 0.5,
68
+ wallThrottle: 18,
69
+ /** Half the kart's width, for the wall line. */
70
+ halfWidth: 0.85,
71
+ /** A burr spin and an acorn tumble, in ticks (`effects.c:375-394`, `:197-224`). */
72
+ spinTicks: 90,
73
+ tumbleTicks: 103,
74
+ } as const;
75
+
76
+ export type EngineClass = keyof typeof KART_FEEL.topSpeed;
77
+
78
+ /** What a kart is told each tick: the player's keys or a CPU's `Driver`. */
79
+ export interface IKartInput {
80
+ throttle: boolean;
81
+ brake: boolean;
82
+ /** −1 full left … +1 full right. */
83
+ steer: number;
84
+ /** The hop and drift button, held. */
85
+ drift: boolean;
86
+ /** Pressed this tick: use the held item. */
87
+ item: boolean;
88
+ }
89
+
90
+ export const idleInput = (): IKartInput => ({
91
+ brake: false,
92
+ drift: false,
93
+ item: false,
94
+ steer: 0,
95
+ throttle: false,
96
+ });
97
+
98
+ const DEG = Math.PI / 180;
99
+
100
+ function wrapAngle(angle: number): number {
101
+ return Math.atan2(Math.sin(angle), Math.cos(angle));
102
+ }
103
+
104
+ /**
105
+ * One kart: the throttle, the speed that chases it, the heading and the slip, the hop and the
106
+ * power-slide, the boosts and the hits. Position is world x/z plus a place on the course
107
+ * (`index`, `lateral`), which gives the ground, the surface and the wall. It draws nothing:
108
+ * `render/kart.ts` follows it.
109
+ */
110
+ export class Kart {
111
+ readonly feel = KART_FEEL;
112
+ x = 0;
113
+ y = 0;
114
+ z = 0;
115
+ /** Facing: 0 looks down −z, positive turns left (three's Y rotation). */
116
+ yaw = 0;
117
+ /** Where the velocity points; `yaw − velocityYaw` is the slip. */
118
+ velocityYaw = 0;
119
+ /** Signed speed along `velocityYaw`, m/s. */
120
+ speed = 0;
121
+ /** The pedal, 0 to the class's throttle top. */
122
+ throttle = 0;
123
+ vy = 0;
124
+ airborne = false;
125
+ /** Seconds in the air on the current flight. */
126
+ airTime = 0;
127
+ /** Longest flight so far, seconds. */
128
+ longestAir = 0;
129
+ #gravity: number = KART_FEEL.gravity;
130
+ /** The road's own vertical speed under the kart last tick: a lip that drops away faster launches it. */
131
+ #roadVy = 0;
132
+ index = 0;
133
+ lateral = 0;
134
+ surface: Surface = "road";
135
+ drag = 0;
136
+ /** Drift: 0 none, −1 left, +1 right. */
137
+ driftSide = 0;
138
+ /** Mini-turbo stage, 0..3: spark colour white, yellow, orange (`code_80057C60.c:2865`). */
139
+ driftStage = 0;
140
+ #driftCounter = 0;
141
+ #hopHeld = false;
142
+ #hopping = false;
143
+ miniTurboTicks = 0;
144
+ miniTurbo = 0;
145
+ /** Fastest speed during the last mini-turbo, and the speed the last drift began at. */
146
+ turboPeak = 0;
147
+ driftEntrySpeed = 0;
148
+ /** Seconds the last boost lasted, and the fastest speed during it. */
149
+ boostSeconds = 0;
150
+ boostPeak = 0;
151
+ boostTicks = 0;
152
+ boost = 0;
153
+ catchUp = 0;
154
+ /** A CPU behind the pace sets this each tick. */
155
+ catchingUp = false;
156
+ spinTicks = 0;
157
+ tumbleTicks = 0;
158
+ /** Seconds the last burr spin or acorn tumble lasted. */
159
+ hitSeconds = 0;
160
+ /** Visual spin angle while hit, radians. */
161
+ spinAngle = 0;
162
+ /** Speed after 1 s of full throttle, wheel straight, on one surface: the settled top there. */
163
+ readonly settled: Record<Surface, number> = { grass: 0, road: 0, water: 0 };
164
+ #settling = 0;
165
+ /** Widest the kart has been from the centre line, metres. */
166
+ maxLateral = 0;
167
+ wallHits = 0;
168
+ /** The last wall contact: speed into the wall before and after it (m/s along the wall's
169
+ * normal; after is negative, away from it) and the throttle it cost. */
170
+ wallInto = 0;
171
+ wallAfter = 0;
172
+ wallThrottleDrop = 0;
173
+ /** Ticks this kart has been touching a wall this tick (0 or 1), for the effects. */
174
+ onWall = false;
175
+ readonly counts = { drifts: 0, hops: 0, miniTurbos: 0, boosts: 0, spins: 0, tumbles: 0 };
176
+ /** The stage each drift reached when it ended, newest last (kept short). */
177
+ readonly driftStages: number[] = [];
178
+ #topSpeed: number;
179
+ #throttleTop: number;
180
+
181
+ constructor(
182
+ readonly course: ICourse,
183
+ readonly engine: EngineClass = "150cc",
184
+ ) {
185
+ this.#topSpeed = KART_FEEL.topSpeed[engine];
186
+ this.#throttleTop = KART_FEEL.throttleTop[engine];
187
+ }
188
+
189
+ get topSpeed(): number {
190
+ return this.#topSpeed;
191
+ }
192
+
193
+ get grounded(): boolean {
194
+ return !this.airborne;
195
+ }
196
+
197
+ get drifting(): boolean {
198
+ return this.driftSide !== 0;
199
+ }
200
+
201
+ get hit(): boolean {
202
+ return this.spinTicks > 0 || this.tumbleTicks > 0;
203
+ }
204
+
205
+ /** Slip angle in radians: where the nose points against where the kart goes. */
206
+ get slip(): number {
207
+ return wrapAngle(this.yaw - this.velocityYaw);
208
+ }
209
+
210
+ /** Puts the kart on the course at sample `index`, `lateral` metres off the line, facing along it. */
211
+ place(index: number, lateral: number): void {
212
+ const course = this.course;
213
+ const at = { x: 0, y: 0, z: 0 };
214
+ const i = course.wrap(index);
215
+ course.pointAt(i, lateral, at);
216
+ this.x = at.x;
217
+ this.y = at.y;
218
+ this.z = at.z;
219
+ this.index = i;
220
+ this.lateral = lateral;
221
+ this.yaw = Math.atan2(-(course.tx[i] ?? 0), -(course.tz[i] ?? 0));
222
+ this.velocityYaw = this.yaw;
223
+ this.speed = 0;
224
+ this.throttle = 0;
225
+ this.vy = 0;
226
+ this.airborne = false;
227
+ this.#roadVy = 0;
228
+ }
229
+
230
+ /** The nitro can, a boost pad or a rocket start: throttle pinned to top for 80 ticks. */
231
+ startBoost(): void {
232
+ this.boostTicks = KART_FEEL.boostTicks;
233
+ this.counts.boosts += 1;
234
+ this.boostSeconds = 0;
235
+ this.boostPeak = this.speed;
236
+ }
237
+
238
+ /** A burr: a 1.5 s spin. Ends any drift and boost. */
239
+ spinOut(): void {
240
+ if (this.hit) return;
241
+ this.spinTicks = KART_FEEL.spinTicks;
242
+ this.counts.spins += 1;
243
+ this.hitSeconds = 0;
244
+ this.#endDrift(false);
245
+ this.boostTicks = 0;
246
+ this.miniTurboTicks = 0;
247
+ }
248
+
249
+ /** An acorn: a 1.7 s tumble that brings the kart to a stop. */
250
+ tumble(): void {
251
+ if (this.hit) return;
252
+ this.tumbleTicks = KART_FEEL.tumbleTicks;
253
+ this.counts.tumbles += 1;
254
+ this.hitSeconds = 0;
255
+ this.#endDrift(false);
256
+ this.boostTicks = 0;
257
+ this.miniTurboTicks = 0;
258
+ if (!this.airborne) {
259
+ this.vy = 4.5;
260
+ this.airborne = true;
261
+ this.#gravity = KART_FEEL.gravity;
262
+ }
263
+ }
264
+
265
+ step(input: IKartInput, dt: number): void {
266
+ const f = KART_FEEL;
267
+ const ticks = dt * 60;
268
+ const top = this.#throttleTop;
269
+ this.onWall = false;
270
+
271
+ // Hits: no control, the throttle drains, the kart turns round its own axis.
272
+ let throttle = input.throttle;
273
+ let brake = input.brake;
274
+ let steer = Math.max(-1, Math.min(1, input.steer));
275
+ if (this.hit) this.hitSeconds += dt;
276
+ if (this.spinTicks > 0) {
277
+ this.spinTicks = Math.max(0, this.spinTicks - ticks);
278
+ // 360° at 12°/tick, then 360° at 6°/tick.
279
+ this.spinAngle += (this.spinTicks > 60 ? 12 : 6) * DEG * ticks;
280
+ this.throttle = Math.max(0, this.throttle - f.coast * ticks);
281
+ throttle = false;
282
+ brake = false;
283
+ steer = 0;
284
+ } else if (this.tumbleTicks > 0) {
285
+ this.tumbleTicks = Math.max(0, this.tumbleTicks - ticks);
286
+ this.spinAngle += 7 * DEG * ticks;
287
+ this.throttle = Math.max(0, this.throttle - 5 * ticks);
288
+ throttle = false;
289
+ brake = false;
290
+ steer = 0;
291
+ } else this.spinAngle = 0;
292
+
293
+ // The pedal. A boost pins it to the top.
294
+ if (this.boostTicks > 0) this.throttle = top;
295
+ else if (throttle && this.grounded) {
296
+ const tenth = Math.min(9, Math.floor((this.throttle / top) * 10));
297
+ this.throttle = Math.min(top, this.throttle + (f.accel[tenth] ?? 0.4) * ticks);
298
+ } else if (brake) this.throttle = Math.max(0, this.throttle - f.brake * ticks);
299
+ else if (!throttle) this.throttle = Math.max(0, this.throttle - f.coast * ticks);
300
+
301
+ // Drag: the surface plus slip, eased in at 5% a tick.
302
+ const slipDeg = Math.abs(this.slip) / DEG;
303
+ let dragTarget = this.grounded ? SURFACE_DRAG[this.surface] : 0;
304
+ if (Math.abs(this.speed) > this.#topSpeed * 0.11)
305
+ dragTarget += slipDeg * (this.drifting ? f.driftDrag : f.turnDrag);
306
+ this.drag += (dragTarget - this.drag) * (1 - (1 - f.dragEase) ** ticks);
307
+
308
+ // Boost forces, each eased toward its level and bled off after.
309
+ if (this.boostTicks > 0) {
310
+ this.boostTicks = Math.max(0, this.boostTicks - ticks);
311
+ this.boost += (f.boost - this.boost) * (1 - 0.5 ** ticks);
312
+ } else this.boost *= 0.9 ** ticks;
313
+ if (this.miniTurboTicks > 0) {
314
+ this.miniTurboTicks = Math.max(0, this.miniTurboTicks - ticks);
315
+ this.miniTurbo += (f.miniTurbo - this.miniTurbo) * (1 - 0.8 ** ticks);
316
+ } else this.miniTurbo *= 0.99 ** ticks;
317
+ if (this.catchingUp) this.catchUp += (f.catchUp - this.catchUp) * (1 - 0.5 ** ticks);
318
+ else this.catchUp *= 0.9 ** ticks;
319
+
320
+ // Speed chases the throttle's terminal speed: ∝ throttle², less drag, plus the boosts. The
321
+ // nitro can skips the drag (`player_controller.c:3117`). In the air the speed holds.
322
+ if (this.grounded) {
323
+ const resist = this.boostTicks > 0 ? 0 : this.drag;
324
+ let target =
325
+ this.#topSpeed *
326
+ (this.throttle / top) ** 2 *
327
+ Math.max(0, 1 - resist) *
328
+ (1 + this.boost + this.miniTurbo + this.catchUp);
329
+ if (brake && this.throttle === 0 && this.speed < 0.5) target = -f.reverse;
330
+ this.speed += (target - this.speed) * (1 - Math.exp(-ticks / f.lagTicks));
331
+ }
332
+
333
+ // Hop and drift. A press while grounded hops; with the stick held and enough speed the hop
334
+ // locks a power-slide to that side, which lasts while the button is held.
335
+ const hopPressed = input.drift && !this.#hopHeld;
336
+ this.#hopHeld = input.drift;
337
+ if (hopPressed && this.grounded && !this.hit) {
338
+ this.vy = f.hopSpeed;
339
+ this.airborne = true;
340
+ this.#hopping = true;
341
+ this.#gravity = f.hopGravity;
342
+ this.counts.hops += 1;
343
+ }
344
+ const fastEnough = this.speed > this.#topSpeed * f.driftMinFraction;
345
+ if (
346
+ this.#hopping &&
347
+ this.driftSide === 0 &&
348
+ input.drift &&
349
+ Math.abs(steer) > 0.2 &&
350
+ fastEnough
351
+ ) {
352
+ this.driftSide = Math.sign(steer);
353
+ this.driftStage = 0;
354
+ this.#driftCounter = 0;
355
+ this.counts.drifts += 1;
356
+ this.driftEntrySpeed = this.speed;
357
+ }
358
+ if (this.drifting) {
359
+ if (!input.drift) this.#endDrift(true);
360
+ else if (!fastEnough && this.grounded) this.#endDrift(false);
361
+ }
362
+ if (this.drifting) this.#charge(steer * this.driftSide, ticks);
363
+
364
+ // Steering.
365
+ let yawRate: number;
366
+ if (this.drifting) {
367
+ const inside = steer * this.driftSide;
368
+ yawRate =
369
+ this.driftSide *
370
+ (f.driftYaw +
371
+ f.driftYawInside * Math.max(0, inside) -
372
+ f.driftYawOutside * Math.max(0, -inside));
373
+ } else {
374
+ const hard = Math.abs(steer) >= f.steerHardLock ? f.steerHardGain : 1;
375
+ yawRate = ((f.steerK * steer * Math.abs(steer)) / (8 + this.throttle / 50)) * hard;
376
+ yawRate *= Math.min(1, Math.abs(this.speed) / f.steerFadeSpeed) * Math.sign(this.speed || 1);
377
+ }
378
+ if (this.airborne && !this.#hopping) yawRate *= 0.5;
379
+ // Positive steer is right; three's positive yaw turns left.
380
+ this.yaw = wrapAngle(this.yaw - yawRate * DEG * dt);
381
+
382
+ // The velocity's heading follows the nose at 1/12 a tick, at most 40° behind it.
383
+ const lag = wrapAngle(this.yaw - this.velocityYaw);
384
+ let next = this.velocityYaw + lag * (1 - (1 - f.slipFollow) ** ticks);
385
+ const behind = wrapAngle(this.yaw - next);
386
+ if (Math.abs(behind) > f.slipMax) next = this.yaw - Math.sign(behind) * f.slipMax;
387
+ this.velocityYaw = wrapAngle(next);
388
+
389
+ // Move on the ground plane.
390
+ if (this.miniTurboTicks > 0) this.turboPeak = Math.max(this.turboPeak, this.speed);
391
+ if (this.boostTicks > 0) {
392
+ this.boostSeconds += dt;
393
+ this.boostPeak = Math.max(this.boostPeak, this.speed);
394
+ }
395
+ this.x += -Math.sin(this.velocityYaw) * this.speed * dt;
396
+ this.z += -Math.cos(this.velocityYaw) * this.speed * dt;
397
+ const surface = this.surface;
398
+ this.#follow(dt);
399
+ this.maxLateral = Math.max(this.maxLateral, Math.abs(this.lateral));
400
+ const steady = this.grounded && this.throttle >= top && Math.abs(steer) < 0.1 && !this.drifting;
401
+ this.#settling = steady && surface === this.surface ? this.#settling + dt : 0;
402
+ if (this.#settling >= 1) this.settled[this.surface] = this.speed;
403
+ }
404
+
405
+ /** The track-space half of the step: where on the course, what surface, the wall and the ground. */
406
+ #follow(dt: number): void {
407
+ const f = KART_FEEL;
408
+ const course = this.course;
409
+ const point = course.track(this.index, this.x, this.z);
410
+ this.index = point.index;
411
+ this.lateral = point.lateral;
412
+ // The wall: push the kart back inside, reflect the speed into it ×0.5, cut the throttle.
413
+ const limit = (course.wall[this.index] ?? 0) - f.halfWidth;
414
+ if (Math.abs(this.lateral) > limit) {
415
+ const side = Math.sign(this.lateral);
416
+ const over = Math.abs(this.lateral) - limit;
417
+ // Right of travel is (−tz, tx).
418
+ const nx = -(course.tz[this.index] ?? 0) * side;
419
+ const nz = (course.tx[this.index] ?? 0) * side;
420
+ this.x -= nx * over;
421
+ this.z -= nz * over;
422
+ this.lateral = side * limit;
423
+ const vx = -Math.sin(this.velocityYaw) * this.speed;
424
+ const vz = -Math.cos(this.velocityYaw) * this.speed;
425
+ const into = vx * nx + vz * nz;
426
+ if (into > 0) {
427
+ const rx = vx - (1 + f.wallBounce) * into * nx;
428
+ const rz = vz - (1 + f.wallBounce) * into * nz;
429
+ this.speed = Math.hypot(rx, rz);
430
+ this.velocityYaw = Math.atan2(-rx, -rz);
431
+ this.wallInto = into;
432
+ this.wallAfter = rx * nx + rz * nz;
433
+ this.wallThrottleDrop = Math.min(this.throttle, f.wallThrottle);
434
+ this.throttle = Math.max(0, this.throttle - f.wallThrottle);
435
+ this.wallHits += 1;
436
+ }
437
+ // A nose into the wall turns to scrape along it, so the kart glances off instead of
438
+ // grinding to a stop against it (kit guard; MK64's own response is the reflection above).
439
+ const fx = -Math.sin(this.yaw);
440
+ const fz = -Math.cos(this.yaw);
441
+ const nose = fx * nx + fz * nz;
442
+ if (nose > 0 && Math.hypot(fx - nose * nx, fz - nose * nz) > 0.1) {
443
+ this.yaw = Math.atan2(-(fx - nose * nx), -(fz - nose * nz));
444
+ }
445
+ this.onWall = true;
446
+ this.#endDrift(false);
447
+ this.boostTicks = 0;
448
+ }
449
+ this.surface = course.surface(point);
450
+
451
+ // Ground: follow the road while it holds the kart; leave it at a lip that drops away faster
452
+ // than gravity would.
453
+ const ground = course.heightAt(this.index, this.x, this.z);
454
+ if (this.airborne) {
455
+ this.vy -= this.#gravity * dt;
456
+ this.y += this.vy * dt;
457
+ this.airTime += dt;
458
+ if (this.y <= ground) {
459
+ this.y = ground;
460
+ this.vy = 0;
461
+ this.airborne = false;
462
+ this.#hopping = false;
463
+ this.#gravity = f.gravity;
464
+ this.#roadVy = 0;
465
+ this.longestAir = Math.max(this.longestAir, this.airTime);
466
+ this.airTime = 0;
467
+ }
468
+ return;
469
+ }
470
+ const ballistic = this.y + this.#roadVy * dt - 0.5 * f.gravity * dt * dt;
471
+ if (ground < ballistic - 0.03 && this.#roadVy > 0.5) {
472
+ this.airborne = true;
473
+ this.#gravity = f.gravity;
474
+ this.vy = this.#roadVy - f.gravity * dt;
475
+ this.y = ballistic;
476
+ this.airTime = 0;
477
+ return;
478
+ }
479
+ this.#roadVy = (ground - this.y) / Math.max(dt, 1e-4);
480
+ this.y = ground;
481
+ }
482
+
483
+ /** The mini-turbo charge: hold the stick against the drift, then let it back. */
484
+ #charge(inside: number, ticks: number): void {
485
+ const f = KART_FEEL;
486
+ if (inside <= -f.chargeStick) {
487
+ this.#driftCounter = Math.min(f.chargeStall + 1, this.#driftCounter + ticks);
488
+ // Held too long: the slide stalls and bleeds 4 throttle a tick (`player_controller.c:1148`).
489
+ if (this.#driftCounter >= f.chargeStall)
490
+ this.throttle = Math.max(0, this.throttle - 4 * ticks);
491
+ return;
492
+ }
493
+ if (this.#driftCounter >= f.chargeTicks && this.#driftCounter < f.chargeStall)
494
+ this.driftStage = Math.min(3, this.driftStage + 1);
495
+ if (this.#driftCounter >= f.chargeKeep && this.#driftCounter < f.chargeStall)
496
+ this.#driftCounter = f.chargeKeep;
497
+ else {
498
+ this.#driftCounter = 0;
499
+ this.driftStage = 0;
500
+ }
501
+ }
502
+
503
+ /** Ends a drift; a release at stage 2 or more fires the mini-turbo. */
504
+ #endDrift(release: boolean): void {
505
+ if (!this.drifting) return;
506
+ if (release && this.driftStage >= 2) {
507
+ this.miniTurboTicks = KART_FEEL.miniTurboTicks;
508
+ this.counts.miniTurbos += 1;
509
+ this.turboPeak = this.speed;
510
+ }
511
+ this.driftStages.push(this.driftStage);
512
+ if (this.driftStages.length > 8) this.driftStages.shift();
513
+ this.driftSide = 0;
514
+ this.driftStage = 0;
515
+ this.#driftCounter = 0;
516
+ }
517
+ }
@@ -0,0 +1,45 @@
1
+ import { defineGame } from "@threenative/core";
2
+ import { playtest } from "@threenative/core/playtest";
3
+ import config from "../threenative.config.js";
4
+ import { drainPlaytestEvents as events } from "./playtest-events.js";
5
+ import { Race } from "./scenes/Race.js";
6
+ import type { GameState } from "./state.js";
7
+
8
+ const game = defineGame<GameState>({
9
+ input: {
10
+ // Steering is the x of `input.vector("move")`: the arrows, A/D or the left stick. No keys on
11
+ // up or down: a vector is normalised, so W held with D would steer at only 0.71.
12
+ move: { up: [], down: [], left: ["ArrowLeft", "KeyA"], right: ["ArrowRight", "KeyD"] },
13
+ accel: { buttons: [0], keys: ["ArrowUp", "KeyW"] },
14
+ brake: { buttons: [1], keys: ["ArrowDown", "KeyS"] },
15
+ // Hop; hold it through a turn to power-slide, wiggle against the slide to charge a mini-turbo.
16
+ drift: { buttons: [5, 7], keys: ["Space", "ShiftLeft", "ShiftRight"] },
17
+ item: { buttons: [4, 6], keys: ["KeyE", "KeyX"] },
18
+ // The player's kart drives itself while this is on (the scenarios use it for whole laps).
19
+ autopilot: { keys: ["KeyP"] },
20
+ restart: { keys: ["KeyR"] },
21
+ },
22
+ plugins: [playtest({ events })],
23
+ display: config.display,
24
+ render: config.renderer,
25
+ scenes: { race: Race },
26
+ seed: 734,
27
+ start: "race",
28
+ });
29
+
30
+ export default game;
31
+
32
+ /**
33
+ * What the UI can ask the game to do. Intents are one-way: the UI sends `restart`, `pause` or
34
+ * `resume`, and reads the game's published state back instead of getting an answer.
35
+ */
36
+ game.ui.onIntent((intent) => {
37
+ if (intent === "restart") void game.goto("race");
38
+ if (intent === "pause") game.pause();
39
+ if (intent === "resume") game.resume();
40
+ game.state.set({
41
+ uiReady: game.ui.connected,
42
+ ...(intent === "pause" || intent === "resume" ? { paused: intent === "pause" } : {}),
43
+ });
44
+ game.state.flush();
45
+ });
@@ -0,0 +1,14 @@
1
+ import { acceptHotUpdate } from "@threenative/core/hot";
2
+ import { createElement } from "react";
3
+ import { createRoot } from "react-dom/client";
4
+ import game from "./game.js";
5
+ import { App } from "./ui/App.js";
6
+ import "./style.css";
7
+ import.meta.hot?.accept();
8
+ acceptHotUpdate(game, import.meta.hot);
9
+ const root = document.getElementById("root");
10
+ if (root === null) throw new Error("Missing #root element.");
11
+ const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
12
+ const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
13
+ appRoot.__threenativeRoot = reactRoot;
14
+ reactRoot.render(createElement(App, { game }));
@@ -0,0 +1,15 @@
1
+ type PlaytestEvent = {
2
+ readonly [key: string]: string;
3
+ readonly entity: string;
4
+ readonly name: string;
5
+ };
6
+
7
+ const pendingEvents: PlaytestEvent[] = [];
8
+
9
+ export function emitPlaytestEvent(event: PlaytestEvent): void {
10
+ pendingEvents.push(event);
11
+ }
12
+
13
+ export function drainPlaytestEvents(): PlaytestEvent[] {
14
+ return pendingEvents.splice(0);
15
+ }
@@ -0,0 +1,83 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // The chase camera, after MK64's: low behind the kart, looking a little ahead of it, the kart at
5
+ // the bottom middle of the frame. Its ground position eases toward its goal at 40% a tick and its
6
+ // height at 15% (`mk64: src/camera.c:22`, `:614-621`), so a hop or a ramp lifts the kart in the frame
7
+ // before the camera follows. It chases the direction of travel, not the nose, so in a slide the
8
+ // kart shows its angle: a camera that turned with the nose would hide the drift.
9
+ import { MathUtils, type PerspectiveCamera, Vector3 } from "three";
10
+ import type { Kart } from "../entities/Kart.js";
11
+
12
+ export const CHASE = {
13
+ /** Metres behind and above the kart, and how far ahead of it the camera looks. */
14
+ behind: 6.2,
15
+ height: 2.3,
16
+ ahead: 5,
17
+ lookHeight: 0.9,
18
+ fov: 62,
19
+ /** Share of the gap closed per 60 Hz tick: ground position, height, heading. */
20
+ follow: 0.4,
21
+ lift: 0.15,
22
+ turn: 0.12,
23
+ /** A boost pulls the camera back and widens the lens a little. */
24
+ boostFov: 8,
25
+ } as const;
26
+
27
+ export interface IChaseCamera {
28
+ update(kart: Kart, dt: number): void;
29
+ snap(kart: Kart): void;
30
+ debug(): Record<string, unknown>;
31
+ }
32
+
33
+ export function createChaseCamera(camera: PerspectiveCamera): IChaseCamera {
34
+ camera.fov = CHASE.fov;
35
+ camera.near = 0.2;
36
+ camera.far = 1200;
37
+ camera.updateProjectionMatrix();
38
+ let heading = 0;
39
+ let fov: number = CHASE.fov;
40
+ const goal = new Vector3();
41
+ const look = new Vector3();
42
+ const place = (kart: Kart, rate: (share: number) => number): void => {
43
+ // Chase the velocity's heading: in a slide the nose points in, the kart travels out.
44
+ const target = kart.velocityYaw;
45
+ heading +=
46
+ (MathUtils.euclideanModulo(target - heading + Math.PI, Math.PI * 2) - Math.PI) *
47
+ rate(CHASE.turn);
48
+ const bx = Math.sin(heading);
49
+ const bz = Math.cos(heading);
50
+ goal.set(kart.x + bx * CHASE.behind, kart.y + CHASE.height, kart.z + bz * CHASE.behind);
51
+ const k = rate(CHASE.follow);
52
+ camera.position.x += (goal.x - camera.position.x) * k;
53
+ camera.position.z += (goal.z - camera.position.z) * k;
54
+ camera.position.y += (goal.y - camera.position.y) * rate(CHASE.lift);
55
+ // Never under the road the kart is on.
56
+ camera.position.y = Math.max(camera.position.y, (kart.course.y[kart.index] ?? 0) + 1.2);
57
+ look.set(kart.x - bx * CHASE.ahead, kart.y + CHASE.lookHeight, kart.z - bz * CHASE.ahead);
58
+ camera.lookAt(look);
59
+ const boosting = kart.boostTicks > 0 || kart.miniTurboTicks > 0;
60
+ const wantFov = CHASE.fov + (boosting ? CHASE.boostFov : 0);
61
+ fov += (wantFov - fov) * rate(0.08);
62
+ if (Math.abs(camera.fov - fov) > 0.01) {
63
+ camera.fov = fov;
64
+ camera.updateProjectionMatrix();
65
+ }
66
+ };
67
+ return {
68
+ debug: () => ({ fov: camera.fov, heading, position: camera.position.toArray() }),
69
+ snap(kart) {
70
+ heading = kart.velocityYaw;
71
+ camera.position.set(
72
+ kart.x + Math.sin(heading) * CHASE.behind,
73
+ kart.y + CHASE.height,
74
+ kart.z + Math.cos(heading) * CHASE.behind,
75
+ );
76
+ place(kart, () => 1);
77
+ },
78
+ update(kart, dt) {
79
+ const ticks = dt * 60;
80
+ place(kart, (share) => 1 - (1 - share) ** ticks);
81
+ },
82
+ };
83
+ }