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
@@ -1,12 +1,20 @@
1
- import { type ICtx, Scene, type SceneFrame } from "@threenative/core";
1
+ import {
2
+ Atmosphere,
3
+ type ICtx,
4
+ Scene,
5
+ type SceneFrame,
6
+ isMobile,
7
+ solarPosition,
8
+ } from "@threenative/core";
2
9
  import { Area3D, CollisionShape3D, type IPhysicsContext, RigidBody3D } from "@threenative/physics";
3
- import { BoxGeometry, Mesh, type PerspectiveCamera } from "three";
10
+ import { BoxGeometry, Mesh, type PerspectiveCamera, Vector3 } from "three";
11
+ import { mergeGeometries } from "three/addons/utils/BufferGeometryUtils.js";
4
12
  import { Player } from "../entities/Player.js";
5
13
  import { setupCamera } from "../render/camera.js";
6
14
  import { createHud } from "../render/hud.js";
7
15
  import { setupLighting } from "../render/lighting.js";
8
16
  import { createLoadingScreen } from "../render/loading.js";
9
- import { floorMaterial } from "../render/materials.js";
17
+ import { defaultMaterial, floorMaterial } from "../render/materials.js";
10
18
  import { setupPost } from "../render/postprocessing.js";
11
19
  import { setupSky } from "../render/sky.js";
12
20
  import type { GameState } from "../state.js";
@@ -14,23 +22,77 @@ import type { GameState } from "../state.js";
14
22
  export type GameCtx = ICtx<GameState, IPhysicsContext>;
15
23
 
16
24
  export class Play extends Scene<GameState, IPhysicsContext> {
17
- static override readonly initialState: GameState = { playerX: -2, score: 0 };
25
+ static override readonly initialState: GameState = {
26
+ playerX: -2,
27
+ score: 0,
28
+ sunAzimuth: 0,
29
+ sunElevation: 0,
30
+ sunTransmittanceRed: 0,
31
+ };
18
32
 
19
33
  override enter(ctx: GameCtx): SceneFrame<GameState, IPhysicsContext> {
20
- setupSky(ctx.scene);
21
- setupLighting(ctx.scene, ctx.renderer.raw as Parameters<typeof setupLighting>[1]);
22
- setupPost(ctx.renderer, ctx.scene, ctx.camera);
34
+ const useAtmosphere = ctx.renderer.kind === "webgpu";
35
+ const atmosphere = useAtmosphere
36
+ ? new Atmosphere({
37
+ rayleigh: [0.005802, 0.013558, 0.0331],
38
+ mie: [0.00444, 0.00444, 0.00444],
39
+ ozone: [0.00065, 0.001881, 0.000085],
40
+ planetRadius: 6360,
41
+ atmosphereRadius: 6460,
42
+ resolutions: {
43
+ transmittance: { width: 128, height: 32 },
44
+ multiScattering: { width: 16, height: 16 },
45
+ skyView: { width: 128, height: 72 },
46
+ },
47
+ })
48
+ : undefined;
49
+ const solarInput = {
50
+ dayOfYear: 172,
51
+ timeOfDay: 6,
52
+ latitude: 49.28,
53
+ longitude: -123.12,
54
+ utcOffset: -8,
55
+ };
56
+ const sun = { azimuth: 0, elevation: 0 };
57
+ solarPosition(solarInput, sun);
58
+ atmosphere?.setSunDirection(sun);
59
+ if (atmosphere !== undefined) {
60
+ ctx.add(atmosphere);
61
+ // Idempotent with the PRD-242 registry when that contract is present; required by the
62
+ // current renderer seam while this template is also usable on WebGL.
63
+ atmosphere.attachRenderer(ctx.renderer);
64
+ }
65
+ setupSky(ctx.scene, atmosphere);
66
+ const lighting = setupLighting(
67
+ ctx.scene,
68
+ ctx.renderer.raw as Parameters<typeof setupLighting>[1],
69
+ atmosphere,
70
+ );
71
+ // isMobile() arrives as an argument because src/render/ imports no framework package: the
72
+ // platform decision is made here, in portable game code, exactly like createRandom.
73
+ setupPost(ctx.renderer, ctx.scene, ctx.camera, {
74
+ atmosphere,
75
+ godraysLight: lighting.key,
76
+ mobile: isMobile(),
77
+ });
23
78
  setupCamera(ctx.camera as PerspectiveCamera);
24
79
  const loading = createLoadingScreen(ctx);
25
80
  ctx.add(ctx.camera);
26
- const hud = ctx.entities.add(
27
- "hud",
28
- createHud(ctx.camera as PerspectiveCamera, "SCORE", "ITEMS"),
29
- );
81
+ const hud = ctx.entities.add("hud", createHud(ctx.camera as PerspectiveCamera, "SCORE"));
30
82
  const floor = new Mesh(new BoxGeometry(10, 0.2, 4), floorMaterial);
31
83
  floor.position.y = -0.1;
32
84
  floor.receiveShadow = true;
33
85
  ctx.add(floor);
86
+ const nearWallGeometry = new BoxGeometry(1.4, 2.8, 0.6);
87
+ nearWallGeometry.translate(-3, 1.4, 2.5);
88
+ const distantRidgeGeometry = new BoxGeometry(12_000, 500, 100);
89
+ distantRidgeGeometry.translate(0, 230, -5_000);
90
+ const hazeProbe = new Mesh(
91
+ mergeGeometries([nearWallGeometry, distantRidgeGeometry]),
92
+ defaultMaterial,
93
+ );
94
+ hazeProbe.castShadow = true;
95
+ ctx.add(hazeProbe);
34
96
  new RigidBody3D({
35
97
  object: floor,
36
98
  physics: ctx.physics,
@@ -49,17 +111,33 @@ export class Play extends Scene<GameState, IPhysicsContext> {
49
111
  });
50
112
 
51
113
  let elapsed = 0;
114
+ const statePatch: Partial<GameState> = {};
52
115
  return (frameCtx, dt) => {
53
116
  loading.update();
54
117
  player.update(frameCtx, dt);
55
118
  elapsed += dt;
119
+ solarInput.timeOfDay = (6 + elapsed * 2) % 24;
120
+ solarPosition(solarInput, sun);
121
+ if (atmosphere !== undefined) {
122
+ atmosphere.setSunDirection(sun);
123
+ lighting.updateSun(atmosphere.getSunDirection());
124
+ }
56
125
  const state = frameCtx.state.getState();
57
126
  hud.update({
58
- counter: Math.abs(player.mesh.position.x) * 10,
59
127
  primary: state.score,
60
128
  seconds: elapsed,
61
129
  });
62
- frameCtx.state.set({ playerX: player.mesh.position.x });
130
+ statePatch.playerX = player.mesh.position.x;
131
+ statePatch.sunAzimuth = sun.azimuth;
132
+ statePatch.sunElevation = sun.elevation;
133
+ if (atmosphere !== undefined) {
134
+ // The sun's angle is plain arithmetic and keeps moving with the atmosphere deleted, so a
135
+ // scenario asserting only on it proves nothing. This number cannot be produced without
136
+ // the node, which is what makes the atmosphere playtest able to go red.
137
+ const transmittance = atmosphere.sunTransmittance(atmosphere.getSunDirection());
138
+ if (transmittance instanceof Vector3) statePatch.sunTransmittanceRed = transmittance.x;
139
+ }
140
+ frameCtx.state.set(statePatch);
63
141
  };
64
142
  }
65
143
  }
@@ -1 +1,8 @@
1
- export type GameState = { playerX: number; score: number };
1
+ export type GameState = {
2
+ playerX: number;
3
+ score: number;
4
+ sunAzimuth: number;
5
+ sunElevation: number;
6
+ /** Red channel of the atmosphere's sun transmittance; stays 0 when no atmosphere is built. */
7
+ sunTransmittanceRed: number;
8
+ };
@@ -1,17 +1,19 @@
1
1
  import type { IThreeNativeConfig } from "@threenative/core";
2
2
 
3
- export default {
3
+ const config: IThreeNativeConfig = {
4
4
  app: {
5
5
  id: "com.threenative.__PROJECT_ID__",
6
6
  name: "__PROJECT_NAME__",
7
7
  version: "1.0.0",
8
8
  build: 1,
9
9
  icon: "public/icon.png",
10
+ icons: { web: { favicon: "public/favicon.svg" } },
10
11
  },
11
12
  display: {
12
13
  orientation: "landscape", // Mobile viewport orientation.
13
14
  fullscreen: true, // Keep the game surface edge to edge.
14
15
  keepScreenOn: true, // Do not dim during a play session.
16
+ maxFps: 60, // Set 120 to opt into a supported high-refresh display mode.
15
17
  },
16
18
  window: {
17
19
  title: "__PROJECT_NAME__", // Desktop window title.
@@ -19,14 +21,17 @@ export default {
19
21
  height: 720,
20
22
  resizable: true,
21
23
  },
22
- loading: {
23
- // Read by src/render/loading.ts, which is your file. Delete that file to drop the screen.
24
- backdropColor: "#0d1b2a",
25
- trackColor: "#274060",
26
- progressColor: "#8fd694",
27
- showProgressBar: true,
28
- // image: "public/logo.png", // drawn centred above the bar
24
+ bootSplash: {
25
+ backgroundColor: "#0d1b2a",
29
26
  },
30
27
  nativeEntry: "src/game.ts",
31
- renderer: { preferWebGPU: true }, // Use WebGPU when the host exposes it.
32
- } satisfies IThreeNativeConfig;
28
+ renderer: {
29
+ preferWebGPU: true, // Use WebGPU when the host exposes it.
30
+ // The engine holds the `display.maxFps` budget by scaling the 3D drawing buffer, and reports
31
+ // the scale it settled on in every `TN_FRAME_BUDGET` window. Replace with a number in (0, 1]
32
+ // to pin it — the loop stops and the reporting does not. CSS, UI and camera framing never move.
33
+ resolutionScale: "auto",
34
+ },
35
+ };
36
+
37
+ export default config;
@@ -1,3 +1,30 @@
1
+ import { watchAssets } from "@threenative/assets";
2
+ import { createEngineFreshnessPlugin, createWebBrandPlugin } from "create-threenative";
1
3
  import { defineConfig } from "vite";
4
+ import type { Plugin } from "vite";
5
+ import config from "./threenative.config.js";
2
6
 
3
- export default defineConfig({});
7
+ /**
8
+ * Recompiles assets/ into public/ while the dev server runs, so editing a texture does not
9
+ * need a rebuild. Serve-only by declaration: builds compile through `threenative build`.
10
+ */
11
+ function assetsWatchPlugin(): Plugin {
12
+ return {
13
+ name: "threenative-assets-watch",
14
+ apply: "serve",
15
+ configureServer(server) {
16
+ const handle = watchAssets({ config: config.assets, cwd: server.config.root });
17
+ server.httpServer?.once("close", () => handle.close());
18
+ },
19
+ };
20
+ }
21
+
22
+ export default defineConfig({
23
+ plugins: [createEngineFreshnessPlugin(), createWebBrandPlugin(), assetsWatchPlugin()],
24
+ server: {
25
+ watch: {
26
+ ignored: ["**/artifacts/**", "**/screenshots/**", "**/playtests/**"],
27
+ usePolling: true,
28
+ },
29
+ },
30
+ });
@@ -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
  }