@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.
- package/CHANGELOG.md +44 -0
- package/README.md +12 -4
- package/dist/.claude-plugin/marketplace.json +26 -0
- package/dist/skills/manifest.json +1409 -145
- package/dist/skills/opengame-accessibility/CHANGELOG.md +4 -0
- package/dist/skills/opengame-accessibility/SKILL.md +48 -32
- package/dist/skills/opengame-all-in-one/CHANGELOG.md +21 -0
- package/dist/skills/opengame-all-in-one/SKILL.md +195 -0
- package/dist/skills/opengame-all-in-one/references/opengame-accessibility/README.md +102 -0
- package/dist/skills/opengame-all-in-one/references/opengame-api/README.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-assets/README.md +168 -0
- package/dist/skills/opengame-all-in-one/references/opengame-assets/references/pipeline.md +164 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/README.md +238 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/helpers/audio-chain.js +325 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/references/mix-notes.md +125 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/references/qa-without-ears.md +177 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/README.md +128 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/references/pipeline.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/references/threejs.md +161 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/README.md +180 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/first-person-body.md +108 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/integration.md +144 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/player-og.md +160 -0
- package/dist/skills/opengame-all-in-one/references/opengame-cli/README.md +189 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +223 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/json-events.md +63 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/manifest.md +89 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +119 -0
- package/dist/skills/opengame-all-in-one/references/opengame-depth/README.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/README.md +155 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/pacing-and-bots.md +108 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/threejs.md +193 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/README.md +185 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/launch.md +50 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/menus.md +81 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/README.md +181 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/helpers/spring.js +146 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/feel-numbers.md +142 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/killcam.md +88 -0
- package/dist/skills/opengame-all-in-one/references/opengame-jam/README.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-lighting/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-lighting/helpers/light-pool.js +185 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/README.md +135 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/helpers/loading-count.mjs +115 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/references/threejs.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/README.md +181 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/matching-a-reference.md +73 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/painterly.md +69 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/post-and-lens.md +73 -0
- package/dist/skills/opengame-all-in-one/references/opengame-maps/README.md +74 -0
- package/dist/skills/opengame-all-in-one/references/opengame-maps/references/map-spec.md +77 -0
- package/dist/skills/opengame-all-in-one/references/opengame-mobile/README.md +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/README.md +183 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/README.md +193 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/README.md +174 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/README.md +139 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/bot-lobbies.md +71 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/netcode.md +165 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/README.md +177 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/helpers/landing-pacer.mjs +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/references/measuring.md +123 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/references/webgpu.md +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/README.md +192 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/references/team.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/references/templates.md +153 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/README.md +170 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/cheap-tells.md +43 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/judges.md +95 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/review-prompt.md +32 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/README.md +134 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/charting.md +109 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/timing.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-router/README.md +54 -0
- package/dist/skills/opengame-all-in-one/references/opengame-router/references/process.md +38 -0
- package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/README.md +136 -0
- package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/helpers/scene-audit.js +677 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/README.md +283 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/engines.md +93 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/frame.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/identity.md +111 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/leaderboards.md +115 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/radio.md +71 -0
- package/dist/skills/opengame-all-in-one/references/opengame-stability/README.md +112 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/README.md +160 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/README.md +172 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/reference-set.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-verification/README.md +197 -0
- package/dist/skills/opengame-all-in-one/references/opengame-verification/helpers/browser-evidence.mjs +74 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/README.md +179 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/handling-numbers.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/reloads-and-hands.md +96 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/sights-and-scopes.md +98 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/threejs.md +240 -0
- package/dist/skills/opengame-all-in-one/references/opengame-world-physics/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-world-physics/references/measured-failures.md +79 -0
- package/dist/skills/opengame-api/CHANGELOG.md +12 -0
- package/dist/skills/opengame-api/SKILL.md +39 -13
- package/dist/skills/opengame-assets/CHANGELOG.md +11 -0
- package/dist/skills/opengame-assets/SKILL.md +79 -31
- package/dist/skills/opengame-assets/references/pipeline.md +67 -0
- package/dist/skills/opengame-audio/CHANGELOG.md +11 -0
- package/dist/skills/opengame-audio/SKILL.md +129 -41
- package/dist/skills/opengame-audio/references/mix-notes.md +44 -1
- package/dist/skills/opengame-audio/references/qa-without-ears.md +177 -0
- package/dist/skills/opengame-capture/CHANGELOG.md +10 -0
- package/dist/skills/opengame-capture/SKILL.md +44 -20
- package/dist/skills/opengame-capture/references/pipeline.md +33 -1
- package/dist/skills/opengame-capture/references/threejs.md +17 -1
- package/dist/skills/opengame-characters/CHANGELOG.md +15 -0
- package/dist/skills/opengame-characters/SKILL.md +94 -39
- package/dist/skills/opengame-characters/references/first-person-body.md +108 -0
- package/dist/skills/opengame-characters/references/player-og.md +1 -1
- package/dist/skills/opengame-cli/CHANGELOG.md +20 -0
- package/dist/skills/opengame-cli/SKILL.md +12 -11
- package/dist/skills/opengame-deploy/CHANGELOG.md +30 -0
- package/dist/skills/opengame-deploy/SKILL.md +43 -23
- package/dist/skills/opengame-deploy/references/json-events.md +6 -5
- package/dist/skills/opengame-deploy/references/manifest.md +9 -3
- package/dist/skills/opengame-deploy/references/packaging.md +32 -30
- package/dist/skills/opengame-depth/CHANGELOG.md +8 -0
- package/dist/skills/opengame-depth/SKILL.md +61 -33
- package/dist/skills/opengame-enemies/CHANGELOG.md +10 -0
- package/dist/skills/opengame-enemies/SKILL.md +96 -40
- package/dist/skills/opengame-enemies/references/pacing-and-bots.md +108 -0
- package/dist/skills/opengame-enemies/references/threejs.md +59 -0
- package/dist/skills/opengame-front-end/CHANGELOG.md +4 -0
- package/dist/skills/opengame-front-end/SKILL.md +85 -39
- package/dist/skills/opengame-front-end/references/menus.md +42 -8
- package/dist/skills/opengame-game-feel/CHANGELOG.md +11 -0
- package/dist/skills/opengame-game-feel/SKILL.md +95 -47
- package/dist/skills/opengame-game-feel/references/feel-numbers.md +59 -0
- package/dist/skills/opengame-game-feel/references/killcam.md +88 -0
- package/dist/skills/opengame-jam/CHANGELOG.md +12 -0
- package/dist/skills/opengame-jam/SKILL.md +48 -33
- package/dist/skills/opengame-lighting/CHANGELOG.md +9 -0
- package/dist/skills/opengame-lighting/SKILL.md +85 -34
- package/dist/skills/opengame-loading/CHANGELOG.md +4 -0
- package/dist/skills/opengame-loading/SKILL.md +78 -38
- package/dist/skills/opengame-loading/helpers/loading-count.mjs +115 -0
- package/dist/skills/opengame-loading/references/threejs.md +32 -7
- package/dist/skills/opengame-look/CHANGELOG.md +9 -0
- package/dist/skills/opengame-look/SKILL.md +122 -51
- package/dist/skills/opengame-look/references/matching-a-reference.md +73 -0
- package/dist/skills/opengame-look/references/painterly.md +69 -0
- package/dist/skills/opengame-look/references/post-and-lens.md +10 -3
- package/dist/skills/opengame-maps/CHANGELOG.md +9 -0
- package/dist/skills/opengame-maps/SKILL.md +78 -0
- package/dist/skills/opengame-maps/references/map-spec.md +77 -0
- package/dist/skills/opengame-mobile/CHANGELOG.md +4 -0
- package/dist/skills/opengame-mobile/SKILL.md +18 -18
- package/dist/skills/opengame-montage-make/CHANGELOG.md +5 -0
- package/dist/skills/opengame-montage-make/SKILL.md +187 -0
- package/dist/skills/opengame-montage-make/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-make/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-montage-make/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-make/references/finishing.md +126 -0
- package/dist/skills/opengame-montage-make/references/measure.md +282 -0
- package/dist/skills/opengame-montage-make/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-make/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-make/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-make/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-make/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-make/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-make/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-make/references/song.md +64 -0
- package/dist/skills/opengame-montage-plan/CHANGELOG.md +5 -0
- package/dist/skills/opengame-montage-plan/SKILL.md +197 -0
- package/dist/skills/opengame-montage-plan/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-plan/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-plan/references/measure.md +282 -0
- package/dist/skills/opengame-montage-plan/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-plan/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-plan/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-plan/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-plan/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-plan/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-plan/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-plan/references/song.md +64 -0
- package/dist/skills/opengame-montage-review-and-improve/CHANGELOG.md +5 -0
- package/dist/skills/opengame-montage-review-and-improve/SKILL.md +178 -0
- package/dist/skills/opengame-montage-review-and-improve/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-montage-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-review-and-improve/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-review-and-improve/references/song.md +64 -0
- package/dist/skills/opengame-multiplayer/CHANGELOG.md +15 -0
- package/dist/skills/opengame-multiplayer/SKILL.md +143 -0
- package/dist/skills/opengame-multiplayer/references/bot-lobbies.md +71 -0
- package/dist/skills/opengame-multiplayer/references/netcode.md +165 -0
- package/dist/skills/opengame-performance/CHANGELOG.md +8 -0
- package/dist/skills/opengame-performance/SKILL.md +106 -65
- package/dist/skills/opengame-performance/helpers/landing-pacer.mjs +86 -0
- package/dist/skills/opengame-performance/references/measuring.md +51 -0
- package/dist/skills/opengame-performance/references/webgpu.md +86 -0
- package/dist/skills/opengame-production/CHANGELOG.md +13 -0
- package/dist/skills/opengame-production/SKILL.md +119 -54
- package/dist/skills/opengame-production/references/team.md +107 -0
- package/dist/skills/opengame-production/references/templates.md +106 -16
- package/dist/skills/opengame-quality-bar/CHANGELOG.md +10 -0
- package/dist/skills/opengame-quality-bar/SKILL.md +94 -42
- package/dist/skills/opengame-quality-bar/references/cheap-tells.md +14 -7
- package/dist/skills/opengame-quality-bar/references/judges.md +95 -0
- package/dist/skills/opengame-quality-bar/references/review-prompt.md +10 -5
- package/dist/skills/opengame-rhythm/CHANGELOG.md +5 -0
- package/dist/skills/opengame-rhythm/SKILL.md +138 -0
- package/dist/skills/opengame-rhythm/references/charting.md +109 -0
- package/dist/skills/opengame-rhythm/references/timing.md +92 -0
- package/dist/skills/opengame-router/CHANGELOG.md +12 -0
- package/dist/skills/opengame-router/SKILL.md +14 -7
- package/dist/skills/opengame-scene-audit/CHANGELOG.md +15 -0
- package/dist/skills/opengame-scene-audit/SKILL.md +64 -47
- package/dist/skills/opengame-scene-audit/helpers/scene-audit.js +97 -19
- package/dist/skills/opengame-sdk/CHANGELOG.md +16 -0
- package/dist/skills/opengame-sdk/SKILL.md +27 -10
- package/dist/skills/opengame-sdk/references/engines.md +2 -2
- package/dist/skills/opengame-sdk/references/identity.md +10 -11
- package/dist/skills/opengame-sdk/references/leaderboards.md +11 -1
- package/dist/skills/opengame-sdk/references/radio.md +1 -1
- package/dist/skills/opengame-stability/CHANGELOG.md +4 -0
- package/dist/skills/opengame-stability/SKILL.md +59 -27
- package/dist/skills/opengame-trailer-make/CHANGELOG.md +5 -0
- package/dist/skills/opengame-trailer-make/SKILL.md +164 -0
- package/dist/skills/opengame-trailer-make/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-make/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-make/references/core.md +129 -0
- package/dist/skills/opengame-trailer-make/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-make/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-make/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-make/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-make/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-make/references/music.md +148 -0
- package/dist/skills/opengame-trailer-make/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-make/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-make/references/review.md +141 -0
- package/dist/skills/opengame-trailer-make/references/title.md +92 -0
- package/dist/skills/opengame-trailer-plan/CHANGELOG.md +5 -0
- package/dist/skills/opengame-trailer-plan/SKILL.md +176 -0
- package/dist/skills/opengame-trailer-plan/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-plan/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-plan/references/core.md +129 -0
- package/dist/skills/opengame-trailer-plan/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-plan/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-plan/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-plan/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-plan/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-plan/references/music.md +148 -0
- package/dist/skills/opengame-trailer-plan/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-plan/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-plan/references/reference-set.md +92 -0
- package/dist/skills/opengame-trailer-plan/references/review.md +141 -0
- package/dist/skills/opengame-trailer-plan/references/title.md +92 -0
- package/dist/skills/opengame-trailer-review-and-improve/CHANGELOG.md +5 -0
- package/dist/skills/opengame-trailer-review-and-improve/SKILL.md +145 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/core.md +129 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/music.md +148 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/review.md +141 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/title.md +92 -0
- package/dist/skills/opengame-verification/CHANGELOG.md +11 -0
- package/dist/skills/opengame-verification/SKILL.md +113 -48
- package/dist/skills/opengame-weapons/CHANGELOG.md +11 -0
- package/dist/skills/opengame-weapons/SKILL.md +129 -55
- package/dist/skills/opengame-weapons/references/handling-numbers.md +42 -0
- package/dist/skills/opengame-weapons/references/reloads-and-hands.md +96 -0
- package/dist/skills/opengame-weapons/references/sights-and-scopes.md +98 -0
- package/dist/skills/opengame-weapons/references/threejs.md +71 -0
- package/dist/skills/opengame-world-physics/CHANGELOG.md +9 -0
- package/dist/skills/opengame-world-physics/SKILL.md +55 -24
- package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
- package/package.json +1 -1
package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/measure.md
ADDED
|
@@ -0,0 +1,282 @@
|
|
|
1
|
+
# Measuring a cut: the recipes behind every gate
|
|
2
|
+
|
|
3
|
+
Every gate in these skills is a number you can get from the rendered file, the take's own capture log, or the
|
|
4
|
+
audio. None of it needs a special tool: ffmpeg, ffprobe, Python with numpy and scipy, OpenCV for optical flow, and
|
|
5
|
+
librosa for beats and onsets cover all of it. Install them in a private virtual environment for the film. Never play
|
|
6
|
+
audio aloud to "check" it: an agent measures sound, it does not listen.
|
|
7
|
+
|
|
8
|
+
Rules that apply to every recipe:
|
|
9
|
+
|
|
10
|
+
- Measure the full-resolution review render (or the delivered file), never a proxy or an older cut. A gate passed on
|
|
11
|
+
the wrong file is a gate that did not run.
|
|
12
|
+
- Frame numbers are 0-based at the film's rate. At 60 fps, seconds = frame / 60.
|
|
13
|
+
- Grab exact frames by index with `select=eq(n\,N)`, never by `-ss` seeking, which lands on the wrong frame.
|
|
14
|
+
- Prefer the capture's own logs (camera, speed, probe) over picture analysis when you have them. A picture measure
|
|
15
|
+
guesses at what the log already knows. Use picture measures for files you did not capture (references, a closed
|
|
16
|
+
game, a critic's review).
|
|
17
|
+
- Run heavy decodes politely: `nice -n 10`, `ffmpeg -threads 6`, through your machine's job queue if it has one.
|
|
18
|
+
|
|
19
|
+
## 1. Stream facts, frames and stills
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
# size, rate, frame count, colour tags, duration of each stream
|
|
23
|
+
ffprobe -v error -count_frames -show_entries \
|
|
24
|
+
stream=index,codec_type,width,height,r_frame_rate,avg_frame_rate,nb_read_frames,pix_fmt,color_primaries,color_transfer,color_space,duration \
|
|
25
|
+
-of json cut.mp4
|
|
26
|
+
|
|
27
|
+
# one exact frame, and a strip of consecutive frames (8 per row) for motion checks
|
|
28
|
+
ffmpeg -v error -i cut.mp4 -vf "select=eq(n\,1234)" -vframes 1 f1234.png
|
|
29
|
+
ffmpeg -v error -i cut.mp4 -vf "select=between(n\,1200\,1263),scale=480:-1,tile=8x8" -vframes 1 strip_1200.jpg
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
- Expected: the planned size, `r_frame_rate` and `avg_frame_rate` both exactly the film rate (60/1), BT.709 primaries,
|
|
33
|
+
transfer and matrix, and audio and video durations within one frame.
|
|
34
|
+
- If a re-encode leaves the colour tags `unknown`, write them into the stream: for H.264,
|
|
35
|
+
`-bsf:v h264_metadata=colour_primaries=1:transfer_characteristics=1:matrix_coefficients=1`.
|
|
36
|
+
- **Every frame, never every second frame,** for any shot with a body, a fall, a hero move or a slow-motion span.
|
|
37
|
+
An every-2nd-frame sheet hides a head flipping between two poses on alternate frames; on the OG Snipers montage that
|
|
38
|
+
defect passed the director and a gate and was found after the cut was called final.
|
|
39
|
+
|
|
40
|
+
## 2. Frozen, duplicate, black and unique frames
|
|
41
|
+
|
|
42
|
+
```bash
|
|
43
|
+
ffmpeg -v error -i cut.mp4 -f framemd5 - > frames.md5 # one hash per frame
|
|
44
|
+
ffmpeg -v info -i cut.mp4 -vf freezedetect=n=0.001:d=0.4 -f null - 2>&1 | grep freeze_
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
- Unique frames: count distinct hashes in `frames.md5`. For footage you captured frame by frame, unique frames must
|
|
48
|
+
equal frames. A frame-count check alone passed an OG Clash cut whose first 402 frames were one frozen picture.
|
|
49
|
+
- Duplicate share in slow motion: identical consecutive hashes divided by frames in the slow span. Real simulated
|
|
50
|
+
slow motion has none; cheap interpolated or frame-doubled edits measured 8-10 %.
|
|
51
|
+
- Black: decode to 160x90 grey and call a frame black when 98 % of its pixels sit below luma code 26. A run outside a
|
|
52
|
+
designed black slug fails. A film's own "black" check that only looks for fully black frames missed a set that read
|
|
53
|
+
as black on a phone.
|
|
54
|
+
|
|
55
|
+
```python
|
|
56
|
+
import subprocess, numpy as np
|
|
57
|
+
w, h = 160, 90
|
|
58
|
+
raw = subprocess.run(["ffmpeg", "-v", "error", "-i", "cut.mp4", "-vf", f"scale={w}:{h},format=gray",
|
|
59
|
+
"-f", "rawvideo", "-"], capture_output=True, check=True).stdout
|
|
60
|
+
frames = np.frombuffer(raw, np.uint8).reshape(-1, h, w)
|
|
61
|
+
black = [i for i, f in enumerate(frames) if (f < 26).mean() >= 0.98]
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
## 3. Cuts and shot lengths
|
|
65
|
+
|
|
66
|
+
- If you built the cut from an edit list, take the cut frames from it. That is the truth.
|
|
67
|
+
- For a file you did not cut, detect cuts adaptively: per frame, the mean absolute difference of a 160x90 grey frame
|
|
68
|
+
against the previous one, compared with a rolling median of the last 30 differences; a cut is a difference over
|
|
69
|
+
about 4x the median that does not return to the previous picture within 2 frames (that return is a flash or a strobe,
|
|
70
|
+
not a cut). ffmpeg's `select='gt(scene,0.3)'` alone misses 30-70 % of cuts on dark footage.
|
|
71
|
+
- Report: cut count, cuts per second, mean and median shot length, share of shots under 0.5 s and under 1 s, the
|
|
72
|
+
longest run of equal-length shots (in beats), and cuts per 10 s window across the film.
|
|
73
|
+
|
|
74
|
+
## 4. Motion: camera speed, seams, ramps
|
|
75
|
+
|
|
76
|
+
Camera speed is apparent motion in pixels per frame at 1080p. From a capture log, project the camera's motion. From
|
|
77
|
+
pictures, use dense optical flow:
|
|
78
|
+
|
|
79
|
+
```python
|
|
80
|
+
import cv2, numpy as np, json, sys
|
|
81
|
+
cap = cv2.VideoCapture(sys.argv[1]); prev = None; rows = []
|
|
82
|
+
while True:
|
|
83
|
+
ok, frame = cap.read()
|
|
84
|
+
if not ok: break
|
|
85
|
+
g = cv2.cvtColor(cv2.resize(frame, (480, 270)), cv2.COLOR_BGR2GRAY)
|
|
86
|
+
if prev is not None:
|
|
87
|
+
flow = cv2.calcOpticalFlowFarneback(prev, g, None, 0.5, 3, 15, 3, 5, 1.2, 0)
|
|
88
|
+
mag = np.linalg.norm(flow, axis=2) * 4 # 480 wide -> 1080p pixels
|
|
89
|
+
ang = np.degrees(np.arctan2(np.median(flow[..., 1]), np.median(flow[..., 0])))
|
|
90
|
+
rows.append({"px": float(np.median(mag)), "p90": float(np.percentile(mag, 90)), "deg": float(ang)})
|
|
91
|
+
prev = g
|
|
92
|
+
json.dump(rows, open("flow.json", "w"))
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
- Every frame of every shot moves ≥ 1 px/f unless the plan scopes a hold that pays off within 0.3 s.
|
|
96
|
+
- Seams: the last 3 frames out and the first 4 frames in. Measure the first frame after the cut too: a rig that starts
|
|
97
|
+
its camera on output frame 0 makes every first frame a still, and critics read those as stutters.
|
|
98
|
+
- Direction (a trailer): compare the median flow angle on each side; fail a seam slower than 0.6 px/f on either side or
|
|
99
|
+
more than 90° apart unless the plan states a cause. A montage carries speed across the cut and lets direction differ
|
|
100
|
+
(FAINT's seams sit a median 115° apart); there, fail only a still-to-still seam.
|
|
101
|
+
- Speed at a montage cut: over the last 3 frames out and the first 3 in, fail when the faster side is more than 30 %
|
|
102
|
+
above the slower one (or the directions part by more than 30°) while both move over 8 px/f; a cut between two still
|
|
103
|
+
pictures needs no match. Report whether each side's cut frame sits within 2 frames of its own speed peak over ±12
|
|
104
|
+
frames.
|
|
105
|
+
- Constant velocity: a third-person shot whose smoothed flow has a coefficient of variation under 0.15 is a robotic
|
|
106
|
+
dolly. No more than a quarter of them.
|
|
107
|
+
- Flow around hero cuts: frames −1 and +1 each at least 1.4x the mean of frames −8 to −5.
|
|
108
|
+
- Beat-phase motion swing: bin every frame's flow by its phase within the beat (20 bins); swing = the largest bin over
|
|
109
|
+
the smallest. Kaiser's montage edits measured 1.6-3.3x with the peak on the beat; a capture reel cut to a click track
|
|
110
|
+
measured 1.37x with the peak mid-beat.
|
|
111
|
+
- **Zoom blindness:** a phase-correlation motion measure on a small decode reads in coarse steps and cannot see a
|
|
112
|
+
zoom. Take camera speed from the capture's camera log before calling a shot dead or a seam regressed.
|
|
113
|
+
|
|
114
|
+
Ramps:
|
|
115
|
+
|
|
116
|
+
- From the capture log (best): the simulation speed per output frame. Report the slowest speed, where it sits in the
|
|
117
|
+
shot, the largest one-frame change as a ratio, |s(t+1) / s(t) − 1| (fail over 15 % on a cinematic pair of frames),
|
|
118
|
+
and any run of 20 or more cinematic frames whose speed never moves (maximum over minimum − 1 under 2 %), which fails
|
|
119
|
+
when it follows a payoff.
|
|
120
|
+
- From pictures: a ramp is legible when the flow inside one shot changes by 3x or more and the content does not explain
|
|
121
|
+
it (the camera did not simply stop). On the OG Clash trailer six shots had real quarter-speed spans and a blind
|
|
122
|
+
critic's flow analysis still found zero ramps, because the camera moved through them at one speed.
|
|
123
|
+
- Slow spans: camera median ≥ 2 px/f, never under 1. Character angular rate (from the probe: the angle each joint chain
|
|
124
|
+
turns per output frame) on no frame under 40 % of the span's median. Under that, the viewer sees a freeze, usually a
|
|
125
|
+
hitstop timer counted on raw time.
|
|
126
|
+
|
|
127
|
+
## 5. Sharpness, light, colour, flashes
|
|
128
|
+
|
|
129
|
+
```bash
|
|
130
|
+
ffmpeg -v error -i cut.mp4 -vf "signalstats,metadata=print:file=stats.txt" -f null - # YAVG, YMIN, YMAX, SATAVG per frame
|
|
131
|
+
ffmpeg -v error -i cut.mp4 -vf "blurdetect,metadata=print:file=blur.txt" -f null - # per-frame blur (FFmpeg 5.1 or newer)
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
- Luma at cuts: decode to 160x90 grey as in section 2 and take the absolute difference of the mean of the cut frame c
|
|
135
|
+
and the frame c − 2. Median ≤ 18, none over 40 except cuts the plan declares as story beats. (`signalstats` YAVG is
|
|
136
|
+
in limited range; if you use it, scale the thresholds to about 15.5 and 34.) Predict a fix as an exposure trim on the
|
|
137
|
+
incoming shot. A montage whose approved look alternates dark gameplay and bright cinematics (FAINT's median jump is
|
|
138
|
+
37, with 29 of 68 cuts over 40) waives the gate at gameplay-to-cinematic cuts.
|
|
139
|
+
- Sharp subject: every shot's blur within the film's own norm (median plus a margin you set from your sharpest shots).
|
|
140
|
+
A frame with nothing sharp, or a defocused foreground over 10 % of the frame, fails. A Laplacian variance per shot
|
|
141
|
+
(`cv2.Laplacian(gray, cv2.CV_64F).var()`) is the fallback.
|
|
142
|
+
- Flat white on effects: decode to RGB and count pixels whose R, G and B are all at or above 225 in limited-range code
|
|
143
|
+
values. ffmpeg's usual conversion to full-range RGB moves 225 to about 244, so threshold the converted frame at 244.
|
|
144
|
+
A hero effect held on screen stays at or under 0.5 % of the frame; measure held effect frames, not the single impact
|
|
145
|
+
flash frame.
|
|
146
|
+
|
|
147
|
+
```python
|
|
148
|
+
img = cv2.cvtColor(cv2.imread("f1234.png"), cv2.COLOR_BGR2RGB)
|
|
149
|
+
flat_white = (img >= 244).all(axis=2).mean() * 100 # percent of frame
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
- Grade: content luma Y 40-70 (limited range) for a dark genre, clipping under 3 %. Per act, the mean chroma (U, V)
|
|
153
|
+
vector should move by 4 units or more between acts when the plan has a colour script.
|
|
154
|
+
- Flashes: a luma rise of 12 or more over 2 frames away from a cut. Every one gets a designed sound or is deliberately
|
|
155
|
+
silent. Photosensitivity: no more than 3 general or red flashes in any 1 s (WCAG 2.3.1 counts a flash over more than 25 % of
|
|
156
|
+
any 10° field of view, a much smaller area than a quarter of the frame); run an open-source analyser such as EA's IRIS
|
|
157
|
+
on every cut sent to anyone.
|
|
158
|
+
- Banding: look at a 4x-contrast crop of every dark gradient (night sky, fog). If it bands, raise the capture bitrate
|
|
159
|
+
(HEVC at 300 Mbps banded least on the OG Clash storm sky) before touching the grade.
|
|
160
|
+
|
|
161
|
+
## 6. Loudness, holes, the loudest moment, tails
|
|
162
|
+
|
|
163
|
+
```bash
|
|
164
|
+
ffmpeg -nostats -i cut.mp4 -filter_complex ebur128=peak=true -f null - 2>&1 | tail -15 # I, LRA, true peak
|
|
165
|
+
ffmpeg -v error -i cut.mp4 -af "ebur128=metadata=1,ametadata=mode=print:key=lavfi.r128.S:file=short.txt" -f null -
|
|
166
|
+
ffmpeg -v error -i cut.mp4 -ac 1 -ar 48000 -f f32le mono.f32 # samples for numpy
|
|
167
|
+
```
|
|
168
|
+
|
|
169
|
+
- Integrated loudness and true peak on the delivered AAC, not on the WAV you mixed: the encode moves the peak.
|
|
170
|
+
- Short-term spread across the body (a trailer): at least 8 LU from the quietest to the loudest section. The OG Clash
|
|
171
|
+
trailer held 2.3 LU for 32 s and read as a flat wall.
|
|
172
|
+
- RMS in 50 ms windows: the loudest window's time is the loudest moment. In a trailer it belongs on the boss impact,
|
|
173
|
+
an explosion or the title, never on a mid-film feature. A montage on the owner's song has no slam: there the check is
|
|
174
|
+
that nothing but a payoff outranks the payoffs (section 8).
|
|
175
|
+
- A designed hole (trailers only): at least 20 dB under the previous 2 s, 0.3-2.4 s long, followed within 0.25 s by a hit at least
|
|
176
|
+
15 dB up. Inside it, no 25 ms window under −90 dBFS (digital zero reads as a dropout), and the 10 frames after its cut at
|
|
177
|
+
least 20 dB under the 10 frames before.
|
|
178
|
+
- Tails: at every cut, the RMS of the 2 frames after against the 2 frames before; a drop over 20 dB is a sound cut dead
|
|
179
|
+
unless it is a designed silence.
|
|
180
|
+
- Clicks: at every clip edge, fail a first-difference peak of the samples over 8x the local median within ±10 ms of the
|
|
181
|
+
edge while the window is above −20 dBFS.
|
|
182
|
+
- Silence: the quietest 25 ms RMS window of the film stays above −26 dBFS, excluding the first 150 ms and the final
|
|
183
|
+
0.8 s; write a waiver for an intended quiet outro.
|
|
184
|
+
|
|
185
|
+
## 7. Beats, onsets and sync
|
|
186
|
+
|
|
187
|
+
```python
|
|
188
|
+
import librosa, numpy as np
|
|
189
|
+
y, sr = librosa.load("track.wav", sr=48000, mono=True)
|
|
190
|
+
onsets = librosa.onset.onset_detect(y=y, sr=sr, units="time")
|
|
191
|
+
tempo, beats = librosa.beat.beat_track(y=y, sr=sr, units="time")
|
|
192
|
+
```
|
|
193
|
+
|
|
194
|
+
- Never trust one beat tracker. Refine the tempo from attacks in one band (a hi-hat or snare band), fit beat index
|
|
195
|
+
against attack time by least squares, and check half and double tempo with onset autocorrelation. On the OG Clash
|
|
196
|
+
track 32 high-band attacks gave 105.0001 BPM with a 0.08 ms residual, where two trackers said 105.04 and 105.47.
|
|
197
|
+
- Click check: mix 2 kHz clicks on downbeats and 1 kHz on beats at −6 dB over the track, then measure the track's own
|
|
198
|
+
attacks within ±15 ms of each grid beat. Pass when every downbeat you cut on sits within one frame.
|
|
199
|
+
- Cuts married to sound: the share of cuts within ±50 ms of an onset of the final mix, against a null made by shifting
|
|
200
|
+
the cut list by random offsets 1,000 times. Aim for 30 % or more and at least 2x the null on the hero section.
|
|
201
|
+
- Performed on the beat: the share of action peaks (muzzle flash, impact, jump apex, from the probe or the luma) within
|
|
202
|
+
±2 frames of a beat. Cuts on the beat are not this.
|
|
203
|
+
- Beat lock of a reference: convert each cut time to a phase angle within its beat and run a Rayleigh test (the mean
|
|
204
|
+
resultant length R and its p-value); most official trailers do not lock (p from 0.93 down to 0.003 across the
|
|
205
|
+
measured set), Kaiser's edits do. Also report the share of cuts in the last eighth of a beat.
|
|
206
|
+
- Best audio/video shift: slide the cut list against the onset list in whole frames from −6 to +6 and keep the shift
|
|
207
|
+
with the most cuts within a frame of an onset; Kaiser's edits peak at the picture 1-2 frames early.
|
|
208
|
+
- A sound's time is its audible attack: the rise into the peak of its 200 Hz-12 kHz envelope, not its broadband peak.
|
|
209
|
+
Dull reports placed by peak started 4-10 frames early on the OG Snipers montage.
|
|
210
|
+
- Slow-motion hits: the flash's visual peak can land many output frames after its engine event (about 10 frames at
|
|
211
|
+
0.3x). Measure the flash frame on the picture and put the sound there.
|
|
212
|
+
|
|
213
|
+
## 8. Sound as heard
|
|
214
|
+
|
|
215
|
+
- Payoff level as heard: band-pass the delivered mix (or the game bus, then the mix) to 150 Hz-8 kHz and take the RMS
|
|
216
|
+
over 300 ms from each payoff's attack. Table every payoff with the film's median and spread. A gate that measured
|
|
217
|
+
each gunshot asset at a fixed level said "spread 0.1 dB" while the hits as heard spread 6-15 dB, because impacts,
|
|
218
|
+
confirms and medals piled onto some shots and not others.
|
|
219
|
+
- Rank every transient in the film; nothing that is not a payoff may be louder than the loudest payoff.
|
|
220
|
+
- Designed hits: at least 35 % of their energy in 300 Hz-5 kHz (sub-only hits are silent on a phone) and at least
|
|
221
|
+
6 dB over the music in that band over their first 50 ms, for a trailer. A montage on the owner's song sits payoffs
|
|
222
|
+
about 3 dB over the song in 1-5 kHz instead.
|
|
223
|
+
- Music level in the mix (accidental ducks): fit the music stem to the mix by least squares in 100 ms windows. The
|
|
224
|
+
fitted gain should stay flat within 1.5 dB under voice and effects; a dip is a limiter pulling the bed down.
|
|
225
|
+
- Song untouched (a montage): align the song file to the music bus by cross-correlation and fit one gain over 1 s
|
|
226
|
+
windows across the film. The gain must hold within 0.5 dB everywhere except an agreed fade at the end; a jump is an
|
|
227
|
+
edit or a duck.
|
|
228
|
+
- Intelligibility: run an open-source speech recogniser (Whisper or faster-whisper) on the mixed master, four
|
|
229
|
+
windows per line; at least three of four must read the line correctly. Test callouts over the real song at several
|
|
230
|
+
offsets with two different recognisers before mixing; treat the result as a screen, and the owner's ear as the
|
|
231
|
+
decision.
|
|
232
|
+
|
|
233
|
+
## 9. Characters, subjects and recurring elements
|
|
234
|
+
|
|
235
|
+
- Subject in frame: project the probe's subject point (or box) through the logged camera on every frame. A follow
|
|
236
|
+
camera keeps the hero's centre inside 12-85 % of frame height and 5-95 % of width; a drift keeps at least 60 % of the
|
|
237
|
+
subject's box in frame, with no run of 30 frames or more that is 70 % sky or empty ground.
|
|
238
|
+
- Gap to a title or insert: project the insert's box and a conservative 3D box around every character and prop on
|
|
239
|
+
every frame; the smallest pixel gap must stay above 0.
|
|
240
|
+
- Pose pops: on head, hand and weapon crops, flag frame n when it differs strongly from both n−1 and n+1 while n−1 and
|
|
241
|
+
n+1 match each other (an A-B-A flip). Run it on every body in every slow span, not only on the hips.
|
|
242
|
+
- Surface flicker (z-fighting): warp both neighbours onto each frame with optical flow and flag 32x32 blocks that
|
|
243
|
+
differ from both warped neighbours while those agree. Leave out whip frames over 40 px/f, 2 frames either side of a
|
|
244
|
+
cut, HUD zones and close occluders. Scan only the changed spans (diff the frozen edit list against the last checked
|
|
245
|
+
one frame by frame and list the ranges whose take or source frame changed), print the verdict before drawing strips,
|
|
246
|
+
keep a cleared list keyed by take, frames and box, and calibrate the threshold on a frame the owner flagged; an
|
|
247
|
+
uncalibrated scan ranked the one real defect 658th under camera motion.
|
|
248
|
+
- Hero jitter: project the hero's position through the camera on every frame, fit a quadratic in game time over 9
|
|
249
|
+
frames, and take the RMS of the residual; pass at 1.5-2.0 px. On OG Snipers it read 51-68 px before the draw-sync hook
|
|
250
|
+
and 0.2-0.4 px after.
|
|
251
|
+
- Cross-clip sheets: crop the same region (kill feed, hit marker, score bug, position badge, the hero's weapon, the
|
|
252
|
+
title) from every clip onto one sheet and find each element's anchor by template matching. Report the anchors in
|
|
253
|
+
pixels. One such sheet found in minutes a feed-spacing defect that fifteen deliveries had missed.
|
|
254
|
+
- Bot tells: compare the scripted player's view log with 3-5 minutes of a good human playing the same game: time to
|
|
255
|
+
aim, flick size and duration, overshoot, how often the view sits dead still, hit rate. A screen, not a verdict.
|
|
256
|
+
|
|
257
|
+
## 10. Titles and inserts
|
|
258
|
+
|
|
259
|
+
- Stillness at rest: render the title shot with the camera locked and its energy off; every frame's hash must match.
|
|
260
|
+
- Camera match: reproject markers placed on logged joints through your rebuilt camera; mean error ≤ 0.1 px, maximum
|
|
261
|
+
≤ 0.25 px, and a background feature track ≤ 0.25 px RMS with no drift.
|
|
262
|
+
- Drift of the inserted object ≤ 0.3 px/f against its anchor; crispness (Laplacian variance) at least 0.9 of its hold
|
|
263
|
+
median; size at rest as the plan says.
|
|
264
|
+
- Words: crop every word the plan puts on screen from the full-resolution render and read it. The scene graph is not
|
|
265
|
+
evidence: a call to action once faced away from the camera for a whole round while the handoff called it built.
|
|
266
|
+
|
|
267
|
+
## 11. Delivery checks
|
|
268
|
+
|
|
269
|
+
```bash
|
|
270
|
+
ffmpeg -i delivery.mp4 -i master.mov -lavfi "[0:v][1:v]psnr" -f null - # PSNR against the master
|
|
271
|
+
ffmpeg -i delivery.mp4 -i master.mov -lavfi "[0:v][1:v]ssim" -f null - # SSIM against the master
|
|
272
|
+
```
|
|
273
|
+
|
|
274
|
+
- Measure PSNR and SSIM before calling a compressed delivery "visually lossless". Both inputs must have the same size
|
|
275
|
+
and frame count: scale one first (`[1:v]scale=1920:1080[m];[0:v][m]psnr`) when the delivery is smaller than the
|
|
276
|
+
master.
|
|
277
|
+
- A mix belongs to one picture: hash the edit list (every slot's take, in and out, source in and payoff frames) into a
|
|
278
|
+
signature, store it with the mix, and mux only when they match. A stale mix muxed onto new picture put two clips of
|
|
279
|
+
the OG Snipers montage 21-27 frames off.
|
|
280
|
+
- Copying to the owner's drive: write to a plain temporary name (`cut.mp4.part-12345`, never a name starting with a
|
|
281
|
+
dot, which some network mounts refuse), rename, then read the file back and compare size and checksum. Report "not
|
|
282
|
+
delivered" until the read-back matches.
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
# Music: choosing, sourcing, generating and measuring the track
|
|
2
|
+
|
|
3
|
+
"Good music for your trailer is more important than almost anything else" (Derek Lieu, trailer editor). The track is
|
|
4
|
+
the film's clock: choose it, measure it and write the beat grid before the shot list.
|
|
5
|
+
|
|
6
|
+
Most people bring no music and no idea what they want. Decide automatically, or ask once with a default.
|
|
7
|
+
|
|
8
|
+
## 1. The decision
|
|
9
|
+
|
|
10
|
+
```
|
|
11
|
+
The person gave a track? -> use it (still measure it; it may be a splice)
|
|
12
|
+
The game has its own score/stems? -> a trailer edit of the game's theme beats any library track
|
|
13
|
+
(in-game loops are built to loop: re-edit them into an arc)
|
|
14
|
+
They own or licensed a catalogue? -> recommend 3 tracks from music they have the rights to use in a trailer
|
|
15
|
+
They want generated music and -> generate 3-5 takes from a composition plan (section 4), on their own
|
|
16
|
+
approve the spend? account, after they say yes to the cost
|
|
17
|
+
Otherwise -> recommend a genre, a tempo and 3 licensable tracks (section 5), and say what
|
|
18
|
+
they must download, buy or approve
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
Always present 2-3 measured candidates with a 15 s excerpt each (the excerpt around the drop) and a default. The one
|
|
22
|
+
music question the plan may ask is "which of these three", never "what music do you want". Check the licence covers a
|
|
23
|
+
trailer and the platforms it will be posted to; save the proof beside the file.
|
|
24
|
+
|
|
25
|
+
## 2. Genre and tempo from the game's tone
|
|
26
|
+
|
|
27
|
+
Read the tone from the art, palette, store copy and existing soundtrack.
|
|
28
|
+
|
|
29
|
+
| Tone | Genre | BPM (feel) | Structure |
|
|
30
|
+
|---|---|---|---|
|
|
31
|
+
| Military, horror, zombies, grim | hybrid orchestral and synth, taiko, distorted bass, braams | 80-110 (often half-time feel at 140-170) | two stops, sub drops, a big final hit with a tail for the slate |
|
|
32
|
+
| Heroic fantasy, sci-fi epic | epic orchestral, hybrid choir | 90-130 | a rising ostinato, a key lift of 1-2 semitones into the finale |
|
|
33
|
+
| Arcade, roguelike, shooter, racing | electronic, rock, synthwave, drum and bass | 120-150 (DnB 170-175) | 8-bar sections, the drop on the core verb |
|
|
34
|
+
| Cozy, farming, wholesome | acoustic, indie folk, lo-fi, glockenspiel | 70-100 | no braams, no hard stops, a warm tail, few hard cuts |
|
|
35
|
+
| Cute, comedy, party | pizzicato, ukulele, chiptune, brass stabs | 100-130 | comedic stops timed to gags |
|
|
36
|
+
| Puzzle, abstract, minimal | minimal electronic, ambient pulse, piano | 90-120 | longer shots (3-4 s average), one gentle build |
|
|
37
|
+
| Pixel, retro | chiptune or chiptune with real drums | 110-140 | keep the lo-fi palette consistent |
|
|
38
|
+
| Rhythm game | the game's own track | the song's | every action on the beat (here it is true) |
|
|
39
|
+
| Upbeat co-op action (OG Clash) | driving electronic and orchestral hybrid, instrumental | about 105 | calm intro, hard drop, full action, quiet resolve |
|
|
40
|
+
|
|
41
|
+
A 4/4 bar lasts 240 / BPM seconds (120 BPM is 2.0 s, 105 is 2.286 s, 90 is 2.667 s). Plan in 4, 8 and 16-bar
|
|
42
|
+
phrases. A 60 s trailer at 120 BPM is 30 bars: intro 4, build 8, drop 8, a stop of 1-2, finale 6, and a button (the
|
|
43
|
+
final hit with 2 s of tail under the slate).
|
|
44
|
+
|
|
45
|
+
**What the track must have:** a clear arc (it is not a loop), a real drop where the picture needs energy, at least one
|
|
46
|
+
place that can become a designed silence, a resolve or final hit to land the title or button on, and no vocals (they
|
|
47
|
+
fight the voice lines). If the track has no risers or fills, the build has to come from picture and sound design; say
|
|
48
|
+
so in the plan.
|
|
49
|
+
|
|
50
|
+
## 3. Music the person already has
|
|
51
|
+
|
|
52
|
+
Their own score, a commissioned track or a catalogue they licensed comes first. Full songs are not trailer cues: pick
|
|
53
|
+
the 60-90 s window with the best arc and edit it to length (section 6). If the catalogue has searchable metadata
|
|
54
|
+
(instruments, mood, tempo), search it by the tone table above and shortlist three. Never assume that music made for a
|
|
55
|
+
game, or music on a platform the game is published on, is cleared for that game's trailer: confirm the rights.
|
|
56
|
+
|
|
57
|
+
## 4. Generating a cue (only with the person's account and go-ahead)
|
|
58
|
+
|
|
59
|
+
Generated music costs money and uses the person's account. Ask before the first paid call, say what it is for and what
|
|
60
|
+
it will cost, and record their approval word for word. Put every paid call behind a cap and a ledger.
|
|
61
|
+
|
|
62
|
+
Music generators that take a composition plan (ElevenLabs Music is one) accept up to 30 sections of 3-120 s
|
|
63
|
+
each, with positive and negative styles per section. Put "instrumental" in the positive styles and "vocals, lyrics" in the negative ones, and never name
|
|
64
|
+
a real artist (the API refuses). Generate 3-5 takes, measure each (section 7), keep the one whose drop and final hit
|
|
65
|
+
land closest to the plan. Generators do not guarantee bar-exact boundaries, so always re-measure.
|
|
66
|
+
|
|
67
|
+
```json
|
|
68
|
+
{"chunks":[
|
|
69
|
+
{"text":"[Intro]","duration_ms":8000,"positive_styles":["instrumental","dark hybrid orchestral trailer","120 BPM","D minor","low string ostinato","distant taiko","sparse"],"negative_styles":["vocals","lyrics","fade in longer than 1 second"]},
|
|
70
|
+
{"text":"[Build]","duration_ms":16000,"positive_styles":["instrumental","rising ostinato","percussion building every 4 bars","risers","tension"],"negative_styles":["vocals","drop","resolution"]},
|
|
71
|
+
{"text":"[Drop]","duration_ms":16000,"positive_styles":["instrumental","full hybrid orchestra hits on the downbeat","heavy drums","distorted bass"],"negative_styles":["vocals","soft pads"]},
|
|
72
|
+
{"text":"[Breakdown]","duration_ms":4000,"positive_styles":["instrumental","sudden stop","near silence","one sub boom","reverse swell into next section"],"negative_styles":["drums","vocals"]},
|
|
73
|
+
{"text":"[Finale]","duration_ms":12000,"positive_styles":["instrumental","biggest section","key lift","driving drums","choir pads without words"],"negative_styles":["vocals","lyrics"]},
|
|
74
|
+
{"text":"[Button]","duration_ms":4000,"positive_styles":["instrumental","single final hit","long reverb tail","ends cleanly"],"negative_styles":["fade out","loop","vocals"]}]}
|
|
75
|
+
```
|
|
76
|
+
|
|
77
|
+
Tell the person once that AI-generated music may not be registrable for copyright in some places. Some music services
|
|
78
|
+
have no API or no longer allow downloads; an agent cannot use those.
|
|
79
|
+
|
|
80
|
+
## 5. Licensable libraries (when there is nothing else)
|
|
81
|
+
|
|
82
|
+
| Source | Commercial trailer use | Credit | Agent download |
|
|
83
|
+
|---|---|---|---|
|
|
84
|
+
| Pixabay Music | yes, free; keep the licence certificate for content-ID disputes | no | no API (the person or a browser) |
|
|
85
|
+
| Incompetech (Kevin MacLeod) | yes | the free tier requires credit (CC BY); a paid licence removes it | direct file URLs |
|
|
86
|
+
| Free Music Archive | only CC BY or public domain (BY-NC bars promotion; BY-ND bars syncing to picture) | per licence | no API |
|
|
87
|
+
| YouTube Audio Library | YouTube only | per track | no |
|
|
88
|
+
| Uppbeat | the free tier needs credit and excludes paid ads | yes (free) | no |
|
|
89
|
+
| Epidemic Sound, Artlist | paid; check the plan covers marketing | no | no |
|
|
90
|
+
| Musopen | public-domain classical | requested | no |
|
|
91
|
+
| Effects: Sonniss GDC bundles | royalty-free, commercial, no credit | no | direct zips |
|
|
92
|
+
| Effects: Freesound | per file (filter to CC0 or CC BY) | per file | API with a token |
|
|
93
|
+
|
|
94
|
+
Recommend a genre, a tempo and three specific tracks with links; save the licence proof next to the file. Licence
|
|
95
|
+
terms change; read the current terms before recommending.
|
|
96
|
+
|
|
97
|
+
## 6. Editing a track to length (a trailer; a montage never edits the owner's song)
|
|
98
|
+
|
|
99
|
+
- **Backtime:** align the track's final hit to the title (or button) frame, then remove time from the middle.
|
|
100
|
+
- Cut only on downbeats at phrase boundaries (4, 8 or 16 bars), between sections with the same harmony (chroma
|
|
101
|
+
similarity of 0.97 or more). Splice with a 5-20 ms crossfade on a transient, or an equal-power crossfade of 1/8-1/4
|
|
102
|
+
beat ending about 3 ms before the downbeat; hide joins under a hit or whoosh.
|
|
103
|
+
- Never cut inside a held chord or a reverb tail. Keep the real ending, never a fade-out.
|
|
104
|
+
- If the file ends abruptly on the resolve, take a ring-out from the song's own continuation (OG Clash took 2 s more
|
|
105
|
+
from the full song, so the film ran 62.000 s, 3,720 frames).
|
|
106
|
+
- Tempo changes up to about ±3 % are inaudible with a good time-stretcher; larger ones are not.
|
|
107
|
+
- A source separator (Demucs) can split drums, bass and the rest, to thin the drums under a line or rebuild an ending.
|
|
108
|
+
|
|
109
|
+
## 7. Measuring: the beat grid (`grid.json`)
|
|
110
|
+
|
|
111
|
+
Measure like a music editor, never play audio aloud, and take every number from a script.
|
|
112
|
+
|
|
113
|
+
1. Decode to 32-bit float WAV with ffmpeg; record the decode convention (MP3 adds about 25 ms of priming; any
|
|
114
|
+
transcode can shift everything by about 1.5 frames).
|
|
115
|
+
2. Duration from the decoded sample count; integrated loudness, true peak and loudness range from `ebur128`; momentary
|
|
116
|
+
loudness every 100 ms.
|
|
117
|
+
3. **Tempo from attacks in one band** (the hi-hat or snare band), fitted by least squares. Check half and double tempo
|
|
118
|
+
with onset autocorrelation. Do not trust one beat tracker: on OG Clash 32 high-band attacks gave 105.0001 BPM with a
|
|
119
|
+
0.08 ms residual, where two trackers said 105.04 and 105.47 because of phase slips. Useful libraries: madmom
|
|
120
|
+
(downbeats), allin1 (beats, downbeats and labelled sections), librosa, essentia, aubio.
|
|
121
|
+
4. **Detect splices.** If the full song exists, cross-correlate pieces of the file against it: each piece may sit at
|
|
122
|
+
its own offset. Build a piecewise clock. The OG Clash "60 s cut" was three pieces of the song slid on the 60 fps
|
|
123
|
+
grid, not on the beat; one global clock would have been 14-39 ms off by the outro.
|
|
124
|
+
5. Downbeat phase from section and chord changes; a bar map with each bar's loudness, sub level, air, onsets and
|
|
125
|
+
chroma.
|
|
126
|
+
6. Sections and accents: the drop (the biggest rise in 20-150 Hz energy after at least a bar below the median), stops
|
|
127
|
+
(a beat or more where full-band level falls more than 12 dB under the local median), bright bars, half-bar holes
|
|
128
|
+
(where voice lines and reveals go), bass downbeats, the breath bar before the drop, the last hit and the home chord.
|
|
129
|
+
A real drop is bright, has a kick on every beat and sits around −12 to −13 LUFS short-term.
|
|
130
|
+
7. Write `grid.json`: `{track, time_base, fps, bpm, beat_period_s, bar_period_s, first_downbeat_s, segments[],
|
|
131
|
+
beats[{t, frame60, bar, beat, seg}], bars[{bar, t, frame60, seg, lufs, sub_db, air_db, onsets_per_s}], sections[],
|
|
132
|
+
hits[{t, frame60, kind, strength}]}`. Shot specs and the edit look positions up here; nothing computes frames from
|
|
133
|
+
BPM.
|
|
134
|
+
8. **Click check:** the track at −6 dB with 2 kHz clicks on downbeats and 1 kHz on beats; subtract the track and measure
|
|
135
|
+
its attacks within ±15 ms of each grid beat. Pass when every downbeat you cut on is within a frame (OG Clash: ±7.1
|
|
136
|
+
ms).
|
|
137
|
+
9. Note the master level. Commercial tracks are hot (OG Clash's measured −7.7 LUFS and +0.5 dBTP, with 1,645 clipped
|
|
138
|
+
samples); the film mix turns it down.
|
|
139
|
+
|
|
140
|
+
## 8. Music in the mix
|
|
141
|
+
|
|
142
|
+
- The music never dips by accident. A master limiter pulling the bed under voice is a bug: peak-control the non-music
|
|
143
|
+
bus against the bed's headroom, and measure the music's fitted level (a dip of 1.5 dB or less).
|
|
144
|
+
- Designed silences are allowed and powerful in a trailer: 2-4 "silence then slam" moments (−20 to −40 dB for 0.3-2.4 s,
|
|
145
|
+
then +20 to +46 dB on a reveal). Plan them in the track edit, not as ducks. OG Clash never used one, because a house
|
|
146
|
+
rule said "the music never ducks", and its critic named that the single biggest missing device.
|
|
147
|
+
- Under voice, a static EQ dip on the bed (−3 dB around 2.2 kHz, crossfaded over 8 frames) is the only change.
|
|
148
|
+
- On a montage cut to the owner's song, none of the silences apply: the song plays untouched and leads the mix.
|
|
@@ -0,0 +1,133 @@
|
|
|
1
|
+
# The OG Clash trailer: what happened, and the gap to 11
|
|
2
|
+
|
|
3
|
+
The worked example behind the trailer skills: a 62 s, 4K60, 16:9 cinematic trailer for OG Clash (OpenGame's co-op
|
|
4
|
+
zombies game: plush heroes in a grim world, written in C, compiled to WebAssembly, rendered with WebGPU), cut to a
|
|
5
|
+
licensed electronic track at 105 BPM made of three spliced pieces. The bar: Black Ops zombies map trailers plus Kaiser's
|
|
6
|
+
montage editing. It shipped at −13.8 LUFS and −1.9 dBTP as a 700 MB HEVC master, and two days later the owner rated it
|
|
7
|
+
6/10.
|
|
8
|
+
|
|
9
|
+
| | |
|
|
10
|
+
|---|---|
|
|
11
|
+
| Wall time | 47 h 06 min (about 23 h active; about 24 h idle on usage-limit stops and restarts) |
|
|
12
|
+
| Sessions | 4 chained director sessions, plus a surviving copy of one that ran beside its resumed self |
|
|
13
|
+
| Agents | about 80 subagents, teams of 7-10 at a time |
|
|
14
|
+
| Owner notes | about 100 messages |
|
|
15
|
+
| Renders | 63 render events: 36 cuts with slates, 3 rhythm re-slots, 14 full 1080p cuts, 4K passes |
|
|
16
|
+
| Takes | 572 capture take lines (23 failed); 401 kept in the footage log; 43 slots |
|
|
17
|
+
| Critics | 2 blind rounds (3/10 on the first 30 s, 4.5/10 on a full cut); no blind A/B |
|
|
18
|
+
| Spend | $2.79 of a $200 cap on generated voice and effects (213 calls) |
|
|
19
|
+
| Approval | the 14th full cut, 42 h 20 min after the brief |
|
|
20
|
+
|
|
21
|
+
## The cuts, and what the owner said at each
|
|
22
|
+
|
|
23
|
+
| Cut | What changed | What the owner said next |
|
|
24
|
+
|---|---|---|
|
|
25
|
+
| the first slate cut | slates, voice and effects over the track | a pipeline proof |
|
|
26
|
+
| 15 cuts with slates | a watcher re-cut as selects landed | on the first 30 s: the announcer line "cheesy and terrible", the enemy rise "terrible", the electricity "really cheap" |
|
|
27
|
+
| the first critic copy | the first 30 s | critic 3/10: "a capture reel cut to a click track ... nothing actually happens on the beat" |
|
|
28
|
+
| round 2 rhythm cut | ramps made visible, motion across cuts, the 13-shot metronome broken | "this scene randomly comes in", "boring like the character isnt moving at all", no enemy rises |
|
|
29
|
+
| reshoots on a new effects build | | (the first session hit its usage limit) |
|
|
30
|
+
| ten cuts in the second session | slate frames from 1,135 down to 974 | "this depth of field blur looks terrible", "coming from same side", "work faster please" |
|
|
31
|
+
| the second critic copy | a full cut that still carried 974 frames of slates | critic 4.5/10, "not production grade"; the owner asked for flips in slow motion |
|
|
32
|
+
| the first cut with no slates | the first full picture | **never sent**: the session died while holding it for another loop |
|
|
33
|
+
| a re-slot from masters | all 44 events | "What r u waiting on? Can u work faster?" |
|
|
34
|
+
| a cut missing 10 selects (a watcher bug) | | notes on voice placement, a choppy bow, effects cut off, a cheap glow, a shot too quick to digest; **the scope freeze**; the title notes |
|
|
35
|
+
| the scope-freeze cut | | the title overlapping characters, revert one shot, a frozen flip, effects on a visor, the title not 3D, crackle throughout, match the world |
|
|
36
|
+
| an interim cut | one shot reverted, a smooth flip | a studio mark and compression |
|
|
37
|
+
| a broken cut | two director processes collided: 3,319 of 3,720 frames | renamed BROKEN |
|
|
38
|
+
| **the approved cut** | the same cut, run alone | "Looks good cut the final 4k version master pls" |
|
|
39
|
+
| the 4K master, first pass | chunked 4K with the title at 4K | "what are some other options for the scene we have at 7 seconds", then the feet note |
|
|
40
|
+
| **the delivered 4K master** | that shot waist-up with walkers only; one chunk re-rendered | delivered |
|
|
41
|
+
| the raw gameplay montage | 47 s, full HUD, 19 hard cuts, the game's own score | "why werent u hitting ... its weak spots?" (its second version was cancelled) |
|
|
42
|
+
|
|
43
|
+
## The shot that took 30 hours
|
|
44
|
+
|
|
45
|
+
The horde shot at 0:07 went: a rise from the ground ("terrible"), then a field of risers, then a walking horde with
|
|
46
|
+
heavy depth of field ("terrible"), then the horde from the other side, then a reverse angle from the south (15 drafts,
|
|
47
|
+
blocked by walls), then a side two-shot ("the zombies hit the player"), then a revert, then waist-up walkers. About 46
|
|
48
|
+
takes and six redesigns. An animation audit and an overhead geography map on day one would have saved most of it.
|
|
49
|
+
|
|
50
|
+
## Where the film went right
|
|
51
|
+
|
|
52
|
+
- Research fanned out in minutes: 36 trailers and 10 edits measured in 75 minutes; the music measured and its splice
|
|
53
|
+
found before a single shot.
|
|
54
|
+
- Deterministic 4K60 stepped capture of a WebGPU WebAssembly game in about three hours; slow motion as real simulation.
|
|
55
|
+
- The film build fixed the game's electricity at the source; the game later shipped it as its default; 10 of 11 film
|
|
56
|
+
notes shipped in the game within about 36 hours.
|
|
57
|
+
- First-to-third-person hand-offs inside one take, and the drop seam (19.1 px/f at 13° into 19.3 px/f at 15°).
|
|
58
|
+
- The 3D title, eventually: placed in the world, extruded, matched to the plate, lightning on the beats.
|
|
59
|
+
- Resilience: every agent's state on disk; teams restarted from resume briefs in minutes.
|
|
60
|
+
|
|
61
|
+
## Where the time went
|
|
62
|
+
|
|
63
|
+
About 24 hours idle (usage limits, restarts, nobody there at the reset); GPU contention (10 parallel 4K jobs at about
|
|
64
|
+
1 fps, 5.6 hours of slot waits); the 30-hour shot; notes a better plan would have pre-empted; 2.5 hours of 4K master
|
|
65
|
+
after approval plus 1.3 hours for a swap; finished cuts held for internal loops while the owner waited.
|
|
66
|
+
|
|
67
|
+
## The gap to 11: a blind critic on the shipped film
|
|
68
|
+
|
|
69
|
+
Commissioned when the owner rated the film 6/10 and asked for a method that produces an 11/10. A blind critic (no plan,
|
|
70
|
+
notes, code or briefs) measured the 4K master against the reference measurements: **5.5/10 against the Black Ops 6 and 7
|
|
71
|
+
trailers, 4/10 against a Kaiser edit.** It estimated that fixing the first four gaps alone would make it an 8.
|
|
72
|
+
|
|
73
|
+
Filtered through the rules before use: the critic's call to hide the first-person hit feedback and the studio mark went
|
|
74
|
+
against the owner's explicit choices (kept, with a question about hiding the mark on the title); its "optical-flow
|
|
75
|
+
retime" broke the no-interpolation rule (the same effect comes from the stepped simulation: the fast part at 1x, the
|
|
76
|
+
slow part at 1/240 within one take); a camera kick on impacts is legitimate as part of the camera path, never a post
|
|
77
|
+
shake filter. **Its most important finding for the craft:** the film did contain real quarter-speed spans in six shots,
|
|
78
|
+
and flow analysis still found zero ramps, because the camera kept moving through them at one speed. A ramp has to be
|
|
79
|
+
legible.
|
|
80
|
+
|
|
81
|
+
**Measured against the references:**
|
|
82
|
+
|
|
83
|
+
| Measure | The shipped cut | The references |
|
|
84
|
+
|---|---|---|
|
|
85
|
+
| cuts per second by act | open 0.38, features 1.54, boss 1.23, coda 0.29 | rising across the film, peaking late |
|
|
86
|
+
| cuts per 10 s window | 4, 12, 20, 15, 7, 3, 0 (peak at 20-30 s, then slowing through the climax) | peak at 50-60 s |
|
|
87
|
+
| cuts within 50 ms of an audio onset | 49 % against 48 % by chance | Kaiser 51 % against 23 % |
|
|
88
|
+
| beat-phase motion swing | 1.37x, peaking mid-beat | Kaiser 1.6-3.3x, on the beat |
|
|
89
|
+
| flow around cuts | flat (0.43-0.46 of the local 90th percentile) | Kaiser 0.26, 0.63, 0.78, 0.54 (a whip across the cut) |
|
|
90
|
+
| constant-velocity moves | 24 of 46 measurable shots | eased crash-zooms and push-ins |
|
|
91
|
+
| speed ramps found | 0 | Kaiser: on every kill |
|
|
92
|
+
| flashes | 3.9 per minute | Kaiser about 30 |
|
|
93
|
+
| HUD | hit markers and points pops in at least 5 first-person shots | none in 16 labelled trailers |
|
|
94
|
+
| voice | 17 lines, about 80 words | 5-8 lines, 42-75 words per 60 s |
|
|
95
|
+
| loudness | −13.8 LUFS, range 9.2 LU; **2.3 LU across 32 s of action** | 2-4 silences followed by slams |
|
|
96
|
+
| music holes | 0 | 1-3 per trailer |
|
|
97
|
+
| the loudest 50 ms | a weapon upgrade at 35 % of runtime | the boss, an explosion or the title |
|
|
98
|
+
| title | drifts into frame at 91.8 %; no hit, no type, no call to action | 84.5-89.6 %, resolved in 4-17 frames, then an end card |
|
|
99
|
+
|
|
100
|
+
**The ranked gaps (about 5 points across twelve):**
|
|
101
|
+
|
|
102
|
+
1. **The mix is a wall** (−1.0): no holes, no slams, the loudest moment in the wrong place, cuts landing on onsets at
|
|
103
|
+
chance. Fix: three holes (before a feature reveal, before the boss's first real reveal, total silence on the boss's
|
|
104
|
+
impact frame), the boss impact as the loudest point, a layered hit on the title, a button sound, a whoosh or impact on
|
|
105
|
+
most cuts.
|
|
106
|
+
2. **Story arc** (−0.8): the busiest cutting was the feature catalogue, not the boss fight; **the cut left the boss's
|
|
107
|
+
fall before the body hit the ground**; the boss was the first frame of the film, so its later "reveal" was a repeat.
|
|
108
|
+
Fix: four acts (a cold open with the boss hidden, features, a turn as the boss wakes in silhouette, the fight at the
|
|
109
|
+
fastest cutting), the kill landed on its impact frame, then the breath.
|
|
110
|
+
3. **No hook in the first 3 s** (−0.5): four shots of 2.3-2.6 s on an idle boss, no event, no line until 4.6 s. Fix:
|
|
111
|
+
an event on frame one, 4-6 shots in 4 s, or the strongest "what is this" image first.
|
|
112
|
+
4. **Title, end card and button** (−0.5): the title drifted in silently with no end card, no call to action and no
|
|
113
|
+
stinger. Fix: earn it from the world on a downbeat with a layered hit, then an end card, then a 1.5-2 s stinger.
|
|
114
|
+
5. **No velocity editing** (−0.5 against the trailers, −3 against Kaiser): no ramps, no whips, no designed transitions.
|
|
115
|
+
Fix: the payoff speed cycle on every hero hit, one designed slow-motion beat, 6-10 caused transitions (a scope iris, a
|
|
116
|
+
foreground wipe, a match cut, black slugs on eighths).
|
|
117
|
+
6. **Cheap or random tells** (−0.5): HUD pops, a sphere for a head gib, a flat red fog over 60 % of a frame, ghostly
|
|
118
|
+
electrocuted bodies, a floating plank barricade, an illegible six-frame smear, a low-poly prop in the hook frame.
|
|
119
|
+
7. **Robotic camera** (−0.4): half the moves at constant velocity, no impact kicks, one lens family. Fix: ease every
|
|
120
|
+
move, motivate it, add long lenses, macro inserts and a top-down.
|
|
121
|
+
8. **Voice overload and mis-sync** (−0.3): lines landing before or after their picture, one unintelligible, none naming
|
|
122
|
+
the game or a character. Fix: 6-8 lines on their pictures, one with a hole under it, a spoken title.
|
|
123
|
+
9. **No personality beat** (−0.3): the plush heroes never played on the clash with the grim world. Fix: name cards, one
|
|
124
|
+
reaction shot with a line on that face, a sight gag at the campfire.
|
|
125
|
+
10. **Features shown, not landed** (−0.3): fix each as a 3-4 shot micro-sequence on 4 beats with its own accent colour.
|
|
126
|
+
11. **A flat colour script inside acts** (−0.2): one real colour turn (night to dawn) and nothing before it. Fix: a
|
|
127
|
+
colour world per act and 1-2 accent flashes.
|
|
128
|
+
12. **No breath in the middle** (−0.2): add one held shot of 1.5-2.5 s in a music hole at about 60 % of runtime.
|
|
129
|
+
|
|
130
|
+
**What the critic said would make it 11/10,** specific to this game: the silence drop on the boss's kill; a match-cut
|
|
131
|
+
chain through circles ending in the logo's "O"; a tone-clash button (a plush hero toasting a marshmallow over the dead
|
|
132
|
+
boss); a one-take first-to-third-person move; an in-world round counter ticking up on consecutive beats; a spoken title.
|
|
133
|
+
These became the "beyond 10/10" list in the core chapter, and its measurable gates became the gates chapter.
|