@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
|
@@ -0,0 +1,299 @@
|
|
|
1
|
+
# Craft: the grammar of a game trailer, measured
|
|
2
|
+
|
|
3
|
+
Every number here was measured on real trailers (36 official Call of Duty zombies trailers and 10 community montage
|
|
4
|
+
edits) or learned on the OG Clash trailer (4 sessions, 63 renders, about 100 owner notes). It is engine-agnostic. Where
|
|
5
|
+
a number came from one genre it says so; re-measure for yours.
|
|
6
|
+
|
|
7
|
+
The whole chapter in one line: **cuts on the beat are table stakes; something must happen on the beat inside the
|
|
8
|
+
shot, every shot must perform one whole action, and every cut must carry motion.** The first critic of OG Clash: "It
|
|
9
|
+
is a capture reel cut to a click track ... the cuts are on the beat but nothing actually happens on the beat."
|
|
10
|
+
|
|
11
|
+
## 1. Structure
|
|
12
|
+
|
|
13
|
+
**The measured gameplay-trailer template (about 60 s; Black Ops 6 and 7 zombies map trailers):**
|
|
14
|
+
|
|
15
|
+
| Beat | When | Notes |
|
|
16
|
+
|---|---|---|
|
|
17
|
+
| rating or platform card | 0-2 s, only if required | silent |
|
|
18
|
+
| cold open before any logo | first frame | 10 of 12 open cold; music within 0.15 s of the first real picture |
|
|
19
|
+
| first voice line | 0.8-3.8 s after the first picture | off-screen, over action |
|
|
20
|
+
| early franchise logo (optional) | 2-8 s | a smash cut, cropped, resolving in 4-14 frames |
|
|
21
|
+
| world reveal | 3-8 s | the place, at scale, moving |
|
|
22
|
+
| first enemy | 6.4-13.3 s | in motion, in numbers |
|
|
23
|
+
| montage building to the feature beats | 13-45 s | the genre's signature systems |
|
|
24
|
+
| boss tease, the loudest hit | about 80 % | just before the title |
|
|
25
|
+
| title | 84-90 % of runtime | on the swell or after a silence |
|
|
26
|
+
| end card, button | 4-6.5 s | sometimes a 2-7 s stinger after the title |
|
|
27
|
+
|
|
28
|
+
- Cuts per 10 s rise from about 5 to a peak of 12-17, then collapse to 0-1 on the end card. Kaiser's montage edits by
|
|
29
|
+
section: intro 0.4-0.9 cuts/s, body 1.0-1.45, a breakdown of one held shot (3-8.5 beats), outro 0-0.3.
|
|
30
|
+
- **Flat cutting reads cheap.** An edit at 1.4-1.5 cuts/s with no sections scored worst of the edits measured.
|
|
31
|
+
- The wrapper (rating card, logos, end card, black) is 11-25 % of runtime in official trailers.
|
|
32
|
+
- Story cinematics run 0.17-0.27 cuts/s with 3-5 s shots; keep their numbers apart from gameplay trailers.
|
|
33
|
+
- OG Clash used three acts mapped to its track: a calm open to the drop (16.1 s), action to the last drop hit
|
|
34
|
+
(45.8 s), then victory and peace (16 s). 43 slots in 62 s; mean shot 1.44 s, median 1.15 s.
|
|
35
|
+
|
|
36
|
+
**Story is the gap.** The 6/10 film showed every system and had no arc: no want, no reversal, no character moment. In
|
|
37
|
+
this order, every trailer needs: a **hook** (a question or an image you cannot look away from, in the first 3 s), a
|
|
38
|
+
**promise** (what the player gets to do), an **escalation** (each beat bigger than the last), a **turn** (the boss
|
|
39
|
+
wakes, the squad goes down, the music drops out), a **payoff** (the win, earned, with its impact frame on screen) and a
|
|
40
|
+
**button** (a last beat after the title that makes people rewatch: a joke, a stinger, a reveal).
|
|
41
|
+
|
|
42
|
+
**The feature beats.** List the genre's signature systems and count which ones the references actually show. Zombies,
|
|
43
|
+
across 12 trailers: a boss or special enemy 11, a wonder weapon 10, a perk 6, a crew introduction 6, the mystery box
|
|
44
|
+
4, the upgrade machine 2. A trailer that shows every system for 1 s each is a feature list. Pick 3-5 hero beats and give
|
|
45
|
+
each a real moment; the rest are 0.5-1 s flashes.
|
|
46
|
+
|
|
47
|
+
**The must-show list.** Write the owner's list as rows of the plan, each with the shot that shows it.
|
|
48
|
+
|
|
49
|
+
## 2. Music and the clock
|
|
50
|
+
|
|
51
|
+
- **Music first.** Choose the track, measure it and write `grid.json` before any shot list. Never compute frames from
|
|
52
|
+
BPM; look positions up in the measured grid.
|
|
53
|
+
- **Measure, do not trust the file.** Detect splices and build a piecewise grid; MP3 decoder padding is about 26 ms (1.5
|
|
54
|
+
frames). Verify with a click track (median 3 ms or less, 95 % within 10 ms).
|
|
55
|
+
- **Find the real drops** bar by bar, and mark accent classes: drop impacts, half-bar holes (where voice and reveals
|
|
56
|
+
sit), bright downbeats, bass downbeats, the last hit, the home chord.
|
|
57
|
+
- **Silence then slam** (2-4 per official trailer): the music falls 20-40 dB for 0.3-2.4 s, often over black, then
|
|
58
|
+
returns 20-46 dB up on a reveal. In a trailer the music may drop out on purpose, as a designed silence; it never dips
|
|
59
|
+
by accident.
|
|
60
|
+
|
|
61
|
+
## 3. Edit rhythm
|
|
62
|
+
|
|
63
|
+
- **Cut 1-2 frames before the beat** at 60 fps. Kaiser lands cuts 2 frames early at 60 fps and 1 at 30; 43-51 % of those
|
|
64
|
+
cuts fall within a frame of a hit, against 9-23 % by chance.
|
|
65
|
+
- **The payoff is the last fast frame,** 1-3 frames before the beat: the muzzle flash, the impact, the kill lands on the
|
|
66
|
+
beat; the cut follows.
|
|
67
|
+
- **Vary the lengths.** Mix 0.5, 1, 1.5 and 2 beats with occasional breaths of 3-8 beats. Never more than 4 equal shots
|
|
68
|
+
in a row: OG Clash's first round had 13 consecutive two-beat shots, and a critic called it a metronome. Tighten into
|
|
69
|
+
the drop: 2-2-2-1-1 beats.
|
|
70
|
+
- **Official trailers are not beat-locked** (their cuts sit on the beat no more than chance); Kaiser's motion is.
|
|
71
|
+
Beat-locked motion is where an agent-made trailer can beat the references.
|
|
72
|
+
- In a montage section, hero shots every second beat, 1-3 frames before it.
|
|
73
|
+
- **Give the hero reveal one long breath** (OG Clash's upgraded weapon: 4.5 beats with a 16-frame aim hold).
|
|
74
|
+
- **Shot lengths:** Black Ops 6 and 7 medians 0.75-1.09 s; 10-37 % of shots under 0.5 s; 50-74 % under 1 s; inserts of
|
|
75
|
+
2-3 frames exist (box cycles, glitches).
|
|
76
|
+
- **The digestibility floor:** a shot that introduces a mechanic the viewer has not seen needs at least 1.2-1.5 s (70-90 frames
|
|
77
|
+
at 60 fps) and one clear cause and result; 17 and 34 frames both failed on OG Clash. A single understood action (a
|
|
78
|
+
sword raised) can run about 0.5 s (32-35 frames). Slow the key moment (to 0.35x) if it happens in under about 10
|
|
79
|
+
frames.
|
|
80
|
+
- **Measure "performed on the beat"**, not "cut on the beat": does the action peak land within ±2 frames of a beat?
|
|
81
|
+
|
|
82
|
+
## 4. Speed ramps and slow motion (the signature)
|
|
83
|
+
|
|
84
|
+
- **Real simulation, never interpolation.** Slow motion is a smaller simulation step per output frame (1/240 s per
|
|
85
|
+
frame is 0.25x), captured from the engine. Frame-blended or optical-flow slow motion reads cheap: the cheap edits
|
|
86
|
+
measured 8-10 % duplicate frames against Kaiser's 0.2-3.4 %.
|
|
87
|
+
- **A ramp only reads when something moves through it.** "it reads as a pause, not slow-mo." Keep the camera at 2 px/f
|
|
88
|
+
or more at 1080p through the slow span, with bodies and debris travelling.
|
|
89
|
+
- **A ramp must be legible, not only smooth.** OG Clash had real quarter-speed spans in six shots and a blind critic's
|
|
90
|
+
flow analysis found zero ramps, because the camera moved through them at one speed and nothing changed on screen.
|
|
91
|
+
The viewer has to see the change: fast, slow, fast inside one shot, the subject's speed contrast at least 3x, debris
|
|
92
|
+
and bodies visibly slowing, and a sound that marks it (a whoosh into the slow, a hit out of it).
|
|
93
|
+
- **The recipe that worked:** 1x approach, the payoff 1-3 frames before the beat (the last fast frame), ease to 0.2-0.3x
|
|
94
|
+
over 6-8 frames, **hold 24-36 output frames (0.4-0.6 s)** with the camera at 2 px/f or more, back to 1x over 10-12
|
|
95
|
+
frames into the cut. Check the slow span's median motion is at least 2 px/f and never under 1.
|
|
96
|
+
- **Kaiser's curve** (optical flow relative to the 90th percentile, in frames at 60 fps around the shot): −12 0.18,
|
|
97
|
+
−8 0.21, −4 0.44, **0 0.87**, +4 0.58, +8 0.29, +12 0.12. Slow for 0.2-0.6 s, rise over about 8 frames, peak on the
|
|
98
|
+
shot, slow again within about 12 frames. Slow runs are short (median 0.25-0.33 s), never whole seconds.
|
|
99
|
+
- **Where the slow goes:** on the aim before the shot (12-14 frames at 60 fps), on the impact after it, or before the
|
|
100
|
+
impact when the next shot's opening must stay protected (slow on the drive-in, snap to 1x so the flash lands on the
|
|
101
|
+
beat, cut into the slowed fall).
|
|
102
|
+
- **The fast side** comes from camera speed when gameplay cannot run above 1x. Character animation may be sped up to
|
|
103
|
+
about 1.3x to land on beats ("music sync wins; not a gameplay-speed claim"); the world stays at or below 1x.
|
|
104
|
+
- **What turns slow motion into a freeze:** game hitstop or hit-pause (45-70 ms counted on raw time becomes 9-12 frozen
|
|
105
|
+
output frames at 0.25x), short animations that finish early and hold, aim springs that die in slow spans, fixed-rate
|
|
106
|
+
physics that stutters every 3rd-4th frame, pulsing lights that become a 10 Hz strobe, gore sprites that fog the frame.
|
|
107
|
+
Turn off or step-compensate each in the film build, and gate on per-character angular rate.
|
|
108
|
+
- **Shutter scales with the slowdown** (blur strength = frame rate × step, a constant 180° look in output time). No
|
|
109
|
+
post motion blur. Nothing blurred on the title.
|
|
110
|
+
- **Long falls:** run at 1x through the motion and slow after the landing; at 1/4-1/6 a 2 s fall barely moves.
|
|
111
|
+
|
|
112
|
+
## 5. Camera
|
|
113
|
+
|
|
114
|
+
- **Every cinematic is moving on its first frame and still moving on its last.** Monotone cubic keys (an ease per
|
|
115
|
+
segment stops dead at each key), roll at most 0.2 rad, no added shake. A calm open may be slow but never locked off
|
|
116
|
+
(1 px/f or more). Nothing still for more than 0.4 s.
|
|
117
|
+
- **Every cut carries motion.** At least 2 px/f into the next shot's direction; speed cuts leave at 15 px/f or more over
|
|
118
|
+
the last 3 frames and arrive at 10 px/f or more over the first 4, within 45°. OG Clash's best seam: 19.1 px/f at 13°
|
|
119
|
+
into 19.3 px/f at 15°, 2 frames before the downbeat. Its worst: dead-to-dead seams (0.0-0.3 px/f) and 165-176°
|
|
120
|
+
reversals.
|
|
121
|
+
- **Every shot needs a reason to arrive:** a motion, a look, a sound or a cause handed over from the previous shot.
|
|
122
|
+
- **Screen direction:** decide which side heroes and enemies come from in each act; they converge; hold the 180° line.
|
|
123
|
+
Map the level from above before choosing lenses: walls and ruins decide which reverse angles exist.
|
|
124
|
+
- **Continuity across cuts:** the same character holds the same weapon, finish and state across adjacent shots; shoot
|
|
125
|
+
adjacent shots of one moment as one take with a hard cut so ambient motion carries over.
|
|
126
|
+
- **Lenses:** wide and low for scale (a boss sells its size against people, torches, parapets); long lenses to compress
|
|
127
|
+
a horde; a lens height of 0.85-1.2 m for waist-up hordes (it hides foot IK).
|
|
128
|
+
- **Depth of field:** every frame has a pin-sharp subject. Engine bokeh reads as smeared low resolution at 4K. No large
|
|
129
|
+
defocused foreground (over 10 % of the frame). Depth of field only lightly on the far background, or off; separate
|
|
130
|
+
with light, angle and motion.
|
|
131
|
+
- **Never the back of a head as the subject.** Over-the-shoulder and side-of-the-weapon angles are wanted where the
|
|
132
|
+
character's head and back do not fill the frame (OG Clash's 0.7 m head made over-the-shoulder impossible; audit it).
|
|
133
|
+
- **Dolly into the shot:** decelerate from 33 to 3 px/f into the payoff. **Orbit:** eased 3.7, 8.3, 4.4 px/f ("re-aim
|
|
134
|
+
it, don't re-time it"). **Scale:** a giant with nothing to compare against reads small.
|
|
135
|
+
|
|
136
|
+
## 6. First person and third person
|
|
137
|
+
|
|
138
|
+
- **Share:** 25-40 % first person across the film; the action section may run 45-50 %. Official zombies trailers are
|
|
139
|
+
only 6-19 % first person, in 0.12-1.75 s bursts; staged third-person action is 80-92 %. Measure on the real cut, over
|
|
140
|
+
the whole film and the action section; the plan's number lies.
|
|
141
|
+
- **First person never stands still:** locomotion or aim motion in every first-person shot, unless a scoped hold pays
|
|
142
|
+
off within about 0.3 s.
|
|
143
|
+
- **Audit every weapon, sight and finish you plan to show** on frames under the scene's real light: low-poly parts, odd
|
|
144
|
+
angles, obstructions when aiming down sights, sights with no real aperture, finishes that blow out. No close-up on an
|
|
145
|
+
unaudited weapon; never trust the default loadout's look.
|
|
146
|
+
- **One first-person character and one set of hands** for the whole film (OG Clash had four arm sets until it pinned
|
|
147
|
+
one).
|
|
148
|
+
- **First to third person:** one simulation take, the camera switching at the action's fastest frame, temporal history
|
|
149
|
+
reset on the cut, the third-person angle chosen so screen direction matches. The best seams in OG Clash.
|
|
150
|
+
- **Long-draw weapons (bows, charge shots) go third person,** in one continuous take with no splice inside the action.
|
|
151
|
+
- **Acrobatics read as a camera spin in first person:** use third person.
|
|
152
|
+
- **HUD in first person:** official trailers show none. If the owner wants the feedback (hit markers, points), build a
|
|
153
|
+
mask that keeps only that, and watch for pops covering a head. Debug overlays never appear.
|
|
154
|
+
|
|
155
|
+
## 7. Characters, enemies, animation
|
|
156
|
+
|
|
157
|
+
- **Audit every animation clip on frames before planning a shot of it** (USABLE, WITH CAMERA CARE, NO). OG Clash found:
|
|
158
|
+
the enemy rise was a lift in a straight line (head height linear with R² 0.98), the scream a T-pose, gun kills never
|
|
159
|
+
threw a body, the hero's weapon hold stretched sleeves 16 %, the victory emote turned into a scarecrow pose after
|
|
160
|
+
2.2 s, the revive greyed the whole frame. Plan around what holds up.
|
|
161
|
+
- **No standing stills, no unnatural poses.** Every character does something with intent; weight, elbows, hands and
|
|
162
|
+
gaze checked on frames.
|
|
163
|
+
- **Show enemies where the animation holds up:** walking toward a character, in numbers, at distance, on impact. Never
|
|
164
|
+
posed for inspection. One gait in a horde, no runners.
|
|
165
|
+
- **Frame out what the engine renders badly:** foot IK, hands, broken holds. Waist-up from 0.85-0.95 m with the horizon
|
|
166
|
+
at the frame bottom.
|
|
167
|
+
- **Readable space between hero and enemies.**
|
|
168
|
+
- **Faces are sacred:** never add glow balls, slits or arcs to a hero or boss face; use the asset's cleanest look and
|
|
169
|
+
match every shot of that subject to the frame the owner likes.
|
|
170
|
+
- **Personality is the missing ingredient.** The 6/10 film never let a character be a person: a look, a joke, a
|
|
171
|
+
hesitation, a reaction. Plan at least one moment where a character reacts to something.
|
|
172
|
+
- **Co-op:** in first person with mates firing at the same far target you only see their backs; keep them off frame and
|
|
173
|
+
let muzzle light and tracers enter from the edges. Ending tableaux: staggered depths, turned to each other, not a row
|
|
174
|
+
facing the lens.
|
|
175
|
+
- **The newest showy move:** feature it mid-action in slow motion, after turning hitstop off.
|
|
176
|
+
|
|
177
|
+
## 8. Effects and light
|
|
178
|
+
|
|
179
|
+
- **A cheap effect is the film's defect.** Fix it at the source (the game's own effect code, in the film build), sweep
|
|
180
|
+
the whole class, and hand the patch to the game team.
|
|
181
|
+
- **An electricity or energy spec that worked:** a thin white-blue core of 2-4 px, a narrow saturated falloff, fractal
|
|
182
|
+
branches that crawl, a re-strike every 2-4 frames, a 1-2 frame after-image in the core only, contact sparks, real
|
|
183
|
+
light cast on nearby surfaces. Not thick soft ribbons.
|
|
184
|
+
- **No glow clips to flat white.** Measure the share of the frame at full white (see the measuring chapter); 0.5 % or
|
|
185
|
+
less on a held hero effect (OG Clash: 8.6 % to 1.2 %, 6.59 % to 0.47 %).
|
|
186
|
+
- **When the owner calls an effect cheap, try removing it first.** More effects was the wrong fix on OG Clash.
|
|
187
|
+
- **No blurred-circle glows, flat puffs, pink fog, see-through holograms** (fast mesh swaps ghost through temporal
|
|
188
|
+
anti-aliasing; reset its history on every swap frame).
|
|
189
|
+
- **Flicker:** at most 3 full-frame flashes per second; check held lights for periodic flicker (a light re-firing every
|
|
190
|
+
0.09 s reads as a 10 Hz strobe). Kaiser's flash rate of about 30 a minute is a ceiling.
|
|
191
|
+
- **Full-frame washes** (lightning, fog flashes) flatten the picture and read as an overlay. Suppress random world
|
|
192
|
+
events per take (reset their timers in the preroll).
|
|
193
|
+
- **World markers that read as HUD** (waypoint rings, weak-point capsules, telegraph circles) are hidden in cinematics.
|
|
194
|
+
- **Never invent an effect the game does not have** to hit a music accent; put the accent in sound.
|
|
195
|
+
|
|
196
|
+
## 9. Transitions
|
|
197
|
+
|
|
198
|
+
About 80 % of cuts in official trailers are hard cuts. Every other transition hides inside the world.
|
|
199
|
+
|
|
200
|
+
- **Allowed:** a speed cut on the fastest frame; a match cut (same framing, sometimes with an 8-frame glitch); a
|
|
201
|
+
first-to-third-person hand-off inside one take; a ramp cut; an in-world wipe by an opaque foreground (about 9 frames
|
|
202
|
+
at 30 fps); a flash cut of 2-16 frames that hides a cut; a white-out of 4 frames to 1.5 s on a story beat; a
|
|
203
|
+
crash-zoom of 4-14 frames; a whip pan of 0.1-0.7 s blurred by the engine's own shutter; a logo or emblem matte of
|
|
204
|
+
0.8-2.9 s; a muzzle strobe at about 8 Hz, 2 frames each; black slugs of 0.07-0.45 s as rhythm; light dropping out in
|
|
205
|
+
the world; at most two story cuts to black of 4-15 frames.
|
|
206
|
+
- **Banned as cheap:** crossfades and dissolves as glue (rare exceptions: an aerial, an end-card particle morph);
|
|
207
|
+
opacity fades; post blur transitions; stacked-copy smears; editorial white flashes that are not in the world; post
|
|
208
|
+
shake; letterbox mattes added mid-film; effects covering the action; frame-doubled slow motion; freeze-frames in the
|
|
209
|
+
body; constant shake or flashing; lyric karaoke; anything more than 2 frames off the grid; stacked transitions; stock
|
|
210
|
+
overlays; ramps on empty shots; intros over 16 % of runtime.
|
|
211
|
+
|
|
212
|
+
The rule that held on OG Clash: ban every **editorial** effect (added blur, opacity, white frames, shake, overlays,
|
|
213
|
+
interpolation); allow everything the **game renders itself** (muzzle light, lightning, engine velocity blur, recoil,
|
|
214
|
+
emissive glow). A montage in a named editor's style may ask for that editor's finishing layer; that is decided in
|
|
215
|
+
`opengame-montage-plan` with a look test.
|
|
216
|
+
|
|
217
|
+
## 10. Grade
|
|
218
|
+
|
|
219
|
+
- Official zombies trailers are dark and low-saturation (luma Y 40-70 limited range, saturation 6-15) with one hot
|
|
220
|
+
accent per section (the genre's signature colour), and bright sections built on purpose for contrast.
|
|
221
|
+
- Kaiser's edits are near-neutral (colour casts within ±2.2 a*/b*, saturation 31-42 %, clipping under 3 %, crushed
|
|
222
|
+
blacks 9-18 %), the colour changing per sequence.
|
|
223
|
+
- OG Clash: three per-act 65³ LUTs built in Oklab on the engine's output (act one cold steel-blue with warm embers, act
|
|
224
|
+
two cyan against orange with the violet left alone, act three warm gold), plus per-shot exposure, temperature and
|
|
225
|
+
tint trims. No added grain, flares, chromatic aberration or vignette.
|
|
226
|
+
- **Light across cuts:** median luma jump at or under 18; none over 40 except a declared story beat.
|
|
227
|
+
- **A colour script** (one sentence per act: "cold and wet", "fire and steel", "dawn gold") makes the grade tell the
|
|
228
|
+
story. The 6/10 film had per-act LUTs and no deliberate contrast moment; plan one.
|
|
229
|
+
|
|
230
|
+
## 11. Title and logo
|
|
231
|
+
|
|
232
|
+
The full procedure is in the title chapter (`opengame-trailer-make` carries it). The rules:
|
|
233
|
+
|
|
234
|
+
- One title, built from the game's own logo art, as a **real 3D object in the world of the final shot**: extruded about
|
|
235
|
+
20 % of its height, separate side and bevel materials, lit by the scene's key, haze and bounce, shadowed, matched
|
|
236
|
+
numerically to props at the same depth, composited **before** the grade.
|
|
237
|
+
- **The camera finds it**, or one clean cut reveals it. No particle assembly, no shimmer; still at rest. Never overlaps
|
|
238
|
+
a character on any frame. About 19-30 % of frame width depending on the shot.
|
|
239
|
+
- **Live structured energy** (lightning, fire) on the title is premium when it strikes on the beats with a designed
|
|
240
|
+
sound per strike, from its first visible frame.
|
|
241
|
+
- Placement: 84-90 % of runtime, on the swell or after a silence; or a cold-open title for a story trailer (Black Ops 3
|
|
242
|
+
put it at 27-36 %).
|
|
243
|
+
- Franchise logos of 2020-2025 use a smash cut to an oversized cropped piece, then a crash-zoom or pull-out to the full
|
|
244
|
+
lockup in 4-14 frames. That is for flat 2D marks; a game's own 3D logo uses the title chapter.
|
|
245
|
+
|
|
246
|
+
## 12. Voice
|
|
247
|
+
|
|
248
|
+
- **Density follows the brief.** The references run 5-8 lines and 42-75 words per 60 s; OG Clash's brief asked for many
|
|
249
|
+
lines and shipped 13 in 62 s with no complaint about the count. One-liners of 1-11 words (median about 5); gaps of 8
|
|
250
|
+
frames or more; never two lines at once; at least a bar clear after the drop and after the hero reveal; no voice on
|
|
251
|
+
frame 0.
|
|
252
|
+
- **Budget in bars:** a radio line 1 bar, a character line 1-2 bars, banter 3-4 bars; keep the drop and the hero reveal
|
|
253
|
+
free of voice.
|
|
254
|
+
- **Placement:** lines are almost always off-screen over action and land on matching pictures; a name lands on the shot
|
|
255
|
+
that shows the thing named; a character's line plays on the shot where they are on screen and the picture motivates
|
|
256
|
+
it. Put lines in the track's measured half-bar holes.
|
|
257
|
+
- **No announcer or voice-of-god clichés, no tutorial lines, no other studios' names** (a critic caught a line that was
|
|
258
|
+
another game's title) and no other franchise's power-up names.
|
|
259
|
+
- **Use the game's own cast and text** where possible; fix casting collisions (two characters sharing one voice).
|
|
260
|
+
Generated voice runs on the person's own account, after they approve the cost.
|
|
261
|
+
- **Intelligibility:** a speech recogniser on the mixed master, four windows per line, three of four correct; fix with
|
|
262
|
+
a new take or new timing, not just more level.
|
|
263
|
+
- **Never speed a line up to fit. Never pitch-shift game audio.**
|
|
264
|
+
|
|
265
|
+
## 13. Sound and mix
|
|
266
|
+
|
|
267
|
+
- **Sound is half the trailer.** A designed hit on every big picture event: at least 35 % of its energy in 300 Hz-5 kHz
|
|
268
|
+
and at least 6 dB over the music in that band over its first 50 ms (OG Clash's sound lead used 7 dB), aligned on the
|
|
269
|
+
attack, in key. Sub-only hits are silent on a phone.
|
|
270
|
+
- **Every flash gets a sound or is deliberately silent.**
|
|
271
|
+
- **Tails ring 150-400 ms across every cut.** A cut that stops every sound dead is heard as a click.
|
|
272
|
+
- **Slow-motion spans** carry the real-time sound once, unstretched, anchored on the payoff.
|
|
273
|
+
- **Mute in-game music and dialogue at capture,** or it is baked into every take (verify by loudness).
|
|
274
|
+
- **Game sound** sits 0 to +6 LU over the bed in action; trim per shot from a mix without the music.
|
|
275
|
+
- **No accidental ducks:** peak-control game sound, effects and voice as one bus keyed to the bed's headroom, and
|
|
276
|
+
measure the music's level in the mix (a dip of 1.5 dB at most). Designed silences are fine.
|
|
277
|
+
- **Master:** −14 LUFS ±1 integrated and true peak at or under −1 dBTP, measured on the AAC delivery; two limiters
|
|
278
|
+
around a linear gain, never ffmpeg's `loudnorm` filter, in one pass or two (its dynamic mode flattened drops by 3-4 dB); 24-bit
|
|
279
|
+
WAV; AAC at 320 kbps. Loudness range follows the track (OG Clash's track alone was 9.0 LU): write a waiver rather
|
|
280
|
+
than leaving a gate red on every cut.
|
|
281
|
+
- **Measure the references' loudness too.**
|
|
282
|
+
|
|
283
|
+
## 14. Endings and the button
|
|
284
|
+
|
|
285
|
+
- Official trailers: title, then an end card of 4-6.5 s, sometimes a 2-7 s stinger (a lunge, a joke line: "That song
|
|
286
|
+
was driving me nuts!"). Every Kaiser edit ends on a held, slow image.
|
|
287
|
+
- OG Clash ended on peace: victory on the wreck, dawn, the crew at a campfire, a crane up to the title in the sky. Good,
|
|
288
|
+
and it had no button.
|
|
289
|
+
- **A 10/10 trailer has a button:** one last beat after the title that rewards the viewer and makes them rewatch (a
|
|
290
|
+
character line, a sight gag, a tease of what is next). Plan it.
|
|
291
|
+
- The end card tells people where to play. If it says "play free in your browser", check the real first-load time on
|
|
292
|
+
typical connections.
|
|
293
|
+
|
|
294
|
+
## 15. Format and delivery
|
|
295
|
+
|
|
296
|
+
- **The format is asked in the plan:** default 1080p at 60 fps, 16:9; 4K60 or 30 fps on request (App Store previews
|
|
297
|
+
cap at 30 fps).
|
|
298
|
+
- The ladder: a 720p contact sheet, then 1080p60 review cuts, then approval, then the master at the agreed format, then
|
|
299
|
+
the social copies. Details are in the finishing chapter (`opengame-trailer-make` carries it).
|
|
@@ -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.
|