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,15 @@
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
+
8
+ import.meta.hot?.accept();
9
+ acceptHotUpdate(game, import.meta.hot);
10
+ const root = document.getElementById("root");
11
+ if (root === null) throw new Error("Missing #root element.");
12
+ const appRoot = root as typeof root & { __threenativeRoot?: ReturnType<typeof createRoot> };
13
+ const reactRoot = appRoot.__threenativeRoot ?? createRoot(appRoot);
14
+ appRoot.__threenativeRoot = reactRoot;
15
+ reactRoot.render(createElement(App, { game }));
@@ -0,0 +1,28 @@
1
+ // Generated for you. Framing is a game-owned decision.
2
+ import type { PerspectiveCamera } from "three";
3
+
4
+ export function setupCamera(camera: PerspectiveCamera): void {
5
+ camera.fov = 52;
6
+ camera.near = 0.1;
7
+ camera.far = 420;
8
+ camera.position.set(5.2, 2.6, 6.4);
9
+ camera.lookAt(0, 0.6, -2);
10
+ camera.updateProjectionMatrix();
11
+ }
12
+
13
+ /**
14
+ * Follow from off the starboard quarter, near the water.
15
+ *
16
+ * Held at eight up and six across the ship was a speck in the middle of an empty sea and the rig —
17
+ * the thing that makes it a ship — was too small to read at all. Low and close puts the sails
18
+ * against the sky, which is the shot this game is about.
19
+ */
20
+ export function followShip(
21
+ camera: PerspectiveCamera,
22
+ target: { x: number; y: number; z: number },
23
+ ): void {
24
+ camera.position.x = target.x + 5.2;
25
+ camera.position.y = target.y + 2.6;
26
+ camera.position.z = target.z + 6.4;
27
+ camera.lookAt(target.x, target.y + 0.9, target.z - 2.4);
28
+ }
@@ -0,0 +1,41 @@
1
+ // Generated for you. This is ordinary Three.js; tune the key and rim for your sea.
2
+ import {
3
+ AmbientLight,
4
+ DirectionalLight,
5
+ HemisphereLight,
6
+ PCFSoftShadowMap,
7
+ type Scene,
8
+ } from "three";
9
+ import { palette } from "./palette.js";
10
+
11
+ type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
12
+
13
+ export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
14
+ renderer.shadowMap.enabled = true;
15
+ renderer.shadowMap.type = PCFSoftShadowMap;
16
+ // The ground term is a muted sea blue, not the trough colour. Bounced at full saturation it
17
+ // painted the ship's shadow side the same teal as the water and the hull stopped reading as
18
+ // timber at all.
19
+ scene.add(new HemisphereLight(palette.skyLow, 0x3d6274, 1.05));
20
+
21
+ // Near-white, not the accent. A strongly tinted key contaminates the canvas, the timber and the
22
+ // sea at once, and no per-material tweak can pull them back apart.
23
+ const key = new DirectionalLight(0xfff4e0, 2.9);
24
+ key.position.set(9, 13, 5);
25
+ key.castShadow = true;
26
+ key.shadow.mapSize.set(1024, 1024);
27
+ key.shadow.camera.near = 0.5;
28
+ key.shadow.camera.far = 80;
29
+ key.shadow.camera.left = -30;
30
+ key.shadow.camera.right = 30;
31
+ key.shadow.camera.top = 30;
32
+ key.shadow.camera.bottom = -30;
33
+ key.shadow.normalBias = 0.04;
34
+ scene.add(key);
35
+
36
+ const rim = new DirectionalLight(palette.skyLow, 0.7);
37
+ rim.position.set(-8, 4, -10);
38
+ scene.add(rim);
39
+ scene.add(new AmbientLight(palette.shadow, 0.5));
40
+ return key;
41
+ }
@@ -0,0 +1,325 @@
1
+ import {
2
+ type Camera,
3
+ CanvasTexture,
4
+ ClampToEdgeWrapping,
5
+ Mesh,
6
+ MeshBasicMaterial,
7
+ type OrthographicCamera,
8
+ PlaneGeometry,
9
+ type Scene,
10
+ type Texture,
11
+ } from "three";
12
+ import { palette } from "./palette.js";
13
+
14
+ /* BEGIN THREENATIVE LOADING APPEARANCE */
15
+ /** Sailing keeps its own sea composition; all behavior is authored here. */
16
+ export const loading = {
17
+ backgroundColor: palette.skyLow,
18
+ backgroundImage: undefined as string | undefined,
19
+ enabled: true,
20
+ fillImage: undefined as string | undefined,
21
+ logoImage: undefined as string | undefined,
22
+ progressColor: palette.accent,
23
+ showStatus: false,
24
+ trackColor: palette.skyHigh,
25
+ bar: { anchorX: 0.5, anchorY: 0.7, height: 9, maxWidth: 560, minWidth: 1, width: 0.64 },
26
+ } as const;
27
+ /* END THREENATIVE LOADING APPEARANCE */
28
+
29
+ interface ILoadingHost {
30
+ readonly assets?: { texture(path: string): Promise<Texture> };
31
+ readonly camera: Camera;
32
+ readonly canvasLayer: {
33
+ readonly camera: OrthographicCamera;
34
+ readonly scene: Scene;
35
+ opaque: boolean;
36
+ };
37
+ readonly renderer: { compileAsync(scene: Scene, camera: Camera): Promise<void> };
38
+ readonly scene: Scene;
39
+ readonly startup: {
40
+ readonly progress: number;
41
+ readonly warmup?: { readonly status: "complete" | "incomplete" | "unavailable" };
42
+ whenReady(): Promise<void>;
43
+ };
44
+ readonly viewport?: {
45
+ readonly safeArea: { height: number; width: number; x: number; y: number };
46
+ };
47
+ }
48
+
49
+ interface ILoadingController {
50
+ update(): void;
51
+ finish(): void;
52
+ }
53
+
54
+ function noOp(layer: ILoadingHost["canvasLayer"]): ILoadingController {
55
+ layer.opaque = false;
56
+ return { finish: () => undefined, update: () => undefined };
57
+ }
58
+
59
+ function meshFor(
60
+ layer: ILoadingHost["canvasLayer"],
61
+ material: MeshBasicMaterial,
62
+ renderOrder: number,
63
+ ): Mesh<PlaneGeometry, MeshBasicMaterial> {
64
+ const mesh = new Mesh(new PlaneGeometry(1, 1), material);
65
+ mesh.frustumCulled = false;
66
+ mesh.renderOrder = renderOrder;
67
+ layer.scene.add(mesh);
68
+ return mesh;
69
+ }
70
+
71
+ function imageAspect(texture: Texture | null | undefined): number {
72
+ const image = texture?.image as { height?: number; width?: number } | undefined;
73
+ const width = image?.width ?? 1;
74
+ const height = image?.height ?? 1;
75
+ return width > 0 && height > 0 ? width / height : 1;
76
+ }
77
+
78
+ function configureTexture(texture: Texture): void {
79
+ texture.wrapS = ClampToEdgeWrapping;
80
+ texture.wrapT = ClampToEdgeWrapping;
81
+ texture.needsUpdate = true;
82
+ }
83
+
84
+ function setFillUv(geometry: PlaneGeometry, progress: number, base: readonly number[]): void {
85
+ const uv = geometry.getAttribute("uv");
86
+ for (let index = 0; index < uv.count; index += 1) uv.setX(index, (base[index] ?? 0) * progress);
87
+ uv.needsUpdate = true;
88
+ }
89
+
90
+ function coverUv(
91
+ geometry: PlaneGeometry,
92
+ texture: Texture,
93
+ width: number,
94
+ height: number,
95
+ baseU: readonly number[],
96
+ baseV: readonly number[],
97
+ ): void {
98
+ const imageRatio = imageAspect(texture);
99
+ const boxRatio = width / Math.max(1, height);
100
+ const visibleU = imageRatio > boxRatio ? boxRatio / imageRatio : 1;
101
+ const visibleV = imageRatio < boxRatio ? imageRatio / boxRatio : 1;
102
+ const offsetU = (1 - visibleU) / 2;
103
+ const offsetV = (1 - visibleV) / 2;
104
+ const uv = geometry.getAttribute("uv");
105
+ for (let index = 0; index < uv.count; index += 1) {
106
+ uv.setX(index, offsetU + (baseU[index] ?? 0) * visibleU);
107
+ uv.setY(index, offsetV + (baseV[index] ?? 0) * visibleV);
108
+ }
109
+ uv.needsUpdate = true;
110
+ }
111
+
112
+ function statusMesh(
113
+ layer: ILoadingHost["canvasLayer"],
114
+ ):
115
+ | { mesh: Mesh<PlaneGeometry, MeshBasicMaterial>; texture: Texture; update(value: number): void }
116
+ | undefined {
117
+ if (!loading.showStatus || typeof document === "undefined") return undefined;
118
+ const canvas = document.createElement("canvas");
119
+ canvas.width = 180;
120
+ canvas.height = 48;
121
+ const context = canvas.getContext("2d");
122
+ if (context === null) return undefined;
123
+ const texture = new CanvasTexture(canvas);
124
+ const mesh = meshFor(
125
+ layer,
126
+ new MeshBasicMaterial({ depthTest: false, depthWrite: false, map: texture, transparent: true }),
127
+ 4,
128
+ );
129
+ const update = (value: number): void => {
130
+ context.clearRect(0, 0, canvas.width, canvas.height);
131
+ context.fillStyle = "#ffffff";
132
+ context.font = "700 20px monospace";
133
+ context.textAlign = "center";
134
+ context.textBaseline = "middle";
135
+ context.fillText(`${Math.round(value * 100)}%`, canvas.width / 2, canvas.height / 2);
136
+ texture.needsUpdate = true;
137
+ };
138
+ update(0);
139
+ return { mesh, texture, update };
140
+ }
141
+
142
+ export function createLoadingScreen(host: ILoadingHost): ILoadingController {
143
+ const layer = host.canvasLayer;
144
+ if (!loading.enabled) return noOp(layer);
145
+ const camera = layer.camera;
146
+ const backdrop = meshFor(
147
+ layer,
148
+ new MeshBasicMaterial({ color: loading.backgroundColor, depthTest: false, depthWrite: false }),
149
+ 0,
150
+ );
151
+ const track = meshFor(
152
+ layer,
153
+ new MeshBasicMaterial({ color: loading.trackColor, depthTest: false, depthWrite: false }),
154
+ 1,
155
+ );
156
+ const fill = meshFor(
157
+ layer,
158
+ new MeshBasicMaterial({ color: loading.progressColor, depthTest: false, depthWrite: false }),
159
+ 2,
160
+ );
161
+ const fillBaseU = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
162
+ fill.geometry.getAttribute("uv").getX(index),
163
+ );
164
+ const fillBaseV = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
165
+ fill.geometry.getAttribute("uv").getY(index),
166
+ );
167
+ const logo =
168
+ loading.logoImage === undefined
169
+ ? undefined
170
+ : meshFor(
171
+ layer,
172
+ new MeshBasicMaterial({
173
+ color: 0xffffff,
174
+ depthTest: false,
175
+ depthWrite: false,
176
+ transparent: true,
177
+ }),
178
+ 3,
179
+ );
180
+ const status = statusMesh(layer);
181
+ const parts = [
182
+ backdrop,
183
+ track,
184
+ fill,
185
+ ...(logo === undefined ? [] : [logo]),
186
+ ...(status === undefined ? [] : [status.mesh]),
187
+ ];
188
+ const ownedTextures = new Set<Texture>(status === undefined ? [] : [status.texture]);
189
+ let width = 1;
190
+ let height = 1;
191
+ let barWidth = 1;
192
+ let barHeight: number = loading.bar.height;
193
+ let barX = 0;
194
+ let barY = 0;
195
+ let progress = 0;
196
+ let done = false;
197
+ let backdropTexture: Texture | undefined;
198
+
199
+ const layout = (): void => {
200
+ width = Math.max(1, camera.right - camera.left);
201
+ height = Math.max(1, camera.top - camera.bottom);
202
+ const safe = host.viewport?.safeArea ?? { height, width, x: 0, y: 0 };
203
+ const safeWidth = Math.max(1, Math.min(width, safe.width));
204
+ const safeHeight = Math.max(1, Math.min(height, safe.height));
205
+ const safeX = Math.max(0, Math.min(width - safeWidth, safe.x));
206
+ const safeY = Math.max(0, Math.min(height - safeHeight, safe.y));
207
+ barWidth = Math.max(2, Math.min(loading.bar.maxWidth, safeWidth * loading.bar.width));
208
+ barHeight = Math.max(2, Math.min(loading.bar.height, safeHeight * 0.05));
209
+ barX = safeX + safeWidth * loading.bar.anchorX;
210
+ barY = safeY + safeHeight * loading.bar.anchorY;
211
+ const worldX = (screenX: number): number => camera.left + screenX;
212
+ const worldY = (screenY: number): number => camera.top - screenY;
213
+ const visibleWidth = Math.max(loading.bar.minWidth, barWidth * progress);
214
+ backdrop.scale.set(width, height, 1);
215
+ backdrop.position.set(worldX(width / 2), worldY(height / 2), 0);
216
+ track.scale.set(barWidth, barHeight, 1);
217
+ track.position.set(worldX(barX), worldY(barY), 0);
218
+ fill.scale.set(visibleWidth, barHeight, 1);
219
+ fill.position.set(worldX(barX - barWidth / 2 + visibleWidth / 2), worldY(barY), 0);
220
+ if (logo?.visible) {
221
+ const logoWidth = Math.min(safeWidth * 0.42, 280);
222
+ logo.scale.set(
223
+ logoWidth,
224
+ Math.min(logoWidth / imageAspect(logo.material.map), safeHeight * 0.22),
225
+ 1,
226
+ );
227
+ logo.position.set(worldX(barX), worldY(Math.max(safeY, barY - safeHeight * 0.2)), 0);
228
+ }
229
+ if (status !== undefined) {
230
+ status.mesh.scale.set(Math.min(180, safeWidth * 0.32), 48, 1);
231
+ status.mesh.position.set(worldX(barX), worldY(Math.min(height, barY + barHeight * 2.5)), 0);
232
+ }
233
+ if (backdropTexture !== undefined)
234
+ coverUv(backdrop.geometry, backdropTexture, width, height, fillBaseU, fillBaseV);
235
+ };
236
+
237
+ const updateProgress = (value: number): void => {
238
+ const bounded = Number.isFinite(value) ? Math.max(0, Math.min(1, value)) : 0;
239
+ // A missing or incomplete backend observation cannot prove that all first-use work is done.
240
+ // Keep the bar visibly indeterminate until readiness removes the cover; never turn unknown
241
+ // coverage into a false 100% claim.
242
+ const observationUnknown =
243
+ host.startup.warmup !== undefined && host.startup.warmup.status !== "complete";
244
+ progress = observationUnknown ? Math.min(0.9, bounded) : bounded;
245
+ setFillUv(fill.geometry, progress, fillBaseU);
246
+ status?.update(progress);
247
+ layout();
248
+ };
249
+
250
+ const attachTexture = (mesh: Mesh<PlaneGeometry, MeshBasicMaterial>, texture: Texture): void => {
251
+ if (done) return;
252
+ configureTexture(texture);
253
+ mesh.material.map = texture;
254
+ mesh.material.color.set(0xffffff);
255
+ mesh.material.needsUpdate = true;
256
+ ownedTextures.add(texture);
257
+ if (mesh === backdrop) backdropTexture = texture;
258
+ layout();
259
+ updateProgress(progress);
260
+ };
261
+
262
+ const load = (source: string | undefined, mesh: Mesh<PlaneGeometry, MeshBasicMaterial>): void => {
263
+ if (source === undefined || host.assets === undefined) return;
264
+ void host.assets
265
+ .texture(source)
266
+ .then((texture) => attachTexture(mesh, texture))
267
+ .catch(() => undefined);
268
+ };
269
+ load(loading.backgroundImage, backdrop);
270
+ load(loading.fillImage, fill);
271
+ if (logo !== undefined && loading.logoImage !== undefined && host.assets !== undefined) {
272
+ void host.assets
273
+ .texture(loading.logoImage)
274
+ .then((texture) => {
275
+ if (done) return;
276
+ configureTexture(texture);
277
+ logo.material.map = texture;
278
+ logo.material.needsUpdate = true;
279
+ logo.visible = true;
280
+ ownedTextures.add(texture);
281
+ layout();
282
+ })
283
+ .catch(() => undefined);
284
+ }
285
+
286
+ layer.opaque = true;
287
+ layout();
288
+ updateProgress(0);
289
+
290
+ const finish = (): void => {
291
+ if (done) return;
292
+ done = true;
293
+ for (const mesh of parts) {
294
+ mesh.removeFromParent();
295
+ mesh.geometry.dispose();
296
+ mesh.material.dispose();
297
+ }
298
+ for (const texture of ownedTextures) texture.dispose();
299
+ layer.opaque = false;
300
+ };
301
+
302
+ void (async () => {
303
+ await host.startup.whenReady();
304
+ if (done) return;
305
+ // Prewarm the world's shaders, but do not wait for them here. `whenReady()` already means the
306
+ // world is safe to show, and compiling a lit, post-processed scene takes far longer than the
307
+ // launch window: hold the screen for it and a playtest — which advances a fixed step as fast
308
+ // as the machine allows — runs an entire scenario behind the launch screen, so every capture
309
+ // photographs the loading bar instead of the game. The prewarm still happens; it no longer
310
+ // decides when the player sees the world.
311
+ try {
312
+ void host.renderer.compileAsync(host.scene, host.camera).catch(() => undefined);
313
+ } catch {
314
+ // A renderer without compileAsync is not a reason to keep the world hidden.
315
+ }
316
+ finish();
317
+ })();
318
+
319
+ return {
320
+ finish,
321
+ update(): void {
322
+ if (!done) updateProgress(host.startup.progress);
323
+ },
324
+ };
325
+ }
@@ -0,0 +1,44 @@
1
+ // Generated for you. This file owns the sailing kit's surface decisions, and nothing in
2
+ // `props.ts` names a colour: change the ship's timber, canvas or cordage entirely from here.
3
+ import { DoubleSide, MeshBasicMaterial, MeshStandardMaterial } from "three";
4
+ import { palette } from "./palette.js";
5
+
6
+ export interface ISailingMaterials {
7
+ readonly deck: MeshStandardMaterial;
8
+ readonly hull: MeshStandardMaterial;
9
+ readonly buoy: MeshStandardMaterial;
10
+ readonly sail: MeshStandardMaterial;
11
+ readonly island: MeshStandardMaterial;
12
+ readonly horizon: MeshBasicMaterial;
13
+ /** Masts, yards, bowsprit, palm trunks. */
14
+ readonly spar: MeshStandardMaterial;
15
+ /** Standing rigging: thinner and darker than the spars, or it reads as more mast. */
16
+ readonly cordage: MeshStandardMaterial;
17
+ /** Rails, wale strakes, pennant — the ship's one saturated accent. */
18
+ readonly trim: MeshStandardMaterial;
19
+ readonly sand: MeshStandardMaterial;
20
+ readonly foliage: MeshStandardMaterial;
21
+ }
22
+
23
+ export function createMaterials(): ISailingMaterials {
24
+ return {
25
+ // Holystoned deck: pale, and clearly not the hull. One timber colour for both made the ship
26
+ // read as a single carved lump.
27
+ deck: new MeshStandardMaterial({ color: 0xd9b98a, roughness: 0.68, metalness: 0 }),
28
+ hull: new MeshStandardMaterial({ color: 0x8a5a3a, roughness: 0.72, metalness: 0.03 }),
29
+ buoy: new MeshStandardMaterial({ color: palette.accent, roughness: 0.4, metalness: 0.08 }),
30
+ sail: new MeshStandardMaterial({
31
+ color: 0xf2e7d2,
32
+ metalness: 0,
33
+ roughness: 0.95,
34
+ side: DoubleSide,
35
+ }),
36
+ island: new MeshStandardMaterial({ color: 0x4c6b45, roughness: 0.96, metalness: 0 }),
37
+ horizon: new MeshBasicMaterial({ color: palette.skyLow }),
38
+ spar: new MeshStandardMaterial({ color: 0x8a6238, roughness: 0.72, metalness: 0 }),
39
+ cordage: new MeshStandardMaterial({ color: 0x3b2c22, roughness: 0.94, metalness: 0 }),
40
+ trim: new MeshStandardMaterial({ color: 0xa33f2c, roughness: 0.6, metalness: 0.05 }),
41
+ sand: new MeshStandardMaterial({ color: 0xe4d3a6, roughness: 0.98, metalness: 0 }),
42
+ foliage: new MeshStandardMaterial({ color: 0x3f7a48, roughness: 0.94, metalness: 0 }),
43
+ };
44
+ }
@@ -0,0 +1,179 @@
1
+ // Generated for you. The sea's tuning and its entire look live in this file, and ThreeNative does
2
+ // not read it. `SpectralOcean` runs the simulation and draws nothing: the mesh, the material, the
3
+ // colours, the foam line and the tessellation are all decisions this game makes here.
4
+ //
5
+ // This replaces a two-wave `WaveField` under a `MeshBasicNodeMaterial`. Both halves of that were
6
+ // the problem. Two analytic waves plus one domain warp is a corrugated sheet — it repeats visibly
7
+ // within a boat length, and no amount of colour work hides a surface with two frequencies in it.
8
+ // And a *basic* material takes no lights at all, so the sea could not respond to the sun the rest
9
+ // of the scene is lit by: its brightness had to be hand-computed with a `pow(dot(n, sun), 30)`
10
+ // term standing in for a specular highlight. Water is one of the few surfaces where the specular
11
+ // *is* the material, so that read as plastic.
12
+ //
13
+ // A spectral ocean is cascaded wave spectra inverse-transformed on the GPU every frame, which is
14
+ // what real water is, and a standard node material puts it back under the scene's own lights.
15
+ import { type ISpectralOceanOptions, SpectralOcean } from "@threenative/core";
16
+ import { Mesh, PlaneGeometry } from "three";
17
+ import {
18
+ color,
19
+ float,
20
+ mix,
21
+ positionLocal,
22
+ positionWorld,
23
+ smoothstep,
24
+ transformNormalToView,
25
+ vec3,
26
+ } from "three/tsl";
27
+ import type { Node } from "three/webgpu";
28
+ import { MeshStandardNodeMaterial } from "three/webgpu";
29
+ import { palette } from "./palette.js";
30
+
31
+ /**
32
+ * The sea state. Every number is this game's.
33
+ *
34
+ * `windSpeed` and `amplitude` are the two to reach for: wind sets which wavelengths carry energy,
35
+ * amplitude scales the whole spectrum. `choppiness` above zero displaces horizontally as well as
36
+ * vertically, which is what sharpens a crest into something a hull can be thrown by.
37
+ */
38
+ export const SEA = {
39
+ amplitude: 0.0082,
40
+ // Largest patch first, and the bands do not overlap. One cascade is a toy — the join between
41
+ // bands is where a spectral ocean visibly fails, so there is nothing to look at until there are
42
+ // two.
43
+ cascades: [{ patchSize: 190 }, { patchSize: 37 }],
44
+ choppiness: 1.2,
45
+ directionality: 2.6,
46
+ gravity: 9.81,
47
+ // The ship reads this field on the CPU for its buoyancy and its attitude, so the copy has to
48
+ // land often enough — and be fine enough — to steer by.
49
+ //
50
+ // 32 samples across the largest patch is one height every six metres, which is coarser than the
51
+ // waves themselves: the hull then sat at a smoothed mean sea level while the drawn surface moved
52
+ // three metres either side of it, so the ship hung in the air over its own troughs and pitched
53
+ // on differences between samples that were nowhere near it. 64 halves that spacing, and the
54
+ // calmer sea state below closes the rest of the gap. This is the cost of a spectral ocean over
55
+ // an analytic one, and it is worth paying — but it has to be paid.
56
+ readbackEveryFrames: 3,
57
+ readbackResolution: 32,
58
+ resolution: 128,
59
+ seed: 20_260_906,
60
+ smallWaveCutoff: 0.32,
61
+ windDirection: 0.55,
62
+ windSpeed: 10.5,
63
+ } satisfies ISpectralOceanOptions;
64
+
65
+ /** The drawn surface's edge length in metres, and how finely it is tessellated. */
66
+ export const SURFACE = { segments: 160, size: 300 } as const;
67
+
68
+ /** Crest foam. Near-white, and not a seventh palette role: the sea's look is owned here. */
69
+ const FOAM = 0xe9f4f6;
70
+
71
+ export function createOcean(): SpectralOcean {
72
+ return new SpectralOcean(SEA);
73
+ }
74
+
75
+ /**
76
+ * Read one cascade's displacement at a world position, **bilinearly**.
77
+ *
78
+ * Nearest-texel sampling is the obvious way to write this and it is visibly wrong here. The mesh
79
+ * carries one vertex per 1.6 m while the fine cascade's texel is 0.29 m, so every vertex grabbed a
80
+ * different texel of a field it was far too coarse to resolve — and the normal, being a difference
81
+ * of two of those, came out piecewise-constant. The frame showed the sun's reflection broken into
82
+ * hard axis-aligned white rectangles, which is a sampling artefact and reads as a bug in the water.
83
+ *
84
+ * The two `mod`s are not redundant: the first is still negative for a vertex left of the origin,
85
+ * and a negative index reads whatever happens to sit behind the buffer.
86
+ */
87
+ function cascadeAt(
88
+ ocean: SpectralOcean,
89
+ index: number,
90
+ x: Node<"float">,
91
+ z: Node<"float">,
92
+ ): Node<"vec4"> {
93
+ const grid = float(ocean.resolution);
94
+ const patch = float(ocean.cascadePatchSize(index));
95
+ const buffer = ocean.cascadeDisplacement(index);
96
+ const u = x.div(patch).mul(grid);
97
+ const v = z.div(patch).mul(grid);
98
+ const u0 = u.floor();
99
+ const v0 = v.floor();
100
+ const wrap = (value: Node<"float">): Node<"float"> => value.mod(grid).add(grid).mod(grid);
101
+ const read = (cx: Node<"float">, cz: Node<"float">): Node<"vec4"> =>
102
+ buffer.element(wrap(cz).mul(grid).add(wrap(cx)).toUint()) as Node<"vec4">;
103
+ const near = mix(read(u0, v0), read(u0.add(1), v0), u.sub(u0));
104
+ const far = mix(read(u0, v0.add(1)), read(u0.add(1), v0.add(1)), u.sub(u0));
105
+ return mix(near, far, v.sub(v0)) as Node<"vec4">;
106
+ }
107
+
108
+ /** Summed displacement of both cascades at a world position. */
109
+ function displacementAt(ocean: SpectralOcean, x: Node<"float">, z: Node<"float">): Node<"vec3"> {
110
+ const broad = cascadeAt(ocean, 0, x, z);
111
+ const fine = cascadeAt(ocean, 1, x, z);
112
+ return vec3(broad.x.add(fine.x), broad.y.add(fine.y), broad.z.add(fine.z));
113
+ }
114
+
115
+ /**
116
+ * The sea surface: displaced by the simulation, and lit by the scene.
117
+ *
118
+ * The vertex stage reads the cascade buffers directly, so what is drawn is the same field the
119
+ * height query is copied from. If the two disagreed the ship would ride water nothing renders and
120
+ * every assertion in this template would still be green.
121
+ */
122
+ export function createWaterMesh(ocean: SpectralOcean): Mesh {
123
+ const geometry = new PlaneGeometry(
124
+ SURFACE.size,
125
+ SURFACE.size,
126
+ SURFACE.segments,
127
+ SURFACE.segments,
128
+ );
129
+ geometry.rotateX(-Math.PI / 2);
130
+
131
+ // Standard, not basic. This is the whole reason the sea now has a sun on it rather than a
132
+ // hand-rolled `pow()` blob: a lit material gets the scene's key light, its hemisphere fill and
133
+ // its specular response for free, and gets them consistent with the hull floating on it.
134
+ const material = new MeshStandardNodeMaterial({
135
+ metalness: 0.02,
136
+ // Not glass. At 0.08 the key light landed as one blown white disc on the swell in front of the
137
+ // camera; water this side of a dead calm scatters enough to spread that into a glitter path.
138
+ roughness: 0.29,
139
+ });
140
+
141
+ const offset = displacementAt(ocean, positionLocal.x, positionLocal.z);
142
+ material.positionNode = positionLocal.add(offset);
143
+
144
+ // Normals by central difference. Without this the surface is lit by the flat plane's normals —
145
+ // every vertex pointing straight up — and a perfectly simulated ocean shades like a sheet of
146
+ // paper.
147
+ //
148
+ // The step is the mesh's own quad size, not a texel. Differencing finer than the mesh can
149
+ // represent measures detail that is never drawn and turns the highlight into noise.
150
+ const step = float(SURFACE.size / SURFACE.segments);
151
+ const east = displacementAt(ocean, positionLocal.x.add(step), positionLocal.z);
152
+ const west = displacementAt(ocean, positionLocal.x.sub(step), positionLocal.z);
153
+ const north = displacementAt(ocean, positionLocal.x, positionLocal.z.add(step));
154
+ const south = displacementAt(ocean, positionLocal.x, positionLocal.z.sub(step));
155
+ const twice = step.mul(2);
156
+ // `transformNormalToView`, not the raw vector. `normalNode` overrides `normalView`, so a
157
+ // material handed a world-space normal lights the surface in the camera's frame instead of the
158
+ // world's: the sun's reflection stopped being a place on the sea and became a column of glare
159
+ // pointing at the camera, sliding across the water as the ship turned.
160
+ material.normalNode = transformNormalToView(
161
+ vec3(west.y.sub(east.y).div(twice), float(1), south.y.sub(north.y).div(twice)).normalize(),
162
+ );
163
+
164
+ // Colour by height: deep in the troughs, lit water on the shoulders, foam on the crests. The
165
+ // band is narrower than the wave amplitude on purpose, so the tops read as foam-lit rather than
166
+ // as a gentle gradient.
167
+ const shade = smoothstep(float(-2.4), float(1.8), positionWorld.y);
168
+ const water = mix(color(palette.floor), color(palette.accent), shade);
169
+ const crest = smoothstep(float(1.6), float(3), positionWorld.y);
170
+ material.colorNode = mix(water, color(FOAM), crest);
171
+ // Foam is not a mirror. Roughening the crests is what stops them reading as chrome.
172
+ material.roughnessNode = mix(float(0.29), float(0.82), crest);
173
+
174
+ const mesh = new Mesh(geometry, material);
175
+ mesh.receiveShadow = true;
176
+ mesh.frustumCulled = false;
177
+ mesh.name = "sea-surface";
178
+ return mesh;
179
+ }
@@ -0,0 +1,17 @@
1
+ // Generated for you. These six roles are the sailing kit's editable visual vocabulary.
2
+ // Open water at mid-morning. The values these replace put a pale cyan at the top of the sky dome
3
+ // *and* used a near-cyan accent for the wave crests, so sea and sky met at the same value and the
4
+ // frame photographed as one flat sheet with no horizon in it. Sea and sky have to disagree.
5
+ export const palette = {
6
+ /** Zenith. Properly blue, so the dome has somewhere to fall from. */
7
+ skyHigh: 0x2f6fae,
8
+ /** Horizon haze, and the fog colour. Where sea meets sky, this is the value. */
9
+ skyLow: 0x9dc2d2,
10
+ /** Deep water in the troughs. */
11
+ floor: 0x0a2c3e,
12
+ /** The sun's own colour, used for the glint on the water. */
13
+ player: 0xffe6b8,
14
+ /** Crest water: green-lit shallow, not cyan. */
15
+ accent: 0x2b8496,
16
+ shadow: 0x143243,
17
+ } as const;