create-threenative 0.2.5 → 0.2.7

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 (631) hide show
  1. package/README.md +25 -3
  2. package/agent-docs/references/assertion-reference.md +40 -1
  3. package/agent-docs/references/build-profiles.md +126 -0
  4. package/agent-docs/references/capability-reference.md +1382 -65
  5. package/agent-docs/references/finding-assets.md +8 -1
  6. package/agent-docs/references/performance-basics.md +117 -0
  7. package/agent-docs/references/rigging-characters.md +51 -0
  8. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  9. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  10. package/agent-docs/references/visual-baseline.md +8 -4
  11. package/agent-docs/references/webview-ui.md +3 -2
  12. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  13. package/agent-files/.agents/skills/ponytail/SKILL.md +68 -0
  14. package/agent-files/.agents/skills/threenative-assets/SKILL.md +12 -4
  15. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  16. package/agent-files/.agents/skills/threenative-context/SKILL.md +9 -1
  17. package/agent-files/.agents/skills/threenative-performance/SKILL.md +26 -10
  18. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  19. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  20. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  21. package/agent-files/.claude/hooks/ponytail-context.mjs +51 -0
  22. package/agent-files/.claude/settings.json +38 -0
  23. package/agent-files/.codex/hooks.json +40 -0
  24. package/capabilities.json +1891 -101
  25. package/dist/index.d.ts +39 -1
  26. package/dist/index.js +480 -56
  27. package/dist/threenative.js +1247 -177
  28. package/package.json +6 -6
  29. package/template-assets/assets/mannequin-combat.glb +0 -0
  30. package/template-assets/assets/mannequin.glb +0 -0
  31. package/template-assets/assets/player-viewmodel.glb +0 -0
  32. package/template-assets/assets/sky.jpg +0 -0
  33. package/template-assets/clearwater/README.md +141 -0
  34. package/template-assets/clearwater/install.mjs +50 -0
  35. package/template-assets/clearwater/src/clearwater.ts +180 -0
  36. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  37. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  38. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  39. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  40. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  41. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  42. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  43. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  44. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  45. package/template-assets/patches/three@0.185.1.patch +2228 -105
  46. package/template-assets/worldEnvironment.ts +52 -1
  47. package/templates/action-rpg/AGENTS.md +43 -43
  48. package/templates/action-rpg/CLAUDE.md +43 -43
  49. package/templates/action-rpg/kit.json +1 -1
  50. package/templates/action-rpg/package.json +14 -8
  51. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  52. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  53. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  54. package/templates/action-rpg/src/conventions.ts +24 -18
  55. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  56. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  57. package/templates/action-rpg/src/entities/Player.ts +102 -32
  58. package/templates/action-rpg/src/game.ts +3 -3
  59. package/templates/action-rpg/src/render/camera.ts +18 -16
  60. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  61. package/templates/action-rpg/src/render/lighting.ts +45 -28
  62. package/templates/action-rpg/src/render/loading.ts +4 -4
  63. package/templates/action-rpg/src/render/materials.ts +191 -47
  64. package/templates/action-rpg/src/render/palette.ts +14 -13
  65. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  66. package/templates/action-rpg/src/render/props.ts +117 -0
  67. package/templates/action-rpg/src/render/quality.ts +40 -82
  68. package/templates/action-rpg/src/render/sky.ts +36 -13
  69. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  70. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  71. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  72. package/templates/action-rpg/src/style.css +9 -7
  73. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  74. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  75. package/templates/action-rpg/threenative.config.ts +14 -1
  76. package/templates/action-rpg/vite.config.ts +4 -1
  77. package/templates/minimal/AGENTS.md +12 -12
  78. package/templates/minimal/CLAUDE.md +12 -12
  79. package/templates/minimal/package.json +13 -7
  80. package/templates/minimal/playtests/play.playtest.json +6 -5
  81. package/templates/minimal/playtests/sky.playtest.json +27 -0
  82. package/templates/minimal/src/conventions.ts +6 -3
  83. package/templates/minimal/src/entities/Player.ts +73 -27
  84. package/templates/minimal/src/main.ts +2 -3
  85. package/templates/minimal/src/render/camera.ts +22 -4
  86. package/templates/minimal/src/render/lighting.ts +24 -48
  87. package/templates/minimal/src/render/materials.ts +158 -13
  88. package/templates/minimal/src/render/palette.ts +10 -7
  89. package/templates/minimal/src/render/postprocessing.ts +12 -25
  90. package/templates/minimal/src/render/quality.ts +35 -69
  91. package/templates/minimal/src/render/sky.ts +35 -54
  92. package/templates/minimal/src/render/touch-controls.ts +1 -1
  93. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  94. package/templates/minimal/src/scenes/Play.ts +121 -111
  95. package/templates/minimal/src/state.ts +0 -4
  96. package/templates/minimal/src/style.css +0 -10
  97. package/templates/minimal/threenative.config.ts +15 -1
  98. package/templates/minimal/vite.config.ts +4 -1
  99. package/templates/platformer/AGENTS.md +18 -56
  100. package/templates/platformer/CLAUDE.md +18 -56
  101. package/templates/platformer/kit.json +2 -2
  102. package/templates/platformer/package.json +14 -10
  103. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  104. package/templates/platformer/playtests/collect.playtest.json +8 -34
  105. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  106. package/templates/platformer/playtests/damage.playtest.json +40 -15
  107. package/templates/platformer/playtests/hud.playtest.json +34 -0
  108. package/templates/platformer/playtests/move.playtest.json +24 -0
  109. package/templates/platformer/playtests/performance.playtest.json +24 -7
  110. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  111. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  112. package/templates/platformer/playtests/survives.playtest.json +3 -19
  113. package/templates/platformer/playtests/world.playtest.json +26 -0
  114. package/templates/platformer/src/entities/Fox.ts +273 -0
  115. package/templates/platformer/src/entities/Pickup.ts +43 -60
  116. package/templates/platformer/src/entities/Walker.ts +88 -0
  117. package/templates/platformer/src/game.ts +11 -8
  118. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  119. package/templates/platformer/src/level/Stage.ts +469 -0
  120. package/templates/platformer/src/render/blocks.ts +94 -0
  121. package/templates/platformer/src/render/camera.ts +28 -3
  122. package/templates/platformer/src/render/fox.ts +196 -0
  123. package/templates/platformer/src/render/lighting.ts +42 -33
  124. package/templates/platformer/src/render/materials.ts +115 -5
  125. package/templates/platformer/src/render/palette.ts +68 -53
  126. package/templates/platformer/src/render/pickups.ts +142 -0
  127. package/templates/platformer/src/render/postprocessing.ts +12 -2
  128. package/templates/platformer/src/render/props.ts +147 -0
  129. package/templates/platformer/src/render/quality.ts +47 -99
  130. package/templates/platformer/src/render/scenery.ts +172 -0
  131. package/templates/platformer/src/render/sky.ts +120 -31
  132. package/templates/platformer/src/render/touch-controls.ts +5 -2
  133. package/templates/platformer/src/render/walkers.ts +96 -0
  134. package/templates/platformer/src/render/waterfall.ts +85 -0
  135. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  136. package/templates/platformer/src/scenes/Boot.ts +3 -4
  137. package/templates/platformer/src/scenes/Play.ts +362 -0
  138. package/templates/platformer/src/state.ts +16 -14
  139. package/templates/platformer/src/style.css +9 -8
  140. package/templates/platformer/src/ui/Hud.tsx +62 -29
  141. package/templates/platformer/src/ui/Menu.tsx +2 -2
  142. package/templates/platformer/threenative.config.ts +14 -1
  143. package/templates/platformer/vite.config.ts +4 -1
  144. package/templates/puzzle/AGENTS.md +21 -22
  145. package/templates/puzzle/CLAUDE.md +21 -22
  146. package/templates/puzzle/assets/native-proof.glb +0 -0
  147. package/templates/puzzle/assets/native-proof.png +0 -0
  148. package/templates/puzzle/kit.json +1 -1
  149. package/templates/puzzle/package.json +14 -8
  150. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  151. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  152. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  153. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  154. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  155. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  156. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  157. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  158. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  159. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  160. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  161. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  162. package/templates/puzzle/src/entities/Crate.ts +99 -42
  163. package/templates/puzzle/src/entities/Seal.ts +69 -0
  164. package/templates/puzzle/src/entities/Warden.ts +135 -0
  165. package/templates/puzzle/src/game.ts +15 -11
  166. package/templates/puzzle/src/render/camera.ts +66 -31
  167. package/templates/puzzle/src/render/crateShape.ts +70 -0
  168. package/templates/puzzle/src/render/lighting.ts +41 -41
  169. package/templates/puzzle/src/render/loading.ts +4 -4
  170. package/templates/puzzle/src/render/materials.ts +131 -27
  171. package/templates/puzzle/src/render/palette.ts +19 -29
  172. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  173. package/templates/puzzle/src/render/quality.ts +71 -80
  174. package/templates/puzzle/src/render/shapes.ts +109 -108
  175. package/templates/puzzle/src/render/sky.ts +18 -10
  176. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  177. package/templates/puzzle/src/render/vault.ts +315 -0
  178. package/templates/puzzle/src/render/warden.ts +46 -0
  179. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  180. package/templates/puzzle/src/scenes/Play.ts +793 -0
  181. package/templates/puzzle/src/state.ts +55 -24
  182. package/templates/puzzle/src/style.css +7 -8
  183. package/templates/puzzle/src/ui/App.tsx +2 -2
  184. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  185. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  186. package/templates/puzzle/threenative.config.ts +14 -1
  187. package/templates/puzzle/vite.config.ts +4 -1
  188. package/templates/racing/AGENTS.md +20 -21
  189. package/templates/racing/CLAUDE.md +20 -21
  190. package/templates/racing/package.json +14 -8
  191. package/templates/racing/playtests/boost.playtest.json +33 -12
  192. package/templates/racing/playtests/outcome.playtest.json +32 -50
  193. package/templates/racing/playtests/performance.playtest.json +2 -1
  194. package/templates/racing/playtests/ranking.playtest.json +5 -14
  195. package/templates/racing/playtests/rescue.playtest.json +2 -2
  196. package/templates/racing/playtests/reverse.playtest.json +30 -8
  197. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  198. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  199. package/templates/racing/src/entities/CarBody.ts +327 -0
  200. package/templates/racing/src/entities/LineDriver.ts +220 -0
  201. package/templates/racing/src/entities/RacingCar.ts +150 -89
  202. package/templates/racing/src/entities/Rival.ts +61 -24
  203. package/templates/racing/src/game.ts +5 -0
  204. package/templates/racing/src/render/camera.ts +49 -7
  205. package/templates/racing/src/render/lighting.ts +36 -37
  206. package/templates/racing/src/render/materials.ts +239 -19
  207. package/templates/racing/src/render/palette.ts +19 -21
  208. package/templates/racing/src/render/postprocessing.ts +12 -2
  209. package/templates/racing/src/render/quality.ts +43 -82
  210. package/templates/racing/src/render/shapes.ts +20 -6
  211. package/templates/racing/src/render/sky.ts +47 -39
  212. package/templates/racing/src/render/touch-controls.ts +1 -1
  213. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  214. package/templates/racing/src/scenes/Race.ts +107 -54
  215. package/templates/racing/src/state.ts +2 -0
  216. package/templates/racing/src/track/Checkline.ts +22 -7
  217. package/templates/racing/src/track/Lap.ts +64 -36
  218. package/templates/racing/src/track/Ranking.ts +20 -11
  219. package/templates/racing/src/track/Track.ts +809 -361
  220. package/templates/racing/src/track/TrackSector.ts +40 -11
  221. package/templates/racing/src/track/circuit.ts +477 -0
  222. package/templates/racing/src/track/rescue.ts +16 -4
  223. package/templates/racing/threenative.config.ts +14 -1
  224. package/templates/racing/vite.config.ts +4 -1
  225. package/templates/rts/AGENTS.md +96 -0
  226. package/templates/rts/CLAUDE.md +98 -0
  227. package/templates/rts/kit.json +7 -0
  228. package/templates/{defense → rts}/package.json +14 -8
  229. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  230. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  231. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  232. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  233. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  234. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  235. package/templates/rts/playtests/survives.playtest.json +58 -0
  236. package/templates/rts/public/favicon.svg +4 -0
  237. package/templates/rts/src/game.ts +64 -0
  238. package/templates/rts/src/orders.ts +22 -0
  239. package/templates/rts/src/render/army.ts +346 -0
  240. package/templates/rts/src/render/camera.ts +123 -0
  241. package/templates/rts/src/render/lighting.ts +61 -0
  242. package/templates/rts/src/render/loading.ts +33 -0
  243. package/templates/rts/src/render/materials.ts +152 -0
  244. package/templates/rts/src/render/models.ts +705 -0
  245. package/templates/rts/src/render/palette.ts +17 -0
  246. package/templates/rts/src/render/picking.ts +93 -0
  247. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  248. package/templates/rts/src/render/quality.ts +128 -0
  249. package/templates/rts/src/render/resources.ts +141 -0
  250. package/templates/rts/src/render/sky.ts +44 -0
  251. package/templates/rts/src/render/terrain.ts +116 -0
  252. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  253. package/templates/rts/src/scenes/Play.ts +650 -0
  254. package/templates/rts/src/sim/ai.ts +1140 -0
  255. package/templates/rts/src/sim/combat.ts +416 -0
  256. package/templates/rts/src/sim/construction.ts +374 -0
  257. package/templates/rts/src/sim/economy.ts +167 -0
  258. package/templates/rts/src/sim/game.ts +1082 -0
  259. package/templates/rts/src/sim/movement.ts +371 -0
  260. package/templates/rts/src/sim/nav.ts +276 -0
  261. package/templates/rts/src/sim/production.ts +180 -0
  262. package/templates/rts/src/sim/terrain.ts +170 -0
  263. package/templates/rts/src/sim/types.ts +647 -0
  264. package/templates/rts/src/sim/vision.ts +46 -0
  265. package/templates/rts/src/state.ts +100 -0
  266. package/templates/{defense → rts}/src/style.css +21 -8
  267. package/templates/rts/src/ui/App.tsx +21 -0
  268. package/templates/rts/src/ui/Commands.tsx +129 -0
  269. package/templates/rts/src/ui/GameUi.tsx +22 -0
  270. package/templates/rts/src/ui/Hud.tsx +165 -0
  271. package/templates/rts/src/ui/Minimap.tsx +84 -0
  272. package/templates/rts/tailwind.config.ts +2 -0
  273. package/templates/rts/threenative.config.ts +56 -0
  274. package/templates/rts/tsconfig.json +17 -0
  275. package/templates/{defense → rts}/vite.config.ts +4 -1
  276. package/templates/runner/AGENTS.md +8 -12
  277. package/templates/runner/CLAUDE.md +8 -12
  278. package/templates/runner/README.md +3 -3
  279. package/templates/runner/package.json +14 -8
  280. package/templates/runner/playtests/performance.playtest.json +2 -2
  281. package/templates/runner/src/conventions.ts +4 -3
  282. package/templates/runner/src/entities/Runner.ts +54 -7
  283. package/templates/runner/src/game.ts +2 -0
  284. package/templates/runner/src/render/camera.ts +4 -2
  285. package/templates/runner/src/render/dust.ts +5 -2
  286. package/templates/runner/src/render/lighting.ts +41 -45
  287. package/templates/runner/src/render/loading.ts +2 -2
  288. package/templates/runner/src/render/materials.ts +165 -25
  289. package/templates/runner/src/render/palette.ts +17 -28
  290. package/templates/runner/src/render/postprocessing.ts +12 -2
  291. package/templates/runner/src/render/quality.ts +42 -96
  292. package/templates/runner/src/render/shapes.ts +59 -37
  293. package/templates/runner/src/render/sky.ts +32 -41
  294. package/templates/runner/src/render/touch-controls.ts +1 -1
  295. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  296. package/templates/runner/src/scenes/Run.ts +26 -6
  297. package/templates/runner/src/track.ts +6 -1
  298. package/templates/runner/threenative.config.ts +14 -1
  299. package/templates/runner/vite.config.ts +4 -1
  300. package/templates/sailing/AGENTS.md +14 -14
  301. package/templates/sailing/CLAUDE.md +14 -14
  302. package/templates/sailing/assets/ship.glb +0 -0
  303. package/templates/sailing/package.json +14 -8
  304. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  305. package/templates/sailing/playtests/sails.playtest.json +33 -0
  306. package/templates/sailing/playtests/win.playtest.json +156 -8
  307. package/templates/sailing/src/conventions.ts +29 -2
  308. package/templates/sailing/src/entities/Ship.ts +381 -57
  309. package/templates/sailing/src/game.ts +14 -0
  310. package/templates/sailing/src/render/camera.ts +63 -9
  311. package/templates/sailing/src/render/lighting.ts +49 -27
  312. package/templates/sailing/src/render/materials.ts +50 -15
  313. package/templates/sailing/src/render/ocean.ts +647 -60
  314. package/templates/sailing/src/render/palette.ts +16 -12
  315. package/templates/sailing/src/render/postprocessing.ts +12 -2
  316. package/templates/sailing/src/render/props.ts +316 -442
  317. package/templates/sailing/src/render/quality.ts +14 -4
  318. package/templates/sailing/src/render/sky.ts +116 -23
  319. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  320. package/templates/sailing/src/scenes/Boot.ts +21 -0
  321. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  322. package/templates/sailing/src/state.ts +6 -0
  323. package/templates/sailing/src/ui/Hud.tsx +41 -9
  324. package/templates/sailing/threenative.config.ts +14 -1
  325. package/templates/sailing/vite.config.ts +4 -1
  326. package/templates/shooter/AGENTS.md +29 -44
  327. package/templates/shooter/CLAUDE.md +29 -44
  328. package/templates/shooter/index.html +1 -0
  329. package/templates/shooter/package.json +14 -8
  330. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  331. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  332. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  333. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  334. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  335. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  336. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  337. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  338. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  339. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  340. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  341. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  342. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  343. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  344. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  345. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  346. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  347. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  348. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  349. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  350. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  351. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  352. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  353. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  354. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  355. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  356. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  357. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  358. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  359. package/templates/shooter/playtests/performance.playtest.json +62 -26
  360. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  361. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  362. package/templates/shooter/playtests/survives.playtest.json +36 -30
  363. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  364. package/templates/shooter/src/entities/Breakables.ts +412 -0
  365. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  366. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  367. package/templates/shooter/src/entities/Rifle.ts +442 -0
  368. package/templates/shooter/src/entities/Target.ts +199 -83
  369. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  370. package/templates/shooter/src/game.ts +75 -41
  371. package/templates/shooter/src/main.ts +0 -1
  372. package/templates/shooter/src/postPhysics.ts +36 -0
  373. package/templates/shooter/src/render/camera.ts +78 -74
  374. package/templates/shooter/src/render/decals.ts +142 -82
  375. package/templates/shooter/src/render/facade.ts +1373 -0
  376. package/templates/shooter/src/render/gunfx.ts +704 -0
  377. package/templates/shooter/src/render/lighting.ts +52 -38
  378. package/templates/shooter/src/render/loading.ts +2 -2
  379. package/templates/shooter/src/render/materials.ts +100 -88
  380. package/templates/shooter/src/render/occlusion.ts +108 -0
  381. package/templates/shooter/src/render/palette.ts +10 -10
  382. package/templates/shooter/src/render/palm.ts +455 -0
  383. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  384. package/templates/shooter/src/render/postprocessing.ts +15 -3
  385. package/templates/shooter/src/render/quality.ts +40 -82
  386. package/templates/shooter/src/render/scale.ts +148 -15
  387. package/templates/shooter/src/render/shapes.ts +138 -613
  388. package/templates/shooter/src/render/sky.ts +35 -35
  389. package/templates/shooter/src/render/town-schematic.ts +120 -0
  390. package/templates/shooter/src/render/town.ts +986 -0
  391. package/templates/shooter/src/render/townMaterials.ts +160 -0
  392. package/templates/shooter/src/render/vehicles.ts +741 -0
  393. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  394. package/templates/shooter/src/scenes/Play.ts +727 -650
  395. package/templates/shooter/src/state.ts +26 -41
  396. package/templates/shooter/src/style.css +207 -11
  397. package/templates/shooter/src/surfaces.ts +131 -0
  398. package/templates/shooter/src/ui/App.tsx +9 -10
  399. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  400. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  401. package/templates/shooter/src/ui/Hud.tsx +428 -39
  402. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  403. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  404. package/templates/shooter/src/ui/main.tsx +2 -3
  405. package/templates/shooter/threenative.config.ts +14 -1
  406. package/templates/shooter/vite.config.ts +4 -1
  407. package/templates/starter/AGENTS.md +20 -20
  408. package/templates/starter/CLAUDE.md +20 -20
  409. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  410. package/templates/starter/package.json +15 -9
  411. package/templates/starter/playtests/play.playtest.json +2 -1
  412. package/templates/starter/playtests/{restart.playtest.json → production-readiness.playtest.json} +17 -12
  413. package/templates/starter/playtests/survives.playtest.json +1 -1
  414. package/templates/starter/src/conventions.ts +6 -3
  415. package/templates/starter/src/entities/Goal.ts +35 -42
  416. package/templates/starter/src/entities/Player.ts +99 -16
  417. package/templates/starter/src/render/arena.ts +131 -0
  418. package/templates/starter/src/render/lighting.ts +27 -44
  419. package/templates/starter/src/render/materials.ts +164 -35
  420. package/templates/starter/src/render/palette.ts +16 -16
  421. package/templates/starter/src/render/postprocessing.ts +6 -7
  422. package/templates/starter/src/render/quality.ts +43 -101
  423. package/templates/starter/src/render/shapes.ts +1 -1
  424. package/templates/starter/src/render/sky.ts +39 -45
  425. package/templates/starter/src/render/touch-controls.ts +3 -1
  426. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  427. package/templates/starter/src/scenes/Play.ts +82 -81
  428. package/templates/starter/src/ui/Hud.tsx +2 -2
  429. package/templates/starter/src/ui/Menu.tsx +5 -1
  430. package/templates/starter/threenative.config.ts +14 -1
  431. package/templates/starter/vite.config.ts +4 -1
  432. package/templates/tower-defense/.codex/config.toml +19 -0
  433. package/templates/tower-defense/.cursor/mcp.json +32 -0
  434. package/templates/tower-defense/.gemini/settings.json +32 -0
  435. package/templates/tower-defense/.mcp.json +32 -0
  436. package/templates/tower-defense/.vscode/mcp.json +36 -0
  437. package/templates/tower-defense/.zed/settings.json +36 -0
  438. package/templates/{defense → tower-defense}/AGENTS.md +16 -14
  439. package/templates/{defense → tower-defense}/CLAUDE.md +16 -14
  440. package/templates/tower-defense/README.md +16 -0
  441. package/templates/tower-defense/index.html +12 -0
  442. package/templates/tower-defense/kit.json +7 -0
  443. package/templates/tower-defense/opencode.json +41 -0
  444. package/templates/tower-defense/package.json +56 -0
  445. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  446. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  447. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  448. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  449. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  450. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  451. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  452. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  453. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  454. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  455. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  456. package/templates/tower-defense/src/balance.ts +187 -0
  457. package/templates/tower-defense/src/board/Board.ts +100 -0
  458. package/templates/tower-defense/src/board/Route.ts +84 -0
  459. package/templates/tower-defense/src/camera-rig.ts +62 -0
  460. package/templates/tower-defense/src/economy.ts +64 -0
  461. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  462. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  463. package/templates/tower-defense/src/game.ts +72 -0
  464. package/templates/tower-defense/src/intents.ts +21 -0
  465. package/templates/tower-defense/src/main.ts +15 -0
  466. package/templates/tower-defense/src/physics.ts +6 -0
  467. package/templates/tower-defense/src/render/camera.ts +38 -0
  468. package/templates/tower-defense/src/render/lighting.ts +42 -0
  469. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  470. package/templates/tower-defense/src/render/materials.ts +103 -0
  471. package/templates/tower-defense/src/render/palette.ts +58 -0
  472. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  473. package/templates/tower-defense/src/render/quality.ts +128 -0
  474. package/templates/tower-defense/src/render/shapes.ts +550 -0
  475. package/templates/tower-defense/src/render/sky.ts +27 -0
  476. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  477. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  478. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  479. package/templates/tower-defense/src/state.ts +88 -0
  480. package/templates/tower-defense/src/style.css +137 -0
  481. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  482. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  483. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  484. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  485. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  486. package/templates/tower-defense/src/ui/main.tsx +14 -0
  487. package/templates/tower-defense/src/waves.ts +90 -0
  488. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  489. package/templates/tower-defense/vite.config.ts +41 -0
  490. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  491. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  492. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -45
  493. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  494. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -57
  495. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -42
  496. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  497. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  498. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  499. package/agent-files/AGENT-ROLES.md +0 -26
  500. package/templates/action-rpg/src/render/shapes.ts +0 -269
  501. package/templates/action-rpg/src/render/types.ts +0 -3
  502. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  503. package/templates/defense/README.md +0 -10
  504. package/templates/defense/kit.json +0 -7
  505. package/templates/defense/playtests/leak.playtest.json +0 -23
  506. package/templates/defense/playtests/placement.playtest.json +0 -40
  507. package/templates/defense/playtests/scan.playtest.json +0 -20
  508. package/templates/defense/playtests/survive.playtest.json +0 -45
  509. package/templates/defense/playtests/survives.playtest.json +0 -36
  510. package/templates/defense/src/attackers/Attacker.ts +0 -120
  511. package/templates/defense/src/board/Route.ts +0 -94
  512. package/templates/defense/src/conventions.ts +0 -18
  513. package/templates/defense/src/economy.ts +0 -36
  514. package/templates/defense/src/entities/Player.ts +0 -52
  515. package/templates/defense/src/game.ts +0 -51
  516. package/templates/defense/src/physics.ts +0 -13
  517. package/templates/defense/src/placement/Buildable.ts +0 -49
  518. package/templates/defense/src/render/camera.ts +0 -16
  519. package/templates/defense/src/render/lighting.ts +0 -37
  520. package/templates/defense/src/render/materials.ts +0 -22
  521. package/templates/defense/src/render/palette.ts +0 -28
  522. package/templates/defense/src/render/quality.ts +0 -170
  523. package/templates/defense/src/render/shapes.ts +0 -246
  524. package/templates/defense/src/render/sky.ts +0 -45
  525. package/templates/defense/src/scenes/Boot.ts +0 -12
  526. package/templates/defense/src/scenes/Defense.ts +0 -231
  527. package/templates/defense/src/state.ts +0 -56
  528. package/templates/defense/src/towers/Tower.ts +0 -95
  529. package/templates/defense/src/towers/targeting.ts +0 -53
  530. package/templates/defense/src/ui/Hud.tsx +0 -62
  531. package/templates/defense/src/ui/Menu.tsx +0 -7
  532. package/templates/defense/src/waves.ts +0 -40
  533. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  534. package/templates/minimal/src/render/hud.ts +0 -69
  535. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  536. package/templates/platformer/playtests/chase.playtest.json +0 -21
  537. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  538. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  539. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  540. package/templates/platformer/playtests/physics.playtest.json +0 -14
  541. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  542. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  543. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  544. package/templates/platformer/src/conventions.ts +0 -18
  545. package/templates/platformer/src/entities/Character.ts +0 -286
  546. package/templates/platformer/src/entities/Chaser.ts +0 -118
  547. package/templates/platformer/src/entities/Patrol.ts +0 -93
  548. package/templates/platformer/src/level/Platform.ts +0 -46
  549. package/templates/platformer/src/render/rig.ts +0 -60
  550. package/templates/platformer/src/render/terrain.ts +0 -31
  551. package/templates/platformer/src/scenes/Level.ts +0 -241
  552. package/templates/puzzle/README.md +0 -43
  553. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  554. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  555. package/templates/puzzle/src/conventions.ts +0 -25
  556. package/templates/puzzle/src/entities/Ball.ts +0 -70
  557. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  558. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  559. package/templates/puzzle/src/physics.ts +0 -19
  560. package/templates/puzzle/src/room.ts +0 -83
  561. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  562. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  563. package/templates/shooter/playtests/combat.playtest.json +0 -48
  564. package/templates/shooter/playtests/fail.playtest.json +0 -31
  565. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  566. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  567. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  568. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  569. package/templates/shooter/src/combat/damage.ts +0 -40
  570. package/templates/shooter/src/conventions.ts +0 -51
  571. package/templates/shooter/src/entities/Pickup.ts +0 -70
  572. package/templates/shooter/src/entities/Player.ts +0 -310
  573. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  574. package/templates/shooter/src/playtest-events.ts +0 -15
  575. package/templates/shooter/src/render/touch-controls.ts +0 -305
  576. package/templates/shooter/src/render/types.ts +0 -3
  577. package/templates/shooter/src/render/ui.css +0 -330
  578. package/templates/shooter/src/render/ui.ts +0 -75
  579. package/templates/shooter/src/render/vfx.ts +0 -215
  580. package/templates/shooter/src/ui/Menu.tsx +0 -41
  581. package/templates/shooter/src/waves.ts +0 -50
  582. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  583. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  584. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  585. package/templates/starter/playtests/assets.playtest.json +0 -65
  586. package/templates/starter/playtests/buffer.playtest.json +0 -79
  587. package/templates/starter/playtests/cloth.playtest.json +0 -113
  588. package/templates/starter/playtests/coyote.playtest.json +0 -87
  589. package/templates/starter/playtests/gameover.playtest.json +0 -66
  590. package/templates/starter/playtests/goal.playtest.json +0 -67
  591. package/templates/starter/playtests/look.playtest.json +0 -175
  592. package/templates/starter/playtests/models-baseline.png +0 -0
  593. package/templates/starter/playtests/models.playtest.json +0 -74
  594. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  595. package/templates/starter/playtests/odometer.playtest.json +0 -54
  596. package/templates/starter/playtests/seed.playtest.json +0 -54
  597. package/templates/starter/playtests/textures-baseline.png +0 -0
  598. package/templates/starter/playtests/textures.playtest.json +0 -74
  599. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  600. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  601. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  602. package/templates/starter/src/render/coast.ts +0 -199
  603. package/templates/starter/src/render/hero.ts +0 -88
  604. package/templates/starter/src/render/implicitSurface.ts +0 -199
  605. package/templates/starter/src/render/kuwahara.ts +0 -174
  606. package/templates/starter/src/render/outline.ts +0 -141
  607. package/templates/starter/src/render/painterly.ts +0 -86
  608. package/templates/starter/src/render/rockRidge.ts +0 -198
  609. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  610. package/templates/starter/src/render/scenery.ts +0 -40
  611. package/templates/starter/src/render/textureLifetime.ts +0 -53
  612. package/templates/starter/src/render/water.ts +0 -38
  613. package/templates/starter/src/render/watercolor.ts +0 -85
  614. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  615. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  616. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  617. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  618. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  619. /package/templates/{defense → rts}/.mcp.json +0 -0
  620. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  621. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  622. /package/templates/{defense → rts}/index.html +0 -0
  623. /package/templates/{defense → rts}/opencode.json +0 -0
  624. /package/templates/{defense → rts}/src/main.ts +0 -0
  625. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  626. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  627. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  628. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  629. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  630. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  631. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -1,46 +1,175 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  // ThreeNative does not read this file.
3
- import { Color, DoubleSide, MeshBasicMaterial, MeshStandardMaterial, type Texture } from "three";
3
+ //
4
+ // The prototype look every engine ships a new project with: a metre grid on neutral greys, one
5
+ // saturated colour for things you can touch, and a metal figure. It reads as "a real engine" only
6
+ // because `sky.ts` gives every surface an environment to reflect — roughness then decides how much
7
+ // sky a surface mirrors, so keep it varied between neighbours.
8
+ import {
9
+ type BufferGeometry,
10
+ DataTexture,
11
+ DoubleSide,
12
+ Float32BufferAttribute,
13
+ LinearMipmapLinearFilter,
14
+ MeshStandardMaterial,
15
+ RepeatWrapping,
16
+ SRGBColorSpace,
17
+ type Texture,
18
+ Vector2,
19
+ Vector3,
20
+ } from "three";
4
21
  import { MeshBasicNodeMaterial } from "three/webgpu";
5
22
  import { palette } from "./palette.js";
6
23
 
7
- export function createMaterials() {
8
- return {
9
- floor: new MeshStandardMaterial({ color: palette.floor, roughness: 0.9, metalness: 0 }),
10
- player: new MeshStandardMaterial({ color: palette.player, roughness: 0.48, metalness: 0.04 }),
11
- crate: new MeshStandardMaterial({ color: palette.crate, roughness: 0.76, metalness: 0 }),
12
- /** The hero's hat, scarf and boots: the one warm accent on a cool coast. */
13
- heroAccent: new MeshStandardMaterial({
14
- color: palette.crate,
15
- roughness: 0.6,
16
- metalness: 0.02,
17
- }),
18
- /** The hero's pack, gloves, legs and visor. Reads as leather at this size. */
19
- heroDark: new MeshStandardMaterial({ color: 0x4a4038, roughness: 0.8, metalness: 0.02 }),
20
- // The flagpole only. The island under it is `floor`, so the far side reads as more of
21
- // the same ground and the gap between them stays legible as a gap.
22
- goal: new MeshStandardMaterial({ color: palette.accent, roughness: 0.45, metalness: 0.04 }),
23
- // The columns under the ledge: lit, matte, near-black, so the drop has a below.
24
- rock: new MeshStandardMaterial({ color: palette.skyLow, roughness: 0.98, metalness: 0 }),
25
- // The ridge on the horizon is unlit on purpose. A standard material there takes the
26
- // warm key like everything else and the backdrop stops being a backdrop; a flat colour
27
- // between the two sky stops stays a silhouette from every light angle, and the scene's
28
- // fog still fades it with distance.
29
- ridge: new MeshBasicMaterial({ color: new Color(palette.skyLow).multiplyScalar(0.72) }),
30
- flower: new MeshStandardMaterial({ color: palette.crate, roughness: 0.6, metalness: 0 }),
31
- grass: new MeshStandardMaterial({ color: palette.floor, roughness: 0.95, metalness: 0 }),
32
- grassDark: new MeshStandardMaterial({
33
- color: new Color(palette.floor).multiplyScalar(0.58),
34
- roughness: 0.98,
35
- metalness: 0,
36
- }),
37
- sand: new MeshStandardMaterial({ color: palette.accent, roughness: 0.96, metalness: 0 }),
38
- /** The far sandbar's beach rim: the same sand as the main island's shore. */
39
- shore: new MeshStandardMaterial({ color: palette.accent, roughness: 0.96, metalness: 0 }),
40
- shoreline: new MeshStandardMaterial({ color: palette.player, roughness: 0.9, metalness: 0 }),
24
+ /**
25
+ * One metre of grid: a heavy line on the metre, faint lines every 25 cm, a faint per-texel grain so
26
+ * large areas do not band. Built from bytes rather than a canvas so it runs the same in the browser
27
+ * and in the native host.
28
+ */
29
+ function gridTexture(base: number, line: number, size = 256): DataTexture {
30
+ const data = new Uint8Array(size * size * 4);
31
+ const minorEvery = size / 4;
32
+ let seed = 7;
33
+ for (let y = 0; y < size; y += 1) {
34
+ for (let x = 0; x < size; x += 1) {
35
+ const major = x < 3 || y < 3;
36
+ const minor = x % minorEvery < 1 || y % minorEvery < 1;
37
+ const weight = major ? 0.92 : minor ? 0.22 : 0;
38
+ seed = (seed * 16807) % 2147483647;
39
+ const grain = 1 + (seed / 2147483647 - 0.5) * 0.04;
40
+ const index = (y * size + x) * 4;
41
+ for (let channel = 0; channel < 3; channel += 1) {
42
+ const shift = 16 - channel * 8;
43
+ const from = ((base >> shift) & 0xff) * grain;
44
+ const to = (line >> shift) & 0xff;
45
+ data[index + channel] = Math.min(255, Math.round(from * (1 - weight) + to * weight));
46
+ }
47
+ data[index + 3] = 255;
48
+ }
49
+ }
50
+ const texture = new DataTexture(data, size, size);
51
+ texture.colorSpace = SRGBColorSpace;
52
+ texture.wrapS = RepeatWrapping;
53
+ texture.wrapT = RepeatWrapping;
54
+ texture.generateMipmaps = true;
55
+ texture.minFilter = LinearMipmapLinearFilter;
56
+ texture.anisotropy = 16;
57
+ texture.needsUpdate = true;
58
+ return texture;
59
+ }
60
+
61
+ const _normal = new Vector3();
62
+
63
+ /**
64
+ * A faint cast-concrete grain as a tangent-space normal map: two octaves of smoothed value noise,
65
+ * tiling every metre like the grid. It is what stops a large flat face reading as an untextured
66
+ * blockout under a low sun — the light breaks up across it instead of sliding off in one tone.
67
+ * Bytes, not a file, so it costs nothing to ship and runs on every target.
68
+ */
69
+ function grainNormalTexture(size = 128): DataTexture {
70
+ const cells = [8, 32];
71
+ const lattice = cells.map((count) => {
72
+ const values = new Float32Array(count * count);
73
+ let seed = count * 7919;
74
+ for (let index = 0; index < values.length; index += 1) {
75
+ seed = (seed * 16807) % 2147483647;
76
+ values[index] = seed / 2147483647;
77
+ }
78
+ return { count, values };
79
+ });
80
+ const height = (x: number, y: number): number => {
81
+ let total = 0;
82
+ for (const [octave, { count, values }] of lattice.entries()) {
83
+ const u = (x / size) * count;
84
+ const v = (y / size) * count;
85
+ const x0 = Math.floor(u);
86
+ const y0 = Math.floor(v);
87
+ const fx = u - x0;
88
+ const fy = v - y0;
89
+ const sx = fx * fx * (3 - 2 * fx);
90
+ const sy = fy * fy * (3 - 2 * fy);
91
+ const at = (i: number, j: number): number =>
92
+ values[(((j % count) + count) % count) * count + (((i % count) + count) % count)] ?? 0;
93
+ const top = at(x0, y0) + (at(x0 + 1, y0) - at(x0, y0)) * sx;
94
+ const bottom = at(x0, y0 + 1) + (at(x0 + 1, y0 + 1) - at(x0, y0 + 1)) * sx;
95
+ total += (top + (bottom - top) * sy) * (octave === 0 ? 1 : 0.5);
96
+ }
97
+ return total;
41
98
  };
99
+ const data = new Uint8Array(size * size * 4);
100
+ for (let y = 0; y < size; y += 1) {
101
+ for (let x = 0; x < size; x += 1) {
102
+ const dx = height(x + 1, y) - height(x - 1, y);
103
+ const dy = height(x, y + 1) - height(x, y - 1);
104
+ _normal.set(-dx * 4, -dy * 4, 1).normalize();
105
+ const index = (y * size + x) * 4;
106
+ data[index] = Math.round((_normal.x * 0.5 + 0.5) * 255);
107
+ data[index + 1] = Math.round((_normal.y * 0.5 + 0.5) * 255);
108
+ data[index + 2] = Math.round((_normal.z * 0.5 + 0.5) * 255);
109
+ data[index + 3] = 255;
110
+ }
111
+ }
112
+ const texture = new DataTexture(data, size, size);
113
+ texture.wrapS = RepeatWrapping;
114
+ texture.wrapT = RepeatWrapping;
115
+ texture.generateMipmaps = true;
116
+ texture.minFilter = LinearMipmapLinearFilter;
117
+ texture.needsUpdate = true;
118
+ return texture;
42
119
  }
43
120
 
121
+ const grain = grainNormalTexture();
122
+
123
+ /**
124
+ * Rewrites a geometry's UVs as world metres, projected along each face's dominant axis, so one grid
125
+ * tile is one metre on every face of every prop regardless of its size. Call it after the geometry
126
+ * is translated into place (merged geometry included), before it is given to a mesh.
127
+ */
128
+ export function worldGridUVs<T extends BufferGeometry>(geometry: T): T {
129
+ const position = geometry.getAttribute("position");
130
+ const normal = geometry.getAttribute("normal");
131
+ const uv = new Float32Array(position.count * 2);
132
+ for (let index = 0; index < position.count; index += 1) {
133
+ _normal.fromBufferAttribute(normal, index);
134
+ const x = position.getX(index);
135
+ const y = position.getY(index);
136
+ const z = position.getZ(index);
137
+ const ax = Math.abs(_normal.x);
138
+ const ay = Math.abs(_normal.y);
139
+ const az = Math.abs(_normal.z);
140
+ const [u, v] = ay >= ax && ay >= az ? [x, z] : ax >= az ? [z, y] : [x, y];
141
+ uv[index * 2] = u;
142
+ uv[index * 2 + 1] = v;
143
+ }
144
+ geometry.setAttribute("uv", new Float32BufferAttribute(uv, 2));
145
+ return geometry;
146
+ }
147
+
148
+ /** Light grid: platform tops and the ground. */
149
+ export const floorMaterial = new MeshStandardMaterial({
150
+ map: gridTexture(palette.floor, palette.gridLine),
151
+ normalMap: grain,
152
+ normalScale: new Vector2(0.18, 0.18),
153
+ roughness: 0.62,
154
+ metalness: 0,
155
+ });
156
+
157
+ /** Dark grid: walls, pillars, platform flanks — anything structural. */
158
+ export const structureMaterial = new MeshStandardMaterial({
159
+ map: gridTexture(palette.structure, palette.gridLine),
160
+ normalMap: grain,
161
+ normalScale: new Vector2(0.18, 0.18),
162
+ roughness: 0.7,
163
+ metalness: 0,
164
+ });
165
+
166
+ /** The one saturated colour: the crate, the pickup and the flagpole — what you can touch. */
167
+ export const propMaterial = new MeshStandardMaterial({
168
+ color: palette.accent,
169
+ roughness: 0.45,
170
+ metalness: 0,
171
+ });
172
+
44
173
  /** The finish flag owns its sampled, double-sided look; SoftBody3D only drives its positions. */
45
174
  export function createPennantMaterial(texture: Texture): MeshBasicNodeMaterial {
46
175
  return new MeshBasicNodeMaterial({ map: texture, side: DoubleSide });
@@ -1,18 +1,18 @@
1
- // Generated for you. Keep the six palette roles coherent when you change the look.
1
+ // Generated for you. Keep these six palette roles coherent when you change the look.
2
+ // Neutral greys carry the light; one saturated blue marks what you can touch.
3
+ // `skyLow`/`skyHigh` are the sky photograph's own two tones, sampled from the HDR it was made
4
+ // from, so the horizon the fog fades into is the horizon the frame actually shows.
2
5
  export const palette = {
3
- skyHigh: 0x8fd5cf,
4
- skyLow: 0x28556a,
5
- floor: 0x67c878,
6
- player: 0xfff0b0,
7
- crate: 0xd86f55,
8
- accent: 0xe6c58d,
6
+ /** Light grid: platform tops and the ground the arena stands on. */
7
+ floor: 0xb4b1ae,
8
+ /** Dark grid: platform sides, walls, pillars — anything structural. */
9
+ structure: 0x747578,
10
+ /** The metre line both grids are drawn in. */
11
+ gridLine: 0x3a3a3c,
12
+ /** The one saturated colour: anything you can push, pick up or stand on. */
13
+ accent: 0x2a6cf0,
14
+ /** The sky photograph's horizon — the fog colour, and the loading screen behind the bar. */
15
+ skyLow: 0xacb1c1,
16
+ /** One stop brighter: the zenith, and the loading track. */
17
+ skyHigh: 0xc3d2e4,
9
18
  } as const;
10
-
11
- export const COAST_WAVES = [
12
- { amplitude: 0.12, direction: [1, 0.2] as const, speed: 0.52, wavelength: 7.2 },
13
- { amplitude: 0.055, detail: true, direction: [-0.35, 1] as const, speed: 0.3, wavelength: 3.3 },
14
- ] as const;
15
-
16
- export const COAST_DOMAIN_WARP = [
17
- { amplitude: 0.12, direction: [0.65, -0.35] as const, speed: 0.18, wavelength: 11 },
18
- ] as const;
@@ -17,7 +17,6 @@ import {
17
17
  createAdaptiveQuality,
18
18
  formatQualityAdaptation,
19
19
  } from "./adaptiveQuality.js";
20
- import { painterlyStageNames, painterlyStages } from "./painterly.js";
21
20
  import { type QualityTier, qualityPreset } from "./quality.js";
22
21
  import { type OutputRenderer, WorldEnvironment } from "./worldEnvironment.js";
23
22
 
@@ -41,6 +40,8 @@ export function setupPost(
41
40
  environment: IAdaptiveQualityOptions & {
42
41
  godraysLight?: DirectionalLight;
43
42
  mobile?: boolean;
43
+ /** The renderer named a software adapter; this game's answer is its `low` tier. */
44
+ software?: boolean;
44
45
  /** Forces a tier while keeping its costs observed. Unknown names throw. */
45
46
  tier?: QualityTier;
46
47
  } = {},
@@ -57,11 +58,7 @@ export function setupPost(
57
58
  // Replacement is serialized: no old graph or subscription remains alive beside the new one.
58
59
  disposeGraph?.();
59
60
  const settings = qualityPreset(policy.tier);
60
- const world = new WorldEnvironment({
61
- ...settings,
62
- authoredStageNames: painterlyStageNames(settings),
63
- authoredStages: painterlyStages(settings),
64
- });
61
+ const world = new WorldEnvironment(settings);
65
62
  const applied = world.apply(renderer, scene, camera, {
66
63
  godraysLight: environment.godraysLight,
67
64
  });
@@ -71,7 +68,9 @@ export function setupPost(
71
68
  apply();
72
69
  const source = environment.tier === undefined ? "platform" : "override";
73
70
  console.info(
74
- `TN_QUALITY_TIER ${policy.tier} mobile=${environment.mobile === true} source=${source}`,
71
+ `TN_QUALITY_TIER ${policy.tier} mobile=${environment.mobile === true} software=${
72
+ environment.software === true
73
+ } source=${source}`,
75
74
  );
76
75
  const controller = {
77
76
  debug: () => observation,
@@ -19,23 +19,15 @@
19
19
  // probe on `scene.environment`, measured at **~6.3 ms of an 18-19 ms Pixel 8 frame**. It is set
20
20
  // in `sky.ts`, not in this file.
21
21
  //
22
- import type { IPainterlyOptions } from "./painterly.js";
23
22
  import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
24
23
 
25
- /**
26
- * A preset is the framework's chain options plus this kit's own painterly knobs. The two are
27
- * separate types because they belong to different layers: `worldEnvironment.ts` is shared with
28
- * every other kit and must not know what a watercolour is.
29
- */
30
- type QualitySettings = IWorldEnvironmentOptions & IPainterlyOptions;
31
-
32
24
  /**
33
25
  * The three names this game's look comes in.
34
26
  *
35
27
  * `low` is what a phone gets and `high` what a desktop gets — those two are this template's
36
- * shipped looks, unchanged. `medium` is the rung in between for a machine that is neither: a
37
- * laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
38
- * what any of them mean.
28
+ * shipped looks. `medium` is the rung in between for a machine that is neither: a laptop iGPU, a
29
+ * handheld, a desktop that is dropping frames. Nothing outside this file decides what any of them
30
+ * mean.
39
31
  */
40
32
  export type QualityTier = "low" | "medium" | "high";
41
33
 
@@ -57,7 +49,7 @@ function isQualityTier(value: string): value is QualityTier {
57
49
  * turned out to have no effect.
58
50
  */
59
51
  export function resolveQualityTier(
60
- request: { readonly mobile?: boolean; readonly tier?: string } = {},
52
+ request: { readonly mobile?: boolean; readonly software?: boolean; readonly tier?: string } = {},
61
53
  ): QualityTier {
62
54
  const requested = request.tier;
63
55
  if (requested !== undefined) {
@@ -68,113 +60,63 @@ export function resolveQualityTier(
68
60
  }
69
61
  return requested;
70
62
  }
63
+ // A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
64
+ // game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
65
+ // drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
66
+ // fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
67
+ // `tier` above still wins over it.
68
+ if (request.software === true) return "low";
71
69
  return request.mobile === true ? "low" : "high";
72
70
  }
73
71
 
74
72
  /**
75
- * What a desktop gets: a clean coastal look with restrained painterly treatment. The expensive
76
- * screen-space gathers are deliberately off here: on a small water scene they muddy the grass and
77
- * turn the water glint into a halo instead of adding useful depth.
73
+ * The look every tier shares: a wide, faint glow on what is genuinely brighter than white — the
74
+ * sun disk, the visor — rather than a haze over the frame (a threshold under 1 blooms lit grey
75
+ * platforms and flattens contrast), a corner falloff, and the shared chain's SMAA. Antialiasing is
76
+ * on in every tier that installs a chain; see `screenSpaceAA` in `worldEnvironment.ts`.
77
+ *
78
+ * No screen-space reflections and no sharpen here, on purpose. Every surface already reflects the
79
+ * captured sky (`sky.ts`), and SSR on rough floors traced speckle into the grid; RCAS then rang the
80
+ * smooth sky gradient into visible bands. Both are one line to turn back on for a glossy scene.
78
81
  */
79
- const high: QualitySettings = {
80
- // Bloom cost: unmeasured for this authored scene; the low strength keeps water glints alive
81
- // without washing the scene in orange.
82
+ const shared: IWorldEnvironmentOptions = {
83
+ // Bloom cost: ~4.6 ms in the reference ablation — the second most expensive stage there.
82
84
  bloomEnabled: true,
83
- bloomRadius: 0.34,
84
- bloomStrength: 0.26,
85
- bloomThreshold: 0.64,
86
- denoiseEnabled: false,
87
- exposure: 1.04,
88
- ssgiEnabled: false,
89
- ssrEnabled: false,
90
- sharpenEnabled: false,
91
- // Outline cost: unmeasured; it is intentionally a soft blue-green edge, not a black
92
- // comic-book stroke.
93
- outlineEnabled: true,
94
- outlineDepthWeight: 0.32,
95
- outlineInkColor: 0x173c4a,
96
- outlineSoftness: 0.08,
97
- outlineStrength: 0.3,
98
- outlineThreshold: 0.2,
99
- // Kuwahara cost: unmeasured; the half-resolution scratch and restrained strength preserve
100
- // readable grass silhouettes.
101
- kuwaharaEnabled: true,
102
- kuwaharaRadius: 5,
103
- kuwaharaResolutionScale: 0.5,
104
- kuwaharaStrength: 0.2,
105
- // Watercolour cost: unmeasured; the low mix keeps the paper grouping from flattening the coast.
106
- watercolorEnabled: true,
107
- watercolorPaperStrength: 0.05,
108
- watercolorShadowStrength: 0.04,
109
- watercolorShadowTint: 0x7d6b62,
110
- watercolorStrength: 0.26,
111
- renderChainTier: "high",
85
+ bloomRadius: 0.6,
86
+ bloomStrength: 0.22,
87
+ bloomThreshold: 1,
88
+ exposure: 0.62,
112
89
  tonemapMode: "aces",
90
+ vignetteAmount: 0.22,
113
91
  };
114
92
 
115
93
  /**
116
- * Medium keeps the same readable coast, with a smaller paint radius and a little less colour
117
- * grouping for machines that need a cheaper frame.
94
+ * What a desktop gets: contact occlusion on top — the dark line where a foot meets the platform
95
+ * and a wall meets the ground, most of what separates "objects in a world" from "objects pasted on
96
+ * a background". Gathered at full resolution and denoised: at half, the upsample left a grain
97
+ * around every foot.
118
98
  */
119
- const medium: QualitySettings = {
120
- // Bloom cost: unmeasured for this authored scene; keep only a small highlight lift.
121
- bloomEnabled: true,
122
- bloomRadius: 0.3,
123
- bloomStrength: 0.22,
124
- bloomThreshold: 0.68,
125
- denoiseEnabled: false,
126
- exposure: 1.03,
127
- ssgiEnabled: false,
128
- ssrEnabled: false,
129
- sharpenEnabled: false,
130
- // Outline cost: unmeasured; keep its edge narrow on the cheaper tier.
131
- outlineEnabled: true,
132
- outlineDepthWeight: 0.28,
133
- outlineInkColor: 0x173c4a,
134
- outlineSoftness: 0.08,
135
- outlineStrength: 0.26,
136
- outlineThreshold: 0.22,
137
- // Kuwahara cost: unmeasured; radius three keeps the water and grass readable.
138
- kuwaharaEnabled: true,
139
- kuwaharaRadius: 3,
140
- kuwaharaResolutionScale: 0.5,
141
- kuwaharaStrength: 0.16,
142
- // Watercolour cost: unmeasured; fewer bands and a low mix preserve the coast's value steps.
143
- watercolorEnabled: true,
144
- watercolorLevels: 6,
145
- watercolorPaperStrength: 0.04,
146
- watercolorShadowStrength: 0.03,
147
- watercolorShadowTint: 0x7d6b62,
148
- watercolorStrength: 0.22,
149
- renderChainTier: "medium",
150
- tonemapMode: "aces",
99
+ const high: IWorldEnvironmentOptions = {
100
+ ...shared,
101
+ // GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
102
+ gtaoEnabled: true,
103
+ gtaoRadius: 0.35,
104
+ renderChainTier: "high",
151
105
  };
152
106
 
153
107
  /**
154
- * What a phone gets: the cleanest version of the coastal look. Authored paint is omitted to keep
155
- * the water mesh and touch controls responsive.
108
+ * The rung in between: the same occlusion at half the directions. Saving unmeasured, and the
109
+ * chain's own antialiasing one notch cheaper.
156
110
  */
157
- const low: QualitySettings = {
158
- // Bloom cost: unmeasured for this authored scene; this is the phone-safe highlight lift.
159
- bloomEnabled: true,
160
- bloomRadius: 0.28,
161
- bloomStrength: 0.18,
162
- bloomThreshold: 0.72,
163
- exposure: 1.02,
164
- sharpenEnabled: false,
165
- // The low tier omits authored paint by name: no outline, scratch target, or paper graph is
166
- // built on the phone path.
167
- outlineEnabled: false,
168
- kuwaharaEnabled: false,
169
- watercolorEnabled: false,
170
- renderChainTier: "low",
171
- tonemapMode: "aces",
172
- };
111
+ const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8, renderChainTier: "medium" };
112
+
113
+ /** What a phone gets: bloom, vignette and the tone curve, nothing screen-space. */
114
+ const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
173
115
 
174
- const QUALITY_PRESETS: Record<QualityTier, QualitySettings> = { high, low, medium };
116
+ const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
175
117
 
176
118
  /** The stages and strengths a tier turns on. Throws on a name that is not a tier. */
177
- export function qualityPreset(tier: string): QualitySettings {
119
+ export function qualityPreset(tier: string): IWorldEnvironmentOptions {
178
120
  const preset = QUALITY_PRESETS[tier as QualityTier];
179
121
  if (preset === undefined) {
180
122
  throw new Error(
@@ -128,7 +128,7 @@ export function spike(
128
128
  // `createRandom` the framework already exports — same multiplier, same increment, same
129
129
  // sequence. It is gone. Nothing in this folder may import a framework package (that is what
130
130
  // keeps `src/render/` portable Three.js), so a scene builds the seeded source and hands it
131
- // down: see `createScenery` below and its caller in `src/scenes/Play.ts`.
131
+ // down: see `createRandom` in `src/scenes/Play.ts`.
132
132
  //
133
133
  // Never `Math.random` for anything the world is built from. The world has to be byte-identical
134
134
  // on every reload or a screenshot diff cannot tell a bug from a reroll, and `ctx.random` is
@@ -1,56 +1,50 @@
1
1
  // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
2
  // ThreeNative does not read this file.
3
+ //
4
+ // The sky is a photograph: `assets/sky.jpg`, Poly Haven's "Kloofendal 48d Partly Cloudy (Pure Sky)"
5
+ // by Greg Zaal and Jarod Guest, CC0 (https://polyhaven.com/a/kloofendal_48d_partly_cloudy_puresky).
6
+ // The same image is the background, the environment light every surface reflects and is filled by,
7
+ // and — through `SUN_DIRECTION` — the direction the sun's shadows fall. Swap the file for any
8
+ // equirectangular sky and re-aim `SUN_DIRECTION` at its sun.
3
9
  import {
4
- BackSide,
5
- BufferAttribute,
6
- Color,
7
- type ColorRepresentation,
8
- Fog,
9
- MathUtils,
10
- Mesh,
11
- MeshBasicMaterial,
10
+ EquirectangularReflectionMapping,
11
+ FogExp2,
12
+ SRGBColorSpace,
12
13
  type Scene,
13
- SphereGeometry,
14
+ type Texture,
15
+ Vector3,
14
16
  } from "three";
15
17
  import { palette } from "./palette.js";
16
18
 
17
- type SkyOptions = { readonly bottom: ColorRepresentation; readonly top: ColorRepresentation };
19
+ /**
20
+ * How the JPEG was made from the 4k HDR: linear radiance × 0.4, clipped, sRGB-encoded — so white
21
+ * in the file is 2.5 in the sky. Multiplying back restores the HDR brightness of the clouds; the sun
22
+ * disk itself is clipped, which is why the sun is a light (`lighting.ts`) and not a texel.
23
+ */
24
+ const SKY_RANGE = 2.5;
18
25
 
19
- export function setupSky(scene: Scene, options?: SkyOptions): void {
20
- const resolved = options ?? { bottom: palette.skyLow, top: palette.skyHigh };
21
- if (resolved.top === undefined || resolved.bottom === undefined)
22
- throw new TypeError("setupSky requires both top and bottom colors.");
26
+ /** Unit vector toward the photographed sun: 47.9° up, measured from the source HDR. */
27
+ export const SUN_DIRECTION = new Vector3(0.555, 0.742, 0.38).normalize();
23
28
 
24
- const top = new Color(resolved.top);
25
- const bottom = new Color(resolved.bottom);
26
- const radius = 90;
27
- const geometry = new SphereGeometry(radius, 24, 12);
28
- const positions = geometry.getAttribute("position");
29
- const colors = new Float32Array(positions.count * 3);
30
- const color = new Color();
31
- for (let index = 0; index < positions.count; index += 1) {
32
- const height = MathUtils.clamp((positions.getY(index) / radius + 0.2) / 0.65, 0, 1);
33
- color.copy(bottom).lerp(top, height);
34
- colors.set([color.r, color.g, color.b], index * 3);
29
+ export function setupSky(scene: Scene, sky: Texture, software = false): void {
30
+ sky.mapping = EquirectangularReflectionMapping;
31
+ sky.colorSpace = SRGBColorSpace;
32
+ scene.background = sky;
33
+ scene.backgroundIntensity = SKY_RANGE;
34
+ // three prefilters an equirectangular `scene.environment` itself (PMREM), on WebGPU and WebGL.
35
+ // It is what makes a standard material read as a material: sky-blue fill on faces the sun
36
+ // misses, and a sky to reflect, sharper as roughness drops.
37
+ //
38
+ // Not on a software adapter. PMREM-filtering a 4096x2048 photo keeps a CPU rasteriser's GPU
39
+ // process busy past its watchdog and the next pipeline compiles die with the device (measured on
40
+ // four cores: a 28 s hitch and two failed pipelines with it on, 37 pipelines in 11 s with it
41
+ // off). That lane is not render evidence, so it gives up the fill light.
42
+ if (!software) {
43
+ scene.environment = sky;
44
+ scene.environmentIntensity = SKY_RANGE;
35
45
  }
36
- geometry.setAttribute("color", new BufferAttribute(colors, 3));
37
- const dome = new Mesh(
38
- geometry,
39
- // The dome is radius 90 and the fog below ends at 180, so without `fog: false` the whole
40
- // dome sits past the far plane and renders as one flat fog-coloured wash — the gradient
41
- // authored just above never reaches the screen.
42
- new MeshBasicMaterial({ fog: false, side: BackSide, toneMapped: false, vertexColors: true }),
43
- );
44
- // The dome is authored at the origin and never moves; freeze only this
45
- // known-static render object, leaving gameplay transforms under user control.
46
- dome.updateMatrix();
47
- dome.matrixAutoUpdate = false;
48
- dome.frustumCulled = false;
49
- scene.background = top;
50
- // Fog starting 18 units out washes the mid-ground, which is where a platformer puts the next
51
- // jump. A blind judge marked a build down for exactly that in round 9: "the distance fogs to
52
- // near-white". Push the near plane past the playable middle distance and fade toward the
53
- // horizon instead. Tune both numbers to your level — this is your file.
54
- scene.fog = new Fog(bottom, 70, 180);
55
- scene.add(dome);
46
+ // Almost nothing inside the arena (1.4% at 30 m), and the ground gone into the horizon by a
47
+ // kilometre — so the floor meets the sky instead of ending at a line. The colour is the
48
+ // photograph's own horizon, sampled from the same HDR, so the fade lands where the sky is.
49
+ scene.fog = new FogExp2(palette.skyLow, 0.003);
56
50
  }
@@ -75,7 +75,9 @@ export class TouchControls {
75
75
 
76
76
  constructor(camera: PerspectiveCamera) {
77
77
  this.#camera = camera;
78
- this.#idleMaterial = overlayMaterial(palette.floor, 0.34);
78
+ // The idle rings read against grass and sand, so they take the sky's own light tone: a green
79
+ // ring vanishes into the island, and the pressed accent is the one colour nothing else uses.
80
+ this.#idleMaterial = overlayMaterial(palette.skyHigh, 0.34);
79
81
  this.#activeMaterial = overlayMaterial(palette.accent, 0.6);
80
82
  this.#moveBase = ringMesh(MOVE_RADIUS, this.#idleMaterial);
81
83
  this.#moveKnob = new Mesh(new CircleGeometry(28, 24), this.#activeMaterial);