@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
@@ -1,109 +1,183 @@
1
1
  ---
2
2
  name: opengame-weapons
3
- description: Build first-person weapons and view models that hold up next to a shipped shooter. Covers iconic guns built from the real reference, view model size per gun class, beat-by-beat reloads with exported timings, hands that touch and never clip, no low-poly stand-ins, aiming through the real sight, kill reactions per weapon, camos and upgrades, wonder weapons and mystery-box odds. Use when the person says the gun looks like a toy or is too big, reloads look fake, hands clip, or add a weapon or box.
3
+ description: Build first-person weapons and view models that hold up next to a shipped shooter. Covers guns built from a reference, size and lens distance, one whole weapon in every view, a still gun, scope-in from the press, a real sight picture, reloads climbed gun by gun, hands that keep one size and never clip, hit zones, camos, upgrades and box odds. Use when the gun looks like a toy, shakes or clips, reloads look fake, scoping feels slow, hits do not kill, or add a weapon.
4
4
  metadata:
5
- version: "1.0.0"
5
+ version: "1.1.0"
6
6
  ---
7
7
 
8
8
  # Weapons
9
9
 
10
10
  In a first-person shooter the gun is on screen for the whole game, so every flaw in it
11
11
  is seen thousands of times. OC's owner raised gun fidelity about 30 times, its wonder
12
- weapon about 22 times and hands about 15 times. Four habits cost most of those rounds.
13
- Agents built a famous gun from an icon, fixed one gun when sixty had the defect, checked
14
- size by eye, and showed a cheap model while the real one loaded.
12
+ weapon about 22 times and hands about 15 times. OS's owner asked about hands 14 times
13
+ and scoping about 11. LC's owner wrote about the body, hands, holds and reloads about 19
14
+ times, and at the end 0 of 73 reloads passed the team's own bar. Five habits cost most of
15
+ those rounds. Agents built a known gun from an icon, fixed one gun when sixty had the
16
+ defect, checked size by eye, showed a cheap or empty hand while the real model loaded,
17
+ and judged motion from stills instead of at speed in the player's own picture.
15
18
 
16
19
  Rules carry five tags; `opengame-quality-bar` explains them and the game codes. The
17
20
  three.js view model pass, depth handling, coverage masks and model loading are in
18
- [references/threejs.md](references/threejs.md). Recoil springs, shake and hit feedback are
19
- in `opengame-game-feel`; hands and arms are in `opengame-characters`.
21
+ [references/threejs.md](references/threejs.md); scopes and sight pictures are in
22
+ [references/sights-and-scopes.md](references/sights-and-scopes.md); reload staging and
23
+ hand contact are in [references/reloads-and-hands.md](references/reloads-and-hands.md).
24
+ Recoil springs, shake, hit feedback and how much a held gun may move are in
25
+ `opengame-game-feel`; bodies, arms and joint limits are in `opengame-characters`.
20
26
 
21
27
  **One defect is a defect in the whole class.** When the owner flags one gun, sight, camo
22
28
  or pickup, sweep every gun on every path before reporting it fixed. The rule and OC's
23
29
  numbers are in `opengame-quality-bar`.
24
30
 
31
+ **An approved look is frozen.** A scope, camo or hand look the owner has approved is the
32
+ target no later pass may make worse, and a regression is fixed by restoring it exactly
33
+ first ("Approved quality is frozen" in `opengame-quality-bar`). OS's approved scope was
34
+ broken twice by "parity" passes until an exact revert ("it used to be perfect this scope").
35
+
25
36
  ## Rules
26
37
 
27
- ### Famous weapons are built from the real reference
28
- - **Invariant:** A weapon the genre has made iconic matches the original's proportions and silhouette from the side, top and back, as seen from the camera players know it from, before anyone works on surface detail; it is built from the original, not from an icon, a texture sheet or memory, and the reference files stay out of the build.
29
- - **Technique:** Get the original model or clear footage first. Extract its proportions, render it beside the candidate under one camera, and score the silhouette overlap from side, top and back. Write a materials list and a reload beat list from the reference, and recover its handling data (magazine, reload time, cadence, projectile speed, splash). Keep reference files outside the build folder, hash-check the shipped files against them, and ship original names.
30
- - **Reference configuration:** OC built its Ray Gun for about 14 builds from "a texture sheet and a 64-pixel icon, never the actual model", and the owner rejected all of them in one message ("ur not even fucking CLOSE"). It took about 30 builds over 3 days. Six owner images and measured proportions fixed it: side outline overlap 0.947 to 0.954 against a bar of 0.95, first-person framing from directly behind as in the original, and triangles held at or below the heaviest loadout gun (24.9k; the first attempt was 47k). The reference data was a 20-round magazine, a 3 s reload empty or partial, a 330 ms cadence, 81.28 m/s base and 106.68 m/s upgraded, and a 1.6256 m splash. The materials list was worn maroon enamel, chipped edges, brass patina, visible cells, a gauge with a needle, rivets, a decal and grime. A hash check found 0 of 44 private reference files among 12,987 shipped, while trademarked names were still in the build at the launch audit. An agent's own note: "more surface detail alone won't address your criticism".
31
- - **Applies when:** Any weapon, vehicle or prop the audience already knows from another game or film.
32
- - **Verify:** Each round, a sheet of reference and build side by side from the same side, top, back and first-person cameras, with the overlap score for each view.
38
+ ### Known weapons are built from their reference
39
+ - **Invariant:** A real firearm, vehicle or prop, or an item from the creator's own spec, matches its reference's proportions and silhouette from the side, top and back, as seen from the camera players know it from, before anyone works on surface detail; it is built from the reference, not from an icon, a texture sheet or memory, and the reference files stay out of the build. An item another studio designed is never recreated: its reference sets only the reads players expect (size class, silhouette type, how it handles), and the design, name and files are original.
40
+ - **Technique:** Get published dimensions, the creator's own model or clear photographs first. Render it beside the candidate under one camera and score the silhouette overlap from side, top and back; treat that score as a floor for the outline only, and check eyepieces, lenses and small parts on a side-by-side render, because an outline score passes them blind. Write a materials list and a reload beat list from the reference, and recover its handling data (magazine, reload time, cadence, projectile speed, splash). Keep reference files outside the build folder, hash-check the shipped files against them, ship original names, and strip maker names and markings from textures as well as file names.
41
+ - **Reference configuration:** OC built its signature wonder weapon for about 14 builds from "a texture sheet and a 64-pixel icon, never the actual model", and the owner rejected all of them in one message ("ur not even fucking CLOSE"). It took about 30 builds over 3 days. Six owner images and measured proportions fixed it: side outline overlap 0.947 to 0.954 against a bar of 0.95, first-person framing from directly behind, and triangles held at or below the heaviest loadout gun (24.9k; the first attempt was 47k). A written materials list (worn enamel, chipped edges, brass patina, a gauge with a needle, rivets, a decal, grime) and handling data (magazine, reload time, cadence, projectile speed, splash) came before the next build. A hash check found 0 of 44 private reference files among 12,987 shipped, while trademarked names were still in the build at the launch audit. OS built about 20 rifles from published dimensions behind an overlap gate (side 0.92, top 0.88); all 23 runs passed while judges named thick eyepieces and flat lenses; its owner judged against the reference the owner had named, not photographs of the real rifle, and the owner's taste beat reference fidelity where the two differed (a level hip pose over the source's odd one); seven rifles still shipped maker names and were rebaked. An agent's own note: "more surface detail alone won't address your criticism".
42
+ - **Applies when:** Any weapon, vehicle or prop built to a reference the audience knows, a real object or the creator's own spec. Ship original names, designs and markings, never another studio's model, design, names or textures.
43
+ - **Verify:** Each round, a sheet of reference and build side by side from the same side, top, back and first-person cameras, with the overlap score for each view and a line on each small part.
44
+
45
+ ### Generated meshes are for large forms; held weapons come from a source that can be photoreal
46
+ - **Invariant:** Small exact parts (sights, screws, levers, knurling, ejection ports) are modelled by script, parametrically or from licensed artist models, and no weapon enters the game before a studio render beside its reference: a photograph of the real thing, or the reference model or concept for an invented one.
47
+ - **Technique:** Search licensed artist models (CC0, or CC BY with a credit) before generating a held weapon. Generate only large forms, from side pictures you have looked at before paying for the mesh, with magazines and moving parts made separately. Grade generated materials before use: metalness only where steel is worn bare, roughness kept in a real band, normals softened. Check the mesh on a millimetre grid, cut moving parts out as whole objects, and refuse an install whose ambient occlusion bake is near black. Judge at the views the camera actually sees, then on the owner's path. Spend only with the person's own account and their yes on the cost (`opengame-assets`).
48
+ - **Reference configuration:** LC paid about $1.05 a generated weapon ($0.18 for side pictures, $0.70 for the mesh), $96.68 for 72, and 0 of 73 were graded photoreal. An M1911 rebuilt from five generated parts cost $6.60 and three hours and still "smears levers, knurling and screws ... its maps are painted light, not material". Defects included mirrored pictures, fused rounds, flat chambers, no ejection port and cocking handles cut into fixed bodies on 18 weapons; licensed artists' models were "crisp where the generated mesh was soft". Blued steel read right at metalness 0.2 to 0.5 and roughness 0.45 to 0.7, and generated maps were graded to roughness 0.55 to 0.67 with normals at half strength. OS refused installs with AO under 40 of 255 after one bake averaged 0.6 ("The renders still looked right only because the flat paint colours land on the correct faces"), and bevels over 4 mm folded into "a hollow black channel".
49
+ - **Applies when:** Weapons, vehicles, machines and any hard-surface object seen at arm's length.
50
+ - **Verify:** A studio, reference and in-game sheet per weapon with a line-by-line verdict.
33
51
 
34
52
  ### View model size is measured per class, in every pose, on several screens
35
- - **Invariant:** Every gun of a class covers about the same share of the screen at hip, aimed, sprinting and drawing, on wide, standard and phone screens, checked against a frame from the genre's reference game; the gun is always in hand and clear of the HUD.
36
- - **Technique:** Render the weapon layer alone to a mask and count its pixels in each pose at each screen size. Keep a table of target shares per class. Change one shared scale, then rerun every gun. Also check the resting angle, the muzzle position and near-plane cuts on long rifles at phone aspect.
37
- - **Reference configuration:** OC hip targets, as a share of a 1280 x 720 frame: pistol about 6%, SMG about 8%, rifle about 9%, LMG about 9.5%, wonder pistol 7 to 9%. The Ray Gun shipped at about 40% and went to 5 to 7% in a hotfix. One fix swung the hip guns from "very small" to "so fucking massive", and the size had been checked against CoD by one agent's eye. The owner rejected guns both as toys and as massive. Within a class OC holds the hip footprint within about 2x (rifles had spread 3.9x and went to 2.1x). Hip yaw above about 13 degrees reads as sideways (one gun sat at 21.5). Screens: 1280 x 720, 1920 x 1080 and 844 x 390. OC's guns are drawn at 1.5x life size against an arm of about 0.52 m, so a true shoulder weld was impossible; the lesson was to fix the scale on day one.
53
+ - **Invariant:** Every gun of a class covers about the same share of the screen at hip, aimed, sprinting and drawing, on wide, standard and phone screens, checked against a frame from the genre's reference game; every gun rests level at hip; the gun is always in hand and clear of the HUD.
54
+ - **Technique:** Render the weapon layer alone to a mask and count its pixels in each pose at each screen size. Keep a table of target shares per class. Fit hip placement once for the whole roster against annotated reference frames, with a fixed view model lens so the FOV slider does not resize the gun, and gate pitch and roll. Change one shared scale, then rerun every gun. Place holds near the bottom of the picture against the edge computed from the live aspect, because a fixed horizontal field of view crops the bottom of a wide window. Also check the muzzle position and near-plane cuts on long rifles at phone aspect.
55
+ - **Reference configuration:** OC hip targets, as a share of a 1280 x 720 frame: pistol about 6%, SMG about 8%, rifle about 9%, LMG about 9.5%, wonder pistol 7 to 9%. The wonder weapon shipped at about 40% and went to 5 to 7% in a hotfix. One fix swung the hip guns from "very small" to "so fucking massive", and the size had been checked against CoD by one agent's eye. Within a class OC holds the hip footprint within about 2x (rifles had spread 3.9x and went to 2.1x); hip yaw above about 13 degrees reads as sideways (one gun sat at 21.5). OC's guns are drawn at 1.5x life size against an arm of about 0.52 m, so a true shoulder weld was impossible; fix the scale on day one. OS fitted hip placement to 41 annotated reference stills under a fixed 68 degree view model lens, so FOV 65 to 120 moves the gun under 0.8%: 17 of 20 rifles within 3% of target, roll within 1.2 degrees against a 2 degree gate, and pitch from 6.5 to 14 degrees down to 1.8 to 2.2 after five notes in 24 h ("so many guns are tilted up... not just m40a3"). LC's pistol rests at 4.5 to 5% of the picture's width, 18 cm from the lens; a rest tuned at 1280 x 720 lost both hands off the bottom of the owner's 1790 x 860 window ("u cant even see ur hands now?").
38
56
  - **Applies when:** First-person games with held weapons or tools.
39
- - **Verify:** The coverage table for every gun in all four poses at all three sizes, with each gun inside its class band.
57
+ - **Verify:** The coverage table for every gun in all four poses at 1280 x 720, 1920 x 1080, 844 x 390 and the widest window the players use, each gun inside its class band, with pitch and roll per gun.
58
+
59
+ ### Nothing of the view model comes near the lens, on any frame
60
+ - **Invariant:** In every state and every change between two, no weapon, glove or sleeve comes nearer the camera than its floor, covers more than its share of the picture, or shows its inside, at every window shape the players use.
61
+ - **Technique:** In a headless test that steps the real view code, project every vertex of the arms, gloves and weapon into the player's picture each frame on a coarse grid and fail on distance and cover. When it fails, change the pose; never add a reactive push-away, which jolts and runs away. Give the view model its own depth floor (a near plane or a depth remap) under its closest part so a long gun never shows its inside. While aimed, the weapon's eye relief places the sight instead, and only the sight itself may come that close.
62
+ - **Reference configuration:** LC's floors are weapon 12 cm and glove and sleeve 9 cm (pistol 16), checked on a 120 x 58 grid of the owner's 1790 x 860, 100 degree picture. It fails when anything nearer than its floor covers over a sixth of the picture for more than three frames, a sleeve over a twelfth for six frames, or over a third outside a reload. It found a glove 2.1 cm from the glass at a steep look and a one-handed crank pushing a glove through the lens. A reactive guard jolted 37 times and ran away 35 cm. LC's aimed apertures sit 6 to 15 cm from the eye under their own eye relief; the floors govern every other state. OC found 19 of 61 guns with mesh within 0.15 m of the eye, 9 of them through it. OS's view-model depth remap (an effective 1 cm near plane) with a 10.5 cm eyepiece floor showed no gun's inside on any frame over 20 rifles x 17 actions.
63
+ - **Applies when:** First-person games with visible arms or a held weapon.
64
+ - **Verify:** The per-frame test over every state at 30, 60 and 144 fps plus an injected long frame, and one film at the widest supported aspect.
65
+
66
+ ### A still player sees a still gun
67
+ - **Invariant:** The held weapon, its sights and screens, and anything attached to the camera are single-imaged and still when the player is still; under real mouse look at the player's refresh rate, camera-attached objects track the view exactly and the weapon moves only by its designed motion, never by a late frame or a smear.
68
+ - **Technique:** Give the view model its own depth band and write real motion vectors for it from the camera's own matrices; keep that band out of velocity dilation and motion blur, and zero its velocity only inside an aimed see-through optic. Pose camera-attached objects after the camera update, in the same pass as the hands. Test at the player's refresh rate with real flicks, never only in a scripted capture with no mouse look. How much the weapon may move on its own, and the designed motion added back, are in `opengame-game-feel`.
69
+ - **Reference configuration:** OS: "even when i dont move the guns barrel and attachments are just like shakign left and right?..." Zeroing the hip velocity stopped that and caused "a dotted sort of hazy outline around the gun", because the temporal upscaler's dilation spread zero onto world pixels at the silhouette. The final path took the ACOG still-hold frame diff from 110 to 4.45 at 120 Hz; 30 fps captures never showed it. A canopy lagged 31 cm and 8.6 degrees at 3 rad/s and a killstreak controller slipped 150 to 480 mm, both to 0 once posed in the hands' pass. A scripted check passed at 0.03 px and the owner reopened it ("killstreak devices still shake/shift a lot"), because the test had no mouse look. LC's muzzle travel standing went from 3 x 9 px to 0.5 x 1.6 at 720p once the rig took the camera's own motion.
70
+ - **Applies when:** First-person games, above all with temporal anti-aliasing, upscaling or motion blur.
71
+ - **Verify:** Still-hold clips at 120 to 144 Hz with a frame-to-frame muzzle diff under 0.5 px (OS's bar), 200% crops while strafing, and drawn-position traces under real flicks.
72
+
73
+ ### Exactly one whole weapon is visible, in every view
74
+ - **Invariant:** The player, bots, menus, killcams and drops always show exactly one complete weapon: never bare hands, floating parts, a mix of stand-in and hero parts, or a generic gun-shaped placeholder. Cards that show weapons appear as a group, and nobody pays for a weapon whose model is not ready.
75
+ - **Technique:** Keep the previous complete weapon in hand until the exact new one has loaded with its materials and its shaders are compiled. Preload the likely next weapons (the visible roster, the box pool, nearby wall buys, menu neighbours) and fetch textures with the model. When nothing is resident, hold the raise off frame or keep the screen dark rather than show a stand-in in front of the eye. A light version is allowed only as a complete copy of the same weapon with its own geometry and anchors, on cards and at distance, and never mixed with hero parts. Gate a purchase on the model being ready. Flag any frame with a whole-weapon miss or a detached part. Ship authored hero models with named parts and sockets (see `opengame-assets`); code-built guns do not pass.
76
+ - **Reference configuration:** OC: one lazy-load change put low-poly guns in 6 places, and a wall gun charged points while its model was missing ("never load any low poly versions of guns ANYWHERE in this game", "NOTHING low poly shows when spinning box"); OC prewarmed its visible roster of 8 guns, about 28 MB. OS's owner ruled on the other half: "we cant have a situatoinw here not all the gun models load..." and "u can see bots running around with no guns". "Guns never fail to show" became its first launch blocker; cards fade in together from light copies of the real rifles (10 to 25 s down to 0.1 to 0.24 s); the class rifle prefetches with the weapon table (13 s of empty gloves to the first spawn frame); the raise waits off frame up to 4 s; a per-frame part check caught a suppressor 0.025 m off its rifle, and a sweep found 0 misses in 5,939 frames. The rule changed because two owners ruled on two halves of it: OC's against a low-detail gun, OS's against an empty hand.
77
+ - **Applies when:** Any game that streams or swaps weapons the player sees, and bots holding them.
78
+ - **Verify:** Throttle the network and cold-boot a full bot lobby, then take every acquisition path and open every menu that shows a gun, stepping the recording at each swap: every frame shows one whole weapon, and the miss log is empty.
79
+
80
+ ### The first frame of a run shows the finished weapon, lit, in its hold
81
+ - **Invariant:** On every path into play (first visit, return, retry, any saved cheats or loadout, a purchase), the first frame shown has the chosen weapon finished, lit and in its rest hold, with no raise, upgrade reveal or perk animation playing on it.
82
+ - **Technique:** Settle the pose for some simulation steps before the first draw. Keep the screen dark until the chosen weapons are built. Size finished-material slots for the largest loadout, and prefetch purchasable weapons within a radius so a bought gun is built, mapped and lit before it can be bought. Play an upgrade's reveal only when the weapon is taken from its machine, and never let start-of-run grants queue animations on the held weapon. Test with every setting the owner has saved.
83
+ - **Reference configuration:** LC settles 20 steps at 1/60 s, keeps 12 finished-model material slots (with 8, refits drew plain) and prefetches racks within 30 m. Six granted perks each queued an injection and put the gun aside for 3.5 s, seen only with every cheat saved ("nobody testing with two cheats saw it"). The owner reported the spawn four times, among them "what the fuck is this first view of gun? guns need to automatically look like 2nd", and of a purchase "it looked very weird for a few seconds as if flashlight wasnt on". After: 20 of 20, 22 of 22 and 11 of 11 spawns clean.
84
+ - **Applies when:** Every shooter, and every game with a held item at spawn.
85
+ - **Verify:** 20 spawns per loadout on the owner's path, frames 0 to 40 read, on 5 and 20 Mbit lines.
86
+
87
+ ### Every way to get a gun shows the same gun
88
+ - **Invariant:** A gun from the box, a wall, an upgrade, a pickup, the firing range or a menu preview matches the loadout version in model, scale, camo, optic, grip and angle.
89
+ - **Technique:** Route every acquisition through one path that applies the slot's camo and a compatible optic. Audit every gun in every view against every path; a debug grant does not prove a pickup path. Give the firing range every gun, attachment, camo and upgrade.
90
+ - **Reference configuration:** OC's sheet was 61 guns x hip, aimed and third person x base, upgraded and camo, 549 views, plus 152 acquisition cases. Wall guns fill 82% of their niche at no less than 1.5x held size. Pickup camo had reset to the default, and the wonder weapon was missing from the range preview twice. Wonder weapons come only from the box, which meant auditing all 11 code paths that write a weapon slot.
91
+ - **Applies when:** Games with more than one way to get a weapon.
92
+ - **Verify:** One contact sheet per round of every gun on every path, and a list of slot-writing code paths each with its capture.
93
+
94
+ ### Weapons in other hands have their own size band
95
+ - **Invariant:** A weapon held by a bot, a teammate or the player's third-person body reads in proportion to that body at every range, and the drawn body follows its aim smoothly while hits stay on the simulation.
96
+ - **Technique:** Scale only the world instance, never through a scale shared with first person, and cap the drawn length to a share of body height. Turn the drawn body toward the aim through a critically damped spring with a capped lag, and resolve shots from the simulation, never from the drawn pose. Re-express first-person actions such as reloads in the holder's own frame, judge where a friend aims by the angle from the watcher's eye, and never let a muzzle rest on a friend.
97
+ - **Reference configuration:** OS drew first-person guns at 1.5x and shared that scale, so a 2.12 m rifle was drawn 3.2 m long in a bot's hands: "ptrs barrel still reads wayy too long when u see a bot holding it ... all snpier should not look egregiously big or lage or long in a bots hands (nor too small)". Its third-person cap is 1.25 m, 0.53 to 0.65 of body height, and a 0.06 s spring capped at 0.6 rad cut one-frame yaw snaps from 1.7% to 0.2% of frames. LC's co-op friend played a first-person reload track that sent his magazine "into his belly" until it was re-expressed in his frame, and "aimed at the watcher" judged in metres put the stock at his collar; no bore rests on a friend within the weapon's length plus 0.33 m and 40 degrees. OC's third-person gun was hidden behind the body in every follow view (`opengame-characters`).
98
+ - **Applies when:** Games where players see others holding weapons: bots, co-op, multiplayer and third person.
99
+ - **Verify:** A sheet of every weapon in a bot's hands at 4, 10 and 30 m, and the drawn yaw's per-frame step through a fight.
100
+
101
+ ### Aiming goes through a real sight picture, measured per weapon
102
+ - **Invariant:** When aimed, the rear sight, the front sight and the bore's point at range lie on one line through the picture's centre, tops level, at the weapon's own eye relief; nothing of hand, sleeve or receiver sits on that line or beside the notch; lenses are clear; the gun stays upright; and the aim is calm and reversible mid-raise.
103
+ - **Technique:** Publish each weapon's sight points in data and fit the eye point from the sight meshes' world positions, never from a mount socket. Place the lens at the rear sight minus the bore direction times the eye relief, let the body follow the eye, and keep the firing hand out of the picture on long guns. Narrow the field of view on the sights and slow the look by the same ratio. Ray-test the sight line through each optic. Ease aiming over the gun's own aim time and allow reversal partway. Draw reticles in a shader, visible only from the eye side, behind dark coated glass, with housings that never take camo glow. Build aim rotation from yaw and pitch so no roll creeps in. Test what stands beside the notch as well as above it. Where a true sight picture cannot look right, aim with the gun lowered and a slight zoom.
104
+ - **Reference configuration:** OC aimed from a socket 343 mm off the ring, a 31 px error; a glove covered 35.29% of the central box on one gun ("your glove completely blocks your ADS") and the fix took it to 0.04%; the sight is within 6 px of the crosshair at 1280 x 720 and 844 x 390 (achieved 0.5 to 2 px); lenses on 4 rifles marked transparent blocked 385 of 385 rays; shortest-arc aim rotation rolled guns 25 to 30 degrees; aim times run 0.19 s (pistol) to 0.48 s (LMG), and the view model lens goes from 75 to 58.5 degrees; for the minigun the fallback was a lowered gun with a slight zoom, since CoD's version is hip-only. LC sets eye relief per weapon, 6 to 50 cm across 73 (a handgun at real reach, 43 cm; open sights 30 to 40; apertures 6 to 15), narrows the view 1.35x for long arms and 1.6x for pistols, and holds each rear sight, post and the round at 25 m within 3 px of one line. Earlier, 69 of 73 lined up within 4 px while 56 long guns still had the firing hand in frame at 10 to 19 cm, and the owner: "the ads view / positionions on all guns is extremely bad and not realistic like i just checked the mp40". A finger-over-the-sight check passed because it looked only above the notch floor ("when ur zoomed in with pistol why does ur right pointer finger liek cover ur aim?").
105
+ - **Applies when:** Shooters with aim-down-sights.
106
+ - **Verify:** Aim every gun at desktop, phone and the widest window and capture: measure sight offset in pixels, the covered share of a central box and the hand's distance from the line, and ray-test every lens; then a quarter-speed film of raise, hold, shot and lower.
40
107
 
41
- ### Nothing low-poly ever shows
42
- - **Invariant:** The player never sees a placeholder, a low level of detail, a procedural fallback or a wrong variant of a weapon, in the loadout, a menu preview, the mystery box, a wall buy, in hand or in third person, and never pays for a weapon whose model has not loaded.
43
- - **Technique:** Keep the previous complete weapon on screen until the exact new one has loaded and its shaders are compiled. Preload the likely next weapons: the visible roster, the box pool, nearby wall buys, menu neighbours. Gate a purchase on the model being ready. Where nothing exists yet, show a designed loading state in the UI, not a gun-shaped stand-in. Ship authored hero models with named parts and sockets (see `opengame-assets`); code-built guns do not pass.
44
- - **Reference configuration:** OC: one lazy-load change put low-poly guns in 6 places, and a wall gun charged points while its model was missing. The owner said it at least 6 times, including "never load any low poly versions of guns ANYWHERE in this game" and "NOTHING low poly shows when spinning box". OC prewarmed its visible roster of 8 guns, about 28 MB.
45
- - **Applies when:** Any game that streams or swaps models the player sees.
46
- - **Verify:** Throttle the network, then take every acquisition path and open every menu that shows a gun, stepping the recording at each swap: every frame shows the full model or the previous one.
108
+ ### Scope-in registers from the press, and nothing forces the player out
109
+ - **Invariant:** Zoom starts on the press frame, with field of view, weapon offset and look sensitivity on one curve; a shot fired once the sight picture shows lands on the reticle; cycling a bolt, reloading or firing never makes the player release and press aim again; and release restores the hip view within a few frames.
110
+ - **Technique:** Drive field of view, offset and sensitivity from one eased progress value. Cut to the scope image at a fixed fraction with the same aperture on both sides of the cut and no crossfade, and fire from the rendered view on the press. A scope is a field-of-view change plus an overlay, never a second world render, and the render scale and targets stay fixed across the cut so nothing is rebuilt. Whether the rifle leaves the eye during a bolt cycle is a style call; either way it returns to the sight on its own while aim is held. Set each optic's magnification to frame a standing target at the game's usual engagement range, and capture scoped frames there, never at a nearby wall. Prove hits with a bench of real inputs at fixed delays and ranges, then leave the feel to the owner's hands.
111
+ - **Reference configuration:** OS shots 100 to 200 ms into a scope-in hit 0 to 2 of 12, "2-2.7° below the crosshair", then 12 of 12 from 100 ms. Lens and hands share 220 ms in and 70 ms out against a quickscope bar of about 0.27 s where the reference data said 0.40 s ("like sleight of hand pro quickscopes on mw2/mw3 from cod on all guns (no perks required"); separate curves read as "left to straight". "u shouldnt force people to zoom out to pull the bolt", after an agent had added the unscope from memory of the reference games; LC, a realistic body-camera game, works the bolt with the rifle off the eye and brings it back. "frame would halt for a few frames righ tbefore zoom in": a resolution change at scope-in re-created 46 to 70 textures, and ADS now costs about 0.4 ms. The bench passed while the owner still saw "a weird frame", a three-frame blur. OS tuned scope fields of view to frame a standing target at each map's signature range (53 to 236 m) and captured at 100 to 300 m, after judges had scored scope shots taken 4 to 23 m away for about 40 builds.
112
+ - **Applies when:** Any scoped or aim-down-sights weapon.
113
+ - **Verify:** Bench hits per 12 at 0 to 250 ms and 50 to 200 m, and a 120 fps strip of scope-in, fire, bolt and release read frame by frame.
47
114
 
48
115
  ### Reloads are choreographed beat by beat
49
116
  - **Invariant:** Each reload is a sequence of named physical beats specific to its mechanism, readable at a glance, with each beat's time held in one data file that the animation and the sound both read, so every sound lands on its contact.
50
- - **Technique:** Write a beat spec per mechanism (box magazine, belt, pan, tube, cylinder, energy cells) for empty and partial reloads. Export the timings, trigger each sound from the same table with a short swish before contact, and add a small sound for each part that moves. Make sure every reload state machine exits.
51
- - **Reference configuration:** The owner on OC: "rn u can barely tell they are reloadin gbut we need lke a sick mag drop / mag out and then mag in and like slap the side of the gun", and later that a magnum should eject the shells inside it. OC's Ray Gun spec was latch, chamber opens, spent cells out, fresh cells in one at a time, snap shut, flicker on, with the timings exported so the audio synced per beat. Reload sounds had run 503 to 743 ms late (SMG bolt 503, rifle magazine 743, pump 649); afterwards they land within 12 ms of hand contact with a swish 110 ms before. OC's bow had an auto-reload cycle that never exited. The fidelity bar was "reload beats frame-for-frame" against the reference.
117
+ - **Technique:** Write a beat spec per mechanism (box magazine, belt, pan, tube, cylinder, energy cells) for empty and partial reloads. Export the timings, trigger each sound from the same table with a short swish before contact, and add a small sound for each part that moves. Make sure every reload state machine exits. Someone listens to every gun's reload before it counts.
118
+ - **Reference configuration:** The owner on OC: "rn u can barely tell they are reloadin gbut we need lke a sick mag drop / mag out and then mag in and like slap the side of the gun", and later that a magnum should eject the shells inside it. OC's wonder weapon spec was latch, chamber opens, spent cells out, fresh cells in one at a time, snap shut, flicker on. Reload sounds had run 503 to 743 ms late (SMG bolt 503, rifle magazine 743, pump 649); afterwards they land within 12 ms of hand contact with a swish 110 ms before. OC's bow had an auto-reload cycle that never exited. LC had reload sounds for ten families, six stages each, timed only on pistols, and nobody had heard one when the owner asked "we should also have reload sfx for all guns too please... idk if we have them?".
52
119
  - **Applies when:** Every game with reloading weapons, and any tool with a multi-step use animation.
53
120
  - **Verify:** Record a reload with sound, step it frame by frame, and check that each beat's sound starts within the game's tolerance of its contact frame, for every gun.
54
121
 
55
- ### Hands touch the gun and never pass through it
56
- - **Invariant:** On every reload, empty and partial, in first and third person, the hands and the magazine touch the parts they hold without sinking into the gun, and the support hand stays on the gun.
57
- - **Technique:** Author hand and magazine contact points on each gun model. Measure penetration depth per reload phase offline across every gun, flag every row above the threshold, and fix the worst first. A simple hand (a thumb and a mitten, see `opengame-characters`) makes the fit tractable. Measure third person too.
58
- - **Reference configuration:** OC flags any phase deeper than 8 mm. It fitted 184 contact points over 56 guns; at launch 55 of 114 rows over 57 guns were still over 8 mm, the worst at 20 to 58 mm, and third person was never measured. The support hand stays 2 to 80 mm from the gun. The owner: "we cant have that on any fo the guns". Shotgun shell inserts needed new motion.
122
+ ### Each reload is climbed gun by gun, in the player's own picture, at speed
123
+ - **Invariant:** Every weapon's empty and partial reload reads as that weapon's real drill from the player's own camera at full speed: the work is in the picture and lit, a hand is at work through it, every action begins and ends with a hand travelling, nothing pops, floats, flashes or fills the frame, and parts that move are separate and really move.
124
+ - **Technique:** Keep a per-weapon ledger scored on fixed points (drill, picture, hands, wrists, motion, parts, light), each fault with its owner, and climb it one gun at a time. Stage by where the magazine well sits in the picture; cant long arms toward the camera and keep the cant through the stage; time hand paths round the weapon and turn any jump of a target into a timed, eased travel; hand parts over when the hand arrives, not by the clock; show an empty magazine as a draw range on the one carried part. Confirm the mesh's moving parts are separate objects before animating hands. Light the work, not the wall above it. Calibrate the ledger against the owner: when the owner accepts what it fails, move the bar. Staging numbers are in [references/reloads-and-hands.md](references/reloads-and-hands.md).
125
+ - **Reference configuration:** The LC owner's order: "we really need to put each reload animation in first person view under scope and hillclimb to perfection that hands and wrists and arms and what u see on screen is all photorealistic". Its bar was 7 points scored 0 to 10, pass at 9 on each, with a hand at work at least every half second, sleeve and glove together under a sixth of the picture, wrists within 70 degrees bent and 30 to the side, and no finger through metal over 1.5 mm. A canted M16 took 7.7% of the picture against 19 to 20% upright. At the end 72 were filmed and 0 of 73 passed, while the owner accepted all eight pistol reloads ("the pistol is pretty good reload already lets just do all the other guns"), where the tester had marked the M1911 6/7/5/7/4/5/5: the owner reads the whole act at speed. Two leads spent eleven placings reaching for a cocking handle fused into the receiver mesh. OS's clip audit rebuilt logged frames from the real models and found bolt handles rotating into the stock and a reload path 16 cm under the rifle; clipped game time fell from about 24 s to 11.
126
+ - **Applies when:** Shooters with visible reloads, and any multi-step tool action seen in first person.
127
+ - **Verify:** Film every weapon empty and with rounds left, refitted too, at speed and at a quarter speed, in the player's light and window; a person watches them at speed, and the ledger shows each gun's scores.
128
+
129
+ ### Hands keep one size and one material, and stay outside the gun on every frame
130
+ - **Invariant:** On every weapon, action and frame, in first and third person, each hand draws at one scale and shares one material and fill light in every state, touches the parts it holds without sinking into them, never reveals the gun's inside, and the support hand stays on the gun.
131
+ - **Technique:** Fit by grip pose, IK target and weapon placement, never by a per-weapon hand scale. Author hand and magazine contact points on each gun model. Over a deterministic stepped capture of every weapon and action, log the drawn glove scale and the signed clip depth every frame, flag every row over the threshold and fix the worst first. Count penetration over every vertex on the game's own rig, not the solver's. After locking the scale, refit every grip, since a constant scale moves contact on every clip. A debug view that paints back faces one colour finds exposed interiors. A simple hand (a thumb and a mitten, see `opengame-characters`) makes the fit tractable where the style allows. Measure third person too.
132
+ - **Reference configuration:** OC flags any phase deeper than 8 mm: 184 contact points over 56 guns, yet at launch 55 of 114 rows over 57 guns were still over it, the worst 20 to 58 mm, and third person was never measured; the support hand stays 2 to 80 mm from the gun ("we cant have that on any fo the guns"); shotgun shell inserts needed new motion. OS: "when reloading the arisaka my hand got a ton smaller? ... cant have that on any animation/gun...", fixed from 1.59x to one scale of exactly 1.1 over 15,382 frames, after a constant scale had pushed one bolt clip from 6 to 29 mm; cells over 6 mm fell only from 56 to 33; a black patch on the mitten through 30% of the bolt cycle on 7 rifles was missed by sampling 8 frames per bolt; fists and armed gloves differed 5x in fill ("the color of hands when holding gun doesnt match"). LC's finger solver passes nothing deeper than 1.5 mm counted over every vertex (sampling every second vertex missed a thumb 1.7 mm into the hammer), and its 2.9 mm on the solver's rig was 7.9 mm on the game's stretched forearm; a pistol thumb 8.9 mm inside the frame went to 0.
59
133
  - **Applies when:** Games with visible hands on held items.
60
- - **Verify:** Run the contact check over every gun and reload; it fails on any row over the threshold. Capture the worst three rows in play.
61
-
62
- ### Aiming goes through the visible sight
63
- - **Invariant:** When aimed, the centre of the sight the player sees is on the crosshair, nothing covers the centre of the screen, lenses are clear, the gun stays upright, and the aim is calm and reversible mid-raise.
64
- - **Technique:** Fit an eye point per gun from the sight mesh's world position, never from a mount socket. Ray-test the sight line through each optic. Ease aiming over the gun's own aim time and allow reversal partway. Draw reticles in a shader, visible only from the eye side, behind dark coated glass, with housings that never take camo. Build aim rotation from yaw and pitch so no roll creeps in. Where a true sight picture cannot look right, aim with the gun lowered and a slight zoom.
65
- - **Reference configuration:** OC's aim used a socket 343 mm off the ring, a 31 px error. A glove covered 35.29% of the central box on one gun ("your glove completely blocks your ADS"); the fix took it to 0.04%. The sight is within 6 px of the crosshair at 1280 x 720 and 844 x 390 (achieved 0.5 to 2 px). Lenses on 4 rifles marked transparent blocked 385 of 385 rays. 19 of 61 guns had mesh within 0.15 m of the eye and 9 went through it. A 2 to 3 px red dot was unreadable; scope tubes need 48 or more sides; a 0.8 mm glowing torus bloomed into a seven-ring flower. Shortest-arc aim rotation rolled guns 25 to 30 degrees. Aim times run 0.19 s (pistol) to 0.48 s (LMG); the view model lens goes from 75 to 58.5 degrees. For the minigun the fallback was a lowered gun with a slight zoom, since CoD's version is hip-only.
66
- - **Applies when:** Shooters with aim-down-sights.
67
- - **Verify:** Aim every gun at desktop and phone sizes and capture: measure sight offset in pixels and the covered share of a central box, and ray-test every lens.
134
+ - **Verify:** The scale log reads 0.00% change, the clip table passes for every weapon and action on every frame, and every-frame strips cover the worst three cells.
68
135
 
69
136
  ### Handling numbers come from the reference game
70
- - **Invariant:** Rate of fire, aim time, swap time, draw time, recoil and spray follow the reference game for each gun, and damage is audited as time to kill across the run.
71
- - **Technique:** Table every gun's handling against its reference. Use real fire rates, authored spray patterns, and recoil springs per class scaled per gun. Audit time to kill at early, middle and late rounds, and treat an outlier gun as a bug.
72
- - **Reference configuration:** OC from World at War: aim 0.245 s in and 0.25 s out, swap 0.25 s, first draw from a machine 0.8 s, kick settling in 0.15 to 0.2 s, aimed kick at 30 to 40% of hip, muzzle flash 2 frames. Real fire rates (MG42 1,200 rpm, a revolver 120); one revolver had done 1,000 damage at 625 rpm. Spray: rounds 1 to 3 straight up, 4 to 10 along the gun's curve, 11 on flatter and wider. Per-gun recoil scale 0.55 to 1.8x of its class. Time to kill audited at rounds 1, 10, 20 and 30; upgraded automatics kill a round-30 zombie in 0.65 to 1.0 s of headshots. Spring and timing tables are in [references/handling-numbers.md](references/handling-numbers.md).
137
+ - **Invariant:** Rate of fire, aim time, swap time, draw time, recoil and spray follow the reference for each gun, timings decide a press the same way at any frame rate, and damage is audited as time to kill across the run.
138
+ - **Technique:** Table every gun's handling against its reference, and check every row of weapon data against a published source. Use real fire rates, authored spray patterns, and recoil springs per class scaled per gun. Run cancels and timings on elapsed time. Keep aim assist off the mouse, and fit it to the reference game's measured envelope. Audit time to kill at early, middle and late rounds, and treat an outlier gun as a bug.
139
+ - **Reference configuration:** OC from World at War: aim 0.245 s in and 0.25 s out, swap 0.25 s, first draw from a machine 0.8 s, kick settling in 0.15 to 0.2 s, aimed kick at 30 to 40% of hip, muzzle flash 2 frames, real fire rates (MG42 1,200 rpm, a revolver 120; one revolver had done 1,000 damage at 625 rpm). Per-gun recoil scale 0.55 to 1.8x of its class; upgraded automatics kill a round-30 zombie in 0.65 to 1.0 s of headshots. OS: aim assist on pads only from the reference's envelope (strafe slip 3.9 to 0.1 degrees), LC's on keys and pads only, a per-frame camera trace took recoil overshoot from 16% to 3%, and "no perk should speed up ADS". LC corrected 26 rows of weapon data against a published source. Spring, timing and recoil tables are in [references/handling-numbers.md](references/handling-numbers.md).
73
140
  - **Applies when:** Shooters, above all those that imitate a known game.
74
141
  - **Verify:** The handling table for every gun beside its reference values, and a time-to-kill run per gun at each audited round.
75
142
 
143
+ ### Hit zones come from the round's path, and lethal zones are an owner ruling
144
+ - **Invariant:** A round aimed at the chest scores as chest from the front, side and back, every zone the owner rules lethal kills with every weapon meant to kill there, and a hit marker shows only on damage that was scored.
145
+ - **Technique:** Classify trunk hits by how far the round's line passes from the capsule's axis, not by its entry point on the surface, and take the head zone from the head as last drawn. Write a lethal-zone table per weapon class, get one owner ruling, and gate it with a scripted sweep over zone, range and angle that asserts zone, damage and kill. Keep one authoritative damage event that the HUD and the marker read, never a second computation. Measure perks through the real hit path.
146
+ - **Reference configuration:** OS took the zone from the entry point, a full radius out on a capsule's side, so "EVERY trunk hit from the front, side or back scores ARMS". Most rifles did 70 to 98 to the trunk and did not kill; only 3 of 20 did, after a table had claimed every filmed rifle did, and only filming a montage found it. Its head capsule sat 0.13 m above the drawn head. The owner: "im also getting too many hitmarkers... when i shoudlnt be" and "chest and above and one shot kills"; the research notes had disagreed three ways on lethal zones. Two of four perks did nothing through the real path, and an armour perk was tuned to +40 so heavy chest hits (142 to 147) still kill, keeping the chest-and-above ruling true. OC's zone multipliers are in [references/handling-numbers.md](references/handling-numbers.md).
147
+ - **Applies when:** Any shooter with zone damage on primitive hitboxes.
148
+ - **Verify:** Per weapon, 10 rounds at mid-chest from front, side and back plus a 24-height sweep, logging zone, damage and kill: only the ruled zones kill.
149
+
76
150
  ### Each weapon kills in its own way
77
151
  - **Invariant:** The body's reaction to a kill matches the weapon: energy weapons drop bodies where they stand, shotguns and explosives throw them, and small arms push them a little.
78
152
  - **Technique:** Choose the death response from the weapon that dealt the kill: a directional death clip, then a ragdoll with an impulse set per weapon class. Tag splash damage by what it is, so an energy splash is not treated as an explosion.
79
- - **Reference configuration:** OC: energy kills rise under 0.15 m and travel under 0.6 m (the Ray Gun at most 0.005 m up and under 0.75 m of slide); a point-blank shotgun throws at 5 to 6 m/s with a sideways part, arm flail, 45 ms of hitstop and stronger shake; a pistol 1.7 m/s; an explosive 4 to 5 m/s out and 3.5 to 4.5 up. The directional death clip plays 0.16 to 0.42 s before the ragdoll. The owner: "ray guns hsouldnt make zombies fly", after the agents had logged "Ray Gun backflip" as a win because its splash was tagged explosive.
153
+ - **Reference configuration:** OC: energy kills rise under 0.15 m and travel under 0.6 m (the wonder weapon at most 0.005 m up and under 0.75 m of slide); a point-blank shotgun throws at 5 to 6 m/s with a sideways part, arm flail, 45 ms of hitstop and stronger shake; a pistol 1.7 m/s; an explosive 4 to 5 m/s out and 3.5 to 4.5 up. The directional death clip plays 0.16 to 0.42 s before the ragdoll. The owner: "ray guns hsouldnt make zombies fly", after the agents had logged the wonder weapon throwing enemies into backflips as a win because its splash was tagged explosive.
80
154
  - **Applies when:** Games with several weapon types and visible deaths.
81
155
  - **Verify:** Kill the same enemy type at the same range with each weapon class and record it; measure the root's rise and travel against the table.
82
156
 
83
- ### Every way to get a gun shows the same gun
84
- - **Invariant:** A gun from the box, a wall, an upgrade, a pickup, the firing range or a menu preview matches the loadout version in model, scale, camo, optic, grip and angle.
85
- - **Technique:** Route every acquisition through one path that applies the slot's camo and a compatible optic. Audit every gun in every view against every path; a debug grant does not prove a pickup path. Give the firing range every gun, attachment, camo and upgrade.
86
- - **Reference configuration:** OC's sheet was 61 guns x hip, aimed and third person x base, upgraded and camo, 549 views, plus 152 acquisition cases. Wall guns fill 82% of their niche at no less than 1.5x held size. Pickup camo had reset to the default, and the Ray Gun was missing from the range preview twice. Wonder weapons come only from the box, which meant auditing all 11 code paths that write a weapon slot.
87
- - **Applies when:** Games with more than one way to get a weapon.
88
- - **Verify:** One contact sheet per round of every gun on every path, and a list of slot-writing code paths each with its capture.
157
+ ### Camos cover the whole gun, skip its hardware and have a measured cost
158
+ - **Invariant:** Every finish covers all paintable surface of every gun, leaves metal, optics, grips, lens rims and glass to an explicit hardware mask, reads as a real material, never blows out to pure white or black, stays calm in the sight picture, costs a fixed amount over the plain finish, and is never cut to save memory without asking. Which finish is the default is the owner's decision, written where every critic reads it.
159
+ - **Technique:** Mark hardware per weapon with a paint, metal and glow mask, never by material name, and measure coverage over every model and in a rendered view. Bake AO into every gun's material so finishes have something to sit on. Build finishes as material response (sheen by angle, a few clean bolts) on a tileable swatch atlas with cheap shader layers, or as one graph worked in the object's own space and selected only by uniforms, branched so an unworn finish costs about nothing. Cut glow from the sight picture while aiming. Time each finish against interleaved plain-finish windows in one boot.
160
+ - **Reference configuration:** OC: 58 of 60 guns lacked AO, so AO went into the packed material at cavity 0.2 to 0.4 with normals of at least 1024 px; gold read as "lumpy sparkly clay"; lightning became at most two clean bolts; an 11-octave camo cost 1.6 to 1.8 ms, 28% of a combat frame, and went to about 4 octaves against a 0.4 ms target; "do NOT cut down the sick camos we had to save memory". OS: coverage went from "half the gun" to 99.4 to 100% over 540 combinations; a name rule painted grips and scope bodies because of "'enamel' in the polymer name", and about a third of each rifle is hardware; a vivid camo that blew out on every rifle went from 82% to 12% on bare metal; every finish stayed within 0.25 ms of the 0.72 ms plain one, where 3D Voronoi finishes had cost 1.2 to 1.8 ms. LC's finishes all cost the same unworn until branched (0.9 ms worn, about 0 unworn). The default: OC's owner wanted the factory finish in menus and starting gear and kept rejecting a rainbow camo there, while OS's owner made a vivid camo the default ("also make the default spawn in gun for new users m40a3 with prism camo"); judges ranked removing it first or second in every round, a lead removed it, and the owner restored it, about 12 commits in 20 h. The default is the owner's call, not a house look.
161
+ - **Applies when:** Weapon or character skins on a hero object.
162
+ - **Verify:** A coverage sheet of every gun and finish; crops of three weapons in three lightings with a clipped-channel histogram; a per-finish GPU timing table from one boot, worn and unworn.
89
163
 
90
- ### Camos and upgrades look like real materials and feel like an event
91
- - **Invariant:** Menus and starting gear show the factory finish; every special finish reads as a real material on every gun and is cheap enough to keep; approved camos are never cut to save memory without asking; an upgrade is a staged moment with its own sound on every upgraded shot; ammo and status effects are seen in a capture before they count as done.
92
- - **Technique:** Bake AO into every gun's material so finishes have something to sit on. Build finishes as material response (sheen by angle, a few clean bolts), not flat colour panels. Budget the held gun's shader cost. Stage the upgrade as a sequence: intake, charge, return, pickup, inspect, voice line.
93
- - **Reference configuration:** OC: 58 of 60 guns lacked AO and camos read flat, so AO went into the packed material at cavity 0.2 to 0.4 with normals of at least 1024 px. A rejected rainbow camo kept returning to menus; gold read as "lumpy sparkly clay"; lightning camo became at most two clean forked bolts, visible about 2 of 3 frames; prism became a smooth sheen that changes with angle. An 11-octave camo cost 1.6 to 1.8 ms, 28% of a combat frame, and went to about 4 octaves against a 0.4 ms target. The owner: "do NOT cut down the sick camos we had to save memory". The upgrade looked "cheap" 3 times; the spec that followed opens with a knuckle crack before the staged sequence. OC's status effects were reported "Not checked in a capture".
94
- - **Applies when:** Games with cosmetic finishes, upgrade stations or special ammo.
95
- - **Verify:** Capture every gun with every finish under the game's own lights, measure the held gun's shader time, and capture an upgrade and an upgraded shot with sound.
164
+ ### An upgrade is a staged event, and firing never lights the held gun
165
+ - **Invariant:** An upgrade is a staged moment with its own sound on every upgraded shot; firing lights a held weapon for at most a frame, with no heat glow or colour building on it unless the design calls for one; ammo and status effects are seen in a capture before they count as done.
166
+ - **Technique:** Stage the upgrade as a sequence: intake, charge, return, pickup, inspect, voice line. Budget the held gun's shader cost, drive animated finishes by uniforms, and compile them all before play. Count hot pixels between flashes over a burst. Dump the compiled shader when a finish misbehaves.
167
+ - **Reference configuration:** OC: the upgrade looked "cheap" 3 times, and the spec that followed opens with a knuckle crack before the staged sequence; its status effects were reported "Not checked in a capture". LC: the muzzle flash had lit the held gun six frames of every seven in a burst, and orange pixels between flashes went from 1,615 and 2,597 to 0; an animated finish cost 0.5 ms (1.2 worst), one of five became fit, and a shader variable first declared inside one branch turned every lamp-lit plain weapon green.
168
+ - **Applies when:** Games with upgrade stations, animated finishes or special ammo.
169
+ - **Verify:** Capture an upgrade and an upgraded shot with sound, and film 30 rounds stepped, counting hot pixels between flashes.
96
170
 
97
171
  ### Wonder weapons feel special without breaking the frame or the mix
98
172
  - **Invariant:** A wonder weapon is as finished as the best loadout gun, stays in its class's size band, is no louder than the other guns, and its effects stay inside the near-lens caps.
99
173
  - **Technique:** Hold it to every rule above, then add character through shape, sound design and projectile, not through size, level or flash. A person listens to its sound before it ships.
100
- - **Reference configuration:** OC's first loud Ray Gun fire sound was rejected as "too aggressive" and "distorted" (the loudness numbers are in `opengame-audio`), and the shipped Ray Gun's in-game peak of -7.4 dBFS stays within about 4 dB of the others. Projectile streaks are at least 56 px, and its hits stopped counting as explosions. Triangles stay at 20 to 25k like loadout guns, and camos had to work on it too.
174
+ - **Reference configuration:** OC's first loud wonder weapon fire sound was rejected as "too aggressive" and "distorted" (the loudness numbers are in `opengame-audio`), and the shipped wonder weapon's in-game peak of -7.4 dBFS stays within about 4 dB of the others. Projectile streaks are at least 56 px, and its hits stopped counting as explosions. Triangles stay at 20 to 25k like loadout guns, and camos had to work on it too.
101
175
  - **Applies when:** Games with a signature or legendary weapon.
102
176
  - **Verify:** Fire it beside a loadout gun at a wall 1 m away and at range: compare loudness, flash coverage and screen share, and have a person listen to both.
103
177
 
104
178
  ### Random rewards have written odds, a pity timer and a show
105
179
  - **Invariant:** A random reward (a mystery box, a loot crate, a gacha pull) has written odds tuned against the reference game, a pity timer for its rarest reward, a visible rarity for every result, weights that keep the weakest results rare, and a reveal that is an event.
106
180
  - **Technique:** Keep the weights in one table and compute the real odds of each result from it. Show rarity through colour, sound and light. Slow the reveal's ticks toward the result. Simulate many pulls and compare the results with the table.
107
- - **Reference configuration:** OC: wonder weapon chance 3.4% per pull, guaranteed after 16 to 20 misses; rarity shown by beam colour (white, green, blue, purple, gold); crate weights tiered 12/8/5/4; the chance of the box leaving went to 10/20/30% from 15/30/50; the starter pistol's weight went from 12 to 4. Later tables gave the Ray Gun 1 in 56, then 2 of 446 (about 1 in 102), where World at War is about 1 in 20 to 25. The spin lasts 3.4 s (BO3 4.6 s), the offer 12 s, the move 8 s; ticks slow from about 16 a second to 3 with a music-box jingle. The box costs 950 points.
181
+ - **Reference configuration:** OC: wonder weapon chance 3.4% per pull, guaranteed after 16 to 20 misses; rarity shown by beam colour (white, green, blue, purple, gold); crate weights tiered 12/8/5/4; the chance of the box leaving went to 10/20/30% from 15/30/50; the starter pistol's weight went from 12 to 4. Later tables gave the wonder weapon 1 in 56, then 2 of 446 (about 1 in 102), where World at War is about 1 in 20 to 25. The spin lasts 3.4 s (BO3 4.6 s), the offer 12 s, the move 8 s; ticks slow from about 16 a second to 3 with a music-box jingle. The box costs 950 points.
108
182
  - **Applies when:** Games with randomised loot from a container, a drop table or a pull. OC's box is the reference here.
109
183
  - **Verify:** Simulate ten thousand pulls from the shipped table and compare the counts with the intended odds, then play a pull and record the spin with sound.
@@ -70,3 +70,45 @@ at rate 7 and out at 14. Aimed kick is 30 to 40% of hip kick.
70
70
  - Wonder weapons: the same fidelity, 20 to 25k triangles, at or below the heaviest
71
71
  loadout gun.
72
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.