create-threenative 0.2.1 → 0.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (343) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +10 -2
  3. package/agent-docs/asset-mcp-loop.md +33 -0
  4. package/agent-docs/ctx-surface.md +69 -0
  5. package/agent-docs/engine-capabilities.md +4 -0
  6. package/agent-docs/framework-blocks-you.md +60 -0
  7. package/agent-docs/look-at-it-and-budget-the-look.md +27 -0
  8. package/agent-docs/performance-default.md +42 -0
  9. package/agent-docs/pixel-budget.md +20 -0
  10. package/agent-docs/playtest-fail-closed.md +23 -0
  11. package/agent-docs/references/assertion-reference.md +652 -0
  12. package/agent-docs/references/capability-reference.md +3279 -0
  13. package/agent-docs/references/capture-the-frame.md +53 -0
  14. package/agent-docs/references/ctx-cookbook.md +51 -0
  15. package/agent-docs/references/debug-surface.md +63 -0
  16. package/agent-docs/references/finding-assets.md +147 -0
  17. package/agent-docs/references/gameplay-recipes.md +54 -0
  18. package/agent-docs/references/menu-screens.md +69 -0
  19. package/agent-docs/references/mobile-memory-budget.md +87 -0
  20. package/agent-docs/references/sculpt-from-a-reference.md +39 -0
  21. package/agent-docs/references/visual-baseline.md +133 -0
  22. package/agent-docs/references/webview-ui.md +113 -0
  23. package/agent-docs/sculpt-loop.md +16 -0
  24. package/agent-files/.agents/skills/threenative-builder/SKILL.md +7 -0
  25. package/agent-files/.agents/skills/threenative-verifier/SKILL.md +7 -0
  26. package/agent-files/.claude/agents/threenative-builder.md +7 -0
  27. package/agent-files/.claude/agents/threenative-verifier.md +7 -0
  28. package/agent-files/.threenative/agents/builder.md +32 -0
  29. package/agent-files/.threenative/agents/verifier.md +31 -0
  30. package/agent-files/AGENT-ROLES.md +26 -0
  31. package/capabilities.json +3542 -0
  32. package/dist/index.d.ts +191 -3
  33. package/dist/index.js +1707 -73
  34. package/dist/threenative.d.ts +9 -2
  35. package/dist/threenative.js +1825 -148
  36. package/package.json +30 -6
  37. package/template-assets/loading.ts +315 -0
  38. package/template-assets/patches/three@0.185.1.patch +287 -0
  39. package/templates/action-rpg/.codex/config.toml +15 -0
  40. package/templates/action-rpg/.mcp.json +6 -2
  41. package/templates/action-rpg/AGENTS.md +370 -6
  42. package/templates/action-rpg/CLAUDE.md +370 -6
  43. package/templates/action-rpg/index.html +0 -1
  44. package/templates/action-rpg/package.json +15 -11
  45. package/templates/action-rpg/playtests/combat.playtest.json +23 -9
  46. package/templates/action-rpg/playtests/fail.playtest.json +3 -3
  47. package/templates/action-rpg/playtests/inventory.playtest.json +16 -10
  48. package/templates/action-rpg/playtests/performance.playtest.json +22 -0
  49. package/templates/action-rpg/playtests/progress.playtest.json +18 -13
  50. package/templates/action-rpg/playtests/win.playtest.json +10 -4
  51. package/templates/action-rpg/public/icon.png +0 -0
  52. package/templates/action-rpg/src/entities/Enemy.ts +14 -4
  53. package/templates/action-rpg/src/game.ts +21 -0
  54. package/templates/action-rpg/src/render/lighting.ts +6 -1
  55. package/templates/action-rpg/src/render/loading.ts +267 -42
  56. package/templates/action-rpg/src/render/postprocessing.ts +68 -15
  57. package/templates/action-rpg/src/render/worldEnvironment.ts +583 -0
  58. package/templates/action-rpg/src/scenes/Play.ts +49 -19
  59. package/templates/action-rpg/src/state.ts +4 -0
  60. package/templates/action-rpg/src/style.css +45 -1
  61. package/templates/action-rpg/src/ui/AbilityBar.tsx +9 -7
  62. package/templates/action-rpg/src/ui/App.tsx +9 -8
  63. package/templates/action-rpg/src/ui/CharacterPanel.tsx +10 -8
  64. package/templates/action-rpg/src/ui/GameUi.tsx +24 -0
  65. package/templates/action-rpg/src/ui/Hud.tsx +10 -8
  66. package/templates/action-rpg/src/ui/InventoryPanel.tsx +9 -7
  67. package/templates/action-rpg/src/ui/main.tsx +14 -0
  68. package/templates/action-rpg/threenative.config.ts +21 -8
  69. package/templates/action-rpg/vite.config.ts +32 -2
  70. package/templates/defense/.codex/config.toml +15 -0
  71. package/templates/defense/.mcp.json +6 -2
  72. package/templates/defense/AGENTS.md +371 -8
  73. package/templates/defense/CLAUDE.md +371 -8
  74. package/templates/defense/README.md +2 -1
  75. package/templates/defense/index.html +0 -1
  76. package/templates/defense/package.json +16 -12
  77. package/templates/defense/playtests/leak.playtest.json +9 -4
  78. package/templates/defense/playtests/performance.playtest.json +22 -0
  79. package/templates/defense/playtests/placement.playtest.json +5 -5
  80. package/templates/defense/playtests/pointer-placement.playtest.json +89 -0
  81. package/templates/defense/playtests/scan.playtest.json +3 -3
  82. package/templates/defense/playtests/survive.playtest.json +11 -6
  83. package/templates/defense/public/icon.png +0 -0
  84. package/templates/defense/src/attackers/Attacker.ts +28 -12
  85. package/templates/defense/src/game.ts +24 -2
  86. package/templates/defense/src/render/lighting.ts +6 -1
  87. package/templates/defense/src/render/loading.ts +263 -37
  88. package/templates/defense/src/render/postprocessing.ts +70 -13
  89. package/templates/defense/src/render/shapes.ts +38 -0
  90. package/templates/defense/src/render/worldEnvironment.ts +583 -0
  91. package/templates/defense/src/scenes/Defense.ts +109 -50
  92. package/templates/defense/src/state.ts +6 -0
  93. package/templates/defense/src/style.css +45 -1
  94. package/templates/defense/src/ui/App.tsx +9 -4
  95. package/templates/defense/src/ui/GameUi.tsx +20 -0
  96. package/templates/defense/src/ui/Hud.tsx +6 -5
  97. package/templates/defense/src/ui/main.tsx +14 -0
  98. package/templates/defense/threenative.config.ts +21 -8
  99. package/templates/defense/vite.config.ts +34 -1
  100. package/templates/minimal/.codex/config.toml +15 -0
  101. package/templates/minimal/.mcp.json +6 -2
  102. package/templates/minimal/AGENTS.md +360 -255
  103. package/templates/minimal/CLAUDE.md +360 -255
  104. package/templates/minimal/index.html +0 -1
  105. package/templates/minimal/package.json +14 -11
  106. package/templates/minimal/playtests/atmosphere.playtest.json +32 -0
  107. package/templates/minimal/playtests/play.playtest.json +17 -5
  108. package/templates/minimal/public/icon.png +0 -0
  109. package/templates/minimal/src/game.ts +1 -0
  110. package/templates/minimal/src/render/camera.ts +1 -1
  111. package/templates/minimal/src/render/hud.ts +24 -8
  112. package/templates/minimal/src/render/lighting.ts +23 -2
  113. package/templates/minimal/src/render/loading.ts +23 -103
  114. package/templates/minimal/src/render/postprocessing.ts +92 -14
  115. package/templates/minimal/src/render/sky.ts +37 -32
  116. package/templates/minimal/src/render/worldEnvironment.ts +583 -0
  117. package/templates/minimal/src/scenes/Play.ts +91 -13
  118. package/templates/minimal/src/state.ts +8 -1
  119. package/templates/minimal/threenative.config.ts +15 -10
  120. package/templates/minimal/vite.config.ts +28 -1
  121. package/templates/platformer/.codex/config.toml +15 -0
  122. package/templates/platformer/.mcp.json +6 -2
  123. package/templates/platformer/AGENTS.md +385 -130
  124. package/templates/platformer/CLAUDE.md +385 -130
  125. package/templates/platformer/index.html +0 -1
  126. package/templates/platformer/package.json +17 -14
  127. package/templates/platformer/playtests/avoidance.playtest.json +6 -1
  128. package/templates/platformer/playtests/branding.playtest.json +29 -0
  129. package/templates/platformer/playtests/buffer.playtest.json +1 -1
  130. package/templates/platformer/playtests/collect.playtest.json +1 -1
  131. package/templates/platformer/playtests/collision-layers.playtest.json +2 -2
  132. package/templates/platformer/playtests/coyote.playtest.json +42 -8
  133. package/templates/platformer/playtests/damage.playtest.json +4 -1
  134. package/templates/platformer/playtests/dash.playtest.json +2 -2
  135. package/templates/platformer/playtests/jump.playtest.json +2 -3
  136. package/templates/platformer/playtests/native/touch-controls.playtest.json +33 -0
  137. package/templates/platformer/playtests/oneway.playtest.json +1 -1
  138. package/templates/platformer/playtests/performance.playtest.json +6 -5
  139. package/templates/platformer/playtests/respawn.playtest.json +2 -2
  140. package/templates/platformer/playtests/stomp-rise.playtest.json +17 -3
  141. package/templates/platformer/playtests/stomp.playtest.json +11 -3
  142. package/templates/platformer/playtests/terminal-loop-fail.playtest.json +13 -4
  143. package/templates/platformer/playtests/terminal-loop-win.playtest.json +3 -3
  144. package/templates/platformer/playtests/touch-controls-web.playtest.json +46 -0
  145. package/templates/platformer/public/icon.png +0 -0
  146. package/templates/platformer/src/entities/Character.ts +16 -10
  147. package/templates/platformer/src/entities/Patrol.ts +5 -0
  148. package/templates/platformer/src/game.ts +24 -1
  149. package/templates/platformer/src/render/lighting.ts +6 -1
  150. package/templates/platformer/src/render/loading.ts +270 -61
  151. package/templates/platformer/src/render/postprocessing.ts +68 -15
  152. package/templates/platformer/src/render/touch-controls.ts +54 -36
  153. package/templates/platformer/src/render/worldEnvironment.ts +583 -0
  154. package/templates/platformer/src/scenes/Level.ts +47 -22
  155. package/templates/platformer/src/state.ts +4 -0
  156. package/templates/platformer/src/style.css +45 -1
  157. package/templates/platformer/src/ui/App.tsx +9 -4
  158. package/templates/platformer/src/ui/GameUi.tsx +20 -0
  159. package/templates/platformer/src/ui/Hud.tsx +6 -5
  160. package/templates/platformer/src/ui/main.tsx +14 -0
  161. package/templates/platformer/threenative.config.ts +20 -10
  162. package/templates/platformer/vite.config.ts +34 -1
  163. package/templates/racing/.codex/config.toml +15 -0
  164. package/templates/racing/.mcp.json +6 -2
  165. package/templates/racing/AGENTS.md +370 -6
  166. package/templates/racing/CLAUDE.md +370 -6
  167. package/templates/racing/index.html +0 -1
  168. package/templates/racing/package.json +16 -12
  169. package/templates/racing/playtests/boost.playtest.json +5 -5
  170. package/templates/racing/playtests/outcome.playtest.json +14 -4
  171. package/templates/racing/playtests/performance.playtest.json +22 -0
  172. package/templates/racing/playtests/ranking.playtest.json +2 -2
  173. package/templates/racing/playtests/rescue.playtest.json +12 -6
  174. package/templates/racing/playtests/reverse.playtest.json +3 -3
  175. package/templates/racing/playtests/shortcut.playtest.json +3 -3
  176. package/templates/racing/public/icon.png +0 -0
  177. package/templates/racing/src/game.ts +24 -1
  178. package/templates/racing/src/render/camera.ts +10 -6
  179. package/templates/racing/src/render/lighting.ts +6 -1
  180. package/templates/racing/src/render/loading.ts +291 -34
  181. package/templates/racing/src/render/postprocessing.ts +70 -13
  182. package/templates/racing/src/render/worldEnvironment.ts +583 -0
  183. package/templates/racing/src/scenes/Race.ts +68 -36
  184. package/templates/racing/src/state.ts +4 -0
  185. package/templates/racing/src/style.css +45 -1
  186. package/templates/racing/src/track/Lap.ts +20 -9
  187. package/templates/racing/src/track/Ranking.ts +53 -14
  188. package/templates/racing/src/track/Track.ts +29 -16
  189. package/templates/racing/src/track/TrackSector.ts +14 -4
  190. package/templates/racing/src/ui/App.tsx +9 -4
  191. package/templates/racing/src/ui/GameUi.tsx +20 -0
  192. package/templates/racing/src/ui/Hud.tsx +6 -5
  193. package/templates/racing/src/ui/main.tsx +14 -0
  194. package/templates/racing/threenative.config.ts +21 -8
  195. package/templates/racing/vite.config.ts +34 -1
  196. package/templates/sailing/.codex/config.toml +15 -0
  197. package/templates/sailing/.mcp.json +20 -0
  198. package/templates/sailing/AGENTS.md +388 -0
  199. package/templates/sailing/CLAUDE.md +390 -0
  200. package/templates/sailing/README.md +25 -0
  201. package/templates/sailing/index.html +12 -0
  202. package/templates/sailing/kit.json +7 -0
  203. package/templates/sailing/native-playtests/survives.playtest.json +21 -0
  204. package/templates/sailing/package.json +52 -0
  205. package/templates/sailing/playtests/fail.playtest.json +24 -0
  206. package/templates/sailing/playtests/performance.playtest.json +21 -0
  207. package/templates/sailing/playtests/survives.playtest.json +38 -0
  208. package/templates/sailing/playtests/win.playtest.json +31 -0
  209. package/templates/sailing/public/favicon.svg +5 -0
  210. package/templates/sailing/public/icon.png +0 -0
  211. package/templates/sailing/src/entities/Ship.ts +96 -0
  212. package/templates/sailing/src/game.ts +40 -0
  213. package/templates/sailing/src/main.ts +15 -0
  214. package/templates/sailing/src/render/camera.ts +21 -0
  215. package/templates/sailing/src/render/lighting.ts +36 -0
  216. package/templates/sailing/src/render/loading.ts +315 -0
  217. package/templates/sailing/src/render/materials.ts +28 -0
  218. package/templates/sailing/src/render/palette.ts +24 -0
  219. package/templates/sailing/src/render/postprocessing.ts +33 -0
  220. package/templates/sailing/src/render/props.ts +52 -0
  221. package/templates/sailing/src/render/sky.ts +32 -0
  222. package/templates/sailing/src/render/water-material.ts +14 -0
  223. package/templates/sailing/src/render/water-shaders.ts +12 -0
  224. package/templates/sailing/src/render/wave-nodes.ts +10 -0
  225. package/templates/sailing/src/render/worldEnvironment.ts +590 -0
  226. package/templates/sailing/src/scenes/Boot.ts +12 -0
  227. package/templates/sailing/src/scenes/Sailing.ts +106 -0
  228. package/templates/sailing/src/state.ts +10 -0
  229. package/templates/sailing/src/style.css +61 -0
  230. package/templates/sailing/src/ui/App.tsx +15 -0
  231. package/templates/sailing/src/ui/GameUi.tsx +12 -0
  232. package/templates/sailing/src/ui/Hud.tsx +55 -0
  233. package/templates/sailing/src/ui/Menu.tsx +30 -0
  234. package/templates/sailing/src/ui/main.tsx +7 -0
  235. package/templates/sailing/tailwind.config.ts +2 -0
  236. package/templates/sailing/threenative.config.ts +34 -0
  237. package/templates/sailing/tsconfig.json +17 -0
  238. package/templates/sailing/vite.config.ts +34 -0
  239. package/templates/shooter/.codex/config.toml +15 -0
  240. package/templates/shooter/.mcp.json +6 -2
  241. package/templates/shooter/AGENTS.md +373 -7
  242. package/templates/shooter/CLAUDE.md +373 -7
  243. package/templates/shooter/index.html +0 -1
  244. package/templates/shooter/package.json +16 -11
  245. package/templates/shooter/playtests/fail.playtest.json +5 -4
  246. package/templates/shooter/playtests/input-control.playtest.json +131 -0
  247. package/templates/shooter/playtests/per-item.playtest.json +59 -0
  248. package/templates/shooter/playtests/performance.playtest.json +22 -0
  249. package/templates/shooter/playtests/shooter.playtest.json +22 -18
  250. package/templates/shooter/playtests/survives.playtest.json +1 -1
  251. package/templates/shooter/public/favicon.svg +1 -1
  252. package/templates/shooter/public/icon.png +0 -0
  253. package/templates/shooter/src/game.ts +24 -1
  254. package/templates/shooter/src/main.ts +3 -13
  255. package/templates/shooter/src/render/camera.ts +62 -12
  256. package/templates/shooter/src/render/lighting.ts +6 -1
  257. package/templates/shooter/src/render/loading.ts +262 -33
  258. package/templates/shooter/src/render/palette.ts +1 -1
  259. package/templates/shooter/src/render/postprocessing.ts +68 -16
  260. package/templates/shooter/src/render/shapes.ts +178 -0
  261. package/templates/shooter/src/render/ui.css +34 -1
  262. package/templates/shooter/src/render/worldEnvironment.ts +583 -0
  263. package/templates/shooter/src/scenes/Play.ts +246 -73
  264. package/templates/shooter/src/state.ts +13 -0
  265. package/templates/shooter/src/style.css +26 -0
  266. package/templates/shooter/src/ui/App.tsx +10 -12
  267. package/templates/shooter/src/ui/GameUi.tsx +20 -0
  268. package/templates/shooter/src/ui/Hud.tsx +8 -10
  269. package/templates/shooter/src/ui/Menu.tsx +24 -9
  270. package/templates/shooter/src/ui/main.tsx +15 -0
  271. package/templates/shooter/src/weapons/Projectile.ts +21 -10
  272. package/templates/shooter/threenative.config.ts +21 -8
  273. package/templates/shooter/vite.config.ts +32 -2
  274. package/templates/starter/.codex/config.toml +15 -0
  275. package/templates/starter/.mcp.json +6 -2
  276. package/templates/starter/AGENTS.md +429 -326
  277. package/templates/starter/CLAUDE.md +429 -326
  278. package/templates/starter/assets/pickup.wav +0 -0
  279. package/templates/starter/gitignore +4 -0
  280. package/templates/starter/index.html +0 -1
  281. package/templates/starter/native-playtests/react-hud.playtest.json +20 -0
  282. package/templates/starter/native-playtests/render-chain.playtest.json +12 -0
  283. package/templates/starter/package.json +16 -12
  284. package/templates/starter/playtests/assets.playtest.json +65 -0
  285. package/templates/starter/playtests/buffer.playtest.json +59 -9
  286. package/templates/starter/playtests/cloth.playtest.json +113 -0
  287. package/templates/starter/playtests/coyote.playtest.json +60 -8
  288. package/templates/starter/playtests/forward.playtest.json +29 -4
  289. package/templates/starter/playtests/gameover.playtest.json +66 -0
  290. package/templates/starter/playtests/goal.playtest.json +67 -0
  291. package/templates/starter/playtests/hot-reload.playtest.json +48 -8
  292. package/templates/starter/playtests/look.playtest.json +34 -6
  293. package/templates/starter/playtests/models-baseline.png +0 -0
  294. package/templates/starter/playtests/models.playtest.json +74 -0
  295. package/templates/starter/playtests/monitoring.playtest.json +38 -7
  296. package/templates/starter/playtests/odometer.playtest.json +54 -0
  297. package/templates/starter/playtests/pause.playtest.json +27 -4
  298. package/templates/starter/playtests/play.playtest.json +43 -7
  299. package/templates/starter/playtests/respawn.playtest.json +46 -6
  300. package/templates/starter/playtests/restart.playtest.json +65 -10
  301. package/templates/starter/playtests/seed.playtest.json +44 -8
  302. package/templates/starter/playtests/survives.playtest.json +27 -4
  303. package/templates/starter/playtests/textures-baseline.png +0 -0
  304. package/templates/starter/playtests/textures.playtest.json +74 -0
  305. package/templates/starter/playtests/zoom-pinch.playtest.json +86 -0
  306. package/templates/starter/playtests/zoom-wheel.playtest.json +59 -0
  307. package/templates/starter/public/icon.png +0 -0
  308. package/templates/starter/src/entities/Goal.ts +122 -0
  309. package/templates/starter/src/entities/Player.ts +40 -2
  310. package/templates/starter/src/game.ts +25 -0
  311. package/templates/starter/src/render/camera.ts +31 -5
  312. package/templates/starter/src/render/easing.ts +5 -0
  313. package/templates/starter/src/render/effects/gradualBackground.ts +48 -0
  314. package/templates/starter/src/render/effects/lensDistortion.ts +43 -0
  315. package/templates/starter/src/render/effects/sparkle.ts +49 -0
  316. package/templates/starter/src/render/lighting.ts +6 -1
  317. package/templates/starter/src/render/loading.ts +315 -0
  318. package/templates/starter/src/render/materials.ts +17 -1
  319. package/templates/starter/src/render/pennant.ts +54 -0
  320. package/templates/starter/src/render/postprocessing.ts +46 -15
  321. package/templates/starter/src/render/scenery.ts +83 -0
  322. package/templates/starter/src/render/shapes.ts +9 -21
  323. package/templates/starter/src/render/worldEnvironment.ts +583 -0
  324. package/templates/starter/src/scenes/Play.ts +146 -36
  325. package/templates/starter/src/state.ts +12 -0
  326. package/templates/starter/src/style.css +45 -1
  327. package/templates/starter/src/ui/App.tsx +9 -6
  328. package/templates/starter/src/ui/GameUi.tsx +20 -0
  329. package/templates/starter/src/ui/Hud.tsx +52 -29
  330. package/templates/starter/src/ui/Menu.tsx +25 -23
  331. package/templates/starter/src/ui/main.tsx +14 -0
  332. package/templates/starter/threenative.config.ts +27 -9
  333. package/templates/starter/tools/look.mjs +109 -0
  334. package/templates/starter/vite.config.ts +32 -2
  335. package/templates/minimal/assets/.gitkeep +0 -0
  336. package/templates/minimal/public/.gitkeep +0 -0
  337. package/templates/platformer/assets/.gitkeep +0 -0
  338. package/templates/platformer/public/.gitkeep +0 -0
  339. package/templates/starter/assets/.gitkeep +0 -0
  340. package/templates/starter/public/.gitkeep +0 -0
  341. package/templates/starter/public/pickup.ogg +0 -0
  342. /package/templates/starter/{public → assets}/native-proof.glb +0 -0
  343. /package/templates/starter/{public → assets}/native-proof.png +0 -0
@@ -1,14 +1,33 @@
1
1
  import {
2
2
  type Camera,
3
+ CanvasTexture,
4
+ ClampToEdgeWrapping,
3
5
  Mesh,
4
6
  MeshBasicMaterial,
5
7
  type OrthographicCamera,
6
8
  PlaneGeometry,
7
9
  type Scene,
10
+ type Texture,
8
11
  } from "three";
9
12
  import { palette } from "./palette.js";
10
13
 
11
- export interface LoadingHost {
14
+ /* BEGIN THREENATIVE LOADING APPEARANCE */
15
+ /** Shooter look and composition; edit this generated source for the launch screen. */
16
+ export const loading = {
17
+ backgroundColor: palette.skyLow,
18
+ backgroundImage: undefined as string | undefined,
19
+ enabled: true,
20
+ fillImage: undefined as string | undefined,
21
+ logoImage: undefined as string | undefined,
22
+ progressColor: palette.accent,
23
+ showStatus: false,
24
+ trackColor: palette.skyHigh,
25
+ bar: { anchorX: 0.5, anchorY: 0.74, height: 10, maxWidth: 520, minWidth: 1, width: 0.6 },
26
+ } as const;
27
+ /* END THREENATIVE LOADING APPEARANCE */
28
+
29
+ interface ILoadingHost {
30
+ readonly assets?: { texture(path: string): Promise<Texture> };
12
31
  readonly camera: Camera;
13
32
  readonly canvasLayer: {
14
33
  readonly camera: OrthographicCamera;
@@ -16,71 +35,281 @@ export interface LoadingHost {
16
35
  opaque: boolean;
17
36
  };
18
37
  readonly renderer: { compileAsync(scene: Scene, camera: Camera): Promise<void> };
38
+ readonly scene: Scene;
19
39
  readonly startup: { readonly progress: number; whenReady(): Promise<void> };
40
+ readonly viewport?: {
41
+ readonly safeArea: { height: number; width: number; x: number; y: number };
42
+ };
43
+ }
44
+
45
+ interface ILoadingController {
46
+ update(): void;
47
+ finish(): void;
48
+ }
49
+
50
+ function noOp(layer: ILoadingHost["canvasLayer"]): ILoadingController {
51
+ layer.opaque = false;
52
+ return { finish: () => undefined, update: () => undefined };
53
+ }
54
+
55
+ function meshFor(
56
+ layer: ILoadingHost["canvasLayer"],
57
+ material: MeshBasicMaterial,
58
+ renderOrder: number,
59
+ ): Mesh<PlaneGeometry, MeshBasicMaterial> {
60
+ const mesh = new Mesh(new PlaneGeometry(1, 1), material);
61
+ mesh.frustumCulled = false;
62
+ mesh.renderOrder = renderOrder;
63
+ layer.scene.add(mesh);
64
+ return mesh;
65
+ }
66
+
67
+ function imageAspect(texture: Texture | null | undefined): number {
68
+ const image = texture?.image as { height?: number; width?: number } | undefined;
69
+ const width = image?.width ?? 1;
70
+ const height = image?.height ?? 1;
71
+ return width > 0 && height > 0 ? width / height : 1;
72
+ }
73
+
74
+ function configureTexture(texture: Texture): void {
75
+ texture.wrapS = ClampToEdgeWrapping;
76
+ texture.wrapT = ClampToEdgeWrapping;
77
+ texture.needsUpdate = true;
78
+ }
79
+
80
+ function setFillUv(geometry: PlaneGeometry, progress: number, base: readonly number[]): void {
81
+ const uv = geometry.getAttribute("uv");
82
+ for (let index = 0; index < uv.count; index += 1) uv.setX(index, (base[index] ?? 0) * progress);
83
+ uv.needsUpdate = true;
84
+ }
85
+
86
+ function coverUv(
87
+ geometry: PlaneGeometry,
88
+ texture: Texture,
89
+ width: number,
90
+ height: number,
91
+ baseU: readonly number[],
92
+ baseV: readonly number[],
93
+ ): void {
94
+ const imageRatio = imageAspect(texture);
95
+ const boxRatio = width / Math.max(1, height);
96
+ const visibleU = imageRatio > boxRatio ? boxRatio / imageRatio : 1;
97
+ const visibleV = imageRatio < boxRatio ? imageRatio / boxRatio : 1;
98
+ const offsetU = (1 - visibleU) / 2;
99
+ const offsetV = (1 - visibleV) / 2;
100
+ const uv = geometry.getAttribute("uv");
101
+ for (let index = 0; index < uv.count; index += 1) {
102
+ uv.setX(index, offsetU + (baseU[index] ?? 0) * visibleU);
103
+ uv.setY(index, offsetV + (baseV[index] ?? 0) * visibleV);
104
+ }
105
+ uv.needsUpdate = true;
106
+ }
107
+
108
+ function statusMesh(
109
+ layer: ILoadingHost["canvasLayer"],
110
+ ):
111
+ | { mesh: Mesh<PlaneGeometry, MeshBasicMaterial>; texture: Texture; update(value: number): void }
112
+ | undefined {
113
+ if (!loading.showStatus || typeof document === "undefined") return undefined;
114
+ const canvas = document.createElement("canvas");
115
+ canvas.width = 180;
116
+ canvas.height = 48;
117
+ const context = canvas.getContext("2d");
118
+ if (context === null) return undefined;
119
+ const texture = new CanvasTexture(canvas);
120
+ const mesh = meshFor(
121
+ layer,
122
+ new MeshBasicMaterial({ depthTest: false, depthWrite: false, map: texture, transparent: true }),
123
+ 4,
124
+ );
125
+ const update = (value: number): void => {
126
+ context.clearRect(0, 0, canvas.width, canvas.height);
127
+ context.fillStyle = "#ffffff";
128
+ context.font = "700 20px monospace";
129
+ context.textAlign = "center";
130
+ context.textBaseline = "middle";
131
+ context.fillText(`${Math.round(value * 100)}%`, canvas.width / 2, canvas.height / 2);
132
+ texture.needsUpdate = true;
133
+ };
134
+ update(0);
135
+ return { mesh, texture, update };
20
136
  }
21
137
 
22
- export function createLoadingScreen(host: LoadingHost) {
138
+ export function createLoadingScreen(host: ILoadingHost): ILoadingController {
23
139
  const layer = host.canvasLayer;
140
+ if (!loading.enabled) return noOp(layer);
24
141
  const camera = layer.camera;
25
- const cover = (color: number, order: number): Mesh => {
26
- const mesh = new Mesh(
27
- new PlaneGeometry(1, 1),
28
- new MeshBasicMaterial({ color, depthTest: false, depthWrite: false }),
29
- );
30
- mesh.frustumCulled = false;
31
- mesh.renderOrder = order;
32
- layer.scene.add(mesh);
33
- return mesh;
34
- };
35
- const backdrop = cover(palette.skyLow, 0);
36
- const track = cover(palette.skyHigh, 1);
37
- const fill = cover(palette.accent, 2);
38
- layer.opaque = true;
142
+ const backdrop = meshFor(
143
+ layer,
144
+ new MeshBasicMaterial({ color: loading.backgroundColor, depthTest: false, depthWrite: false }),
145
+ 0,
146
+ );
147
+ const track = meshFor(
148
+ layer,
149
+ new MeshBasicMaterial({ color: loading.trackColor, depthTest: false, depthWrite: false }),
150
+ 1,
151
+ );
152
+ const fill = meshFor(
153
+ layer,
154
+ new MeshBasicMaterial({ color: loading.progressColor, depthTest: false, depthWrite: false }),
155
+ 2,
156
+ );
157
+ const fillBaseU = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
158
+ fill.geometry.getAttribute("uv").getX(index),
159
+ );
160
+ const fillBaseV = Array.from({ length: fill.geometry.getAttribute("uv").count }, (_, index) =>
161
+ fill.geometry.getAttribute("uv").getY(index),
162
+ );
163
+ const logo =
164
+ loading.logoImage === undefined
165
+ ? undefined
166
+ : meshFor(
167
+ layer,
168
+ new MeshBasicMaterial({
169
+ color: 0xffffff,
170
+ depthTest: false,
171
+ depthWrite: false,
172
+ transparent: true,
173
+ }),
174
+ 3,
175
+ );
176
+ const status = statusMesh(layer);
177
+ const parts = [
178
+ backdrop,
179
+ track,
180
+ fill,
181
+ ...(logo === undefined ? [] : [logo]),
182
+ ...(status === undefined ? [] : [status.mesh]),
183
+ ];
184
+ const ownedTextures = new Set<Texture>(status === undefined ? [] : [status.texture]);
39
185
  let width = 1;
40
186
  let height = 1;
187
+ let barWidth = 1;
188
+ let barHeight: number = loading.bar.height;
189
+ let barX = 0;
190
+ let barY = 0;
41
191
  let progress = 0;
192
+ let done = false;
193
+ let backdropTexture: Texture | undefined;
42
194
 
43
195
  const layout = (): void => {
44
196
  width = Math.max(1, camera.right - camera.left);
45
197
  height = Math.max(1, camera.top - camera.bottom);
198
+ const safe = host.viewport?.safeArea ?? { height, width, x: 0, y: 0 };
199
+ const safeWidth = Math.max(1, Math.min(width, safe.width));
200
+ const safeHeight = Math.max(1, Math.min(height, safe.height));
201
+ const safeX = Math.max(0, Math.min(width - safeWidth, safe.x));
202
+ const safeY = Math.max(0, Math.min(height - safeHeight, safe.y));
203
+ barWidth = Math.max(2, Math.min(loading.bar.maxWidth, safeWidth * loading.bar.width));
204
+ barHeight = Math.max(2, Math.min(loading.bar.height, safeHeight * 0.05));
205
+ barX = safeX + safeWidth * loading.bar.anchorX;
206
+ barY = safeY + safeHeight * loading.bar.anchorY;
207
+ const worldX = (screenX: number): number => camera.left + screenX;
208
+ const worldY = (screenY: number): number => camera.top - screenY;
209
+ const visibleWidth = Math.max(loading.bar.minWidth, barWidth * progress);
46
210
  backdrop.scale.set(width, height, 1);
47
- track.scale.set(width * 0.48, height * 0.012, 1);
48
- track.position.set(0, -height * 0.06, 0);
211
+ backdrop.position.set(worldX(width / 2), worldY(height / 2), 0);
212
+ track.scale.set(barWidth, barHeight, 1);
213
+ track.position.set(worldX(barX), worldY(barY), 0);
214
+ fill.scale.set(visibleWidth, barHeight, 1);
215
+ fill.position.set(worldX(barX - barWidth / 2 + visibleWidth / 2), worldY(barY), 0);
216
+ if (logo?.visible) {
217
+ const logoWidth = Math.min(safeWidth * 0.42, 280);
218
+ logo.scale.set(
219
+ logoWidth,
220
+ Math.min(logoWidth / imageAspect(logo.material.map), safeHeight * 0.22),
221
+ 1,
222
+ );
223
+ logo.position.set(worldX(barX), worldY(Math.max(safeY, barY - safeHeight * 0.2)), 0);
224
+ }
225
+ if (status !== undefined) {
226
+ status.mesh.scale.set(Math.min(180, safeWidth * 0.32), 48, 1);
227
+ status.mesh.position.set(worldX(barX), worldY(Math.min(height, barY + barHeight * 2.5)), 0);
228
+ }
229
+ if (backdropTexture !== undefined)
230
+ coverUv(backdrop.geometry, backdropTexture, width, height, fillBaseU, fillBaseV);
49
231
  };
50
- const setProgress = (value: number): void => {
232
+
233
+ const updateProgress = (value: number): void => {
51
234
  progress = Number.isFinite(value) ? Math.max(0, Math.min(1, value)) : 0;
52
- const full = width * 0.48;
53
- const bar = Math.max(full * 0.002, full * progress);
54
- fill.scale.set(bar, height * 0.012, 1);
55
- fill.position.set(-full / 2 + bar / 2, -height * 0.06, 0);
235
+ setFillUv(fill.geometry, progress, fillBaseU);
236
+ status?.update(progress);
237
+ layout();
238
+ };
239
+
240
+ const attachTexture = (mesh: Mesh<PlaneGeometry, MeshBasicMaterial>, texture: Texture): void => {
241
+ if (done) return;
242
+ configureTexture(texture);
243
+ mesh.material.map = texture;
244
+ mesh.material.color.set(0xffffff);
245
+ mesh.material.needsUpdate = true;
246
+ ownedTextures.add(texture);
247
+ if (mesh === backdrop) backdropTexture = texture;
248
+ layout();
249
+ updateProgress(progress);
56
250
  };
251
+
252
+ const load = (source: string | undefined, mesh: Mesh<PlaneGeometry, MeshBasicMaterial>): void => {
253
+ if (source === undefined || host.assets === undefined) return;
254
+ void host.assets
255
+ .texture(source)
256
+ .then((texture) => attachTexture(mesh, texture))
257
+ .catch(() => undefined);
258
+ };
259
+ load(loading.backgroundImage, backdrop);
260
+ load(loading.fillImage, fill);
261
+ if (logo !== undefined && loading.logoImage !== undefined && host.assets !== undefined) {
262
+ void host.assets
263
+ .texture(loading.logoImage)
264
+ .then((texture) => {
265
+ if (done) return;
266
+ configureTexture(texture);
267
+ logo.material.map = texture;
268
+ logo.material.needsUpdate = true;
269
+ logo.visible = true;
270
+ ownedTextures.add(texture);
271
+ layout();
272
+ })
273
+ .catch(() => undefined);
274
+ }
275
+
276
+ layer.opaque = true;
57
277
  layout();
58
- setProgress(0);
59
- let done = false;
278
+ updateProgress(0);
279
+
60
280
  const finish = (): void => {
61
281
  if (done) return;
62
282
  done = true;
63
- for (const mesh of [backdrop, track, fill]) {
283
+ for (const mesh of parts) {
64
284
  mesh.removeFromParent();
65
285
  mesh.geometry.dispose();
66
- if (!Array.isArray(mesh.material)) mesh.material.dispose();
286
+ mesh.material.dispose();
67
287
  }
288
+ for (const texture of ownedTextures) texture.dispose();
68
289
  layer.opaque = false;
69
290
  };
291
+
70
292
  void (async () => {
71
293
  await host.startup.whenReady();
72
- await host.renderer.compileAsync(host.canvasLayer.scene, host.camera).catch(() => undefined);
294
+ if (done) return;
295
+ // Prewarm the world's shaders, but do not wait for them here. `whenReady()` already means the
296
+ // world is safe to show, and compiling a lit, post-processed scene takes far longer than the
297
+ // launch window: hold the screen for it and a playtest — which advances a fixed step as fast
298
+ // as the machine allows — runs an entire scenario behind the launch screen, so every capture
299
+ // photographs the loading bar instead of the game. The prewarm still happens; it no longer
300
+ // decides when the player sees the world.
301
+ try {
302
+ void host.renderer.compileAsync(host.scene, host.camera).catch(() => undefined);
303
+ } catch {
304
+ // A renderer without compileAsync is not a reason to keep the world hidden.
305
+ }
73
306
  finish();
74
307
  })();
75
308
 
76
309
  return {
77
310
  finish,
78
311
  update(): void {
79
- if (done) return;
80
- const nextWidth = camera.right - camera.left;
81
- const nextHeight = camera.top - camera.bottom;
82
- if (nextWidth !== width || nextHeight !== height) layout();
83
- setProgress(host.startup.progress);
312
+ if (!done) updateProgress(host.startup.progress);
84
313
  },
85
314
  };
86
315
  }
@@ -1,7 +1,7 @@
1
1
  // Generated for you. Keep the six palette roles coherent when you repaint the arena.
2
2
  export const palette = {
3
3
  skyHigh: 0x263449,
4
- skyLow: 0x090d13,
4
+ skyLow: 0x101820,
5
5
  arena: 0x18232d,
6
6
  player: 0x64d8cb,
7
7
  hostile: 0xff6b7a,
@@ -1,19 +1,71 @@
1
- // Generated for you: ordinary Three.js postprocessing, owned by this game.
2
- import { ACESFilmicToneMapping, type Camera, type Scene } from "three";
3
- import { bloom } from "three/addons/tsl/display/BloomNode.js";
4
- import { pass } from "three/tsl";
1
+ // Generated for you. This is ordinary Three.js — edit or delete it freely.
2
+ // ThreeNative does not read this file.
3
+ //
4
+ // `WorldEnvironment`, in this folder, builds the lighting chain: which stages run, in what
5
+ // order, and an honest report of what happened. It prints `TN_WORLD_ENVIRONMENT` naming every
6
+ // stage as applied or refused **with a reason**, so a stage that silently no-op'd is never
7
+ // mistaken for one you turned off. It decides no colour and no strength — every value below is
8
+ // an argument, and they are yours.
9
+ //
10
+ // SSGI and SSR are the expensive pair, so they ship on for desktop and off for mobile. That
11
+ // split is the shipped default, not a ceiling: turn either on for mobile by adding it to
12
+ // `mobilePreset` and read the frame cost back out of `TN_FRAME_BUDGET`. What each stage costs,
13
+ // and the one-line enable for the ones that ship off everywhere (godrays, contact AO,
14
+ // vignette), is in `agent-docs/visual-baseline.md`.
15
+ import type { Camera, DirectionalLight, Scene } from "three";
16
+ import type { OutputRenderer } from "./worldEnvironment.js";
17
+ import { WorldEnvironment } from "./worldEnvironment.js";
5
18
 
6
- type OutputRenderer = {
7
- kind: string;
8
- raw: unknown;
9
- setOutputNode(node: unknown): void;
10
- };
19
+ // Scene-referred exposure: multiplied into the pass before the tone curve, so the gather, the
20
+ // reflections and the bloom threshold all see the same exposed image.
21
+ const exposure = 1.12;
11
22
 
12
- export function setupPost(renderer: OutputRenderer, scene: Scene, camera: Camera): void {
13
- const raw = renderer.raw as { toneMapping?: number; toneMappingExposure?: number };
14
- raw.toneMapping = ACESFilmicToneMapping;
15
- raw.toneMappingExposure = 1.12;
16
- if (renderer.kind !== "webgpu") return;
17
- const colour = pass(scene, camera).getTextureNode();
18
- renderer.setOutputNode(colour.add(bloom(colour, 0.75, 0.48, 0.2)));
23
+ // Unchanged from this template's previous chain — strength, radius and threshold are a look
24
+ // decision that was already tuned to this scene's palette.
25
+ const glow = {
26
+ bloomEnabled: true,
27
+ bloomRadius: 0.48,
28
+ bloomStrength: 0.75,
29
+ bloomThreshold: 0.2,
30
+ } as const;
31
+
32
+ const desktopPreset = {
33
+ ...glow,
34
+ denoiseEnabled: true,
35
+ exposure,
36
+ ssgiEnabled: true,
37
+ // Room scale, not contact scale: about two thirds of the 20-unit shadow extent
38
+ // `lighting.ts` lights — an interior arena, which is the case screen-space GI is best at.
39
+ ssgiRadius: 14,
40
+ ssgiQuality: "medium",
41
+ ssrEnabled: true,
42
+ // `SSRNode` defaults this to **1 world unit**, which on a scene this size reads as
43
+ // "reflections are on and do nothing" — the ray dies a metre from where it started.
44
+ ssrMaxDistance: 34,
45
+ // A reflection carries almost no high-frequency detail, so half resolution costs a quarter
46
+ // of the rays and is very hard to see in the result.
47
+ ssrResolutionScale: 0.5,
48
+ // RCAS puts back the micro-detail the half-resolution reflection and the denoiser take out.
49
+ // The same cause everywhere, so the same value everywhere: **0 is maximum sharpening and 2
50
+ // is none** — it is a radius, not a gain.
51
+ sharpenEnabled: true,
52
+ sharpenStrength: 0.3,
53
+ tonemapMode: "aces",
54
+ } as const;
55
+
56
+ // No SSGI, no SSR, and therefore nothing for the sharpener to put back.
57
+ const mobilePreset = {
58
+ ...glow,
59
+ exposure,
60
+ tonemapMode: "aces",
61
+ } as const;
62
+
63
+ export function setupPost(
64
+ renderer: OutputRenderer,
65
+ scene: Scene,
66
+ camera: Camera,
67
+ environment: { godraysLight?: DirectionalLight; mobile?: boolean } = {},
68
+ ): void {
69
+ const world = new WorldEnvironment(environment.mobile === true ? mobilePreset : desktopPreset);
70
+ world.apply(renderer, scene, camera, { godraysLight: environment.godraysLight });
19
71
  }
@@ -2,11 +2,19 @@
2
2
  import {
3
3
  BufferAttribute,
4
4
  BufferGeometry,
5
+ ClampToEdgeWrapping,
5
6
  CylinderGeometry,
7
+ DataTexture,
8
+ DoubleSide,
6
9
  Group,
7
10
  type Material,
8
11
  Mesh,
12
+ MeshBasicMaterial,
13
+ NearestFilter,
14
+ PlaneGeometry,
15
+ RGBAFormat,
9
16
  SphereGeometry,
17
+ UnsignedByteType,
10
18
  } from "three";
11
19
 
12
20
  import type { ReturnTypeOfMaterials } from "./types.js";
@@ -15,6 +23,158 @@ const roundedCache = new Map<string, BufferGeometry>();
15
23
 
16
24
  export type ShooterMaterials = ReturnTypeOfMaterials;
17
25
 
26
+ export const PICKUP_SPRITE_FRAMES = [
27
+ { x: 0, y: 0, width: 8, height: 8, duration: 0.07 },
28
+ { x: 8, y: 0, width: 12, height: 10, duration: 0.11 },
29
+ { x: 20, y: 2, width: 12, height: 8, duration: 0.15 },
30
+ ] as const;
31
+
32
+ const PICKUP_ATLAS_WIDTH = 32;
33
+ const PICKUP_ATLAS_HEIGHT = 16;
34
+
35
+ function setPixel(
36
+ data: Uint8Array,
37
+ width: number,
38
+ height: number,
39
+ x: number,
40
+ y: number,
41
+ colour: readonly [number, number, number, number],
42
+ ): void {
43
+ if (x < 0 || y < 0 || x >= width || y >= height) return;
44
+ const row = height - 1 - y;
45
+ const index = (row * width + x) * 4;
46
+ data[index] = colour[0];
47
+ data[index + 1] = colour[1];
48
+ data[index + 2] = colour[2];
49
+ data[index + 3] = colour[3];
50
+ }
51
+
52
+ function createPickupAtlas(): DataTexture {
53
+ const data = new Uint8Array(PICKUP_ATLAS_WIDTH * PICKUP_ATLAS_HEIGHT * 4);
54
+ for (let y = 0; y < PICKUP_ATLAS_HEIGHT; y += 1) {
55
+ for (let x = 0; x < PICKUP_ATLAS_WIDTH; x += 1) {
56
+ const frame = PICKUP_SPRITE_FRAMES.find(
57
+ ({ x: left, y: top, width, height }) =>
58
+ x >= left && x < left + width && y >= top && y < top + height,
59
+ );
60
+ if (frame === undefined) continue;
61
+ const localX = x - frame.x - (frame.width - 1) / 2;
62
+ const localY = y - frame.y - (frame.height - 1) / 2;
63
+ const radius = Math.min(frame.width, frame.height) * 0.42;
64
+ if (Math.hypot(localX, localY) > radius) continue;
65
+ const colour: readonly [number, number, number, number] = [
66
+ 100 + Math.round((frame.width / 12) * 100),
67
+ 225,
68
+ 255,
69
+ 255,
70
+ ];
71
+ setPixel(data, PICKUP_ATLAS_WIDTH, PICKUP_ATLAS_HEIGHT, x, y, colour);
72
+ }
73
+ }
74
+ const texture = new DataTexture(
75
+ data,
76
+ PICKUP_ATLAS_WIDTH,
77
+ PICKUP_ATLAS_HEIGHT,
78
+ RGBAFormat,
79
+ UnsignedByteType,
80
+ );
81
+ texture.magFilter = NearestFilter;
82
+ texture.minFilter = NearestFilter;
83
+ texture.wrapS = ClampToEdgeWrapping;
84
+ texture.wrapT = ClampToEdgeWrapping;
85
+ texture.needsUpdate = true;
86
+ return texture;
87
+ }
88
+
89
+ const NAMEPLATE_GLYPHS: Readonly<Record<string, readonly string[]>> = {
90
+ A: ["01110", "10001", "10001", "11111", "10001", "10001", "10001"],
91
+ E: ["11111", "10000", "10000", "11110", "10000", "10000", "11111"],
92
+ G: ["01110", "10001", "10000", "10111", "10001", "10001", "01110"],
93
+ R: ["11110", "10001", "10001", "11110", "10100", "10010", "10001"],
94
+ T: ["11111", "00100", "00100", "00100", "00100", "00100", "00100"],
95
+ };
96
+
97
+ const NAMEPLATE_WIDTH = 48;
98
+ const NAMEPLATE_HEIGHT = 12;
99
+ const NAMEPLATE_BACKGROUND: readonly [number, number, number, number] = [7, 18, 27, 240];
100
+ const NAMEPLATE_INK: readonly [number, number, number, number] = [138, 239, 255, 255];
101
+ const NAMEPLATE_BORDER: readonly [number, number, number, number] = [53, 128, 154, 255];
102
+
103
+ function fillNameplate(data: Uint8Array): void {
104
+ for (let y = 0; y < NAMEPLATE_HEIGHT; y += 1) {
105
+ for (let x = 0; x < NAMEPLATE_WIDTH; x += 1)
106
+ setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, x, y, NAMEPLATE_BACKGROUND);
107
+ }
108
+ }
109
+
110
+ function drawNameplateBorder(data: Uint8Array): void {
111
+ for (let x = 0; x < NAMEPLATE_WIDTH; x += 1) {
112
+ setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, x, 0, NAMEPLATE_BORDER);
113
+ setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, x, NAMEPLATE_HEIGHT - 1, NAMEPLATE_BORDER);
114
+ }
115
+ for (let y = 0; y < NAMEPLATE_HEIGHT; y += 1) {
116
+ setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, 0, y, NAMEPLATE_BORDER);
117
+ setPixel(data, NAMEPLATE_WIDTH, NAMEPLATE_HEIGHT, NAMEPLATE_WIDTH - 1, y, NAMEPLATE_BORDER);
118
+ }
119
+ }
120
+
121
+ function drawNameplateText(data: Uint8Array): void {
122
+ for (const [index, character] of [..."TARGET"].entries()) {
123
+ const glyph = NAMEPLATE_GLYPHS[character];
124
+ if (glyph === undefined) continue;
125
+ for (const [row, line] of glyph.entries()) {
126
+ for (const [column, lit] of [...line].entries()) {
127
+ if (lit === "1")
128
+ setPixel(
129
+ data,
130
+ NAMEPLATE_WIDTH,
131
+ NAMEPLATE_HEIGHT,
132
+ 6 + index * 7 + column,
133
+ 2 + row,
134
+ NAMEPLATE_INK,
135
+ );
136
+ }
137
+ }
138
+ }
139
+ }
140
+
141
+ function createNameplateTexture(): DataTexture {
142
+ const data = new Uint8Array(NAMEPLATE_WIDTH * NAMEPLATE_HEIGHT * 4);
143
+ fillNameplate(data);
144
+ drawNameplateBorder(data);
145
+ drawNameplateText(data);
146
+ const texture = new DataTexture(
147
+ data,
148
+ NAMEPLATE_WIDTH,
149
+ NAMEPLATE_HEIGHT,
150
+ RGBAFormat,
151
+ UnsignedByteType,
152
+ );
153
+ texture.magFilter = NearestFilter;
154
+ texture.minFilter = NearestFilter;
155
+ texture.wrapS = ClampToEdgeWrapping;
156
+ texture.wrapT = ClampToEdgeWrapping;
157
+ texture.needsUpdate = true;
158
+ return texture;
159
+ }
160
+
161
+ function createTargetNameplate(): Group {
162
+ const group = new Group();
163
+ group.name = "target-nameplate";
164
+ const mesh = new Mesh(
165
+ new PlaneGeometry(2.4, 0.6),
166
+ new MeshBasicMaterial({
167
+ depthWrite: false,
168
+ map: createNameplateTexture(),
169
+ side: DoubleSide,
170
+ transparent: true,
171
+ }),
172
+ );
173
+ mesh.name = "target-nameplate-surface";
174
+ group.add(mesh);
175
+ return group;
176
+ }
177
+
18
178
  function compactBox(width: number, height: number, depth: number): BufferGeometry {
19
179
  const halfX = width / 2;
20
180
  const halfY = height / 2;
@@ -148,6 +308,9 @@ export function createPlayerVisual(materials: ShooterMaterials): Group {
148
308
  export function createTargetVisual(materials: ShooterMaterials): Group {
149
309
  const group = new Group();
150
310
  group.name = "target-visual";
311
+ // Keep a non-zero parent rotation in the stock scene so the nameplate demonstrates world-space
312
+ // billboarding instead of accidentally passing only in the unparented case.
313
+ group.rotation.y = 0.22;
151
314
  const body = block(1.2, 1.8, 1, materials.hostile);
152
315
  body.position.y = 0.9;
153
316
  group.add(body);
@@ -159,6 +322,9 @@ export function createTargetVisual(materials: ShooterMaterials): Group {
159
322
  crossbar.position.y = 0.9;
160
323
  crossbar.castShadow = true;
161
324
  group.add(crossbar);
325
+ const nameplate = createTargetNameplate();
326
+ nameplate.position.y = 2.1;
327
+ group.add(nameplate);
162
328
  return group;
163
329
  }
164
330
 
@@ -186,6 +352,18 @@ export function createPickupVisual(materials: ShooterMaterials): Group {
186
352
  orb.position.y = 0.45;
187
353
  orb.castShadow = true;
188
354
  group.add(orb);
355
+ const animated = new Mesh(
356
+ new PlaneGeometry(0.9, 0.9),
357
+ new MeshBasicMaterial({
358
+ depthWrite: false,
359
+ map: createPickupAtlas(),
360
+ side: DoubleSide,
361
+ transparent: true,
362
+ }),
363
+ );
364
+ animated.name = "pickup-animation";
365
+ animated.position.y = 0.7;
366
+ group.add(animated);
189
367
  return group;
190
368
  }
191
369