@opengamehq/skills 1.3.0 → 1.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +44 -0
- package/README.md +12 -4
- package/dist/.claude-plugin/marketplace.json +26 -0
- package/dist/skills/manifest.json +1409 -145
- package/dist/skills/opengame-accessibility/CHANGELOG.md +4 -0
- package/dist/skills/opengame-accessibility/SKILL.md +48 -32
- package/dist/skills/opengame-all-in-one/CHANGELOG.md +21 -0
- package/dist/skills/opengame-all-in-one/SKILL.md +195 -0
- package/dist/skills/opengame-all-in-one/references/opengame-accessibility/README.md +102 -0
- package/dist/skills/opengame-all-in-one/references/opengame-api/README.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-assets/README.md +168 -0
- package/dist/skills/opengame-all-in-one/references/opengame-assets/references/pipeline.md +164 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/README.md +238 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/helpers/audio-chain.js +325 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/references/mix-notes.md +125 -0
- package/dist/skills/opengame-all-in-one/references/opengame-audio/references/qa-without-ears.md +177 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/README.md +128 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/references/pipeline.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-capture/references/threejs.md +161 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/README.md +180 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/first-person-body.md +108 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/integration.md +144 -0
- package/dist/skills/opengame-all-in-one/references/opengame-characters/references/player-og.md +160 -0
- package/dist/skills/opengame-all-in-one/references/opengame-cli/README.md +189 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/README.md +223 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/json-events.md +63 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/manifest.md +89 -0
- package/dist/skills/opengame-all-in-one/references/opengame-deploy/references/packaging.md +119 -0
- package/dist/skills/opengame-all-in-one/references/opengame-depth/README.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/README.md +155 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/pacing-and-bots.md +108 -0
- package/dist/skills/opengame-all-in-one/references/opengame-enemies/references/threejs.md +193 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/README.md +185 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/launch.md +50 -0
- package/dist/skills/opengame-all-in-one/references/opengame-front-end/references/menus.md +81 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/README.md +181 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/helpers/spring.js +146 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/feel-numbers.md +142 -0
- package/dist/skills/opengame-all-in-one/references/opengame-game-feel/references/killcam.md +88 -0
- package/dist/skills/opengame-all-in-one/references/opengame-jam/README.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-lighting/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-lighting/helpers/light-pool.js +185 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/README.md +135 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/helpers/loading-count.mjs +115 -0
- package/dist/skills/opengame-all-in-one/references/opengame-loading/references/threejs.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/README.md +181 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/matching-a-reference.md +73 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/painterly.md +69 -0
- package/dist/skills/opengame-all-in-one/references/opengame-look/references/post-and-lens.md +73 -0
- package/dist/skills/opengame-all-in-one/references/opengame-maps/README.md +74 -0
- package/dist/skills/opengame-all-in-one/references/opengame-maps/references/map-spec.md +77 -0
- package/dist/skills/opengame-all-in-one/references/opengame-mobile/README.md +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/README.md +183 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-make/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/README.md +193 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-plan/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/README.md +174 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/briefs.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/reference-study.md +293 -0
- package/dist/skills/opengame-all-in-one/references/opengame-montage-review-and-improve/references/song.md +64 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/README.md +139 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/bot-lobbies.md +71 -0
- package/dist/skills/opengame-all-in-one/references/opengame-multiplayer/references/netcode.md +165 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/README.md +177 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/helpers/landing-pacer.mjs +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/references/measuring.md +123 -0
- package/dist/skills/opengame-all-in-one/references/opengame-performance/references/webgpu.md +86 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/README.md +192 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/references/team.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-production/references/templates.md +153 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/README.md +170 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/cheap-tells.md +43 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/judges.md +95 -0
- package/dist/skills/opengame-all-in-one/references/opengame-quality-bar/references/review-prompt.md +32 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/README.md +134 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/charting.md +109 -0
- package/dist/skills/opengame-all-in-one/references/opengame-rhythm/references/timing.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-router/README.md +54 -0
- package/dist/skills/opengame-all-in-one/references/opengame-router/references/process.md +38 -0
- package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/README.md +136 -0
- package/dist/skills/opengame-all-in-one/references/opengame-scene-audit/helpers/scene-audit.js +677 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/README.md +283 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/engines.md +93 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/frame.md +107 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/identity.md +111 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/leaderboards.md +115 -0
- package/dist/skills/opengame-all-in-one/references/opengame-sdk/references/radio.md +71 -0
- package/dist/skills/opengame-all-in-one/references/opengame-stability/README.md +112 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/README.md +160 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-make/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/README.md +172 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/reference-set.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-plan/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/briefs.md +273 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/core.md +129 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/craft.md +299 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/gates.md +184 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/music.md +148 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/ops.md +154 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/review.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-trailer-review-and-improve/references/title.md +92 -0
- package/dist/skills/opengame-all-in-one/references/opengame-verification/README.md +197 -0
- package/dist/skills/opengame-all-in-one/references/opengame-verification/helpers/browser-evidence.mjs +74 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/README.md +179 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/handling-numbers.md +114 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/reloads-and-hands.md +96 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/sights-and-scopes.md +98 -0
- package/dist/skills/opengame-all-in-one/references/opengame-weapons/references/threejs.md +240 -0
- package/dist/skills/opengame-all-in-one/references/opengame-world-physics/README.md +141 -0
- package/dist/skills/opengame-all-in-one/references/opengame-world-physics/references/measured-failures.md +79 -0
- package/dist/skills/opengame-api/CHANGELOG.md +12 -0
- package/dist/skills/opengame-api/SKILL.md +39 -13
- package/dist/skills/opengame-assets/CHANGELOG.md +11 -0
- package/dist/skills/opengame-assets/SKILL.md +79 -31
- package/dist/skills/opengame-assets/references/pipeline.md +67 -0
- package/dist/skills/opengame-audio/CHANGELOG.md +11 -0
- package/dist/skills/opengame-audio/SKILL.md +129 -41
- package/dist/skills/opengame-audio/references/mix-notes.md +44 -1
- package/dist/skills/opengame-audio/references/qa-without-ears.md +177 -0
- package/dist/skills/opengame-capture/CHANGELOG.md +10 -0
- package/dist/skills/opengame-capture/SKILL.md +44 -20
- package/dist/skills/opengame-capture/references/pipeline.md +33 -1
- package/dist/skills/opengame-capture/references/threejs.md +17 -1
- package/dist/skills/opengame-characters/CHANGELOG.md +15 -0
- package/dist/skills/opengame-characters/SKILL.md +94 -39
- package/dist/skills/opengame-characters/references/first-person-body.md +108 -0
- package/dist/skills/opengame-characters/references/player-og.md +1 -1
- package/dist/skills/opengame-cli/CHANGELOG.md +20 -0
- package/dist/skills/opengame-cli/SKILL.md +12 -11
- package/dist/skills/opengame-deploy/CHANGELOG.md +30 -0
- package/dist/skills/opengame-deploy/SKILL.md +43 -23
- package/dist/skills/opengame-deploy/references/json-events.md +6 -5
- package/dist/skills/opengame-deploy/references/manifest.md +9 -3
- package/dist/skills/opengame-deploy/references/packaging.md +32 -30
- package/dist/skills/opengame-depth/CHANGELOG.md +8 -0
- package/dist/skills/opengame-depth/SKILL.md +61 -33
- package/dist/skills/opengame-enemies/CHANGELOG.md +10 -0
- package/dist/skills/opengame-enemies/SKILL.md +96 -40
- package/dist/skills/opengame-enemies/references/pacing-and-bots.md +108 -0
- package/dist/skills/opengame-enemies/references/threejs.md +59 -0
- package/dist/skills/opengame-front-end/CHANGELOG.md +4 -0
- package/dist/skills/opengame-front-end/SKILL.md +85 -39
- package/dist/skills/opengame-front-end/references/menus.md +42 -8
- package/dist/skills/opengame-game-feel/CHANGELOG.md +11 -0
- package/dist/skills/opengame-game-feel/SKILL.md +95 -47
- package/dist/skills/opengame-game-feel/references/feel-numbers.md +59 -0
- package/dist/skills/opengame-game-feel/references/killcam.md +88 -0
- package/dist/skills/opengame-jam/CHANGELOG.md +12 -0
- package/dist/skills/opengame-jam/SKILL.md +48 -33
- package/dist/skills/opengame-lighting/CHANGELOG.md +9 -0
- package/dist/skills/opengame-lighting/SKILL.md +85 -34
- package/dist/skills/opengame-loading/CHANGELOG.md +4 -0
- package/dist/skills/opengame-loading/SKILL.md +78 -38
- package/dist/skills/opengame-loading/helpers/loading-count.mjs +115 -0
- package/dist/skills/opengame-loading/references/threejs.md +32 -7
- package/dist/skills/opengame-look/CHANGELOG.md +9 -0
- package/dist/skills/opengame-look/SKILL.md +122 -51
- package/dist/skills/opengame-look/references/matching-a-reference.md +73 -0
- package/dist/skills/opengame-look/references/painterly.md +69 -0
- package/dist/skills/opengame-look/references/post-and-lens.md +10 -3
- package/dist/skills/opengame-maps/CHANGELOG.md +9 -0
- package/dist/skills/opengame-maps/SKILL.md +78 -0
- package/dist/skills/opengame-maps/references/map-spec.md +77 -0
- package/dist/skills/opengame-mobile/CHANGELOG.md +4 -0
- package/dist/skills/opengame-mobile/SKILL.md +18 -18
- package/dist/skills/opengame-montage-make/CHANGELOG.md +5 -0
- package/dist/skills/opengame-montage-make/SKILL.md +187 -0
- package/dist/skills/opengame-montage-make/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-make/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-montage-make/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-make/references/finishing.md +126 -0
- package/dist/skills/opengame-montage-make/references/measure.md +282 -0
- package/dist/skills/opengame-montage-make/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-make/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-make/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-make/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-make/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-make/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-make/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-make/references/song.md +64 -0
- package/dist/skills/opengame-montage-plan/CHANGELOG.md +5 -0
- package/dist/skills/opengame-montage-plan/SKILL.md +197 -0
- package/dist/skills/opengame-montage-plan/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-plan/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-plan/references/measure.md +282 -0
- package/dist/skills/opengame-montage-plan/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-plan/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-plan/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-plan/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-plan/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-plan/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-plan/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-plan/references/song.md +64 -0
- package/dist/skills/opengame-montage-review-and-improve/CHANGELOG.md +5 -0
- package/dist/skills/opengame-montage-review-and-improve/SKILL.md +178 -0
- package/dist/skills/opengame-montage-review-and-improve/references/briefs.md +293 -0
- package/dist/skills/opengame-montage-review-and-improve/references/day-one-questions.md +46 -0
- package/dist/skills/opengame-montage-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-montage-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-montage-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-capture.md +151 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-gates.md +84 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-genres.md +198 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-grammar.md +320 -0
- package/dist/skills/opengame-montage-review-and-improve/references/montage-ops.md +127 -0
- package/dist/skills/opengame-montage-review-and-improve/references/og-snipers-record.md +110 -0
- package/dist/skills/opengame-montage-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-montage-review-and-improve/references/reference-study.md +293 -0
- package/dist/skills/opengame-montage-review-and-improve/references/song.md +64 -0
- package/dist/skills/opengame-multiplayer/CHANGELOG.md +15 -0
- package/dist/skills/opengame-multiplayer/SKILL.md +143 -0
- package/dist/skills/opengame-multiplayer/references/bot-lobbies.md +71 -0
- package/dist/skills/opengame-multiplayer/references/netcode.md +165 -0
- package/dist/skills/opengame-performance/CHANGELOG.md +8 -0
- package/dist/skills/opengame-performance/SKILL.md +106 -65
- package/dist/skills/opengame-performance/helpers/landing-pacer.mjs +86 -0
- package/dist/skills/opengame-performance/references/measuring.md +51 -0
- package/dist/skills/opengame-performance/references/webgpu.md +86 -0
- package/dist/skills/opengame-production/CHANGELOG.md +13 -0
- package/dist/skills/opengame-production/SKILL.md +119 -54
- package/dist/skills/opengame-production/references/team.md +107 -0
- package/dist/skills/opengame-production/references/templates.md +106 -16
- package/dist/skills/opengame-quality-bar/CHANGELOG.md +10 -0
- package/dist/skills/opengame-quality-bar/SKILL.md +94 -42
- package/dist/skills/opengame-quality-bar/references/cheap-tells.md +14 -7
- package/dist/skills/opengame-quality-bar/references/judges.md +95 -0
- package/dist/skills/opengame-quality-bar/references/review-prompt.md +10 -5
- package/dist/skills/opengame-rhythm/CHANGELOG.md +5 -0
- package/dist/skills/opengame-rhythm/SKILL.md +138 -0
- package/dist/skills/opengame-rhythm/references/charting.md +109 -0
- package/dist/skills/opengame-rhythm/references/timing.md +92 -0
- package/dist/skills/opengame-router/CHANGELOG.md +12 -0
- package/dist/skills/opengame-router/SKILL.md +14 -7
- package/dist/skills/opengame-scene-audit/CHANGELOG.md +15 -0
- package/dist/skills/opengame-scene-audit/SKILL.md +64 -47
- package/dist/skills/opengame-scene-audit/helpers/scene-audit.js +97 -19
- package/dist/skills/opengame-sdk/CHANGELOG.md +16 -0
- package/dist/skills/opengame-sdk/SKILL.md +27 -10
- package/dist/skills/opengame-sdk/references/engines.md +2 -2
- package/dist/skills/opengame-sdk/references/identity.md +10 -11
- package/dist/skills/opengame-sdk/references/leaderboards.md +11 -1
- package/dist/skills/opengame-sdk/references/radio.md +1 -1
- package/dist/skills/opengame-stability/CHANGELOG.md +4 -0
- package/dist/skills/opengame-stability/SKILL.md +59 -27
- package/dist/skills/opengame-trailer-make/CHANGELOG.md +5 -0
- package/dist/skills/opengame-trailer-make/SKILL.md +164 -0
- package/dist/skills/opengame-trailer-make/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-make/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-make/references/core.md +129 -0
- package/dist/skills/opengame-trailer-make/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-make/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-make/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-make/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-make/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-make/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-make/references/music.md +148 -0
- package/dist/skills/opengame-trailer-make/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-make/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-make/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-make/references/review.md +141 -0
- package/dist/skills/opengame-trailer-make/references/title.md +92 -0
- package/dist/skills/opengame-trailer-plan/CHANGELOG.md +5 -0
- package/dist/skills/opengame-trailer-plan/SKILL.md +176 -0
- package/dist/skills/opengame-trailer-plan/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-plan/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-plan/references/core.md +129 -0
- package/dist/skills/opengame-trailer-plan/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-plan/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-plan/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-plan/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-plan/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-plan/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-plan/references/music.md +148 -0
- package/dist/skills/opengame-trailer-plan/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-plan/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-plan/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-plan/references/reference-set.md +92 -0
- package/dist/skills/opengame-trailer-plan/references/review.md +141 -0
- package/dist/skills/opengame-trailer-plan/references/title.md +92 -0
- package/dist/skills/opengame-trailer-review-and-improve/CHANGELOG.md +5 -0
- package/dist/skills/opengame-trailer-review-and-improve/SKILL.md +145 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/archetypes.md +113 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/briefs.md +273 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/core.md +129 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/craft.md +299 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/edge-cases.md +27 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/filmable.md +244 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/finishing.md +126 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/gates.md +184 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/measure.md +282 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/music.md +148 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/og-clash-record.md +133 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/ops.md +154 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/owner-eye.md +214 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/review.md +141 -0
- package/dist/skills/opengame-trailer-review-and-improve/references/title.md +92 -0
- package/dist/skills/opengame-verification/CHANGELOG.md +11 -0
- package/dist/skills/opengame-verification/SKILL.md +113 -48
- package/dist/skills/opengame-weapons/CHANGELOG.md +11 -0
- package/dist/skills/opengame-weapons/SKILL.md +129 -55
- package/dist/skills/opengame-weapons/references/handling-numbers.md +42 -0
- package/dist/skills/opengame-weapons/references/reloads-and-hands.md +96 -0
- package/dist/skills/opengame-weapons/references/sights-and-scopes.md +98 -0
- package/dist/skills/opengame-weapons/references/threejs.md +71 -0
- package/dist/skills/opengame-world-physics/CHANGELOG.md +9 -0
- package/dist/skills/opengame-world-physics/SKILL.md +55 -24
- package/dist/skills/opengame-world-physics/references/measured-failures.md +28 -1
- package/package.json +1 -1
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: opengame-audio
|
|
3
|
-
description: Make a browser game sound finished. Covers sound from the first press
|
|
3
|
+
description: Make a browser game sound finished. Covers sound from the first press on every device, audio QA without ears, a person listening before shipping, the player's shot leading the mix, a weapons limiter, no delay, a quiet player body, harshness and loudness gates, sounds heard at range and played whole, loops, generated takes, voice casting and buses. Use when the person says the game is silent, delayed, harsh, thin or muddy, sounds cheap, cuts off, repeats, or needs sound or voices.
|
|
4
4
|
metadata:
|
|
5
|
-
version: "1.
|
|
5
|
+
version: "1.1.0"
|
|
6
6
|
---
|
|
7
7
|
|
|
8
8
|
# Audio
|
|
@@ -12,22 +12,30 @@ ship between 337 and 7,459 audio files; our first prototypes shipped 34. Count i
|
|
|
12
12
|
the goal, though. Four hundred samples played without a chain, a voice budget and a
|
|
13
13
|
no-repeat rule sound worse than forty played through them.
|
|
14
14
|
|
|
15
|
+
Agents have no ears. In OC, LC and OS every level was set by meter, and each time the
|
|
16
|
+
owner was the first person to listen: OC's wonder weapon was "too aggressive", LC had
|
|
17
|
+
no rain at all under the browser's strict autoplay, and OS delayed every sound by about
|
|
18
|
+
690 ms. So these rules keep two kinds of evidence apart: what a recording of the running
|
|
19
|
+
game measures, and what only a person who listened can decide. Every report says which
|
|
20
|
+
is which.
|
|
21
|
+
|
|
15
22
|
Rules carry five tags; `opengame-quality-bar` explains them and the game codes.
|
|
16
23
|
[helpers/audio-chain.js](helpers/audio-chain.js) builds the chain, the buses and the
|
|
17
24
|
voice pool; its `selfTest()` plants a bus that bypasses the limiter, a clip curve that
|
|
18
|
-
adds gain, a duck with no lead and an oldest-voice pool, and proves each is caught.
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
25
|
+
adds gain, a duck with no lead and an oldest-voice pool, and proves each is caught. How
|
|
26
|
+
to record and check a game's sound without ears, with code for the master-bus tap:
|
|
27
|
+
[references/qa-without-ears.md](references/qa-without-ears.md). Rhythm and music games:
|
|
28
|
+
`opengame-rhythm` owns the song clock, the charted attack heard in the final mix and
|
|
29
|
+
codec delay.
|
|
22
30
|
|
|
23
31
|
## Rules
|
|
24
32
|
|
|
25
33
|
### Sound from the first press, loading screen included
|
|
26
34
|
- **Invariant:** The game makes sound from the player's first press: the loading screen, the title and every menu have music or ambience, and the first shot of the first run is heard.
|
|
27
|
-
- **Technique:** A press-to-start screen over key art gives the browser the gesture it needs while the download runs. Create and resume one audio context inside that first key or pointer handler, with no separate "tap for sound" prompt. Load the menu set first, then the sounds the player makes (the equipped weapon's bank) ahead of the rest of the run's audio. Hand the loading music to the menu theme with a crossfade, and log when the theme is up so the two never overlap. In three.js, call `THREE.AudioContext.getContext().resume()` in the handler; `AudioListener` uses that shared context.
|
|
28
|
-
- **Reference configuration:** OC: the press lands a hit on the music downbeat 60 ms after the key; loading music at -20 LUFS over a -27 LUFS bed, a tick for every 5% of progress and an anvil hit at 100%, then a 3 s music fade and a 5 s bed fade into the menu theme. Tiered sets: menu 10.4 MB, combat core 22 MB. A gun granted in the first 20 s of a run was silent for 11 to 16 s behind 35 MB of queued audio, until a trickle loader moved the first fire cue from 12.0 s to 2.1 s at 3 MB/s. The owner asked three times: "even our loading screen should have sfx and music and environmental ambience sounds too ... not just be silent".
|
|
35
|
+
- **Technique:** A press-to-start screen over key art gives the browser the gesture it needs while the download runs. Create and resume one audio context inside that first key or pointer handler, with no separate "tap for sound" prompt. Load the menu set first, then the sounds the player makes (the equipped weapon's bank) ahead of the rest of the run's audio. Hand the loading music to the menu theme with a crossfade, and log when the theme is up so the two never overlap. Never swallow a refused `play()` or a suspended context: count each refusal and restart the stream on the next gesture. Inside OpenGame the frame boots muted under the poster and the page's Play press is the gesture, so start sound from `og.audio.onHostMute(false)` after `og.init()` (`opengame-sdk`). In three.js, call `THREE.AudioContext.getContext().resume()` in the handler; `AudioListener` uses that shared context.
|
|
36
|
+
- **Reference configuration:** OC: the press lands a hit on the music downbeat 60 ms after the key; loading music at -20 LUFS over a -27 LUFS bed, a tick for every 5% of progress and an anvil hit at 100%, then a 3 s music fade and a 5 s bed fade into the menu theme. Tiered sets: menu 10.4 MB, combat core 22 MB. A gun granted in the first 20 s of a run was silent for 11 to 16 s behind 35 MB of queued audio, until a trickle loader moved the first fire cue from 12.0 s to 2.1 s at 3 MB/s. The owner asked three times: "even our loading screen should have sfx and music and environmental ambience sounds too ... not just be silent". LC's every capture booted with autostart and a lenient autoplay flag; under the strict policy every streamed loop died at its first hand-over and 421 refused `play()` calls were swallowed, until the owner asked "i dont hear any rain?".
|
|
29
37
|
- **Applies when:** Every browser game with sound.
|
|
30
|
-
- **Verify:** In a fresh profile on a throttled connection, press a key on the first screen and record the tab: sound starts on the press, the loading screen is never silent,
|
|
38
|
+
- **Verify:** In a fresh profile on a throttled connection, under the browser's strict autoplay policy, press a key on the first screen and record the tab: sound starts on the press, the loading screen is never silent, the first shot of the first run is audible, and the refusal counter reads zero.
|
|
31
39
|
|
|
32
40
|
### The shipped build makes sound on every platform
|
|
33
41
|
- **Invariant:** On every device and browser the game ships to, the deployed build plays the menu, the player's weapon and the voices at the levels the mix intends, and a build that cannot play sound tells the player.
|
|
@@ -36,52 +44,101 @@ loading, missing effects, no gunfire on iPhone) and harsh sounds 4 more. Start t
|
|
|
36
44
|
- **Applies when:** Every game with sound, and above all games that ship to phones.
|
|
37
45
|
- **Verify:** On a real iPhone and a real Android phone, open the live URL, play to the first reload and record: gunfire, reload and a voice line are each audible. Turn sound off in settings and measure the drop.
|
|
38
46
|
|
|
39
|
-
###
|
|
40
|
-
- **Invariant:** Every sound in the build has been heard in the running game by a person before it ships. Meters gate a sound; a listener decides it.
|
|
41
|
-
- **Technique:** Meter first (loudness, peak, harshness), then
|
|
42
|
-
- **Reference configuration:** OC on 16 Oct: "None of the audio has been listened to by a person: every pick was made by measurement." The wonder weapon's third sound was pushed to -12 LUFS with stacked crackle and whistle, marked "Not listened to by anyone", and rejected as "too aggressive" and "distorted"; its crest factor was 9.7 against the reference's 13.8.
|
|
43
|
-
- **Applies when:** Every game with sound.
|
|
44
|
-
- **Verify:** Every cue in the registry names who heard it and when, and links the in-game clip they heard.
|
|
47
|
+
### Agents measure; a person listens
|
|
48
|
+
- **Invariant:** Every sound in the build has been heard in the running game by a person before it ships. Until then, every report calls it measured, never heard, and says that nobody has listened. Meters gate a sound; a listener decides it.
|
|
49
|
+
- **Technique:** Meter first (loudness, peak, harshness, band levels), then render short named A/B clips of the change from one boot of the game, each named for what it is (new, as it was, not taken) and what to listen for, and send them to a person with a plain question. Keep a listened-by field per cue in the registry; a cue with no listener is reported as unheard. An agent opens every audio report with what nobody has heard and never writes "sounds" or "heard" about its own measurements. A spectrogram, a transcript and a model's score are evidence for a meter, not for taste.
|
|
50
|
+
- **Reference configuration:** OC on 16 Oct: "None of the audio has been listened to by a person: every pick was made by measurement." The wonder weapon's third sound was pushed to -12 LUFS with stacked crackle and whistle, marked "Not listened to by anyone", and rejected as "too aggressive" and "distorted"; its crest factor was 9.7 against the reference's 13.8. LC wrote "NOBODY HAS HEARD" 72 times across its audio notes; nine audio leads set every level by meter, and the owner, the first to listen, found no rain, "a really loud screehcing noise (that sounds female?)" and a flamethrower whose sound was "to harsh/loud/unpleasant", while reload sounds existed for every gun and nobody had heard one. OS moved its guns from -14 to -20 to -22 LUFS over four publishes with nobody listening, from "way too loud and distorted" to "too soft". In OH the owner was the only ear (`opengame-rhythm`).
|
|
51
|
+
- **Applies when:** Every game with sound, and every game built by agents.
|
|
52
|
+
- **Verify:** Every cue in the registry names who heard it and when, and links the in-game clip they heard; every agent report on sound opens with what is unheard.
|
|
53
|
+
|
|
54
|
+
### Record the game's own output on the player's path
|
|
55
|
+
- **Invariant:** The mix is judged from recordings of the built game's master output, started the way a player starts it and aligned to the game's own events, against stated relationships between sounds; nothing is judged from the source files alone, and no master is ever deleted.
|
|
56
|
+
- **Technique:** Tap the master bus with an AudioWorklet that writes a WAV, and log game events on the audio clock beside it so each shot, step and line can be found in the recording. Boot the built game with no autostart, press a real key, and run under the browser's strict autoplay policy as well as the default. Render scripted scenes through the game's real audio code in an `OfflineAudioContext` for fast checks. Gate on relationships (the shot over an enemy voice, steps over rain, a bed's level in the band a laptop speaker plays), transcribe every spoken line, read spectrograms as images with the shipped file shown first, and decode and re-measure after every encode. A low cue with no harmonics is silent on a laptop. A screencast's clock is not real time, so prove sound against picture from the in-page log, never by counting video frames.
|
|
57
|
+
- **Reference configuration:** LC's gates: the shot at least 4 LU over an enemy voice at arm's length (it measured 1.2, then 5.9), footsteps at least 6 dB over the rain for most steps, the surge heard before it is seen, a fight at -16 LUFS ±1.5, a quiet night at -28 ±3 (later ruled -25), output under -2 dBTP, files under -6 dBTP. Its rain beds sat near -47 dBFS and passed because the check measured the whole quiet scene; it now fails if rain at rest in 200 Hz-6 kHz is under -33 dBFS. A heartbeat 97% below 150 Hz read -59 dBFS in 300 Hz-4 kHz until a parallel clipped path gave it harmonics. The recordings found a misread radio line, an 8 dB end fade, masked footsteps, a shot 1.2 LU over a throat and a 600 Hz tone in a lift that the audio check itself exempted. OS's tap, aligned to the engine log within about 0.2 s, exposed a 1.7 to 3.6 s skew behind wrong numbers. OH's screencast ran at 25 fps with a 1 to 4.6 s offset from the page, so judges who timed effects by counting frames were wrong.
|
|
58
|
+
- **Applies when:** Every game with sound, above all one built by agents.
|
|
59
|
+
- **Verify:** After every bank or mix change, a three-minute real run produces the gate table from the recording, and a planted fault (a muted bed, a swallowed `play()`) fails it.
|
|
60
|
+
|
|
61
|
+
### Every sound reaches the speaker without delay, and nothing broken ever does
|
|
62
|
+
- **Invariant:** A sound waits only the device's own output latency plus a short mixing lead, in every phase of the game, and no NaN, out-of-range, runaway or garbage sample ever reaches the speakers. Static from the speakers counts as a crash.
|
|
63
|
+
- **Technique:** In Web Audio, start each sound at once on the context's clock and add no buffering of your own. Where a mixer is fed by a thread that can stall (a wasm engine, an AudioWorklet ring buffer), size its lead from the measured gap between writes, the longest recent gap plus a small margin inside a clamp; reset it after load stalls and never store it. Never trade latency for dropouts. Guard every bus against NaN, DC and bursts with bit tests that survive fast-math builds, keep a limiter under full scale, and prove the guard by injecting noise and NaNs.
|
|
64
|
+
- **Reference configuration:** An OS dropout fix grew the lead to 600 ms and stored it, so every sound waited about 690 ms: "audio / gun shot sounds are delayed now?... in latest build actualyl it seems all audio" and "we cant ever have delaye daudio ever in game anywhere" (owner). The adaptive lead (the longest engine write gap in the last 3 s plus 8 ms, within 30 to 100 ms) gave a 30 ms median with 13 underruns in 7 minutes, against 511 at a fixed 30 to 40 ms, and press-to-output of 67 ms against an 80 ms bar. A failed allocation wrote 5.3 MB of PCM, heard as "really loud static noise ... that really hurt my ears", because the NaN check had been compiled away. OC's latency clamp below the mixer's lead garbled every device.
|
|
65
|
+
- **Applies when:** Every game with sound; the lead sizing applies to a mixer fed by a thread that can stall.
|
|
66
|
+
- **Verify:** Log press-to-onset at each of the player's shots through two map loads, force 20 stalls of 150 ms, and inject +12 dB noise with NaNs: the output stays clean and the median stays near the device's base latency.
|
|
67
|
+
|
|
68
|
+
### The player's shot leads the mix, measured as a hierarchy at the output
|
|
69
|
+
- **Invariant:** In the recorded output the player's own signature sound (a shot, a strike) with its echo is clearly louder than every bolt, reload, voice, rival shot and continuous sound, and a person listens before a change ships.
|
|
70
|
+
- **Technique:** Record the real output with music, ambience and ducks off, and measure the shot, bolt and reload of each weapon together in one table. Normalise percussive takes on their momentary maximum from masters trimmed to the transient, keep rivals well under the player's own shot, order weapons by calibre, and trim each spoken line by its loudest moment against the shot. Rebuild ducks from the live voices every audio frame, so a stuck duck cannot flatter the measurement. Targets per family can still invert the hierarchy, so check it across families at the output.
|
|
71
|
+
- **Reference configuration:** OS: a flat ±1 LU pass left bolts louder, "reload and bolt back sounds are defs louder than the gunshot sounds which shouldnt be the case" (owner). After: the own shot 4.8 LU over anything in a fight, rivals at least 6 dB under, bolts 9.5 to 28 LU under, reloads never within 6 LU, the announcer 2 to 3 LU under; momentary maximum put 13 of 16 guns within 0.8 dB where integrated loudness left 4.7 dB. A duck that skipped its reset flattered the check by 4 to 8 dB. A gunshot pack the owner supplied stayed once the owner signed it off ("Keep them for all the gunshots. Do not change them…"), and was only levelled, mixed and trimmed, with the shot 6 to 10 LU over foley; its licence had been flagged by an agent, which makes shipping it the owner's call (`opengame-assets`). LC orders by calibre: rifle at the ceiling, pistol -3 and SMG -4 dB, 12 dB over a zombie's throat within 3 m; each radio line trimmed so its loudest 150 ms lands 2 dB under the player's shot (lines levelled by integrated loudness stood 5.4 dB apart).
|
|
72
|
+
- **Applies when:** Any game with a signature action sound.
|
|
73
|
+
- **Verify:** A dry table per weapon with the shot on top in every row, a duck log reading 0 dB during the capture, and a clip a person has heard.
|
|
74
|
+
|
|
75
|
+
### Weapons have their own limiter, and the mix makes room for each shot
|
|
76
|
+
- **Invariant:** Firing never pumps the rest of the mix: the weapons run through a limiter of their own, every other sound gives way briefly under each shot, nothing ducks the weapons, and automatic fire never becomes a wall of sound.
|
|
77
|
+
- **Technique:** A weapons bus with its own fast limiter ahead of the master. Each shot ducks the other buses briefly: fast down, a short hold, a slower return (the duck rule below covers a cause that sits inside the ducked bus). Keep non-shot sounds a few dB lower, cap overlapping shot bodies in automatic fire, put enemy voices through their own compressor, and use real recorded gunshots with a tail recorded for each place. A low thump with harmonics gives weight on small speakers.
|
|
78
|
+
- **Reference configuration:** LC's weapons limiter: -7 dBFS (-4 for real recordings), 20:1, 1 ms attack, 90 ms release; "with one shared limiter a burst took 8 dB off everything" (the dead, the radio and the storm). Each round ducks 10 dB, down in 5 ms, held 120 ms, back over 450 ms, measured at 12.4 dB with no pumping; non-shot sounds sit 3 dB lower; at most 2 shot bodies at once ("a burst becomes a wall"); the dead go through a compressor at -10 dB and 3.5:1, and a shot rises 4.9 to 6.7 dB out of 18 of them (it had risen 1 dB). An old voice duck had cut every round 6 dB for a run's first 20 s. CC0 recordings peak in 1.5 ms with a crest of 19 dB where generated shots peaked in 10 to 35 ms, "a rebuild, not a level change"; tails decay to -40 dB in 0.36 s in a room and 1.84 s in a vault; a sine thump falling from 125 to 50 Hz survives laptop speakers through its harmonics.
|
|
79
|
+
- **Applies when:** Shooters, and any game with a crowd under the player's action.
|
|
80
|
+
- **Verify:** Render a burst beside a near enemy offline: the shot stands about 12 dB over it, the duck holds and returns without pumping, and the weapons bus shows no gain reduction from anything but its own limiter.
|
|
45
81
|
|
|
46
82
|
### Every sound is clean
|
|
47
83
|
- **Invariant:** No sound is harsh, distorted, clipped or unpleasant to sit through, including the ones that repeat fastest, and one harsh sound starts a sweep of its whole class.
|
|
48
|
-
- **Technique:** Batch-meter every file for true peak, loudness, crest factor, the share of energy in the upper-mid presence band, hiss, DC offset and clicks at the loop point, and flag outliers against their family. Fix at the file. When anyone calls one sound harsh, meter and audition every sound in its class. Rapid-fire weapons get a short sound per shot and a cap on overlapping shots.
|
|
49
|
-
- **Reference configuration:** OC's owner: "the death machine SFX is OBNOXIOUS ... every sound needs to be elegant and clean and pleasant to the ear ... make sure no others like that!" Its 1.8 s file fired 25 times a second, about 12 dB louder than the Thompson, with 39% of its energy at 2-5 kHz (Thompson 12%); a 2 s in-game spray went from -13.0 LUFS and 23% to -17.7 LUFS and 5.4% (Thompson -16.4 and 9.7%, M1911 -17.2 and 5.5%). The sweep softened 54 more files and fixed 6 clicks at loop points (R167-R169).
|
|
84
|
+
- **Technique:** Batch-meter every file for true peak, loudness, crest factor, the share of energy in the upper-mid presence band and above it, narrow peaks, onset steepness, hiss, DC offset and clicks at the loop point, and flag outliers against their family. Fix at the file. When anyone calls one sound harsh, meter and audition every sound in its class. Rapid-fire weapons get a short sound per shot and a cap on overlapping shots. A soft tonal design beats stacked crackle, sizzle and whistle layers.
|
|
85
|
+
- **Reference configuration:** OC's owner: "the death machine SFX is OBNOXIOUS ... every sound needs to be elegant and clean and pleasant to the ear ... make sure no others like that!" Its 1.8 s file fired 25 times a second, about 12 dB louder than the Thompson, with 39% of its energy at 2-5 kHz (Thompson 12%); a 2 s in-game spray went from -13.0 LUFS and 23% to -17.7 LUFS and 5.4% (Thompson -16.4 and 9.7%, M1911 -17.2 and 5.5%). The sweep softened 54 more files and fixed 6 clicks at loop points (R167-R169). Gate: true peak at or under -1 dBTP, codec SNR at least 33 dB, 2,895 files with none clipped; rapid fire caps simultaneous shots at 2 and plays a casing every 6th round. LC's limits: 2-6 kHz at most -4 dB of the total, above 8 kHz at most -9 dB, narrow peaks at most 7 dB over their neighbours, onsets at most 12 dB/ms (90 for a shot).
|
|
50
86
|
- **Applies when:** Every game with sound; weapons and voices first.
|
|
51
87
|
- **Verify:** The batch meter prints every file's numbers and the outliers in each family; a person listens to every rapid-fire weapon held down and to the loudest ten seconds of the busiest fight.
|
|
52
88
|
|
|
89
|
+
### The player's body is quiet
|
|
90
|
+
- **Invariant:** A person moving normally makes no sound with their mouth: no breathing at rest or at a walk, no groans while moving, and effort and pain sounds are short, clean and rare.
|
|
91
|
+
- **Technique:** Gate body vocals on state: breath only after a long sprint and briefly after it, a voiced blow at most once per short interval, a death as one short clean grunt. No breathy, moaning or groaning takes on a player character. Footsteps, kit and cloth carry the body instead.
|
|
92
|
+
- **Reference configuration:** LC's owner: "therse way too many player groan noises and breathing noises... we want some but nedes to be more realistic... and not weird groan noises when ur moving". After: no breath at rest or walk, breath only after at least 4 s of sprint and for 7 s, a blow voiced at most once per 2.2 s. OC's death groan "sounds sexual" and became a 210-240 ms "oof".
|
|
93
|
+
- **Applies when:** Games with a voiced player character, in first or third person.
|
|
94
|
+
- **Verify:** A three-minute recorded run with no fighting has zero mouth sounds; a sprint and a run of hits stay inside the gates.
|
|
95
|
+
|
|
53
96
|
### Far sounds the player needs can be heard
|
|
54
97
|
- **Invariant:** Before anyone balances levels, every sound the player needs is audible at the distances the game is played at, and the mixer plays the cues the game sends.
|
|
55
98
|
- **Technique:** Check the distance model first: one falloff for every source makes the biggest sources inaudible at the distance they matter. Set reference distance and rolloff per sound family, keep the player's own hits above a floor, and count cues requested against cues played during a busy fight. In three.js, set `PositionalAudio.setRefDistance`, `setRolloffFactor` and `setDistanceModel` per family.
|
|
56
|
-
- **Reference configuration:** OC: one 3 m falloff left the boss at -28 dB. Per-family falloff became boss 30 m, explosions 12 m, zombies 6 m, impacts 5 m, with the player's own hits never below -8 dB. The mixer had been dropping 75% of cues (peak 41 voices, creature vocals capped at 4 with 13 dropped). The whole mix moved from -24.9 to -16.9 LUFS. The owner: "i dont hear any sfx really in game?"
|
|
99
|
+
- **Reference configuration:** OC: one 3 m falloff left the boss at -28 dB. Per-family falloff became boss 30 m, explosions 12 m, zombies 6 m, impacts 5 m, with the player's own hits never below -8 dB. The mixer had been dropping 75% of cues (peak 41 voices, creature vocals capped at 4 with 13 dropped). The whole mix moved from -24.9 to -16.9 LUFS. The owner: "i dont hear any sfx really in game?" OS, where "a sniper game lives on hearing shots": a rival shot about 10 LU over wind and rain at 30 m, directional at 100 m, a distinct far crack and echo at 150-200 m, crack before boom at 343 m/s.
|
|
57
100
|
- **Applies when:** 3D games with positional sound.
|
|
58
101
|
- **Verify:** Stand at the far edge of the arena and trigger the boss's loudest attack; log requested against played cues over a minute of the busiest fight.
|
|
59
102
|
|
|
103
|
+
### Enemies can be found by ear in the dark
|
|
104
|
+
- **Invariant:** With nothing visible, the player can tell an enemy is near and where it is from its steps and voice over the ambience, inside a stated range.
|
|
105
|
+
- **Technique:** Trigger footsteps by distance covered with a minimum gap; give voices and feet a flatter falloff than other sounds; let the ambience give way a few dB while an unseen enemy is close; put voices in the band the ambience leaves free; use HRTF panning with extra cut at the far ear; taper a crowd so many voices do not blur.
|
|
106
|
+
- **Reference configuration:** LC's bar, lamp off: the nearest zombie within 10 m at or over the rain in its own band (100 Hz-1 kHz) nine times in ten, at least 6 dB over inside 5 m, under it beyond 15 m; steps at least 90 ms apart; falloff 0.4x (voices) and 0.55x (feet) of inverse distance; the rain gives 4 dB while an unseen one is within 10 m; up to 6 dB more cut at the far ear; a crowd taper with six or more within 12 m; "what is heard through rain is a moan" (90-500 Hz). Measured: steps found 32 of 34, voices 14 of 14, bearing error 2 degrees.
|
|
107
|
+
- **Applies when:** Horror and stealth games, and any game with enemies out of sight.
|
|
108
|
+
- **Verify:** Log every sound with its true distance and bearing and its level against the ambience in its own band; the bar holds over a dark run.
|
|
109
|
+
|
|
110
|
+
### Every sound the player needs plays whole, from where it happened
|
|
111
|
+
- **Invariant:** No audible sound ends before its file except by a named rule, echoes decay under the next shot rather than being cut, no queue or first use drops a shot or a cue, and every rival's sound comes from the rival.
|
|
112
|
+
- **Technique:** Voices over the cap keep advancing virtually and come back when there is room. Fade tails at their natural slope, never on a fixed clock, and continue a short tail with shaped noise at the measured slope. Size delayed-sound queues for the worst fight, load a weapon's far takes when its holder first appears, keep a stop ledger naming why each sound ended early, and play every rival's reload, bolt and step positionally. Duck weather briefly under each arriving far report.
|
|
113
|
+
- **Reference configuration:** OS's owner: "it feels like we're cutting off the echo on many gun shots prematurely?...". OS's voice limit cut 1,110 sounds in a 10-minute 31-bot fight, then 0 once stolen voices went virtual; fixed-clock fades ran up to 214 dB/s where tails decay at 20-40 dB/s to -60 dB in 2.3-3.7 s. A 32-entry queue dropped 30 of 109 rival reports, and "each rifle's first long-range shot of a match was silent". Rival reloads played centred at full level and were heard as the player's own reload never ending, until 71 cues were made positional. Rivals at 100 m went from -24 dB to 10 LU over storm rain.
|
|
114
|
+
- **Applies when:** Games with a voice cap, many players or many enemies.
|
|
115
|
+
- **Verify:** A busiest-fight capture whose stop ledger shows no unexplained early end, an audible first long-range shot in a fresh match, and a distance sweep with the louder ear on the correct side.
|
|
116
|
+
|
|
60
117
|
### Gunfire beats groans
|
|
61
118
|
- **Invariant:** When the voice budget is full, the sounds the player causes and needs (their weapon, hits, interface, music, announcer) always play, and enemy vocals give way first.
|
|
62
119
|
- **Technique:** Priority classes in the voice pool. The player's weapon, hit confirmation, interface, music and announcer are never culled; enemy vocals are capped to the nearest few within a radius; everything else competes by audibility as in the stealing rule below. Phones keep the same classes with a smaller pool.
|
|
63
|
-
- **Reference configuration:** OC: player fire, hits, interface, music and announcer always mixed; enemy vocals capped to the nearest 6 within 20-30 m; about 40 voices in the mix. Before the classes existed, iPhones played "game audio ... but NOT gunfire sounds".
|
|
120
|
+
- **Reference configuration:** OC: player fire, hits, interface, music and announcer always mixed; enemy vocals capped to the nearest 6 within 20-30 m; about 40 voices in the mix. Before the classes existed, iPhones played "game audio ... but NOT gunfire sounds". LC shares no enemy voice within 14 m.
|
|
64
121
|
- **Applies when:** Games where many sounds overlap.
|
|
65
122
|
- **Verify:** Spawn the largest horde and hold the trigger; the pool log shows no player shot refused or stolen, and a recording of the fight has every shot in it.
|
|
66
123
|
|
|
67
124
|
### Sound follows the animation beat by beat
|
|
68
|
-
- **Invariant:** Every sound tied to a visible action lands on the frame of its contact, beat by beat, and stops when the action is interrupted.
|
|
69
|
-
- **Technique:** Author multi-part actions (reloads, inspections, interactions) as named beats with times exported from the animation into one shared file.
|
|
70
|
-
- **Reference configuration:** OC's fire cue rises within 3 ms of the shot, and its reload sounds land within 12 ms of hand contact after running up to 0.74 s late; the beat specs and per-gun numbers are in `opengame-weapons`. The owner: "sweat the details with micro sfx even for like each part of a reload animation".
|
|
71
|
-
- **Applies when:** Games with authored animations that make contact sounds.
|
|
72
|
-
- **Verify:** Frame-step a recording of every reload beside its waveform and measure each beat's offset from
|
|
125
|
+
- **Invariant:** Every sound tied to a visible action lands on the frame of its contact, beat by beat, on every weapon and action, and stops when the action is interrupted.
|
|
126
|
+
- **Technique:** Author multi-part actions (reloads, inspections, interactions) as named beats with times exported from the animation into one shared file. Start each beat's sound from the animation's own state in the frame that draws it, when its playhead crosses the beat, and place it on the audio clock at once; never run a second timeline on the audio side from the action's start, which drifts as soon as the animation is slowed, blended or cut. Cancel the remaining beats when the action is cancelled. Every weapon gets its full set, and a set shared by a family is checked on each gun it plays on. Subtitles take the clip's real length and close when the line is cut.
|
|
127
|
+
- **Reference configuration:** OC's fire cue rises within 3 ms of the shot, and its reload sounds land within 12 ms of hand contact after running up to 0.74 s late; the beat specs and per-gun numbers are in `opengame-weapons`. The owner: "sweat the details with micro sfx even for like each part of a reload animation". LC's reload sounds existed in ten families of six stages each, were timed only on pistols, and landed a median 443 ms before the hand, 108 of 109 more than 120 ms early; its rule became "every beat is begun by the picture's own value in the frame it shows it, never by a clock of audio's". The owner had asked "we should also have reload sfx for all guns too please... idk if we have them?".
|
|
128
|
+
- **Applies when:** Games with authored animations that make contact sounds. Rhythm games run the other way: the song clock drives the picture (`opengame-rhythm`).
|
|
129
|
+
- **Verify:** Frame-step a recording of every reload of every weapon beside its waveform and measure each beat's offset from the frame where the moving part makes contact.
|
|
73
130
|
|
|
74
131
|
### Everything goes through one master chain
|
|
75
132
|
- **Invariant:** Every sound the game makes reaches the speakers through one chain that holds overlapping sounds together and puts a ceiling on the output.
|
|
76
|
-
- **Technique:** Master gain into a glue compressor, make-up gain before (not after) a limiter so its threshold is the real ceiling, then a soft clip for the transient the limiter's attack lets through. Route HTML audio and video through the same graph if they belong in the mix. `createMasterChain` in the helper.
|
|
77
|
-
- **Reference configuration:** AW and MC: glue at -15 dB, 4:1, knee 14, 6 ms attack, 180 ms release; limiter at -1.2 dB, 20:1, 1 ms, 60 ms; make-up 1.25 before the limiter (after it, the real ceiling rose to about +0.7 dBFS). SR glues more gently at -12 dB, 2:1. AW measured three 50 ms windows a minute peaking above 0 dBFS after the limiter alone.
|
|
133
|
+
- **Technique:** Master gain into a glue compressor, make-up gain before (not after) a limiter so its threshold is the real ceiling, then a soft clip for the transient the limiter's attack lets through. A `DynamicsCompressorNode` adds make-up gain of its own, so measure it and compensate. Route HTML audio and video through the same graph if they belong in the mix. `createMasterChain` in the helper.
|
|
134
|
+
- **Reference configuration:** AW and MC: glue at -15 dB, 4:1, knee 14, 6 ms attack, 180 ms release; limiter at -1.2 dB, 20:1, 1 ms, 60 ms; make-up 1.25 before the limiter (after it, the real ceiling rose to about +0.7 dBFS). SR glues more gently at -12 dB, 2:1. AW measured three 50 ms windows a minute peaking above 0 dBFS after the limiter alone. LC's master limiter is at -4.5 dBFS, 20:1, 220 ms release, with output under -2 dBTP, and it undoes the compressor node's automatic make-up of about (1/g)^0.6.
|
|
78
135
|
- **Applies when:** Every game with sound.
|
|
79
136
|
- **Verify:** `chainProperties(chain)` returns no failures, and a recording of the busiest moment in the game has no sample above the ceiling.
|
|
80
137
|
|
|
81
138
|
### Buses with separate volume and duck
|
|
82
139
|
- **Invariant:** Music, ambience, effects, voice and interface sounds can each be turned down by the player and ducked by the game, and the two never fight.
|
|
83
|
-
- **Technique:** Each bus is a volume gain into a duck gain into the master. The player's slider writes the volume; the game's ducking writes the duck.
|
|
84
|
-
- **Reference configuration:** AW's buses are sfx, music, voice and ui, with ambience riding under the music slider but ducking on its own. OC ducks music 5 dB on big hits; its announcer ducks effects 4 dB and music and voice 6 dB.
|
|
140
|
+
- **Technique:** Each bus is a volume gain into a duck gain into the master. The player's slider writes the volume; the game's ducking writes the duck. Keep the player's weapons out of every voice and announcer duck (the weapons rule). Mute, pause and the page's own mute apply to every bus without changing the saved levels.
|
|
141
|
+
- **Reference configuration:** AW's buses are sfx, music, voice and ui, with ambience riding under the music slider but ducking on its own. OC ducks music 5 dB on big hits; its announcer ducks effects 4 dB and music and voice 6 dB. LC's rain ducks 8 dB under a radio line in 0.3 s, and an old voice duck that reached the weapons cut every round 6 dB. OH takes master gain under 0.01 within 0.5 s of the page's mute.
|
|
85
142
|
- **Applies when:** Every game with more than one kind of sound.
|
|
86
143
|
- **Verify:** Set the music slider to half, trigger a duck, let it release: the music returns to half, not to full.
|
|
87
144
|
|
|
@@ -94,8 +151,8 @@ loading, missing effects, no gunfire on iPhone) and harsh sounds 4 more. Start t
|
|
|
94
151
|
|
|
95
152
|
### Busy moments steal the quietest voice, gently
|
|
96
153
|
- **Invariant:** When too many sounds play at once, the least audible one gives way, without a click, and information-bearing sounds are the last to go.
|
|
97
|
-
- **Technique:** A bounded voice pool; when full, fade the quietest unprotected voice over a few milliseconds and start the new one after it. Reclaim voices by their scheduled end time, not by `onended`, which a busy event loop delivers late. Protect hit confirmation, warnings and voice. `createVoicePool` in the helper.
|
|
98
|
-
- **Reference configuration:** AW's 72-voice pool saturated in 0.16 s with twelve combatants. Taking the oldest voice with a hard stop retired voices as loud as the mix average (101%) and clicked; taking the quietest with a 6 ms fade retired voices at 46% of the mix average.
|
|
154
|
+
- **Technique:** A bounded voice pool; when full, fade the quietest unprotected voice over a few milliseconds and start the new one after it. A stolen voice the player still needs keeps its place virtually and returns when a voice frees (the rule on playing sounds whole). Reclaim voices by their scheduled end time, not by `onended`, which a busy event loop delivers late. Protect hit confirmation, warnings and voice. `createVoicePool` in the helper.
|
|
155
|
+
- **Reference configuration:** AW's 72-voice pool saturated in 0.16 s with twelve combatants. Taking the oldest voice with a hard stop retired voices as loud as the mix average (101%) and clicked; taking the quietest with a 6 ms fade retired voices at 46% of the mix average. OS's engine took the oldest unprotected voice, usually a gun's tail.
|
|
99
156
|
- **Applies when:** Any game where many sounds can overlap.
|
|
100
157
|
- **Verify:** `stealFailures(stealBehaviour(...))` is empty; drive the busiest fight and count voices stolen, refused and protected voices cut.
|
|
101
158
|
|
|
@@ -106,13 +163,41 @@ loading, missing effects, no gunfire on iPhone) and harsh sounds 4 more. Start t
|
|
|
106
163
|
- **Applies when:** Every game with repeated actions.
|
|
107
164
|
- **Verify:** Log the take played for a hundred footsteps: no immediate repeats, and every take used.
|
|
108
165
|
|
|
166
|
+
### Loops never repeat audibly
|
|
167
|
+
- **Invariant:** No bed or held sound has an audible period, no bed contains a sound the player will read as an event, and no continuous sound is as loud as the player's own action.
|
|
168
|
+
- **Technique:** Cut beds from long recordings, flatten swells, and fold the end over the start; check the envelope's circular autocorrelation; layer two beds of unequal length at random offsets. Build held sounds such as fire and engines from noise buffers of coprime lengths with moving bands rather than looping one file, and keep their top band narrow and free of fixed tones. Never prompt a generated bed with an event (steps, a door, a voice), because the player hears it as one; scan every bed for trains of footstep-like transients.
|
|
169
|
+
- **Reference configuration:** LC's rain beds run 38-97 s at an autocorrelation of 0.07 to 0.12 against a bar of 0.2 (a pulsed bed had read 0.58 at 2.1 s); open rain is two layers of 97 s and 71 s. The flamethrower moved from one 6 s file going round (self-likeness 1.00) to buffers of 9.7 and 13.1 s (0.18); after the owner's "to harsh/loud/unpleasant", four complaints in 27 hours, its 2.6 kHz whistle came out, its top was kept to 1.2-3 kHz and its held level went from -18.2 to -25.4 dBFS. OS's menu "footsteps", reported four times over three days, came last from a generated ambience bed prompted with "gravel crunching far away"; the transient-train scan took them from 4 to 0.
|
|
170
|
+
- **Applies when:** Ambience, weather, engines, fire and any held sound.
|
|
171
|
+
- **Verify:** Envelope autocorrelation of every bed under the bar, a spectrum check for fixed tones, and a transient-train scan of every bed that finds none.
|
|
172
|
+
|
|
109
173
|
### Loudness is measured, per family
|
|
110
174
|
- **Invariant:** Every shipped audio file has a measured loudness and true peak, grouped by family and normalised to that family's target after the codec, and the measurements cover exactly the files that ship.
|
|
111
|
-
- **Technique:** Generate a loudness manifest from the files on disk, never by hand, with integrated or short-window loudness and true peak per file, and fail when a file and the manifest disagree in either direction. Normalise each family to its target, level-match takes within a class, and measure again after every re-encode. Then audition the assembled mix, because per-file numbers do not balance a game.
|
|
112
|
-
- **Reference configuration:** AW's manifest is generated from the library and its check reports how many files it measured, because an empty library and an empty manifest otherwise agree perfectly. AW's confirmation levels: hit about -25 LUFS, headshot -23, kill -21, measured over the loudest 200 ms. OC's targets: weapons -17 LUFS (-19 to -16), voice -19, steps -25, ambience loops -26, ceiling -1 dBTP, one-shots on their loudest 200 ms K-weighted window; takes within a class level-matched to 0.1 dB; a new gun at or below the existing ones; fire 13-15 dB over the ambient bed. OC generated 1,275 files for $11.70 at the start and shipped 2,895; spend and credit rates are in the mix notes.
|
|
175
|
+
- **Technique:** Generate a loudness manifest from the files on disk, never by hand, with integrated or short-window loudness and true peak per file, and fail when a file and the manifest disagree in either direction. Normalise each family to its target (percussive takes on their momentary maximum), level-match takes within a class, and measure again after every re-encode. Then check the families against each other at the output (the shot rule above) and audition the assembled mix, because per-file numbers do not balance a game.
|
|
176
|
+
- **Reference configuration:** AW's manifest is generated from the library and its check reports how many files it measured, because an empty library and an empty manifest otherwise agree perfectly. AW's confirmation levels: hit about -25 LUFS, headshot -23, kill -21, measured over the loudest 200 ms. OC's targets: weapons -17 LUFS (-19 to -16), voice -19, steps -25, ambience loops -26, ceiling -1 dBTP, one-shots on their loudest 200 ms K-weighted window; takes within a class level-matched to 0.1 dB; a new gun at or below the existing ones; fire 13-15 dB over the ambient bed. OC generated 1,275 files for $11.70 at the start and shipped 2,895; spend and credit rates are in the mix notes. OS masters percussive takes to -14 LUFS momentary at most -1 dBTP, far takes near -22. LC's interface sounds are at -30 LUFS; a fight measured -17.2 LUFS, and a quiet night measured -22.5 against a ruling of -25.
|
|
113
177
|
- **Applies when:** Every game with recorded audio.
|
|
114
178
|
- **Verify:** The manifest check prints a file count equal to the number of shipped audio files, and every family's median is on its target.
|
|
115
179
|
|
|
180
|
+
### Generated takes are bought once, mastered and screened
|
|
181
|
+
- **Invariant:** Every generated sound is made once from a recorded spec, mastered, encoded, decoded and measured again, and screened by measurement before anyone listens; a take that fails is rejected with a reason and never patched, and masters are kept.
|
|
182
|
+
- **Technique:** Buy only on the person's own account, after they have said yes to the cost (`opengame-assets`). Keep a manifest of specs and hash each one, so the generator skips a spec it has made before. Check the cap and the balance first, read the provider's cost for each call from its response, and write it to a sidecar file beside the take; stop when the service fails. Buy a few takes per cue. Master each take (trim to the transient, de-clip, tame harshness, notch whines, limit onsets, normalise loudness in two passes under a true-peak ceiling), encode, decode and re-measure. Reject clipped, thin, whining, clicking, shrill-for-its-character, cut-off and unsteady takes and fall back to the next; never re-pitch a bad one. Run every spoken line through the game's final chain into a local speech recogniser and a phoneme check, and reword what they mishear. Read spectrograms with the shipped file first, because metrics alone prefer synthetic beeps.
|
|
183
|
+
- **Reference configuration:** LC turned 1,891 takes into 520 sounds (24.6 MB) for $24.18; the cost in each response showed sound effects at 11 credits a second, not the 40 assumed. About half of its generated takes were rejected (598 of 1,230 zombie readings kept, 381 shipped); shrill takes fell from 144 of 243 to 0 of 236 once a throat stopped being prompted as a woman's; a takeoff carried a 656 Hz tone 28 dB over its surroundings; lines misheard through the radio ("take an arm from Iraq" 11 of 12) were reworded. Its rejects: clipped over 64 samples or 1.2% at the ceiling, thin over 30 dB down under 180 Hz, a steady 11-19 kHz tone, shrill a fundamental over 300 Hz ("a 1.3 kHz tone played an octave down is still a tone"); a 10 ms lead absorbs Opus pre-echo. OS's single-pass normaliser fell into an automatic-gain mode and added 22-32 ms lead-ins ("theres a werid noise first and a delay", owner); masters now start within 2 ms of the transient, and "exact" is proved by correlation (0.56 to 0.9997). OS's recogniser passed two invented names that a phoneme check caught, and could not tell /laɪv/ from /lɪv/, which the owner heard.
|
|
184
|
+
- **Applies when:** Every game using generated sound or voice.
|
|
185
|
+
- **Verify:** The rejection log per bank, a re-measure of every shipped file after decoding, and recogniser word accuracy on every line through the final chain at 85% or more in a fight.
|
|
186
|
+
|
|
187
|
+
### Voices are cast by measurement, and the owner chooses by listening
|
|
188
|
+
- **Invariant:** A character voice is picked on intelligibility and fit across the whole script, from voices the game has a licence for and never cloned from another game's character; the owner hears samples and picks before the lines become the default; and a voice the owner approved is never replaced or deleted without asking.
|
|
189
|
+
- **Technique:** Audition the same few lines across several licensed voices; measure pitch, harmonics-to-noise, words per minute and recogniser word errors through the game's own chain (radio, helmet, distance); record the whole script with the top two; send the owner short samples; keep the runner-up one command away. Ask before deleting any named voice or line set, even one nothing calls yet.
|
|
190
|
+
- **Reference configuration:** LC auditioned 6 lines across 7 voices: the audition pick lost words on 34 of 159 readings through the radio and the runner-up on 14, so the pick was not cast; operator pitch 76-109 Hz; radio band 300 Hz-3.4 kHz; "nothing is cloned". Asked for two characters' voices that the account did not hold, LC recast from licensed library voices against a written character brief, cloning nothing ($3.17), and never put the 18 samples in front of the owner: the failure to avoid. An OS agent deleted the announcer's voice as "unused", so 46 of 71 lines shipped on a stand-in; once it was back, the owner: "annoucner voice is perfect so dont chang ehtat".
|
|
191
|
+
- **Applies when:** Any voiced character, narrator or announcer.
|
|
192
|
+
- **Verify:** The owner's pick is recorded with the samples they heard before the line set becomes the default, and the recogniser table covers the whole script.
|
|
193
|
+
|
|
194
|
+
### A listener model is a compass, not proof
|
|
195
|
+
- **Invariant:** No music or sound ships on a model's score alone, and the owner hears a sample of each style before it is made in bulk.
|
|
196
|
+
- **Technique:** Score at equal loudness, leave stems out or play them alone to find what moves the score, score section by section, and treat any difference smaller than the model's own scatter as no difference.
|
|
197
|
+
- **Reference configuration:** OH: a synthesised snare cost about 0.27 of a listener model's score; leads pitched an octave high cost 0.4 to 0.9, and moving them into register lifted one song from 6.50 to 7.42; the model disliked jazz guitar everywhere; a text-audio model scored two different styles 0.9995 alike and was useless. OS kept its paid sound judge only as a method: a hearing test to admit a judge, shuffled ids, anchors and a median.
|
|
198
|
+
- **Applies when:** Generating music or sound at volume.
|
|
199
|
+
- **Verify:** An owner listen per style, logged before the batch is made.
|
|
200
|
+
|
|
116
201
|
### One ranked confirmation channel
|
|
117
202
|
- **Invariant:** Hit, headshot and kill confirmations never pile up; a stronger verdict replaces a weaker one, and a weaker one never plays over a stronger one.
|
|
118
203
|
- **Technique:** Treat confirmations as one priority channel on a dry, protected interface bus with no world position. A new cue of equal or higher rank fades its predecessor out quickly; a lower one waits. Collapse duplicate reports from one frame.
|
|
@@ -121,23 +206,23 @@ loading, missing effects, no gunfire on iPhone) and harsh sounds 4 more. Start t
|
|
|
121
206
|
- **Verify:** Fire a shotgun into a target that dies: one kill cue plays, no hit cues under it.
|
|
122
207
|
|
|
123
208
|
### Distance is authored, not filtered
|
|
124
|
-
- **Invariant:** A far sound is a different sound, not the near one made quieter.
|
|
125
|
-
- **Technique:** Distant takes for loud sources, plus physically based air absorption that removes high frequencies with distance, attenuation from current positions, occlusion, and a reverb per zone. Keep interface sounds and narrators out of the world.
|
|
126
|
-
- **Reference configuration:** AW: at 300 m, 8 kHz is 45 dB down while 250 Hz loses 0.3 dB; its distant weapon set varies by duration and low-frequency content, from a pistol's 0.22 s to a launcher's 0.70 s. AAA bar values: gain `ref / (ref + k (d - ref))`, a low-pass from 16 to 20 kHz near to 1.5 kHz at 40 m, occlusion about 0.43 of gain, zone reverbs from 0.38 s (courtyard) to 2.2 s (hall).
|
|
209
|
+
- **Invariant:** A far sound is a different sound, not the near one made quieter, and every sound has the reverb of the space it happened in.
|
|
210
|
+
- **Technique:** Distant takes for loud sources, plus physically based air absorption that removes high frequencies with distance, attenuation from current positions, occlusion, and a reverb per zone sent from the source's own zone. Keep interface sounds and narrators out of the world.
|
|
211
|
+
- **Reference configuration:** AW: at 300 m, 8 kHz is 45 dB down while 250 Hz loses 0.3 dB; its distant weapon set varies by duration and low-frequency content, from a pistol's 0.22 s to a launcher's 0.70 s. AAA bar values: gain `ref / (ref + k (d - ref))`, a low-pass from 16 to 20 kHz near to 1.5 kHz at 40 m, occlusion about 0.43 of gain, zone reverbs from 0.38 s (courtyard) to 2.2 s (hall). LC, after "the sfx should echo like they are part of the map apporopiratley" (owner): eight impulse responses built in a Worker (Sabine RT60 = 0.161 V/A, first reflection at 2d/343), wetter with distance, at most two far reverbs, air low-pass 20 kHz x exp(-d/110), delay d/343, one occlusion ray a frame (900 Hz, -5 dB); a hut answers 2.7-3.0 dB over the open.
|
|
127
212
|
- **Applies when:** 3D games with sounds at distance.
|
|
128
213
|
- **Verify:** Record the same source at near, mid and far range, and behind a wall; each is audibly different in tone, not only level.
|
|
129
214
|
|
|
130
215
|
### The audio clock schedules sound
|
|
131
216
|
- **Invariant:** Every sound that must land at a time is scheduled on the audio context's clock, not on a timer.
|
|
132
|
-
- **Technique:** Schedule against `AudioContext.currentTime`. Where a long sequence must not reserve voices up front, wake a little early with a timer and place each cue exactly on the audio clock. Cancel both the scheduled sources and the pending wake-ups.
|
|
133
|
-
- **Reference configuration:** AW's reload reserved one voice per phase for its whole length, 132 voices against a pool of 72 at twelve combatants, until it moved to a 120 ms look-ahead. AW found four separate faults from gating sound on a clock other than the audio clock.
|
|
217
|
+
- **Technique:** Schedule against `AudioContext.currentTime`. Where a long sequence must not reserve voices up front, wake a little early with a timer and place each cue exactly on the audio clock. Cancel both the scheduled sources and the pending wake-ups. A sound tied to a picture takes its trigger from the picture and its placement from this clock (the beat rule above).
|
|
218
|
+
- **Reference configuration:** AW's reload reserved one voice per phase for its whole length, 132 voices against a pool of 72 at twelve combatants, until it moved to a 120 ms look-ahead. AW found four separate faults from gating sound on a clock other than the audio clock. LC's reloads ran their own audio-side timeline and drifted off the hands.
|
|
134
219
|
- **Applies when:** Every game with timed or sequenced sound.
|
|
135
220
|
- **Verify:** Grep for `setTimeout` near a `start(` or `play(` call; each one is a look-ahead wake-up, not the timing itself.
|
|
136
221
|
|
|
137
222
|
### Every file has a caller, and music streams
|
|
138
|
-
- **Invariant:** Every audio file in the build is reachable from a call site, and long music never sits decoded in memory.
|
|
139
|
-
- **Technique:** One cue registry that names each file and the event that triggers it, and preload derived from that registry. Stream music through a media element routed into the music bus; keep short cues in a bank that decodes on first use,
|
|
140
|
-
- **Reference configuration:** AW shipped 35 weapon files no weapon reached. A decoded sound is float PCM, about 23 MiB per stereo minute; ST found one game spending 134 MiB that way before its first frame of play. AW measured 266.9 MB of decoded audio against a 200 MB budget. In OC the first play of a rare sound was silent until warmed.
|
|
223
|
+
- **Invariant:** Every audio file in the build is reachable from a call site, a file nothing calls is wired up or reported rather than deleted, and long music never sits decoded in memory.
|
|
224
|
+
- **Technique:** One cue registry that names each file and the event that triggers it, and preload derived from that registry. Report an unreached file to the owner; never delete a named voice or set to pass the check (the casting rule). A game made from another game ships its own sound, and a check fails on any file inherited from the parent that the owner has not kept. Stream music through a media element routed into the music bus; keep short cues in a bank that decodes on first use, warm the first use of a rare sound the round before it plays, and disconnect idle voices.
|
|
225
|
+
- **Reference configuration:** AW shipped 35 weapon files no weapon reached. A decoded sound is float PCM, about 23 MiB per stereo minute; ST found one game spending 134 MiB that way before its first frame of play. AW measured 266.9 MB of decoded audio against a 200 MB budget. In OC the first play of a rare sound was silent until warmed. OS replaced all 1,194 sounds it had inherited after its owner's "not same voices and music and sfx NONE of it the same there pls!", and once served new fire files while 14 of 16 rifles still triggered another cue. LC took decoded audio from 403 to 188 MB with nothing heard within 10 m below 44.1 kHz, and disconnecting voices idle for 0.5 s took the audio thread from 0.41 to 0.22 of a core at rest.
|
|
141
226
|
- **Applies when:** Every game with recorded audio.
|
|
142
227
|
- **Verify:** List audio files and grep each name in source; list decoded buffers at runtime and sum their sizes.
|
|
143
228
|
|
|
@@ -151,4 +236,7 @@ loading, missing effects, no gunfire on iPhone) and harsh sounds 4 more. Start t
|
|
|
151
236
|
## Further reading
|
|
152
237
|
|
|
153
238
|
Where the reference numbers came from, the soft-clip measurement, the sound families a
|
|
154
|
-
shooter needs
|
|
239
|
+
shooter needs, what OC's, LC's and OS's libraries cost and LC's generation pipeline:
|
|
240
|
+
[references/mix-notes.md](references/mix-notes.md). The master-bus tap, the owner-path
|
|
241
|
+
capture, the offline mix render and the other checks an agent can run without ears:
|
|
242
|
+
[references/qa-without-ears.md](references/qa-without-ears.md).
|
|
@@ -42,6 +42,20 @@ fallback, because a fallback that never fires in testing ships as the real sound
|
|
|
42
42
|
somebody else's machine. A game whose style is synthesis can design synthesis on purpose;
|
|
43
43
|
what no game should ship is a beep standing in for a sound nobody made.
|
|
44
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
|
+
|
|
45
59
|
## Generated sound
|
|
46
60
|
|
|
47
61
|
Write prompts like directions to a recordist: source and material, attack, body, tail,
|
|
@@ -50,6 +64,28 @@ unwanted silence before an attack, keep real tails, and remeasure after every ed
|
|
|
50
64
|
delayed gunshot or footstep is a failed cue when its visible contact already happened.
|
|
51
65
|
See `opengame-assets` for the generation services themselves.
|
|
52
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
|
+
|
|
53
89
|
## Listening is a result of its own
|
|
54
90
|
|
|
55
91
|
A recording of the busiest moment, listened to at a consistent level, is a separate
|
|
@@ -57,7 +93,7 @@ result from every measurement. Peak and loudness readings, cue counts and a comp
|
|
|
57
93
|
in the code do not establish that the game sounds good. Record listening, final-output
|
|
58
94
|
measurement and missing cues as separate lines in a report.
|
|
59
95
|
|
|
60
|
-
## What
|
|
96
|
+
## What the libraries cost
|
|
61
97
|
|
|
62
98
|
OC generated its sound with ElevenLabs. Rates as measured on 16 Oct: sound effects about
|
|
63
99
|
11 credits a second, speech 0.43 credits a character, music 13.8 credits a second, at
|
|
@@ -65,6 +101,13 @@ $0.000183 a credit. The first library was 1,275 files for $11.70; ElevenLabs spe
|
|
|
65
101
|
$27.56 by 19 Oct against a $500 cap, and the shipped library was 2,895 files. Takes per cue
|
|
66
102
|
were 2 to 4, curated by measurement and then by ear.
|
|
67
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
|
+
|
|
68
111
|
Generated one-shots often peak late. Ask for "one single event that starts instantly at
|
|
69
112
|
0 ms" and cut to the transient. Loop stems need a join with no lag: a loop cut on the beat
|
|
70
113
|
grid stuttered by 45-68 ms.
|
|
@@ -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.
|
|
@@ -1,5 +1,15 @@
|
|
|
1
1
|
# opengame-capture changelog
|
|
2
2
|
|
|
3
|
+
## 1.1.0
|
|
4
|
+
|
|
5
|
+
Adds the testing half from OG Snipers (OS), Last Contact (LC) and OG Hero (OH): captures
|
|
6
|
+
that prove their own build, state, camera and coverage from a frozen committed snapshot
|
|
7
|
+
with quality pinned, motion filmed on the game clock and read at quarter speed (enemies
|
|
8
|
+
from the side, the DOM and canvas together in a headed grab), WebGPU canvases read in the
|
|
9
|
+
frame that drew them, screencasts treated as not real time, and every shot for one look
|
|
10
|
+
batched into one job after a one-frame proof. Extends the clock, time scale, clean feed,
|
|
11
|
+
ready, audio and hook rules with their numbers.
|
|
12
|
+
|
|
3
13
|
## 1.0.0
|
|
4
14
|
|
|
5
15
|
First public release, in the opengamehq/opengame repository and the OpenGame CLI.
|