@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,46 @@
1
+ # The 30 day-one questions, with defaults
2
+
3
+ Ask them in **one message within the first hour**, grouped as the ten groups in `opengame-montage-plan`, each with a default and,
4
+ where one helps, a picture to choose from. A demanding owner answers "which of these" and yes/no fast and leaves
5
+ open-ended sheets unanswered: if nothing comes back, take the default, log it in `plan/DECISIONS.md` and keep going.
6
+ Answer from the repo, the build and the song anything that is not the owner's taste; ask each question once. "Payoff" is
7
+ the genre's peak event; "skin" is a camo, livery, costume or palette.
8
+
9
+ Every one of these cost hours on the OG Snipers montage because it was not asked. The defaults are what that owner
10
+ settled on; your owner may differ, which is why you ask.
11
+
12
+ | # | Question | Default if unanswered | Why it is asked (OG Snipers) |
13
+ |---|---|---|---|
14
+ | 1 | Where in the song does the montage end, and how long is the ending after it? | the measured structural point (the end of the vocal), an ending of 3-5 s; confirm the length in one line | "around 60 seconds" and "around 1:30" in one brief |
15
+ | 2 | May the song be edited, faded or dropped anywhere? Any silences? | untouched; one gain; a fade of at most 0.5 s at the end; no holes | "dont randomly change the song"; "u cant have music just go completely blank" |
16
+ | 3 | Is the music always the loudest element? (attach a 20 s mix check) | the music leads; payoffs about 3 dB over it in 1-5 kHz | "music is way too soft"; about ten sound rounds |
17
+ | 4 | Do payoffs sit at a fixed interval on the beat? May a beat be a movement or a cut? | equal spacing at k beats; movement beats allowed | two full re-shoot rounds |
18
+ | 5 | How many payoffs in a normal clip, how big is the biggest, and which clip is the finale? | 5-6; one bigger; a unique finale | "5-6 pieces be the default ... last clip of 10 piece should be unique" |
19
+ | 6 | Which play styles are banned, which tricks count, and at what speed? | only the high-skill form; tricks at real speed, ending in their hardest form | hard scopes banned; "at least 720 and noscope"; "the 720 is way too slow" |
20
+ | 7 | Must every payoff be legal under the real rules? What mix of payoff types? | legal, or staging disclosed per payoff; vary types, with a few pure showpiece clips | staged kills counted as 4, then 7, then 8 |
21
+ | 8 | Which of your own habits should the player copy, and which not? | their measured feel; their habits only where they say | weapon swaps after every shot: "only a few clips" |
22
+ | 9 | How should opponents look and behave? Which names must be unique? | varied as the game varies them, moving like players; names unique wherever readable, from the game's generator | duplicate feed names reported as a bug; stuck bots twice |
23
+ | 10 | Whose character is the hero, in which exact outfit? Does the player-view model (hands, cockpit, board) change? | the owner's own character, exact settings (an account link or a screenshot); the player view as shipped | about 10 hours on the wrong hero; "no dont change first person shots" |
24
+ | 11 | Your shortlist of skins? Is reuse fine? | their list, reuse allowed; a casting sheet before shooting | four turns on camos; "this is a terrible camo to use" |
25
+ | 12 | Which weapons, cars, characters or loadouts, with which iconic attachments? | the most iconic per clip, their pairings | one clip's weapon had to wear a specific sight |
26
+ | 13 | Which maps, tracks or levels are must-show, and which go first if clips need length? | the best known first | "cut the least popular / known ... maps" |
27
+ | 14 | Which kinds of cinematic do you like? (three stills: a move into the map handing into the player view; the payoff from the receiver's side; the hero alone) | the first two; the hero alone only as a signature moment | they praised the first two and never the third |
28
+ | 15 | In impact shots, which part of the body (car, board) may be in frame? | frame out what the engine animates worst | "dont see the bottom half of body" on day 3 made a day of tuning moot |
29
+ | 16 | Eased speed ramps everywhere, cinematics included? (send a pilot clip) | yes; a pilot on day one | asked at the 17th cut; on 3 of 13 clips at the final |
30
+ | 17 | Once you like a shot, may I ever remove it without asking? | no: assume it, do not ask | the third cut removed every praised cinematic with a fault |
31
+ | 18 | Which HUD elements show? (a frame of each next to the shipped game) | success feedback only, pixel-identical to the game | feed spacing raised twice, 42 hours apart |
32
+ | 19 | Any text? If a title: material, font (five on the real plate), in the air or on the ground, how it animates? Or no title rather than a weak one? Confirm any name or word in one line | no text unless they say so; offer a cut without the title early | 23 hand-ins; a name dictated with a typo had to be confirmed (dictation garbles names) |
33
+ | 20 | What is the ending: one shot or a sequence, how long, what does the hero do? | one shot of 3-5 s, the hero's calm moment | "one scene and 3-5s long" |
34
+ | 21 | Which voice lines, where relative to their trigger, how loud? Any to drop? | the game's own callouts, sparing, 0.1-0.15 s after the trigger, under the song | one callout moved four times; "we dont need the game over voice" |
35
+ | 22 | Keep every game sound as recorded? Add the hit-confirm tick? | keep everything; the tick on | "retain all the gun shot sounds"; "lets have hitmarker sounds topo" |
36
+ | 23 | Do you want the reference editor's finishing layer? (a 15 s look test) | yes, tasteful; lock the approved look | approved first time |
37
+ | 24 | Which parts of the reference matter most? Follow its split of play and cinematics? | flow, ramps, sync, aura; its measured split | "the same split of clips vs cinematics can be what u follow" |
38
+ | 25 | Where do cuts go, in which formats? The review and master formats; capture at the master? | review cuts at 1080p60 16:9 copied to their folder and read back; capture at the master format | "where are we saving all the cuts" twice; the 4K master was an upscale |
39
+ | 26 | A full cut per block of fixes, or one complete cut? Updates how often? | a cut 30-90 minutes after each burst of notes while they are active; one current file while away; a status line every 15 minutes | 13 cuts in a row drew no note (r04 to r15); "its been a long time..." |
40
+ | 27 | Is a judge panel's score the finish line, or your approval? When should it run? | their approval; the panel on a schedule as a measuring stick | the panel never ran |
41
+ | 28 | When is the deadline, and how many rounds do you expect? | a good cut by hour 16-20, then rounds to their call | "perfect and all done 4 hours from now or so"; "how do we speed up" |
42
+ | 29 | What compute and paid spend may I use, on whose account? May I coordinate shared machines with their other sessions directly? | the stated cap on their own account, logged per call; yes, coordinate directly | $2.35 of a $200 cap used; "u should message that thread directly and coordinate" |
43
+ | 30 | What will you never accept on screen? | the never-list from earlier films (hard scopes, clipping, jitter, z-fighting, stuck AI, a reaction before its action, the wrong receiver, dead time after the last payoff, a floating first-person arm), each gated on their own flagged frames before any cut is sent | |
44
+
45
+ Assume without asking: updates every 15 minutes; side work goes to another session; no placeholder is ever sent; a shot
46
+ the owner liked is never removed without asking them.
@@ -0,0 +1,27 @@
1
+ # Edge cases: games that are not a 3D shooter
2
+
3
+ Each row is a recommended approach. Platform rules and tools change; check the current rules before you render.
4
+
5
+ | Case | Approach |
6
+ |---|---|
7
+ | **No characters; abstract or puzzle** | The mechanic is the hero. Tell-show-repeat (a card, then the footage that proves it) with 2-3 short cards; average shot 2.5-4.5 s (Baba Is You's trailer runs 4.25 s); macro camera and slow orbits on the board; the "aha" moment is the drop; type and music carry the emotion; no voice. The "receiving side" of a payoff is the consequence seen up close (a cascade, a collapse). Depth of field is safer here than anywhere, because there are no faces to lose. Vary scale (macro, mid, top-down) and colour per section, or every board looks alike. |
8
+ | **2D or pixel art** | Capture at native resolution with whole-pixel camera positions; upscale by an integer factor with nearest-neighbour (320x180 ×12, 384x216 ×10, 480x270 ×8, 640x360 ×6) with `scale=iw*8:ih*8:flags=neighbor`; zoom in integer steps or in the engine, never with smooth scaling in the edit; keep the art's own animation frame rate inside a 60 fps master (a 12 fps walk at 0.25x shows each drawing for 20 output frames, which is honest; never interpolate drawings); keep sprites on the pixel grid at every simulation step or slow motion shimmers; separate parallax layers give 2D its camera move; screen shake and palette flashes are the game's own grammar, kept where they mark the event; upload 4K even for 1080p viewers. |
9
+ | **Closed build: no source, no free camera** | Screen-capture at the highest resolution the build runs, at a constant frame rate with near-lossless settings (for example OBS at CQP 12-16, a constant 60 fps or higher); look for photo mode, replay or spectator modes, console commands and config switches for field of view and HUD; fake camera moves only as slow 5-10 % pushes on 4K captures, never upscaled beyond 1.25x; slow motion by running the game at 0.25x and recording in real time (single-player only) or by capturing at a high frame rate and laying it at 60 (the slow-motion budget is capture fps ÷ 60); say plainly what the limits are and lean harder on editing, music, sound and type. |
10
+ | **Unfinished or buggy** | Freeze and tag one build; plan around the known bugs in the game bible's risk list; restart the scene per take; frame out artefacts; label "work in progress" where true; never show features that will not ship. |
11
+ | **Multiplayer only** | Bots or scripted headless clients for crowds; 2-6 trusted players on voice with a shot director; a spectator or replay client for cameras; a private server, a fixed seed and map; capture each player's view. |
12
+ | **Procedural or random** | Expose seed control; log seeds per take; re-roll until the shot matches the brief. |
13
+ | **Very low-fidelity art** | Lean on editing, music, sound and type built from the game's own logo and palette; parallax key art; keep it 30-60 s. |
14
+ | **Mobile portrait** | Master at 1080x1920 (App Store previews at 886x1920, 30 fps); make 16:9 versions with designed side panels, never black bars; no hands or devices on screen. |
15
+ | **VR** | A stabilised spectator camera (60-75° field of view, smoothed), a third-person avatar flown by a virtual camera, or a mixed-reality composite; "Captured on [device]"; fill 16:9. Bell-shaped hand paths, never a perfectly still controller. |
16
+ | **Text-heavy (visual novel, narrative)** | Build around the 4-8 strongest lines as voice or kinetic type; show the UI briefly so the genre is honest; the story-trailer structure; hold text at least 0.3 s per word plus 1 s. |
17
+ | **No voice budget or no cast** | Kinetic type and in-game barks; synthetic voice only when it fits the world and the person approves the spend; otherwise no voice. Ask first whether it needs voice at all. |
18
+ | **The game's voice is subtitle-only** | Voice the lines with the game's own casting settings (OG Clash's cost about $0.007 a line, on an account the owner approved) or go without; never invent a narrator. |
19
+ | **15 s social cut** | The first frame is the hook; burned-in captions; on a 1080x1920 frame keep text out of the top 220-240 px, the bottom 480-660 px, the right 140 px and the side 60-120 px (text inside the central 880x1220 or so); check each app before posting. |
20
+ | **Localisation and subtitles** | Make the text-free master first with cards as layers; deliver stems (music, effects, voice) and a music-and-effects mix; an .srt per language (block captions with sound cues in brackets); leave 15-30 % slack for longer languages. |
21
+ | **Photosensitivity** | WCAG 2.3.1: no more than 3 general or red flashes in any 1 s over 25 % of a 10° field. Run an open-source analyser (EA's IRIS) on every cut; use a certified test for broadcast or paid ads; remove editorial white flashes first; add a warning card if strobes must stay. |
22
+ | **Rating and age** | No blood in TV, cinema and most paid online video ads; age-gate mature trailers; App Store previews are all-ages; make a clean cut beside the full one; put the regional rating block on the end slate where required (an icon at least 53 px high online). |
23
+ | **Platform logos and legal** | Official logo files only, under each holder's guidelines; no other platform's button glyphs; "© year Studio"; a music credit if the licence needs one; "Captured on [device]" and "Footage not final" where true. |
24
+ | **Other studios' work** | Never recreate another studio's game, characters, logo or footage, even renamed. No other games' names in voice lines (a line that was another game's title was cut from OG Clash), no other franchises' power-up names, and scan every reference-inspired frame for emblems (a period map once hid an offensive emblem on a tower). References are for measuring only. |
25
+ | **The game keeps changing during production** | Freeze; re-check the frozen build's receipt; decide per shot whether a newer build is visibly better; the trailer may lag the live game (OG Clash shipped 80 rounds behind the live build). |
26
+ | **The machine is shared with the game team** | Agree a split before production, run heavy jobs through a slot queue with thread caps, declare burst windows for final renders, yield new jobs to the game's profiling windows and never kill in-flight takes. The film does not need a quiet machine; the game's measurements do. |
27
+ | **No GPU, or a software renderer only** | Stepped capture needs a real GPU. Refuse software renderers (SwiftShader, llvmpipe): if no GPU exists, say so and stop rather than render footage that misrepresents the game. |
@@ -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.