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
@@ -3,15 +3,20 @@
3
3
  "target": "web",
4
4
  "schemaVersion": 1,
5
5
  "viewport": {
6
- "width": 1280,
7
- "height": 720
6
+ "width": 1920,
7
+ "height": 1080
8
8
  },
9
- "warmupFrames": 10,
9
+ "warmupFrames": 60,
10
10
  "steps": [
11
11
  {
12
12
  "kind": "input",
13
13
  "press": "ArrowRight",
14
- "holdFrames": 120,
14
+ "holdTicks": 60,
15
+ "release": true
16
+ },
17
+ {
18
+ "kind": "wait",
19
+ "waitTicks": 600,
15
20
  "release": true
16
21
  }
17
22
  ],
@@ -27,6 +32,14 @@
27
32
  "entity": "hud"
28
33
  }
29
34
  ],
30
- "performance": {}
35
+ "performance": {
36
+ "maxDrawCalls": 48,
37
+ "maxFrameMsP95": 33,
38
+ "maxTriangles": 6200,
39
+ "minFps": 30
40
+ },
41
+ "renderChain": {
42
+ "tier": "high"
43
+ }
31
44
  }
32
45
  }
@@ -2,12 +2,26 @@
2
2
  "name": "survives",
3
3
  "target": "web",
4
4
  "schemaVersion": 1,
5
- "viewport": { "width": 1280, "height": 720 },
5
+ "viewport": {
6
+ "width": 1280,
7
+ "height": 720
8
+ },
6
9
  "warmupFrames": 10,
7
10
  "subject": "player",
8
11
  "steps": [
9
- { "kind": "input", "label": "move", "press": "ArrowUp", "holdTicks": 60, "release": true },
10
- { "kind": "wait", "label": "settle", "waitTicks": 10, "release": true }
12
+ {
13
+ "kind": "input",
14
+ "label": "move",
15
+ "press": "ArrowUp",
16
+ "holdTicks": 60,
17
+ "release": true
18
+ },
19
+ {
20
+ "kind": "wait",
21
+ "label": "settle",
22
+ "waitTicks": 10,
23
+ "release": true
24
+ }
11
25
  ],
12
26
  "assert": {
13
27
  "diagnostics": {
@@ -16,7 +30,37 @@
16
30
  "noRuntimeDiagnostics": true,
17
31
  "runtimeReady": true
18
32
  },
19
- "movement": { "entity": "player", "minDistance": 0.5 },
33
+ "components": [
34
+ {
35
+ "entity": "player",
36
+ "component": "groundCorrectionEnabled",
37
+ "equals": false,
38
+ "allowTrivial": "The disabled correction is intentional while its measurement remains live."
39
+ },
40
+ {
41
+ "entity": "player",
42
+ "component": "groundClearance",
43
+ "lte": 0,
44
+ "allowTrivial": "The authored pose is intentionally below the floor so clearance stays observable."
45
+ },
46
+ {
47
+ "entity": "player",
48
+ "component": "normaliseFactor",
49
+ "allowTrivial": "The figure is authored taller than the template's 1.1 m convention and normalised down, so the retained factor is below one; either side of one proves normaliseToMetres ran in generated source.",
50
+ "lte": 0.99
51
+ }
52
+ ],
53
+ "movement": {
54
+ "entity": "player",
55
+ "minDistance": 0.5
56
+ },
57
+ "visibility": [
58
+ {
59
+ "entity": "touch-controls",
60
+ "present": false,
61
+ "allowTrivial": "Desktop keyboard lanes intentionally omit touch controls while movement proves the scene is active."
62
+ }
63
+ ],
20
64
  "visual": [
21
65
  {
22
66
  "region": {
@@ -0,0 +1,42 @@
1
+ {
2
+ "name": "minimal-touch-controls",
3
+ "schemaVersion": 1,
4
+ "target": "web",
5
+ "viewport": { "width": 1280, "height": 720 },
6
+ "warmupFrames": 10,
7
+ "subject": "player",
8
+ "steps": [
9
+ {
10
+ "kind": "input",
11
+ "label": "movement-anchor",
12
+ "pointers": [{ "id": 7, "x": 0.18, "y": 0.75 }],
13
+ "holdTicks": 2,
14
+ "release": false
15
+ },
16
+ {
17
+ "kind": "input",
18
+ "label": "move-right",
19
+ "pointers": [{ "id": 7, "x": 0.38, "y": 0.75 }],
20
+ "holdTicks": 45,
21
+ "release": true
22
+ },
23
+ { "kind": "wait", "label": "settled", "waitTicks": 10, "release": true }
24
+ ],
25
+ "assert": {
26
+ "diagnostics": {
27
+ "noConsoleErrors": true,
28
+ "noNetworkErrors": true,
29
+ "noRuntimeDiagnostics": true,
30
+ "runtimeReady": true
31
+ },
32
+ "movement": { "entity": "player", "minDistance": 0.1 },
33
+ "resources": [{ "id": "state", "path": "playerX", "changed": true }],
34
+ "visibility": [
35
+ {
36
+ "entity": "touch-controls",
37
+ "present": true,
38
+ "allowTrivial": "Touch-primary lanes keep the authored controls visible while state assertions prove they are live."
39
+ }
40
+ ]
41
+ }
42
+ }
@@ -0,0 +1,18 @@
1
+ import { GroundSnap, normaliseToMetres } from "@threenative/core";
2
+ import type { Mesh } from "three";
3
+
4
+ export interface IMinimalConventions {
5
+ readonly applyGrounding: (surfaceY: number, dt: number) => void;
6
+ readonly groundSnap: GroundSnap;
7
+ readonly normaliseFactor: number;
8
+ }
9
+
10
+ export function preparePlayerConventions(model: Mesh): IMinimalConventions {
11
+ const normaliseFactor = normaliseToMetres(model, { axis: "height", metres: 1.1 });
12
+ const groundSnap = new GroundSnap(model, { enabled: false });
13
+ return {
14
+ applyGrounding: (surfaceY, dt) => groundSnap.apply(model, surfaceY, dt),
15
+ groundSnap,
16
+ normaliseFactor,
17
+ };
18
+ }
@@ -1,7 +1,9 @@
1
1
  import type { ICtx } from "@threenative/core";
2
2
  import { CharacterBody3D, CollisionShape3D, type IPhysicsContext } from "@threenative/physics";
3
- import { BoxGeometry, Mesh } from "three";
4
- import { defaultMaterial } from "../render/materials.js";
3
+ import { BoxGeometry, Group, Mesh } from "three";
4
+ import { type IMinimalConventions, preparePlayerConventions } from "../conventions.js";
5
+ import { accentMaterial, defaultMaterial } from "../render/materials.js";
6
+ import type { ITouchInput } from "../render/touch-controls.js";
5
7
  import type { GameState } from "../state.js";
6
8
 
7
9
  type GameCtx = ICtx<GameState, IPhysicsContext>;
@@ -13,16 +15,37 @@ const MOVE_SPEED = 2;
13
15
  const SPAWN = { x: -2, y: 0.5, z: 0 } as const;
14
16
 
15
17
  export class Player {
16
- readonly mesh = new Mesh(new BoxGeometry(0.6, 1, 0.6), defaultMaterial);
18
+ readonly mesh: Group;
19
+ readonly visual: Mesh;
17
20
  readonly body: CharacterBody3D;
21
+ #conventions: IMinimalConventions;
18
22
  #coyoteTime = 0;
19
23
  #jumpBuffer = 0;
20
24
  #jumps = 0;
21
25
  #coyoteJumps = 0;
22
26
 
23
27
  constructor(ctx: GameCtx) {
28
+ this.mesh = new Group();
29
+ // A figure, not a cube. Three boxes is still minimal, and it gives the player a front — which
30
+ // is the whole difference between "a character" and "the scene's placeholder".
31
+ this.visual = new Mesh(new BoxGeometry(0.46, 0.56, 0.34), defaultMaterial);
32
+ this.visual.castShadow = true;
33
+ const head = new Mesh(new BoxGeometry(0.34, 0.3, 0.3), defaultMaterial);
34
+ head.position.y = 0.42;
35
+ head.castShadow = true;
36
+ this.visual.add(head);
37
+ const visor = new Mesh(new BoxGeometry(0.26, 0.08, 0.04), accentMaterial);
38
+ visor.position.set(0, 0.44, -0.16);
39
+ this.visual.add(visor);
40
+ for (const side of [-1, 1]) {
41
+ const leg = new Mesh(new BoxGeometry(0.15, 0.34, 0.2), accentMaterial);
42
+ leg.position.set(side * 0.12, -0.44, 0);
43
+ leg.castShadow = true;
44
+ this.visual.add(leg);
45
+ }
46
+ this.mesh.add(this.visual);
24
47
  this.mesh.position.set(SPAWN.x, SPAWN.y, SPAWN.z);
25
- this.mesh.castShadow = true;
48
+ this.#conventions = preparePlayerConventions(this.visual);
26
49
  ctx.add(this.mesh);
27
50
  this.body = new CharacterBody3D({
28
51
  autostep: { maxHeight: 0.4, minWidth: 0.2 },
@@ -32,11 +55,12 @@ export class Player {
32
55
  });
33
56
  }
34
57
 
35
- update(ctx: GameCtx, dt: number): void {
58
+ update(ctx: GameCtx, dt: number, touch?: ITouchInput): void {
36
59
  this.#coyoteTime = Math.max(0, this.#coyoteTime - dt);
37
60
  this.#jumpBuffer = Math.max(0, this.#jumpBuffer - dt);
38
61
  if (this.body.grounded) this.#coyoteTime = COYOTE_TIME;
39
- if (ctx.input.justPressed("jump")) this.#jumpBuffer = JUMP_BUFFER;
62
+ if (ctx.input.justPressed("jump") || touch?.jumpPressed === true)
63
+ this.#jumpBuffer = JUMP_BUFFER;
40
64
  if (this.#jumpBuffer > 0 && this.#coyoteTime > 0) {
41
65
  this.body.velocity.y = JUMP_SPEED;
42
66
  this.#jumpBuffer = 0;
@@ -45,16 +69,25 @@ export class Player {
45
69
  this.#coyoteJumps += 1;
46
70
  }
47
71
  const move = ctx.input.vector("move");
72
+ if (touch !== undefined) {
73
+ move.x += touch.move.x;
74
+ move.y += touch.move.y;
75
+ move.clampLength(0, 1);
76
+ }
48
77
  this.body.velocity.x = move.x * MOVE_SPEED;
49
78
  this.body.velocity.z = -move.y * MOVE_SPEED;
50
79
  this.body.moveAndSlide(dt);
80
+ this.#conventions.applyGrounding(0, dt);
51
81
  }
52
82
 
53
83
  debug(): Record<string, unknown> {
54
84
  return {
55
85
  coyoteJumps: this.#coyoteJumps,
56
86
  grounded: this.body.grounded,
87
+ groundClearance: this.#conventions.groundSnap.clearance,
88
+ groundCorrectionEnabled: this.#conventions.groundSnap.enabled,
57
89
  jumps: this.#jumps,
90
+ normaliseFactor: this.#conventions.normaliseFactor,
58
91
  position: this.mesh.position.toArray(),
59
92
  };
60
93
  }
@@ -20,6 +20,7 @@ const game = defineGame<GameState, IPhysicsContext>({
20
20
  // `playtest()` installs the bridge a scenario needs to observe entities and state. Without
21
21
  // it, semantic assertions fail closed with TN_PLAYTEST_BRIDGE_MISSING rather than passing.
22
22
  plugins: [rapier(), playtest()],
23
+ display: config.display,
23
24
  render: config.renderer,
24
25
  scenes: { play: Play },
25
26
  start: "play",
@@ -11,7 +11,17 @@ if (app === null) throw new Error("Missing #app element.");
11
11
 
12
12
  import.meta.hot?.accept();
13
13
  acceptHotUpdate(game, import.meta.hot);
14
- void game.start().then(() => {
15
- const canvas = game.ctx?.renderer.domElement;
16
- if (canvas !== undefined) app.prepend(canvas);
17
- });
14
+ void game
15
+ .start()
16
+ .then(() => {
17
+ const canvas = game.ctx?.renderer.domElement;
18
+ if (canvas !== undefined) app.prepend(canvas);
19
+ })
20
+ .catch((error: unknown) => {
21
+ const failure = document.createElement("div");
22
+ failure.id = "threenative-canvas-error";
23
+ failure.dataset.threenativeCanvasError = "true";
24
+ failure.setAttribute("role", "alert");
25
+ failure.textContent = error instanceof Error ? error.message : String(error);
26
+ app.replaceChildren(failure);
27
+ });
@@ -4,7 +4,7 @@ import type { PerspectiveCamera } from "three";
4
4
  export function setupCamera(camera: PerspectiveCamera): void {
5
5
  camera.fov = 54;
6
6
  camera.near = 0.1;
7
- camera.far = 100;
7
+ camera.far = 20_000;
8
8
  camera.position.set(0, 3, 9);
9
9
  camera.lookAt(0, 1, 0);
10
10
  camera.updateProjectionMatrix();
@@ -8,7 +8,19 @@ const GLYPHS =
8
8
  .split(" ")
9
9
  .map((hex) => BigInt(`0x${hex}`));
10
10
 
11
- export function createHud(camera: PerspectiveCamera, primaryLabel: string, counterLabel: string) {
11
+ type HudValues = { counter?: number; primary: number; seconds: number };
12
+
13
+ function formatHudText(primaryLabel: string, counterLabel: string | undefined, values: HudValues) {
14
+ const minutes = String(Math.floor(values.seconds / 60)).padStart(2, "0");
15
+ const seconds = String(Math.floor(values.seconds % 60)).padStart(2, "0");
16
+ const lines = [`${primaryLabel} ${Math.max(0, Math.round(values.primary))}`];
17
+ if (counterLabel !== undefined && values.counter !== undefined)
18
+ lines.push(`${counterLabel} ${Math.max(0, Math.round(values.counter))}`);
19
+ lines.push(`TIME ${minutes}:${seconds}`);
20
+ return lines.join("\n");
21
+ }
22
+
23
+ export function createHud(camera: PerspectiveCamera, primaryLabel: string, counterLabel?: string) {
12
24
  const material = new MeshBasicMaterial({
13
25
  color: palette.player,
14
26
  depthTest: false,
@@ -21,10 +33,16 @@ export function createHud(camera: PerspectiveCamera, primaryLabel: string, count
21
33
  camera.add(root);
22
34
  return {
23
35
  glyphs: 0,
24
- update(values: { counter: number; primary: number; seconds: number }): void {
25
- const minutes = String(Math.floor(values.seconds / 60)).padStart(2, "0");
26
- const seconds = String(Math.floor(values.seconds % 60)).padStart(2, "0");
27
- const text = `${primaryLabel} ${Math.max(0, Math.round(values.primary))}\n${counterLabel} ${Math.max(0, Math.round(values.counter))}\nTIME ${minutes}:${seconds}`;
36
+ update(values: HudValues): void {
37
+ // The HUD changes at most once a second, but update runs per frame — skip the glyph
38
+ // rebuild and the instance upload when the text is unchanged. Placement still recomputes:
39
+ // a resize moves the anchor even when the text has not changed.
40
+ const text = formatHudText(primaryLabel, counterLabel, values);
41
+ const height = 2 * Math.tan(MathUtils.degToRad(camera.fov / 2));
42
+ root.position.set(-height * camera.aspect * 0.46, height * 0.42, -1);
43
+ root.scale.setScalar(height / 160);
44
+ if (text === this.lastText) return;
45
+ this.lastText = text;
28
46
  let instance = 0;
29
47
  for (const [y, line] of text.split("\n").entries()) {
30
48
  for (let x = 0; x < line.length; x += 1) {
@@ -40,10 +58,8 @@ export function createHud(camera: PerspectiveCamera, primaryLabel: string, count
40
58
  }
41
59
  root.count = this.glyphs = instance;
42
60
  root.instanceMatrix.needsUpdate = true;
43
- const height = 2 * Math.tan(MathUtils.degToRad(camera.fov / 2));
44
- root.position.set(-height * camera.aspect * 0.46, height * 0.42, -1);
45
- root.scale.setScalar(height / 160);
46
61
  },
62
+ lastText: "",
47
63
  dispose(): void {
48
64
  root.removeFromParent();
49
65
  root.geometry.dispose();
@@ -5,23 +5,40 @@
5
5
  // back light, silhouettes read as flat cut-outs against the background.
6
6
  import {
7
7
  AmbientLight,
8
+ Color,
8
9
  DirectionalLight,
9
10
  HemisphereLight,
10
11
  PCFSoftShadowMap,
11
12
  type Scene,
13
+ Vector3,
12
14
  } from "three";
13
15
  import { palette } from "./palette.js";
14
16
 
15
17
  type ShadowRenderer = { shadowMap: { enabled: boolean; type: number } };
18
+ type AtmosphereLike = {
19
+ getSunDirection(target?: Vector3): Vector3;
20
+ sunTransmittance(direction: Vector3): unknown;
21
+ };
16
22
 
17
- export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
23
+ export function setupLighting(
24
+ scene: Scene,
25
+ renderer: ShadowRenderer,
26
+ atmosphere?: AtmosphereLike,
27
+ ): { key: DirectionalLight; updateSun(direction: Vector3): void } {
18
28
  renderer.shadowMap.enabled = true;
19
29
  renderer.shadowMap.type = PCFSoftShadowMap;
20
30
 
21
31
  scene.add(new HemisphereLight(palette.skyHigh, palette.shadow, 1.6));
22
32
 
23
33
  const key = new DirectionalLight(palette.accent, 3);
24
- key.position.set(4, 7, 3);
34
+ const updateSun = (direction: Vector3): void => {
35
+ key.position.copy(direction).multiplyScalar(7);
36
+ const transmittance = atmosphere?.sunTransmittance(direction);
37
+ if (transmittance instanceof Vector3) {
38
+ key.color.copy(new Color().setRGB(transmittance.x, transmittance.y, transmittance.z));
39
+ }
40
+ };
41
+ updateSun(atmosphere?.getSunDirection() ?? new Vector3(4, 7, 3).normalize());
25
42
  key.castShadow = true;
26
43
  // 1024² keeps the default shadow pass at one quarter of a 2048² map's
27
44
  // texel storage and fill work. The small generated scene fits this 12-unit
@@ -43,4 +60,8 @@ export function setupLighting(scene: Scene, renderer: ShadowRenderer): void {
43
60
  scene.add(rim);
44
61
 
45
62
  scene.add(new AmbientLight(palette.shadow, 0.28));
63
+ // The key light travels with the sun updater: `WorldEnvironment`'s godrays stage raymarches
64
+ // against its shadow map, so `setupPost` needs the light itself and refuses a shadowless one
65
+ // by name instead of rendering a black pass.
66
+ return { key, updateSun };
46
67
  }
@@ -1,113 +1,33 @@
1
- import {
2
- type Camera,
3
- Mesh,
4
- MeshBasicMaterial,
5
- type OrthographicCamera,
6
- PlaneGeometry,
7
- type Scene,
8
- } from "three";
9
- import { palette } from "./palette.js";
10
-
11
- /**
12
- * What the framework hands a loading screen. Structural on purpose: nothing under `src/render/`
13
- * imports the framework, and `ctx` already satisfies this shape.
14
- */
15
- export interface LoadingHost {
1
+ import type { Camera, OrthographicCamera, Scene } from "three";
2
+
3
+ /** Minimal deliberately opts out; changing this one source value enables a full authored cover. */
4
+ export const loading = {
5
+ backgroundImage: undefined as string | undefined,
6
+ enabled: false,
7
+ fillImage: undefined as string | undefined,
8
+ logoImage: undefined as string | undefined,
9
+ progressColor: 0xffd27a,
10
+ trackColor: 0x14516e,
11
+ } as const;
12
+
13
+ interface LoadingHost {
16
14
  readonly camera: Camera;
17
- readonly scene: Scene;
18
15
  readonly canvasLayer: {
19
16
  readonly camera: OrthographicCamera;
20
17
  readonly scene: Scene;
21
18
  opaque: boolean;
22
19
  };
23
- readonly renderer: { compileAsync(scene: Scene, camera: Camera): Promise<void> };
24
- readonly startup: { readonly progress: number; whenReady(): Promise<void> };
20
+ readonly viewport?: {
21
+ readonly safeArea: {
22
+ readonly height: number;
23
+ readonly width: number;
24
+ readonly x: number;
25
+ readonly y: number;
26
+ };
27
+ };
25
28
  }
26
29
 
27
- /**
28
- * Draws the loading screen in the framework's pixel-sized canvas layer. Colours, layout, and the
29
- * shape of the bar live here in generated source, so they remain the game's to change or delete.
30
- */
31
30
  export function createLoadingScreen(host: LoadingHost) {
32
- const layer = host.canvasLayer;
33
- const camera = layer.camera;
34
- const cover = (color: number, renderOrder: number) => {
35
- const mesh = new Mesh(
36
- new PlaneGeometry(1, 1),
37
- new MeshBasicMaterial({ color, depthTest: false, depthWrite: false }),
38
- );
39
- mesh.frustumCulled = false;
40
- mesh.renderOrder = renderOrder;
41
- layer.scene.add(mesh);
42
- return mesh;
43
- };
44
- const backdrop = cover(palette.skyLow, 0);
45
- const track = cover(palette.skyHigh, 1);
46
- const fill = cover(palette.accent, 2);
47
- const parts = [backdrop, track, fill];
48
- layer.opaque = true;
49
-
50
- let width = 0;
51
- let height = 0;
52
- let lastProgress = 0;
53
-
54
- const layout = (): void => {
55
- const nextWidth = camera.right - camera.left;
56
- const nextHeight = camera.top - camera.bottom;
57
- width = Number.isFinite(nextWidth) && nextWidth > 0 ? nextWidth : 1;
58
- height = Number.isFinite(nextHeight) && nextHeight > 0 ? nextHeight : 1;
59
- backdrop.scale.set(width, height, 1);
60
- track.scale.set(width * 0.5, height * 0.012, 1);
61
- track.position.set(0, -height * 0.05, 0);
62
- fill.position.set(0, -height * 0.05, 0);
63
- };
64
-
65
- const setProgress = (progress: number): void => {
66
- // `Math.max(0, Math.min(1, NaN))` is NaN, so non-finite progress means no progress.
67
- lastProgress = Number.isFinite(progress) ? Math.max(0, Math.min(1, progress)) : 0;
68
- const full = width * 0.5;
69
- const barWidth = Math.max(full * 0.002, full * lastProgress);
70
- fill.scale.set(barWidth, height * 0.012, 1);
71
- fill.position.x = -full / 2 + barWidth / 2;
72
- };
73
-
74
- let laidOutWidth = camera.right - camera.left;
75
- let laidOutHeight = camera.top - camera.bottom;
76
- layout();
77
- setProgress(0);
78
-
79
- let done = false;
80
- const finish = (): void => {
81
- if (done) return;
82
- done = true;
83
- for (const mesh of parts) {
84
- mesh.removeFromParent();
85
- mesh.geometry.dispose();
86
- mesh.material.dispose();
87
- }
88
- layer.opaque = false;
89
- };
90
-
91
- void (async () => {
92
- await host.startup.whenReady();
93
- // Compile the collapsed world's pipelines while the opaque canvas layer still covers it.
94
- await host.renderer.compileAsync(host.scene, host.camera).catch(() => undefined);
95
- finish();
96
- })();
97
-
98
- return {
99
- update(): void {
100
- if (done) return;
101
- const nextWidth = camera.right - camera.left;
102
- const nextHeight = camera.top - camera.bottom;
103
- if (nextWidth !== laidOutWidth || nextHeight !== laidOutHeight) {
104
- laidOutWidth = nextWidth;
105
- laidOutHeight = nextHeight;
106
- layout();
107
- setProgress(lastProgress);
108
- }
109
- setProgress(host.startup.progress);
110
- },
111
- finish,
112
- };
31
+ host.canvasLayer.opaque = false;
32
+ return { finish: () => undefined, update: () => undefined };
113
33
  }
@@ -9,6 +9,13 @@ export const floorMaterial = new MeshStandardMaterial({
9
9
  metalness: 0.12,
10
10
  });
11
11
 
12
+ /** The player's visor and boots: the one warm note against a cool morning. */
13
+ export const accentMaterial = new MeshStandardMaterial({
14
+ color: palette.accent,
15
+ roughness: 0.6,
16
+ metalness: 0.05,
17
+ });
18
+
12
19
  export const defaultMaterial = new MeshStandardMaterial({
13
20
  color: palette.player,
14
21
  roughness: 0.52,
@@ -1,9 +1,9 @@
1
1
  // Generated for you. Keep these six roles coherent when you change the look.
2
2
  export const palette = {
3
3
  skyHigh: 0x14516e,
4
- skyLow: 0x071018,
5
- floor: 0x12384a,
4
+ skyLow: 0x1b3a4e,
5
+ floor: 0x27566b,
6
6
  player: 0x6fe8ff,
7
7
  accent: 0xffd27a,
8
- shadow: 0x10232d,
8
+ shadow: 0x24414f,
9
9
  } as const;
@@ -1,20 +1,59 @@
1
- // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
- // ThreeNative does not read this file.
3
- import { ACESFilmicToneMapping, type Camera, type Scene } from "three";
4
- import { bloom } from "three/addons/tsl/display/BloomNode.js";
5
- import { pass } from "three/tsl";
1
+ // Generated for you: ordinary Three.js; ThreeNative does not read this file.
2
+ //
3
+ // This file wires two things together and decides nothing itself. `quality.ts`, in this folder,
4
+ // owns which stages run at which tier and records what each one measured. `WorldEnvironment`,
5
+ // also in this folder, builds them and prints `TN_WORLD_ENVIRONMENT` naming every stage as
6
+ // applied or refused **with a reason**, so a stage that silently no-op'd is never mistaken for
7
+ // one you turned off.
8
+ //
9
+ // To make the game cheaper or prettier everywhere, edit `quality.ts`. To force one tier for one
10
+ // run — a desktop that is dropping frames, a capture you want to compare — pass it:
11
+ // `setupPost(renderer, scene, camera, { tier: "low" })`. Overriding does not silence the report:
12
+ // `TN_QUALITY_TIER` names the tier that ran either way.
13
+ import type { Camera, DirectionalLight, Scene } from "three";
14
+ import { vec3 } from "three/tsl";
15
+ import type { Node } from "three/webgpu";
16
+ import { type QualityTier, qualityPreset, resolveQualityTier } from "./quality.js";
17
+ import type { OutputRenderer } from "./worldEnvironment.js";
18
+ import { WorldEnvironment } from "./worldEnvironment.js";
6
19
 
7
- type OutputRenderer = {
8
- kind: string;
9
- raw: unknown;
10
- setOutputNode(node: unknown): void;
20
+ type AtmosphereLike = {
21
+ aerialPerspective(scenePass: unknown, depth: unknown, inScatteredRadiance?: unknown): unknown;
22
+ radiance(direction: unknown): unknown;
11
23
  };
12
24
 
13
- export function setupPost(renderer: OutputRenderer, scene: Scene, camera: Camera): void {
14
- const raw = renderer.raw as { toneMapping?: number; toneMappingExposure?: number };
15
- raw.toneMapping = ACESFilmicToneMapping;
16
- raw.toneMappingExposure = 1.15;
17
- if (renderer.kind !== "webgpu") return;
18
- const colour = pass(scene, camera).getTextureNode();
19
- renderer.setOutputNode(colour.add(bloom(colour, 0.5, 0.5, 0.2)));
25
+ export function setupPost(
26
+ renderer: OutputRenderer,
27
+ scene: Scene,
28
+ camera: Camera,
29
+ environment: {
30
+ atmosphere?: AtmosphereLike;
31
+ godraysLight?: DirectionalLight;
32
+ mobile?: boolean;
33
+ /** Forces a tier, ignoring `mobile`. An unknown name throws rather than falling back. */
34
+ tier?: QualityTier;
35
+ } = {},
36
+ ): void {
37
+ const tier = resolveQualityTier({ mobile: environment.mobile, tier: environment.tier });
38
+ const source = environment.tier === undefined ? "platform" : "override";
39
+ console.info(`TN_QUALITY_TIER ${tier} mobile=${environment.mobile === true} source=${source}`);
40
+ const world = new WorldEnvironment(qualityPreset(tier));
41
+ const atmosphere = environment.atmosphere;
42
+ world.apply(renderer, scene, camera, {
43
+ // The chain builds the scene pass, so aerial perspective — which needs that pass and its
44
+ // view-Z — is composed here, first, before exposure and before any stage. Delete this
45
+ // property to drop aerial perspective while keeping the sky and the rest of the chain.
46
+ baseColour:
47
+ atmosphere === undefined
48
+ ? undefined
49
+ : (scenePass) =>
50
+ atmosphere.aerialPerspective(
51
+ scenePass,
52
+ scenePass.getViewZNode(),
53
+ // Same scale as the dome in sky.ts, and for the same reason: this radiance is
54
+ // mixed into every pixel by the haze term, so at 24 it lifted the whole frame.
55
+ (atmosphere.radiance(vec3(0, 0, 1)) as Node<"vec3">).mul(1.5),
56
+ ) as Node<"vec4">,
57
+ godraysLight: environment.godraysLight,
58
+ });
20
59
  }