create-threenative 0.2.1 → 0.2.3

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 (343) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +10 -2
  3. package/agent-docs/asset-mcp-loop.md +33 -0
  4. package/agent-docs/ctx-surface.md +69 -0
  5. package/agent-docs/engine-capabilities.md +4 -0
  6. package/agent-docs/framework-blocks-you.md +60 -0
  7. package/agent-docs/look-at-it-and-budget-the-look.md +27 -0
  8. package/agent-docs/performance-default.md +42 -0
  9. package/agent-docs/pixel-budget.md +20 -0
  10. package/agent-docs/playtest-fail-closed.md +23 -0
  11. package/agent-docs/references/assertion-reference.md +652 -0
  12. package/agent-docs/references/capability-reference.md +3279 -0
  13. package/agent-docs/references/capture-the-frame.md +53 -0
  14. package/agent-docs/references/ctx-cookbook.md +51 -0
  15. package/agent-docs/references/debug-surface.md +63 -0
  16. package/agent-docs/references/finding-assets.md +147 -0
  17. package/agent-docs/references/gameplay-recipes.md +54 -0
  18. package/agent-docs/references/menu-screens.md +69 -0
  19. package/agent-docs/references/mobile-memory-budget.md +87 -0
  20. package/agent-docs/references/sculpt-from-a-reference.md +39 -0
  21. package/agent-docs/references/visual-baseline.md +133 -0
  22. package/agent-docs/references/webview-ui.md +113 -0
  23. package/agent-docs/sculpt-loop.md +16 -0
  24. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  25. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  26. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  27. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  28. package/agent-files/.threenative/agents/builder.md +32 -0
  29. package/agent-files/.threenative/agents/verifier.md +31 -0
  30. package/agent-files/AGENT-ROLES.md +26 -0
  31. package/capabilities.json +3542 -0
  32. package/dist/index.d.ts +191 -3
  33. package/dist/index.js +1707 -73
  34. package/dist/threenative.d.ts +9 -2
  35. package/dist/threenative.js +1825 -148
  36. package/package.json +30 -6
  37. package/template-assets/loading.ts +315 -0
  38. package/template-assets/patches/three@0.185.1.patch +287 -0
  39. package/templates/action-rpg/.codex/config.toml +15 -0
  40. package/templates/action-rpg/.mcp.json +6 -2
  41. package/templates/action-rpg/AGENTS.md +370 -6
  42. package/templates/action-rpg/CLAUDE.md +370 -6
  43. package/templates/action-rpg/index.html +0 -1
  44. package/templates/action-rpg/package.json +15 -11
  45. package/templates/action-rpg/playtests/combat.playtest.json +23 -9
  46. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  47. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  48. package/templates/action-rpg/playtests/performance.playtest.json +22 -0
  49. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  50. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  51. package/templates/action-rpg/public/icon.png +0 -0
  52. package/templates/action-rpg/src/entities/Enemy.ts +14 -4
  53. package/templates/action-rpg/src/game.ts +21 -0
  54. package/templates/action-rpg/src/render/lighting.ts +6 -1
  55. package/templates/action-rpg/src/render/loading.ts +267 -42
  56. package/templates/action-rpg/src/render/postprocessing.ts +68 -15
  57. package/templates/action-rpg/src/render/worldEnvironment.ts +583 -0
  58. package/templates/action-rpg/src/scenes/Play.ts +49 -19
  59. package/templates/action-rpg/src/state.ts +4 -0
  60. package/templates/action-rpg/src/style.css +45 -1
  61. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  62. package/templates/action-rpg/src/ui/App.tsx +9 -8
  63. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  64. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  65. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  66. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  67. package/templates/action-rpg/src/ui/main.tsx +14 -0
  68. package/templates/action-rpg/threenative.config.ts +21 -8
  69. package/templates/action-rpg/vite.config.ts +32 -2
  70. package/templates/defense/.codex/config.toml +15 -0
  71. package/templates/defense/.mcp.json +6 -2
  72. package/templates/defense/AGENTS.md +371 -8
  73. package/templates/defense/CLAUDE.md +371 -8
  74. package/templates/defense/README.md +2 -1
  75. package/templates/defense/index.html +0 -1
  76. package/templates/defense/package.json +16 -12
  77. package/templates/defense/playtests/leak.playtest.json +9 -4
  78. package/templates/defense/playtests/performance.playtest.json +22 -0
  79. package/templates/defense/playtests/placement.playtest.json +5 -5
  80. package/templates/defense/playtests/pointer-placement.playtest.json +89 -0
  81. package/templates/defense/playtests/scan.playtest.json +3 -3
  82. package/templates/defense/playtests/survive.playtest.json +11 -6
  83. package/templates/defense/public/icon.png +0 -0
  84. package/templates/defense/src/attackers/Attacker.ts +28 -12
  85. package/templates/defense/src/game.ts +24 -2
  86. package/templates/defense/src/render/lighting.ts +6 -1
  87. package/templates/defense/src/render/loading.ts +263 -37
  88. package/templates/defense/src/render/postprocessing.ts +70 -13
  89. package/templates/defense/src/render/shapes.ts +38 -0
  90. package/templates/defense/src/render/worldEnvironment.ts +583 -0
  91. package/templates/defense/src/scenes/Defense.ts +109 -50
  92. package/templates/defense/src/state.ts +6 -0
  93. package/templates/defense/src/style.css +45 -1
  94. package/templates/defense/src/ui/App.tsx +9 -4
  95. package/templates/defense/src/ui/GameUi.tsx +20 -0
  96. package/templates/defense/src/ui/Hud.tsx +6 -5
  97. package/templates/defense/src/ui/main.tsx +14 -0
  98. package/templates/defense/threenative.config.ts +21 -8
  99. package/templates/defense/vite.config.ts +34 -1
  100. package/templates/minimal/.codex/config.toml +15 -0
  101. package/templates/minimal/.mcp.json +6 -2
  102. package/templates/minimal/AGENTS.md +360 -255
  103. package/templates/minimal/CLAUDE.md +360 -255
  104. package/templates/minimal/index.html +0 -1
  105. package/templates/minimal/package.json +14 -11
  106. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  107. package/templates/minimal/playtests/play.playtest.json +17 -5
  108. package/templates/minimal/public/icon.png +0 -0
  109. package/templates/minimal/src/game.ts +1 -0
  110. package/templates/minimal/src/render/camera.ts +1 -1
  111. package/templates/minimal/src/render/hud.ts +24 -8
  112. package/templates/minimal/src/render/lighting.ts +23 -2
  113. package/templates/minimal/src/render/loading.ts +23 -103
  114. package/templates/minimal/src/render/postprocessing.ts +92 -14
  115. package/templates/minimal/src/render/sky.ts +37 -32
  116. package/templates/minimal/src/render/worldEnvironment.ts +583 -0
  117. package/templates/minimal/src/scenes/Play.ts +91 -13
  118. package/templates/minimal/src/state.ts +8 -1
  119. package/templates/minimal/threenative.config.ts +15 -10
  120. package/templates/minimal/vite.config.ts +28 -1
  121. package/templates/platformer/.codex/config.toml +15 -0
  122. package/templates/platformer/.mcp.json +6 -2
  123. package/templates/platformer/AGENTS.md +385 -130
  124. package/templates/platformer/CLAUDE.md +385 -130
  125. package/templates/platformer/index.html +0 -1
  126. package/templates/platformer/package.json +17 -14
  127. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  128. package/templates/platformer/playtests/branding.playtest.json +29 -0
  129. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  130. package/templates/platformer/playtests/collect.playtest.json +1 -1
  131. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  132. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  133. package/templates/platformer/playtests/damage.playtest.json +4 -1
  134. package/templates/platformer/playtests/dash.playtest.json +2 -2
  135. package/templates/platformer/playtests/jump.playtest.json +2 -3
  136. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  137. package/templates/platformer/playtests/oneway.playtest.json +1 -1
  138. package/templates/platformer/playtests/performance.playtest.json +6 -5
  139. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  140. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  141. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  142. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +13 -4
  143. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  144. package/templates/platformer/playtests/touch-controls-web.playtest.json +46 -0
  145. package/templates/platformer/public/icon.png +0 -0
  146. package/templates/platformer/src/entities/Character.ts +16 -10
  147. package/templates/platformer/src/entities/Patrol.ts +5 -0
  148. package/templates/platformer/src/game.ts +24 -1
  149. package/templates/platformer/src/render/lighting.ts +6 -1
  150. package/templates/platformer/src/render/loading.ts +270 -61
  151. package/templates/platformer/src/render/postprocessing.ts +68 -15
  152. package/templates/platformer/src/render/touch-controls.ts +54 -36
  153. package/templates/platformer/src/render/worldEnvironment.ts +583 -0
  154. package/templates/platformer/src/scenes/Level.ts +47 -22
  155. package/templates/platformer/src/state.ts +4 -0
  156. package/templates/platformer/src/style.css +45 -1
  157. package/templates/platformer/src/ui/App.tsx +9 -4
  158. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  159. package/templates/platformer/src/ui/Hud.tsx +6 -5
  160. package/templates/platformer/src/ui/main.tsx +14 -0
  161. package/templates/platformer/threenative.config.ts +20 -10
  162. package/templates/platformer/vite.config.ts +34 -1
  163. package/templates/racing/.codex/config.toml +15 -0
  164. package/templates/racing/.mcp.json +6 -2
  165. package/templates/racing/AGENTS.md +370 -6
  166. package/templates/racing/CLAUDE.md +370 -6
  167. package/templates/racing/index.html +0 -1
  168. package/templates/racing/package.json +16 -12
  169. package/templates/racing/playtests/boost.playtest.json +5 -5
  170. package/templates/racing/playtests/outcome.playtest.json +14 -4
  171. package/templates/racing/playtests/performance.playtest.json +22 -0
  172. package/templates/racing/playtests/ranking.playtest.json +2 -2
  173. package/templates/racing/playtests/rescue.playtest.json +12 -6
  174. package/templates/racing/playtests/reverse.playtest.json +3 -3
  175. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  176. package/templates/racing/public/icon.png +0 -0
  177. package/templates/racing/src/game.ts +24 -1
  178. package/templates/racing/src/render/camera.ts +10 -6
  179. package/templates/racing/src/render/lighting.ts +6 -1
  180. package/templates/racing/src/render/loading.ts +291 -34
  181. package/templates/racing/src/render/postprocessing.ts +70 -13
  182. package/templates/racing/src/render/worldEnvironment.ts +583 -0
  183. package/templates/racing/src/scenes/Race.ts +68 -36
  184. package/templates/racing/src/state.ts +4 -0
  185. package/templates/racing/src/style.css +45 -1
  186. package/templates/racing/src/track/Lap.ts +20 -9
  187. package/templates/racing/src/track/Ranking.ts +53 -14
  188. package/templates/racing/src/track/Track.ts +29 -16
  189. package/templates/racing/src/track/TrackSector.ts +14 -4
  190. package/templates/racing/src/ui/App.tsx +9 -4
  191. package/templates/racing/src/ui/GameUi.tsx +20 -0
  192. package/templates/racing/src/ui/Hud.tsx +6 -5
  193. package/templates/racing/src/ui/main.tsx +14 -0
  194. package/templates/racing/threenative.config.ts +21 -8
  195. package/templates/racing/vite.config.ts +34 -1
  196. package/templates/sailing/.codex/config.toml +15 -0
  197. package/templates/sailing/.mcp.json +20 -0
  198. package/templates/sailing/AGENTS.md +388 -0
  199. package/templates/sailing/CLAUDE.md +390 -0
  200. package/templates/sailing/README.md +25 -0
  201. package/templates/sailing/index.html +12 -0
  202. package/templates/sailing/kit.json +7 -0
  203. package/templates/sailing/native-playtests/survives.playtest.json +21 -0
  204. package/templates/sailing/package.json +52 -0
  205. package/templates/sailing/playtests/fail.playtest.json +24 -0
  206. package/templates/sailing/playtests/performance.playtest.json +21 -0
  207. package/templates/sailing/playtests/survives.playtest.json +38 -0
  208. package/templates/sailing/playtests/win.playtest.json +31 -0
  209. package/templates/sailing/public/favicon.svg +5 -0
  210. package/templates/sailing/public/icon.png +0 -0
  211. package/templates/sailing/src/entities/Ship.ts +96 -0
  212. package/templates/sailing/src/game.ts +40 -0
  213. package/templates/sailing/src/main.ts +15 -0
  214. package/templates/sailing/src/render/camera.ts +21 -0
  215. package/templates/sailing/src/render/lighting.ts +36 -0
  216. package/templates/sailing/src/render/loading.ts +315 -0
  217. package/templates/sailing/src/render/materials.ts +28 -0
  218. package/templates/sailing/src/render/palette.ts +24 -0
  219. package/templates/sailing/src/render/postprocessing.ts +33 -0
  220. package/templates/sailing/src/render/props.ts +52 -0
  221. package/templates/sailing/src/render/sky.ts +32 -0
  222. package/templates/sailing/src/render/water-material.ts +14 -0
  223. package/templates/sailing/src/render/water-shaders.ts +12 -0
  224. package/templates/sailing/src/render/wave-nodes.ts +10 -0
  225. package/templates/sailing/src/render/worldEnvironment.ts +590 -0
  226. package/templates/sailing/src/scenes/Boot.ts +12 -0
  227. package/templates/sailing/src/scenes/Sailing.ts +106 -0
  228. package/templates/sailing/src/state.ts +10 -0
  229. package/templates/sailing/src/style.css +61 -0
  230. package/templates/sailing/src/ui/App.tsx +15 -0
  231. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  232. package/templates/sailing/src/ui/Hud.tsx +55 -0
  233. package/templates/sailing/src/ui/Menu.tsx +30 -0
  234. package/templates/sailing/src/ui/main.tsx +7 -0
  235. package/templates/sailing/tailwind.config.ts +2 -0
  236. package/templates/sailing/threenative.config.ts +34 -0
  237. package/templates/sailing/tsconfig.json +17 -0
  238. package/templates/sailing/vite.config.ts +34 -0
  239. package/templates/shooter/.codex/config.toml +15 -0
  240. package/templates/shooter/.mcp.json +6 -2
  241. package/templates/shooter/AGENTS.md +373 -7
  242. package/templates/shooter/CLAUDE.md +373 -7
  243. package/templates/shooter/index.html +0 -1
  244. package/templates/shooter/package.json +16 -11
  245. package/templates/shooter/playtests/fail.playtest.json +5 -4
  246. package/templates/shooter/playtests/input-control.playtest.json +131 -0
  247. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  248. package/templates/shooter/playtests/performance.playtest.json +22 -0
  249. package/templates/shooter/playtests/shooter.playtest.json +22 -18
  250. package/templates/shooter/playtests/survives.playtest.json +1 -1
  251. package/templates/shooter/public/favicon.svg +1 -1
  252. package/templates/shooter/public/icon.png +0 -0
  253. package/templates/shooter/src/game.ts +24 -1
  254. package/templates/shooter/src/main.ts +3 -13
  255. package/templates/shooter/src/render/camera.ts +62 -12
  256. package/templates/shooter/src/render/lighting.ts +6 -1
  257. package/templates/shooter/src/render/loading.ts +262 -33
  258. package/templates/shooter/src/render/palette.ts +1 -1
  259. package/templates/shooter/src/render/postprocessing.ts +68 -16
  260. package/templates/shooter/src/render/shapes.ts +178 -0
  261. package/templates/shooter/src/render/ui.css +34 -1
  262. package/templates/shooter/src/render/worldEnvironment.ts +583 -0
  263. package/templates/shooter/src/scenes/Play.ts +246 -73
  264. package/templates/shooter/src/state.ts +13 -0
  265. package/templates/shooter/src/style.css +26 -0
  266. package/templates/shooter/src/ui/App.tsx +10 -12
  267. package/templates/shooter/src/ui/GameUi.tsx +20 -0
  268. package/templates/shooter/src/ui/Hud.tsx +8 -10
  269. package/templates/shooter/src/ui/Menu.tsx +24 -9
  270. package/templates/shooter/src/ui/main.tsx +15 -0
  271. package/templates/shooter/src/weapons/Projectile.ts +21 -10
  272. package/templates/shooter/threenative.config.ts +21 -8
  273. package/templates/shooter/vite.config.ts +32 -2
  274. package/templates/starter/.codex/config.toml +15 -0
  275. package/templates/starter/.mcp.json +6 -2
  276. package/templates/starter/AGENTS.md +429 -326
  277. package/templates/starter/CLAUDE.md +429 -326
  278. package/templates/starter/assets/pickup.wav +0 -0
  279. package/templates/starter/gitignore +4 -0
  280. package/templates/starter/index.html +0 -1
  281. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  282. package/templates/starter/native-playtests/render-chain.playtest.json +12 -0
  283. package/templates/starter/package.json +16 -12
  284. package/templates/starter/playtests/assets.playtest.json +65 -0
  285. package/templates/starter/playtests/buffer.playtest.json +59 -9
  286. package/templates/starter/playtests/cloth.playtest.json +113 -0
  287. package/templates/starter/playtests/coyote.playtest.json +60 -8
  288. package/templates/starter/playtests/forward.playtest.json +29 -4
  289. package/templates/starter/playtests/gameover.playtest.json +66 -0
  290. package/templates/starter/playtests/goal.playtest.json +67 -0
  291. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  292. package/templates/starter/playtests/look.playtest.json +34 -6
  293. package/templates/starter/playtests/models-baseline.png +0 -0
  294. package/templates/starter/playtests/models.playtest.json +74 -0
  295. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  296. package/templates/starter/playtests/odometer.playtest.json +54 -0
  297. package/templates/starter/playtests/pause.playtest.json +27 -4
  298. package/templates/starter/playtests/play.playtest.json +43 -7
  299. package/templates/starter/playtests/respawn.playtest.json +46 -6
  300. package/templates/starter/playtests/restart.playtest.json +65 -10
  301. package/templates/starter/playtests/seed.playtest.json +44 -8
  302. package/templates/starter/playtests/survives.playtest.json +27 -4
  303. package/templates/starter/playtests/textures-baseline.png +0 -0
  304. package/templates/starter/playtests/textures.playtest.json +74 -0
  305. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  306. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  307. package/templates/starter/public/icon.png +0 -0
  308. package/templates/starter/src/entities/Goal.ts +122 -0
  309. package/templates/starter/src/entities/Player.ts +40 -2
  310. package/templates/starter/src/game.ts +25 -0
  311. package/templates/starter/src/render/camera.ts +31 -5
  312. package/templates/starter/src/render/easing.ts +5 -0
  313. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  314. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  315. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  316. package/templates/starter/src/render/lighting.ts +6 -1
  317. package/templates/starter/src/render/loading.ts +315 -0
  318. package/templates/starter/src/render/materials.ts +17 -1
  319. package/templates/starter/src/render/pennant.ts +54 -0
  320. package/templates/starter/src/render/postprocessing.ts +46 -15
  321. package/templates/starter/src/render/scenery.ts +83 -0
  322. package/templates/starter/src/render/shapes.ts +9 -21
  323. package/templates/starter/src/render/worldEnvironment.ts +583 -0
  324. package/templates/starter/src/scenes/Play.ts +146 -36
  325. package/templates/starter/src/state.ts +12 -0
  326. package/templates/starter/src/style.css +45 -1
  327. package/templates/starter/src/ui/App.tsx +9 -6
  328. package/templates/starter/src/ui/GameUi.tsx +20 -0
  329. package/templates/starter/src/ui/Hud.tsx +52 -29
  330. package/templates/starter/src/ui/Menu.tsx +25 -23
  331. package/templates/starter/src/ui/main.tsx +14 -0
  332. package/templates/starter/threenative.config.ts +27 -9
  333. package/templates/starter/tools/look.mjs +109 -0
  334. package/templates/starter/vite.config.ts +32 -2
  335. package/templates/minimal/assets/.gitkeep +0 -0
  336. package/templates/minimal/public/.gitkeep +0 -0
  337. package/templates/platformer/assets/.gitkeep +0 -0
  338. package/templates/platformer/public/.gitkeep +0 -0
  339. package/templates/starter/assets/.gitkeep +0 -0
  340. package/templates/starter/public/.gitkeep +0 -0
  341. package/templates/starter/public/pickup.ogg +0 -0
  342. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  343. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -0,0 +1,106 @@
1
+ import { type ICtx, Scene, type SceneFrame, WaveField, isMobile } from "@threenative/core";
2
+ import type { IPhysicsContext } from "@threenative/physics";
3
+ import { Fog, Mesh, type PerspectiveCamera, PlaneGeometry } from "three";
4
+ import { Ship } from "../entities/Ship.js";
5
+ import { followShip, setupCamera } from "../render/camera.js";
6
+ import { setupLighting } from "../render/lighting.js";
7
+ import { createLoadingScreen } from "../render/loading.js";
8
+ import { createMaterials } from "../render/materials.js";
9
+ import { SAILING_DOMAIN_WARP, SAILING_WAVES, palette } from "../render/palette.js";
10
+ import { setupPost } from "../render/postprocessing.js";
11
+ import { createBuoy, createIsland } from "../render/props.js";
12
+ import { setupSky } from "../render/sky.js";
13
+ import { createWaterMaterial } from "../render/water-material.js";
14
+ import type { GameState } from "../state.js";
15
+
16
+ export type GameCtx = ICtx<GameState, IPhysicsContext>;
17
+
18
+ const COURSE_BUOYS = [5, 3, 1, -1] as const;
19
+
20
+ export class Sailing extends Scene<GameState, IPhysicsContext> {
21
+ static override readonly initialState: GameState = {
22
+ buoysRounded: 0,
23
+ elapsed: 0,
24
+ paused: false,
25
+ shipZ: 7,
26
+ status: "sailing",
27
+ submergedFraction: 0,
28
+ uiReady: false,
29
+ wind: 1,
30
+ };
31
+
32
+ override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
33
+ setupSky(ctx.scene);
34
+ ctx.scene.fog = new Fog(palette.skyLow, 30, 100);
35
+ const sun = setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
36
+ setupPost(ctx.renderer, ctx.scene, ctx.camera, { godraysLight: sun, mobile: isMobile() });
37
+ const loading = createLoadingScreen(ctx);
38
+ const camera = ctx.camera as PerspectiveCamera;
39
+ setupCamera(camera);
40
+
41
+ const field = new WaveField({ waves: SAILING_WAVES, domainWarp: SAILING_DOMAIN_WARP });
42
+ const water = new Mesh(new PlaneGeometry(80, 80, 96, 96), createWaterMaterial(field));
43
+ water.geometry.rotateX(-Math.PI / 2);
44
+ water.receiveShadow = true;
45
+ water.frustumCulled = false;
46
+ ctx.add(water);
47
+
48
+ const materials = createMaterials();
49
+ ctx.add(createIsland(materials));
50
+ for (const [index, z] of COURSE_BUOYS.entries()) {
51
+ const buoy = createBuoy(materials);
52
+ buoy.position.set(index % 2 === 0 ? 0.6 : -0.6, 0, z);
53
+ ctx.add(buoy);
54
+ }
55
+
56
+ const ship = new Ship(ctx, field);
57
+ ctx.entities.add("player", ship);
58
+ let elapsed = 0;
59
+ let buoysRounded = 0;
60
+ let status: GameState["status"] = "sailing";
61
+ const advanceSailing = (frameCtx: GameCtx, deltaTime: number, wind: number): void => {
62
+ if (frameCtx.input.justPressed("capsize")) {
63
+ ship.capsize();
64
+ status = "lost";
65
+ return;
66
+ }
67
+ ship.update(frameCtx, deltaTime, wind);
68
+ const nextBuoy = COURSE_BUOYS[buoysRounded];
69
+ if (nextBuoy === undefined || ship.mesh.position.z > nextBuoy) {
70
+ if (wind <= 0) status = "lost";
71
+ return;
72
+ }
73
+ buoysRounded += 1;
74
+ if (buoysRounded === COURSE_BUOYS.length) status = "won";
75
+ else if (wind <= 0) status = "lost";
76
+ };
77
+
78
+ return (frameCtx, deltaTime) => {
79
+ loading.update();
80
+ if (frameCtx.input.justPressed("restart")) {
81
+ frameCtx.state.set(Sailing.initialState);
82
+ frameCtx.state.flush();
83
+ void frameCtx.goto("sailing");
84
+ return;
85
+ }
86
+
87
+ elapsed += deltaTime;
88
+ field.setTime(elapsed);
89
+ const wind = Math.max(0, 1 - elapsed / 45);
90
+ if (status === "sailing") advanceSailing(frameCtx, deltaTime, wind);
91
+
92
+ const state = frameCtx.state.getState();
93
+ frameCtx.state.set({
94
+ buoysRounded,
95
+ elapsed,
96
+ paused: state.paused,
97
+ shipZ: ship.mesh.position.z,
98
+ status,
99
+ submergedFraction: ship.buoyancy.submergedFraction,
100
+ uiReady: frameCtx.state.getState().uiReady,
101
+ wind,
102
+ });
103
+ followShip(camera, ship.mesh.position);
104
+ };
105
+ }
106
+ }
@@ -0,0 +1,10 @@
1
+ export type GameState = {
2
+ buoysRounded: number;
3
+ elapsed: number;
4
+ paused: boolean;
5
+ submergedFraction: number;
6
+ status: "sailing" | "won" | "lost";
7
+ uiReady: boolean;
8
+ wind: number;
9
+ shipZ: number;
10
+ };
@@ -0,0 +1,61 @@
1
+ @import "tailwindcss";
2
+
3
+ @theme {
4
+ --color-ink: #061b2b;
5
+ --color-panel: #0b2a3b;
6
+ --color-text: #e5f5f7;
7
+ --color-muted: #8caeba;
8
+ --color-accent: #ffd27a;
9
+ --color-win: #6fe8ff;
10
+ --color-danger: #ff8f7a;
11
+ }
12
+
13
+ :root,
14
+ body,
15
+ #root {
16
+ height: 100%;
17
+ margin: 0;
18
+ overflow: hidden;
19
+ }
20
+
21
+ body {
22
+ color: #e5f5f7;
23
+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
24
+ }
25
+
26
+ #root {
27
+ background: #061b2b;
28
+ }
29
+
30
+ /* The debug surface is framework plumbing; its default presentation is yours to change. */
31
+ [data-threenative-debug-overlay="true"] {
32
+ position: fixed;
33
+ top: 1rem;
34
+ right: 1rem;
35
+ z-index: 50;
36
+ max-width: 24rem;
37
+ padding: 0.75rem;
38
+ pointer-events: none;
39
+ background: rgb(2 6 23 / 90%);
40
+ box-shadow: 0 10px 15px -3px rgb(0 0 0 / 30%);
41
+ color: #cffafe;
42
+ font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
43
+ font-size: 12px;
44
+ line-height: 1.5;
45
+ }
46
+
47
+ [data-threenative-debug-overlay="true"] table {
48
+ width: 100%;
49
+ table-layout: fixed;
50
+ }
51
+
52
+ [data-threenative-debug-overlay="true"] th,
53
+ [data-threenative-debug-overlay="true"] td {
54
+ padding-right: 1rem;
55
+ text-align: left;
56
+ }
57
+
58
+ [data-threenative-debug-overlay="true"] td:last-child {
59
+ overflow-wrap: anywhere;
60
+ word-break: break-all;
61
+ }
@@ -0,0 +1,15 @@
1
+ import type { IGame } from "@threenative/core";
2
+ import type { IPhysicsContext } from "@threenative/physics";
3
+ import { DebugOverlay, GameCanvas } from "@threenative/ui";
4
+ import type { GameState } from "../state.js";
5
+ import { GameUi } from "./GameUi.js";
6
+
7
+ export function App({ game }: { game: IGame<GameState, IPhysicsContext> }) {
8
+ return (
9
+ <main className="relative h-screen w-screen overflow-hidden bg-ink">
10
+ <GameCanvas className="absolute inset-0" game={game} />
11
+ <GameUi />
12
+ <DebugOverlay />
13
+ </main>
14
+ );
15
+ }
@@ -0,0 +1,12 @@
1
+ import { UiLayer } from "@threenative/ui";
2
+ import { Hud } from "./Hud.js";
3
+ import { Menu } from "./Menu.js";
4
+
5
+ export function GameUi() {
6
+ return (
7
+ <UiLayer>
8
+ <Hud />
9
+ <Menu />
10
+ </UiLayer>
11
+ );
12
+ }
@@ -0,0 +1,55 @@
1
+ import { useUiState } from "@threenative/ui";
2
+ import type { GameState } from "../state.js";
3
+
4
+ export function Hud() {
5
+ const state = useUiState<GameState>();
6
+ if (state === undefined) return null;
7
+ const statusClass =
8
+ state.status === "won" ? "text-win" : state.status === "lost" ? "text-danger" : "text-accent";
9
+ return (
10
+ <div className="pointer-events-none absolute inset-0 p-6 text-[11px] uppercase tracking-[0.16em] text-text">
11
+ <div className="flex items-start justify-between">
12
+ <div>
13
+ <div className="text-[10px] text-muted">passage / bluewater run</div>
14
+ <div className="mt-2 flex items-baseline gap-5 text-[18px] text-white">
15
+ <span>
16
+ buoys <b id="buoys-rounded">{state.buoysRounded}</b>/4
17
+ </span>
18
+ <span className={statusClass} id="sailing-status">
19
+ {state.status}
20
+ </span>
21
+ </div>
22
+ </div>
23
+ <div className="text-right">
24
+ <div className="text-[10px] text-muted">wind</div>
25
+ <div className="mt-2 text-[22px] text-white" id="wind">
26
+ {Math.round(state.wind * 100)}%
27
+ </div>
28
+ </div>
29
+ </div>
30
+ <div className="absolute bottom-6 left-6 flex items-end gap-8">
31
+ <div>
32
+ <div className="text-[10px] text-muted">waterline</div>
33
+ <div className="mt-1 text-[26px] leading-none text-white" id="submerged-fraction">
34
+ {Math.round(state.submergedFraction * 100)}
35
+ <span className="text-[11px] text-muted">%</span>
36
+ </div>
37
+ </div>
38
+ <div>
39
+ <div className="text-[10px] text-muted">elapsed</div>
40
+ <div className="mt-1 text-[18px] leading-none text-white" id="elapsed">
41
+ {state.elapsed.toFixed(1)}s
42
+ </div>
43
+ </div>
44
+ </div>
45
+ {state.status === "sailing" ? null : (
46
+ <div className="absolute left-1/2 top-1/2 -translate-x-1/2 -translate-y-1/2 border border-accent/70 bg-panel/80 px-8 py-5 text-center">
47
+ <div className={`text-[28px] tracking-[0.28em] ${statusClass}`}>
48
+ {state.status === "won" ? "course complete" : "capsized"}
49
+ </div>
50
+ <div className="mt-2 text-[10px] text-muted">press R to restart</div>
51
+ </div>
52
+ )}
53
+ </div>
54
+ );
55
+ }
@@ -0,0 +1,30 @@
1
+ import { useUiIntent, useUiState } from "@threenative/ui";
2
+ import type { GameState } from "../state.js";
3
+
4
+ export function Menu() {
5
+ const send = useUiIntent();
6
+ const state = useUiState<GameState>();
7
+ if (state === undefined) return null;
8
+ return (
9
+ <div className="pointer-events-none absolute bottom-6 right-6 flex items-center gap-3 border border-line bg-panel/75 px-4 py-3 text-[10px] uppercase tracking-[0.14em] text-muted">
10
+ <span>WASD / arrows steer · C capsize test</span>
11
+ <button
12
+ aria-pressed={state.paused}
13
+ className="pointer-events-auto border border-line px-2 py-1 text-text hover:border-accent"
14
+ data-tn-interactive
15
+ onClick={() => send(state.paused ? "resume" : "pause")}
16
+ type="button"
17
+ >
18
+ {state.paused ? "resume" : "pause"}
19
+ </button>
20
+ <button
21
+ className="pointer-events-auto border border-line px-2 py-1 text-text hover:border-accent"
22
+ data-tn-interactive
23
+ onClick={() => send("restart")}
24
+ type="button"
25
+ >
26
+ restart
27
+ </button>
28
+ </div>
29
+ );
30
+ }
@@ -0,0 +1,7 @@
1
+ import { createRoot } from "react-dom/client";
2
+ import { GameUi } from "./GameUi.js";
3
+ import "../style.css";
4
+
5
+ const root = document.getElementById("tn-ui");
6
+ if (root === null) throw new Error("Missing #tn-ui element.");
7
+ createRoot(root).render(<GameUi />);
@@ -0,0 +1,2 @@
1
+ // Tailwind 4 is CSS-first. Keep this file for familiar project discovery.
2
+ export default {};
@@ -0,0 +1,34 @@
1
+ import type { IThreeNativeConfig } from "@threenative/core";
2
+
3
+ const config: IThreeNativeConfig = {
4
+ app: {
5
+ id: "com.threenative.__PROJECT_ID__",
6
+ name: "__PROJECT_NAME__",
7
+ version: "1.0.0",
8
+ build: 1,
9
+ icon: "public/icon.png",
10
+ icons: { web: { favicon: "public/favicon.svg" } },
11
+ },
12
+ display: {
13
+ orientation: "landscape",
14
+ fullscreen: true,
15
+ keepScreenOn: true,
16
+ maxFps: 60,
17
+ },
18
+ window: {
19
+ title: "__PROJECT_NAME__",
20
+ width: 1280,
21
+ height: 720,
22
+ resizable: true,
23
+ },
24
+ bootSplash: { backgroundColor: "#061b2b" },
25
+ nativeEntry: "src/game.ts",
26
+ renderer: {
27
+ preferWebGPU: true,
28
+ resolutionScale: "auto",
29
+ },
30
+ assets: { models: "none", textures: "none" },
31
+ ui: { renderer: "web" },
32
+ };
33
+
34
+ export default config;
@@ -0,0 +1,17 @@
1
+ {
2
+ "compilerOptions": {
3
+ "target": "ES2022",
4
+ "lib": ["ES2022", "DOM", "DOM.Iterable"],
5
+ "module": "ESNext",
6
+ "moduleResolution": "bundler",
7
+ "jsx": "react-jsx",
8
+ "types": ["vite/client"],
9
+ "strict": true,
10
+ "noUncheckedIndexedAccess": true,
11
+ "noEmit": true,
12
+ "skipLibCheck": true,
13
+ "verbatimModuleSyntax": true,
14
+ "isolatedModules": true
15
+ },
16
+ "include": ["src/**/*.ts", "src/**/*.tsx", "tests/**/*.ts", "*.ts"]
17
+ }
@@ -0,0 +1,34 @@
1
+ import tailwindcss from "@tailwindcss/vite";
2
+ import { watchAssets } from "@threenative/assets";
3
+ import react from "@vitejs/plugin-react";
4
+ import { createEngineFreshnessPlugin, createWebBrandPlugin } from "create-threenative";
5
+ import { defineConfig } from "vite";
6
+ import type { Plugin } from "vite";
7
+ import config from "./threenative.config.js";
8
+
9
+ function assetsWatchPlugin(): Plugin {
10
+ return {
11
+ name: "threenative-assets-watch",
12
+ apply: "serve",
13
+ configureServer(server) {
14
+ const handle = watchAssets({ config: config.assets, cwd: server.config.root });
15
+ server.httpServer?.once("close", () => handle.close());
16
+ },
17
+ };
18
+ }
19
+
20
+ export default defineConfig({
21
+ plugins: [
22
+ createEngineFreshnessPlugin(),
23
+ createWebBrandPlugin(),
24
+ react(),
25
+ tailwindcss(),
26
+ assetsWatchPlugin(),
27
+ ],
28
+ server: {
29
+ watch: {
30
+ ignored: ["**/artifacts/**", "**/screenshots/**", "**/playtests/**"],
31
+ usePolling: true,
32
+ },
33
+ },
34
+ });
@@ -0,0 +1,15 @@
1
+ [mcp_servers.threenative-assets]
2
+ command = "node"
3
+ args = ["./node_modules/@threenative/core/mcp/assets.mjs"]
4
+
5
+ [mcp_servers.threenative-assets.env]
6
+ ASSET_DOWNLOAD_DIR = "./public/assets"
7
+ AUDIO_DOWNLOAD_DIR = "./public/audio"
8
+
9
+ [mcp_servers.threenative-sculpt]
10
+ command = "node"
11
+ args = ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
12
+
13
+ [mcp_servers.threenative-engine]
14
+ command = "node"
15
+ args = ["./node_modules/@threenative/core/mcp/engine.mjs"]
@@ -2,7 +2,7 @@
2
2
  "mcpServers": {
3
3
  "threenative-assets": {
4
4
  "command": "node",
5
- "args": ["./node_modules/threenative-asset-mcp/dist/index.js"],
5
+ "args": ["./node_modules/@threenative/core/mcp/assets.mjs"],
6
6
  "env": {
7
7
  "ASSET_DOWNLOAD_DIR": "./public/assets",
8
8
  "AUDIO_DOWNLOAD_DIR": "./public/audio"
@@ -10,7 +10,11 @@
10
10
  },
11
11
  "threenative-sculpt": {
12
12
  "command": "node",
13
- "args": ["./node_modules/threenative-sculpt-mcp/dist/server.js"]
13
+ "args": ["./node_modules/@threenative/core/mcp/sculpt.mjs"]
14
+ },
15
+ "threenative-engine": {
16
+ "command": "node",
17
+ "args": ["./node_modules/@threenative/core/mcp/engine.mjs"]
14
18
  }
15
19
  }
16
20
  }