create-threenative 0.2.2 → 0.2.4

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 (588) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +61 -2
  3. package/agent-docs/references/assertion-reference.md +819 -0
  4. package/agent-docs/references/capability-reference.md +4483 -0
  5. package/agent-docs/references/capture-the-frame.md +60 -0
  6. package/agent-docs/references/creating-creatures.md +215 -0
  7. package/agent-docs/references/ctx-cookbook.md +120 -0
  8. package/agent-docs/references/debug-surface.md +68 -0
  9. package/agent-docs/references/dream-loop.md +150 -0
  10. package/agent-docs/references/finding-assets.md +215 -0
  11. package/agent-docs/references/gameplay-recipes.md +54 -0
  12. package/agent-docs/references/menu-screens.md +69 -0
  13. package/agent-docs/references/mobile-memory-budget.md +87 -0
  14. package/agent-docs/references/sculpt-from-a-reference.md +40 -0
  15. package/agent-docs/references/trace-a-slow-frame.md +99 -0
  16. package/agent-docs/references/visual-baseline.md +174 -0
  17. package/agent-docs/references/webview-ui.md +113 -0
  18. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +59 -0
  19. package/agent-files/.agents/skills/prd-creator/SKILL.md +40 -0
  20. package/agent-files/.agents/skills/threenative-assets/SKILL.md +45 -0
  21. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  22. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +27 -0
  23. package/agent-files/.agents/skills/threenative-context/SKILL.md +57 -0
  24. package/agent-files/.agents/skills/threenative-performance/SKILL.md +42 -0
  25. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +44 -0
  26. package/agent-files/.agents/skills/threenative-ui/SKILL.md +20 -0
  27. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  28. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +41 -0
  29. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  30. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  31. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +59 -0
  32. package/agent-files/.claude/skills/prd-creator/SKILL.md +40 -0
  33. package/agent-files/.claude/skills/threenative-assets/SKILL.md +45 -0
  34. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +27 -0
  35. package/agent-files/.claude/skills/threenative-context/SKILL.md +57 -0
  36. package/agent-files/.claude/skills/threenative-performance/SKILL.md +42 -0
  37. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +44 -0
  38. package/agent-files/.claude/skills/threenative-ui/SKILL.md +20 -0
  39. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +41 -0
  40. package/agent-files/.threenative/agents/builder.md +32 -0
  41. package/agent-files/.threenative/agents/verifier.md +31 -0
  42. package/agent-files/AGENT-ROLES.md +26 -0
  43. package/agent-files/scripts/reference.mjs +705 -0
  44. package/agent-files/scripts/visual-loop.mjs +382 -0
  45. package/capabilities.json +5292 -0
  46. package/dist/index.d.ts +224 -3
  47. package/dist/index.js +1972 -73
  48. package/dist/threenative.d.ts +9 -2
  49. package/dist/threenative.js +2570 -176
  50. package/package.json +55 -6
  51. package/template-assets/icon.png +0 -0
  52. package/template-assets/loading.ts +325 -0
  53. package/template-assets/patches/three@0.185.1.patch +522 -0
  54. package/template-assets/worldEnvironment.ts +758 -0
  55. package/templates/action-rpg/.codex/config.toml +19 -0
  56. package/templates/action-rpg/.cursor/mcp.json +32 -0
  57. package/templates/action-rpg/.gemini/settings.json +32 -0
  58. package/templates/action-rpg/.mcp.json +18 -2
  59. package/templates/action-rpg/.vscode/mcp.json +36 -0
  60. package/templates/action-rpg/.zed/settings.json +36 -0
  61. package/templates/action-rpg/AGENTS.md +84 -29
  62. package/templates/action-rpg/CLAUDE.md +84 -29
  63. package/templates/action-rpg/index.html +0 -1
  64. package/templates/action-rpg/opencode.json +41 -0
  65. package/templates/action-rpg/package.json +15 -11
  66. package/templates/action-rpg/playtests/combat.playtest.json +32 -9
  67. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  68. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  69. package/templates/action-rpg/playtests/performance.playtest.json +39 -0
  70. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  71. package/templates/action-rpg/playtests/survives.playtest.json +27 -0
  72. package/templates/action-rpg/playtests/touch-controls.playtest.json +42 -0
  73. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  74. package/templates/action-rpg/src/conventions.ts +35 -0
  75. package/templates/action-rpg/src/entities/Enemy.ts +16 -7
  76. package/templates/action-rpg/src/entities/Player.ts +20 -3
  77. package/templates/action-rpg/src/game.ts +21 -0
  78. package/templates/action-rpg/src/render/camera.ts +7 -2
  79. package/templates/action-rpg/src/render/lighting.ts +11 -4
  80. package/templates/action-rpg/src/render/loading.ts +278 -43
  81. package/templates/action-rpg/src/render/materials.ts +11 -0
  82. package/templates/action-rpg/src/render/palette.ts +10 -3
  83. package/templates/action-rpg/src/render/postprocessing.ts +32 -16
  84. package/templates/action-rpg/src/render/quality.ts +170 -0
  85. package/templates/action-rpg/src/render/shapes.ts +185 -26
  86. package/templates/action-rpg/src/render/touch-controls.ts +185 -0
  87. package/templates/action-rpg/src/render/vfx.ts +257 -0
  88. package/templates/action-rpg/src/render/worldEnvironment.ts +758 -0
  89. package/templates/action-rpg/src/scenes/Play.ts +91 -24
  90. package/templates/action-rpg/src/state.ts +4 -0
  91. package/templates/action-rpg/src/style.css +65 -1
  92. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  93. package/templates/action-rpg/src/ui/App.tsx +9 -8
  94. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  95. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  96. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  97. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  98. package/templates/action-rpg/src/ui/main.tsx +14 -0
  99. package/templates/action-rpg/threenative.config.ts +28 -8
  100. package/templates/action-rpg/vite.config.ts +32 -2
  101. package/templates/defense/.codex/config.toml +19 -0
  102. package/templates/defense/.cursor/mcp.json +32 -0
  103. package/templates/defense/.gemini/settings.json +32 -0
  104. package/templates/defense/.mcp.json +18 -2
  105. package/templates/defense/.vscode/mcp.json +36 -0
  106. package/templates/defense/.zed/settings.json +36 -0
  107. package/templates/defense/AGENTS.md +81 -41
  108. package/templates/defense/CLAUDE.md +81 -41
  109. package/templates/defense/README.md +2 -1
  110. package/templates/defense/index.html +0 -1
  111. package/templates/defense/opencode.json +41 -0
  112. package/templates/defense/package.json +16 -12
  113. package/templates/defense/playtests/leak.playtest.json +9 -4
  114. package/templates/defense/playtests/performance.playtest.json +39 -0
  115. package/templates/defense/playtests/placement.playtest.json +5 -5
  116. package/templates/defense/playtests/pointer-placement.playtest.json +156 -0
  117. package/templates/defense/playtests/scan.playtest.json +4 -4
  118. package/templates/defense/playtests/survive.playtest.json +25 -6
  119. package/templates/defense/src/attackers/Attacker.ts +32 -16
  120. package/templates/defense/src/board/Route.ts +22 -8
  121. package/templates/defense/src/conventions.ts +18 -0
  122. package/templates/defense/src/entities/Player.ts +11 -3
  123. package/templates/defense/src/game.ts +25 -4
  124. package/templates/defense/src/physics.ts +9 -39
  125. package/templates/defense/src/placement/Buildable.ts +4 -4
  126. package/templates/defense/src/render/camera.ts +9 -3
  127. package/templates/defense/src/render/lighting.ts +6 -1
  128. package/templates/defense/src/render/loading.ts +274 -38
  129. package/templates/defense/src/render/materials.ts +9 -0
  130. package/templates/defense/src/render/palette.ts +12 -5
  131. package/templates/defense/src/render/postprocessing.ts +32 -12
  132. package/templates/defense/src/render/quality.ts +170 -0
  133. package/templates/defense/src/render/shapes.ts +180 -23
  134. package/templates/defense/src/render/sky.ts +2 -2
  135. package/templates/defense/src/render/worldEnvironment.ts +758 -0
  136. package/templates/defense/src/scenes/Boot.ts +2 -2
  137. package/templates/defense/src/scenes/Defense.ts +122 -56
  138. package/templates/defense/src/state.ts +6 -0
  139. package/templates/defense/src/style.css +65 -1
  140. package/templates/defense/src/towers/Tower.ts +11 -12
  141. package/templates/defense/src/towers/targeting.ts +1 -1
  142. package/templates/defense/src/ui/App.tsx +11 -6
  143. package/templates/defense/src/ui/GameUi.tsx +20 -0
  144. package/templates/defense/src/ui/Hud.tsx +6 -5
  145. package/templates/defense/src/ui/main.tsx +14 -0
  146. package/templates/defense/threenative.config.ts +28 -8
  147. package/templates/defense/vite.config.ts +34 -1
  148. package/templates/minimal/.codex/config.toml +19 -0
  149. package/templates/minimal/.cursor/mcp.json +32 -0
  150. package/templates/minimal/.gemini/settings.json +32 -0
  151. package/templates/minimal/.mcp.json +18 -2
  152. package/templates/minimal/.vscode/mcp.json +36 -0
  153. package/templates/minimal/.zed/settings.json +36 -0
  154. package/templates/minimal/AGENTS.md +78 -382
  155. package/templates/minimal/CLAUDE.md +78 -382
  156. package/templates/minimal/index.html +0 -1
  157. package/templates/minimal/opencode.json +41 -0
  158. package/templates/minimal/package.json +14 -11
  159. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  160. package/templates/minimal/playtests/play.playtest.json +18 -5
  161. package/templates/minimal/playtests/survives.playtest.json +48 -4
  162. package/templates/minimal/playtests/touch-controls.playtest.json +42 -0
  163. package/templates/minimal/src/conventions.ts +18 -0
  164. package/templates/minimal/src/entities/Player.ts +39 -6
  165. package/templates/minimal/src/game.ts +1 -0
  166. package/templates/minimal/src/main.ts +14 -4
  167. package/templates/minimal/src/render/camera.ts +1 -1
  168. package/templates/minimal/src/render/hud.ts +24 -8
  169. package/templates/minimal/src/render/lighting.ts +23 -2
  170. package/templates/minimal/src/render/loading.ts +23 -103
  171. package/templates/minimal/src/render/materials.ts +7 -0
  172. package/templates/minimal/src/render/palette.ts +3 -3
  173. package/templates/minimal/src/render/postprocessing.ts +55 -16
  174. package/templates/minimal/src/render/quality.ts +162 -0
  175. package/templates/minimal/src/render/sky.ts +51 -32
  176. package/templates/minimal/src/render/touch-controls.ts +165 -0
  177. package/templates/minimal/src/render/worldEnvironment.ts +758 -0
  178. package/templates/minimal/src/scenes/Play.ts +128 -14
  179. package/templates/minimal/src/state.ts +8 -1
  180. package/templates/minimal/src/style.css +20 -0
  181. package/templates/minimal/threenative.config.ts +22 -10
  182. package/templates/minimal/vite.config.ts +28 -1
  183. package/templates/platformer/.codex/config.toml +19 -0
  184. package/templates/platformer/.cursor/mcp.json +32 -0
  185. package/templates/platformer/.gemini/settings.json +32 -0
  186. package/templates/platformer/.mcp.json +18 -2
  187. package/templates/platformer/.vscode/mcp.json +36 -0
  188. package/templates/platformer/.zed/settings.json +36 -0
  189. package/templates/platformer/AGENTS.md +81 -186
  190. package/templates/platformer/CLAUDE.md +81 -186
  191. package/templates/platformer/index.html +0 -1
  192. package/templates/platformer/opencode.json +41 -0
  193. package/templates/platformer/package.json +17 -14
  194. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  195. package/templates/platformer/playtests/branding.playtest.json +29 -0
  196. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  197. package/templates/platformer/playtests/collect.playtest.json +1 -1
  198. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  199. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  200. package/templates/platformer/playtests/damage.playtest.json +4 -1
  201. package/templates/platformer/playtests/dash.playtest.json +2 -2
  202. package/templates/platformer/playtests/jump.playtest.json +2 -3
  203. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  204. package/templates/platformer/playtests/oneway.playtest.json +30 -3
  205. package/templates/platformer/playtests/performance.playtest.json +7 -5
  206. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  207. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  208. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  209. package/templates/platformer/playtests/survives.playtest.json +31 -0
  210. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +16 -4
  211. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  212. package/templates/platformer/playtests/touch-controls-web.playtest.json +57 -0
  213. package/templates/platformer/src/conventions.ts +18 -0
  214. package/templates/platformer/src/entities/Character.ts +79 -11
  215. package/templates/platformer/src/entities/Patrol.ts +5 -0
  216. package/templates/platformer/src/game.ts +27 -2
  217. package/templates/platformer/src/level/Platform.ts +13 -1
  218. package/templates/platformer/src/render/lighting.ts +13 -5
  219. package/templates/platformer/src/render/loading.ts +281 -62
  220. package/templates/platformer/src/render/palette.ts +4 -1
  221. package/templates/platformer/src/render/postprocessing.ts +42 -14
  222. package/templates/platformer/src/render/quality.ts +170 -0
  223. package/templates/platformer/src/render/touch-controls.ts +54 -36
  224. package/templates/platformer/src/render/worldEnvironment.ts +758 -0
  225. package/templates/platformer/src/scenes/Level.ts +97 -32
  226. package/templates/platformer/src/state.ts +4 -0
  227. package/templates/platformer/src/style.css +65 -1
  228. package/templates/platformer/src/ui/App.tsx +9 -4
  229. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  230. package/templates/platformer/src/ui/Hud.tsx +6 -5
  231. package/templates/platformer/src/ui/main.tsx +14 -0
  232. package/templates/platformer/threenative.config.ts +27 -10
  233. package/templates/platformer/vite.config.ts +34 -1
  234. package/templates/puzzle/.codex/config.toml +19 -0
  235. package/templates/puzzle/.cursor/mcp.json +32 -0
  236. package/templates/puzzle/.gemini/settings.json +32 -0
  237. package/templates/puzzle/.mcp.json +32 -0
  238. package/templates/puzzle/.vscode/mcp.json +36 -0
  239. package/templates/puzzle/.zed/settings.json +36 -0
  240. package/templates/puzzle/AGENTS.md +96 -0
  241. package/templates/puzzle/CLAUDE.md +98 -0
  242. package/templates/puzzle/README.md +43 -0
  243. package/templates/puzzle/index.html +12 -0
  244. package/templates/puzzle/kit.json +7 -0
  245. package/templates/puzzle/opencode.json +41 -0
  246. package/templates/puzzle/package.json +50 -0
  247. package/templates/puzzle/playtests/carry.playtest.json +71 -0
  248. package/templates/puzzle/playtests/performance.playtest.json +23 -0
  249. package/templates/puzzle/playtests/survives.playtest.json +51 -0
  250. package/templates/puzzle/playtests/swing.playtest.json +38 -0
  251. package/templates/puzzle/public/favicon.svg +5 -0
  252. package/templates/puzzle/src/conventions.ts +25 -0
  253. package/templates/puzzle/src/entities/Ball.ts +70 -0
  254. package/templates/puzzle/src/entities/Crate.ts +76 -0
  255. package/templates/puzzle/src/entities/Gripper.ts +69 -0
  256. package/templates/puzzle/src/entities/Pendulum.ts +89 -0
  257. package/templates/puzzle/src/game.ts +48 -0
  258. package/templates/puzzle/src/main.ts +15 -0
  259. package/templates/puzzle/src/physics.ts +19 -0
  260. package/templates/puzzle/src/render/camera.ts +37 -0
  261. package/templates/puzzle/src/render/lighting.ts +55 -0
  262. package/templates/puzzle/src/render/loading.ts +325 -0
  263. package/templates/puzzle/src/render/materials.ts +28 -0
  264. package/templates/puzzle/src/render/palette.ts +31 -0
  265. package/templates/puzzle/src/render/postprocessing.ts +34 -0
  266. package/templates/puzzle/src/render/quality.ts +170 -0
  267. package/templates/puzzle/src/render/shapes.ts +134 -0
  268. package/templates/puzzle/src/render/sky.ts +16 -0
  269. package/templates/puzzle/src/render/touch-controls.ts +185 -0
  270. package/templates/puzzle/src/render/worldEnvironment.ts +758 -0
  271. package/templates/puzzle/src/room.ts +83 -0
  272. package/templates/puzzle/src/scenes/Boot.ts +12 -0
  273. package/templates/puzzle/src/scenes/Puzzle.ts +158 -0
  274. package/templates/puzzle/src/state.ts +30 -0
  275. package/templates/puzzle/src/style.css +96 -0
  276. package/templates/puzzle/src/ui/App.tsx +22 -0
  277. package/templates/puzzle/src/ui/GameUi.tsx +20 -0
  278. package/templates/puzzle/src/ui/Hud.tsx +57 -0
  279. package/templates/puzzle/src/ui/Menu.tsx +7 -0
  280. package/templates/puzzle/src/ui/main.tsx +14 -0
  281. package/templates/puzzle/tailwind.config.ts +1 -0
  282. package/templates/puzzle/threenative.config.ts +49 -0
  283. package/templates/puzzle/tsconfig.json +17 -0
  284. package/templates/puzzle/vite.config.ts +38 -0
  285. package/templates/racing/.codex/config.toml +19 -0
  286. package/templates/racing/.cursor/mcp.json +32 -0
  287. package/templates/racing/.gemini/settings.json +32 -0
  288. package/templates/racing/.mcp.json +18 -2
  289. package/templates/racing/.vscode/mcp.json +36 -0
  290. package/templates/racing/.zed/settings.json +36 -0
  291. package/templates/racing/AGENTS.md +84 -36
  292. package/templates/racing/CLAUDE.md +84 -36
  293. package/templates/racing/index.html +0 -1
  294. package/templates/racing/native-playtests/survives.playtest.json +43 -0
  295. package/templates/racing/opencode.json +41 -0
  296. package/templates/racing/package.json +17 -12
  297. package/templates/racing/playtests/boost.playtest.json +5 -5
  298. package/templates/racing/playtests/outcome.playtest.json +14 -4
  299. package/templates/racing/playtests/performance.playtest.json +39 -0
  300. package/templates/racing/playtests/ranking.playtest.json +2 -2
  301. package/templates/racing/playtests/rescue.playtest.json +12 -6
  302. package/templates/racing/playtests/reverse.playtest.json +3 -3
  303. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  304. package/templates/racing/playtests/survives.playtest.json +36 -4
  305. package/templates/racing/playtests/touch-controls.playtest.json +41 -0
  306. package/templates/racing/src/conventions.ts +6 -0
  307. package/templates/racing/src/entities/RacingCar.ts +16 -4
  308. package/templates/racing/src/entities/Rival.ts +5 -2
  309. package/templates/racing/src/game.ts +24 -1
  310. package/templates/racing/src/render/camera.ts +15 -8
  311. package/templates/racing/src/render/lighting.ts +28 -14
  312. package/templates/racing/src/render/loading.ts +302 -35
  313. package/templates/racing/src/render/materials.ts +54 -4
  314. package/templates/racing/src/render/palette.ts +23 -6
  315. package/templates/racing/src/render/postprocessing.ts +32 -12
  316. package/templates/racing/src/render/quality.ts +170 -0
  317. package/templates/racing/src/render/shapes.ts +537 -26
  318. package/templates/racing/src/render/sky.ts +5 -2
  319. package/templates/racing/src/render/touch-controls.ts +185 -0
  320. package/templates/racing/src/render/worldEnvironment.ts +758 -0
  321. package/templates/racing/src/scenes/Race.ts +84 -37
  322. package/templates/racing/src/state.ts +4 -0
  323. package/templates/racing/src/style.css +65 -1
  324. package/templates/racing/src/track/Lap.ts +20 -9
  325. package/templates/racing/src/track/Ranking.ts +53 -14
  326. package/templates/racing/src/track/Track.ts +284 -32
  327. package/templates/racing/src/track/TrackSector.ts +14 -4
  328. package/templates/racing/src/ui/App.tsx +9 -4
  329. package/templates/racing/src/ui/GameUi.tsx +20 -0
  330. package/templates/racing/src/ui/Hud.tsx +6 -5
  331. package/templates/racing/src/ui/main.tsx +14 -0
  332. package/templates/racing/threenative.config.ts +28 -8
  333. package/templates/racing/vite.config.ts +34 -1
  334. package/templates/runner/.codex/config.toml +19 -0
  335. package/templates/runner/.cursor/mcp.json +32 -0
  336. package/templates/runner/.gemini/settings.json +32 -0
  337. package/templates/runner/.mcp.json +32 -0
  338. package/templates/runner/.vscode/mcp.json +36 -0
  339. package/templates/runner/.zed/settings.json +36 -0
  340. package/templates/runner/AGENTS.md +96 -0
  341. package/templates/runner/CLAUDE.md +98 -0
  342. package/templates/runner/README.md +43 -0
  343. package/templates/runner/index.html +12 -0
  344. package/templates/runner/kit.json +7 -0
  345. package/templates/runner/opencode.json +41 -0
  346. package/templates/runner/package.json +50 -0
  347. package/templates/runner/playtests/performance.playtest.json +23 -0
  348. package/templates/runner/playtests/streams.playtest.json +38 -0
  349. package/templates/runner/playtests/survives.playtest.json +51 -0
  350. package/templates/runner/public/favicon.svg +5 -0
  351. package/templates/runner/src/conventions.ts +24 -0
  352. package/templates/runner/src/entities/Runner.ts +135 -0
  353. package/templates/runner/src/game.ts +50 -0
  354. package/templates/runner/src/main.ts +15 -0
  355. package/templates/runner/src/physics.ts +13 -0
  356. package/templates/runner/src/render/camera.ts +39 -0
  357. package/templates/runner/src/render/dust.ts +131 -0
  358. package/templates/runner/src/render/lighting.ts +57 -0
  359. package/templates/runner/src/render/loading.ts +325 -0
  360. package/templates/runner/src/render/materials.ts +27 -0
  361. package/templates/runner/src/render/palette.ts +30 -0
  362. package/templates/runner/src/render/postprocessing.ts +34 -0
  363. package/templates/runner/src/render/quality.ts +170 -0
  364. package/templates/runner/src/render/shapes.ts +68 -0
  365. package/templates/runner/src/render/sky.ts +51 -0
  366. package/templates/runner/src/render/touch-controls.ts +185 -0
  367. package/templates/runner/src/render/worldEnvironment.ts +758 -0
  368. package/templates/runner/src/scenes/Boot.ts +12 -0
  369. package/templates/runner/src/scenes/Run.ts +142 -0
  370. package/templates/runner/src/state.ts +29 -0
  371. package/templates/runner/src/style.css +96 -0
  372. package/templates/runner/src/track.ts +176 -0
  373. package/templates/runner/src/ui/App.tsx +22 -0
  374. package/templates/runner/src/ui/GameUi.tsx +20 -0
  375. package/templates/runner/src/ui/Hud.tsx +55 -0
  376. package/templates/runner/src/ui/Menu.tsx +7 -0
  377. package/templates/runner/src/ui/main.tsx +14 -0
  378. package/templates/runner/tailwind.config.ts +1 -0
  379. package/templates/runner/threenative.config.ts +49 -0
  380. package/templates/runner/tsconfig.json +17 -0
  381. package/templates/runner/vite.config.ts +38 -0
  382. package/templates/sailing/.codex/config.toml +19 -0
  383. package/templates/sailing/.cursor/mcp.json +32 -0
  384. package/templates/sailing/.gemini/settings.json +32 -0
  385. package/templates/sailing/.mcp.json +32 -0
  386. package/templates/sailing/.vscode/mcp.json +36 -0
  387. package/templates/sailing/.zed/settings.json +36 -0
  388. package/templates/sailing/AGENTS.md +95 -0
  389. package/templates/sailing/CLAUDE.md +97 -0
  390. package/templates/sailing/README.md +28 -0
  391. package/templates/sailing/index.html +12 -0
  392. package/templates/sailing/kit.json +7 -0
  393. package/templates/sailing/native-playtests/float.playtest.json +55 -0
  394. package/templates/sailing/native-playtests/survives.playtest.json +38 -0
  395. package/templates/sailing/opencode.json +41 -0
  396. package/templates/sailing/package.json +52 -0
  397. package/templates/sailing/playtests/fail.playtest.json +24 -0
  398. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +75 -0
  399. package/templates/sailing/playtests/float.playtest.json +59 -0
  400. package/templates/sailing/playtests/performance.playtest.json +36 -0
  401. package/templates/sailing/playtests/survives.playtest.json +46 -0
  402. package/templates/sailing/playtests/touch-controls.playtest.json +48 -0
  403. package/templates/sailing/playtests/win.playtest.json +31 -0
  404. package/templates/sailing/public/favicon.svg +5 -0
  405. package/templates/sailing/src/conventions.ts +8 -0
  406. package/templates/sailing/src/entities/Ship.ts +233 -0
  407. package/templates/sailing/src/game.ts +40 -0
  408. package/templates/sailing/src/main.ts +15 -0
  409. package/templates/sailing/src/render/camera.ts +28 -0
  410. package/templates/sailing/src/render/lighting.ts +41 -0
  411. package/templates/sailing/src/render/loading.ts +325 -0
  412. package/templates/sailing/src/render/materials.ts +44 -0
  413. package/templates/sailing/src/render/ocean.ts +179 -0
  414. package/templates/sailing/src/render/palette.ts +17 -0
  415. package/templates/sailing/src/render/postprocessing.ts +34 -0
  416. package/templates/sailing/src/render/props.ts +602 -0
  417. package/templates/sailing/src/render/quality.ts +140 -0
  418. package/templates/sailing/src/render/sky.ts +37 -0
  419. package/templates/sailing/src/render/touch-controls.ts +142 -0
  420. package/templates/sailing/src/render/worldEnvironment.ts +758 -0
  421. package/templates/sailing/src/scenes/Boot.ts +12 -0
  422. package/templates/sailing/src/scenes/Sailing.ts +133 -0
  423. package/templates/sailing/src/state.ts +10 -0
  424. package/templates/sailing/src/style.css +81 -0
  425. package/templates/sailing/src/ui/App.tsx +15 -0
  426. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  427. package/templates/sailing/src/ui/Hud.tsx +55 -0
  428. package/templates/sailing/src/ui/Menu.tsx +30 -0
  429. package/templates/sailing/src/ui/main.tsx +7 -0
  430. package/templates/sailing/tailwind.config.ts +2 -0
  431. package/templates/sailing/threenative.config.ts +40 -0
  432. package/templates/sailing/tsconfig.json +17 -0
  433. package/templates/sailing/vite.config.ts +34 -0
  434. package/templates/shooter/.codex/config.toml +19 -0
  435. package/templates/shooter/.cursor/mcp.json +32 -0
  436. package/templates/shooter/.gemini/settings.json +32 -0
  437. package/templates/shooter/.mcp.json +18 -2
  438. package/templates/shooter/.vscode/mcp.json +36 -0
  439. package/templates/shooter/.zed/settings.json +36 -0
  440. package/templates/shooter/AGENTS.md +81 -54
  441. package/templates/shooter/CLAUDE.md +81 -54
  442. package/templates/shooter/index.html +0 -1
  443. package/templates/shooter/kit.json +2 -2
  444. package/templates/shooter/opencode.json +41 -0
  445. package/templates/shooter/package.json +16 -11
  446. package/templates/shooter/playtests/combat.playtest.json +48 -0
  447. package/templates/shooter/playtests/fail.playtest.json +5 -4
  448. package/templates/shooter/playtests/input-control.playtest.json +261 -0
  449. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  450. package/templates/shooter/playtests/performance.playtest.json +39 -0
  451. package/templates/shooter/playtests/shooter.playtest.json +31 -21
  452. package/templates/shooter/playtests/survives.playtest.json +28 -1
  453. package/templates/shooter/playtests/touch-controls.playtest.json +42 -0
  454. package/templates/shooter/playtests/weapon-cycle.playtest.json +164 -0
  455. package/templates/shooter/public/favicon.svg +1 -1
  456. package/templates/shooter/src/combat/damage.ts +1 -2
  457. package/templates/shooter/src/conventions.ts +51 -0
  458. package/templates/shooter/src/entities/Player.ts +235 -18
  459. package/templates/shooter/src/entities/Target.ts +2 -2
  460. package/templates/shooter/src/game.ts +35 -3
  461. package/templates/shooter/src/main.ts +3 -13
  462. package/templates/shooter/src/render/camera.ts +78 -18
  463. package/templates/shooter/src/render/decals.ts +211 -0
  464. package/templates/shooter/src/render/lighting.ts +13 -4
  465. package/templates/shooter/src/render/loading.ts +274 -35
  466. package/templates/shooter/src/render/materials.ts +56 -3
  467. package/templates/shooter/src/render/palette.ts +6 -3
  468. package/templates/shooter/src/render/postprocessing.ts +32 -17
  469. package/templates/shooter/src/render/quality.ts +170 -0
  470. package/templates/shooter/src/render/scale.ts +22 -0
  471. package/templates/shooter/src/render/shapes.ts +519 -60
  472. package/templates/shooter/src/render/sky.ts +5 -1
  473. package/templates/shooter/src/render/touch-controls.ts +305 -0
  474. package/templates/shooter/src/render/ui.css +119 -1
  475. package/templates/shooter/src/render/ui.ts +19 -3
  476. package/templates/shooter/src/render/vfx.ts +215 -0
  477. package/templates/shooter/src/render/worldEnvironment.ts +758 -0
  478. package/templates/shooter/src/scenes/Play.ts +385 -97
  479. package/templates/shooter/src/state.ts +18 -0
  480. package/templates/shooter/src/style.css +46 -0
  481. package/templates/shooter/src/ui/App.tsx +10 -12
  482. package/templates/shooter/src/ui/Crosshair.tsx +25 -0
  483. package/templates/shooter/src/ui/GameUi.tsx +22 -0
  484. package/templates/shooter/src/ui/Hud.tsx +14 -10
  485. package/templates/shooter/src/ui/Menu.tsx +24 -9
  486. package/templates/shooter/src/ui/main.tsx +15 -0
  487. package/templates/shooter/src/weapons/Hitscan.ts +3 -4
  488. package/templates/shooter/src/weapons/Projectile.ts +29 -13
  489. package/templates/shooter/src/weapons/Viewmodel.ts +275 -0
  490. package/templates/shooter/threenative.config.ts +28 -8
  491. package/templates/shooter/vite.config.ts +32 -2
  492. package/templates/starter/.codex/config.toml +19 -0
  493. package/templates/starter/.cursor/mcp.json +32 -0
  494. package/templates/starter/.gemini/settings.json +32 -0
  495. package/templates/starter/.mcp.json +18 -2
  496. package/templates/starter/.vscode/mcp.json +36 -0
  497. package/templates/starter/.zed/settings.json +36 -0
  498. package/templates/starter/AGENTS.md +72 -426
  499. package/templates/starter/CLAUDE.md +72 -426
  500. package/templates/starter/assets/pickup.wav +0 -0
  501. package/templates/starter/gitignore +4 -0
  502. package/templates/starter/index.html +0 -1
  503. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  504. package/templates/starter/native-playtests/render-chain.playtest.json +81 -0
  505. package/templates/starter/opencode.json +41 -0
  506. package/templates/starter/package.json +16 -12
  507. package/templates/starter/playtests/assets.playtest.json +65 -0
  508. package/templates/starter/playtests/boot-failure.playtest.json +45 -0
  509. package/templates/starter/playtests/buffer.playtest.json +59 -9
  510. package/templates/starter/playtests/cloth.playtest.json +113 -0
  511. package/templates/starter/playtests/coyote.playtest.json +60 -8
  512. package/templates/starter/playtests/forward.playtest.json +29 -4
  513. package/templates/starter/playtests/gameover.playtest.json +66 -0
  514. package/templates/starter/playtests/goal.playtest.json +67 -0
  515. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  516. package/templates/starter/playtests/look.playtest.json +142 -10
  517. package/templates/starter/playtests/models-baseline.png +0 -0
  518. package/templates/starter/playtests/models.playtest.json +74 -0
  519. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  520. package/templates/starter/playtests/odometer.playtest.json +54 -0
  521. package/templates/starter/playtests/pause.playtest.json +27 -4
  522. package/templates/starter/playtests/play.playtest.json +44 -7
  523. package/templates/starter/playtests/respawn.playtest.json +46 -6
  524. package/templates/starter/playtests/restart.playtest.json +65 -10
  525. package/templates/starter/playtests/seed.playtest.json +44 -8
  526. package/templates/starter/playtests/survives.playtest.json +48 -4
  527. package/templates/starter/playtests/textures-baseline.png +0 -0
  528. package/templates/starter/playtests/textures.playtest.json +74 -0
  529. package/templates/starter/playtests/touch-controls.playtest.json +42 -0
  530. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  531. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  532. package/templates/starter/src/conventions.ts +18 -0
  533. package/templates/starter/src/entities/Goal.ts +137 -0
  534. package/templates/starter/src/entities/Player.ts +111 -10
  535. package/templates/starter/src/game.ts +27 -0
  536. package/templates/starter/src/render/adaptiveQuality.ts +195 -0
  537. package/templates/starter/src/render/camera.ts +31 -5
  538. package/templates/starter/src/render/coast.ts +199 -0
  539. package/templates/starter/src/render/easing.ts +5 -0
  540. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  541. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  542. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  543. package/templates/starter/src/render/hero.ts +88 -0
  544. package/templates/starter/src/render/implicitSurface.ts +199 -0
  545. package/templates/starter/src/render/kuwahara.ts +174 -0
  546. package/templates/starter/src/render/lighting.ts +10 -5
  547. package/templates/starter/src/render/loading.ts +325 -0
  548. package/templates/starter/src/render/materials.ts +39 -4
  549. package/templates/starter/src/render/outline.ts +141 -0
  550. package/templates/starter/src/render/painterly.ts +86 -0
  551. package/templates/starter/src/render/palette.ts +15 -6
  552. package/templates/starter/src/render/pennant.ts +54 -0
  553. package/templates/starter/src/render/postprocessing.ts +97 -15
  554. package/templates/starter/src/render/quality.ts +185 -0
  555. package/templates/starter/src/render/rockRidge.ts +198 -0
  556. package/templates/starter/src/render/rockRidge.worker.ts +77 -0
  557. package/templates/starter/src/render/scenery.ts +40 -0
  558. package/templates/starter/src/render/shapes.ts +9 -21
  559. package/templates/starter/src/render/textureLifetime.ts +53 -0
  560. package/templates/starter/src/render/touch-controls.ts +165 -0
  561. package/templates/starter/src/render/water.ts +38 -0
  562. package/templates/starter/src/render/watercolor.ts +85 -0
  563. package/templates/starter/src/render/worldEnvironment.ts +758 -0
  564. package/templates/starter/src/scenes/Play.ts +243 -46
  565. package/templates/starter/src/state.ts +12 -0
  566. package/templates/starter/src/style.css +72 -8
  567. package/templates/starter/src/ui/App.tsx +9 -6
  568. package/templates/starter/src/ui/GameUi.tsx +20 -0
  569. package/templates/starter/src/ui/Hud.tsx +52 -29
  570. package/templates/starter/src/ui/Menu.tsx +25 -23
  571. package/templates/starter/src/ui/main.tsx +14 -0
  572. package/templates/starter/threenative.config.ts +27 -9
  573. package/templates/starter/tools/look.mjs +109 -0
  574. package/templates/starter/vite.config.ts +32 -2
  575. package/templates/action-rpg/src/physics.ts +0 -40
  576. package/templates/minimal/assets/.gitkeep +0 -0
  577. package/templates/minimal/public/.gitkeep +0 -0
  578. package/templates/minimal/public/icon.png +0 -0
  579. package/templates/platformer/assets/.gitkeep +0 -0
  580. package/templates/platformer/public/.gitkeep +0 -0
  581. package/templates/platformer/public/icon.png +0 -0
  582. package/templates/shooter/src/physics.ts +0 -49
  583. package/templates/starter/assets/.gitkeep +0 -0
  584. package/templates/starter/public/.gitkeep +0 -0
  585. package/templates/starter/public/icon.png +0 -0
  586. package/templates/starter/public/pickup.ogg +0 -0
  587. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  588. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -0,0 +1,198 @@
1
+ // Generated source. The field, seed and refinement quality belong to this game.
2
+ import { BufferAttribute, BufferGeometry, Group, type Material, Mesh } from "three";
3
+ import { auditImplicitSurface, buildImplicitSurface } from "./implicitSurface.js";
4
+ import {
5
+ type IRockRidgeWorkerInput,
6
+ type IRockRidgeWorkerMessage,
7
+ createRockRidgeWorkerSource,
8
+ } from "./rockRidge.worker.js";
9
+ // biome-ignore format: compact generated bounds keep the render source under its smell budget.
10
+ const ROCK_RIDGE_BOUNDS = { maxX: 54, maxY: 18, maxZ: -42, minX: -54, minY: -32, minZ: -74 } as const;
11
+ const PREVIEW_SETTINGS = { cellSize: 10, latticeCap: 30_000, protectBoundary: true } as const;
12
+ const REFINED_SETTINGS = { cellSize: 8, latticeCap: 100_000, protectBoundary: true } as const;
13
+ // biome-ignore format: the generated field stays within the render-source smell budget.
14
+ export function sampleGraniteField(x: number, y: number, z: number, seed: number, bounds: IRockRidgeWorkerInput["bounds"]): number {
15
+ const phase = ((seed >>> 0) % 4096) * 0.0015;
16
+ const noise = (index: number): number => {
17
+ let value = Math.imul((index | 0) ^ (seed | 0), 0x45d9f3b);
18
+ value = Math.imul(value ^ (value >>> 16), 0x45d9f3b);
19
+ return ((value ^ (value >>> 16)) >>> 0) / 4_294_967_295;
20
+ };
21
+ const smoothMin = (a: number, b: number, radius: number): number => {
22
+ const h = Math.max(radius - Math.abs(a - b), 0) / radius;
23
+ return Math.min(a, b) - h * h * h * radius / 6;
24
+ };
25
+ const centerZ = -58 + Math.sin(x * 0.08 + phase) * 1.2 + Math.cos(x * 0.17 - phase) * 0.7;
26
+ const top = -5 + Math.sin(x * 0.13 + phase * 2) * 0.8;
27
+ const contactY = -20;
28
+ const bottom = contactY - 2 + Math.cos(x * 0.07 - phase) * 0.45;
29
+ let field = Math.hypot(x / 50, (y - (top + bottom) * 0.5) / ((top - bottom) * 0.5), (z - centerZ) / 12) - 1;
30
+ for (let index = -4; index <= 4; index += 1) {
31
+ const jitter = noise(index + 31);
32
+ const lobeX = index * 11 + (jitter - 0.5) * 3;
33
+ const lobeZ = centerZ + (noise(index + 61) - 0.5) * 3;
34
+ const lobeY = -5 + (noise(index + 91) - 0.5) * 2;
35
+ const lobe = Math.hypot((x - lobeX) / (6.4 + noise(index + 121) * 2.2), (y - lobeY) / (8.5 + noise(index + 151) * 3), (z - lobeZ) / (6.5 + noise(index + 181) * 2)) - 1;
36
+ field = smoothMin(field, lobe, 0.22);
37
+ }
38
+ const edge = Math.min(x - bounds.minX, bounds.maxX - x, y - bounds.minY, bounds.maxY - y, z - bounds.minZ, bounds.maxZ - z);
39
+ return Math.max(field, 0.06 - edge / 4);
40
+ }
41
+ function hashArray(array: Float32Array | Uint32Array): string {
42
+ const bytes = new Uint8Array(array.buffer, array.byteOffset, array.byteLength);
43
+ let hash = 2_166_136_261;
44
+ for (const byte of bytes) hash = Math.imul(hash ^ byte, 16_777_619);
45
+ return (hash >>> 0).toString(16).padStart(8, "0");
46
+ }
47
+ // biome-ignore format: compact generated validation keeps the render source under its smell budget.
48
+ function topologyError(report: ReturnType<typeof auditImplicitSurface>): Error | undefined {
49
+ if (report.boundaryEdges === 0 && report.degenerateTriangles === 0 && report.windingConflicts === 0 && report.signedVolume > 0)
50
+ return undefined;
51
+ const error = new Error(`boundary=${report.boundaryEdges}, degenerate=${report.degenerateTriangles}, winding=${report.windingConflicts}, volume=${report.signedVolume}`);
52
+ error.name = "TN_ROCK_RIDGE_TOPOLOGY_INVALID";
53
+ return error;
54
+ }
55
+ // biome-ignore format: compact generated mesh attachment keeps the render source under its smell budget.
56
+ function makeMesh(result: ReturnType<typeof buildImplicitSurface>, material: Material, generation: number): { mesh: Mesh; report: ReturnType<typeof auditImplicitSurface> } {
57
+ const report = auditImplicitSurface(result.indices, result.positions);
58
+ const error = topologyError(report);
59
+ if (error !== undefined) throw error;
60
+ const geometry = new BufferGeometry();
61
+ geometry.setAttribute("position", new BufferAttribute(result.positions, 3));
62
+ geometry.setIndex(new BufferAttribute(result.indices, 1));
63
+ geometry.computeVertexNormals();
64
+ geometry.computeBoundingBox();
65
+ geometry.computeBoundingSphere();
66
+ const mesh = new Mesh(geometry, material);
67
+ mesh.name = `granite-ridge-${generation === 0 ? "preview" : "refined"}`;
68
+ mesh.castShadow = false;
69
+ mesh.receiveShadow = false;
70
+ return { mesh, report };
71
+ }
72
+ // biome-ignore format: compact generated controller contract keeps the render source under budget.
73
+ export interface IRockRidgeController { readonly object: Group; readonly state: "preview" | "refined" | "error" | "disposed"; debug(): Record<string, unknown>; dispose(): void; rebuild(seed?: number): void; }
74
+ // biome-ignore format: the controller is a single generated render source with a fixed budget.
75
+ export function createRockRidge(ridgeMaterial: Material, initialSeed: number, options: { deferRefinement?: boolean } = {}): IRockRidgeController {
76
+ const object = new Group();
77
+ object.name = "granite-ridge";
78
+ const preview = buildImplicitSurface({
79
+ ...PREVIEW_SETTINGS, bounds: ROCK_RIDGE_BOUNDS, closed: true,
80
+ sample: (x, y, z) => sampleGraniteField(x, y, z, initialSeed, ROCK_RIDGE_BOUNDS),
81
+ });
82
+ let visible = makeMesh(preview, ridgeMaterial, 0);
83
+ object.add(visible.mesh);
84
+ const state = {
85
+ phase: "preview" as IRockRidgeController["state"],
86
+ visibleGeneration: 0,
87
+ requestedGeneration: 0,
88
+ lastError: undefined as string | undefined,
89
+ report: { ...visible.report, buildMs: preview.report.buildMs, cellSize: preview.report.cellSize },
90
+ };
91
+ const workers = new Set<Worker>();
92
+ const workerSource = createRockRidgeWorkerSource(sampleGraniteField);
93
+ const stop = (worker: Worker): void => {
94
+ if (!workers.delete(worker)) return;
95
+ worker.terminate();
96
+ };
97
+ const fail = (error: unknown): void => {
98
+ state.phase = "error";
99
+ state.lastError = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
100
+ for (const worker of [...workers]) stop(worker);
101
+ };
102
+ const swap = (result: ReturnType<typeof buildImplicitSurface>, generation: number, buildMs: number, cellSize: number): void => {
103
+ const next = makeMesh(result, ridgeMaterial, generation);
104
+ const previous = visible.mesh;
105
+ object.add(next.mesh);
106
+ visible = next;
107
+ state.visibleGeneration = generation;
108
+ state.report = { ...next.report, buildMs, cellSize };
109
+ object.remove(previous);
110
+ previous.geometry.dispose();
111
+ };
112
+ const dispatch = (seed: number, settings: typeof REFINED_SETTINGS): void => {
113
+ const generation = state.requestedGeneration + 1;
114
+ state.requestedGeneration = generation;
115
+ if (typeof Worker === "undefined" || typeof URL.createObjectURL !== "function") {
116
+ const error = new Error("TN_ROCK_RIDGE_WORKER_FAILED: classic Worker support is required.");
117
+ fail(error);
118
+ throw error;
119
+ }
120
+ const url = URL.createObjectURL(new Blob([workerSource], { type: "text/javascript" }));
121
+ let worker: Worker;
122
+ try {
123
+ worker = new Worker(url);
124
+ } catch (error) {
125
+ URL.revokeObjectURL(url);
126
+ fail(error);
127
+ throw error;
128
+ }
129
+ URL.revokeObjectURL(url);
130
+ workers.add(worker);
131
+ // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: stale-result and error guards stay atomic.
132
+ worker.onmessage = (event: MessageEvent<IRockRidgeWorkerMessage>) => {
133
+ stop(worker);
134
+ const message = event.data;
135
+ if (state.phase === "disposed" || message.generation !== state.requestedGeneration) return;
136
+ if (message.error !== undefined || message.positions === undefined || message.indices === undefined || message.report === undefined) {
137
+ fail(new Error(`${message.name ?? "TN_ROCK_RIDGE_WORKER_FAILED"}: ${message.error ?? "missing result"}`));
138
+ return;
139
+ }
140
+ try {
141
+ const result = { positions: message.positions, indices: message.indices, report: message.report } as ReturnType<typeof buildImplicitSurface>;
142
+ const report = auditImplicitSurface(result.indices, result.positions);
143
+ const error = topologyError(report);
144
+ if (error !== undefined) throw error;
145
+ if (report.boundaryEdges !== message.report.boundaryEdges || report.degenerateTriangles !== message.report.degenerateTriangles || report.windingConflicts !== message.report.windingConflicts)
146
+ throw new Error("TN_ROCK_RIDGE_WORKER_FAILED: report does not match final arrays.");
147
+ swap(result, message.generation, message.report.buildMs, message.report.cellSize);
148
+ state.phase = "refined";
149
+ } catch (error) {
150
+ fail(error);
151
+ }
152
+ };
153
+ worker.onerror = (event) => {
154
+ stop(worker);
155
+ if (state.phase !== "disposed" && generation === state.requestedGeneration)
156
+ fail(new Error(`TN_ROCK_RIDGE_WORKER_FAILED: ${event.message || "worker error"}`));
157
+ };
158
+ try {
159
+ const input: IRockRidgeWorkerInput = {
160
+ bounds: ROCK_RIDGE_BOUNDS, cellSize: settings.cellSize, generation,
161
+ latticeCap: settings.latticeCap, protectBoundary: settings.protectBoundary, seed,
162
+ };
163
+ worker.postMessage(input);
164
+ } catch (error) {
165
+ stop(worker);
166
+ fail(error);
167
+ throw error;
168
+ }
169
+ };
170
+ if (options.deferRefinement !== true) dispatch(initialSeed, REFINED_SETTINGS);
171
+ return {
172
+ object,
173
+ get state() {
174
+ return state.phase;
175
+ },
176
+ debug: () => ({
177
+ state: state.phase,
178
+ generation: state.visibleGeneration,
179
+ requestedGeneration: state.requestedGeneration,
180
+ positionHash: hashArray(visible.mesh.geometry.getAttribute("position").array as Float32Array),
181
+ indexHash: hashArray(visible.mesh.geometry.index?.array as Uint32Array),
182
+ topology: state.report,
183
+ ...(state.lastError === undefined ? {} : { error: state.lastError }),
184
+ }),
185
+ dispose: () => {
186
+ if (state.phase === "disposed") return;
187
+ state.phase = "disposed";
188
+ state.requestedGeneration += 1;
189
+ for (const worker of [...workers]) stop(worker);
190
+ object.remove(visible.mesh);
191
+ visible.mesh.geometry.dispose();
192
+ },
193
+ rebuild: (seed = initialSeed) => {
194
+ if (state.phase === "disposed") return;
195
+ dispatch(seed, REFINED_SETTINGS);
196
+ },
197
+ };
198
+ }
@@ -0,0 +1,77 @@
1
+ // Generated source. The worker is a classic Blob worker so browser and native use one path.
2
+ import { createImplicitSurfaceWorkerSource } from "./implicitSurface.js";
3
+
4
+ export interface IRockRidgeWorkerInput {
5
+ readonly bounds: Readonly<Record<"maxX" | "maxY" | "maxZ" | "minX" | "minY" | "minZ", number>>;
6
+ readonly cellSize: number;
7
+ readonly generation: number;
8
+ readonly latticeCap: number;
9
+ readonly protectBoundary: boolean;
10
+ readonly seed: number;
11
+ }
12
+
13
+ export interface IRockRidgeWorkerReport {
14
+ readonly boundaryEdges: number;
15
+ readonly buildMs: number;
16
+ readonly cellSize: number;
17
+ readonly degenerateTriangles: number;
18
+ readonly signedVolume: number;
19
+ readonly triangles: number;
20
+ readonly vertices: number;
21
+ readonly windingConflicts: number;
22
+ }
23
+
24
+ export interface IRockRidgeWorkerMessage {
25
+ readonly error?: string;
26
+ readonly generation: number;
27
+ readonly indices?: Uint32Array;
28
+ readonly name?: string;
29
+ readonly positions?: Float32Array;
30
+ readonly report?: IRockRidgeWorkerReport;
31
+ }
32
+
33
+ export function createRockRidgeWorkerSource(
34
+ sampleField: (
35
+ x: number,
36
+ y: number,
37
+ z: number,
38
+ seed: number,
39
+ bounds: IRockRidgeWorkerInput["bounds"],
40
+ ) => number,
41
+ ): string {
42
+ const extractor = createImplicitSurfaceWorkerSource();
43
+ const field = sampleField.toString();
44
+ return `${extractor}
45
+ const sampleGraniteField = ${field};
46
+ self.onmessage = function (event) {
47
+ const input = event.data;
48
+ try {
49
+ const result = buildImplicitSurface({
50
+ bounds: input.bounds,
51
+ cellSize: input.cellSize,
52
+ closed: true,
53
+ latticeCap: input.latticeCap,
54
+ protectBoundary: input.protectBoundary,
55
+ sample: function (x, y, z) {
56
+ return sampleGraniteField(x, y, z, input.seed, input.bounds);
57
+ },
58
+ });
59
+ self.postMessage(
60
+ {
61
+ generation: input.generation,
62
+ indices: result.indices,
63
+ positions: result.positions,
64
+ report: result.report,
65
+ },
66
+ [result.indices.buffer, result.positions.buffer],
67
+ );
68
+ } catch (error) {
69
+ self.postMessage({
70
+ error: error instanceof Error ? error.message : String(error),
71
+ generation: input.generation,
72
+ name: error instanceof Error ? error.name : "TN_ROCK_RIDGE_WORKER_FAILED",
73
+ });
74
+ }
75
+ };
76
+ `;
77
+ }
@@ -0,0 +1,40 @@
1
+ // Generated for you. This is ordinary Three.js — edit its visual choices freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // The half of the world that has no collider. None of this is reachable and none of it
5
+ // is simulated; it is the distant silhouette behind the coastal play space.
6
+ //
7
+ // Play.enter imports and invokes createScenery, so deleting this live source without updating
8
+ // that caller breaks the build. Editing the backdrop leaves gameplay rules and colliders unchanged.
9
+ import type { Material } from "three";
10
+ import { type IRockRidgeController, createRockRidge } from "./rockRidge.js";
11
+ import { block } from "./shapes.js";
12
+
13
+ const REEF_ROCKS = [
14
+ { depth: 1.4, height: 1.35, top: -0.35, width: 1.9, x: -3.4, z: -0.5 },
15
+ { depth: 1.6, height: 1.1, top: -0.32, width: 2.1, x: 1.4, z: 0.4 },
16
+ ] as const;
17
+ /**
18
+ * @param random Seeded source for the ridge, handed in by the scene — see `src/scenes/Play.ts`,
19
+ * which builds it with the framework's `createRandom`. It arrives as an argument rather than as
20
+ * an import because nothing in this folder may import a framework package: that is what keeps
21
+ * `src/render/` portable Three.js. The seed is the scene's choice anyway.
22
+ */
23
+ export function createScenery(
24
+ rockMaterial: Material,
25
+ ridgeMaterial: Material,
26
+ random: () => number,
27
+ ): IRockRidgeController {
28
+ const ridgeSeed = Math.floor(random() * 4_294_967_295) >>> 0;
29
+ const scenery = createRockRidge(ridgeMaterial, ridgeSeed, { deferRefinement: true });
30
+ for (const { depth, height, top, width, x, z } of REEF_ROCKS) {
31
+ const rock = block(width, height, depth, rockMaterial, {
32
+ castShadow: false,
33
+ radius: 0.3,
34
+ receiveShadow: false,
35
+ });
36
+ rock.position.set(x, top - height / 2, z);
37
+ scenery.object.add(rock);
38
+ }
39
+ return scenery;
40
+ }
@@ -19,7 +19,6 @@ import {
19
19
  MathUtils,
20
20
  Mesh,
21
21
  SphereGeometry,
22
- TorusKnotGeometry,
23
22
  Vector3,
24
23
  } from "three";
25
24
  import { mergeVertices } from "three/addons/utils/BufferGeometryUtils.js";
@@ -125,23 +124,12 @@ export function spike(
125
124
  return shadowed(new Mesh(geometry, material), options);
126
125
  }
127
126
 
128
- /** A smooth prop for the starter scene. */
129
- export function sculpture(material: Material): Mesh {
130
- // 128 × 24 is 6,144 triangles. The old 500 × 100 mesh pushed 100k triangles
131
- // through the colour, shadow and bloom passes for no visible gain.
132
- const geometry = new TorusKnotGeometry(1.35, 0.38, 128, 24);
133
- return shadowed(new Mesh(geometry, material), {});
134
- }
135
-
136
- /**
137
- * Deterministic PRNG. Never Math.random: the world has to be byte-identical on
138
- * every reload or a screenshot diff means nothing and you cannot tell a bug
139
- * from a reroll.
140
- */
141
- export function makeRandom(seed = 1337): () => number {
142
- let state = seed >>> 0;
143
- return () => {
144
- state = (state * 1664525 + 1013904223) >>> 0;
145
- return state / 4294967296;
146
- };
147
- }
127
+ // A hand-rolled seeded PRNG used to live here, and it was a line-for-line copy of the
128
+ // `createRandom` the framework already exports — same multiplier, same increment, same
129
+ // sequence. It is gone. Nothing in this folder may import a framework package (that is what
130
+ // keeps `src/render/` portable Three.js), so a scene builds the seeded source and hands it
131
+ // down: see `createScenery` below and its caller in `src/scenes/Play.ts`.
132
+ //
133
+ // Never `Math.random` for anything the world is built from. The world has to be byte-identical
134
+ // on every reload or a screenshot diff cannot tell a bug from a reroll, and `ctx.random` is
135
+ // what a playtest reads to prove the level was seeded at all.
@@ -0,0 +1,53 @@
1
+ import { convertToTexture } from "three/tsl";
2
+ import type { Node } from "three/webgpu";
3
+
4
+ interface ITextureResource {
5
+ readonly isRTTNode: true;
6
+ readonly renderTarget: { dispose(): void };
7
+ readonly _quadMesh: { material: { dispose(): void } };
8
+ }
9
+
10
+ function hasRttMarker(value: unknown): value is { readonly isRTTNode: true } {
11
+ return (
12
+ typeof value === "object" &&
13
+ value !== null &&
14
+ (value as { isRTTNode?: unknown }).isRTTNode === true
15
+ );
16
+ }
17
+
18
+ function isTextureResource(value: unknown): value is ITextureResource {
19
+ if (!hasRttMarker(value)) return false;
20
+ const resource = value as {
21
+ renderTarget?: { dispose?: unknown } | null;
22
+ _quadMesh?: { material?: { dispose?: unknown } } | null;
23
+ };
24
+ return (
25
+ typeof resource.renderTarget?.dispose === "function" &&
26
+ typeof resource._quadMesh?.material?.dispose === "function"
27
+ );
28
+ }
29
+
30
+ /** Owns only RTT nodes created by this stage; ordinary and shared texture nodes remain external. */
31
+ export function createTextureScope() {
32
+ const owned = new Set<ITextureResource>();
33
+ return {
34
+ texture(input: Node): Node {
35
+ const output = convertToTexture(input);
36
+ if (output !== input && hasRttMarker(output)) this.own(output);
37
+ return output;
38
+ },
39
+ own<T>(newRtt: T): T {
40
+ if (!isTextureResource(newRtt))
41
+ throw new Error("texture scope requires a disposable RTTNode.");
42
+ owned.add(newRtt);
43
+ return newRtt;
44
+ },
45
+ dispose(): void {
46
+ for (const resource of owned) {
47
+ resource.renderTarget.dispose();
48
+ resource._quadMesh.material.dispose();
49
+ }
50
+ owned.clear();
51
+ },
52
+ };
53
+ }
@@ -0,0 +1,165 @@
1
+ import {
2
+ CircleGeometry,
3
+ type ColorRepresentation,
4
+ Group,
5
+ MathUtils,
6
+ Mesh,
7
+ MeshBasicMaterial,
8
+ type PerspectiveCamera,
9
+ RingGeometry,
10
+ Vector2,
11
+ } from "three";
12
+ import { palette } from "./palette.js";
13
+
14
+ const MOVE_RADIUS = 72;
15
+ const BUTTON_RADIUS = 62;
16
+ const EDGE = 36;
17
+
18
+ export interface ITouchPointer {
19
+ readonly position: Vector2;
20
+ }
21
+
22
+ export interface ITouchViewport {
23
+ readonly height: number;
24
+ readonly width: number;
25
+ }
26
+
27
+ export interface ITouchInput {
28
+ readonly jumpPressed: boolean;
29
+ readonly move: Vector2;
30
+ }
31
+
32
+ function overlayMaterial(color: ColorRepresentation, opacity: number): MeshBasicMaterial {
33
+ return new MeshBasicMaterial({
34
+ color,
35
+ depthTest: false,
36
+ depthWrite: false,
37
+ opacity,
38
+ transparent: true,
39
+ });
40
+ }
41
+
42
+ function ringMesh(radius: number, material: MeshBasicMaterial): Mesh {
43
+ return new Mesh(new RingGeometry(radius - 5, radius, 32), material);
44
+ }
45
+
46
+ function place(mesh: Mesh, point: Vector2): void {
47
+ mesh.position.set(point.x, point.y, 0);
48
+ }
49
+
50
+ function controlPoint(size: ITouchViewport, name: "jump" | "move"): Vector2 {
51
+ if (name === "move") return new Vector2(MOVE_RADIUS + EDGE, size.height - MOVE_RADIUS - EDGE);
52
+ return new Vector2(size.width - BUTTON_RADIUS - EDGE, size.height - BUTTON_RADIUS - EDGE);
53
+ }
54
+
55
+ export class TouchControls {
56
+ readonly root = new Group();
57
+ readonly object = this.root;
58
+ #camera: PerspectiveCamera;
59
+ #input: { jumpPressed: boolean; move: Vector2 } = {
60
+ jumpPressed: false,
61
+ move: new Vector2(),
62
+ };
63
+ #wasJump = false;
64
+ #moveAnchor = new Vector2();
65
+ #resting = new Vector2();
66
+ #jumpCenter = new Vector2();
67
+ #hasMoveAnchor = false;
68
+ #lastWidth = -1;
69
+ #lastHeight = -1;
70
+ #moveBase: Mesh;
71
+ #moveKnob: Mesh;
72
+ #jump: Mesh;
73
+ #idleMaterial: MeshBasicMaterial;
74
+ #activeMaterial: MeshBasicMaterial;
75
+
76
+ constructor(camera: PerspectiveCamera) {
77
+ this.#camera = camera;
78
+ this.#idleMaterial = overlayMaterial(palette.floor, 0.34);
79
+ this.#activeMaterial = overlayMaterial(palette.accent, 0.6);
80
+ this.#moveBase = ringMesh(MOVE_RADIUS, this.#idleMaterial);
81
+ this.#moveKnob = new Mesh(new CircleGeometry(28, 24), this.#activeMaterial);
82
+ this.#jump = ringMesh(BUTTON_RADIUS, this.#idleMaterial);
83
+ this.root.add(this.#moveBase, this.#moveKnob, this.#jump);
84
+ this.root.renderOrder = 10_001;
85
+ camera.add(this.root);
86
+ }
87
+
88
+ update(pointers: ReadonlyMap<number, ITouchPointer>, size: ITouchViewport): ITouchInput {
89
+ this.#ensureLayout(size);
90
+ const jump = this.#at(pointers, this.#jumpCenter, BUTTON_RADIUS);
91
+ let movement: ITouchPointer | undefined;
92
+ for (const pointer of pointers.values()) {
93
+ if (pointer.position.x < size.width * 0.5) {
94
+ movement = pointer;
95
+ break;
96
+ }
97
+ }
98
+
99
+ if (movement === undefined) {
100
+ this.#hasMoveAnchor = false;
101
+ this.#input.move.set(0, 0);
102
+ } else {
103
+ if (!this.#hasMoveAnchor) {
104
+ this.#moveAnchor.copy(movement.position);
105
+ this.#hasMoveAnchor = true;
106
+ }
107
+ this.#input.move.set(
108
+ MathUtils.clamp((movement.position.x - this.#moveAnchor.x) / MOVE_RADIUS, -1, 1),
109
+ MathUtils.clamp((this.#moveAnchor.y - movement.position.y) / MOVE_RADIUS, -1, 1),
110
+ );
111
+ }
112
+
113
+ const center = this.#hasMoveAnchor ? this.#moveAnchor : this.#resting;
114
+ place(
115
+ this.#moveKnob,
116
+ new Vector2(
117
+ center.x + this.#input.move.x * MOVE_RADIUS,
118
+ center.y - this.#input.move.y * MOVE_RADIUS,
119
+ ),
120
+ );
121
+ this.#jump.material = jump ? this.#activeMaterial : this.#idleMaterial;
122
+ this.#input.jumpPressed = jump && !this.#wasJump;
123
+ this.#wasJump = jump;
124
+ this.#layout(size);
125
+ return this.#input;
126
+ }
127
+
128
+ debug(): Record<string, unknown> {
129
+ return { jump: this.#wasJump, move: this.#input.move.toArray() };
130
+ }
131
+
132
+ dispose(): void {
133
+ this.root.removeFromParent();
134
+ for (const child of this.root.children) {
135
+ if (child instanceof Mesh) child.geometry.dispose();
136
+ }
137
+ this.#idleMaterial.dispose();
138
+ this.#activeMaterial.dispose();
139
+ }
140
+
141
+ #ensureLayout(size: ITouchViewport): void {
142
+ if (size.width === this.#lastWidth && size.height === this.#lastHeight) return;
143
+ this.#lastWidth = size.width;
144
+ this.#lastHeight = size.height;
145
+ this.#resting.copy(controlPoint(size, "move"));
146
+ this.#jumpCenter.copy(controlPoint(size, "jump"));
147
+ }
148
+
149
+ #layout(size: ITouchViewport): void {
150
+ const worldHeight = 2 * Math.tan(MathUtils.degToRad(this.#camera.fov / 2));
151
+ const pixels = worldHeight / Math.max(1, size.height);
152
+ this.root.position.set(-(size.width * pixels) / 2, worldHeight / 2, -1);
153
+ this.root.scale.set(pixels, -pixels, 1);
154
+ place(this.#moveBase, this.#hasMoveAnchor ? this.#moveAnchor : this.#resting);
155
+ place(this.#jump, this.#jumpCenter);
156
+ }
157
+
158
+ #at(pointers: ReadonlyMap<number, ITouchPointer>, center: Vector2, radius: number): boolean {
159
+ const radiusSquared = radius * radius;
160
+ for (const pointer of pointers.values()) {
161
+ if (pointer.position.distanceToSquared(center) <= radiusSquared) return true;
162
+ }
163
+ return false;
164
+ }
165
+ }
@@ -0,0 +1,38 @@
1
+ // Generated for you: this is the starter's game-owned water look.
2
+ // The WaveField itself is framework plumbing; these colours, highlights and opacity are yours.
3
+ import { DoubleSide } from "three";
4
+ import { color, float, mix, normalize, smoothstep, vec3 } from "three/tsl";
5
+ import { MeshBasicNodeMaterial } from "three/webgpu";
6
+ import type { Node } from "three/webgpu";
7
+ import { palette } from "./palette.js";
8
+
9
+ export interface IWaveDisplacementSource {
10
+ displacementNode(): Node;
11
+ heightNode(): Node<"float">;
12
+ normalNode(): Node<"vec3">;
13
+ }
14
+
15
+ const SUN = normalize(vec3(0.45, 0.82, 0.3));
16
+
17
+ /** Water with broad colour bands and a narrow sun glint that survives the painterly grade. */
18
+ export function createWaterMaterial(source: IWaveDisplacementSource): MeshBasicNodeMaterial {
19
+ const water = new MeshBasicNodeMaterial({
20
+ depthWrite: false,
21
+ opacity: 0.94,
22
+ side: DoubleSide,
23
+ transparent: true,
24
+ });
25
+ water.positionNode = source.displacementNode();
26
+
27
+ const height = source.heightNode();
28
+ const normal = source.normalNode();
29
+ const facing = normal.dot(SUN).clamp(0, 1);
30
+ const troughToCrest = smoothstep(-0.26, 0.26, height);
31
+ const waterMid = mix(color(palette.skyLow), color(palette.skyHigh), 0.35);
32
+ const body = mix(color(palette.skyLow), waterMid, troughToCrest.mul(0.16).add(0.42));
33
+ const litBody = body.mul(mix(float(0.92), float(1), facing));
34
+ const glint = color(palette.skyHigh).mul(facing.pow(48).mul(0.07));
35
+ const crestFoam = color(palette.player).mul(smoothstep(0.16, 0.26, height).mul(0.025));
36
+ water.colorNode = litBody.add(glint).add(crestFoam);
37
+ return water;
38
+ }