@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,293 @@
|
|
|
1
|
+
# Studying the reference edit: the golden edit, its finishing layer, and a good player
|
|
2
|
+
|
|
3
|
+
The owner usually gives one reference edit ("edit it like this") and treats it as the bar: 10/10 by definition. Measure
|
|
4
|
+
it before planning, as a study a judge can score against. The worked example is the OG Snipers study of Kaiser's FaZe
|
|
5
|
+
sniping edit "FAINT" (95.24 s, 2,858 frames at 1080p30, 4 Mbps). Download it privately for measurement only; never cut
|
|
6
|
+
it into your film, play it aloud, or recreate its game, characters, logo or footage.
|
|
7
|
+
|
|
8
|
+
**Units.** Its frame numbers and frame counts are at 30 fps: double them for a 60 fps timeline. Its speeds in px/f and
|
|
9
|
+
its angles per frame are per 30 fps frame at 1080p: halve them for a 60 fps timeline (FAINT's incoming seams at a median
|
|
10
|
+
27 px/f are about 13.5 px/f at 60 fps).
|
|
11
|
+
|
|
12
|
+
## 1. The shape of a reference study
|
|
13
|
+
|
|
14
|
+
Write `research/REF-STUDY.md` with these sections, every number measured from the file (the measuring chapter) or
|
|
15
|
+
marked "by eye":
|
|
16
|
+
|
|
17
|
+
- **A. Identity:** the file, its length, rate, bitrate; its structure by song section.
|
|
18
|
+
- **B. A shot log:** every shot with frames, type (first-person gameplay, a cinematic tied to a clip, a free cinematic,
|
|
19
|
+
title or text), what happens, and the transition in.
|
|
20
|
+
- **C. Measured statistics:** cuts and shot lengths; the screen-time split; the gameplay clips; sync to the music; speed
|
|
21
|
+
ramps; grade; letterbox; sound.
|
|
22
|
+
- **D. The cinematics in detail:** the cold open; the cinematics that replay or extend a clip; the free ones.
|
|
23
|
+
- **E. A transitions catalogue:** every kind, its count, its frames, what in the picture causes it.
|
|
24
|
+
- **F. Text and titles.**
|
|
25
|
+
- **G. Flow and aura as rules with numbers.**
|
|
26
|
+
- **H. A rubric for the judges,** 0-10 per dimension, with what 10, 7 and 5 look like in this file.
|
|
27
|
+
- **I. A steal list:** 20-30 techniques with frames and how to reproduce each in an engine that owns the camera and the
|
|
28
|
+
clock.
|
|
29
|
+
- **What could not be measured,** said in so many words.
|
|
30
|
+
|
|
31
|
+
Check automatic cut detection against every frame by eye: on FAINT the detector returned 75 cuts, of which 20 were flashes
|
|
32
|
+
inside a shot, and missed about 25 real cuts hidden in whips, irises, portals and white frames. The corrected list had
|
|
33
|
+
68 real cuts and 22 transition-only inserts.
|
|
34
|
+
|
|
35
|
+
## 2. FAINT, measured
|
|
36
|
+
|
|
37
|
+
**Cuts and shots.** 68 cuts in 95.27 s, 0.71 a second; nearly flat after the cold open (4-9 per 10 s), because the
|
|
38
|
+
energy comes from what is inside the shots. Shot lengths: mean 1.35 s, median 1.03 s; 23 % under 0.5 s, 49 % under 1 s,
|
|
39
|
+
19 % over 2 s. First-person gameplay segments: median 1.37 s, up to 5.17 s without a cut. Cinematics tied to a clip:
|
|
40
|
+
median 0.50 s. The rhythm inside gameplay is whips, not cuts: optical flow peaks 175 times (1.84 a second), each rising
|
|
41
|
+
in 3 frames and falling in 3. No held or frozen frames: 2 near-duplicate pairs in 2,857 (0.07 %).
|
|
42
|
+
|
|
43
|
+
**The screen-time split** (what the owner asked OG Snipers to follow): over the whole file 52 % first-person gameplay, 37 %
|
|
44
|
+
cinematic (12 % tied to a clip, 26 % free), 9 % titles and text, 2 % transitions. It is front-loaded: the first 32 s hold
|
|
45
|
+
12.3 s of story cinematic, 8 s of titles and 5.2 s of gameplay. After the titles the body runs 70 % first person, 24 %
|
|
46
|
+
cinematic, 3 % text, 3 % transitions. The file is cut off, so an outro would raise the cinematic share.
|
|
47
|
+
|
|
48
|
+
**The clips.** 11 clips; first-person time per clip a median 4.87 s (1.40-7.13); kills per clip a median 5 (3-9 in the
|
|
49
|
+
ten complete clips); one kill per 0.95 s of first-person screen time. Kill spacing inside a clip: 2 beats is the mode (18
|
|
50
|
+
of 46 gaps), then 1.5 beats (8), 4 (5), 2.5 and 3 (4 each), 1 (3). Quickscopes are the default (about 40 of 52); each clip
|
|
51
|
+
has one twist (a wall-jump shot, a pistol finisher, a match-winning kill, a held scope, a collateral shown by a bullet
|
|
52
|
+
camera, a slide, backflip and spin into a charged shot). Inside a first-person segment the 95th-percentile flow is a
|
|
53
|
+
median 13.8x the 10th: every clip swings between near-still holds and very fast whips.
|
|
54
|
+
|
|
55
|
+
**Sync.** One constant 135.0 BPM grid (a beat is 13.33 frames at 30 fps, 26.67 at 60). As delivered almost nothing sits
|
|
56
|
+
on a beat's own frame; shift the picture 2 frames later and 70 % of shot frames and 40 % of cuts sit within a frame of a
|
|
57
|
+
beat. **The picture leads the beat by 1.5-2 reference frames: 3-4 frames at 60 fps.** 51 % of cuts fall in the last
|
|
58
|
+
quarter of a beat (25 % would be even). Cut spacing varies (1 to 12 beats; the edit never cuts on a fixed count). Motion
|
|
59
|
+
is beat-locked: folded onto the beat, flow is highest in the last 30 % before it, a swing of 2.49x over the film and 3.23x
|
|
60
|
+
inside gameplay. Every section change in the music is answered in the picture 2-3 frames early (the drop by ink frames
|
|
61
|
+
and a light-streak zoom, the chorus by a flash, the second verse by a whip-cut). Flashes: 45 luma jumps over 35 levels,
|
|
62
|
+
28.3 a minute, a median half-decay of 3 frames.
|
|
63
|
+
|
|
64
|
+
**Ramps.** Around a shot (flow relative to the film's 90th percentile, frame 0 the shot, at 30 fps): −10 0.28, −8 0.23,
|
|
65
|
+
−6 0.18, −4 0.28, −3 0.35, −2 0.63, −1 0.94, **0 0.84**, +1 0.88, +2 0.70, +3 0.79, +4 0.54, +5 0.56, +6 0.43, +7 0.31,
|
|
66
|
+
+8 0.32. A glide at 0.18-0.28 until 4 frames before; a rise over 3 frames; the peak held 5 frames (flick, shot, recoil); a
|
|
67
|
+
fall over 4. Peak over glide about 5x. At 60 fps: rise 6, peak 10, fall 8. Around a cut, the outgoing shot is calm and
|
|
68
|
+
lifts only in its last frame or two, and **the incoming shot arrives at about twice that speed and settles over 5
|
|
69
|
+
frames**: shots are entered fast and left slow. Slow holds in gameplay: a median 11 frames (0.37 s), the longest 21 (the
|
|
70
|
+
airborne hold on the drop). Long near-still spans exist only in the cold open and titles.
|
|
71
|
+
|
|
72
|
+
**Grade.** One look for the whole film: a teal cast (a* about −12 in every section), warm things left warm so they pop.
|
|
73
|
+
Two brightness worlds: gameplay dark and contrasty (luma 98, 10 % crushed), cinematics high-key (luma 125-158). **The
|
|
74
|
+
median luma jump across a cut is 37 levels, and 29 of 68 cuts jump more than 40:** the edit alternates dark and bright on
|
|
75
|
+
purpose. That breaks the trailer gate of a median jump at or under 18; for this style, waive the gate at
|
|
76
|
+
gameplay-to-cinematic cuts once the owner has approved the look. Almost nothing clips outside flash frames.
|
|
77
|
+
|
|
78
|
+
**Sound.** The song runs unbroken at one tempo, with one big contrast: 16 s of quiet intro, then the drop. Gunshots are
|
|
79
|
+
not louder than the music's own hits (onset strength at the shot frames sits below that of the beats), which is the
|
|
80
|
+
owner's "the music leads" in numbers. One spoken line, a character's, in the cold open.
|
|
81
|
+
|
|
82
|
+
**Letterbox.** 2.20:1 bars on the cold open only, opening over 28 frames as the title lands. Decide it on a strip of your
|
|
83
|
+
own cold open; never assume it.
|
|
84
|
+
|
|
85
|
+
**Endings.** The attached file is cut off and has no ending. The other Kaiser edits measured for OG Clash all end on a
|
|
86
|
+
held, slow image (0-0.3 cuts a second): a tableau, black and silence, then a calm title.
|
|
87
|
+
|
|
88
|
+
## 3. Flow and aura, as rules
|
|
89
|
+
|
|
90
|
+
1. Speed is carried across the cut; stillness never meets stillness (incoming shots start at a median 27 px/f at 30 fps;
|
|
91
|
+
only 3 of 68 seams are still on both sides, all in the cold open or titles). Direction need not match (a median 115°
|
|
92
|
+
apart).
|
|
93
|
+
2. Arrive fast, settle in 5 frames.
|
|
94
|
+
3. Every kill breathes the same way: glide, rise 3, peak 5, fall 4. The repetition of one shape reads as smooth.
|
|
95
|
+
4. Motion lives in the last third of the beat.
|
|
96
|
+
5. The picture leads the sound by 2 frames at 30 fps.
|
|
97
|
+
6. Nothing ever stops: no held frames, no freeze frames; the slowest spans still drift or sway.
|
|
98
|
+
7. Density alternates by song section in content, not cut rate: verses (rapped) are 77-94 % gameplay at nearly a kill a
|
|
99
|
+
second; choruses (sung, 5 LU louder) are twice as cinematic with the fastest cutting and the set pieces. The loudest
|
|
100
|
+
music gets the most cinema, not the most kills, and the loudest change in the music meets the least motion (the drop
|
|
101
|
+
lands on an airborne slow hold).
|
|
102
|
+
8. Gameplay runs 3-7 s, then a short punctuation of 0.4-2.9 s; ten of eleven clips have a cinematic attached.
|
|
103
|
+
9. One real breath, late: 5.2 s without gameplay after 16 s that were 94 % gameplay, before the last lift.
|
|
104
|
+
10. No metronome: the longest run of equally spaced cuts is 3.
|
|
105
|
+
11. Dark and bright alternate: a return to gameplay feels like a hit because the picture drops into contrast.
|
|
106
|
+
12. One colour, one hero: the same cast in every 10 s window, the same character in every cinematic.
|
|
107
|
+
13. Effects are brief and each kind is rationed: flashes decay in 3 frames; no transition type except the whip appears
|
|
108
|
+
more than 7 times; signature devices (a glass-shard portal, a bullet camera) once each.
|
|
109
|
+
14. Every transition is caused by something in the picture: a muzzle flash, a scope, a lens, a shard, a sleeve, a boot.
|
|
110
|
+
15. Titles and effects never cover a kill: tint flashes start on the kill frame, not before.
|
|
111
|
+
16. Two lens families: ultra-wide, low, tilted and inches away for action; long and shallow for calm moments and the
|
|
112
|
+
weapon. The subject is off the ground in action shots. Something new every 6-10 s.
|
|
113
|
+
|
|
114
|
+
**Where you can beat it:** it is 30 fps and 4 Mbps; its whole HUD is on; its master clips (true peak +0.7 dBFS); one teal
|
|
115
|
+
wash over eleven maps makes places hard to tell apart and turns skin olive; 12.3 s of titles hold back the gameplay;
|
|
116
|
+
three dead seams; a few dated devices (two-frame negative flashes, a text decode). Its music never breathes after the
|
|
117
|
+
drop; a trailer would add a designed silence there, but a montage on the owner's song must not ("u cant have music just
|
|
118
|
+
go completely blank"). What cannot be copied: its game's characters, animations and set pieces, a real player's recorded
|
|
119
|
+
matches, its track and its emblem.
|
|
120
|
+
|
|
121
|
+
## 4. The rubric anchors (what 10, 7 and 5 look like)
|
|
122
|
+
|
|
123
|
+
| Dimension | 10 in FAINT | 7 | 5 |
|
|
124
|
+
|---|---|---|---|
|
|
125
|
+
| Clip quality | multi-kills by one visibly human player: a median of 5, a kill per 0.95 s, a twist per clip, no miss shown | 3-5 kills, clean, the same pattern every clip | 1-3 kills, or kills that look scripted |
|
|
126
|
+
| Music sync | 70 % of shot frames within a frame of a beat at the lead; section changes answered within 3 frames; swing 3.2x in gameplay | 45-60 % on a beat; swing about 2x | under 35 %; swing under 1.5x |
|
|
127
|
+
| Speed ramps | one repeated shape, peak over glide about 5x, holds of 0.37 s, no doubled frames | smooth but 2-3x contrast, or holds of a second that read as pauses | constant speed, interpolation smear, freezes |
|
|
128
|
+
| Transitions | 16 kinds, each caused by the picture; 3 dead seams of 68 | 6-8 kinds, mostly whips and flashes; one signature piece; under 10 % dead seams | hard cuts plus stock overlays; 20 % or more dead seams; dissolves |
|
|
129
|
+
| Cinematics | 37 % of the file; 19 shots replay a clip at a median 0.50 s; kills from the victim's side | good-looking but separate from the clips | orbits of a standing character; no replay of any kill |
|
|
130
|
+
| Camera | the two lens families; a one-take reveal with a foreground wipe | varied, some low and wide, several eye-level | one lens, eye level, moves that start or end on a stop |
|
|
131
|
+
| Grade | one world, dark gameplay against high-key cinematics, under 0.1 % clipped | consistent, but no contrast between gameplay and cinematics | ungraded, or a different look per shot |
|
|
132
|
+
| Pacing | cold open, a drop on an airborne hold, verses of gameplay, a cinematic chorus, a late breath | sections exist but the calm parts are short or missing | one density throughout |
|
|
133
|
+
| Flow | nothing stops; arrive fast, settle in 5; the same ease on every kill | a few abrupt stops or a metronomic stretch | snaps without easing, dead frames at cuts |
|
|
134
|
+
| Overall aura | one authored piece: one colour, one hero, one ramp shape, the song visible in the picture | strong with a flat stretch | a compilation |
|
|
135
|
+
|
|
136
|
+
## 5. A steal list from FAINT (reproduced with an engine that owns the camera and the clock)
|
|
137
|
+
|
|
138
|
+
Frame counts here are already at 60 fps. "Sim speed" is simulation time per output frame, stepped by the engine, never
|
|
139
|
+
interpolated.
|
|
140
|
+
|
|
141
|
+
1. **The kill cycle:** sim speed 0.2 until 8 frames before the shot, ease to 1.0 over 6, hold 1.0 from 2 before to 6 after
|
|
142
|
+
(flick, shot, recoil), ease back over 8. Check the peak's median flow is at least 4x the glide's.
|
|
143
|
+
2. **Kills two beats apart, the shot frame 4 frames before the beat:** solve the clock so the shots land there; never
|
|
144
|
+
slide the audio.
|
|
145
|
+
3. **A scope-shot exposure bump:** luma up about 18 of 255 on the shot frame, settling over 16 frames, tied to the muzzle
|
|
146
|
+
light.
|
|
147
|
+
4. **Muzzle flash, one white frame, first person:** end the outside shot on its muzzle frame, one frame near white,
|
|
148
|
+
start first person already moving.
|
|
149
|
+
5. **First person to third person in the air and back,** in one simulation take: at the jump's apex switch to a camera
|
|
150
|
+
0.5-1 m from the body, 14-18 mm, low and tilted; sim speed 0.2 for about 24 frames on the aim; cut back while still
|
|
151
|
+
airborne; reset temporal history on both switches.
|
|
152
|
+
6. **The drop lands on an airborne slow hold:** a few high-contrast frames, a short radial zoom, then about 68 frames at
|
|
153
|
+
sim speed 0.2 with a slow push.
|
|
154
|
+
7. **A one-take reveal with a foreground wipe:** a spline camera past a large foreground object that covers the lens for
|
|
155
|
+
20-30 frames, then onto the hero as a small figure.
|
|
156
|
+
8. **Landing in a long lens:** 85-135 mm equivalent at knee height, side-on, the subject sharp, a dust burst, a slow push.
|
|
157
|
+
9. **Sub-second cuts on motion:** a near-still macro of gear, an ankle-height lateral track at 15 px/f or more (60 fps), an
|
|
158
|
+
overhead tilted wide on the takedown at sim speed 0.25.
|
|
159
|
+
10. **A title found by a whip pan:** extruded letters at two depths, a 20-frame whip from the running hero onto them, a
|
|
160
|
+
hold, a focus rack between the lines, the hero's blurred body crossing the foreground.
|
|
161
|
+
11. **A title standing in the scene, lit by it, crossed by the hero** (mesh letters that take the scene's key light and
|
|
162
|
+
cast shadows). The OG Snipers owner wanted theirs floating rather than on the ground.
|
|
163
|
+
12. **A weapon macro, a sleeve wipe, the next clip:** a macro on a firing sidearm, a whip along the arm, the sleeve
|
|
164
|
+
blacking out the lens for about 16 frames, the next first person already scoped.
|
|
165
|
+
13. **A punch-in on a clip's last kill** for a few frames around the shot; once or twice in the film.
|
|
166
|
+
14. **A lens iris of 2-6 frames** to leave a cinematic for gameplay.
|
|
167
|
+
15. **A tint flash with particles on a special kill:** grade toward one accent from the kill frame, decaying over 8-20
|
|
168
|
+
frames, with the kill's own debris; one colour per kill type; never before the kill frame.
|
|
169
|
+
16. **An ultra-wide tilted dive:** 14-16 mm at step height, rolled 20-30°, sim speed 0.25 for about 32 frames at the apex.
|
|
170
|
+
17. **The kill from the victim's side,** from the same simulation take: a camera under and beside the victim, ultra-wide,
|
|
171
|
+
orbiting, sim speed 0.2 as they leave the ground.
|
|
172
|
+
18. **A pop-out frame:** matte the shot between two white bars and let one bright element render over a bar; once.
|
|
173
|
+
19. **The weapon run:** three short macro moves along the held weapon, the last pushing into the eyepiece; the next frame
|
|
174
|
+
is first person already scoped on a kill.
|
|
175
|
+
20. **A word or medal inside the scope:** push into the scope, a white disc with the target as a silhouette and a large
|
|
176
|
+
word behind it, a slow zoom out, a squeeze to a line.
|
|
177
|
+
21. **Fire into white and recover** over about 20 frames while the player is already moving.
|
|
178
|
+
22. **A floor orbit ending on a boot over the lens,** then the next clip rising out of the dark.
|
|
179
|
+
23. **Lightning on the shot:** the scope to white for a frame, arcs around the muzzle that light nearby surfaces, a fall to
|
|
180
|
+
dark.
|
|
181
|
+
24. **A bullet camera for a collateral:** replay the shot from the bullet with every material switched to matte white
|
|
182
|
+
and ambient occlusion, rushing between victims at a slowed sim speed so bodies react in frame. Once.
|
|
183
|
+
25. **One held scope, then the shot,** after fast kills: about 52 frames at sim speed 0.2 with a slight sway, the shot on a
|
|
184
|
+
beat. Only if the owner allows held scopes.
|
|
185
|
+
26. **An iris that becomes the next weapon's scope ring.**
|
|
186
|
+
27. **The breath, then a backflip handed to first person and back:** a ground-level wide with a slow dolly-in, a chest-up
|
|
187
|
+
shot with something out of focus behind, then a slide, a backflip at sim speed 0.25, an iris into first person, a
|
|
188
|
+
profile close-up in the air while the shot charges, a short strobe on the shot.
|
|
189
|
+
|
|
190
|
+
## 6. The finishing layer, separated from the game
|
|
191
|
+
|
|
192
|
+
The HUD is drawn in screen space, so it cannot move, grow, tilt or smear unless the edit did it. Fitting each HUD corner
|
|
193
|
+
against its own median template per frame gives the edit's zoom, roll and shift; the HUD's edge energy gives the edit's
|
|
194
|
+
blur. It cannot tell an exposure key in the edit from the game's own muzzle light, and it fails on the most smeared
|
|
195
|
+
frames, so the peak values below are under-read.
|
|
196
|
+
|
|
197
|
+
- **The grade:** contrast is the gap, not exposure. FAINT's first person: mean luma 94, quartiles 29 and 157, black at
|
|
198
|
+
codes 3-5, white reaching 242-247, 14.5 % under code 18, 1.25 % over 245, a teal cast (a* −10.8). Per-clip medians run
|
|
199
|
+
from 48 to 123: it shares the curve and the cast, not the level. The OG Snipers cut before its look test: the same mean,
|
|
200
|
+
quartiles 47 and 127, nothing black and nothing white. No vignette, no visible grain, no chromatic split. **Recipe:**
|
|
201
|
+
levels from the cut's own measured black and white to codes 4 and 246, an S-curve of slope 1.20, a shoulder from 0.80,
|
|
202
|
+
a fraction of the cast in the shadows only (keep places and skins as themselves). OG Snipers then set per-clip exposure
|
|
203
|
+
into a median luma of 86-105; that range is its own, not FAINT's.
|
|
204
|
+
- **The shot accent:** 46 % of shots flash (+25 levels or more, median +49, gone by half in 3-4 frames), 18 % bump, 36 %
|
|
205
|
+
get nothing: not every shot gets the same accent. The zoom punch: a median +3.2 % (p90 +4.8 %), arriving in one frame on
|
|
206
|
+
the shot frame and easing out over about 20 frames at 60 fps; roll a median 0.72°; a damped shake of a few frames. No
|
|
207
|
+
chromatic split. **Recipe:** a class per shot from those shares (flash 40 %, punch 32 %, bump 16 %, clean 12 %), never
|
|
208
|
+
the same class twice running; zoom +3.2 % (+4.8 % on a clip's last kill or a multi-kill); roll 0.7°; a 6 px damped
|
|
209
|
+
shake. The OG Snipers owner then asked that the punch hold until the next payoff ("it goes back to 100% too quick").
|
|
210
|
+
- **Whips:** in a pan whip the world streaks and the weapon and HUD stay sharp: a blur of the world only, not of the whole
|
|
211
|
+
frame. **Recipe:** directional blur of the world along the view's own motion from the capture log, 0.30 of the frame's
|
|
212
|
+
travel, capped at 72 px, only above 30 px of travel a frame and at sim speed 0.6 or more, never from 2 frames before a
|
|
213
|
+
shot to 7 after, with the weapon, hands and HUD matted out. Leave it off until the matte is clean on every skin.
|
|
214
|
+
- **Transitions, by share of FAINT's 68 cuts:** plain cuts on motion 44 %; whips through the cut 16 % (where the picture
|
|
215
|
+
already pans 26 px/f or more at 30 fps; at most 7); white flashes 9 % (1-2 frames; at most 3 where a muzzle frame hands to
|
|
216
|
+
its own outside camera); light-streak zooms 6 %; through the scope 6 % (when the incoming clip opens scoped); foreground
|
|
217
|
+
wipes 4 % (from the take, never pasted); dark beats 4 %; burns to white 3 % (into the ending, once); ink flashes,
|
|
218
|
+
irises and portals 16 % together (of their moment, and easy to date).
|
|
219
|
+
- **No frame blending, no dissolves.**
|
|
220
|
+
|
|
221
|
+
## 7. The seams of the cut the owner praised for flow
|
|
222
|
+
|
|
223
|
+
The cut the OG Snipers owner later named as the model for flow had no post transitions at all. Its seams cut on the
|
|
224
|
+
game's own leaving motion (the unscope, an aim release, a camera pull-out) into the payoff cinematic, entered first person
|
|
225
|
+
on the frame its swing began, and took foreground wipes from the takes themselves. When a later round stripped the caused
|
|
226
|
+
transitions along with the pasted ones, the owner said "flow/transitions got worse". Measure the seams of every cut the
|
|
227
|
+
owner praises (white and dark frames, view speed out and in, radial push, luma) and keep that table as the model.
|
|
228
|
+
|
|
229
|
+
## 8. A good player, measured
|
|
230
|
+
|
|
231
|
+
Before scripting a player, record 3-5 minutes of a good human in the real game (the owner, if they play) and measure it.
|
|
232
|
+
|
|
233
|
+
**Getting view angles from a video.** Track features with Lucas-Kanade (`cv2.calcOpticalFlowPyrLK`) on a 960x540 proxy,
|
|
234
|
+
fit a similarity transform per frame pair with RANSAC (`cv2.estimateAffinePartial2D`), with the HUD and the first-person
|
|
235
|
+
weapon masked out, and convert the rotation to degrees through the game's field of view. Treat every absolute angle as
|
|
236
|
+
±20 % unless you know the player's actual field-of-view setting (ratios, durations, frame counts and curve shapes do not
|
|
237
|
+
depend on it); strafing is not separated from rotation by this fit; frames lost at scope-in and cuts are normal. Find
|
|
238
|
+
shots from the HUD (an ammo counter, a damage number, the scope overlay), not from the audio, which carries every other
|
|
239
|
+
player's gunfire. Measure the build, not its config: OG Snipers' on-screen scope-in took 0.10-0.20 s where the config said
|
|
240
|
+
0.30-0.40 s.
|
|
241
|
+
|
|
242
|
+
**OG Snipers' owner, measured:** scope-in to full overlay a median 0.13 s; overlay to shot 0.32 s; shot to unscope 0.10 s;
|
|
243
|
+
shot to next shot 1.68 s (quartiles 1.25 and 2.27); hip flicks a median 14.5° in 0.13 s; the view dead still on 1.6-2.1 %
|
|
244
|
+
of hip frames, never more than 4 in a row; a 91 % hit rate (the film needed 100 %).
|
|
245
|
+
|
|
246
|
+
**Bot tells, with thresholds from that play** (fail a take when):
|
|
247
|
+
|
|
248
|
+
1. A frozen hip camera: over 5 % of frames static, a static run over 6 frames, or any 1 s window under 1° of path.
|
|
249
|
+
2. Constant-speed turns: any flick whose speed varies less than 20 % (coefficient of variation), or 4 or more frames in a
|
|
250
|
+
row within ±5 % of each other.
|
|
251
|
+
3. Linear ramps: the flick's speed peak in its first 15 % or last 10 % on more than a fifth of flicks, or progress that is
|
|
252
|
+
a straight line (r² over 0.995). Human flicks peak at about 0.56 of their duration.
|
|
253
|
+
4. Instant snaps: any single-frame turn over 17°, a peak over 450°/s, or a flick shorter than 60 % of the fitted duration
|
|
254
|
+
(duration ≈ 0.046 × amplitude^0.45 s).
|
|
255
|
+
5. Zero settle: no overshoot in a clip of 5 or more flicks (40 % of human flicks overshoot, a median 13.5 %), or the scope
|
|
256
|
+
coming up on the flick's last frame every time.
|
|
257
|
+
6. A dead-still scope at the shot on every shot of a clip (under 0.05° over the last 0.1 s).
|
|
258
|
+
7. Identical timing: kill gaps varying less than 25 %, two consecutive gaps within 2 frames, or every scoped time within 2
|
|
259
|
+
frames.
|
|
260
|
+
8. Pure-yaw turns: more than 20 % of flicks with under 0.05° of pitch.
|
|
261
|
+
9. Always the same scope time across a clip.
|
|
262
|
+
10. Pixel-perfect centre hits: a human lands up to half a body width off centre; review by eye until the build can
|
|
263
|
+
measure it.
|
|
264
|
+
11. No strafing, or robotic stop-starts: not measured on OG Snipers; review by eye.
|
|
265
|
+
12. No turn after the kill: under 2° of turn in the 0.5 s after every kill.
|
|
266
|
+
|
|
267
|
+
**These tells are measured in game time, on the take's own view log. On screen, the owner's rules win:** where they want
|
|
268
|
+
payoffs at equal spacing on the beat, the clock and the payoff solver produce that spacing, and tell 7 does not apply to
|
|
269
|
+
the picture; where they ban a play style (OG Snipers banned held scopes), tells 6 and 9 do not ask for it. The other
|
|
270
|
+
override is deliberate: a human misses, and the film never does.
|
|
271
|
+
|
|
272
|
+
**A human input synthesiser,** sampled per event, never once per clip:
|
|
273
|
+
|
|
274
|
+
| Parameter | Value (OG Snipers) |
|
|
275
|
+
|---|---|
|
|
276
|
+
| Flick duration | 0.046 × amplitude^0.45 s, times a factor of 0.75-1.35; never under 0.07 s |
|
|
277
|
+
| Flick peak speed | 35.4 × amplitude^0.55 °/s, capped at 445°/s |
|
|
278
|
+
| Flick shape | an asymmetric bell, its peak drawn from about 0.56 ± 0.16 of the duration, clipped to 0.30-0.80 |
|
|
279
|
+
| Pitch | pitch = yaw × a ratio of 0.04-0.21, either sign; never exactly 0 |
|
|
280
|
+
| Overshoot | on 40 % of flicks, 3-24 % of the amplitude (median 13.5 %), returned within 0.2 s |
|
|
281
|
+
| Aim error left for the scope | 0.5-2.3° off (median 1.0) |
|
|
282
|
+
| Pause from flick end to scope-in | 0.27-0.58 s (median 0.42); floor 0.07 s |
|
|
283
|
+
| Scoped time before the shot | a mix of short, medium and long, spread at least 0.2 s across a clip (within the owner's play-style rules) |
|
|
284
|
+
| In-scope correction | one move at 20-45°/s peak, ending 0-0.13 s before the shot; leave 0.1-0.4° of motion in the last 0.1 s on a quarter of shots |
|
|
285
|
+
| Release after the shot | unscope at +0.07 to +0.13 s |
|
|
286
|
+
| Weapon swap (two-weapon clips) | input at +0.17 to +0.33 s (median 0.30) |
|
|
287
|
+
| Turn-away | a new flick within 0.5 s; median 14°, up to 58° |
|
|
288
|
+
| Time between kills (when the owner's grid does not fix it) | 0.87-2.5 s, median 1.7 s, coefficient of variation at least 0.35 |
|
|
289
|
+
| Hip idle | never still: 4-8°/s median drift, 0.12-0.19° per-frame jitter at 30 fps, a flick about once a second |
|
|
290
|
+
| Scoped idle | 1.7-3.2°/s median drift, 0.05-0.08° per-frame jitter at 30 fps; still runs up to 0.4 s |
|
|
291
|
+
| Not measured | the reaction delay to a new target, the strafe pattern, jump, slide and flip timing |
|
|
292
|
+
|
|
293
|
+
Measure your own genre's equivalents (a racing line, inputs against frame data, hand paths in VR) the same way.
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# The song: measuring it into a film map
|
|
2
|
+
|
|
3
|
+
In a montage the owner's song is the clock and the lead. It is played, not edited: one gain from start to end and, at
|
|
4
|
+
most, a fade over the last half second. Measure it before any shot, and write the film map from the measurement.
|
|
5
|
+
|
|
6
|
+
## 1. Rights and choice
|
|
7
|
+
|
|
8
|
+
- The owner's own track wins. Confirm it is cleared for where the montage will be posted (a commercial song on a
|
|
9
|
+
personal upload is not cleared for a game's marketing). Never assume that music made for a game or offered on a
|
|
10
|
+
platform is cleared for that game's montage.
|
|
11
|
+
- With no track: recommend 2-3 measured candidates with a 15 s excerpt each and a default, from music they own or
|
|
12
|
+
licensed, or from a licensable library with the licence saved beside the file. Generated music runs only on the
|
|
13
|
+
person's own account after they approve the cost; record the approval word for word.
|
|
14
|
+
- A rhythm game whose own chart is not the owner's song: chart the song in the game if it supports custom maps, or mute
|
|
15
|
+
the game and align only shared downbeats.
|
|
16
|
+
|
|
17
|
+
## 2. Measure it like a music editor
|
|
18
|
+
|
|
19
|
+
Never play audio aloud; take every number from a script (the measuring chapter has the recipes).
|
|
20
|
+
|
|
21
|
+
1. Decode to 32-bit float WAV; record the decode convention (MP3 adds about 25 ms of priming; a transcode can shift
|
|
22
|
+
everything by about 1.5 frames).
|
|
23
|
+
2. Duration from the sample count; integrated loudness, true peak and range; momentary loudness every 100 ms.
|
|
24
|
+
3. **Tempo from attacks in one band** (hi-hat or snare), fitted by least squares; check half and double tempo. Never trust
|
|
25
|
+
a single beat tracker.
|
|
26
|
+
4. **Check for splices** if the file might be an edit of a longer song: cross-correlate pieces against the full song and
|
|
27
|
+
build a piecewise clock if pieces sit at different offsets. The OG Snipers song ran on one clock with no splice; the OG
|
|
28
|
+
Clash trailer track was three pieces.
|
|
29
|
+
5. The downbeat phase from section changes; a bar map with each bar's loudness, sub level, air, onsets and chroma.
|
|
30
|
+
6. Sections: verses and choruses, where any vocal starts and ends, holes and dips, the loudest moment, the key, whether
|
|
31
|
+
the song has an ending, a drop or risers.
|
|
32
|
+
7. Write `research/grid.json` with beats, bars and sections in seconds and 60 fps frames. Shot specs and the edit read
|
|
33
|
+
positions from it; nothing computes frames from BPM.
|
|
34
|
+
8. **Click check:** the track with clicks on downbeats and beats; measure its attacks within ±15 ms of each grid beat.
|
|
35
|
+
Every downbeat you cut on must sit within a frame.
|
|
36
|
+
9. Note the master level: commercial tracks are hot. The OG Snipers film sat at −12.9 LUFS with the song bus at −14.4.
|
|
37
|
+
|
|
38
|
+
OG Snipers: 137.370 BPM on one clock; a beat of 26.207 frames at 60 fps; bar 1 beat 1 at 0.755 s (frame 45); four 16-bar
|
|
39
|
+
blocks of 27.954 s; short-term loudness −10.6 to −8.8 LUFS (flat), with no drop, no riser and no ending; a half-time
|
|
40
|
+
feel with the snare on beat 3.
|
|
41
|
+
|
|
42
|
+
## 3. The film map
|
|
43
|
+
|
|
44
|
+
- **Map the owner's spoken times onto measured downbeats** and confirm the length in one line. "around 57 seconds" became
|
|
45
|
+
56.663 s (frame 3400), where the hook returns. The rap ended at 84.44 s and the next downbeat, 84.616 s (frame 5077),
|
|
46
|
+
became the door to the end shot. The first brief said both "around 60 seconds" and "around 1:30".
|
|
47
|
+
- **Slots of 8, 12 or 16 beats,** each with its grid. A slot's last 2 beats are its last payoff's hit and outside shot,
|
|
48
|
+
or the next clip's entry.
|
|
49
|
+
- **Sections drive content:** verse = play, chorus = spectacle. A flat loop has its sections made by the edit and the
|
|
50
|
+
mix. Ambient or orchestral music is cut on phrases, not a grid.
|
|
51
|
+
- **Payoff spacing comes from read time** (the grammar chapter): the smallest power-of-two number of beats that covers the
|
|
52
|
+
payoff's read time, the same beat positions in every clip. Half-time feel: payoffs on the snare, motion peaks on the
|
|
53
|
+
kicks. Drum and bass: treat it as 85-87 BPM for payoffs.
|
|
54
|
+
- **The ending:** one shot of 3-5 s from the door the song gives (the vocal's end), the song fading under it untouched.
|
|
55
|
+
|
|
56
|
+
## 4. The song in the mix
|
|
57
|
+
|
|
58
|
+
- The music leads. Payoffs sit about 3 dB over the song in 1-5 kHz, not 6 or more. The song is never ducked by accident,
|
|
59
|
+
never edited, never dropped to silence ("u cant have music just go completely blank").
|
|
60
|
+
- Check on the delivered file that the song is untouched: align the song file to the music bus and fit one gain in 1 s
|
|
61
|
+
windows; the gain must hold within 0.5 dB everywhere but the agreed fade.
|
|
62
|
+
- Callouts sit under the song, just after their trigger; test each over the real song at several offsets with two speech
|
|
63
|
+
recognisers before the mix.
|
|
64
|
+
- Before any cut is sent, send the owner a 20 s mix check and ask whether the music is the loudest element.
|
|
@@ -0,0 +1,193 @@
|
|
|
1
|
+
> Carried from `opengame-montage-plan` 1.0.0. Read it when: Plan a gameplay montage of any game, genre or engine before anything is captured. Covers the owner's day-one questions in one message with defaults, the song measured into a film map, payoffs spaced on the beat by read time, the payoff shot and eased speed ramps designed first, the capture tier, and a frame-exact clip plan and storyboard. Use when someone wants a kill montage, frag movie, highlight reel or clip edit to a song. For a trailer or reveal, use opengame-trailer-plan.
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
# Montage plan
|
|
5
|
+
|
|
6
|
+
Step 1 of 3: **plan**, then `opengame-montage-make`, then `opengame-montage-review-and-improve` on every round.
|
|
7
|
+
|
|
8
|
+
The job is a plan that settles, before the first take, what cost the last montage its time. The OG Snipers sniper montage
|
|
9
|
+
took 66 h 38 min, 19 cuts and about 50 capture sessions per shipped slot, with 21 owner reversals. A plan could have
|
|
10
|
+
settled the payoff spacing (two re-shoot rounds), the hero (about 10 hours on the wrong one), the payoff framing (a day of
|
|
11
|
+
animation tuning undone by one note), the title (23 hand-ins), staged hits, speed ramps retrofitted at hour 64, and a
|
|
12
|
+
4K master that had to be an upscale. Every rule below is stated for any genre; the OG Snipers numbers are examples.
|
|
13
|
+
|
|
14
|
+
A montage is not a trailer: no story arc, no voice script, no call to action, and the owner's song is never edited.
|
|
15
|
+
For a trailer, teaser, launch or reveal video, or the raw real-time gameplay reel of a launch package, use
|
|
16
|
+
`opengame-trailer-plan`.
|
|
17
|
+
|
|
18
|
+
## Read first
|
|
19
|
+
|
|
20
|
+
1. [references/montage-grammar.md](references/montage-grammar.md), whole: where a montage overrides trailer defaults,
|
|
21
|
+
and the grammar with numbers (the film map, spacing by read time, sync, the edit never retiming, eased speed, the
|
|
22
|
+
payoff cinematic, the primary view, HUD, cuts and transitions, the finishing layer, the end shot, sound).
|
|
23
|
+
2. [references/day-one-questions.md](references/day-one-questions.md): the 30 questions with defaults and why each was
|
|
24
|
+
needed.
|
|
25
|
+
3. [references/montage-genres.md](references/montage-genres.md): money moments, read times, cameras, HUD, fake tells and
|
|
26
|
+
hooks for 19 genres, and the day-one decision tree for an unknown game.
|
|
27
|
+
4. [references/montage-capture.md](references/montage-capture.md): capture tiers A-F, film-build hooks, and shooting
|
|
28
|
+
from a replay, input replay or live play when there is no source.
|
|
29
|
+
5. [references/owner-eye.md](references/owner-eye.md): how a demanding owner reviews, and the montage anticipations.
|
|
30
|
+
6. [references/song.md](references/song.md) and [references/reference-study.md](references/reference-study.md): the song
|
|
31
|
+
measured into a film map; the reference edit, its finishing layer and a good player, measured.
|
|
32
|
+
7. [references/montage-gates.md](references/montage-gates.md), [references/montage-ops.md](references/montage-ops.md)
|
|
33
|
+
and [references/og-snipers-record.md](references/og-snipers-record.md): which gates mattered, the team and the time
|
|
34
|
+
budget, and the 19-cut record.
|
|
35
|
+
8. As needed: [references/filmable.md](references/filmable.md) (the capability checklist and stepped capture),
|
|
36
|
+
[references/briefs.md](references/briefs.md) (research, sweep and judge briefs) and
|
|
37
|
+
[references/measure.md](references/measure.md) (how to measure everything with ffmpeg, Python and a speech
|
|
38
|
+
recogniser).
|
|
39
|
+
|
|
40
|
+
Related skills: `opengame-capture` (the hooks that make a game filmable), `opengame-audio` (the game's own sound),
|
|
41
|
+
`opengame-production` (many agent rounds against one owner). Keys come from the environment and are never printed.
|
|
42
|
+
|
|
43
|
+
## Day one: the owner's questions, in one message
|
|
44
|
+
|
|
45
|
+
Infer everything that is not the owner's taste from the repo, the build and the song. Send the rest in **one message
|
|
46
|
+
within the first hour**, each question with a default and, where possible, a picture to choose from: owners answer yes/no
|
|
47
|
+
and "which of these" fast and leave open-ended sheets unanswered. If nothing comes back, log the defaults in
|
|
48
|
+
`plan/DECISIONS.md` and keep going. Ask each once. The 30 questions are in the day-one chapter; they group into ten:
|
|
49
|
+
|
|
50
|
+
1. **The song (Q1-3):** where the montage ends in the song (a measured point such as the vocal's end) and the ending after
|
|
51
|
+
it; may the song be edited or dropped; is the music the loudest element. Default: untouched, one gain, a fade of at
|
|
52
|
+
most 0.5 s, the music leads; attach a 20 s mix check.
|
|
53
|
+
2. **The reference and the finish line (Q23-24, Q27):** their reference edit is GOLD, 10 by definition; which parts
|
|
54
|
+
matter; follow its split of play and cinematics; its finishing layer (attach a 15 s look test); is a judge panel's
|
|
55
|
+
score or their approval the finish line. Default: their approval, with the panel run on a schedule anyway.
|
|
56
|
+
3. **Payoffs (Q4-9):** fixed spacing on the beat; may a beat be a movement or a cut; payoffs per clip, the biggest, the
|
|
57
|
+
finale; banned play styles, tricks and their speed; legal under the real rules, and the mix of payoff types; which of
|
|
58
|
+
their habits to copy; how opponents look and behave; which names must be unique.
|
|
59
|
+
4. **Format, delivery, cadence, deadline (Q25-26, Q28):** review and master formats; capture at the master; the folder
|
|
60
|
+
every cut goes to; a cut per burst of notes or one complete cut; the deadline and the rounds they expect.
|
|
61
|
+
5. **Hero and cosmetics (Q10-12):** whose character in which exact outfit (an account link or a screenshot); does the
|
|
62
|
+
player-view model change; their shortlist of skins and whether reuse is fine; which weapons, cars or loadouts with
|
|
63
|
+
which iconic parts. Default: their own character; the player view as shipped; a casting sheet before shooting.
|
|
64
|
+
6. **Maps or levels (Q13):** must-show, and which go first if clips need length.
|
|
65
|
+
7. **HUD (Q18):** a frame of each element next to the shipped game. Default: success feedback only, matching the shipped game pixel for pixel.
|
|
66
|
+
8. **Cinematics and the payoff shot (Q14-17):** which kind they like (three stills: a move into the map handing into the
|
|
67
|
+
player view; the payoff from the receiver's side; the hero alone); what may be in frame at impact; eased ramps
|
|
68
|
+
everywhere (the pilot clip, step 6). Assume without asking: a shot they liked is never removed without asking them.
|
|
69
|
+
9. **Ending and text (Q19-20):** one shot or a sequence, how long, what the hero does; any text; if a title, its
|
|
70
|
+
material, font (five on the real plate), in the air or on the ground, how it animates; no title rather than a weak
|
|
71
|
+
one; confirm any name or word in one line (dictation garbles names). Default: one shot of 3-5 s, no text.
|
|
72
|
+
10. **Sound, spend, limits (Q21-22, Q29-30):** voice lines, their offset and level; keep every game sound and the
|
|
73
|
+
hit-confirm tick; paid generation only on their own account with a cap they approve; compute; **their never-list**,
|
|
74
|
+
each item gated on their own flagged frames before any cut is sent.
|
|
75
|
+
|
|
76
|
+
Also assume: updates every 15 minutes; side work goes to another session; no placeholder is ever sent.
|
|
77
|
+
|
|
78
|
+
## Steps
|
|
79
|
+
|
|
80
|
+
### 1. Freeze and fan out (the first 30 minutes)
|
|
81
|
+
|
|
82
|
+
- **Freeze the build:** the latest stable build, named and hashed; the game team keeps shipping.
|
|
83
|
+
- **Research in parallel, briefs on disk first** (the briefs chapter; on OG Snipers seven agents landed in 58 minutes):
|
|
84
|
+
R-GAME (the money event from score events, announcers and banners; its read time; replay, determinism, hitstop),
|
|
85
|
+
R-CAPTURE (a tier probe), R-MUSIC (the grid), R-REF (the reference edit measured as a study), R-REFS (3-5 edits of this
|
|
86
|
+
genre), R-SOUND, R-PLAYER (a good human's play on the real game, measured: acquisition, settle, hold, drift).
|
|
87
|
+
- The film repo as for a trailer, plus `status/<role>.json`, `inbox/<role>.md`, `work/OWNER-NOTES.md` (one row per note
|
|
88
|
+
with its verification state), `work/PRAISED.md` and `film/SKILLS.log` (one UTC line per skill invocation).
|
|
89
|
+
- Log the brief in the owner's words into the notes ledger and `work/OWNER-NOTES.md`: it is the first spec.
|
|
90
|
+
|
|
91
|
+
### 2. Genre, payoff and capture tier
|
|
92
|
+
|
|
93
|
+
- From the genre chapter: the money moment, its read time, the show-it-twice device, the impact grammar, the fake tells,
|
|
94
|
+
the HUD that carries the stakes, the hooks needed.
|
|
95
|
+
- Pick the tier (the capture chapter): A source or a film build; B deterministic input replay; C a replay or demo with a
|
|
96
|
+
free camera; D the game's own cameras or photo mode plus high-frame-rate capture; E live play only; F no GPU (stop).
|
|
97
|
+
Run a 20-minute probe judged on frames (replay fidelity, slow-motion duplicates, ragdoll or physics stepping, HUD
|
|
98
|
+
toggles, debug overlays).
|
|
99
|
+
- State the limits in the plan: B-E have no film build, so staging, seeds and probes become recorded human play, replay
|
|
100
|
+
passes and event mining; C and D slow motion only as fine as the replay re-simulates (interpolated replays to 0.5x); D
|
|
101
|
+
and E slow motion capped at capture fps ÷ 60; E has no second angle, so a lower cinematic share.
|
|
102
|
+
|
|
103
|
+
### 3. The film map from the song
|
|
104
|
+
|
|
105
|
+
- Measure the track fully into `research/grid.json` (the song chapter): tempo, drift, bar 1, sections, the vocal's end,
|
|
106
|
+
the door to the end shot. Map the owner's spoken times onto measured downbeats and confirm the length in one line.
|
|
107
|
+
- Slots of 8, 12 or 16 beats; a slot's last 2 beats are its last payoff's hit and cinematic, or the next entry. Sections
|
|
108
|
+
drive content: verse = play, chorus = spectacle. A flat loop has its sections made by the edit. Ambient or orchestral:
|
|
109
|
+
phrases, not a grid. A rhythm game on a song that is not its chart: chart it or mute it.
|
|
110
|
+
|
|
111
|
+
### 4. Money moments on the read-time grid
|
|
112
|
+
|
|
113
|
+
- k = the smallest power-of-two number of beats that covers the payoff's read time: about 2 beats for a quickscope, 4-8
|
|
114
|
+
for an overtake, 8 for an aerial goal, 8-16 for a fighting combo, 16-32 for a teamfight. Put every payoff on the same
|
|
115
|
+
beat positions at that spacing; vary what is on screen, never the spacing.
|
|
116
|
+
- Every grid point is a payoff, a movement accent peaking on it, or a cut. Measure each movement's lead on day one (OG
|
|
117
|
+
Snipes: a jump peaks 0.32 s after the key, a flip 0.43 s, a mantle 0.25 s). Openers can be movement; the first payoff
|
|
118
|
+
comes a beat later.
|
|
119
|
+
- Per clip: the default size, one bigger, a unique finale; at most one trick; one signature moment only this game can do;
|
|
120
|
+
the staple is a clean chain of single high-skill payoffs.
|
|
121
|
+
- Plan the visible payoff frame at the beat − 3 frames (60 fps) and its sound attack on the beat; cause before effect,
|
|
122
|
+
once.
|
|
123
|
+
|
|
124
|
+
### 5. Design the payoff shot first
|
|
125
|
+
|
|
126
|
+
- Write its framing model before any animation or physics tuning, in this genre's terms: the receiver at least a third of
|
|
127
|
+
frame height; what must stay out of frame (what the engine animates worst, from the audit and the owner's still choice:
|
|
128
|
+
legs and feet on OG Snipers, wheels on the terrain in racing, pathing feet in a MOBA); the consequence visible within 15
|
|
129
|
+
frames and complete by 60 % of the span; a span of at least 28 frames; the same run (seeded take, input replay or
|
|
130
|
+
replay pass) seen from the receiver's side; held to the clip's end. Name the probes it needs (the receiver's drawn
|
|
131
|
+
points, the payoff point, the line of the attack, ground height) so the film build adds them on day one, or the replay
|
|
132
|
+
pass that stands in at tiers B-D.
|
|
133
|
+
- Put a three-option still sheet to the owner before mass shooting.
|
|
134
|
+
|
|
135
|
+
### 6. The eased speed plan
|
|
136
|
+
|
|
137
|
+
- Write per-clip speed keys from the start, not as a retrofit: the payoff cycle with drag-through; AE1 every change eased
|
|
138
|
+
over 8 or more frames with no more than 15 % change a frame; AE2 a V on every payoff cinematic; AE3 cuts between clips at 2.5-3x out
|
|
139
|
+
and in; AE4 no searching, dead travel at 1.5-2x. Genre: racing inverts it; fighting keeps hitstop, re-timed; a rhythm
|
|
140
|
+
playfield is never slowed; 2D sprites stay on their own drawings.
|
|
141
|
+
- **Pilot one clip on day one** with ramps everywhere, the payoff framing and the finishing look, and send it to the
|
|
142
|
+
owner: "is this the look for every clip?" On OG Snipers this question came at hour 64.
|
|
143
|
+
|
|
144
|
+
### 7. The rest of the language
|
|
145
|
+
|
|
146
|
+
- Primary view, HUD, cuts and transitions, look, ending and sound per the grammar chapter. Test every voice line over the song at 5
|
|
147
|
+
offsets with two speech recognisers now, not in the mix. List every departure from the reference and from the montage
|
|
148
|
+
overrides, with the owner's yes or the default taken.
|
|
149
|
+
- Never recreate another studio's game, characters, logo or footage; the reference edit is measured, never copied.
|
|
150
|
+
|
|
151
|
+
### 8. The clip plan (`plan/shots.json` and the table in `plan/PLAN.md`) and a storyboard
|
|
152
|
+
|
|
153
|
+
| slot | frames a..b at 60 fps (bars) | map or level | loadout and skin | grid frames (payoff, accent, cut) | payoffs (count, type, legal) | opener | tied cinematic (receiver, framing, span, V) | cut out and in | HUD | sound and voice | tier, build, seed or replay | reference moment |
|
|
154
|
+
|
|
155
|
+
One machine-readable object per slot with the same fields. Publish the storyboard as a page (the timeline on bars, play
|
|
156
|
+
and cinematic lanes, a still per slot) and republish it when the structure changes.
|
|
157
|
+
|
|
158
|
+
### 9. The delivery plan (two steps)
|
|
159
|
+
|
|
160
|
+
- **Step A, a good cut early:** the first full real cut (no slates, no placeholders) by hour 8-10; a cut that clears every
|
|
161
|
+
note so far by hour 16-20, labelled as one they could stop on.
|
|
162
|
+
- **Step B, polish to the owner's call:** every cut labelled with its change list and which cut to judge; copied by the
|
|
163
|
+
cut chain to their folder and read back; cadence matched to their attention (the OG Snipers owner gave notes on 7 of 19
|
|
164
|
+
cuts and came back to the newest). "Final" only for what is final; when they say final, stop and render the master at
|
|
165
|
+
its native format.
|
|
166
|
+
- The judge panel's schedule (`opengame-montage-review-and-improve`): a baseline on the first full cut, every third cut, the final candidate.
|
|
167
|
+
|
|
168
|
+
### 10. Pre-mortem
|
|
169
|
+
|
|
170
|
+
- Check the plan against the montage overrides, the hard gates and the owner-eye anticipations, line by line.
|
|
171
|
+
- One blind critic on the storyboard and the reference; filter it through the ledger (reject every device the owner
|
|
172
|
+
banned), log the rejections, and send what is still open in one short message with defaults.
|
|
173
|
+
|
|
174
|
+
## Output
|
|
175
|
+
|
|
176
|
+
In the film repo: `plan/PLAN.md` (the brief in the owner's words; genre, tier and its limits; the day-one answers and defaults;
|
|
177
|
+
reference measurements; music and the grid; the slot table; the payoff model; the speed plan; HUD, transitions, look, ending,
|
|
178
|
+
sound; the capture plan with hooks or replay passes; team; the delivery plan; open questions), `plan/shots.json`,
|
|
179
|
+
`research/grid.json`, `research/*.md`, `plan/DECISIONS.md`, `work/OWNER-NOTES.md`, the storyboard link, and a line in
|
|
180
|
+
`film/SKILLS.log`. Then: "Plan ready. Run `opengame-montage-make`."
|
|
181
|
+
|
|
182
|
+
## Don't
|
|
183
|
+
|
|
184
|
+
- Don't let a reference number or a trailer default outrank the owner's word (varied gaps, designed silences, short
|
|
185
|
+
tails, held aim, a 30 % title).
|
|
186
|
+
- Don't cast the hero, skins, maps or title from an audit; ask with a casting sheet.
|
|
187
|
+
- Don't tune any animation or physics before the payoff framing is decided.
|
|
188
|
+
- Don't plan speed as constant slow motion, one-frame steps, interpolation or a retrofit; at tiers C-E, say the limit.
|
|
189
|
+
- Don't fill every grid point with a payoff; a beat can be a movement or a cut.
|
|
190
|
+
- Don't plan capture below the master format.
|
|
191
|
+
- Don't plan a cinematic tied to nothing, or the hero alone as a showpiece.
|
|
192
|
+
- Don't plan a direction check made of placeholders; ask in words or stills. Don't touch the owner's song.
|
|
193
|
+
- Don't spend on generation without the person's go-ahead, on their own account.
|