@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,125 @@
|
|
|
1
|
+
# Mix notes
|
|
2
|
+
|
|
3
|
+
## Why the helper's soft clip differs from AW's
|
|
4
|
+
|
|
5
|
+
AW's master chain ends in a WaveShaper with a tanh curve scaled to reach 0.97 at full
|
|
6
|
+
scale (`tanh(x * 1.6) * 0.97 / tanh(1.6)`). Its comment describes the curve as within
|
|
7
|
+
0.1 dB of unity below -8 dBFS. Computed, the curve adds about 4.5 dB to quiet signals
|
|
8
|
+
(+4.52 dB at -30 dBFS, +3.45 dB at -8 dBFS) and only reaches unity near full scale,
|
|
9
|
+
because scaling a tanh to its ceiling also scales its slope at zero. Sitting after the
|
|
10
|
+
limiter, it lifts everything quiet and moves the true ceiling.
|
|
11
|
+
|
|
12
|
+
The helper's curve is exactly unity below a knee and a tanh shoulder above it that
|
|
13
|
+
approaches the ceiling without passing it, continuous in value and slope at the knee.
|
|
14
|
+
`chainProperties` checks a -8 dBFS signal passes within 0.1 dB, and the self-test plants
|
|
15
|
+
AW's curve to prove that check sees the difference. Measure any curve you write the same
|
|
16
|
+
way; a comment about a curve is a claim, not a measurement.
|
|
17
|
+
|
|
18
|
+
## Sound families for a shooter
|
|
19
|
+
|
|
20
|
+
Plan the families from the whole game before production, not from the few actions in an
|
|
21
|
+
early blockout. For a shooter (ST's list):
|
|
22
|
+
|
|
23
|
+
- Weapons: report, body and tail; dry fire; equip and holster; magazine out, in and seat;
|
|
24
|
+
bolt, slide or pump; shell insert and eject; casings by surface.
|
|
25
|
+
- Movement: walk, run, land and jump by the terrain actually walked; ladders as rungs,
|
|
26
|
+
not one sound at the top (AW).
|
|
27
|
+
- Impacts and ricochets by material.
|
|
28
|
+
- Damage, shield and low health; enemy anticipation, action and reaction.
|
|
29
|
+
- Pickups, interaction, objectives; interface focus, confirm and back; results.
|
|
30
|
+
- Ambience per place: a quiet bed plus sparse local events, crossfaded between zones,
|
|
31
|
+
stopped on pause and restarted from the current state on resume, never as a backlog.
|
|
32
|
+
- Music states (menu, exploration, tension, combat, resolution) as tracks or layers with
|
|
33
|
+
deliberate transitions.
|
|
34
|
+
|
|
35
|
+
Other genres need the equivalent depth for their own mechanics. Do not invent weapons or
|
|
36
|
+
materials to reach a count.
|
|
37
|
+
|
|
38
|
+
## Recorded or designed, never a placeholder
|
|
39
|
+
|
|
40
|
+
Our originals ban procedural sound entirely: no runtime oscillators, no synthesised
|
|
41
|
+
fallback, because a fallback that never fires in testing ships as the real sound on
|
|
42
|
+
somebody else's machine. A game whose style is synthesis can design synthesis on purpose;
|
|
43
|
+
what no game should ship is a beep standing in for a sound nobody made.
|
|
44
|
+
|
|
45
|
+
Designed synthesis is a sound somebody made. LC computed its low thump, heartbeat, hums,
|
|
46
|
+
CRT buzz, reverbs and flamethrower in the audio graph on purpose, each measured like any
|
|
47
|
+
recorded file, and OH synthesised its hit ticks from band-passed noise. Neither is a
|
|
48
|
+
fallback: each is the only version of that sound, and each was checked through the same
|
|
49
|
+
gates.
|
|
50
|
+
|
|
51
|
+
## Real recordings first, where they exist
|
|
52
|
+
|
|
53
|
+
LC's gunshots came from a CC0 firearm recording library (it rebuilt the first 2 ms of the
|
|
54
|
+
crack, which the archive had clipped, and kept the recorded tails), and its rain from
|
|
55
|
+
public-domain field recordings with credits; a file with no recorded author was dropped.
|
|
56
|
+
Recorded gunshots peak in about 1.5 ms where LC's generated ones peaked in 10 to 35 ms, and
|
|
57
|
+
no level change closes that gap. Licences and credits: `opengame-assets`.
|
|
58
|
+
|
|
59
|
+
## Generated sound
|
|
60
|
+
|
|
61
|
+
Write prompts like directions to a recordist: source and material, attack, body, tail,
|
|
62
|
+
distance, duration and whether it loops. Keep one acoustic space per family. Trim
|
|
63
|
+
unwanted silence before an attack, keep real tails, and remeasure after every edit. A
|
|
64
|
+
delayed gunshot or footstep is a failed cue when its visible contact already happened.
|
|
65
|
+
See `opengame-assets` for the generation services themselves.
|
|
66
|
+
|
|
67
|
+
Prompts LC found worked for voices of the dead: "one long low growling roar from deep in
|
|
68
|
+
the chest, bass voice, swelling to its end", and for effort, "effort, breath, the throat
|
|
69
|
+
closing, no words". A throat prompted as a woman's came back shrill in 144 of 243 takes. A
|
|
70
|
+
bed prompt names only the bed: OS's ambience prompted with "gravel crunching far away"
|
|
71
|
+
played as footsteps in the menu for three days.
|
|
72
|
+
|
|
73
|
+
## LC's generation pipeline
|
|
74
|
+
|
|
75
|
+
1. A manifest of specs per bank.
|
|
76
|
+
2. A generator that hashes each spec and skips one it has made, checks the cap and the
|
|
77
|
+
credits, reads each call's cost from the response into a sidecar beside the take,
|
|
78
|
+
writes the ledger line before the call and stops when the service fails.
|
|
79
|
+
3. A mastering step: de-clip, de-harsh (a 3.6 kHz bell, a 7 kHz shelf), notch whines,
|
|
80
|
+
limit onsets, fold loops, normalise loudness under a true-peak ceiling, encode Opus,
|
|
81
|
+
then decode and measure again, rejecting with a reason and falling back to the next
|
|
82
|
+
take. Masters are kept.
|
|
83
|
+
4. Banks of at most 80 s, named by content hash.
|
|
84
|
+
5. An audit and a mix render through the game's own graph.
|
|
85
|
+
|
|
86
|
+
It turned 1,891 takes into 520 sounds and 24.6 MB in its first phase, about half the
|
|
87
|
+
takes refused by measurement. Bad takes are removed, never re-pitched.
|
|
88
|
+
|
|
89
|
+
## Listening is a result of its own
|
|
90
|
+
|
|
91
|
+
A recording of the busiest moment, listened to at a consistent level, is a separate
|
|
92
|
+
result from every measurement. Peak and loudness readings, cue counts and a compressor
|
|
93
|
+
in the code do not establish that the game sounds good. Record listening, final-output
|
|
94
|
+
measurement and missing cues as separate lines in a report.
|
|
95
|
+
|
|
96
|
+
## What the libraries cost
|
|
97
|
+
|
|
98
|
+
OC generated its sound with ElevenLabs. Rates as measured on 16 Oct: sound effects about
|
|
99
|
+
11 credits a second, speech 0.43 credits a character, music 13.8 credits a second, at
|
|
100
|
+
$0.000183 a credit. The first library was 1,275 files for $11.70; ElevenLabs spend reached
|
|
101
|
+
$27.56 by 19 Oct against a $500 cap, and the shipped library was 2,895 files. Takes per cue
|
|
102
|
+
were 2 to 4, curated by measurement and then by ear.
|
|
103
|
+
|
|
104
|
+
LC spent $52.17 on ElevenLabs in all, at about $22 per 100,000 credits: a sound-effect bank
|
|
105
|
+
of about 2,650 takes for $20.10, a recast of the dead's voices (about 3,210 readings) for
|
|
106
|
+
$18.56, and a leap set for $7.16; a recast of the radio voices from library voices cost
|
|
107
|
+
$3.17. OS spent $12.15 on music, $9.84 on 2,541 sound-effect takes and $1.82 on speech,
|
|
108
|
+
after the owner asked for a sound identity of its own: "not same voices and music and sfx
|
|
109
|
+
NONE of it the same there pls!".
|
|
110
|
+
|
|
111
|
+
Generated one-shots often peak late. Ask for "one single event that starts instantly at
|
|
112
|
+
0 ms" and cut to the transient. Loop stems need a join with no lag: a loop cut on the beat
|
|
113
|
+
grid stuttered by 45-68 ms.
|
|
114
|
+
|
|
115
|
+
Log the spend before each paid call, and keep the generated files with the prompt that made
|
|
116
|
+
them, so a remake starts from the prompt instead of from memory.
|
|
117
|
+
|
|
118
|
+
## Phones
|
|
119
|
+
|
|
120
|
+
OC's iPhone fixes, most important first, were these. Ship the build that carries audio on
|
|
121
|
+
that device (only the threaded build did). Resume the context on touch, visibility change and
|
|
122
|
+
interruption. Keep the player's weapon in the highest priority class so a busy horde cannot
|
|
123
|
+
take its voices. Never clamp output latency below the mixer's own lead, which garbled every
|
|
124
|
+
device. Test each fix on the phone itself. Emulation passed every build that was silent on the
|
|
125
|
+
real device.
|
package/dist/skills/opengame-all-in-one/references/opengame-audio/references/qa-without-ears.md
ADDED
|
@@ -0,0 +1,177 @@
|
|
|
1
|
+
# Checking sound without ears
|
|
2
|
+
|
|
3
|
+
An agent cannot hear. It can record what the game actually sends to the speakers, line
|
|
4
|
+
that recording up with what the game did, and test stated relationships between sounds.
|
|
5
|
+
LC, OS and OH each built some of the tools below; together they found most of the sound
|
|
6
|
+
faults those games had before a person listened. None of them replaces the person, and
|
|
7
|
+
every report that uses them still opens with what nobody has heard.
|
|
8
|
+
|
|
9
|
+
## The master-bus tap
|
|
10
|
+
|
|
11
|
+
Record the output, not the files. An AudioWorklet in parallel with the destination sees
|
|
12
|
+
exactly what the player would hear after every bus, duck and limiter.
|
|
13
|
+
|
|
14
|
+
```js
|
|
15
|
+
// tap-worklet.js, loaded with audioContext.audioWorklet.addModule()
|
|
16
|
+
class MasterTap extends AudioWorkletProcessor {
|
|
17
|
+
constructor() { super(); this.blocks = []; this.frames = 0; this.start = null; }
|
|
18
|
+
process(inputs) {
|
|
19
|
+
const input = inputs[0];
|
|
20
|
+
// With nothing playing, an input can arrive with no channels. Record that quantum as
|
|
21
|
+
// silence, so a batch stays continuous and every later event still lines up.
|
|
22
|
+
const block = input && input.length
|
|
23
|
+
? input.map((channel) => channel.slice())
|
|
24
|
+
: [new Float32Array(128), new Float32Array(128)];
|
|
25
|
+
if (this.start === null) this.start = currentTime; // the context time of this batch
|
|
26
|
+
this.blocks.push(block);
|
|
27
|
+
this.frames += block[0].length;
|
|
28
|
+
if (this.frames >= sampleRate / 4) { // post about four times a second
|
|
29
|
+
this.port.postMessage({ start: this.start, blocks: this.blocks });
|
|
30
|
+
this.blocks = []; this.frames = 0; this.start = null;
|
|
31
|
+
}
|
|
32
|
+
return true;
|
|
33
|
+
}
|
|
34
|
+
}
|
|
35
|
+
registerProcessor('master-tap', MasterTap);
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
```js
|
|
39
|
+
// in the game, behind a test flag that changes nothing else
|
|
40
|
+
await ctx.audioWorklet.addModule('tap-worklet.js');
|
|
41
|
+
const tap = new AudioWorkletNode(ctx, 'master-tap', {
|
|
42
|
+
channelCount: 2, channelCountMode: 'explicit', outputChannelCount: [2],
|
|
43
|
+
});
|
|
44
|
+
const silent = new GainNode(ctx, { gain: 0 });
|
|
45
|
+
master.connect(tap).connect(silent).connect(ctx.destination); // keeps the tap running, adds nothing
|
|
46
|
+
const batches = [];
|
|
47
|
+
tap.port.onmessage = (e) => batches.push(e.data);
|
|
48
|
+
|
|
49
|
+
const events = [];
|
|
50
|
+
// Call it with the same `when` you pass to `source.start(when)`, so the log holds the
|
|
51
|
+
// time the sound was placed on the audio clock, not the time the code ran.
|
|
52
|
+
export function logEvent(kind, when, detail = {}) {
|
|
53
|
+
events.push({ t: when, kind, ...detail });
|
|
54
|
+
}
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
Place each batch at its `start` time; the worklet writes silent quanta itself, so batches
|
|
58
|
+
follow one another without gaps. Convert the samples to plain arrays or
|
|
59
|
+
base64 before returning them from the page, then write a WAV in Node:
|
|
60
|
+
|
|
61
|
+
```js
|
|
62
|
+
import { writeFileSync } from 'node:fs';
|
|
63
|
+
// 32-bit float WAV from interleaved samples
|
|
64
|
+
export function writeWav(path, interleaved, channels, rate) {
|
|
65
|
+
const data = Buffer.from(interleaved.buffer, interleaved.byteOffset, interleaved.byteLength);
|
|
66
|
+
const h = Buffer.alloc(44);
|
|
67
|
+
h.write('RIFF', 0); h.writeUInt32LE(36 + data.length, 4); h.write('WAVE', 8);
|
|
68
|
+
h.write('fmt ', 12); h.writeUInt32LE(16, 16); h.writeUInt16LE(3, 20); // 3: IEEE float
|
|
69
|
+
h.writeUInt16LE(channels, 22); h.writeUInt32LE(rate, 24);
|
|
70
|
+
h.writeUInt32LE(rate * channels * 4, 28); h.writeUInt16LE(channels * 4, 32); h.writeUInt16LE(32, 34);
|
|
71
|
+
h.write('data', 36); h.writeUInt32LE(data.length, 40);
|
|
72
|
+
writeFileSync(path, Buffer.concat([h, data]));
|
|
73
|
+
}
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
The event log and the samples share the audio clock, so every shot, step and line can be
|
|
77
|
+
found in the recording to well under a frame. OS's tap lined up with its engine log to
|
|
78
|
+
about 0.2 s, close enough to expose a 1.7 to 3.6 s skew that had been producing wrong
|
|
79
|
+
numbers for days.
|
|
80
|
+
|
|
81
|
+
## The owner-path capture
|
|
82
|
+
|
|
83
|
+
Every repeated sound complaint LC had lived on a path nobody tested. Capture the path the
|
|
84
|
+
player takes:
|
|
85
|
+
|
|
86
|
+
- The built game, served the way it ships, with no autostart flag and no debug option
|
|
87
|
+
that changes behaviour.
|
|
88
|
+
- A real key press through the browser's input pipeline, not a call into the game.
|
|
89
|
+
- Two runs: the browser's default autoplay policy and the strict one
|
|
90
|
+
(`--autoplay-policy=user-gesture-required` in Chromium). Read the flags your test
|
|
91
|
+
launcher adds; many allow autoplay, which hides exactly this fault.
|
|
92
|
+
- The game's own count of refused `play()` calls and suspended-context recoveries, kept in
|
|
93
|
+
the shipped build too, read at the end. A wrapper the test injects into `play()` is a
|
|
94
|
+
tool changing the game.
|
|
95
|
+
- One tap per bus as well as the master, so a muted bed and a quiet bed read differently.
|
|
96
|
+
|
|
97
|
+
LC called this capture "the single best check" for sound that never starts: its rain was
|
|
98
|
+
silent under strict autoplay while every earlier capture, run with autostart, had it.
|
|
99
|
+
|
|
100
|
+
## The offline mix render
|
|
101
|
+
|
|
102
|
+
For fast level work, build the game's real audio graph (the same factory functions, the
|
|
103
|
+
same buses) inside an `OfflineAudioContext`, schedule a scripted scene (a fight, a quiet
|
|
104
|
+
walk, a reload beside a crowd) and render it in well under real time. Measure integrated,
|
|
105
|
+
short-term and momentary loudness, true peak oversampled, band levels and duck depth. Wait
|
|
106
|
+
for streamed sources to load before rendering, and take the median of three renders for
|
|
107
|
+
anything streamed. LC's version fails the build if rain at rest reads under its floor in
|
|
108
|
+
its band.
|
|
109
|
+
|
|
110
|
+
## Bands a laptop can play
|
|
111
|
+
|
|
112
|
+
Laptop and phone speakers give back little of the lowest octaves, so a cue that is all
|
|
113
|
+
low end can measure loud and be silent on the player's machine. Measure each bed and cue
|
|
114
|
+
in the band that carries it (LC: rain at rest in 200 Hz to 6 kHz at or over -33 dBFS;
|
|
115
|
+
enemy steps and voices in 100 Hz to 1 kHz against the rain). Give a low cue harmonics: a
|
|
116
|
+
parallel softly clipped path through the low mids made LC's heartbeat audible where it had
|
|
117
|
+
read -59 dBFS in 300 Hz to 4 kHz.
|
|
118
|
+
|
|
119
|
+
## A gate table of relationships
|
|
120
|
+
|
|
121
|
+
Absolute levels drift with every change; relationships are what the player hears. LC's
|
|
122
|
+
table, read from a three-minute real run after every bank change:
|
|
123
|
+
|
|
124
|
+
| Relationship | LC bar |
|
|
125
|
+
| --- | --- |
|
|
126
|
+
| The player's shot over an enemy voice at arm's length | at least 4 LU |
|
|
127
|
+
| Footsteps over rain, most steps | at least 6 dB |
|
|
128
|
+
| A surge of enemies | heard before it is seen |
|
|
129
|
+
| A fight, integrated | -16 LUFS ±1.5 |
|
|
130
|
+
| A quiet night, integrated | -28 LUFS ±3 |
|
|
131
|
+
| Output true peak | under -2 dBTP |
|
|
132
|
+
| Mouth sounds in three minutes without a fight | zero |
|
|
133
|
+
|
|
134
|
+
OS's equivalent was a hierarchy: the player's shot 4.8 LU over anything in a fight, rivals
|
|
135
|
+
at least 6 dB under, reloads never within 6 LU, the announcer 2 to 3 LU under.
|
|
136
|
+
|
|
137
|
+
## Spoken lines
|
|
138
|
+
|
|
139
|
+
Run every line through the game's final chain (radio, helmet, distance) into a local
|
|
140
|
+
speech recogniser, and compare it with the script. Recognisers lean towards dictionary
|
|
141
|
+
words, so add a phoneme comparison for names and invented words, and flag a line when the
|
|
142
|
+
two disagree with the text. OS's recogniser passed two invented place names that a
|
|
143
|
+
phoneme check caught, and could not tell /laɪv/ from /lɪv/, which the owner heard at once. LC reworded lines the recogniser misheard through the radio ("take an arm from
|
|
144
|
+
Iraq" 11 times in 12).
|
|
145
|
+
|
|
146
|
+
## Spectrograms read as images
|
|
147
|
+
|
|
148
|
+
Render the shipped file first and each candidate after it on the same scale and range.
|
|
149
|
+
Look for horizontal lines (fixed tones and whines), vertical lines (clicks), tails cut
|
|
150
|
+
square, energy before the attack (codec pre-echo) and a top band that never moves. OS
|
|
151
|
+
found that its metrics alone preferred synthetic beeps to real takes; the picture with the
|
|
152
|
+
shipped file beside it did not.
|
|
153
|
+
|
|
154
|
+
## Ledgers for cut-offs, delay and position
|
|
155
|
+
|
|
156
|
+
- **Stop ledger.** Every voice that ended before its file, with the reason: stolen, ended
|
|
157
|
+
by a rule, a queue overflow, never started. OS's showed 1,110 cut-offs in a ten-minute
|
|
158
|
+
fight that no level meter could see.
|
|
159
|
+
- **Delay probe.** The press, stamped from the input event and mapped to the audio clock
|
|
160
|
+
with `getOutputTimestamp()`, against the first sample over a threshold in the tap. OS's
|
|
161
|
+
found a 690 ms backlog; after the fix, press-to-output read 67 ms.
|
|
162
|
+
- **Position log.** Every world sound with its true distance and bearing and its level
|
|
163
|
+
against the ambience in its band. LC's found steps 32 times in 34 and a 2 degree bearing
|
|
164
|
+
error; OS's found rival reloads playing centred at full level.
|
|
165
|
+
|
|
166
|
+
## A/B tapes for the person
|
|
167
|
+
|
|
168
|
+
Name each clip `<date>-<what>-{NEW|AS-IT-WAS|NOT-TAKEN}-<what to listen for>.mp3` and
|
|
169
|
+
render each pair from one boot, so the only difference is the change. Send two or three
|
|
170
|
+
pairs with one plain question each. Record the answer against the cue.
|
|
171
|
+
|
|
172
|
+
## What none of this proves
|
|
173
|
+
|
|
174
|
+
Whether a sound is pleasant, whether it fits the world, whether a voice suits its
|
|
175
|
+
character, whether the game sounds finished. Those are a person's calls, made by
|
|
176
|
+
listening. Report the measurements as measurements, and keep the list of what nobody has
|
|
177
|
+
heard at the top.
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
> Carried from `opengame-capture` 1.1.0. Read it when: Make a browser game filmable and screenshot-testable. Covers a host-stepped clock, one time scale, seeded takes, a director camera, a clean feed, a ready state, acknowledged requests, captures that prove their own build and state, motion filmed on the game clock at quarter speed, stepped audio, WebGPU readback, batched jobs and hooks absent from public builds. Use when the person wants a trailer, footage, slow motion or screenshot tests, or takes do not repeat or captures come out black.
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
# Capture: a game you can film and test
|
|
5
|
+
|
|
6
|
+
OC's launch film is 62 s of 4K60 from 43 shots, cut from 401 kept takes. The game had no
|
|
7
|
+
capture mode, so the film team added every hook to a forked build while filming: a stepped
|
|
8
|
+
clock, a free camera, HUD masks, mute flags, a probe. Each hook was small. Finding out it
|
|
9
|
+
was needed cost a reshoot, and about 24 of the 47 hours went to restarts and usage limits on
|
|
10
|
+
top. The owner's brief: "i do NOT want to have to keep watching shitty takes and giving u
|
|
11
|
+
feedbaxk thqt u should be able to know ill give u based on those skills".
|
|
12
|
+
|
|
13
|
+
Build these into the game before anyone films it. The same hooks make screenshot tests
|
|
14
|
+
repeatable, which is most of what `opengame-verification` asks of a capture. OS, LC and OH
|
|
15
|
+
added the testing half: judges scored captures that were not what their labels said,
|
|
16
|
+
WebGPU frames came back black, real-time films drew a handful of frames a second on a
|
|
17
|
+
loaded machine, and screencasts were read as real time.
|
|
18
|
+
|
|
19
|
+
Rules carry five tags; `opengame-quality-bar` explains them and the game codes. The
|
|
20
|
+
three.js way to do each is in [references/threejs.md](references/threejs.md); pipeline
|
|
21
|
+
numbers, the capability audit and process are in [references/pipeline.md](references/pipeline.md).
|
|
22
|
+
|
|
23
|
+
## Rules
|
|
24
|
+
|
|
25
|
+
### The host steps one clock
|
|
26
|
+
- **Invariant:** In capture mode the host advances the game by a fixed simulation step per output frame, every system reads that one clock, and no game code reads wall time.
|
|
27
|
+
- **Technique:** A capture mode where the host calls step, then render, then read back, and the game's own frame loop is off. Simulation, physics, animation, particles, weather, camera smoothing and audio all take their time from the step, and worker threads read the same clock. Drive every scripted state by update count, never wall time. Slow motion is a smaller step, never frame interpolation. Gameplay never runs faster than real time; speed on screen comes from the camera.
|
|
28
|
+
- **Reference configuration:** OC's time came from `performance.now()` in a worker, and page-level tricks failed: a fake page clock froze timers and virtual time never reached the workers. A shim replaced `performance.now` and `requestAnimationFrame` in the worker and retried a frame when the GPU slot was busy; its first version took 48-64 min and the full rig about 2 h. Real-time 4K ran at 25-31 fps, so 1 s of 4K60 cost about 5.2 s of wall time. Stepped, the rig ran 28.1 fps first person and 37.2 fps on a dolly at 4K on an idle M4 Max, 2.1-3.5 s of wall time per output second. A step of 1/60 is 1x and 1/240 is 0.25x; 240 frames covered 1.000 s of simulation with 0 skipped. The montage reused the rig unchanged on a new build in about an hour. LC stepped 1/60 per drawn frame after real-time films on its loaded machine drew 8-25 fps ("nine pictures a second at best"), and recipes timed on the wall clock while the game clock was held made holds 3-4x short; the stepped burst was "the only film true under tonight's load".
|
|
29
|
+
- **Applies when:** Every game that will be filmed, screenshot-tested or compared frame by frame.
|
|
30
|
+
- **Verify:** Capture 240 frames at a 1/240 step: the probe's simulation time rises by exactly one step per frame and ends at 1 s. Repeat on a loaded machine and get the same frames.
|
|
31
|
+
|
|
32
|
+
### One time scale, and every timer obeys it
|
|
33
|
+
- **Invariant:** Every timer in the game (hitstop, shake, camera lerps, particles, physics, corpse settling, emitters, flashes, audio) runs on scaled simulation time, so an effect at quarter speed looks like the same effect slowed down.
|
|
34
|
+
- **Technique:** One time scale applied where the clock is read, never per system. Replace frame-count timers with time. Physics sub-steps or interpolates so a small step does not hold a pose and then jump. Motion blur takes its shutter from the step. A cinematic flag turns off hitstop and kill-cam time dilation. Review every effect at quarter speed before filming.
|
|
35
|
+
- **Reference configuration:** OC: a 45 ms kill hitstop became about 9 near-frozen frames at 0.3x, and a 70 ms hammer hold about 12 frames at 0.25x. Corpses solved at a fixed 60 Hz, so at 0.25x a pose held for 4 frames, then jumped. A gib trail emitted every third frame, and per-frame emitters ran 4 times denser. A game-only time scale left particles on presentation time at full speed. Motion blur reached a 360-degree shutter at 1/240 until its strength was set to 60 times the step in seconds (0.25 at 1/240). At 0.25x a light re-firing every 0.09 s strobed at 10 Hz, a blood sprite covered about 40% of the frame, and a bloom clipped to white. The frozen-flip defect was predicted in an audit, still reached the owner about 28 h later, and cost about 3 h and reshoots for a 6-line fix. OS's dev time scale never reached the game, so every "slow-motion" animation capture ran at real speed until someone checked.
|
|
36
|
+
- **Applies when:** Games with slow motion, hitstop, or any effect timed by frames.
|
|
37
|
+
- **Verify:** Render each effect at 1x and at 0.25x and lay the frames side by side: the slow version has four times the frames of the same motion, with no holds, jumps or denser particles, and the probe's simulation time confirms the scale took.
|
|
38
|
+
|
|
39
|
+
### One seed makes a take repeat
|
|
40
|
+
- **Invariant:** Two runs of the same take with the same seed, clock and scripted input produce the same frames.
|
|
41
|
+
- **Technique:** One global seed feeds every random source: weather, sky, lightning, voice picks, idle animation, spawns. Nothing seeds from wall time or the operating system in capture mode. A switch freezes ambient events. Script input against simulation frames, and record the seed in the take's spec.
|
|
42
|
+
- **Reference configuration:** OC: 0 of 240 frame signatures matched between two runs, because sky, lightning, boss idle and voice picks were seeded from wall time or OS randomness while camera and scripted input were exact. Workarounds: a voice seed set at least 2 s before the start under load, a forced lightning strike 3.3 s before a take to push the next one at least 14 s away, and 25 dev strikes to land the take's own strike on the boss's helm. Reshoots on a new build still kept identical kill frames (28 of 131), so the clock and scripted input were enough for reshoots.
|
|
43
|
+
- **Applies when:** Every game with randomness that will be filmed or screenshot-tested.
|
|
44
|
+
- **Verify:** Shoot the same take twice and hash every frame: all hashes match.
|
|
45
|
+
|
|
46
|
+
### The director's camera wins, and a cut resets history
|
|
47
|
+
- **Invariant:** A director camera overrides gameplay and cutscene cameras whenever it is set, and a cut gives a clean first frame with no trace of the previous shot.
|
|
48
|
+
- **Technique:** A camera override layer with position, look target, field of view, roll and near plane, and a cut call that resets temporal anti-aliasing history, motion blur and auto exposure. Call the same reset when a visible mesh swaps. Cutscenes accept an external camera and keep the simulation running. Under a free camera, draw the third-person body and world weapon while aim stays with the player.
|
|
49
|
+
- **Reference configuration:** OC's engine had a camera cut that nothing in the game called, so a hard jump smeared the whole frame through TAA. Crate weapons cycling every 0.06-0.32 s ghosted until each gun was held for at least 4 frames with a cut on each swap. The victory cinematic took the camera, deleted the zombies and hid the body, and the hook that let the film own the ending took about 5.5 h. With the cut, a first-to-third-person hand-off on the fastest swing frame became the "best cut in the film". Over-the-shoulder shots of the player were impossible because the 0.7 m head filled the frame.
|
|
50
|
+
- **Applies when:** Games with temporal effects (TAA, motion blur, auto exposure) or scripted cameras.
|
|
51
|
+
- **Verify:** Cut between two distant cameras and inspect the first frame after: no ghost of the previous shot. Swap a held item and step through it frame by frame.
|
|
52
|
+
|
|
53
|
+
### A clean feed, element by element
|
|
54
|
+
- **Invariant:** Each HUD element and each world-space gameplay marker can be hidden on its own, music and voice can each be muted, and a clean take keeps whatever feedback the shot asks for.
|
|
55
|
+
- **Technique:** A named flag for every interface element and world marker (hit markers, score pops, crosshair, plates, subtitles, set-piece UI, telegraphs, weak-point marks, rings) and a mask that picks which to draw. Tag world markers separately from art. One clean-feed switch sets the usual mask and mutes music and voice; prove the mute by loudness. Interface projected from the player's camera lines up only in first person, so hide it on other cameras. Dev overlays, page badges and cheat effects never reach the frame. Give scoring tools the same mask, so a screen-fixed reticle or HUD is never counted as change in the scene.
|
|
56
|
+
- **Reference configuration:** OC's owner asked to hide "the H UD except hitmarkers and like the points juice". A HUD mask (score pops, hit marker, crosshair, points plate) plus flags for subtitles and set-piece UI took about 3 min to build. The old hide flag also hid boss marks and the letterbox, subtitles ignored it, and the mask drew over it, so cinematics had to clear both. Cyan rings, a weak-point capsule, floor telegraphs, glyphs and strike circles read as HUD on film. On the montage, dev-funded score jumps from 1,039 to 49,550 showed on screen. On OS the screen-fixed reticle made 75-91% of the spikes a flicker scorer counted in scoped shots until it was masked.
|
|
57
|
+
- **Applies when:** Every game with a HUD that will be filmed or used for marketing stills.
|
|
58
|
+
- **Verify:** A contact sheet of one frame with each flag on and off. On the clean feed, a reviewer marks every visible interface element; only the masked-in ones remain.
|
|
59
|
+
|
|
60
|
+
### Ready means resident
|
|
61
|
+
- **Invariant:** The game exposes one state the capture script can await that means every model, texture, pipeline and sound the scene needs is resident and the quality setting is locked, and a load failure reports itself instead of crashing.
|
|
62
|
+
- **Technique:** Count pending loads, compiles and decodes; resolve a promise or post a message when they reach zero after the scene is built and quality is fixed. Give each asset class a named failure and a timeout. In the unrecorded preroll, grant and show every item the take uses once, so late loads happen off camera. Lock quality: no dynamic resolution or automatic tier in capture mode. A capture that waits for ready never sees the seconds before it, so test the first seconds of play with a separate capture that starts at the press.
|
|
63
|
+
- **Reference configuration:** OC had no such state. Under load, 55 boot crashes paired with a renderer assert on a missing material; about 40 takes hit it and 5 of 7 attempts at one shot were lost. Boot waits grew from 180 to 420 s, and takes were capped at 2-3 min with 2-5 retries. Late guns drew black for about 10 s ("give every gun once before shooting"), and sound banks stayed silent for 11-20 s. The renderer started on Low and calibrated, so dynamic resolution popped lights until quality was fixed after the title; the rig waited for the log line "renderer quality: fixed at ultra". LC's captures waited for late assets and so never saw the white placeholder hand a player saw before the real hands arrived.
|
|
64
|
+
- **Applies when:** Every game that streams assets or calibrates quality.
|
|
65
|
+
- **Verify:** Await the state on a throttled connection and capture the next frame: every model is present and lit at final quality, and the first shot is audible. Block one asset: the state reports which one failed.
|
|
66
|
+
|
|
67
|
+
### Capture requests are addressed to frames and acknowledged one by one
|
|
68
|
+
- **Invariant:** Every screenshot request and director command names the simulation frame it applies to, and the game acknowledges each one with the frame it ran on, so the capture script never guesses when something happened.
|
|
69
|
+
- **Technique:** A request queue with an id and a target frame per request. The game runs it at that frame and replies with the id, the frame, the build id, the screen it was on and whether assets were loaded. The capture script sends the next request after the reply and treats a missing reply as a failure. Screenshots wait for the interface to settle. Document the limits: command size, deadlines, and what happens to a command sent before the scene exists.
|
|
70
|
+
- **Reference configuration:** OC: real-time stage commands 0.2 s apart landed in the same frame and were lost under load, so staging moved to an unrecorded preroll. A shutter command sent only on change swallowed the frame-0 command. Commands sent before the scene existed were dropped, a scripted run aborted 10 s after its last command, and a command buffer over about 7.9 KB crashed the engine on load. Frame-addressed injection landed 59 of 59 on the right frame. OS's capture steps each waited for a log line the game printed, and every step that shoots shoots exactly once, after one boot took 184 s. Checking that each capture shows the screen it claims is in `opengame-verification`.
|
|
71
|
+
- **Applies when:** Every game driven by a capture or test script.
|
|
72
|
+
- **Verify:** Send 100 screenshot requests in a burst: 100 replies arrive, each with its own frame and the expected screen. Kill the game mid-burst: the capture script fails the run.
|
|
73
|
+
|
|
74
|
+
### A capture proves its own build, state, camera and coverage
|
|
75
|
+
- **Invariant:** A frame reaches a judge, a metric or the owner only if its pixels and a log line from the same second agree with its label (the named build from committed code, the real interface path, the player alive in a first life, the requested camera outside geometry, quality and weather pinned), it was taken from a frozen snapshot nobody else can change while the run lasts, and the set covers every cell the rubric scores.
|
|
76
|
+
- **Technique:** Capture from a snapshot of the committed head plus your own files, served on a private port, so another agent's save cannot reload the page. Pin quality, weather and time of day, and write the renderer string, build hash and state line beside each image. Dump the camera before and after each still, ray-probe every judge camera against collision, and spawn with god mode off. Wait on game state, never on timers. Write each run to an immutable folder keyed by build hash. Quarantine black, low-variance and duplicate frames. Generate the capture plan from the rubric, so every scored cell has a frame. Label each clip for what it is: stepped or real time, its clock rate, brightened or not.
|
|
77
|
+
- **Reference configuration:** OS's first round had 6 of 10 maps at 1 HP, put the victory screen in all three scope slots, and sent judges four "gameplay" stills aimed at the sky; on a first pass 13 of one map's 39 checklist cameras sat inside walls, roofs or cliff tops. "Several smoke folders were rewritten while I was reading them." Capture "success" (files written, 0 errors, 4 of 4 shots) proved nothing four separate times. OH captured at 1600 x 900 from frozen snapshots of the committed head on private ports, quality pinned, a state line and renderer string beside each image, and still had a missing clip, a mid-animation title and a stale capture scored as game faults; its rule became a manifest of build hash and renderer, with no file older than the build. Checking a capture against its label before judging is in `opengame-verification`.
|
|
78
|
+
- **Applies when:** Any automated capture that feeds a judge, a gate, a metric or the owner.
|
|
79
|
+
- **Verify:** Kill the player partway through a run and move one camera into rock: the run exits non-zero and quarantines both. The manifest lists the build hash and renderer, and no file in the set is older than the build.
|
|
80
|
+
|
|
81
|
+
### A state probe in render space, checked on day one
|
|
82
|
+
- **Invariant:** On request or every frame, the game reports where the camera, the player, each enemy's head and joints, bosses and objective states are, taken from the same snapshot that was rendered and in render space, and the report matches the picture.
|
|
83
|
+
- **Technique:** A probe flag that emits one record per frame from post-skinning transforms in the rendered snapshot. Name items and tables in the record; never make anyone map indices by hand. On the first day, project probe points into a rendered frame and check each lands on the drawn head, joint or item. Export the per-frame camera and joints if CG will be composited.
|
|
84
|
+
- **Reference configuration:** OC built `probe=1`, one JSON line of 2-4 KB per frame, because log lines were the only channel from game to host. It was wrong in ways that cost shots: the head bone sat 0.17-0.2 m below the visible head; titan joints were 10-13 m off the rendered model and never fixed; a documented overlook camera was inside a wall; a gun table was off by one, so one gun's slot gave another and 6 shots hit with the wrong gun. The per-frame camera and joint export matched Blender to 0.0003 px. No depth or object-ID matte existed, so a 3D logo could avoid characters but not pass behind them.
|
|
85
|
+
- **Applies when:** Games where a capture script aims, frames or checks shots from game state.
|
|
86
|
+
- **Verify:** Draw probe points over 20 captured frames: each lands on its drawn feature within a few pixels.
|
|
87
|
+
|
|
88
|
+
### Motion is filmed on the game clock and read at quarter speed, from the angle that shows it
|
|
89
|
+
- **Invariant:** Holds, reloads, gaits, deaths, effects, flicker and transitions are accepted only from a recording of every drawn frame on the game clock, played back slowed and stepped frame by frame, from the player's camera and from an angle that shows the motion, and also watched at full speed as a whole act by a person, since no agent can; an interface cut over the scene is judged from a recording that holds both.
|
|
90
|
+
- **Technique:** Record every drawn frame for a few seconds on the stepped clock and play it at quarter speed (drawn frames shown at a quarter of their rate), with a sheet of consecutive frames beside it. Film enemies from a side lens at chest height a few metres off as well as from the player's view. For flicker and camera feel, script a fixed still, turn, strafe, walk and aim sequence so before and after show the same poses. When the DOM and the canvas must be judged together, run a headed browser on its own virtual display and grab it at the display rate, with a small corner mark that changes every frame as the frame clock. Stamp any dark frame you brightened with its gain, and never pass anything on a brightened frame.
|
|
91
|
+
- **Reference configuration:** LC filmed every drawn frame and played it at 15 fps (quarter speed at 60) beside a 16-frame sheet, and filmed enemies through a side lens 3 m off at chest height with a 68-degree field of view, which exposed library "falls" as stunt breakfalls that the deformation audit had passed. LC's headed grab ran 34 fps at a machine load of 13 and 4-13 fps at 35-54, and showed the DOM changing 67-167 ms before the WebGPU picture. OS's game-clock flicker path held within about 5% run to run, against 10-30% for free-running captures. OH's judges found its board vanishing for single frames by stepping a clip, and an in-page probe counted 4 of 880.
|
|
92
|
+
- **Applies when:** Anything that moves, in any game whose motion an agent, a judge or the owner will review.
|
|
93
|
+
- **Verify:** The film's frame count equals game seconds times the step rate, the corner mark changes once per frame, and each motion has a sheet with named faults or "none", read at full size.
|
|
94
|
+
|
|
95
|
+
### Audio is captured at simulation rate, per bus
|
|
96
|
+
- **Invariant:** A take's sound comes from the simulation at the take's own rate, music, voice, effects and ambience are available as separate stems, and each bus can be muted from the launch URL.
|
|
97
|
+
- **Technique:** Mute and stem flags readable at launch. In capture mode, drain the mixer per output frame by exactly the samples one step covers, trim the output latency, and save a cue log with each cue's simulation time. Slow motion yields audio the length of simulated time, so the edit retimes or replaces it. Load every sound bank a take uses before recording. Where a capture cannot carry sound, prove timing from logs on the game's clock and leave the listening to a person.
|
|
98
|
+
- **Reference configuration:** OC: music and voice were baked into every take until music and voice mute flags existed, found when 12 of 22 voice lines overlapped. The rig drained `sampleRate * step` samples per frame and trimmed 4,095 samples (85 ms) of latency; 13 of 145 cues needed re-alignment in slow-motion takes. On the montage, settings-menu mute clicks never landed and all 9 segments were reshot (`opengame-audio` has the numbers). The film mastered at -13.8 LUFS and -1.6 dBTP against a -14 LUFS target. Every clip OH's judges saw had no audio, so OH proved timing from logs on the song clock (drawn against heard under 4 ms). LC recorded the page's audio by routing everything sent to the output into a recorder while the browser stayed muted; OS recorded the exact WebAudio output aligned to the engine log to about 0.2 s, which exposed a 1.7-3.6 s skew behind wrong numbers.
|
|
99
|
+
- **Applies when:** Every game with sound that will be filmed.
|
|
100
|
+
- **Verify:** Capture the same shot at 1x and at 0.25x. At 1x each shot's sound lines up with its muzzle flash to within a frame. With music muted, the music stem measures silent.
|
|
101
|
+
|
|
102
|
+
### Every frame comes from the render surface
|
|
103
|
+
- **Invariant:** Delivered footage and test captures hold every frame at the intended resolution and rate, read from the render surface with correct colour tags, however loaded the machine is, and a capture whose first picture is near black fails.
|
|
104
|
+
- **Technique:** After each stepped frame, read back the render surface, convert colour on the GPU to the encoder's format and tag it, and encode with a hardware encoder through WebCodecs. Page screenshots and screencasts are for stills and debugging, never for motion, and a screencast's timing and frame count are not the game's. Read a WebGPU canvas inside the task that drew it, from a declared after-frame hook that changes nothing else (see the hooks rule below), with `canvas.toBlob` or a copy of the presented texture; depending on the browser's mode, copying the canvas into another canvas, `captureStream`, a screencast or a page screenshot can return black, so prove the path on one frame first and check that the first frame's mean clears a near-black floor. Render at native resolution with a device pixel ratio of 1, lock the quality preset, and stop the run if the browser fell back to a software rasteriser. Check output by counting unique frames and measuring colour, never by frame count alone.
|
|
105
|
+
- **Reference configuration:** OC: `page.screenshot` at 4K took 2,516 ms; a CDP screencast gave 12-19 fps, lossy; CPU x264 encoded 1.7-4.2 fps at 1080p. A swapchain copy with `copyTextureToBuffer` and `mapAsync` took 30.4 ms at 4K. WebCodecs tagged frames BT.601, so a GPU pass to NV12 BT.709 fixed it (Y 68.7 dB against ffmpeg, against 41.3 dB for BT.601). HEVC at 300 Mbps banded least on the storm sky (H.264 at 160 Mbps flattened 51% of blocks, HEVC 14.5%); the 4K master is 2.25 GB per output minute. Supersampling at dpr 1.5 cost 3.4x (11.0 against 37.2 fps) for no visible gain. Dropped frames were 0 regardless of load, because frames were stepped, not timed. Frame-count QA passed a 3,720-frame cut whose frames 1-402 were frozen. On LC, headless, copying a WebGPU canvas into another canvas, `captureStream()`, the CDP screencast and `page.screenshot` all gave black frames (79 of 79), and LC fails a capture whose first frame's mean is under 1-2 of 255. OH's 25 fps screencasts sat 1-4.6 s off the page, and judges who timed effects by counting their frames were wrong.
|
|
106
|
+
- **Applies when:** Every game filmed for a trailer, montage or store page.
|
|
107
|
+
- **Verify:** `ffprobe` reports the expected size, rate and BT.709 tags; the count of unique frames equals the count of frames; one frame matches a direct readback of the same step.
|
|
108
|
+
|
|
109
|
+
### Batch the shots for one look into one job, and prove the tool on one frame first
|
|
110
|
+
- **Invariant:** Every shot needed for one look is taken in one job on your machine's job queue, with no more browsers than the GPU holds, the job is watched until its result is read, and a new or changed capture tool has been proved on one frame before a batch spends a slot.
|
|
111
|
+
- **Technique:** Write the batch as a spec (scenes, cameras, states, frames) and run it in one slot from one build. Run a dry pass that boots no browser and checks names and paths, then one shot, then the batch. Wait for the job inside your own turn with a bounded wait on its end mark; a job left running after its launcher's turn ends reaches nobody. Keep file names short and encoder tile widths even.
|
|
112
|
+
- **Reference configuration:** LC kept at most three browsers in one slot after five lost the WebGPU device; an odd tile width gave 0-frame clips, and under load a kept picture cost about 1 s. Learning the black-frame rule cost one LC stream five slot jobs and every stream about one. OH kept every shot for a judge packet inside one slot grant of under 8 minutes, never nested. OS grouped steps into slot jobs of under 20 minutes and spaced screenshots at least 1.2 s apart. How to share the slots between agents is in `opengame-production`.
|
|
113
|
+
- **Applies when:** Every capture run on a machine whose browsers, GPU or job slots are shared.
|
|
114
|
+
- **Verify:** The job log shows one slot per look, the dry pass and the single-shot proof before the batch, and no capture job still running after its launcher's turn ended.
|
|
115
|
+
|
|
116
|
+
### Capture hooks are off by default and absent from public builds
|
|
117
|
+
- **Invariant:** Capture hooks live in the shipping game's code, each off by default behind its own flag, change nothing while off, change nothing but what they declare while on, and are absent or locked in the public build.
|
|
118
|
+
- **Technique:** One flag per hook, listed in one file with what it does. No game code reads whether a hook is attached except through that declaration. A parity frame proves flags-off equals the release. Strip hooks at build time for the public build, or gate them behind a key whose secret is not in the bundle. Record the build hash and every flag a take used in the take's spec. Write each film fix as a flag the game can adopt.
|
|
119
|
+
- **Reference configuration:** OC added about 25-30 default-off hooks in a day, each diffable as a hooks list and a patch, versioned film builds by wasm hash with receipts, and proved parity with the release round on a frame. The fork had costs: the final film mixes selects from at least 5 builds and no single build reproduces it, and one take depended on environment variables nobody recorded. Production disabled dev URL switches with a dev key stored only as a SHA-256 hash. Film fixes flowed back: the film's lightning became the game default (flat-white share 10.47% to 0.58%). LC's engine skipped its frame-pacing rule whenever an after-frame hook was set, so every capture sat a different game from the owner's; `opengame-verification` has the rule.
|
|
120
|
+
- **Applies when:** Every game with capture or test hooks and a public build.
|
|
121
|
+
- **Verify:** Grep the public bundle for every hook name; open the public URL with each flag set and see no change; diff a flags-off frame from the capture build against the release.
|
|
122
|
+
|
|
123
|
+
## Other engines
|
|
124
|
+
|
|
125
|
+
Unity sets a fixed capture step with `Time.captureDeltaTime`, and its Recorder package
|
|
126
|
+
writes stepped frames. Godot 4 renders offline with `--write-movie <file>` and
|
|
127
|
+
`--fixed-fps <n>` on the command line. Both still need the time scale, seed, camera and
|
|
128
|
+
clean-feed rules above; the engine steps the clock, and every timer in the game has to read it.
|
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
# Capture pipeline, audit and process
|
|
2
|
+
|
|
3
|
+
Numbers from OC's launch film (a 62 s 4K60 trailer) and its gameplay montage, filmed on an
|
|
4
|
+
M4 Max with 16 cores, and from the test captures of OS, LC and OH, taken on shared Linux
|
|
5
|
+
machines with one GPU.
|
|
6
|
+
|
|
7
|
+
## Audit before planning shots
|
|
8
|
+
|
|
9
|
+
Before writing a shot list, check each item against the build you will film, and write down
|
|
10
|
+
what is missing. OC's film team found most of these one at a time, mid-production.
|
|
11
|
+
|
|
12
|
+
- A frozen build to film, and how long a private rebuild takes.
|
|
13
|
+
- A command channel from the capture script into the game, and its size and deadline limits.
|
|
14
|
+
- A host-stepped clock, one time scale, and an audit of timers that read raw frame time or
|
|
15
|
+
count frames.
|
|
16
|
+
- A director camera with a cut.
|
|
17
|
+
- A HUD mask per element, world-marker flags and a clean-feed switch.
|
|
18
|
+
- Scripting for every actor in the shot, friendlies included: spawn, pose, equip by name,
|
|
19
|
+
emote, sit, fire. OC's friendlies could not be scripted at first, and a teleport despawned
|
|
20
|
+
the squad.
|
|
21
|
+
- A state probe, checked against a rendered frame.
|
|
22
|
+
- A quality lock, with flash settings at full strength (OC's Reduce Flashing has to stay
|
|
23
|
+
off for film, or every flash is cut to 20%).
|
|
24
|
+
- Readback, colour tags and the encoder.
|
|
25
|
+
- Audio mute flags and stems.
|
|
26
|
+
- Seeds and a freeze for ambient events.
|
|
27
|
+
- The boot crash rate under load.
|
|
28
|
+
- An animation audit on frames for every clip a shot needs: a contact sheet of 8 spaced and
|
|
29
|
+
6 consecutive frames, root and head second-difference, foot slide.
|
|
30
|
+
- Hero poses and states that exist in play, not only in cutscenes, and world-state switches
|
|
31
|
+
such as time of day and weather. OC's dawn existed only on the results screen.
|
|
32
|
+
- Boot gates: press to start, install prompts, audio unlock, focus and pointer-lock pause,
|
|
33
|
+
service workers, COOP and COEP headers (without them OC fell back to one thread with no
|
|
34
|
+
warning).
|
|
35
|
+
- What the game team already built for capture.
|
|
36
|
+
|
|
37
|
+
## Throughput and output
|
|
38
|
+
|
|
39
|
+
- Draft at 720p (25-54 fps on a quiet machine), proof risky shots at 1080p, and render 4K
|
|
40
|
+
last, only for the take expected to be selected. Never judge in a draft what must be
|
|
41
|
+
judged at 4K: OC's drafts hid "capsule mannequin" wolves and cheap bloom.
|
|
42
|
+
- Keep takes to 2-3 min, plan about 10 takes per kept shot, and keep shot specs as code so a
|
|
43
|
+
reshoot takes about 60 s to set up. OC shot 572 take lines, 23 failed, 401 were kept.
|
|
44
|
+
- Master: HEVC Main 8-bit at about 300 Mbps, BT.709, 2.25 GB per output minute. Proxy:
|
|
45
|
+
1080p x264 CRF 23. Delivery: HEVC Main10 at about 90 Mbps (700 MB for 62 s). Hardware
|
|
46
|
+
`hevc_videotoolbox` took about 40 s against more than an hour for x265 under load.
|
|
47
|
+
- Music grid: at 105.000 BPM a beat is 34.286 frames at 60 fps. Place cuts from the beat
|
|
48
|
+
times; stepping a whole number of frames per beat drifts. OC landed 31 of 35 cuts within
|
|
49
|
+
2 frames of the grid.
|
|
50
|
+
- Check every render by counting unique frames and measuring colour. OC's frame-count check
|
|
51
|
+
passed a cut whose first 402 frames were frozen, because two directors shared one
|
|
52
|
+
minute-stamped work folder.
|
|
53
|
+
|
|
54
|
+
## Test captures and judge packets
|
|
55
|
+
|
|
56
|
+
- Capture from a snapshot of the committed head plus your own files, never the shared
|
|
57
|
+
working tree. LC's slot tool read the tree when the slot was granted, not when the job
|
|
58
|
+
was queued, so an edit made during the wait killed jobs or filmed someone else's
|
|
59
|
+
half-written file.
|
|
60
|
+
- Write a manifest per packet: build hash, renderer string, quality, weather, camera per
|
|
61
|
+
frame, the state line, and whether each clip is stepped or real time. OH's judges scored
|
|
62
|
+
a missing clip, a mid-animation title and a stale capture as game faults, and OH's
|
|
63
|
+
rule became a manifest with no file older than the build.
|
|
64
|
+
- Generate the capture list from the rubric. OS's council scored more than 20 "gaps" that
|
|
65
|
+
were built items no camera showed.
|
|
66
|
+
- Space stills when the game settles UI after input: OS waited at least 1.2 s between
|
|
67
|
+
screenshots and A/B'd inside one boot, because "Numbers across boots move about 20 %".
|
|
68
|
+
- Software rasterisers prove function only. Refuse one for anything judged on looks or
|
|
69
|
+
timing, and print the adapter on every run (LC and OH both did).
|
|
70
|
+
|
|
71
|
+
## Filming the interface with the scene
|
|
72
|
+
|
|
73
|
+
Stepped capture films the canvas. When a cut, a menu or a HUD change must be judged
|
|
74
|
+
against the scene at speed, LC ran a headed browser on the job's own virtual display and
|
|
75
|
+
grabbed it with `ffmpeg -f x11grab -framerate 60`, with a 6-pixel white corner mark that
|
|
76
|
+
changed every frame as the frame clock. It ran 34 fps at a load of 13 and 4-13 fps at
|
|
77
|
+
35-54, so read it for order and offsets, never for frame time. It showed the DOM changing
|
|
78
|
+
67-167 ms before the WebGPU picture.
|
|
79
|
+
|
|
80
|
+
## Contention
|
|
81
|
+
|
|
82
|
+
Capture is the heaviest job on the machine, and it slows down when anything else runs.
|
|
83
|
+
|
|
84
|
+
- OC's 4K capture ran at a median 9.7 fps (minimum 0.47) under contention against 28-37 fps
|
|
85
|
+
alone. With 10 capture agents the load reached 74 on 16 cores and takes crawled at 0.7-1.1
|
|
86
|
+
fps.
|
|
87
|
+
- A second GPU browser roughly halves throughput. A background-priority LaunchAgent cut
|
|
88
|
+
capture from about 120 to 2-5 fps within 30 s; `taskpolicy -B` took one run from 5.6 to
|
|
89
|
+
105 fps.
|
|
90
|
+
- Film jobs also corrupted the game team's performance numbers: one "regression" was other
|
|
91
|
+
browsers using CPU, and was retracted.
|
|
92
|
+
- Agree a written compute share before production. OC settled on 45% film, 45% game and
|
|
93
|
+
10% other work only after more than 40 h of contention.
|
|
94
|
+
- Private build trees as full disk clones cost about 26 GB for 3 flags. Keep a disk floor
|
|
95
|
+
(OC's was 4 GB).
|
|
96
|
+
- Job slots do not govern the GPU. OH held two of six slots while another project's
|
|
97
|
+
headless browsers kept the card 14-100% busy, so every OH frame-time number is
|
|
98
|
+
contaminated. Record GPU load beside every frame number.
|
|
99
|
+
- On LC, at most three browsers fit in one slot (five lost the WebGPU device), and real-time
|
|
100
|
+
films on the loaded machine drew 8-25 fps, which is why motion is filmed stepped.
|
|
101
|
+
|
|
102
|
+
## Process with the game team
|
|
103
|
+
|
|
104
|
+
- Film an immutable served build on its own URL, versioned by hash, with the previous
|
|
105
|
+
builds kept. The film will lag the live game.
|
|
106
|
+
- Notes to the game team go in one append-only file: the owner's words, the evidence frame,
|
|
107
|
+
the file and line at the frozen build, what fixed looks like, and the shot it serves.
|
|
108
|
+
Notes that named a cause and a number were the ones that got fixed. OC shipped 10 of 11
|
|
109
|
+
film notes in about 36 h once one integrator gave each note its own stream.
|
|
110
|
+
- Write film fixes as single flags with before and after crops, so the game can adopt them.
|
|
111
|
+
- Persist every override a take depends on in its spec. Keep rejected takes, so a revert is
|
|
112
|
+
a change of select.
|
|
113
|
+
- Stand up a footage log, a review page and a latest-preview link in the first hour, and
|
|
114
|
+
load the link yourself before sending it.
|