@opengamehq/skills 1.4.0 → 1.6.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 +36 -0
- package/README.md +12 -4
- package/dist/.claude-plugin/marketplace.json +26 -0
- package/dist/skills/manifest.json +1407 -143
- 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 +25 -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 +108 -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 +190 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +229 -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 +90 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +120 -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 +121 -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 +40 -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 +16 -0
- package/dist/skills/opengame-cli/SKILL.md +13 -11
- package/dist/skills/opengame-deploy/CHANGELOG.md +24 -0
- package/dist/skills/opengame-deploy/SKILL.md +47 -21
- package/dist/skills/opengame-deploy/references/json-events.md +6 -5
- package/dist/skills/opengame-deploy/references/manifest.md +3 -2
- package/dist/skills/opengame-deploy/references/packaging.md +29 -26
- 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 +59 -37
- 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 +8 -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 +12 -0
- package/dist/skills/opengame-sdk/SKILL.md +26 -9
- package/dist/skills/opengame-sdk/references/engines.md +2 -2
- package/dist/skills/opengame-sdk/references/identity.md +10 -11
- 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
|
+
# Montage briefs: what to hand each agent
|
|
2
|
+
|
|
3
|
+
Write a brief to disk before spawning any agent; the brief is the agent's whole context. Fill every `{brace}` and paste
|
|
4
|
+
the whole brief. These are the briefs the OG Snipers montage ran on, with what each one learned.
|
|
5
|
+
|
|
6
|
+
## 1. Common brief (every agent reads it first)
|
|
7
|
+
|
|
8
|
+
> Film: a {length} s gameplay montage of **{GAME}** ({genre, engine}), cut to {the song, BPM}, in the style of {the
|
|
9
|
+
> reference edit}. Master {format}; review cuts at 1080p60. The song is played, not edited; the music leads the mix.
|
|
10
|
+
> Frozen build {id, hash}; film build {path}, owned by {role}; capture tier {A-E}. The owner's words are in
|
|
11
|
+
> `work/OWNER-NOTES.md` and the notes ledger; the praised list is `work/PRAISED.md`.
|
|
12
|
+
>
|
|
13
|
+
> House rules: write only inside {your output path}; never modify the game team's workspace; never kill a process you did
|
|
14
|
+
> not start (by verified process id, never by pattern). Heavy jobs (browsers, captures, renders, encodes) go through
|
|
15
|
+
> {your machine's job queue, if it has one}, with thread caps. Never play audio aloud. Never print or log keys, or pass them as command-line
|
|
16
|
+
> arguments; read them inside the process. Never use `git stash` in a shared checkout. Keep {N} GB of disk free and
|
|
17
|
+
> check before every take; delete rejected masters only from a keep-list built from the select files. Requests to
|
|
18
|
+
> another agent go in `work/REQUESTS.md`; decisions go in `plan/DECISIONS.md`, one dated line each. Paid generation
|
|
19
|
+
> only on the person's own account, through the capped ledger; approval: {verbatim}. Read your inbox
|
|
20
|
+
> (`inbox/{role}.md`) at the start of every task and before queuing any take. Report readiness in
|
|
21
|
+
> `status/{role}.json` (author, cut id, commit, READY), never only in a log. Every wait ends on success, a failure line,
|
|
22
|
+
> or 15 minutes, then reads the real state. A progress line every 20 minutes with the UTC time from `date -u`. Report
|
|
23
|
+
> measurements, not impressions; never invent a number; quote the owner, never paraphrase them.
|
|
24
|
+
|
|
25
|
+
## 2. Research fan-out (plan step; on OG Snipers seven agents landed in 58 minutes)
|
|
26
|
+
|
|
27
|
+
Every research agent is read-only, writes one file into `research/`, backs every claim with a file and line or a
|
|
28
|
+
measurement, and writes a progress line every 20 minutes.
|
|
29
|
+
|
|
30
|
+
- **R-GAME:** the game bible (the filmable chapter): the money event from score events, announcer lines and banners; its
|
|
31
|
+
read time; whether the game has replay, determinism and hitstop; the HUD that carries the stakes; the genre's fake tell;
|
|
32
|
+
known risks to footage.
|
|
33
|
+
- **R-CAPTURE:** the capability checklist C1-C19 and the capture tier, with one 20-minute probe judged on frames (replay
|
|
34
|
+
fidelity, slow-motion duplicates, ragdoll or physics stepping, HUD toggles, debug overlays).
|
|
35
|
+
- **R-MUSIC:** measure the song into `research/grid.json` (the song chapter): tempo and drift, bar 1, sections, the vocal's
|
|
36
|
+
end, the door to the end shot.
|
|
37
|
+
- **R-REF:** the reference edit measured as a study (the reference-study chapter), with a rubric for the judges and a
|
|
38
|
+
steal list.
|
|
39
|
+
- **R-REFS:** 3-5 more edits of this genre, measured (cuts, shot lengths, beat lock, ramp shape, flashes, grade).
|
|
40
|
+
- **R-SOUND:** the game's sound inventory organised by payoff, movement and secondary sounds; its callouts and their
|
|
41
|
+
intelligibility over the song.
|
|
42
|
+
- **R-PLAYER:** 3-5 minutes of a good human playing the real game, measured into a timing and aim model (acquisition,
|
|
43
|
+
settle, hold, drift) with bot-tell thresholds (the reference-study chapter shows the sniping version).
|
|
44
|
+
|
|
45
|
+
Never let research pick the hero, the skins, the maps or the title: those are the owner's taste, asked on day one.
|
|
46
|
+
|
|
47
|
+
## 3. Shooter (one per range of slots)
|
|
48
|
+
|
|
49
|
+
> Read first: the common brief, your inbox, `plan/PLAN.md` (the slot table, the payoff model, the speed plan),
|
|
50
|
+
> `plan/shots.json` (your slots), `research/grid.json`, the film build's hooks file, the grammar chapter, the owner-notes
|
|
51
|
+
> table and the praised list.
|
|
52
|
+
>
|
|
53
|
+
> For each slot: write the spec as code from `grid.json` (payoffs on grid frames at the beat − 3 frames; movement accents
|
|
54
|
+
> with their measured leads; speed keys eased per AE1-AE4; the seed, build and clock frozen with the select). Preflight it
|
|
55
|
+
> offline before it takes a slot (lines of fire, cover, opponents' paths, clock sums). Shoot; run the take checks;
|
|
56
|
+
> shoot the payoff cinematic from the same run (the seeded take with a stage camera, the input replay, or the replay's
|
|
57
|
+
> free camera), with the two-pass lens solve when the framing must include X and exclude Y on every frame.
|
|
58
|
+
>
|
|
59
|
+
> Offer a take only with three full-size graded frames, an every-frame strip of every receiver and hero shot, the take
|
|
60
|
+
> check's results, and what is weak, said plainly. Never cut a shot the owner praised: fix it by re-staging, re-framing or
|
|
61
|
+
> a build request. Never delete a master a select names. Self-review every take harshly: three honest lines (great,
|
|
62
|
+
> weak, with another hour). Keep at most one master-resolution take in flight, in your own port range. Report in
|
|
63
|
+
> 120-300 words: per slot the select, payoff accuracy, the take check, what is placeholder, what is unchecked, and the
|
|
64
|
+
> calls the owner might want to change.
|
|
65
|
+
|
|
66
|
+
## 4. Resume brief (on disk at all times)
|
|
67
|
+
|
|
68
|
+
> Resume brief #{n} ({role}, {UTC time}). The previous session {hit a usage limit / lost its provider / restarted}. Read
|
|
69
|
+
> this, the common brief, your inbox, `plan/DECISIONS.md` and your role's last lines in the progress log. Do not redo what
|
|
70
|
+
> exists: check select timestamps, take check files and proxies first. What changed since the stop: {the owner's newest
|
|
71
|
+
> notes verbatim; builds; machine share}. Your items and their state: {list}. Unreviewed takes that landed after the stop:
|
|
72
|
+
> {review, select or reject; do not reshoot}. Scope, if frozen: {item, state, owner}; if one item runs more than about
|
|
73
|
+
> 45 minutes behind, cut without it and say which. Finish line: {the next cut and what it must carry, then the sweep,
|
|
74
|
+
> the A/B against the last cut, delivery to the owner's folder read back; the master only when the owner says final}.
|
|
75
|
+
> When done, write `{role} FINAL DONE` in the progress log.
|
|
76
|
+
|
|
77
|
+
## 5. The independent every-frame sweep
|
|
78
|
+
|
|
79
|
+
For the director (not pasted): the review source with the best hit rate on OG Snipers. It flagged 14.5 of the 29 owner
|
|
80
|
+
defect notes it could have seen (50 %), against 10 % for blind critics and gates and 0 % for a judge panel that never
|
|
81
|
+
ran. Its independence is the point: a sweep that read no earlier report or ruling found an alternate-frame head flip the
|
|
82
|
+
director had ruled in. Run one on every cut that will be sent, on the edit render while the finishing pass runs, so it
|
|
83
|
+
lands **before** the send. Use a different model each time, rotating vendors among those the person's setup already has.
|
|
84
|
+
Check a sample of its A rows on the delivered file before trusting it, and write TRUE, OVERSTATED, FALSE or DESIGN beside
|
|
85
|
+
every row you act on. It reports; it never decides. It once recommended cutting every faulted shot the owner had praised,
|
|
86
|
+
and following it cost about a day: fill in the praised list every time.
|
|
87
|
+
|
|
88
|
+
> You are sweeping a gameplay montage cut frame by frame for everything that looks cheap, broken, fake or unfinished. The
|
|
89
|
+
> owner has said: "im not going to call out every single slop point u need to find all this urself". Your job is to be
|
|
90
|
+
> the eye that finds every such point before they do. Be exhaustive and exact; no praise, no taste essays, no scores.
|
|
91
|
+
>
|
|
92
|
+
> Read only, on every project file. Write only your report and your own scratch under {scratch dir}. Do the work
|
|
93
|
+
> yourself; start no subagents. The machine is shared: `nice -n 10`, ffmpeg `-threads 6`, no GPU, no browser, never play
|
|
94
|
+
> audio aloud. Keep scratch under {2 GB}; delete each frame dump once you have looked at it.
|
|
95
|
+
>
|
|
96
|
+
> THE FILM: {cut path} ({N} s, {frames} frames at {fps}, {resolution}): a montage of {GAME, one line}, cut to {the song,
|
|
97
|
+
> BPM}. It has {primary-view clips} with outside cinematics cut in ({what they show}), an opening and an end shot {with /
|
|
98
|
+
> without a title}. Do NOT read the project's plans, notes, reviews, rulings, earlier sweeps or code. You may read
|
|
99
|
+
> {ledger lines} (the owner's words) and the reference edit {path}.
|
|
100
|
+
>
|
|
101
|
+
> WHAT THE OWNER HAS ALREADY CALLED SLOP (their words; find every further instance of each, and anything of the same
|
|
102
|
+
> family they have not named): {their complaint lines, verbatim}. The families from earlier films, which hold for any
|
|
103
|
+
> genre:
|
|
104
|
+
> - surface flicker or z-fighting anywhere on a map or level;
|
|
105
|
+
> - slow motion that judders, steps or drops frames on any object; a character jittering or shaking;
|
|
106
|
+
> - an opponent or AI stuck, running into geometry, shuttling back and forth, idle, or in a row facing the lens; clones;
|
|
107
|
+
> - any part passing through another: limbs through stairs, rails or ground, a weapon through a body or a wall;
|
|
108
|
+
> - a reaction shown before its cause; the same payoff shown twice;
|
|
109
|
+
> - an outside shot showing the player-view rig (a floating arm) or the wrong subject, place or moment for its payoff; a
|
|
110
|
+
> hero shot that crops the character the owner wanted seen whole;
|
|
111
|
+
> - menus, loading screens, lobbies or results screens anywhere in the film;
|
|
112
|
+
> - an angle where the payoff cannot be read; an insert in the middle of a chain with no reason;
|
|
113
|
+
> - dead time after a clip's last payoff; the player searching (looking around) between payoffs;
|
|
114
|
+
> - the low-skill form of the core action where only the high-skill form is allowed; a trick at slowed speed;
|
|
115
|
+
> - {the parts of a body the owner wants out of frame on impact shots};
|
|
116
|
+
> - HUD that differs between clips (spacing, anchor, icons), names repeated in a feed, HUD the owner did not allow;
|
|
117
|
+
> - a speed change in one frame; a payoff cinematic at one constant slow speed; a held or duplicated frame; a stray frame;
|
|
118
|
+
> - a sound louder than the payoffs, a payoff noticeably louder or quieter than the rest, a secondary sound over its
|
|
119
|
+
> payoff, a tail cut dead, a stray tone or beep, the song changed or dropping out;
|
|
120
|
+
> - the genre's own fake tells: {from the genre chapter}.
|
|
121
|
+
>
|
|
122
|
+
> PRAISED: {the shots the owner said they like, with frames and their words}. On a praised shot report ONLY the families
|
|
123
|
+
> above that the owner themselves complained about, as fixes, and mark every other remark on it "taste, not a defect".
|
|
124
|
+
> Never recommend CUT for a praised shot: recommend the smallest fix.
|
|
125
|
+
>
|
|
126
|
+
> METHOD.
|
|
127
|
+
> 1. Extract EVERY frame (in ranges of about 300) and look at them with your image tool: every outside, cinematic, hero
|
|
128
|
+
> and payoff shot on every frame at full size; the primary view on every 3rd frame plus every frame from 14 before to
|
|
129
|
+
> 20 after each payoff. Make tiled strips of consecutive frames (6-8 a row) so motion, stutter and flicker show across
|
|
130
|
+
> neighbours. Never judge a body from every-2nd-frame sheets: alternate-frame flips hide there.
|
|
131
|
+
> 2. Measure as well as look: per-frame difference of a tracked region; a body that does not move on a frame while its
|
|
132
|
+
> neighbours do; a small region alternating A-B-A-B (on head, hand and weapon crops, not only the hips); a one-frame
|
|
133
|
+
> camera jump.
|
|
134
|
+
> 3. Follow every opponent who is ever in frame: where are they going, are they blocked, idle, sliding, duplicated,
|
|
135
|
+
> popping?
|
|
136
|
+
> 4. Put the same crop of every recurring HUD element from every clip on one sheet and diff the anchors in pixels.
|
|
137
|
+
> 5. Sound, on the delivered mix: every payoff's in-band RMS (150 Hz-8 kHz over 300 ms from its attack) in one table with
|
|
138
|
+
> the median and spread; every transient ranked (name anything louder than the loudest payoff); secondary sounds
|
|
139
|
+
> against their clip's payoff; callout offsets and levels; a spectrogram pass for stray tones.
|
|
140
|
+
>
|
|
141
|
+
> REPORT {report path}:
|
|
142
|
+
> 1. One table, one row per defect, sorted by frame: frames (first to last), clip or shot, family, exactly what is wrong
|
|
143
|
+
> and where in the frame, severity (A: the owner would stop on it; B: visible on a second watch; C: frame-step only),
|
|
144
|
+
> the smallest fix (re-frame, re-stage, trim to frames x-y, re-shoot, level by N dB).
|
|
145
|
+
> 2. Standing asks: each of the owner's rules {list} with PASS or FAIL and the evidence.
|
|
146
|
+
> 3. The ten worst, in order.
|
|
147
|
+
> 4. Every outside shot marked KEEP, FIX or CUT (never CUT a praised shot), and the shots you found clean.
|
|
148
|
+
> 5. How many frames you looked at, and anything you could not check.
|
|
149
|
+
>
|
|
150
|
+
> Append a progress line at the start and at the finish. Final message: counts by family and severity, the ten worst
|
|
151
|
+
> with frames, and the standing asks that FAIL.
|
|
152
|
+
|
|
153
|
+
## 6. The judge panel: three blind judges against the golden edit
|
|
154
|
+
|
|
155
|
+
For the director (not pasted):
|
|
156
|
+
|
|
157
|
+
- **Why it exists.** The OG Snipers owner asked for "a council/panel of judges ... each give scores ... where 10/10 is the
|
|
158
|
+
level of [the reference edit] ... and score our edit across diff dimensions out of 10 vs the golden set". It never ran:
|
|
159
|
+
it was held for "the bar is met" at every cut from the third to the nineteenth, and the owner called the final with no
|
|
160
|
+
score.
|
|
161
|
+
- **Who.** Three independent judges from different model vendors (the owner's named models if they give them; whatever
|
|
162
|
+
the person's agent setup already has, never bought credit without asking), on high effort, each blind to plans, code,
|
|
163
|
+
notes and each other. The same brief and rubric every round, so scores move only because the film moved.
|
|
164
|
+
- **When.** A baseline on the first full cut that passes QA and the owner-note gates; then every third delivered cut, or
|
|
165
|
+
as soon as a cut passes the director's own bar, or after three cuts with no new owner note; on the final candidate;
|
|
166
|
+
whenever the owner asks. If the owner says not to start it until the bar is met, run it anyway as a measuring stick and
|
|
167
|
+
keep its verdict out of their updates until then; say so once.
|
|
168
|
+
- **Reading it.** Each dimension's median and spread; a spread over 2 points means measure it, not argue it. Map every
|
|
169
|
+
owner note to a dimension; where the judges scored 7 or more and the owner complained, rewrite that rubric line in the
|
|
170
|
+
owner's words. Treat the gap list like any critic's: filter it through the ledger and the montage overrides, reject any
|
|
171
|
+
fix that contradicts the owner (designed silences, varied gaps, shorter tails, held scopes and cutting praised shots
|
|
172
|
+
all did on OG Snipers), verify the rest on frames of the delivered file, then route. A judge reports; it never decides.
|
|
173
|
+
- **The finish line** is the owner's approval unless they name the panel's target as the finish line.
|
|
174
|
+
|
|
175
|
+
> You are one of three independent judges on a panel. You are a veteran of two worlds: the editor who cuts the best
|
|
176
|
+
> {genre} montages ({the reference editor}) and the creative director of {the genre's official gameplay trailers}. You did
|
|
177
|
+
> not make the film you are judging and have no stake in it. Be severe and exact. A score is evidence, not
|
|
178
|
+
> encouragement: praise only what is truly at the bar. You judge alone; do not look for the other judges' reports.
|
|
179
|
+
>
|
|
180
|
+
> Read only. Do not edit any project file. Do not read the film's source code, plans, briefs, notes, review files,
|
|
181
|
+
> rulings or history: judge only what is on screen and in the sound. Never play audio aloud; measure it.
|
|
182
|
+
>
|
|
183
|
+
> THE FILMS. GOLD (10/10 by definition): {path}, {editor, title, length, rate}. The owner's words on it: {verbatim}. Its
|
|
184
|
+
> measured study: {research/REF-STUDY.md} (read it whole). If GOLD has no ending, use {other edits by the same editor} for
|
|
185
|
+
> endings. OURS: {cut path} ({resolution}, {rate}, {N} s): a montage of {GAME}, cut to {the song}. The song file alone:
|
|
186
|
+
> {path} (for a null test). Its gate report {path} may be used and should be spot-checked.
|
|
187
|
+
>
|
|
188
|
+
> WHAT THE OWNER ASKED FOR (do not mark the film down for obeying them): {their standing rules for this film, verbatim}.
|
|
189
|
+
> Never award points for a device of GOLD that they banned, and never subtract them for its absence.
|
|
190
|
+
>
|
|
191
|
+
> METHOD. ffmpeg and Python only (`nice -n 10`, `-threads 6`), a private environment under {scratch dir}, raw output there
|
|
192
|
+
> (under {3 GB}); write nothing else except your report. Watch OURS start to finish once as a viewer would (a 12 fps pass
|
|
193
|
+
> in order) before taking it apart. Look at frames: 2 fps overviews of both films; every-frame strips across every cut,
|
|
194
|
+
> ramp, transition and payoff in OURS, and the matching moments in GOLD. Frame-exact grabs with `select=eq(n\,N)`, never `-ss`.
|
|
195
|
+
> Measure: cuts and shot lengths; payoff spacing in beats; payoffs on the beat at the picture lead; the payoff cycle
|
|
196
|
+
> (glide, rise, peak, fall) and its peak over glide; seam speeds in and out; duplicate and held frames; luma per section
|
|
197
|
+
> and at cuts; loudness; every payoff's in-band RMS and its spread; any transient louder than the loudest payoff; the
|
|
198
|
+
> song against the supplied file (untouched?). "Payoff" is the genre's peak event: {kill / goal / overtake / combo ender /
|
|
199
|
+
> boss break / clear}.
|
|
200
|
+
>
|
|
201
|
+
> THE RUBRIC: score each 0-10, GOLD = 10, with a timestamp in OURS, the matching moment in GOLD, and a number where one
|
|
202
|
+
> exists. Half points allowed; above 10 with a reason; a dimension where OURS equals GOLD is a 10.
|
|
203
|
+
>
|
|
204
|
+
> | # | Dimension | What 10 looks like | Evidence required |
|
|
205
|
+
> |---|---|---|---|
|
|
206
|
+
> | 1 | Sync to music | every payoff on the beat at the picture lead (±2 frames); cuts married to hits; equal spacing where the owner wants "a very clear beat" | a payoff-against-grid table; the share of cuts on onsets; off-beat payoffs listed |
|
|
207
|
+
> | 2 | Flow and transitions | every cut carries motion or a stated cause; transitions caused by the picture, never pasted; nothing randomly comes in | seam speeds in and out; dead seams; uncaused transitions |
|
|
208
|
+
> | 3 | Speed ramps | eased fast-slow-fast on every payoff and on cinematics; real slow motion, never interpolated; no constant-speed slow spans | the speed curve per payoff; the share at constant speed; the largest one-frame change |
|
|
209
|
+
> | 4 | Camera and cinematics | outside shots tied to their gameplay moment (same subject, place, frames); a clear angle; lens variety; moves into the map that hand into the primary view | per cinematic: subject, angle, tie right or wrong, every-frame motion |
|
|
210
|
+
> | 5 | Payoff moments | each payoff seen and read at a glance; its consequence completing inside the shot; framed on what animates well | frames of each payoff and reaction; reaction start within 12 frames |
|
|
211
|
+
> | 6 | Play reads as a real skilled human | movement and aim like a top player; opponents moving like players; no dead holds, searching or stuck AI; no misses | idle spans; opponent paths; misses |
|
|
212
|
+
> | 7 | HUD and text | exactly the allowed HUD, identical in every clip; text only where allowed, in the world, legible | a cross-clip HUD sheet; title crops from the finished file |
|
|
213
|
+
> | 8 | Sound mix | the music leads; payoffs level as heard; tails ring out; no transient louder than the payoffs; callouts at the owner's level and timing | a per-payoff level table; a transient ranking; the song null test |
|
|
214
|
+
> | 9 | Grade and look | one authored look that keeps the game's colours; no clipped highlights; light continuous within a sequence | luma and saturation per section; clipped share |
|
|
215
|
+
> | 10 | Pacing and structure | a shape that follows the song; clip sizes as the owner wants them (a default, a bigger one, a unique finale); no filler | payoffs per clip and section; filler shots |
|
|
216
|
+
> | 11 | Polish (nothing cheap) | no clipping, flicker, pop-in, floating parts, duplicate or stray frames on any frame | defect rows with severity |
|
|
217
|
+
> | 12 | Ending | the owner's ending: one shot, the title in the world if allowed; the song untouched | every frame of the ending; the title read at 480 px |
|
|
218
|
+
> | 13 | Overall against GOLD | would GOLD's editor sign it; would the owner share it | one paragraph; the three best and three worst moments |
|
|
219
|
+
>
|
|
220
|
+
> For every dimension add one owner-proxy line: what the owner would say, in their voice, after reading the owner-eye
|
|
221
|
+
> chapter and the ledger lines above.
|
|
222
|
+
>
|
|
223
|
+
> DELIVER {work/review/panel/{round}/{judge}.md}: (1) the thirteen scores on one line, then `OVERALL: N/10` and
|
|
224
|
+
> `Proxy score: N/10`; (2) the gap list, every dimension under 10 ranked by points lost: what is wrong (frames in OURS),
|
|
225
|
+
> what GOLD does at the equivalent moment (frames), and the smallest change that closes it, in frames, speeds, lenses and
|
|
226
|
+
> dB; (3) shot by shot: frames, what it is, a 0-10 grade, the one thing to fix; (4) every seam: clean, jerky or dead, with
|
|
227
|
+
> measured speeds; (5) must not change: what already meets the bar; (6) if your previous report is given, every earlier
|
|
228
|
+
> finding marked Fixed, Partly or Still there. End your final message with the thirteen scores on one line,
|
|
229
|
+
> `OVERALL: N/10` and `Proxy score: N/10`.
|
|
230
|
+
|
|
231
|
+
## 7. The blind critic, the owner proxy, the blind A/B and the fixer
|
|
232
|
+
|
|
233
|
+
**The blind critic** (on the plan's storyboard in the pre-mortem, and on cuts alongside the sweep):
|
|
234
|
+
|
|
235
|
+
> You are a harsh, unbiased reviewer of {an N-second gameplay montage} of {GAME, one line}, in the role of {the
|
|
236
|
+
> genre's best montage editor} and of the creative director of {the genre's official gameplay trailers}. You did not
|
|
237
|
+
> make it and have no stake in it. Be specific and severe; praise only what is at that bar. Read only: do not look at
|
|
238
|
+
> any source code, plans, notes, briefs or history; judge only the film (or the storyboard). Every note must be
|
|
239
|
+
> specific, measured where possible, and buildable.
|
|
240
|
+
>
|
|
241
|
+
> The film: {path}. The reference edit: {path} and its study {research/REF-STUDY.md}. The owner's eye: {the owner-eye
|
|
242
|
+
> chapter} and {the notes ledger}. What the owner asked for, which you must not mark down: {their standing rules,
|
|
243
|
+
> verbatim}. Notes the owner already gave on this cut, not to be reported again: {list}.
|
|
244
|
+
>
|
|
245
|
+
> Method: ffmpeg and Python only; 2 fps overviews; every-frame strips across every cut, ramp and payoff; frame-exact grabs
|
|
246
|
+
> with `select=eq(n\,N)`; flow for camera speed; beats and onsets; per-payoff in-band RMS on the mix; `nice -n 10`;
|
|
247
|
+
> never play audio aloud. Append a progress line to {log} every 20 minutes.
|
|
248
|
+
>
|
|
249
|
+
> Deliver {review/rNN/CRITIC.md}: a measured headline (payoffs on the beat at the picture lead, payoff spacing, speed
|
|
250
|
+
> curves, seam speeds, the play-to-cinematic split, hit levels as heard, the song untouched or not) with the reference's
|
|
251
|
+
> numbers beside it; scores out of 10 against the reference; at least 15 fixes with frames, what is wrong (measured), the
|
|
252
|
+
> reference moment and a buildable fix; the owner-proxy list in their voice ending in `Proxy score: N/10`; a must-not-change
|
|
253
|
+
> list; and, if a previous report exists, every earlier finding marked Fixed, Partly or Still there.
|
|
254
|
+
|
|
255
|
+
Filter every proposal through the ledger and the montage overrides before it reaches a fixer: on OG Snipers critics pushed
|
|
256
|
+
held scopes, varied gaps, designed silences and shorter tails, and the owner reversed all four.
|
|
257
|
+
|
|
258
|
+
**The owner proxy:** "Be the owner. Read the owner-eye chapter and the notes ledger in full first. For each problem: the
|
|
259
|
+
timestamp (seconds and 60 fps frame), what they would say in one blunt line, then the concrete fix. Rank by how annoyed
|
|
260
|
+
they would be. Then the things they would still ask for. End with `Proxy score: N/10`. Praise nothing they would not."
|
|
261
|
+
|
|
262
|
+
**The blind A/B of changed shots:** "Two cuts, A and B, unlabelled. Judge every changed shot and every seam: which is better
|
|
263
|
+
and why, with frames. Flag what the losing cut did better so nothing good is lost. Do not guess which is newer." Then
|
|
264
|
+
compare the whole cut against the previous one for anything lost.
|
|
265
|
+
|
|
266
|
+
**The fixer** (one per owner of a file set, per round):
|
|
267
|
+
|
|
268
|
+
> **The owner's notes, verbatim, at the top:** {quotes with ledger numbers, times, frames}. Read the common brief first.
|
|
269
|
+
> You own {slots or files}; nothing else is yours.
|
|
270
|
+
>
|
|
271
|
+
> Findings to fix (from the filtered fix list): {slot and frames}: what is wrong (measured), the target (a number), the
|
|
272
|
+
> reference moment. **First confirm each defect at the cited frames on the delivered file.** If it is not there, say so
|
|
273
|
+
> and skip it.
|
|
274
|
+
>
|
|
275
|
+
> **Do not change:** {the must-not-change list, starting with the praised list, verbatim}. Never cut a praised shot: fix
|
|
276
|
+
> it.
|
|
277
|
+
>
|
|
278
|
+
> Make the smallest change that answers the note, and sweep the class in your slots. Check on rendered frames, never by
|
|
279
|
+
> reading code. Time box: if nothing lands within about {75} minutes, finish with what exists and say so. Report in
|
|
280
|
+
> 120-300 words: what changed (frame ranges, numbers before and after), what is placeholder, what is unchecked, and the
|
|
281
|
+
> calls the owner might want to change.
|
|
282
|
+
|
|
283
|
+
## 8. Notes from the film to the game team (append-only)
|
|
284
|
+
|
|
285
|
+
Keep `handoff/GAME-NOTES.md` from day one, and ask the owner to paste its protocol into the game team's own instructions.
|
|
286
|
+
Each note has an id (F-n), the date, a priority (P1 visible in the film now and cheap-looking; P2 worked around; P3 nice
|
|
287
|
+
to have), what looks wrong, the owner's words verbatim, the evidence frames, the file and line at the frozen build, what
|
|
288
|
+
"fixed" looks like, the film's workaround and the shot it serves. The game team replies in `handoff/GAME-REPLIES.md`,
|
|
289
|
+
one line per note: the release that ships it and what changed, or "won't do, because ...". A fix the film made in its
|
|
290
|
+
own build is linked as a patch behind one flag, with before and after crops, so the game can take it as is. File a P1
|
|
291
|
+
note on day one for every payoff that depends on game behaviour (deaths, ragdolls, damage rules, opponent pathing).
|
|
292
|
+
Notes that name a cause at file and line and a measured defect ship fastest; the film never waits on the game, and
|
|
293
|
+
never edits the game team's source.
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# The 30 day-one questions, with defaults
|
|
2
|
+
|
|
3
|
+
Ask them in **one message within the first hour**, grouped as the ten groups in `opengame-montage-plan`, each with a default and,
|
|
4
|
+
where one helps, a picture to choose from. A demanding owner answers "which of these" and yes/no fast and leaves
|
|
5
|
+
open-ended sheets unanswered: if nothing comes back, take the default, log it in `plan/DECISIONS.md` and keep going.
|
|
6
|
+
Answer from the repo, the build and the song anything that is not the owner's taste; ask each question once. "Payoff" is
|
|
7
|
+
the genre's peak event; "skin" is a camo, livery, costume or palette.
|
|
8
|
+
|
|
9
|
+
Every one of these cost hours on the OG Snipers montage because it was not asked. The defaults are what that owner
|
|
10
|
+
settled on; your owner may differ, which is why you ask.
|
|
11
|
+
|
|
12
|
+
| # | Question | Default if unanswered | Why it is asked (OG Snipers) |
|
|
13
|
+
|---|---|---|---|
|
|
14
|
+
| 1 | Where in the song does the montage end, and how long is the ending after it? | the measured structural point (the end of the vocal), an ending of 3-5 s; confirm the length in one line | "around 60 seconds" and "around 1:30" in one brief |
|
|
15
|
+
| 2 | May the song be edited, faded or dropped anywhere? Any silences? | untouched; one gain; a fade of at most 0.5 s at the end; no holes | "dont randomly change the song"; "u cant have music just go completely blank" |
|
|
16
|
+
| 3 | Is the music always the loudest element? (attach a 20 s mix check) | the music leads; payoffs about 3 dB over it in 1-5 kHz | "music is way too soft"; about ten sound rounds |
|
|
17
|
+
| 4 | Do payoffs sit at a fixed interval on the beat? May a beat be a movement or a cut? | equal spacing at k beats; movement beats allowed | two full re-shoot rounds |
|
|
18
|
+
| 5 | How many payoffs in a normal clip, how big is the biggest, and which clip is the finale? | 5-6; one bigger; a unique finale | "5-6 pieces be the default ... last clip of 10 piece should be unique" |
|
|
19
|
+
| 6 | Which play styles are banned, which tricks count, and at what speed? | only the high-skill form; tricks at real speed, ending in their hardest form | hard scopes banned; "at least 720 and noscope"; "the 720 is way too slow" |
|
|
20
|
+
| 7 | Must every payoff be legal under the real rules? What mix of payoff types? | legal, or staging disclosed per payoff; vary types, with a few pure showpiece clips | staged kills counted as 4, then 7, then 8 |
|
|
21
|
+
| 8 | Which of your own habits should the player copy, and which not? | their measured feel; their habits only where they say | weapon swaps after every shot: "only a few clips" |
|
|
22
|
+
| 9 | How should opponents look and behave? Which names must be unique? | varied as the game varies them, moving like players; names unique wherever readable, from the game's generator | duplicate feed names reported as a bug; stuck bots twice |
|
|
23
|
+
| 10 | Whose character is the hero, in which exact outfit? Does the player-view model (hands, cockpit, board) change? | the owner's own character, exact settings (an account link or a screenshot); the player view as shipped | about 10 hours on the wrong hero; "no dont change first person shots" |
|
|
24
|
+
| 11 | Your shortlist of skins? Is reuse fine? | their list, reuse allowed; a casting sheet before shooting | four turns on camos; "this is a terrible camo to use" |
|
|
25
|
+
| 12 | Which weapons, cars, characters or loadouts, with which iconic attachments? | the most iconic per clip, their pairings | one clip's weapon had to wear a specific sight |
|
|
26
|
+
| 13 | Which maps, tracks or levels are must-show, and which go first if clips need length? | the best known first | "cut the least popular / known ... maps" |
|
|
27
|
+
| 14 | Which kinds of cinematic do you like? (three stills: a move into the map handing into the player view; the payoff from the receiver's side; the hero alone) | the first two; the hero alone only as a signature moment | they praised the first two and never the third |
|
|
28
|
+
| 15 | In impact shots, which part of the body (car, board) may be in frame? | frame out what the engine animates worst | "dont see the bottom half of body" on day 3 made a day of tuning moot |
|
|
29
|
+
| 16 | Eased speed ramps everywhere, cinematics included? (send a pilot clip) | yes; a pilot on day one | asked at the 17th cut; on 3 of 13 clips at the final |
|
|
30
|
+
| 17 | Once you like a shot, may I ever remove it without asking? | no: assume it, do not ask | the third cut removed every praised cinematic with a fault |
|
|
31
|
+
| 18 | Which HUD elements show? (a frame of each next to the shipped game) | success feedback only, pixel-identical to the game | feed spacing raised twice, 42 hours apart |
|
|
32
|
+
| 19 | Any text? If a title: material, font (five on the real plate), in the air or on the ground, how it animates? Or no title rather than a weak one? Confirm any name or word in one line | no text unless they say so; offer a cut without the title early | 23 hand-ins; a name dictated with a typo had to be confirmed (dictation garbles names) |
|
|
33
|
+
| 20 | What is the ending: one shot or a sequence, how long, what does the hero do? | one shot of 3-5 s, the hero's calm moment | "one scene and 3-5s long" |
|
|
34
|
+
| 21 | Which voice lines, where relative to their trigger, how loud? Any to drop? | the game's own callouts, sparing, 0.1-0.15 s after the trigger, under the song | one callout moved four times; "we dont need the game over voice" |
|
|
35
|
+
| 22 | Keep every game sound as recorded? Add the hit-confirm tick? | keep everything; the tick on | "retain all the gun shot sounds"; "lets have hitmarker sounds topo" |
|
|
36
|
+
| 23 | Do you want the reference editor's finishing layer? (a 15 s look test) | yes, tasteful; lock the approved look | approved first time |
|
|
37
|
+
| 24 | Which parts of the reference matter most? Follow its split of play and cinematics? | flow, ramps, sync, aura; its measured split | "the same split of clips vs cinematics can be what u follow" |
|
|
38
|
+
| 25 | Where do cuts go, in which formats? The review and master formats; capture at the master? | review cuts at 1080p60 16:9 copied to their folder and read back; capture at the master format | "where are we saving all the cuts" twice; the 4K master was an upscale |
|
|
39
|
+
| 26 | A full cut per block of fixes, or one complete cut? Updates how often? | a cut 30-90 minutes after each burst of notes while they are active; one current file while away; a status line every 15 minutes | 13 cuts in a row drew no note (r04 to r15); "its been a long time..." |
|
|
40
|
+
| 27 | Is a judge panel's score the finish line, or your approval? When should it run? | their approval; the panel on a schedule as a measuring stick | the panel never ran |
|
|
41
|
+
| 28 | When is the deadline, and how many rounds do you expect? | a good cut by hour 16-20, then rounds to their call | "perfect and all done 4 hours from now or so"; "how do we speed up" |
|
|
42
|
+
| 29 | What compute and paid spend may I use, on whose account? May I coordinate shared machines with their other sessions directly? | the stated cap on their own account, logged per call; yes, coordinate directly | $2.35 of a $200 cap used; "u should message that thread directly and coordinate" |
|
|
43
|
+
| 30 | What will you never accept on screen? | the never-list from earlier films (hard scopes, clipping, jitter, z-fighting, stuck AI, a reaction before its action, the wrong receiver, dead time after the last payoff, a floating first-person arm), each gated on their own flagged frames before any cut is sent | |
|
|
44
|
+
|
|
45
|
+
Assume without asking: updates every 15 minutes; side work goes to another session; no placeholder is ever sent; a shot
|
|
46
|
+
the owner liked is never removed without asking them.
|
|
@@ -0,0 +1,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.
|