@opengamehq/cli 0.9.8 → 0.9.9

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 (349) hide show
  1. package/AGENTS.md +37 -17
  2. package/CHANGELOG.md +11 -0
  3. package/README.md +7 -6
  4. package/dist/cli.mjs +135 -135
  5. package/dist/opengame-global.js +3 -3
  6. package/dist/preflight-worker.mjs +10 -10
  7. package/dist/runtime-builder.mjs +1 -1
  8. package/dist/skills/manifest.json +1406 -142
  9. package/dist/skills/opengame-accessibility/SKILL.md +48 -32
  10. package/dist/skills/opengame-all-in-one/SKILL.md +195 -0
  11. package/dist/skills/opengame-all-in-one/references/opengame-accessibility/README.md +102 -0
  12. package/dist/skills/opengame-all-in-one/references/opengame-api/README.md +107 -0
  13. package/dist/skills/opengame-all-in-one/references/opengame-assets/README.md +168 -0
  14. package/dist/skills/opengame-all-in-one/references/opengame-assets/references/pipeline.md +164 -0
  15. package/dist/skills/opengame-all-in-one/references/opengame-audio/README.md +238 -0
  16. package/dist/skills/opengame-all-in-one/references/opengame-audio/helpers/audio-chain.js +325 -0
  17. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/mix-notes.md +125 -0
  18. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/qa-without-ears.md +177 -0
  19. package/dist/skills/opengame-all-in-one/references/opengame-capture/README.md +128 -0
  20. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/pipeline.md +114 -0
  21. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/threejs.md +161 -0
  22. package/dist/skills/opengame-all-in-one/references/opengame-characters/README.md +180 -0
  23. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/first-person-body.md +108 -0
  24. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/integration.md +144 -0
  25. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/player-og.md +160 -0
  26. package/dist/skills/opengame-all-in-one/references/opengame-cli/README.md +189 -0
  27. package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +223 -0
  28. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/json-events.md +63 -0
  29. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/manifest.md +89 -0
  30. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +119 -0
  31. package/dist/skills/opengame-all-in-one/references/opengame-depth/README.md +154 -0
  32. package/dist/skills/opengame-all-in-one/references/opengame-enemies/README.md +155 -0
  33. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/pacing-and-bots.md +108 -0
  34. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/threejs.md +193 -0
  35. package/dist/skills/opengame-all-in-one/references/opengame-front-end/README.md +185 -0
  36. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/launch.md +50 -0
  37. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/menus.md +81 -0
  38. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/README.md +181 -0
  39. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/helpers/spring.js +146 -0
  40. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/feel-numbers.md +142 -0
  41. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/killcam.md +88 -0
  42. package/dist/skills/opengame-all-in-one/references/opengame-jam/README.md +114 -0
  43. package/dist/skills/opengame-all-in-one/references/opengame-lighting/README.md +141 -0
  44. package/dist/skills/opengame-all-in-one/references/opengame-lighting/helpers/light-pool.js +185 -0
  45. package/dist/skills/opengame-all-in-one/references/opengame-loading/README.md +135 -0
  46. package/dist/skills/opengame-all-in-one/references/opengame-loading/helpers/loading-count.mjs +115 -0
  47. package/dist/skills/opengame-all-in-one/references/opengame-loading/references/threejs.md +141 -0
  48. package/dist/skills/opengame-all-in-one/references/opengame-look/README.md +181 -0
  49. package/dist/skills/opengame-all-in-one/references/opengame-look/references/matching-a-reference.md +73 -0
  50. package/dist/skills/opengame-all-in-one/references/opengame-look/references/painterly.md +69 -0
  51. package/dist/skills/opengame-all-in-one/references/opengame-look/references/post-and-lens.md +73 -0
  52. package/dist/skills/opengame-all-in-one/references/opengame-maps/README.md +74 -0
  53. package/dist/skills/opengame-all-in-one/references/opengame-maps/references/map-spec.md +77 -0
  54. package/dist/skills/opengame-all-in-one/references/opengame-mobile/README.md +86 -0
  55. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/README.md +183 -0
  56. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/briefs.md +293 -0
  57. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/day-one-questions.md +46 -0
  58. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/edge-cases.md +27 -0
  59. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/filmable.md +244 -0
  60. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/finishing.md +126 -0
  61. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/measure.md +282 -0
  62. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-capture.md +151 -0
  63. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-gates.md +84 -0
  64. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-genres.md +198 -0
  65. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-grammar.md +320 -0
  66. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-ops.md +127 -0
  67. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/og-snipers-record.md +110 -0
  68. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/owner-eye.md +214 -0
  69. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/reference-study.md +293 -0
  70. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/song.md +64 -0
  71. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/README.md +193 -0
  72. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/briefs.md +293 -0
  73. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/day-one-questions.md +46 -0
  74. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/filmable.md +244 -0
  75. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/measure.md +282 -0
  76. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-capture.md +151 -0
  77. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-gates.md +84 -0
  78. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-genres.md +198 -0
  79. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-grammar.md +320 -0
  80. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-ops.md +127 -0
  81. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/og-snipers-record.md +110 -0
  82. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/owner-eye.md +214 -0
  83. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/reference-study.md +293 -0
  84. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/song.md +64 -0
  85. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/README.md +174 -0
  86. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/briefs.md +293 -0
  87. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  88. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/filmable.md +244 -0
  89. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/finishing.md +126 -0
  90. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/measure.md +282 -0
  91. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  92. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  93. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  94. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  95. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  96. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  97. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  98. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  99. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/song.md +64 -0
  100. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/README.md +139 -0
  101. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/bot-lobbies.md +71 -0
  102. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/netcode.md +165 -0
  103. package/dist/skills/opengame-all-in-one/references/opengame-performance/README.md +177 -0
  104. package/dist/skills/opengame-all-in-one/references/opengame-performance/helpers/landing-pacer.mjs +86 -0
  105. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/measuring.md +123 -0
  106. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/webgpu.md +86 -0
  107. package/dist/skills/opengame-all-in-one/references/opengame-production/README.md +192 -0
  108. package/dist/skills/opengame-all-in-one/references/opengame-production/references/team.md +107 -0
  109. package/dist/skills/opengame-all-in-one/references/opengame-production/references/templates.md +153 -0
  110. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/README.md +170 -0
  111. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/cheap-tells.md +43 -0
  112. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/judges.md +95 -0
  113. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/review-prompt.md +32 -0
  114. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/README.md +134 -0
  115. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/charting.md +109 -0
  116. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/timing.md +92 -0
  117. package/dist/skills/opengame-all-in-one/references/opengame-router/README.md +54 -0
  118. package/dist/skills/opengame-all-in-one/references/opengame-router/references/process.md +38 -0
  119. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/README.md +136 -0
  120. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/helpers/scene-audit.js +677 -0
  121. package/dist/skills/opengame-all-in-one/references/opengame-sdk/README.md +283 -0
  122. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/engines.md +93 -0
  123. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/frame.md +107 -0
  124. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/identity.md +111 -0
  125. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/leaderboards.md +115 -0
  126. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/radio.md +71 -0
  127. package/dist/skills/opengame-all-in-one/references/opengame-stability/README.md +112 -0
  128. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/README.md +160 -0
  129. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/archetypes.md +113 -0
  130. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/briefs.md +273 -0
  131. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/core.md +129 -0
  132. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/craft.md +299 -0
  133. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/edge-cases.md +27 -0
  134. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/filmable.md +244 -0
  135. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/finishing.md +126 -0
  136. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/gates.md +184 -0
  137. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/measure.md +282 -0
  138. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/music.md +148 -0
  139. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/og-clash-record.md +133 -0
  140. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/ops.md +154 -0
  141. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/owner-eye.md +214 -0
  142. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/review.md +141 -0
  143. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/title.md +92 -0
  144. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/README.md +172 -0
  145. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/archetypes.md +113 -0
  146. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/briefs.md +273 -0
  147. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/core.md +129 -0
  148. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/craft.md +299 -0
  149. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/edge-cases.md +27 -0
  150. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/filmable.md +244 -0
  151. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/finishing.md +126 -0
  152. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/gates.md +184 -0
  153. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/measure.md +282 -0
  154. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/music.md +148 -0
  155. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/og-clash-record.md +133 -0
  156. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/ops.md +154 -0
  157. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/owner-eye.md +214 -0
  158. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/reference-set.md +92 -0
  159. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/review.md +141 -0
  160. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/title.md +92 -0
  161. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/README.md +141 -0
  162. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  163. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  164. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/core.md +129 -0
  165. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/craft.md +299 -0
  166. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  167. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  168. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  169. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/gates.md +184 -0
  170. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/measure.md +282 -0
  171. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/music.md +148 -0
  172. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  173. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/ops.md +154 -0
  174. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  175. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/review.md +141 -0
  176. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/title.md +92 -0
  177. package/dist/skills/opengame-all-in-one/references/opengame-verification/README.md +197 -0
  178. package/dist/skills/opengame-all-in-one/references/opengame-verification/helpers/browser-evidence.mjs +74 -0
  179. package/dist/skills/opengame-all-in-one/references/opengame-weapons/README.md +179 -0
  180. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/handling-numbers.md +114 -0
  181. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/reloads-and-hands.md +96 -0
  182. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/sights-and-scopes.md +98 -0
  183. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/threejs.md +240 -0
  184. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/README.md +141 -0
  185. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/references/measured-failures.md +79 -0
  186. package/dist/skills/opengame-api/SKILL.md +32 -6
  187. package/dist/skills/opengame-assets/SKILL.md +79 -31
  188. package/dist/skills/opengame-assets/references/pipeline.md +67 -0
  189. package/dist/skills/opengame-audio/SKILL.md +129 -41
  190. package/dist/skills/opengame-audio/references/mix-notes.md +44 -1
  191. package/dist/skills/opengame-audio/references/qa-without-ears.md +177 -0
  192. package/dist/skills/opengame-capture/SKILL.md +44 -20
  193. package/dist/skills/opengame-capture/references/pipeline.md +33 -1
  194. package/dist/skills/opengame-capture/references/threejs.md +17 -1
  195. package/dist/skills/opengame-characters/SKILL.md +94 -39
  196. package/dist/skills/opengame-characters/references/first-person-body.md +108 -0
  197. package/dist/skills/opengame-characters/references/player-og.md +1 -1
  198. package/dist/skills/opengame-cli/SKILL.md +4 -4
  199. package/dist/skills/opengame-deploy/SKILL.md +35 -15
  200. package/dist/skills/opengame-deploy/references/json-events.md +6 -5
  201. package/dist/skills/opengame-deploy/references/packaging.md +28 -26
  202. package/dist/skills/opengame-depth/SKILL.md +61 -33
  203. package/dist/skills/opengame-enemies/SKILL.md +96 -40
  204. package/dist/skills/opengame-enemies/references/pacing-and-bots.md +108 -0
  205. package/dist/skills/opengame-enemies/references/threejs.md +59 -0
  206. package/dist/skills/opengame-front-end/SKILL.md +85 -39
  207. package/dist/skills/opengame-front-end/references/menus.md +42 -8
  208. package/dist/skills/opengame-game-feel/SKILL.md +95 -47
  209. package/dist/skills/opengame-game-feel/references/feel-numbers.md +59 -0
  210. package/dist/skills/opengame-game-feel/references/killcam.md +88 -0
  211. package/dist/skills/opengame-jam/SKILL.md +42 -27
  212. package/dist/skills/opengame-lighting/SKILL.md +85 -34
  213. package/dist/skills/opengame-loading/SKILL.md +78 -38
  214. package/dist/skills/opengame-loading/helpers/loading-count.mjs +115 -0
  215. package/dist/skills/opengame-loading/references/threejs.md +32 -7
  216. package/dist/skills/opengame-look/SKILL.md +122 -51
  217. package/dist/skills/opengame-look/references/matching-a-reference.md +73 -0
  218. package/dist/skills/opengame-look/references/painterly.md +69 -0
  219. package/dist/skills/opengame-look/references/post-and-lens.md +10 -3
  220. package/dist/skills/opengame-maps/SKILL.md +78 -0
  221. package/dist/skills/opengame-maps/references/map-spec.md +77 -0
  222. package/dist/skills/opengame-mobile/SKILL.md +18 -18
  223. package/dist/skills/opengame-montage-make/SKILL.md +187 -0
  224. package/dist/skills/opengame-montage-make/references/briefs.md +293 -0
  225. package/dist/skills/opengame-montage-make/references/day-one-questions.md +46 -0
  226. package/dist/skills/opengame-montage-make/references/edge-cases.md +27 -0
  227. package/dist/skills/opengame-montage-make/references/filmable.md +244 -0
  228. package/dist/skills/opengame-montage-make/references/finishing.md +126 -0
  229. package/dist/skills/opengame-montage-make/references/measure.md +282 -0
  230. package/dist/skills/opengame-montage-make/references/montage-capture.md +151 -0
  231. package/dist/skills/opengame-montage-make/references/montage-gates.md +84 -0
  232. package/dist/skills/opengame-montage-make/references/montage-genres.md +198 -0
  233. package/dist/skills/opengame-montage-make/references/montage-grammar.md +320 -0
  234. package/dist/skills/opengame-montage-make/references/montage-ops.md +127 -0
  235. package/dist/skills/opengame-montage-make/references/og-snipers-record.md +110 -0
  236. package/dist/skills/opengame-montage-make/references/owner-eye.md +214 -0
  237. package/dist/skills/opengame-montage-make/references/reference-study.md +293 -0
  238. package/dist/skills/opengame-montage-make/references/song.md +64 -0
  239. package/dist/skills/opengame-montage-plan/SKILL.md +197 -0
  240. package/dist/skills/opengame-montage-plan/references/briefs.md +293 -0
  241. package/dist/skills/opengame-montage-plan/references/day-one-questions.md +46 -0
  242. package/dist/skills/opengame-montage-plan/references/filmable.md +244 -0
  243. package/dist/skills/opengame-montage-plan/references/measure.md +282 -0
  244. package/dist/skills/opengame-montage-plan/references/montage-capture.md +151 -0
  245. package/dist/skills/opengame-montage-plan/references/montage-gates.md +84 -0
  246. package/dist/skills/opengame-montage-plan/references/montage-genres.md +198 -0
  247. package/dist/skills/opengame-montage-plan/references/montage-grammar.md +320 -0
  248. package/dist/skills/opengame-montage-plan/references/montage-ops.md +127 -0
  249. package/dist/skills/opengame-montage-plan/references/og-snipers-record.md +110 -0
  250. package/dist/skills/opengame-montage-plan/references/owner-eye.md +214 -0
  251. package/dist/skills/opengame-montage-plan/references/reference-study.md +293 -0
  252. package/dist/skills/opengame-montage-plan/references/song.md +64 -0
  253. package/dist/skills/opengame-montage-review-and-improve/SKILL.md +178 -0
  254. package/dist/skills/opengame-montage-review-and-improve/references/briefs.md +293 -0
  255. package/dist/skills/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  256. package/dist/skills/opengame-montage-review-and-improve/references/filmable.md +244 -0
  257. package/dist/skills/opengame-montage-review-and-improve/references/finishing.md +126 -0
  258. package/dist/skills/opengame-montage-review-and-improve/references/measure.md +282 -0
  259. package/dist/skills/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  260. package/dist/skills/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  261. package/dist/skills/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  262. package/dist/skills/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  263. package/dist/skills/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  264. package/dist/skills/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  265. package/dist/skills/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  266. package/dist/skills/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  267. package/dist/skills/opengame-montage-review-and-improve/references/song.md +64 -0
  268. package/dist/skills/opengame-multiplayer/SKILL.md +143 -0
  269. package/dist/skills/opengame-multiplayer/references/bot-lobbies.md +71 -0
  270. package/dist/skills/opengame-multiplayer/references/netcode.md +165 -0
  271. package/dist/skills/opengame-performance/SKILL.md +106 -65
  272. package/dist/skills/opengame-performance/helpers/landing-pacer.mjs +86 -0
  273. package/dist/skills/opengame-performance/references/measuring.md +51 -0
  274. package/dist/skills/opengame-performance/references/webgpu.md +86 -0
  275. package/dist/skills/opengame-production/SKILL.md +119 -54
  276. package/dist/skills/opengame-production/references/team.md +107 -0
  277. package/dist/skills/opengame-production/references/templates.md +106 -16
  278. package/dist/skills/opengame-quality-bar/SKILL.md +94 -42
  279. package/dist/skills/opengame-quality-bar/references/cheap-tells.md +14 -7
  280. package/dist/skills/opengame-quality-bar/references/judges.md +95 -0
  281. package/dist/skills/opengame-quality-bar/references/review-prompt.md +10 -5
  282. package/dist/skills/opengame-rhythm/SKILL.md +138 -0
  283. package/dist/skills/opengame-rhythm/references/charting.md +109 -0
  284. package/dist/skills/opengame-rhythm/references/timing.md +92 -0
  285. package/dist/skills/opengame-router/SKILL.md +10 -2
  286. package/dist/skills/opengame-scene-audit/SKILL.md +64 -47
  287. package/dist/skills/opengame-scene-audit/helpers/scene-audit.js +97 -19
  288. package/dist/skills/opengame-sdk/SKILL.md +26 -9
  289. package/dist/skills/opengame-sdk/references/engines.md +2 -2
  290. package/dist/skills/opengame-sdk/references/identity.md +10 -11
  291. package/dist/skills/opengame-stability/SKILL.md +59 -27
  292. package/dist/skills/opengame-trailer-make/SKILL.md +164 -0
  293. package/dist/skills/opengame-trailer-make/references/archetypes.md +113 -0
  294. package/dist/skills/opengame-trailer-make/references/briefs.md +273 -0
  295. package/dist/skills/opengame-trailer-make/references/core.md +129 -0
  296. package/dist/skills/opengame-trailer-make/references/craft.md +299 -0
  297. package/dist/skills/opengame-trailer-make/references/edge-cases.md +27 -0
  298. package/dist/skills/opengame-trailer-make/references/filmable.md +244 -0
  299. package/dist/skills/opengame-trailer-make/references/finishing.md +126 -0
  300. package/dist/skills/opengame-trailer-make/references/gates.md +184 -0
  301. package/dist/skills/opengame-trailer-make/references/measure.md +282 -0
  302. package/dist/skills/opengame-trailer-make/references/music.md +148 -0
  303. package/dist/skills/opengame-trailer-make/references/og-clash-record.md +133 -0
  304. package/dist/skills/opengame-trailer-make/references/ops.md +154 -0
  305. package/dist/skills/opengame-trailer-make/references/owner-eye.md +214 -0
  306. package/dist/skills/opengame-trailer-make/references/review.md +141 -0
  307. package/dist/skills/opengame-trailer-make/references/title.md +92 -0
  308. package/dist/skills/opengame-trailer-plan/SKILL.md +176 -0
  309. package/dist/skills/opengame-trailer-plan/references/archetypes.md +113 -0
  310. package/dist/skills/opengame-trailer-plan/references/briefs.md +273 -0
  311. package/dist/skills/opengame-trailer-plan/references/core.md +129 -0
  312. package/dist/skills/opengame-trailer-plan/references/craft.md +299 -0
  313. package/dist/skills/opengame-trailer-plan/references/edge-cases.md +27 -0
  314. package/dist/skills/opengame-trailer-plan/references/filmable.md +244 -0
  315. package/dist/skills/opengame-trailer-plan/references/finishing.md +126 -0
  316. package/dist/skills/opengame-trailer-plan/references/gates.md +184 -0
  317. package/dist/skills/opengame-trailer-plan/references/measure.md +282 -0
  318. package/dist/skills/opengame-trailer-plan/references/music.md +148 -0
  319. package/dist/skills/opengame-trailer-plan/references/og-clash-record.md +133 -0
  320. package/dist/skills/opengame-trailer-plan/references/ops.md +154 -0
  321. package/dist/skills/opengame-trailer-plan/references/owner-eye.md +214 -0
  322. package/dist/skills/opengame-trailer-plan/references/reference-set.md +92 -0
  323. package/dist/skills/opengame-trailer-plan/references/review.md +141 -0
  324. package/dist/skills/opengame-trailer-plan/references/title.md +92 -0
  325. package/dist/skills/opengame-trailer-review-and-improve/SKILL.md +145 -0
  326. package/dist/skills/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  327. package/dist/skills/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  328. package/dist/skills/opengame-trailer-review-and-improve/references/core.md +129 -0
  329. package/dist/skills/opengame-trailer-review-and-improve/references/craft.md +299 -0
  330. package/dist/skills/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  331. package/dist/skills/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  332. package/dist/skills/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  333. package/dist/skills/opengame-trailer-review-and-improve/references/gates.md +184 -0
  334. package/dist/skills/opengame-trailer-review-and-improve/references/measure.md +282 -0
  335. package/dist/skills/opengame-trailer-review-and-improve/references/music.md +148 -0
  336. package/dist/skills/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  337. package/dist/skills/opengame-trailer-review-and-improve/references/ops.md +154 -0
  338. package/dist/skills/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  339. package/dist/skills/opengame-trailer-review-and-improve/references/review.md +141 -0
  340. package/dist/skills/opengame-trailer-review-and-improve/references/title.md +92 -0
  341. package/dist/skills/opengame-verification/SKILL.md +113 -48
  342. package/dist/skills/opengame-weapons/SKILL.md +129 -55
  343. package/dist/skills/opengame-weapons/references/handling-numbers.md +42 -0
  344. package/dist/skills/opengame-weapons/references/reloads-and-hands.md +96 -0
  345. package/dist/skills/opengame-weapons/references/sights-and-scopes.md +98 -0
  346. package/dist/skills/opengame-weapons/references/threejs.md +71 -0
  347. package/dist/skills/opengame-world-physics/SKILL.md +55 -24
  348. package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
  349. package/package.json +1 -1
@@ -0,0 +1,114 @@
1
+ # Handling numbers from OC
2
+
3
+ Reference configurations from OC, a first-person wave shooter with a boss. Most were
4
+ taken from the CoD games it imitated, World at War and Black Ops above all. Use them as a
5
+ starting point for a game of the same kind, then tune with frame recordings.
6
+
7
+ ## Recoil springs per class
8
+
9
+ | Class | Frequency | Damping ratio |
10
+ |---|---|---|
11
+ | SMG | 8.2 Hz | 0.62 |
12
+ | Assault rifle | 6.6 Hz | 0.58 |
13
+ | LMG | 4.6 Hz | 0.50 |
14
+ | Sniper | 3.4 Hz | 0.46 |
15
+ | Shotgun | 4.0 Hz | 0.48 |
16
+ | Pistol | 9.5 Hz | 0.66 |
17
+
18
+ Aimed: frequency x1.25, damping to 1.0 (critically damped), pitch x0.15, push x0.32.
19
+ Caps: position z 0.070, y 0.026, x 0.020; rotation x 0.30, y 0.10, z 0.16 rad. Each gun
20
+ scales its class between 0.55x and 1.8x. The first three shots follow a fixed pattern,
21
+ as in BO6.
22
+
23
+ ## Spray
24
+
25
+ Rounds 1 to 3 go straight up. Rounds 4 to 10 follow the gun's own sway curve. From round
26
+ 11 the pattern goes flatter (0.67x) and wider (1.3x). Random noise went from 35% to 20%.
27
+ OC's notes record the first shot at 25% horizontal and a 65% per-gun wander after it.
28
+
29
+ ## Times
30
+
31
+ | Action | Time |
32
+ |---|---|
33
+ | Aim in, World at War | 0.245 s |
34
+ | Aim out, World at War | 0.25 s |
35
+ | Aim, pistol | 0.19 s |
36
+ | Aim, SMG | 0.21 to 0.28 s |
37
+ | Aim, assault rifle | 0.26 to 0.32 s |
38
+ | Aim, sniper | 0.34 to 0.46 s |
39
+ | Aim, LMG | 0.39 to 0.48 s |
40
+ | Swap raise and lower | 0.25 s |
41
+ | First draw from a machine | 0.8 s |
42
+ | Equip / holster / inspect | 0.35 s / 0.13 s / 3.0 s |
43
+ | Kick settles | 0.15 to 0.2 s inside a 330 ms cadence |
44
+
45
+ Aiming is a smoothstep, `3p^2 - 2p^3`, over exactly the gun's aim time, reversible
46
+ mid-raise. A flat 165 ms for every gun was the defect it replaced. Sprint pose blends in
47
+ at rate 7 and out at 14. Aimed kick is 30 to 40% of hip kick.
48
+
49
+ ## Damage and fire rate
50
+
51
+ - Real fire rates: MG42 1,200 rpm, a revolver 120 rpm.
52
+ - Hit zones: head 2.0, chest 1.0, arm 0.9, leg 0.85.
53
+ - Audit time to kill per gun at rounds 1, 10, 20 and 30. Upgraded automatics kill a
54
+ round-30 zombie in 0.65 to 1.0 s of headshots. One revolver had done 1,000 damage at
55
+ 625 rpm before the audit.
56
+
57
+ ## Shots
58
+
59
+ - Muzzle flash 0.045 s sprite with a 0.055 s point light, from the muzzle socket, never
60
+ the hand; two frames; a white-hot core, never an opaque cone.
61
+ - Shells eject from an ejection socket with gravity 11 and a 2.2 s life. On high fire
62
+ rates OC dropped a casing every 6th round and capped simultaneous fire sounds at 2.
63
+ - Tracer pool of 28, cores at least 3.2 px with a 12 px glow.
64
+
65
+ ## Assets
66
+
67
+ - Hero guns: about 24k triangles in first person (2048 base colour, 1024 metal and
68
+ roughness, 2048 normal) and about 10k in the world (512), with named moving parts,
69
+ `socket_*` empties and a manifest of pivots, reload travel and sight data.
70
+ - Wonder weapons: the same fidelity, 20 to 25k triangles, at or below the heaviest
71
+ loadout gun.
72
+ - AO baked into the packed material, cavity 0.2 to 0.4; normals at least 1024 px.
73
+
74
+ # Handling numbers from OS
75
+
76
+ OS is a first-person, snipers-only free-for-all with bots. Its owner's bar was the
77
+ quickscoping of the reference games; these numbers met it in the owner's hands.
78
+
79
+ - Aim: lens and hands share 220 ms in and 70 ms out, zoom on the press frame. The
80
+ quickscope bar was about 0.27 s where the reference data said 0.40 s, and no perk
81
+ speeds aiming up.
82
+ - A swap is usable in the middle of a bolt cycle. Cancels run on elapsed time "so 20 fps
83
+ and 144 fps decide a press the same way".
84
+ - Aim assist on pads only, fitted to the reference game's measured envelope rather than
85
+ a research table (strafe slip 3.9 to 0.1 degrees).
86
+ - A per-frame camera trace took recoil overshoot from 16% to 3%.
87
+ - Rounds pass anything thinner than 0.6 m at -25% damage per wall, at most 2 walls (1 for
88
+ bots) and two bodies; rock and terrain stop them. Bullets and bodies use separate
89
+ collision categories, and what can be seen through can be shot through.
90
+ - Hit markers fire only on scored damage, from one damage event that the HUD never
91
+ recomputes.
92
+ - Owner-locked: 7 to 10 rounds a magazine and infinite reserve; pickup by pressing, not
93
+ holding.
94
+ - Sniper-only rules: a quickscope is a kill within 0.35 s of full zoom; a no-scope means
95
+ no aiming in the last second; the multikill window is sized to the bolt cycle; scope
96
+ glint shows only after 250 ms scoped, within 20 degrees of the victim's view and beyond
97
+ 25 m, a counter to camping.
98
+
99
+ # Handling numbers from LC
100
+
101
+ LC is a body-camera survival shooter with 73 weapons, a camera on the player's chest and
102
+ weight-driven recoil.
103
+
104
+ - Recoil from the weapon's mass: kick = 0.5 x impulse / kg^0.72 x brace x (1 - steady).
105
+ View impulse per round: back 0.9 + 0.9 kick, pitch 5 + 9 kick, random roll 3 + 8 drift,
106
+ scaled 1 / (0.6 + 0.35 kg), and x(1 - 0.45) on the sights.
107
+ - Brass: the slide goes back in 13 ms and home in 54, the case leaves 7 ms after the
108
+ round and lands about 2 m right, with a sound per bounce. Brass is dull metal: three
109
+ bright cases read as "three fat white cylinders glowing in a dark hall".
110
+ - Movement: walk 3.1 m/s, sprint 6.3 (7.0 with a perk), winded 4.3, crouch 1.55;
111
+ acceleration 15 and deceleration 18 m/s^2; sights slow movement to 0.58x.
112
+ - Weapon data checked row by row against a published source: 26 rows corrected.
113
+ - Grenades and launchers were removed at the owner's word, with a test that fires every
114
+ gun and fails on any blast.
@@ -0,0 +1,96 @@
1
+ # Reloads and hands in the player's picture
2
+
3
+ How LC and OS staged reloads and kept hands on the gun, for "Each reload is climbed gun
4
+ by gun" and "Hands keep one size and one material" in `SKILL.md`. LC used a camera on
5
+ the player's chest; OS a conventional eye camera. Numbers are theirs; measure your own.
6
+
7
+ ## The ledger
8
+
9
+ One row per weapon, two reloads per row (empty and with rounds left), refitted versions
10
+ too. Seven points scored 0 to 10, pass at 9 on every one:
11
+
12
+ | Point | What it asks |
13
+ |---|---|
14
+ | Drill | The real sequence for this mechanism, in order, nothing skipped |
15
+ | Picture | The work is in frame, the weapon under a third of the picture, the work in its lower third |
16
+ | Hands | A hand is at work through the reload; each action begins and ends with a hand travelling |
17
+ | Wrists | Wrists, elbows and forearms inside the natural band (`opengame-characters`) |
18
+ | Motion | Nothing pops, teleports, slides on rails or whirls over the lens, at 60 fps |
19
+ | Parts | Moving parts are separate objects and really move |
20
+ | Light | The work is lit; gloves are never the brightest thing in frame |
21
+
22
+ Hard limits LC added: sleeve and glove together under a sixth of the picture; no finger
23
+ through metal deeper than 1.5 mm; wrist within 70 degrees bent and 30 to the side (a
24
+ simpler pair than the per-axis joint limits in `opengame-characters`, which also apply).
25
+ Each fault names the stream or file that owns it. Read the films at speed first, then at
26
+ a quarter speed. Calibrate the ledger against the owner: LC's owner accepted all eight
27
+ pistols while the tester had scored the M1911 6/7/5/7/4/5/5; the director's reading was that
28
+ the owner judges the whole act at speed in the player's own picture, not a fingertip at
29
+ one frame. When the owner
30
+ passes what the bar fails, move the bar.
31
+
32
+ ## Staging (LC)
33
+
34
+ - **Stance by the magazine well.** Place the weapon so the well sits in the picture, not
35
+ so the hand is comfortable.
36
+ - **Cant long arms toward the lens** and keep the cant through the stage: rolled 1.2 rad,
37
+ 12 cm out, 6 cm right, muzzle up 0.15 rad. A canted M16 took 7.7% of the picture;
38
+ upright it took 19 to 20%. Never swing a long gun through end-on: 12 end-on frames read
39
+ as the rifle flicked over the lens.
40
+ - **Nothing within 25 cm of the lens** while a long arm is staged for a reload, stricter
41
+ than the 9 to 16 cm floors that hold at rest (`SKILL.md`, the lens floor rule).
42
+ - **Hand paths are timed** round the weapon, 0.25 to 0.33 s, and any target jump over
43
+ 8 cm becomes a timed, eased travel (an M1897 hand had teleported 305 mm).
44
+ - **Hand parts over as the hand arrives, never by the clock.**
45
+ - **The magazine leaves empty and arrives full** through one carried part and a draw
46
+ range on its rounds, its mouth within about 40 degrees of the lens for 6 frames.
47
+ - **A rock when a magazine is torn out** and a kick when a bolt runs forward: 8 to 10 mm
48
+ and 4 degrees, doubled because 10 px of 1790 did not read.
49
+ - **Empty and tactical differ**: on an empty pistol the slide sits on its stop, is drawn
50
+ overhand, and is released 0.15 s after the rack event.
51
+ - **Every action begins and ends with a hand travelling**, about a third of a second in
52
+ and a third out, eased, so nothing appears or vanishes. This is what made the pistol
53
+ reload the one the owner accepted.
54
+ - **Light the work.** Reloads indoors went near-dark because the chest lamp lit the wall
55
+ above the hands: "a dark picture through a reload does not stand".
56
+ - **Check the mesh first.** A cocking handle fused into the receiver cost two leads
57
+ eleven placings; cut moving parts out by boolean (the magazine whole with its end
58
+ walls, handles whole) before animating any hand.
59
+
60
+ ## Contact audit (OS)
61
+
62
+ Rebuild logged frames from the real models offline and measure how far each glove
63
+ vertex sits inside the gun, past the glove's own idle penetration. OS flagged clips over
64
+ 6 mm. It found bolt handles rotating into the stock (fixed by a table of bolt-handle positions per rifle), a
65
+ reload path 16 cm under the rifle and a hand path through the optic; clipped game time fell from
66
+ about 24 s to 11 s. The test driver pulsed bolt presses every 0.6 s because the engine ignored
67
+ presses mid-rechamber.
68
+
69
+ - Sample every frame. Eight frames per bolt missed a black patch on the mitten through
70
+ 30% of the cycle on 7 rifles.
71
+ - Log the drawn glove scale every frame. One scale held: exactly 1.1 over 15,382 frames.
72
+ - Paint back faces one colour in a debug view to find exposed interiors.
73
+ - One material and one fill light for hands in every state: fists and armed gloves had
74
+ differed 5x in fill.
75
+
76
+ ## Finger solve (LC)
77
+
78
+ - Named skin patches (web, palm, heel, thenar) placed at millimetre positions on the
79
+ weapon's own vertices; a six-degree-of-freedom search per finger, each closed until
80
+ every bone bears; the thumb searched from 729 seeds; the support hand solved over the
81
+ firing hand's glove.
82
+ - Pass: nothing deeper than 1.5 mm, counted over every vertex. A bounding-volume inside
83
+ test was trusted only within 8 mm.
84
+ - Count on the game's own rig: the solver's 2.9 mm was 7.9 mm on the game's stretched
85
+ forearm.
86
+ - Fix a bent wrist by moving the elbow, not the hand (`opengame-characters`).
87
+
88
+ ## The glove itself (LC)
89
+
90
+ A photoreal style needed five-finger gloves. LC built them by script from a CC0 human
91
+ base: the glove as a design in fields measured from the bone frames, about 1,000
92
+ stitches as geometry sunk in a trough, a sleeve draped by a cloth solver at a 105 degree
93
+ elbow and un-skinned back to rest, a tight-elbow morph, five baked maps at 4096 and a
94
+ closed-hand fold map blended finger by finger. 14.1k triangles a glove, 12.7k a sleeve.
95
+ "Nothing regular": every repeat has a wobble on its phase. A stylised game can use a
96
+ thumb and a mitten instead (`opengame-characters`).
@@ -0,0 +1,98 @@
1
+ # Sights and scopes
2
+
3
+ How OS and LC met "Aiming goes through a real sight picture" and "Scope-in registers
4
+ from the press" in `SKILL.md`. OS is a snipers-only shooter on a wasm engine with
5
+ WebGPU; LC is a body-camera shooter in three.js WebGPU. Their numbers worked there;
6
+ measure your own.
7
+
8
+ ## One progress value
9
+
10
+ Field of view, weapon offset and look sensitivity all read one eased aim progress `p`
11
+ from 0 to 1. Separate curves read as the gun sliding "left to straight" while the view
12
+ zooms.
13
+
14
+ - Zoom starts on the press frame. OS: lens and hands share 220 ms in and 70 ms out.
15
+ - Ease the field of view in tan space, not in degrees, so the zoom rate looks even.
16
+ - Sensitivity follows the field of view: the look slows by the same ratio the picture
17
+ narrows. LC narrows 1.35x for long arms and 1.6x for pistols.
18
+ - Fire from the rendered view on the press, never from where the camera will be once
19
+ the ease finishes. OS's shots 100 to 200 ms into a scope-in had landed 2 to 2.7 degrees
20
+ below the crosshair.
21
+ - Release is at least as fast as the press, and reversal mid-raise starts from the current
22
+ `p`. The owner asked for aim-out as fast as aim-in; OS's 70 ms out is faster.
23
+
24
+ ## Two optic classes (OS)
25
+
26
+ - **Full-screen scopes** hide the view model at a fixed `p` (OS: 0.5) and draw the scope
27
+ image at the same radius the eyepiece had in the frame before the cut, so the aperture
28
+ does not jump (it had jumped over 2x; after, about 5%). The glass fills about 80% of
29
+ frame height (864 to 886 px at 1080p) and its markings draw even with the HUD hidden.
30
+ - **See-through optics** keep the real optic in the frame and zoom the world by
31
+ `M = tan(play / 2) / tan(ads / 2)`, computed against the actual play lens (OS's
32
+ 3.71x became 4.00x once computed against the 66 degree lens rather than a nominal
33
+ one). Cut camo glow from the sight picture (14 of 283 frames to 0), keep the map
34
+ visible around the optic, and lock the reticle under recoil.
35
+
36
+ ## Tune and judge at the range of use
37
+
38
+ At 4 to 10x a surface 40 m away reads as 4 to 10 m away, so a scope is judged where it
39
+ is used. OS tuned each map's scope field of view to frame a standing target at that
40
+ map's signature range (53 to 236 m) and captured scoped frames at 100 to 300 m; its
41
+ judges had scored scope shots taken 4 to 23 m from a wall for about 40 builds.
42
+
43
+ ## What a scope must not cost
44
+
45
+ - A scope is a field-of-view change plus an overlay, never a second world render. OS:
46
+ about 0.4 ms against a no-ADS control.
47
+ - Hold the render scale and render targets fixed across the cut. A resolution change at
48
+ scope-in re-created 46 to 70 textures and 250 to 450 bind groups, seen only in a WebGPU
49
+ call trace after the CPU profile showed nothing; the owner saw "a weird frame".
50
+ - Cast long rangefinder rays only while zoomed, in growing spans (OS: 32, 128, 512 m).
51
+ A 1.2 km ray every frame had peaked at 123 ms; after, under 0.14 ms.
52
+
53
+ ## Magnified artefacts
54
+
55
+ A scope magnifies whatever the hip view hid.
56
+
57
+ - Clamp glass sharpening to its neighbourhood (OS: 4,492 spike pixels to 698).
58
+ - Use hard shadows while scoped: soft penumbra "only resolves under TAA, which the
59
+ scope's sway and narrow FOV prevent".
60
+ - Draw an open tube's back faces as a dark bore; they had caught the rim light (3,800
61
+ cyan pixels).
62
+ - Scope tubes need 48 or more radial segments to read round (OC).
63
+ - A 2 to 3 px red dot was unreadable, and a 0.8 mm glowing torus bloomed into a
64
+ seven-ring flower (OC): draw reticles in a shader.
65
+
66
+ ## The sight line (LC)
67
+
68
+ - Publish per weapon: rear sight point, front sight point, bore axis, eye relief.
69
+ - Lens position = rear sight - bore direction x relief. The body follows the eye; the
70
+ gun never moves to meet a fixed camera.
71
+ - Eye relief: handgun at real reach (43 cm), open sights 30 to 40 cm, apertures 6 to
72
+ 15 cm; 6 to 50 cm across LC's 73 weapons.
73
+ - The weapon comes square to the lens axis: rear sight within 1 mm of the axis, bore
74
+ within 4 cm at 10 m. Each clip's rear sight, front post and the round at 25 m lie
75
+ within 3 px of one line.
76
+ - Open sight notches (2.8 to 3.6 mm) and apertures (5 mm in an 11 mm ring) were cut by a
77
+ tool on packed meshes in seconds, after generated guns arrived with solid sights.
78
+ - Keep the firing hand out of the picture on long guns: 69 of 73 guns lined up within
79
+ 4 px while 56 still showed the firing hand at 10 to 19 cm.
80
+ - Check what stands beside the notch, not only above its floor: a finger-over-the-sight
81
+ check passed while the owner saw a finger cover the aim.
82
+ - LC focuses depth of field on the front post of open sights; the field of view narrows
83
+ 1.25 to 1.35x in its first version.
84
+
85
+ ## Bolts and the scope
86
+
87
+ Never make the player release aim to cycle a bolt, reload or fire again. OS kept the
88
+ rifle on the eye through the bolt at the owner's call ("u shouldnt force people to zoom
89
+ out to pull the bolt"); LC's realistic hold works the bolt with the rifle off the eye
90
+ and brings it back while aim is held. An agent had added a forced unscope "as in" the
91
+ reference games, from memory: the owner's feel beats canon recalled from memory.
92
+
93
+ ## Benches
94
+
95
+ - Real inputs at fixed delays after the press (0 to 250 ms) and fixed ranges (50 to
96
+ 200 m), counted per 12 shots. OS: 0 to 2 of 12 became 12 of 12 from 100 ms.
97
+ - A 120 fps strip of scope-in, fire, bolt and release, read frame by frame. A bench
98
+ proves registration, not feel; the owner's hands judge the feel.
@@ -0,0 +1,240 @@
1
+ # Weapons in three.js
2
+
3
+ The engine-agnostic rules are in `SKILL.md`. This file is how to meet them in three.js.
4
+ Numbers are OC's unless another game is named.
5
+
6
+ ## A separate view model scene and camera
7
+
8
+ Render the world, clear depth, then render the view model with its own camera. The view
9
+ model never clips into walls because the world's depth is gone when it draws, and its
10
+ lens does not follow the FOV slider.
11
+
12
+ ```js
13
+ const viewScene = new THREE.Scene()
14
+ const viewCamera = new THREE.PerspectiveCamera(75, aspect, 0.012, 10) // fixed FOV, tiny near
15
+ renderer.autoClear = false
16
+
17
+ function frame() {
18
+ renderer.clear()
19
+ renderer.render(worldScene, worldCamera) // world FOV from the slider, 65 to 110
20
+ renderer.clearDepth() // the view model ignores world depth
21
+ renderer.render(viewScene, viewCamera)
22
+ }
23
+ ```
24
+
25
+ - Copy the world camera's rotation into the view camera each frame, before sway and kick
26
+ are added to the gun, so shots still leave along the world camera's ray.
27
+ - On resize, update both cameras' `aspect` and call `updateProjectionMatrix()` on both.
28
+ Only the world camera's `fov` follows the settings slider.
29
+ - Aiming changes the view camera's FOV with the gun's own aim time (OC: 75 to 58.5
30
+ degrees), not the world FOV slider.
31
+ - Move the world camera's near plane out (DK used 0.15) once the view model has its own
32
+ near plane; it buys depth precision for the world.
33
+
34
+ ## Depth and post-processing
35
+
36
+ - Run depth-reading world passes (SSAO, depth of field, fog, motion blur) on the world
37
+ scene only, then draw the view model. In `EffectComposer`, add a second `RenderPass`
38
+ for `viewScene` with `clear = false` and `clearDepth = true`, after the world's
39
+ depth-reading passes and before the output pass.
40
+ - Motion blur on the world with the gun sharp is OC's default. Keep the view model out
41
+ of any velocity buffer.
42
+ - Do not let the view model cast shadows into the world. A third-person world model of
43
+ the same gun casts them instead.
44
+ - Bloom runs after both, so clamp the view model's emissive (reticles, wonder glow)
45
+ before tonemapping. A 0.8 mm glowing torus bloomed into a seven-ring flower; draw
46
+ reticles in a shader instead.
47
+
48
+ ## Light and environment for the view model
49
+
50
+ The view model gets its own environment and a small rig so it never goes black in a
51
+ backlit world.
52
+
53
+ ```js
54
+ import { RoomEnvironment } from 'three/addons/environments/RoomEnvironment.js'
55
+ const pmrem = new THREE.PMREMGenerator(renderer)
56
+ viewScene.environment = pmrem.fromScene(new RoomEnvironment(), 0.04).texture
57
+ viewScene.add(new THREE.HemisphereLight(0xdfe8ff, 0x302820, 0.6))
58
+ ```
59
+
60
+ OC's studio environment gave 41% of the gun's mean brightness, and the two directional
61
+ lights about 3 luma. Clone materials per held gun (`material.clone()`) so a menu preview
62
+ or a camo swap never changes a shared material.
63
+
64
+ ## Coverage masks for view model size
65
+
66
+ Render the view model alone to a small target with a flat override material and count
67
+ the lit pixels. Run it per gun at hip, aimed, sprinting and drawing, at 1280 x 720,
68
+ 1920 x 1080 and 844 x 390.
69
+
70
+ ```js
71
+ const target = new THREE.WebGLRenderTarget(w, h)
72
+ const flat = new THREE.MeshBasicMaterial({ color: 0xffffff })
73
+ viewScene.overrideMaterial = flat
74
+ renderer.setRenderTarget(target)
75
+ renderer.setClearColor(0x000000, 1)
76
+ renderer.clear()
77
+ renderer.render(viewScene, viewCamera)
78
+ renderer.setRenderTarget(null)
79
+ viewScene.overrideMaterial = null
80
+ const pixels = new Uint8Array(w * h * 4)
81
+ renderer.readRenderTargetPixels(target, 0, 0, w, h, pixels)
82
+ let lit = 0
83
+ for (let i = 0; i < pixels.length; i += 4) if (pixels[i] > 127) lit++
84
+ const share = lit / (w * h) // OC hip: pistol ~0.06, SMG ~0.08, rifle ~0.09
85
+ ```
86
+
87
+ The same mask with a central 20% x 20% box gives the aimed-view occlusion share (OC's
88
+ glove case went from 35.29% to 0.04%).
89
+
90
+ ## Aim and sights
91
+
92
+ - Compute the aimed offset from the sight mesh, not a socket: take
93
+ `sight.getWorldPosition(v)`, bring it into the view camera's space, and move the gun so
94
+ that point lands on the camera's axis. OC's socket was 343 mm off the ring, 31 px.
95
+ - Build the gun's aim from yaw and pitch (an `Euler` in `'YXZ'` order) or `lookAt` with a
96
+ fixed up vector. `Quaternion.setFromUnitVectors` takes the shortest arc and added 25 to
97
+ 30 degrees of roll.
98
+ - Ray-test each optic in CI: cast rays from the eye point through the lens area with a
99
+ `Raycaster` against the gun's own meshes; any hit on a "transparent" lens is a defect
100
+ (4 OC rifles blocked 385 of 385 rays).
101
+ - Draw the reticle in a fragment shader on the lens, visible only from the eye side,
102
+ over dark tinted glass with a fresnel edge. Exclude housings from camo materials.
103
+ - Scope tubes need 48 or more radial segments to read round when aimed.
104
+
105
+ ## Load hero models before they can be equipped
106
+
107
+ A gun is equippable only after its full model has loaded and its shaders have compiled.
108
+ Until then the previous gun stays in hand, and a purchase is refused with a message.
109
+
110
+ ```js
111
+ const cache = new Map() // url -> Promise<THREE.Object3D>
112
+ function loadGun(url) {
113
+ if (!cache.has(url)) cache.set(url, (async () => {
114
+ const gltf = await gltfLoader.loadAsync(url)
115
+ const gun = gltf.scene
116
+ gun.traverse(o => { if (o.isMesh) o.material = o.material.clone() })
117
+ await renderer.compileAsync(gun, viewCamera, viewScene)
118
+ return gun
119
+ })())
120
+ return cache.get(url)
121
+ }
122
+
123
+ async function equip(url) {
124
+ const next = await loadGun(url) // the old gun stays in hand while this resolves
125
+ holster(current)
126
+ draw(next)
127
+ current = next
128
+ }
129
+ ```
130
+
131
+ - Preload the guns the player can reach next: the loadout, the box pool, wall buys near
132
+ the player, menu neighbours. OC prewarmed its visible roster of 8 guns, about 28 MB.
133
+ - Gate the buy prompt on `cache.get(url)` having resolved, so a wall gun never charges
134
+ points for a model that is not there.
135
+ - Use KTX2 textures (`KTX2Loader`) and meshopt geometry (`MeshoptDecoder`) for hero guns,
136
+ and upload textures early with `renderer.initTexture(texture)` so the first draw does
137
+ not hitch.
138
+ - Never load a low level of detail as a placeholder. If nothing is resident, show a UI
139
+ loading state.
140
+
141
+ ## Reload beats in one table
142
+
143
+ ```js
144
+ // Exported from the beat spec; animation and audio both read it.
145
+ const reloadRay = [
146
+ { t: 0.00, beat: 'latch', sound: 'ray_latch' },
147
+ { t: 0.28, beat: 'chamber_open', sound: 'ray_open' },
148
+ { t: 0.62, beat: 'cells_out', sound: 'ray_cells_out' },
149
+ // one row per fresh cell in, then snap shut and flicker on
150
+ ]
151
+ ```
152
+
153
+ Drive an `AnimationAction` and schedule each sound from the same row, with
154
+ `AudioContext.currentTime` plus the row's offset from the action's start. The times
155
+ above are an illustration of the format, not OC's values.
156
+
157
+ ## Hand contact check
158
+
159
+ Offline, for each gun and reload phase, pose the arms with `AnimationMixer.setTime`,
160
+ read each hand vertex with `SkinnedMesh.getVertexPosition(i, v)` and transform it to
161
+ world space, then measure how far it sits inside the gun's mesh (a signed distance from
162
+ a BVH such as `three-mesh-bvh`). Flag every phase deeper than 8 mm.
163
+
164
+ LC's finger solver passes at 1.5 mm and counts every vertex; every second vertex missed a
165
+ thumb 1.7 mm into a hammer. Measure on the game's own skinned mesh, not the solver's
166
+ copy of the rig. The method is in [reloads-and-hands.md](reloads-and-hands.md).
167
+
168
+ ## Lens floor test
169
+
170
+ Run it headless on the real view code, every frame of a stepped run through every state
171
+ and every change between two. Floors and shares are LC's.
172
+
173
+ ```js
174
+ const v = new THREE.Vector3(), eye = new THREE.Vector3()
175
+ function lensFrame(parts, camera, gridW = 120, gridH = 58) {
176
+ camera.getWorldPosition(eye)
177
+ const near = new Uint8Array(gridW * gridH) // cells covered by something under its floor
178
+ let closest = Infinity
179
+ for (const { mesh, floor } of parts) { // floor: weapon 0.12, glove and sleeve 0.09
180
+ const pos = mesh.geometry.attributes.position
181
+ for (let i = 0; i < pos.count; i++) {
182
+ if (mesh.isSkinnedMesh) mesh.getVertexPosition(i, v); else v.fromBufferAttribute(pos, i)
183
+ v.applyMatrix4(mesh.matrixWorld)
184
+ const d = v.distanceTo(eye)
185
+ closest = Math.min(closest, d - floor)
186
+ v.project(camera) // to normalised device coordinates
187
+ if (d >= floor || Math.abs(v.x) > 1 || Math.abs(v.y) > 1 || Math.abs(v.z) > 1) continue // off screen or behind the lens
188
+ const gx = Math.floor((v.x + 1) / 2 * gridW), gy = Math.floor((1 - v.y) / 2 * gridH)
189
+ near[Math.min(gy, gridH - 1) * gridW + Math.min(gx, gridW - 1)] = 1
190
+ }
191
+ }
192
+ const cover = near.reduce((a, b) => a + b, 0) / near.length
193
+ return { closest, cover } // LC fails cover over 1/6 for more than three frames
194
+ }
195
+ ```
196
+
197
+ While aimed, skip the sight's own parts: the weapon's eye relief (6 to 15 cm for LC's
198
+ apertures) places them, and the floors govern everything else.
199
+
200
+ Vertices undersample large triangles, so subdivide the grid test or rasterise a mask
201
+ (the coverage mask above) when a part has few vertices. Run it with the camera aspect set
202
+ to the widest window the players use: a hold tuned at 16:9 lost its hands off the bottom
203
+ of a wider window.
204
+
205
+ ## Camera-attached objects in the same frame
206
+
207
+ Update the camera first, then pose the view model and everything attached to the camera
208
+ from its new matrix, then render. A scope canopy or a held device posed before the
209
+ camera moved draws a frame late and slides under fast mouse look (OS: 31 cm and 150 to
210
+ 480 mm, both to 0).
211
+
212
+ ```js
213
+ updateLook(input) // camera rotation from this frame's input
214
+ camera.updateMatrixWorld()
215
+ poseViewModel(camera.matrixWorld) // gun, hands, scope canopy, held screens
216
+ renderFrame()
217
+ ```
218
+
219
+ With temporal anti-aliasing or motion blur on WebGPU (three.js `TRAANode` reading a
220
+ velocity output, in recent releases; check the names in yours), give the view model a
221
+ velocity from the view camera's own current and previous matrices. Writing zero at hip
222
+ let the resolve smear world pixels at the gun's silhouette into a dotted halo (OS); zero
223
+ is right only inside an aimed see-through optic. Keep the view model out of motion blur.
224
+
225
+ ## Empty magazines as a draw range
226
+
227
+ Order a magazine's index buffer with the rounds last, one block per round, and draw fewer
228
+ rounds as it empties. One carried part then leaves empty and arrives full, with no swap.
229
+
230
+ ```js
231
+ const body = mag.userData.bodyIndexCount, perRound = mag.userData.indicesPerRound
232
+ mag.geometry.setDrawRange(0, body + roundsLeft * perRound)
233
+ ```
234
+
235
+ ## Other engines
236
+
237
+ - Unity (URP): a base camera for the world and an overlay camera in its camera stack for
238
+ a weapon layer, with the overlay set to clear depth.
239
+ - Godot: render the weapon in a `SubViewport` with its own `Camera3D` and composite it
240
+ over the main view, or give the weapon its own visual layer and a second camera.