create-threenative 0.2.6 → 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 (622) hide show
  1. package/README.md +2 -2
  2. package/agent-docs/references/build-profiles.md +126 -0
  3. package/agent-docs/references/capability-reference.md +431 -20
  4. package/agent-docs/references/performance-basics.md +8 -5
  5. package/agent-docs/references/sculpt-from-a-reference.md +1 -1
  6. package/agent-docs/references/trace-a-slow-frame.md +1 -1
  7. package/agent-docs/references/visual-baseline.md +8 -4
  8. package/agent-files/.agents/skills/file-engine-bug/SKILL.md +15 -4
  9. package/agent-files/.agents/skills/threenative-assets/SKILL.md +5 -5
  10. package/agent-files/.agents/skills/threenative-capabilities/SKILL.md +1 -1
  11. package/agent-files/.agents/skills/threenative-context/SKILL.md +1 -1
  12. package/agent-files/.agents/skills/threenative-performance/SKILL.md +3 -3
  13. package/agent-files/.agents/skills/threenative-playtest/SKILL.md +1 -1
  14. package/agent-files/.agents/skills/threenative-ui/SKILL.md +1 -1
  15. package/agent-files/.agents/skills/threenative-visuals/SKILL.md +4 -4
  16. package/capabilities.json +555 -21
  17. package/dist/index.d.ts +30 -1
  18. package/dist/index.js +294 -55
  19. package/dist/threenative.js +714 -154
  20. package/package.json +6 -6
  21. package/template-assets/assets/mannequin-combat.glb +0 -0
  22. package/template-assets/assets/mannequin.glb +0 -0
  23. package/template-assets/assets/player-viewmodel.glb +0 -0
  24. package/template-assets/assets/sky.jpg +0 -0
  25. package/template-assets/clearwater/README.md +141 -0
  26. package/template-assets/clearwater/install.mjs +50 -0
  27. package/template-assets/clearwater/src/clearwater.ts +180 -0
  28. package/template-assets/clearwater/src/clearwaterDemo.ts +28 -0
  29. package/template-assets/clearwater/src/clearwaterLifetime.ts +28 -0
  30. package/{LICENSE → template-assets/clearwater/src/render/CLEARWATER-LICENSE.txt} +4 -1
  31. package/template-assets/clearwater/src/render/clearwater.ts +278 -0
  32. package/template-assets/clearwater/src/render/clearwaterCaustics.ts +138 -0
  33. package/template-assets/clearwater/src/render/clearwaterDemo.ts +65 -0
  34. package/template-assets/clearwater/src/render/clearwaterOptics.ts +33 -0
  35. package/template-assets/clearwater/src/render/clearwaterOptions.ts +177 -0
  36. package/template-assets/clearwater/src/render/clearwaterPass.ts +51 -0
  37. package/template-assets/patches/three@0.185.1.patch +2101 -138
  38. package/template-assets/worldEnvironment.ts +52 -1
  39. package/templates/action-rpg/AGENTS.md +42 -42
  40. package/templates/action-rpg/CLAUDE.md +42 -42
  41. package/templates/action-rpg/kit.json +1 -1
  42. package/templates/action-rpg/package.json +13 -7
  43. package/templates/action-rpg/playtests/combat.playtest.json +162 -23
  44. package/templates/action-rpg/playtests/performance.playtest.json +4 -3
  45. package/templates/action-rpg/playtests/survives.playtest.json +25 -8
  46. package/templates/action-rpg/src/conventions.ts +24 -18
  47. package/templates/action-rpg/src/entities/Enemy.ts +74 -24
  48. package/templates/action-rpg/src/entities/Fighter.ts +127 -0
  49. package/templates/action-rpg/src/entities/Player.ts +102 -32
  50. package/templates/action-rpg/src/game.ts +3 -3
  51. package/templates/action-rpg/src/render/camera.ts +18 -16
  52. package/templates/action-rpg/src/render/dungeon.ts +192 -0
  53. package/templates/action-rpg/src/render/lighting.ts +45 -28
  54. package/templates/action-rpg/src/render/loading.ts +4 -4
  55. package/templates/action-rpg/src/render/materials.ts +191 -47
  56. package/templates/action-rpg/src/render/palette.ts +14 -13
  57. package/templates/action-rpg/src/render/postprocessing.ts +12 -2
  58. package/templates/action-rpg/src/render/props.ts +117 -0
  59. package/templates/action-rpg/src/render/quality.ts +40 -82
  60. package/templates/action-rpg/src/render/sky.ts +36 -13
  61. package/templates/action-rpg/src/render/touch-controls.ts +1 -1
  62. package/templates/action-rpg/src/render/worldEnvironment.ts +52 -1
  63. package/templates/action-rpg/src/scenes/Play.ts +61 -39
  64. package/templates/action-rpg/src/style.css +9 -7
  65. package/templates/action-rpg/src/ui/AbilityBar.tsx +3 -1
  66. package/templates/action-rpg/src/ui/Hud.tsx +3 -3
  67. package/templates/action-rpg/threenative.config.ts +14 -1
  68. package/templates/action-rpg/vite.config.ts +4 -1
  69. package/templates/minimal/AGENTS.md +10 -10
  70. package/templates/minimal/CLAUDE.md +10 -10
  71. package/templates/minimal/package.json +12 -6
  72. package/templates/minimal/playtests/play.playtest.json +6 -5
  73. package/templates/minimal/playtests/sky.playtest.json +27 -0
  74. package/templates/minimal/src/conventions.ts +6 -3
  75. package/templates/minimal/src/entities/Player.ts +73 -27
  76. package/templates/minimal/src/main.ts +2 -3
  77. package/templates/minimal/src/render/camera.ts +22 -4
  78. package/templates/minimal/src/render/lighting.ts +24 -48
  79. package/templates/minimal/src/render/materials.ts +158 -13
  80. package/templates/minimal/src/render/palette.ts +10 -7
  81. package/templates/minimal/src/render/postprocessing.ts +12 -25
  82. package/templates/minimal/src/render/quality.ts +35 -69
  83. package/templates/minimal/src/render/sky.ts +35 -54
  84. package/templates/minimal/src/render/touch-controls.ts +1 -1
  85. package/templates/minimal/src/render/worldEnvironment.ts +52 -1
  86. package/templates/minimal/src/scenes/Play.ts +121 -111
  87. package/templates/minimal/src/state.ts +0 -4
  88. package/templates/minimal/src/style.css +0 -10
  89. package/templates/minimal/threenative.config.ts +14 -1
  90. package/templates/minimal/vite.config.ts +4 -1
  91. package/templates/platformer/AGENTS.md +18 -56
  92. package/templates/platformer/CLAUDE.md +18 -56
  93. package/templates/platformer/kit.json +2 -2
  94. package/templates/platformer/package.json +13 -9
  95. package/templates/platformer/playtests/buffer.playtest.json +15 -5
  96. package/templates/platformer/playtests/collect.playtest.json +8 -34
  97. package/templates/platformer/playtests/coyote.playtest.json +12 -34
  98. package/templates/platformer/playtests/damage.playtest.json +40 -15
  99. package/templates/platformer/playtests/hud.playtest.json +34 -0
  100. package/templates/platformer/playtests/move.playtest.json +24 -0
  101. package/templates/platformer/playtests/performance.playtest.json +24 -7
  102. package/templates/platformer/playtests/respawn.playtest.json +46 -11
  103. package/templates/platformer/playtests/stomp.playtest.json +49 -12
  104. package/templates/platformer/playtests/survives.playtest.json +3 -19
  105. package/templates/platformer/playtests/world.playtest.json +26 -0
  106. package/templates/platformer/src/entities/Fox.ts +273 -0
  107. package/templates/platformer/src/entities/Pickup.ts +43 -60
  108. package/templates/platformer/src/entities/Walker.ts +88 -0
  109. package/templates/platformer/src/game.ts +11 -8
  110. package/templates/platformer/src/level/Checkpoints.ts +29 -16
  111. package/templates/platformer/src/level/Stage.ts +469 -0
  112. package/templates/platformer/src/render/blocks.ts +94 -0
  113. package/templates/platformer/src/render/camera.ts +28 -3
  114. package/templates/platformer/src/render/fox.ts +196 -0
  115. package/templates/platformer/src/render/lighting.ts +42 -33
  116. package/templates/platformer/src/render/materials.ts +115 -5
  117. package/templates/platformer/src/render/palette.ts +68 -53
  118. package/templates/platformer/src/render/pickups.ts +142 -0
  119. package/templates/platformer/src/render/postprocessing.ts +12 -2
  120. package/templates/platformer/src/render/props.ts +147 -0
  121. package/templates/platformer/src/render/quality.ts +47 -99
  122. package/templates/platformer/src/render/scenery.ts +172 -0
  123. package/templates/platformer/src/render/sky.ts +120 -31
  124. package/templates/platformer/src/render/touch-controls.ts +5 -2
  125. package/templates/platformer/src/render/walkers.ts +96 -0
  126. package/templates/platformer/src/render/waterfall.ts +85 -0
  127. package/templates/platformer/src/render/worldEnvironment.ts +52 -1
  128. package/templates/platformer/src/scenes/Boot.ts +3 -4
  129. package/templates/platformer/src/scenes/Play.ts +362 -0
  130. package/templates/platformer/src/state.ts +16 -14
  131. package/templates/platformer/src/style.css +9 -8
  132. package/templates/platformer/src/ui/Hud.tsx +62 -29
  133. package/templates/platformer/src/ui/Menu.tsx +2 -2
  134. package/templates/platformer/threenative.config.ts +14 -1
  135. package/templates/platformer/vite.config.ts +4 -1
  136. package/templates/puzzle/AGENTS.md +19 -20
  137. package/templates/puzzle/CLAUDE.md +19 -20
  138. package/templates/puzzle/assets/native-proof.glb +0 -0
  139. package/templates/puzzle/assets/native-proof.png +0 -0
  140. package/templates/puzzle/kit.json +1 -1
  141. package/templates/puzzle/package.json +13 -7
  142. package/templates/puzzle/playtests/axis.playtest.json +20 -0
  143. package/templates/puzzle/playtests/blocked.playtest.json +73 -0
  144. package/templates/puzzle/playtests/caused.playtest.json +65 -0
  145. package/templates/puzzle/playtests/lit.playtest.json +74 -0
  146. package/templates/puzzle/playtests/performance.playtest.json +24 -7
  147. package/templates/{starter/playtests/respawn.playtest.json → puzzle/playtests/push.playtest.json} +24 -19
  148. package/templates/puzzle/playtests/replay.playtest.json +81 -0
  149. package/templates/puzzle/playtests/restart.playtest.json +108 -0
  150. package/templates/puzzle/playtests/seal.playtest.json +98 -0
  151. package/templates/puzzle/playtests/settle.playtest.json +100 -0
  152. package/templates/puzzle/playtests/survives.playtest.json +6 -29
  153. package/templates/{starter/playtests/hot-reload.playtest.json → puzzle/playtests/travel.playtest.json} +6 -5
  154. package/templates/puzzle/src/entities/Crate.ts +99 -42
  155. package/templates/puzzle/src/entities/Seal.ts +69 -0
  156. package/templates/puzzle/src/entities/Warden.ts +135 -0
  157. package/templates/puzzle/src/game.ts +15 -11
  158. package/templates/puzzle/src/render/camera.ts +66 -31
  159. package/templates/puzzle/src/render/crateShape.ts +70 -0
  160. package/templates/puzzle/src/render/lighting.ts +41 -41
  161. package/templates/puzzle/src/render/loading.ts +4 -4
  162. package/templates/puzzle/src/render/materials.ts +131 -27
  163. package/templates/puzzle/src/render/palette.ts +19 -29
  164. package/templates/puzzle/src/render/postprocessing.ts +15 -3
  165. package/templates/puzzle/src/render/quality.ts +71 -80
  166. package/templates/puzzle/src/render/shapes.ts +109 -108
  167. package/templates/puzzle/src/render/sky.ts +18 -10
  168. package/templates/puzzle/src/render/touch-controls.ts +8 -51
  169. package/templates/puzzle/src/render/vault.ts +315 -0
  170. package/templates/puzzle/src/render/warden.ts +46 -0
  171. package/templates/puzzle/src/render/worldEnvironment.ts +52 -1
  172. package/templates/puzzle/src/scenes/Play.ts +793 -0
  173. package/templates/puzzle/src/state.ts +55 -24
  174. package/templates/puzzle/src/style.css +7 -8
  175. package/templates/puzzle/src/ui/App.tsx +2 -2
  176. package/templates/puzzle/src/ui/Hud.tsx +92 -40
  177. package/templates/puzzle/src/ui/Menu.tsx +40 -2
  178. package/templates/puzzle/threenative.config.ts +14 -1
  179. package/templates/puzzle/vite.config.ts +4 -1
  180. package/templates/racing/AGENTS.md +19 -20
  181. package/templates/racing/CLAUDE.md +19 -20
  182. package/templates/racing/package.json +13 -7
  183. package/templates/racing/playtests/boost.playtest.json +33 -12
  184. package/templates/racing/playtests/outcome.playtest.json +32 -50
  185. package/templates/racing/playtests/performance.playtest.json +2 -1
  186. package/templates/racing/playtests/ranking.playtest.json +5 -14
  187. package/templates/racing/playtests/rescue.playtest.json +2 -2
  188. package/templates/racing/playtests/reverse.playtest.json +30 -8
  189. package/templates/racing/playtests/shortcut.playtest.json +54 -9
  190. package/templates/racing/playtests/touch-controls.playtest.json +32 -5
  191. package/templates/racing/src/entities/CarBody.ts +327 -0
  192. package/templates/racing/src/entities/LineDriver.ts +220 -0
  193. package/templates/racing/src/entities/RacingCar.ts +150 -89
  194. package/templates/racing/src/entities/Rival.ts +61 -24
  195. package/templates/racing/src/game.ts +5 -0
  196. package/templates/racing/src/render/camera.ts +49 -7
  197. package/templates/racing/src/render/lighting.ts +36 -37
  198. package/templates/racing/src/render/materials.ts +239 -19
  199. package/templates/racing/src/render/palette.ts +19 -21
  200. package/templates/racing/src/render/postprocessing.ts +12 -2
  201. package/templates/racing/src/render/quality.ts +43 -82
  202. package/templates/racing/src/render/shapes.ts +20 -6
  203. package/templates/racing/src/render/sky.ts +47 -39
  204. package/templates/racing/src/render/touch-controls.ts +1 -1
  205. package/templates/racing/src/render/worldEnvironment.ts +52 -1
  206. package/templates/racing/src/scenes/Race.ts +107 -54
  207. package/templates/racing/src/state.ts +2 -0
  208. package/templates/racing/src/track/Checkline.ts +22 -7
  209. package/templates/racing/src/track/Lap.ts +64 -36
  210. package/templates/racing/src/track/Ranking.ts +20 -11
  211. package/templates/racing/src/track/Track.ts +809 -361
  212. package/templates/racing/src/track/TrackSector.ts +40 -11
  213. package/templates/racing/src/track/circuit.ts +477 -0
  214. package/templates/racing/src/track/rescue.ts +16 -4
  215. package/templates/racing/threenative.config.ts +14 -1
  216. package/templates/racing/vite.config.ts +4 -1
  217. package/templates/rts/AGENTS.md +96 -0
  218. package/templates/rts/CLAUDE.md +98 -0
  219. package/templates/rts/kit.json +7 -0
  220. package/templates/{defense → rts}/package.json +13 -7
  221. package/templates/{defense → rts}/playtests/performance.playtest.json +28 -26
  222. package/templates/rts/playtests/rts-ai-attack.playtest.json +24 -0
  223. package/templates/rts/playtests/rts-attack.playtest.json +75 -0
  224. package/templates/rts/playtests/rts-build.playtest.json +68 -0
  225. package/templates/rts/playtests/rts-orders.playtest.json +150 -0
  226. package/templates/rts/playtests/rts-train.playtest.json +62 -0
  227. package/templates/rts/playtests/survives.playtest.json +58 -0
  228. package/templates/rts/public/favicon.svg +4 -0
  229. package/templates/rts/src/game.ts +64 -0
  230. package/templates/rts/src/orders.ts +22 -0
  231. package/templates/rts/src/render/army.ts +346 -0
  232. package/templates/rts/src/render/camera.ts +123 -0
  233. package/templates/rts/src/render/lighting.ts +61 -0
  234. package/templates/rts/src/render/loading.ts +33 -0
  235. package/templates/rts/src/render/materials.ts +152 -0
  236. package/templates/rts/src/render/models.ts +705 -0
  237. package/templates/rts/src/render/palette.ts +17 -0
  238. package/templates/rts/src/render/picking.ts +93 -0
  239. package/templates/{defense → rts}/src/render/postprocessing.ts +15 -3
  240. package/templates/rts/src/render/quality.ts +128 -0
  241. package/templates/rts/src/render/resources.ts +141 -0
  242. package/templates/rts/src/render/sky.ts +44 -0
  243. package/templates/rts/src/render/terrain.ts +116 -0
  244. package/templates/{defense → rts}/src/render/worldEnvironment.ts +52 -1
  245. package/templates/rts/src/scenes/Play.ts +650 -0
  246. package/templates/rts/src/sim/ai.ts +1140 -0
  247. package/templates/rts/src/sim/combat.ts +416 -0
  248. package/templates/rts/src/sim/construction.ts +374 -0
  249. package/templates/rts/src/sim/economy.ts +167 -0
  250. package/templates/rts/src/sim/game.ts +1082 -0
  251. package/templates/rts/src/sim/movement.ts +371 -0
  252. package/templates/rts/src/sim/nav.ts +276 -0
  253. package/templates/rts/src/sim/production.ts +180 -0
  254. package/templates/rts/src/sim/terrain.ts +170 -0
  255. package/templates/rts/src/sim/types.ts +647 -0
  256. package/templates/rts/src/sim/vision.ts +46 -0
  257. package/templates/rts/src/state.ts +100 -0
  258. package/templates/{defense → rts}/src/style.css +21 -8
  259. package/templates/rts/src/ui/App.tsx +21 -0
  260. package/templates/rts/src/ui/Commands.tsx +129 -0
  261. package/templates/rts/src/ui/GameUi.tsx +22 -0
  262. package/templates/rts/src/ui/Hud.tsx +165 -0
  263. package/templates/rts/src/ui/Minimap.tsx +84 -0
  264. package/templates/rts/tailwind.config.ts +2 -0
  265. package/templates/rts/threenative.config.ts +56 -0
  266. package/templates/rts/tsconfig.json +17 -0
  267. package/templates/{defense → rts}/vite.config.ts +4 -1
  268. package/templates/runner/AGENTS.md +6 -10
  269. package/templates/runner/CLAUDE.md +6 -10
  270. package/templates/runner/README.md +3 -3
  271. package/templates/runner/package.json +13 -7
  272. package/templates/runner/playtests/performance.playtest.json +2 -2
  273. package/templates/runner/src/conventions.ts +4 -3
  274. package/templates/runner/src/entities/Runner.ts +54 -7
  275. package/templates/runner/src/game.ts +2 -0
  276. package/templates/runner/src/render/camera.ts +4 -2
  277. package/templates/runner/src/render/dust.ts +5 -2
  278. package/templates/runner/src/render/lighting.ts +41 -45
  279. package/templates/runner/src/render/loading.ts +2 -2
  280. package/templates/runner/src/render/materials.ts +165 -25
  281. package/templates/runner/src/render/palette.ts +17 -28
  282. package/templates/runner/src/render/postprocessing.ts +12 -2
  283. package/templates/runner/src/render/quality.ts +42 -96
  284. package/templates/runner/src/render/shapes.ts +59 -37
  285. package/templates/runner/src/render/sky.ts +32 -41
  286. package/templates/runner/src/render/touch-controls.ts +1 -1
  287. package/templates/runner/src/render/worldEnvironment.ts +52 -1
  288. package/templates/runner/src/scenes/Run.ts +26 -6
  289. package/templates/runner/src/track.ts +6 -1
  290. package/templates/runner/threenative.config.ts +14 -1
  291. package/templates/runner/vite.config.ts +4 -1
  292. package/templates/sailing/AGENTS.md +12 -12
  293. package/templates/sailing/CLAUDE.md +12 -12
  294. package/templates/sailing/assets/ship.glb +0 -0
  295. package/templates/sailing/package.json +13 -7
  296. package/templates/sailing/playtests/float-after-the-run-ends.playtest.json +10 -6
  297. package/templates/sailing/playtests/sails.playtest.json +33 -0
  298. package/templates/sailing/playtests/win.playtest.json +156 -8
  299. package/templates/sailing/src/conventions.ts +29 -2
  300. package/templates/sailing/src/entities/Ship.ts +381 -57
  301. package/templates/sailing/src/game.ts +14 -0
  302. package/templates/sailing/src/render/camera.ts +63 -9
  303. package/templates/sailing/src/render/lighting.ts +49 -27
  304. package/templates/sailing/src/render/materials.ts +50 -15
  305. package/templates/sailing/src/render/ocean.ts +647 -60
  306. package/templates/sailing/src/render/palette.ts +16 -12
  307. package/templates/sailing/src/render/postprocessing.ts +12 -2
  308. package/templates/sailing/src/render/props.ts +316 -442
  309. package/templates/sailing/src/render/quality.ts +14 -4
  310. package/templates/sailing/src/render/sky.ts +116 -23
  311. package/templates/sailing/src/render/worldEnvironment.ts +52 -1
  312. package/templates/sailing/src/scenes/Boot.ts +21 -0
  313. package/templates/sailing/src/scenes/Sailing.ts +173 -39
  314. package/templates/sailing/src/state.ts +6 -0
  315. package/templates/sailing/src/ui/Hud.tsx +41 -9
  316. package/templates/sailing/threenative.config.ts +14 -1
  317. package/templates/sailing/vite.config.ts +4 -1
  318. package/templates/shooter/AGENTS.md +27 -42
  319. package/templates/shooter/CLAUDE.md +27 -42
  320. package/templates/shooter/index.html +1 -0
  321. package/templates/shooter/package.json +13 -7
  322. package/templates/shooter/playtests/aim-alignment.playtest.json +58 -0
  323. package/templates/shooter/playtests/breakable-shatters.playtest.json +62 -0
  324. package/templates/shooter/playtests/bullet-holes.playtest.json +56 -0
  325. package/templates/shooter/playtests/camera-tracks-body-vertically.playtest.json +61 -0
  326. package/templates/shooter/playtests/crouch-lowers-the-eye.playtest.json +41 -0
  327. package/templates/shooter/playtests/death-no-snap.playtest.json +77 -0
  328. package/templates/shooter/playtests/debug-ads.playtest.json +58 -0
  329. package/templates/shooter/playtests/debug-clear.playtest.json +383 -0
  330. package/templates/shooter/playtests/debug-endurance.playtest.json +61 -0
  331. package/templates/shooter/playtests/debug-fire.playtest.json +119 -0
  332. package/templates/shooter/playtests/debug-restart.playtest.json +24 -0
  333. package/templates/shooter/playtests/enemy-body-is-a-body.playtest.json +79 -0
  334. package/templates/shooter/playtests/enemy-death-settles.playtest.json +64 -0
  335. package/templates/shooter/playtests/enemy-flinches-when-hit.playtest.json +75 -0
  336. package/templates/shooter/playtests/enemy-foot-contact.playtest.json +41 -0
  337. package/templates/shooter/playtests/enemy-material-is-not-shared.playtest.json +59 -0
  338. package/templates/shooter/playtests/enemy-reaches-walkway.playtest.json +80 -0
  339. package/templates/shooter/playtests/enemy-rifle-grip.playtest.json +101 -0
  340. package/templates/shooter/playtests/enemy-scale.playtest.json +56 -0
  341. package/templates/shooter/playtests/enemy-stops-without-snapping.playtest.json +486 -0
  342. package/templates/shooter/playtests/enemy-stride-matches-speed.playtest.json +198 -0
  343. package/templates/shooter/playtests/enemy-stride-under-crouch.playtest.json +87 -0
  344. package/templates/shooter/playtests/enemy-uses-crouch-clips.playtest.json +74 -0
  345. package/templates/shooter/playtests/five-soldiers.playtest.json +83 -0
  346. package/templates/shooter/playtests/flash-retires.playtest.json +62 -0
  347. package/templates/shooter/playtests/headshot-hits-head.playtest.json +132 -0
  348. package/templates/shooter/playtests/hold-to-fire.playtest.json +45 -0
  349. package/templates/shooter/playtests/input-control.playtest.json +43 -98
  350. package/templates/shooter/playtests/minimap-state.playtest.json +75 -0
  351. package/templates/shooter/playtests/performance.playtest.json +62 -26
  352. package/templates/{starter/playtests/forward.playtest.json → shooter/playtests/round-clock.playtest.json} +11 -16
  353. package/templates/shooter/playtests/shot-tracks-crosshair.playtest.json +79 -0
  354. package/templates/shooter/playtests/survives.playtest.json +36 -30
  355. package/templates/shooter/playtests/walkway-reachable.playtest.json +67 -0
  356. package/templates/shooter/src/entities/Breakables.ts +412 -0
  357. package/templates/shooter/src/entities/Enemy.ts +2095 -0
  358. package/templates/shooter/src/entities/FpsPlayer.ts +283 -0
  359. package/templates/shooter/src/entities/Rifle.ts +442 -0
  360. package/templates/shooter/src/entities/Target.ts +199 -83
  361. package/templates/shooter/src/entities/TouchControls.ts +276 -0
  362. package/templates/shooter/src/game.ts +75 -41
  363. package/templates/shooter/src/main.ts +0 -1
  364. package/templates/shooter/src/postPhysics.ts +36 -0
  365. package/templates/shooter/src/render/camera.ts +78 -74
  366. package/templates/shooter/src/render/decals.ts +142 -82
  367. package/templates/shooter/src/render/facade.ts +1373 -0
  368. package/templates/shooter/src/render/gunfx.ts +704 -0
  369. package/templates/shooter/src/render/lighting.ts +52 -38
  370. package/templates/shooter/src/render/loading.ts +2 -2
  371. package/templates/shooter/src/render/materials.ts +100 -88
  372. package/templates/shooter/src/render/occlusion.ts +108 -0
  373. package/templates/shooter/src/render/palette.ts +10 -10
  374. package/templates/shooter/src/render/palm.ts +455 -0
  375. package/templates/shooter/src/render/pooled-billboards.ts +144 -0
  376. package/templates/shooter/src/render/postprocessing.ts +15 -3
  377. package/templates/shooter/src/render/quality.ts +40 -82
  378. package/templates/shooter/src/render/scale.ts +148 -15
  379. package/templates/shooter/src/render/shapes.ts +138 -613
  380. package/templates/shooter/src/render/sky.ts +35 -35
  381. package/templates/shooter/src/render/town-schematic.ts +120 -0
  382. package/templates/shooter/src/render/town.ts +986 -0
  383. package/templates/shooter/src/render/townMaterials.ts +160 -0
  384. package/templates/shooter/src/render/vehicles.ts +741 -0
  385. package/templates/shooter/src/render/worldEnvironment.ts +52 -1
  386. package/templates/shooter/src/scenes/Play.ts +727 -650
  387. package/templates/shooter/src/state.ts +26 -41
  388. package/templates/shooter/src/style.css +207 -11
  389. package/templates/shooter/src/surfaces.ts +131 -0
  390. package/templates/shooter/src/ui/App.tsx +9 -10
  391. package/templates/shooter/src/ui/Crosshair.tsx +25 -18
  392. package/templates/shooter/src/ui/GameUi.tsx +6 -9
  393. package/templates/shooter/src/ui/Hud.tsx +428 -39
  394. package/templates/shooter/src/ui/Minimap.tsx +164 -0
  395. package/templates/shooter/src/ui/TouchOverlay.tsx +54 -0
  396. package/templates/shooter/src/ui/main.tsx +2 -3
  397. package/templates/shooter/threenative.config.ts +14 -1
  398. package/templates/shooter/vite.config.ts +4 -1
  399. package/templates/starter/AGENTS.md +17 -17
  400. package/templates/starter/CLAUDE.md +17 -17
  401. package/templates/starter/native-playtests/render-chain.playtest.json +13 -45
  402. package/templates/starter/package.json +13 -7
  403. package/templates/starter/playtests/play.playtest.json +2 -1
  404. package/templates/starter/playtests/survives.playtest.json +1 -1
  405. package/templates/starter/src/conventions.ts +6 -3
  406. package/templates/starter/src/entities/Goal.ts +35 -42
  407. package/templates/starter/src/entities/Player.ts +99 -16
  408. package/templates/starter/src/render/arena.ts +131 -0
  409. package/templates/starter/src/render/lighting.ts +27 -44
  410. package/templates/starter/src/render/materials.ts +164 -35
  411. package/templates/starter/src/render/palette.ts +16 -16
  412. package/templates/starter/src/render/postprocessing.ts +6 -7
  413. package/templates/starter/src/render/quality.ts +43 -101
  414. package/templates/starter/src/render/shapes.ts +1 -1
  415. package/templates/starter/src/render/sky.ts +39 -45
  416. package/templates/starter/src/render/touch-controls.ts +3 -1
  417. package/templates/starter/src/render/worldEnvironment.ts +52 -1
  418. package/templates/starter/src/scenes/Play.ts +82 -81
  419. package/templates/starter/threenative.config.ts +14 -1
  420. package/templates/starter/vite.config.ts +4 -1
  421. package/templates/tower-defense/.codex/config.toml +19 -0
  422. package/templates/tower-defense/.cursor/mcp.json +32 -0
  423. package/templates/tower-defense/.gemini/settings.json +32 -0
  424. package/templates/tower-defense/.mcp.json +32 -0
  425. package/templates/tower-defense/.vscode/mcp.json +36 -0
  426. package/templates/tower-defense/.zed/settings.json +36 -0
  427. package/templates/{defense → tower-defense}/AGENTS.md +14 -12
  428. package/templates/{defense → tower-defense}/CLAUDE.md +14 -12
  429. package/templates/tower-defense/README.md +16 -0
  430. package/templates/tower-defense/index.html +12 -0
  431. package/templates/tower-defense/kit.json +7 -0
  432. package/templates/tower-defense/opencode.json +41 -0
  433. package/templates/tower-defense/package.json +56 -0
  434. package/templates/tower-defense/playtests/arsenal.playtest.json +214 -0
  435. package/templates/tower-defense/playtests/defeat.playtest.json +85 -0
  436. package/templates/tower-defense/playtests/look.playtest.json +130 -0
  437. package/templates/tower-defense/playtests/performance.playtest.json +77 -0
  438. package/templates/tower-defense/playtests/placement.playtest.json +115 -0
  439. package/templates/{defense → tower-defense}/playtests/pointer-placement.playtest.json +21 -49
  440. package/templates/tower-defense/playtests/strike.playtest.json +98 -0
  441. package/templates/tower-defense/playtests/survives.playtest.json +85 -0
  442. package/templates/tower-defense/playtests/target-priority.playtest.json +177 -0
  443. package/templates/tower-defense/playtests/upgrade-recycle.playtest.json +124 -0
  444. package/templates/tower-defense/playtests/victory.playtest.json +810 -0
  445. package/templates/tower-defense/src/balance.ts +187 -0
  446. package/templates/tower-defense/src/board/Board.ts +100 -0
  447. package/templates/tower-defense/src/board/Route.ts +84 -0
  448. package/templates/tower-defense/src/camera-rig.ts +62 -0
  449. package/templates/tower-defense/src/economy.ts +64 -0
  450. package/templates/tower-defense/src/effects/Effects.ts +284 -0
  451. package/templates/tower-defense/src/enemies/Enemy.ts +198 -0
  452. package/templates/tower-defense/src/game.ts +72 -0
  453. package/templates/tower-defense/src/intents.ts +21 -0
  454. package/templates/tower-defense/src/main.ts +15 -0
  455. package/templates/tower-defense/src/physics.ts +6 -0
  456. package/templates/tower-defense/src/render/camera.ts +38 -0
  457. package/templates/tower-defense/src/render/lighting.ts +42 -0
  458. package/templates/{defense → tower-defense}/src/render/loading.ts +3 -3
  459. package/templates/tower-defense/src/render/materials.ts +103 -0
  460. package/templates/tower-defense/src/render/palette.ts +58 -0
  461. package/templates/tower-defense/src/render/postprocessing.ts +46 -0
  462. package/templates/tower-defense/src/render/quality.ts +128 -0
  463. package/templates/tower-defense/src/render/shapes.ts +550 -0
  464. package/templates/tower-defense/src/render/sky.ts +27 -0
  465. package/templates/tower-defense/src/render/worldEnvironment.ts +809 -0
  466. package/templates/tower-defense/src/scenes/Battle.ts +539 -0
  467. package/templates/{shooter → tower-defense}/src/scenes/Boot.ts +3 -3
  468. package/templates/tower-defense/src/state.ts +88 -0
  469. package/templates/tower-defense/src/style.css +137 -0
  470. package/templates/tower-defense/src/towers/Tower.ts +230 -0
  471. package/templates/tower-defense/src/towers/targeting.ts +97 -0
  472. package/templates/tower-defense/src/ui/Hud.tsx +270 -0
  473. package/templates/tower-defense/src/ui/Menu.tsx +134 -0
  474. package/templates/tower-defense/src/ui/icons.tsx +54 -0
  475. package/templates/tower-defense/src/ui/main.tsx +14 -0
  476. package/templates/tower-defense/src/waves.ts +90 -0
  477. package/templates/{defense → tower-defense}/threenative.config.ts +14 -1
  478. package/templates/tower-defense/vite.config.ts +41 -0
  479. package/agent-files/.claude/skills/file-engine-bug/SKILL.md +0 -59
  480. package/agent-files/.claude/skills/ponytail/SKILL.md +0 -68
  481. package/agent-files/.claude/skills/prd-creator/SKILL.md +0 -40
  482. package/agent-files/.claude/skills/threenative-assets/SKILL.md +0 -53
  483. package/agent-files/.claude/skills/threenative-capabilities/SKILL.md +0 -27
  484. package/agent-files/.claude/skills/threenative-context/SKILL.md +0 -65
  485. package/agent-files/.claude/skills/threenative-performance/SKILL.md +0 -58
  486. package/agent-files/.claude/skills/threenative-playtest/SKILL.md +0 -44
  487. package/agent-files/.claude/skills/threenative-ui/SKILL.md +0 -20
  488. package/agent-files/.claude/skills/threenative-visuals/SKILL.md +0 -41
  489. package/agent-files/AGENT-ROLES.md +0 -26
  490. package/templates/action-rpg/src/render/shapes.ts +0 -269
  491. package/templates/action-rpg/src/render/types.ts +0 -3
  492. package/templates/action-rpg/src/scenes/Boot.ts +0 -12
  493. package/templates/defense/README.md +0 -10
  494. package/templates/defense/kit.json +0 -7
  495. package/templates/defense/playtests/leak.playtest.json +0 -23
  496. package/templates/defense/playtests/placement.playtest.json +0 -40
  497. package/templates/defense/playtests/scan.playtest.json +0 -20
  498. package/templates/defense/playtests/survive.playtest.json +0 -45
  499. package/templates/defense/playtests/survives.playtest.json +0 -36
  500. package/templates/defense/src/attackers/Attacker.ts +0 -120
  501. package/templates/defense/src/board/Route.ts +0 -94
  502. package/templates/defense/src/conventions.ts +0 -18
  503. package/templates/defense/src/economy.ts +0 -36
  504. package/templates/defense/src/entities/Player.ts +0 -52
  505. package/templates/defense/src/game.ts +0 -51
  506. package/templates/defense/src/physics.ts +0 -13
  507. package/templates/defense/src/placement/Buildable.ts +0 -49
  508. package/templates/defense/src/render/camera.ts +0 -16
  509. package/templates/defense/src/render/lighting.ts +0 -37
  510. package/templates/defense/src/render/materials.ts +0 -22
  511. package/templates/defense/src/render/palette.ts +0 -28
  512. package/templates/defense/src/render/quality.ts +0 -170
  513. package/templates/defense/src/render/shapes.ts +0 -246
  514. package/templates/defense/src/render/sky.ts +0 -45
  515. package/templates/defense/src/scenes/Boot.ts +0 -12
  516. package/templates/defense/src/scenes/Defense.ts +0 -231
  517. package/templates/defense/src/state.ts +0 -56
  518. package/templates/defense/src/towers/Tower.ts +0 -95
  519. package/templates/defense/src/towers/targeting.ts +0 -53
  520. package/templates/defense/src/ui/Hud.tsx +0 -62
  521. package/templates/defense/src/ui/Menu.tsx +0 -7
  522. package/templates/defense/src/waves.ts +0 -40
  523. package/templates/minimal/playtests/atmosphere.playtest.json +0 -32
  524. package/templates/minimal/src/render/hud.ts +0 -69
  525. package/templates/platformer/playtests/avoidance.playtest.json +0 -28
  526. package/templates/platformer/playtests/chase.playtest.json +0 -21
  527. package/templates/platformer/playtests/collision-layers.playtest.json +0 -36
  528. package/templates/platformer/playtests/oneway.playtest.json +0 -44
  529. package/templates/platformer/playtests/patrol.playtest.json +0 -13
  530. package/templates/platformer/playtests/physics.playtest.json +0 -14
  531. package/templates/platformer/playtests/stomp-rise.playtest.json +0 -55
  532. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +0 -41
  533. package/templates/platformer/playtests/terminal-loop-win.playtest.json +0 -52
  534. package/templates/platformer/src/conventions.ts +0 -18
  535. package/templates/platformer/src/entities/Character.ts +0 -286
  536. package/templates/platformer/src/entities/Chaser.ts +0 -118
  537. package/templates/platformer/src/entities/Patrol.ts +0 -93
  538. package/templates/platformer/src/level/Platform.ts +0 -46
  539. package/templates/platformer/src/render/rig.ts +0 -60
  540. package/templates/platformer/src/render/terrain.ts +0 -31
  541. package/templates/platformer/src/scenes/Level.ts +0 -241
  542. package/templates/puzzle/README.md +0 -43
  543. package/templates/puzzle/playtests/carry.playtest.json +0 -71
  544. package/templates/puzzle/playtests/swing.playtest.json +0 -38
  545. package/templates/puzzle/src/conventions.ts +0 -25
  546. package/templates/puzzle/src/entities/Ball.ts +0 -70
  547. package/templates/puzzle/src/entities/Gripper.ts +0 -69
  548. package/templates/puzzle/src/entities/Pendulum.ts +0 -89
  549. package/templates/puzzle/src/physics.ts +0 -19
  550. package/templates/puzzle/src/room.ts +0 -83
  551. package/templates/puzzle/src/scenes/Boot.ts +0 -12
  552. package/templates/puzzle/src/scenes/Puzzle.ts +0 -158
  553. package/templates/shooter/playtests/combat.playtest.json +0 -48
  554. package/templates/shooter/playtests/fail.playtest.json +0 -31
  555. package/templates/shooter/playtests/per-item.playtest.json +0 -59
  556. package/templates/shooter/playtests/shooter.playtest.json +0 -99
  557. package/templates/shooter/playtests/touch-controls.playtest.json +0 -42
  558. package/templates/shooter/playtests/weapon-cycle.playtest.json +0 -164
  559. package/templates/shooter/src/combat/damage.ts +0 -40
  560. package/templates/shooter/src/conventions.ts +0 -51
  561. package/templates/shooter/src/entities/Pickup.ts +0 -70
  562. package/templates/shooter/src/entities/Player.ts +0 -310
  563. package/templates/shooter/src/level/SpawnPoints.ts +0 -28
  564. package/templates/shooter/src/playtest-events.ts +0 -15
  565. package/templates/shooter/src/render/touch-controls.ts +0 -305
  566. package/templates/shooter/src/render/types.ts +0 -3
  567. package/templates/shooter/src/render/ui.css +0 -330
  568. package/templates/shooter/src/render/ui.ts +0 -75
  569. package/templates/shooter/src/render/vfx.ts +0 -215
  570. package/templates/shooter/src/ui/Menu.tsx +0 -41
  571. package/templates/shooter/src/waves.ts +0 -50
  572. package/templates/shooter/src/weapons/Hitscan.ts +0 -42
  573. package/templates/shooter/src/weapons/Projectile.ts +0 -92
  574. package/templates/shooter/src/weapons/Viewmodel.ts +0 -275
  575. package/templates/starter/playtests/assets.playtest.json +0 -65
  576. package/templates/starter/playtests/buffer.playtest.json +0 -79
  577. package/templates/starter/playtests/cloth.playtest.json +0 -113
  578. package/templates/starter/playtests/coyote.playtest.json +0 -87
  579. package/templates/starter/playtests/gameover.playtest.json +0 -66
  580. package/templates/starter/playtests/goal.playtest.json +0 -67
  581. package/templates/starter/playtests/look.playtest.json +0 -175
  582. package/templates/starter/playtests/models-baseline.png +0 -0
  583. package/templates/starter/playtests/models.playtest.json +0 -74
  584. package/templates/starter/playtests/monitoring.playtest.json +0 -72
  585. package/templates/starter/playtests/odometer.playtest.json +0 -54
  586. package/templates/starter/playtests/restart.playtest.json +0 -91
  587. package/templates/starter/playtests/seed.playtest.json +0 -54
  588. package/templates/starter/playtests/textures-baseline.png +0 -0
  589. package/templates/starter/playtests/textures.playtest.json +0 -74
  590. package/templates/starter/playtests/touch-controls.playtest.json +0 -42
  591. package/templates/starter/playtests/zoom-pinch.playtest.json +0 -86
  592. package/templates/starter/playtests/zoom-wheel.playtest.json +0 -59
  593. package/templates/starter/src/render/coast.ts +0 -199
  594. package/templates/starter/src/render/hero.ts +0 -88
  595. package/templates/starter/src/render/implicitSurface.ts +0 -199
  596. package/templates/starter/src/render/kuwahara.ts +0 -174
  597. package/templates/starter/src/render/outline.ts +0 -141
  598. package/templates/starter/src/render/painterly.ts +0 -86
  599. package/templates/starter/src/render/rockRidge.ts +0 -198
  600. package/templates/starter/src/render/rockRidge.worker.ts +0 -77
  601. package/templates/starter/src/render/scenery.ts +0 -40
  602. package/templates/starter/src/render/textureLifetime.ts +0 -53
  603. package/templates/starter/src/render/water.ts +0 -38
  604. package/templates/starter/src/render/watercolor.ts +0 -85
  605. /package/templates/{starter → puzzle}/playtests/boot-failure.playtest.json +0 -0
  606. /package/templates/{starter → puzzle}/playtests/pause.playtest.json +0 -0
  607. /package/templates/{defense → rts}/.codex/config.toml +0 -0
  608. /package/templates/{defense → rts}/.cursor/mcp.json +0 -0
  609. /package/templates/{defense → rts}/.gemini/settings.json +0 -0
  610. /package/templates/{defense → rts}/.mcp.json +0 -0
  611. /package/templates/{defense → rts}/.vscode/mcp.json +0 -0
  612. /package/templates/{defense → rts}/.zed/settings.json +0 -0
  613. /package/templates/{defense → rts}/index.html +0 -0
  614. /package/templates/{defense → rts}/opencode.json +0 -0
  615. /package/templates/{defense → rts}/src/main.ts +0 -0
  616. /package/templates/{defense → rts}/src/ui/main.tsx +0 -0
  617. /package/templates/{defense → tower-defense}/public/favicon.svg +0 -0
  618. /package/templates/{defense → tower-defense}/src/playtest-events.ts +0 -0
  619. /package/templates/{defense → tower-defense}/src/ui/App.tsx +0 -0
  620. /package/templates/{defense → tower-defense}/src/ui/GameUi.tsx +0 -0
  621. /package/templates/{defense → tower-defense}/tailwind.config.ts +0 -0
  622. /package/templates/{defense → tower-defense}/tsconfig.json +0 -0
@@ -26,6 +26,8 @@ export function setupPost(
26
26
  environment: {
27
27
  godraysLight?: DirectionalLight;
28
28
  mobile?: boolean;
29
+ /** The renderer named a software adapter; this game's answer is its `low` tier. */
30
+ software?: boolean;
29
31
  /** Forces a tier, ignoring `mobile`. An unknown name throws rather than falling back. */
30
32
  tier?: QualityTier;
31
33
  } = {},
@@ -37,10 +39,18 @@ export function setupPost(
37
39
  (globalThis as ProfileGlobals).__THREENATIVE_PROFILE__?.hostedSoftware === true;
38
40
  const requestedTier: QualityTier | undefined =
39
41
  environment.tier ?? (hostedSoftware ? "low" : undefined);
40
- const tier = resolveQualityTier({ mobile: environment.mobile, tier: requestedTier });
42
+ const tier = resolveQualityTier({
43
+ mobile: environment.mobile,
44
+ software: environment.software,
45
+ tier: requestedTier,
46
+ });
41
47
  const source =
42
48
  environment.tier !== undefined ? "override" : hostedSoftware ? "hosted-software" : "platform";
43
- console.info(`TN_QUALITY_TIER ${tier} mobile=${environment.mobile === true} source=${source}`);
49
+ console.info(
50
+ `TN_QUALITY_TIER ${tier} mobile=${environment.mobile === true} software=${
51
+ environment.software === true
52
+ } source=${source}`,
53
+ );
44
54
  const world = new WorldEnvironment(qualityPreset(tier));
45
55
  world.apply(renderer, scene, camera, { godraysLight: environment.godraysLight });
46
56
  }
@@ -0,0 +1,147 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // The dressing on and beside the route: trees, bushes, flowers, a post-and-rope fence, and the
4
+ // vines under a floating island. Each one is a `Group` of primitives taking a scale and an RNG, so
5
+ // the same call site reads differently every time — and every one of them is pure decoration: none
6
+ // of it collides, because `buildStaticColliders` is handed a predicate and only walkable geometry
7
+ // passes it.
8
+ import {
9
+ type BufferGeometry,
10
+ ConeGeometry,
11
+ CylinderGeometry,
12
+ Group,
13
+ type Material,
14
+ Mesh,
15
+ type MeshBasicMaterial,
16
+ SphereGeometry,
17
+ } from "three";
18
+ import { flat, toon } from "./materials.js";
19
+ import { C } from "./palette.js";
20
+
21
+ function mesh(geometry: BufferGeometry, material: Material): Mesh {
22
+ const m = new Mesh(geometry, material);
23
+ m.castShadow = true;
24
+ m.receiveShadow = true;
25
+ return m;
26
+ }
27
+
28
+ /** Stacked-cone conifer. */
29
+ export function pineTree(scale = 1, rng: () => number = Math.random): Group {
30
+ const group = new Group();
31
+ const trunk = mesh(new CylinderGeometry(0.13, 0.18, 0.7, 6), toon(C.woodDark));
32
+ trunk.position.y = 0.35;
33
+ group.add(trunk);
34
+ for (let i = 0; i < 3; i += 1) {
35
+ const cone = mesh(
36
+ new ConeGeometry(0.72 - i * 0.17, 0.95, 8),
37
+ toon(i % 2 ? C.grassDark : C.grass),
38
+ );
39
+ cone.position.y = 0.75 + i * 0.55;
40
+ cone.rotation.y = rng() * Math.PI;
41
+ group.add(cone);
42
+ }
43
+ group.scale.setScalar(scale);
44
+ return group;
45
+ }
46
+
47
+ /** Round broadleaf tree with a clustered canopy. */
48
+ export function roundTree(scale = 1, rng: () => number = Math.random): Group {
49
+ const group = new Group();
50
+ const trunk = mesh(new CylinderGeometry(0.16, 0.24, 1, 6), toon(C.woodDark));
51
+ trunk.position.y = 0.5;
52
+ group.add(trunk);
53
+ for (let i = 0; i < 5; i += 1) {
54
+ const ball = mesh(
55
+ new SphereGeometry(0.5 + rng() * 0.35, 10, 8),
56
+ toon(i % 2 ? C.grass : C.grassDark),
57
+ );
58
+ ball.position.set((rng() - 0.5) * 0.9, 1.5 + (rng() - 0.5) * 0.5, (rng() - 0.5) * 0.9);
59
+ group.add(ball);
60
+ }
61
+ group.scale.setScalar(scale);
62
+ return group;
63
+ }
64
+
65
+ export function bush(scale = 1, rng: () => number = Math.random): Group {
66
+ const group = new Group();
67
+ for (let i = 0; i < 4; i += 1) {
68
+ const r = 0.22 + rng() * 0.2;
69
+ const ball = mesh(new SphereGeometry(r, 8, 6), toon(i % 2 ? C.grass : C.grassDark));
70
+ ball.position.set((rng() - 0.5) * 0.6, r * 0.7, (rng() - 0.5) * 0.5);
71
+ group.add(ball);
72
+ }
73
+ group.scale.setScalar(scale);
74
+ return group;
75
+ }
76
+
77
+ export function flower(color = 0xff8fb0): Group {
78
+ const group = new Group();
79
+ const stem = mesh(new CylinderGeometry(0.015, 0.02, 0.22, 4), toon(C.grassDark));
80
+ stem.position.y = 0.11;
81
+ group.add(stem);
82
+ for (let i = 0; i < 5; i += 1) {
83
+ const petal = mesh(new SphereGeometry(0.05, 6, 4), toon(color));
84
+ const a = (i / 5) * Math.PI * 2;
85
+ petal.position.set(Math.cos(a) * 0.06, 0.24, Math.sin(a) * 0.06);
86
+ group.add(petal);
87
+ }
88
+ const core = mesh(new SphereGeometry(0.04, 6, 4), toon(C.gold));
89
+ core.position.y = 0.25;
90
+ group.add(core);
91
+ return group;
92
+ }
93
+
94
+ /** Wooden post-and-rope fence running along +X. */
95
+ export function fence(length: number, posts = 4): Group {
96
+ const group = new Group();
97
+ const step = length / (posts - 1);
98
+ for (let i = 0; i < posts; i += 1) {
99
+ const post = mesh(new CylinderGeometry(0.09, 0.11, 1, 6), toon(C.woodPost));
100
+ post.position.set(i * step, 0.5, 0);
101
+ group.add(post);
102
+ if (i >= posts - 1) continue;
103
+ for (const [height, sag] of [
104
+ [0.78, 0.06],
105
+ [0.45, 0.05],
106
+ ] as const) {
107
+ const rail = mesh(new CylinderGeometry(0.035, 0.035, step, 5), toon(C.rope));
108
+ rail.rotation.z = Math.PI / 2;
109
+ rail.position.set(i * step + step / 2, height - sag, 0);
110
+ group.add(rail);
111
+ }
112
+ }
113
+ return group;
114
+ }
115
+
116
+ /** Vine strands hanging off a ledge and a floating island. */
117
+ export function vines(count = 4, rng: () => number = Math.random): Group {
118
+ const group = new Group();
119
+ for (let i = 0; i < count; i += 1) {
120
+ const length = 0.8 + rng() * 1.6;
121
+ const strand = mesh(new CylinderGeometry(0.035, 0.03, length, 4), toon(C.grassDark));
122
+ strand.position.set((rng() - 0.5) * 1.6, -length / 2, (rng() - 0.5) * 0.3);
123
+ group.add(strand);
124
+ for (let leaf = 0; leaf < 3; leaf += 1) {
125
+ const pad = mesh(new SphereGeometry(0.11, 6, 4), toon(C.grass));
126
+ pad.scale.set(1, 0.4, 0.7);
127
+ pad.position.set(
128
+ strand.position.x + (rng() - 0.5) * 0.2,
129
+ -length * (0.2 + leaf * 0.3),
130
+ strand.position.z,
131
+ );
132
+ group.add(pad);
133
+ }
134
+ }
135
+ return group;
136
+ }
137
+
138
+ /** Waves the goal cloth without a texture: a sine along its own x. */
139
+ export function swayFlag(cloth: Mesh, time: number): void {
140
+ const position = cloth.geometry.getAttribute("position");
141
+ if (position === undefined) return;
142
+ for (let i = 0; i < position.count; i += 1) {
143
+ const x = position.getX(i);
144
+ position.setZ(i, Math.sin(time * 6 + x * 3) * 0.12 * (x + 0.9));
145
+ }
146
+ position.needsUpdate = true;
147
+ }
@@ -5,30 +5,23 @@
5
5
  // `qualityPreset(resolveQualityTier(...))` and nothing else, so "make it run on a phone" is one
6
6
  // file to edit rather than a hunt through anonymous literals.
7
7
  //
8
- // **Where the numbers come from.** Every millisecond below is GPU time from the per-stage
9
- // ablation recorded in the engine repository's `docs/verification/runtime-perf-state.md`: Chrome
10
- // on an RTX 2080, 1600x900, static build, `gpuMs` read from three's `timestamp-query`. In that
11
- // scene the whole five-stage chain costs **12.5 ms of a 14.7 ms GPU frame**, and the same frame
12
- // with every stage off costs **2.2 ms**. The per-stage figures oversum — removing SSGI also
13
- // removes the denoise passes the later stages sample — so read each as *what turning this one off
14
- // gave back*, not as a share of a partition. A stage nobody has ablated on its own says
15
- // `unmeasured` rather than guessing, and your scene is not that scene: read `TN_FRAME_BUDGET`
16
- // back after you change a tier.
8
+ // **Every millisecond here is a reading, and every gap says so.** The figures come from the
9
+ // per-stage ablation recorded in the engine repository's `docs/verification/runtime-perf-state.md`
10
+ // (Chrome on an RTX 2080, 1600x900, static build, `gpuMs` from three's `timestamp-query`), where
11
+ // the whole five-stage chain costs 12.5 ms of a 14.7 ms frame and the same frame with every stage
12
+ // off costs 2.2 ms. The per-stage figures oversum — removing SSGI also removes the denoise passes
13
+ // the later stages sample — so read each as *what turning this one off gave back*, not as a share
14
+ // of a partition. A stage nobody has ablated on its own says `unmeasured` rather than guessing.
17
15
  //
18
16
  // One cost that is **not** a stage here and outweighs most of them: the prefiltered reflection
19
- // probe on `scene.environment`, measured at **~6.3 ms of an 18-19 ms Pixel 8 frame**. It is set
20
- // in `sky.ts`, not in this file.
17
+ // probe on `scene.environment`, measured at ~6.3 ms of an 18-19 ms Pixel 8 frame. It is set in
18
+ // `sky.ts`, not in this file.
21
19
  //
20
+ // This level is bright: a photograph sky at full range, ~2,300 small meshes, one sun and no
21
+ // screen-space colour work. `playtests/performance.playtest.json` is the proof of the numbers
22
+ // below — read `TN_FRAME_BUDGET` back after you change a tier rather than trusting these.
22
23
  import type { IWorldEnvironmentOptions } from "./worldEnvironment.js";
23
24
 
24
- /**
25
- * The three names this game's look comes in.
26
- *
27
- * `low` is what a phone gets and `high` what a desktop gets — those two are this template's
28
- * shipped looks, unchanged. `medium` is the rung in between for a machine that is neither: a
29
- * laptop iGPU, a handheld, a desktop that is dropping frames. Nothing outside this file decides
30
- * what any of them mean.
31
- */
32
25
  export type QualityTier = "low" | "medium" | "high";
33
26
 
34
27
  const QUALITY_TIERS: readonly QualityTier[] = ["low", "medium", "high"];
@@ -49,7 +42,7 @@ function isQualityTier(value: string): value is QualityTier {
49
42
  * turned out to have no effect.
50
43
  */
51
44
  export function resolveQualityTier(
52
- request: { readonly mobile?: boolean; readonly tier?: string } = {},
45
+ request: { readonly mobile?: boolean; readonly software?: boolean; readonly tier?: string } = {},
53
46
  ): QualityTier {
54
47
  const requested = request.tier;
55
48
  if (requested !== undefined) {
@@ -60,101 +53,56 @@ export function resolveQualityTier(
60
53
  }
61
54
  return requested;
62
55
  }
56
+ // A named software adapter — SwiftShader, llvmpipe, a basic-render driver — is the machine this
57
+ // game's desktop look cannot run on: a single `high` frame on one can outlast the device it is
58
+ // drawing on, and no adaptation that reacts to frame times gets to run first. `software` is the
59
+ // fact the renderer read from `adapter.info`, not a guess from a driver string, and an explicit
60
+ // `tier` above still wins over it.
61
+ if (request.software === true) return "low";
63
62
  return request.mobile === true ? "low" : "high";
64
63
  }
65
64
 
66
65
  /**
67
- * What a desktop gets: this template's shipped desktop look, unchanged.
68
- *
69
- * The whole chain measured 12.5 ms of a 14.7 ms GPU frame in the reference ablation, and SSGI
70
- * with its denoiser is ~9.2 ms of that.
66
+ * The look every tier shares: a narrow bloom on what is genuinely brighter than white — the gold
67
+ * coins, the goal star — rather than a haze over the frame, a filmic curve so the photographed
68
+ * sky's own highlights stay highlights, and a corner falloff that frames the route.
71
69
  */
72
- const high: IWorldEnvironmentOptions = {
73
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
74
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
75
- // to be.
70
+ const shared: IWorldEnvironmentOptions = {
71
+ // Bloom: ~4.6 ms in the reference ablation — the second most expensive stage there. The
72
+ // threshold sits at 1 so only the gold and the specular hit it, never the pale stone.
76
73
  bloomEnabled: true,
77
74
  bloomRadius: 0.5,
78
- bloomStrength: 0.3,
79
- bloomThreshold: 0.62,
80
- exposure: 1.02,
81
- // The two full-resolution denoise passes over the AO and GI terms: ~1.9 ms. Only worth running
82
- // when SSGI is on — its noise is what they clean up.
83
- denoiseEnabled: true,
84
- // SSGI, the screen-space indirect-light gather: ~7.3 ms alone, ~9.2 ms with the two denoise
85
- // passes it feeds. The largest stage in the chain by a factor of two, of a 14.7 ms frame.
86
- // Dropping this pair is what `medium` is.
87
- ssgiEnabled: true,
88
- ssgiRadius: 16,
89
- ssgiQuality: "medium",
90
- // Half the frame in each axis, so a quarter of the pixels. Full-res SSGI cost 14.4 ms
91
- // of a 39.7 ms frame on an RTX 2080; this is the same gather over a quarter of the work,
92
- // and it measured *sharper* because the scaler spends what it hands back on resolution.
93
- // `worldEnvironment.ts` explains why it takes a wrapper instead of a property.
94
- ssgiResolutionScale: 0.5,
95
- // Screen-space reflections: ~4.1 ms.
96
- ssrEnabled: true,
97
- // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
98
- // are on and do nothing" — the ray dies a metre from where it started.
99
- ssrMaxDistance: 40,
100
- // A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
101
- // the rays and is very hard to see in the result.
102
- ssrResolutionScale: 0.5,
103
- // RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
104
- // denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
105
- // that runs one of them.
106
- sharpenEnabled: true,
107
- // **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
108
- sharpenStrength: 0.3,
75
+ bloomStrength: 0.18,
76
+ bloomThreshold: 1,
77
+ // The sky photograph arrives at 2.5x, so the curve and the exposure below are what bring it
78
+ // back to a daylight frame instead of a white one.
79
+ exposure: 0.6,
109
80
  tonemapMode: "aces",
81
+ vignetteAmount: 0.2,
110
82
  };
111
83
 
112
84
  /**
113
- * `high` minus the gather and its denoiser — the single change in this chain measured to give
114
- * back most of the frame: **14.7 ms -> 5.5 ms of GPU** in the reference ablation. Reflections,
115
- * bloom and the sharpener stay, so it is recognisably the same look.
85
+ * What a desktop gets on top: contact occlusion — the dark line where a foot meets the ground and
86
+ * a cliff meets the sky, which is most of what separates "objects in a world" from "objects
87
+ * pasted on a background". Gathered at full resolution and denoised; at half, the upsample left
88
+ * grain around every grass tuft.
116
89
  */
117
- const medium: IWorldEnvironmentOptions = {
118
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
119
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
120
- // to be.
121
- bloomEnabled: true,
122
- bloomRadius: 0.5,
123
- bloomStrength: 0.3,
124
- bloomThreshold: 0.62,
125
- exposure: 1.02,
126
- // Screen-space reflections: ~4.1 ms.
127
- ssrEnabled: true,
128
- // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as "reflections
129
- // are on and do nothing" — the ray dies a metre from where it started.
130
- ssrMaxDistance: 40,
131
- // A reflection carries almost no high-frequency detail, so half resolution costs a quarter of
132
- // the rays and is very hard to see in the result.
133
- ssrResolutionScale: 0.5,
134
- // RCAS sharpen: unmeasured — never ablated on its own here. It puts back the micro-detail the
135
- // denoiser and the half-resolution reflection take out, so it earns its cost only on a tier
136
- // that runs one of them.
137
- sharpenEnabled: true,
138
- // **0 is maximum sharpening and 2 is none** — it is a radius, not a gain.
139
- sharpenStrength: 0.3,
140
- tonemapMode: "aces",
90
+ const high: IWorldEnvironmentOptions = {
91
+ ...shared,
92
+ // GTAO, full resolution plus denoise: unmeasured on its own here; read `TN_FRAME_BUDGET`.
93
+ gtaoEnabled: true,
94
+ gtaoRadius: 0.4,
141
95
  };
142
96
 
97
+ /** The rung in between: the same occlusion at half the directions. Saving unmeasured. */
98
+ const medium: IWorldEnvironmentOptions = { ...high, gtaoSamples: 8 };
99
+
143
100
  /**
144
- * What a phone gets: this template's shipped mobile look, unchanged. Bloom and the tone curve,
145
- * nothing screen-space. The ablation's floor — every stage off — was 2.2 ms.
101
+ * What a phone gets: the curve, the narrow bloom and the vignette, nothing screen-space. On a
102
+ * 2,300-mesh level the per-object cost of GTAO is the part that does not scale down, so this tier
103
+ * drops it rather than the effects on top of it.
146
104
  */
147
- const low: IWorldEnvironmentOptions = {
148
- // Strength, radius and threshold are a look decision already tuned to this scene's palette.
149
- // Bloom: ~4.6 ms — the second most expensive stage in the chain, and the one nobody expects
150
- // to be.
151
- bloomEnabled: true,
152
- bloomRadius: 0.5,
153
- bloomStrength: 0.3,
154
- bloomThreshold: 0.62,
155
- exposure: 1.02,
156
- tonemapMode: "aces",
157
- };
105
+ const low: IWorldEnvironmentOptions = { ...shared, renderChainTier: "low" };
158
106
 
159
107
  const QUALITY_PRESETS: Record<QualityTier, IWorldEnvironmentOptions> = { high, low, medium };
160
108
 
@@ -0,0 +1,172 @@
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ //
3
+ // The world past the route: layered cliffs, a castle, a windmill and an airship. None of it
4
+ // collides and none of it is ever within a shadow's reach of the fox, which is the whole point of
5
+ // putting it here: it is what makes 100 m of ground read as a place rather than a corridor. The
6
+ // waterfalls that hang off the cliffs live next door in `waterfall.ts`.
7
+ import {
8
+ BoxGeometry,
9
+ type BufferGeometry,
10
+ CapsuleGeometry,
11
+ ConeGeometry,
12
+ CylinderGeometry,
13
+ Group,
14
+ type Material,
15
+ Mesh,
16
+ PlaneGeometry,
17
+ SphereGeometry,
18
+ TorusGeometry,
19
+ } from "three";
20
+ import { flat, mottle, toon } from "./materials.js";
21
+ import { C } from "./palette.js";
22
+
23
+ function mesh(geometry: BufferGeometry, material: Material, cast = true): Mesh {
24
+ const m = new Mesh(geometry, material);
25
+ m.castShadow = cast;
26
+ m.receiveShadow = true;
27
+ return m;
28
+ }
29
+
30
+ /** Distant castle with two towers, matching the skyline the route is heading for. */
31
+ export function castle(rng: () => number): Group {
32
+ const group = new Group();
33
+ const brick = toon(C.brick);
34
+ const brickDark = toon(C.brickDark);
35
+ group.add(placed(new BoxGeometry(9, 14, 8), brick, 0, 7, 0));
36
+ for (const x of [-4.5, 4.5]) {
37
+ group.add(placed(new CylinderGeometry(2.2, 2.5, 17, 10), brick, x, 8.5, 0));
38
+ group.add(placed(new CylinderGeometry(2.7, 2.7, 1, 10), brickDark, x, 17.2, 0));
39
+ for (let i = 0; i < 6; i += 1) {
40
+ const a = (i / 6) * Math.PI * 2;
41
+ group.add(
42
+ placed(
43
+ new BoxGeometry(0.7, 1.1, 0.7),
44
+ brickDark,
45
+ x + Math.cos(a) * 2.3,
46
+ 18.2,
47
+ Math.sin(a) * 2.3,
48
+ ),
49
+ );
50
+ }
51
+ }
52
+ for (let i = -4; i <= 4; i += 1)
53
+ group.add(placed(new BoxGeometry(0.8, 1.2, 0.8), brickDark, i * 1.05, 14.6, 3.6));
54
+ group.add(placed(new BoxGeometry(3, 4.4, 0.6), toon(C.woodDark), 0, 2.2, 4.1));
55
+ for (const [x, y] of [
56
+ [-2.6, 9],
57
+ [2.6, 9],
58
+ [0, 10.5],
59
+ ] as const) {
60
+ group.add(placed(new PlaneGeometry(1.7, 1.7), flat(0x2f6fa8), x, y, 4.05));
61
+ group.add(placed(new TorusGeometry(0.95, 0.16, 6, 12), brickDark, x, y, 4.05));
62
+ }
63
+ group.add(placed(new CylinderGeometry(0.08, 0.08, 5, 5), toon(C.metal), 0, 16.5, 0));
64
+ // Motes on the battlements, so the silhouette is not a stack of clean cylinders.
65
+ for (let i = 0; i < 12; i += 1)
66
+ group.add(
67
+ placed(
68
+ new BoxGeometry(0.3, 0.3, 0.3),
69
+ brickDark,
70
+ (rng() - 0.5) * 9,
71
+ 14.6 + rng() * 4,
72
+ 4 + rng(),
73
+ ),
74
+ );
75
+ return group;
76
+ }
77
+
78
+ /** Windmill. `spin` advances the sails. */
79
+ export function windmill(): { group: Group; spin(dt: number): void } {
80
+ const group = new Group();
81
+ group.add(placed(new CylinderGeometry(1.5, 2.3, 7, 10), toon(0xe6d9c2), 0, 3.5, 0));
82
+ group.add(placed(new ConeGeometry(2.1, 2.2, 10), toon(C.roof), 0, 8.1, 0));
83
+ const hub = new Group();
84
+ hub.position.set(0, 6.6, 2);
85
+ group.add(hub);
86
+ for (let i = 0; i < 4; i += 1) {
87
+ const arm = new Group();
88
+ arm.rotation.z = (i / 4) * Math.PI * 2;
89
+ hub.add(arm);
90
+ arm.add(placed(new BoxGeometry(0.18, 4.4, 0.18), toon(C.woodDark), 0, 2.2, 0));
91
+ arm.add(placed(new BoxGeometry(0.9, 3.2, 0.08), toon(0xf6f0e2), 0.6, 2.4, 0.12));
92
+ }
93
+ return {
94
+ group,
95
+ spin(dt: number): void {
96
+ hub.rotation.z += dt * 0.55;
97
+ },
98
+ };
99
+ }
100
+
101
+ /** Zeppelin drifting across the sky. */
102
+ export function airship(): Group {
103
+ const group = new Group();
104
+ const hull = mesh(new CapsuleGeometry(1.5, 4.4, 6, 12), toon(0xb9c4cc), false);
105
+ hull.rotation.z = Math.PI / 2;
106
+ group.add(hull);
107
+ const fin = mesh(new BoxGeometry(0.12, 1.4, 1.6), toon(0x8e9aa4), false);
108
+ fin.position.x = -3.5;
109
+ group.add(fin);
110
+ const gondola = mesh(new BoxGeometry(1.8, 0.7, 0.9), toon(C.woodDark), false);
111
+ gondola.position.y = -1.7;
112
+ group.add(gondola);
113
+ for (const x of [-0.6, 0.6]) {
114
+ const cable = mesh(new CylinderGeometry(0.04, 0.04, 1.1, 4), toon(0x6b6b6b), false);
115
+ cable.position.set(x, -1.1, 0);
116
+ group.add(cable);
117
+ }
118
+ return group;
119
+ }
120
+
121
+ /** A mottled cliff face, the unit every backdrop layer is built from. */
122
+ export function cliff(width: number, height: number, depth: number, rng: () => number): Group {
123
+ const group = new Group();
124
+ const segments = (n: number): number => Math.max(1, Math.min(6, Math.round(n / 3)));
125
+ const rock = new Mesh(
126
+ mottle(
127
+ new BoxGeometry(width, height, depth, segments(width), segments(height), segments(depth)),
128
+ 0.24,
129
+ rng,
130
+ ),
131
+ toon(C.rock, { flat: true, vertexColors: true }),
132
+ );
133
+ group.add(rock);
134
+ for (let i = 1; i < 4; i += 1)
135
+ group.add(
136
+ placed(
137
+ new BoxGeometry(width * 0.99, 0.8, depth + 0.2),
138
+ toon(i % 2 ? C.rockDark : C.rockLight),
139
+ 0,
140
+ height / 2 - i * 3.5,
141
+ 0,
142
+ ),
143
+ );
144
+ for (let i = 0; i < 5; i += 1) {
145
+ const boulder = new Mesh(
146
+ new SphereGeometry(1 + rng() * 1.6, 6, 5),
147
+ toon(rng() < 0.5 ? C.rockDark : C.rockLight, { flat: true }),
148
+ );
149
+ boulder.userData.faceted = true;
150
+ boulder.position.set((rng() - 0.5) * width * 0.9, (rng() - 0.5) * height * 0.9, depth / 2);
151
+ group.add(boulder);
152
+ }
153
+ group.add(
154
+ placed(new BoxGeometry(width + 0.6, 1.4, depth + 0.6), toon(C.grass), 0, height / 2, 0),
155
+ );
156
+ group.add(
157
+ placed(new BoxGeometry(width + 0.3, 0.9, depth + 0.3), toon(C.dirt), 0, height / 2 - 1.1, 0),
158
+ );
159
+ return group;
160
+ }
161
+
162
+ function placed(
163
+ geometry: BufferGeometry,
164
+ material: Material,
165
+ x: number,
166
+ y: number,
167
+ z: number,
168
+ ): Mesh {
169
+ const m = mesh(geometry, material);
170
+ m.position.set(x, y, z);
171
+ return m;
172
+ }