@opengamehq/skills 1.3.0 → 1.5.0

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 (385) hide show
  1. package/CHANGELOG.md +44 -0
  2. package/README.md +12 -4
  3. package/dist/.claude-plugin/marketplace.json +26 -0
  4. package/dist/skills/manifest.json +1409 -145
  5. package/dist/skills/opengame-accessibility/CHANGELOG.md +4 -0
  6. package/dist/skills/opengame-accessibility/SKILL.md +48 -32
  7. package/dist/skills/opengame-all-in-one/CHANGELOG.md +21 -0
  8. package/dist/skills/opengame-all-in-one/SKILL.md +195 -0
  9. package/dist/skills/opengame-all-in-one/references/opengame-accessibility/README.md +102 -0
  10. package/dist/skills/opengame-all-in-one/references/opengame-api/README.md +107 -0
  11. package/dist/skills/opengame-all-in-one/references/opengame-assets/README.md +168 -0
  12. package/dist/skills/opengame-all-in-one/references/opengame-assets/references/pipeline.md +164 -0
  13. package/dist/skills/opengame-all-in-one/references/opengame-audio/README.md +238 -0
  14. package/dist/skills/opengame-all-in-one/references/opengame-audio/helpers/audio-chain.js +325 -0
  15. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/mix-notes.md +125 -0
  16. package/dist/skills/opengame-all-in-one/references/opengame-audio/references/qa-without-ears.md +177 -0
  17. package/dist/skills/opengame-all-in-one/references/opengame-capture/README.md +128 -0
  18. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/pipeline.md +114 -0
  19. package/dist/skills/opengame-all-in-one/references/opengame-capture/references/threejs.md +161 -0
  20. package/dist/skills/opengame-all-in-one/references/opengame-characters/README.md +180 -0
  21. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/first-person-body.md +108 -0
  22. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/integration.md +144 -0
  23. package/dist/skills/opengame-all-in-one/references/opengame-characters/references/player-og.md +160 -0
  24. package/dist/skills/opengame-all-in-one/references/opengame-cli/README.md +189 -0
  25. package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +223 -0
  26. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/json-events.md +63 -0
  27. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/manifest.md +89 -0
  28. package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +119 -0
  29. package/dist/skills/opengame-all-in-one/references/opengame-depth/README.md +154 -0
  30. package/dist/skills/opengame-all-in-one/references/opengame-enemies/README.md +155 -0
  31. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/pacing-and-bots.md +108 -0
  32. package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/threejs.md +193 -0
  33. package/dist/skills/opengame-all-in-one/references/opengame-front-end/README.md +185 -0
  34. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/launch.md +50 -0
  35. package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/menus.md +81 -0
  36. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/README.md +181 -0
  37. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/helpers/spring.js +146 -0
  38. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/feel-numbers.md +142 -0
  39. package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/killcam.md +88 -0
  40. package/dist/skills/opengame-all-in-one/references/opengame-jam/README.md +114 -0
  41. package/dist/skills/opengame-all-in-one/references/opengame-lighting/README.md +141 -0
  42. package/dist/skills/opengame-all-in-one/references/opengame-lighting/helpers/light-pool.js +185 -0
  43. package/dist/skills/opengame-all-in-one/references/opengame-loading/README.md +135 -0
  44. package/dist/skills/opengame-all-in-one/references/opengame-loading/helpers/loading-count.mjs +115 -0
  45. package/dist/skills/opengame-all-in-one/references/opengame-loading/references/threejs.md +141 -0
  46. package/dist/skills/opengame-all-in-one/references/opengame-look/README.md +181 -0
  47. package/dist/skills/opengame-all-in-one/references/opengame-look/references/matching-a-reference.md +73 -0
  48. package/dist/skills/opengame-all-in-one/references/opengame-look/references/painterly.md +69 -0
  49. package/dist/skills/opengame-all-in-one/references/opengame-look/references/post-and-lens.md +73 -0
  50. package/dist/skills/opengame-all-in-one/references/opengame-maps/README.md +74 -0
  51. package/dist/skills/opengame-all-in-one/references/opengame-maps/references/map-spec.md +77 -0
  52. package/dist/skills/opengame-all-in-one/references/opengame-mobile/README.md +86 -0
  53. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/README.md +183 -0
  54. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/briefs.md +293 -0
  55. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/day-one-questions.md +46 -0
  56. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/edge-cases.md +27 -0
  57. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/filmable.md +244 -0
  58. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/finishing.md +126 -0
  59. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/measure.md +282 -0
  60. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-capture.md +151 -0
  61. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-gates.md +84 -0
  62. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-genres.md +198 -0
  63. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-grammar.md +320 -0
  64. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-ops.md +127 -0
  65. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/og-snipers-record.md +110 -0
  66. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/owner-eye.md +214 -0
  67. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/reference-study.md +293 -0
  68. package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/song.md +64 -0
  69. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/README.md +193 -0
  70. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/briefs.md +293 -0
  71. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/day-one-questions.md +46 -0
  72. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/filmable.md +244 -0
  73. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/measure.md +282 -0
  74. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-capture.md +151 -0
  75. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-gates.md +84 -0
  76. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-genres.md +198 -0
  77. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-grammar.md +320 -0
  78. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-ops.md +127 -0
  79. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/og-snipers-record.md +110 -0
  80. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/owner-eye.md +214 -0
  81. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/reference-study.md +293 -0
  82. package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/song.md +64 -0
  83. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/README.md +174 -0
  84. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/briefs.md +293 -0
  85. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  86. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/filmable.md +244 -0
  87. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/finishing.md +126 -0
  88. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/measure.md +282 -0
  89. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  90. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  91. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  92. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  93. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  94. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  95. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  96. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  97. package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/song.md +64 -0
  98. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/README.md +139 -0
  99. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/bot-lobbies.md +71 -0
  100. package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/netcode.md +165 -0
  101. package/dist/skills/opengame-all-in-one/references/opengame-performance/README.md +177 -0
  102. package/dist/skills/opengame-all-in-one/references/opengame-performance/helpers/landing-pacer.mjs +86 -0
  103. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/measuring.md +123 -0
  104. package/dist/skills/opengame-all-in-one/references/opengame-performance/references/webgpu.md +86 -0
  105. package/dist/skills/opengame-all-in-one/references/opengame-production/README.md +192 -0
  106. package/dist/skills/opengame-all-in-one/references/opengame-production/references/team.md +107 -0
  107. package/dist/skills/opengame-all-in-one/references/opengame-production/references/templates.md +153 -0
  108. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/README.md +170 -0
  109. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/cheap-tells.md +43 -0
  110. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/judges.md +95 -0
  111. package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/review-prompt.md +32 -0
  112. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/README.md +134 -0
  113. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/charting.md +109 -0
  114. package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/timing.md +92 -0
  115. package/dist/skills/opengame-all-in-one/references/opengame-router/README.md +54 -0
  116. package/dist/skills/opengame-all-in-one/references/opengame-router/references/process.md +38 -0
  117. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/README.md +136 -0
  118. package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/helpers/scene-audit.js +677 -0
  119. package/dist/skills/opengame-all-in-one/references/opengame-sdk/README.md +283 -0
  120. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/engines.md +93 -0
  121. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/frame.md +107 -0
  122. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/identity.md +111 -0
  123. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/leaderboards.md +115 -0
  124. package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/radio.md +71 -0
  125. package/dist/skills/opengame-all-in-one/references/opengame-stability/README.md +112 -0
  126. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/README.md +160 -0
  127. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/archetypes.md +113 -0
  128. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/briefs.md +273 -0
  129. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/core.md +129 -0
  130. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/craft.md +299 -0
  131. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/edge-cases.md +27 -0
  132. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/filmable.md +244 -0
  133. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/finishing.md +126 -0
  134. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/gates.md +184 -0
  135. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/measure.md +282 -0
  136. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/music.md +148 -0
  137. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/og-clash-record.md +133 -0
  138. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/ops.md +154 -0
  139. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/owner-eye.md +214 -0
  140. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/review.md +141 -0
  141. package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/title.md +92 -0
  142. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/README.md +172 -0
  143. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/archetypes.md +113 -0
  144. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/briefs.md +273 -0
  145. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/core.md +129 -0
  146. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/craft.md +299 -0
  147. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/edge-cases.md +27 -0
  148. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/filmable.md +244 -0
  149. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/finishing.md +126 -0
  150. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/gates.md +184 -0
  151. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/measure.md +282 -0
  152. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/music.md +148 -0
  153. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/og-clash-record.md +133 -0
  154. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/ops.md +154 -0
  155. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/owner-eye.md +214 -0
  156. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/reference-set.md +92 -0
  157. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/review.md +141 -0
  158. package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/title.md +92 -0
  159. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/README.md +141 -0
  160. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  161. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  162. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/core.md +129 -0
  163. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/craft.md +299 -0
  164. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  165. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  166. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  167. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/gates.md +184 -0
  168. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/measure.md +282 -0
  169. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/music.md +148 -0
  170. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  171. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/ops.md +154 -0
  172. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  173. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/review.md +141 -0
  174. package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/title.md +92 -0
  175. package/dist/skills/opengame-all-in-one/references/opengame-verification/README.md +197 -0
  176. package/dist/skills/opengame-all-in-one/references/opengame-verification/helpers/browser-evidence.mjs +74 -0
  177. package/dist/skills/opengame-all-in-one/references/opengame-weapons/README.md +179 -0
  178. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/handling-numbers.md +114 -0
  179. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/reloads-and-hands.md +96 -0
  180. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/sights-and-scopes.md +98 -0
  181. package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/threejs.md +240 -0
  182. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/README.md +141 -0
  183. package/dist/skills/opengame-all-in-one/references/opengame-world-physics/references/measured-failures.md +79 -0
  184. package/dist/skills/opengame-api/CHANGELOG.md +12 -0
  185. package/dist/skills/opengame-api/SKILL.md +39 -13
  186. package/dist/skills/opengame-assets/CHANGELOG.md +11 -0
  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/CHANGELOG.md +11 -0
  190. package/dist/skills/opengame-audio/SKILL.md +129 -41
  191. package/dist/skills/opengame-audio/references/mix-notes.md +44 -1
  192. package/dist/skills/opengame-audio/references/qa-without-ears.md +177 -0
  193. package/dist/skills/opengame-capture/CHANGELOG.md +10 -0
  194. package/dist/skills/opengame-capture/SKILL.md +44 -20
  195. package/dist/skills/opengame-capture/references/pipeline.md +33 -1
  196. package/dist/skills/opengame-capture/references/threejs.md +17 -1
  197. package/dist/skills/opengame-characters/CHANGELOG.md +15 -0
  198. package/dist/skills/opengame-characters/SKILL.md +94 -39
  199. package/dist/skills/opengame-characters/references/first-person-body.md +108 -0
  200. package/dist/skills/opengame-characters/references/player-og.md +1 -1
  201. package/dist/skills/opengame-cli/CHANGELOG.md +20 -0
  202. package/dist/skills/opengame-cli/SKILL.md +12 -11
  203. package/dist/skills/opengame-deploy/CHANGELOG.md +30 -0
  204. package/dist/skills/opengame-deploy/SKILL.md +43 -23
  205. package/dist/skills/opengame-deploy/references/json-events.md +6 -5
  206. package/dist/skills/opengame-deploy/references/manifest.md +9 -3
  207. package/dist/skills/opengame-deploy/references/packaging.md +32 -30
  208. package/dist/skills/opengame-depth/CHANGELOG.md +8 -0
  209. package/dist/skills/opengame-depth/SKILL.md +61 -33
  210. package/dist/skills/opengame-enemies/CHANGELOG.md +10 -0
  211. package/dist/skills/opengame-enemies/SKILL.md +96 -40
  212. package/dist/skills/opengame-enemies/references/pacing-and-bots.md +108 -0
  213. package/dist/skills/opengame-enemies/references/threejs.md +59 -0
  214. package/dist/skills/opengame-front-end/CHANGELOG.md +4 -0
  215. package/dist/skills/opengame-front-end/SKILL.md +85 -39
  216. package/dist/skills/opengame-front-end/references/menus.md +42 -8
  217. package/dist/skills/opengame-game-feel/CHANGELOG.md +11 -0
  218. package/dist/skills/opengame-game-feel/SKILL.md +95 -47
  219. package/dist/skills/opengame-game-feel/references/feel-numbers.md +59 -0
  220. package/dist/skills/opengame-game-feel/references/killcam.md +88 -0
  221. package/dist/skills/opengame-jam/CHANGELOG.md +12 -0
  222. package/dist/skills/opengame-jam/SKILL.md +48 -33
  223. package/dist/skills/opengame-lighting/CHANGELOG.md +9 -0
  224. package/dist/skills/opengame-lighting/SKILL.md +85 -34
  225. package/dist/skills/opengame-loading/CHANGELOG.md +4 -0
  226. package/dist/skills/opengame-loading/SKILL.md +78 -38
  227. package/dist/skills/opengame-loading/helpers/loading-count.mjs +115 -0
  228. package/dist/skills/opengame-loading/references/threejs.md +32 -7
  229. package/dist/skills/opengame-look/CHANGELOG.md +9 -0
  230. package/dist/skills/opengame-look/SKILL.md +122 -51
  231. package/dist/skills/opengame-look/references/matching-a-reference.md +73 -0
  232. package/dist/skills/opengame-look/references/painterly.md +69 -0
  233. package/dist/skills/opengame-look/references/post-and-lens.md +10 -3
  234. package/dist/skills/opengame-maps/CHANGELOG.md +9 -0
  235. package/dist/skills/opengame-maps/SKILL.md +78 -0
  236. package/dist/skills/opengame-maps/references/map-spec.md +77 -0
  237. package/dist/skills/opengame-mobile/CHANGELOG.md +4 -0
  238. package/dist/skills/opengame-mobile/SKILL.md +18 -18
  239. package/dist/skills/opengame-montage-make/CHANGELOG.md +5 -0
  240. package/dist/skills/opengame-montage-make/SKILL.md +187 -0
  241. package/dist/skills/opengame-montage-make/references/briefs.md +293 -0
  242. package/dist/skills/opengame-montage-make/references/day-one-questions.md +46 -0
  243. package/dist/skills/opengame-montage-make/references/edge-cases.md +27 -0
  244. package/dist/skills/opengame-montage-make/references/filmable.md +244 -0
  245. package/dist/skills/opengame-montage-make/references/finishing.md +126 -0
  246. package/dist/skills/opengame-montage-make/references/measure.md +282 -0
  247. package/dist/skills/opengame-montage-make/references/montage-capture.md +151 -0
  248. package/dist/skills/opengame-montage-make/references/montage-gates.md +84 -0
  249. package/dist/skills/opengame-montage-make/references/montage-genres.md +198 -0
  250. package/dist/skills/opengame-montage-make/references/montage-grammar.md +320 -0
  251. package/dist/skills/opengame-montage-make/references/montage-ops.md +127 -0
  252. package/dist/skills/opengame-montage-make/references/og-snipers-record.md +110 -0
  253. package/dist/skills/opengame-montage-make/references/owner-eye.md +214 -0
  254. package/dist/skills/opengame-montage-make/references/reference-study.md +293 -0
  255. package/dist/skills/opengame-montage-make/references/song.md +64 -0
  256. package/dist/skills/opengame-montage-plan/CHANGELOG.md +5 -0
  257. package/dist/skills/opengame-montage-plan/SKILL.md +197 -0
  258. package/dist/skills/opengame-montage-plan/references/briefs.md +293 -0
  259. package/dist/skills/opengame-montage-plan/references/day-one-questions.md +46 -0
  260. package/dist/skills/opengame-montage-plan/references/filmable.md +244 -0
  261. package/dist/skills/opengame-montage-plan/references/measure.md +282 -0
  262. package/dist/skills/opengame-montage-plan/references/montage-capture.md +151 -0
  263. package/dist/skills/opengame-montage-plan/references/montage-gates.md +84 -0
  264. package/dist/skills/opengame-montage-plan/references/montage-genres.md +198 -0
  265. package/dist/skills/opengame-montage-plan/references/montage-grammar.md +320 -0
  266. package/dist/skills/opengame-montage-plan/references/montage-ops.md +127 -0
  267. package/dist/skills/opengame-montage-plan/references/og-snipers-record.md +110 -0
  268. package/dist/skills/opengame-montage-plan/references/owner-eye.md +214 -0
  269. package/dist/skills/opengame-montage-plan/references/reference-study.md +293 -0
  270. package/dist/skills/opengame-montage-plan/references/song.md +64 -0
  271. package/dist/skills/opengame-montage-review-and-improve/CHANGELOG.md +5 -0
  272. package/dist/skills/opengame-montage-review-and-improve/SKILL.md +178 -0
  273. package/dist/skills/opengame-montage-review-and-improve/references/briefs.md +293 -0
  274. package/dist/skills/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
  275. package/dist/skills/opengame-montage-review-and-improve/references/filmable.md +244 -0
  276. package/dist/skills/opengame-montage-review-and-improve/references/finishing.md +126 -0
  277. package/dist/skills/opengame-montage-review-and-improve/references/measure.md +282 -0
  278. package/dist/skills/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
  279. package/dist/skills/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
  280. package/dist/skills/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
  281. package/dist/skills/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
  282. package/dist/skills/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
  283. package/dist/skills/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
  284. package/dist/skills/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
  285. package/dist/skills/opengame-montage-review-and-improve/references/reference-study.md +293 -0
  286. package/dist/skills/opengame-montage-review-and-improve/references/song.md +64 -0
  287. package/dist/skills/opengame-multiplayer/CHANGELOG.md +15 -0
  288. package/dist/skills/opengame-multiplayer/SKILL.md +143 -0
  289. package/dist/skills/opengame-multiplayer/references/bot-lobbies.md +71 -0
  290. package/dist/skills/opengame-multiplayer/references/netcode.md +165 -0
  291. package/dist/skills/opengame-performance/CHANGELOG.md +8 -0
  292. package/dist/skills/opengame-performance/SKILL.md +106 -65
  293. package/dist/skills/opengame-performance/helpers/landing-pacer.mjs +86 -0
  294. package/dist/skills/opengame-performance/references/measuring.md +51 -0
  295. package/dist/skills/opengame-performance/references/webgpu.md +86 -0
  296. package/dist/skills/opengame-production/CHANGELOG.md +13 -0
  297. package/dist/skills/opengame-production/SKILL.md +119 -54
  298. package/dist/skills/opengame-production/references/team.md +107 -0
  299. package/dist/skills/opengame-production/references/templates.md +106 -16
  300. package/dist/skills/opengame-quality-bar/CHANGELOG.md +10 -0
  301. package/dist/skills/opengame-quality-bar/SKILL.md +94 -42
  302. package/dist/skills/opengame-quality-bar/references/cheap-tells.md +14 -7
  303. package/dist/skills/opengame-quality-bar/references/judges.md +95 -0
  304. package/dist/skills/opengame-quality-bar/references/review-prompt.md +10 -5
  305. package/dist/skills/opengame-rhythm/CHANGELOG.md +5 -0
  306. package/dist/skills/opengame-rhythm/SKILL.md +138 -0
  307. package/dist/skills/opengame-rhythm/references/charting.md +109 -0
  308. package/dist/skills/opengame-rhythm/references/timing.md +92 -0
  309. package/dist/skills/opengame-router/CHANGELOG.md +12 -0
  310. package/dist/skills/opengame-router/SKILL.md +14 -7
  311. package/dist/skills/opengame-scene-audit/CHANGELOG.md +15 -0
  312. package/dist/skills/opengame-scene-audit/SKILL.md +64 -47
  313. package/dist/skills/opengame-scene-audit/helpers/scene-audit.js +97 -19
  314. package/dist/skills/opengame-sdk/CHANGELOG.md +16 -0
  315. package/dist/skills/opengame-sdk/SKILL.md +27 -10
  316. package/dist/skills/opengame-sdk/references/engines.md +2 -2
  317. package/dist/skills/opengame-sdk/references/identity.md +10 -11
  318. package/dist/skills/opengame-sdk/references/leaderboards.md +11 -1
  319. package/dist/skills/opengame-sdk/references/radio.md +1 -1
  320. package/dist/skills/opengame-stability/CHANGELOG.md +4 -0
  321. package/dist/skills/opengame-stability/SKILL.md +59 -27
  322. package/dist/skills/opengame-trailer-make/CHANGELOG.md +5 -0
  323. package/dist/skills/opengame-trailer-make/SKILL.md +164 -0
  324. package/dist/skills/opengame-trailer-make/references/archetypes.md +113 -0
  325. package/dist/skills/opengame-trailer-make/references/briefs.md +273 -0
  326. package/dist/skills/opengame-trailer-make/references/core.md +129 -0
  327. package/dist/skills/opengame-trailer-make/references/craft.md +299 -0
  328. package/dist/skills/opengame-trailer-make/references/edge-cases.md +27 -0
  329. package/dist/skills/opengame-trailer-make/references/filmable.md +244 -0
  330. package/dist/skills/opengame-trailer-make/references/finishing.md +126 -0
  331. package/dist/skills/opengame-trailer-make/references/gates.md +184 -0
  332. package/dist/skills/opengame-trailer-make/references/measure.md +282 -0
  333. package/dist/skills/opengame-trailer-make/references/music.md +148 -0
  334. package/dist/skills/opengame-trailer-make/references/og-clash-record.md +133 -0
  335. package/dist/skills/opengame-trailer-make/references/ops.md +154 -0
  336. package/dist/skills/opengame-trailer-make/references/owner-eye.md +214 -0
  337. package/dist/skills/opengame-trailer-make/references/review.md +141 -0
  338. package/dist/skills/opengame-trailer-make/references/title.md +92 -0
  339. package/dist/skills/opengame-trailer-plan/CHANGELOG.md +5 -0
  340. package/dist/skills/opengame-trailer-plan/SKILL.md +176 -0
  341. package/dist/skills/opengame-trailer-plan/references/archetypes.md +113 -0
  342. package/dist/skills/opengame-trailer-plan/references/briefs.md +273 -0
  343. package/dist/skills/opengame-trailer-plan/references/core.md +129 -0
  344. package/dist/skills/opengame-trailer-plan/references/craft.md +299 -0
  345. package/dist/skills/opengame-trailer-plan/references/edge-cases.md +27 -0
  346. package/dist/skills/opengame-trailer-plan/references/filmable.md +244 -0
  347. package/dist/skills/opengame-trailer-plan/references/finishing.md +126 -0
  348. package/dist/skills/opengame-trailer-plan/references/gates.md +184 -0
  349. package/dist/skills/opengame-trailer-plan/references/measure.md +282 -0
  350. package/dist/skills/opengame-trailer-plan/references/music.md +148 -0
  351. package/dist/skills/opengame-trailer-plan/references/og-clash-record.md +133 -0
  352. package/dist/skills/opengame-trailer-plan/references/ops.md +154 -0
  353. package/dist/skills/opengame-trailer-plan/references/owner-eye.md +214 -0
  354. package/dist/skills/opengame-trailer-plan/references/reference-set.md +92 -0
  355. package/dist/skills/opengame-trailer-plan/references/review.md +141 -0
  356. package/dist/skills/opengame-trailer-plan/references/title.md +92 -0
  357. package/dist/skills/opengame-trailer-review-and-improve/CHANGELOG.md +5 -0
  358. package/dist/skills/opengame-trailer-review-and-improve/SKILL.md +145 -0
  359. package/dist/skills/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
  360. package/dist/skills/opengame-trailer-review-and-improve/references/briefs.md +273 -0
  361. package/dist/skills/opengame-trailer-review-and-improve/references/core.md +129 -0
  362. package/dist/skills/opengame-trailer-review-and-improve/references/craft.md +299 -0
  363. package/dist/skills/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
  364. package/dist/skills/opengame-trailer-review-and-improve/references/filmable.md +244 -0
  365. package/dist/skills/opengame-trailer-review-and-improve/references/finishing.md +126 -0
  366. package/dist/skills/opengame-trailer-review-and-improve/references/gates.md +184 -0
  367. package/dist/skills/opengame-trailer-review-and-improve/references/measure.md +282 -0
  368. package/dist/skills/opengame-trailer-review-and-improve/references/music.md +148 -0
  369. package/dist/skills/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
  370. package/dist/skills/opengame-trailer-review-and-improve/references/ops.md +154 -0
  371. package/dist/skills/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
  372. package/dist/skills/opengame-trailer-review-and-improve/references/review.md +141 -0
  373. package/dist/skills/opengame-trailer-review-and-improve/references/title.md +92 -0
  374. package/dist/skills/opengame-verification/CHANGELOG.md +11 -0
  375. package/dist/skills/opengame-verification/SKILL.md +113 -48
  376. package/dist/skills/opengame-weapons/CHANGELOG.md +11 -0
  377. package/dist/skills/opengame-weapons/SKILL.md +129 -55
  378. package/dist/skills/opengame-weapons/references/handling-numbers.md +42 -0
  379. package/dist/skills/opengame-weapons/references/reloads-and-hands.md +96 -0
  380. package/dist/skills/opengame-weapons/references/sights-and-scopes.md +98 -0
  381. package/dist/skills/opengame-weapons/references/threejs.md +71 -0
  382. package/dist/skills/opengame-world-physics/CHANGELOG.md +9 -0
  383. package/dist/skills/opengame-world-physics/SKILL.md +55 -24
  384. package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
  385. package/package.json +1 -1
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: opengame-capture
3
- description: Make a browser game filmable and screenshot-testable. Covers a host-stepped clock, one time scale, seeded takes, a director camera whose cuts reset history, a clean feed with HUD masks and mute flags, an awaitable ready state, acknowledged capture requests, a state probe, stepped audio, 4K60 readback from the render surface and hooks kept out of public builds. Use when the person wants a trailer, gameplay footage, slow motion, a photo mode or screenshot tests, or says takes do not repeat.
3
+ description: Make a browser game filmable and screenshot-testable. Covers a host-stepped clock, one time scale, seeded takes, a director camera, a clean feed, a ready state, acknowledged requests, captures that prove their own build and state, motion filmed on the game clock at quarter speed, stepped audio, WebGPU readback, batched jobs and hooks absent from public builds. Use when the person wants a trailer, footage, slow motion or screenshot tests, or takes do not repeat or captures come out black.
4
4
  metadata:
5
- version: "1.0.0"
5
+ version: "1.1.0"
6
6
  ---
7
7
 
8
8
  # Capture: a game you can film and test
@@ -15,7 +15,10 @@ top. The owner's brief: "i do NOT want to have to keep watching shitty takes and
15
15
  feedbaxk thqt u should be able to know ill give u based on those skills".
16
16
 
17
17
  Build these into the game before anyone films it. The same hooks make screenshot tests
18
- repeatable, which is most of what `opengame-verification` asks of a capture.
18
+ repeatable, which is most of what `opengame-verification` asks of a capture. OS, LC and OH
19
+ added the testing half: judges scored captures that were not what their labels said,
20
+ WebGPU frames came back black, real-time films drew a handful of frames a second on a
21
+ loaded machine, and screencasts were read as real time.
19
22
 
20
23
  Rules carry five tags; `opengame-quality-bar` explains them and the game codes. The
21
24
  three.js way to do each is in [references/threejs.md](references/threejs.md); pipeline
@@ -25,17 +28,17 @@ numbers, the capability audit and process are in [references/pipeline.md](refere
25
28
 
26
29
  ### The host steps one clock
27
30
  - **Invariant:** In capture mode the host advances the game by a fixed simulation step per output frame, every system reads that one clock, and no game code reads wall time.
28
- - **Technique:** A capture mode where the host calls step, then render, then read back, and the game's own frame loop is off. Simulation, physics, animation, particles, weather, camera smoothing and audio all take their time from the step, and worker threads read the same clock. Slow motion is a smaller step, never frame interpolation. Gameplay never runs faster than real time; speed on screen comes from the camera.
29
- - **Reference configuration:** OC's time came from `performance.now()` in a worker, and page-level tricks failed: a fake page clock froze timers and virtual time never reached the workers. A shim replaced `performance.now` and `requestAnimationFrame` in the worker and retried a frame when the GPU slot was busy; its first version took 48-64 min and the full rig about 2 h. Real-time 4K ran at 25-31 fps, so 1 s of 4K60 cost about 5.2 s of wall time. Stepped, the rig ran 28.1 fps first person and 37.2 fps on a dolly at 4K on an idle M4 Max, 2.1-3.5 s of wall time per output second. A step of 1/60 is 1x and 1/240 is 0.25x; 240 frames covered 1.000 s of simulation with 0 skipped. The montage reused the rig unchanged on a new build in about an hour.
31
+ - **Technique:** A capture mode where the host calls step, then render, then read back, and the game's own frame loop is off. Simulation, physics, animation, particles, weather, camera smoothing and audio all take their time from the step, and worker threads read the same clock. Drive every scripted state by update count, never wall time. Slow motion is a smaller step, never frame interpolation. Gameplay never runs faster than real time; speed on screen comes from the camera.
32
+ - **Reference configuration:** OC's time came from `performance.now()` in a worker, and page-level tricks failed: a fake page clock froze timers and virtual time never reached the workers. A shim replaced `performance.now` and `requestAnimationFrame` in the worker and retried a frame when the GPU slot was busy; its first version took 48-64 min and the full rig about 2 h. Real-time 4K ran at 25-31 fps, so 1 s of 4K60 cost about 5.2 s of wall time. Stepped, the rig ran 28.1 fps first person and 37.2 fps on a dolly at 4K on an idle M4 Max, 2.1-3.5 s of wall time per output second. A step of 1/60 is 1x and 1/240 is 0.25x; 240 frames covered 1.000 s of simulation with 0 skipped. The montage reused the rig unchanged on a new build in about an hour. LC stepped 1/60 per drawn frame after real-time films on its loaded machine drew 8-25 fps ("nine pictures a second at best"), and recipes timed on the wall clock while the game clock was held made holds 3-4x short; the stepped burst was "the only film true under tonight's load".
30
33
  - **Applies when:** Every game that will be filmed, screenshot-tested or compared frame by frame.
31
34
  - **Verify:** Capture 240 frames at a 1/240 step: the probe's simulation time rises by exactly one step per frame and ends at 1 s. Repeat on a loaded machine and get the same frames.
32
35
 
33
36
  ### One time scale, and every timer obeys it
34
37
  - **Invariant:** Every timer in the game (hitstop, shake, camera lerps, particles, physics, corpse settling, emitters, flashes, audio) runs on scaled simulation time, so an effect at quarter speed looks like the same effect slowed down.
35
38
  - **Technique:** One time scale applied where the clock is read, never per system. Replace frame-count timers with time. Physics sub-steps or interpolates so a small step does not hold a pose and then jump. Motion blur takes its shutter from the step. A cinematic flag turns off hitstop and kill-cam time dilation. Review every effect at quarter speed before filming.
36
- - **Reference configuration:** OC: a 45 ms kill hitstop became about 9 near-frozen frames at 0.3x, and a 70 ms hammer hold about 12 frames at 0.25x. Corpses solved at a fixed 60 Hz, so at 0.25x a pose held for 4 frames, then jumped. A gib trail emitted every third frame, and per-frame emitters ran 4 times denser. A game-only time scale left particles on presentation time at full speed. Motion blur reached a 360-degree shutter at 1/240 until its strength was set to 60 times the step in seconds (0.25 at 1/240). At 0.25x a light re-firing every 0.09 s strobed at 10 Hz, a blood sprite covered about 40% of the frame, and a bloom clipped to white. The frozen-flip defect was predicted in an audit, still reached the owner about 28 h later, and cost about 3 h and reshoots for a 6-line fix.
39
+ - **Reference configuration:** OC: a 45 ms kill hitstop became about 9 near-frozen frames at 0.3x, and a 70 ms hammer hold about 12 frames at 0.25x. Corpses solved at a fixed 60 Hz, so at 0.25x a pose held for 4 frames, then jumped. A gib trail emitted every third frame, and per-frame emitters ran 4 times denser. A game-only time scale left particles on presentation time at full speed. Motion blur reached a 360-degree shutter at 1/240 until its strength was set to 60 times the step in seconds (0.25 at 1/240). At 0.25x a light re-firing every 0.09 s strobed at 10 Hz, a blood sprite covered about 40% of the frame, and a bloom clipped to white. The frozen-flip defect was predicted in an audit, still reached the owner about 28 h later, and cost about 3 h and reshoots for a 6-line fix. OS's dev time scale never reached the game, so every "slow-motion" animation capture ran at real speed until someone checked.
37
40
  - **Applies when:** Games with slow motion, hitstop, or any effect timed by frames.
38
- - **Verify:** Render each effect at 1x and at 0.25x and lay the frames side by side: the slow version has four times the frames of the same motion, with no holds, jumps or denser particles.
41
+ - **Verify:** Render each effect at 1x and at 0.25x and lay the frames side by side: the slow version has four times the frames of the same motion, with no holds, jumps or denser particles, and the probe's simulation time confirms the scale took.
39
42
 
40
43
  ### One seed makes a take repeat
41
44
  - **Invariant:** Two runs of the same take with the same seed, clock and scripted input produce the same frames.
@@ -53,25 +56,32 @@ numbers, the capability audit and process are in [references/pipeline.md](refere
53
56
 
54
57
  ### A clean feed, element by element
55
58
  - **Invariant:** Each HUD element and each world-space gameplay marker can be hidden on its own, music and voice can each be muted, and a clean take keeps whatever feedback the shot asks for.
56
- - **Technique:** A named flag for every interface element and world marker (hit markers, score pops, crosshair, plates, subtitles, set-piece UI, telegraphs, weak-point marks, rings) and a mask that picks which to draw. Tag world markers separately from art. One clean-feed switch sets the usual mask and mutes music and voice; prove the mute by loudness. Interface projected from the player's camera lines up only in first person, so hide it on other cameras. Dev overlays, page badges and cheat effects never reach the frame.
57
- - **Reference configuration:** OC's owner asked to hide "the H UD except hitmarkers and like the points juice". A HUD mask (score pops, hit marker, crosshair, points plate) plus flags for subtitles and set-piece UI took about 3 min to build. The old hide flag also hid boss marks and the letterbox, subtitles ignored it, and the mask drew over it, so cinematics had to clear both. Cyan rings, a weak-point capsule, floor telegraphs, glyphs and strike circles read as HUD on film. On the montage, dev-funded score jumps from 1,039 to 49,550 showed on screen.
59
+ - **Technique:** A named flag for every interface element and world marker (hit markers, score pops, crosshair, plates, subtitles, set-piece UI, telegraphs, weak-point marks, rings) and a mask that picks which to draw. Tag world markers separately from art. One clean-feed switch sets the usual mask and mutes music and voice; prove the mute by loudness. Interface projected from the player's camera lines up only in first person, so hide it on other cameras. Dev overlays, page badges and cheat effects never reach the frame. Give scoring tools the same mask, so a screen-fixed reticle or HUD is never counted as change in the scene.
60
+ - **Reference configuration:** OC's owner asked to hide "the H UD except hitmarkers and like the points juice". A HUD mask (score pops, hit marker, crosshair, points plate) plus flags for subtitles and set-piece UI took about 3 min to build. The old hide flag also hid boss marks and the letterbox, subtitles ignored it, and the mask drew over it, so cinematics had to clear both. Cyan rings, a weak-point capsule, floor telegraphs, glyphs and strike circles read as HUD on film. On the montage, dev-funded score jumps from 1,039 to 49,550 showed on screen. On OS the screen-fixed reticle made 75-91% of the spikes a flicker scorer counted in scoped shots until it was masked.
58
61
  - **Applies when:** Every game with a HUD that will be filmed or used for marketing stills.
59
62
  - **Verify:** A contact sheet of one frame with each flag on and off. On the clean feed, a reviewer marks every visible interface element; only the masked-in ones remain.
60
63
 
61
64
  ### Ready means resident
62
65
  - **Invariant:** The game exposes one state the capture script can await that means every model, texture, pipeline and sound the scene needs is resident and the quality setting is locked, and a load failure reports itself instead of crashing.
63
- - **Technique:** Count pending loads, compiles and decodes; resolve a promise or post a message when they reach zero after the scene is built and quality is fixed. Give each asset class a named failure and a timeout. In the unrecorded preroll, grant and show every item the take uses once, so late loads happen off camera. Lock quality: no dynamic resolution or automatic tier in capture mode.
64
- - **Reference configuration:** OC had no such state. Under load, 55 boot crashes paired with a renderer assert on a missing material; about 40 takes hit it and 5 of 7 attempts at one shot were lost. Boot waits grew from 180 to 420 s, and takes were capped at 2-3 min with 2-5 retries. Late guns drew black for about 10 s ("give every gun once before shooting"), and sound banks stayed silent for 11-20 s. The renderer started on Low and calibrated, so dynamic resolution popped lights until quality was fixed after the title; the rig waited for the log line "renderer quality: fixed at ultra".
66
+ - **Technique:** Count pending loads, compiles and decodes; resolve a promise or post a message when they reach zero after the scene is built and quality is fixed. Give each asset class a named failure and a timeout. In the unrecorded preroll, grant and show every item the take uses once, so late loads happen off camera. Lock quality: no dynamic resolution or automatic tier in capture mode. A capture that waits for ready never sees the seconds before it, so test the first seconds of play with a separate capture that starts at the press.
67
+ - **Reference configuration:** OC had no such state. Under load, 55 boot crashes paired with a renderer assert on a missing material; about 40 takes hit it and 5 of 7 attempts at one shot were lost. Boot waits grew from 180 to 420 s, and takes were capped at 2-3 min with 2-5 retries. Late guns drew black for about 10 s ("give every gun once before shooting"), and sound banks stayed silent for 11-20 s. The renderer started on Low and calibrated, so dynamic resolution popped lights until quality was fixed after the title; the rig waited for the log line "renderer quality: fixed at ultra". LC's captures waited for late assets and so never saw the white placeholder hand a player saw before the real hands arrived.
65
68
  - **Applies when:** Every game that streams assets or calibrates quality.
66
69
  - **Verify:** Await the state on a throttled connection and capture the next frame: every model is present and lit at final quality, and the first shot is audible. Block one asset: the state reports which one failed.
67
70
 
68
71
  ### Capture requests are addressed to frames and acknowledged one by one
69
72
  - **Invariant:** Every screenshot request and director command names the simulation frame it applies to, and the game acknowledges each one with the frame it ran on, so the capture script never guesses when something happened.
70
73
  - **Technique:** A request queue with an id and a target frame per request. The game runs it at that frame and replies with the id, the frame, the build id, the screen it was on and whether assets were loaded. The capture script sends the next request after the reply and treats a missing reply as a failure. Screenshots wait for the interface to settle. Document the limits: command size, deadlines, and what happens to a command sent before the scene exists.
71
- - **Reference configuration:** OC: real-time stage commands 0.2 s apart landed in the same frame and were lost under load, so staging moved to an unrecorded preroll. A shutter command sent only on change swallowed the frame-0 command. Commands sent before the scene existed were dropped, a scripted run aborted 10 s after its last command, and a command buffer over about 7.9 KB crashed the engine on load. Frame-addressed injection landed 59 of 59 on the right frame. Checking that each capture shows the screen it claims is in `opengame-verification`.
74
+ - **Reference configuration:** OC: real-time stage commands 0.2 s apart landed in the same frame and were lost under load, so staging moved to an unrecorded preroll. A shutter command sent only on change swallowed the frame-0 command. Commands sent before the scene existed were dropped, a scripted run aborted 10 s after its last command, and a command buffer over about 7.9 KB crashed the engine on load. Frame-addressed injection landed 59 of 59 on the right frame. OS's capture steps each waited for a log line the game printed, and every step that shoots shoots exactly once, after one boot took 184 s. Checking that each capture shows the screen it claims is in `opengame-verification`.
72
75
  - **Applies when:** Every game driven by a capture or test script.
73
76
  - **Verify:** Send 100 screenshot requests in a burst: 100 replies arrive, each with its own frame and the expected screen. Kill the game mid-burst: the capture script fails the run.
74
77
 
78
+ ### A capture proves its own build, state, camera and coverage
79
+ - **Invariant:** A frame reaches a judge, a metric or the owner only if its pixels and a log line from the same second agree with its label (the named build from committed code, the real interface path, the player alive in a first life, the requested camera outside geometry, quality and weather pinned), it was taken from a frozen snapshot nobody else can change while the run lasts, and the set covers every cell the rubric scores.
80
+ - **Technique:** Capture from a snapshot of the committed head plus your own files, served on a private port, so another agent's save cannot reload the page. Pin quality, weather and time of day, and write the renderer string, build hash and state line beside each image. Dump the camera before and after each still, ray-probe every judge camera against collision, and spawn with god mode off. Wait on game state, never on timers. Write each run to an immutable folder keyed by build hash. Quarantine black, low-variance and duplicate frames. Generate the capture plan from the rubric, so every scored cell has a frame. Label each clip for what it is: stepped or real time, its clock rate, brightened or not.
81
+ - **Reference configuration:** OS's first round had 6 of 10 maps at 1 HP, put the victory screen in all three scope slots, and sent judges four "gameplay" stills aimed at the sky; on a first pass 13 of one map's 39 checklist cameras sat inside walls, roofs or cliff tops. "Several smoke folders were rewritten while I was reading them." Capture "success" (files written, 0 errors, 4 of 4 shots) proved nothing four separate times. OH captured at 1600 x 900 from frozen snapshots of the committed head on private ports, quality pinned, a state line and renderer string beside each image, and still had a missing clip, a mid-animation title and a stale capture scored as game faults; its rule became a manifest of build hash and renderer, with no file older than the build. Checking a capture against its label before judging is in `opengame-verification`.
82
+ - **Applies when:** Any automated capture that feeds a judge, a gate, a metric or the owner.
83
+ - **Verify:** Kill the player partway through a run and move one camera into rock: the run exits non-zero and quarantines both. The manifest lists the build hash and renderer, and no file in the set is older than the build.
84
+
75
85
  ### A state probe in render space, checked on day one
76
86
  - **Invariant:** On request or every frame, the game reports where the camera, the player, each enemy's head and joints, bosses and objective states are, taken from the same snapshot that was rendered and in render space, and the report matches the picture.
77
87
  - **Technique:** A probe flag that emits one record per frame from post-skinning transforms in the rendered snapshot. Name items and tables in the record; never make anyone map indices by hand. On the first day, project probe points into a rendered frame and check each lands on the drawn head, joint or item. Export the per-frame camera and joints if CG will be composited.
@@ -79,24 +89,38 @@ numbers, the capability audit and process are in [references/pipeline.md](refere
79
89
  - **Applies when:** Games where a capture script aims, frames or checks shots from game state.
80
90
  - **Verify:** Draw probe points over 20 captured frames: each lands on its drawn feature within a few pixels.
81
91
 
92
+ ### Motion is filmed on the game clock and read at quarter speed, from the angle that shows it
93
+ - **Invariant:** Holds, reloads, gaits, deaths, effects, flicker and transitions are accepted only from a recording of every drawn frame on the game clock, played back slowed and stepped frame by frame, from the player's camera and from an angle that shows the motion, and also watched at full speed as a whole act by a person, since no agent can; an interface cut over the scene is judged from a recording that holds both.
94
+ - **Technique:** Record every drawn frame for a few seconds on the stepped clock and play it at quarter speed (drawn frames shown at a quarter of their rate), with a sheet of consecutive frames beside it. Film enemies from a side lens at chest height a few metres off as well as from the player's view. For flicker and camera feel, script a fixed still, turn, strafe, walk and aim sequence so before and after show the same poses. When the DOM and the canvas must be judged together, run a headed browser on its own virtual display and grab it at the display rate, with a small corner mark that changes every frame as the frame clock. Stamp any dark frame you brightened with its gain, and never pass anything on a brightened frame.
95
+ - **Reference configuration:** LC filmed every drawn frame and played it at 15 fps (quarter speed at 60) beside a 16-frame sheet, and filmed enemies through a side lens 3 m off at chest height with a 68-degree field of view, which exposed library "falls" as stunt breakfalls that the deformation audit had passed. LC's headed grab ran 34 fps at a machine load of 13 and 4-13 fps at 35-54, and showed the DOM changing 67-167 ms before the WebGPU picture. OS's game-clock flicker path held within about 5% run to run, against 10-30% for free-running captures. OH's judges found its board vanishing for single frames by stepping a clip, and an in-page probe counted 4 of 880.
96
+ - **Applies when:** Anything that moves, in any game whose motion an agent, a judge or the owner will review.
97
+ - **Verify:** The film's frame count equals game seconds times the step rate, the corner mark changes once per frame, and each motion has a sheet with named faults or "none", read at full size.
98
+
82
99
  ### Audio is captured at simulation rate, per bus
83
100
  - **Invariant:** A take's sound comes from the simulation at the take's own rate, music, voice, effects and ambience are available as separate stems, and each bus can be muted from the launch URL.
84
- - **Technique:** Mute and stem flags readable at launch. In capture mode, drain the mixer per output frame by exactly the samples one step covers, trim the output latency, and save a cue log with each cue's simulation time. Slow motion yields audio the length of simulated time, so the edit retimes or replaces it. Load every sound bank a take uses before recording.
85
- - **Reference configuration:** OC: music and voice were baked into every take until music and voice mute flags existed, found when 12 of 22 voice lines overlapped. The rig drained `sampleRate * step` samples per frame and trimmed 4,095 samples (85 ms) of latency; 13 of 145 cues needed re-alignment in slow-motion takes. On the montage, settings-menu mute clicks never landed and all 9 segments were reshot (`opengame-audio` has the numbers). The film mastered at -13.8 LUFS and -1.6 dBTP against a -14 LUFS target.
101
+ - **Technique:** Mute and stem flags readable at launch. In capture mode, drain the mixer per output frame by exactly the samples one step covers, trim the output latency, and save a cue log with each cue's simulation time. Slow motion yields audio the length of simulated time, so the edit retimes or replaces it. Load every sound bank a take uses before recording. Where a capture cannot carry sound, prove timing from logs on the game's clock and leave the listening to a person.
102
+ - **Reference configuration:** OC: music and voice were baked into every take until music and voice mute flags existed, found when 12 of 22 voice lines overlapped. The rig drained `sampleRate * step` samples per frame and trimmed 4,095 samples (85 ms) of latency; 13 of 145 cues needed re-alignment in slow-motion takes. On the montage, settings-menu mute clicks never landed and all 9 segments were reshot (`opengame-audio` has the numbers). The film mastered at -13.8 LUFS and -1.6 dBTP against a -14 LUFS target. Every clip OH's judges saw had no audio, so OH proved timing from logs on the song clock (drawn against heard under 4 ms). LC recorded the page's audio by routing everything sent to the output into a recorder while the browser stayed muted; OS recorded the exact WebAudio output aligned to the engine log to about 0.2 s, which exposed a 1.7-3.6 s skew behind wrong numbers.
86
103
  - **Applies when:** Every game with sound that will be filmed.
87
104
  - **Verify:** Capture the same shot at 1x and at 0.25x. At 1x each shot's sound lines up with its muzzle flash to within a frame. With music muted, the music stem measures silent.
88
105
 
89
106
  ### Every frame comes from the render surface
90
- - **Invariant:** Delivered footage holds every frame at the delivery resolution and frame rate, read from the render surface with correct colour tags, however loaded the machine is.
91
- - **Technique:** After each stepped frame, read back the render surface, convert colour on the GPU to the encoder's format and tag it, and encode with a hardware encoder through WebCodecs. Page screenshots and screencasts are for stills and debugging, never for motion. Render at native resolution with a device pixel ratio of 1, lock the quality preset, and stop the run if the browser fell back to a software rasteriser. Check output by counting unique frames and measuring colour, never by frame count alone.
92
- - **Reference configuration:** OC: `page.screenshot` at 4K took 2,516 ms; a CDP screencast gave 12-19 fps, lossy; CPU x264 encoded 1.7-4.2 fps at 1080p. A swapchain copy with `copyTextureToBuffer` and `mapAsync` took 30.4 ms at 4K. WebCodecs tagged frames BT.601, so a GPU pass to NV12 BT.709 fixed it (Y 68.7 dB against ffmpeg, against 41.3 dB for BT.601). HEVC at 300 Mbps banded least on the storm sky (H.264 at 160 Mbps flattened 51% of blocks, HEVC 14.5%); the 4K master is 2.25 GB per output minute. Supersampling at dpr 1.5 cost 3.4x (11.0 against 37.2 fps) for no visible gain. Dropped frames were 0 regardless of load, because frames were stepped, not timed. Frame-count QA passed a 3,720-frame cut whose frames 1-402 were frozen.
107
+ - **Invariant:** Delivered footage and test captures hold every frame at the intended resolution and rate, read from the render surface with correct colour tags, however loaded the machine is, and a capture whose first picture is near black fails.
108
+ - **Technique:** After each stepped frame, read back the render surface, convert colour on the GPU to the encoder's format and tag it, and encode with a hardware encoder through WebCodecs. Page screenshots and screencasts are for stills and debugging, never for motion, and a screencast's timing and frame count are not the game's. Read a WebGPU canvas inside the task that drew it, from a declared after-frame hook that changes nothing else (see the hooks rule below), with `canvas.toBlob` or a copy of the presented texture; depending on the browser's mode, copying the canvas into another canvas, `captureStream`, a screencast or a page screenshot can return black, so prove the path on one frame first and check that the first frame's mean clears a near-black floor. Render at native resolution with a device pixel ratio of 1, lock the quality preset, and stop the run if the browser fell back to a software rasteriser. Check output by counting unique frames and measuring colour, never by frame count alone.
109
+ - **Reference configuration:** OC: `page.screenshot` at 4K took 2,516 ms; a CDP screencast gave 12-19 fps, lossy; CPU x264 encoded 1.7-4.2 fps at 1080p. A swapchain copy with `copyTextureToBuffer` and `mapAsync` took 30.4 ms at 4K. WebCodecs tagged frames BT.601, so a GPU pass to NV12 BT.709 fixed it (Y 68.7 dB against ffmpeg, against 41.3 dB for BT.601). HEVC at 300 Mbps banded least on the storm sky (H.264 at 160 Mbps flattened 51% of blocks, HEVC 14.5%); the 4K master is 2.25 GB per output minute. Supersampling at dpr 1.5 cost 3.4x (11.0 against 37.2 fps) for no visible gain. Dropped frames were 0 regardless of load, because frames were stepped, not timed. Frame-count QA passed a 3,720-frame cut whose frames 1-402 were frozen. On LC, headless, copying a WebGPU canvas into another canvas, `captureStream()`, the CDP screencast and `page.screenshot` all gave black frames (79 of 79), and LC fails a capture whose first frame's mean is under 1-2 of 255. OH's 25 fps screencasts sat 1-4.6 s off the page, and judges who timed effects by counting their frames were wrong.
93
110
  - **Applies when:** Every game filmed for a trailer, montage or store page.
94
111
  - **Verify:** `ffprobe` reports the expected size, rate and BT.709 tags; the count of unique frames equals the count of frames; one frame matches a direct readback of the same step.
95
112
 
113
+ ### Batch the shots for one look into one job, and prove the tool on one frame first
114
+ - **Invariant:** Every shot needed for one look is taken in one job on your machine's job queue, with no more browsers than the GPU holds, the job is watched until its result is read, and a new or changed capture tool has been proved on one frame before a batch spends a slot.
115
+ - **Technique:** Write the batch as a spec (scenes, cameras, states, frames) and run it in one slot from one build. Run a dry pass that boots no browser and checks names and paths, then one shot, then the batch. Wait for the job inside your own turn with a bounded wait on its end mark; a job left running after its launcher's turn ends reaches nobody. Keep file names short and encoder tile widths even.
116
+ - **Reference configuration:** LC kept at most three browsers in one slot after five lost the WebGPU device; an odd tile width gave 0-frame clips, and under load a kept picture cost about 1 s. Learning the black-frame rule cost one LC stream five slot jobs and every stream about one. OH kept every shot for a judge packet inside one slot grant of under 8 minutes, never nested. OS grouped steps into slot jobs of under 20 minutes and spaced screenshots at least 1.2 s apart. How to share the slots between agents is in `opengame-production`.
117
+ - **Applies when:** Every capture run on a machine whose browsers, GPU or job slots are shared.
118
+ - **Verify:** The job log shows one slot per look, the dry pass and the single-shot proof before the batch, and no capture job still running after its launcher's turn ended.
119
+
96
120
  ### Capture hooks are off by default and absent from public builds
97
- - **Invariant:** Capture hooks live in the shipping game's code, each off by default behind its own flag, change nothing while off, and are absent or locked in the public build.
98
- - **Technique:** One flag per hook, listed in one file with what it does. A parity frame proves flags-off equals the release. Strip hooks at build time for the public build, or gate them behind a key whose secret is not in the bundle. Record the build hash and every flag a take used in the take's spec. Write each film fix as a flag the game can adopt.
99
- - **Reference configuration:** OC added about 25-30 default-off hooks in a day, each diffable as a hooks list and a patch, versioned film builds by wasm hash with receipts, and proved parity with the release round on a frame. The fork had costs: the final film mixes selects from at least 5 builds and no single build reproduces it, and one take depended on environment variables nobody recorded. Production disabled dev URL switches with a dev key stored only as a SHA-256 hash. Film fixes flowed back: the film's lightning became the game default (flat-white share 10.47% to 0.58%).
121
+ - **Invariant:** Capture hooks live in the shipping game's code, each off by default behind its own flag, change nothing while off, change nothing but what they declare while on, and are absent or locked in the public build.
122
+ - **Technique:** One flag per hook, listed in one file with what it does. No game code reads whether a hook is attached except through that declaration. A parity frame proves flags-off equals the release. Strip hooks at build time for the public build, or gate them behind a key whose secret is not in the bundle. Record the build hash and every flag a take used in the take's spec. Write each film fix as a flag the game can adopt.
123
+ - **Reference configuration:** OC added about 25-30 default-off hooks in a day, each diffable as a hooks list and a patch, versioned film builds by wasm hash with receipts, and proved parity with the release round on a frame. The fork had costs: the final film mixes selects from at least 5 builds and no single build reproduces it, and one take depended on environment variables nobody recorded. Production disabled dev URL switches with a dev key stored only as a SHA-256 hash. Film fixes flowed back: the film's lightning became the game default (flat-white share 10.47% to 0.58%). LC's engine skipped its frame-pacing rule whenever an after-frame hook was set, so every capture sat a different game from the owner's; `opengame-verification` has the rule.
100
124
  - **Applies when:** Every game with capture or test hooks and a public build.
101
125
  - **Verify:** Grep the public bundle for every hook name; open the public URL with each flag set and see no change; diff a flags-off frame from the capture build against the release.
102
126
 
@@ -1,7 +1,8 @@
1
1
  # Capture pipeline, audit and process
2
2
 
3
3
  Numbers from OC's launch film (a 62 s 4K60 trailer) and its gameplay montage, filmed on an
4
- M4 Max with 16 cores.
4
+ M4 Max with 16 cores, and from the test captures of OS, LC and OH, taken on shared Linux
5
+ machines with one GPU.
5
6
 
6
7
  ## Audit before planning shots
7
8
 
@@ -50,6 +51,32 @@ what is missing. OC's film team found most of these one at a time, mid-productio
50
51
  passed a cut whose first 402 frames were frozen, because two directors shared one
51
52
  minute-stamped work folder.
52
53
 
54
+ ## Test captures and judge packets
55
+
56
+ - Capture from a snapshot of the committed head plus your own files, never the shared
57
+ working tree. LC's slot tool read the tree when the slot was granted, not when the job
58
+ was queued, so an edit made during the wait killed jobs or filmed someone else's
59
+ half-written file.
60
+ - Write a manifest per packet: build hash, renderer string, quality, weather, camera per
61
+ frame, the state line, and whether each clip is stepped or real time. OH's judges scored
62
+ a missing clip, a mid-animation title and a stale capture as game faults, and OH's
63
+ rule became a manifest with no file older than the build.
64
+ - Generate the capture list from the rubric. OS's council scored more than 20 "gaps" that
65
+ were built items no camera showed.
66
+ - Space stills when the game settles UI after input: OS waited at least 1.2 s between
67
+ screenshots and A/B'd inside one boot, because "Numbers across boots move about 20 %".
68
+ - Software rasterisers prove function only. Refuse one for anything judged on looks or
69
+ timing, and print the adapter on every run (LC and OH both did).
70
+
71
+ ## Filming the interface with the scene
72
+
73
+ Stepped capture films the canvas. When a cut, a menu or a HUD change must be judged
74
+ against the scene at speed, LC ran a headed browser on the job's own virtual display and
75
+ grabbed it with `ffmpeg -f x11grab -framerate 60`, with a 6-pixel white corner mark that
76
+ changed every frame as the frame clock. It ran 34 fps at a load of 13 and 4-13 fps at
77
+ 35-54, so read it for order and offsets, never for frame time. It showed the DOM changing
78
+ 67-167 ms before the WebGPU picture.
79
+
53
80
  ## Contention
54
81
 
55
82
  Capture is the heaviest job on the machine, and it slows down when anything else runs.
@@ -66,6 +93,11 @@ Capture is the heaviest job on the machine, and it slows down when anything else
66
93
  10% other work only after more than 40 h of contention.
67
94
  - Private build trees as full disk clones cost about 26 GB for 3 flags. Keep a disk floor
68
95
  (OC's was 4 GB).
96
+ - Job slots do not govern the GPU. OH held two of six slots while another project's
97
+ headless browsers kept the card 14-100% busy, so every OH frame-time number is
98
+ contaminated. Record GPU load beside every frame number.
99
+ - On LC, at most three browsers fit in one slot (five lost the WebGPU device), and real-time
100
+ films on the loaded machine drew 8-25 fps, which is why motion is filmed stepped.
69
101
 
70
102
  ## Process with the game team
71
103
 
@@ -94,8 +94,24 @@ pixels with the drawing buffer size. Draw those points over the captured frame o
94
94
  target, or build a `VideoFrame` from the canvas right after rendering. If you configure the
95
95
  canvas context yourself, add `GPUTextureUsage.COPY_SRC` to its usage; OC read its swapchain
96
96
  with `copyTextureToBuffer` and `mapAsync` in 30.4 ms at 4K.
97
+ - Headless WebGPU: read the canvas with `canvas.toBlob()` in the same task that rendered
98
+ it, one copy per frame, and hand frames to the host in batches (LC returned 20 at a
99
+ time). On LC, `drawImage` of the WebGPU canvas into a 2D canvas, `captureStream()`, the
100
+ CDP screencast and `page.screenshot` all returned black (79 of 79), so prove the path on
101
+ one frame and check its mean before a batch:
102
+
103
+ ```js
104
+ async function captureFrame(dt) { // capture mode only, behind its flag
105
+ step(dt)
106
+ renderer.render(scene, camera) // the read below must be in this task
107
+ const blob = await new Promise((r) => renderer.domElement.toBlob(r, 'image/png'))
108
+ return blob // check the first one is not near black
109
+ }
110
+ ```
111
+
97
112
  - `canvas.captureStream(0)` with `track.requestFrame()` after each render feeds a
98
- `MediaRecorder`. Its timestamps are wall time, so use it for real-time previews only.
113
+ `MediaRecorder`. Its timestamps are wall time, so use it for real-time previews only,
114
+ and check it is not black on a WebGPU canvas.
99
115
  - Refuse a software rasteriser. WebGL: read `UNMASKED_RENDERER_WEBGL` through
100
116
  `WEBGL_debug_renderer_info` and stop on SwiftShader or llvmpipe. WebGPU: inspect
101
117
  `adapter.info`, including `isFallbackAdapter` where the browser reports it.
@@ -1,5 +1,20 @@
1
1
  # opengame-characters changelog
2
2
 
3
+ ## 1.2.1
4
+
5
+ A player's OG is missing for a guest, an account that has not made one, a preview and a signed-out player; there is no sharing setting to turn it off any more.
6
+
7
+ ## 1.2.0
8
+
9
+ What LC's photoreal body-camera shooter and OH's painterly rhythm game taught, merged
10
+ into OC's rules. New rules for a first-person body that is never see-through, captured
11
+ motion with IK only for contact, joint limits plus a natural band checked in the build,
12
+ holds copied from photographs of trained people, generated bodies measured against a
13
+ human, generated people ordered for skinning and rigged after preparation, and the OG
14
+ identity spec outranking art feedback. The skin rule now plays every clip on the
15
+ figure's own rig with a torn-edge audit, and feet are planted by distance travelled.
16
+ New reference: a first-person body and generated people.
17
+
3
18
  ## 1.1.0
4
19
 
5
20
  The player's OG is drawn from the SDK alone: `readAvatar`, `portraitUrl` for the head as
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  name: opengame-characters
3
- description: Bring generated or imported 3D characters into a browser game so they hold up in play. Covers skin checks against pinched waists, eased gait choice against third-person jitter, authored locomotion over procedural, thumb-and-mitten hands on the posed gun, canon sheets against drift, instant customisation, gated stages and real grips. Use when the character T-poses, jitters, bends wrong, feet slide, hands clip the gun, it drifts from the art, customising is slow, or a game shows the player's OG.
3
+ description: Bring generated or imported 3D characters into a browser game so they hold up in play. Covers clips audited on each figure's own rig, a first-person body never see-through, captured motion with IK only for contact, natural joint bands, holds from photographs, generated people, eased gaits and planted feet, mitten hands, canon sheets, instant customisation and the OG spec. Use when a character T-poses, tears, jitters, bends wrong, slides, clips the gun, drifts from the art, or shows an OG.
4
4
  metadata:
5
- version: "1.1.0"
5
+ version: "1.2.1"
6
6
  ---
7
7
 
8
8
  # Characters
@@ -10,19 +10,65 @@ metadata:
10
10
  A character is finished when it is right in the live spawn path, from the gameplay
11
11
  camera, while moving, including from behind. A model that loads, a rig that binds and
12
12
  a clip that plays are three separate facts, and none of them proves the visible
13
- character is correct.
13
+ character is correct. LC's owner raised the player's body, hands and holds more than
14
+ anything else, about 19 times; solver-posed arms were rejected three times in 17 hours,
15
+ and a joint check that read "0 faults" passed wrists the owner called inhuman.
14
16
 
15
17
  Rules carry five tags; `opengame-quality-bar` explains them and the game codes.
16
- Generation and Meshy specifics are in `opengame-assets`.
18
+ Generation and Meshy specifics are in `opengame-assets`. LC's first-person body, joint
19
+ limits and generated-people numbers are in
20
+ [references/first-person-body.md](references/first-person-body.md).
17
21
 
18
22
  ## Rules
19
23
 
20
- ### Bodies keep their volume in every clip
21
- - **Invariant:** No character or creature pinches, hourglasses, splits or bends wrong at the waist, hips, shoulders or neck in any clip, and this is checked when the asset is imported and again in motion.
22
- - **Technique:** At import, pose every clip offline and measure the posed waist width against the bind waist. Check that no thigh weight reaches above the hip or crosses to the other leg, that hoods and collars are not weighted into the head, that skirts and aprons follow the hips, that normals agree with face winding, and that left and right parts match. Spread twist over several torso bones. Then watch a turntable of every clip, because the numbers pass before the eye does.
23
- - **Reference configuration:** OC passes a waist at 0.95 or more of rest, and below 0.90 is a visible pinch. Two zombie types sat at 0.81 and 0.79; after reweighting all 20 heroes reached 0.957 or more and the zombies 0.97 to 0.99. A bind waist at 63 to 65% of hip depth reads as an hourglass even with good weights. One waist kept 65% of its width before the fix and 98% after; an apron weighted to the thighs filled the gap between the legs; a hook was weighted to the thigh instead of the hand; one shoe was 27% longer than its pair. The owner sent three messages in about 30 minutes ("we cant have that on any character or creature!"), and the defect was declared fixed by numbers while screenshots still showed it.
24
- - **Applies when:** Every skinned character or creature, generated or bought.
25
- - **Verify:** The import report lists the waist ratio per clip for every body, and a turntable of each clip in play shows no pinch.
24
+ ### Bodies keep their volume and their surface in every clip, on their own rig
25
+ - **Invariant:** No character or creature pinches, hourglasses, splits, tears or bends wrong at the waist, hips, shoulders or neck in any clip at any level of detail, every clip plays on the rig it was made or captured for, and this is checked when the asset is imported and again in motion.
26
+ - **Technique:** Auto-rig each generated figure and play library actions on that rig rather than retargeting onto a shared one. At import, pose every figure, clip and frame offline with the game's own skinning: measure the posed waist width against the bind waist, and count edges stretched or squeezed past a limit, listing failing clips and never playing them. Check that no thigh weight reaches above the hip or crosses to the other leg, that hoods and collars are not weighted into the head, that skirts and aprons follow the hips, that normals agree with face winding, and that left and right parts match. Spread twist over several torso bones. Then watch a turntable of every clip, because the numbers pass before the eye does.
27
+ - **Reference configuration:** OC passes a waist at 0.95 or more of rest, and below 0.90 is a visible pinch. Two zombie types sat at 0.81 and 0.79; after reweighting all 20 heroes reached 0.957 or more and the zombies 0.97 to 0.99. A bind waist at 63 to 65% of hip depth reads as an hourglass even with good weights. One waist kept 65% of its width before the fix and 98% after; an apron weighted to the thighs filled the gap between the legs; a hook was weighted to the thigh instead of the hand; one shoe was 27% longer than its pair. The owner sent three messages in about 30 minutes ("we cant have that on any character or creature!"), and the defect was declared fixed by numbers while screenshots still showed it. LC's shared rig with retargeted clips "failed every clip: 2 to 17% of the surface strained and edges pulled 40 to 150 times. That is what the owner saw." On each figure's own rig 572 of 572 clips passed, where torn means an edge over 3x or under 0.25x its bind length and a clip fails above 1% torn at any level of detail. Dual quaternion skinning measured worse (5.1% strained against 4.0%).
28
+ - **Applies when:** Every skinned character or creature, generated or bought, with a motion library.
29
+ - **Verify:** The import report lists the waist ratio and torn share per clip for every body, worst-frame sheets are opened large, and a turntable of each clip in play shows no pinch.
30
+
31
+ ### A generated body is measured against a human before it is animated
32
+ - **Invariant:** Every generated figure has human proportions at the size it fills the player's screen, a crowd's statures vary, and no weight stretches an edge past a limit over a joint's range.
33
+ - **Technique:** Print a proportions sheet per figure (stature, head, arm, upper arm against forearm, hand, wrist) and fix it before rigging. Vary stature across a crowd. Weight by a diffused field over a welded shell rather than by distance from the bone, and gate edge stretch per joint over its whole range. Judge figures in the game's light at arm's length.
34
+ - **Reference configuration:** LC's owner: "the characters and their meshes and zomebis are all fucked up and like dismorph and the way joins turn not all [photorealistic". Every zombie had stood exactly 1.80 m with heads 25 to 35% too big, the other soldier's arm was 26.1% of his height (a man's is 33.4%), and the hands were "0.132 x 0.075 m against a man's 0.095 x 0.03". After: stature 1.64 to 1.90 m, head 0.135 to 0.145 of height, arm 33%, upper arm 1.2x the forearm, wrist 0.55 of the forearm's width; edges over 2x at the hip went from 116 to 0, after "three rules by distance from the bone failed". OC's canon doc said 2.2 heads tall while its measured turnaround was 2.7 (below).
35
+ - **Applies when:** Every game using generated or bought humanoids. Stylised characters measure against their own canon sheet instead.
36
+ - **Verify:** The proportions sheet and worst-edge list per figure, and a lit sheet at arm's length.
37
+
38
+ ### Generated people are ordered for skinning, prepared, then rigged
39
+ - **Invariant:** Generated human figures arrive in a pose and outfit that rigging can handle, are reduced with their faces and hands intact, and are rigged only after that preparation, on the mesh the game ships.
40
+ - **Technique:** Ask for an A-pose with the arms held well out from the body, in close-fitting clothes, and look at the picture before paying for the mesh. Re-bake to a target triangle count with the head and hands dense, the head on its own texture sheet and its own reduction budget, and one unwrap shared by every level of detail. Rig the prepared mesh, never the raw one, and refuse a mesh that drifts from its rig's mesh. Long coats and capes fail on automatic rigs: avoid them or rig them by hand. Spend only with the person's own account and their yes on the cost (`opengame-assets`).
41
+ - **Reference configuration:** LC's dead cost about $2.44 to $2.66 a person with 27 actions: an A-pose concept, image-to-3D at 600k to 1M triangles, re-baked to about 11,500 (head share 0.27, hands 0.13) with levels at about 3,900 and 1,200 to 1,700, colour, normal and roughness at 2048, 2048 and 1024, and the head on its own 1024 sheet ("collapsing 700k triangles to 12k drags the texture across the raw atlas's seams"); the packer refuses a mesh more than 10 mm off its rig's mesh. One face had 18 triangles where it needed 400 ("the collapse spends the head's share on its curls"). OS gave its 52 generated OGs three levels of detail with an attribute-aware simplifier, since UV seams had locked plain simplification near 9k triangles.
42
+ - **Applies when:** Games using image-to-3D or text-to-3D humans.
43
+ - **Verify:** Every head sheet opened after preparation, and the deformation audit above passing on every clip.
44
+
45
+ ### The player's own body is never see-through
46
+ - **Invariant:** Every drawn part of the first-person body, clothing, gloves and weapon is opaque and whole at every reachable view angle.
47
+ - **Technique:** Keep parts away from the lens by pose, never by cutting geometry near the camera. Use a small near plane and no alpha test, dissolve, dither or near-fade on the player's own materials; make cloth closed and double-sided. Hide whole pieces (head, neck), never triangles. Keep post effects off anything very close to the lens. Hide the third-person body rather than shrink it. When something looks wrong close up, check whether the camera is inside a part.
48
+ - **Reference configuration:** LC's owner: "u shouldnt be ablet o see through ur body parts..." with two screenshots. A near-lens cut on every operator material dropped geometry within 7 to 20 cm of the lens, which sits on the chest, so the torso became a ring of ragged shards around a hole and the sleeves blades. After: a near plane of about 2.5 cm, post effects that skip anything within 1.2 m of the lens, and a playtest that saw no see-through frame at any angle. A "pale lining" on a sleeve was the camera inside the sleeve for 67% of the picture. OC's shrunken first-person head and arms spread white shards under the camera (below).
49
+ - **Applies when:** First person with a visible body.
50
+ - **Verify:** Scripted looks down, left, right and up, aiming, reloading and sprinting; a mask of the player's own materials fails on any alpha below 1.
51
+
52
+ ### Captured motion drives the body, and IK only makes contact
53
+ - **Invariant:** A first-person or armed body moves from captured motion on a whole rigged body; solvers only close hands and feet onto what they touch; and when a target cannot be reached within the joint limits, the held object moves, never the anatomy.
54
+ - **Technique:** Rig a whole body (legs, trunk, arms) with a third-person debug view, even when the player sees only arms. Drive stance, gait and reloads from captured clips blended by speed and gait, turn the chest to the aim, and let IK finish the grip with the elbow placed a set share of the way from hanging toward the captured elbow. Never solve an arm by the shortest arc from rest; give the forearm twist joints so it carries part of the hand's roll. Fix a bent wrist by moving the elbow, not the hand. Pick library clips from previews, not their names.
55
+ - **Reference configuration:** LC's owner: "why are the hands bent and look so fucking weird ... u also should have a body not just floating arms and hands... with legs body etc." Solver-only holds were rejected three times in 17 hours, and the rule written after the second was "motion capture drives the body, the solver only finishes the hands". Its operator has 22 joints and 32 captured clips, with two-bone arm IK and the elbow a third of the way from hanging toward the captured elbow: "the weapon moves, never the anatomy". Shortest-arc solves had wrung the forearm 36 degrees at the ready, 61 on the sights and 105 at one support elbow; ten twist joints per sleeve, the forearm carrying 0.6 of the hand's roll, took ring twist from 24 to 12 degrees. Five hand placements left a wrist at 23 to 44 degrees; moving the elbow under it gave 9 to 22. OS: a clip named "Chest Pound Taunt" was a sword taunt.
56
+ - **Applies when:** First-person arms and bodies, and any armed character.
57
+ - **Verify:** A third-person film of every weapon and state beside reference photographs, and the joint sweep in the next rule.
58
+
59
+ ### Joints stay inside natural bands, checked in the build
60
+ - **Invariant:** Wrists, elbows, shoulders and knees stay inside human limits on every frame of every hold, action and change between two, and inside a narrower natural band at rest and on the sights; a frame that leaves either raises an error in the build.
61
+ - **Technique:** Give every visible joint two gates, the impossible limit and a natural band for rest and aim, and check both per frame in the running build with a console error. Sweep every weapon and state while the joints are visible. Bound the natural, not only the impossible: a hold that passes "possible" can still read as wrong. Measure on the game's own rig.
62
+ - **Reference configuration:** LC's limits were a wrist about 70 degrees back, 80 forward and 20 to 30 to the side, later flexion 80, extension 70, radial 25, ulnar 40 and twist 85; the natural band is 20 degrees either way at rest and on the sights. Its check read "0 joint faults over 1,825 arm-states" and a playtest called it fixed, then the owner: "hands also still look fucked up holding the gun and pistol both hands just are angled not photorealistic and humanly". Wrists at 67 to 78 degrees had passed the first check's limit near 95, and the natural band came too late. Later, "when u ads and move aronud ur elbow and forearm like swivle out randomly ... u cant have weird angles of hands or arms etc anywhere"; one wrist's side-bend went from 51 to 22 degrees after about ten mends. A forearm twist weight of 0.5 (0.65 left a ring at the cuff) and a wrist cross-section never under 0.85 of rest kept the cuff whole.
63
+ - **Applies when:** First-person arms, and any armed or close-up character.
64
+ - **Verify:** A sweep of every weapon and state with a per-joint table against both gates, and a third-person film.
65
+
66
+ ### Holds are copied from photographs of trained people
67
+ - **Invariant:** How a character holds, aims, moves with and reloads a weapon or tool is copied from photographs and footage of trained people doing it, with one grip and one elbow place per hold, never invented or taken from generated pictures.
68
+ - **Technique:** Collect real photographs per weapon class and stance (rest, ready, aim, reload) before posing, and pose beside them. Use generated pictures for mood only. Keep one grip and one elbow place per hold, so the grip does not shift as the look moves. Set handedness once. Begin and end every action with a hand travelling, eased, so nothing appears or vanishes. Judge from the player's own picture at speed.
69
+ - **Reference configuration:** LC's first owner screenshot was a crop of the director's own composite, praised ten minutes earlier: a glove splayed flat on top of the fore-end, no firing hand, no shoulder. The owner: "thats nt how someone holds a gun this looks very unnatural and how u hold it and move wiht it and zoom in and out and all that stuff needs to be perfect and look photorealistic and how a real soldier would hold". Then "how come as u look further down where u grip the gun changes?.." (one grip per hold since), and "rn the gun is pointed from left to right idle i think it should be opposite to be realistic no?" (right-handed, the firing forearm from the lower right). A reload where the arm "randomly goes away" became a hand travel of about a third of a second in and out, and that pistol reload was the one explicit acceptance in the record. A library of eight grip poses arrived at the end and went unused.
70
+ - **Applies when:** Any character that holds a weapon or tool, in first or third person.
71
+ - **Verify:** A sheet per weapon class, photograph beside build at the same angle, at rest, ready, aimed and mid-reload.
26
72
 
27
73
  ### No pose weight ever changes in one frame
28
74
  - **Invariant:** Gait choice, direction switches and layer weights ease over time, so a third-person body never pops, flips or jitters while running, strafing, stopping or idling.
@@ -33,16 +79,23 @@ Generation and Meshy specifics are in `opengame-assets`.
33
79
 
34
80
  ### Locomotion is authored; procedural motion is a small layer
35
81
  - **Invariant:** Walking, running, idling and actions come from authored or captured clips blended by speed, with feet planted and legs still at idle; procedural passes add small corrections on top and never replace a limb's pose.
36
- - **Technique:** Buy or capture a locomotion set before writing procedural legs or arms. Blend clips by measured speed with matched phase, set cadence from distance travelled, and fix bad channels in the clip data at the source. Audit each procedural pass by turning it off and comparing.
37
- - **Reference configuration:** OC: mocap clips at walk 1.4, jog 3.4, run 4.8 and sprint 6.2 m/s, crossfades of at least 0.15 s; 40 clips cost about $2.40. Cadence by distance (1.05 m per walking cycle) cut foot skate from 84% to 30%. The "mannequin arms" the owner disliked came from a procedural arm pass that pulled the arms level. A knee and foot channel swap was fixed in 11 clips at the source. The owner asked 7 to 10 times, including "not even moving and my characters legs are moving".
82
+ - **Technique:** Buy or capture a locomotion set before writing procedural legs or arms. Blend clips by measured speed with matched phase, set cadence from distance travelled, and fix bad channels in the clip data at the source. Audit each procedural pass by turning it off and comparing. Library clips fail on sight more often than not: pick and trim them from side and front contact sheets before they reach the game.
83
+ - **Reference configuration:** OC: mocap clips at walk 1.4, jog 3.4, run 4.8 and sprint 6.2 m/s, crossfades of at least 0.15 s; 40 clips cost about $2.40. Cadence by distance (1.05 m per walking cycle) cut foot skate from 84% to 30%. The "mannequin arms" the owner disliked came from a procedural arm pass that pulled the arms level. A knee and foot channel swap was fixed in 11 clips at the source. The owner asked 7 to 10 times, including "not even moving and my characters legs are moving". LC's library gave a knockdown that back-flips, a side-walk sliding 18 mm a frame, deaths that kneel or kick and a lunge that turns its back.
38
84
  - **Applies when:** Every walking character. A stylised procedural walk is a style choice, made once and checked against the concept.
39
85
  - **Verify:** Stand still, walk, run and sprint in play and record the feet: planted feet do not slide and idle legs do not move. Turn each procedural layer off and confirm the base clip already reads right.
40
86
 
87
+ ### Gaits blend by phase, and feet are planted by distance travelled
88
+ - **Invariant:** Feet do not slide or pop: transitions blend, a new gait starts where the old one's feet were, stride phase follows the ground covered, a planted foot stays put heel then toe, and steps match the ground at every speed and on slopes.
89
+ - **Technique:** Crossfade every transition, starting the new clip at the old clip's normalised phase. Advance stride phase by metres travelled over stride length, or set playback rate from displacement after collision divided by stride over clip length, clamped per clip. Lock a foot while its heel is down, then its toe; step a foot home when it is left far out; sample the ground ahead for the swinging foot. Scale a first-person figure so the camera height is its own. Pick the gait from measured motion relative to facing, not from the key pressed, and gate it against a table of how people walk.
90
+ - **Reference configuration:** SR and MC crossfade 0.14 to 0.16 s, ladders and mantles 0.22 to 0.30 s. Gait thresholds walk above 0.4 m/s and run above 6 m/s. DK varies each actor's idle speed (0.55 + (id % 7) * 0.04) so a horde never moves in lockstep. OC crossfades in at least 0.15 s at a matched phase and sets `timeScale` from velocity. LC's owner: "ur legs/feet positoin and hwo they move while u walk and run is very unnatural and not aaa". Its operator had slid planted feet 21 to 38 mm a frame walking, 66 to 130 sprinting and 255 mm in one frame stopping; after, under 5 mm a frame, heel first, 0.95 to 1.01 m steps at 2.9 a second, the figure scaled to 1.70 m. Its person table: knee 0 to 5 degrees at heel strike, about 15 loading, 60 in swing; hip bob 4 cm walking, 6 to 10 running.
91
+ - **Applies when:** Every walking character, including a first-person body seen looking down.
92
+ - **Verify:** Record feet against the ground at slow, normal and sprint speed, against a wall, on stairs and through a stop; per-frame slide stays under the game's bar while planted.
93
+
41
94
  ### Hands are a thumb and a mitten, fixed to the posed gun
42
- - **Invariant:** First-person and held-item hands are simple closed shapes that rig and pose easily, attach to the item's posed transform, never pass into it, and never cover the sight.
43
- - **Technique:** Model the hand as a thumb plus a single mitten body, cuff-wide, as one closed mesh, unless the game's style needs fingers. Parent it to the gun's posed transform, not the unposed one. Test penetration numerically per reload phase (`opengame-weapons` has the check) and keep sleeves from stretching to reach.
44
- - **Reference configuration:** The owner on OC: "basically a thumb and then a blob for hands ... It should be easier to then rig it and animate it with the guns versus having five fingers", and later "We don't need five fingers. If anything you just need a thumb". Before that it took 4 first-person passes and 5 glove redesigns. OC's sleeves are about 0.17 m across. A hold constant stretched sleeves 16%; a glove covered 35% of one gun's aimed centre.
45
- - **Applies when:** First-person games and any character holding tools, unless the art style calls for articulated fingers.
95
+ - **Invariant:** First-person and held-item hands are simple closed shapes that rig and pose easily, attach to the item's posed transform, never pass into it, and never cover the sight, unless the game's style needs fingers.
96
+ - **Technique:** Model the hand as a thumb plus a single mitten body, cuff-wide, as one closed mesh. Parent it to the gun's posed transform, not the unposed one. Test penetration numerically per reload phase (`opengame-weapons` has the check) and keep sleeves from stretching to reach. When the style is photoreal, build five-finger gloves and solve each finger onto the grip, which is the larger job.
97
+ - **Reference configuration:** The owner on OC: "basically a thumb and then a blob for hands ... It should be easier to then rig it and animate it with the guns versus having five fingers", and later "We don't need five fingers. If anything you just need a thumb". Before that it took 4 first-person passes and 5 glove redesigns. OC's sleeves are about 0.17 m across; a hold constant stretched them 16%; a glove covered 35% of one gun's aimed centre. OS's owner settled on "glvoe/mit style hands" after about 20 notes and 45 to 60 discarded finger builds, then ended the work: "im fine with the fists/hands view as is". LC's photoreal style needed scripted five-finger gloves and a finger solver held to 1.5 mm (`opengame-weapons`).
98
+ - **Applies when:** First-person games and any character holding tools.
46
99
  - **Verify:** Capture hip, aimed and every reload for each gun; measure penetration and the covered share of the aimed centre.
47
100
 
48
101
  ### One canon sheet per character stops drift
@@ -62,59 +115,59 @@ Generation and Meshy specifics are in `opengame-assets`.
62
115
  ### Gate every stage
63
116
  - **Invariant:** Each stage of a character (reference, mesh, remesh, rig, skin check, clips, sockets, play) is inspected and passed before the next one is paid for.
64
117
  - **Technique:** Keep a short stage list per character with the evidence for each: the reference image, a turntable of the mesh, the polygon count after remesh, a rest-pose capture of the rig, a stretch pose for skinning, each clip looped three times, each socket with its equipment, and a capture in play.
65
- - **Reference configuration:** ST gates characters this way, and MC found that two soldiers generated with identical parameters came back at different quality, so each one is checked rather than assumed.
118
+ - **Reference configuration:** ST gates characters this way, and MC found that two soldiers generated with identical parameters came back at different quality, so each one is checked rather than assumed. LC checked the concept picture before paying for each mesh and opened every head sheet after preparation.
66
119
  - **Applies when:** Every generated or imported rigged character.
67
120
  - **Verify:** The stage list has evidence for every stage of every character in the game.
68
121
 
69
122
  ### Pilot two bodies before making many
70
123
  - **Invariant:** The pipeline is proven on two anatomically different characters before it runs for the rest.
71
124
  - **Technique:** Pick the two most different bodies the game needs (a heavy and a slight one, a biped and a creature) and take both all the way to play first. Rigs from one generator are not interchangeable; budget a per-character solve for stances, grips and contact.
72
- - **Reference configuration:** ST pilots two before forty. MC found its generator's rigs were not interchangeable between soldiers and that stance correction was a third per-soldier solve.
125
+ - **Reference configuration:** ST pilots two before forty. MC found its generator's rigs were not interchangeable between soldiers and that stance correction was a third per-soldier solve. LC's own-rig audit was proven on 14 people and 405 clips before it covered 21 people and 572 clips.
73
126
  - **Applies when:** Any game with more than a couple of characters.
74
127
  - **Verify:** Both pilots pass every gate in play before a batch is started.
75
128
 
76
129
  ### No T-poses, no primitive stand-ins
77
130
  - **Invariant:** No character is ever seen in its bind pose, and nothing a character holds is a primitive.
78
- - **Technique:** Start every character in an idle clip before its first render; give held items their own models with grip markers. A missing clip falls back to idle, never to the bind pose.
79
- - **Reference configuration:** Our originals require a rig and at minimum idle, locomotion and the game's one signature action on every character mesh. ST's review fails a T-pose anywhere.
131
+ - **Technique:** Start every character in an idle clip before its first render; give held items their own models with grip markers. A missing clip falls back to idle, never to the bind pose. Raise an error in the build when a figure is seen in its rest pose.
132
+ - **Reference configuration:** Our originals require a rig and at minimum idle, locomotion and the game's one signature action on every character mesh. ST's review fails a T-pose anywhere. LC's owner saw its dead "just go t pose when they die"; its build now logs an error on any rest pose (`opengame-enemies`).
80
133
  - **Applies when:** Every game with characters.
81
- - **Verify:** Capture every character on its first visible frame after spawn and after a respawn.
134
+ - **Verify:** Capture every character on its first visible frame after spawn, after a respawn and after a death.
82
135
 
83
136
  ### One owner of movement
84
137
  - **Invariant:** The controller moves the character's root through the world; animation never moves it, so the body, the collision capsule and the equipment stay together.
85
- - **Technique:** Strip net horizontal travel from locomotion clips while keeping bob and sway, normalise rest height and forward once, and use a positive uniform scale on animated ancestors. Correct gait clips only, never actions, jumps or deaths.
86
- - **Reference configuration:** AW rebases the hips of its mocap; ST's `prepareLocomotionClip` removes travel and checks three loops for drift. SR's death clip moves the hips more than two metres, so SR samples it once to set a conservative bound and culling stays on.
138
+ - **Technique:** Strip net horizontal travel from locomotion clips while keeping bob and sway, normalise rest height and forward once, and use a positive uniform scale on animated ancestors. Correct gait clips only, never actions, jumps or deaths. Strip root motion from additive hit reactions too.
139
+ - **Reference configuration:** AW rebases the hips of its mocap; ST's `prepareLocomotionClip` removes travel and checks three loops for drift. SR's death clip moves the hips more than two metres, so SR samples it once to set a conservative bound and culling stays on. LC's additive hit clips carried up to 84 cm of root motion, so struck figures slid sideways and snapped back (`opengame-enemies`).
87
140
  - **Applies when:** Every animated character driven by a controller.
88
141
  - **Verify:** Loop each gait three times in place: no drift, no snap at the loop, no separation from the capsule.
89
142
 
90
- ### Gaits blend by phase and speed
91
- - **Invariant:** Feet do not slide or pop: transitions blend, a new gait starts where the old one's feet were, and playback speed matches ground speed.
92
- - **Technique:** Crossfade every transition, starting the new clip at the old clip's normalised phase. Set playback rate from displacement after collision, divided by stride over clip length, clamped per clip. Pick the gait from measured motion relative to facing, not from the key pressed.
93
- - **Reference configuration:** SR and MC crossfade 0.14 to 0.16 s, ladders and mantles 0.22 to 0.30 s. Gait thresholds walk above 0.4 m/s and run above 6 m/s. DK varies each actor's idle speed (0.55 + (id % 7) * 0.04) so a horde never moves in lockstep. OC crossfades in at least 0.15 s at a matched phase and sets `timeScale` from velocity.
94
- - **Applies when:** Every walking character.
95
- - **Verify:** Record feet against the ground at slow, normal and sprint speed, against a wall and on stairs; no foot moves while planted.
96
-
97
143
  ### Hands hold the real grip
98
144
  - **Invariant:** A held weapon or tool follows the animated body, both hands sit on its real grips through movement, aim, recoil and reload, and the shot leaves from its real muzzle.
99
- - **Technique:** Attach rigid equipment to a bone with the inverse of the bone's rest transform so it keeps its fitted pose. Author grip and muzzle markers on the actual model, animate a pivot rather than the frozen carry matrix, then solve each arm as a two-bone chain to its grip with a stable elbow pole, clamping unreachable targets rather than stretching.
100
- - **Reference configuration:** MC's weapon IK, AW's hand-on-weapon validator, SR's weapon mount and DK's gear attachment by inverse rest matrix. SR validated 540 hand-grip poses across four outfits and every weapon. OC's default IK pole gave a 52 degree elbow where 17 to 18 was the target, and its third-person gun canted left twice.
145
+ - **Technique:** Attach rigid equipment to a bone with the inverse of the bone's rest transform so it keeps its fitted pose. Author grip and muzzle markers on the actual model, animate a pivot rather than the frozen carry matrix, then close each arm onto its grip as a two-bone chain over the captured pose, with a stable elbow pole, inside the joint bands; when a grip is out of reach, move the weapon, never stretch the arm.
146
+ - **Reference configuration:** MC's weapon IK, AW's hand-on-weapon validator, SR's weapon mount and DK's gear attachment by inverse rest matrix. SR validated 540 hand-grip poses across four outfits and every weapon. OC's default IK pole gave a 52 degree elbow where 17 to 18 was the target, and its third-person gun canted left twice. LC's finger solve passes at 1.5 mm counted over every vertex on the game's own rig (`opengame-weapons`).
101
147
  - **Applies when:** Characters that hold things, in third person or in any view that shows them from outside.
102
148
  - **Verify:** Capture both palms against the grips at several aim angles and through a reload; muzzle flash and shot origin coincide.
103
149
 
104
- ### Judge from the gameplay camera
105
- - **Invariant:** A character is accepted on how it looks in play, from the camera the player uses, from every side the player sees.
106
- - **Technique:** Capture rest, movement, the signature action and its return, from the gameplay camera, including rear views, and compare against the concept at the same camera. Judge motion as a frame sequence, not a still.
107
- - **Reference configuration:** ST compares player-camera captures with the selected concept and sends actual pixels to an adversarial reviewer; SR's character review lists native shoulder-camera appearance as outstanding until it is seen in play. OC's third-person gun was "hidden behind the body in every follow view"; the owner asked to see the hold "in EVERY camera hangle".
150
+ ### Judge from the gameplay camera, and from every camera that sees the body
151
+ - **Invariant:** A character is accepted on how it looks in play, from the camera the player uses and from every side the player sees, including how other players see the same body doing the same action.
152
+ - **Technique:** Capture rest, movement, the signature action and its return, from the gameplay camera, including rear views, and compare against the concept at the same camera. For a player body, also film it from outside as a teammate or rival sees it, with every first-person action expressed in the body's own frame. Judge motion as a frame sequence at a quarter speed and then at speed, not as a still.
153
+ - **Reference configuration:** ST compares player-camera captures with the selected concept and sends actual pixels to an adversarial reviewer; SR's character review lists native shoulder-camera appearance as outstanding until it is seen in play. OC's third-person gun was "hidden behind the body in every follow view"; the owner asked to see the hold "in EVERY camera hangle". LC's owner: "continue making sure that multiplayer how u see other soldiers/players is perfect with whatever movement and animation they are doing should look like a real person"; its co-op friend is the player's own figure, whole.
108
154
  - **Applies when:** Every game with characters.
109
- - **Verify:** A reviewer with fresh context passes the captures, rear views included.
155
+ - **Verify:** A reviewer with fresh context passes the captures, rear and outside views included.
110
156
 
111
157
  ### Fair bodies and fair budgets
112
158
  - **Invariant:** Hitboxes are fair across characters, and every character fits the game's frame budget.
113
159
  - **Technique:** Normalise heights so a tall character is not easier to hit, keep the hit capsule independent of cosmetic equipment, set polygon counts before rigging, and share geometry and materials across instances. Clone skinned characters with `SkeletonUtils.clone` so each owns its bones.
114
- - **Reference configuration:** ST budgets 150k triangles per character and 30k per prop. MC sets a 22,000 target before rigging so its rig does not bind to a mesh that is later remeshed. SR's four outfits add 1,140 to 1,320 triangles each and one mesh per actor without changing the hit capsule.
160
+ - **Reference configuration:** ST budgets 150k triangles per character and 30k per prop. MC sets a 22,000 target before rigging so its rig does not bind to a mesh that is later remeshed. SR's four outfits add 1,140 to 1,320 triangles each and one mesh per actor without changing the hit capsule. LC's co-op friend is 28,994 triangles with levels of detail under 12 m and from 12 to 40 m.
115
161
  - **Applies when:** Games with several characters on screen, competitive games above all.
116
162
  - **Verify:** Read triangle counts and draw calls with the busiest crowd on screen; compare hit capsules across characters.
117
163
 
164
+ ### The OG identity spec outranks art feedback
165
+ - **Invariant:** Wherever a game draws OpenGame avatars, each keeps what the SDK's spec lists under "What makes it an OG" (a big head in its own colour, a face made of eyes, mittens with a thumb, the outfit as chosen), a player's SDK avatar replaces the default, a crowd is generated rather than taken from other players, and no art pass, judge or critic removes any of it.
166
+ - **Technique:** Vendor the SDK's model and spec unchanged with a provenance note, split the figure into rigid parts, and read recipes live (next rule). Put the spec in every brief and every judge's rubric. Measure the head's share through the real game lens at play size, not on the model. Seed generated crowd members per place, with a test that forbids the features the spec leaves out. Ease crowd members aside rather than culling them. The spec covers OGs only; it does not license restyling other characters to match.
167
+ - **Reference configuration:** OH: "also where did our OGs go?... the og sdk identity stuff characters [screenshot] we need to keep those", after judge-driven passes had added a mouth and brows and made the crowd faceless, seven passes before the spec reached them; one later pass removed the thumbs and the next restored them. "also default og color should be white not orange" and "when someone brings their og/avatar throuhg the opengame sdk ofc it should be their colors"; the white head took nine passes to land on plain white. OH's figure has 16 parts; a face test over 40 seeds x 20 members forbids mouths, noses, brows and beards in its generated crowd; a head built at 51% of height read at 41 to 44% through the lens, against the spec's about 40%; 12 to 16 members per place, where culling had once left 3 to 7. OS went the other way once: a concept agent forced white mittens on first-person gloves "to match the OG character canon" after its owner had called white blob hands slop.
168
+ - **Applies when:** Any game drawing OpenGame avatars, as the player's OG or as a crowd.
169
+ - **Verify:** The face test; three recipes at play size after every art pass; the head share as seen, and the members per side per place.
170
+
118
171
  ### The player's OG is theirs, read fresh and never kept
119
172
  - **Invariant:** A game that offers the player's OpenGame OG builds it from `og.player.avatar` each session, never stores it or anything built from it, asks for it or relays it to other players, falls back to its own default for anything missing or unknown, and shows the same OG as "Your OG" in every scene and point of view.
120
173
  - **Technique:** Remembering that the player picked "Your OG" is fine; the recipe is not. Read it through `watchAvatar` from `@opengamehq/sdk/avatar`, which names the parts with the shared layout (`readAvatar` does the same for one recipe); never split the recipe by position. Map each part through the game's own table with a default per part, and draw it to `AVATAR-SPEC.md` in the SDK package, or start from the SDK's Three.js example in `examples/avatar-threejs`. For a menu, a scoreboard or a 2D game, `portraitUrl(avatar)` gives the head as OpenGame draws it. Start building the model off the main thread as soon as the SDK names the player, under the loading screen, and import it only in menus. List "Your OG" first, labelled, equipped once loaded, removed after sign-out. Give first person separate sleeves and hands in the same colors as the third-person OG rather than a shrunken body, keep a shoulder camera's OG to one side, give every OG the same hitbox in competitive play, and light menus separately from the level. The recipe format, the portrait, the 21-joint contract, the page-bake pattern and each view's settings are in [references/player-og.md](references/player-og.md).
@@ -126,4 +179,6 @@ Generation and Meshy specifics are in `opengame-assets`.
126
179
 
127
180
  Meshy's rig skeleton, animation library and the traps MC hit integrating them are in
128
181
  `opengame-assets`. Root-motion, carry-frame, grip, skin-check, eased gait and customise-pool code sketches:
129
- [references/integration.md](references/integration.md).
182
+ [references/integration.md](references/integration.md). LC's chest-camera body, joint
183
+ limits, foot planting and generated-people pipeline:
184
+ [references/first-person-body.md](references/first-person-body.md).