@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
@@ -0,0 +1,244 @@
1
+ # Filmable: making any game shoot like a film set
2
+
3
+ A trailer or montage at the bar is not screen-recorded. It is **shot**: the game is frozen, forked into a
4
+ capture-only film build, driven frame by frame by a script, and rendered offline at the master resolution with an
5
+ exact clock. Slow motion is then real, cameras are exact, the HUD is whatever the shot needs, and a take reshoots in
6
+ about a minute. OG Clash did this to a C/WebAssembly WebGPU game in about three hours on day one (a capture probe in
7
+ 31 minutes, the film build in 1 h 50 min and the rig in 64 minutes, in parallel). OG Clash's raw gameplay montage reused
8
+ the rig on a newer build in about an hour, and the OG Snipers montage had its film build and rig ready in 2 h 14 min.
9
+
10
+ `opengame-capture` holds the rules for the hooks themselves, inside the game: one host-stepped clock, one time scale,
11
+ seeds, a director camera with a cut, a clean feed, a ready state, frame-addressed requests, a probe, stepped audio,
12
+ readback, and hooks kept out of public builds. If you own the game, build them in. This chapter is the film side: what
13
+ to find out, how to fork, how to drive the capture, how to turn takes into selects, and what went wrong.
14
+
15
+ ## 0. Study the game first (parallel, read-only, about 20-30 minutes)
16
+
17
+ Before planning any shot, write two documents with research agents, every claim backed by a file and line:
18
+
19
+ - **`research/GAME.md`, the game bible for a director:** the pitch in the game's own words; the core loop end to end
20
+ with every set piece's timing; every weapon, ability and upgrade path; characters, enemies, boss phases; which voice
21
+ lines ship as audio and which are subtitle-only; the map with a coordinate convention and its ten most cinematic
22
+ places; lighting and time of day; the game's own cinematic cameras (their distances and fields of view are free
23
+ starting points); brand assets (logo lockup, key art, palette, fonts, logo sounds); and **known risks that would hurt
24
+ footage** (crashes, stuck AI, bad animations, stand-in models, build text on screen, developer shortcuts that skip
25
+ set pieces).
26
+ - **`research/CAPTURE.md`, the capability map:** the checklist below, answered for this game, plus one short real probe.
27
+
28
+ Mine the developers' own history: playtest verdicts, rejected looks, critical comments in code ("this optic looks
29
+ terrible"), acceptance ledgers, existing recorders, camera presets and capture specs. It is the cheapest source of
30
+ "what looks bad", and it usually has half a rig already.
31
+
32
+ **Reading the source over-promises.** OG Clash's research listed flips, dances and the victory pose as "would look
33
+ good on camera"; the on-frame audit graded nearly all of them NO. Plan nothing around an animation, behaviour or effect
34
+ until it has been **seen on rendered frames**. NOT REPRODUCED means not plannable.
35
+
36
+ ## 1. The capability checklist (settle every line before writing shots)
37
+
38
+ | # | Capability | What to establish |
39
+ |---|---|---|
40
+ | C1 | Frozen build | exactly which build players get; its hash; whether you can rebuild it privately and how long that takes |
41
+ | C2 | Command bridge | how to set game state from outside at run time and per frame (console, variables, URL parameters, developer switches, a debug socket) |
42
+ | C3 | Deterministic clock | whether each rendered frame can advance game time by exactly 1/60 s regardless of wall time |
43
+ | C4 | Time scale | whole-world slow motion with exact output frames; ramps inside a take |
44
+ | C5 | Fixed-rate traps | every fixed-timestep system without interpolation, frame-count throttles, per-frame emitters, time-quantised flicker, the motion-blur shutter, and **hitstop, hit-pause and freeze-frame timers on raw time** |
45
+ | C6 | Free camera | position, look, field of view and roll per frame; a hard cut that resets temporal history (TAA, motion vectors) |
46
+ | C7 | HUD mask | all, none, or per element (hit markers, pops, crosshair, points), subtitles, set-piece letterbox, debug and frame-rate overlays |
47
+ | C8 | Staging | spawn enemies at set points, times, types and gaits; hold spawns; place, aim, fire and emote friendlies; boss phase and attack; give weapons, upgrades, finishes; a skilled aim helper |
48
+ | C9 | Per-frame probe | where every actor, joint and weak point is on each frame, to aim cameras and verify payoffs. **Check it against rendered frames on day one** (OG Clash's boss joints were 10-13 m off the drawn model) |
49
+ | C10 | Quality lock | native internal resolution, the top preset locked (not calibrating), dynamic resolution off, LODs settled, accessibility "reduce flashing / shake" set to full strength |
50
+ | C11 | Readback and encode | exact-frame pixels at speed, colour-correct (BT.709) |
51
+ | C12 | Audio | engine audio captured at the simulation rate (re-aligned in the edit) or rebuilt from the game's own files; in-game music and voice muted at capture |
52
+ | C13 | Repeatability | whether takes repeat bit for bit, and which systems seed from the wall clock (weather, sky, lightning, voice picks) |
53
+ | C14 | Robustness | crash classes, safe take length, retries, watchdogs |
54
+ | C15 | Animation audit | which character and enemy clips survive a trailer frame |
55
+ | C16 | Hero tableaux | seated, celebration and idle poses worth filming, and whether they can run in gameplay |
56
+ | C17 | World switches | time of day, weather, phase skies, set-piece triggers, hiding markers and telegraphs |
57
+ | C18 | Boot gates | press-to-start, install cards, audio unlock, focus or pointer-lock pause, service workers, required headers |
58
+ | C19 | Prior art | the developers' recorders, camera presets, capture specs, QA ledgers |
59
+
60
+ Write each blocker as a **film-build hook to add, off by default**.
61
+
62
+ ## 2. Freeze the build, fork a film build
63
+
64
+ - **Freeze** a named, hashed build of the game and clone its release and source (a copy-on-write clone if your file
65
+ system has one). The game keeps shipping past it; the film never blocks the game. Tell the game team so in writing.
66
+ - **Play the frozen build before planning on it.** OG Clash's "stable" build receipt said its runtime was untested, and
67
+ it had two crash classes.
68
+ - **The film build** is a private copy of the frozen source with capture-only hooks behind flags in their own namespace.
69
+ **Every default equals the frozen build,** proven with a parity frame (the PSNR of the film build's frame against
70
+ the frozen build's, within the frozen build's own run-to-run variance).
71
+ - **Decide with the owner up front** whether the film may show improved but unshipped visuals. OG Clash started with
72
+ "camera, capture and staging only, never change the look" and ended rewriting its lightning (later the game's
73
+ default), gore scale, crate paint and a boss eye. That was right, but it should be a stated policy: every look change
74
+ behind a named flag with A/B evidence, routed back to the game team as a patch.
75
+ - **One owner** merges and deploys the film build; others send patches from private clones. Deploys are atomic (stage,
76
+ then rename), named by hash, the previous binary kept for rollback, with a hooks-file section and a defaults A/B frame
77
+ per deploy and an announcement line in the progress log. Selects record the build hash.
78
+ - **Write film fixes so the game can adopt them:** no globals, sizes relative to resolution, bounded pools with overflow
79
+ counters, tested at gameplay frame rates and full load. The game team had to harden OG Clash's lightning patch before
80
+ shipping it as their default.
81
+ - **Shader and data cooks:** a code build may not recompile shaders or recook assets. Check the cooked asset contains
82
+ the change.
83
+
84
+ ### The hook catalogue to ask for (any engine)
85
+
86
+ 1. **HUD mask** per element, no subtitles, no set-piece letterbox. Hit markers and pops project from the player's camera,
87
+ so they only line up on first-person shots.
88
+ 2. **Stage camera:** position, look, field of view, roll and near plane per frame; a **cut** that resets temporal history
89
+ and zeroes that frame's motion blur (without it a camera jump smears the whole frame); a **body** switch that draws
90
+ the third-person body and world weapon under a free camera instead of a floating first-person arm.
91
+ 3. **Slow-motion-safe simulation:** ragdolls and fixed-rate systems stepped on frame time; **no hitstop** (zero hit-pause
92
+ and freeze-frame juice) for shooters; short animations re-timed to span the slow window. Fighting and action games
93
+ keep their hitstop and re-time it instead (`opengame-montage-plan` explains).
94
+ 4. **Shutter:** motion blur proportional to the step (blur = frame rate × step) for a constant 180° look.
95
+ 5. **Depth of field:** usually usable, not premium; off by default, never on the subject.
96
+ 6. **Staging** of friendlies and NPCs: keep, pose, target, fire (visual only), emote, sit, flip.
97
+ 7. **Cinematic aim assist:** two cascaded critically damped springs (ω = 2.5 / aim time), a sticky target, the target's
98
+ angular rate fed forward, the head low-passed over 25 ms, so first person looks like a skilled human.
99
+ 8. **Voice seed** (repeatable voice picks; set it at least 2 s before the take starts, under load).
100
+ 9. **Per-frame probe:** player, camera, every enemy with its head, corpses, squad, boss joints and weak points, the state
101
+ of interactive objects.
102
+ 10. **Time scale** (simulation only) as a fallback; the stepped clock is the real slow motion.
103
+ 11. **World:** time of day and its sun bearing, weather and sky seeds, lightning triggers, and a switch that keeps the
104
+ victory in gameplay so your camera owns the ending (the OG Clash victory cinematic took the camera and deleted the
105
+ enemies; the hook to own the ending took about 5.5 hours).
106
+ 12. **Look flags as needed:** hide markers and telegraphs, solid pickups, pin the first-person character, gore scale,
107
+ steady held lights, a temporal-history cut on every mesh swap.
108
+ 13. **Audio:** no in-game music, no voice (engine effects only), separate stems if the engine allows.
109
+
110
+ ## 3. The deterministic stepped capture
111
+
112
+ Real-time capture cannot hold 4K60 on a game (OG Clash ran 25-31 fps at 4K on its top preset) and changes outcomes
113
+ (screenshot calls delay inputs). A page screenshot costs about 2.5 s per 4K frame and a screencast drops frames.
114
+ Instead:
115
+
116
+ 1. **Serve the build yourself** (web games): cross-origin isolation headers (COOP and COEP, or the game silently falls
117
+ back to one thread), Range requests, compressed assets, broken asset paths remapped, and **the clock shim prepended
118
+ to whatever script runs the game loop**, often a Worker (a page-level clock does not reach workers).
119
+ 2. **Boot in real time** to a known state (the title), send boot commands, start, wait for "playing", stage at real-time
120
+ seconds, then **settle** while streaming finishes (top LODs, hero models: wait for the hero model before rolling).
121
+ 3. **Arm:** switch the engine's clock (`performance.now` and `requestAnimationFrame` in a browser) to a virtual clock.
122
+ 4. **Preroll** some stepped, unrecorded frames at frame 0's camera so temporal anti-aliasing, LODs and streaming
123
+ settle. Set expensive toggles (seeds, poses, depth of field) in the stage or the preroll, never on a recorded frame.
124
+ **Spawn staged enemies in the stepped preroll:** real-time commands under load drop or collapse into one frame.
125
+ 5. **Per output frame:** read the directive for this frame from the shot spec (step, commands, input, camera); inject
126
+ commands into the engine's own queue for this frame; advance the virtual clock by the step; run one engine frame (if
127
+ the engine refused, for example a busy GPU slot, retry the same time); convert to BT.709 limited-range YUV on the GPU;
128
+ read back; encode; drain exactly sample rate × step samples of audio; write the frame's metadata (camera, probe,
129
+ signature) off the critical path, every frame (batching it cost 17 %).
130
+ 6. **Conform:** a lossless remux with BT.709 tags; check the decoded frame count, the rate, the colour tags, duplicate
131
+ signatures and clock skips; make a 1080p proxy; copy the master to the archive and verify the checksum, falling back
132
+ to a local folder when the archive is missing.
133
+
134
+ **Numbers from OG Clash:** 17-37 captured frames per second at 4K on a quiet laptop GPU (2.1-3.5 s of wall time per
135
+ output second) plus 45-75 s of overhead per take; another GPU browser halved it; two parallel takes cost 8 %. For dark
136
+ skies, capture HEVC at 300 Mbps (shadow banding 14.5 % of blocks against 51.3 % for H.264 at 160 Mbps); that is about
137
+ 2.25 GB per output minute. Supersampling at 1.5x cost 3.4x the time for no visible gain except on short slow hero shots.
138
+
139
+ **Slow motion:** a step of 1/240 s per output frame is 0.25x with perfect 60 fps output; ramps change the step per frame
140
+ (smoothstep in log-speed). Check with the engine's own logged clock and the motion on frames.
141
+
142
+ **Takes are performances.** Two runs of the same OG Clash shot shared 0 of 240 frame signatures, because sky, rain and
143
+ lightning seeded from the wall clock while the camera and input were exact. Seed or freeze ambient events if retakes
144
+ must match, shoot several takes and pick by measured payoffs. A deterministic seed can even land a "random" event where
145
+ you want it (25 forced lightning strikes in the stage made the take's own strike hit the boss's helm).
146
+
147
+ ## 4. Per engine
148
+
149
+ Check every API name against the engine version in hand.
150
+
151
+ | Engine | Clock and offline render | Slow motion | Camera and cuts | HUD | Notes |
152
+ |---|---|---|---|---|---|
153
+ | Unity | `Time.captureDeltaTime = 1/60` (or `captureFramerate`) advances game time a fixed amount per rendered frame; the Recorder package writes sequences or movies under it; HDRP accumulation gives sub-frame motion blur | `captureDeltaTime = 1/240`; keep `fixedDeltaTime` small, Rigidbody interpolation on | Cinemachine or Timeline; reset TAA and motion vectors on cuts (Cinemachine cut events, HDRP history reset) | a canvas per element behind a capture flag | `Time.unscaledDeltaTime` and `realtimeSinceStartup` users (UI tweens, hitstops) will not slow down, and an Animator on an unscaled update mode will not either; audio under capture stepping is unreliable, so rebuild it from the game's files |
154
+ | Unreal | Movie Render Queue or Movie Render Graph renders Sequencer at a fixed rate with warm-up frames, temporal sub-samples (motion blur) and spatial samples | global time dilation; Chaos substepping; check real-time timers | CineCameraActor in Sequencer (filmback, focal length, aperture); Sequencer camera cuts reset history | `showhud`, widget visibility; screen percentage 100, dynamic resolution off | for gameplay, record with Take Recorder and re-render through the render queue, or use a fixed frame rate or benchmark mode |
155
+ | Godot 4 | `--fixed-fps 60 --write-movie out.png` (Movie Maker) renders at a fixed rate regardless of real time, audio in sync | `Engine.time_scale`; physics ticks and interpolation | Camera3D with CameraAttributes; AnimationPlayer, Path3D | a CanvasLayer per element | check 2D and 3D interpolation support per version |
156
+ | three.js, Babylon, custom WebGL or WebGPU | own the loop: no `setAnimationLoop`; call render with a virtual time; feed a fixed dt to `AnimationMixer.update`, physics and shader time uniforms | a smaller dt per frame | your own camera; reset TAA history on cuts | DOM or a flag | shim `requestAnimationFrame` and `performance.now` if the app reads them; read back with `readPixels` (WebGL) or `copyTextureToBuffer` and `mapAsync` (WebGPU); encode with WebCodecs and do the RGB to YUV conversion with the BT.709 matrix yourself (WebCodecs tags frames BT.601); refuse software renderers (SwiftShader, llvmpipe) |
157
+ | Browser WebAssembly (Emscripten, Unity WebGL, custom) | find where the loop runs (main thread or Worker), every clock it reads (`performance.now`, `Date.now`, imports), whether pool workers read time, whether a frame pacer refuses short frames; shim all of them | a smaller step | engine commands per frame through its own queue; sync on log lines | engine flags | serve with COOP and COEP; block service workers; skip press, install and audio gates with URL parameters or synthetic events; pointer lock can be faked; gamepads can be spoofed |
158
+ | Bevy and native custom engines | add a capture mode: a fixed step per frame, render offscreen, read back, pipe raw frames to ffmpeg or encode in-process | a smaller fixed step | your camera system and a history reset | a resource flag | usually the easiest: you own the loop |
159
+ | 2D (Phaser, Pixi, canvas, pixel art) | the same loop ownership; record at an integer multiple of the art's native resolution | a smaller dt; check tweens that run on real time | whole-pixel camera positions (no sub-pixel shimmer) | DOM or a scene flag | upscale with nearest-neighbour; no rotation or non-integer zoom on pixel art unless the game does it |
160
+ | Mobile builds | prefer the editor or a desktop build with the mobile content for offline capture; a device recording (Xcode, `adb screenrecord`, then crop) only for "real phone" proof shots | engine-side | as the engine | as the engine | store preview rules: the archetypes chapter of `opengame-trailer-plan` |
161
+ | Closed build, no source | drive input from a recorded stream at a locked frame rate, capture at the highest constant rate, use photo mode, replay or spectator if the game has them | optical-flow retiming only as a last resort, and say so | the game's photo or replay camera | in-game options | say plainly what the limits are; lean harder on editing, music, sound and type |
162
+
163
+ ## 5. Shot specs as code: takes, selects, the edit
164
+
165
+ - **A shot is a module** (for example `capture/shots/<id>.mjs`): `{id, build, size, boot, start, stage[{at, cmd}],
166
+ settle, preroll, frames, step(f), frame(f, ctx) -> {cmds, cam{pos, look, fov, roll, cut}, input, hud}}`, where `ctx`
167
+ is the simulation time and the probe's entities. Specs read music positions from `grid.json` (bar n, beat k), never
168
+ compute frames from BPM.
169
+ - **Handles:** record 30 frames either side; take frame = timeline frame − slot start + 30. Script payoffs to ±1 frame
170
+ and outcomes to ±3, then **measure** them from the probe (bodies down, boss gone, a luma jump).
171
+ - **First-to-third-person pairs** are one take with an in-take camera cut and a HUD switch on the same frame.
172
+ - **Draft at 720p,** test the riskiest shots on proxies, then shoot the master format only for the take you expect to
173
+ select. Never judge at draft size what must be judged at the master: drafts hid mannequin-looking enemies and cheap
174
+ bloom on OG Clash. Delete rejected masters when disk is tight; specs reshoot in about a minute.
175
+ - **Takes** live in `capture/takes/<id>/tNN/` with a proxy, `frames.jsonl` (camera and probe per frame), a QA file, a
176
+ summary (capture rate, load at arm) and a copy of the spec.
177
+ - **Selects** (`capture/selects/<shot>.json`) are the contract with the edit: take, proxy, take in and out, timeline in
178
+ and out, payoffs (timeline frame, take frame, what) with measured evidence, build hash, notes, a self-review (checks
179
+ PASS or FAIL, what is great, what is weak, what another hour would buy) and the previous select. Store paths relative
180
+ to the project. Back up selects before bulk edits so a revert is one line.
181
+ - **Persist every environment override a take depends on** in the spec or the select (OG Clash lost a take because its
182
+ variant lived only in a shell).
183
+ - **Shared primitives** (grid lookup, monotone cubic camera paths, a critically damped follower, log-speed ramps, the
184
+ payoff speed cycle, a shutter helper, HUD bits, the boot switches, the weapon and finish tables) are owned by the
185
+ director; builders import them and never fork them.
186
+
187
+ ## 6. The animation audit (before planning any character or enemy shot)
188
+
189
+ - When the owner or the developers have already called an animation bad, assume it is: measure it, then stage only
190
+ clips that pass.
191
+ - Audit weapons, sights and finishes too: every one the plan shows, on frames, aimed down sights included.
192
+ - One spec per clip: a flattering three-quarter front camera, mid and wide, at 1x and 0.25x, HUD off.
193
+ - A contact sheet per clip: 8 spaced frames and 6 consecutive cropped frames (plus a slow-motion strip for enemies).
194
+ - Measure: root and head second-difference RMS (jitter, in mm per frame squared), motion energy over a crop, the share
195
+ of puppet arms (arms locked straighter than 155° with hands above the chest), foot slide, rise linearity (R²).
196
+ - A verdict per clip: **USABLE, WITH CAMERA CARE (and the exact framing), NO, or NOT REPRODUCED.**
197
+ - Staging rules from the OG Clash audits (reuse them unless your game proves better):
198
+ - motion with intent, never idle; an armed character at most 30 % of frame height, a squad firing at most 20 %, a
199
+ seated character at most 45 %;
200
+ - faces three-quarter or profile; no backs of heads; over-the-shoulder only where the head and back do not fill the
201
+ frame;
202
+ - a low lens (0.3-1.0 m) looking up at heroes;
203
+ - slow motion on what characters cause (muzzle flash, tracers, debris, enemies), not on weak bodies;
204
+ - enemies rising out of the ground at 11 m or more, at most 14 % of frame height, at least 6 bodies, staggered in time
205
+ and depth (one row standing up together reads as a chorus line), or none;
206
+ - cut before arrival jostle, before corpses settle, before a sprint stop snaps;
207
+ - never let an enemy stand in frame; never hold a T-pose;
208
+ - hide the feet of crowd AI (navigation and IK glitches live there).
209
+ - Scout lanes first: props block AI and the player ("walking in place" was a blocked controller).
210
+
211
+ ## 7. What cost OG Clash a round
212
+
213
+ | Symptom | Cause | Fix |
214
+ |---|---|---|
215
+ | every asset 404s, endless loading | broken relative links in the release | serve with path remaps |
216
+ | silent single-threaded fallback | missing COOP and COEP headers | send them |
217
+ | low-quality takes | the renderer's auto profile, dynamic quality | force the top preset after the title; check the log says it is fixed |
218
+ | BT.601 colour | WebCodecs given RGB frames | convert to BT.709 NV12 on the GPU |
219
+ | banding in dark skies | H.264 at 160 Mbps | HEVC at 300 Mbps |
220
+ | a full-frame smear on a camera jump | temporal history carried across | the cut hook |
221
+ | ghostly see-through pickups | TAA on fast mesh swaps | cut history on every swap frame |
222
+ | ragdolls stepping every 4th frame in slow motion | fixed 60 Hz physics, no interpolation | step on frame time |
223
+ | a flip freezes while the camera moves | a 70 ms hitstop on raw time is 12 frames at 0.25x | no-hitstop flag; re-time the animation |
224
+ | aim drift dies in slow spans | an aim spring in simulation time | per-frame view steering in output frames |
225
+ | a floating gun under a free camera | the first-person arm | the body hook |
226
+ | music baked into every take | in-game music on | mute at capture; verify by loudness |
227
+ | silent guns early in a run | sound banks still loading | grant each weapon once in the preroll, then wait |
228
+ | the first recorded frame smeared | the camera sent on frame 0 | set it in the preroll |
229
+ | a documented camera position inside a wall | the research doc was wrong | verify every coordinate on frames |
230
+ | a scripted run aborts under load | the engine's deadline after the last command | append a far-future no-op |
231
+ | a sky change missing | the build did not recook shaders | cook, then verify the cooked asset |
232
+ | the revive greys the whole frame | a game state effect | do not use it, or add a hook |
233
+ | a held prop never visible | a first-frame visibility bug | fix it with a hook |
234
+ | two agents' work in one commit | a deploy script that commits the whole tree | one owner, patches |
235
+ | debug overlays in a shot | frame counters, page badges, "reload with sound", build text | turn every overlay off; check the build's defaults |
236
+ | capture drops from 120 to 2-5 fps within 30 s | macOS background-priority throttling of the browser | run the capture tree at normal priority (`taskpolicy -B` on macOS) |
237
+
238
+ ## 8. Audio at capture
239
+
240
+ - Mute in-game music and voice; keep engine effects. Capture at the simulation rate (slow-motion takes are short in
241
+ audio) and map each frame to its samples in the frame log; the edit re-aligns real-time sound to the payoff.
242
+ - Inventory every game sound file before buying or generating sound: duration, loudness, true peak, phone-band share
243
+ (300 Hz-5 kHz), sub share, a key estimate against the track's key, organised by beat of the film with the code that
244
+ triggers it. Pick game audio; never pitch-shift it. `opengame-audio` covers how a game's own sound should be built.
@@ -0,0 +1,126 @@
1
+ # Finishing: edit, grade, mix, render, QA, delivery
2
+
3
+ The OG Clash pipeline was ffmpeg and Python, engine-agnostic, and one command made a cut: shots and selects into an
4
+ edit list, a frame-exact conform, the grade, the mix, the render, then QA on the final file. Build yours the same way:
5
+ a script per stage, each restartable, and one command that runs them in order.
6
+
7
+ ## 1. The edit
8
+
9
+ - **The edit list comes from the plan and the selects.** A select fixes a 1:1 mapping from take frame to timeline frame
10
+ (offset = timeline in − take in). The edit never changes speed: speed lives in the capture. A select may carry
11
+ segments (two takes in one slot).
12
+ - A slot with no select becomes a labelled slate ("SLATE, NOT FOR DELIVERY") so a watchable full-length cut exists from
13
+ hour one. A cut sent to the owner as a full cut never carries one.
14
+ - A fallback select lets a new slot show a neighbour's take until it is shot.
15
+ - Story beats are the only cuts allowed big luma jumps; list them.
16
+ - An overrides file holds per-shot exposure, temperature and tint trims, slips, the take-audio choice, gains, and the
17
+ title's frame range and stage.
18
+ - **Re-slotting:** move cuts 1-2 frames before beats or half-beats, keep payoffs inside their slots and covered by take
19
+ handles, write a reason per change, never more than 4 equal-length shots in a row.
20
+ - **A cue sheet keyed to payoffs:** sound cues reference the select's payoff frames (the nearest within 15 frames), so
21
+ sound follows re-shot picture. Re-key the cue sheet whenever selects or title strikes change.
22
+
23
+ ## 2. Frame-exact conform
24
+
25
+ - Decode each event with its own ffmpeg, trimming by decoded frame index (`trim=start_frame=..:end_frame=..`), never by
26
+ time seeking; count the raw frames in your script and abort on any mismatch; feed one encoder at a constant 60 fps.
27
+ Self-test: sample frames must be bit-identical to the source.
28
+ - Frame-exact stills anywhere: `-vf "select=eq(n\,N)"`, never `-ss`.
29
+ - Plates for CG inserts: convert with `scale=in_color_matrix=bt709:in_range=tv:flags=accurate_rnd+full_chroma_int,format=rgb48be`
30
+ (a mixed extraction differed by up to 168 of 255).
31
+
32
+ ## 3. Grade
33
+
34
+ - Per-act 3D LUTs (OG Clash built 65³ LUTs in Oklab on the engine's output) plus per-shot exposure, temperature and tint
35
+ trims. A colour script of one sentence per act.
36
+ - Light across cuts: median luma jump at or under 18, none over 40 except declared story beats; predict trims by
37
+ applying them to the two frames at the cut before rendering.
38
+ - No added grain, flares, chromatic aberration or vignette on top of game art; the game's own bloom stays.
39
+ - Titles and CG inserts go in **before** the grade; a studio mark, if the owner wants one, goes **after** it at encode.
40
+ - A montage in a named editor's style may have a finishing layer (levels, a curve, glow, punches); that is set by a look
41
+ test with the owner and runs once per cut (`opengame-montage-make` covers it).
42
+
43
+ ## 4. Mix
44
+
45
+ - **The bed:** the music at one constant gain. Designed silences are edits of the track, not ducks.
46
+ - **The bus:** game sound, effects and voice peak-controlled as one bus keyed to the bed's headroom, big hits exempt.
47
+ Measure the music's level in the mix: a master limiter alone pulled OG Clash's music down 3.5-3.9 dB under every peak,
48
+ an accidental duck.
49
+ - **Game sound:** 0 to +6 LU over the bed in action (OG Clash needed +5 dB with per-shot trims).
50
+ - **Tails:** a 0.4 s raised-cosine continuation after each take group's last sound; slow-motion tails inside a group stop
51
+ 5 ms before the next onset so no transient plays twice. No cut where the sound drops more than 20 dB within 2 frames.
52
+ - **Slow motion:** the real-time sound once, unstretched, anchored so the payoff sounds on its frame.
53
+ - **Never double a sound:** skip a designed cue where the take audio already carries the event (track each cue's source:
54
+ the take, the re-aligned take, a file, a generated sound). OG Clash's first round played 47 cues twice.
55
+ - **Designed hits:** on every big picture event, at least 35 % of the energy in 300 Hz-5 kHz, at least 6 dB over the
56
+ bed in that band, on the attack, in key, with a sub layer 14-21 dB under. Every flash gets a sound or is deliberately
57
+ silent.
58
+ - **Voice:** a static −3 dB presence dip on the bed around 2.2 kHz under each line, crossfaded over 8 frames; check each
59
+ line with a speech recogniser on the mixed master, four windows per line, three of four correct.
60
+ - **Electric effects:** a static −3 dB shelf at 9 kHz on your own layers, never on take audio.
61
+ - **Write every generated audio file atomically** (temporary name, then rename). A mix that read half-written files
62
+ produced a squashed master (−14.4 LUFS, 4.3 LU range).
63
+ - **Master:** −14 LUFS ±1 integrated and true peak at or under −1 dBTP on the AAC delivery; two limiters around a linear
64
+ gain with about 1 s of pre-roll; never ffmpeg's `loudnorm` filter, in one pass or two (its dynamic mode flattened drops by 3-4 dB).
65
+ The loudness range follows the track: document a waiver rather than leaving a gate red on every cut.
66
+ - A montage on the owner's song mixes differently (the song leads, untouched): `opengame-montage-make` covers it.
67
+
68
+ ## 5. Render
69
+
70
+ - **Review cuts at 1080p at the master frame rate:** x264 `-preset slow -crf 18 -tune film` (about 17 Mbps; a fast
71
+ preset at CRF 15 was 29 % bigger). Under heavy load a fast preset is fine for review; the master path stays separate.
72
+ - **The master** at the plan's format, 1080p60 by default. A 4K master renders in 600-frame chunks, each reused when its
73
+ frame count matches (a later shot swap re-rendered one chunk in 344 s). Refuse to build a 4K master from 1080p
74
+ proxies.
75
+ - **Unique work folders and a lock** before cutting (process id plus seconds, never a minute stamp): two director
76
+ processes started in the same minute shared a work folder on OG Clash and produced a cut of 3,319 of 3,720 frames with
77
+ a frozen opening. Keep the work folder until QA passes on the final file.
78
+ - **Cap threads** (`ffmpeg -threads 6`) and send heavy jobs through your machine's job queue if it has one; an uncapped
79
+ encode at 880 % CPU froze the game team's work.
80
+ - **Long jobs survive session restarts** under a service manager (a user launchd agent on macOS, a systemd user unit on
81
+ Linux) rather than an agent's background shell. On macOS use a LaunchAgent with an interactive process type and
82
+ `launchctl bootstrap`; a job started with `launchctl submit` runs at background priority and crawls. On completion, stop it **and** delete its definition: OG Clash's jobs
83
+ set to run at load re-ran five times after delivery, rewriting the edit list and the mix.
84
+ - Copy from slow external drives into internal disk before encoding (a 4K encode reading from a spinning drive took 54
85
+ minutes against about 40 s locally), then copy the result out and verify it.
86
+
87
+ ## 6. QA on every cut, on the final muxed file
88
+
89
+ | Check | Test |
90
+ |---|---|
91
+ | stream | frame count against the edit list; real and average rate exactly the film rate; BT.709 tags; audio and video within a frame |
92
+ | frames | black frames; frozen runs of 24 frames or more; exact duplicates; unique frames equal frames |
93
+ | light | the luma jump at each cut (the 160x90 grey mean of the cut frame against the frame two before it): median ≤ 18, none over 40 unless a story beat |
94
+ | loudness | −14 ±1 LUFS (a trailer), true peak ≤ −1 dBTP on the file's own AAC, loudness range (waiver documented) |
95
+ | silence | the quietest 25 ms RMS window stays above −26 dBFS, the first 150 ms and the final 0.8 s excluded (document a waiver for an intended quiet outro) |
96
+ | clicks | at every clip edge: no first-difference peak over 8x the local median within ±10 ms of the edge while the window is above −20 dBFS |
97
+ | moved cuts | strips at every cut that moved since the last cut; every changed shot's frame on a sheet |
98
+
99
+ The picture check inside OG Clash's render step passed on the broken cut with the frozen opening; only QA on the final
100
+ file caught it.
101
+
102
+ ## 7. Delivery
103
+
104
+ The master format is chosen in the plan (default 1080p60). OG Clash was mastered at 4K60:
105
+
106
+ | Deliverable | Settings | OG Clash |
107
+ |---|---|---|
108
+ | 1080p60 review | libx264 slow CRF 18 tune film, High profile, yuv420p, GOP 120, BT.709, AAC 320k, `+faststart` | 134 MB, about 17 Mbps |
109
+ | 4K60 archive master | libx265 medium CRF 12, Main10, yuv420p10le, keyint 60, `hvc1` tag | 1.23 GB, about 158 Mbps |
110
+ | 4K60 delivery | hardware HEVC Main10 (on macOS `hevc_videotoolbox -profile:v main10 -pix_fmt p010le -b:v 90M -maxrate 140M -bufsize 180M -tag:v hvc1`) with BT.709 tags, or x265 CRF 16 with `-tag:v hvc1` | 700.6 MB, 90 Mbps |
111
+ | web | 1080p60 x264 CRF 20-23, max rate 7 Mbps; 720p CRF 26 for an archive page | 56 MB, 8-18 MB |
112
+ | inline chat preview | 720p, under 50 MB | |
113
+ | social | 30 s and 15 s in 9:16 with burned-in captions | |
114
+
115
+ **Measure "visually lossless" before claiming it:** PSNR and SSIM of the delivery against the master. Hardware HEVC
116
+ was about 100x faster than x265 under load. HEVC in an MP4 needs the `hvc1` tag or QuickTime, Safari and iOS will not
117
+ play it. Settle a target size or bitrate per deliverable in the plan ("optimize it
118
+ ... so its not a crazy file size").
119
+
120
+ ## 8. A studio mark (only if the owner wants one)
121
+
122
+ If the owner asks for a studio or publisher mark on every frame: draw it once at the master resolution and downsample
123
+ it, overlay it as a full-frame straight-alpha image at encode (after the grade, never graded), one flat white with no
124
+ shadow, small (OG Clash's avatar was about 3.5 % of frame height, with margins of about 1.9 % of the width and 3 % of the height), with a
125
+ switch that renders without it. A blind critic flagged the mark sitting over the title and the end card; offer to hide
126
+ it there.
@@ -0,0 +1,184 @@
1
+ # Gates: what every trailer cut passes before a person sees it
2
+
3
+ The shipped OG Clash trailer is a 6/10 by its owner, 5.5/10 against the Black Ops 6 and 7 zombies map trailers and
4
+ 4/10 against a Kaiser montage edit by a blind critic. These gates are the measurable difference, built from that
5
+ critic's report, the owner's notes and the reference measurements. Several came from four quick test trailers made
6
+ afterwards (a platformer, a tactics game, a shoot-'em-up and a racer), each caught by a critic or the owner and not by
7
+ an earlier gate; their lessons are folded in.
8
+
9
+ A FAIL is a finding like a critic's: fix it, or list it as open in the message that sends the cut. Thresholds are for
10
+ a trailer of about 60 s at 60 fps; scale them for other lengths. How to measure each one is in the measuring chapter.
11
+ Measure on the full-resolution review render and grab frames by index. A montage cut to the owner's song overrides
12
+ several of these (no silences, equal spacing, the song untouched): use `opengame-montage-review-and-improve` for those.
13
+
14
+ ## 1. Story and structure
15
+
16
+ - [ ] **Hook:** the first event (a hit of +15 dB or more, a cut, a flash or a question image) at 0.0-0.5 s; at least 3
17
+ cuts in the first 3 s, or one designed signature move or question image (a calm open passes through this branch,
18
+ not the cut count). No studio logo first.
19
+ - [ ] First voice line 0.8-3.8 s after the first picture (if the film has voice); first enemy by about 6-13 s.
20
+ - [ ] The story beats are on screen: hook, promise, escalation, **turn**, payoff, **button**.
21
+ - [ ] The boss or hero reveal is earned: its first full reveal at or after 40 % of runtime (partial teases allowed).
22
+ - [ ] The busiest 10 s window of cutting sits in the last 40 % of the pre-title runtime; the climax cuts at least 1.3x
23
+ faster than the feature section.
24
+ - [ ] **Every hero impact shows the impact frame:** no cut within 6 frames before it. OG Clash cut away from its boss's
25
+ fall before the body hit the ground, and a critic called it the biggest single point lost.
26
+ - [ ] One breath at 50-70 % of runtime: a single shot of 1.5 s or longer inside a music hole.
27
+ - [ ] Each feature is landed, not shown: a 3-4 shot micro-sequence over about 4 beats with its own accent colour and
28
+ sound.
29
+ - [ ] A shot that introduces a mechanic runs at least 70-90 frames; a single already-understood action at least about 32.
30
+ - [ ] Every item on the must-show list has a shot.
31
+
32
+ ## 2. Music, sync and rhythm
33
+
34
+ - [ ] At least 30 % of cuts within ±50 ms of an audio onset, and at least 2x the null on the hero section: cuts married
35
+ to hits and whooshes, not only to the beat grid.
36
+ - [ ] Action peaks (muzzle flash, impact, apex) within ±2 frames of a beat on hero shots.
37
+ - [ ] Montage sections: beat-phase motion swing of 2.0x or more, with the flow peak within ±15 % of a beat.
38
+ - [ ] Flow around hero cuts: frames −1 and +1 each at least 1.4x frames −8 to −5 (whips across cuts, not flat).
39
+ - [ ] Shot lengths in beats: no single length over 40 % of cuts; no more than 4 equal-length shots in a row; at least 3
40
+ shots of 3 beats or more outside the open and the coda.
41
+
42
+ ## 3. Ramps and camera
43
+
44
+ - [ ] **At least 6 legible speed ramps** (an in-shot flow ratio of 3x or more that the content does not explain), each
45
+ eased into a hit. Slow holds of 24-36 frames by default; at most one designed slow-motion beat of 0.9-1.5 s (the
46
+ climax, say), never several. 0 % duplicated frames.
47
+ - [ ] Slow spans: camera median at least 2 px/f, never under 1; **every character's angular rate at least 40 % of the
48
+ span's median on every frame** (no hitstop freezes).
49
+ - [ ] Every frame of every shot moves at least 1 px/f at 1080p (no locked-off frames, no static first person), unless
50
+ a scoped hold pays off within 0.3 s.
51
+ - [ ] Seams: **speed cuts** leave at 15 px/f or more over the last 3 frames and arrive at 10 px/f or more over the
52
+ first 4, within 45° of each other; **every other cut** carries at least 2 px/f into the next shot's direction
53
+ (1 px/f in a calm open) or has a stated cause (match cut, sound, look). Fail any seam under 0.6 px/f on either
54
+ side or over 90° apart.
55
+ - [ ] **The cut frame moves too.** A rig that starts its camera and its interpolation on output frame 0 makes every
56
+ shot's first frame a still: the platformer test trailer arrived at 0 px/f on 18 of 20 cuts, and critics read
57
+ three of them as stutters. Measure the first frame after each cut, and warm the rig 3 frames before frame 0.
58
+ - [ ] At most a quarter of third-person shots at constant velocity (smoothed-flow coefficient of variation under
59
+ 0.15). Ease and motivate every move: push on reveals, pull on scale, whip on action.
60
+ - [ ] Lens variety: at least 2 long-lens shots, 2 macro inserts and 1 top-down or bird's-eye shot; impacts get a camera
61
+ kick in the path if the owner allows it (never a post shake).
62
+ - [ ] Screen direction per the plan's map; no cut between sides breaks the 180° line.
63
+ - [ ] First-person share 25-40 % of the film (the action section may reach about 50 %); one set of hands.
64
+
65
+ ## 4. Sound
66
+
67
+ - [ ] **2-4 designed music holes** (20 dB or more under the previous 2 s, 0.3-2.4 s long), each followed within 0.25 s
68
+ by a hit at least 15 dB up (the references return 20-46 dB). A hole is near-silence, not digital zero: no 25 ms
69
+ window under −90 dBFS inside it, which two critics heard as a dropout on the platformer test trailer.
70
+ - [ ] **A designed hole starts on its cut:** the 10 frames after the cut are at least 20 dB under the 10 frames before,
71
+ with no onset inside the hole except its return. On the tactics test trailer the boss silence began 11 frames
72
+ late with a 14 dB chop, because effect tails from the outgoing shot ran into it; release the effects bus over the
73
+ last 6 frames before the cut.
74
+ - [ ] **The loudest 50 ms is on the boss impact, an explosion or the title,** never on a mid-film feature. OG Clash's
75
+ loudest moment was a weapon upgrade at 35 % of runtime.
76
+ - [ ] Short-term loudness spread of at least 8 LU across the body (no flat wall); loudness range within the track's
77
+ own range (the target is contrast, not a number to game); integrated −14 ±1 LUFS; true peak at or under −1 dBTP
78
+ measured on the AAC.
79
+ - [ ] No accidental duck: the music's fitted level dips 1.5 dB or less under voice and effects.
80
+ - [ ] Tails: no cut where the outgoing sound drops more than 20 dB within 2 frames, unless it is a designed silence.
81
+ - [ ] **A slow-motion hit is heard when it is seen,** within ±2 frames of its flash. At 0.3x a burst's visual peak lands
82
+ about 10 output frames after its engine event, so a cue placed on the event leads the picture.
83
+ - [ ] Nothing plays twice: no designed effect where the take's own audio already carries the event.
84
+ - [ ] Every luma flash of 12 or more over 2 frames has a designed sound or is deliberately silent; designed hits carry
85
+ at least 35 % of their energy in 300 Hz-5 kHz, sit at least 6 dB over the music in that band, and are in key.
86
+ - [ ] Voice density follows the brief; without one, the references' 5-8 lines and no more than 75 words per 60 s. Never
87
+ a wall of lines: gaps of 8 frames or more, no voice on the drop or the hero reveal, each line within 0.3 s of its
88
+ matching picture and on its speaker's shot (or the thing named), at least 3 of 4 recogniser windows correct on the
89
+ mix, no announcer clichés, no other studio's names.
90
+ - [ ] A raised designed hit cannot beat the limiter: on the tactics test trailer, raising the title hit moved its 50 ms
91
+ level from −7.8 to −8.1 dB because the peak met the limiter. The premaster's peak normalisation then turned
92
+ everything else up. Loudness over 50 ms comes from energy that lasts (a 70 ms crack decay, a rumble layer), not from
93
+ a higher peak.
94
+ - [ ] Lifting every small game event flattens the build: a platformer fires an event every 10-20 frames, and raising
95
+ the effects bus 4 dB at each one took the spread from 8.4 to 6.8 LU and the loudness range from 9.2 to 6.6 LU. Lift by
96
+ about −1 dB outside the first act and −4.5 dB inside it instead. Put the audible hits on a few chosen events
97
+ and measure the spread on an audio-only mix before rendering.
98
+ - [ ] The title lands with a layered hit 10 dB or more up; a button sound ends the film (no fade to nothing).
99
+
100
+ ## 5. Picture hygiene: nothing cheap, nothing random
101
+
102
+ - [ ] Hero effects: flat white at or under 0.5 % of the frame on held frames; thin structured cores; no blurred-circle
103
+ glows; at most 3 full-frame flashes per second; no periodic flicker on held lights. Re-measure after any reframe:
104
+ zooming in from 6x to 8x pushed one fire jet from 0.54 to 0.85 %, and a highlight roll-off in that act's grade (top 1.0
105
+ to 0.87) brought it to 0.47 % without touching black.
106
+ - [ ] Every shot has a sharp subject within the film's norm; no defocused occluder over 10 % of the frame.
107
+ - [ ] No animation graded NO by the audit on screen; no idle or posed characters; no backs of heads as subject; no
108
+ visible feet on crowd AI; readable space between hero and enemies.
109
+ - [ ] No primitive or placeholder meshes (a red sphere for a head gib read as cheap); blood or fog at or under 25 % of
110
+ the frame for at most 4 frames; no see-through or ghosted bodies or pickups; no floating or random props.
111
+ - [ ] HUD exactly as the plan says (none by default; only the owner's chosen feedback if they asked); no debug overlays
112
+ (frame counters, build text, page badges).
113
+ - [ ] No illegible shot of 10 frames or less (mean luma under 40 with no subject) unless it is a designed black slug.
114
+ - [ ] **The subject stays in frame to the last frame of every drift:** at least 60 % of its box inside the frame on
115
+ every frame, and no run of 30 frames or more that is 70 % sky or empty ground. A slow drift up carried the
116
+ tactics trailer's squad out of the bottom of frame for 74 frames while every camera-speed gate passed it.
117
+ - [ ] **The hero is in frame on follow shots:** the hero's centre inside 12-85 % of frame height and 5-95 % of width on
118
+ every gameplay frame, measured from the probe projected through the camera. The shoot-'em-up test trailer had its
119
+ ship off the bottom on most follow frames, and only critics saying "no ship in frame" caught it. Fix with a
120
+ constant camera offset per segment, which keeps every seam's speed.
121
+ - [ ] No two shots in one act frame the same subject at the same scale.
122
+ - [ ] Faces and hero assets match the owner's reference frame in every shot; no invented effects on them.
123
+ - [ ] Light across cuts: median luma jump at or under 18; none over 40 except declared story beats.
124
+ - [ ] **The background as well as the subject:** no off-tone props, signage, UI-like markers or telegraph circles in
125
+ frame unless they serve the shot.
126
+ - [ ] No digital punch-in beyond 1.2x; reframe in the engine instead ("why do the games look so zoomed in?").
127
+ - [ ] No banding in dark gradients; check a 4x-contrast crop.
128
+ - [ ] Every effect reviewed as full-resolution stills at hero size before the owner sees it.
129
+ - [ ] **Photosensitivity:** no more than 3 general or red flashes in any 1 s (WCAG 2.3.1 counts a flash when it covers
130
+ more than 25 % of any 10° field of view, which is far smaller than a quarter of the frame); run EA's IRIS on the cut.
131
+ - [ ] **The hero never fails on screen** (a death, a respawn, a hit taken) unless the plan declares a fail beat and the
132
+ owner chose it: no death or respawn event in the probe of any take in the cut. Both blind critics ranked a staged
133
+ death and respawn first on the platformer test trailer, and no earlier gate caught it.
134
+ - [ ] **No set reads black:** a black detector (98 % of a 160x90 frame below luma 26) finds no run outside a designed
135
+ slug. A check that only looks for fully black frames missed a stretch of ice cave that read black on a phone.
136
+
137
+ ## 6. Title, end, button
138
+
139
+ - [ ] The title lands at 84-90 % of runtime (or a deliberate cold-open title), resolves on a beat (±4 frames) and is
140
+ **earned from the world** (it emerges from an ember, a forge, a light) or found by the camera; never a drift-in.
141
+ - [ ] It is a 3D object in the world: the per-frame gap to characters stays above 0; extrusion visible; at most 30 % of
142
+ frame width; matched to scenery at the same depth (saturation, black floor, peak below the brightest light in the
143
+ shot); composited before the grade; still at rest (bit-identical frames with its energy off); energy on the beats
144
+ from its first visible frame.
145
+ - [ ] End card per the plan's text policy. When text is allowed: 4-6.5 s with the game's name, where to play and "Play
146
+ now" or a date, the "play now" claim checked against the game's real first-load time. When the brief allows only
147
+ the title ("The only text is ... the name of the game ... thats it"), the call to action lives in the post copy
148
+ and the share card.
149
+ - [ ] A **button** of 2-7 s after the title or end card, ending on a hard cut and a sound.
150
+ - [ ] **Every word the plan puts on screen is on a rendered frame:** crop the title and the call to action from the
151
+ review render at full resolution and read them. On the racer test trailer "Play now" sat on a gantry face turned
152
+ away from the camera for a whole round while the handoff called it built; both blind critics reported no call to
153
+ action.
154
+
155
+ ## 7. Character
156
+
157
+ - [ ] At least one reaction shot of 1 s or more with readable body acting (a look, a tilt, a take).
158
+ - [ ] At least one crew-identity beat (names, a signature line, a spoken title).
159
+ - [ ] At least one moment of the game's own humour or personality, if it has any.
160
+
161
+ ## 8. Grade
162
+
163
+ - [ ] Each act has its own colour world: the mean chroma (U, V) vector moves 4 units or more between acts, per the
164
+ colour script.
165
+ - [ ] One or two accent flashes of 3-6 frames on the biggest reveal and the kill.
166
+ - [ ] Content luma Y 40-70 (limited range; bright sections built on purpose), clipping under 3 %.
167
+
168
+ ## 9. Delivery
169
+
170
+ - [ ] QA passes on the final muxed file: frame count, frame rate, BT.709 tags, audio and video within 1 frame, no black,
171
+ frozen or duplicate frames, loudness, clicks.
172
+ - [ ] No slate or fallback frame in any cut sent as a full cut.
173
+ - [ ] The master is at the plan's format (default 1080p60); PSNR and SSIM of any compressed delivery against the master
174
+ measured before calling it visually lossless.
175
+ - [ ] Every watcher, scheduled job and heartbeat torn down at delivery.
176
+
177
+ ## 10. Raw gameplay montage (when the plan includes one)
178
+
179
+ - [ ] Every gameplay beat fulfils its on-screen objective with the success feedback visible. The OG Clash montage shot
180
+ a boss's visor while the objective on screen asked for its weak spots.
181
+ - [ ] No frame of the player firing at nothing, getting hit, stuck, or doing something a skilled player would not.
182
+ - [ ] No visible score jumps between cuts that reveal developer setups; no god-mode or debug text.
183
+ - [ ] Game music muted in every take (measured), the game's own score laid in afterwards.
184
+ - [ ] Subtitles and voice checked for duplicates and bugs; each filed as a game note.