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,174 @@
1
+ // Generated source: the starter owns this painterly algorithm and may replace it freely.
2
+ import { HalfFloatType } from "three";
3
+ import * as tsl from "three/tsl";
4
+ import type { Node } from "three/webgpu";
5
+ import { createTextureScope } from "./textureLifetime.js";
6
+ export type KernelOffset = { readonly x: number; readonly y: number };
7
+ export interface IKuwaharaStageOptions {
8
+ readonly anisotropy?: number;
9
+ readonly radius?: number;
10
+ readonly resolutionScale?: number;
11
+ readonly strength?: number;
12
+ }
13
+ export interface IKuwaharaStage {
14
+ readonly after: "outline";
15
+ readonly build: (input: unknown) => unknown;
16
+ readonly dispose: () => void;
17
+ readonly minimumTier: "medium";
18
+ readonly name: "kuwahara";
19
+ }
20
+ function sectorSampleOffsets(radius: number): readonly KernelOffset[] {
21
+ const bounded = boundedRadius(radius);
22
+ const halfWidth = Math.floor(bounded / 2);
23
+ const offsets: KernelOffset[] = [];
24
+ for (let radial = 1; radial <= bounded; radial += 1)
25
+ for (let tangent = -halfWidth; tangent <= halfWidth; tangent += 1)
26
+ offsets.push({ x: radial, y: tangent });
27
+ return offsets;
28
+ }
29
+ export function createKuwaharaStage(options: IKuwaharaStageOptions = {}): IKuwaharaStage {
30
+ const anisotropy = finiteRange(options.anisotropy ?? 0.72, 0, 1, false, "kuwahara anisotropy");
31
+ const radius = boundedRadius(options.radius ?? 5);
32
+ const resolutionScale = finiteRange(
33
+ options.resolutionScale ?? 0.5,
34
+ 0,
35
+ 1,
36
+ true,
37
+ "kuwahara resolutionScale",
38
+ );
39
+ const strength = finiteRange(options.strength ?? 0.82, 0, 1, false, "kuwahara strength");
40
+ const textureScope = createTextureScope();
41
+ const dispose = textureScope.dispose;
42
+ return {
43
+ after: "outline",
44
+ build: (input) => {
45
+ if (!isNode(input)) throw new Error("kuwahara input is missing");
46
+ if (strength === 0) return input;
47
+ dispose();
48
+ const source = textureScope.texture(input) as unknown as ITextureNode;
49
+ const texel = tsl.screenSize.reciprocal();
50
+ const sampleUv = (x: Node<"float"> | number, y: Node<"float"> | number): Node<"vec2"> =>
51
+ tsl.screenUV.add(texel.mul(tsl.vec2(x, y))).clamp(0, 1) as Node<"vec2">;
52
+ const sampleColour = (x: number, y: number): Node<"float"> =>
53
+ tsl.luminance(source.sample(sampleUv(x, y)).rgb);
54
+ const gradientX = sampleColour(1, 0).sub(sampleColour(-1, 0)).mul(0.5);
55
+ const gradientY = sampleColour(0, 1).sub(sampleColour(0, -1)).mul(0.5);
56
+ const tensor = makeHalfFloatScratch(
57
+ textureScope,
58
+ tsl.vec4(gradientX.mul(gradientX), gradientX.mul(gradientY), gradientY.mul(gradientY), 1),
59
+ resolutionScale,
60
+ );
61
+ const tensorSample = tensor.sample(tsl.screenUV);
62
+ const orientation = tsl
63
+ .atan(tensorSample.y.mul(2), tensorSample.x.sub(tensorSample.z))
64
+ .mul(0.5);
65
+ const axis = tsl.vec2(tsl.cos(orientation), tsl.sin(orientation));
66
+ const sectorOffsets = sectorSampleOffsets(radius);
67
+ const sector = (sectorIndex: number) => {
68
+ let mean: Node<"vec3"> = tsl.vec3(0);
69
+ let secondMoment: Node<"vec3"> = tsl.vec3(0);
70
+ const angle = (sectorIndex / 8) * Math.PI * 2;
71
+ const sectorAxis = tsl.vec2(
72
+ axis.x.mul(Math.cos(angle)).sub(axis.y.mul(Math.sin(angle))),
73
+ axis.y.mul(Math.cos(angle)).add(axis.x.mul(Math.sin(angle))),
74
+ );
75
+ for (const localOffset of sectorOffsets) {
76
+ const offset = transformKernelOffsetNode(
77
+ tsl.vec2(localOffset.x, localOffset.y),
78
+ sectorAxis,
79
+ anisotropy,
80
+ );
81
+ const colour = source.sample(sampleUv(offset.x, offset.y)).rgb;
82
+ mean = mean.add(colour);
83
+ secondMoment = secondMoment.add(colour.mul(colour));
84
+ }
85
+ const average = mean.div(sectorOffsets.length);
86
+ const variance = secondMoment.div(sectorOffsets.length).sub(average.mul(average)).max(0);
87
+ return { mean: average, score: tsl.luminance(variance) };
88
+ };
89
+ let best = sector(0);
90
+ for (let sectorIndex = 1; sectorIndex < 8; sectorIndex += 1) {
91
+ const candidate = sector(sectorIndex);
92
+ const candidateWins = candidate.score.lessThan(best.score);
93
+ best = {
94
+ mean: tsl.select(candidateWins, candidate.mean, best.mean) as Node<"vec3">,
95
+ score: tsl.select(candidateWins, candidate.score, best.score) as Node<"float">,
96
+ };
97
+ }
98
+ const base = source.sample(tsl.screenUV);
99
+ const paint = makeHalfFloatScratch(
100
+ textureScope,
101
+ tsl.vec4(best.mean, base.a),
102
+ resolutionScale,
103
+ );
104
+ return mixColour(base, paint.sample(tsl.screenUV).rgb, strength);
105
+ },
106
+ dispose,
107
+ minimumTier: "medium",
108
+ name: "kuwahara",
109
+ };
110
+ }
111
+ interface ITextureNode extends Node<"vec4"> {
112
+ sample(uv: Node<"vec2">): Node<"vec4">;
113
+ }
114
+ function makeHalfFloatScratch(
115
+ scope: ReturnType<typeof createTextureScope>,
116
+ node: Node<"vec4">,
117
+ resolutionScale: number,
118
+ ): IRawScratch {
119
+ let scratch: IRawScratch | undefined;
120
+ try {
121
+ scratch = scope.own(
122
+ tsl.rtt(node, null, null, { type: HalfFloatType }) as unknown as IRawScratch,
123
+ );
124
+ scratch.setResolutionScale(resolutionScale);
125
+ } catch (error) {
126
+ scope.dispose();
127
+ throw new Error(
128
+ `kuwahara scratch allocation failed: ${error instanceof Error ? error.message : String(error)}`,
129
+ );
130
+ }
131
+ if (scratch.renderTarget.texture.type !== HalfFloatType) {
132
+ scope.dispose();
133
+ throw new Error("kuwahara scratch format is not half-float");
134
+ }
135
+ return scratch;
136
+ }
137
+ interface IRawScratch extends ITextureNode {
138
+ readonly renderTarget: { readonly texture: { readonly type: number }; dispose: () => void };
139
+ setResolutionScale(scale: number): void;
140
+ }
141
+ function transformKernelOffsetNode(
142
+ offset: Node<"vec2">,
143
+ axis: Node<"vec2">,
144
+ anisotropy: number,
145
+ ): Node<"vec2"> {
146
+ const scaled = tsl.vec2(offset.x.mul(1 + anisotropy), offset.y.mul(1 - anisotropy));
147
+ return tsl.vec2(
148
+ axis.x.mul(scaled.x).sub(axis.y.mul(scaled.y)),
149
+ axis.y.mul(scaled.x).add(axis.x.mul(scaled.y)),
150
+ );
151
+ }
152
+ function mixColour(base: Node<"vec4">, paint: Node<"vec3">, strength: number): Node<"vec4"> {
153
+ return tsl.mix(base, tsl.vec4(paint, base.a), strength) as Node<"vec4">;
154
+ }
155
+ function boundedRadius(value: number): number {
156
+ if (!Number.isInteger(value) || value < 1 || value > 9)
157
+ throw new Error("kuwahara radius must be an integer from 1 through 9");
158
+ return value;
159
+ }
160
+ function finiteRange(
161
+ value: number,
162
+ minimum: number,
163
+ maximum: number,
164
+ exclusiveMinimum: boolean,
165
+ name: string,
166
+ ): number {
167
+ const lower = exclusiveMinimum ? value <= minimum : value < minimum;
168
+ if (!Number.isFinite(value) || lower || value > maximum)
169
+ throw new Error(`${name} must be finite and in range`);
170
+ return value;
171
+ }
172
+ function isNode(value: unknown): value is Node {
173
+ return !!value && typeof value === "object" && (value as { isNode?: boolean }).isNode === true;
174
+ }
@@ -16,15 +16,18 @@ import { palette } from "./palette.js";
16
16
 
17
17
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
18
18
 
19
- export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
19
+ // Returns the key light: `WorldEnvironment`'s godrays stage raymarches against a shadow
20
+ // map, so the scene hands the sun to `setupPost` and a shadowless light is refused by name
21
+ // instead of rendering a black pass.
22
+ export function setupLighting(scene: Scene, renderer: ShadowRenderer): DirectionalLight {
20
23
  renderer.shadowMap.enabled = true;
21
24
  renderer.shadowMap.type = PCFSoftShadowMap;
22
25
 
23
26
  // Sky above, ground bounce below. Tint the second colour toward whatever the
24
27
  // floor actually is — it is the cheapest realism in the whole rig.
25
- scene.add(new HemisphereLight(palette.skyHigh, palette.skyLow, 1.6));
28
+ scene.add(new HemisphereLight(palette.skyHigh, palette.skyLow, 1.8));
26
29
 
27
- const key = new DirectionalLight(palette.accent, 3);
30
+ const key = new DirectionalLight(palette.accent, 2.4);
28
31
  key.position.set(4, 7, 3);
29
32
  key.castShadow = true;
30
33
  // 1024² is one quarter of a 2048² map's texel storage and fill work while
@@ -47,9 +50,11 @@ export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
47
50
  key.shadow.normalBias = 0.03;
48
51
  scene.add(key);
49
52
 
50
- const rim = new DirectionalLight(palette.player, 0.75);
53
+ const rim = new DirectionalLight(palette.skyHigh, 0.9);
51
54
  rim.position.set(-5, 3, -6);
52
55
  scene.add(rim);
53
56
 
54
- scene.add(new AmbientLight(palette.skyLow, 0.28));
57
+ scene.add(new AmbientLight(palette.skyLow, 0.38));
58
+
59
+ return key;
55
60
  }
@@ -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
+ /** Edit these source constants for the starter's loading look. */
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.72, height: 12, maxWidth: 520, minWidth: 1, width: 0.62 },
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
+ }
@@ -1,12 +1,47 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  // ThreeNative does not read this file.
3
- import { MeshStandardMaterial } from "three";
3
+ import { Color, DoubleSide, MeshBasicMaterial, MeshStandardMaterial, type Texture } from "three";
4
+ import { MeshBasicNodeMaterial } from "three/webgpu";
4
5
  import { palette } from "./palette.js";
5
6
 
6
7
  export function createMaterials() {
7
8
  return {
8
- floor: new MeshStandardMaterial({ color: palette.floor, roughness: 0.78, metalness: 0.12 }),
9
- player: new MeshStandardMaterial({ color: palette.player, roughness: 0.42, metalness: 0.22 }),
10
- crate: new MeshStandardMaterial({ color: palette.crate, roughness: 0.8, metalness: 0 }),
9
+ floor: new MeshStandardMaterial({ color: palette.floor, roughness: 0.9, metalness: 0 }),
10
+ player: new MeshStandardMaterial({ color: palette.player, roughness: 0.48, metalness: 0.04 }),
11
+ crate: new MeshStandardMaterial({ color: palette.crate, roughness: 0.76, metalness: 0 }),
12
+ /** The hero's hat, scarf and boots: the one warm accent on a cool coast. */
13
+ heroAccent: new MeshStandardMaterial({
14
+ color: palette.crate,
15
+ roughness: 0.6,
16
+ metalness: 0.02,
17
+ }),
18
+ /** The hero's pack, gloves, legs and visor. Reads as leather at this size. */
19
+ heroDark: new MeshStandardMaterial({ color: 0x4a4038, roughness: 0.8, metalness: 0.02 }),
20
+ // The flagpole only. The island under it is `floor`, so the far side reads as more of
21
+ // the same ground and the gap between them stays legible as a gap.
22
+ goal: new MeshStandardMaterial({ color: palette.accent, roughness: 0.45, metalness: 0.04 }),
23
+ // The columns under the ledge: lit, matte, near-black, so the drop has a below.
24
+ rock: new MeshStandardMaterial({ color: palette.skyLow, roughness: 0.98, metalness: 0 }),
25
+ // The ridge on the horizon is unlit on purpose. A standard material there takes the
26
+ // warm key like everything else and the backdrop stops being a backdrop; a flat colour
27
+ // between the two sky stops stays a silhouette from every light angle, and the scene's
28
+ // fog still fades it with distance.
29
+ ridge: new MeshBasicMaterial({ color: new Color(palette.skyLow).multiplyScalar(0.72) }),
30
+ flower: new MeshStandardMaterial({ color: palette.crate, roughness: 0.6, metalness: 0 }),
31
+ grass: new MeshStandardMaterial({ color: palette.floor, roughness: 0.95, metalness: 0 }),
32
+ grassDark: new MeshStandardMaterial({
33
+ color: new Color(palette.floor).multiplyScalar(0.58),
34
+ roughness: 0.98,
35
+ metalness: 0,
36
+ }),
37
+ sand: new MeshStandardMaterial({ color: palette.accent, roughness: 0.96, metalness: 0 }),
38
+ /** The far sandbar's beach rim: the same sand as the main island's shore. */
39
+ shore: new MeshStandardMaterial({ color: palette.accent, roughness: 0.96, metalness: 0 }),
40
+ shoreline: new MeshStandardMaterial({ color: palette.player, roughness: 0.9, metalness: 0 }),
11
41
  };
12
42
  }
43
+
44
+ /** The finish flag owns its sampled, double-sided look; SoftBody3D only drives its positions. */
45
+ export function createPennantMaterial(texture: Texture): MeshBasicNodeMaterial {
46
+ return new MeshBasicNodeMaterial({ map: texture, side: DoubleSide });
47
+ }